@noego/wood 0.4.9 → 0.5.0

package/dist/navigation/automation_introspection.d.cts

@@ -0,0 +1,60 @@
+/**
+ * Dev/test-only automation introspection (Axe.md AXE-WP-02).
+ *
+ * Exposes a narrow, versioned inspection surface for the Axe live driver:
+ * current route, readiness, and route-change subscription. It exposes no
+ * privileged operations.
+ *
+ * Deviation from the spec's `bridge.__automation` shape: the preload bridge
+ * (`__NOEGO_WOOD_BRIDGE__`) is a sealed contextBridge object that renderer
+ * code cannot extend, so the surface is installed as the sibling main-world
+ * global `__NOEGO_WOOD_AUTOMATION__`. Axe reads it the same way.
+ *
+ * This module lives in the renderer bundle. It must only be installed in
+ * development and explicit test builds — the generated renderer app gates the
+ * install call; this module never self-installs on import.
+ */
+declare const WOOD_AUTOMATION_GLOBAL_KEY = "__NOEGO_WOOD_AUTOMATION__";
+interface WoodAutomationSnapshot {
+    version: 1;
+    windowId: string | null;
+    currentRoute: {
+        page: string;
+        params: Record<string, string>;
+        query: Record<string, string>;
+    } | null;
+    navigationDepth: number;
+    rendererReady: boolean;
+    pendingWork: {
+        bridgeCalls: number;
+        renders: number;
+        animations: number;
+    };
+}
+type WoodAutomationEvent = {
+    kind: 'route';
+    entry: WoodAutomationSnapshot['currentRoute'];
+};
+interface WoodAutomationIntrospection {
+    version: 1;
+    snapshot: () => WoodAutomationSnapshot;
+    waitForIdle: (options?: {
+        timeoutMs?: number;
+        idleFrames?: number;
+    }) => Promise<boolean>;
+    subscribe: (listener: (event: WoodAutomationEvent) => void) => () => void;
+}
+interface InstallAutomationIntrospectionOptions {
+    /** Wood window identity when known at install time. */
+    windowId?: string | null;
+    /** Override for tests; defaults to `globalThis`. */
+    globalObject?: Record<string, unknown>;
+}
+/**
+ * Install the introspection global. Idempotent: repeated installs replace the
+ * previous surface (fresh navigation subscription, updated windowId).
+ * Returns an uninstall function.
+ */
+declare function installAutomationIntrospection(options?: InstallAutomationIntrospectionOptions): () => void;
+
+export { type InstallAutomationIntrospectionOptions, WOOD_AUTOMATION_GLOBAL_KEY, type WoodAutomationEvent, type WoodAutomationIntrospection, type WoodAutomationSnapshot, installAutomationIntrospection };

package/dist/navigation/automation_introspection.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Dev/test-only automation introspection (Axe.md AXE-WP-02).
+ *
+ * Exposes a narrow, versioned inspection surface for the Axe live driver:
+ * current route, readiness, and route-change subscription. It exposes no
+ * privileged operations.
+ *
+ * Deviation from the spec's `bridge.__automation` shape: the preload bridge
+ * (`__NOEGO_WOOD_BRIDGE__`) is a sealed contextBridge object that renderer
+ * code cannot extend, so the surface is installed as the sibling main-world
+ * global `__NOEGO_WOOD_AUTOMATION__`. Axe reads it the same way.
+ *
+ * This module lives in the renderer bundle. It must only be installed in
+ * development and explicit test builds — the generated renderer app gates the
+ * install call; this module never self-installs on import.
+ */
+declare const WOOD_AUTOMATION_GLOBAL_KEY = "__NOEGO_WOOD_AUTOMATION__";
+interface WoodAutomationSnapshot {
+    version: 1;
+    windowId: string | null;
+    currentRoute: {
+        page: string;
+        params: Record<string, string>;
+        query: Record<string, string>;
+    } | null;
+    navigationDepth: number;
+    rendererReady: boolean;
+    pendingWork: {
+        bridgeCalls: number;
+        renders: number;
+        animations: number;
+    };
+}
+type WoodAutomationEvent = {
+    kind: 'route';
+    entry: WoodAutomationSnapshot['currentRoute'];
+};
+interface WoodAutomationIntrospection {
+    version: 1;
+    snapshot: () => WoodAutomationSnapshot;
+    waitForIdle: (options?: {
+        timeoutMs?: number;
+        idleFrames?: number;
+    }) => Promise<boolean>;
+    subscribe: (listener: (event: WoodAutomationEvent) => void) => () => void;
+}
+interface InstallAutomationIntrospectionOptions {
+    /** Wood window identity when known at install time. */
+    windowId?: string | null;
+    /** Override for tests; defaults to `globalThis`. */
+    globalObject?: Record<string, unknown>;
+}
+/**
+ * Install the introspection global. Idempotent: repeated installs replace the
+ * previous surface (fresh navigation subscription, updated windowId).
+ * Returns an uninstall function.
+ */
+declare function installAutomationIntrospection(options?: InstallAutomationIntrospectionOptions): () => void;
+
+export { type InstallAutomationIntrospectionOptions, WOOD_AUTOMATION_GLOBAL_KEY, type WoodAutomationEvent, type WoodAutomationIntrospection, type WoodAutomationSnapshot, installAutomationIntrospection };

package/dist/navigation/automation_introspection.js

