@noego/wood 0.6.0 → 0.6.2

package/dist/main/shutdown_coordinator.js

@@ -0,0 +1,127 @@
+const RENDERER_SHUTDOWN_DRAIN_TIMEOUT_MS = 1e3;
+function shouldDeferLastWindowCloseForCleanup(trackedWindowCount, cleanupComplete) {
+  return trackedWindowCount === 1 && !cleanupComplete;
+}
+class ShutdownCoordinator {
+  constructor(deps) {
+    this.deps = deps;
+    this.currentPhase = "idle";
+    this.shutdown = null;
+  }
+  get phase() {
+    return this.currentPhase;
+  }
+  get isActive() {
+    return this.shutdown !== null;
+  }
+  get isComplete() {
+    return this.currentPhase === "complete";
+  }
+  /** Resolves when the in-flight (or already finished) shutdown sequence settles. */
+  whenSettled() {
+    return this.shutdown ?? Promise.resolve();
+  }
+  /**
+   * `close` handler for a tracked BrowserWindow. Returns true when the close
+   * was intercepted (last window, or a shutdown is already running); false
+   * means the window may close normally.
+   */
+  handleTrackedWindowClose(event, trackedWindowCount) {
+    if (this.isComplete) {
+      return false;
+    }
+    if (this.shutdown) {
+      event.preventDefault();
+      return true;
+    }
+    if (!shouldDeferLastWindowCloseForCleanup(trackedWindowCount, false)) {
+      return false;
+    }
+    event.preventDefault();
+    this.begin("last-window-close");
+    return true;
+  }
+  /** `before-quit` handler. Prevents every quit until the sequence completes. */
+  handleBeforeQuit(event) {
+    if (this.isComplete) {
+      return;
+    }
+    event.preventDefault();
+    if (this.shutdown) {
+      return;
+    }
+    this.begin("quit");
+  }
+  /**
+   * `window-all-closed` / last `closed` handler. While a shutdown is in flight
+   * the coordinator issues the final quit itself, so the cascade caused by
+   * destroying our own windows must not request another one.
+   */
+  handleAllWindowsClosed() {
+    if (this.shutdown) {
+      return;
+    }
+    this.deps.requestQuit();
+  }
+  begin(reason) {
+    this.deps.logger.info("shutdown started", { reason });
+    this.shutdown = this.run();
+  }
+  async run() {
+    this.hideAllWindows();
+    this.currentPhase = "draining";
+    try {
+      await this.deps.drainRenderers();
+    } catch (error) {
+      this.deps.logger.warn("renderer shutdown drain failed", { error: toErrorMessage(error) });
+    }
+    this.destroyAllWindows();
+    this.currentPhase = "windows-destroyed";
+    this.currentPhase = "cleaning-backend";
+    try {
+      await this.deps.cleanupBackend();
+    } catch (error) {
+      this.deps.logger.warn("backend shutdown cleanup failed", { error: toErrorMessage(error) });
+    }
+    this.currentPhase = "complete";
+    this.deps.logger.info("shutdown complete");
+    this.deps.requestQuit();
+  }
+  hideAllWindows() {
+    for (const [id, window] of [...this.deps.trackedWindows()]) {
+      this.hideWindow(id, window);
+    }
+  }
+  hideWindow(id, window) {
+    try {
+      if (!window.isDestroyed()) {
+        window.hide();
+        this.deps.logger.debug("hid window for shutdown", { windowId: id });
+      }
+    } catch (error) {
+      this.deps.logger.warn("hiding window for shutdown failed", { windowId: id, error: toErrorMessage(error) });
+    }
+  }
+  destroyAllWindows() {
+    for (const [id, window] of [...this.deps.trackedWindows()]) {
+      try {
+        if (!window.isDestroyed()) {
+          window.destroy();
+          this.deps.logger.debug("destroyed window on shutdown", { windowId: id });
+        }
+      } catch (error) {
+        this.deps.logger.warn("destroying window on shutdown failed", { windowId: id, error: toErrorMessage(error) });
+      }
+    }
+    this.deps.clearTrackedWindows();
+  }
+}
+function toErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+export {
+  RENDERER_SHUTDOWN_DRAIN_TIMEOUT_MS,
+  ShutdownCoordinator,
+  shouldDeferLastWindowCloseForCleanup
+};
+//# sourceMappingURL=shutdown_coordinator.js.map

