@symbiote-native/navigation 4.0.1 → 5.0.0

package/README.md

@@ -18,6 +18,10 @@ logic/view/lifecycle split every other SymbioteNative component follows.
 npm install @symbiote-native/navigation
 ```
 
+Scaffolding or extending a SymbioteNative app? `npx @symbiote-native/cli new --navigation` (or
+`add --navigation` in an existing app) installs and wires this for you — see
+[`@symbiote-native/cli`](../cli).
+
 Only this package — never `react-native-screens` directly. `@symbiote-native/navigation` depends
 on it and ships as the sole autolinked native proxy (`react-native.config.cjs` +
 `symbiote-navigation.podspec`), the same one-dependency packaging as `@symbiote-native/slider` and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/navigation",
-  "version": "4.0.1",
+  "version": "5.0.0",
   "description": "Native stack navigator for SymbioteNative, built on react-native-screens' native view primitives (RNSScreen/RNSScreenStack) — one framework-agnostic core, reachable from the React, Vue, Svelte, Solid, and Angular adapters.",
   "keywords": [
     "react-native",
@@ -160,7 +160,7 @@
   },
   "dependencies": {
     "react-native-screens": "4.26.0",
-    "@symbiote-native/components": "2.0.0"
+    "@symbiote-native/components": "3.0.0"
   },
   "peerDependencies": {
     "@angular/common": ">=20",
@@ -171,12 +171,12 @@
     "solid-js": ">=1.9.0",
     "svelte": ">=5.56.0",
     "vue": ">=3.5.0",
-    "@symbiote-native/react": "^2.0.0",
-    "@symbiote-native/angular": "^2.0.0",
-    "@symbiote-native/solid": "^2.0.0",
-    "@symbiote-native/svelte": "^2.0.0",
-    "@symbiote-native/vue": "^2.0.0",
-    "@symbiote-native/engine": "^0.5.0"
+    "@symbiote-native/angular": "^3.0.0",
+    "@symbiote-native/engine": "^1.0.0",
+    "@symbiote-native/react": "^3.0.0",
+    "@symbiote-native/solid": "^3.0.0",
+    "@symbiote-native/svelte": "^3.0.0",
+    "@symbiote-native/vue": "^3.0.0"
   },
   "peerDependenciesMeta": {
     "@angular/common": {
@@ -228,13 +228,13 @@
     "solid-js": "^1.9.14",
     "svelte": "^5.56.0",
     "typescript": "~6.0.0",
-    "@symbiote-native/angular": "2.0.0",
-    "@symbiote-native/engine": "0.5.0",
-    "@symbiote-native/react": "2.0.0",
-    "@symbiote-native/solid": "2.0.0",
-    "@symbiote-native/test-utils": "0.3.0",
-    "@symbiote-native/vue": "2.0.0",
-    "@symbiote-native/svelte": "2.0.0"
+    "@symbiote-native/angular": "3.0.0",
+    "@symbiote-native/engine": "1.0.0",
+    "@symbiote-native/react": "3.0.0",
+    "@symbiote-native/solid": "3.0.0",
+    "@symbiote-native/svelte": "3.0.0",
+    "@symbiote-native/test-utils": "0.3.1",
+    "@symbiote-native/vue": "3.0.0"
   },
   "scripts": {
     "clean": "rm -rf build-ngc",

package/src/svelte/fabric-tree.test-helper.ts

@@ -1,95 +1,69 @@
-// Live-tree walkers the smoke tests in this folder share.
+// The live-tree walkers the smoke tests in this folder share, over the shared reader.
 //
-// `fabric.find()` (from @symbiote-native/test-utils) walks the CREATION log, not the current
-// tree: a node it returns stays "found" forever, and its `props` reflect creation time rather
-// than what is currently committed (svelte-adapter-dom-shim skill §15). Every assertion about
-// what is on screen NOW - "this route is gone after a pop", "this header currently carries this
-// title" - therefore walks `fabric.appRoot()` instead.
+// Everything general — walking the LIVE child links instead of the creation log, flattening
+// anchors the way the commit walk does, the two readings of a node — lives in
+// `@symbiote-native/test-utils`'s `createLiveTree`. See its header for why each of those is not
+// optional. What stays here is the two questions only this folder asks.
 
-export type IFabricNode = {
-  viewName?: string;
-  props?: Record<string, unknown>;
-  children?: IFabricNode[];
-  instanceHandle?: unknown;
-};
-
-function isFabricNode(value: unknown): value is IFabricNode {
-  return typeof value === 'object' && value !== null;
-}
-
-export function walkLive(
-  root: unknown,
-  visit: (node: IFabricNode) => void,
-): void {
-  if (!isFabricNode(root)) return;
-  visit(root);
-  for (const child of root.children ?? []) walkLive(child, visit);
-}
-
-export function findAllLive(root: unknown, viewName: string): IFabricNode[] {
-  const found: IFabricNode[] = [];
-  walkLive(root, node => {
-    if (node.viewName === viewName) found.push(node);
-  });
-  return found;
-}
+import {
+  createLiveTree,
+  type IRecordingHost,
+} from '@symbiote-native/test-utils';
+import type { ILiveNode, ILiveTree } from '@symbiote-native/test-utils';
+import type { ISymbioteNode } from '@symbiote-native/engine';
 
-export function findLive(
-  root: unknown,
-  viewName: string,
-): IFabricNode | undefined {
-  return findAllLive(root, viewName)[0];
-}
+export type IFabricNode = ILiveNode;
 
-export function countLive(root: unknown, viewName: string): number {
-  return findAllLive(root, viewName).length;
-}
-
-export function findLiveByTestId(
-  root: unknown,
-  testID: string,
-): IFabricNode | undefined {
-  let found: IFabricNode | undefined;
-  walkLive(root, node => {
-    if (found === undefined && node.props?.testID === testID) found = node;
-  });
-  return found;
-}
+export type INavigationLiveTree = ILiveTree & {
+  findAllLive: (root: ISymbioteNode, viewName: string) => ILiveNode[];
+  findLive: (root: ISymbioteNode, viewName: string) => ILiveNode | undefined;
+  countLive: (root: ISymbioteNode, viewName: string) => number;
+  findLiveByTestId: (
+    root: ISymbioteNode,
+    testID: string,
+  ) => ILiveNode | undefined;
+  rawTextsOutsideTextContainer: (root: ISymbioteNode) => string[];
+};
 
 const TEXT_CONTAINER_VIEW_NAMES = new Set(['RCTText', 'RCTVirtualText']);
 
-// Every raw text committed under a parent that cannot hold one - an invalid Fabric child.
-// The gap Svelte leaves between two sibling tags compiles to a ' ' text node, and the shim
-// drops it exactly when the parent takes no raw text (dom-shim/text.ts, svelte-adapter-dom-shim
-// §16b); inside an RCTText the same string is a real word separator and must survive. So the
-// parent, not the string, is what makes a raw text legal, and this returns the ones that are
-// not. Formatted `viewName > "text"` so a failure names the offender.
-export function rawTextsOutsideTextContainer(root: unknown): string[] {
-  const found: string[] = [];
-  const visit = (node: unknown, parent: IFabricNode | undefined): void => {
-    if (!isFabricNode(node)) return;
-    const parentName = parent?.viewName;
-    if (
-      node.viewName === 'RCTRawText' &&
-      (parentName === undefined || !TEXT_CONTAINER_VIEW_NAMES.has(parentName))
-    ) {
-      found.push(`${String(parentName)} > ${JSON.stringify(node.props?.text)}`);
-    }
-    for (const child of node.children ?? []) visit(child, node);
-  };
-  visit(root, undefined);
-  return found;
-}
+export function createNavigationLiveTree(
+  fabric: IRecordingHost,
+): INavigationLiveTree {
+  const live = createLiveTree(fabric);
+  const byName = (root: ISymbioteNode, viewName: string): ILiveNode[] =>
+    live.findAllLive(root, node => node.viewName === viewName);
+
+  return {
+    ...live,
+    findAllLive: byName,
+    findLive: (root, viewName) => byName(root, viewName)[0],
+    countLive: (root, viewName) => byName(root, viewName).length,
+    findLiveByTestId: (root, testID) =>
+      live.findLive(root, node => node.props.testID === testID),
 
-// A depth-indented `viewName` outline, for asserting the exact committed SHAPE (which is what
-// catches a stray whitespace text node, an extra wrapper, or a missing header).
-export function outline(root: unknown): string[] {
-  const lines: string[] = [];
-  const visit = (node: unknown, depth: number): void => {
-    if (!isFabricNode(node)) return;
-    lines.push(`${'  '.repeat(depth)}${String(node.viewName)}`);
-    for (const child of node.children ?? []) visit(child, depth + 1);
+    // Every raw text under a parent that cannot hold one - an invalid Fabric child. The gap Svelte
+    // leaves between two sibling tags compiles to a ' ' text node, and the shim drops it exactly
+    // when the parent takes no raw text (dom-shim/text.ts, svelte-adapter-dom-shim §16b); inside an
+    // RCTText the same string is a real word separator and must survive. So the parent, not the
+    // string, is what makes a raw text legal, and this returns the ones that are not. Formatted
+    // `viewName > "text"` so a failure names the offender.
+    rawTextsOutsideTextContainer: (root): string[] => {
+      const found: string[] = [];
+      const visit = (node: ILiveNode, parentName: string | undefined): void => {
+        if (
+          node.viewName === 'RCTRawText' &&
+          (parentName === undefined ||
+            !TEXT_CONTAINER_VIEW_NAMES.has(parentName))
+        ) {
+          found.push(
+            `${String(parentName)} > ${JSON.stringify(node.props.text)}`,
+          );
+        }
+        for (const child of node.children) visit(child, node.viewName);
+      };
+      visit(live.nodeOf(root), undefined);
+      return found;
+    },
   };
-  visit(root, 0);
-  return lines;
 }