@@ -0,0 +1,85 @@
+import { getNavigation } from "./index.js";
+const WOOD_AUTOMATION_GLOBAL_KEY = "__NOEGO_WOOD_AUTOMATION__";
+function toRoute(entry) {
+  if (!entry) {
+    return null;
+  }
+  return { page: entry.page, params: { ...entry.params }, query: { ...entry.query } };
+}
+function installAutomationIntrospection(options = {}) {
+  const globalObject = options.globalObject ?? globalThis;
+  const navigation = getNavigation();
+  let routeRevision = 0;
+  const listeners = /* @__PURE__ */ new Set();
+  const unsubscribeNavigation = navigation.subscribe((entry) => {
+    routeRevision += 1;
+    const event = { kind: "route", entry: toRoute(entry) };
+    for (const listener of listeners) {
+      listener(event);
+    }
+  });
+  const surface = {
+    version: 1,
+    snapshot: () => ({
+      version: 1,
+      windowId: options.windowId ?? null,
+      currentRoute: toRoute(navigation.getCurrent()),
+      navigationDepth: navigation.getPages().length,
+      rendererReady: true,
+      pendingWork: {
+        // Bounded placeholders until render/bridge instrumentation lands;
+        // consumers must treat unknown pending work as zero, not omit checks.
+        bridgeCalls: 0,
+        renders: 0,
+        animations: 0
+      }
+    }),
+    waitForIdle: (waitOptions) => {
+      const timeoutMs = waitOptions?.timeoutMs ?? 2e3;
+      const idleFramesRequired = waitOptions?.idleFrames ?? 3;
+      const raf = typeof requestAnimationFrame === "function" ? (cb) => requestAnimationFrame(() => cb()) : (cb) => void setTimeout(cb, 16);
+      return new Promise((resolve) => {
+        const startedAt = Date.now();
+        let lastSeenRevision = routeRevision;
+        let idleFrames = 0;
+        const step = () => {
+          if (Date.now() - startedAt > timeoutMs) {
+            resolve(false);
+            return;
+          }
+          if (routeRevision !== lastSeenRevision) {
+            lastSeenRevision = routeRevision;
+            idleFrames = 0;
+          } else {
+            idleFrames += 1;
+            if (idleFrames >= idleFramesRequired) {
+              resolve(true);
+              return;
+            }
+          }
+          raf(step);
+        };
+        raf(step);
+      });
+    },
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+  globalObject[WOOD_AUTOMATION_GLOBAL_KEY] = surface;
+  return () => {
+    unsubscribeNavigation();
+    listeners.clear();
+    if (globalObject[WOOD_AUTOMATION_GLOBAL_KEY] === surface) {
+      delete globalObject[WOOD_AUTOMATION_GLOBAL_KEY];
+    }
+  };
+}
+export {
+  WOOD_AUTOMATION_GLOBAL_KEY,
+  installAutomationIntrospection
+};
+//# sourceMappingURL=automation_introspection.js.map

package/dist/navigation/automation_introspection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/navigation/automation_introspection.ts"],"sourcesContent":["/**\n * Dev/test-only automation introspection (Axe.md AXE-WP-02).\n *\n * Exposes a narrow, versioned inspection surface for the Axe live driver:\n * current route, readiness, and route-change subscription. It exposes no\n * privileged operations.\n *\n * Deviation from the spec's `bridge.__automation` shape: the preload bridge\n * (`__NOEGO_WOOD_BRIDGE__`) is a sealed contextBridge object that renderer\n * code cannot extend, so the surface is installed as the sibling main-world\n * global `__NOEGO_WOOD_AUTOMATION__`. Axe reads it the same way.\n *\n * This module lives in the renderer bundle. It must only be installed in\n * development and explicit test builds — the generated renderer app gates the\n * install call; this module never self-installs on import.\n */\n\nimport { getNavigation, type NavigationEntry } from './index.js';\n\nexport const WOOD_AUTOMATION_GLOBAL_KEY = '__NOEGO_WOOD_AUTOMATION__';\n\nexport interface WoodAutomationSnapshot {\n  version: 1;\n  windowId: string | null;\n  currentRoute: {\n    page: string;\n    params: Record<string, string>;\n    query: Record<string, string>;\n  } | null;\n  navigationDepth: number;\n  rendererReady: boolean;\n  pendingWork: {\n    bridgeCalls: number;\n    renders: number;\n    animations: number;\n  };\n}\n\nexport type WoodAutomationEvent =\n  | { kind: 'route'; entry: WoodAutomationSnapshot['currentRoute'] };\n\nexport interface WoodAutomationIntrospection {\n  version: 1;\n  snapshot: () => WoodAutomationSnapshot;\n  waitForIdle: (options?: { timeoutMs?: number; idleFrames?: number }) => Promise<boolean>;\n  subscribe: (listener: (event: WoodAutomationEvent) => void) => () => void;\n}\n\nexport interface InstallAutomationIntrospectionOptions {\n  /** Wood window identity when known at install time. */\n  windowId?: string | null;\n  /** Override for tests; defaults to `globalThis`. */\n  globalObject?: Record<string, unknown>;\n}\n\nfunction toRoute(entry: NavigationEntry | null): WoodAutomationSnapshot['currentRoute'] {\n  if (!entry) {\n    return null;\n  }\n  return { page: entry.page, params: { ...entry.params }, query: { ...entry.query } };\n}\n\n/**\n * Install the introspection global. Idempotent: repeated installs replace the\n * previous surface (fresh navigation subscription, updated windowId).\n * Returns an uninstall function.\n */\nexport function installAutomationIntrospection(\n  options: InstallAutomationIntrospectionOptions = {},\n): () => void {\n  const globalObject = options.globalObject ?? (globalThis as unknown as Record<string, unknown>);\n  const navigation = getNavigation();\n\n  let routeRevision = 0;\n  const listeners = new Set<(event: WoodAutomationEvent) => void>();\n\n  const unsubscribeNavigation = navigation.subscribe((entry) => {\n    routeRevision += 1;\n    const event: WoodAutomationEvent = { kind: 'route', entry: toRoute(entry) };\n    for (const listener of listeners) {\n      listener(event);\n    }\n  });\n\n  const surface: WoodAutomationIntrospection = {\n    version: 1,\n    snapshot: () => ({\n      version: 1,\n      windowId: options.windowId ?? null,\n      currentRoute: toRoute(navigation.getCurrent()),\n      navigationDepth: navigation.getPages().length,\n      rendererReady: true,\n      pendingWork: {\n        // Bounded placeholders until render/bridge instrumentation lands;\n        // consumers must treat unknown pending work as zero, not omit checks.\n        bridgeCalls: 0,\n        renders: 0,\n        animations: 0,\n      },\n    }),\n    waitForIdle: (waitOptions) => {\n      const timeoutMs = waitOptions?.timeoutMs ?? 2_000;\n      const idleFramesRequired = waitOptions?.idleFrames ?? 3;\n      const raf: (cb: () => void) => void =\n        typeof requestAnimationFrame === 'function'\n          ? (cb) => requestAnimationFrame(() => cb())\n          : (cb) => void setTimeout(cb, 16);\n\n      return new Promise<boolean>((resolve) => {\n        const startedAt = Date.now();\n        let lastSeenRevision = routeRevision;\n        let idleFrames = 0;\n\n        const step = (): void => {\n          if (Date.now() - startedAt > timeoutMs) {\n            resolve(false);\n            return;\n          }\n          if (routeRevision !== lastSeenRevision) {\n            lastSeenRevision = routeRevision;\n            idleFrames = 0;\n          } else {\n            idleFrames += 1;\n            if (idleFrames >= idleFramesRequired) {\n              resolve(true);\n              return;\n            }\n          }\n          raf(step);\n        };\n\n        raf(step);\n      });\n    },\n    subscribe: (listener) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n\n  globalObject[WOOD_AUTOMATION_GLOBAL_KEY] = surface;\n\n  return () => {\n    unsubscribeNavigation();\n    listeners.clear();\n    if (globalObject[WOOD_AUTOMATION_GLOBAL_KEY] === surface) {\n      delete globalObject[WOOD_AUTOMATION_GLOBAL_KEY];\n    }\n  };\n}\n"],"mappings":"AAiBA,SAAS,qBAA2C;AAE7C,MAAM,6BAA6B;AAoC1C,SAAS,QAAQ,OAAuE;AACtF,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AACA,SAAO,EAAE,MAAM,MAAM,MAAM,QAAQ,EAAE,GAAG,MAAM,OAAO,GAAG,OAAO,EAAE,GAAG,MAAM,MAAM,EAAE;AACpF;AAOO,SAAS,+BACd,UAAiD,CAAC,GACtC;AACZ,QAAM,eAAe,QAAQ,gBAAiB;AAC9C,QAAM,aAAa,cAAc;AAEjC,MAAI,gBAAgB;AACpB,QAAM,YAAY,oBAAI,IAA0C;AAEhE,QAAM,wBAAwB,WAAW,UAAU,CAAC,UAAU;AAC5D,qBAAiB;AACjB,UAAM,QAA6B,EAAE,MAAM,SAAS,OAAO,QAAQ,KAAK,EAAE;AAC1E,eAAW,YAAY,WAAW;AAChC,eAAS,KAAK;AAAA,IAChB;AAAA,EACF,CAAC;AAED,QAAM,UAAuC;AAAA,IAC3C,SAAS;AAAA,IACT,UAAU,OAAO;AAAA,MACf,SAAS;AAAA,MACT,UAAU,QAAQ,YAAY;AAAA,MAC9B,cAAc,QAAQ,WAAW,WAAW,CAAC;AAAA,MAC7C,iBAAiB,WAAW,SAAS,EAAE;AAAA,MACvC,eAAe;AAAA,MACf,aAAa;AAAA;AAAA;AAAA,QAGX,aAAa;AAAA,QACb,SAAS;AAAA,QACT,YAAY;AAAA,MACd;AAAA,IACF;AAAA,IACA,aAAa,CAAC,gBAAgB;AAC5B,YAAM,YAAY,aAAa,aAAa;AAC5C,YAAM,qBAAqB,aAAa,cAAc;AACtD,YAAM,MACJ,OAAO,0BAA0B,aAC7B,CAAC,OAAO,sBAAsB,MAAM,GAAG,CAAC,IACxC,CAAC,OAAO,KAAK,WAAW,IAAI,EAAE;AAEpC,aAAO,IAAI,QAAiB,CAAC,YAAY;AACvC,cAAM,YAAY,KAAK,IAAI;AAC3B,YAAI,mBAAmB;AACvB,YAAI,aAAa;AAEjB,cAAM,OAAO,MAAY;AACvB,cAAI,KAAK,IAAI,IAAI,YAAY,WAAW;AACtC,oBAAQ,KAAK;AACb;AAAA,UACF;AACA,cAAI,kBAAkB,kBAAkB;AACtC,+BAAmB;AACnB,yBAAa;AAAA,UACf,OAAO;AACL,0BAAc;AACd,gBAAI,cAAc,oBAAoB;AACpC,sBAAQ,IAAI;AACZ;AAAA,YACF;AAAA,UACF;AACA,cAAI,IAAI;AAAA,QACV;AAEA,YAAI,IAAI;AAAA,MACV,CAAC;AAAA,IACH;AAAA,IACA,WAAW,CAAC,aAAa;AACvB,gBAAU,IAAI,QAAQ;AACtB,aAAO,MAAM;AACX,kBAAU,OAAO,QAAQ;AAAA,MAC3B;AAAA,IACF;AAAA,EACF;AAEA,eAAa,0BAA0B,IAAI;AAE3C,SAAO,MAAM;AACX,0BAAsB;AACtB,cAAU,MAAM;AAChB,QAAI,aAAa,0BAA0B,MAAM,SAAS;AACxD,aAAO,aAAa,0BAA0B;AAAA,IAChD;AAAA,EACF;AACF;","names":[]}

package/dist/navigation/index.cjs

@@ -19,14 +19,19 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var navigation_exports = {};
 __export(navigation_exports, {
   Navigation: () => Navigation,
+  WOOD_AUTOMATION_GLOBAL_KEY: () => import_automation_introspection.WOOD_AUTOMATION_GLOBAL_KEY,
   clearNavigationForTests: () => clearNavigationForTests,
+  computePreservedLayoutDepth: () => import_layout_preservation.computePreservedLayoutDepth,
   getNavigation: () => getNavigation,
   go: () => go,
   goback: () => goback,
-  goto: () => goto
+  goto: () => goto,
+  installAutomationIntrospection: () => import_automation_introspection.installAutomationIntrospection
 });
 module.exports = __toCommonJS(navigation_exports);
 var import_tracing = require("../tracing/index.js");
+var import_automation_introspection = require("./automation_introspection.cjs");
+var import_layout_preservation = require("./layout_preservation.cjs");
 const NAVIGATION_SYMBOL = /* @__PURE__ */ Symbol.for("@noego/wood.navigation");
 const HISTORY_STATE_MARKER = "__wood_navigation_state__";
 class Navigation {
@@ -201,10 +206,13 @@ function clearNavigationForTests() {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Navigation,
+  WOOD_AUTOMATION_GLOBAL_KEY,
   clearNavigationForTests,
+  computePreservedLayoutDepth,
   getNavigation,
   go,
   goback,
-  goto
+  goto,
+  installAutomationIntrospection
 });
 //# sourceMappingURL=index.cjs.map

package/dist/navigation/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/navigation/index.ts"],"sourcesContent":["import { emitRendererTrace } from '../tracing/index.js';\n\nconst NAVIGATION_SYMBOL = Symbol.for('@noego/wood.navigation');\nconst HISTORY_STATE_MARKER = '__wood_navigation_state__';\n\nexport interface NavigationEntry {\n  page: string;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  options: NavigationOptions;\n}\n\nexport interface NavigationOptions {\n  preserveLayouts?: boolean;\n}\n\ntype NavigationHistoryState = NavigationEntry & {\n  [HISTORY_STATE_MARKER]: true;\n};\n\ntype NavigationListener = (entry: NavigationEntry | null) => void;\n\nexport class Navigation {\n  private entries: NavigationEntry[] = [];\n  private index = -1;\n  private listeners = new Set<NavigationListener>();\n\n  getCurrent(): NavigationEntry | null {\n    if (this.index < 0 || this.index >= this.entries.length) {\n      return null;\n    }\n    return this.cloneEntry(this.entries[this.index]);\n  }\n\n  getPages(): NavigationEntry[] {\n    return this.entries.map((entry) => this.cloneEntry(entry));\n  }\n\n  getParams(): Record<string, string> {\n    const current = this.getCurrent();\n    if (!current) {\n      return {};\n    }\n    return { ...current.params };\n  }\n\n  replace(\n    page: string,\n    params: Record<string, string> = {},\n    query: Record<string, string> = {},\n    options: NavigationOptions = {},\n  ): NavigationEntry {\n    const entry = this.createEntry(page, params, query, options);\n\n    if (this.index < 0) {\n      this.entries.push(entry);\n      this.index = 0;\n    } else {\n      this.entries[this.index] = entry;\n    }\n\n    this.writeWindowHistory('replaceState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.replace',\n      payload: {\n        page: entry.page,\n        params: entry.params,\n        query: entry.query,\n        options: entry.options,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  go(\n    page: string,\n    params: Record<string, string> = {},\n    query: Record<string, string> = {},\n    options: NavigationOptions = {},\n  ): NavigationEntry {\n    const entry = this.createEntry(page, params, query, options);\n    if (this.index < this.entries.length - 1) {\n      this.entries = this.entries.slice(0, this.index + 1);\n    }\n    this.entries.push(entry);\n    this.index = this.entries.length - 1;\n\n    this.writeWindowHistory('pushState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.go',\n      payload: {\n        page: entry.page,\n        params: entry.params,\n        query: entry.query,\n        options: entry.options,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  goto(delta: number): NavigationEntry | null {\n    return this.moveCursor(delta);\n  }\n\n  goBack(): NavigationEntry | null {\n    return this.goto(-1);\n  }\n\n  goForward(): NavigationEntry | null {\n    return this.goto(1);\n  }\n\n  subscribe(listener: NavigationListener): () => void {\n    this.listeners.add(listener);\n    listener(this.getCurrent());\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  private moveCursor(delta: number): NavigationEntry | null {\n    if (delta === 0) {\n      return this.getCurrent();\n    }\n\n    const nextIndex = this.index + delta;\n    if (nextIndex < 0 || nextIndex >= this.entries.length) {\n      return this.getCurrent();\n    }\n\n    this.index = nextIndex;\n    const entry = this.entries[this.index];\n    this.writeWindowHistory('replaceState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.goto',\n      payload: {\n        delta,\n        page: entry.page,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  private notify(): void {\n    const current = this.getCurrent();\n    for (const listener of this.listeners) {\n      listener(current);\n    }\n  }\n\n  private createEntry(\n    page: string,\n    params: Record<string, string>,\n    query: Record<string, string>,\n    options: NavigationOptions,\n  ): NavigationEntry {\n    return {\n      page,\n      params: this.normalizeRecord(params),\n      query: this.normalizeRecord(query),\n      options: { ...options },\n    };\n  }\n\n  private cloneEntry(entry: NavigationEntry): NavigationEntry {\n    return {\n      page: entry.page,\n      params: { ...entry.params },\n      query: { ...entry.query },\n      options: { ...entry.options },\n    };\n  }\n\n  private normalizeRecord(input: Record<string, string>): Record<string, string> {\n    const output: Record<string, string> = {};\n    for (const [key, value] of Object.entries(input ?? {})) {\n      output[String(key)] = String(value);\n    }\n    return output;\n  }\n\n  private writeWindowHistory(\n    mode: 'pushState' | 'replaceState',\n    entry: NavigationEntry,\n  ): void {\n    if (typeof window === 'undefined') {\n      return;\n    }\n\n    const state: NavigationHistoryState = {\n      [HISTORY_STATE_MARKER]: true,\n      page: entry.page,\n      params: { ...entry.params },\n      query: { ...entry.query },\n      options: { ...entry.options },\n    };\n\n    window.history[mode](state, '');\n  }\n}\n\ntype GlobalWithNavigation = typeof globalThis & {\n  [NAVIGATION_SYMBOL]?: Navigation;\n};\n\nfunction createNavigationInstance(): Navigation {\n  return new Navigation();\n}\n\nexport function getNavigation(): Navigation {\n  const globalObj = globalThis as GlobalWithNavigation;\n  if (!globalObj[NAVIGATION_SYMBOL]) {\n    globalObj[NAVIGATION_SYMBOL] = createNavigationInstance();\n  }\n  return globalObj[NAVIGATION_SYMBOL];\n}\n\nexport function goto(\n  delta: number,\n): NavigationEntry | null {\n  return getNavigation().goto(delta);\n}\n\nexport function go(\n  page: string,\n  params: Record<string, string> = {},\n  query: Record<string, string> = {},\n  options: NavigationOptions = {},\n): NavigationEntry {\n  return getNavigation().go(page, params, query, options);\n}\n\nexport function goback(): NavigationEntry | null {\n  return goto(-1);\n}\n\n/** Test-only helper to clear the navigation singleton. */\nexport function clearNavigationForTests(): void {\n  const globalObj = globalThis as GlobalWithNavigation;\n  delete globalObj[NAVIGATION_SYMBOL];\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/navigation/index.ts"],"sourcesContent":["import { emitRendererTrace } from '../tracing/index.js';\n\nconst NAVIGATION_SYMBOL = Symbol.for('@noego/wood.navigation');\nconst HISTORY_STATE_MARKER = '__wood_navigation_state__';\n\nexport interface NavigationEntry {\n  page: string;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  options: NavigationOptions;\n}\n\nexport interface NavigationOptions {\n  preserveLayouts?: boolean;\n}\n\ntype NavigationHistoryState = NavigationEntry & {\n  [HISTORY_STATE_MARKER]: true;\n};\n\ntype NavigationListener = (entry: NavigationEntry | null) => void;\n\nexport class Navigation {\n  private entries: NavigationEntry[] = [];\n  private index = -1;\n  private listeners = new Set<NavigationListener>();\n\n  getCurrent(): NavigationEntry | null {\n    if (this.index < 0 || this.index >= this.entries.length) {\n      return null;\n    }\n    return this.cloneEntry(this.entries[this.index]);\n  }\n\n  getPages(): NavigationEntry[] {\n    return this.entries.map((entry) => this.cloneEntry(entry));\n  }\n\n  getParams(): Record<string, string> {\n    const current = this.getCurrent();\n    if (!current) {\n      return {};\n    }\n    return { ...current.params };\n  }\n\n  replace(\n    page: string,\n    params: Record<string, string> = {},\n    query: Record<string, string> = {},\n    options: NavigationOptions = {},\n  ): NavigationEntry {\n    const entry = this.createEntry(page, params, query, options);\n\n    if (this.index < 0) {\n      this.entries.push(entry);\n      this.index = 0;\n    } else {\n      this.entries[this.index] = entry;\n    }\n\n    this.writeWindowHistory('replaceState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.replace',\n      payload: {\n        page: entry.page,\n        params: entry.params,\n        query: entry.query,\n        options: entry.options,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  go(\n    page: string,\n    params: Record<string, string> = {},\n    query: Record<string, string> = {},\n    options: NavigationOptions = {},\n  ): NavigationEntry {\n    const entry = this.createEntry(page, params, query, options);\n    if (this.index < this.entries.length - 1) {\n      this.entries = this.entries.slice(0, this.index + 1);\n    }\n    this.entries.push(entry);\n    this.index = this.entries.length - 1;\n\n    this.writeWindowHistory('pushState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.go',\n      payload: {\n        page: entry.page,\n        params: entry.params,\n        query: entry.query,\n        options: entry.options,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  goto(delta: number): NavigationEntry | null {\n    return this.moveCursor(delta);\n  }\n\n  goBack(): NavigationEntry | null {\n    return this.goto(-1);\n  }\n\n  goForward(): NavigationEntry | null {\n    return this.goto(1);\n  }\n\n  subscribe(listener: NavigationListener): () => void {\n    this.listeners.add(listener);\n    listener(this.getCurrent());\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  private moveCursor(delta: number): NavigationEntry | null {\n    if (delta === 0) {\n      return this.getCurrent();\n    }\n\n    const nextIndex = this.index + delta;\n    if (nextIndex < 0 || nextIndex >= this.entries.length) {\n      return this.getCurrent();\n    }\n\n    this.index = nextIndex;\n    const entry = this.entries[this.index];\n    this.writeWindowHistory('replaceState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.goto',\n      payload: {\n        delta,\n        page: entry.page,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  private notify(): void {\n    const current = this.getCurrent();\n    for (const listener of this.listeners) {\n      listener(current);\n    }\n  }\n\n  private createEntry(\n    page: string,\n    params: Record<string, string>,\n    query: Record<string, string>,\n    options: NavigationOptions,\n  ): NavigationEntry {\n    return {\n      page,\n      params: this.normalizeRecord(params),\n      query: this.normalizeRecord(query),\n      options: { ...options },\n    };\n  }\n\n  private cloneEntry(entry: NavigationEntry): NavigationEntry {\n    return {\n      page: entry.page,\n      params: { ...entry.params },\n      query: { ...entry.query },\n      options: { ...entry.options },\n    };\n  }\n\n  private normalizeRecord(input: Record<string, string>): Record<string, string> {\n    const output: Record<string, string> = {};\n    for (const [key, value] of Object.entries(input ?? {})) {\n      output[String(key)] = String(value);\n    }\n    return output;\n  }\n\n  private writeWindowHistory(\n    mode: 'pushState' | 'replaceState',\n    entry: NavigationEntry,\n  ): void {\n    if (typeof window === 'undefined') {\n      return;\n    }\n\n    const state: NavigationHistoryState = {\n      [HISTORY_STATE_MARKER]: true,\n      page: entry.page,\n      params: { ...entry.params },\n      query: { ...entry.query },\n      options: { ...entry.options },\n    };\n\n    window.history[mode](state, '');\n  }\n}\n\ntype GlobalWithNavigation = typeof globalThis & {\n  [NAVIGATION_SYMBOL]?: Navigation;\n};\n\nfunction createNavigationInstance(): Navigation {\n  return new Navigation();\n}\n\nexport function getNavigation(): Navigation {\n  const globalObj = globalThis as GlobalWithNavigation;\n  if (!globalObj[NAVIGATION_SYMBOL]) {\n    globalObj[NAVIGATION_SYMBOL] = createNavigationInstance();\n  }\n  return globalObj[NAVIGATION_SYMBOL];\n}\n\nexport function goto(\n  delta: number,\n): NavigationEntry | null {\n  return getNavigation().goto(delta);\n}\n\nexport function go(\n  page: string,\n  params: Record<string, string> = {},\n  query: Record<string, string> = {},\n  options: NavigationOptions = {},\n): NavigationEntry {\n  return getNavigation().go(page, params, query, options);\n}\n\nexport function goback(): NavigationEntry | null {\n  return goto(-1);\n}\n\n/** Test-only helper to clear the navigation singleton. */\nexport function clearNavigationForTests(): void {\n  const globalObj = globalThis as GlobalWithNavigation;\n  delete globalObj[NAVIGATION_SYMBOL];\n}\n\n// Dev/test-only automation introspection surface (Axe AXE-WP-02).\n// Benign import cycle: automation_introspection uses getNavigation lazily.\n// NOTE: keep these re-exports single-line — the tsup extension-rewrite plugin\n// only rewrites single-line import/export specifiers.\nexport { installAutomationIntrospection, WOOD_AUTOMATION_GLOBAL_KEY } from './automation_introspection.cjs';\nexport type { WoodAutomationSnapshot, WoodAutomationEvent, WoodAutomationIntrospection, InstallAutomationIntrospectionOptions } from './automation_introspection.cjs';\nexport { computePreservedLayoutDepth } from './layout_preservation.cjs';\nexport type { LayoutStack } from './layout_preservation.cjs';\n"],"mappings":"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","names":[]}

package/dist/navigation/index.d.cts

@@ -1,3 +1,29 @@
+export { InstallAutomationIntrospectionOptions, WOOD_AUTOMATION_GLOBAL_KEY, WoodAutomationEvent, WoodAutomationIntrospection, WoodAutomationSnapshot, installAutomationIntrospection } from './automation_introspection.cjs';
+
+/**
+ * Layout preservation depth — the single production rule for how many
+ * leading layouts a navigation transition keeps mounted.
+ *
+ * One implementation, two callers: the renderer's NavigationShell (real
+ * component transitions) and the Node frontend application slice
+ * (`createFrontendSurface`). They must agree — a slice test that preserved
+ * a layout the renderer rebuilds, or vice versa, would be evidence about a
+ * rule that does not exist in production.
+ *
+ * The rule: walk the layout stacks in parallel and keep a layout only while
+ * BOTH sides declare the same layout path, the same layout controller, and
+ * both mark it `preserve: true`. `NavigationOptions.preserveLayouts`
+ * overrides the declaration in both directions.
+ */
+
+/** The layout stack of one view, in the shape both callers can supply. */
+interface LayoutStack {
+    layoutPaths: readonly string[];
+    layoutControllers?: ReadonlyArray<string | undefined>;
+    layoutPreserve?: readonly boolean[];
+}
+declare function computePreservedLayoutDepth(from: LayoutStack, to: LayoutStack, options?: NavigationOptions): number;
+
 interface NavigationEntry {
     page: string;
     params: Record<string, string>;
@@ -35,4 +61,4 @@ declare function goback(): NavigationEntry | null;
 /** Test-only helper to clear the navigation singleton. */
 declare function clearNavigationForTests(): void;
 
-export { Navigation, type NavigationEntry, type NavigationOptions, clearNavigationForTests, getNavigation, go, goback, goto };
+export { type LayoutStack, Navigation, type NavigationEntry, type NavigationOptions, clearNavigationForTests, computePreservedLayoutDepth, getNavigation, go, goback, goto };

package/dist/navigation/index.d.ts

@@ -1,3 +1,29 @@
+export { InstallAutomationIntrospectionOptions, WOOD_AUTOMATION_GLOBAL_KEY, WoodAutomationEvent, WoodAutomationIntrospection, WoodAutomationSnapshot, installAutomationIntrospection } from './automation_introspection.js';
+
+/**
+ * Layout preservation depth — the single production rule for how many
+ * leading layouts a navigation transition keeps mounted.
+ *
+ * One implementation, two callers: the renderer's NavigationShell (real
+ * component transitions) and the Node frontend application slice
+ * (`createFrontendSurface`). They must agree — a slice test that preserved
+ * a layout the renderer rebuilds, or vice versa, would be evidence about a
+ * rule that does not exist in production.
+ *
+ * The rule: walk the layout stacks in parallel and keep a layout only while
+ * BOTH sides declare the same layout path, the same layout controller, and
+ * both mark it `preserve: true`. `NavigationOptions.preserveLayouts`
+ * overrides the declaration in both directions.
+ */
+
+/** The layout stack of one view, in the shape both callers can supply. */
+interface LayoutStack {
+    layoutPaths: readonly string[];
+    layoutControllers?: ReadonlyArray<string | undefined>;
+    layoutPreserve?: readonly boolean[];
+}
+declare function computePreservedLayoutDepth(from: LayoutStack, to: LayoutStack, options?: NavigationOptions): number;
+
 interface NavigationEntry {
     page: string;
     params: Record<string, string>;
@@ -35,4 +61,4 @@ declare function goback(): NavigationEntry | null;
 /** Test-only helper to clear the navigation singleton. */
 declare function clearNavigationForTests(): void;
 
-export { Navigation, type NavigationEntry, type NavigationOptions, clearNavigationForTests, getNavigation, go, goback, goto };
+export { type LayoutStack, Navigation, type NavigationEntry, type NavigationOptions, clearNavigationForTests, computePreservedLayoutDepth, getNavigation, go, goback, goto };

package/dist/navigation/index.js

@@ -170,12 +170,17 @@ function clearNavigationForTests() {
   const globalObj = globalThis;
   delete globalObj[NAVIGATION_SYMBOL];
 }
+import { installAutomationIntrospection, WOOD_AUTOMATION_GLOBAL_KEY } from "./automation_introspection.js";
+import { computePreservedLayoutDepth } from "./layout_preservation.js";
 export {
   Navigation,
+  WOOD_AUTOMATION_GLOBAL_KEY,
   clearNavigationForTests,
+  computePreservedLayoutDepth,
   getNavigation,
   go,
   goback,
-  goto
+  goto,
+  installAutomationIntrospection
 };
 //# sourceMappingURL=index.js.map

package/dist/navigation/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/navigation/index.ts"],"sourcesContent":["import { emitRendererTrace } from '../tracing/index.js';\n\nconst NAVIGATION_SYMBOL = Symbol.for('@noego/wood.navigation');\nconst HISTORY_STATE_MARKER = '__wood_navigation_state__';\n\nexport interface NavigationEntry {\n  page: string;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  options: NavigationOptions;\n}\n\nexport interface NavigationOptions {\n  preserveLayouts?: boolean;\n}\n\ntype NavigationHistoryState = NavigationEntry & {\n  [HISTORY_STATE_MARKER]: true;\n};\n\ntype NavigationListener = (entry: NavigationEntry | null) => void;\n\nexport class Navigation {\n  private entries: NavigationEntry[] = [];\n  private index = -1;\n  private listeners = new Set<NavigationListener>();\n\n  getCurrent(): NavigationEntry | null {\n    if (this.index < 0 || this.index >= this.entries.length) {\n      return null;\n    }\n    return this.cloneEntry(this.entries[this.index]);\n  }\n\n  getPages(): NavigationEntry[] {\n    return this.entries.map((entry) => this.cloneEntry(entry));\n  }\n\n  getParams(): Record<string, string> {\n    const current = this.getCurrent();\n    if (!current) {\n      return {};\n    }\n    return { ...current.params };\n  }\n\n  replace(\n    page: string,\n    params: Record<string, string> = {},\n    query: Record<string, string> = {},\n    options: NavigationOptions = {},\n  ): NavigationEntry {\n    const entry = this.createEntry(page, params, query, options);\n\n    if (this.index < 0) {\n      this.entries.push(entry);\n      this.index = 0;\n    } else {\n      this.entries[this.index] = entry;\n    }\n\n    this.writeWindowHistory('replaceState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.replace',\n      payload: {\n        page: entry.page,\n        params: entry.params,\n        query: entry.query,\n        options: entry.options,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  go(\n    page: string,\n    params: Record<string, string> = {},\n    query: Record<string, string> = {},\n    options: NavigationOptions = {},\n  ): NavigationEntry {\n    const entry = this.createEntry(page, params, query, options);\n    if (this.index < this.entries.length - 1) {\n      this.entries = this.entries.slice(0, this.index + 1);\n    }\n    this.entries.push(entry);\n    this.index = this.entries.length - 1;\n\n    this.writeWindowHistory('pushState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.go',\n      payload: {\n        page: entry.page,\n        params: entry.params,\n        query: entry.query,\n        options: entry.options,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  goto(delta: number): NavigationEntry | null {\n    return this.moveCursor(delta);\n  }\n\n  goBack(): NavigationEntry | null {\n    return this.goto(-1);\n  }\n\n  goForward(): NavigationEntry | null {\n    return this.goto(1);\n  }\n\n  subscribe(listener: NavigationListener): () => void {\n    this.listeners.add(listener);\n    listener(this.getCurrent());\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  private moveCursor(delta: number): NavigationEntry | null {\n    if (delta === 0) {\n      return this.getCurrent();\n    }\n\n    const nextIndex = this.index + delta;\n    if (nextIndex < 0 || nextIndex >= this.entries.length) {\n      return this.getCurrent();\n    }\n\n    this.index = nextIndex;\n    const entry = this.entries[this.index];\n    this.writeWindowHistory('replaceState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.goto',\n      payload: {\n        delta,\n        page: entry.page,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  private notify(): void {\n    const current = this.getCurrent();\n    for (const listener of this.listeners) {\n      listener(current);\n    }\n  }\n\n  private createEntry(\n    page: string,\n    params: Record<string, string>,\n    query: Record<string, string>,\n    options: NavigationOptions,\n  ): NavigationEntry {\n    return {\n      page,\n      params: this.normalizeRecord(params),\n      query: this.normalizeRecord(query),\n      options: { ...options },\n    };\n  }\n\n  private cloneEntry(entry: NavigationEntry): NavigationEntry {\n    return {\n      page: entry.page,\n      params: { ...entry.params },\n      query: { ...entry.query },\n      options: { ...entry.options },\n    };\n  }\n\n  private normalizeRecord(input: Record<string, string>): Record<string, string> {\n    const output: Record<string, string> = {};\n    for (const [key, value] of Object.entries(input ?? {})) {\n      output[String(key)] = String(value);\n    }\n    return output;\n  }\n\n  private writeWindowHistory(\n    mode: 'pushState' | 'replaceState',\n    entry: NavigationEntry,\n  ): void {\n    if (typeof window === 'undefined') {\n      return;\n    }\n\n    const state: NavigationHistoryState = {\n      [HISTORY_STATE_MARKER]: true,\n      page: entry.page,\n      params: { ...entry.params },\n      query: { ...entry.query },\n      options: { ...entry.options },\n    };\n\n    window.history[mode](state, '');\n  }\n}\n\ntype GlobalWithNavigation = typeof globalThis & {\n  [NAVIGATION_SYMBOL]?: Navigation;\n};\n\nfunction createNavigationInstance(): Navigation {\n  return new Navigation();\n}\n\nexport function getNavigation(): Navigation {\n  const globalObj = globalThis as GlobalWithNavigation;\n  if (!globalObj[NAVIGATION_SYMBOL]) {\n    globalObj[NAVIGATION_SYMBOL] = createNavigationInstance();\n  }\n  return globalObj[NAVIGATION_SYMBOL];\n}\n\nexport function goto(\n  delta: number,\n): NavigationEntry | null {\n  return getNavigation().goto(delta);\n}\n\nexport function go(\n  page: string,\n  params: Record<string, string> = {},\n  query: Record<string, string> = {},\n  options: NavigationOptions = {},\n): NavigationEntry {\n  return getNavigation().go(page, params, query, options);\n}\n\nexport function goback(): NavigationEntry | null {\n  return goto(-1);\n}\n\n/** Test-only helper to clear the navigation singleton. */\nexport function clearNavigationForTests(): void {\n  const globalObj = globalThis as GlobalWithNavigation;\n  delete globalObj[NAVIGATION_SYMBOL];\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/navigation/index.ts"],"sourcesContent":["import { emitRendererTrace } from '../tracing/index.js';\n\nconst NAVIGATION_SYMBOL = Symbol.for('@noego/wood.navigation');\nconst HISTORY_STATE_MARKER = '__wood_navigation_state__';\n\nexport interface NavigationEntry {\n  page: string;\n  params: Record<string, string>;\n  query: Record<string, string>;\n  options: NavigationOptions;\n}\n\nexport interface NavigationOptions {\n  preserveLayouts?: boolean;\n}\n\ntype NavigationHistoryState = NavigationEntry & {\n  [HISTORY_STATE_MARKER]: true;\n};\n\ntype NavigationListener = (entry: NavigationEntry | null) => void;\n\nexport class Navigation {\n  private entries: NavigationEntry[] = [];\n  private index = -1;\n  private listeners = new Set<NavigationListener>();\n\n  getCurrent(): NavigationEntry | null {\n    if (this.index < 0 || this.index >= this.entries.length) {\n      return null;\n    }\n    return this.cloneEntry(this.entries[this.index]);\n  }\n\n  getPages(): NavigationEntry[] {\n    return this.entries.map((entry) => this.cloneEntry(entry));\n  }\n\n  getParams(): Record<string, string> {\n    const current = this.getCurrent();\n    if (!current) {\n      return {};\n    }\n    return { ...current.params };\n  }\n\n  replace(\n    page: string,\n    params: Record<string, string> = {},\n    query: Record<string, string> = {},\n    options: NavigationOptions = {},\n  ): NavigationEntry {\n    const entry = this.createEntry(page, params, query, options);\n\n    if (this.index < 0) {\n      this.entries.push(entry);\n      this.index = 0;\n    } else {\n      this.entries[this.index] = entry;\n    }\n\n    this.writeWindowHistory('replaceState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.replace',\n      payload: {\n        page: entry.page,\n        params: entry.params,\n        query: entry.query,\n        options: entry.options,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  go(\n    page: string,\n    params: Record<string, string> = {},\n    query: Record<string, string> = {},\n    options: NavigationOptions = {},\n  ): NavigationEntry {\n    const entry = this.createEntry(page, params, query, options);\n    if (this.index < this.entries.length - 1) {\n      this.entries = this.entries.slice(0, this.index + 1);\n    }\n    this.entries.push(entry);\n    this.index = this.entries.length - 1;\n\n    this.writeWindowHistory('pushState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.go',\n      payload: {\n        page: entry.page,\n        params: entry.params,\n        query: entry.query,\n        options: entry.options,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  goto(delta: number): NavigationEntry | null {\n    return this.moveCursor(delta);\n  }\n\n  goBack(): NavigationEntry | null {\n    return this.goto(-1);\n  }\n\n  goForward(): NavigationEntry | null {\n    return this.goto(1);\n  }\n\n  subscribe(listener: NavigationListener): () => void {\n    this.listeners.add(listener);\n    listener(this.getCurrent());\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  private moveCursor(delta: number): NavigationEntry | null {\n    if (delta === 0) {\n      return this.getCurrent();\n    }\n\n    const nextIndex = this.index + delta;\n    if (nextIndex < 0 || nextIndex >= this.entries.length) {\n      return this.getCurrent();\n    }\n\n    this.index = nextIndex;\n    const entry = this.entries[this.index];\n    this.writeWindowHistory('replaceState', entry);\n    this.notify();\n    emitRendererTrace('info', {\n      source: 'wood.navigation',\n      type: 'navigation.goto',\n      payload: {\n        delta,\n        page: entry.page,\n      },\n    });\n    return this.cloneEntry(entry);\n  }\n\n  private notify(): void {\n    const current = this.getCurrent();\n    for (const listener of this.listeners) {\n      listener(current);\n    }\n  }\n\n  private createEntry(\n    page: string,\n    params: Record<string, string>,\n    query: Record<string, string>,\n    options: NavigationOptions,\n  ): NavigationEntry {\n    return {\n      page,\n      params: this.normalizeRecord(params),\n      query: this.normalizeRecord(query),\n      options: { ...options },\n    };\n  }\n\n  private cloneEntry(entry: NavigationEntry): NavigationEntry {\n    return {\n      page: entry.page,\n      params: { ...entry.params },\n      query: { ...entry.query },\n      options: { ...entry.options },\n    };\n  }\n\n  private normalizeRecord(input: Record<string, string>): Record<string, string> {\n    const output: Record<string, string> = {};\n    for (const [key, value] of Object.entries(input ?? {})) {\n      output[String(key)] = String(value);\n    }\n    return output;\n  }\n\n  private writeWindowHistory(\n    mode: 'pushState' | 'replaceState',\n    entry: NavigationEntry,\n  ): void {\n    if (typeof window === 'undefined') {\n      return;\n    }\n\n    const state: NavigationHistoryState = {\n      [HISTORY_STATE_MARKER]: true,\n      page: entry.page,\n      params: { ...entry.params },\n      query: { ...entry.query },\n      options: { ...entry.options },\n    };\n\n    window.history[mode](state, '');\n  }\n}\n\ntype GlobalWithNavigation = typeof globalThis & {\n  [NAVIGATION_SYMBOL]?: Navigation;\n};\n\nfunction createNavigationInstance(): Navigation {\n  return new Navigation();\n}\n\nexport function getNavigation(): Navigation {\n  const globalObj = globalThis as GlobalWithNavigation;\n  if (!globalObj[NAVIGATION_SYMBOL]) {\n    globalObj[NAVIGATION_SYMBOL] = createNavigationInstance();\n  }\n  return globalObj[NAVIGATION_SYMBOL];\n}\n\nexport function goto(\n  delta: number,\n): NavigationEntry | null {\n  return getNavigation().goto(delta);\n}\n\nexport function go(\n  page: string,\n  params: Record<string, string> = {},\n  query: Record<string, string> = {},\n  options: NavigationOptions = {},\n): NavigationEntry {\n  return getNavigation().go(page, params, query, options);\n}\n\nexport function goback(): NavigationEntry | null {\n  return goto(-1);\n}\n\n/** Test-only helper to clear the navigation singleton. */\nexport function clearNavigationForTests(): void {\n  const globalObj = globalThis as GlobalWithNavigation;\n  delete globalObj[NAVIGATION_SYMBOL];\n}\n\n// Dev/test-only automation introspection surface (Axe AXE-WP-02).\n// Benign import cycle: automation_introspection uses getNavigation lazily.\n// NOTE: keep these re-exports single-line — the tsup extension-rewrite plugin\n// only rewrites single-line import/export specifiers.\nexport { installAutomationIntrospection, WOOD_AUTOMATION_GLOBAL_KEY } from './automation_introspection.js';\nexport type { WoodAutomationSnapshot, WoodAutomationEvent, WoodAutomationIntrospection, InstallAutomationIntrospectionOptions } from './automation_introspection.js';\nexport { computePreservedLayoutDepth } from './layout_preservation.js';\nexport type { LayoutStack } from './layout_preservation.js';\n"],"mappings":"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","names":[]}

package/dist/{middleware/__fixtures__/middleware/auth.cjs → navigation/layout_preservation.cjs}

@@ -16,29 +16,27 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var auth_exports = {};
-__export(auth_exports, {
-  is_admin: () => is_admin,
-  is_authenticated: () => is_authenticated
+var layout_preservation_exports = {};
+__export(layout_preservation_exports, {
+  computePreservedLayoutDepth: () => computePreservedLayoutDepth
 });
-module.exports = __toCommonJS(auth_exports);
-function is_admin(ctx) {
-  const session = ctx.getSession();
-  if (!session?.admin) {
-    throw new Error("Unauthorized: admin required");
+module.exports = __toCommonJS(layout_preservation_exports);
+function computePreservedLayoutDepth(from, to, options = {}) {
+  const maxDepth = Math.min(from.layoutPaths.length, to.layoutPaths.length);
+  let depth = 0;
+  for (let index = 0; index < maxDepth; index += 1) {
+    if (from.layoutPaths[index] !== to.layoutPaths[index]) break;
+    if (from.layoutControllers?.[index] !== to.layoutControllers?.[index]) break;
+    if (options.preserveLayouts === false) break;
+    if (options.preserveLayouts !== true && (from.layoutPreserve?.[index] !== true || to.layoutPreserve?.[index] !== true)) {
+      break;
+    }
+    depth += 1;
   }
-  ctx.set("admin", session.admin);
-}
-function is_authenticated(ctx) {
-  const session = ctx.getSession();
-  if (!session?.user) {
-    throw new Error("Unauthorized: authentication required");
-  }
-  ctx.set("user", session.user);
+  return depth;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  is_admin,
-  is_authenticated
+  computePreservedLayoutDepth
 });
-//# sourceMappingURL=auth.cjs.map
+//# sourceMappingURL=layout_preservation.cjs.map

package/dist/navigation/layout_preservation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/navigation/layout_preservation.ts"],"sourcesContent":["/**\n * Layout preservation depth — the single production rule for how many\n * leading layouts a navigation transition keeps mounted.\n *\n * One implementation, two callers: the renderer's NavigationShell (real\n * component transitions) and the Node frontend application slice\n * (`createFrontendSurface`). They must agree — a slice test that preserved\n * a layout the renderer rebuilds, or vice versa, would be evidence about a\n * rule that does not exist in production.\n *\n * The rule: walk the layout stacks in parallel and keep a layout only while\n * BOTH sides declare the same layout path, the same layout controller, and\n * both mark it `preserve: true`. `NavigationOptions.preserveLayouts`\n * overrides the declaration in both directions.\n */\nimport type { NavigationOptions } from './index.js';\n\n/** The layout stack of one view, in the shape both callers can supply. */\nexport interface LayoutStack {\n  layoutPaths: readonly string[];\n  layoutControllers?: ReadonlyArray<string | undefined>;\n  layoutPreserve?: readonly boolean[];\n}\n\nexport function computePreservedLayoutDepth(\n  from: LayoutStack,\n  to: LayoutStack,\n  options: NavigationOptions = {},\n): number {\n  const maxDepth = Math.min(from.layoutPaths.length, to.layoutPaths.length);\n  let depth = 0;\n  for (let index = 0; index < maxDepth; index += 1) {\n    if (from.layoutPaths[index] !== to.layoutPaths[index]) break;\n    if (from.layoutControllers?.[index] !== to.layoutControllers?.[index]) break;\n    if (options.preserveLayouts === false) break;\n    if (\n      options.preserveLayouts !== true &&\n      (from.layoutPreserve?.[index] !== true || to.layoutPreserve?.[index] !== true)\n    ) {\n      break;\n    }\n    depth += 1;\n  }\n  return depth;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAwBO,SAAS,4BACd,MACA,IACA,UAA6B,CAAC,GACtB;AACR,QAAM,WAAW,KAAK,IAAI,KAAK,YAAY,QAAQ,GAAG,YAAY,MAAM;AACxE,MAAI,QAAQ;AACZ,WAAS,QAAQ,GAAG,QAAQ,UAAU,SAAS,GAAG;AAChD,QAAI,KAAK,YAAY,KAAK,MAAM,GAAG,YAAY,KAAK,EAAG;AACvD,QAAI,KAAK,oBAAoB,KAAK,MAAM,GAAG,oBAAoB,KAAK,EAAG;AACvE,QAAI,QAAQ,oBAAoB,MAAO;AACvC,QACE,QAAQ,oBAAoB,SAC3B,KAAK,iBAAiB,KAAK,MAAM,QAAQ,GAAG,iBAAiB,KAAK,MAAM,OACzE;AACA;AAAA,IACF;AACA,aAAS;AAAA,EACX;AACA,SAAO;AACT;","names":[]}

package/dist/navigation/layout_preservation.d.cts

@@ -0,0 +1,2 @@
+export { LayoutStack, computePreservedLayoutDepth } from './index.cjs';
+import './automation_introspection.cjs';

package/dist/navigation/layout_preservation.d.ts

@@ -0,0 +1,2 @@
+export { LayoutStack, computePreservedLayoutDepth } from './index.js';
+import './automation_introspection.js';

package/dist/navigation/layout_preservation.js

@@ -0,0 +1,18 @@
+function computePreservedLayoutDepth(from, to, options = {}) {
+  const maxDepth = Math.min(from.layoutPaths.length, to.layoutPaths.length);
+  let depth = 0;
+  for (let index = 0; index < maxDepth; index += 1) {
+    if (from.layoutPaths[index] !== to.layoutPaths[index]) break;
+    if (from.layoutControllers?.[index] !== to.layoutControllers?.[index]) break;
+    if (options.preserveLayouts === false) break;
+    if (options.preserveLayouts !== true && (from.layoutPreserve?.[index] !== true || to.layoutPreserve?.[index] !== true)) {
+      break;
+    }
+    depth += 1;
+  }
+  return depth;
+}
+export {
+  computePreservedLayoutDepth
+};
+//# sourceMappingURL=layout_preservation.js.map

package/dist/navigation/layout_preservation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/navigation/layout_preservation.ts"],"sourcesContent":["/**\n * Layout preservation depth — the single production rule for how many\n * leading layouts a navigation transition keeps mounted.\n *\n * One implementation, two callers: the renderer's NavigationShell (real\n * component transitions) and the Node frontend application slice\n * (`createFrontendSurface`). They must agree — a slice test that preserved\n * a layout the renderer rebuilds, or vice versa, would be evidence about a\n * rule that does not exist in production.\n *\n * The rule: walk the layout stacks in parallel and keep a layout only while\n * BOTH sides declare the same layout path, the same layout controller, and\n * both mark it `preserve: true`. `NavigationOptions.preserveLayouts`\n * overrides the declaration in both directions.\n */\nimport type { NavigationOptions } from './index.js';\n\n/** The layout stack of one view, in the shape both callers can supply. */\nexport interface LayoutStack {\n  layoutPaths: readonly string[];\n  layoutControllers?: ReadonlyArray<string | undefined>;\n  layoutPreserve?: readonly boolean[];\n}\n\nexport function computePreservedLayoutDepth(\n  from: LayoutStack,\n  to: LayoutStack,\n  options: NavigationOptions = {},\n): number {\n  const maxDepth = Math.min(from.layoutPaths.length, to.layoutPaths.length);\n  let depth = 0;\n  for (let index = 0; index < maxDepth; index += 1) {\n    if (from.layoutPaths[index] !== to.layoutPaths[index]) break;\n    if (from.layoutControllers?.[index] !== to.layoutControllers?.[index]) break;\n    if (options.preserveLayouts === false) break;\n    if (\n      options.preserveLayouts !== true &&\n      (from.layoutPreserve?.[index] !== true || to.layoutPreserve?.[index] !== true)\n    ) {\n      break;\n    }\n    depth += 1;\n  }\n  return depth;\n}\n"],"mappings":"AAwBO,SAAS,4BACd,MACA,IACA,UAA6B,CAAC,GACtB;AACR,QAAM,WAAW,KAAK,IAAI,KAAK,YAAY,QAAQ,GAAG,YAAY,MAAM;AACxE,MAAI,QAAQ;AACZ,WAAS,QAAQ,GAAG,QAAQ,UAAU,SAAS,GAAG;AAChD,QAAI,KAAK,YAAY,KAAK,MAAM,GAAG,YAAY,KAAK,EAAG;AACvD,QAAI,KAAK,oBAAoB,KAAK,MAAM,GAAG,oBAAoB,KAAK,EAAG;AACvE,QAAI,QAAQ,oBAAoB,MAAO;AACvC,QACE,QAAQ,oBAAoB,SAC3B,KAAK,iBAAiB,KAAK,MAAM,QAAQ,GAAG,iBAAiB,KAAK,MAAM,OACzE;AACA;AAAA,IACF;AACA,aAAS;AAAA,EACX;AACA,SAAO;AACT;","names":[]}

package/dist/parser/index.cjs

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var parser_exports = {};
 __export(parser_exports, {
   parseOperations: () => import_operations_parser.parseOperations,
+  parseOperationsDocument: () => import_operations_parser.parseOperationsDocument,
   parseOperationsFile: () => import_operations_parser.parseOperationsFile,
   parseViews: () => import_views_parser.parseViews,
   parseViewsFile: () => import_views_parser.parseViewsFile
@@ -29,6 +30,7 @@ var import_views_parser = require("./views_parser.cjs");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   parseOperations,
+  parseOperationsDocument,
   parseOperationsFile,
   parseViews,
   parseViewsFile

package/dist/parser/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/parser/index.ts"],"sourcesContent":["export { parseOperations, parseOperationsFile } from './operations_parser.cjs';\nexport { parseViews, parseViewsFile } from './views_parser.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,+BAAqD;AACrD,0BAA2C;","names":[]}
+{"version":3,"sources":["../../src/parser/index.ts"],"sourcesContent":["export { parseOperations, parseOperationsDocument, parseOperationsFile } from './operations_parser.cjs';\nexport { parseViews, parseViewsFile } from './views_parser.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,+BAA8E;AAC9E,0BAA2C;","names":[]}

package/dist/parser/index.d.cts

@@ -1,4 +1,4 @@
-export { parseOperations, parseOperationsFile } from './operations_parser.cjs';
+export { parseOperations, parseOperationsDocument, parseOperationsFile } from './operations_parser.cjs';
 export { parseViews, parseViewsFile } from './views_parser.cjs';
 import '../types/operations.cjs';
 import '../types/views.cjs';

package/dist/parser/index.d.ts

@@ -1,4 +1,4 @@
-export { parseOperations, parseOperationsFile } from './operations_parser.js';
+export { parseOperations, parseOperationsDocument, parseOperationsFile } from './operations_parser.js';
 export { parseViews, parseViewsFile } from './views_parser.js';
 import '../types/operations.js';
 import '../types/views.js';

package/dist/parser/index.js

@@ -1,7 +1,8 @@
-import { parseOperations, parseOperationsFile } from "./operations_parser.js";
+import { parseOperations, parseOperationsDocument, parseOperationsFile } from "./operations_parser.js";
 import { parseViews, parseViewsFile } from "./views_parser.js";
 export {
   parseOperations,
+  parseOperationsDocument,
   parseOperationsFile,
   parseViews,
   parseViewsFile

package/dist/parser/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/parser/index.ts"],"sourcesContent":["export { parseOperations, parseOperationsFile } from './operations_parser.js';\nexport { parseViews, parseViewsFile } from './views_parser.js';\n"],"mappings":"AAAA,SAAS,iBAAiB,2BAA2B;AACrD,SAAS,YAAY,sBAAsB;","names":[]}
+{"version":3,"sources":["../../src/parser/index.ts"],"sourcesContent":["export { parseOperations, parseOperationsDocument, parseOperationsFile } from './operations_parser.js';\nexport { parseViews, parseViewsFile } from './views_parser.js';\n"],"mappings":"AAAA,SAAS,iBAAiB,yBAAyB,2BAA2B;AAC9E,SAAS,YAAY,sBAAsB;","names":[]}

package/dist/parser/operations_parser.cjs

@@ -29,6 +29,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var operations_parser_exports = {};
 __export(operations_parser_exports, {
   parseOperations: () => parseOperations,
+  parseOperationsDocument: () => parseOperationsDocument,
   parseOperationsFile: () => parseOperationsFile
 });
 module.exports = __toCommonJS(operations_parser_exports);
@@ -36,6 +37,9 @@ var import_js_yaml = __toESM(require("js-yaml"), 1);
 var import_fs = require("fs");
 function parseOperations(yamlContent) {
   const doc = import_js_yaml.default.load(yamlContent);
+  return parseOperationsDocument(doc);
+}
+function parseOperationsDocument(doc) {
   const operations = /* @__PURE__ */ new Map();
   if (doc === null || doc === void 0) {
     throw new Error('Operations document is empty: expected a top-level "operations:" or "module:" mapping.');
@@ -84,6 +88,7 @@ function parseOperations(yamlContent) {
         }
         set(channel, {
           channel,
+          module: moduleName,
           controller: opEntry.controller ?? moduleController ?? "",
           action: opEntry.action,
           middleware,
@@ -110,6 +115,7 @@ function parseOperationsFile(filePath) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   parseOperations,
+  parseOperationsDocument,
   parseOperationsFile
 });
 //# sourceMappingURL=operations_parser.cjs.map