@ng-json-render/core 0.0.2

package/README.md

@@ -0,0 +1,86 @@
+# @ng-json-render/core
+
+Angular renderer for [json-render](https://json-render.dev) — safely render
+AI-agent-generated and server-driven UIs from a JSON spec into **native Angular
+components**. No iframes, no `eval`.
+
+Built on the framework-agnostic `@json-render/core` (catalog, spec, streaming,
+expression evaluation), this package adds the Angular rendering layer: signals,
+standalone components, dynamic instantiation, and DI-based events.
+
+## Install
+
+```sh
+npm i @ng-json-render/core @ng-json-render/primitives @json-render/core
+```
+
+## Usage
+
+```ts
+import { Component, signal } from '@angular/core';
+import { JrRenderer, type Spec } from '@ng-json-render/core';
+import { primitivesRegistry } from '@ng-json-render/primitives';
+
+@Component({
+  selector: 'app-root',
+  imports: [JrRenderer],
+  template: `<jr-renderer [spec]="spec()" [registry]="registry" (action)="onAction($event)" />`,
+})
+export class App {
+  registry = primitivesRegistry;
+  spec = signal<Spec>({
+    root: 'root',
+    elements: {
+      root: { type: 'Stack', props: { gap: 16 }, children: ['title', 'save'] },
+      title: { type: 'Text', props: { value: 'Hello', weight: 'bold' } },
+      save: { type: 'Button', props: { label: 'Save' }, on: { press: { action: 'save' } } },
+    },
+  });
+  onAction(e) { console.log(e.action, e.nodeId); }
+}
+```
+
+## Authoring components
+
+A catalog component is a standard standalone component. Props map to discrete
+`input()`s, children go through `<ng-content>`, and events are raised via the
+injected `JR_CONTEXT`:
+
+```ts
+import { Component, inject, input } from '@angular/core';
+import { JR_CONTEXT } from '@ng-json-render/core';
+
+@Component({
+  selector: 'jr-button',
+  template: `<button (click)="ctx.emit('press')">{{ label() }}<ng-content /></button>`,
+})
+export class MyButton {
+  label = input('');
+  protected ctx = inject(JR_CONTEXT);
+}
+```
+
+Register it with `defineRegistry({ Button: MyButton })` and pass to `<jr-renderer>`
+or `provideJsonRender({ registry })`.
+
+## Data binding
+
+Props support the full `@json-render/core` expression language — `$state`
+paths, `$cond/$then/$else`, `$template`, and directives — resolved against the
+spec's `state`. Provide/override state via the `[state]` input.
+
+## Testing
+
+`@ng-json-render/core/testing` exports a `renderSpec()` harness for TestBed:
+
+```ts
+import { renderSpec } from '@ng-json-render/core/testing';
+
+const r = renderSpec(spec, { registry });
+expect(r.query('button')?.textContent).toContain('Save');
+```
+
+## Status
+
+M1 (dynamic renderer + primitives + static/bound specs) is implemented.
+Streaming, two-way form binding, and a broader catalog are on the roadmap.

package/fesm2022/ng-json-render-core-testing.mjs

@@ -0,0 +1,45 @@
+import { TestBed } from '@angular/core/testing';
+import { provideJsonRender, JrRenderer } from '@ng-json-render/core';
+
+/**
+ * Mount a {@link Spec} in a TestBed and return helpers for asserting the output.
+ *
+ * ```ts
+ * const r = renderSpec(spec, { registry });
+ * expect(r.query('button')?.textContent).toContain('Save');
+ * ```
+ */
+function renderSpec(spec, options) {
+    TestBed.configureTestingModule({
+        providers: options.actions
+            ? [provideJsonRender({ actions: options.actions })]
+            : [],
+    });
+    const fixture = TestBed.createComponent(JrRenderer);
+    const actions = [];
+    fixture.componentInstance.action.subscribe((e) => actions.push(e));
+    fixture.componentRef.setInput('registry', options.registry);
+    if (options.state)
+        fixture.componentRef.setInput('state', options.state);
+    fixture.componentRef.setInput('spec', spec);
+    fixture.detectChanges();
+    const host = fixture.nativeElement;
+    return {
+        fixture,
+        host,
+        actions,
+        setSpec(next) {
+            fixture.componentRef.setInput('spec', next);
+            fixture.detectChanges();
+        },
+        query: (selector) => host.querySelector(selector),
+        queryAll: (selector) => Array.from(host.querySelectorAll(selector)),
+    };
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { renderSpec };
+//# sourceMappingURL=ng-json-render-core-testing.mjs.map

package/fesm2022/ng-json-render-core-testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ng-json-render-core-testing.mjs","sources":["../../../../libs/core/testing/src/index.ts","../../../../libs/core/testing/src/ng-json-render-core-testing.ts"],"sourcesContent":["import { ComponentFixture, TestBed } from '@angular/core/testing';\nimport {\n  type JrActionEvent,\n  type JrActionHandler,\n  type JrRegistry,\n  JrRenderer,\n  type Spec,\n  provideJsonRender,\n} from '@ng-json-render/core';\n\n/** Options for {@link renderSpec}. */\nexport interface RenderSpecOptions {\n  /** Registry mapping component types to Angular classes. */\n  registry: JrRegistry;\n  /** Optional action handlers, provided via `provideJsonRender`. */\n  actions?: Record<string, JrActionHandler>;\n  /** Optional initial state. */\n  state?: Record<string, unknown>;\n}\n\n/** Handle returned by {@link renderSpec}. */\nexport interface RenderSpecResult {\n  readonly fixture: ComponentFixture<JrRenderer>;\n  /** Root DOM element of the mounted renderer. */\n  readonly host: HTMLElement;\n  /** Actions captured from the renderer's `(action)` output, in order. */\n  readonly actions: readonly JrActionEvent[];\n  /** Replace the spec and run change detection. */\n  setSpec(next: Spec): void;\n  /** Query the rendered DOM. */\n  query(selector: string): HTMLElement | null;\n  queryAll(selector: string): HTMLElement[];\n}\n\n/**\n * Mount a {@link Spec} in a TestBed and return helpers for asserting the output.\n *\n * ```ts\n * const r = renderSpec(spec, { registry });\n * expect(r.query('button')?.textContent).toContain('Save');\n * ```\n */\nexport function renderSpec(\n  spec: Spec,\n  options: RenderSpecOptions,\n): RenderSpecResult {\n  TestBed.configureTestingModule({\n    providers: options.actions\n      ? [provideJsonRender({ actions: options.actions })]\n      : [],\n  });\n\n  const fixture = TestBed.createComponent(JrRenderer);\n  const actions: JrActionEvent[] = [];\n  fixture.componentInstance.action.subscribe((e) => actions.push(e));\n\n  fixture.componentRef.setInput('registry', options.registry);\n  if (options.state) fixture.componentRef.setInput('state', options.state);\n  fixture.componentRef.setInput('spec', spec);\n  fixture.detectChanges();\n\n  const host = fixture.nativeElement as HTMLElement;\n  return {\n    fixture,\n    host,\n    actions,\n    setSpec(next: Spec) {\n      fixture.componentRef.setInput('spec', next);\n      fixture.detectChanges();\n    },\n    query: (selector) => host.querySelector<HTMLElement>(selector),\n    queryAll: (selector) =>\n      Array.from(host.querySelectorAll<HTMLElement>(selector)),\n  };\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;AAkCA;;;;;;;AAOG;AACG,SAAU,UAAU,CACxB,IAAU,EACV,OAA0B,EAAA;IAE1B,OAAO,CAAC,sBAAsB,CAAC;QAC7B,SAAS,EAAE,OAAO,CAAC;AACjB,cAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;AAClD,cAAE,EAAE;AACP,KAAA,CAAC;IAEF,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC;IACnD,MAAM,OAAO,GAAoB,EAAE;AACnC,IAAA,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAElE,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC;IAC3D,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC;IACxE,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IAC3C,OAAO,CAAC,aAAa,EAAE;AAEvB,IAAA,MAAM,IAAI,GAAG,OAAO,CAAC,aAA4B;IACjD,OAAO;QACL,OAAO;QACP,IAAI;QACJ,OAAO;AACP,QAAA,OAAO,CAAC,IAAU,EAAA;YAChB,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;YAC3C,OAAO,CAAC,aAAa,EAAE;QACzB,CAAC;QACD,KAAK,EAAE,CAAC,QAAQ,KAAK,IAAI,CAAC,aAAa,CAAc,QAAQ,CAAC;AAC9D,QAAA,QAAQ,EAAE,CAAC,QAAQ,KACjB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAc,QAAQ,CAAC,CAAC;KAC3D;AACH;;AC1EA;;AAEG;;;;"}

package/fesm2022/ng-json-render-core.mjs

@@ -0,0 +1,331 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, inject, makeEnvironmentProviders, signal, Injectable, input, output, viewChild, ViewContainerRef, EnvironmentInjector, Injector, effect, untracked, reflectComponentType, ChangeDetectionStrategy, Component } from '@angular/core';
+import { createStateStore, resolveElementProps, resolveBindings, evaluateVisibility } from '@json-render/core';
+export { compileSpecStream, createSpecStreamCompiler, defineCatalog, defineSchema, validateSpec } from '@json-render/core';
+
+/** Injection token providing the per-node {@link JrContext}. */
+const JR_CONTEXT = new InjectionToken('JR_CONTEXT');
+/** Convenience helper to inject the current {@link JrContext} from a component. */
+function injectJrContext() {
+    return inject(JR_CONTEXT);
+}
+
+/** DI token for a default {@link JrRegistry} provided via `provideJsonRender`. */
+const JR_REGISTRY = new InjectionToken('JR_REGISTRY');
+/**
+ * Build a {@link JrRegistry} from a map of catalog `type` → Angular component class.
+ *
+ * ```ts
+ * const registry = defineRegistry({
+ *   Stack: JrStack,
+ *   Text: JrText,
+ *   Button: JrButton,
+ * });
+ * ```
+ */
+function defineRegistry(components) {
+    return { components: { ...components } };
+}
+/** Merge multiple registries; later entries win on conflicting keys. */
+function mergeRegistries(...registries) {
+    return {
+        components: Object.assign({}, ...registries.map((r) => r.components)),
+    };
+}
+
+/** DI token for the {@link JrActionDispatcher}. */
+const JR_ACTION_DISPATCHER = new InjectionToken('JR_ACTION_DISPATCHER');
+/**
+ * Register json-render defaults for the application (or a route).
+ *
+ * ```ts
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [
+ *     provideJsonRender({
+ *       registry: primitivesRegistry,
+ *       actions: { export_report: async () => { ... } },
+ *     }),
+ *   ],
+ * };
+ * ```
+ */
+function provideJsonRender(options = {}) {
+    const providers = [];
+    if (options.registry) {
+        providers.push({ provide: JR_REGISTRY, useValue: options.registry });
+    }
+    const actions = options.actions;
+    if (actions) {
+        const dispatcher = {
+            dispatch: (ctx) => actions[ctx.action]?.(ctx),
+        };
+        providers.push({ provide: JR_ACTION_DISPATCHER, useValue: dispatcher });
+    }
+    return makeEnvironmentProviders(providers);
+}
+
+/**
+ * Signal-based store that owns the current {@link Spec} and its runtime state.
+ *
+ * All calls into `@json-render/core` state utilities are funnelled through here
+ * so the rest of the engine depends on a single, stable surface. State changes
+ * from `@json-render/core`'s in-memory store are mirrored into an Angular signal
+ * (`state`) so templates and prop resolution stay reactive under zoneless CD.
+ */
+class JrStateStore {
+    _spec = signal(null, ...(ngDevMode ? [{ debugName: "_spec" }] : /* istanbul ignore next */ []));
+    /** The current spec, or `null` before one is set. */
+    spec = this._spec.asReadonly();
+    // `equal: () => false` forces the signal to notify on every store change even
+    // when the core store mutates the snapshot in place.
+    _state = signal({}, { ...(ngDevMode ? { debugName: "_state" } : /* istanbul ignore next */ {}), equal: () => false });
+    /** The current runtime state model. */
+    state = this._state.asReadonly();
+    store = createStateStore({});
+    unsubscribe;
+    /** Replace the spec and re-seed runtime state from `spec.state`. */
+    setSpec(spec) {
+        this._spec.set(spec);
+        this.unsubscribe?.();
+        this.store = createStateStore(spec.state ?? {});
+        this.unsubscribe = this.store.subscribe(() => this._state.set(this.store.getSnapshot()));
+        this._state.set(this.store.getSnapshot());
+    }
+    /** Merge additional state on top of the current model. */
+    patchState(state) {
+        this.store.update(state);
+    }
+    /** Look up an element by id in the current spec. */
+    getElement(id) {
+        return this._spec()?.elements[id];
+    }
+    /** Read a value from state by JSON Pointer path. */
+    getStatePath(path) {
+        return this.store.get(path);
+    }
+    /** Write a value into state by JSON Pointer path (notifies subscribers). */
+    setStatePath(path, value) {
+        this.store.set(path, value);
+    }
+    /** Current full state snapshot (non-reactive read). */
+    snapshot() {
+        return this.store.getSnapshot();
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: JrStateStore, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: JrStateStore });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: JrStateStore, decorators: [{
+            type: Injectable
+        }] });
+
+const ROOT_SCOPE = { item: undefined, index: -1 };
+/**
+ * Renders a json-render {@link Spec} into native Angular components.
+ *
+ * ```html
+ * <jr-renderer [spec]="spec()" [registry]="registry" (action)="onAction($event)" />
+ * ```
+ *
+ * The spec is a flat tree of typed elements; each `type` is resolved against the
+ * {@link JrRegistry} (from the `[registry]` input or `provideJsonRender`) and
+ * instantiated dynamically. Children are projected into each component's
+ * `<ng-content>`.
+ *
+ * Structural changes (the spec itself) rebuild the tree; state changes update
+ * individual nodes' inputs in place via per-node effects — so bound inputs stay
+ * live and keep focus. Props declaring `$bindState` two-way bind to a component's
+ * `model()` (Signal Forms `FormValueControl` / `FormCheckboxControl`).
+ */
+class JrRenderer {
+    /** The spec to render. */
+    spec = input(null, ...(ngDevMode ? [{ debugName: "spec" }] : /* istanbul ignore next */ []));
+    /** Registry mapping component types to Angular classes (overrides the DI default). */
+    registry = input(null, ...(ngDevMode ? [{ debugName: "registry" }] : /* istanbul ignore next */ []));
+    /** Initial/overriding runtime state merged on top of `spec.state`. */
+    state = input(undefined, ...(ngDevMode ? [{ debugName: "state" }] : /* istanbul ignore next */ []));
+    /** Emits whenever a rendered component raises an action. */
+    action = output();
+    anchor = viewChild.required('anchor', {
+        read: ViewContainerRef,
+    });
+    store = inject(JrStateStore);
+    envInjector = inject(EnvironmentInjector);
+    injector = inject(Injector);
+    fallbackRegistry = inject(JR_REGISTRY, { optional: true });
+    dispatcher = inject(JR_ACTION_DISPATCHER, {
+        optional: true,
+    });
+    /** Per-node effects (prop resolution + two-way bindings), torn down on rebuild. */
+    effects = [];
+    constructor() {
+        // Feed spec/state inputs into the store.
+        effect(() => {
+            const spec = this.spec();
+            if (!spec)
+                return;
+            const extra = this.state();
+            const merged = extra
+                ? { ...spec, state: { ...(spec.state ?? {}), ...extra } }
+                : spec;
+            untracked(() => this.store.setSpec(merged));
+        });
+        // Rebuild the DOM only when the spec (structure) changes. State-driven prop
+        // updates are handled per node, without rebuilding.
+        effect((onCleanup) => {
+            const vcr = this.anchor();
+            const spec = this.store.spec();
+            untracked(() => this.render(vcr, spec));
+            onCleanup(() => this.teardown(vcr));
+        });
+    }
+    render(vcr, spec) {
+        this.teardown(vcr);
+        if (!spec?.root)
+            return;
+        const registry = this.registry() ?? this.fallbackRegistry;
+        if (!registry) {
+            console.warn('[json-render] No registry provided (set [registry] or use provideJsonRender).');
+            return;
+        }
+        this.buildNode(vcr, spec.root, registry, ROOT_SCOPE);
+    }
+    buildNode(vcr, id, registry, scope) {
+        const element = this.store.getElement(id);
+        if (!element)
+            return null;
+        if (element.visible !== undefined && !this.isVisible(element, scope)) {
+            return null;
+        }
+        const cmp = registry.components[element.type];
+        if (!cmp) {
+            console.warn(`[json-render] No component registered for type "${element.type}".`);
+            return null;
+        }
+        // Build children first so their host nodes can be projected into <ng-content>.
+        const childNodes = [];
+        for (const childId of element.children ?? []) {
+            const childRef = this.buildNode(vcr, childId, registry, scope);
+            if (childRef)
+                childNodes.push(childRef.location.nativeElement);
+        }
+        const ref = vcr.createComponent(cmp, {
+            injector: this.makeNodeInjector(id, element, scope),
+            environmentInjector: this.envInjector,
+            projectableNodes: [childNodes],
+        });
+        const mirror = reflectComponentType(cmp);
+        const inputNames = new Set(mirror?.inputs.map((i) => i.templateName) ?? []);
+        this.bindProps(ref, element, scope, inputNames);
+        this.bindTwoWay(ref, element, mirror, inputNames);
+        return ref;
+    }
+    /** Reactively resolve and apply props; re-runs when referenced state changes. */
+    bindProps(ref, element, scope, inputNames) {
+        const eff = effect(() => {
+            const resolved = resolveElementProps(element.props ?? {}, {
+                stateModel: this.store.state(),
+                repeatItem: scope.item,
+                repeatIndex: scope.index,
+            });
+            untracked(() => {
+                for (const [key, value] of Object.entries(resolved)) {
+                    if (inputNames.has(key))
+                        ref.setInput(key, value);
+                }
+                if (inputNames.has('props'))
+                    ref.setInput('props', resolved);
+            });
+        }, { ...(ngDevMode ? { debugName: "eff" } : /* istanbul ignore next */ {}), injector: this.injector });
+        this.effects.push(eff);
+    }
+    /**
+     * Wire two-way `$bindState` props to a component's `model()` output. Works with
+     * any Signal Forms control (`value`/`checked` model), writing edits back to state.
+     */
+    bindTwoWay(ref, element, mirror, inputNames) {
+        if (!mirror)
+            return;
+        const bindings = resolveBindings(element.props ?? {}, {
+            stateModel: this.store.snapshot(),
+        });
+        if (!bindings)
+            return;
+        const outputs = new Set(mirror.outputs.map((o) => o.templateName));
+        const instance = ref.instance;
+        for (const [prop, path] of Object.entries(bindings)) {
+            // A model() prop exposes a matching `<prop>Change` output.
+            if (!inputNames.has(prop) || !outputs.has(`${prop}Change`))
+                continue;
+            const modelSignal = instance[prop];
+            if (typeof modelSignal !== 'function')
+                continue;
+            const eff = effect(() => {
+                const next = modelSignal();
+                untracked(() => {
+                    if (this.store.getStatePath(path) !== next) {
+                        this.store.setStatePath(path, next);
+                    }
+                });
+            }, { ...(ngDevMode ? { debugName: "eff" } : /* istanbul ignore next */ {}), injector: this.injector });
+            this.effects.push(eff);
+        }
+    }
+    makeNodeInjector(id, element, scope) {
+        const item = signal(scope.item, ...(ngDevMode ? [{ debugName: "item" }] : /* istanbul ignore next */ []));
+        const index = signal(scope.index, ...(ngDevMode ? [{ debugName: "index" }] : /* istanbul ignore next */ []));
+        const context = {
+            nodeId: id,
+            item: item.asReadonly(),
+            index: index.asReadonly(),
+            emit: (event, payload) => this.handleEmit(id, element, event, payload),
+        };
+        return Injector.create({
+            providers: [{ provide: JR_CONTEXT, useValue: context }],
+            parent: this.injector,
+        });
+    }
+    isVisible(element, scope) {
+        return evaluateVisibility(element.visible, {
+            stateModel: this.store.snapshot(),
+            repeatItem: scope.item,
+            repeatIndex: scope.index,
+        });
+    }
+    handleEmit(nodeId, element, event, payload) {
+        const binding = element.on?.[event];
+        const action = Array.isArray(binding)
+            ? (binding[0]?.action ?? event)
+            : (binding?.action ?? event);
+        const ctx = { action, payload, nodeId, element };
+        void this.dispatcher?.dispatch(ctx);
+        const spec = this.store.spec();
+        if (spec)
+            this.action.emit({ ...ctx, spec });
+    }
+    teardown(vcr) {
+        for (const eff of this.effects)
+            eff.destroy();
+        this.effects.length = 0;
+        vcr.clear();
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: JrRenderer, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.2.0", version: "21.2.17", type: JrRenderer, isStandalone: true, selector: "jr-renderer", inputs: { spec: { classPropertyName: "spec", publicName: "spec", isSignal: true, isRequired: false, transformFunction: null }, registry: { classPropertyName: "registry", publicName: "registry", isSignal: true, isRequired: false, transformFunction: null }, state: { classPropertyName: "state", publicName: "state", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { action: "action" }, providers: [JrStateStore], viewQueries: [{ propertyName: "anchor", first: true, predicate: ["anchor"], descendants: true, read: ViewContainerRef, isSignal: true }], ngImport: i0, template: `<ng-container #anchor />`, isInline: true, changeDetection: i0.ChangeDetectionStrategy.OnPush });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: JrRenderer, decorators: [{
+            type: Component,
+            args: [{
+                    selector: 'jr-renderer',
+                    template: `<ng-container #anchor />`,
+                    changeDetection: ChangeDetectionStrategy.OnPush,
+                    providers: [JrStateStore],
+                }]
+        }], ctorParameters: () => [], propDecorators: { spec: [{ type: i0.Input, args: [{ isSignal: true, alias: "spec", required: false }] }], registry: [{ type: i0.Input, args: [{ isSignal: true, alias: "registry", required: false }] }], state: [{ type: i0.Input, args: [{ isSignal: true, alias: "state", required: false }] }], action: [{ type: i0.Output, args: ["action"] }], anchor: [{ type: i0.ViewChild, args: ['anchor', { ...{
+                            read: ViewContainerRef,
+                        }, isSignal: true }] }] } });
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { JR_ACTION_DISPATCHER, JR_CONTEXT, JR_REGISTRY, JrRenderer, JrStateStore, defineRegistry, injectJrContext, mergeRegistries, provideJsonRender };
+//# sourceMappingURL=ng-json-render-core.mjs.map

