@noego/wood 0.6.1 → 0.7.0

package/dist/native_browser.types-BY2daUOS.d.ts

@@ -0,0 +1,189 @@
+import { ConfigureFetch, TestFetchRuntime } from '@noego/testing/fetch';
+import { Page } from 'playwright';
+import { Window } from 'happy-dom';
+import { ModuleImporter, WoodConfigSource } from './testing/wood_config_source.js';
+import { ViewDef } from './types/views.js';
+import { RouterBridgeEvents } from './testing/create_router_bridge.js';
+import { WoodTestApi, WoodTestRawApi } from './testing-api.js';
+import { IContainer } from '@noego/ioc';
+import { ENV_REGISTRY, TestStub, ClassToken, ReplacementClass, ReplacementOptions, ReplacementFunction, MethodDescriptor, ExecutableReplacement, LoaderIdentity } from '@noego/testing';
+import { WoodRouter } from './router/wood_router.js';
+import { WoodConfig } from './types/config.js';
+import { OperationDef } from './types/operations.js';
+import { FrontendApplicationSurface } from './frontend/frontend_surface.js';
+import { FrontendPage } from './frontend/frontend_page.js';
+import { WoodTestSelection, ResolvedWoodSelection } from './testing/wood_test_selection.js';
+import { WoodRendererHooks } from './testing/wood_env_renderer.js';
+
+/** What the app's `main.testing.compose` default export receives. */
+interface WoodComposeContext {
+    /** Standard per-environment backend push source; hosts subscribe automatically. */
+    readonly events: RouterBridgeEvents;
+    readonly configPath: string;
+    readonly configDir: string;
+    readonly config: WoodConfig;
+    readonly selection: ResolvedWoodSelection;
+    /** The selected operations (the router will serve exactly these). */
+    readonly operations: ReadonlyMap<string, OperationDef>;
+    readonly importer: ModuleImporter;
+    /**
+     * Dispatch through the environment's router. Available from `start()`
+     * onward (the router is built after compose returns); calling it during
+     * compose itself fails.
+     */
+    call<T = unknown>(operation: string, input?: unknown): Promise<T>;
+}
+/** What the compose hook may hand back; every member is optional. */
+interface WoodComposeResult extends WoodRendererHooks {
+    /**
+     * Runs AFTER the test's substitutions are installed on the root (compose
+     * itself runs before them, so production registrations never shadow a
+     * seam). Seed world state and warm caches here — through the seamed graph,
+     * exactly as the test will observe it.
+     */
+    start?(): void | Promise<void>;
+    /**
+     * Quiesce BEFORE the main root disposes its instances: silence push
+     * delivery, drain detached work — everything that still needs the live
+     * graph (database, tracer) the services' own dispose hooks run against.
+     */
+    drain?(): void | Promise<void>;
+    /** Release resources AFTER the roots are disposed (close files, remove dirs). */
+    dispose?(): void | Promise<void>;
+}
+/**
+ * The app's backend composition on the root the builder hands it. Register
+ * lazily: nothing expensive should run until a test resolves it.
+ */
+type WoodComposeMain = (root: IContainer, context: WoodComposeContext) => WoodComposeResult | void | Promise<WoodComposeResult | void>;
+type Params = Record<string, string>;
+interface TestWoodEnvironment {
+    /** The main-process IoC root of this environment. */
+    readonly root: IContainer;
+    readonly router: WoodRouter;
+    /** The selected operations. */
+    readonly operations: ReadonlyMap<string, OperationDef>;
+    /** Typed nested operation API backed by the real selected WoodRouter. */
+    readonly api: WoodTestApi;
+    /** Object-shaped untyped payload surface for deliberate runtime-validation probes. */
+    readonly rawApi: WoodTestRawApi;
+    /** Execute a selected operation through the real pipeline. */
+    call<T = unknown>(operation: string, input?: unknown): Promise<T>;
+    /** Resolve a controller class through a fresh main scope (root seams apply). */
+    controller<T>(controller: new (...args: never[]) => T): Promise<T>;
+    /** Resolve any dependency from the main root; class tokens retain their instance type. */
+    get<T>(token: {
+        readonly prototype: T;
+    }): Promise<T>;
+    get<T = unknown>(token: unknown): Promise<T>;
+    /** Renderer surface — present only when `pages` was selected. */
+    readonly frontend: FrontendApplicationSurface;
+    /** Backend push emitter feeding renderer subscriptions (pages only). */
+    readonly events: RouterBridgeEvents;
+    readonly rendererRoot: IContainer;
+    open(page: string, params?: Params, query?: Params): Promise<FrontendPage>;
+    navigate(page: string, params?: Params, query?: Params): Promise<FrontendPage>;
+    current(): FrontendPage | null;
+    settle(): Promise<void>;
+    /** DOM driver — present only when `dom` was selected. */
+    readonly target: Element;
+    click(selector: string): Promise<void>;
+    type(selector: string, text: string): Promise<void>;
+    submit(selector: string): Promise<void>;
+    text(selector: string): Promise<string>;
+    exists(selector: string): Promise<boolean>;
+    /** Finalize `test.*` expectations; fails on undrained renderer work. */
+    verify(): Promise<void>;
+    dispose(): Promise<void>;
+    readonly [ENV_REGISTRY]: unknown;
+}
+declare class TestWoodBuilder<H extends WoodBrowserHost | null = null> {
+    private readonly state;
+    private constructor();
+    static create(configPath: string): TestWoodBuilder;
+    fetch(configure: ConfigureFetch): TestWoodBuilder<H>;
+    browser(): TestWoodBuilder<'playwright'>;
+    browser(host: 'playwright'): TestWoodBuilder<'playwright'>;
+    browser(host: 'happy_dom'): TestWoodBuilder<'happy_dom'>;
+    /** Declare selected tiers, snapshotting the source selector at call time. */
+    select(selection: WoodTestSelection): TestWoodBuilder<H>;
+    /** Route hook/controller imports through a caller-owned importer (escape hatch). */
+    importer(importer: ModuleImporter): TestWoodBuilder<H>;
+    /** Compose a reusable canonical testStub() replacement description. */
+    use(preset: TestStub): TestWoodBuilder<H>;
+    /** Replace the class bound to an exact declared token; the declared lifetime is kept. */
+    class<T>(target: ClassToken<T>, replacement: ReplacementClass<T>, options?: ReplacementOptions): TestWoodBuilder<H>;
+    /** Replace a declared factory/provider (dependencies and lifetime kept) or a callable value. */
+    function(target: unknown, replacement: ReplacementFunction, options?: ReplacementOptions): TestWoodBuilder<H>;
+    /** A test.* method seam on the FINAL binding of an exact declared token. */
+    method(target: unknown, method: string, replacement: MethodDescriptor, options?: ReplacementOptions): TestWoodBuilder<H>;
+    /** Provide a caller-owned value for an exact declared token (never disposed by the app). */
+    value(target: unknown, replacement: unknown, options?: ReplacementOptions): TestWoodBuilder<H>;
+    /**
+     * Replace the executable satisfying a production middleware identity
+     * (`file.path:selector` as written in the operations source). Membership,
+     * order and inheritance always come from the source.
+     */
+    middleware(identity: string, replacement: ExecutableReplacement, options?: ReplacementOptions): TestWoodBuilder<H>;
+    /**
+     * Replace the DATA LOADER behind a selected page/layout: the companion
+     * `.load` source of a view (`pages/chat.svelte` → `pages/chat.load.ts`).
+     * The identity is the config-relative source path (`ui/pages/chat.load.ts`),
+     * export `default`; the executable receives the loader `RequestData`
+     * (`url` = page identity, `params`, `query`) and yields the data the
+     * controller's `initialize({ params, query, data })` receives. A source
+     * with no companion loader is not a declared identity (build error).
+     * Controllers are replaced with `.class`, never here.
+     */
+    load(identity: LoaderIdentity, replacement: ExecutableReplacement, options?: ReplacementOptions): TestWoodBuilder<H>;
+    /** Build; without `select()`, every owner the config declares is selected whole. */
+    build(): Promise<WoodTestEnvironmentFor<H>>;
+    private derive;
+}
+declare function testWood(configPath: string): TestWoodBuilder;
+
+type WoodBrowserHost = 'playwright' | 'happy_dom';
+type NativeWoodPage<H extends WoodBrowserHost> = H extends 'happy_dom' ? Window : Page;
+/** Route data, not a second browser-driver API. */
+interface WoodBrowserOpenOptions {
+    readonly params?: Readonly<Record<string, string>>;
+    readonly query?: Readonly<Record<string, string>>;
+}
+/** Native hosts expose application composition, NOT Wood's legacy DOM wrappers. */
+type NativeWoodTestEnvironment<H extends WoodBrowserHost> = Pick<TestWoodEnvironment, 'root' | 'router' | 'operations' | 'api' | 'rawApi' | 'get' | 'controller' | 'events' | 'verify' | 'settle' | 'dispose'> & {
+    readonly browserHost: H;
+    /** Each open is a new tab/window. Tabs in one env share its isolated browser context. */
+    open(page: string, options?: WoodBrowserOpenOptions): Promise<NativeWoodPage<H>>;
+};
+type WoodTestEnvironmentFor<H extends WoodBrowserHost | null> = H extends WoodBrowserHost ? NativeWoodTestEnvironment<H> : TestWoodEnvironment;
+interface NativeBrowserInputs {
+    readonly network: TestFetchRuntime;
+    readonly source: WoodConfigSource;
+    readonly views: readonly ViewDef[];
+    readonly environment: TestWoodEnvironment;
+    /** Read after main startup; a compose hook may select its event source in start(). */
+    readonly events: () => RouterBridgeEvents;
+}
+/** Framework-owned resource record. Its native object is returned without a wrapper. */
+interface NativeBrowserTab {
+    readonly native: Page | Window;
+    flush(): Promise<void>;
+    dispose(): Promise<void>;
+}
+interface NativeRendererAsset {
+    readonly fileName: string;
+    readonly source: Uint8Array;
+}
+interface NativeRendererBundle {
+    readonly code: string;
+    readonly css: string;
+    /** Vite-emitted worker/wasm/image/etc. files served from the tab's synthetic origin. */
+    readonly assets: ReadonlyMap<string, NativeRendererAsset>;
+}
+interface NativeRendererRoute {
+    readonly page: string;
+    readonly params: Readonly<Record<string, string>>;
+    readonly query: Readonly<Record<string, string>>;
+}
+
+export { type NativeWoodPage as N, type TestWoodEnvironment as T, type WoodBrowserHost as W, type NativeWoodTestEnvironment as a, type WoodBrowserOpenOptions as b, type WoodTestEnvironmentFor as c, TestWoodBuilder as d, type WoodComposeContext as e, type WoodComposeMain as f, type WoodComposeResult as g, type NativeBrowserInputs as h, type NativeRendererBundle as i, type NativeRendererRoute as j, type NativeBrowserTab as k, type NativeRendererAsset as l, testWood as t };

