@symbiote-native/angular 0.0.0-canary-20260724081123

package/build/angular/render/index.js

@@ -0,0 +1,171 @@
+// Mount an Angular app onto a Fabric surface. The native host hands us a rootTag; we
+// create a surface and bootstrap a standalone Angular component WITHOUT platform-browser
+// (no DOM) — createEnvironmentInjector + createComponent over @angular/core only, with our
+// SymbioteRendererFactory provided so Angular drives the engine, which commits into
+// nativeFabricUIManager; RN's own renderer never in the path. Angular twin of
+// adapters/vue/src/render.ts.
+import { createElement as createEngineElement, createSurface, disposeRoot, dlog, toPublicInstance, } from '@symbiote-native/engine';
+import { descriptorFor } from '@symbiote-native/components';
+import { ApplicationRef, createComponent, createEnvironmentInjector, DOCUMENT, ErrorHandler, RendererFactory2, ɵINJECTOR_SCOPE as INJECTOR_SCOPE, ɵprovideZonelessChangeDetectionInternal as provideZonelessChangeDetectionInternal, } from '@angular/core';
+import { SymbioteRendererFactory } from '../renderer';
+import { ColorSchemeService, WindowDimensionsService } from '../services';
+// The two FFI-edge casts of this adapter, both confined here to bootstrap. Angular's core
+// types model a browser: the injector parent is a non-null EnvironmentInjector, the host is
+// a DOM Element. Our root has neither shape — a null parent IS a root injector, and the host
+// is a SymbioteSurface (or, for a wrapped AppRegistry root, a plain engine node) the
+// SymbioteRenderer (not the DOM) consumes. These are the sanctioned I/O-edge casts where our
+// objects cross into Angular's web-typed API; revisit if Angular ever exposes a cast-free
+// host. Nothing else in the adapter casts.
+function rootInjectorParent() {
+    return null;
+}
+function asAngularHost(hostNode) {
+    // Angular's locateHostElement reads hostElement.tagName even when a concrete hostElement
+    // is supplied. The host container is given Angular the tiny DOM-shaped field it probes
+    // without changing the renderer target.
+    Object.defineProperty(hostNode, 'tagName', {
+        configurable: true,
+        value: 'symbiote-root',
+    });
+    return hostNode;
+}
+// A bare `symbiote-view` node, created directly through the engine (bypassing Angular's own
+// createElement, which only resolves KNOWN symbiote primitives, never an arbitrary component's
+// selector — see SymbioteRenderer.createElement). Used as the AppRegistry root's host when a
+// wrapperComponentProvider is set: Angular has no hostElement-less bootstrap for our renderer
+// (it would try `renderer.createElement(rootComponent.selector)`, which throws for anything
+// that isn't one of our primitives), so the root needs an explicit host too, one we then hand
+// to the wrapper as projectable content.
+function createDetachedViewHost() {
+    const descriptor = descriptorFor('View');
+    return toPublicInstance(createEngineElement(descriptor.component, descriptor.isText));
+}
+function applyInputs(cmpRef, initialProps) {
+    if (initialProps === undefined)
+        return;
+    for (const [key, value] of Object.entries(initialProps)) {
+        cmpRef.setInput(key, value);
+    }
+}
+// One Angular app per surface, so a surface can be torn down (unmount) or cleanly
+// re-mounted on the same rootTag: the bridgeless host stops and restarts a surface on Fast
+// Refresh and on lifecycle/focus changes, reusing the rootTag.
+const apps = new Map();
+function teardown(rootTag) {
+    const app = apps.get(rootTag);
+    if (app === undefined)
+        return;
+    app.rootRef?.destroy();
+    app.cmpRef.destroy();
+    app.injector.destroy();
+    apps.delete(rootTag);
+    disposeRoot(rootTag);
+}
+export function mount(rootTag, rootComponent, options) {
+    // A re-mount on a live rootTag starts clean; otherwise the stale app double-drives the surface.
+    teardown(rootTag);
+    const surface = createSurface(rootTag);
+    const injector = createEnvironmentInjector([
+        {
+            provide: RendererFactory2,
+            useValue: new SymbioteRendererFactory(surface),
+        },
+        { provide: DOCUMENT, useValue: { head: surface, body: surface } },
+        // createEnvironmentInjector with a null parent gives this injector scope
+        // {'environment'} only (see EnvironmentNgModuleRefAdapter), so providedIn:'root'
+        // tokens — ApplicationRef included — never resolve on their own (R3Injector.get
+        // walks up looking for an injector whose `scopes` contains 'root', and a null
+        // parent means that search always dead-ends in NullInjector). platform-browser's
+        // BROWSER_MODULE_PROVIDERS solves this the same way for real DOM apps: it hands
+        // { provide: INJECTOR_SCOPE, useValue: 'root' } to its OWN app-level providers, and
+        // R3Injector's constructor reads that provider and self-tags this.scopes with
+        // 'root'. We do the same here — no PlatformRef, no DOM, just this one provider.
+        { provide: INJECTOR_SCOPE, useValue: 'root' },
+        // Supplies the real ChangeDetectionSchedulerImpl (microtask-batched, self-scheduling
+        // via ApplicationRef.afterTick) + NoopNgZone + ZONELESS_ENABLED: true — the exact
+        // bundle internalCreateApplication() uses. With ApplicationRef reachable (see above),
+        // there is no more reason for a hand-rolled scheduler: it replaces our old
+        // unconditional `rootView.detectChanges(); cmpView.detectChanges()` (which force-ran
+        // BOTH root views on every tick regardless of cause) with Angular's own tick(), which
+        // only enters an attached view when something actually marked it (RefreshView / Dirty
+        // consumer / HasChildViewsToRefresh). NOTE: this does NOT stop the root's own template
+        // from re-running on a plain press or `ChangeDetectorRef.markForCheck()` anywhere in
+        // the tree — `markViewDirty` (which both native (event) bindings and `markForCheck()`
+        // go through, see SymbioteHostPropsDirective) unconditionally sets RefreshView on
+        // EVERY ancestor up to the root; that is fundamental, unavoidable Angular zoneless
+        // behavior, true in every Angular app, not something this swap changes. What DOES
+        // still protect a sibling branch from an unrelated press is a genuine child
+        // `@Component` boundary — SignalView-compiled children are skip-eligible regardless of
+        // this scheduler.
+        ...provideZonelessChangeDetectionInternal(),
+        // Angular's own INTERNAL_APPLICATION_ERROR_HANDLER (core.mjs) reports a tick()
+        // exception by calling `injector.get(ErrorHandler)` — a normal `bootstrapApplication`
+        // registers this token by default (platform-browser's BROWSER_MODULE_PROVIDERS), but
+        // our from-scratch environment injector never did, so that lookup itself threw
+        // NG0201 and REPLACED whatever the real error was with an unrelated "No provider
+        // found for ErrorHandler" — the real exception never got logged, and the NG0201 itself
+        // propagated out of a bare Timeout callback uncaught (nothing above it in the stack to
+        // catch it), i.e. any async tick() exception, anywhere in the app, crashed hard instead
+        // of being reported. Providing the default `ErrorHandler` (same one bootstrapApplication
+        // ships) restores the intended behavior: `console.error('ERROR', e)` and keep running.
+        { provide: ErrorHandler, useClass: ErrorHandler },
+        ColorSchemeService,
+        WindowDimensionsService,
+    ], rootInjectorParent());
+    // hostElement = the surface: the component's template content commits straight into the
+    // surface with no wrapper view, the engine wrapping surface.children in its synthetic flex
+    // root — the Angular equivalent of Vue's `app.mount(surface)`.
+    let cmpRef;
+    let rootRef;
+    if (options?.wrapperComponent === undefined) {
+        cmpRef = createComponent(rootComponent, {
+            environmentInjector: injector,
+            hostElement: asAngularHost(surface),
+        });
+        applyInputs(cmpRef, options?.initialProps);
+    }
+    else {
+        // The root gets its own host node from the renderer (createComponent without a
+        // hostElement) but is not attached to the surface directly; it is handed to the
+        // wrapper as projectable content instead, so only the wrapper needs a real host.
+        const rootHost = asAngularHost(createDetachedViewHost());
+        rootRef = createComponent(rootComponent, {
+            environmentInjector: injector,
+            hostElement: rootHost,
+        });
+        applyInputs(rootRef, options.initialProps);
+        cmpRef = createComponent(options.wrapperComponent, {
+            environmentInjector: injector,
+            hostElement: asAngularHost(surface),
+            projectableNodes: [[rootHost]],
+        });
+    }
+    // Attach both root views to ApplicationRef so its own tick() (via the real
+    // ChangeDetectionSchedulerImpl provided above) drives them from here on — no manual
+    // ChangeDetectorRef juggling needed. markForCheck anywhere in the tree now notifies
+    // the real scheduler, which batches a microtask and calls appRef.tick() itself.
+    const appRef = injector.get(ApplicationRef);
+    appRef.attachView(cmpRef.hostView);
+    if (rootRef !== undefined) {
+        appRef.attachView(rootRef.hostView);
+    }
+    dlog(`angular mount root=${rootTag}`);
+    appRef.tick(); // first paint
+    surface.requestCommit();
+    apps.set(rootTag, { cmpRef, rootRef, injector });
+    return surface;
+}
+// Tear down a surface by rootTag: the public pair of `mount`, and the JS half of the
+// bridgeless `RN$stopSurface` contract (see installStopSurfaceGlobal).
+export function unmount(rootTag) {
+    dlog(`angular unmount root=${rootTag}`);
+    teardown(rootTag);
+}
+function installStopSurfaceGlobal() {
+    globalThis.RN$stopSurface = (surfaceId) => {
+        unmount(surfaceId);
+    };
+    dlog('installed global.RN$stopSurface');
+}
+installStopSurfaceGlobal();
+//# sourceMappingURL=index.js.map

