@symbiote-native/engine 0.2.0 → 0.4.0

package/build/animated/operators.js

@@ -57,7 +57,10 @@ export class AnimatedAddition extends AnimatedBinaryOp {
         return a + b;
     }
     __getNativeConfig() {
-        return { type: 'addition', input: [this.a.__getNativeTag(), this.b.__getNativeTag()] };
+        return {
+            type: 'addition',
+            input: [this.a.__getNativeTag(), this.b.__getNativeTag()],
+        };
     }
 }
 export class AnimatedSubtraction extends AnimatedBinaryOp {
@@ -65,7 +68,10 @@ export class AnimatedSubtraction extends AnimatedBinaryOp {
         return a - b;
     }
     __getNativeConfig() {
-        return { type: 'subtraction', input: [this.a.__getNativeTag(), this.b.__getNativeTag()] };
+        return {
+            type: 'subtraction',
+            input: [this.a.__getNativeTag(), this.b.__getNativeTag()],
+        };
     }
 }
 export class AnimatedMultiplication extends AnimatedBinaryOp {
@@ -73,7 +79,10 @@ export class AnimatedMultiplication extends AnimatedBinaryOp {
         return a * b;
     }
     __getNativeConfig() {
-        return { type: 'multiplication', input: [this.a.__getNativeTag(), this.b.__getNativeTag()] };
+        return {
+            type: 'multiplication',
+            input: [this.a.__getNativeTag(), this.b.__getNativeTag()],
+        };
     }
 }
 export class AnimatedDivision extends AnimatedBinaryOp {
@@ -97,7 +106,10 @@ export class AnimatedDivision extends AnimatedBinaryOp {
         return a / b;
     }
     __getNativeConfig() {
-        return { type: 'division', input: [this.a.__getNativeTag(), this.b.__getNativeTag()] };
+        return {
+            type: 'division',
+            input: [this.a.__getNativeTag(), this.b.__getNativeTag()],
+        };
     }
 }
 export class AnimatedModulo extends AnimatedWithChildren {
@@ -127,7 +139,11 @@ export class AnimatedModulo extends AnimatedWithChildren {
         super.__makeNative(platformConfig);
     }
     __getNativeConfig() {
-        return { type: 'modulus', input: this.a.__getNativeTag(), modulus: this.modulus };
+        return {
+            type: 'modulus',
+            input: this.a.__getNativeTag(),
+            modulus: this.modulus,
+        };
     }
 }
 export class AnimatedDiffClamp extends AnimatedWithChildren {
@@ -167,7 +183,12 @@ export class AnimatedDiffClamp extends AnimatedWithChildren {
         super.__makeNative(platformConfig);
     }
     __getNativeConfig() {
-        return { type: 'diffclamp', input: this.a.__getNativeTag(), min: this.min, max: this.max };
+        return {
+            type: 'diffclamp',
+            input: this.a.__getNativeTag(),
+            min: this.min,
+            max: this.max,
+        };
     }
 }
 export function add(a, b) {

package/build/animated/props.js

@@ -15,7 +15,7 @@ import { AnimatedNode, AnimatedWithChildren } from './graph.js';
 import { setNativeProps, getNativeTag } from '../commit.js';
 import { isSymbioteNode } from '../node.js';
 import { registerPostCommit } from '../post-commit.js';
-import { nativeAnimated } from './native/native-animated.js';
+import { nativeAnimated, } from './native/native-animated.js';
 import { AnimatedStyle } from './style.js';
 function isAnimatedNode(value) {
     return value instanceof AnimatedNode;

package/build/animated/rgba.js

@@ -16,7 +16,12 @@ export const DEFAULT_COLOR = { r: 0, g: 0, b: 0, a: 1 };
 export function normalizeColor(color) {
     if (typeof color === 'number') {
         const c = color >>> 0;
-        return { r: (c >>> 24) & 255, g: (c >>> 16) & 255, b: (c >>> 8) & 255, a: (c & 255) / 255 };
+        return {
+            r: (c >>> 24) & 255,
+            g: (c >>> 16) & 255,
+            b: (c >>> 8) & 255,
+            a: (c & 255) / 255,
+        };
     }
     const trimmed = color.trim();
     if (trimmed.startsWith('#'))
@@ -42,7 +47,12 @@ function parseHex(hex) {
         return { r: (int >>> 16) & 255, g: (int >>> 8) & 255, b: int & 255, a: 1 };
     }
     const c = int >>> 0;
-    return { r: (c >>> 24) & 255, g: (c >>> 16) & 255, b: (c >>> 8) & 255, a: (c & 255) / 255 };
+    return {
+        r: (c >>> 24) & 255,
+        g: (c >>> 16) & 255,
+        b: (c >>> 8) & 255,
+        a: (c & 255) / 255,
+    };
 }
 function parseRgb(str) {
     const match = /^rgba?\(([^)]+)\)$/i.exec(str);
@@ -51,5 +61,10 @@ function parseRgb(str) {
     const parts = match[1].split(',').map(part => Number.parseFloat(part.trim()));
     if (parts.length < 3 || parts.some(n => Number.isNaN(n)))
         return undefined;
-    return { r: parts[0], g: parts[1], b: parts[2], a: parts.length >= 4 ? parts[3] : 1 };
+    return {
+        r: parts[0],
+        g: parts[1],
+        b: parts[2],
+        a: parts.length >= 4 ? parts[3] : 1,
+    };
 }

package/build/animated/style.js

@@ -73,7 +73,9 @@ export class AnimatedTransform extends AnimatedWithChildren {
             const result = {};
             for (const key of Object.keys(entry)) {
                 const value = entry[key];
-                result[key] = isAnimatedNode(value) ? value.__getAnimatedValue() : value;
+                result[key] = isAnimatedNode(value)
+                    ? value.__getAnimatedValue()
+                    : value;
             }
             return result;
         });
@@ -96,10 +98,18 @@ export class AnimatedTransform extends AnimatedWithChildren {
                 const value = entry[key];
                 if (isAnimatedNode(value)) {
                     // __getNativeTag only: creation is edge-free; the connect is a later phase.
-                    transforms.push({ type: 'animated', property: key, nodeTag: value.__getNativeTag() });
+                    transforms.push({
+                        type: 'animated',
+                        property: key,
+                        nodeTag: value.__getNativeTag(),
+                    });
                 }
                 else {
-                    transforms.push({ type: 'static', property: key, value: transformDataType(value) });
+                    transforms.push({
+                        type: 'static',
+                        property: key,
+                        value: transformDataType(value),
+                    });
                 }
             }
         }

