@symbiote-native/engine 0.2.0 → 0.4.0

package/build/tags.js

@@ -2,9 +2,39 @@
 // for root tags). A tag is minted once when a node is first created and then
 // stays with it across clone-on-write commits (the clone keeps the family), so
 // this counter only ever moves forward: one tag per node, not per commit.
-let next = 2;
+import { dlog } from './debug.js';
+// WHY IT DOES NOT START AT 2. React's own Fabric renderer allocates tags the exact same way and
+// from the exact same seed — `let nextReactTag = 2; ... nextReactTag += 2` in
+// react-native-renderer/src/ReactFiberConfigFabric.js. We replace React as the APP's renderer, but
+// React is still in the bundle and still drives one Fabric surface of its own: **LogBox**. So the
+// first JS error in a symbiote app opens a redbox, React mints tag 2 for it, and Fabric aborts the
+// process on a Create for a tag the engine registered at app start:
+//
+//   *** Terminating app due to uncaught exception 'NSInternalInconsistencyException',
+//   reason: 'RCTComponentViewRegistry: Attempt to dequeue already registered component.'
+//   -[RCTComponentViewRegistry dequeueComponentViewWithComponentHandle:tag:]
+//   RCTPerformMountInstructions(...)
+//
+// `RCTComponentViewRegistry` is process-wide, not per-surface, so the two allocators must not
+// overlap. Diagnosed 2026-08-20 on examples/svelte: an `effect_update_depth_exceeded` on the API
+// Playground screen turned into a SIGABRT with no JS stack, because the redbox that would have
+// named the file killed the app instead of showing. Starting a whole surface's worth of tags above
+// React's seed keeps the redbox a redbox: LogBox needs a few hundred nodes, so it can never walk
+// 500k allocations up into this range.
+const REACT_LOGBOX_TAG_RESERVE = 1_000_000;
+let next = REACT_LOGBOX_TAG_RESERVE + 2;
+let announced = false;
 export function nextTag() {
+    if (!announced) {
+        announced = true;
+        // Printed once, next to the first `commit ... createNode tag=` line: a device log that shows a
+        // Fabric tag below this base was minted by React (LogBox), not by us.
+        dlog(`tag allocator base=${next} (React's own Fabric tags stay below it)`);
+    }
     const tag = next;
     next += 2;
     return tag;
 }
+// The lowest tag this allocator can ever hand out. Exported for the regression test that pins the
+// no-overlap invariant against React's own allocator; nothing at runtime reads it.
+export const FIRST_TAG = REACT_LOGBOX_TAG_RESERVE + 2;

package/build/touch-history.js

@@ -21,7 +21,9 @@ export const touchHistory = {
     mostRecentTimeStamp: 0,
 };
 function toFiniteNumber(value) {
-    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+    return typeof value === 'number' && Number.isFinite(value)
+        ? value
+        : undefined;
 }
 // Pull a recordable touch out of an untyped entry. RN's getTouchIdentifier throws on
 // a null id; we skip instead, so events without touch geometry leave the bank untouched.
@@ -35,7 +37,12 @@ function normalizeTouch(raw) {
         return undefined;
     if (identifier < 0 || identifier > MAX_TOUCH_BANK)
         return undefined;
-    return { identifier, pageX, pageY, timestamp: toFiniteNumber(raw.timestamp) ?? 0 };
+    return {
+        identifier,
+        pageX,
+        pageY,
+        timestamp: toFiniteNumber(raw.timestamp) ?? 0,
+    };
 }
 // The changed touches for this frame (start/move/end), defensively read.
 function changedTouchesOf(nativeEvent) {

package/build/vibration/index.ios.js

@@ -3,7 +3,7 @@
 // Everything else (the single-number buzz, cancel, the module resolver) is the shared
 // core. Metro picks this file on an iOS host; the base vibration.ts re-exports it for
 // web/headless.
-import { createVibration, DEFAULT_VIBRATION_LENGTH } from './shared.js';
+import { createVibration, DEFAULT_VIBRATION_LENGTH, } from './shared.js';
 // JS scheduler state, mirroring RN's _vibrating / _id. `scheduleId` guards against a
 // stale timer from a previous run firing into a new one.
 let vibrating = false;

package/build/view-config.js

@@ -30,6 +30,12 @@ const BASE_EVENTS = [
     'press',
     'pressIn',
     'pressOut',
+    // Synthesized from the touch stream like its four siblings, and omitted here until 2026-09-02.
+    // A name the press machine OWNS but the engine does not route is dead on the lowered path only:
+    // `routeProp` hands an `on*` prop to `setEventListener` (and thus to the behavior's stash) only
+    // for a registered event, so `onPressMove` landed in `node.props` where nothing reads it, while
+    // a wrapper passes the same callback to the machine directly and stayed correct.
+    'pressMove',
     'longPress',
     'layout',
     'focus',
@@ -55,7 +61,12 @@ const TEXT_INPUT_EVENTS = [
     'selectionChange',
     'contentSizeChange',
 ];
-const MODAL_EVENTS = ['show', 'dismiss', 'requestClose', 'orientationChange'];
+const MODAL_EVENTS = [
+    'show',
+    'dismiss',
+    'requestClose',
+    'orientationChange',
+];
 // A scroll view's events are the same on both axes and both platforms; only the native
 // NAME differs (iOS RCTScrollView for both; Android RCTScrollView vertical vs
 // AndroidHorizontalScrollView horizontal). Declared once, keyed under each name below. The
@@ -78,7 +89,14 @@ const TEXT_EVENTS = ['textLayout'];
 // SymbioteNode.component (what createNode is called with). A component absent here
 // still gets BASE_EVENTS, so a new primitive has working press/layout for free.
 const COMPONENT_EVENTS = {
-    RCTImageView: ['loadStart', 'load', 'loadEnd', 'error', 'progress', 'partialLoad'],
+    RCTImageView: [
+        'loadStart',
+        'load',
+        'loadEnd',
+        'error',
+        'progress',
+        'partialLoad',
+    ],
     RCTScrollView: SCROLL_EVENTS,
     AndroidHorizontalScrollView: SCROLL_EVENTS,
     RCTSinglelineTextInputView: TEXT_INPUT_EVENTS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/engine",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "SymbioteNative's retained shadow-tree engine — clone-on-write commit path + event normalization over React Native Fabric, shared by every framework adapter.",
   "license": "MIT",
   "repository": {
@@ -17,6 +17,16 @@
   "main": "./build/index.js",
   "module": "./build/index.js",
   "types": "./build/index.d.ts",
+  "keywords": [
+    "react-native",
+    "symbiote-native",
+    "fabric",
+    "shadow-tree",
+    "renderer-core",
+    "jsi",
+    "yoga",
+    "cross-platform"
+  ],
   "exports": {
     ".": {
       "types": "./build/index.d.ts",
@@ -33,7 +43,7 @@
     "react-native": ">=0.86"
   },
   "devDependencies": {
-    "@symbiote-native/test-utils": "0.1.6"
+    "@symbiote-native/test-utils": "0.3.0"
   },
   "scripts": {
     "typecheck": "tsc --build",