package/build/angular/render/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/render/index.ts"],"names":[],"mappings":"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"}

package/build/angular/renderer/index.d.ts

@@ -0,0 +1,37 @@
+import { SymbioteSurface, type ISymbioteNode } from '@symbiote-native/engine';
+import type { Renderer2, RendererFactory2, RendererType2 } from '@angular/core';
+type IHostNode = ISymbioteNode;
+type IHostElement = ISymbioteNode | SymbioteSurface;
+export declare class SymbioteRenderer implements Renderer2 {
+    private readonly surface;
+    readonly data: Record<string, unknown>;
+    destroyNode: ((node: ISymbioteNode) => void) | null;
+    constructor(surface: SymbioteSurface);
+    destroy(): void;
+    createElement(name: string): IHostNode;
+    createComment(): IHostNode;
+    createText(value: string): IHostNode;
+    appendChild(parent: IHostElement | null, newChild: IHostNode): void;
+    insertBefore(parent: IHostElement | null, newChild: IHostNode, refChild: IHostNode | null): void;
+    removeChild(_parent: IHostElement | null, oldChild: IHostNode): void;
+    parentNode(node: IHostNode): IHostElement | null;
+    nextSibling(node: IHostNode): IHostNode | null;
+    selectRootElement(selectorOrNode: string | IHostElement): IHostElement;
+    setAttribute(el: IHostElement, name: string, value: string): void;
+    removeAttribute(el: IHostElement, name: string): void;
+    private readonly classTokens;
+    addClass(el: IHostElement, name: string): void;
+    removeClass(el: IHostElement, name: string): void;
+    setStyle(el: IHostElement, style: string, value: unknown): void;
+    removeStyle(el: IHostElement, style: string): void;
+    setProperty(el: IHostElement, name: string, value: unknown): void;
+    setValue(node: IHostNode, value: string): void;
+    listen(target: unknown, eventName: string, callback: (event: unknown) => boolean | void): () => void;
+}
+export declare class SymbioteRendererFactory implements RendererFactory2 {
+    private readonly surface;
+    private renderer;
+    constructor(surface: SymbioteSurface);
+    createRenderer(_hostElement: unknown, _type: RendererType2 | null): Renderer2;
+}
+export {};

