@symbiote-native/engine 0.1.7 → 0.3.0

package/build/commit.js

@@ -13,20 +13,52 @@
 // references to specific child handles. That bubble is inherent to a persistent
 // tree and is exactly what React's own Fabric renderer does.
 import { getSlot, } from './fabric.js';
-import { createElement, debugNodeId, isAnchor, VIRTUAL_TEXT_COMPONENT, } from './node.js';
+import { createElement, debugNodeId, isAnchor, isEmptyRawText, markDirty, takePropStats, VIRTUAL_TEXT_COMPONENT, } from './node.js';
 import { dlog, isDebug } from './debug.js';
 import { flattenStyle } from './style/index.js';
 import { nextTag } from './tags.js';
 import { registerPostCommit, runPostCommitHooks } from './post-commit.js';
 import { fabricProps } from './fabric-props.js';
 import { isRecord } from './type-guards.js';
-// processColor/setColorProcessor now live in ./platform-color (the stable color-processing
-// leaf every color-touching module imports from); re-exported here so nothing outside this
-// module needs to change its import path.
+// Re-exported from ./platform-color so callers don't need to change their import path.
 export { processColor, setColorProcessor } from './platform-color/index.js';
 // Per-commit work counters, surfaced via dlog so a device run can prove the
 // engine is incremental (created=0 with clones after the first mount).
 const stats = { created: 0, cloneProps: 0, cloneChildren: 0, reused: 0 };
+// Cumulative cost of the reconcile walk. Unlike `stats` (per-commit, zeroed at the top of every
+// commit), this ACCUMULATES: one scroll frame produces a burst of commits and the frame's real cost
+// is only visible as their sum. Read-and-zeroed via readCommitProfile().
+//
+// Deliberately NOT gated behind isDebug(): two performance.now() calls per commit are noise next to
+// the walk they measure, and the number is only meaningful from a RELEASE build - dev-mode JS
+// drowns the signal. The dlog below stays gated as usual.
+const profile = { commits: 0, walkMs: 0, nodesVisited: 0 };
+// What `renderableChildren` costs, accumulated over the same window as `profile`. Anchors are the
+// only reason that function is not free, and how many a tree carries is a property of the ADAPTER,
+// not of the app: a Vue/React/Svelte/Solid component is a function returning children and allocates
+// no node, while an Angular component is bound to a host ELEMENT and therefore always has one
+// (anchor-host-registry.ts keeps it from painting). So the same screen is a no-anchor tree under
+// four adapters and an anchor-per-composed-component tree under the fifth, and only a counter tells
+// them apart at runtime - a source-level grep for "anchor" measures instrumentation density, not
+// trees.
+//
+// `scans` counts invocations; `probed` counts children actually examined by the fast-path probe,
+// which is why that probe is a counted loop rather than `.some()` (a `.some` short-circuits at the
+// first anchor, so children.length would overstate a defeated scan by however much it skipped).
+// `flattens` is the probe defeated: a fresh array, a second pass, and a recursion into every
+// anchor. `widest` is the widest single flatten in the window, because a defeated scan over 3
+// children is noise and one over 1000 is not - a count alone cannot separate them.
+//
+// Not gated behind isDebug(), for the same reason the rest of the profile is not: integer
+// increments are noise next to the array work they price, and the number is only meaningful from a
+// release build.
+const childScan = {
+    scans: 0,
+    probed: 0,
+    flattens: 0,
+    flattenProbed: 0,
+    widest: 0,
+};
 // Diagnostic (gated): Fabric serializes props to folly::dynamic, which rejects a JS
 // Symbol or function with "JS Symbols are not convertible to dynamic". A hard native
 // throw deep in cloneNode*. Walk a props payload and return the dotted path of the