package/fesm2022/ng-json-render-core.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ng-json-render-core.mjs","sources":["../../../../libs/core/src/lib/jr-context.ts","../../../../libs/core/src/lib/registry.ts","../../../../libs/core/src/lib/providers.ts","../../../../libs/core/src/lib/state-store.ts","../../../../libs/core/src/lib/jr-renderer.ts","../../../../libs/core/src/ng-json-render-core.ts"],"sourcesContent":["import { InjectionToken, type Signal, inject } from '@angular/core';\n\n/**\n * Per-node context made available to every rendered catalog component via DI.\n *\n * A component injects it to raise events and to read its data-binding scope:\n *\n * ```ts\n * @Component({ selector: 'jr-button', template: `<button (click)=\"ctx.emit('press')\"><ng-content/></button>` })\n * export class JrButton { protected ctx = inject(JR_CONTEXT); }\n * ```\n */\nexport interface JrContext {\n  /** Id of the spec element this component instance renders. */\n  readonly nodeId: string;\n  /** The current `$item` when inside a `repeat` scope, otherwise `undefined`. */\n  readonly item: Signal<unknown>;\n  /** The current `$index` when inside a `repeat` scope, otherwise `-1`. */\n  readonly index: Signal<number>;\n  /** Raise a named event; routed to the element's `on` bindings / action handlers. */\n  emit(event: string, payload?: unknown): void;\n}\n\n/** Injection token providing the per-node {@link JrContext}. */\nexport const JR_CONTEXT = new InjectionToken<JrContext>('JR_CONTEXT');\n\n/** Convenience helper to inject the current {@link JrContext} from a component. */\nexport function injectJrContext(): JrContext {\n  return inject(JR_CONTEXT);\n}\n","import { InjectionToken, type Type } from '@angular/core';\nimport type { JrRegistry } from './types';\n\n/** DI token for a default {@link JrRegistry} provided via `provideJsonRender`. */\nexport const JR_REGISTRY = new InjectionToken<JrRegistry>('JR_REGISTRY');\n\n/**\n * Build a {@link JrRegistry} from a map of catalog `type` → Angular component class.\n *\n * ```ts\n * const registry = defineRegistry({\n *   Stack: JrStack,\n *   Text: JrText,\n *   Button: JrButton,\n * });\n * ```\n */\nexport function defineRegistry(\n  components: Record<string, Type<unknown>>,\n): JrRegistry {\n  return { components: { ...components } };\n}\n\n/** Merge multiple registries; later entries win on conflicting keys. */\nexport function mergeRegistries(...registries: JrRegistry[]): JrRegistry {\n  return {\n    components: Object.assign({}, ...registries.map((r) => r.components)),\n  };\n}\n","import {\n  type EnvironmentProviders,\n  InjectionToken,\n  makeEnvironmentProviders,\n} from '@angular/core';\nimport { JR_REGISTRY } from './registry';\nimport type { JrActionContext, JrActionHandler, JrRegistry } from './types';\n\n/** A dispatcher routes emitted actions to their handlers. */\nexport interface JrActionDispatcher {\n  dispatch(ctx: JrActionContext): void | Promise<void>;\n}\n\n/** DI token for the {@link JrActionDispatcher}. */\nexport const JR_ACTION_DISPATCHER = new InjectionToken<JrActionDispatcher>(\n  'JR_ACTION_DISPATCHER',\n);\n\n/** Options for {@link provideJsonRender}. */\nexport interface ProvideJsonRenderOptions {\n  /** A default registry used by `JrRenderer` when no `[registry]` input is set. */\n  registry?: JrRegistry;\n  /** Map of action name → handler, invoked when a component emits that action. */\n  actions?: Record<string, JrActionHandler>;\n}\n\n/**\n * Register json-render defaults for the application (or a route).\n *\n * ```ts\n * export const appConfig: ApplicationConfig = {\n *   providers: [\n *     provideJsonRender({\n *       registry: primitivesRegistry,\n *       actions: { export_report: async () => { ... } },\n *     }),\n *   ],\n * };\n * ```\n */\nexport function provideJsonRender(\n  options: ProvideJsonRenderOptions = {},\n): EnvironmentProviders {\n  const providers = [];\n\n  if (options.registry) {\n    providers.push({ provide: JR_REGISTRY, useValue: options.registry });\n  }\n\n  const actions = options.actions;\n  if (actions) {\n    const dispatcher: JrActionDispatcher = {\n      dispatch: (ctx) => actions[ctx.action]?.(ctx),\n    };\n    providers.push({ provide: JR_ACTION_DISPATCHER, useValue: dispatcher });\n  }\n\n  return makeEnvironmentProviders(providers);\n}\n","import { Injectable, type Signal, signal } from '@angular/core';\nimport {\n  type Spec,\n  type StateModel,\n  type StateStore,\n  type UIElement,\n  createStateStore,\n} from '@json-render/core';\n\n/**\n * Signal-based store that owns the current {@link Spec} and its runtime state.\n *\n * All calls into `@json-render/core` state utilities are funnelled through here\n * so the rest of the engine depends on a single, stable surface. State changes\n * from `@json-render/core`'s in-memory store are mirrored into an Angular signal\n * (`state`) so templates and prop resolution stay reactive under zoneless CD.\n */\n@Injectable()\nexport class JrStateStore {\n  private readonly _spec = signal<Spec | null>(null);\n  /** The current spec, or `null` before one is set. */\n  readonly spec: Signal<Spec | null> = this._spec.asReadonly();\n\n  // `equal: () => false` forces the signal to notify on every store change even\n  // when the core store mutates the snapshot in place.\n  private readonly _state = signal<StateModel>(\n    {},\n    { equal: () => false },\n  );\n  /** The current runtime state model. */\n  readonly state: Signal<StateModel> = this._state.asReadonly();\n\n  private store: StateStore = createStateStore({});\n  private unsubscribe?: () => void;\n\n  /** Replace the spec and re-seed runtime state from `spec.state`. */\n  setSpec(spec: Spec): void {\n    this._spec.set(spec);\n    this.unsubscribe?.();\n    this.store = createStateStore(spec.state ?? {});\n    this.unsubscribe = this.store.subscribe(() =>\n      this._state.set(this.store.getSnapshot()),\n    );\n    this._state.set(this.store.getSnapshot());\n  }\n\n  /** Merge additional state on top of the current model. */\n  patchState(state: StateModel): void {\n    this.store.update(state);\n  }\n\n  /** Look up an element by id in the current spec. */\n  getElement(id: string): UIElement | undefined {\n    return this._spec()?.elements[id];\n  }\n\n  /** Read a value from state by JSON Pointer path. */\n  getStatePath(path: string): unknown {\n    return this.store.get(path);\n  }\n\n  /** Write a value into state by JSON Pointer path (notifies subscribers). */\n  setStatePath(path: string, value: unknown): void {\n    this.store.set(path, value);\n  }\n\n  /** Current full state snapshot (non-reactive read). */\n  snapshot(): StateModel {\n    return this.store.getSnapshot();\n  }\n}\n","import {\n  ChangeDetectionStrategy,\n  Component,\n  type ComponentRef,\n  type EffectRef,\n  EnvironmentInjector,\n  Injector,\n  ViewContainerRef,\n  effect,\n  inject,\n  input,\n  output,\n  reflectComponentType,\n  signal,\n  untracked,\n  viewChild,\n} from '@angular/core';\nimport {\n  type Spec,\n  type StateModel,\n  type UIElement,\n  evaluateVisibility,\n  resolveBindings,\n  resolveElementProps,\n} from '@json-render/core';\nimport { JR_CONTEXT, type JrContext } from './jr-context';\nimport { JR_ACTION_DISPATCHER } from './providers';\nimport { JR_REGISTRY } from './registry';\nimport { JrStateStore } from './state-store';\nimport type { JrActionEvent, JrRegistry } from './types';\n\n/** Iteration scope threaded through the recursive build (`$item` / `$index`). */\ninterface RenderScope {\n  readonly item: unknown;\n  readonly index: number;\n}\n\nconst ROOT_SCOPE: RenderScope = { item: undefined, index: -1 };\n\n/**\n * Renders a json-render {@link Spec} into native Angular components.\n *\n * ```html\n * <jr-renderer [spec]=\"spec()\" [registry]=\"registry\" (action)=\"onAction($event)\" />\n * ```\n *\n * The spec is a flat tree of typed elements; each `type` is resolved against the\n * {@link JrRegistry} (from the `[registry]` input or `provideJsonRender`) and\n * instantiated dynamically. Children are projected into each component's\n * `<ng-content>`.\n *\n * Structural changes (the spec itself) rebuild the tree; state changes update\n * individual nodes' inputs in place via per-node effects — so bound inputs stay\n * live and keep focus. Props declaring `$bindState` two-way bind to a component's\n * `model()` (Signal Forms `FormValueControl` / `FormCheckboxControl`).\n */\n@Component({\n  selector: 'jr-renderer',\n  template: `<ng-container #anchor />`,\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  providers: [JrStateStore],\n})\nexport class JrRenderer {\n  /** The spec to render. */\n  readonly spec = input<Spec | null>(null);\n  /** Registry mapping component types to Angular classes (overrides the DI default). */\n  readonly registry = input<JrRegistry | null>(null);\n  /** Initial/overriding runtime state merged on top of `spec.state`. */\n  readonly state = input<StateModel | undefined>(undefined);\n  /** Emits whenever a rendered component raises an action. */\n  readonly action = output<JrActionEvent>();\n\n  private readonly anchor = viewChild.required('anchor', {\n    read: ViewContainerRef,\n  });\n\n  private readonly store = inject(JrStateStore);\n  private readonly envInjector = inject(EnvironmentInjector);\n  private readonly injector = inject(Injector);\n  private readonly fallbackRegistry = inject(JR_REGISTRY, { optional: true });\n  private readonly dispatcher = inject(JR_ACTION_DISPATCHER, {\n    optional: true,\n  });\n\n  /** Per-node effects (prop resolution + two-way bindings), torn down on rebuild. */\n  private readonly effects: EffectRef[] = [];\n\n  constructor() {\n    // Feed spec/state inputs into the store.\n    effect(() => {\n      const spec = this.spec();\n      if (!spec) return;\n      const extra = this.state();\n      const merged: Spec = extra\n        ? { ...spec, state: { ...(spec.state ?? {}), ...extra } }\n        : spec;\n      untracked(() => this.store.setSpec(merged));\n    });\n\n    // Rebuild the DOM only when the spec (structure) changes. State-driven prop\n    // updates are handled per node, without rebuilding.\n    effect((onCleanup) => {\n      const vcr = this.anchor();\n      const spec = this.store.spec();\n      untracked(() => this.render(vcr, spec));\n      onCleanup(() => this.teardown(vcr));\n    });\n  }\n\n  private render(vcr: ViewContainerRef, spec: Spec | null): void {\n    this.teardown(vcr);\n    if (!spec?.root) return;\n    const registry = this.registry() ?? this.fallbackRegistry;\n    if (!registry) {\n      console.warn(\n        '[json-render] No registry provided (set [registry] or use provideJsonRender).',\n      );\n      return;\n    }\n    this.buildNode(vcr, spec.root, registry, ROOT_SCOPE);\n  }\n\n  private buildNode(\n    vcr: ViewContainerRef,\n    id: string,\n    registry: JrRegistry,\n    scope: RenderScope,\n  ): ComponentRef<unknown> | null {\n    const element = this.store.getElement(id);\n    if (!element) return null;\n\n    if (element.visible !== undefined && !this.isVisible(element, scope)) {\n      return null;\n    }\n\n    const cmp = registry.components[element.type];\n    if (!cmp) {\n      console.warn(\n        `[json-render] No component registered for type \"${element.type}\".`,\n      );\n      return null;\n    }\n\n    // Build children first so their host nodes can be projected into <ng-content>.\n    const childNodes: Node[] = [];\n    for (const childId of element.children ?? []) {\n      const childRef = this.buildNode(vcr, childId, registry, scope);\n      if (childRef) childNodes.push(childRef.location.nativeElement as Node);\n    }\n\n    const ref = vcr.createComponent(cmp, {\n      injector: this.makeNodeInjector(id, element, scope),\n      environmentInjector: this.envInjector,\n      projectableNodes: [childNodes],\n    });\n\n    const mirror = reflectComponentType(cmp);\n    const inputNames = new Set(mirror?.inputs.map((i) => i.templateName) ?? []);\n    this.bindProps(ref, element, scope, inputNames);\n    this.bindTwoWay(ref, element, mirror, inputNames);\n    return ref;\n  }\n\n  /** Reactively resolve and apply props; re-runs when referenced state changes. */\n  private bindProps(\n    ref: ComponentRef<unknown>,\n    element: UIElement,\n    scope: RenderScope,\n    inputNames: ReadonlySet<string>,\n  ): void {\n    const eff = effect(\n      () => {\n        const resolved = resolveElementProps(element.props ?? {}, {\n          stateModel: this.store.state(),\n          repeatItem: scope.item,\n          repeatIndex: scope.index,\n        });\n        untracked(() => {\n          for (const [key, value] of Object.entries(resolved)) {\n            if (inputNames.has(key)) ref.setInput(key, value);\n          }\n          if (inputNames.has('props')) ref.setInput('props', resolved);\n        });\n      },\n      { injector: this.injector },\n    );\n    this.effects.push(eff);\n  }\n\n  /**\n   * Wire two-way `$bindState` props to a component's `model()` output. Works with\n   * any Signal Forms control (`value`/`checked` model), writing edits back to state.\n   */\n  private bindTwoWay(\n    ref: ComponentRef<unknown>,\n    element: UIElement,\n    mirror: ReturnType<typeof reflectComponentType>,\n    inputNames: ReadonlySet<string>,\n  ): void {\n    if (!mirror) return;\n    const bindings = resolveBindings(element.props ?? {}, {\n      stateModel: this.store.snapshot(),\n    });\n    if (!bindings) return;\n\n    const outputs = new Set(mirror.outputs.map((o) => o.templateName));\n    const instance = ref.instance as Record<string, unknown>;\n\n    for (const [prop, path] of Object.entries(bindings)) {\n      // A model() prop exposes a matching `<prop>Change` output.\n      if (!inputNames.has(prop) || !outputs.has(`${prop}Change`)) continue;\n      const modelSignal = instance[prop];\n      if (typeof modelSignal !== 'function') continue;\n\n      const eff = effect(\n        () => {\n          const next = (modelSignal as () => unknown)();\n          untracked(() => {\n            if (this.store.getStatePath(path) !== next) {\n              this.store.setStatePath(path, next);\n            }\n          });\n        },\n        { injector: this.injector },\n      );\n      this.effects.push(eff);\n    }\n  }\n\n  private makeNodeInjector(\n    id: string,\n    element: UIElement,\n    scope: RenderScope,\n  ): Injector {\n    const item = signal(scope.item);\n    const index = signal(scope.index);\n    const context: JrContext = {\n      nodeId: id,\n      item: item.asReadonly(),\n      index: index.asReadonly(),\n      emit: (event, payload) => this.handleEmit(id, element, event, payload),\n    };\n    return Injector.create({\n      providers: [{ provide: JR_CONTEXT, useValue: context }],\n      parent: this.injector,\n    });\n  }\n\n  private isVisible(element: UIElement, scope: RenderScope): boolean {\n    return evaluateVisibility(element.visible, {\n      stateModel: this.store.snapshot(),\n      repeatItem: scope.item,\n      repeatIndex: scope.index,\n    });\n  }\n\n  private handleEmit(\n    nodeId: string,\n    element: UIElement,\n    event: string,\n    payload: unknown,\n  ): void {\n    const binding = element.on?.[event];\n    const action = Array.isArray(binding)\n      ? (binding[0]?.action ?? event)\n      : (binding?.action ?? event);\n\n    const ctx = { action, payload, nodeId, element };\n    void this.dispatcher?.dispatch(ctx);\n\n    const spec = this.store.spec();\n    if (spec) this.action.emit({ ...ctx, spec });\n  }\n\n  private teardown(vcr: ViewContainerRef): void {\n    for (const eff of this.effects) eff.destroy();\n    this.effects.length = 0;\n    vcr.clear();\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@ng-json-render/core",
+  "version": "0.0.2",
+  "description": "Angular renderer for json-render — safely render AI-agent-generated & server-driven UIs from a JSON spec.",
+  "license": "MIT",
+  "peerDependencies": {
+    "@angular/core": ">=19.0.0 <23.0.0",
+    "@json-render/core": "^0.19.0"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "fesm2022/ng-json-render-core.mjs",
+  "typings": "types/ng-json-render-core.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/ng-json-render-core.d.ts",
+      "default": "./fesm2022/ng-json-render-core.mjs"
+    },
+    "./testing": {
+      "types": "./types/ng-json-render-core-testing.d.ts",
+      "default": "./fesm2022/ng-json-render-core-testing.mjs"
+    }
+  },
+  "type": "module",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/testing/README.md

