@noego/wood 0.6.2 → 0.7.1

package/dist/testing/wood_env_renderer.cjs.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 { TestIocBuilder } from '@noego/testing';\nimport type { WoodRouter } from '../router/wood_router.cjs';\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.cjs';\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.cjs';\nimport { importDefaultExport, type ModuleImporter, type WoodConfigSource } from './wood_config_source.cjs';\nimport type { WoodDomMode } from './wood_test_selection.cjs';\nimport { leaseDomAnimation, type WoodAnimationLease } from './wood_dom_animation.cjs';\nimport {\n  buildRecordedEnvironment,\n  cleanupAll,\n  RegistrationOnlyRoot,\n  TestWoodCleanupError,\n} from './registration_only_root.cjs';\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":[]}
+{"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 { ENV_REGISTRY, type TestExecutableOverlays, type TestIocBuilder } from '@noego/testing';\nimport type { WoodRouter } from '../router/wood_router.cjs';\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.cjs';\nimport type { DataLoader, ViewLoaderSet } from '../loader/loader_orchestration.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.cjs';\nimport { importDefaultExport, type ModuleImporter, type WoodConfigSource } from './wood_config_source.cjs';\nimport type { WoodDomMode } from './wood_test_selection.cjs';\nimport { leaseDomAnimation, type WoodAnimationLease } from './wood_dom_animation.cjs';\nimport {\n  buildRecordedEnvironment,\n  cleanupAll,\n  RegistrationOnlyRoot,\n  TestWoodCleanupError,\n} from './registration_only_root.cjs';\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  /** Tokens whose `.value`/callable `.function` replacements stay caller-owned. */\n  borrowedTokens?: readonly unknown[];\n  registrations: RegistrationOnlyRoot;\n  controllerClasses: ReadonlyMap<string, ControllerClass>;\n  /**\n   * `.load` seams over the page/layout DATA loaders. The native loader\n   * identity is the config-relative companion source path\n   * (`ui/pages/chat.load.ts`), export `default`.\n   */\n  loaders?: TestExecutableOverlays;\n  /** The imported companion loaders by identity (discovered at build, none has run). */\n  loaderModules?: ReadonlyMap<string, DataLoader>;\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  /** The renderer owner's method-seam registry (`test.inspect` on renderer tokens). */\n  readonly [ENV_REGISTRY]: unknown;\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    borrowedTokens,\n    registrations,\n    controllerClasses,\n    loaders,\n    loaderModules,\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', borrowedTokens);\n  const rendererRoot = rendererEnv.root;\n  let navigation: Navigation;\n  const loadController = controllerLoader(source, importer, controllerClasses);\n  const resolveController = (identity: string): Promise<ControllerClass> => loadController(identity);\n  // `.load` seams are installed over the imported companion loaders NOW —\n  // before any page resolves — one slot per loader identity. Nothing runs\n  // here; a page open/navigation executes them through the shared\n  // orchestration exactly as the production renderer does.\n  const installedLoaders = new Map<string, DataLoader>();\n  for (const [identity, original] of loaderModules ?? []) {\n    installedLoaders.set(\n      identity,\n      loaders ? (loaders.replace('load', { path: identity, export: 'default' }, original) as DataLoader) : original,\n    );\n  }\n  const loaderFor = (viewPath: string): DataLoader | null => {\n    const reference = source.rendererLoaderReference(viewPath);\n    if (!reference) return null;\n    const installed = installedLoaders.get(reference.identity);\n    if (!installed) {\n      throw new TestWoodError(`data loader ${reference.identity} was not imported at build; rebuild the environment`);\n    }\n    return installed;\n  };\n  const resolveLoaders = (view: ViewDef): ViewLoaderSet => ({\n    layouts: view.layouts.map((layoutPath) => loaderFor(layoutPath)),\n    view: loaderFor(view.viewPath),\n  });\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,\n      resolveLoaders,\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    [ENV_REGISTRY]: (rendererEnv as unknown as Record<symbol, unknown>)[ENV_REGISTRY],\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/testing/wood_env_renderer.d.cts

@@ -1,9 +1,10 @@
 import { IContainer } from '@noego/ioc';
-import { TestIocBuilder } from '@noego/testing';
+import { ENV_REGISTRY, TestIocBuilder, TestExecutableOverlays } from '@noego/testing';
 import { WoodRouter } from '../router/wood_router.cjs';
 import { RouterBridgeEvents } from './create_router_bridge.cjs';
 import { OperationDef } from '../types/operations.cjs';
 import { ViewDef } from '../types/views.cjs';
+import { DataLoader } from '../loader/loader_orchestration.cjs';
 import { PageCatalog } from '../frontend/page_catalog.cjs';
 import { WorkRegistry } from '../frontend/work_registry.cjs';
 import { PageScopeContext, FrontendApplicationSurface } from '../frontend/frontend_surface.cjs';
@@ -57,8 +58,18 @@ interface RendererTierOptions {
     hooks: WoodRendererHooks | null;
     dom: WoodDomMode | null;
     ioc: TestIocBuilder;
+    /** Tokens whose `.value`/callable `.function` replacements stay caller-owned. */
+    borrowedTokens?: readonly unknown[];
     registrations: RegistrationOnlyRoot;
     controllerClasses: ReadonlyMap<string, ControllerClass>;
+    /**
+     * `.load` seams over the page/layout DATA loaders. The native loader
+     * identity is the config-relative companion source path
+     * (`ui/pages/chat.load.ts`), export `default`.
+     */
+    loaders?: TestExecutableOverlays;
+    /** The imported companion loaders by identity (discovered at build, none has run). */
+    loaderModules?: ReadonlyMap<string, DataLoader>;
 }
 interface WoodDomDriver {
     readonly target: Element;
@@ -80,6 +91,8 @@ interface RendererTier {
     verify(): Promise<void>;
     dom: WoodDomDriver | null;
     dispose(): Promise<void>;
+    /** The renderer owner's method-seam registry (`test.inspect` on renderer tokens). */
+    readonly [ENV_REGISTRY]: unknown;
 }
 type ControllerClass = new (...args: never[]) => unknown;
 /**

package/dist/testing/wood_env_renderer.d.ts

@@ -1,9 +1,10 @@
 import { IContainer } from '@noego/ioc';
-import { TestIocBuilder } from '@noego/testing';
+import { ENV_REGISTRY, TestIocBuilder, TestExecutableOverlays } from '@noego/testing';
 import { WoodRouter } from '../router/wood_router.js';
 import { RouterBridgeEvents } from './create_router_bridge.js';
 import { OperationDef } from '../types/operations.js';
 import { ViewDef } from '../types/views.js';
+import { DataLoader } from '../loader/loader_orchestration.js';
 import { PageCatalog } from '../frontend/page_catalog.js';
 import { WorkRegistry } from '../frontend/work_registry.js';
 import { PageScopeContext, FrontendApplicationSurface } from '../frontend/frontend_surface.js';
@@ -57,8 +58,18 @@ interface RendererTierOptions {
     hooks: WoodRendererHooks | null;
     dom: WoodDomMode | null;
     ioc: TestIocBuilder;
+    /** Tokens whose `.value`/callable `.function` replacements stay caller-owned. */
+    borrowedTokens?: readonly unknown[];
     registrations: RegistrationOnlyRoot;
     controllerClasses: ReadonlyMap<string, ControllerClass>;
+    /**
+     * `.load` seams over the page/layout DATA loaders. The native loader
+     * identity is the config-relative companion source path
+     * (`ui/pages/chat.load.ts`), export `default`.
+     */
+    loaders?: TestExecutableOverlays;
+    /** The imported companion loaders by identity (discovered at build, none has run). */
+    loaderModules?: ReadonlyMap<string, DataLoader>;
 }
 interface WoodDomDriver {
     readonly target: Element;
@@ -80,6 +91,8 @@ interface RendererTier {
     verify(): Promise<void>;
     dom: WoodDomDriver | null;
     dispose(): Promise<void>;
+    /** The renderer owner's method-seam registry (`test.inspect` on renderer tokens). */
+    readonly [ENV_REGISTRY]: unknown;
 }
 type ControllerClass = new (...args: never[]) => unknown;
 /**

package/dist/testing/wood_env_renderer.js

@@ -1,4 +1,5 @@
 import { ExecutionContext, LoadAs } from "@noego/ioc";
+import { ENV_REGISTRY } from "@noego/testing";
 import { InProcessRouterTransport } from "../transport/in_process_router_transport.js";
 import { buildTransportBridge } from "../transport/build_transport_bridge.js";
 import { RouterBridgeEvents } from "./create_router_bridge.js";
@@ -141,8 +142,11 @@ async function buildRendererTier(options) {
     hooks,
     dom,
     ioc,
+    borrowedTokens,
     registrations,
-    controllerClasses
+    controllerClasses,
+    loaders,
+    loaderModules
   } = options;
   const keeper = dom ? new MountKeeper(await loadPageHost(source, importer, dom)) : null;
   const registry = new WorkRegistry();
@@ -153,10 +157,31 @@ async function buildRendererTier(options) {
   const { bridge } = buildTransportBridge(operations, transport);
   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 rendererEnv = await buildRecordedEnvironment(ioc, registrations, "renderer", borrowedTokens);
   const rendererRoot = rendererEnv.root;
   let navigation;
   const loadController = controllerLoader(source, importer, controllerClasses);
+  const resolveController = (identity) => loadController(identity);
+  const installedLoaders = /* @__PURE__ */ new Map();
+  for (const [identity, original] of loaderModules ?? []) {
+    installedLoaders.set(
+      identity,
+      loaders ? loaders.replace("load", { path: identity, export: "default" }, original) : original
+    );
+  }
+  const loaderFor = (viewPath) => {
+    const reference = source.rendererLoaderReference(viewPath);
+    if (!reference) return null;
+    const installed = installedLoaders.get(reference.identity);
+    if (!installed) {
+      throw new TestWoodError(`data loader ${reference.identity} was not imported at build; rebuild the environment`);
+    }
+    return installed;
+  };
+  const resolveLoaders = (view) => ({
+    layouts: view.layouts.map((layoutPath) => loaderFor(layoutPath)),
+    view: loaderFor(view.viewPath)
+  });
   let frontend;
   try {
     navigation = await ExecutionContext.run(rendererRoot, () => rendererRoot.get(Navigation));
@@ -165,7 +190,8 @@ async function buildRendererTier(options) {
       rendererRoot,
       registry,
       navigation,
-      resolveController: (identity) => loadController(identity),
+      resolveController,
+      resolveLoaders,
       ...hooks?.configurePageScope ? { configurePageScope: (scope, view, context) => hooks.configurePageScope(scope, view, context) } : {}
     });
   } catch (error) {
@@ -230,7 +256,8 @@ async function buildRendererTier(options) {
     pendingWork: () => registry.pending(),
     verify: () => rendererEnv.verify(),
     dom: keeper ? domDriver(keeper) : null,
-    dispose
+    dispose,
+    [ENV_REGISTRY]: rendererEnv[ENV_REGISTRY]
   };
 }
 export {

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 { 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":[]}
+{"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 { ENV_REGISTRY, type TestExecutableOverlays, 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 type { DataLoader, ViewLoaderSet } from '../loader/loader_orchestration.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  /** Tokens whose `.value`/callable `.function` replacements stay caller-owned. */\n  borrowedTokens?: readonly unknown[];\n  registrations: RegistrationOnlyRoot;\n  controllerClasses: ReadonlyMap<string, ControllerClass>;\n  /**\n   * `.load` seams over the page/layout DATA loaders. The native loader\n   * identity is the config-relative companion source path\n   * (`ui/pages/chat.load.ts`), export `default`.\n   */\n  loaders?: TestExecutableOverlays;\n  /** The imported companion loaders by identity (discovered at build, none has run). */\n  loaderModules?: ReadonlyMap<string, DataLoader>;\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  /** The renderer owner's method-seam registry (`test.inspect` on renderer tokens). */\n  readonly [ENV_REGISTRY]: unknown;\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    borrowedTokens,\n    registrations,\n    controllerClasses,\n    loaders,\n    loaderModules,\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', borrowedTokens);\n  const rendererRoot = rendererEnv.root;\n  let navigation: Navigation;\n  const loadController = controllerLoader(source, importer, controllerClasses);\n  const resolveController = (identity: string): Promise<ControllerClass> => loadController(identity);\n  // `.load` seams are installed over the imported companion loaders NOW —\n  // before any page resolves — one slot per loader identity. Nothing runs\n  // here; a page open/navigation executes them through the shared\n  // orchestration exactly as the production renderer does.\n  const installedLoaders = new Map<string, DataLoader>();\n  for (const [identity, original] of loaderModules ?? []) {\n    installedLoaders.set(\n      identity,\n      loaders ? (loaders.replace('load', { path: identity, export: 'default' }, original) as DataLoader) : original,\n    );\n  }\n  const loaderFor = (viewPath: string): DataLoader | null => {\n    const reference = source.rendererLoaderReference(viewPath);\n    if (!reference) return null;\n    const installed = installedLoaders.get(reference.identity);\n    if (!installed) {\n      throw new TestWoodError(`data loader ${reference.identity} was not imported at build; rebuild the environment`);\n    }\n    return installed;\n  };\n  const resolveLoaders = (view: ViewDef): ViewLoaderSet => ({\n    layouts: view.layouts.map((layoutPath) => loaderFor(layoutPath)),\n    view: loaderFor(view.viewPath),\n  });\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,\n      resolveLoaders,\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    [ENV_REGISTRY]: (rendererEnv as unknown as Record<symbol, unknown>)[ENV_REGISTRY],\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/testing/wood_lazy_runtime.cjs

@@ -0,0 +1,109 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var wood_lazy_runtime_exports = {};
+__export(wood_lazy_runtime_exports, {
+  LazyRuntimeStage: () => LazyRuntimeStage,
+  lazyMember: () => lazyMember
+});
+module.exports = __toCommonJS(wood_lazy_runtime_exports);
+var import_test_wood = require("./test_wood.cjs");
+class LazyRuntimeStage {
+  constructor(init, rollback) {
+    this.init = init;
+    this.rollback = rollback;
+    this.pending = null;
+    /** The bare `init()` attempt, settled (never rejecting) — excludes rollback. */
+    this.attempt = null;
+    this.value = null;
+  }
+  /** The initialized value, or null while this stage has not been used yet. */
+  get current() {
+    return this.value;
+  }
+  /** True once initialization has been requested (whether or not it finished). */
+  get requested() {
+    return this.pending !== null;
+  }
+  /** Initialize exactly once; concurrent callers share the same promise. */
+  acquire() {
+    if (!this.pending) {
+      const attempt = this.init();
+      this.attempt = attempt.then(() => void 0, () => void 0);
+      this.pending = attempt.then(
+        (value) => {
+          this.value = value;
+          return value;
+        },
+        (error) => this.rollback(error)
+      );
+    }
+    return this.pending;
+  }
+  /**
+   * Resolves once an in-flight initialization attempt has finished (either
+   * way); immediately when none was requested. Deliberately excludes the
+   * rollback so a disposer invoked *by* the rollback never waits on itself.
+   */
+  settled() {
+    return this.attempt ?? Promise.resolve();
+  }
+  /** A derived view over one member of the initialized value. */
+  map(project) {
+    const stage = this;
+    return {
+      get current() {
+        return stage.value === null ? null : project(stage.value);
+      },
+      acquire: async () => project(await stage.acquire())
+    };
+  }
+}
+function lazyMember(label, value, asyncMethods, hint) {
+  const isAsync = (property) => typeof property === "string" && asyncMethods.includes(property);
+  return new Proxy({}, {
+    get(_target, property) {
+      const live = value.current;
+      if (live) {
+        const member = Reflect.get(live, property, live);
+        return typeof member === "function" ? member.bind(live) : member;
+      }
+      if (isAsync(property)) {
+        return async (...args) => {
+          const initialized = await value.acquire();
+          const method = Reflect.get(initialized, property, initialized);
+          return method.apply(initialized, args);
+        };
+      }
+      if (typeof property === "symbol" || property === "then" || property === "constructor") return void 0;
+      throw new import_test_wood.TestWoodError(
+        `${label}.${property} is not available before the runtime is initialized; ${hint}`
+      );
+    },
+    has(_target, property) {
+      const live = value.current;
+      return live ? property in live : isAsync(property);
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LazyRuntimeStage,
+  lazyMember
+});
+//# sourceMappingURL=wood_lazy_runtime.cjs.map

package/dist/testing/wood_lazy_runtime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/wood_lazy_runtime.ts"],"sourcesContent":["/**\n * Lazy, once-only runtime stages for `testWood(configPath)` environments.\n *\n * `build()` records registrations and installs overlays; the managed router,\n * `compose.start()` and the renderer tier are only initialized on the first\n * explicit use. Concurrent first uses share one initialization; a failed\n * initialization rolls the environment back (through the supplied rollback)\n * and every later use observes the same failure.\n */\nimport { TestWoodError } from './test_wood.cjs';\n\n/** A value that is initialized on first `acquire()` and readable once live. */\nexport interface LazyValue<T> {\n  readonly current: T | null;\n  acquire(): Promise<T>;\n}\n\nexport class LazyRuntimeStage<T> implements LazyValue<T> {\n  private pending: Promise<T> | null = null;\n  /** The bare `init()` attempt, settled (never rejecting) — excludes rollback. */\n  private attempt: Promise<void> | null = null;\n  private value: T | null = null;\n\n  constructor(\n    private readonly init: () => Promise<T>,\n    private readonly rollback: (error: unknown) => Promise<never>,\n  ) {}\n\n  /** The initialized value, or null while this stage has not been used yet. */\n  get current(): T | null {\n    return this.value;\n  }\n\n  /** True once initialization has been requested (whether or not it finished). */\n  get requested(): boolean {\n    return this.pending !== null;\n  }\n\n  /** Initialize exactly once; concurrent callers share the same promise. */\n  acquire(): Promise<T> {\n    if (!this.pending) {\n      const attempt = this.init();\n      this.attempt = attempt.then(() => undefined, () => undefined);\n      this.pending = attempt.then(\n        (value) => {\n          this.value = value;\n          return value;\n        },\n        (error) => this.rollback(error),\n      );\n    }\n    return this.pending;\n  }\n\n  /**\n   * Resolves once an in-flight initialization attempt has finished (either\n   * way); immediately when none was requested. Deliberately excludes the\n   * rollback so a disposer invoked *by* the rollback never waits on itself.\n   */\n  settled(): Promise<void> {\n    return this.attempt ?? Promise.resolve();\n  }\n\n  /** A derived view over one member of the initialized value. */\n  map<U>(project: (value: T) => U): LazyValue<U> {\n    const stage = this;\n    return {\n      get current() {\n        return stage.value === null ? null : project(stage.value);\n      },\n      acquire: async () => project(await stage.acquire()),\n    };\n  }\n}\n\n/**\n * A member whose runtime is initialized on first use. Async methods listed in\n * `asyncMethods` initialize the runtime and then delegate; every other member\n * delegates once initialized and fails with guidance before that.\n */\nexport function lazyMember<T extends object>(\n  label: string,\n  value: LazyValue<T>,\n  asyncMethods: ReadonlyArray<keyof T & string>,\n  hint: string,\n): T {\n  const isAsync = (property: PropertyKey): property is keyof T & string =>\n    typeof property === 'string' && asyncMethods.includes(property as keyof T & string);\n  return new Proxy({} as T, {\n    get(_target, property) {\n      const live = value.current;\n      if (live) {\n        const member = Reflect.get(live as object, property, live);\n        return typeof member === 'function' ? member.bind(live) : member;\n      }\n      if (isAsync(property)) {\n        return async (...args: unknown[]): Promise<unknown> => {\n          const initialized = await value.acquire();\n          const method = Reflect.get(initialized as object, property, initialized) as (...a: unknown[]) => unknown;\n          return method.apply(initialized, args);\n        };\n      }\n      // Promise resolution and inspection probe these; never treat them as use.\n      if (typeof property === 'symbol' || property === 'then' || property === 'constructor') return undefined;\n      throw new TestWoodError(\n        `${label}.${property} is not available before the runtime is initialized; ${hint}`,\n      );\n    },\n    has(_target, property) {\n      const live = value.current;\n      return live ? property in (live as object) : isAsync(property);\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,uBAA8B;AAQvB,MAAM,iBAA4C;AAAA,EAMvD,YACmB,MACA,UACjB;AAFiB;AACA;AAPnB,SAAQ,UAA6B;AAErC;AAAA,SAAQ,UAAgC;AACxC,SAAQ,QAAkB;AAAA,EAKvB;AAAA;AAAA,EAGH,IAAI,UAAoB;AACtB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,YAAqB;AACvB,WAAO,KAAK,YAAY;AAAA,EAC1B;AAAA;AAAA,EAGA,UAAsB;AACpB,QAAI,CAAC,KAAK,SAAS;AACjB,YAAM,UAAU,KAAK,KAAK;AAC1B,WAAK,UAAU,QAAQ,KAAK,MAAM,QAAW,MAAM,MAAS;AAC5D,WAAK,UAAU,QAAQ;AAAA,QACrB,CAAC,UAAU;AACT,eAAK,QAAQ;AACb,iBAAO;AAAA,QACT;AAAA,QACA,CAAC,UAAU,KAAK,SAAS,KAAK;AAAA,MAChC;AAAA,IACF;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,UAAyB;AACvB,WAAO,KAAK,WAAW,QAAQ,QAAQ;AAAA,EACzC;AAAA;AAAA,EAGA,IAAO,SAAwC;AAC7C,UAAM,QAAQ;AACd,WAAO;AAAA,MACL,IAAI,UAAU;AACZ,eAAO,MAAM,UAAU,OAAO,OAAO,QAAQ,MAAM,KAAK;AAAA,MAC1D;AAAA,MACA,SAAS,YAAY,QAAQ,MAAM,MAAM,QAAQ,CAAC;AAAA,IACpD;AAAA,EACF;AACF;AAOO,SAAS,WACd,OACA,OACA,cACA,MACG;AACH,QAAM,UAAU,CAAC,aACf,OAAO,aAAa,YAAY,aAAa,SAAS,QAA4B;AACpF,SAAO,IAAI,MAAM,CAAC,GAAQ;AAAA,IACxB,IAAI,SAAS,UAAU;AACrB,YAAM,OAAO,MAAM;AACnB,UAAI,MAAM;AACR,cAAM,SAAS,QAAQ,IAAI,MAAgB,UAAU,IAAI;AACzD,eAAO,OAAO,WAAW,aAAa,OAAO,KAAK,IAAI,IAAI;AAAA,MAC5D;AACA,UAAI,QAAQ,QAAQ,GAAG;AACrB,eAAO,UAAU,SAAsC;AACrD,gBAAM,cAAc,MAAM,MAAM,QAAQ;AACxC,gBAAM,SAAS,QAAQ,IAAI,aAAuB,UAAU,WAAW;AACvE,iBAAO,OAAO,MAAM,aAAa,IAAI;AAAA,QACvC;AAAA,MACF;AAEA,UAAI,OAAO,aAAa,YAAY,aAAa,UAAU,aAAa,cAAe,QAAO;AAC9F,YAAM,IAAI;AAAA,QACR,GAAG,KAAK,IAAI,QAAQ,wDAAwD,IAAI;AAAA,MAClF;AAAA,IACF;AAAA,IACA,IAAI,SAAS,UAAU;AACrB,YAAM,OAAO,MAAM;AACnB,aAAO,OAAO,YAAa,OAAkB,QAAQ,QAAQ;AAAA,IAC/D;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/testing/wood_lazy_runtime.d.cts

@@ -0,0 +1,36 @@
+/** A value that is initialized on first `acquire()` and readable once live. */
+interface LazyValue<T> {
+    readonly current: T | null;
+    acquire(): Promise<T>;
+}
+declare class LazyRuntimeStage<T> implements LazyValue<T> {
+    private readonly init;
+    private readonly rollback;
+    private pending;
+    /** The bare `init()` attempt, settled (never rejecting) — excludes rollback. */
+    private attempt;
+    private value;
+    constructor(init: () => Promise<T>, rollback: (error: unknown) => Promise<never>);
+    /** The initialized value, or null while this stage has not been used yet. */
+    get current(): T | null;
+    /** True once initialization has been requested (whether or not it finished). */
+    get requested(): boolean;
+    /** Initialize exactly once; concurrent callers share the same promise. */
+    acquire(): Promise<T>;
+    /**
+     * Resolves once an in-flight initialization attempt has finished (either
+     * way); immediately when none was requested. Deliberately excludes the
+     * rollback so a disposer invoked *by* the rollback never waits on itself.
+     */
+    settled(): Promise<void>;
+    /** A derived view over one member of the initialized value. */
+    map<U>(project: (value: T) => U): LazyValue<U>;
+}
+/**
+ * A member whose runtime is initialized on first use. Async methods listed in
+ * `asyncMethods` initialize the runtime and then delegate; every other member
+ * delegates once initialized and fails with guidance before that.
+ */
+declare function lazyMember<T extends object>(label: string, value: LazyValue<T>, asyncMethods: ReadonlyArray<keyof T & string>, hint: string): T;
+
+export { LazyRuntimeStage, type LazyValue, lazyMember };

package/dist/testing/wood_lazy_runtime.d.ts

@@ -0,0 +1,36 @@
+/** A value that is initialized on first `acquire()` and readable once live. */
+interface LazyValue<T> {
+    readonly current: T | null;
+    acquire(): Promise<T>;
+}
+declare class LazyRuntimeStage<T> implements LazyValue<T> {
+    private readonly init;
+    private readonly rollback;
+    private pending;
+    /** The bare `init()` attempt, settled (never rejecting) — excludes rollback. */
+    private attempt;
+    private value;
+    constructor(init: () => Promise<T>, rollback: (error: unknown) => Promise<never>);
+    /** The initialized value, or null while this stage has not been used yet. */
+    get current(): T | null;
+    /** True once initialization has been requested (whether or not it finished). */
+    get requested(): boolean;
+    /** Initialize exactly once; concurrent callers share the same promise. */
+    acquire(): Promise<T>;
+    /**
+     * Resolves once an in-flight initialization attempt has finished (either
+     * way); immediately when none was requested. Deliberately excludes the
+     * rollback so a disposer invoked *by* the rollback never waits on itself.
+     */
+    settled(): Promise<void>;
+    /** A derived view over one member of the initialized value. */
+    map<U>(project: (value: T) => U): LazyValue<U>;
+}
+/**
+ * A member whose runtime is initialized on first use. Async methods listed in
+ * `asyncMethods` initialize the runtime and then delegate; every other member
+ * delegates once initialized and fails with guidance before that.
+ */
+declare function lazyMember<T extends object>(label: string, value: LazyValue<T>, asyncMethods: ReadonlyArray<keyof T & string>, hint: string): T;
+
+export { LazyRuntimeStage, type LazyValue, lazyMember };

package/dist/testing/wood_lazy_runtime.js

@@ -0,0 +1,84 @@
+import { TestWoodError } from "./test_wood.js";
+class LazyRuntimeStage {
+  constructor(init, rollback) {
+    this.init = init;
+    this.rollback = rollback;
+    this.pending = null;
+    /** The bare `init()` attempt, settled (never rejecting) — excludes rollback. */
+    this.attempt = null;
+    this.value = null;
+  }
+  /** The initialized value, or null while this stage has not been used yet. */
+  get current() {
+    return this.value;
+  }
+  /** True once initialization has been requested (whether or not it finished). */
+  get requested() {
+    return this.pending !== null;
+  }
+  /** Initialize exactly once; concurrent callers share the same promise. */
+  acquire() {
+    if (!this.pending) {
+      const attempt = this.init();
+      this.attempt = attempt.then(() => void 0, () => void 0);
+      this.pending = attempt.then(
+        (value) => {
+          this.value = value;
+          return value;
+        },
+        (error) => this.rollback(error)
+      );
+    }
+    return this.pending;
+  }
+  /**
+   * Resolves once an in-flight initialization attempt has finished (either
+   * way); immediately when none was requested. Deliberately excludes the
+   * rollback so a disposer invoked *by* the rollback never waits on itself.
+   */
+  settled() {
+    return this.attempt ?? Promise.resolve();
+  }
+  /** A derived view over one member of the initialized value. */
+  map(project) {
+    const stage = this;
+    return {
+      get current() {
+        return stage.value === null ? null : project(stage.value);
+      },
+      acquire: async () => project(await stage.acquire())
+    };
+  }
+}
+function lazyMember(label, value, asyncMethods, hint) {
+  const isAsync = (property) => typeof property === "string" && asyncMethods.includes(property);
+  return new Proxy({}, {
+    get(_target, property) {
+      const live = value.current;
+      if (live) {
+        const member = Reflect.get(live, property, live);
+        return typeof member === "function" ? member.bind(live) : member;
+      }
+      if (isAsync(property)) {
+        return async (...args) => {
+          const initialized = await value.acquire();
+          const method = Reflect.get(initialized, property, initialized);
+          return method.apply(initialized, args);
+        };
+      }
+      if (typeof property === "symbol" || property === "then" || property === "constructor") return void 0;
+      throw new TestWoodError(
+        `${label}.${property} is not available before the runtime is initialized; ${hint}`
+      );
+    },
+    has(_target, property) {
+      const live = value.current;
+      return live ? property in live : isAsync(property);
+    }
+  });
+}
+export {
+  LazyRuntimeStage,
+  lazyMember
+};
+//# sourceMappingURL=wood_lazy_runtime.js.map