package/dist/native_browser.types-vWXtE4rM.d.cts

@@ -0,0 +1,189 @@
+import { ConfigureFetch, TestFetchRuntime } from '@noego/testing/fetch';
+import { Page } from 'playwright';
+import { Window } from 'happy-dom';
+import { ModuleImporter, WoodConfigSource } from './testing/wood_config_source.cjs';
+import { ViewDef } from './types/views.cjs';
+import { RouterBridgeEvents } from './testing/create_router_bridge.cjs';
+import { WoodTestApi, WoodTestRawApi } from './testing-api.cjs';
+import { IContainer } from '@noego/ioc';
+import { ENV_REGISTRY, TestStub, ClassToken, ReplacementClass, ReplacementOptions, ReplacementFunction, MethodDescriptor, ExecutableReplacement, LoaderIdentity } from '@noego/testing';
+import { WoodRouter } from './router/wood_router.cjs';
+import { WoodConfig } from './types/config.cjs';
+import { OperationDef } from './types/operations.cjs';
+import { FrontendApplicationSurface } from './frontend/frontend_surface.cjs';
+import { FrontendPage } from './frontend/frontend_page.cjs';
+import { WoodTestSelection, ResolvedWoodSelection } from './testing/wood_test_selection.cjs';
+import { WoodRendererHooks } from './testing/wood_env_renderer.cjs';
+
+/** What the app's `main.testing.compose` default export receives. */
+interface WoodComposeContext {
+    /** Standard per-environment backend push source; hosts subscribe automatically. */
+    readonly events: RouterBridgeEvents;
+    readonly configPath: string;
+    readonly configDir: string;
+    readonly config: WoodConfig;
+    readonly selection: ResolvedWoodSelection;
+    /** The selected operations (the router will serve exactly these). */
+    readonly operations: ReadonlyMap<string, OperationDef>;
+    readonly importer: ModuleImporter;
+    /**
+     * Dispatch through the environment's router. Available from `start()`
+     * onward (the router is built after compose returns); calling it during
+     * compose itself fails.
+     */
+    call<T = unknown>(operation: string, input?: unknown): Promise<T>;
+}
+/** What the compose hook may hand back; every member is optional. */
+interface WoodComposeResult extends WoodRendererHooks {
+    /**
+     * Runs AFTER the test's substitutions are installed on the root (compose
+     * itself runs before them, so production registrations never shadow a
+     * seam). Seed world state and warm caches here — through the seamed graph,
+     * exactly as the test will observe it.
+     */
+    start?(): void | Promise<void>;
+    /**
+     * Quiesce BEFORE the main root disposes its instances: silence push
+     * delivery, drain detached work — everything that still needs the live
+     * graph (database, tracer) the services' own dispose hooks run against.
+     */
+    drain?(): void | Promise<void>;
+    /** Release resources AFTER the roots are disposed (close files, remove dirs). */
+    dispose?(): void | Promise<void>;
+}
+/**
+ * The app's backend composition on the root the builder hands it. Register
+ * lazily: nothing expensive should run until a test resolves it.
+ */
+type WoodComposeMain = (root: IContainer, context: WoodComposeContext) => WoodComposeResult | void | Promise<WoodComposeResult | void>;
+type Params = Record<string, string>;
+interface TestWoodEnvironment {
+    /** The main-process IoC root of this environment. */
+    readonly root: IContainer;
+    readonly router: WoodRouter;
+    /** The selected operations. */
+    readonly operations: ReadonlyMap<string, OperationDef>;
+    /** Typed nested operation API backed by the real selected WoodRouter. */
+    readonly api: WoodTestApi;
+    /** Object-shaped untyped payload surface for deliberate runtime-validation probes. */
+    readonly rawApi: WoodTestRawApi;
+    /** Execute a selected operation through the real pipeline. */
+    call<T = unknown>(operation: string, input?: unknown): Promise<T>;
+    /** Resolve a controller class through a fresh main scope (root seams apply). */
+    controller<T>(controller: new (...args: never[]) => T): Promise<T>;
+    /** Resolve any dependency from the main root; class tokens retain their instance type. */
+    get<T>(token: {
+        readonly prototype: T;
+    }): Promise<T>;
+    get<T = unknown>(token: unknown): Promise<T>;
+    /** Renderer surface — present only when `pages` was selected. */
+    readonly frontend: FrontendApplicationSurface;
+    /** Backend push emitter feeding renderer subscriptions (pages only). */
+    readonly events: RouterBridgeEvents;
+    readonly rendererRoot: IContainer;
+    open(page: string, params?: Params, query?: Params): Promise<FrontendPage>;
+    navigate(page: string, params?: Params, query?: Params): Promise<FrontendPage>;
+    current(): FrontendPage | null;
+    settle(): Promise<void>;
+    /** DOM driver — present only when `dom` was selected. */
+    readonly target: Element;
+    click(selector: string): Promise<void>;
+    type(selector: string, text: string): Promise<void>;
+    submit(selector: string): Promise<void>;
+    text(selector: string): Promise<string>;
+    exists(selector: string): Promise<boolean>;
+    /** Finalize `test.*` expectations; fails on undrained renderer work. */
+    verify(): Promise<void>;
+    dispose(): Promise<void>;
+    readonly [ENV_REGISTRY]: unknown;
+}
+declare class TestWoodBuilder<H extends WoodBrowserHost | null = null> {
+    private readonly state;
+    private constructor();
+    static create(configPath: string): TestWoodBuilder;
+    fetch(configure: ConfigureFetch): TestWoodBuilder<H>;
+    browser(): TestWoodBuilder<'playwright'>;
+    browser(host: 'playwright'): TestWoodBuilder<'playwright'>;
+    browser(host: 'happy_dom'): TestWoodBuilder<'happy_dom'>;
+    /** Declare selected tiers, snapshotting the source selector at call time. */
+    select(selection: WoodTestSelection): TestWoodBuilder<H>;
+    /** Route hook/controller imports through a caller-owned importer (escape hatch). */
+    importer(importer: ModuleImporter): TestWoodBuilder<H>;
+    /** Compose a reusable canonical testStub() replacement description. */
+    use(preset: TestStub): TestWoodBuilder<H>;
+    /** Replace the class bound to an exact declared token; the declared lifetime is kept. */
+    class<T>(target: ClassToken<T>, replacement: ReplacementClass<T>, options?: ReplacementOptions): TestWoodBuilder<H>;
+    /** Replace a declared factory/provider (dependencies and lifetime kept) or a callable value. */
+    function(target: unknown, replacement: ReplacementFunction, options?: ReplacementOptions): TestWoodBuilder<H>;
+    /** A test.* method seam on the FINAL binding of an exact declared token. */
+    method(target: unknown, method: string, replacement: MethodDescriptor, options?: ReplacementOptions): TestWoodBuilder<H>;
+    /** Provide a caller-owned value for an exact declared token (never disposed by the app). */
+    value(target: unknown, replacement: unknown, options?: ReplacementOptions): TestWoodBuilder<H>;
+    /**
+     * Replace the executable satisfying a production middleware identity
+     * (`file.path:selector` as written in the operations source). Membership,
+     * order and inheritance always come from the source.
+     */
+    middleware(identity: string, replacement: ExecutableReplacement, options?: ReplacementOptions): TestWoodBuilder<H>;
+    /**
+     * Replace the DATA LOADER behind a selected page/layout: the companion
+     * `.load` source of a view (`pages/chat.svelte` → `pages/chat.load.ts`).
+     * The identity is the config-relative source path (`ui/pages/chat.load.ts`),
+     * export `default`; the executable receives the loader `RequestData`
+     * (`url` = page identity, `params`, `query`) and yields the data the
+     * controller's `initialize({ params, query, data })` receives. A source
+     * with no companion loader is not a declared identity (build error).
+     * Controllers are replaced with `.class`, never here.
+     */
+    load(identity: LoaderIdentity, replacement: ExecutableReplacement, options?: ReplacementOptions): TestWoodBuilder<H>;
+    /** Build; without `select()`, every owner the config declares is selected whole. */
+    build(): Promise<WoodTestEnvironmentFor<H>>;
+    private derive;
+}
+declare function testWood(configPath: string): TestWoodBuilder;
+
+type WoodBrowserHost = 'playwright' | 'happy_dom';
+type NativeWoodPage<H extends WoodBrowserHost> = H extends 'happy_dom' ? Window : Page;
+/** Route data, not a second browser-driver API. */
+interface WoodBrowserOpenOptions {
+    readonly params?: Readonly<Record<string, string>>;
+    readonly query?: Readonly<Record<string, string>>;
+}
+/** Native hosts expose application composition, NOT Wood's legacy DOM wrappers. */
+type NativeWoodTestEnvironment<H extends WoodBrowserHost> = Pick<TestWoodEnvironment, 'root' | 'router' | 'operations' | 'api' | 'rawApi' | 'get' | 'controller' | 'events' | 'verify' | 'settle' | 'dispose'> & {
+    readonly browserHost: H;
+    /** Each open is a new tab/window. Tabs in one env share its isolated browser context. */
+    open(page: string, options?: WoodBrowserOpenOptions): Promise<NativeWoodPage<H>>;
+};
+type WoodTestEnvironmentFor<H extends WoodBrowserHost | null> = H extends WoodBrowserHost ? NativeWoodTestEnvironment<H> : TestWoodEnvironment;
+interface NativeBrowserInputs {
+    readonly network: TestFetchRuntime;
+    readonly source: WoodConfigSource;
+    readonly views: readonly ViewDef[];
+    readonly environment: TestWoodEnvironment;
+    /** Read after main startup; a compose hook may select its event source in start(). */
+    readonly events: () => RouterBridgeEvents;
+}
+/** Framework-owned resource record. Its native object is returned without a wrapper. */
+interface NativeBrowserTab {
+    readonly native: Page | Window;
+    flush(): Promise<void>;
+    dispose(): Promise<void>;
+}
+interface NativeRendererAsset {
+    readonly fileName: string;
+    readonly source: Uint8Array;
+}
+interface NativeRendererBundle {
+    readonly code: string;
+    readonly css: string;
+    /** Vite-emitted worker/wasm/image/etc. files served from the tab's synthetic origin. */
+    readonly assets: ReadonlyMap<string, NativeRendererAsset>;
+}
+interface NativeRendererRoute {
+    readonly page: string;
+    readonly params: Readonly<Record<string, string>>;
+    readonly query: Readonly<Record<string, string>>;
+}
+
+export { type NativeWoodPage as N, type TestWoodEnvironment as T, type WoodBrowserHost as W, type NativeWoodTestEnvironment as a, type WoodBrowserOpenOptions as b, type WoodTestEnvironmentFor as c, TestWoodBuilder as d, type WoodComposeContext as e, type WoodComposeMain as f, type WoodComposeResult as g, type NativeBrowserInputs as h, type NativeRendererBundle as i, type NativeRendererRoute as j, type NativeBrowserTab as k, type NativeRendererAsset as l, testWood as t };