@@ -0,0 +1,3 @@
+# @ng-json-render/core/testing
+
+Secondary entry point of `@ng-json-render/core`. It can be used by importing from `@ng-json-render/core/testing`.

package/types/ng-json-render-core-testing.d.ts

@@ -0,0 +1,37 @@
+import { ComponentFixture } from '@angular/core/testing';
+import { JrRegistry, JrActionHandler, JrRenderer, JrActionEvent, Spec } from '@ng-json-render/core';
+
+/** Options for {@link renderSpec}. */
+interface RenderSpecOptions {
+    /** Registry mapping component types to Angular classes. */
+    registry: JrRegistry;
+    /** Optional action handlers, provided via `provideJsonRender`. */
+    actions?: Record<string, JrActionHandler>;
+    /** Optional initial state. */
+    state?: Record<string, unknown>;
+}
+/** Handle returned by {@link renderSpec}. */
+interface RenderSpecResult {
+    readonly fixture: ComponentFixture<JrRenderer>;
+    /** Root DOM element of the mounted renderer. */
+    readonly host: HTMLElement;
+    /** Actions captured from the renderer's `(action)` output, in order. */
+    readonly actions: readonly JrActionEvent[];
+    /** Replace the spec and run change detection. */
+    setSpec(next: Spec): void;
+    /** Query the rendered DOM. */
+    query(selector: string): HTMLElement | null;
+    queryAll(selector: string): HTMLElement[];
+}
+/**
+ * Mount a {@link Spec} in a TestBed and return helpers for asserting the output.
+ *
+ * ```ts
+ * const r = renderSpec(spec, { registry });
+ * expect(r.query('button')?.textContent).toContain('Save');
+ * ```
+ */
+declare function renderSpec(spec: Spec, options: RenderSpecOptions): RenderSpecResult;
+
+export { renderSpec };
+export type { RenderSpecOptions, RenderSpecResult };