package/build/angular/renderer/index.js

@@ -0,0 +1,301 @@
+// An Angular custom renderer over @symbiote-native/engine. Angular components never touch the
+// DOM directly — every paint goes through Renderer2 (created per-component by
+// RendererFactory2). We provide OUR factory, so each Renderer2 method maps onto the
+// engine's tiny mutation API; the engine owns all Fabric clone-on-write, shared with
+// every other adapter. This is the Angular twin of adapters/vue/src/renderer.ts — proof
+// that the same engine mutation API drives both frameworks.
+import { appendChild, createAnchor, createElement, createRawText, dlog, getExplicitStyle, insertBefore, isDebug, isSymbioteNode, removeChild, routeProp, setEventListener, setText, toPublicInstance, RAW_TEXT_COMPONENT, SymbioteSurface, } from '@symbiote-native/engine';
+import { descriptorFor } from '@symbiote-native/components';
+import { isAnchorHostComponent } from '../anchor-host-registry';
+import { getScrollViewProjection, removeScrollViewProjectedChild, } from '../components/scroll-view/projection';
+function isSurface(parent) {
+    return parent instanceof SymbioteSurface;
+}
+function isRawText(node) {
+    return node.component === RAW_TEXT_COMPONENT;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+// Diagnostic-only: tags each anchor with a sequential id so log lines can tell distinct
+// anchors apart (they all otherwise print the same generic '#anchor' component name).
+// Gated behind isDebug() so a production build pays zero cost (no WeakMap writes).
+let anchorDebugCounter = 0;
+const anchorDebugIds = new WeakMap();
+function tagAnchorForDebug(node) {
+    if (isDebug()) {
+        anchorDebugCounter += 1;
+        anchorDebugIds.set(node, anchorDebugCounter);
+    }
+    return node;
+}
+// Diagnostic identity string for a renderer node/surface — component name, or 'surface'.
+// Null-tolerant: a diagnostic must never throw (Angular hands insertBefore a null refChild).
+function describeHost(node) {
+    if (node === null || node === undefined)
+        return 'null';
+    if (isSurface(node))
+        return 'surface';
+    const anchorId = anchorDebugIds.get(node);
+    return anchorId !== undefined ? `${node.component}#${anchorId}` : node.component;
+}
+const PRIMITIVE_SELECTOR_ALIAS = {
+    // Public ergonomic selectors map directly to the engine primitive descriptors.
+    View: 'symbiote-view',
+    Text: 'symbiote-text',
+};
+// The ANCHOR_HOST_COMPONENTS Set and registerComposedComponent now live in the dependency-free
+// leaf module ../anchor-host-registry (imported above as isAnchorHostComponent) — see its header
+// for why the registry must NOT sit in this require-cyclic renderer module.
+// Inserting a bare raw-text node anywhere but inside a <Text> is invalid in Fabric (a
+// stray RCTRawText would paint). Angular's ɵɵtext only ever lands text inside a <Text>,
+// but guard anyway for parity with the Vue adapter and to fail loudly on a bad template.
+function assertTextPlacement(child, parent) {
+    if (isRawText(child) && (isSurface(parent) || !parent.isText)) {
+        throw new Error(`Text string "${String(child.props.text)}" must be rendered inside a <Text>`);
+    }
+}
+// One renderer per mounted surface. Every mutation asks the surface to (microtask-
+// coalesced) recommit — the same seam Vue uses; a burst of Angular change-detection
+// mutations collapses into one completeRoot.
+export class SymbioteRenderer {
+    surface;
+    data = {};
+    // Angular calls destroyNode per-node only when this is non-null; teardown happens in
+    // render.ts (unmount), so per-node cleanup is a no-op.
+    destroyNode = null;
+    constructor(surface) {
+        this.surface = surface;
+    }
+    destroy() { }
+    createElement(name) {
+        // `name` is the component's host tag — a symbiote intrinsic (`symbiote-view`,
+        // `symbiote-text`, …), a public ergonomic alias (`View`, `Text`), or a raw Fabric view
+        // name for a native leaf. Public aliases are normalized to their engine primitive name
+        // before descriptor lookup. descriptorFor resolves it; an unknown `symbiote-*` is a typo,
+        // any other string flows through as a raw Fabric name (events/processors derived from its
+        // ViewConfig). toPublicInstance grafts the imperative API (measure / setNativeProps /
+        // focus) onto the raw node in place, returning the SAME identity the commit mirror keys on.
+        const engineName = PRIMITIVE_SELECTOR_ALIAS[name] ?? name;
+        if (isAnchorHostComponent(engineName)) {
+            const anchor = tagAnchorForDebug(createAnchor());
+            dlog(`angular createElement ${name} -> anchor host ${describeHost(anchor)}`);
+            return anchor;
+        }
+        const descriptor = descriptorFor(engineName);
+        const node = createElement(descriptor.component, descriptor.isText);
+        dlog(`angular createElement ${name} -> ${descriptor.component}`);
+        return toPublicInstance(node);
+    }
+    createComment() {
+        // Angular structural directives (*ngIf / @if / @for) need anchor nodes to track
+        // position. A real retained node the commit walk SKIPS — no native view. Twin of the
+        // Vue createComment path.
+        const anchor = tagAnchorForDebug(createAnchor());
+        dlog(`Angular renderer createComment -> ${describeHost(anchor)}`);
+        return anchor;
+    }
+    createText(value) {
+        return createRawText(value);
+    }
+    appendChild(parent, newChild) {
+        // Angular defers insertion for content awaiting its host component's own projection
+        // (see parentNode below) — mirrors Angular's own `if (parentRNode !== null)` guard in
+        // addLViewToLContainer: skip silently now, the later projection pass places it correctly.
+        if (parent === null)
+            return;
+        assertTextPlacement(newChild, parent);
+        if (isSurface(parent)) {
+            dlog(`Angular renderer appendChild parent=surface child=${describeHost(newChild)}`);
+            parent.appendChild(newChild);
+        }
+        else {
+            const projection = getScrollViewProjection(parent);
+            dlog(`Angular renderer appendChild parent=${describeHost(parent)} child=${describeHost(newChild)} projection=${projection !== undefined}`);
+            if (projection !== undefined) {
+                projection.appendProjectedChild(parent, newChild, (target, child) => appendChild(target, child));
+            }
+            else {
+                appendChild(parent, newChild);
+            }
+        }
+        this.surface.requestCommit();
+    }
+    insertBefore(parent, newChild, refChild) {
+        if (parent === null)
+            return; // see the appendChild guard above
+        assertTextPlacement(newChild, parent);
+        if (isSurface(parent)) {
+            dlog(`Angular renderer insertBefore parent=surface child=${describeHost(newChild)} ref=${refChild ? describeHost(refChild) : 'null'}`);
+            if (refChild)
+                parent.insertBefore(newChild, refChild);
+            else
+                parent.appendChild(newChild);
+        }
+        else {
+            const projection = getScrollViewProjection(parent);
+            dlog(`Angular renderer insertBefore parent=${describeHost(parent)} child=${describeHost(newChild)} ref=${refChild ? describeHost(refChild) : 'null'} projection=${projection !== undefined}`);
+            if (projection !== undefined) {
+                projection.insertProjectedChild(parent, newChild, refChild, (target, child, before) => {
+                    if (before === undefined)
+                        appendChild(target, child);
+                    else
+                        insertBefore(target, child, before);
+                });
+            }
+            else if (refChild) {
+                insertBefore(parent, newChild, refChild);
+            }
+            else {
+                appendChild(parent, newChild);
+            }
+        }
+        this.surface.requestCommit();
+    }
+    removeChild(_parent, oldChild) {
+        // Detach from the child's own retained parent (a top-level node lives in
+        // surface.children with no parent). Angular's `parent` arg is ignored in favor of the
+        // authoritative link, mirroring the Vue adapter's remove.
+        const angularParent = _parent !== null ? describeHost(_parent) : 'null';
+        const retainedParent = oldChild.parent !== undefined ? describeHost(oldChild.parent) : 'none';
+        const wasProjected = removeScrollViewProjectedChild(oldChild, (parent, child) => removeChild(parent, child));
+        dlog(`Angular renderer removeChild angularParent=${angularParent} retainedParent=${retainedParent} child=${describeHost(oldChild)} viaProjection=${wasProjected}`);
+        if (!wasProjected) {
+            const parent = oldChild.parent;
+            if (parent !== undefined)
+                removeChild(parent, oldChild);
+            else
+                this.surface.removeChild(oldChild);
+        }
+        this.surface.requestCommit();
+    }
+    // FlatList/VirtualizedList cells are content projected into a component host (our
+    // ANCHOR_HOST_COMPONENTS, e.g. ScrollView) — Angular's own addLViewToLContainer
+    // (.vendors/angular node_manipulation.ts/container.ts) treats a null parent here as "defer —
+    // the child component's own <ng-content>/ɵɵprojection will place this once its structure
+    // resolves" (e.g. ScrollView's `@if(isHorizontal)` branch). Renderer2's contract types this
+    // return as nullable for exactly that reason; returning `this.surface` as a non-null fallback
+    // defeated that defer check and caused premature top-level insertion (2026-07: FlatList cells
+    // rendered outside their ScrollView).
+    //
+    // Safe only because appendChild/insertBefore above now also treat a null parent as "skip, wait
+    // for projection" — a second Angular call site (`insertAnchorNode`, hit whenever a directive
+    // does `inject(ViewContainerRef)`, e.g. VListOutletDirective) forwards this null straight into
+    // insertBefore without checking it; without that guard it crashed on-device.
+    parentNode(node) {
+        return node.parent ?? null;
+    }
+    nextSibling(node) {
+        const siblings = node.parent !== undefined ? node.parent.children : this.surface.children;
+        const index = siblings.indexOf(node);
+        return index >= 0 ? (siblings[index + 1] ?? null) : null;
+    }
+    // locateHostElement always routes createComponent's `hostElement` THROUGH here as
+    // `selectorOrNode` (Angular's own core.mjs) — it is never bypassed just because a real
+    // object (vs. a selector string) was given. A string only reaches us on the (unused here)
+    // selector-string bootstrap path, so the surface is the fallback for that case only.
+    selectRootElement(selectorOrNode) {
+        return typeof selectorOrNode === 'string' ? this.surface : selectorOrNode;
+    }
+    setAttribute(el, name, value) {
+        if (isSurface(el))
+            return;
+        routeProp(el, name, value);
+        this.surface.requestCommit();
+    }
+    removeAttribute(el, name) {
+        if (isSurface(el))
+            return;
+        routeProp(el, name, undefined);
+        this.surface.requestCommit();
+    }
+    // Ivy compiles every class= / [class.foo] / [ngClass] form down to per-token addClass/
+    // removeClass calls (never a single setAttribute('class', ...) call), so a per-node token set
+    // is accumulated here and re-joined into one string on every change, then handed to
+    // routeProp('class', ...) exactly like Vue's template `class="..."` and React's JSX
+    // `className="..."` — all three resolve through the SAME centralized class+style merge in
+    // core/engine/src/node.ts, so a class registered via the SFC/CSS-Modules style compiler
+    // resolves identically regardless of adapter.
+    classTokens = new WeakMap();
+    addClass(el, name) {
+        if (isSurface(el))
+            return;
+        const tokens = this.classTokens.get(el) ?? new Set();
+        tokens.add(name);
+        this.classTokens.set(el, tokens);
+        routeProp(el, 'class', [...tokens].join(' '));
+        this.surface.requestCommit();
+    }
+    removeClass(el, name) {
+        if (isSurface(el))
+            return;
+        const tokens = this.classTokens.get(el);
+        if (tokens === undefined)
+            return;
+        tokens.delete(name);
+        routeProp(el, 'class', tokens.size > 0 ? [...tokens].join(' ') : undefined);
+        this.surface.requestCommit();
+    }
+    // Angular decomposes a [style] binding into per-key setStyle calls (ɵɵstyleMap). RN wants
+    // the whole style object as one `style` prop, so merge each key into it — onto the explicit
+    // style half tracked by routeProp's centralized class+style merge (core/engine/src/node.ts),
+    // NOT el.props.style directly: that may now be the [classStyle, explicitStyle] array the
+    // merge writes, and spreading an array as a record would silently produce numeric-index keys.
+    setStyle(el, style, value) {
+        if (isSurface(el))
+            return;
+        const current = getExplicitStyle(el);
+        const base = isRecord(current) ? current : {};
+        routeProp(el, 'style', { ...base, [style]: value });
+        this.surface.requestCommit();
+    }
+    removeStyle(el, style) {
+        if (isSurface(el))
+            return;
+        const current = getExplicitStyle(el);
+        if (!isRecord(current))
+            return;
+        const { [style]: _removed, ...rest } = current;
+        routeProp(el, 'style', rest);
+        this.surface.requestCommit();
+    }
+    // [prop]="x" bindings. routeProp makes the prop-vs-event decision from the node's
+    // ViewConfig (identical to React/Vue), so the whole flat-bag prop layer is shared.
+    setProperty(el, name, value) {
+        if (isSurface(el))
+            return;
+        routeProp(el, name, value);
+        this.surface.requestCommit();
+    }
+    setValue(node, value) {
+        // A useful permanent seam: text mutations are low-frequency and the one place a stale
+        // `{{binding}}` (a change-detection gap) shows up as "the setValue never fired".
+        dlog(`Angular renderer setValue "${value}" on ${describeHost(node)}`);
+        setText(node, value);
+        this.surface.requestCommit();
+    }
+    // (event)="x" bindings. Angular hands the event name EXPLICITLY (no onX->x inference),
+    // so we drive the engine's structural event channel directly — the path setEventListener
+    // in core/engine/src/node.ts already names "Angular Renderer2.listen" for. Global targets
+    // (window/document/body) have no Fabric node, so they no-op.
+    listen(target, eventName, callback) {
+        if (!isSymbioteNode(target))
+            return () => { };
+        setEventListener(target, eventName, callback);
+        return () => setEventListener(target, eventName, undefined);
+    }
+}
+// Provided to Angular as RendererFactory2; createRenderer returns the single
+// surface-bound renderer for every component (begin/end commit-coalescing is unnecessary —
+// requestCommit already microtask-coalesces).
+export class SymbioteRendererFactory {
+    surface;
+    renderer;
+    constructor(surface) {
+        this.surface = surface;
+    }
+    createRenderer(_hostElement, _type) {
+        return (this.renderer ??= new SymbioteRenderer(this.surface));
+    }
+}
+//# sourceMappingURL=index.js.map

package/build/angular/renderer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/renderer/index.ts"],"names":[],"mappings":"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"}

package/build/angular/services/color-scheme.service.d.ts

@@ -0,0 +1,16 @@
+import { type IColorSchemeName } from '@symbiote-native/engine';
+import * as i0 from "@angular/core";
+/**
+ * Angular twin of React's `useColorScheme` and Vue's `useColorScheme` composable. The service
+ * holds a Signal that tracks the device color scheme; consumers read it via `inject`:
+ *
+ *   readonly colorScheme = inject(ColorSchemeService).colorScheme;
+ *
+ * State and lifecycle live in DI, not in a function closure.
+ */
+export declare class ColorSchemeService {
+    readonly colorScheme: import("@angular/core").WritableSignal<IColorSchemeName | null>;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<ColorSchemeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ColorSchemeService>;
+}

package/build/angular/services/color-scheme.service.js

@@ -0,0 +1,31 @@
+import { DestroyRef, inject, Injectable, signal } from '@angular/core';
+import { Appearance } from '@symbiote-native/engine';
+import * as i0 from "@angular/core";
+/**
+ * Angular twin of React's `useColorScheme` and Vue's `useColorScheme` composable. The service
+ * holds a Signal that tracks the device color scheme; consumers read it via `inject`:
+ *
+ *   readonly colorScheme = inject(ColorSchemeService).colorScheme;
+ *
+ * State and lifecycle live in DI, not in a function closure.
+ */
+export class ColorSchemeService {
+    colorScheme = signal(Appearance.getColorScheme(), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "colorScheme" }] : /* istanbul ignore next */ []));
+    constructor() {
+        const destroyRef = inject(DestroyRef);
+        const subscription = Appearance.addChangeListener(preferences => {
+            this.colorScheme.set(preferences.colorScheme);
+        });
+        destroyRef.onDestroy(() => {
+            subscription.remove();
+        });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: ColorSchemeService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: ColorSchemeService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: ColorSchemeService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [] });
+//# sourceMappingURL=color-scheme.service.js.map

