@noego/wood 0.6.2 → 0.7.1

package/dist/frontend/frontend_surface.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/frontend/frontend_surface.ts"],"sourcesContent":["/**\n * The Node frontend application surface (spec 18 §12–13, 18A D-FAS-01/02).\n *\n *   frontend.open({ page, params, query })  — explicit initial page\n *   frontend.current()                      — production navigation result\n *   frontend.act(fn) / frontend.settle()    — owned-work fixed-point drains\n *   frontend.errors                         — observed owned-work failures\n *\n * Runtime honesty (D-FAS-02): this is the plain-Node tier. It proves\n * explicit PageController behavior, $state/$derived reachable through it,\n * backend calls, events, and navigation identity/lifecycle. It does not\n * create a Svelte component/root context and therefore proves no $effect,\n * mount/unmount, or DOM behavior — those belong to the happy-dom tier.\n *\n * Isolation: every environment owns its own Navigation instance, renderer\n * root, transport, and work registry. Nothing here writes globalThis and\n * nothing calls the production client getters — two environments run\n * concurrently without cross-talk. A controller that calls the module-level\n * `go()`/`getNavigation()` free functions bypasses its environment; this\n * tier requires constructor-injected `Navigation`.\n */\nimport { ExecutionContext, LoadAs } from '@noego/ioc';\nimport { Navigation, type NavigationEntry } from '../navigation/index.js';\nimport { computePreservedLayoutDepth } from '../navigation/layout_preservation.js';\nimport { cleanupAll } from '../controller/cleanup.js';\nimport { disposeControllerLifecycle, guardControllerLifecycleOnce } from '../controller/controller_lifecycle.js';\nimport type { ViewDef } from '../types/index.js';\nimport { PageCatalog, PageCatalogError, pageIdentity } from './page_catalog.js';\nimport { WorkRegistry, FrontendWorkError, type WorkFailure } from './work_registry.js';\nimport { FrontendLifecycleOwner, type FrontendLifecycle } from './frontend_lifecycle.js';\nimport { createFrontendPage, type FrontendPage, type FrontendPageHandle, type MountedLayout } from './frontend_page.js';\n\nexport interface FrontendOpenOptions {\n  /** Required production page identity (`window.page`, or unambiguous leaf). */\n  page: string;\n  params?: Record<string, string>;\n  query?: Record<string, string>;\n}\n\nexport interface FrontendApplicationSurface {\n  open(options: FrontendOpenOptions): Promise<FrontendPage>;\n  current(): FrontendPage | null;\n  act(action: () => unknown | Promise<unknown>): Promise<void>;\n  settle(): Promise<void>;\n  readonly errors: readonly WorkFailure[];\n  /** The environment-local production Navigation instance. */\n  readonly navigation: Navigation;\n  /** Internal: dispose the active page and application lifecycles. */\n  dispose(): Promise<void>;\n}\n\ninterface ScopeLike {\n  extend(): ScopeLike;\n  get(token: unknown): Promise<unknown>;\n  registerClass?(target: unknown, options?: unknown): void;\n  registerFunction?(token: unknown, factory: () => unknown, options?: unknown): void;\n  registerValue?(token: unknown, value: unknown): void;\n  dispose?(): Promise<void>;\n}\n\n/**\n * A mounted layout controller and the scope that owns it. A layout declared\n * `preserve: true` owns a DEDICATED scope that survives page transitions\n * (production parity: `createControllerSet`); every other layout shares the\n * page scope and dies with the page.\n */\ninterface ActiveLayout extends MountedLayout {\n  index: number;\n  /** Non-null only for a preserved layout that owns its scope. */\n  ownScope: ScopeLike | null;\n  /**\n   * A preserved layout outlives the page that built it, so it cannot borrow\n   * that page's lifecycle owner — it owns one, disposed when the layout is\n   * finally dropped.\n   */\n  ownLifecycle: FrontendLifecycleOwner | null;\n}\n\ninterface ActivePage {\n  identity: string;\n  view: ViewDef;\n  scope: ScopeLike;\n  lifecycle: FrontendLifecycleOwner;\n  handle: FrontendPageHandle;\n  controller: unknown;\n  layouts: ActiveLayout[];\n}\n\nexport interface PageScopeContext {\n  kind: 'page' | 'layout';\n  /** Layout index within the view's layout stack (layout scopes only). */\n  layoutIndex?: number;\n  /** Controller identity bound to this scope. */\n  controller: string;\n}\n\nexport interface CreateFrontendSurfaceOptions {\n  /** The selected renderer aperture. */\n  catalog: PageCatalog;\n  /** Fresh renderer root for this environment (separate from the main root). */\n  rendererRoot: ScopeLike;\n  registry: WorkRegistry;\n  /** Environment-local Navigation (also registered on the renderer root). */\n  navigation: Navigation;\n  /** Resolve a production controller identity to its class. */\n  resolveController: (identity: string, view: ViewDef) => Promise<new (...args: never[]) => unknown>;\n  /** Per-pass reactive flush hooks from the active runtime adapter (Node: none). */\n  flushHooks?: ReadonlyArray<() => void | Promise<void>>;\n  /**\n   * Register per-scope services on a newly created scope (bridge client,\n   * etc.). Called for the page scope, and once for each PRESERVED layout\n   * that owns a dedicated scope — `context.kind` says which, so a caller\n   * that tracks \"the page scope\" does not mistake a layout scope for it.\n   */\n  configurePageScope?: (\n    scope: ScopeLike,\n    view: ViewDef,\n    context: PageScopeContext,\n  ) => void | Promise<void>;\n}\n\n/**\n * Plain (undecorated) controller classes are registered on their scope so\n * they resolve — unless the hierarchy already decided how the token resolves\n * (a renderer-root substitution of the controller class), which keeps\n * winning inside the page scope.\n */\nfunction registerControllerUnlessBound(scope: ScopeLike, ControllerClass: unknown): void {\n  const registrable = scope as { isRegistered?(token: unknown): boolean };\n  if (typeof registrable.isRegistered === 'function' && registrable.isRegistered(ControllerClass)) return;\n  if (typeof scope.registerClass === 'function') scope.registerClass(ControllerClass);\n}\n\nexport function createFrontendSurface(options: CreateFrontendSurfaceOptions): FrontendApplicationSurface {\n  const { catalog, rendererRoot, registry, navigation } = options;\n  const flushHooks = options.flushHooks ?? [];\n  const application = new FrontendLifecycleOwner(registry, 'application');\n\n  let active: ActivePage | null = null;\n  let transitioning = false;\n  let disposed = false;\n  let navigationQueue: Promise<void> = Promise.resolve();\n  let closing: Promise<void> | undefined;\n  const retainedPageScopes = new Map<ScopeLike, FrontendLifecycleOwner>();\n  const locallyOwnedControllers = new WeakSet<object>();\n  const markController = (instance: unknown, token: unknown) => {\n    const root = rendererRoot as ScopeLike & { isRegistered?(token: unknown): boolean };\n    if (!root.isRegistered?.(token) && instance && typeof instance === 'object') locallyOwnedControllers.add(instance);\n    guardControllerLifecycleOnce(instance);\n  };\n  const disposeLocalController = (instance: unknown) => instance && typeof instance === 'object' && locallyOwnedControllers.has(instance)\n    ? disposeControllerLifecycle(instance) : Promise.resolve();\n\n  const currentOwner = (): string => (active ? `page ${active.identity}` : 'application');\n\n  async function constructPage(\n    view: ViewDef,\n    params: Record<string, string>,\n    query: Record<string, string>,\n    preserved: ActiveLayout[] = [],\n  ): Promise<ActivePage> {\n    const identity = pageIdentity(view);\n    if (!view.controller) {\n      throw new PageCatalogError(\n        `page \"${identity}\" declares no controller in its view definition; ` +\n        'the Node application slice drives public PageController input and needs one.',\n      );\n    }\n\n    const ControllerClass = await options.resolveController(view.controller, view);\n    const scope = rendererRoot.extend();\n    const lifecycle = new FrontendLifecycleOwner(registry, `page ${identity}`);\n\n    const rollback: Array<() => unknown | Promise<unknown>> = [\n      () => ExecutionContext.run(scope as never, () => scope.dispose?.()),\n      () => lifecycle.dispose(),\n    ];\n    try {\n    // The page lifecycle is injectable so controllers can register\n    // deliberately detached finite work (D-FAS-01 §2.2). Scoped, not\n    // Singleton: the lifecycle belongs to this page scope alone — a\n    // Singleton would store at the hierarchy root and leak the first\n    // page's lifecycle into every later page.\n    scope.registerFunction?.(FrontendLifecycleOwner, () => lifecycle, { loadAs: LoadAs.Scoped });\n    await ExecutionContext.run(scope as never, () => options.configurePageScope?.(scope, view, { kind: 'page', controller: view.controller! }));\n    registerControllerUnlessBound(scope, ControllerClass);\n\n    // Layout controllers mount BEFORE the view controller (production\n    // ordering in `createControllerSet`): a page controller may legitimately\n    // read state a layout controller published during construction.\n    const layouts: ActiveLayout[] = [...preserved];\n    for (let index = preserved.length; index < view.layouts.length; index += 1) {\n      const layoutIdentity = view.layoutControllers?.[index];\n      if (!layoutIdentity) continue;\n      const preserve = view.layoutPreserve?.[index] === true;\n      const LayoutClass = await options.resolveController(layoutIdentity, view);\n      const ownScope = preserve ? rendererRoot.extend() : null;\n      const ownLifecycle = ownScope\n        ? new FrontendLifecycleOwner(registry, `layout ${layoutIdentity}`)\n        : null;\n      const layoutScope = ownScope ?? scope;\n      if (ownScope) {\n        rollback.push(() => ExecutionContext.run(ownScope as never, () => ownScope.dispose?.()));\n        rollback.push(() => ownLifecycle!.dispose());\n        ownScope.registerFunction?.(FrontendLifecycleOwner, () => ownLifecycle!, { loadAs: LoadAs.Scoped });\n        await ExecutionContext.run(ownScope as never, () => options.configurePageScope?.(ownScope, view, {\n          kind: 'layout',\n          layoutIndex: index,\n          controller: layoutIdentity,\n        }));\n      }\n      registerControllerUnlessBound(layoutScope, LayoutClass);\n      const instance = (await ExecutionContext.run(layoutScope as never, () =>\n        layoutScope.get(LayoutClass),\n      )) as Record<string, unknown>;\n      markController(instance, LayoutClass);\n      rollback.push(() => ExecutionContext.run(layoutScope as never, () => disposeLocalController(instance)));\n      layouts.push({\n        index,\n        path: view.layouts[index],\n        controller: layoutIdentity,\n        preserve,\n        instance,\n        scope: layoutScope,\n        ownScope,\n        ownLifecycle,\n      });\n    }\n\n    const controller = (await ExecutionContext.run(scope as never, () =>\n      scope.get(ControllerClass),\n    )) as Record<string, unknown>;\n\n    markController(controller, ControllerClass);\n    rollback.push(() => ExecutionContext.run(scope as never, () => disposeLocalController(controller)));\n\n    if (typeof controller.initialize === 'function') {\n      await registry.track(\n        Promise.resolve(\n          ExecutionContext.run(scope as never, () =>\n            (controller.initialize as (load: unknown) => unknown)({ params, query }),\n          ),\n        ).then(() => undefined),\n        { label: `initialize ${identity}`, kind: 'initialize', owner: `page ${identity}` },\n      );\n    }\n\n    const handle = createFrontendPage({\n      identity,\n      controller,\n      scope,\n      layouts,\n      onClose: async () => {\n        await disposePage(identity);\n      },\n    });\n\n    return { identity, view, scope, lifecycle, handle, controller, layouts };\n    } catch (error) {\n      try { await cleanupAll(rollback.reverse(), 'Wood page rollback failed'); }\n      catch (cleanupError) { throw Object.assign(new Error('Wood page construction and cleanup failed'), { cause: error, errors: [error, cleanupError] }); }\n      throw error;\n    }\n  }\n\n  /**\n   * End a page: the page lifecycle owner first (abort signal, owned\n   * resources), then the IoC scopes — scope disposal is what runs each\n   * controller's production `dispose()`/`destroy()` hook, so nothing here\n   * calls those directly. Layouts in the preserved prefix keep running:\n   * they belong to the next page now.\n   */\n  async function endPage(page: ActivePage, preservedDepth = 0): Promise<void> {\n    page.handle.invalidate();\n    // Production teardown order (NavigationShell.disposeControllerSet): the\n    // page controller's hook, then each ending layout's, then the lifecycle\n    // owner and the IoC scopes. The hooks are once-guarded, so the scope\n    // disposal below does not run them a second time.\n    const steps: Array<() => unknown | Promise<unknown>> = [\n      () => ExecutionContext.run(page.scope as never, () => disposeLocalController(page.controller)),\n    ];\n    for (const layout of page.layouts) {\n      if (layout.index < preservedDepth) continue;\n      steps.push(() => ExecutionContext.run(layout.scope as never, () => disposeLocalController(layout.instance)));\n      steps.push(() => layout.ownLifecycle?.dispose());\n      if (layout.ownScope) steps.push(() => ExecutionContext.run(layout.ownScope as never, () => layout.ownScope!.dispose?.()));\n    }\n    const carriesPageScope = page.layouts.some(layout => layout.index < preservedDepth && layout.scope === page.scope);\n    if (carriesPageScope) retainedPageScopes.set(page.scope, page.lifecycle);\n    else {\n      steps.push(() => page.lifecycle.dispose());\n      steps.push(() => ExecutionContext.run(page.scope as never, () => page.scope.dispose?.()));\n    }\n    for (const [scope, lifecycle] of retainedPageScopes) {\n      if (active?.layouts.some(layout => layout.scope === scope)) continue;\n      retainedPageScopes.delete(scope);\n      steps.push(() => lifecycle.dispose());\n      steps.push(() => ExecutionContext.run(scope as never, () => scope.dispose?.()));\n    }\n    await cleanupAll(steps, 'Wood page cleanup failed');\n  }\n\n  async function disposePage(identity: string): Promise<void> {\n    if (!active || active.identity !== identity) return;\n    const ended = active;\n    active = null;\n    await endPage(ended);\n  }\n\n  async function transitionTo(entry: NavigationEntry): Promise<void> {\n    if (disposed) return;\n    // Resolve the destination through the selected aperture — navigation\n    // outside it fails without widening the environment.\n    const view = catalog.resolve(entry.page);\n    const previous = active;\n    // Preserved layouts carry over as live instances — the transition never\n    // reconstructs them (production `preserve: true` semantics).\n    // Same preservation rule the renderer's NavigationShell applies.\n    const depth = previous\n      ? computePreservedLayoutDepth(\n          { layoutPaths: previous.view.layouts, layoutControllers: previous.view.layoutControllers, layoutPreserve: previous.view.layoutPreserve },\n          { layoutPaths: view.layouts, layoutControllers: view.layoutControllers, layoutPreserve: view.layoutPreserve },\n          entry.options ?? {},\n        )\n      : 0;\n    const carried = previous ? previous.layouts.filter((layout) => layout.index < depth) : [];\n    const next = await constructPage(view, entry.params, entry.query, carried);\n    if (disposed) {\n      await endPage(next, depth);\n      return;\n    }\n    active = next;\n    if (previous) {\n      await endPage(previous, depth);\n    }\n  }\n\n  // Production navigation drives page transitions: a controller calling its\n  // injected Navigation.go()/replace() inside the aperture triggers one\n  // tracked finite navigation transition (18A D-FAS-01 §2.2).\n  const unsubscribe = navigation.subscribe((entry) => {\n    if (!entry || transitioning || disposed) return;\n    if (active && entry.page === active.identity) return;\n    if (!active) return; // initial open() seeds navigation itself\n    const transition = navigationQueue.then(() => transitionTo(entry));\n    navigationQueue = transition.catch(() => {});\n    registry.track(transition, {\n      label: `navigate ${active.identity} -> ${entry.page}`,\n      kind: 'navigation',\n      owner: currentOwner(),\n    });\n  });\n\n  return {\n    navigation,\n\n    async open(openOptions: FrontendOpenOptions): Promise<FrontendPage> {\n      if (disposed || transitioning) throw new PageCatalogError('Wood frontend is closed or opening a page');\n      if (!openOptions || typeof openOptions.page !== 'string' || !openOptions.page.length) {\n        throw new PageCatalogError('frontend.open() requires an explicit { page } identity');\n      }\n      if (active) {\n        throw new PageCatalogError(\n          `frontend.open() is test bootstrap; page \"${active.identity}\" is already open. ` +\n          'Drive production navigation for subsequent route changes, or close() the page first.',\n        );\n      }\n      const view = catalog.resolve(openOptions.page);\n      const params = openOptions.params ?? {};\n      const query = openOptions.query ?? {};\n\n      transitioning = true;\n      try {\n        // Seed production navigation state BEFORE construction: controllers\n        // and their services legitimately read the current route (params,\n        // query) during construction/initialize, exactly as in production\n        // where the route exists before the page loads.\n        navigation.replace(pageIdentity(view), params, query);\n        const opened = await constructPage(view, params, query);\n        if (disposed) { await endPage(opened); throw new PageCatalogError('Wood frontend was disposed during page construction'); }\n        active = opened;\n      } finally {\n        transitioning = false;\n      }\n      return active.handle.page;\n    },\n\n    current(): FrontendPage | null {\n      return active ? active.handle.page : null;\n    },\n\n    async act(action: () => unknown | Promise<unknown>): Promise<void> {\n      void registry.track(\n        Promise.resolve().then(() => action()).then(() => undefined),\n        { label: 'act()', kind: 'tracked', owner: currentOwner() },\n      ).catch(() => {\n        // The failure is recorded by the registry; drain reports it with\n        // its owner rather than losing the aggregate view.\n      });\n      await registry.drain(flushHooks);\n    },\n\n    async settle(): Promise<void> {\n      await registry.drain(flushHooks);\n    },\n\n    get errors(): readonly WorkFailure[] {\n      return registry.errors();\n    },\n\n    dispose(): Promise<void> {\n      if (closing) return closing;\n      disposed = true;\n      unsubscribe();\n      const ended = active;\n      active = null;\n      return closing = cleanupAll([\n        () => ended ? endPage(ended) : undefined,\n        () => application.dispose(),\n      ], 'Wood frontend cleanup failed');\n    },\n  };\n}\n\nexport type { FrontendLifecycle };\nexport { FrontendWorkError };\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/frontend/frontend_surface.ts"],"sourcesContent":["/**\n * The Node frontend application surface (spec 18 §12–13, 18A D-FAS-01/02).\n *\n *   frontend.open({ page, params, query })  — explicit initial page\n *   frontend.current()                      — production navigation result\n *   frontend.act(fn) / frontend.settle()    — owned-work fixed-point drains\n *   frontend.errors                         — observed owned-work failures\n *\n * Runtime honesty (D-FAS-02): this is the plain-Node tier. It proves\n * explicit PageController behavior, $state/$derived reachable through it,\n * backend calls, events, and navigation identity/lifecycle. It does not\n * create a Svelte component/root context and therefore proves no $effect,\n * mount/unmount, or DOM behavior — those belong to the happy-dom tier.\n *\n * Isolation: every environment owns its own Navigation instance, renderer\n * root, transport, and work registry. Nothing here writes globalThis and\n * nothing calls the production client getters — two environments run\n * concurrently without cross-talk. A controller that calls the module-level\n * `go()`/`getNavigation()` free functions bypasses its environment; this\n * tier requires constructor-injected `Navigation`.\n */\nimport { ExecutionContext, LoadAs } from '@noego/ioc';\nimport { Navigation, type NavigationEntry } from '../navigation/index.js';\nimport { computePreservedLayoutDepth } from '../navigation/layout_preservation.js';\nimport { createNavigationMountKey } from '../navigation/navigation_identity.js';\nimport { cleanupAll } from '../controller/cleanup.js';\nimport { disposeControllerLifecycle, guardControllerLifecycleOnce } from '../controller/controller_lifecycle.js';\nimport {\n  createLoaderRequest,\n  initializeArgument,\n  initializeController,\n  NO_LOADERS,\n  runViewLoaders,\n  type ViewLoaderSet,\n} from '../loader/loader_orchestration.js';\nimport type { ViewDef } from '../types/index.js';\nimport { PageCatalog, PageCatalogError, pageIdentity } from './page_catalog.js';\nimport { WorkRegistry, FrontendWorkError, type WorkFailure } from './work_registry.js';\nimport { FrontendLifecycleOwner, type FrontendLifecycle } from './frontend_lifecycle.js';\nimport { createFrontendPage, type FrontendPage, type FrontendPageHandle, type MountedLayout } from './frontend_page.js';\n\nexport interface FrontendOpenOptions {\n  /** Required production page identity (`window.page`, or unambiguous leaf). */\n  page: string;\n  params?: Record<string, string>;\n  query?: Record<string, string>;\n}\n\nexport interface FrontendApplicationSurface {\n  open(options: FrontendOpenOptions): Promise<FrontendPage>;\n  current(): FrontendPage | null;\n  act(action: () => unknown | Promise<unknown>): Promise<void>;\n  settle(): Promise<void>;\n  readonly errors: readonly WorkFailure[];\n  /** The environment-local production Navigation instance. */\n  readonly navigation: Navigation;\n  /** Internal: dispose the active page and application lifecycles. */\n  dispose(): Promise<void>;\n}\n\ninterface ScopeLike {\n  extend(): ScopeLike;\n  get(token: unknown): Promise<unknown>;\n  registerClass?(target: unknown, options?: unknown): void;\n  registerFunction?(token: unknown, factory: () => unknown, options?: unknown): void;\n  registerValue?(token: unknown, value: unknown): void;\n  dispose?(): Promise<void>;\n}\n\n/**\n * A mounted layout controller and the scope that owns it. A layout declared\n * `preserve: true` owns a DEDICATED scope that survives page transitions\n * (production parity: `createControllerSet`); every other layout shares the\n * page scope and dies with the page.\n */\ninterface ActiveLayout extends MountedLayout {\n  index: number;\n  /** Non-null only for a preserved layout that owns its scope. */\n  ownScope: ScopeLike | null;\n  /**\n   * A preserved layout outlives the page that built it, so it cannot borrow\n   * that page's lifecycle owner — it owns one, disposed when the layout is\n   * finally dropped.\n   */\n  ownLifecycle: FrontendLifecycleOwner | null;\n}\n\ninterface ActivePage {\n  identity: string;\n  mountKey: string;\n  view: ViewDef;\n  scope: ScopeLike;\n  lifecycle: FrontendLifecycleOwner;\n  handle: FrontendPageHandle;\n  controller: unknown;\n  layouts: ActiveLayout[];\n}\n\nexport interface PageScopeContext {\n  kind: 'page' | 'layout';\n  /** Layout index within the view's layout stack (layout scopes only). */\n  layoutIndex?: number;\n  /** Controller identity when the source binds one (static pages omit it). */\n  controller?: string;\n}\n\nexport interface CreateFrontendSurfaceOptions {\n  /** The selected renderer aperture. */\n  catalog: PageCatalog;\n  /** Fresh renderer root for this environment (separate from the main root). */\n  rendererRoot: ScopeLike;\n  registry: WorkRegistry;\n  /** Environment-local Navigation (also registered on the renderer root). */\n  navigation: Navigation;\n  /** Resolve a production controller identity to its class. */\n  resolveController: (identity: string, view: ViewDef) => Promise<new (...args: never[]) => unknown>;\n  /**\n   * Resolve the page/layout data loaders of a view (companion `.load`\n   * sources, already discovered and imported by the caller). Omitted: no\n   * loaders — controllers initialize with `{ params, query }` exactly as\n   * before. Loaders run under the page scope on every open/navigation,\n   * layouts (non-preserved) first, then the view, BEFORE controllers exist.\n   */\n  resolveLoaders?: (view: ViewDef) => ViewLoaderSet | Promise<ViewLoaderSet>;\n  /** Per-pass reactive flush hooks from the active runtime adapter (Node: none). */\n  flushHooks?: ReadonlyArray<() => void | Promise<void>>;\n  /**\n   * Register per-scope services on a newly created scope (bridge client,\n   * etc.). Called for the page scope, and once for each PRESERVED layout\n   * that owns a dedicated scope — `context.kind` says which, so a caller\n   * that tracks \"the page scope\" does not mistake a layout scope for it.\n   */\n  configurePageScope?: (\n    scope: ScopeLike,\n    view: ViewDef,\n    context: PageScopeContext,\n  ) => void | Promise<void>;\n}\n\n/**\n * Plain (undecorated) controller classes are registered on their scope so\n * they resolve — unless the hierarchy already decided how the token resolves\n * (a renderer-root substitution of the controller class), which keeps\n * winning inside the page scope.\n */\nfunction registerControllerUnlessBound(scope: ScopeLike, ControllerClass: unknown): void {\n  const registrable = scope as { isRegistered?(token: unknown): boolean };\n  if (typeof registrable.isRegistered === 'function' && registrable.isRegistered(ControllerClass)) return;\n  if (typeof scope.registerClass === 'function') scope.registerClass(ControllerClass);\n}\n\nexport function createFrontendSurface(options: CreateFrontendSurfaceOptions): FrontendApplicationSurface {\n  const { catalog, rendererRoot, registry, navigation } = options;\n  const flushHooks = options.flushHooks ?? [];\n  const application = new FrontendLifecycleOwner(registry, 'application');\n\n  let active: ActivePage | null = null;\n  let transitioning = false;\n  let disposed = false;\n  let navigationQueue: Promise<void> = Promise.resolve();\n  let closing: Promise<void> | undefined;\n  const retainedPageScopes = new Map<ScopeLike, FrontendLifecycleOwner>();\n  const locallyOwnedControllers = new WeakSet<object>();\n  const markController = (instance: unknown, token: unknown) => {\n    const root = rendererRoot as ScopeLike & { isRegistered?(token: unknown): boolean };\n    if (!root.isRegistered?.(token) && instance && typeof instance === 'object') locallyOwnedControllers.add(instance);\n    guardControllerLifecycleOnce(instance);\n  };\n  const disposeLocalController = (instance: unknown) => instance && typeof instance === 'object' && locallyOwnedControllers.has(instance)\n    ? disposeControllerLifecycle(instance) : Promise.resolve();\n\n  const currentOwner = (): string => (active ? `page ${active.identity}` : 'application');\n\n  async function constructPage(\n    view: ViewDef,\n    params: Record<string, string>,\n    query: Record<string, string>,\n    preserved: ActiveLayout[] = [],\n    preservedDepth = 0,\n  ): Promise<ActivePage> {\n    const identity = pageIdentity(view);\n    const ControllerClass = view.controller\n      ? await options.resolveController(view.controller, view) : undefined;\n    const scope = rendererRoot.extend();\n    const lifecycle = new FrontendLifecycleOwner(registry, `page ${identity}`);\n\n    const rollback: Array<() => unknown | Promise<unknown>> = [\n      () => ExecutionContext.run(scope as never, () => scope.dispose?.()),\n      () => lifecycle.dispose(),\n    ];\n    try {\n    // The page lifecycle is injectable so controllers can register\n    // deliberately detached finite work (D-FAS-01 §2.2). Scoped, not\n    // Singleton: the lifecycle belongs to this page scope alone — a\n    // Singleton would store at the hierarchy root and leak the first\n    // page's lifecycle into every later page.\n    scope.registerFunction?.(FrontendLifecycleOwner, () => lifecycle, { loadAs: LoadAs.Scoped });\n    await ExecutionContext.run(scope as never, () => options.configurePageScope?.(scope, view, { kind: 'page', controller: view.controller }));\n    if (ControllerClass) registerControllerUnlessBound(scope, ControllerClass);\n\n    // Data loaders run first (shared orchestration): the route is already\n    // seeded, no controller exists yet, and a failure rolls the page back.\n    const route = { params, query };\n    const loaderSet = options.resolveLoaders ? await options.resolveLoaders(view) : NO_LOADERS;\n    const loaded = await ExecutionContext.run(scope as never, () =>\n      runViewLoaders(loaderSet, createLoaderRequest(identity, route), preservedDepth),\n    );\n\n    // Layout controllers mount BEFORE the view controller (production\n    // ordering in `createControllerSet`): a page controller may legitimately\n    // read state a layout controller published during construction.\n    const layouts: ActiveLayout[] = [...preserved];\n    for (let index = preservedDepth; index < view.layouts.length; index += 1) {\n      const layoutIdentity = view.layoutControllers?.[index];\n      if (!layoutIdentity) continue;\n      const preserve = view.layoutPreserve?.[index] === true;\n      const LayoutClass = await options.resolveController(layoutIdentity, view);\n      const ownScope = preserve ? rendererRoot.extend() : null;\n      const ownLifecycle = ownScope\n        ? new FrontendLifecycleOwner(registry, `layout ${layoutIdentity}`)\n        : null;\n      const layoutScope = ownScope ?? scope;\n      if (ownScope) {\n        rollback.push(() => ExecutionContext.run(ownScope as never, () => ownScope.dispose?.()));\n        rollback.push(() => ownLifecycle!.dispose());\n        ownScope.registerFunction?.(FrontendLifecycleOwner, () => ownLifecycle!, { loadAs: LoadAs.Scoped });\n        await ExecutionContext.run(ownScope as never, () => options.configurePageScope?.(ownScope, view, {\n          kind: 'layout',\n          layoutIndex: index,\n          controller: layoutIdentity,\n        }));\n      }\n      registerControllerUnlessBound(layoutScope, LayoutClass);\n      const instance = (await ExecutionContext.run(layoutScope as never, () =>\n        layoutScope.get(LayoutClass),\n      )) as Record<string, unknown>;\n      markController(instance, LayoutClass);\n      rollback.push(() => ExecutionContext.run(layoutScope as never, () => disposeLocalController(instance)));\n      if (typeof instance.initialize === 'function') {\n        await registry.track(\n          Promise.resolve(\n            ExecutionContext.run(layoutScope as never, () =>\n              initializeController(instance, initializeArgument(route, loaded.layouts[index] ?? null)),\n            ),\n          ).then(() => undefined),\n          { label: `initialize layout ${layoutIdentity}`, kind: 'initialize', owner: `page ${identity}` },\n        );\n      }\n      layouts.push({\n        index,\n        path: view.layouts[index],\n        controller: layoutIdentity,\n        preserve,\n        instance,\n        scope: layoutScope,\n        ownScope,\n        ownLifecycle,\n      });\n    }\n\n    const controller = ControllerClass ? (await ExecutionContext.run(scope as never, () =>\n      scope.get(ControllerClass),\n    )) as Record<string, unknown> : undefined;\n\n    if (controller) markController(controller, ControllerClass);\n    rollback.push(() => ExecutionContext.run(scope as never, () => disposeLocalController(controller)));\n\n    if (typeof controller?.initialize === 'function') {\n      await registry.track(\n        Promise.resolve(\n          ExecutionContext.run(scope as never, () =>\n            initializeController(controller, initializeArgument(route, loaded.view)),\n          ),\n        ).then(() => undefined),\n        { label: `initialize ${identity}`, kind: 'initialize', owner: `page ${identity}` },\n      );\n    }\n\n    const handle = createFrontendPage({\n      identity,\n      controller,\n      scope,\n      layouts,\n      onClose: async () => {\n        await disposePage(identity);\n      },\n    });\n\n    return { identity, mountKey: createNavigationMountKey(identity, params), view, scope, lifecycle, handle, controller, layouts };\n    } catch (error) {\n      try { await cleanupAll(rollback.reverse(), 'Wood page rollback failed'); }\n      catch (cleanupError) { throw Object.assign(new Error('Wood page construction and cleanup failed'), { cause: error, errors: [error, cleanupError] }); }\n      throw error;\n    }\n  }\n\n  /**\n   * End a page: the page lifecycle owner first (abort signal, owned\n   * resources), then the IoC scopes — scope disposal is what runs each\n   * controller's production `dispose()`/`destroy()` hook, so nothing here\n   * calls those directly. Layouts in the preserved prefix keep running:\n   * they belong to the next page now.\n   */\n  async function endPage(page: ActivePage, preservedDepth = 0): Promise<void> {\n    page.handle.invalidate();\n    // Production teardown order (NavigationShell.disposeControllerSet): the\n    // page controller's hook, then each ending layout's, then the lifecycle\n    // owner and the IoC scopes. The hooks are once-guarded, so the scope\n    // disposal below does not run them a second time.\n    const steps: Array<() => unknown | Promise<unknown>> = [\n      () => ExecutionContext.run(page.scope as never, () => disposeLocalController(page.controller)),\n    ];\n    for (const layout of page.layouts) {\n      if (layout.index < preservedDepth) continue;\n      steps.push(() => ExecutionContext.run(layout.scope as never, () => disposeLocalController(layout.instance)));\n      steps.push(() => layout.ownLifecycle?.dispose());\n      if (layout.ownScope) steps.push(() => ExecutionContext.run(layout.ownScope as never, () => layout.ownScope!.dispose?.()));\n    }\n    const carriesPageScope = page.layouts.some(layout => layout.index < preservedDepth && layout.scope === page.scope);\n    if (carriesPageScope) retainedPageScopes.set(page.scope, page.lifecycle);\n    else {\n      steps.push(() => page.lifecycle.dispose());\n      steps.push(() => ExecutionContext.run(page.scope as never, () => page.scope.dispose?.()));\n    }\n    for (const [scope, lifecycle] of retainedPageScopes) {\n      if (active?.layouts.some(layout => layout.scope === scope)) continue;\n      retainedPageScopes.delete(scope);\n      steps.push(() => lifecycle.dispose());\n      steps.push(() => ExecutionContext.run(scope as never, () => scope.dispose?.()));\n    }\n    await cleanupAll(steps, 'Wood page cleanup failed');\n  }\n\n  async function disposePage(identity: string): Promise<void> {\n    if (!active || active.identity !== identity) return;\n    const ended = active;\n    active = null;\n    await endPage(ended);\n  }\n\n  async function transitionTo(entry: NavigationEntry): Promise<void> {\n    if (disposed) return;\n    // Resolve the destination through the selected aperture — navigation\n    // outside it fails without widening the environment.\n    const view = catalog.resolve(entry.page);\n    const previous = active;\n    // Preserved layouts carry over as live instances — the transition never\n    // reconstructs them (production `preserve: true` semantics).\n    // Same preservation rule the renderer's NavigationShell applies.\n    const depth = previous\n      ? computePreservedLayoutDepth(\n          { layoutPaths: previous.view.layouts, layoutControllers: previous.view.layoutControllers, layoutPreserve: previous.view.layoutPreserve },\n          { layoutPaths: view.layouts, layoutControllers: view.layoutControllers, layoutPreserve: view.layoutPreserve },\n          entry.options ?? {},\n        )\n      : 0;\n    const carried = previous ? previous.layouts.filter((layout) => layout.index < depth) : [];\n    const next = await constructPage(view, entry.params, entry.query, carried, depth);\n    if (disposed) {\n      await endPage(next, depth);\n      return;\n    }\n    active = next;\n    if (previous) {\n      await endPage(previous, depth);\n    }\n  }\n\n  // Production navigation drives page transitions: a controller calling its\n  // injected Navigation.go()/replace() inside the aperture triggers one\n  // tracked finite navigation transition (18A D-FAS-01 §2.2).\n  const unsubscribe = navigation.subscribe((entry) => {\n    if (!entry || transitioning || disposed) return;\n    if (active && createNavigationMountKey(entry.page, entry.params) === active.mountKey) return;\n    if (!active) return; // initial open() seeds navigation itself\n    const transition = navigationQueue.then(() => transitionTo(entry));\n    navigationQueue = transition.catch(() => {});\n    registry.track(transition, {\n      label: `navigate ${active.identity} -> ${entry.page}`,\n      kind: 'navigation',\n      owner: currentOwner(),\n    });\n  });\n\n  return {\n    navigation,\n\n    async open(openOptions: FrontendOpenOptions): Promise<FrontendPage> {\n      if (disposed || transitioning) throw new PageCatalogError('Wood frontend is closed or opening a page');\n      if (!openOptions || typeof openOptions.page !== 'string' || !openOptions.page.length) {\n        throw new PageCatalogError('frontend.open() requires an explicit { page } identity');\n      }\n      if (active) {\n        throw new PageCatalogError(\n          `frontend.open() is test bootstrap; page \"${active.identity}\" is already open. ` +\n          'Drive production navigation for subsequent route changes, or close() the page first.',\n        );\n      }\n      const view = catalog.resolve(openOptions.page);\n      const params = openOptions.params ?? {};\n      const query = openOptions.query ?? {};\n\n      transitioning = true;\n      try {\n        // Seed production navigation state BEFORE construction: controllers\n        // and their services legitimately read the current route (params,\n        // query) during construction/initialize, exactly as in production\n        // where the route exists before the page loads.\n        navigation.replace(pageIdentity(view), params, query);\n        const opened = await constructPage(view, params, query);\n        if (disposed) { await endPage(opened); throw new PageCatalogError('Wood frontend was disposed during page construction'); }\n        active = opened;\n      } finally {\n        transitioning = false;\n      }\n      return active.handle.page;\n    },\n\n    current(): FrontendPage | null {\n      return active ? active.handle.page : null;\n    },\n\n    async act(action: () => unknown | Promise<unknown>): Promise<void> {\n      void registry.track(\n        Promise.resolve().then(() => action()).then(() => undefined),\n        { label: 'act()', kind: 'tracked', owner: currentOwner() },\n      ).catch(() => {\n        // The failure is recorded by the registry; drain reports it with\n        // its owner rather than losing the aggregate view.\n      });\n      await registry.drain(flushHooks);\n    },\n\n    async settle(): Promise<void> {\n      await registry.drain(flushHooks);\n    },\n\n    get errors(): readonly WorkFailure[] {\n      return registry.errors();\n    },\n\n    dispose(): Promise<void> {\n      if (closing) return closing;\n      disposed = true;\n      unsubscribe();\n      const ended = active;\n      active = null;\n      return closing = cleanupAll([\n        () => ended ? endPage(ended) : undefined,\n        () => application.dispose(),\n      ], 'Wood frontend cleanup failed');\n    },\n  };\n}\n\nexport type { FrontendLifecycle };\nexport { FrontendWorkError };\n"],"mappings":"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","names":[]}

package/dist/frontend/index.d.cts

@@ -9,3 +9,5 @@ import '../transport/wood_rpc_transport.cjs';
 import '../navigation/index.cjs';
 import '../navigation/layout_preservation.cjs';
 import '../navigation/automation_introspection.cjs';
+import '../loader/loader_orchestration.cjs';
+import '../types/context.cjs';

package/dist/frontend/index.d.ts

@@ -9,3 +9,5 @@ import '../transport/wood_rpc_transport.js';
 import '../navigation/index.js';
 import '../navigation/layout_preservation.js';
 import '../navigation/automation_introspection.js';
+import '../loader/loader_orchestration.js';
+import '../types/context.js';

package/dist/index.cjs

@@ -41,6 +41,7 @@ __export(index_exports, {
   WindowStateStore: () => import_window.WindowStateStore,
   WoodAuthError: () => import_types.WoodAuthError,
   WoodRouter: () => import_router.WoodRouter,
+  WoodTestBuilder: () => import_test_wood.WoodTestBuilder,
   WoodTraceBatchContract: () => import_tracing.WoodTraceBatchContract,
   WoodValidationError: () => import_types.WoodValidationError,
   buildControllerArgs: () => import_controller.buildControllerArgs,
@@ -95,6 +96,7 @@ __export(index_exports, {
   setRendererTraceEnabled: () => import_tracing.setRendererTraceEnabled,
   setRendererTraceTransport: () => import_tracing.setRendererTraceTransport,
   startBackendLoop: () => import_bridge.startBackendLoop,
+  testWood: () => import_test_wood.testWood,
   usesOperationContext: () => import_controller.usesOperationContext,
   woodBatchToTraceBatch: () => import_tracing.woodBatchToTraceBatch,
   writeWoodDevMetadata: () => import_dev_metadata.writeWoodDevMetadata
@@ -125,6 +127,7 @@ var import_runtime = require("./runtime/index.js");
 var import_navigation = require("./navigation/index.cjs");
 var import_ipc = require("./ipc/index.cjs");
 var import_tracing = require("./tracing/index.js");
+var import_test_wood = require("./test-wood.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BackendBridge,
@@ -150,6 +153,7 @@ var import_tracing = require("./tracing/index.js");
   WindowStateStore,
   WoodAuthError,
   WoodRouter,
+  WoodTestBuilder,
   WoodTraceBatchContract,
   WoodValidationError,
   buildControllerArgs,
@@ -204,6 +208,7 @@ var import_tracing = require("./tracing/index.js");
   setRendererTraceEnabled,
   setRendererTraceTransport,
   startBackendLoop,
+  testWood,
   usesOperationContext,
   woodBatchToTraceBatch,
   writeWoodDevMetadata

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @noego/wood — Declarative Electron desktop apps using the noego ecosystem\n\n// Types\nexport type {\n  WoodConfig,\n  WindowDef,\n  DevConfig,\n  ElectronBuilderConfig,\n  OperationDef,\n  RawOperationsDocument,\n  RawModuleDef,\n  RawOperationEntry,\n  RawModuleOperationEntry,\n  ViewDef,\n  RawViewsDocument,\n  RawViewEntry,\n  ParameterDef,\n  IpcContext,\n  WoodMiddlewareContext,\n  WoodMiddlewareFn,\n  RequestData,\n  ControllerArgs,\n  LoaderResult,\n  BridgeMessage,\n  BridgeRequest,\n  BridgeResponse,\n  BridgeReady,\n  BridgePush,\n  BridgeElectronApi,\n  SerializedError,\n  ContextMenuContext,\n  ContextMenuItem,\n  ContextMenuEvent,\n} from './types/index.cjs';\n\n// Errors\nexport { WoodAuthError, WoodValidationError, BackendRestartingError } from './types/index.cjs';\n\n// Config\nexport {\n  parseConfig,\n  resolveRendererTraceBatching,\n  RENDERER_TRACE_BATCHING_DEFAULTS,\n} from './config/index.cjs';\nexport type { ObservabilityConfig, RendererTraceBatchingConfig } from './config/index.cjs';\n\n// Parsers\nexport { parseOperations, parseOperationsDocument, parseOperationsFile } from './parser/index.cjs';\nexport { parseViews, parseViewsFile } from './parser/index.cjs';\n\n// Router\nexport { WoodRouter } from './router/index.cjs';\n\n// Validation\nexport { SchemaValidator } from './validation/index.cjs';\n\n// Middleware\nexport { MiddlewareResolver, buildMiddlewareContext, executeMiddleware } from './middleware/index.cjs';\n\n// Controller\nexport { ControllerResolver, buildControllerArgs, buildOperationContext, usesOperationContext, disposeControllerLifecycle } from './controller/index.cjs';\nexport type { ControllerLifecycle } from './controller/index.cjs';\n\n// Codegen\nexport { generatePreload } from './codegen/index.cjs';\nexport { generateTypes } from './codegen/index.cjs';\nexport { generateChannelMap } from './codegen/index.cjs';\nexport { generateTestMock } from './codegen/index.cjs';\nexport { generateControllerRegistration } from './codegen/index.cjs';\nexport type { ControllerRegistrationOptions } from './codegen/index.cjs';\nexport { generateRuntime } from './codegen/index.cjs';\nexport type { RuntimeGeneratorOptions } from './codegen/index.cjs';\nexport { generateRendererViewManifest } from './codegen/index.cjs';\nexport type { RendererViewManifestGeneratorOptions } from './codegen/index.cjs';\nexport { generateRendererControllerRegistration } from './codegen/index.cjs';\nexport type { RendererControllerRegistrationOptions } from './codegen/index.cjs';\nexport { generateRendererApp } from './codegen/index.cjs';\nexport type { RendererAppGeneratorOptions } from './codegen/index.cjs';\n\n// Window\nexport { WindowManager, WindowStateStore } from './window/index.cjs';\nexport type { ScreenLike, WindowBounds } from './window/index.cjs';\n\n// Loader\nexport { LoaderRunner } from './loader/index.cjs';\n\n// Bridge\nexport { BackendBridge, startBackendLoop, pushEvent } from './bridge/index.cjs';\n\n// Dev metadata (lightweight; safe at runtime)\n// Heavy dev tooling (WoodDevServer, BackendWatcher, YamlWatcher,\n// EsbuildBackend) is available via the '@noego/wood/dev' subpath only,\n// so production consumers never load esbuild/chokidar.\nexport {\n  DEFAULT_WOOD_REMOTE_DEBUGGING_PORT,\n  WOOD_DEV_DIRECTORY,\n  WOOD_DEV_METADATA_BASENAME,\n  resolveWoodRemoteDebuggingPort,\n  resolveWoodDevDirectory,\n  resolveWoodDevMetadataPath,\n  writeWoodDevMetadata,\n  readWoodDevMetadata,\n  removeWoodDevMetadata,\n} from './dev/dev_metadata.js';\nexport type { WoodDevMetadata } from './dev/dev_metadata.js';\n\n// Runtime\nexport {\n  createWoodRoot,\n  getContainer,\n  clearContainerRegistryForTests,\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n  clearRendererTraceBatchReceiverForTests,\n  getRendererTraceBatchReceiver,\n  runtime,\n  setRendererTraceBatchReceiver,\n} from './runtime/index.js';\nexport type {\n  GetContainerOptions,\n  RuntimeOptions,\n  RuntimeResult,\n  RegisterRuntimeRouter,\n} from './runtime/index.cjs';\n\n// Navigation\nexport { Navigation, getNavigation, go, goto, goback } from './navigation/index.cjs';\nexport type { NavigationEntry, NavigationOptions } from './navigation/index.cjs';\n\n// Isomorphic IPC API\nexport { Ipc, getIpc } from './ipc/index.cjs';\nexport type { IpcPushOptions } from './ipc/index.cjs';\n\n// Tracing\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\n  TraceCommitWriter,\n  clearTraceHubForTests,\n  getTraceEvents$,\n  getTraceProducerId,\n  ingestRemoteTraceEvent,\n  publishMainTrace,\n  publishTestTrace,\n  registerTraceSink,\n  setRendererTraceEnabled,\n  setRendererTraceTransport,\n  woodBatchToTraceBatch,\n  WoodTraceBatchContract,\n} from './tracing/index.js';\nexport type { WoodTraceBatchConversion } from './tracing/index.js';\nexport type {\n  TraceCommitRow,\n  TraceCommitWriterOptions,\n  TraceFlushOptions,\n  TraceFlushResult,\n  WoodTracePersistencePort,\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceLevel,\n  TraceProcess,\n  TraceProviderMode,\n  TraceRuntimeContext,\n  TraceRuntime,\n  TraceWaitOptions,\n  WoodRendererTraceEvent,\n  WoodRendererTraceInput,\n  WoodTraceBatch,\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchReceiver,\n  WoodTraceBatchRuntimeContext,\n  WoodTraceEventSink,\n  WoodTraceEventSnapshot,\n  WoodTraceSinkDisposer,\n} from './tracing/index.js';\n\n// Testing — available via '@noego/wood/testing' subpath export.\n// Not re-exported here to avoid pulling vitest into production builds.\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoCA,mBAA2E;AAG3E,oBAIO;AAIP,oBAA8E;AAC9E,IAAAA,iBAA2C;AAG3C,oBAA2B;AAG3B,wBAAgC;AAGhC,wBAA8E;AAG9E,wBAAiI;AAIjI,qBAAgC;AAChC,IAAAC,kBAA8B;AAC9B,IAAAA,kBAAmC;AACnC,IAAAA,kBAAiC;AACjC,IAAAA,kBAA+C;AAE/C,IAAAA,kBAAgC;AAEhC,IAAAA,kBAA6C;AAE7C,IAAAA,kBAAuD;AAEvD,IAAAA,kBAAoC;AAIpC,oBAAgD;AAIhD,oBAA6B;AAG7B,oBAA2D;AAM3D,0BAUO;AAIP,qBAWO;AASP,wBAA4D;AAI5D,iBAA4B;AAI5B,qBAmBO;","names":["import_parser","import_codegen"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @noego/wood — Declarative Electron desktop apps using the noego ecosystem\n\n// Types\nexport type {\n  WoodConfig,\n  WindowDef,\n  DevConfig,\n  ElectronBuilderConfig,\n  OperationDef,\n  RawOperationsDocument,\n  RawModuleDef,\n  RawOperationEntry,\n  RawModuleOperationEntry,\n  ViewDef,\n  RawViewsDocument,\n  RawViewEntry,\n  ParameterDef,\n  IpcContext,\n  WoodMiddlewareContext,\n  WoodMiddlewareFn,\n  RequestData,\n  ControllerArgs,\n  LoaderResult,\n  BridgeMessage,\n  BridgeRequest,\n  BridgeResponse,\n  BridgeReady,\n  BridgePush,\n  BridgeElectronApi,\n  SerializedError,\n  ContextMenuContext,\n  ContextMenuItem,\n  ContextMenuEvent,\n} from './types/index.cjs';\n\n// Errors\nexport { WoodAuthError, WoodValidationError, BackendRestartingError } from './types/index.cjs';\n\n// Config\nexport {\n  parseConfig,\n  resolveRendererTraceBatching,\n  RENDERER_TRACE_BATCHING_DEFAULTS,\n} from './config/index.cjs';\nexport type { ObservabilityConfig, RendererTraceBatchingConfig } from './config/index.cjs';\n\n// Parsers\nexport { parseOperations, parseOperationsDocument, parseOperationsFile } from './parser/index.cjs';\nexport { parseViews, parseViewsFile } from './parser/index.cjs';\n\n// Router\nexport { WoodRouter } from './router/index.cjs';\n\n// Validation\nexport { SchemaValidator } from './validation/index.cjs';\n\n// Middleware\nexport { MiddlewareResolver, buildMiddlewareContext, executeMiddleware } from './middleware/index.cjs';\n\n// Controller\nexport { ControllerResolver, buildControllerArgs, buildOperationContext, usesOperationContext, disposeControllerLifecycle } from './controller/index.cjs';\nexport type { ControllerLifecycle } from './controller/index.cjs';\n\n// Codegen\nexport { generatePreload } from './codegen/index.cjs';\nexport { generateTypes } from './codegen/index.cjs';\nexport { generateChannelMap } from './codegen/index.cjs';\nexport { generateTestMock } from './codegen/index.cjs';\nexport { generateControllerRegistration } from './codegen/index.cjs';\nexport type { ControllerRegistrationOptions } from './codegen/index.cjs';\nexport { generateRuntime } from './codegen/index.cjs';\nexport type { RuntimeGeneratorOptions } from './codegen/index.cjs';\nexport { generateRendererViewManifest } from './codegen/index.cjs';\nexport type { RendererViewManifestGeneratorOptions } from './codegen/index.cjs';\nexport { generateRendererControllerRegistration } from './codegen/index.cjs';\nexport type { RendererControllerRegistrationOptions } from './codegen/index.cjs';\nexport { generateRendererApp } from './codegen/index.cjs';\nexport type { RendererAppGeneratorOptions } from './codegen/index.cjs';\n\n// Window\nexport { WindowManager, WindowStateStore } from './window/index.cjs';\nexport type { ScreenLike, WindowBounds } from './window/index.cjs';\n\n// Loader\nexport { LoaderRunner } from './loader/index.cjs';\n\n// Bridge\nexport { BackendBridge, startBackendLoop, pushEvent } from './bridge/index.cjs';\n\n// Dev metadata (lightweight; safe at runtime)\n// Heavy dev tooling (WoodDevServer, BackendWatcher, YamlWatcher,\n// EsbuildBackend) is available via the '@noego/wood/dev' subpath only,\n// so production consumers never load esbuild/chokidar.\nexport {\n  DEFAULT_WOOD_REMOTE_DEBUGGING_PORT,\n  WOOD_DEV_DIRECTORY,\n  WOOD_DEV_METADATA_BASENAME,\n  resolveWoodRemoteDebuggingPort,\n  resolveWoodDevDirectory,\n  resolveWoodDevMetadataPath,\n  writeWoodDevMetadata,\n  readWoodDevMetadata,\n  removeWoodDevMetadata,\n} from './dev/dev_metadata.js';\nexport type { WoodDevMetadata } from './dev/dev_metadata.js';\n\n// Runtime\nexport {\n  createWoodRoot,\n  getContainer,\n  clearContainerRegistryForTests,\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n  clearRendererTraceBatchReceiverForTests,\n  getRendererTraceBatchReceiver,\n  runtime,\n  setRendererTraceBatchReceiver,\n} from './runtime/index.js';\nexport type {\n  GetContainerOptions,\n  RuntimeOptions,\n  RuntimeResult,\n  RegisterRuntimeRouter,\n} from './runtime/index.cjs';\n\n// Navigation\nexport { Navigation, getNavigation, go, goto, goback } from './navigation/index.cjs';\nexport type { NavigationEntry, NavigationOptions } from './navigation/index.cjs';\n\n// Isomorphic IPC API\nexport { Ipc, getIpc } from './ipc/index.cjs';\nexport type { IpcPushOptions } from './ipc/index.cjs';\n\n// Tracing\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\n  TraceCommitWriter,\n  clearTraceHubForTests,\n  getTraceEvents$,\n  getTraceProducerId,\n  ingestRemoteTraceEvent,\n  publishMainTrace,\n  publishTestTrace,\n  registerTraceSink,\n  setRendererTraceEnabled,\n  setRendererTraceTransport,\n  woodBatchToTraceBatch,\n  WoodTraceBatchContract,\n} from './tracing/index.js';\nexport type { WoodTraceBatchConversion } from './tracing/index.js';\nexport type {\n  TraceCommitRow,\n  TraceCommitWriterOptions,\n  TraceFlushOptions,\n  TraceFlushResult,\n  WoodTracePersistencePort,\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceLevel,\n  TraceProcess,\n  TraceProviderMode,\n  TraceRuntimeContext,\n  TraceRuntime,\n  TraceWaitOptions,\n  WoodRendererTraceEvent,\n  WoodRendererTraceInput,\n  WoodTraceBatch,\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchReceiver,\n  WoodTraceBatchRuntimeContext,\n  WoodTraceEventSink,\n  WoodTraceEventSnapshot,\n  WoodTraceSinkDisposer,\n} from './tracing/index.js';\n\n// Testing facade — production-safe: records the builder here and loads the\n// '@noego/wood/testing' implementation (DOM, Playwright, Electron mocks)\n// only inside build(). Compatibility helpers stay on the subpath export.\nexport { testWood, WoodTestBuilder } from './test-wood.js';\nexport type { WoodTestSelection } from './test-wood.js';\nexport type { TestWoodEnvironment, WoodDomMode } from './testing/index.js';\nexport type { WoodTestApi, WoodTestRawApi } from './testing-api.js';\n\nexport type { WoodBrowserHost, NativeWoodPage, NativeWoodTestEnvironment, WoodTestEnvironmentFor, WoodBrowserOpenOptions } from './testing/native_browser/native_browser.types.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoCA,mBAA2E;AAG3E,oBAIO;AAIP,oBAA8E;AAC9E,IAAAA,iBAA2C;AAG3C,oBAA2B;AAG3B,wBAAgC;AAGhC,wBAA8E;AAG9E,wBAAiI;AAIjI,qBAAgC;AAChC,IAAAC,kBAA8B;AAC9B,IAAAA,kBAAmC;AACnC,IAAAA,kBAAiC;AACjC,IAAAA,kBAA+C;AAE/C,IAAAA,kBAAgC;AAEhC,IAAAA,kBAA6C;AAE7C,IAAAA,kBAAuD;AAEvD,IAAAA,kBAAoC;AAIpC,oBAAgD;AAIhD,oBAA6B;AAG7B,oBAA2D;AAM3D,0BAUO;AAIP,qBAWO;AASP,wBAA4D;AAI5D,iBAA4B;AAI5B,qBAmBO;AA+BP,uBAA0C;","names":["import_parser","import_codegen"]}

package/dist/index.d.cts

@@ -40,6 +40,11 @@ export { TraceCommitRow, TraceCommitWriter, TraceCommitWriterOptions, TraceFlush
 export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './tracing/trace_provider.cjs';
 export { Navigation, NavigationEntry, getNavigation, go, goback, goto } from './navigation/index.cjs';
 export { Ipc, getIpc } from './ipc/index.cjs';
+export { WoodTestBuilder, WoodTestSelection, testWood } from './test-wood.cjs';
+export { N as NativeWoodPage, a as NativeWoodTestEnvironment, T as TestWoodEnvironment, W as WoodBrowserHost, b as WoodBrowserOpenOptions, c as WoodTestEnvironmentFor } from './native_browser.types-vWXtE4rM.cjs';
+export { WoodTestApi, WoodTestRawApi } from './testing-api.cjs';
+export { WoodDomMode } from './testing/wood_test_selection.cjs';
+import './testing/browser.cjs';
 export { IpcPushOptions } from './ipc/shared.cjs';
 export { NavigationOptions } from './navigation/layout_preservation.cjs';
 import '@noego/ioc';
@@ -50,3 +55,23 @@ import 'rxjs';
 import '@noego/trace';
 import '@noego/telemetry/core';
 import './navigation/automation_introspection.cjs';
+import './loader/loader_orchestration.cjs';
+import '@noego/testing/fetch';
+import '@noego/testing';
+import 'playwright';
+import 'happy-dom';
+import './testing/wood_config_source.cjs';
+import './testing/create_router_bridge.cjs';
+import './frontend/frontend_surface.cjs';
+import './frontend/page_catalog.cjs';
+import './frontend/work_registry.cjs';
+import './frontend/frontend_lifecycle.cjs';
+import './frontend/frontend_page.cjs';
+import './testing/wood_env_renderer.cjs';
+import './testing/wood_dom_animation.cjs';
+import './testing/registration_only_root.cjs';
+import './testing/test_wood.cjs';
+import './trace-testing/trace_recorder.cjs';
+import '@noego/trace/testing';
+import './transport/wood_rpc_transport.cjs';
+import './testing/geometry.cjs';

package/dist/index.d.ts

@@ -40,6 +40,11 @@ export { TraceCommitRow, TraceCommitWriter, TraceCommitWriterOptions, TraceFlush
 export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './tracing/trace_provider.js';
 export { Navigation, NavigationEntry, getNavigation, go, goback, goto } from './navigation/index.js';
 export { Ipc, getIpc } from './ipc/index.js';
+export { WoodTestBuilder, WoodTestSelection, testWood } from './test-wood.js';
+export { N as NativeWoodPage, a as NativeWoodTestEnvironment, T as TestWoodEnvironment, W as WoodBrowserHost, b as WoodBrowserOpenOptions, c as WoodTestEnvironmentFor } from './native_browser.types-BY2daUOS.js';
+export { WoodTestApi, WoodTestRawApi } from './testing-api.js';
+export { WoodDomMode } from './testing/wood_test_selection.js';
+import './testing/browser.js';
 export { IpcPushOptions } from './ipc/shared.js';
 export { NavigationOptions } from './navigation/layout_preservation.js';
 import '@noego/ioc';
@@ -50,3 +55,23 @@ import 'rxjs';
 import '@noego/trace';
 import '@noego/telemetry/core';
 import './navigation/automation_introspection.js';
+import './loader/loader_orchestration.js';
+import '@noego/testing/fetch';
+import '@noego/testing';
+import 'playwright';
+import 'happy-dom';
+import './testing/wood_config_source.js';
+import './testing/create_router_bridge.js';
+import './frontend/frontend_surface.js';
+import './frontend/page_catalog.js';
+import './frontend/work_registry.js';
+import './frontend/frontend_lifecycle.js';
+import './frontend/frontend_page.js';
+import './testing/wood_env_renderer.js';
+import './testing/wood_dom_animation.js';
+import './testing/registration_only_root.js';
+import './testing/test_wood.js';
+import './trace-testing/trace_recorder.js';
+import '@noego/trace/testing';
+import './transport/wood_rpc_transport.js';
+import './testing/geometry.js';

package/dist/index.js

@@ -67,6 +67,7 @@ import {
   woodBatchToTraceBatch,
   WoodTraceBatchContract
 } from "./tracing/index.js";
+import { testWood, WoodTestBuilder } from "./test-wood.js";
 export {
   BackendBridge,
   BackendRestartingError,
@@ -91,6 +92,7 @@ export {
   WindowStateStore,
   WoodAuthError,
   WoodRouter,
+  WoodTestBuilder,
   WoodTraceBatchContract,
   WoodValidationError,
   buildControllerArgs,
@@ -145,6 +147,7 @@ export {
   setRendererTraceEnabled,
   setRendererTraceTransport,
   startBackendLoop,
+  testWood,
   usesOperationContext,
   woodBatchToTraceBatch,
   writeWoodDevMetadata

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @noego/wood — Declarative Electron desktop apps using the noego ecosystem\n\n// Types\nexport type {\n  WoodConfig,\n  WindowDef,\n  DevConfig,\n  ElectronBuilderConfig,\n  OperationDef,\n  RawOperationsDocument,\n  RawModuleDef,\n  RawOperationEntry,\n  RawModuleOperationEntry,\n  ViewDef,\n  RawViewsDocument,\n  RawViewEntry,\n  ParameterDef,\n  IpcContext,\n  WoodMiddlewareContext,\n  WoodMiddlewareFn,\n  RequestData,\n  ControllerArgs,\n  LoaderResult,\n  BridgeMessage,\n  BridgeRequest,\n  BridgeResponse,\n  BridgeReady,\n  BridgePush,\n  BridgeElectronApi,\n  SerializedError,\n  ContextMenuContext,\n  ContextMenuItem,\n  ContextMenuEvent,\n} from './types/index.js';\n\n// Errors\nexport { WoodAuthError, WoodValidationError, BackendRestartingError } from './types/index.js';\n\n// Config\nexport {\n  parseConfig,\n  resolveRendererTraceBatching,\n  RENDERER_TRACE_BATCHING_DEFAULTS,\n} from './config/index.js';\nexport type { ObservabilityConfig, RendererTraceBatchingConfig } from './config/index.js';\n\n// Parsers\nexport { parseOperations, parseOperationsDocument, parseOperationsFile } from './parser/index.js';\nexport { parseViews, parseViewsFile } from './parser/index.js';\n\n// Router\nexport { WoodRouter } from './router/index.js';\n\n// Validation\nexport { SchemaValidator } from './validation/index.js';\n\n// Middleware\nexport { MiddlewareResolver, buildMiddlewareContext, executeMiddleware } from './middleware/index.js';\n\n// Controller\nexport { ControllerResolver, buildControllerArgs, buildOperationContext, usesOperationContext, disposeControllerLifecycle } from './controller/index.js';\nexport type { ControllerLifecycle } from './controller/index.js';\n\n// Codegen\nexport { generatePreload } from './codegen/index.js';\nexport { generateTypes } from './codegen/index.js';\nexport { generateChannelMap } from './codegen/index.js';\nexport { generateTestMock } from './codegen/index.js';\nexport { generateControllerRegistration } from './codegen/index.js';\nexport type { ControllerRegistrationOptions } from './codegen/index.js';\nexport { generateRuntime } from './codegen/index.js';\nexport type { RuntimeGeneratorOptions } from './codegen/index.js';\nexport { generateRendererViewManifest } from './codegen/index.js';\nexport type { RendererViewManifestGeneratorOptions } from './codegen/index.js';\nexport { generateRendererControllerRegistration } from './codegen/index.js';\nexport type { RendererControllerRegistrationOptions } from './codegen/index.js';\nexport { generateRendererApp } from './codegen/index.js';\nexport type { RendererAppGeneratorOptions } from './codegen/index.js';\n\n// Window\nexport { WindowManager, WindowStateStore } from './window/index.js';\nexport type { ScreenLike, WindowBounds } from './window/index.js';\n\n// Loader\nexport { LoaderRunner } from './loader/index.js';\n\n// Bridge\nexport { BackendBridge, startBackendLoop, pushEvent } from './bridge/index.js';\n\n// Dev metadata (lightweight; safe at runtime)\n// Heavy dev tooling (WoodDevServer, BackendWatcher, YamlWatcher,\n// EsbuildBackend) is available via the '@noego/wood/dev' subpath only,\n// so production consumers never load esbuild/chokidar.\nexport {\n  DEFAULT_WOOD_REMOTE_DEBUGGING_PORT,\n  WOOD_DEV_DIRECTORY,\n  WOOD_DEV_METADATA_BASENAME,\n  resolveWoodRemoteDebuggingPort,\n  resolveWoodDevDirectory,\n  resolveWoodDevMetadataPath,\n  writeWoodDevMetadata,\n  readWoodDevMetadata,\n  removeWoodDevMetadata,\n} from './dev/dev_metadata.js';\nexport type { WoodDevMetadata } from './dev/dev_metadata.js';\n\n// Runtime\nexport {\n  createWoodRoot,\n  getContainer,\n  clearContainerRegistryForTests,\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n  clearRendererTraceBatchReceiverForTests,\n  getRendererTraceBatchReceiver,\n  runtime,\n  setRendererTraceBatchReceiver,\n} from './runtime/index.js';\nexport type {\n  GetContainerOptions,\n  RuntimeOptions,\n  RuntimeResult,\n  RegisterRuntimeRouter,\n} from './runtime/index.js';\n\n// Navigation\nexport { Navigation, getNavigation, go, goto, goback } from './navigation/index.js';\nexport type { NavigationEntry, NavigationOptions } from './navigation/index.js';\n\n// Isomorphic IPC API\nexport { Ipc, getIpc } from './ipc/index.js';\nexport type { IpcPushOptions } from './ipc/index.js';\n\n// Tracing\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\n  TraceCommitWriter,\n  clearTraceHubForTests,\n  getTraceEvents$,\n  getTraceProducerId,\n  ingestRemoteTraceEvent,\n  publishMainTrace,\n  publishTestTrace,\n  registerTraceSink,\n  setRendererTraceEnabled,\n  setRendererTraceTransport,\n  woodBatchToTraceBatch,\n  WoodTraceBatchContract,\n} from './tracing/index.js';\nexport type { WoodTraceBatchConversion } from './tracing/index.js';\nexport type {\n  TraceCommitRow,\n  TraceCommitWriterOptions,\n  TraceFlushOptions,\n  TraceFlushResult,\n  WoodTracePersistencePort,\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceLevel,\n  TraceProcess,\n  TraceProviderMode,\n  TraceRuntimeContext,\n  TraceRuntime,\n  TraceWaitOptions,\n  WoodRendererTraceEvent,\n  WoodRendererTraceInput,\n  WoodTraceBatch,\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchReceiver,\n  WoodTraceBatchRuntimeContext,\n  WoodTraceEventSink,\n  WoodTraceEventSnapshot,\n  WoodTraceSinkDisposer,\n} from './tracing/index.js';\n\n// Testing — available via '@noego/wood/testing' subpath export.\n// Not re-exported here to avoid pulling vitest into production builds.\n"],"mappings":"AAoCA,SAAS,eAAe,qBAAqB,8BAA8B;AAG3E;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP,SAAS,iBAAiB,yBAAyB,2BAA2B;AAC9E,SAAS,YAAY,sBAAsB;AAG3C,SAAS,kBAAkB;AAG3B,SAAS,uBAAuB;AAGhC,SAAS,oBAAoB,wBAAwB,yBAAyB;AAG9E,SAAS,oBAAoB,qBAAqB,uBAAuB,sBAAsB,kCAAkC;AAIjI,SAAS,uBAAuB;AAChC,SAAS,qBAAqB;AAC9B,SAAS,0BAA0B;AACnC,SAAS,wBAAwB;AACjC,SAAS,sCAAsC;AAE/C,SAAS,uBAAuB;AAEhC,SAAS,oCAAoC;AAE7C,SAAS,8CAA8C;AAEvD,SAAS,2BAA2B;AAIpC,SAAS,eAAe,wBAAwB;AAIhD,SAAS,oBAAoB;AAG7B,SAAS,eAAe,kBAAkB,iBAAiB;AAM3D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,YAAY,eAAe,IAAI,MAAM,cAAc;AAI5D,SAAS,KAAK,cAAc;AAI5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @noego/wood — Declarative Electron desktop apps using the noego ecosystem\n\n// Types\nexport type {\n  WoodConfig,\n  WindowDef,\n  DevConfig,\n  ElectronBuilderConfig,\n  OperationDef,\n  RawOperationsDocument,\n  RawModuleDef,\n  RawOperationEntry,\n  RawModuleOperationEntry,\n  ViewDef,\n  RawViewsDocument,\n  RawViewEntry,\n  ParameterDef,\n  IpcContext,\n  WoodMiddlewareContext,\n  WoodMiddlewareFn,\n  RequestData,\n  ControllerArgs,\n  LoaderResult,\n  BridgeMessage,\n  BridgeRequest,\n  BridgeResponse,\n  BridgeReady,\n  BridgePush,\n  BridgeElectronApi,\n  SerializedError,\n  ContextMenuContext,\n  ContextMenuItem,\n  ContextMenuEvent,\n} from './types/index.js';\n\n// Errors\nexport { WoodAuthError, WoodValidationError, BackendRestartingError } from './types/index.js';\n\n// Config\nexport {\n  parseConfig,\n  resolveRendererTraceBatching,\n  RENDERER_TRACE_BATCHING_DEFAULTS,\n} from './config/index.js';\nexport type { ObservabilityConfig, RendererTraceBatchingConfig } from './config/index.js';\n\n// Parsers\nexport { parseOperations, parseOperationsDocument, parseOperationsFile } from './parser/index.js';\nexport { parseViews, parseViewsFile } from './parser/index.js';\n\n// Router\nexport { WoodRouter } from './router/index.js';\n\n// Validation\nexport { SchemaValidator } from './validation/index.js';\n\n// Middleware\nexport { MiddlewareResolver, buildMiddlewareContext, executeMiddleware } from './middleware/index.js';\n\n// Controller\nexport { ControllerResolver, buildControllerArgs, buildOperationContext, usesOperationContext, disposeControllerLifecycle } from './controller/index.js';\nexport type { ControllerLifecycle } from './controller/index.js';\n\n// Codegen\nexport { generatePreload } from './codegen/index.js';\nexport { generateTypes } from './codegen/index.js';\nexport { generateChannelMap } from './codegen/index.js';\nexport { generateTestMock } from './codegen/index.js';\nexport { generateControllerRegistration } from './codegen/index.js';\nexport type { ControllerRegistrationOptions } from './codegen/index.js';\nexport { generateRuntime } from './codegen/index.js';\nexport type { RuntimeGeneratorOptions } from './codegen/index.js';\nexport { generateRendererViewManifest } from './codegen/index.js';\nexport type { RendererViewManifestGeneratorOptions } from './codegen/index.js';\nexport { generateRendererControllerRegistration } from './codegen/index.js';\nexport type { RendererControllerRegistrationOptions } from './codegen/index.js';\nexport { generateRendererApp } from './codegen/index.js';\nexport type { RendererAppGeneratorOptions } from './codegen/index.js';\n\n// Window\nexport { WindowManager, WindowStateStore } from './window/index.js';\nexport type { ScreenLike, WindowBounds } from './window/index.js';\n\n// Loader\nexport { LoaderRunner } from './loader/index.js';\n\n// Bridge\nexport { BackendBridge, startBackendLoop, pushEvent } from './bridge/index.js';\n\n// Dev metadata (lightweight; safe at runtime)\n// Heavy dev tooling (WoodDevServer, BackendWatcher, YamlWatcher,\n// EsbuildBackend) is available via the '@noego/wood/dev' subpath only,\n// so production consumers never load esbuild/chokidar.\nexport {\n  DEFAULT_WOOD_REMOTE_DEBUGGING_PORT,\n  WOOD_DEV_DIRECTORY,\n  WOOD_DEV_METADATA_BASENAME,\n  resolveWoodRemoteDebuggingPort,\n  resolveWoodDevDirectory,\n  resolveWoodDevMetadataPath,\n  writeWoodDevMetadata,\n  readWoodDevMetadata,\n  removeWoodDevMetadata,\n} from './dev/dev_metadata.js';\nexport type { WoodDevMetadata } from './dev/dev_metadata.js';\n\n// Runtime\nexport {\n  createWoodRoot,\n  getContainer,\n  clearContainerRegistryForTests,\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n  clearRendererTraceBatchReceiverForTests,\n  getRendererTraceBatchReceiver,\n  runtime,\n  setRendererTraceBatchReceiver,\n} from './runtime/index.js';\nexport type {\n  GetContainerOptions,\n  RuntimeOptions,\n  RuntimeResult,\n  RegisterRuntimeRouter,\n} from './runtime/index.js';\n\n// Navigation\nexport { Navigation, getNavigation, go, goto, goback } from './navigation/index.js';\nexport type { NavigationEntry, NavigationOptions } from './navigation/index.js';\n\n// Isomorphic IPC API\nexport { Ipc, getIpc } from './ipc/index.js';\nexport type { IpcPushOptions } from './ipc/index.js';\n\n// Tracing\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\n  TraceCommitWriter,\n  clearTraceHubForTests,\n  getTraceEvents$,\n  getTraceProducerId,\n  ingestRemoteTraceEvent,\n  publishMainTrace,\n  publishTestTrace,\n  registerTraceSink,\n  setRendererTraceEnabled,\n  setRendererTraceTransport,\n  woodBatchToTraceBatch,\n  WoodTraceBatchContract,\n} from './tracing/index.js';\nexport type { WoodTraceBatchConversion } from './tracing/index.js';\nexport type {\n  TraceCommitRow,\n  TraceCommitWriterOptions,\n  TraceFlushOptions,\n  TraceFlushResult,\n  WoodTracePersistencePort,\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceLevel,\n  TraceProcess,\n  TraceProviderMode,\n  TraceRuntimeContext,\n  TraceRuntime,\n  TraceWaitOptions,\n  WoodRendererTraceEvent,\n  WoodRendererTraceInput,\n  WoodTraceBatch,\n  WoodTraceBatchAcknowledgement,\n  WoodTraceBatchReceiver,\n  WoodTraceBatchRuntimeContext,\n  WoodTraceEventSink,\n  WoodTraceEventSnapshot,\n  WoodTraceSinkDisposer,\n} from './tracing/index.js';\n\n// Testing facade — production-safe: records the builder here and loads the\n// '@noego/wood/testing' implementation (DOM, Playwright, Electron mocks)\n// only inside build(). Compatibility helpers stay on the subpath export.\nexport { testWood, WoodTestBuilder } from './test-wood.js';\nexport type { WoodTestSelection } from './test-wood.js';\nexport type { TestWoodEnvironment, WoodDomMode } from './testing/index.js';\nexport type { WoodTestApi, WoodTestRawApi } from './testing-api.js';\n\nexport type { WoodBrowserHost, NativeWoodPage, NativeWoodTestEnvironment, WoodTestEnvironmentFor, WoodBrowserOpenOptions } from './testing/native_browser/native_browser.types.js';\n"],"mappings":"AAoCA,SAAS,eAAe,qBAAqB,8BAA8B;AAG3E;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP,SAAS,iBAAiB,yBAAyB,2BAA2B;AAC9E,SAAS,YAAY,sBAAsB;AAG3C,SAAS,kBAAkB;AAG3B,SAAS,uBAAuB;AAGhC,SAAS,oBAAoB,wBAAwB,yBAAyB;AAG9E,SAAS,oBAAoB,qBAAqB,uBAAuB,sBAAsB,kCAAkC;AAIjI,SAAS,uBAAuB;AAChC,SAAS,qBAAqB;AAC9B,SAAS,0BAA0B;AACnC,SAAS,wBAAwB;AACjC,SAAS,sCAAsC;AAE/C,SAAS,uBAAuB;AAEhC,SAAS,oCAAoC;AAE7C,SAAS,8CAA8C;AAEvD,SAAS,2BAA2B;AAIpC,SAAS,eAAe,wBAAwB;AAIhD,SAAS,oBAAoB;AAG7B,SAAS,eAAe,kBAAkB,iBAAiB;AAM3D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,YAAY,eAAe,IAAI,MAAM,cAAc;AAI5D,SAAS,KAAK,cAAc;AAI5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AA+BP,SAAS,UAAU,uBAAuB;","names":[]}

package/dist/loader/index.cjs

@@ -18,12 +18,29 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var loader_exports = {};
 __export(loader_exports, {
-  LoaderRunner: () => import_loader_runner.LoaderRunner
+  LOADER_COMPANION_SUFFIXES: () => import_loader_orchestration.LOADER_COMPANION_SUFFIXES,
+  LoaderRunner: () => import_loader_runner.LoaderRunner,
+  NO_LOADERS: () => import_loader_orchestration.NO_LOADERS,
+  assertDataLoader: () => import_loader_orchestration.assertDataLoader,
+  createLoaderRequest: () => import_loader_orchestration.createLoaderRequest,
+  initializeArgument: () => import_loader_orchestration.initializeArgument,
+  initializeController: () => import_loader_orchestration.initializeController,
+  loaderCompanionCandidates: () => import_loader_orchestration.loaderCompanionCandidates,
+  runViewLoaders: () => import_loader_orchestration.runViewLoaders
 });
 module.exports = __toCommonJS(loader_exports);
 var import_loader_runner = require("./loader_runner.cjs");
+var import_loader_orchestration = require("./loader_orchestration.cjs");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  LoaderRunner
+  LOADER_COMPANION_SUFFIXES,
+  LoaderRunner,
+  NO_LOADERS,
+  assertDataLoader,
+  createLoaderRequest,
+  initializeArgument,
+  initializeController,
+  loaderCompanionCandidates,
+  runViewLoaders
 });
 //# sourceMappingURL=index.cjs.map

package/dist/loader/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/loader/index.ts"],"sourcesContent":["export { LoaderRunner } from './loader_runner.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,2BAA6B;","names":[]}
+{"version":3,"sources":["../../src/loader/index.ts"],"sourcesContent":["export { LoaderRunner } from './loader_runner.cjs';\nexport {\n  assertDataLoader,\n  createLoaderRequest,\n  initializeArgument,\n  initializeController,\n  loaderCompanionCandidates,\n  LOADER_COMPANION_SUFFIXES,\n  NO_LOADERS,\n  runViewLoaders,\n} from './loader_orchestration.cjs';\nexport type {\n  DataLoader,\n  LoadedData,\n  RouteInput,\n  ViewLoaderResult,\n  ViewLoaderSet,\n} from './loader_orchestration.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,2BAA6B;AAC7B,kCASO;","names":[]}

package/dist/loader/index.d.cts

@@ -1,3 +1,4 @@
 export { LoaderRunner } from './loader_runner.cjs';
+export { DataLoader, LOADER_COMPANION_SUFFIXES, LoadedData, NO_LOADERS, RouteInput, ViewLoaderResult, ViewLoaderSet, assertDataLoader, createLoaderRequest, initializeArgument, initializeController, loaderCompanionCandidates, runViewLoaders } from './loader_orchestration.cjs';
 import '../types/context.cjs';
 import '../types/views.cjs';

package/dist/loader/index.d.ts

@@ -1,3 +1,4 @@
 export { LoaderRunner } from './loader_runner.js';
+export { DataLoader, LOADER_COMPANION_SUFFIXES, LoadedData, NO_LOADERS, RouteInput, ViewLoaderResult, ViewLoaderSet, assertDataLoader, createLoaderRequest, initializeArgument, initializeController, loaderCompanionCandidates, runViewLoaders } from './loader_orchestration.js';
 import '../types/context.js';
 import '../types/views.js';

package/dist/loader/index.js

@@ -1,5 +1,23 @@
 import { LoaderRunner } from "./loader_runner.js";
+import {
+  assertDataLoader,
+  createLoaderRequest,
+  initializeArgument,
+  initializeController,
+  loaderCompanionCandidates,
+  LOADER_COMPANION_SUFFIXES,
+  NO_LOADERS,
+  runViewLoaders
+} from "./loader_orchestration.js";
 export {
-  LoaderRunner
+  LOADER_COMPANION_SUFFIXES,
+  LoaderRunner,
+  NO_LOADERS,
+  assertDataLoader,
+  createLoaderRequest,
+  initializeArgument,
+  initializeController,
+  loaderCompanionCandidates,
+  runViewLoaders
 };
 //# sourceMappingURL=index.js.map

package/dist/loader/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/loader/index.ts"],"sourcesContent":["export { LoaderRunner } from './loader_runner.js';\n"],"mappings":"AAAA,SAAS,oBAAoB;","names":[]}
+{"version":3,"sources":["../../src/loader/index.ts"],"sourcesContent":["export { LoaderRunner } from './loader_runner.js';\nexport {\n  assertDataLoader,\n  createLoaderRequest,\n  initializeArgument,\n  initializeController,\n  loaderCompanionCandidates,\n  LOADER_COMPANION_SUFFIXES,\n  NO_LOADERS,\n  runViewLoaders,\n} from './loader_orchestration.js';\nexport type {\n  DataLoader,\n  LoadedData,\n  RouteInput,\n  ViewLoaderResult,\n  ViewLoaderSet,\n} from './loader_orchestration.js';\n"],"mappings":"AAAA,SAAS,oBAAoB;AAC7B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/loader/loader_orchestration.cjs

@@ -0,0 +1,82 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var loader_orchestration_exports = {};
+__export(loader_orchestration_exports, {
+  LOADER_COMPANION_SUFFIXES: () => LOADER_COMPANION_SUFFIXES,
+  NO_LOADERS: () => NO_LOADERS,
+  assertDataLoader: () => assertDataLoader,
+  createLoaderRequest: () => createLoaderRequest,
+  initializeArgument: () => initializeArgument,
+  initializeController: () => initializeController,
+  loaderCompanionCandidates: () => loaderCompanionCandidates,
+  runViewLoaders: () => runViewLoaders
+});
+module.exports = __toCommonJS(loader_orchestration_exports);
+const LOADER_COMPANION_SUFFIXES = [".load.ts", ".load.js"];
+function loaderCompanionCandidates(viewPath) {
+  if (!/\.svelte$/.test(viewPath)) return [];
+  const base = viewPath.replace(/\.svelte$/, "");
+  return LOADER_COMPANION_SUFFIXES.map((suffix) => base + suffix);
+}
+const NO_LOADERS = Object.freeze({ layouts: Object.freeze([]), view: null });
+function createLoaderRequest(page, route) {
+  return {
+    url: page,
+    params: { ...route.params },
+    query: { ...route.query },
+    context: {},
+    headers: {}
+  };
+}
+function assertDataLoader(value, label) {
+  if (typeof value !== "function") {
+    throw new TypeError(`${label} must default-export a loader function (request) => data`);
+  }
+  return value;
+}
+async function runViewLoaders(set, request, preservedDepth = 0) {
+  const layouts = [];
+  for (let index = 0; index < set.layouts.length; index += 1) {
+    const loader = index < preservedDepth ? null : set.layouts[index];
+    layouts.push(loader ? { data: await loader(request) } : null);
+  }
+  const view = set.view ? { data: await set.view(request) } : null;
+  return { layouts, view };
+}
+function initializeArgument(route, loaded) {
+  const base = { params: route.params, query: route.query };
+  return loaded ? { ...base, data: loaded.data } : base;
+}
+async function initializeController(controller, argument) {
+  const initialize = controller?.initialize;
+  if (typeof initialize !== "function") return;
+  await initialize.call(controller, argument);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LOADER_COMPANION_SUFFIXES,
+  NO_LOADERS,
+  assertDataLoader,
+  createLoaderRequest,
+  initializeArgument,
+  initializeController,
+  loaderCompanionCandidates,
+  runViewLoaders
+});
+//# sourceMappingURL=loader_orchestration.cjs.map

package/dist/loader/loader_orchestration.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/loader/loader_orchestration.ts"],"sourcesContent":["/**\n * Shared page/layout data-loader orchestration.\n *\n * One implementation, three callers: the generated production renderer app\n * (`createControllerSet`), the Node frontend application surface\n * (`constructPage`) and the main-process `LoaderRunner`. It is deliberately\n * free of Node APIs so it ships to the browser through `@noego/wood/navigation`.\n *\n * Convention: a view `pages/chat.svelte` MAY have a companion loader\n * `pages/chat.load.ts` whose DEFAULT export is `(request: RequestData) =>\n * data`. Discovery (does the companion exist?) is a build-time concern of the\n * caller (codegen, the test config source, the runner); this module only\n * defines the companion identity and executes an already-resolved set:\n * layouts in stack order (outermost first), then the view. A layout carried\n * over from the previous page (`preservedDepth`) is never re-run.\n */\nimport type { RequestData } from '../types/context.cjs';\n\nexport type DataLoader = (request: RequestData) => unknown;\n\n/** Companion suffixes, in resolution order; more than one present is ambiguous. */\nexport const LOADER_COMPANION_SUFFIXES = ['.load.ts', '.load.js'] as const;\n\n/** The companion loader candidates for a `.svelte` view path (empty for other files). */\nexport function loaderCompanionCandidates(viewPath: string): string[] {\n  if (!/\\.svelte$/.test(viewPath)) return [];\n  const base = viewPath.replace(/\\.svelte$/, '');\n  return LOADER_COMPANION_SUFFIXES.map((suffix) => base + suffix);\n}\n\n/** Loaders resolved for one view: index-aligned with the layout stack; `null` = no loader. */\nexport interface ViewLoaderSet {\n  readonly layouts: ReadonlyArray<DataLoader | null>;\n  readonly view: DataLoader | null;\n}\n\n/** A loader ran and produced `data` (which may legitimately be `undefined`). */\nexport interface LoadedData {\n  readonly data: unknown;\n}\n\n/** Index-aligned outcome; `null` where no loader exists or the layout was preserved. */\nexport interface ViewLoaderResult {\n  readonly layouts: ReadonlyArray<LoadedData | null>;\n  readonly view: LoadedData | null;\n}\n\nexport interface RouteInput {\n  readonly params: Record<string, string>;\n  readonly query: Record<string, string>;\n}\n\nexport const NO_LOADERS: ViewLoaderSet = Object.freeze({ layouts: Object.freeze([]), view: null });\n\n/** The request a page/layout loader receives (`url` is the page identity). */\nexport function createLoaderRequest(page: string, route: RouteInput): RequestData {\n  return {\n    url: page,\n    params: { ...route.params },\n    query: { ...route.query },\n    context: {},\n    headers: {},\n  };\n}\n\n/** A loader module's default export must be a function; anything else is a source error. */\nexport function assertDataLoader(value: unknown, label: string): DataLoader {\n  if (typeof value !== 'function') {\n    throw new TypeError(`${label} must default-export a loader function (request) => data`);\n  }\n  return value as DataLoader;\n}\n\n/**\n * Execute a view's loaders: layouts from `preservedDepth` in stack order,\n * then the view. Any failure rejects — the caller owns rollback.\n */\nexport async function runViewLoaders(\n  set: ViewLoaderSet,\n  request: RequestData,\n  preservedDepth = 0,\n): Promise<ViewLoaderResult> {\n  const layouts: Array<LoadedData | null> = [];\n  for (let index = 0; index < set.layouts.length; index += 1) {\n    const loader = index < preservedDepth ? null : set.layouts[index];\n    layouts.push(loader ? { data: await loader(request) } : null);\n  }\n  const view = set.view ? { data: await set.view(request) } : null;\n  return { layouts, view };\n}\n\n/**\n * The argument a controller's `initialize()` receives: `{ params, query }`\n * exactly as before when the controller has no loader, plus `data` when one\n * ran for it.\n */\nexport function initializeArgument(\n  route: RouteInput,\n  loaded: LoadedData | null | undefined,\n): { params: Record<string, string>; query: Record<string, string>; data?: unknown } {\n  const base = { params: route.params, query: route.query };\n  return loaded ? { ...base, data: loaded.data } : base;\n}\n\n/** Call `initialize(argument)` when the controller declares one. */\nexport async function initializeController(controller: unknown, argument: unknown): Promise<void> {\n  const initialize = (controller as { initialize?: unknown } | null)?.initialize;\n  if (typeof initialize !== 'function') return;\n  await (initialize as (argument: unknown) => unknown).call(controller, argument);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqBO,MAAM,4BAA4B,CAAC,YAAY,UAAU;AAGzD,SAAS,0BAA0B,UAA4B;AACpE,MAAI,CAAC,YAAY,KAAK,QAAQ,EAAG,QAAO,CAAC;AACzC,QAAM,OAAO,SAAS,QAAQ,aAAa,EAAE;AAC7C,SAAO,0BAA0B,IAAI,CAAC,WAAW,OAAO,MAAM;AAChE;AAwBO,MAAM,aAA4B,OAAO,OAAO,EAAE,SAAS,OAAO,OAAO,CAAC,CAAC,GAAG,MAAM,KAAK,CAAC;AAG1F,SAAS,oBAAoB,MAAc,OAAgC;AAChF,SAAO;AAAA,IACL,KAAK;AAAA,IACL,QAAQ,EAAE,GAAG,MAAM,OAAO;AAAA,IAC1B,OAAO,EAAE,GAAG,MAAM,MAAM;AAAA,IACxB,SAAS,CAAC;AAAA,IACV,SAAS,CAAC;AAAA,EACZ;AACF;AAGO,SAAS,iBAAiB,OAAgB,OAA2B;AAC1E,MAAI,OAAO,UAAU,YAAY;AAC/B,UAAM,IAAI,UAAU,GAAG,KAAK,0DAA0D;AAAA,EACxF;AACA,SAAO;AACT;AAMA,eAAsB,eACpB,KACA,SACA,iBAAiB,GACU;AAC3B,QAAM,UAAoC,CAAC;AAC3C,WAAS,QAAQ,GAAG,QAAQ,IAAI,QAAQ,QAAQ,SAAS,GAAG;AAC1D,UAAM,SAAS,QAAQ,iBAAiB,OAAO,IAAI,QAAQ,KAAK;AAChE,YAAQ,KAAK,SAAS,EAAE,MAAM,MAAM,OAAO,OAAO,EAAE,IAAI,IAAI;AAAA,EAC9D;AACA,QAAM,OAAO,IAAI,OAAO,EAAE,MAAM,MAAM,IAAI,KAAK,OAAO,EAAE,IAAI;AAC5D,SAAO,EAAE,SAAS,KAAK;AACzB;AAOO,SAAS,mBACd,OACA,QACmF;AACnF,QAAM,OAAO,EAAE,QAAQ,MAAM,QAAQ,OAAO,MAAM,MAAM;AACxD,SAAO,SAAS,EAAE,GAAG,MAAM,MAAM,OAAO,KAAK,IAAI;AACnD;AAGA,eAAsB,qBAAqB,YAAqB,UAAkC;AAChG,QAAM,aAAc,YAAgD;AACpE,MAAI,OAAO,eAAe,WAAY;AACtC,QAAO,WAA8C,KAAK,YAAY,QAAQ;AAChF;","names":[]}

package/dist/loader/loader_orchestration.d.cts

@@ -0,0 +1,66 @@
+import { RequestData } from '../types/context.cjs';
+
+/**
+ * Shared page/layout data-loader orchestration.
+ *
+ * One implementation, three callers: the generated production renderer app
+ * (`createControllerSet`), the Node frontend application surface
+ * (`constructPage`) and the main-process `LoaderRunner`. It is deliberately
+ * free of Node APIs so it ships to the browser through `@noego/wood/navigation`.
+ *
+ * Convention: a view `pages/chat.svelte` MAY have a companion loader
+ * `pages/chat.load.ts` whose DEFAULT export is `(request: RequestData) =>
+ * data`. Discovery (does the companion exist?) is a build-time concern of the
+ * caller (codegen, the test config source, the runner); this module only
+ * defines the companion identity and executes an already-resolved set:
+ * layouts in stack order (outermost first), then the view. A layout carried
+ * over from the previous page (`preservedDepth`) is never re-run.
+ */
+
+type DataLoader = (request: RequestData) => unknown;
+/** Companion suffixes, in resolution order; more than one present is ambiguous. */
+declare const LOADER_COMPANION_SUFFIXES: readonly [".load.ts", ".load.js"];
+/** The companion loader candidates for a `.svelte` view path (empty for other files). */
+declare function loaderCompanionCandidates(viewPath: string): string[];
+/** Loaders resolved for one view: index-aligned with the layout stack; `null` = no loader. */
+interface ViewLoaderSet {
+    readonly layouts: ReadonlyArray<DataLoader | null>;
+    readonly view: DataLoader | null;
+}
+/** A loader ran and produced `data` (which may legitimately be `undefined`). */
+interface LoadedData {
+    readonly data: unknown;
+}
+/** Index-aligned outcome; `null` where no loader exists or the layout was preserved. */
+interface ViewLoaderResult {
+    readonly layouts: ReadonlyArray<LoadedData | null>;
+    readonly view: LoadedData | null;
+}
+interface RouteInput {
+    readonly params: Record<string, string>;
+    readonly query: Record<string, string>;
+}
+declare const NO_LOADERS: ViewLoaderSet;
+/** The request a page/layout loader receives (`url` is the page identity). */
+declare function createLoaderRequest(page: string, route: RouteInput): RequestData;
+/** A loader module's default export must be a function; anything else is a source error. */
+declare function assertDataLoader(value: unknown, label: string): DataLoader;
+/**
+ * Execute a view's loaders: layouts from `preservedDepth` in stack order,
+ * then the view. Any failure rejects — the caller owns rollback.
+ */
+declare function runViewLoaders(set: ViewLoaderSet, request: RequestData, preservedDepth?: number): Promise<ViewLoaderResult>;
+/**
+ * The argument a controller's `initialize()` receives: `{ params, query }`
+ * exactly as before when the controller has no loader, plus `data` when one
+ * ran for it.
+ */
+declare function initializeArgument(route: RouteInput, loaded: LoadedData | null | undefined): {
+    params: Record<string, string>;
+    query: Record<string, string>;
+    data?: unknown;
+};
+/** Call `initialize(argument)` when the controller declares one. */
+declare function initializeController(controller: unknown, argument: unknown): Promise<void>;
+
+export { type DataLoader, LOADER_COMPANION_SUFFIXES, type LoadedData, NO_LOADERS, type RouteInput, type ViewLoaderResult, type ViewLoaderSet, assertDataLoader, createLoaderRequest, initializeArgument, initializeController, loaderCompanionCandidates, runViewLoaders };