package/types/ng-json-render-core.d.ts

@@ -0,0 +1,191 @@
+import * as _angular_core from '@angular/core';
+import { Type, InjectionToken, Signal, EnvironmentProviders } from '@angular/core';
+import { UIElement, Spec, StateModel } from '@json-render/core';
+export { Catalog, Schema, Spec, UIElement, compileSpecStream, createSpecStreamCompiler, defineCatalog, defineSchema, validateSpec } from '@json-render/core';
+
+/**
+ * A registry maps catalog component `type` strings to the Angular component
+ * classes that render them. Built with {@link defineRegistry}.
+ */
+interface JrRegistry {
+    readonly components: Readonly<Record<string, Type<unknown>>>;
+}
+/**
+ * Handler for an action raised by a component's `emit(event, payload)`.
+ * Registered via `provideJsonRender({ actions })`.
+ */
+type JrActionHandler = (ctx: JrActionContext) => void | Promise<void>;
+/** Context passed to a {@link JrActionHandler} when an action fires. */
+interface JrActionContext {
+    /** The action name (event name, or the `on` binding's action). */
+    readonly action: string;
+    /** Payload supplied by the emitting component. */
+    readonly payload: unknown;
+    /** Id of the spec element that raised the action. */
+    readonly nodeId: string;
+    /** The element that raised the action. */
+    readonly element: UIElement;
+}
+/** An event surfaced on `JrRenderer`'s `(action)` output. */
+interface JrActionEvent extends JrActionContext {
+    readonly spec: Spec;
+}
+
+/**
+ * Renders a json-render {@link Spec} into native Angular components.
+ *
+ * ```html
+ * <jr-renderer [spec]="spec()" [registry]="registry" (action)="onAction($event)" />
+ * ```
+ *
+ * The spec is a flat tree of typed elements; each `type` is resolved against the
+ * {@link JrRegistry} (from the `[registry]` input or `provideJsonRender`) and
+ * instantiated dynamically. Children are projected into each component's
+ * `<ng-content>`.
+ *
+ * Structural changes (the spec itself) rebuild the tree; state changes update
+ * individual nodes' inputs in place via per-node effects — so bound inputs stay
+ * live and keep focus. Props declaring `$bindState` two-way bind to a component's
+ * `model()` (Signal Forms `FormValueControl` / `FormCheckboxControl`).
+ */
+declare class JrRenderer {
+    /** The spec to render. */
+    readonly spec: _angular_core.InputSignal<Spec | null>;
+    /** Registry mapping component types to Angular classes (overrides the DI default). */
+    readonly registry: _angular_core.InputSignal<JrRegistry | null>;
+    /** Initial/overriding runtime state merged on top of `spec.state`. */
+    readonly state: _angular_core.InputSignal<StateModel | undefined>;
+    /** Emits whenever a rendered component raises an action. */
+    readonly action: _angular_core.OutputEmitterRef<JrActionEvent>;
+    private readonly anchor;
+    private readonly store;
+    private readonly envInjector;
+    private readonly injector;
+    private readonly fallbackRegistry;
+    private readonly dispatcher;
+    /** Per-node effects (prop resolution + two-way bindings), torn down on rebuild. */
+    private readonly effects;
+    constructor();
+    private render;
+    private buildNode;
+    /** Reactively resolve and apply props; re-runs when referenced state changes. */
+    private bindProps;
+    /**
+     * Wire two-way `$bindState` props to a component's `model()` output. Works with
+     * any Signal Forms control (`value`/`checked` model), writing edits back to state.
+     */
+    private bindTwoWay;
+    private makeNodeInjector;
+    private isVisible;
+    private handleEmit;
+    private teardown;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<JrRenderer, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<JrRenderer, "jr-renderer", never, { "spec": { "alias": "spec"; "required": false; "isSignal": true; }; "registry": { "alias": "registry"; "required": false; "isSignal": true; }; "state": { "alias": "state"; "required": false; "isSignal": true; }; }, { "action": "action"; }, never, never, true, never>;
+}
+
+/**
+ * Per-node context made available to every rendered catalog component via DI.
+ *
+ * A component injects it to raise events and to read its data-binding scope:
+ *
+ * ```ts
+ * @Component({ selector: 'jr-button', template: `<button (click)="ctx.emit('press')"><ng-content/></button>` })
+ * export class JrButton { protected ctx = inject(JR_CONTEXT); }
+ * ```
+ */
+interface JrContext {
+    /** Id of the spec element this component instance renders. */
+    readonly nodeId: string;
+    /** The current `$item` when inside a `repeat` scope, otherwise `undefined`. */
+    readonly item: Signal<unknown>;
+    /** The current `$index` when inside a `repeat` scope, otherwise `-1`. */
+    readonly index: Signal<number>;
+    /** Raise a named event; routed to the element's `on` bindings / action handlers. */
+    emit(event: string, payload?: unknown): void;
+}
+/** Injection token providing the per-node {@link JrContext}. */
+declare const JR_CONTEXT: InjectionToken<JrContext>;
+/** Convenience helper to inject the current {@link JrContext} from a component. */
+declare function injectJrContext(): JrContext;
+
+/**
+ * Signal-based store that owns the current {@link Spec} and its runtime state.
+ *
+ * All calls into `@json-render/core` state utilities are funnelled through here
+ * so the rest of the engine depends on a single, stable surface. State changes
+ * from `@json-render/core`'s in-memory store are mirrored into an Angular signal
+ * (`state`) so templates and prop resolution stay reactive under zoneless CD.
+ */
+declare class JrStateStore {
+    private readonly _spec;
+    /** The current spec, or `null` before one is set. */
+    readonly spec: Signal<Spec | null>;
+    private readonly _state;
+    /** The current runtime state model. */
+    readonly state: Signal<StateModel>;
+    private store;
+    private unsubscribe?;
+    /** Replace the spec and re-seed runtime state from `spec.state`. */
+    setSpec(spec: Spec): void;
+    /** Merge additional state on top of the current model. */
+    patchState(state: StateModel): void;
+    /** Look up an element by id in the current spec. */
+    getElement(id: string): UIElement | undefined;
+    /** Read a value from state by JSON Pointer path. */
+    getStatePath(path: string): unknown;
+    /** Write a value into state by JSON Pointer path (notifies subscribers). */
+    setStatePath(path: string, value: unknown): void;
+    /** Current full state snapshot (non-reactive read). */
+    snapshot(): StateModel;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<JrStateStore, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<JrStateStore>;
+}
+
+/** DI token for a default {@link JrRegistry} provided via `provideJsonRender`. */
+declare const JR_REGISTRY: InjectionToken<JrRegistry>;
+/**
+ * Build a {@link JrRegistry} from a map of catalog `type` → Angular component class.
+ *
+ * ```ts
+ * const registry = defineRegistry({
+ *   Stack: JrStack,
+ *   Text: JrText,
+ *   Button: JrButton,
+ * });
+ * ```
+ */
+declare function defineRegistry(components: Record<string, Type<unknown>>): JrRegistry;
+/** Merge multiple registries; later entries win on conflicting keys. */
+declare function mergeRegistries(...registries: JrRegistry[]): JrRegistry;
+
+/** A dispatcher routes emitted actions to their handlers. */
+interface JrActionDispatcher {
+    dispatch(ctx: JrActionContext): void | Promise<void>;
+}
+/** DI token for the {@link JrActionDispatcher}. */
+declare const JR_ACTION_DISPATCHER: InjectionToken<JrActionDispatcher>;
+/** Options for {@link provideJsonRender}. */
+interface ProvideJsonRenderOptions {
+    /** A default registry used by `JrRenderer` when no `[registry]` input is set. */
+    registry?: JrRegistry;
+    /** Map of action name → handler, invoked when a component emits that action. */
+    actions?: Record<string, JrActionHandler>;
+}
+/**
+ * Register json-render defaults for the application (or a route).
+ *
+ * ```ts
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [
+ *     provideJsonRender({
+ *       registry: primitivesRegistry,
+ *       actions: { export_report: async () => { ... } },
+ *     }),
+ *   ],
+ * };
+ * ```
+ */
+declare function provideJsonRender(options?: ProvideJsonRenderOptions): EnvironmentProviders;
+
+export { JR_ACTION_DISPATCHER, JR_CONTEXT, JR_REGISTRY, JrRenderer, JrStateStore, defineRegistry, injectJrContext, mergeRegistries, provideJsonRender };
+export type { JrActionContext, JrActionDispatcher, JrActionEvent, JrActionHandler, JrContext, JrRegistry, ProvideJsonRenderOptions };