package/build/angular/services/color-scheme.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-scheme.service.js","sourceRoot":"","sources":["../../../src/services/color-scheme.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,UAAU,EAAyB,MAAM,yBAAyB,CAAC;;AAE5E;;;;;;;GAOG;AAEH,MAAM,OAAO,kBAAkB;IACpB,WAAW,GAAG,MAAM,CAA0B,UAAU,CAAC,cAAc,EAAE;oFAAC,CAAC;IAEpF;QACE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QAEtC,MAAM,YAAY,GAAG,UAAU,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE;YAC9D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,SAAS,CAAC,GAAG,EAAE;YACxB,YAAY,CAAC,MAAM,EAAE,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;uGAbU,kBAAkB;2GAAlB,kBAAkB,cADL,MAAM;;2FACnB,kBAAkB;kBAD9B,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE"}

package/build/angular/services/index.d.ts

@@ -0,0 +1,2 @@
+export { ColorSchemeService } from './color-scheme.service';
+export { WindowDimensionsService } from './window-dimensions.service';

package/build/angular/services/index.js

@@ -0,0 +1,3 @@
+export { ColorSchemeService } from './color-scheme.service';
+export { WindowDimensionsService } from './window-dimensions.service';
+//# sourceMappingURL=index.js.map

package/build/angular/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC"}

package/build/angular/services/window-dimensions.service.d.ts

@@ -0,0 +1,16 @@
+import { type IDisplayMetrics } from '@symbiote-native/engine';
+import * as i0 from "@angular/core";
+/**
+ * Angular twin of React's `useWindowDimensions` and Vue's `useWindowDimensions` composable. The
+ * service holds a Signal that tracks window metrics; consumers read it via `inject`:
+ *
+ *   readonly dimensions = inject(WindowDimensionsService).dimensions;
+ *
+ * State and lifecycle live in DI, not in a function closure.
+ */
+export declare class WindowDimensionsService {
+    readonly dimensions: import("@angular/core").WritableSignal<IDisplayMetrics>;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<WindowDimensionsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WindowDimensionsService>;
+}