@noego/wood 0.5.0 → 0.6.0

package/dist/frontend/frontend_surface.cjs.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 { disposeControllerLifecycle } from '../controller/controller_lifecycle.js';\nimport type { ViewDef } from '../types/index.cjs';\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\n/**\n * Make a controller's production teardown hook run at most once.\n *\n * Two owners legitimately end a controller: this surface (production\n * parity — the renderer's NavigationShell calls the hook explicitly, and\n * for a Transient controller that is the ONLY call) and IoC scope\n * disposal (which calls `dispose()`/`destroy()` on the scoped instances it\n * owns). Shadowing the hook with a once-guard means a controller sees the\n * same single teardown whichever way it was registered.\n */\nfunction guardControllerLifecycleOnce(instance: unknown): void {\n  if (!instance || typeof instance !== 'object') return;\n  const target = instance as Record<string, unknown>;\n  for (const hook of ['dispose', 'destroy'] as const) {\n    const original = target[hook];\n    if (typeof original !== 'function') continue;\n    if (Object.prototype.hasOwnProperty.call(target, hook)) continue;\n    let called = false;\n    Object.defineProperty(target, hook, {\n      configurable: true,\n      writable: true,\n      enumerable: false,\n      value: function guarded(this: unknown, ...args: unknown[]) {\n        if (called) return undefined;\n        called = true;\n        return (original as (...rest: unknown[]) => unknown).apply(this, args);\n      },\n    });\n  }\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\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    // 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 options.configurePageScope?.(scope, view, {\n      kind: 'page',\n      controller: view.controller,\n    });\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        ownScope.registerFunction?.(FrontendLifecycleOwner, () => ownLifecycle!, { loadAs: LoadAs.Scoped });\n        await 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      guardControllerLifecycleOnce(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    guardControllerLifecycleOnce(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  }\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    await disposeControllerLifecycle(page.controller);\n    for (const layout of page.layouts) {\n      if (layout.index < preservedDepth) continue;\n      await disposeControllerLifecycle(layout.instance);\n    }\n    await page.lifecycle.dispose();\n    // Page scope first, then dropped preserved layouts — production's\n    // disposeControllerSet order (view controller, then layouts).\n    if (typeof page.scope.dispose === 'function') {\n      await page.scope.dispose();\n    }\n    for (const layout of page.layouts) {\n      if (layout.index < preservedDepth) continue;\n      await layout.ownLifecycle?.dispose();\n      if (layout.ownScope && typeof layout.ownScope.dispose === 'function') {\n        await layout.ownScope.dispose();\n      }\n    }\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    // 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    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  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    registry.track(transitionTo(entry), {\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 (!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        active = await constructPage(view, params, query);\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      await 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    async dispose(): Promise<void> {\n      if (disposed) return;\n      disposed = true;\n      if (active) {\n        const ended = active;\n        active = null;\n        // Environment teardown ends everything, preserved layouts included.\n        await endPage(ended);\n      }\n      await application.dispose();\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 { cleanupAll } from '../controller/cleanup.js';\nimport { disposeControllerLifecycle, guardControllerLifecycleOnce } from '../controller/controller_lifecycle.js';\nimport type { ViewDef } from '../types/index.cjs';\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":[]}

package/dist/frontend/frontend_surface.js

@@ -1,6 +1,7 @@
 import { ExecutionContext, LoadAs } from "@noego/ioc";
 import { computePreservedLayoutDepth } from "../navigation/layout_preservation.js";
-import { disposeControllerLifecycle } from "../controller/controller_lifecycle.js";
+import { cleanupAll } from "../controller/cleanup.js";
+import { disposeControllerLifecycle, guardControllerLifecycleOnce } from "../controller/controller_lifecycle.js";
 import { PageCatalogError, pageIdentity } from "./page_catalog.js";
 import { FrontendWorkError } from "./work_registry.js";
 import { FrontendLifecycleOwner } from "./frontend_lifecycle.js";
@@ -10,26 +11,6 @@ function registerControllerUnlessBound(scope, ControllerClass) {
   if (typeof registrable.isRegistered === "function" && registrable.isRegistered(ControllerClass)) return;
   if (typeof scope.registerClass === "function") scope.registerClass(ControllerClass);
 }
-function guardControllerLifecycleOnce(instance) {
-  if (!instance || typeof instance !== "object") return;
-  const target = instance;
-  for (const hook of ["dispose", "destroy"]) {
-    const original = target[hook];
-    if (typeof original !== "function") continue;
-    if (Object.prototype.hasOwnProperty.call(target, hook)) continue;
-    let called = false;
-    Object.defineProperty(target, hook, {
-      configurable: true,
-      writable: true,
-      enumerable: false,
-      value: function guarded(...args) {
-        if (called) return void 0;
-        called = true;
-        return original.apply(this, args);
-      }
-    });
-  }
-}
 function createFrontendSurface(options) {
   const { catalog, rendererRoot, registry, navigation } = options;
   const flushHooks = options.flushHooks ?? [];
@@ -37,6 +18,16 @@ function createFrontendSurface(options) {
   let active = null;
   let transitioning = false;
   let disposed = false;
+  let navigationQueue = Promise.resolve();
+  let closing;
+  const retainedPageScopes = /* @__PURE__ */ new Map();
+  const locallyOwnedControllers = /* @__PURE__ */ new WeakSet();
+  const markController = (instance, token) => {
+    const root = rendererRoot;
+    if (!root.isRegistered?.(token) && instance && typeof instance === "object") locallyOwnedControllers.add(instance);
+    guardControllerLifecycleOnce(instance);
+  };
+  const disposeLocalController = (instance) => instance && typeof instance === "object" && locallyOwnedControllers.has(instance) ? disposeControllerLifecycle(instance) : Promise.resolve();
   const currentOwner = () => active ? `page ${active.identity}` : "application";
   async function constructPage(view, params, query, preserved = []) {
     const identity = pageIdentity(view);
@@ -48,91 +39,111 @@ function createFrontendSurface(options) {
     const ControllerClass = await options.resolveController(view.controller, view);
     const scope = rendererRoot.extend();
     const lifecycle = new FrontendLifecycleOwner(registry, `page ${identity}`);
-    scope.registerFunction?.(FrontendLifecycleOwner, () => lifecycle, { loadAs: LoadAs.Scoped });
-    await options.configurePageScope?.(scope, view, {
-      kind: "page",
-      controller: view.controller
-    });
-    registerControllerUnlessBound(scope, ControllerClass);
-    const layouts = [...preserved];
-    for (let index = preserved.length; index < view.layouts.length; index += 1) {
-      const layoutIdentity = view.layoutControllers?.[index];
-      if (!layoutIdentity) continue;
-      const preserve = view.layoutPreserve?.[index] === true;
-      const LayoutClass = await options.resolveController(layoutIdentity, view);
-      const ownScope = preserve ? rendererRoot.extend() : null;
-      const ownLifecycle = ownScope ? new FrontendLifecycleOwner(registry, `layout ${layoutIdentity}`) : null;
-      const layoutScope = ownScope ?? scope;
-      if (ownScope) {
-        ownScope.registerFunction?.(FrontendLifecycleOwner, () => ownLifecycle, { loadAs: LoadAs.Scoped });
-        await options.configurePageScope?.(ownScope, view, {
-          kind: "layout",
-          layoutIndex: index,
-          controller: layoutIdentity
+    const rollback = [
+      () => ExecutionContext.run(scope, () => scope.dispose?.()),
+      () => lifecycle.dispose()
+    ];
+    try {
+      scope.registerFunction?.(FrontendLifecycleOwner, () => lifecycle, { loadAs: LoadAs.Scoped });
+      await ExecutionContext.run(scope, () => options.configurePageScope?.(scope, view, { kind: "page", controller: view.controller }));
+      registerControllerUnlessBound(scope, ControllerClass);
+      const layouts = [...preserved];
+      for (let index = preserved.length; index < view.layouts.length; index += 1) {
+        const layoutIdentity = view.layoutControllers?.[index];
+        if (!layoutIdentity) continue;
+        const preserve = view.layoutPreserve?.[index] === true;
+        const LayoutClass = await options.resolveController(layoutIdentity, view);
+        const ownScope = preserve ? rendererRoot.extend() : null;
+        const ownLifecycle = ownScope ? new FrontendLifecycleOwner(registry, `layout ${layoutIdentity}`) : null;
+        const layoutScope = ownScope ?? scope;
+        if (ownScope) {
+          rollback.push(() => ExecutionContext.run(ownScope, () => ownScope.dispose?.()));
+          rollback.push(() => ownLifecycle.dispose());
+          ownScope.registerFunction?.(FrontendLifecycleOwner, () => ownLifecycle, { loadAs: LoadAs.Scoped });
+          await ExecutionContext.run(ownScope, () => options.configurePageScope?.(ownScope, view, {
+            kind: "layout",
+            layoutIndex: index,
+            controller: layoutIdentity
+          }));
+        }
+        registerControllerUnlessBound(layoutScope, LayoutClass);
+        const instance = await ExecutionContext.run(
+          layoutScope,
+          () => layoutScope.get(LayoutClass)
+        );
+        markController(instance, LayoutClass);
+        rollback.push(() => ExecutionContext.run(layoutScope, () => disposeLocalController(instance)));
+        layouts.push({
+          index,
+          path: view.layouts[index],
+          controller: layoutIdentity,
+          preserve,
+          instance,
+          scope: layoutScope,
+          ownScope,
+          ownLifecycle
         });
       }
-      registerControllerUnlessBound(layoutScope, LayoutClass);
-      const instance = await ExecutionContext.run(
-        layoutScope,
-        () => layoutScope.get(LayoutClass)
+      const controller = await ExecutionContext.run(
+        scope,
+        () => scope.get(ControllerClass)
       );
-      guardControllerLifecycleOnce(instance);
-      layouts.push({
-        index,
-        path: view.layouts[index],
-        controller: layoutIdentity,
-        preserve,
-        instance,
-        scope: layoutScope,
-        ownScope,
-        ownLifecycle
+      markController(controller, ControllerClass);
+      rollback.push(() => ExecutionContext.run(scope, () => disposeLocalController(controller)));
+      if (typeof controller.initialize === "function") {
+        await registry.track(
+          Promise.resolve(
+            ExecutionContext.run(
+              scope,
+              () => controller.initialize({ params, query })
+            )
+          ).then(() => void 0),
+          { label: `initialize ${identity}`, kind: "initialize", owner: `page ${identity}` }
+        );
+      }
+      const handle = createFrontendPage({
+        identity,
+        controller,
+        scope,
+        layouts,
+        onClose: async () => {
+          await disposePage(identity);
+        }
       });
-    }
-    const controller = await ExecutionContext.run(
-      scope,
-      () => scope.get(ControllerClass)
-    );
-    guardControllerLifecycleOnce(controller);
-    if (typeof controller.initialize === "function") {
-      await registry.track(
-        Promise.resolve(
-          ExecutionContext.run(
-            scope,
-            () => controller.initialize({ params, query })
-          )
-        ).then(() => void 0),
-        { label: `initialize ${identity}`, kind: "initialize", owner: `page ${identity}` }
-      );
-    }
-    const handle = createFrontendPage({
-      identity,
-      controller,
-      scope,
-      layouts,
-      onClose: async () => {
-        await disposePage(identity);
+      return { identity, view, scope, lifecycle, handle, controller, layouts };
+    } catch (error) {
+      try {
+        await cleanupAll(rollback.reverse(), "Wood page rollback failed");
+      } catch (cleanupError) {
+        throw Object.assign(new Error("Wood page construction and cleanup failed"), { cause: error, errors: [error, cleanupError] });
       }
-    });
-    return { identity, view, scope, lifecycle, handle, controller, layouts };
+      throw error;
+    }
   }
   async function endPage(page, preservedDepth = 0) {
     page.handle.invalidate();
-    await disposeControllerLifecycle(page.controller);
+    const steps = [
+      () => ExecutionContext.run(page.scope, () => disposeLocalController(page.controller))
+    ];
     for (const layout of page.layouts) {
       if (layout.index < preservedDepth) continue;
-      await disposeControllerLifecycle(layout.instance);
+      steps.push(() => ExecutionContext.run(layout.scope, () => disposeLocalController(layout.instance)));
+      steps.push(() => layout.ownLifecycle?.dispose());
+      if (layout.ownScope) steps.push(() => ExecutionContext.run(layout.ownScope, () => layout.ownScope.dispose?.()));
     }
-    await page.lifecycle.dispose();
-    if (typeof page.scope.dispose === "function") {
-      await page.scope.dispose();
+    const carriesPageScope = page.layouts.some((layout) => layout.index < preservedDepth && layout.scope === page.scope);
+    if (carriesPageScope) retainedPageScopes.set(page.scope, page.lifecycle);
+    else {
+      steps.push(() => page.lifecycle.dispose());
+      steps.push(() => ExecutionContext.run(page.scope, () => page.scope.dispose?.()));
     }
-    for (const layout of page.layouts) {
-      if (layout.index < preservedDepth) continue;
-      await layout.ownLifecycle?.dispose();
-      if (layout.ownScope && typeof layout.ownScope.dispose === "function") {
-        await layout.ownScope.dispose();
-      }
+    for (const [scope, lifecycle] of retainedPageScopes) {
+      if (active?.layouts.some((layout) => layout.scope === scope)) continue;
+      retainedPageScopes.delete(scope);
+      steps.push(() => lifecycle.dispose());
+      steps.push(() => ExecutionContext.run(scope, () => scope.dispose?.()));
     }
+    await cleanupAll(steps, "Wood page cleanup failed");
   }
   async function disposePage(identity) {
     if (!active || active.identity !== identity) return;
@@ -141,6 +152,7 @@ function createFrontendSurface(options) {
     await endPage(ended);
   }
   async function transitionTo(entry) {
+    if (disposed) return;
     const view = catalog.resolve(entry.page);
     const previous = active;
     const depth = previous ? computePreservedLayoutDepth(
@@ -150,16 +162,23 @@ function createFrontendSurface(options) {
     ) : 0;
     const carried = previous ? previous.layouts.filter((layout) => layout.index < depth) : [];
     const next = await constructPage(view, entry.params, entry.query, carried);
+    if (disposed) {
+      await endPage(next, depth);
+      return;
+    }
     active = next;
     if (previous) {
       await endPage(previous, depth);
     }
   }
-  navigation.subscribe((entry) => {
+  const unsubscribe = navigation.subscribe((entry) => {
     if (!entry || transitioning || disposed) return;
     if (active && entry.page === active.identity) return;
     if (!active) return;
-    registry.track(transitionTo(entry), {
+    const transition = navigationQueue.then(() => transitionTo(entry));
+    navigationQueue = transition.catch(() => {
+    });
+    registry.track(transition, {
       label: `navigate ${active.identity} -> ${entry.page}`,
       kind: "navigation",
       owner: currentOwner()
@@ -168,6 +187,7 @@ function createFrontendSurface(options) {
   return {
     navigation,
     async open(openOptions) {
+      if (disposed || transitioning) throw new PageCatalogError("Wood frontend is closed or opening a page");
       if (!openOptions || typeof openOptions.page !== "string" || !openOptions.page.length) {
         throw new PageCatalogError("frontend.open() requires an explicit { page } identity");
       }
@@ -182,7 +202,12 @@ function createFrontendSurface(options) {
       transitioning = true;
       try {
         navigation.replace(pageIdentity(view), params, query);
-        active = await constructPage(view, params, query);
+        const opened = await constructPage(view, params, query);
+        if (disposed) {
+          await endPage(opened);
+          throw new PageCatalogError("Wood frontend was disposed during page construction");
+        }
+        active = opened;
       } finally {
         transitioning = false;
       }
@@ -192,7 +217,7 @@ function createFrontendSurface(options) {
       return active ? active.handle.page : null;
     },
     async act(action) {
-      await registry.track(
+      void registry.track(
         Promise.resolve().then(() => action()).then(() => void 0),
         { label: "act()", kind: "tracked", owner: currentOwner() }
       ).catch(() => {
@@ -205,15 +230,16 @@ function createFrontendSurface(options) {
     get errors() {
       return registry.errors();
     },
-    async dispose() {
-      if (disposed) return;
+    dispose() {
+      if (closing) return closing;
       disposed = true;
-      if (active) {
-        const ended = active;
-        active = null;
-        await endPage(ended);
-      }
-      await application.dispose();
+      unsubscribe();
+      const ended = active;
+      active = null;
+      return closing = cleanupAll([
+        () => ended ? endPage(ended) : void 0,
+        () => application.dispose()
+      ], "Wood frontend cleanup failed");
     }
   };
 }

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 { disposeControllerLifecycle } 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\n/**\n * Make a controller's production teardown hook run at most once.\n *\n * Two owners legitimately end a controller: this surface (production\n * parity — the renderer's NavigationShell calls the hook explicitly, and\n * for a Transient controller that is the ONLY call) and IoC scope\n * disposal (which calls `dispose()`/`destroy()` on the scoped instances it\n * owns). Shadowing the hook with a once-guard means a controller sees the\n * same single teardown whichever way it was registered.\n */\nfunction guardControllerLifecycleOnce(instance: unknown): void {\n  if (!instance || typeof instance !== 'object') return;\n  const target = instance as Record<string, unknown>;\n  for (const hook of ['dispose', 'destroy'] as const) {\n    const original = target[hook];\n    if (typeof original !== 'function') continue;\n    if (Object.prototype.hasOwnProperty.call(target, hook)) continue;\n    let called = false;\n    Object.defineProperty(target, hook, {\n      configurable: true,\n      writable: true,\n      enumerable: false,\n      value: function guarded(this: unknown, ...args: unknown[]) {\n        if (called) return undefined;\n        called = true;\n        return (original as (...rest: unknown[]) => unknown).apply(this, args);\n      },\n    });\n  }\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\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    // 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 options.configurePageScope?.(scope, view, {\n      kind: 'page',\n      controller: view.controller,\n    });\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        ownScope.registerFunction?.(FrontendLifecycleOwner, () => ownLifecycle!, { loadAs: LoadAs.Scoped });\n        await 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      guardControllerLifecycleOnce(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    guardControllerLifecycleOnce(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  }\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    await disposeControllerLifecycle(page.controller);\n    for (const layout of page.layouts) {\n      if (layout.index < preservedDepth) continue;\n      await disposeControllerLifecycle(layout.instance);\n    }\n    await page.lifecycle.dispose();\n    // Page scope first, then dropped preserved layouts — production's\n    // disposeControllerSet order (view controller, then layouts).\n    if (typeof page.scope.dispose === 'function') {\n      await page.scope.dispose();\n    }\n    for (const layout of page.layouts) {\n      if (layout.index < preservedDepth) continue;\n      await layout.ownLifecycle?.dispose();\n      if (layout.ownScope && typeof layout.ownScope.dispose === 'function') {\n        await layout.ownScope.dispose();\n      }\n    }\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    // 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    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  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    registry.track(transitionTo(entry), {\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 (!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        active = await constructPage(view, params, query);\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      await 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    async dispose(): Promise<void> {\n      if (disposed) return;\n      disposed = true;\n      if (active) {\n        const ended = active;\n        active = null;\n        // Environment teardown ends everything, preserved layouts included.\n        await endPage(ended);\n      }\n      await application.dispose();\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 { 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":[]}