package/dist/main/shutdown_coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/main/shutdown_coordinator.ts"],"sourcesContent":["import type { Logger } from '@noego/logger';\n\n/**\n * Bounded time the last renderers get to acknowledge the shutdown drain\n * (trace transport close + app-registered persistence hooks) before their\n * windows are destroyed.\n */\nexport const RENDERER_SHUTDOWN_DRAIN_TIMEOUT_MS = 1_000;\n\nexport type ShutdownWindow = Readonly<{\n  isDestroyed(): boolean;\n  hide(): void;\n  destroy(): void;\n}>;\n\nexport type ShutdownPreventableEvent = Readonly<{\n  preventDefault(): void;\n}>;\n\nexport type ShutdownReason = 'last-window-close' | 'quit';\n\nexport type ShutdownPhase =\n  | 'idle'\n  | 'draining'\n  | 'windows-destroyed'\n  | 'cleaning-backend'\n  | 'complete';\n\nexport type ShutdownCoordinatorDependencies = Readonly<{\n  /** Live view of the tracked windows; iterated as a snapshot on each use. */\n  trackedWindows(): Iterable<readonly [string, ShutdownWindow]>;\n  /** Forget every tracked window after destruction. */\n  clearTrackedWindows(): void;\n  /** Bounded renderer drain (traces + persistence acknowledgements). */\n  drainRenderers(): Promise<void>;\n  /** Backend runtime/service teardown; runs only after windows are gone. */\n  cleanupBackend(): Promise<void>;\n  /** Ask Electron to quit; the coordinator calls this exactly once, at the end. */\n  requestQuit(): void;\n  logger: Pick<Logger, 'debug' | 'info' | 'warn'>;\n}>;\n\nexport function shouldDeferLastWindowCloseForCleanup(\n  trackedWindowCount: number,\n  cleanupComplete: boolean,\n): boolean {\n  return trackedWindowCount === 1 && !cleanupComplete;\n}\n\n/**\n * Owns the Desktop shutdown sequence so windows disappear first and the\n * backend is torn down last:\n *\n *   accepted last-window Close or Quit\n *     -> hide every tracked window immediately\n *     -> bounded renderer drain (trace close + persistence acknowledgements)\n *     -> destroy every tracked window\n *     -> backend runtime/service cleanup\n *     -> app.quit()\n *\n * The sequence runs exactly once. Every Electron quit attempt that arrives\n * while it is in flight (repeated Cmd+Q, the `closed` -> `window-all-closed`\n * cascade caused by our own window destruction, a second Close) is prevented\n * so the process cannot exit before cleanup finishes. Once complete, the final\n * `requestQuit()` is allowed through untouched.\n */\nexport class ShutdownCoordinator {\n  private currentPhase: ShutdownPhase = 'idle';\n  private shutdown: Promise<void> | null = null;\n\n  constructor(private readonly deps: ShutdownCoordinatorDependencies) {}\n\n  get phase(): ShutdownPhase {\n    return this.currentPhase;\n  }\n\n  get isActive(): boolean {\n    return this.shutdown !== null;\n  }\n\n  get isComplete(): boolean {\n    return this.currentPhase === 'complete';\n  }\n\n  /** Resolves when the in-flight (or already finished) shutdown sequence settles. */\n  whenSettled(): Promise<void> {\n    return this.shutdown ?? Promise.resolve();\n  }\n\n  /**\n   * `close` handler for a tracked BrowserWindow. Returns true when the close\n   * was intercepted (last window, or a shutdown is already running); false\n   * means the window may close normally.\n   */\n  handleTrackedWindowClose(\n    event: ShutdownPreventableEvent,\n    trackedWindowCount: number,\n  ): boolean {\n    if (this.isComplete) {\n      return false;\n    }\n    if (this.shutdown) {\n      // Shutdown owns window destruction; do not let a competing close race it.\n      event.preventDefault();\n      return true;\n    }\n    if (!shouldDeferLastWindowCloseForCleanup(trackedWindowCount, false)) {\n      return false;\n    }\n    event.preventDefault();\n    // begin() hides every tracked window synchronously, including this one.\n    this.begin('last-window-close');\n    return true;\n  }\n\n  /** `before-quit` handler. Prevents every quit until the sequence completes. */\n  handleBeforeQuit(event: ShutdownPreventableEvent): void {\n    if (this.isComplete) {\n      return;\n    }\n    event.preventDefault();\n    if (this.shutdown) {\n      return;\n    }\n    this.begin('quit');\n  }\n\n  /**\n   * `window-all-closed` / last `closed` handler. While a shutdown is in flight\n   * the coordinator issues the final quit itself, so the cascade caused by\n   * destroying our own windows must not request another one.\n   */\n  handleAllWindowsClosed(): void {\n    if (this.shutdown) {\n      return;\n    }\n    this.deps.requestQuit();\n  }\n\n  private begin(reason: ShutdownReason): void {\n    this.deps.logger.info('shutdown started', { reason });\n    this.shutdown = this.run();\n  }\n\n  private async run(): Promise<void> {\n    this.hideAllWindows();\n\n    this.currentPhase = 'draining';\n    try {\n      await this.deps.drainRenderers();\n    } catch (error) {\n      this.deps.logger.warn('renderer shutdown drain failed', { error: toErrorMessage(error) });\n    }\n\n    this.destroyAllWindows();\n    this.currentPhase = 'windows-destroyed';\n\n    this.currentPhase = 'cleaning-backend';\n    try {\n      await this.deps.cleanupBackend();\n    } catch (error) {\n      this.deps.logger.warn('backend shutdown cleanup failed', { error: toErrorMessage(error) });\n    }\n\n    this.currentPhase = 'complete';\n    this.deps.logger.info('shutdown complete');\n    this.deps.requestQuit();\n  }\n\n  private hideAllWindows(): void {\n    for (const [id, window] of [...this.deps.trackedWindows()]) {\n      this.hideWindow(id, window);\n    }\n  }\n\n  private hideWindow(id: string, window: ShutdownWindow): void {\n    try {\n      if (!window.isDestroyed()) {\n        window.hide();\n        this.deps.logger.debug('hid window for shutdown', { windowId: id });\n      }\n    } catch (error) {\n      this.deps.logger.warn('hiding window for shutdown failed', { windowId: id, error: toErrorMessage(error) });\n    }\n  }\n\n  private destroyAllWindows(): void {\n    for (const [id, window] of [...this.deps.trackedWindows()]) {\n      try {\n        if (!window.isDestroyed()) {\n          window.destroy();\n          this.deps.logger.debug('destroyed window on shutdown', { windowId: id });\n        }\n      } catch (error) {\n        this.deps.logger.warn('destroying window on shutdown failed', { windowId: id, error: toErrorMessage(error) });\n      }\n    }\n    this.deps.clearTrackedWindows();\n  }\n}\n\nfunction toErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"],"mappings":"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","names":[]}

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\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":[]}
+{"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\nimport type { NavigationOptions } from './layout_preservation.js';\nexport type { NavigationOptions } from './layout_preservation.js';\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":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAkC;AA2PlC,sCAA2E;AAE3E,iCAA4C;AA3P5C,MAAM,oBAAoB,uBAAO,IAAI,wBAAwB;AAC7D,MAAM,uBAAuB;AAkBtB,MAAM,WAAW;AAAA,EAAjB;AACL,SAAQ,UAA6B,CAAC;AACtC,SAAQ,QAAQ;AAChB,SAAQ,YAAY,oBAAI,IAAwB;AAAA;AAAA,EAEhD,aAAqC;AACnC,QAAI,KAAK,QAAQ,KAAK,KAAK,SAAS,KAAK,QAAQ,QAAQ;AACvD,aAAO;AAAA,IACT;AACA,WAAO,KAAK,WAAW,KAAK,QAAQ,KAAK,KAAK,CAAC;AAAA,EACjD;AAAA,EAEA,WAA8B;AAC5B,WAAO,KAAK,QAAQ,IAAI,CAAC,UAAU,KAAK,WAAW,KAAK,CAAC;AAAA,EAC3D;AAAA,EAEA,YAAoC;AAClC,UAAM,UAAU,KAAK,WAAW;AAChC,QAAI,CAAC,SAAS;AACZ,aAAO,CAAC;AAAA,IACV;AACA,WAAO,EAAE,GAAG,QAAQ,OAAO;AAAA,EAC7B;AAAA,EAEA,QACE,MACA,SAAiC,CAAC,GAClC,QAAgC,CAAC,GACjC,UAA6B,CAAC,GACb;AACjB,UAAM,QAAQ,KAAK,YAAY,MAAM,QAAQ,OAAO,OAAO;AAE3D,QAAI,KAAK,QAAQ,GAAG;AAClB,WAAK,QAAQ,KAAK,KAAK;AACvB,WAAK,QAAQ;AAAA,IACf,OAAO;AACL,WAAK,QAAQ,KAAK,KAAK,IAAI;AAAA,IAC7B;AAEA,SAAK,mBAAmB,gBAAgB,KAAK;AAC7C,SAAK,OAAO;AACZ,0CAAkB,QAAQ;AAAA,MACxB,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,SAAS;AAAA,QACP,MAAM,MAAM;AAAA,QACZ,QAAQ,MAAM;AAAA,QACd,OAAO,MAAM;AAAA,QACb,SAAS,MAAM;AAAA,MACjB;AAAA,IACF,CAAC;AACD,WAAO,KAAK,WAAW,KAAK;AAAA,EAC9B;AAAA,EAEA,GACE,MACA,SAAiC,CAAC,GAClC,QAAgC,CAAC,GACjC,UAA6B,CAAC,GACb;AACjB,UAAM,QAAQ,KAAK,YAAY,MAAM,QAAQ,OAAO,OAAO;AAC3D,QAAI,KAAK,QAAQ,KAAK,QAAQ,SAAS,GAAG;AACxC,WAAK,UAAU,KAAK,QAAQ,MAAM,GAAG,KAAK,QAAQ,CAAC;AAAA,IACrD;AACA,SAAK,QAAQ,KAAK,KAAK;AACvB,SAAK,QAAQ,KAAK,QAAQ,SAAS;AAEnC,SAAK,mBAAmB,aAAa,KAAK;AAC1C,SAAK,OAAO;AACZ,0CAAkB,QAAQ;AAAA,MACxB,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,SAAS;AAAA,QACP,MAAM,MAAM;AAAA,QACZ,QAAQ,MAAM;AAAA,QACd,OAAO,MAAM;AAAA,QACb,SAAS,MAAM;AAAA,MACjB;AAAA,IACF,CAAC;AACD,WAAO,KAAK,WAAW,KAAK;AAAA,EAC9B;AAAA,EAEA,KAAK,OAAuC;AAC1C,WAAO,KAAK,WAAW,KAAK;AAAA,EAC9B;AAAA,EAEA,SAAiC;AAC/B,WAAO,KAAK,KAAK,EAAE;AAAA,EACrB;AAAA,EAEA,YAAoC;AAClC,WAAO,KAAK,KAAK,CAAC;AAAA,EACpB;AAAA,EAEA,UAAU,UAA0C;AAClD,SAAK,UAAU,IAAI,QAAQ;AAC3B,aAAS,KAAK,WAAW,CAAC;AAC1B,WAAO,MAAM;AACX,WAAK,UAAU,OAAO,QAAQ;AAAA,IAChC;AAAA,EACF;AAAA,EAEQ,WAAW,OAAuC;AACxD,QAAI,UAAU,GAAG;AACf,aAAO,KAAK,WAAW;AAAA,IACzB;AAEA,UAAM,YAAY,KAAK,QAAQ;AAC/B,QAAI,YAAY,KAAK,aAAa,KAAK,QAAQ,QAAQ;AACrD,aAAO,KAAK,WAAW;AAAA,IACzB;AAEA,SAAK,QAAQ;AACb,UAAM,QAAQ,KAAK,QAAQ,KAAK,KAAK;AACrC,SAAK,mBAAmB,gBAAgB,KAAK;AAC7C,SAAK,OAAO;AACZ,0CAAkB,QAAQ;AAAA,MACxB,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,SAAS;AAAA,QACP;AAAA,QACA,MAAM,MAAM;AAAA,MACd;AAAA,IACF,CAAC;AACD,WAAO,KAAK,WAAW,KAAK;AAAA,EAC9B;AAAA,EAEQ,SAAe;AACrB,UAAM,UAAU,KAAK,WAAW;AAChC,eAAW,YAAY,KAAK,WAAW;AACrC,eAAS,OAAO;AAAA,IAClB;AAAA,EACF;AAAA,EAEQ,YACN,MACA,QACA,OACA,SACiB;AACjB,WAAO;AAAA,MACL;AAAA,MACA,QAAQ,KAAK,gBAAgB,MAAM;AAAA,MACnC,OAAO,KAAK,gBAAgB,KAAK;AAAA,MACjC,SAAS,EAAE,GAAG,QAAQ;AAAA,IACxB;AAAA,EACF;AAAA,EAEQ,WAAW,OAAyC;AAC1D,WAAO;AAAA,MACL,MAAM,MAAM;AAAA,MACZ,QAAQ,EAAE,GAAG,MAAM,OAAO;AAAA,MAC1B,OAAO,EAAE,GAAG,MAAM,MAAM;AAAA,MACxB,SAAS,EAAE,GAAG,MAAM,QAAQ;AAAA,IAC9B;AAAA,EACF;AAAA,EAEQ,gBAAgB,OAAuD;AAC7E,UAAM,SAAiC,CAAC;AACxC,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,SAAS,CAAC,CAAC,GAAG;AACtD,aAAO,OAAO,GAAG,CAAC,IAAI,OAAO,KAAK;AAAA,IACpC;AACA,WAAO;AAAA,EACT;AAAA,EAEQ,mBACN,MACA,OACM;AACN,QAAI,OAAO,WAAW,aAAa;AACjC;AAAA,IACF;AAEA,UAAM,QAAgC;AAAA,MACpC,CAAC,oBAAoB,GAAG;AAAA,MACxB,MAAM,MAAM;AAAA,MACZ,QAAQ,EAAE,GAAG,MAAM,OAAO;AAAA,MAC1B,OAAO,EAAE,GAAG,MAAM,MAAM;AAAA,MACxB,SAAS,EAAE,GAAG,MAAM,QAAQ;AAAA,IAC9B;AAEA,WAAO,QAAQ,IAAI,EAAE,OAAO,EAAE;AAAA,EAChC;AACF;AAMA,SAAS,2BAAuC;AAC9C,SAAO,IAAI,WAAW;AACxB;AAEO,SAAS,gBAA4B;AAC1C,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,iBAAiB,GAAG;AACjC,cAAU,iBAAiB,IAAI,yBAAyB;AAAA,EAC1D;AACA,SAAO,UAAU,iBAAiB;AACpC;AAEO,SAAS,KACd,OACwB;AACxB,SAAO,cAAc,EAAE,KAAK,KAAK;AACnC;AAEO,SAAS,GACd,MACA,SAAiC,CAAC,GAClC,QAAgC,CAAC,GACjC,UAA6B,CAAC,GACb;AACjB,SAAO,cAAc,EAAE,GAAG,MAAM,QAAQ,OAAO,OAAO;AACxD;AAEO,SAAS,SAAiC;AAC/C,SAAO,KAAK,EAAE;AAChB;AAGO,SAAS,0BAAgC;AAC9C,QAAM,YAAY;AAClB,SAAO,UAAU,iBAAiB;AACpC;","names":[]}

package/dist/navigation/index.d.cts

@@ -1,38 +1,14 @@
+import { NavigationOptions } from './layout_preservation.cjs';
+export { LayoutStack, computePreservedLayoutDepth } from './layout_preservation.cjs';
 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>;
     query: Record<string, string>;
     options: NavigationOptions;
 }
-interface NavigationOptions {
-    preserveLayouts?: boolean;
-}
+
 type NavigationListener = (entry: NavigationEntry | null) => void;
 declare class Navigation {
     private entries;
@@ -61,4 +37,4 @@ declare function goback(): NavigationEntry | null;
 /** Test-only helper to clear the navigation singleton. */
 declare function clearNavigationForTests(): void;
 
-export { type LayoutStack, Navigation, type NavigationEntry, type NavigationOptions, clearNavigationForTests, computePreservedLayoutDepth, getNavigation, go, goback, goto };
+export { Navigation, type NavigationEntry, NavigationOptions, clearNavigationForTests, getNavigation, go, goback, goto };

package/dist/navigation/index.d.ts

@@ -1,38 +1,14 @@
+import { NavigationOptions } from './layout_preservation.js';
+export { LayoutStack, computePreservedLayoutDepth } from './layout_preservation.js';
 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>;
     query: Record<string, string>;
     options: NavigationOptions;
 }
-interface NavigationOptions {
-    preserveLayouts?: boolean;
-}
+
 type NavigationListener = (entry: NavigationEntry | null) => void;
 declare class Navigation {
     private entries;
@@ -61,4 +37,4 @@ declare function goback(): NavigationEntry | null;
 /** Test-only helper to clear the navigation singleton. */
 declare function clearNavigationForTests(): void;
 
-export { type LayoutStack, Navigation, type NavigationEntry, type NavigationOptions, clearNavigationForTests, computePreservedLayoutDepth, getNavigation, go, goback, goto };
+export { Navigation, type NavigationEntry, NavigationOptions, clearNavigationForTests, getNavigation, go, goback, goto };

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\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":[]}
+{"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\nimport type { NavigationOptions } from './layout_preservation.js';\nexport type { NavigationOptions } from './layout_preservation.js';\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":"AAAA,SAAS,yBAAyB;AAElC,MAAM,oBAAoB,uBAAO,IAAI,wBAAwB;AAC7D,MAAM,uBAAuB;AAkBtB,MAAM,WAAW;AAAA,EAAjB;AACL,SAAQ,UAA6B,CAAC;AACtC,SAAQ,QAAQ;AAChB,SAAQ,YAAY,oBAAI,IAAwB;AAAA;AAAA,EAEhD,aAAqC;AACnC,QAAI,KAAK,QAAQ,KAAK,KAAK,SAAS,KAAK,QAAQ,QAAQ;AACvD,aAAO;AAAA,IACT;AACA,WAAO,KAAK,WAAW,KAAK,QAAQ,KAAK,KAAK,CAAC;AAAA,EACjD;AAAA,EAEA,WAA8B;AAC5B,WAAO,KAAK,QAAQ,IAAI,CAAC,UAAU,KAAK,WAAW,KAAK,CAAC;AAAA,EAC3D;AAAA,EAEA,YAAoC;AAClC,UAAM,UAAU,KAAK,WAAW;AAChC,QAAI,CAAC,SAAS;AACZ,aAAO,CAAC;AAAA,IACV;AACA,WAAO,EAAE,GAAG,QAAQ,OAAO;AAAA,EAC7B;AAAA,EAEA,QACE,MACA,SAAiC,CAAC,GAClC,QAAgC,CAAC,GACjC,UAA6B,CAAC,GACb;AACjB,UAAM,QAAQ,KAAK,YAAY,MAAM,QAAQ,OAAO,OAAO;AAE3D,QAAI,KAAK,QAAQ,GAAG;AAClB,WAAK,QAAQ,KAAK,KAAK;AACvB,WAAK,QAAQ;AAAA,IACf,OAAO;AACL,WAAK,QAAQ,KAAK,KAAK,IAAI;AAAA,IAC7B;AAEA,SAAK,mBAAmB,gBAAgB,KAAK;AAC7C,SAAK,OAAO;AACZ,sBAAkB,QAAQ;AAAA,MACxB,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,SAAS;AAAA,QACP,MAAM,MAAM;AAAA,QACZ,QAAQ,MAAM;AAAA,QACd,OAAO,MAAM;AAAA,QACb,SAAS,MAAM;AAAA,MACjB;AAAA,IACF,CAAC;AACD,WAAO,KAAK,WAAW,KAAK;AAAA,EAC9B;AAAA,EAEA,GACE,MACA,SAAiC,CAAC,GAClC,QAAgC,CAAC,GACjC,UAA6B,CAAC,GACb;AACjB,UAAM,QAAQ,KAAK,YAAY,MAAM,QAAQ,OAAO,OAAO;AAC3D,QAAI,KAAK,QAAQ,KAAK,QAAQ,SAAS,GAAG;AACxC,WAAK,UAAU,KAAK,QAAQ,MAAM,GAAG,KAAK,QAAQ,CAAC;AAAA,IACrD;AACA,SAAK,QAAQ,KAAK,KAAK;AACvB,SAAK,QAAQ,KAAK,QAAQ,SAAS;AAEnC,SAAK,mBAAmB,aAAa,KAAK;AAC1C,SAAK,OAAO;AACZ,sBAAkB,QAAQ;AAAA,MACxB,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,SAAS;AAAA,QACP,MAAM,MAAM;AAAA,QACZ,QAAQ,MAAM;AAAA,QACd,OAAO,MAAM;AAAA,QACb,SAAS,MAAM;AAAA,MACjB;AAAA,IACF,CAAC;AACD,WAAO,KAAK,WAAW,KAAK;AAAA,EAC9B;AAAA,EAEA,KAAK,OAAuC;AAC1C,WAAO,KAAK,WAAW,KAAK;AAAA,EAC9B;AAAA,EAEA,SAAiC;AAC/B,WAAO,KAAK,KAAK,EAAE;AAAA,EACrB;AAAA,EAEA,YAAoC;AAClC,WAAO,KAAK,KAAK,CAAC;AAAA,EACpB;AAAA,EAEA,UAAU,UAA0C;AAClD,SAAK,UAAU,IAAI,QAAQ;AAC3B,aAAS,KAAK,WAAW,CAAC;AAC1B,WAAO,MAAM;AACX,WAAK,UAAU,OAAO,QAAQ;AAAA,IAChC;AAAA,EACF;AAAA,EAEQ,WAAW,OAAuC;AACxD,QAAI,UAAU,GAAG;AACf,aAAO,KAAK,WAAW;AAAA,IACzB;AAEA,UAAM,YAAY,KAAK,QAAQ;AAC/B,QAAI,YAAY,KAAK,aAAa,KAAK,QAAQ,QAAQ;AACrD,aAAO,KAAK,WAAW;AAAA,IACzB;AAEA,SAAK,QAAQ;AACb,UAAM,QAAQ,KAAK,QAAQ,KAAK,KAAK;AACrC,SAAK,mBAAmB,gBAAgB,KAAK;AAC7C,SAAK,OAAO;AACZ,sBAAkB,QAAQ;AAAA,MACxB,QAAQ;AAAA,MACR,MAAM;AAAA,MACN,SAAS;AAAA,QACP;AAAA,QACA,MAAM,MAAM;AAAA,MACd;AAAA,IACF,CAAC;AACD,WAAO,KAAK,WAAW,KAAK;AAAA,EAC9B;AAAA,EAEQ,SAAe;AACrB,UAAM,UAAU,KAAK,WAAW;AAChC,eAAW,YAAY,KAAK,WAAW;AACrC,eAAS,OAAO;AAAA,IAClB;AAAA,EACF;AAAA,EAEQ,YACN,MACA,QACA,OACA,SACiB;AACjB,WAAO;AAAA,MACL;AAAA,MACA,QAAQ,KAAK,gBAAgB,MAAM;AAAA,MACnC,OAAO,KAAK,gBAAgB,KAAK;AAAA,MACjC,SAAS,EAAE,GAAG,QAAQ;AAAA,IACxB;AAAA,EACF;AAAA,EAEQ,WAAW,OAAyC;AAC1D,WAAO;AAAA,MACL,MAAM,MAAM;AAAA,MACZ,QAAQ,EAAE,GAAG,MAAM,OAAO;AAAA,MAC1B,OAAO,EAAE,GAAG,MAAM,MAAM;AAAA,MACxB,SAAS,EAAE,GAAG,MAAM,QAAQ;AAAA,IAC9B;AAAA,EACF;AAAA,EAEQ,gBAAgB,OAAuD;AAC7E,UAAM,SAAiC,CAAC;AACxC,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,SAAS,CAAC,CAAC,GAAG;AACtD,aAAO,OAAO,GAAG,CAAC,IAAI,OAAO,KAAK;AAAA,IACpC;AACA,WAAO;AAAA,EACT;AAAA,EAEQ,mBACN,MACA,OACM;AACN,QAAI,OAAO,WAAW,aAAa;AACjC;AAAA,IACF;AAEA,UAAM,QAAgC;AAAA,MACpC,CAAC,oBAAoB,GAAG;AAAA,MACxB,MAAM,MAAM;AAAA,MACZ,QAAQ,EAAE,GAAG,MAAM,OAAO;AAAA,MAC1B,OAAO,EAAE,GAAG,MAAM,MAAM;AAAA,MACxB,SAAS,EAAE,GAAG,MAAM,QAAQ;AAAA,IAC9B;AAEA,WAAO,QAAQ,IAAI,EAAE,OAAO,EAAE;AAAA,EAChC;AACF;AAMA,SAAS,2BAAuC;AAC9C,SAAO,IAAI,WAAW;AACxB;AAEO,SAAS,gBAA4B;AAC1C,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,iBAAiB,GAAG;AACjC,cAAU,iBAAiB,IAAI,yBAAyB;AAAA,EAC1D;AACA,SAAO,UAAU,iBAAiB;AACpC;AAEO,SAAS,KACd,OACwB;AACxB,SAAO,cAAc,EAAE,KAAK,KAAK;AACnC;AAEO,SAAS,GACd,MACA,SAAiC,CAAC,GAClC,QAAgC,CAAC,GACjC,UAA6B,CAAC,GACb;AACjB,SAAO,cAAc,EAAE,GAAG,MAAM,QAAQ,OAAO,OAAO;AACxD;AAEO,SAAS,SAAiC;AAC/C,SAAO,KAAK,EAAE;AAChB;AAGO,SAAS,0BAAgC;AAC9C,QAAM,YAAY;AAClB,SAAO,UAAU,iBAAiB;AACpC;AAMA,SAAS,gCAAgC,kCAAkC;AAE3E,SAAS,mCAAmC;","names":[]}

package/dist/navigation/layout_preservation.cjs.map

@@ -1 +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":[]}
+{"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 */\nexport interface NavigationOptions {\n  preserveLayouts?: boolean;\n}\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;AA0BO,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

@@ -1,2 +1,27 @@
-export { LayoutStack, computePreservedLayoutDepth } from './index.cjs';
-import './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.
+ */
+interface NavigationOptions {
+    preserveLayouts?: boolean;
+}
+/** 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;
+
+export { type LayoutStack, type NavigationOptions, computePreservedLayoutDepth };

package/dist/navigation/layout_preservation.d.ts

@@ -1,2 +1,27 @@
-export { LayoutStack, computePreservedLayoutDepth } from './index.js';
-import './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.
+ */
+interface NavigationOptions {
+    preserveLayouts?: boolean;
+}
+/** 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;
+
+export { type LayoutStack, type NavigationOptions, computePreservedLayoutDepth };

package/dist/navigation/layout_preservation.js.map

@@ -1 +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":[]}
+{"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 */\nexport interface NavigationOptions {\n  preserveLayouts?: boolean;\n}\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":"AA0BO,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/testing/create_controller_harness.d.cts

@@ -2,6 +2,7 @@ import { Navigation } from '../navigation/index.cjs';
 import { TraceRecorder } from '../trace-testing/trace_recorder.cjs';
 import { RouterBridgeResult } from './create_router_bridge.cjs';
 import { createTestRouter } from './create_test_router.cjs';
+import '../navigation/layout_preservation.cjs';
 import '../navigation/automation_introspection.cjs';
 import '@noego/trace/testing';
 import '../trace_hub-Cpo_nVze.cjs';

package/dist/testing/create_controller_harness.d.ts

@@ -2,6 +2,7 @@ import { Navigation } from '../navigation/index.js';
 import { TraceRecorder } from '../trace-testing/trace_recorder.js';
 import { RouterBridgeResult } from './create_router_bridge.js';
 import { createTestRouter } from './create_test_router.js';
+import '../navigation/layout_preservation.js';
 import '../navigation/automation_introspection.js';
 import '@noego/trace/testing';
 import '../trace_hub-Cpo_nVze.js';

package/dist/testing/index.d.cts

@@ -37,6 +37,7 @@ import '../types/config.cjs';
 import '../types/views.cjs';
 import './wood_dom_animation.cjs';
 import '../navigation/index.cjs';
+import '../navigation/layout_preservation.cjs';
 import '../navigation/automation_introspection.cjs';
 import 'playwright';
 import '@noego/trace/testing';

package/dist/testing/index.d.ts

@@ -37,6 +37,7 @@ import '../types/config.js';
 import '../types/views.js';
 import './wood_dom_animation.js';
 import '../navigation/index.js';
+import '../navigation/layout_preservation.js';
 import '../navigation/automation_introspection.js';
 import 'playwright';
 import '@noego/trace/testing';

package/dist/testing/test_wood_config.d.cts

@@ -14,6 +14,7 @@ import '../validation/schema_validator.cjs';
 import '../middleware/middleware_resolver.cjs';
 import '../controller/controller_resolver.cjs';
 import '../navigation/index.cjs';
+import '../navigation/layout_preservation.cjs';
 import '../navigation/automation_introspection.cjs';
 import '../types/views.cjs';
 import '../frontend/page_catalog.cjs';

package/dist/testing/test_wood_config.d.ts

@@ -14,6 +14,7 @@ import '../validation/schema_validator.js';
 import '../middleware/middleware_resolver.js';
 import '../controller/controller_resolver.js';
 import '../navigation/index.js';
+import '../navigation/layout_preservation.js';
 import '../navigation/automation_introspection.js';
 import '../types/views.js';
 import '../frontend/page_catalog.js';

package/dist/testing/wood_env_renderer.d.cts

@@ -17,6 +17,7 @@ import '../validation/schema_validator.cjs';
 import '../middleware/middleware_resolver.cjs';
 import '../controller/controller_resolver.cjs';
 import '../navigation/index.cjs';
+import '../navigation/layout_preservation.cjs';
 import '../navigation/automation_introspection.cjs';
 import '../frontend/frontend_lifecycle.cjs';
 import '../types/config.cjs';

package/dist/testing/wood_env_renderer.d.ts

@@ -17,6 +17,7 @@ import '../validation/schema_validator.js';
 import '../middleware/middleware_resolver.js';
 import '../controller/controller_resolver.js';
 import '../navigation/index.js';
+import '../navigation/layout_preservation.js';
 import '../navigation/automation_introspection.js';
 import '../frontend/frontend_lifecycle.js';
 import '../types/config.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noego/wood",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/navigation/layout_preservation.ts

@@ -13,7 +13,9 @@
  * both mark it `preserve: true`. `NavigationOptions.preserveLayouts`
  * overrides the declaration in both directions.
  */
-import type { NavigationOptions } from './index.js';
+export interface NavigationOptions {
+  preserveLayouts?: boolean;
+}
 
 /** The layout stack of one view, in the shape both callers can supply. */
 export interface LayoutStack {