@noego/wood 0.5.0 → 0.6.0

package/dist/testing/wood_env_renderer.js

@@ -3,7 +3,6 @@ import { InProcessRouterTransport } from "../transport/in_process_router_transpo
 import { buildTransportBridge } from "../transport/build_transport_bridge.js";
 import { RouterBridgeEvents } from "./create_router_bridge.js";
 import { Navigation } from "../navigation/index.js";
-import { createWoodRoot } from "../runtime/get_container.js";
 import { WorkRegistry } from "../frontend/work_registry.js";
 import { TrackedTransport } from "../frontend/tracked_transport.js";
 import {
@@ -11,8 +10,15 @@ import {
 } from "../frontend/frontend_surface.js";
 import { TestWoodError, WOOD_FRONTEND_BRIDGE } from "./test_wood.js";
 import { importDefaultExport } from "./wood_config_source.js";
-function controllerLoader(source, importer) {
+import { leaseDomAnimation } from "./wood_dom_animation.js";
+import {
+  buildRecordedEnvironment,
+  cleanupAll,
+  TestWoodCleanupError
+} from "./registration_only_root.js";
+function controllerLoader(source, importer, preloaded) {
   const cache = /* @__PURE__ */ new Map();
+  for (const [identity, controller] of preloaded) cache.set(identity, Promise.resolve(controller));
   return (identity) => {
     let pending = cache.get(identity);
     if (!pending) {
@@ -48,11 +54,16 @@ class MountKeeper {
     this.host = host;
     this.mounted = null;
     this.mountedFor = null;
+    this.animation = null;
   }
   get target() {
     if (!this.mounted) throw new TestWoodError("no page is mounted; open(page) first");
     return this.mounted.target;
   }
+  /** The Web Animations lease held for the current mount (null when nothing is mounted). */
+  get animationLease() {
+    return this.animation;
+  }
   async flush() {
     await this.mounted?.flush?.();
   }
@@ -62,14 +73,29 @@ class MountKeeper {
     if (!current) return;
     const target = document.createElement("div");
     document.body.appendChild(target);
-    this.mounted = this.host(current.identity, current, target);
+    const lease = leaseDomAnimation(target);
+    try {
+      this.mounted = this.host(current.identity, current, target);
+    } catch (error) {
+      lease.release();
+      target.remove();
+      throw error;
+    }
+    this.animation = lease;
     this.mountedFor = current;
   }
   unmount() {
-    this.mounted?.unmount();
-    this.mounted?.target.remove();
+    const mounted = this.mounted;
+    const lease = this.animation;
     this.mounted = null;
     this.mountedFor = null;
+    this.animation = null;
+    try {
+      mounted?.unmount();
+    } finally {
+      mounted?.target.remove();
+      lease?.release();
+    }
   }
 }
 function domDriver(keeper) {
@@ -106,28 +132,54 @@ function domDriver(keeper) {
   };
 }
 async function buildRendererTier(options) {
-  const { source, router, catalog, operations, importer, hooks, dom } = options;
+  const {
+    source,
+    router,
+    catalog,
+    operations,
+    importer,
+    hooks,
+    dom,
+    ioc,
+    registrations,
+    controllerClasses
+  } = options;
   const keeper = dom ? new MountKeeper(await loadPageHost(source, importer, dom)) : null;
-  const rendererRoot = createWoodRoot();
-  await hooks?.configureRendererRoot?.(rendererRoot);
   const registry = new WorkRegistry();
-  const navigation = new Navigation();
+  const defaultNavigation = new Navigation();
   const innerTransport = new InProcessRouterTransport(router, hooks?.events ?? new RouterBridgeEvents());
   let currentOwner = () => "application";
   const transport = new TrackedTransport(innerTransport, registry, () => currentOwner());
   const { bridge } = buildTransportBridge(operations, transport);
-  const registrable = rendererRoot;
-  registrable.registerFunction(Navigation, () => navigation, { loadAs: LoadAs.Singleton });
-  registrable.registerFunction(WOOD_FRONTEND_BRIDGE, () => bridge, { loadAs: LoadAs.Singleton });
-  const loadController = controllerLoader(source, importer);
-  const frontend = createFrontendSurface({
-    catalog,
-    rendererRoot,
-    registry,
-    navigation,
-    resolveController: (identity) => loadController(identity),
-    ...hooks?.configurePageScope ? { configurePageScope: (scope, view, context) => hooks.configurePageScope(scope, view, context) } : {}
-  });
+  registrations.root.registerFunction(Navigation, () => defaultNavigation, { loadAs: LoadAs.Singleton });
+  registrations.root.registerFunction(WOOD_FRONTEND_BRIDGE, () => bridge, { loadAs: LoadAs.Singleton });
+  const rendererEnv = await buildRecordedEnvironment(ioc, registrations, "renderer");
+  const rendererRoot = rendererEnv.root;
+  let navigation;
+  const loadController = controllerLoader(source, importer, controllerClasses);
+  let frontend;
+  try {
+    navigation = await ExecutionContext.run(rendererRoot, () => rendererRoot.get(Navigation));
+    frontend = createFrontendSurface({
+      catalog,
+      rendererRoot,
+      registry,
+      navigation,
+      resolveController: (identity) => loadController(identity),
+      ...hooks?.configurePageScope ? { configurePageScope: (scope, view, context) => hooks.configurePageScope(scope, view, context) } : {}
+    });
+  } catch (error) {
+    try {
+      await cleanupAll("renderer build rollback failed", [
+        ["renderer mount", () => keeper?.unmount()],
+        ["renderer root", () => ExecutionContext.run(rendererRoot, () => rendererEnv.dispose())]
+      ]);
+    } catch (cleanupError) {
+      const failures = cleanupError instanceof TestWoodCleanupError ? cleanupError.failures : [{ owner: "renderer rollback", error: cleanupError }];
+      throw new TestWoodCleanupError("renderer build failed and rollback failed", failures, error);
+    }
+    throw error;
+  }
   currentOwner = () => {
     const current = frontend.current();
     return current ? `page ${current.identity}` : "application";
@@ -144,6 +196,14 @@ async function buildRendererTier(options) {
     await new Promise((resolve) => setTimeout(resolve, 0));
     await keeper.flush();
   };
+  let closing = null;
+  const dispose = () => closing ?? (closing = cleanupAll("renderer cleanup failed", [
+    ["renderer mount", () => keeper?.unmount()],
+    ["renderer work drain (before frontend)", () => ExecutionContext.run(rendererRoot, () => frontend.settle())],
+    ["renderer frontend", () => ExecutionContext.run(rendererRoot, () => frontend.dispose())],
+    ["renderer work drain (after frontend)", () => ExecutionContext.run(rendererRoot, () => frontend.settle())],
+    ["renderer root", () => ExecutionContext.run(rendererRoot, () => rendererEnv.dispose())]
+  ]));
   return {
     frontend,
     events: innerTransport.events,
@@ -168,21 +228,13 @@ async function buildRendererTier(options) {
     current: () => frontend.current(),
     settle,
     pendingWork: () => registry.pending(),
+    verify: () => rendererEnv.verify(),
     dom: keeper ? domDriver(keeper) : null,
-    async dispose() {
-      keeper?.unmount();
-      await ExecutionContext.run(rendererRoot, async () => {
-        await frontend.settle().catch(() => {
-        });
-        await frontend.dispose();
-        await frontend.settle().catch(() => {
-        });
-        await rendererRoot.dispose();
-      });
-    }
+    dispose
   };
 }
 export {
+  MountKeeper,
   buildRendererTier
 };
 //# sourceMappingURL=wood_env_renderer.js.map

package/dist/testing/wood_env_renderer.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/wood_env_renderer.ts"],"sourcesContent":["/**\n * The renderer tier of a `testWood(configPath)` environment: a fresh renderer\n * root (mirroring the production process split), an environment-local\n * Navigation, the generated bridge client over an in-process transport into\n * the main router, and the frontend application surface over the selected\n * page catalog. With a DOM mode, the page's real component is mounted by the\n * app's host module and driven through a selector-based surface.\n */\nimport type { IContainer } from '@noego/ioc';\nimport { ExecutionContext, LoadAs } from '@noego/ioc';\nimport type { WoodRouter } from '../router/wood_router.js';\nimport { InProcessRouterTransport } from '../transport/in_process_router_transport.js';\nimport { buildTransportBridge } from '../transport/build_transport_bridge.js';\nimport { RouterBridgeEvents } from './create_router_bridge.js';\nimport type { OperationDef, ViewDef } from '../types/index.js';\nimport { Navigation } from '../navigation/index.js';\nimport { createWoodRoot } from '../runtime/get_container.js';\nimport type { PageCatalog } from '../frontend/page_catalog.js';\nimport { WorkRegistry } from '../frontend/work_registry.js';\nimport { TrackedTransport } from '../frontend/tracked_transport.js';\nimport {\n  createFrontendSurface,\n  type FrontendApplicationSurface,\n  type PageScopeContext,\n} from '../frontend/frontend_surface.js';\nimport type { FrontendPage } from '../frontend/frontend_page.js';\nimport { TestWoodError, WOOD_FRONTEND_BRIDGE } from './test_wood.js';\nimport { importDefaultExport, type ModuleImporter, type WoodConfigSource } from './wood_config_source.js';\nimport type { WoodDomMode } from './wood_test_selection.js';\n\n/** What the app's `main.testing.compose` module may hand back for the renderer side. */\nexport interface WoodRendererHooks {\n  /** Backend push emitter feeding renderer subscriptions (default: transport-owned). */\n  events?: RouterBridgeEvents;\n  /** Register app-owned renderer composition on the fresh renderer root. */\n  configureRendererRoot?(root: IContainer): void | Promise<void>;\n  /** Register per-scope renderer builtins on a new page/layout scope. */\n  configurePageScope?(scope: IContainer, view: ViewDef, context: PageScopeContext): void | Promise<void>;\n}\n\n/** A page's real component mounted under a DOM driver (`renderer.testing.host`). */\nexport interface WoodMountedPage {\n  readonly target: Element;\n  flush?(): void | Promise<void>;\n  unmount(): void;\n}\n\nexport type WoodPageHost = (identity: string, page: FrontendPage, target: Element) => WoodMountedPage;\n\nexport interface RendererTierOptions {\n  source: WoodConfigSource;\n  router: WoodRouter;\n  catalog: PageCatalog;\n  operations: Map<string, OperationDef>;\n  importer: ModuleImporter;\n  hooks: WoodRendererHooks | null;\n  dom: WoodDomMode | null;\n}\n\nexport interface WoodDomDriver {\n  readonly target: Element;\n  click(selector: string): Promise<void>;\n  type(selector: string, text: string): Promise<void>;\n  submit(selector: string): Promise<void>;\n  text(selector: string): Promise<string>;\n  exists(selector: string): Promise<boolean>;\n}\n\nexport interface RendererTier {\n  readonly frontend: FrontendApplicationSurface;\n  readonly events: RouterBridgeEvents;\n  readonly rendererRoot: IContainer;\n  open(page: string, params?: Record<string, string>, query?: Record<string, string>): Promise<FrontendPage>;\n  navigate(page: string, params?: Record<string, string>, query?: Record<string, string>): Promise<FrontendPage>;\n  current(): FrontendPage | null;\n  settle(): Promise<void>;\n  pendingWork(): ReturnType<WorkRegistry['pending']>;\n  dom: WoodDomDriver | null;\n  dispose(): Promise<void>;\n}\n\ntype ControllerClass = new (...args: never[]) => unknown;\n\nfunction controllerLoader(source: WoodConfigSource, importer: ModuleImporter) {\n  const cache = new Map<string, Promise<ControllerClass>>();\n  return (identity: string): Promise<ControllerClass> => {\n    let pending = cache.get(identity);\n    if (!pending) {\n      pending = importDefaultExport<ControllerClass>(\n        importer,\n        source.rendererControllerFile(identity),\n        `renderer controller \"${identity}\"`,\n      );\n      cache.set(identity, pending);\n    }\n    return pending;\n  };\n}\n\nasync function loadPageHost(\n  source: WoodConfigSource,\n  importer: ModuleImporter,\n  dom: WoodDomMode,\n): Promise<WoodPageHost> {\n  if (dom === 'chromium') {\n    throw new TestWoodError(\"select({ dom: 'chromium' }) is not available yet; use 'happy-dom'\");\n  }\n  if (typeof document === 'undefined') {\n    throw new TestWoodError(\n      \"select({ dom: 'happy-dom' }) requires a DOM environment (// @vitest-environment happy-dom)\",\n    );\n  }\n  const hostPath = source.hookModule(source.config.renderer.testing?.host);\n  if (!hostPath) {\n    throw new TestWoodError(\n      'select({ dom }) requires renderer.testing.host in wood.config.yml (a module whose default export mounts a page)',\n    );\n  }\n  return importDefaultExport<WoodPageHost>(importer, hostPath, 'renderer.testing.host');\n}\n\n/** Keeps the mounted component in step with the surface's current page. */\nclass MountKeeper {\n  private mounted: WoodMountedPage | null = null;\n  private mountedFor: FrontendPage | null = null;\n\n  constructor(private readonly host: WoodPageHost) {}\n\n  get target(): Element {\n    if (!this.mounted) throw new TestWoodError('no page is mounted; open(page) first');\n    return this.mounted.target;\n  }\n\n  async flush(): Promise<void> {\n    await this.mounted?.flush?.();\n  }\n\n  sync(current: FrontendPage | null): void {\n    if (current === this.mountedFor) return;\n    this.unmount();\n    if (!current) return;\n    const target = document.createElement('div');\n    document.body.appendChild(target);\n    this.mounted = this.host(current.identity, current, target);\n    this.mountedFor = current;\n  }\n\n  unmount(): void {\n    this.mounted?.unmount();\n    this.mounted?.target.remove();\n    this.mounted = null;\n    this.mountedFor = null;\n  }\n}\n\nfunction domDriver(keeper: MountKeeper): WoodDomDriver {\n  const find = (selector: string): Element => {\n    const found = keeper.target.querySelector(selector);\n    if (!found) throw new TestWoodError(`no element matches \"${selector}\"`);\n    return found;\n  };\n  return {\n    get target() {\n      return keeper.target;\n    },\n    async click(selector) {\n      (find(selector) as HTMLElement).click();\n      await keeper.flush();\n    },\n    async type(selector, text) {\n      const input = find(selector) as HTMLInputElement;\n      input.focus();\n      input.value = text;\n      input.dispatchEvent(new Event('input', { bubbles: true }));\n      await keeper.flush();\n    },\n    async submit(selector) {\n      find(selector).dispatchEvent(new Event('submit', { bubbles: true, cancelable: true }));\n      await keeper.flush();\n    },\n    async text(selector) {\n      return keeper.target.querySelector(selector)?.textContent ?? '';\n    },\n    async exists(selector) {\n      return keeper.target.querySelector(selector) !== null;\n    },\n  };\n}\n\nexport async function buildRendererTier(options: RendererTierOptions): Promise<RendererTier> {\n  const { source, router, catalog, operations, importer, hooks, dom } = options;\n  const keeper = dom ? new MountKeeper(await loadPageHost(source, importer, dom)) : null;\n\n  const rendererRoot = createWoodRoot();\n  await hooks?.configureRendererRoot?.(rendererRoot);\n\n  const registry = new WorkRegistry();\n  const navigation = new Navigation();\n  const innerTransport = new InProcessRouterTransport(router, hooks?.events ?? new RouterBridgeEvents());\n  let currentOwner: () => string = () => 'application';\n  const transport = new TrackedTransport(innerTransport, registry, () => currentOwner());\n  const { bridge } = buildTransportBridge(operations, transport);\n\n  const registrable = rendererRoot as unknown as {\n    registerFunction(token: unknown, factory: () => unknown, options: { loadAs: LoadAs }): void;\n  };\n  registrable.registerFunction(Navigation, () => navigation, { loadAs: LoadAs.Singleton });\n  registrable.registerFunction(WOOD_FRONTEND_BRIDGE, () => bridge, { loadAs: LoadAs.Singleton });\n\n  const loadController = controllerLoader(source, importer);\n  const frontend = createFrontendSurface({\n    catalog,\n    rendererRoot: rendererRoot as never,\n    registry,\n    navigation,\n    resolveController: (identity) => loadController(identity),\n    ...(hooks?.configurePageScope\n      ? { configurePageScope: (scope, view, context) => hooks.configurePageScope!(scope as IContainer, view, context) }\n      : {}),\n  });\n  currentOwner = () => {\n    const current = frontend.current();\n    return current ? `page ${current.identity}` : 'application';\n  };\n\n  const syncMount = async (): Promise<void> => {\n    if (!keeper) return;\n    keeper.sync(frontend.current());\n    await keeper.flush();\n  };\n  const settle = async (): Promise<void> => {\n    await frontend.settle();\n    if (!keeper) return;\n    await syncMount();\n    await new Promise<void>((resolve) => setTimeout(resolve, 0));\n    await keeper.flush();\n  };\n\n  return {\n    frontend,\n    events: innerTransport.events,\n    rendererRoot,\n    async open(page, params, query) {\n      const opened = await frontend.open({\n        page,\n        ...(params ? { params } : {}),\n        ...(query ? { query } : {}),\n      });\n      await syncMount();\n      return opened;\n    },\n    async navigate(page, params, query) {\n      if (!frontend.current()) throw new TestWoodError('navigate() needs an open page; call open(page) first');\n      await frontend.act(() => navigation.go(page, params, query));\n      await syncMount();\n      const current = frontend.current();\n      if (!current) throw new TestWoodError(`navigate(\"${page}\") left no page open`);\n      return current;\n    },\n    current: () => frontend.current(),\n    settle,\n    pendingWork: () => registry.pending(),\n    dom: keeper ? domDriver(keeper) : null,\n    async dispose() {\n      keeper?.unmount();\n      await ExecutionContext.run(rendererRoot as never, async () => {\n        // Drain owned work while the transport still reaches a live main\n        // root, end the pages, then drain the teardown's own deliveries.\n        await frontend.settle().catch(() => {});\n        await frontend.dispose();\n        await frontend.settle().catch(() => {});\n        await rendererRoot.dispose();\n      });\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/testing/wood_env_renderer.ts"],"sourcesContent":["/**\n * The renderer tier of a `testWood(configPath)` environment: a fresh renderer\n * root (mirroring the production process split), an environment-local\n * Navigation, the generated bridge client over an in-process transport into\n * the main router, and the frontend application surface over the selected\n * page catalog. With a DOM mode, the page's real component is mounted by the\n * app's host module and driven through a selector-based surface.\n */\nimport type { IContainer } from '@noego/ioc';\nimport { ExecutionContext, LoadAs } from '@noego/ioc';\nimport type { TestIocBuilder } from '@noego/testing';\nimport type { WoodRouter } from '../router/wood_router.js';\nimport { InProcessRouterTransport } from '../transport/in_process_router_transport.js';\nimport { buildTransportBridge } from '../transport/build_transport_bridge.js';\nimport { RouterBridgeEvents } from './create_router_bridge.js';\nimport type { OperationDef, ViewDef } from '../types/index.js';\nimport { Navigation } from '../navigation/index.js';\nimport type { PageCatalog } from '../frontend/page_catalog.js';\nimport { WorkRegistry } from '../frontend/work_registry.js';\nimport { TrackedTransport } from '../frontend/tracked_transport.js';\nimport {\n  createFrontendSurface,\n  type FrontendApplicationSurface,\n  type PageScopeContext,\n} from '../frontend/frontend_surface.js';\nimport type { FrontendPage } from '../frontend/frontend_page.js';\nimport { TestWoodError, WOOD_FRONTEND_BRIDGE } from './test_wood.js';\nimport { importDefaultExport, type ModuleImporter, type WoodConfigSource } from './wood_config_source.js';\nimport type { WoodDomMode } from './wood_test_selection.js';\nimport { leaseDomAnimation, type WoodAnimationLease } from './wood_dom_animation.js';\nimport {\n  buildRecordedEnvironment,\n  cleanupAll,\n  RegistrationOnlyRoot,\n  TestWoodCleanupError,\n} from './registration_only_root.js';\n\n/** What the app's `main.testing.compose` module may hand back for the renderer side. */\nexport interface WoodRendererHooks {\n  /** Backend push emitter feeding renderer subscriptions (default: transport-owned). */\n  events?: RouterBridgeEvents;\n  /** Register app-owned renderer composition on the fresh renderer root. */\n  configureRendererRoot?(root: IContainer): void | Promise<void>;\n  /** Register per-scope renderer builtins on a new page/layout scope. */\n  configurePageScope?(scope: IContainer, view: ViewDef, context: PageScopeContext): void | Promise<void>;\n}\n\n/** A page's real component mounted under a DOM driver (`renderer.testing.host`). */\nexport interface WoodMountedPage {\n  readonly target: Element;\n  flush?(): void | Promise<void>;\n  unmount(): void;\n}\n\nexport type WoodPageHost = (identity: string, page: FrontendPage, target: Element) => WoodMountedPage;\n\nexport interface RendererTierOptions {\n  source: WoodConfigSource;\n  router: WoodRouter;\n  catalog: PageCatalog;\n  operations: Map<string, OperationDef>;\n  importer: ModuleImporter;\n  hooks: WoodRendererHooks | null;\n  dom: WoodDomMode | null;\n  ioc: TestIocBuilder;\n  registrations: RegistrationOnlyRoot;\n  controllerClasses: ReadonlyMap<string, ControllerClass>;\n}\n\nexport interface WoodDomDriver {\n  readonly target: Element;\n  click(selector: string): Promise<void>;\n  type(selector: string, text: string): Promise<void>;\n  submit(selector: string): Promise<void>;\n  text(selector: string): Promise<string>;\n  exists(selector: string): Promise<boolean>;\n}\n\nexport interface RendererTier {\n  readonly frontend: FrontendApplicationSurface;\n  readonly events: RouterBridgeEvents;\n  readonly rendererRoot: IContainer;\n  open(page: string, params?: Record<string, string>, query?: Record<string, string>): Promise<FrontendPage>;\n  navigate(page: string, params?: Record<string, string>, query?: Record<string, string>): Promise<FrontendPage>;\n  current(): FrontendPage | null;\n  settle(): Promise<void>;\n  pendingWork(): ReturnType<WorkRegistry['pending']>;\n  verify(): Promise<void>;\n  dom: WoodDomDriver | null;\n  dispose(): Promise<void>;\n}\ntype ControllerClass = new (...args: never[]) => unknown;\n\nfunction controllerLoader(\n  source: WoodConfigSource,\n  importer: ModuleImporter,\n  preloaded: ReadonlyMap<string, ControllerClass>,\n) {\n  const cache = new Map<string, Promise<ControllerClass>>();\n  for (const [identity, controller] of preloaded) cache.set(identity, Promise.resolve(controller));\n  return (identity: string): Promise<ControllerClass> => {\n    let pending = cache.get(identity);\n    if (!pending) {\n      pending = importDefaultExport<ControllerClass>(\n        importer,\n        source.rendererControllerFile(identity),\n        `renderer controller \"${identity}\"`,\n      );\n      cache.set(identity, pending);\n    }\n    return pending;\n  };\n}\n\nasync function loadPageHost(\n  source: WoodConfigSource,\n  importer: ModuleImporter,\n  dom: WoodDomMode,\n): Promise<WoodPageHost> {\n  if (dom === 'chromium') {\n    throw new TestWoodError(\"select({ dom: 'chromium' }) is not available yet; use 'happy-dom'\");\n  }\n  if (typeof document === 'undefined') {\n    throw new TestWoodError(\n      \"select({ dom: 'happy-dom' }) requires a DOM environment (// @vitest-environment happy-dom)\",\n    );\n  }\n  const hostPath = source.hookModule(source.config.renderer.testing?.host);\n  if (!hostPath) {\n    throw new TestWoodError(\n      'select({ dom }) requires renderer.testing.host in wood.config.yml (a module whose default export mounts a page)',\n    );\n  }\n  return importDefaultExport<WoodPageHost>(importer, hostPath, 'renderer.testing.host');\n}\n\n/**\n * Keeps the mounted component in step with the surface's current page. While\n * a page is mounted it holds a Web Animations lease on the target's realm so\n * Svelte transitions work under happy-dom (see `wood_dom_animation.ts`); the\n * lease is released on unmount, on a failed host mount, and on dispose.\n */\nexport class MountKeeper {\n  private mounted: WoodMountedPage | null = null;\n  private mountedFor: FrontendPage | null = null;\n  private animation: WoodAnimationLease | null = null;\n\n  constructor(private readonly host: WoodPageHost) {}\n\n  get target(): Element {\n    if (!this.mounted) throw new TestWoodError('no page is mounted; open(page) first');\n    return this.mounted.target;\n  }\n\n  /** The Web Animations lease held for the current mount (null when nothing is mounted). */\n  get animationLease(): WoodAnimationLease | null {\n    return this.animation;\n  }\n\n  async flush(): Promise<void> {\n    await this.mounted?.flush?.();\n  }\n\n  sync(current: FrontendPage | null): void {\n    if (current === this.mountedFor) return;\n    this.unmount();\n    if (!current) return;\n    const target = document.createElement('div');\n    document.body.appendChild(target);\n    const lease = leaseDomAnimation(target);\n    try {\n      this.mounted = this.host(current.identity, current, target);\n    } catch (error) {\n      lease.release();\n      target.remove();\n      throw error;\n    }\n    this.animation = lease;\n    this.mountedFor = current;\n  }\n\n  unmount(): void {\n    const mounted = this.mounted;\n    const lease = this.animation;\n    this.mounted = null;\n    this.mountedFor = null;\n    this.animation = null;\n    try {\n      mounted?.unmount();\n    } finally {\n      mounted?.target.remove();\n      lease?.release();\n    }\n  }\n}\n\nfunction domDriver(keeper: MountKeeper): WoodDomDriver {\n  const find = (selector: string): Element => {\n    const found = keeper.target.querySelector(selector);\n    if (!found) throw new TestWoodError(`no element matches \"${selector}\"`);\n    return found;\n  };\n  return {\n    get target() {\n      return keeper.target;\n    },\n    async click(selector) {\n      (find(selector) as HTMLElement).click();\n      await keeper.flush();\n    },\n    async type(selector, text) {\n      const input = find(selector) as HTMLInputElement;\n      input.focus();\n      input.value = text;\n      input.dispatchEvent(new Event('input', { bubbles: true }));\n      await keeper.flush();\n    },\n    async submit(selector) {\n      find(selector).dispatchEvent(new Event('submit', { bubbles: true, cancelable: true }));\n      await keeper.flush();\n    },\n    async text(selector) {\n      return keeper.target.querySelector(selector)?.textContent ?? '';\n    },\n    async exists(selector) {\n      return keeper.target.querySelector(selector) !== null;\n    },\n  };\n}\n\nexport async function buildRendererTier(options: RendererTierOptions): Promise<RendererTier> {\n  const {\n    source,\n    router,\n    catalog,\n    operations,\n    importer,\n    hooks,\n    dom,\n    ioc,\n    registrations,\n    controllerClasses,\n  } = options;\n  const keeper = dom ? new MountKeeper(await loadPageHost(source, importer, dom)) : null;\n\n  const registry = new WorkRegistry();\n  const defaultNavigation = new Navigation();\n  const innerTransport = new InProcessRouterTransport(router, hooks?.events ?? new RouterBridgeEvents());\n  let currentOwner: () => string = () => 'application';\n  const transport = new TrackedTransport(innerTransport, registry, () => currentOwner());\n  const { bridge } = buildTransportBridge(operations, transport);\n\n  registrations.root.registerFunction(Navigation, () => defaultNavigation, { loadAs: LoadAs.Singleton });\n  registrations.root.registerFunction(WOOD_FRONTEND_BRIDGE, () => bridge, { loadAs: LoadAs.Singleton });\n\n  const rendererEnv = await buildRecordedEnvironment(ioc, registrations, 'renderer');\n  const rendererRoot = rendererEnv.root;\n  let navigation: Navigation;\n  const loadController = controllerLoader(source, importer, controllerClasses);\n  let frontend: FrontendApplicationSurface;\n  try {\n    navigation = await ExecutionContext.run(rendererRoot as never, () => rendererRoot.get(Navigation)) as Navigation;\n    frontend = createFrontendSurface({\n      catalog,\n      rendererRoot: rendererRoot as never,\n      registry,\n      navigation,\n      resolveController: (identity) => loadController(identity),\n      ...(hooks?.configurePageScope\n        ? { configurePageScope: (scope, view, context) => hooks.configurePageScope!(scope as IContainer, view, context) }\n        : {}),\n    });\n  } catch (error) {\n    try {\n      await cleanupAll('renderer build rollback failed', [\n        ['renderer mount', () => keeper?.unmount()],\n        ['renderer root', () => ExecutionContext.run(rendererRoot as never, () => rendererEnv.dispose()) as Promise<void>],\n      ]);\n    } catch (cleanupError) {\n      const failures = cleanupError instanceof TestWoodCleanupError\n        ? cleanupError.failures\n        : [{ owner: 'renderer rollback', error: cleanupError }];\n      throw new TestWoodCleanupError('renderer build failed and rollback failed', failures, error);\n    }\n    throw error;\n  }\n\n  currentOwner = () => {\n    const current = frontend.current();\n    return current ? `page ${current.identity}` : 'application';\n  };\n\n  const syncMount = async (): Promise<void> => {\n    if (!keeper) return;\n    keeper.sync(frontend.current());\n    await keeper.flush();\n  };\n  const settle = async (): Promise<void> => {\n    await frontend.settle();\n    if (!keeper) return;\n    await syncMount();\n    await new Promise<void>((resolve) => setTimeout(resolve, 0));\n    await keeper.flush();\n  };\n\n  let closing: Promise<void> | null = null;\n  const dispose = (): Promise<void> => closing ??= cleanupAll('renderer cleanup failed', [\n    ['renderer mount', () => keeper?.unmount()],\n    ['renderer work drain (before frontend)', () =>\n      ExecutionContext.run(rendererRoot as never, () => frontend.settle()) as Promise<void>],\n    ['renderer frontend', () =>\n      ExecutionContext.run(rendererRoot as never, () => frontend.dispose()) as Promise<void>],\n    ['renderer work drain (after frontend)', () =>\n      ExecutionContext.run(rendererRoot as never, () => frontend.settle()) as Promise<void>],\n    ['renderer root', () =>\n      ExecutionContext.run(rendererRoot as never, () => rendererEnv.dispose()) as Promise<void>],\n  ]);\n\n  return {\n    frontend,\n    events: innerTransport.events,\n    rendererRoot,\n    async open(page, params, query) {\n      const opened = await frontend.open({\n        page,\n        ...(params ? { params } : {}),\n        ...(query ? { query } : {}),\n      });\n      await syncMount();\n      return opened;\n    },\n    async navigate(page, params, query) {\n      if (!frontend.current()) throw new TestWoodError('navigate() needs an open page; call open(page) first');\n      await frontend.act(() => navigation.go(page, params, query));\n      await syncMount();\n      const current = frontend.current();\n      if (!current) throw new TestWoodError(`navigate(\"${page}\") left no page open`);\n      return current;\n    },\n    current: () => frontend.current(),\n    settle,\n    pendingWork: () => registry.pending(),\n    verify: () => rendererEnv.verify(),\n    dom: keeper ? domDriver(keeper) : null,\n    dispose,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/transport/in_process_router_transport.d.cts

@@ -3,6 +3,9 @@ import { RouterBridgeEvents } from '../testing/create_router_bridge.cjs';
 import { WoodRpcTransport } from './wood_rpc_transport.cjs';
 import '../types/operations.cjs';
 import '../types/context.cjs';
+import '../validation/schema_validator.cjs';
+import '../middleware/middleware_resolver.cjs';
+import '../controller/controller_resolver.cjs';
 
 /**
  * A `WoodRpcTransport` that dispatches straight through a real `WoodRouter`

package/dist/transport/in_process_router_transport.d.ts

@@ -3,6 +3,9 @@ import { RouterBridgeEvents } from '../testing/create_router_bridge.js';
 import { WoodRpcTransport } from './wood_rpc_transport.js';
 import '../types/operations.js';
 import '../types/context.js';
+import '../validation/schema_validator.js';
+import '../middleware/middleware_resolver.js';
+import '../controller/controller_resolver.js';
 
 /**
  * A `WoodRpcTransport` that dispatches straight through a real `WoodRouter`

package/dist/transport/index.d.cts

@@ -6,4 +6,7 @@ export { TransportBridgeResult, buildTransportBridge } from './build_transport_b
 import '../router/wood_router.cjs';
 import '../types/operations.cjs';
 import '../types/context.cjs';
+import '../validation/schema_validator.cjs';
+import '../middleware/middleware_resolver.cjs';
+import '../controller/controller_resolver.cjs';
 import '../testing/create_router_bridge.cjs';

package/dist/transport/index.d.ts

@@ -6,4 +6,7 @@ export { TransportBridgeResult, buildTransportBridge } from './build_transport_b
 import '../router/wood_router.js';
 import '../types/operations.js';
 import '../types/context.js';
+import '../validation/schema_validator.js';
+import '../middleware/middleware_resolver.js';
+import '../controller/controller_resolver.js';
 import '../testing/create_router_bridge.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noego/wood",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -23,6 +23,8 @@
     "src/client/app_env.ts",
     "src/client/controller_contract.ts",
     "src/controller/controller_lifecycle.ts",
+    "src/controller/cleanup.ts",
+    "src/navigation/layout_preservation.ts",
     "src/navigation/navigation_identity.ts",
     "src/runtime/app_env.ts"
   ],
@@ -125,10 +127,10 @@
     "prepublishOnly": "npm run build && npm run typecheck && npm test"
   },
   "dependencies": {
-    "@noego/ioc": "^0.7.0",
+    "@noego/ioc": "^0.8.0",
     "@noego/logger": "^0.2.0",
-    "@noego/stitch": "^1.0.3",
-    "@noego/telemetry": "^0.1.0",
+    "@noego/stitch": "^1.1.0",
+    "@noego/telemetry": "^0.2.0",
     "@noego/trace": "^0.2.0",
     "ajv": "^8.x",
     "ajv-formats": "^3.x",
@@ -140,7 +142,7 @@
     "rxjs": "^7.x"
   },
   "peerDependencies": {
-    "@noego/testing": ">=0.5.0",
+    "@noego/testing": ">=0.6.0",
     "@sveltejs/vite-plugin-svelte": "^4.0.0",
     "electron": ">=28.0.0",
     "playwright": "^1.40.0",
@@ -158,7 +160,7 @@
     }
   },
   "devDependencies": {
-    "@noego/testing": "^0.5.0",
+    "@noego/testing": "^0.6.0",
     "@sveltejs/vite-plugin-svelte": "^4.0.4",
     "@types/better-sqlite3": "^9.6.0",
     "@types/js-yaml": "^4.x",

package/src/components/NavigationShell.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
   import { setContext, onDestroy } from 'svelte';
   import { getNavigation, type NavigationEntry } from '@noego/wood/navigation';
+  import { cleanupAll } from '../controller/cleanup';
   import { disposeControllerLifecycle } from '../controller/controller_lifecycle';
   import { createNavigationMountKey } from '../navigation/navigation_identity';
   import { computePreservedLayoutDepth as computeSharedPreservedLayoutDepth } from '../navigation/layout_preservation';
@@ -60,6 +61,7 @@
     initialControllerSet,
     createControllerSetFn,
     getViewManifestEntryFn,
+    onLifecycleError,
   }: {
     manifest: Record<string, ViewManifestEntry>;
     initialEntry: ViewManifestEntry;
@@ -70,6 +72,8 @@
     initialControllerSet?: ControllerSet;
     createControllerSetFn?: CreateControllerSetFn;
     getViewManifestEntryFn: GetViewManifestEntryFn;
+    /** Observe navigation/cleanup failures without skipping remaining owners. */
+    onLifecycleError?: (error: unknown) => void;
   } = $props();
 
   // Unified controller-set factory: prefer the scope-aware contract; wrap
@@ -222,10 +226,12 @@
     layoutControllers: Array<unknown>,
     fromLayoutIndex = 0,
   ): Promise<void> {
-    await disposeControllerLifecycle(controller);
-    for (let index = fromLayoutIndex; index < layoutControllers.length; index += 1) {
-      await disposeControllerLifecycle(layoutControllers[index]);
-    }
+    try {
+      await cleanupAll([
+        () => disposeControllerLifecycle(controller),
+        ...layoutControllers.slice(fromLayoutIndex).map(layout => () => disposeControllerLifecycle(layout)),
+      ], 'Wood controller-set cleanup failed');
+    } catch (error) { reportNavigationError('controller-set cleanup failed', error); }
   }
 
   async function disposeActiveControllers(): Promise<void> {
@@ -233,14 +239,13 @@
   }
 
   async function disposeLayoutControllers(layoutControllers: Array<unknown>): Promise<void> {
-    for (const layoutController of layoutControllers) {
-      await disposeControllerLifecycle(layoutController);
-    }
+    await cleanupAll(layoutControllers.map(controller => () => disposeControllerLifecycle(controller)), 'Wood layout cleanup failed');
   }
 
   function reportNavigationError(context: string, error: unknown): void {
     const message = error instanceof Error ? error.message : String(error);
     console.error(`[wood] ${context}: ${message}`);
+    try { onLifecycleError?.(error); } catch (observerError) { console.error('[wood] lifecycle error observer failed', observerError); }
   }
 
   async function disposeStagedControllers(

package/src/controller/cleanup.ts

@@ -0,0 +1,8 @@
+/** Attempt every owner in order, preserving all failures (including non-Error throws). */
+export async function cleanupAll(steps: ReadonlyArray<() => unknown | Promise<unknown>>, message = 'Wood cleanup failed'): Promise<void> {
+  const errors: unknown[] = [];
+  for (const step of steps) {
+    try { await step(); } catch (error) { errors.push(error); }
+  }
+  if (errors.length) throw Object.assign(new Error(message), { errors, cause: errors[0] });
+}

package/src/controller/controller_lifecycle.ts

@@ -13,6 +13,7 @@ export async function disposeControllerLifecycle(target: unknown): Promise<void>
     return;
   }
 
+  guardControllerLifecycleOnce(target);
   const lifecycle = target as ControllerLifecycle;
   if (typeof lifecycle.dispose === 'function') {
     await lifecycle.dispose();
@@ -22,3 +23,26 @@ export async function disposeControllerLifecycle(target: unknown): Promise<void>
     await lifecycle.destroy();
   }
 }
+
+const guardedControllers = new WeakSet<object>();
+
+/** Share one teardown attempt between the explicit controller owner and IoC. */
+export function guardControllerLifecycleOnce(target: unknown): void {
+  if (!target || (typeof target !== 'object' && typeof target !== 'function')) return;
+  if (guardedControllers.has(target as object)) return;
+  guardedControllers.add(target as object);
+  const instance = target as Record<string, unknown>;
+  for (const name of ['dispose', 'destroy'] as const) {
+    const original = instance[name];
+    if (typeof original !== 'function') continue;
+    let called = false;
+    Object.defineProperty(instance, name, {
+      configurable: true, writable: true,
+      value: function (this: unknown, ...args: unknown[]) {
+        if (called) return;
+        called = true;
+        return original.apply(this, args);
+      },
+    });
+  }
+}

package/src/navigation/layout_preservation.ts

@@ -0,0 +1,45 @@
+/**
+ * Layout preservation depth — the single production rule for how many
+ * leading layouts a navigation transition keeps mounted.
+ *
+ * One implementation, two callers: the renderer's NavigationShell (real
+ * component transitions) and the Node frontend application slice
+ * (`createFrontendSurface`). They must agree — a slice test that preserved
+ * a layout the renderer rebuilds, or vice versa, would be evidence about a
+ * rule that does not exist in production.
+ *
+ * The rule: walk the layout stacks in parallel and keep a layout only while
+ * BOTH sides declare the same layout path, the same layout controller, and
+ * both mark it `preserve: true`. `NavigationOptions.preserveLayouts`
+ * overrides the declaration in both directions.
+ */
+import type { NavigationOptions } from './index.js';
+
+/** The layout stack of one view, in the shape both callers can supply. */
+export interface LayoutStack {
+  layoutPaths: readonly string[];
+  layoutControllers?: ReadonlyArray<string | undefined>;
+  layoutPreserve?: readonly boolean[];
+}
+
+export function computePreservedLayoutDepth(
+  from: LayoutStack,
+  to: LayoutStack,
+  options: NavigationOptions = {},
+): number {
+  const maxDepth = Math.min(from.layoutPaths.length, to.layoutPaths.length);
+  let depth = 0;
+  for (let index = 0; index < maxDepth; index += 1) {
+    if (from.layoutPaths[index] !== to.layoutPaths[index]) break;
+    if (from.layoutControllers?.[index] !== to.layoutControllers?.[index]) break;
+    if (options.preserveLayouts === false) break;
+    if (
+      options.preserveLayouts !== true &&
+      (from.layoutPreserve?.[index] !== true || to.layoutPreserve?.[index] !== true)
+    ) {
+      break;
+    }
+    depth += 1;
+  }
+  return depth;
+}