package/dist/navigation/index.cjs

@@ -18,20 +18,27 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var navigation_exports = {};
 __export(navigation_exports, {
+  NO_LOADERS: () => import_loader_orchestration.NO_LOADERS,
   Navigation: () => Navigation,
   WOOD_AUTOMATION_GLOBAL_KEY: () => import_automation_introspection.WOOD_AUTOMATION_GLOBAL_KEY,
+  assertDataLoader: () => import_loader_orchestration.assertDataLoader,
   clearNavigationForTests: () => clearNavigationForTests,
   computePreservedLayoutDepth: () => import_layout_preservation.computePreservedLayoutDepth,
+  createLoaderRequest: () => import_loader_orchestration.createLoaderRequest,
   getNavigation: () => getNavigation,
   go: () => go,
   goback: () => goback,
   goto: () => goto,
-  installAutomationIntrospection: () => import_automation_introspection.installAutomationIntrospection
+  initializeArgument: () => import_loader_orchestration.initializeArgument,
+  initializeController: () => import_loader_orchestration.initializeController,
+  installAutomationIntrospection: () => import_automation_introspection.installAutomationIntrospection,
+  runViewLoaders: () => import_loader_orchestration.runViewLoaders
 });
 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");
+var import_loader_orchestration = require("../loader/loader_orchestration.cjs");
 const NAVIGATION_SYMBOL = /* @__PURE__ */ Symbol.for("@noego/wood.navigation");
 const HISTORY_STATE_MARKER = "__wood_navigation_state__";
 class Navigation {
@@ -205,14 +212,20 @@ function clearNavigationForTests() {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  NO_LOADERS,
   Navigation,
   WOOD_AUTOMATION_GLOBAL_KEY,
+  assertDataLoader,
   clearNavigationForTests,
   computePreservedLayoutDepth,
+  createLoaderRequest,
   getNavigation,
   go,
   goback,
   goto,
-  installAutomationIntrospection
+  initializeArgument,
+  initializeController,
+  installAutomationIntrospection,
+  runViewLoaders
 });
 //# 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\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// Shared page/layout data-loader orchestration for the generated renderer app.\nexport { createLoaderRequest, initializeArgument, initializeController, runViewLoaders, assertDataLoader, NO_LOADERS } from '../loader/loader_orchestration.cjs';\nexport type { DataLoader, LoadedData, RouteInput, ViewLoaderResult, ViewLoaderSet } from '../loader/loader_orchestration.cjs';\n"],"mappings":"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","names":[]}

