signaltree

Guides AI agents integrating Angular reactive forms with SignalTree via @signaltree/ng-forms. Covers FormGroup ↔ signal bidirectional sync, validators, conditional fields, persistence, undo/redo, and multi-step wizards. Triggers on @signaltree/ng-forms, Angular reactive forms, FormGroup, createFormTree, form() marker, formBridge, signal forms, FormControl, FormArray, form validators, wizard forms, withFormHistory, createWizardForm, form history, undo redo forms.

Guides AI agents integrating SignalTree (@signaltree/core and related packages) into Angular 20+ applications. Use when the user mentions SignalTree, @signaltree/core, @signaltree/ng-forms, @signaltree/enterprise, @signaltree/callable-syntax, @signaltree/guardrails, @signaltree/events, @signaltree/realtime, signal tree, reactive state, Angular signals store, or Angular state management; when the user wants to create, read, or update a signalTree() state tree; when the user is choosing enhancers (batching, persistence, time travel, devTools) or markers (entityMap, status, stored, form); or when the user is building reactive forms, syncing realtime data, or wiring event-driven flows on top of Angular signals.

Guides AI agents using @signaltree/events for Zod-validated event schemas, event registries, factories, idempotency, retry classification, and framework subpath integrations (NestJS EventBusModule, Angular WebSocket bridge, entityMap batch-op bridge, optimistic updates, testing utilities). Triggers on @signaltree/events, createEventSchema, validateEvent, EventRegistry, EventBusModule, BaseSubscriber, NestJS event bus, Zod schema, idempotency store, retryable error, event factory, CQRS events, entityEventHandler, OptimisticUpdateManager, applyOptimisticEntityChange, optimistic update rollback.

Guides AI agents attaching @signaltree/schema for StandardSchema-driven validation against SignalTree leaf paths. Async-first, observe-only (never blocks writes), supports wildcard + ancestor schemas. Triggers on @signaltree/schema, schema validation, Zod integration, Valibot integration, StandardSchema, validation enhancer, errorsAt, isValid, async validation, schema registry, wildcard paths.

Guides AI agents wiring @signaltree/realtime so DB change events (INSERT/UPDATE/DELETE) automatically sync into SignalTree entityMap slices, via Supabase, custom WebSocket adapters, or any RealtimeAdapter. Covers connection state signals, reconnect logic, and entity transforms. Triggers on @signaltree/realtime, supabaseRealtime, realtime, RealtimeAdapter, entityMap sync, connection state, Supabase realtime, Firebase realtime, WebSocket adapter, INSERT UPDATE DELETE sync.

Guides AI agents enabling the optional build-time @signaltree/callable-syntax transform that lets `tree.$.field(value)` desugar to `.set(value)` and `tree.$.count(n => n + 1)` desugar to `.update(n => n + 1)`. Covers Webpack and Vite plugin configuration. Triggers on @signaltree/callable-syntax, SignalTreeSyntaxWebpackPlugin, signalTreeSyntaxTransform, Vite plugin, Webpack plugin, callable API sugar, set/update shorthand, build-time transform.

Guides AI agents attaching @signaltree/guardrails as a dev-only enhancer for SignalTree performance budgets, hot-path detection, memory-leak monitoring, and anti-pattern rules. Automatically noop in production via conditional package exports. Triggers on @signaltree/guardrails, performance budget, dev-only enhancer, anti-pattern detection, hot path analysis, memory leak detection, P95/P99 reporting, intent suppression.

Guides AI agents applying @signaltree/enterprise to large SignalTree state for diff-based bulk updates, optimized partial writes, and path-index monitoring. Triggers on @signaltree/enterprise, updateOptimized, bulk updates, large state tree, diff engine, path index, getPathIndex, 500+ signals, enterprise enhancer.

Guides AI agents consuming @signaltree/* packages in Angular applications. The canonical skill content lives at docs/skills/using-signaltree/SKILL.md — read that file for full instructions. Triggers include SignalTree, @signaltree/core, @signaltree/ng-forms, @signaltree/enterprise, @signaltree/callable-syntax, @signaltree/guardrails, @signaltree/events, @signaltree/realtime, Angular signals store, reactive state.