package/build/animated/value-xy.d.ts

@@ -26,10 +26,13 @@ export declare class AnimatedValueXY {
         left: AnimatedValue;
         top: AnimatedValue;
     };
-    getTranslateTransform(): [{
-        translateX: AnimatedValue;
-    }, {
-        translateY: AnimatedValue;
-    }];
+    getTranslateTransform(): [
+        {
+            translateX: AnimatedValue;
+        },
+        {
+            translateY: AnimatedValue;
+        }
+    ];
 }
 export {};

package/build/animated/value-xy.js

@@ -17,7 +17,10 @@ export class AnimatedValueXY {
     // Each joint id maps to the two per-axis listener ids it registered, so
     // removeListener can tear both down together.
     jointListeners = new Map();
-    constructor(value = { x: 0, y: 0 }) {
+    constructor(value = {
+        x: 0,
+        y: 0,
+    }) {
         if (typeof value.x === 'number' && typeof value.y === 'number') {
             this.x = new AnimatedValue(value.x);
             this.y = new AnimatedValue(value.y);

package/build/app-registry/index.d.ts

@@ -14,6 +14,7 @@ export type ITaskCanceller = () => void;
 export type ITaskCancelProvider = () => ITaskCanceller;
 export interface IHostRegistrar {
     registerRunnable(appKey: string, run: IRunnable): string;
+    registerCancellableHeadlessTask?(taskKey: string, taskProvider: ITaskProvider, taskCancelProvider: ITaskCancelProvider): void;
     unmountAtRootTag?(rootTag: IRootTag): void;
 }
 export interface IAppRegistry<TComponentProvider, TWrapperComponentProvider> {

package/build/app-registry/index.js

@@ -6,11 +6,9 @@
 // the one thing each adapter supplies; everything else (registry bookkeeping, sections, the
 // host-registrar bridge, headless tasks) is byte-identical across adapters and lives here once.
 //
-// The catch: the native Fabric host invokes RN's AppRegistry (a registered callable module) by
-// app key, and it can't see ours. So registerComponent must also hand its runnable to RN's
-// registrar. Reached the same way shared reaches processColor: a dependency-injected seam
-// (setHostRegistrar), so the core stays react-native-free and the app glue wires the host once
-// at startup.
+// The catch: native invokes RN's registered callable AppRegistry for both surface runnables and
+// headless tasks; it cannot see this local registry. `setHostRegistrar` mirrors those native-facing
+// registrations there while the core remains react-native-free.
 import { getNativeModule } from '../native-modules/index.js';
 import { dlog } from '../debug.js';
 const HEADLESS_TASK_MODULE = 'HeadlessJsTaskSupport';
@@ -121,6 +119,7 @@ export function createAppRegistry(runnableFor) {
             }
             taskProviders.set(taskKey, taskProvider);
             taskCancelProviders.set(taskKey, taskCancelProvider);
+            hostRegistrar?.registerCancellableHeadlessTask?.(taskKey, taskProvider, taskCancelProvider);
         },
         startHeadlessTask(taskId, taskKey, data) {
             runHeadlessTask(taskId, taskKey, data);
@@ -138,7 +137,18 @@ export function createAppRegistry(runnableFor) {
     return {
         AppRegistry,
         setHostRegistrar(registrar) {
+            if (hostRegistrar === registrar)
+                return;
             hostRegistrar = registrar;
+            // Headless tasks are commonly registered before adapter bootstrap attaches RN's callable
+            // AppRegistry. Replay only this missing native-facing registry; app runnables retain their
+            // existing register-after-bootstrap contract.
+            for (const [taskKey, taskProvider] of taskProviders) {
+                const taskCancelProvider = taskCancelProviders.get(taskKey);
+                if (taskCancelProvider !== undefined) {
+                    registrar.registerCancellableHeadlessTask?.(taskKey, taskProvider, taskCancelProvider);
+                }
+            }
         },
     };
 }

package/build/appearance/index.js

@@ -62,7 +62,10 @@ export const Appearance = {
             return;
         }
         module.setColorScheme(colorScheme);
-        cachedScheme = colorScheme === 'unspecified' ? (module.getColorScheme() ?? null) : colorScheme;
+        cachedScheme =
+            colorScheme === 'unspecified'
+                ? (module.getColorScheme() ?? null)
+                : colorScheme;
     },
     // Subscribe to color-scheme changes. The listener receives `{ colorScheme }`.
     addChangeListener(listener) {

package/build/commit.d.ts

@@ -1,9 +1,44 @@
 import { type IFabricNode, type IRootTag, type IMeasureOnSuccess, type IMeasureInWindowOnSuccess, type IMeasureLayoutOnSuccess } from './fabric';
 import { type ISymbioteNode } from './node';
 export { processColor, setColorProcessor } from './platform-color';
+declare global {
+    var __SYMBIOTE_BATCH_CREATE__: boolean | undefined;
+}
 export declare function disposeRoot(rootTag: IRootTag): void;
 export declare function commitChildren(rootTag: IRootTag, children: readonly ISymbioteNode[]): void;
+export interface ICommitProfile {
+    commits: number;
+    walkMs: number;
+    nodesVisited: number;
+    /** Update-path nodes that rebuilt their Fabric payload and deep-compared it. */
+    propsBuilt: number;
+    /** Update-path nodes that re-cloned for a child but reused the committed payload by reference. */
+    propsReused: number;
+    propWrites: number;
+    propNoops: number;
+    childScans: number;
+    childScanProbed: number;
+    childFlattens: number;
+    childFlattenProbed: number;
+    childFlattenWidest: number;
+}
+export declare function readCommitProfile(): ICommitProfile;
+export declare function flushNativeProps(): void;
 export declare function setNativeProps(node: ISymbioteNode, partial: Record<string, unknown>): void;
+/**
+ * Publish a node whose props were changed OUTSIDE any renderer mutation.
+ *
+ * Dirtying is not publishing. Every other write reaches Fabric because the framework's own commit
+ * follows it; a change driven by a NATIVE EVENT has no such follow-up — `native-events.ts`
+ * requests no commit and no adapter does either, so a node marked dirty from an event handler
+ * simply stays dirty. The host-behavior press path (`setNodePressed` for `:active`) is the first
+ * caller that is not `setNativeProps`, and `setNodeHidden`'s React twin never needed it because
+ * the reconciler is already in its commit phase when it calls.
+ *
+ * Queued rather than committed on the spot, sharing `setNativeProps`' batch: several writes in one
+ * task publish together at the microtask boundary, one commit per surface.
+ */
+export declare function requestCommitFor(node: ISymbioteNode): void;
 export declare function getNativeTag(node: ISymbioteNode): number | undefined;
 export declare function whenCommitted(node: ISymbioteNode, action: () => void): () => void;
 export declare function getNativeNode(node: ISymbioteNode): IFabricNode | undefined;