@@ -81,7 +113,9 @@ function guardSerializable(propsDiff, viewName, tag) {
 function viewNameFor(node, hasTextAncestor) {
     // The only position-dependent name: a <Text> inside another <Text> becomes a
     // virtual span. Everything else is the component string the adapter chose.
-    return node.isText && hasTextAncestor ? VIRTUAL_TEXT_COMPONENT : node.component;
+    return node.isText && hasTextAncestor
+        ? VIRTUAL_TEXT_COMPONENT
+        : node.component;
 }
 // Fabric's clone*WithNewProps MERGES the raw payload onto the node's existing props,
 // so the payload must be a MINIMAL diff: only the keys that actually changed, plus any
@@ -131,18 +165,46 @@ function jsonEqual(a, b) {
     return keys.every(key => key in b && jsonEqual(a[key], b[key]));
 }
 const mirror = new WeakMap();
+function isSkippedAtCommit(node) {
+    return isAnchor(node) || isEmptyRawText(node);
+}
 function renderableChildren(node) {
     // Anchor nodes (Vue fragment/v-if/v-for placeholders, Angular component hosts that should
     // not paint) live in the retained tree for sibling ordering but never become Fabric views.
     // When an anchor owns children, flatten them into the parent's renderable list: this lets a
     // DOM-less framework use an anchor as a fragment/component host without adding a native
     // wrapper node. Fast path: no anchors reuses the array, so the common case allocates nothing.
-    if (!node.children.some(isAnchor))
+    // An empty raw text is skipped for a different reason and with no flattening: it has no
+    // children, and committing it aborts the app inside Fabric's text walk (isEmptyRawText).
+    //
+    // The probe is a counted loop rather than `.some()` only so childScan can price it honestly;
+    // see the childScan declaration for what the five counters mean and what they were built to
+    // settle.
+    childScan.scans += 1;
+    const total = node.children.length;
+    let index = 0;
+    while (index < total && !isSkippedAtCommit(node.children[index]))
+        index += 1;
+    // The defeating child was examined too, so it counts.
+    childScan.probed += index === total ? total : index + 1;
+    if (index === total)
         return node.children;
+    childScan.flattens += 1;
+    childScan.flattenProbed += total;
+    if (total > childScan.widest)
+        childScan.widest = total;
     const children = [];
     for (const child of node.children) {
-        if (isAnchor(child))
-            children.push(...renderableChildren(child));
+        if (isSkippedAtCommit(child)) {
+            // A skipped child is flattened away here and never reaches reconcile, so this is the only
+            // place that can clear its dirty flag. Leaving it set would be a silent stale-UI bug:
+            // markDirty stops at the first dirty ancestor, so a permanently-dirty skipped node swallows
+            // every later mark - from an anchor's subtree, or from the setText that turns an empty raw
+            // text back into real content - and the real parent never learns anything changed.
+            child.dirty = false;
+            if (isAnchor(child))
+                children.push(...renderableChildren(child));
+        }
         else
             children.push(child);
     }
@@ -168,13 +230,41 @@ function logScrollChildren(node, viewName, selfTag) {
     const flag = kids.length === 1 ? 'OK' : 'MULTI!!';
     dlog(`SCROLL-${flag} ${viewName} tag=${selfTag} children(${kids.length})=[${kids.join(',')}]`);
 }
+// The failure mode dirty-marking introduces: a mutation path that forgets to markDirty leaves a
+// node whose desired props have drifted from what Fabric holds, and the screen silently keeps
+// showing the old value - no error, no crash, nothing to grep for. So under DEBUG pay back the full
+// price just saved and verify the skip was honest, naming the node loudly enough to find the
+// missing mark.
+function warnIfStale(node, committed) {
+    if (!isDebug())
+        return;
+    const fresh = fabricProps(node);
+    if (propsEqual(committed.props, fresh))
+        return;
+    dlog(`DIRTY-MISS ${committed.viewName}#${committed.tag} node=${debugNodeId(node)} skipped as clean ` +
+        `but props differ: committed=${JSON.stringify(committed.props)} desired=${JSON.stringify(fresh)}`);
+}
 function reconcile(slot, node, rootTag, hasTextAncestor, renderableParent, forceFreshFamily) {
+    profile.nodesVisited += 1;
     const viewName = viewNameFor(node, hasTextAncestor);
+    const committed = mirror.get(node);
+    // Nothing under here changed: hand back the committed handle without rebuilding this node's
+    // Fabric props or descending into it at all. The walk below costs ~13 us/node on device, and an
+    // untouched sibling subtree would pay it on every commit. `committed.parent` is re-checked rather
+    // than trusted to the flag because a MOVED node can still be legitimately clean (see node.ts's
+    // structural ops), and a reparent must fall through to the fresh-family path below.
+    if (!forceFreshFamily &&
+        !node.dirty &&
+        committed !== undefined &&
+        committed.parent === renderableParent &&
+        committed.viewName === viewName) {
+        stats.reused += 1;
+        warnIfStale(node, committed);
+        return { handle: committed.handle, changed: false };
+    }
+    node.dirty = false;
     const props = fabricProps(node);
     const childInText = node.isText || hasTextAncestor;
-    const committed = mirror.get(node);
-    // The children that actually reach Fabric. Anchors are filtered out here so the
-    // whole walk (child-set emission, identity diff, mirror) is anchor-blind.
     const kids = renderableChildren(node);
     // First mount, or the view kind flipped (RCTText <-> RCTVirtualText when a
     // <Text> moves in or out of another <Text>): a different native component
@@ -199,7 +289,8 @@ function reconcile(slot, node, rootTag, hasTextAncestor, renderableParent, force
                 `bg=${JSON.stringify(props.backgroundColor)} color=${JSON.stringify(props.color)} ` +
                 `opacity=${JSON.stringify(props.opacity)}`);
         }
-        if (viewName === 'AndroidSwipeRefreshLayout' || viewName === 'RCTScrollView') {
+        if (viewName === 'AndroidSwipeRefreshLayout' ||
+            viewName === 'RCTScrollView') {
             dlog(`commit root=${rootTag} layoutProbe tag=${tag} view=${viewName} ` +
                 `flex=${JSON.stringify(props.flex)} height=${JSON.stringify(props.height)} ` +
                 `width=${JSON.stringify(props.width)} minHeight=${JSON.stringify(props.minHeight)} ` +
@@ -333,6 +424,13 @@ export function commitChildren(rootTag, children) {
 function commitContainer(rootTag) {
     const slot = getSlot();
     const container = rootContainerFor(rootTag);
+    // The synthetic container is dirtied here, at the one entry point, because markDirty can never
+    // bubble up to it: a surface's top-level nodes carry `parent === undefined` (surface.ts sets it
+    // deliberately), so a mark stops at the top-level node and the container above it stays clean -
+    // it would then early-exit and swallow the whole commit. Marking unconditionally costs one node's
+    // props rebuild per commit and closes the hole for both callers, mutation commit and
+    // setNativeProps alike.
+    markDirty(container);
     stats.created = 0;
     stats.cloneProps = 0;
     stats.cloneChildren = 0;
@@ -342,7 +440,11 @@ function commitContainer(rootTag) {
     // tree walk); if `start` itself never prints, the stall is upstream: React's commit
     // phase or the mutation ops before we are even called.
     dlog(`commit root=${rootTag} start children=${container.children.length}`);
+    const walkStart = performance.now();
     const result = reconcile(slot, container, rootTag, false, undefined, false);
+    const walkMs = performance.now() - walkStart;
+    profile.walkMs += walkMs;
+    profile.commits += 1;
     // Boundary seam: prints once reconcile returns. If a commit hangs and this line
     // never appears, the stall is inside reconcile (JS); if it appears but the
     // post-completeRoot line below never does, the stall is inside the native commit.
@@ -365,9 +467,34 @@ function commitContainer(rootTag) {
         const mode = stats.created > 0 && stats.reused === 0 ? 'full' : 'incremental';
         dlog(`commit root=${rootTag} ${mode} ` +
             `created=${stats.created} cloneProps=${stats.cloneProps} ` +
-            `cloneChildren=${stats.cloneChildren} reused=${stats.reused}`);
+            `cloneChildren=${stats.cloneChildren} reused=${stats.reused} ` +
+            `walk=${walkMs.toFixed(3)}ms`);
     }
 }
+export function readCommitProfile() {
+    const props = takePropStats();
+    const snapshot = {
+        commits: profile.commits,
+        walkMs: profile.walkMs,
+        nodesVisited: profile.nodesVisited,
+        propWrites: props.writes,
+        propNoops: props.noops,
+        childScans: childScan.scans,
+        childScanProbed: childScan.probed,
+        childFlattens: childScan.flattens,
+        childFlattenProbed: childScan.flattenProbed,
+        childFlattenWidest: childScan.widest,
+    };
+    profile.commits = 0;
+    profile.walkMs = 0;
+    profile.nodesVisited = 0;
+    childScan.scans = 0;
+    childScan.probed = 0;
+    childScan.flattens = 0;
+    childScan.flattenProbed = 0;
+    childScan.widest = 0;
+    return snapshot;
+}
 // Targeted per-frame prop write for the JS-driven Animated path. RN flushes an
 // animation frame with an in-place `instance.setNativeProps(...)`; we have no
 // in-place mutation (Fabric is persistent), so a frame is one scoped commit: mutate
@@ -386,12 +513,17 @@ export function setNativeProps(node, partial) {
             // A partial style override MERGES onto the declarative style (RN semantics):
             // setNativeProps({style:{backgroundColor}}) recolors without dropping height
             // or radius. Transient: the next React commit re-applies the full style.
-            node.props.style = { ...flattenStyle(node.props.style), ...flattenStyle(value) };
+            node.props.style = {
+                ...flattenStyle(node.props.style),
+                ...flattenStyle(value),
+            };
         }
         else {
             node.props[key] = value;
         }
     }
+    // Writes node.props directly rather than through setProp, so it owes its own mark.
+    markDirty(node);
     dlog(`setNativeProps root=${record.rootTag} tag=${record.tag} keys=${Object.keys(partial)}`);
     commitContainer(record.rootTag);
 }

package/build/debug.d.ts

@@ -2,4 +2,4 @@ declare global {
     var __SYMBIOTE_DEBUG__: boolean | undefined;
 }
 export declare function isDebug(): boolean;
-export declare function dlog(message: string): void;
+export declare function dlog(message: string | (() => string)): void;

package/build/debug.js

@@ -5,7 +5,13 @@
 //     Metro start (--reset-cache), not a rebuild.
 //   - runtime: globalThis.__SYMBIOTE_DEBUG__ = true, an escape hatch for hosts
 //     where the env isn't reachable.
-// Production with neither set pays one property read per call and nothing else.
+// Production with neither set pays one property read per call and nothing else -
+// but ONLY if the caller does not build the message itself first. A template
+// literal is evaluated at the CALL SITE, before dlog can decide anything, so a
+// `dlog(\`… ${JSON.stringify(x)}\`)` on a per-frame path costs its full price with
+// logging off. On a hot path (a getter Angular re-reads every change-detection
+// pass, an Animated reconcile, a scroll-driven apply) pass a THUNK instead:
+// `dlog(() => \`…\`)` - it is only called once the switch is on.
 function envEnabled() {
     return typeof process !== 'undefined' && process.env.DEBUG === '1';
 }
@@ -13,6 +19,7 @@ export function isDebug() {
     return globalThis.__SYMBIOTE_DEBUG__ === true || envEnabled();
 }
 export function dlog(message) {
-    if (isDebug())
-        console.log(`[symbiote] ${message}`);
+    if (!isDebug())
+        return;
+    console.log(`[symbiote] ${typeof message === 'function' ? message() : message}`);
 }

package/build/events/index.js

@@ -8,7 +8,7 @@
 import { dlog } from '../debug.js';
 import { runWrapped } from '../dispatch.js';
 import { getSlot } from '../fabric.js';
-import { isAnchor, isSymbioteNode } from '../node.js';
+import { isAnchor, isSymbioteNode, } from '../node.js';
 import { registeredNativeEvent } from '../registry.js';
 import { attachTouchHistory, recordTouchTrack, resetTouchHistory, touchHistory, } from '../touch-history.js';
 import { isRecord } from '../type-guards.js';
@@ -228,12 +228,14 @@ function lowestCommonAncestor(a, b) {
 // handler, so asking the responder again would zero its move).
 function findWantsResponder(path, captureName, bubbleName, nativeEvent, skip) {
     for (let i = path.length - 1; i >= 0; i--) {
-        if (path[i] !== skip && callOwnListener(path[i], captureName, nativeEvent) === true) {
+        if (path[i] !== skip &&
+            callOwnListener(path[i], captureName, nativeEvent) === true) {
             return path[i];
         }
     }
     for (const node of path) {
-        if (node !== skip && callOwnListener(node, bubbleName, nativeEvent) === true)
+        if (node !== skip &&
+            callOwnListener(node, bubbleName, nativeEvent) === true)
             return node;
     }
     return undefined;
@@ -248,7 +250,9 @@ function negotiateResponder(target, phase, nativeEvent) {
     // the responder) and skips the deepest node when it IS the responder (Responder-
     // EventPlugin.setResponderAndExtractTransfer). At touch start currentResponder is
     // cleared, so this collapses to the plain target->root start walk.
-    const from = currentResponder === undefined ? target : lowestCommonAncestor(currentResponder, target);
+    const from = currentResponder === undefined
+        ? target
+        : lowestCommonAncestor(currentResponder, target);
     if (!from)
         return;
     const path = pathToRoot(from);
@@ -268,7 +272,9 @@ function negotiateResponder(target, phase, nativeEvent) {
     // A missing termination-request listener means implicit consent (RN default true);
     // only an explicit non-true answer keeps the incumbent and rejects the taker.
     const guarded = incumbent.listeners?.has(RESPONDER_TERMINATION_REQUEST) === true;
-    const allowed = !guarded || callOwnListener(incumbent, RESPONDER_TERMINATION_REQUEST, nativeEvent) === true;
+    const allowed = !guarded ||
+        callOwnListener(incumbent, RESPONDER_TERMINATION_REQUEST, nativeEvent) ===
+            true;
     if (allowed) {
         // RN's transfer order (setResponderAndExtractTransfer): grant the TAKER first, then
         // terminate the incumbent. RN dispatches grant ahead of the terminationRequest too,
@@ -362,7 +368,8 @@ export function installEventHandler() {
             // started inside it; lifting ONE finger in a multi-touch gesture must NOT release.
             // onResponderEnd still fires on every finger-up. (ResponderEventPlugin: responderEnd
             // is unconditional, responderRelease is gated on noResponderTouches.)
-            const releases = responder !== undefined && !hasRemainingResponderTouch(responder, nativeEvent);
+            const releases = responder !== undefined &&
+                !hasRemainingResponderTouch(responder, nativeEvent);
             if (releases)
                 currentResponder = undefined;
             // A completed long press eats the tap (RN), but pressOut still fires below.
@@ -495,7 +502,9 @@ function bubble(target, listenerName, nativeEvent) {
         // machinery (already delivered directly, e.g. Angular's EventEmitter.subscribe) also
         // registered it through Renderer2.listen. Bubbling into it would refire that same
         // callback a second time, so anchors are transparent to listener lookup, not just paint.
-        const listener = isAnchor(node) ? undefined : node.listeners?.get(captureName);
+        const listener = isAnchor(node)
+            ? undefined
+            : node.listeners?.get(captureName);
         if (listener) {
             dlog(`event ${listenerName} capture on ${node.component}`);
             listener({
@@ -513,9 +522,10 @@ function bubble(target, listenerName, nativeEvent) {
     // transparent here too, same reason (see the capture-phase comment above).
     let node = target;
     while (node) {
-        const listener = isAnchor(node) ? undefined : node.listeners?.get(listenerName);
+        const listener = isAnchor(node)
+            ? undefined
+            : node.listeners?.get(listenerName);
         if (listener) {
-            // engine owner adds currentTarget + stopPropagation to SymbioteEvent
             const event = {
                 type: listenerName,
                 target,
@@ -535,7 +545,6 @@ function deliverDirect(target, listenerName, nativeEvent) {
     const listener = target.listeners?.get(listenerName);
     if (!listener)
         return;
-    // engine owner adds currentTarget + stopPropagation to SymbioteEvent
     listener({
         type: listenerName,
         target,

package/build/fabric-props.js

@@ -70,11 +70,17 @@ const COLOR_PROPS = new Set([
 const STYLE_PROCESSORS = new Map([
     ['boxShadow', value => processBoxShadow(asBoxShadowInput(value))],
     ['filter', value => processFilter(asFilterInput(value))],
-    ['transformOrigin', value => processTransformOrigin(asTransformOriginInput(value))],
+    [
+        'transformOrigin',
+        value => processTransformOrigin(asTransformOriginInput(value)),
+    ],
     ['transform', processTransformValue],
     ['aspectRatio', value => processAspectRatio(asAspectRatioInput(value))],
     ['fontVariant', value => processFontVariant(asFontVariantInput(value))],
-    ['experimental_backgroundImage', value => processBackgroundImage(asBackgroundImageInput(value))],
+    [
+        'experimental_backgroundImage',
+        value => processBackgroundImage(asBackgroundImageInput(value)),
+    ],
 ]);
 // boxShadow accepts a CSS string or an array of shadow objects; anything else is
 // undefined to processBoxShadow (which returns []). Narrowing avoids an `as` cast.

package/build/image-loader.js

@@ -14,7 +14,7 @@
 // alongside Alert/Share, not in a view/render-*.ts file (whose contract is zero state / zero
 // native bridge).
 import { dlog } from './debug.js';
-import { resolveImageSource } from './image-source-resolver.js';
+import { resolveImageSource, } from './image-source-resolver.js';
 import { getNativeModule } from './native-modules/index.js';
 import { Platform } from './platform';
 import { isNumber } from './type-guards.js';
@@ -26,7 +26,8 @@ const IMAGE_LOADER_MODULE = 'ImageLoader';
 let imageLoaderModule;
 function getImageLoader() {
     if (imageLoaderModule === undefined) {
-        imageLoaderModule = getNativeModule(IMAGE_LOADER_MODULE);
+        imageLoaderModule =
+            getNativeModule(IMAGE_LOADER_MODULE);
         dlog(`Image: ImageLoader module ${imageLoaderModule ? 'resolved' : 'NOT resolved (null)'}`);
     }
     return imageLoaderModule;

package/build/index.d.ts

@@ -1,8 +1,8 @@
-export { createElement, createRawText, createAnchor, isAnchor, appendChild, insertBefore, removeChild, setProp, setEventListener, routeProp, getExplicitStyle, setText, isSymbioteNode, isSymbioteEvent, RAW_TEXT_COMPONENT, debugNodeId, } from './node';
+export { createElement, createRawText, createAnchor, isAnchor, appendChild, insertBefore, removeChild, setProp, setEventListener, routeProp, censusRetainedTree, getExplicitStyle, setNodeHidden, setText, isSymbioteNode, isSymbioteEvent, RAW_TEXT_COMPONENT, debugNodeId, } from './node';
 export { isEventFor } from './view-config';
 export { registerComponent, setNativeViewConfigSource } from './registry';
 export { isRecord } from './type-guards';
-export { InteractionManager, Events as InteractionManagerEvents } from './interaction-manager';
+export { InteractionManager, Events as InteractionManagerEvents, } from './interaction-manager';
 export type { IInteractionEvent, ISimpleTask, IPromiseTask, ITask, IHandle, ICancellable, } from './interaction-manager';
 export { default as PanResponder } from './pan-responder';
 export type { IPanResponderGestureState, IPanResponderCallbacks, IGestureResponderHandlers, IPanResponderInstance, } from './pan-responder';
@@ -10,11 +10,13 @@ export type { IComponentRegistration, INativeEventBinding, INativeViewConfig, IN
 export type { ISymbioteNode, ISymbioteEvent, IListener } from './node';
 export { SymbioteSurface, createSurface } from './surface';
 export { setEventDispatcher } from './dispatch';
-export { setColorProcessor, processColor, dispatchViewCommand, sendAccessibilityEvent, setNativeProps, getNativeTag, getNativeNode, whenCommitted, measure, measureInWindow, measureLayout, disposeRoot, } from './commit';
+export { setColorProcessor, processColor, dispatchViewCommand, sendAccessibilityEvent, setNativeProps, getNativeTag, getNativeNode, whenCommitted, measure, measureInWindow, measureLayout, disposeRoot, readCommitProfile, } from './commit';
+export type { ICommitProfile } from './commit';
+export { registerPostCommit, unregisterPostCommit } from './post-commit';
 export { toPublicInstance } from './host-instance';
 export type { IHostInstance } from './host-instance';
-export { PlatformColor, DynamicColorIOS, isOpaqueColorValue } from './platform-color';
-export type { IColorValue, IOpaqueColorValue, IDynamicColorIOSTuple } from './platform-color';
+export { PlatformColor, DynamicColorIOS, isOpaqueColorValue, } from './platform-color';
+export type { IColorValue, IOpaqueColorValue, IDynamicColorIOSTuple, } from './platform-color';
 export { processBoxShadow } from './process-box-shadow';
 export type { IParsedBoxShadow } from './process-box-shadow';
 export { processFilter } from './process-filter';
@@ -28,20 +30,22 @@ export type { IParsedBackgroundImage } from './process-background-image';
 export { flattenStyle } from './style';
 export type { IViewStyle, ITextStyle, IStyleProp, IDimensionValue, IFlexAlign, IFlexJustify, ITransformProp, IBoxShadowValue, IDropShadowValue, IFilterFunction, IColorStopValue, ILinearGradientValue, IRadialGradientValue, IRadialGradientPosition, IRadialGradientShape, IRadialGradientSize, IBackgroundImageValue, IBlendMode, } from './styles';
 export { StyleSheet, computeHairlineWidth } from './style-sheet';
-export { registerStyles, resolveClassName, clearGlobalStyles, isClassNameValue, } from './style-registry';
-export type { IClassNameValue } from './style-registry';
-export { scopeClassName } from './style-registry/scope';
-export type { IClassToggleMap, IScopableClassValue } from './style-registry/scope';
+export { registerRules, resolveClassName, clearGlobalStyles, isClassNameValue, } from './style-registry';
+export type { IClassNameValue, IStyleRule } from './style-registry';
+export { renameClassTokens } from './style-registry/scope';
+export type { IClassNameRenames, IClassToggleMap, IScopableClassValue, } from './style-registry/scope';
 export { Platform } from './platform';
-export type { IPlatformStatic, IPlatformOSType, IPlatformSelectSpec } from './platform';
+export type { IPlatformStatic, IPlatformOSType, IPlatformSelectSpec, } from './platform';
 export type { IPlatformConstantsIOS } from './platform/index.ios';
 export type { IPlatformConstantsAndroid } from './platform/index.android';
 export { dlog, isDebug } from './debug';
+export { reportUncaughtError } from './report-error';
+export type { IUncaughtErrorInfo } from './report-error';
 export { getNativeModule, getEnforcingNativeModule } from './native-modules';
-export { installDeviceEventHub, NativeEventEmitter, setDeviceEventSource } from './native-events';
+export { installDeviceEventHub, NativeEventEmitter, setDeviceEventSource, } from './native-events';
 export type { IEventSubscription, IEventEmitterModule, INativeEventListener, IDeviceEventSource, } from './native-events';
-export { AnimatedNode, AnimatedWithChildren, AnimatedValue, AnimatedValueXY, AnimatedColor, AnimatedInterpolation, AnimatedAddition, AnimatedSubtraction, AnimatedMultiplication, AnimatedDivision, AnimatedModulo, AnimatedDiffClamp, AnimatedEvent, add, subtract, multiply, divide, modulo, diffClamp, event, forkEvent, unforkEvent, attachNativeEvent, attachNativeEventHandler, flushValue, Easing, createNumericInterpolation, checkValidRanges, TimingAnimation, SpringAnimation, DecayAnimation, AnimatedTracking, timing, spring, decay, parallel, sequence, stagger, loop, delay, nativeAnimated, isNativeAnimatedAvailable, AnimatedProps, AnimatedStyle, AnimatedTransform, AnimatedMock, reduceProps, isAnimatedNode, readPassthroughStyle, resolveHostNode, } from './animated';
-export type { IValueXY, IRgbaValue, IColorInput, IEventConfig, IEventListener, IAnimatedEventHandler, INativeEventAttachment, IValueListener, IEasingFunction, IInterpolationConfig, IExtrapolateType, IAnimation, IEndCallback, IEndResult, ICompositeAnimation, ITimingConfig, ISpringConfig, IDecayConfig, IParallelConfig, ILoopAnimationConfig, INativeNodeConfig, INativeAnimationConfig, INativeEventMapping, IPlatformConfig, } from './animated';
+export { AnimatedNode, AnimatedWithChildren, AnimatedValue, AnimatedValueXY, AnimatedColor, AnimatedInterpolation, AnimatedAddition, AnimatedSubtraction, AnimatedMultiplication, AnimatedDivision, AnimatedModulo, AnimatedDiffClamp, AnimatedEvent, add, subtract, multiply, divide, modulo, diffClamp, event, forkEvent, unforkEvent, attachNativeEvent, attachNativeEventHandler, flushValue, Easing, createNumericInterpolation, checkValidRanges, TimingAnimation, SpringAnimation, DecayAnimation, AnimatedTracking, timing, spring, decay, parallel, sequence, stagger, loop, delay, nativeAnimated, isNativeAnimatedAvailable, AnimatedProps, createAnimatedLeafLifecycle, AnimatedStyle, AnimatedTransform, AnimatedMock, reduceProps, isAnimatedNode, readPassthroughStyle, resolveHostNode, } from './animated';
+export type { IAnimatedLeafLifecycle, IValueXY, IRgbaValue, IColorInput, IEventConfig, IEventListener, IAnimatedEventHandler, INativeEventAttachment, IValueListener, IEasingFunction, IInterpolationConfig, IExtrapolateType, IAnimation, IEndCallback, IEndResult, ICompositeAnimation, ITimingConfig, ISpringConfig, IDecayConfig, IParallelConfig, ILoopAnimationConfig, INativeNodeConfig, INativeAnimationConfig, INativeEventMapping, IPlatformConfig, } from './animated';
 export { getSlot } from './fabric';
 export type { IFabricSlot, IFabricNode, IFabricChildSet, IFabricProps, IFabricEventHandler, IRootTag, IMeasureOnSuccess, IMeasureInWindowOnSuccess, IMeasureLayoutOnSuccess, } from './fabric';
 export { Alert } from './alert';
@@ -49,8 +53,8 @@ export type { IAlertType, IAlertButtonStyle, IAlertButton, IAlertButtons, IAlert
 export { Share } from './share';
 export type { IShareContent, IShareOptions, IShareAction } from './share';
 export { imageStatics } from './image-loader';
-export type { IImageStatics, IImageSize, IImageCacheStatus } from './image-loader';
-export { setImageSourceResolver, resolveImageSource } from './image-source-resolver';
+export type { IImageStatics, IImageSize, IImageCacheStatus, } from './image-loader';
+export { setImageSourceResolver, resolveImageSource, } from './image-source-resolver';
 export type { IImageSource, IImageSourceProp } from './image-source-resolver';
 export { ActionSheetIOS } from './action-sheet-ios';
 export type { IActionSheetIOSOptions, IShareActionSheetIOSOptions, IShareActionSheetError, } from './action-sheet-ios';
@@ -72,16 +76,16 @@ export type { IAppStateStatus, IAppStateEvent } from './app-state';
 export { createAppRegistry } from './app-registry';
 export type { IAppRegistry, ICreateAppRegistryResult, IAppParameters, IRunnable, IHostRegistrar, IRegistry, IHeadlessTask, ITaskProvider, ITaskCanceller, ITaskCancelProvider, } from './app-registry';
 export { Keyboard, KEYBOARD_EVENT } from './keyboard';
-export type { IKeyboardEventName, IKeyboardEvent, IKeyboardMetrics } from './keyboard';
+export type { IKeyboardEventName, IKeyboardEvent, IKeyboardMetrics, } from './keyboard';
 export { currentlyFocusedInput, setInputFocused, setInputBlurred, blurTextInput, } from './text-input-state';
 export { LayoutAnimation } from './layout-animation';
 export type { ILayoutAnimationType, ILayoutAnimationProperty, ILayoutAnimationConfig, ILayoutAnimationAnim, ILayoutAnimationTypes, ILayoutAnimationProperties, } from './layout-animation';
 export { BackHandler } from './back-handler';
 export type { IBackPressEventName, IBackPressHandler } from './back-handler';
-export { PermissionsAndroid, PERMISSIONS, RESULTS } from './permissions-android';
-export type { IPermission, IPermissionStatus, IRationale } from './permissions-android';
+export { PermissionsAndroid, PERMISSIONS, RESULTS, } from './permissions-android';
+export type { IPermission, IPermissionStatus, IRationale, } from './permissions-android';
 export { AccessibilityInfo } from './accessibility-info';
 export type { IAccessibilityChangeEvent, IAccessibilityChangeEventName, IAccessibilityChangeEventHandler, IAccessibilityAnnouncementFinishedEvent, IAnnounceForAccessibilityOptions, IAccessibilityInfoStatic, IAccessibilityEventType, IAccessibilityHandle, } from './accessibility-info/shared';
-export { applyStatusBarProps, statusBarImperative, statusBarCurrentHeight } from './status-bar';
+export { applyStatusBarProps, statusBarImperative, statusBarCurrentHeight, } from './status-bar';
 export { hideTransition, STATUS_BAR_MANAGER, ANIMATED_HIDE_TRANSITION, STATIC_HIDE_TRANSITION, } from './status-bar/shared';
 export type { IStatusBarProps, IStatusBarStyle, IStatusBarAnimation, IStatusBarImperative, } from './status-bar/shared';

package/build/index.js

@@ -2,7 +2,7 @@
 // Every framework adapter drives this tiny mutation API; all Fabric-specific
 // logic (tag allocation, view-name resolution, clone-on-write, event
 // normalization) lives behind it, in one place.
-export { createElement, createRawText, createAnchor, isAnchor, appendChild, insertBefore, removeChild, setProp, setEventListener, routeProp, getExplicitStyle, setText, isSymbioteNode, isSymbioteEvent, RAW_TEXT_COMPONENT, debugNodeId, } from './node.js';
+export { createElement, createRawText, createAnchor, isAnchor, appendChild, insertBefore, removeChild, setProp, setEventListener, routeProp, censusRetainedTree, getExplicitStyle, setNodeHidden, setText, isSymbioteNode, isSymbioteEvent, RAW_TEXT_COMPONENT, debugNodeId, } from './node.js';
 export { isEventFor } from './view-config.js';
 export { registerComponent, setNativeViewConfigSource } from './registry.js';
 // Real cross-package consumer: core/components' KeyboardAvoidingView render narrows
@@ -10,18 +10,25 @@ export { registerComponent, setNativeViewConfigSource } from './registry.js';
 export { isRecord } from './type-guards.js';
 // InteractionManager: pure JS (timers + emitter), framework-agnostic, so it lives
 // here; every adapter re-exports it.
-export { InteractionManager, Events as InteractionManagerEvents } from './interaction-manager/index.js';
+export { InteractionManager, Events as InteractionManagerEvents, } from './interaction-manager/index.js';
 // PanResponder: pure JS gesture recognition over the View responder props,
 // framework-agnostic, so it lives here; every adapter re-exports it.
 export { default as PanResponder } from './pan-responder/index.js';
 export { SymbioteSurface, createSurface } from './surface.js';
 export { setEventDispatcher } from './dispatch.js';
-export { setColorProcessor, processColor, dispatchViewCommand, sendAccessibilityEvent, setNativeProps, getNativeTag, getNativeNode, whenCommitted, measure, measureInWindow, measureLayout, disposeRoot, } from './commit.js';
+export { setColorProcessor, processColor, dispatchViewCommand, sendAccessibilityEvent, setNativeProps, getNativeTag, getNativeNode, whenCommitted, measure, measureInWindow, measureLayout, disposeRoot, readCommitProfile, } from './commit.js';
+// "A commit just reached completeRoot." The one seam that means the same thing under every
+// adapter: React commits synchronously inside its own commit phase, while Vue / Svelte / Angular
+// schedule completeRoot on a microtask, so each framework's own after-render hook fires at a
+// DIFFERENT point relative to the native commit. Anything timing or comparing the commit path
+// across adapters has to hang off this, not off a per-framework lifecycle hook, or it measures a
+// different quantity in each one under the same name.
+export { registerPostCommit, unregisterPostCommit } from './post-commit.js';
 // The public instance grafted onto a host node by every adapter (React's getPublicInstance,
 // the Vue renderer's createElement): the imperative measure/setNativeProps/focus API. Lives
 // here because it depends only on engine internals, so all adapters inherit it identically.
 export { toPublicInstance } from './host-instance/index.js';
-export { PlatformColor, DynamicColorIOS, isOpaqueColorValue } from './platform-color/index.js';
+export { PlatformColor, DynamicColorIOS, isOpaqueColorValue, } from './platform-color/index.js';
 // CSS-style processors (boxShadow/filter): RN parses these in JS before native because
 // enableNativeCSSParsing() defaults to false. Exported so an adapter / test can reuse them.
 export { processBoxShadow } from './process-box-shadow/index.js';
@@ -33,13 +40,14 @@ export { processFontVariant } from './process-font-variant.js';
 export { processBackgroundImage } from './process-background-image/index.js';
 export { flattenStyle } from './style/index.js';
 export { StyleSheet, computeHairlineWidth } from './style-sheet/index.js';
-export { registerStyles, resolveClassName, clearGlobalStyles, isClassNameValue, } from './style-registry/index.js';
-export { scopeClassName } from './style-registry/scope.js';
+export { registerRules, resolveClassName, clearGlobalStyles, isClassNameValue, } from './style-registry/index.js';
+export { renameClassTokens } from './style-registry/scope.js';
 export { Platform } from './platform';
 export { dlog, isDebug } from './debug.js';
+export { reportUncaughtError } from './report-error.js';
 export { getNativeModule, getEnforcingNativeModule } from './native-modules/index.js';
-export { installDeviceEventHub, NativeEventEmitter, setDeviceEventSource } from './native-events.js';
-export { AnimatedNode, AnimatedWithChildren, AnimatedValue, AnimatedValueXY, AnimatedColor, AnimatedInterpolation, AnimatedAddition, AnimatedSubtraction, AnimatedMultiplication, AnimatedDivision, AnimatedModulo, AnimatedDiffClamp, AnimatedEvent, add, subtract, multiply, divide, modulo, diffClamp, event, forkEvent, unforkEvent, attachNativeEvent, attachNativeEventHandler, flushValue, Easing, createNumericInterpolation, checkValidRanges, TimingAnimation, SpringAnimation, DecayAnimation, AnimatedTracking, timing, spring, decay, parallel, sequence, stagger, loop, delay, nativeAnimated, isNativeAnimatedAvailable, AnimatedProps, AnimatedStyle, AnimatedTransform, AnimatedMock, reduceProps, isAnimatedNode, readPassthroughStyle, resolveHostNode, } from './animated/index.js';
+export { installDeviceEventHub, NativeEventEmitter, setDeviceEventSource, } from './native-events.js';
+export { AnimatedNode, AnimatedWithChildren, AnimatedValue, AnimatedValueXY, AnimatedColor, AnimatedInterpolation, AnimatedAddition, AnimatedSubtraction, AnimatedMultiplication, AnimatedDivision, AnimatedModulo, AnimatedDiffClamp, AnimatedEvent, add, subtract, multiply, divide, modulo, diffClamp, event, forkEvent, unforkEvent, attachNativeEvent, attachNativeEventHandler, flushValue, Easing, createNumericInterpolation, checkValidRanges, TimingAnimation, SpringAnimation, DecayAnimation, AnimatedTracking, timing, spring, decay, parallel, sequence, stagger, loop, delay, nativeAnimated, isNativeAnimatedAvailable, AnimatedProps, createAnimatedLeafLifecycle, AnimatedStyle, AnimatedTransform, AnimatedMock, reduceProps, isAnimatedNode, readPassthroughStyle, resolveHostNode, } from './animated/index.js';
 export { getSlot } from './fabric.js';
 // Imperative runtime modules: framework-agnostic native-bridge consumers (no visual, no
 // lifecycle), moved here from @symbiote-native/react so every adapter re-exports the SAME module.
@@ -51,7 +59,7 @@ export { Share } from './share';
 // no view of its own, same shape as Alert/Share. The source-resolution seam it shares with
 // @symbiote-native/components' renderImage lives alongside it in image-source-resolver.
 export { imageStatics } from './image-loader.js';
-export { setImageSourceResolver, resolveImageSource } from './image-source-resolver.js';
+export { setImageSourceResolver, resolveImageSource, } from './image-source-resolver.js';
 export { ActionSheetIOS } from './action-sheet-ios/index.js';
 export { Linking } from './linking';
 export { Vibration } from './vibration';
@@ -73,9 +81,9 @@ export { Keyboard, KEYBOARD_EVENT } from './keyboard/index.js';
 export { currentlyFocusedInput, setInputFocused, setInputBlurred, blurTextInput, } from './text-input-state.js';
 export { LayoutAnimation } from './layout-animation/index.js';
 export { BackHandler } from './back-handler/index.js';
-export { PermissionsAndroid, PERMISSIONS, RESULTS } from './permissions-android/index.js';
+export { PermissionsAndroid, PERMISSIONS, RESULTS, } from './permissions-android/index.js';
 export { AccessibilityInfo } from './accessibility-info';
 // StatusBar: values from the platform-selected './status-bar', types from '-shared' (the
 // .ios re-export would otherwise duplicate-export the type symbols).
-export { applyStatusBarProps, statusBarImperative, statusBarCurrentHeight } from './status-bar';
+export { applyStatusBarProps, statusBarImperative, statusBarCurrentHeight, } from './status-bar';
 export { hideTransition, STATUS_BAR_MANAGER, ANIMATED_HIDE_TRANSITION, STATIC_HIDE_TRANSITION, } from './status-bar/shared.js';

package/build/interaction-manager/index.js

@@ -202,7 +202,8 @@ class InteractionManagerImpl {
                 break;
             if (typeof next === 'function')
                 next();
-            if (this.deadline > DEFAULT_DEADLINE && Date.now() - startTime >= this.deadline) {
+            if (this.deadline > DEFAULT_DEADLINE &&
+                Date.now() - startTime >= this.deadline) {
                 if (this.taskQueue.length > 0) {
                     scheduleTimeout(() => {
                         this.flushQueue();