package/dist/navigation/index.d.cts

@@ -1,28 +1,8 @@
+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;
+export { DataLoader, LoadedData, NO_LOADERS, RouteInput, ViewLoaderResult, ViewLoaderSet, assertDataLoader, createLoaderRequest, initializeArgument, initializeController, runViewLoaders } from '../loader/loader_orchestration.cjs';
+import '../types/context.cjs';
 
 interface NavigationEntry {
     page: string;
@@ -30,9 +10,7 @@ interface NavigationEntry {
     query: Record<string, string>;
     options: NavigationOptions;
 }
-interface NavigationOptions {
-    preserveLayouts?: boolean;
-}
+
 type NavigationListener = (entry: NavigationEntry | null) => void;
 declare class Navigation {
     private entries;
@@ -61,4 +39,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,28 +1,8 @@
+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;
+export { DataLoader, LoadedData, NO_LOADERS, RouteInput, ViewLoaderResult, ViewLoaderSet, assertDataLoader, createLoaderRequest, initializeArgument, initializeController, runViewLoaders } from '../loader/loader_orchestration.js';
+import '../types/context.js';
 
 interface NavigationEntry {
     page: string;
@@ -30,9 +10,7 @@ interface NavigationEntry {
     query: Record<string, string>;
     options: NavigationOptions;
 }
-interface NavigationOptions {
-    preserveLayouts?: boolean;
-}
+
 type NavigationListener = (entry: NavigationEntry | null) => void;
 declare class Navigation {
     private entries;
@@ -61,4 +39,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

@@ -172,15 +172,22 @@ function clearNavigationForTests() {
 }
 import { installAutomationIntrospection, WOOD_AUTOMATION_GLOBAL_KEY } from "./automation_introspection.js";
 import { computePreservedLayoutDepth } from "./layout_preservation.js";
+import { createLoaderRequest, initializeArgument, initializeController, runViewLoaders, assertDataLoader, NO_LOADERS } from "../loader/loader_orchestration.js";
 export {
+  NO_LOADERS,
   Navigation,
   WOOD_AUTOMATION_GLOBAL_KEY,
+  assertDataLoader,
   clearNavigationForTests,
   computePreservedLayoutDepth,
+  createLoaderRequest,
   getNavigation,
   go,
   goback,
   goto,
-  installAutomationIntrospection
+  initializeArgument,
+  initializeController,
+  installAutomationIntrospection,
+  runViewLoaders
 };
 //# sourceMappingURL=index.js.map