@symbiote-native/angular 0.6.2 → 0.8.0

package/src/services/window-dimensions.service.ts

@@ -1,5 +1,9 @@
 import { DestroyRef, inject, Injectable, signal } from '@angular/core';
-import { Dimensions, type IDimensionsSet, type IDisplayMetrics } from '@symbiote-native/engine';
+import {
+  Dimensions,
+  type IDimensionsSet,
+  type IDisplayMetrics,
+} from '@symbiote-native/engine';
 
 /**
  * Angular twin of React's `useWindowDimensions` and Vue's `useWindowDimensions` composable. The
@@ -28,9 +32,12 @@ export class WindowDimensionsService {
       }
     };
 
-    const subscription = Dimensions.addEventListener('change', (set: IDimensionsSet) => {
-      handleChange(set.window);
-    });
+    const subscription = Dimensions.addEventListener(
+      'change',
+      (set: IDimensionsSet) => {
+        handleChange(set.window);
+      },
+    );
     // Re-check once after subscribing to close the gap between construction and the listener.
     handleChange(Dimensions.get('window'));
 

package/build/angular/modules/animated/animated-leaf-binder/index.d.ts

@@ -1,14 +0,0 @@
-import { type ISymbioteNode } from '@symbiote-native/engine';
-export declare class AnimatedLeafBinder {
-    private readonly resolveNode;
-    private readonly label;
-    private attached;
-    private cancelBind;
-    private eventDetachers;
-    constructor(resolveNode: () => ISymbioteNode | null, label: string);
-    reconcile(props: Record<string, unknown>, wantsNative: boolean): void;
-    private bindNode;
-    private attachEvents;
-    private detachEvents;
-    destroy(): void;
-}

package/build/angular/modules/animated/animated-leaf-binder/index.js

@@ -1,91 +0,0 @@
-// Pure Fabrication (GRASP): the leaf-lifecycle orchestration shared by every Animated*
-// wrapper, extracted out of AnimatedComponentBase so AnimatedImage — which cannot extend
-// AnimatedComponentBase, since it must extend ImageBase for TS's-native image handling —
-// gets the SAME logic via composition instead of copy-pasting it. Framework-thin on
-// purpose: it knows nothing about Angular (@ViewChild, DI, change detection), only the
-// engine's Animated leaf + commit primitives, so it stays testable without any Angular
-// bootstrap. NOTE: react/vue drive this same dance through their own runtime HOC
-// (createAnimatedComponent) rather than a class, so there is no cross-adapter dedup
-// opportunity here yet — this Pure Fabrication is local to the angular adapter.
-import { AnimatedProps, attachNativeEventHandler, dlog, whenCommitted, } from '@symbiote-native/engine';
-export class AnimatedLeafBinder {
-    resolveNode;
-    label;
-    // The leaf currently wired into the value graph. Null until the first reconcile.
-    attached = null;
-    // The whenCommitted waiter for the current leaf's node binding, cancelled before the next.
-    cancelBind;
-    // Detachers for any Animated.event prop bound natively to the committed node (JS path: none).
-    eventDetachers = [];
-    // `resolveNode` stays a caller-supplied resolver (not a constructor-captured node) so this
-    // class never needs to know HOW the host node is found — AnimatedComponentBase and
-    // AnimatedImage both resolve it the same way (resolveHostNode + isSymbioteNode over their
-    // own @ViewChild), but that's Angular DI state this binder has no business touching.
-    // `label` is purely diagnostic (dlog), mirroring the constructor.name the pre-extraction
-    // dlog call used.
-    constructor(resolveNode, label) {
-        this.resolveNode = resolveNode;
-        this.label = label;
-    }
-    // Build a fresh AnimatedProps leaf from the current props (the React/Vue per-render
-    // useMemo(rest)), wire it into the graph, and swap the previous one out. Attach the NEW leaf
-    // BEFORE detaching the OLD one: a shared Value self-detaches (dropping its native node) the
-    // instant its child count hits zero, so detaching first would kill a running native animation
-    // on any unrelated re-render (mirrors RN's AnimatedComponent._attachProps). Then bind the
-    // committed node, go native if wanted, and rebind native events.
-    reconcile(props, wantsNative) {
-        dlog(`${this.label} reconcile`);
-        const newLeaf = new AnimatedProps(props);
-        newLeaf.__attach();
-        if (this.attached !== null && this.attached !== newLeaf)
-            this.attached.__detach();
-        this.attached = newLeaf;
-        this.bindNode(newLeaf, props, wantsNative);
-    }
-    // Bind the leaf to the host's Fabric node THROUGH whenCommitted: under Angular's zoneless
-    // batched change detection the inner host's tag does not exist yet at ngAfterViewInit time
-    // (the same async-commit gotcha Vue documents), so binding eagerly would no-op. whenCommitted
-    // runs the action now if already committed, else after the commit that assigns the tag.
-    bindNode(leaf, props, wantsNative) {
-        this.cancelBind?.();
-        this.cancelBind = undefined;
-        const node = this.resolveNode();
-        if (node === null)
-            return;
-        this.cancelBind = whenCommitted(node, () => {
-            leaf.setNativeView(node);
-            if (wantsNative)
-                leaf.__makeNative();
-            this.attachEvents(node, props);
-        });
-    }
-    // Native-attach any Animated.event prop (e.g. onScroll={Animated.event(…,{useNativeDriver:true})})
-    // to the committed node. attachNativeEventHandler no-ops (returns undefined) unless the prop is a
-    // native event handler with a committed tag, so the JS path stays the fallback. Rebound each
-    // reconcile so a new inline event re-attaches; detached first to avoid leaking the prior binding.
-    attachEvents(node, props) {
-        this.detachEvents();
-        for (const key of Object.keys(props)) {
-            const attachment = attachNativeEventHandler(node, key, props[key]);
-            if (attachment !== undefined)
-                this.eventDetachers.push(attachment.detach);
-        }
-    }
-    detachEvents() {
-        for (const detach of this.eventDetachers)
-            detach();
-        this.eventDetachers = [];
-    }
-    // Tear down everything: cancel a still-pending bind, drop native event listeners, detach the
-    // current leaf from the value graph. Safe to call even if reconcile() was never called.
-    destroy() {
-        this.cancelBind?.();
-        this.cancelBind = undefined;
-        this.detachEvents();
-        if (this.attached !== null) {
-            this.attached.__detach();
-            this.attached = null;
-        }
-    }
-}
-//# sourceMappingURL=index.js.map

package/build/angular/modules/animated/animated-leaf-binder/index.js.map

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

package/src/modules/animated/animated-leaf-binder/index.ts

@@ -1,101 +0,0 @@
-// Pure Fabrication (GRASP): the leaf-lifecycle orchestration shared by every Animated*
-// wrapper, extracted out of AnimatedComponentBase so AnimatedImage — which cannot extend
-// AnimatedComponentBase, since it must extend ImageBase for TS's-native image handling —
-// gets the SAME logic via composition instead of copy-pasting it. Framework-thin on
-// purpose: it knows nothing about Angular (@ViewChild, DI, change detection), only the
-// engine's Animated leaf + commit primitives, so it stays testable without any Angular
-// bootstrap. NOTE: react/vue drive this same dance through their own runtime HOC
-// (createAnimatedComponent) rather than a class, so there is no cross-adapter dedup
-// opportunity here yet — this Pure Fabrication is local to the angular adapter.
-import {
-  AnimatedProps,
-  attachNativeEventHandler,
-  dlog,
-  whenCommitted,
-  type ISymbioteNode,
-} from '@symbiote-native/engine';
-
-export class AnimatedLeafBinder {
-  // The leaf currently wired into the value graph. Null until the first reconcile.
-  private attached: AnimatedProps | null = null;
-  // The whenCommitted waiter for the current leaf's node binding, cancelled before the next.
-  private cancelBind: (() => void) | undefined;
-  // Detachers for any Animated.event prop bound natively to the committed node (JS path: none).
-  private eventDetachers: Array<() => void> = [];
-
-  // `resolveNode` stays a caller-supplied resolver (not a constructor-captured node) so this
-  // class never needs to know HOW the host node is found — AnimatedComponentBase and
-  // AnimatedImage both resolve it the same way (resolveHostNode + isSymbioteNode over their
-  // own @ViewChild), but that's Angular DI state this binder has no business touching.
-  // `label` is purely diagnostic (dlog), mirroring the constructor.name the pre-extraction
-  // dlog call used.
-  constructor(
-    private readonly resolveNode: () => ISymbioteNode | null,
-    private readonly label: string,
-  ) {}
-
-  // Build a fresh AnimatedProps leaf from the current props (the React/Vue per-render
-  // useMemo(rest)), wire it into the graph, and swap the previous one out. Attach the NEW leaf
-  // BEFORE detaching the OLD one: a shared Value self-detaches (dropping its native node) the
-  // instant its child count hits zero, so detaching first would kill a running native animation
-  // on any unrelated re-render (mirrors RN's AnimatedComponent._attachProps). Then bind the
-  // committed node, go native if wanted, and rebind native events.
-  reconcile(props: Record<string, unknown>, wantsNative: boolean): void {
-    dlog(`${this.label} reconcile`);
-    const newLeaf = new AnimatedProps(props);
-    newLeaf.__attach();
-    if (this.attached !== null && this.attached !== newLeaf) this.attached.__detach();
-    this.attached = newLeaf;
-
-    this.bindNode(newLeaf, props, wantsNative);
-  }
-
-  // Bind the leaf to the host's Fabric node THROUGH whenCommitted: under Angular's zoneless
-  // batched change detection the inner host's tag does not exist yet at ngAfterViewInit time
-  // (the same async-commit gotcha Vue documents), so binding eagerly would no-op. whenCommitted
-  // runs the action now if already committed, else after the commit that assigns the tag.
-  private bindNode(
-    leaf: AnimatedProps,
-    props: Record<string, unknown>,
-    wantsNative: boolean,
-  ): void {
-    this.cancelBind?.();
-    this.cancelBind = undefined;
-    const node = this.resolveNode();
-    if (node === null) return;
-    this.cancelBind = whenCommitted(node, () => {
-      leaf.setNativeView(node);
-      if (wantsNative) leaf.__makeNative();
-      this.attachEvents(node, props);
-    });
-  }
-
-  // Native-attach any Animated.event prop (e.g. onScroll={Animated.event(…,{useNativeDriver:true})})
-  // to the committed node. attachNativeEventHandler no-ops (returns undefined) unless the prop is a
-  // native event handler with a committed tag, so the JS path stays the fallback. Rebound each
-  // reconcile so a new inline event re-attaches; detached first to avoid leaking the prior binding.
-  private attachEvents(node: ISymbioteNode, props: Record<string, unknown>): void {
-    this.detachEvents();
-    for (const key of Object.keys(props)) {
-      const attachment = attachNativeEventHandler(node, key, props[key]);
-      if (attachment !== undefined) this.eventDetachers.push(attachment.detach);
-    }
-  }
-
-  private detachEvents(): void {
-    for (const detach of this.eventDetachers) detach();
-    this.eventDetachers = [];
-  }
-
-  // Tear down everything: cancel a still-pending bind, drop native event listeners, detach the
-  // current leaf from the value graph. Safe to call even if reconcile() was never called.
-  destroy(): void {
-    this.cancelBind?.();
-    this.cancelBind = undefined;
-    this.detachEvents();
-    if (this.attached !== null) {
-      this.attached.__detach();
-      this.attached = null;
-    }
-  }
-}