@simon-says-build/demo-player 0.4.0 → 0.5.0

package/index.d.ts

@@ -31,3 +31,13 @@ export const PLAYER_VERSION: string;
 export function reviewChangesOf(demo: unknown): { jobId: string; title: string }[];
 /** A release's demo (0.4.0): the session merge its review card releases, or null. */
 export function releaseOf(demo: unknown): { jobId: string; label: string; note: string } | null;
+
+/**
+ * React Navigation (an app without expo-router): a path is the chain of route
+ * names to the focused screen, "/MainStack/Tabs/Dashboard". `nav` is the
+ * NavigationContainer's ref (or the container), read at call time.
+ */
+export function navigationRoute(nav: unknown): string;
+export function navigationRouter(nav: unknown): { push: (path: string) => boolean };
+export function navigateArgs(path: string): [string] | [string, object] | null;
+export function pathOfState(state: unknown): string;

package/index.js

@@ -1,2 +1,3 @@
 export { DemoHost } from './src/DemoHost.js';
 export { demoConfig, findTarget, handlerFor, phoneSteps, scalePoint, playDemo, currentDemo, onDemo, reviewChangesOf, releaseOf, PLAYER_VERSION } from './src/core.js';
+export { navigationRoute, navigationRouter, navigateArgs, pathOfState } from './src/navigation.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simon-says-build/demo-player",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "SimonSays mobile demo player: walks a preview's viewer through a job's change, inside the app. Renders nothing unless the bundle carries a demo.",
   "repository": {
     "type": "git",

package/src/core.js

@@ -10,7 +10,7 @@ import { bubbleBox } from './step-place.js';
 // What this player is, said when the app registers for "Ready to see"
 // (packages/ssb-overlay sends it; functions/in-app-notify.mjs clientOf). Kept
 // equal to package.json by test/core.test.mjs.
-export const PLAYER_VERSION = '0.4.0';
+export const PLAYER_VERSION = '0.5.0';
 
 export const HOST = 5;
 export const TEXT = 6;

package/src/navigation.js

@@ -0,0 +1,52 @@
+// REACT NAVIGATION, for an app without expo-router (2026-10-22, SuperSub's
+// Center and Sub apps). A demo's `goto` step carries an in-app PATH, and the
+// in-app overlay reports the screen a person is on as one. For an
+// expo-router app that is its URL path. For a React Navigation app it is the
+// chain of route NAMES from the root to the focused screen:
+//
+//     /MainStack/Tabs/Dashboard
+//
+// navigationRoute() reads that off the navigation container, and
+// navigationRouter() replays it with nested navigate() calls, so a path the
+// overlay recorded is one the demo player can open. Both take the container
+// (or a ref to it, read at call time). Pure apart from the container.
+
+const containerOf = (nav) => (nav && 'current' in nav ? nav.current : nav);
+
+/** The focused route's path, "/A/B/C", from a navigation state; "" when there is none. */
+export function pathOfState(state) {
+  const names = [];
+  for (let s = state; s && Array.isArray(s.routes) && s.routes.length;) {
+    const r = s.routes[Number.isInteger(s.index) ? s.index : s.routes.length - 1];
+    if (!r?.name) break;
+    names.push(r.name);
+    s = r.state;
+  }
+  return names.length ? `/${names.map(encodeURIComponent).join('/')}` : '';
+}
+
+/** What navigate() is called with to open a path: [name, params], or null for a path that names nothing. */
+export function navigateArgs(path) {
+  const names = String(path || '').split('?')[0].split('/').filter(Boolean).map((n) => { try { return decodeURIComponent(n); } catch { return n; } });
+  if (!names.length) return null;
+  let params;
+  for (let i = names.length - 1; i >= 1; i--) params = params ? { screen: names[i], params } : { screen: names[i] };
+  return params ? [names[0], params] : [names[0]];
+}
+
+/** The current screen's path on a React Navigation container ("" before it is ready). */
+export function navigationRoute(nav) {
+  try { return pathOfState(containerOf(nav)?.getRootState?.()); } catch { return ''; }
+}
+
+/** A `router` for <DemoHost> on a React Navigation app: push(path) opens it. */
+export function navigationRouter(nav) {
+  return {
+    push(path) {
+      const c = containerOf(nav);
+      const args = navigateArgs(path);
+      if (!c?.navigate || !args) return false;
+      try { c.navigate(...args); return true; } catch { return false; }
+    },
+  };
+}