@noego/wood 0.4.10 → 0.5.0

package/dist/testing/wood_env_renderer.js

@@ -0,0 +1,188 @@
+import { ExecutionContext, LoadAs } from "@noego/ioc";
+import { InProcessRouterTransport } from "../transport/in_process_router_transport.js";
+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 {
+  createFrontendSurface
+} 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) {
+  const cache = /* @__PURE__ */ new Map();
+  return (identity) => {
+    let pending = cache.get(identity);
+    if (!pending) {
+      pending = importDefaultExport(
+        importer,
+        source.rendererControllerFile(identity),
+        `renderer controller "${identity}"`
+      );
+      cache.set(identity, pending);
+    }
+    return pending;
+  };
+}
+async function loadPageHost(source, importer, dom) {
+  if (dom === "chromium") {
+    throw new TestWoodError("select({ dom: 'chromium' }) is not available yet; use 'happy-dom'");
+  }
+  if (typeof document === "undefined") {
+    throw new TestWoodError(
+      "select({ dom: 'happy-dom' }) requires a DOM environment (// @vitest-environment happy-dom)"
+    );
+  }
+  const hostPath = source.hookModule(source.config.renderer.testing?.host);
+  if (!hostPath) {
+    throw new TestWoodError(
+      "select({ dom }) requires renderer.testing.host in wood.config.yml (a module whose default export mounts a page)"
+    );
+  }
+  return importDefaultExport(importer, hostPath, "renderer.testing.host");
+}
+class MountKeeper {
+  constructor(host) {
+    this.host = host;
+    this.mounted = null;
+    this.mountedFor = null;
+  }
+  get target() {
+    if (!this.mounted) throw new TestWoodError("no page is mounted; open(page) first");
+    return this.mounted.target;
+  }
+  async flush() {
+    await this.mounted?.flush?.();
+  }
+  sync(current) {
+    if (current === this.mountedFor) return;
+    this.unmount();
+    if (!current) return;
+    const target = document.createElement("div");
+    document.body.appendChild(target);
+    this.mounted = this.host(current.identity, current, target);
+    this.mountedFor = current;
+  }
+  unmount() {
+    this.mounted?.unmount();
+    this.mounted?.target.remove();
+    this.mounted = null;
+    this.mountedFor = null;
+  }
+}
+function domDriver(keeper) {
+  const find = (selector) => {
+    const found = keeper.target.querySelector(selector);
+    if (!found) throw new TestWoodError(`no element matches "${selector}"`);
+    return found;
+  };
+  return {
+    get target() {
+      return keeper.target;
+    },
+    async click(selector) {
+      find(selector).click();
+      await keeper.flush();
+    },
+    async type(selector, text) {
+      const input = find(selector);
+      input.focus();
+      input.value = text;
+      input.dispatchEvent(new Event("input", { bubbles: true }));
+      await keeper.flush();
+    },
+    async submit(selector) {
+      find(selector).dispatchEvent(new Event("submit", { bubbles: true, cancelable: true }));
+      await keeper.flush();
+    },
+    async text(selector) {
+      return keeper.target.querySelector(selector)?.textContent ?? "";
+    },
+    async exists(selector) {
+      return keeper.target.querySelector(selector) !== null;
+    }
+  };
+}
+async function buildRendererTier(options) {
+  const { source, router, catalog, operations, importer, hooks, dom } = 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 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) } : {}
+  });
+  currentOwner = () => {
+    const current = frontend.current();
+    return current ? `page ${current.identity}` : "application";
+  };
+  const syncMount = async () => {
+    if (!keeper) return;
+    keeper.sync(frontend.current());
+    await keeper.flush();
+  };
+  const settle = async () => {
+    await frontend.settle();
+    if (!keeper) return;
+    await syncMount();
+    await new Promise((resolve) => setTimeout(resolve, 0));
+    await keeper.flush();
+  };
+  return {
+    frontend,
+    events: innerTransport.events,
+    rendererRoot,
+    async open(page, params, query) {
+      const opened = await frontend.open({
+        page,
+        ...params ? { params } : {},
+        ...query ? { query } : {}
+      });
+      await syncMount();
+      return opened;
+    },
+    async navigate(page, params, query) {
+      if (!frontend.current()) throw new TestWoodError("navigate() needs an open page; call open(page) first");
+      await frontend.act(() => navigation.go(page, params, query));
+      await syncMount();
+      const current = frontend.current();
+      if (!current) throw new TestWoodError(`navigate("${page}") left no page open`);
+      return current;
+    },
+    current: () => frontend.current(),
+    settle,
+    pendingWork: () => registry.pending(),
+    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();
+      });
+    }
+  };
+}
+export {
+  buildRendererTier
+};
+//# sourceMappingURL=wood_env_renderer.js.map

package/dist/testing/wood_env_renderer.js.map

@@ -0,0 +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":[]}

package/dist/testing/wood_test_selection.cjs

@@ -0,0 +1,94 @@
+"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_test_selection_exports = {};
+__export(wood_test_selection_exports, {
+  resolveSelection: () => resolveSelection,
+  selectCatalog: () => selectCatalog,
+  selectOperations: () => selectOperations
+});
+module.exports = __toCommonJS(wood_test_selection_exports);
+var import_page_catalog = require("../frontend/page_catalog.js");
+var import_test_wood = require("./test_wood.cjs");
+const DOM_MODES = ["happy-dom", "chromium"];
+function isMainSelection(value) {
+  if (value === true) return true;
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  const hasOperation = typeof candidate.operation === "string" && candidate.operation.length > 0;
+  const hasModule = typeof candidate.module === "string" && candidate.module.length > 0;
+  return hasOperation !== hasModule;
+}
+function isPagesSelection(value) {
+  if (value === true) return true;
+  return Array.isArray(value) && value.length > 0 && value.every((entry) => typeof entry === "string" && entry.length > 0);
+}
+function resolveSelection(selection) {
+  if (!selection || typeof selection !== "object") {
+    throw new import_test_wood.TestWoodError("select() requires { main }, { pages }, or both (plus optional dom)");
+  }
+  const { main, pages, dom } = selection;
+  if (main !== void 0 && !isMainSelection(main)) {
+    throw new import_test_wood.TestWoodError("select({ main }) must be true, { operation: string } or { module: string }");
+  }
+  if (pages !== void 0 && !isPagesSelection(pages)) {
+    throw new import_test_wood.TestWoodError("select({ pages }) must be true or a non-empty list of page identities");
+  }
+  if (dom !== void 0 && !DOM_MODES.includes(dom)) {
+    throw new import_test_wood.TestWoodError(`select({ dom }) must be one of: ${DOM_MODES.join(", ")}`);
+  }
+  if (dom !== void 0 && pages === void 0) {
+    throw new import_test_wood.TestWoodError("select({ dom }) requires { pages }: a component needs a page to mount");
+  }
+  if (main === void 0 && pages === void 0) {
+    throw new import_test_wood.TestWoodError("select() built nothing: add { main } and/or { pages }");
+  }
+  return { main: main ?? true, pages: pages ?? null, dom: dom ?? null };
+}
+function operationIdentities(operations) {
+  if (!operations.size) return "the config defines no operations";
+  return `available operations:
+  ${[...operations.keys()].join("\n  ")}`;
+}
+function selectOperations(all, main) {
+  if (main === true) return new Map(all);
+  if ("module" in main) {
+    const matched = new Map([...all].filter(([, operation]) => operation.module === main.module));
+    if (matched.size) return matched;
+    const modules = [...new Set([...all.values()].map((operation) => operation.module).filter(Boolean))];
+    throw new import_test_wood.TestWoodError(
+      `unknown module "${main.module}"; ` + (modules.length ? `available modules: ${modules.join(", ")}` : "the config defines no modules")
+    );
+  }
+  const match = all.get(main.operation);
+  if (!match) {
+    throw new import_test_wood.TestWoodError(`no operation matches "${main.operation}"; ${operationIdentities(all)}`);
+  }
+  return /* @__PURE__ */ new Map([[main.operation, match]]);
+}
+function selectCatalog(views, pages) {
+  const catalog = new import_page_catalog.PageCatalog(views);
+  return pages === true ? catalog : catalog.select({ pages });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  resolveSelection,
+  selectCatalog,
+  selectOperations
+});
+//# sourceMappingURL=wood_test_selection.cjs.map

package/dist/testing/wood_test_selection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/wood_test_selection.ts"],"sourcesContent":["/**\n * `testWood(configPath).select({...})` — one declarative object says which\n * tiers exist and how they are observed:\n *\n *   main   true | { operation } | { module }   the router + real controllers\n *   pages  true | [identity, ...]              the renderer page catalog\n *   dom    'happy-dom' | 'chromium'            the page's real component\n *\n * A key that is absent is not built. `pages` implies `main: true`; `dom`\n * requires `pages`. Nothing opens at build — tests drive `open()`.\n */\nimport type { OperationDef, ViewDef } from '../types/index.cjs';\nimport { PageCatalog } from '../frontend/page_catalog.js';\nimport { TestWoodError } from './test_wood.cjs';\n\nexport type WoodMainSelection = true | { operation: string } | { module: string };\nexport type WoodDomMode = 'happy-dom' | 'chromium';\n\nexport interface WoodTestSelection {\n  main?: WoodMainSelection;\n  pages?: true | string[];\n  dom?: WoodDomMode;\n}\n\nexport interface ResolvedWoodSelection {\n  readonly main: WoodMainSelection;\n  readonly pages: true | string[] | null;\n  readonly dom: WoodDomMode | null;\n}\n\nconst DOM_MODES: readonly WoodDomMode[] = ['happy-dom', 'chromium'];\n\nfunction isMainSelection(value: unknown): value is WoodMainSelection {\n  if (value === true) return true;\n  if (!value || typeof value !== 'object') return false;\n  const candidate = value as { operation?: unknown; module?: unknown };\n  const hasOperation = typeof candidate.operation === 'string' && candidate.operation.length > 0;\n  const hasModule = typeof candidate.module === 'string' && candidate.module.length > 0;\n  return hasOperation !== hasModule;\n}\n\nfunction isPagesSelection(value: unknown): value is true | string[] {\n  if (value === true) return true;\n  return Array.isArray(value)\n    && value.length > 0\n    && value.every((entry) => typeof entry === 'string' && entry.length > 0);\n}\n\nexport function resolveSelection(selection: WoodTestSelection | null): ResolvedWoodSelection {\n  if (!selection || typeof selection !== 'object') {\n    throw new TestWoodError('select() requires { main }, { pages }, or both (plus optional dom)');\n  }\n  const { main, pages, dom } = selection;\n  if (main !== undefined && !isMainSelection(main)) {\n    throw new TestWoodError('select({ main }) must be true, { operation: string } or { module: string }');\n  }\n  if (pages !== undefined && !isPagesSelection(pages)) {\n    throw new TestWoodError('select({ pages }) must be true or a non-empty list of page identities');\n  }\n  if (dom !== undefined && !DOM_MODES.includes(dom)) {\n    throw new TestWoodError(`select({ dom }) must be one of: ${DOM_MODES.join(', ')}`);\n  }\n  if (dom !== undefined && pages === undefined) {\n    throw new TestWoodError('select({ dom }) requires { pages }: a component needs a page to mount');\n  }\n  if (main === undefined && pages === undefined) {\n    throw new TestWoodError('select() built nothing: add { main } and/or { pages }');\n  }\n  return { main: main ?? true, pages: pages ?? null, dom: dom ?? null };\n}\n\nfunction operationIdentities(operations: Map<string, OperationDef>): string {\n  if (!operations.size) return 'the config defines no operations';\n  return `available operations:\\n  ${[...operations.keys()].join('\\n  ')}`;\n}\n\n/** Narrow the production operations to the selected main aperture. */\nexport function selectOperations(\n  all: Map<string, OperationDef>,\n  main: WoodMainSelection,\n): Map<string, OperationDef> {\n  if (main === true) return new Map(all);\n  if ('module' in main) {\n    const matched = new Map([...all].filter(([, operation]) => operation.module === main.module));\n    if (matched.size) return matched;\n    const modules = [...new Set([...all.values()].map((operation) => operation.module).filter(Boolean))];\n    throw new TestWoodError(\n      `unknown module \"${main.module}\"; ` +\n      (modules.length ? `available modules: ${modules.join(', ')}` : 'the config defines no modules'),\n    );\n  }\n  const match = all.get(main.operation);\n  if (!match) {\n    throw new TestWoodError(`no operation matches \"${main.operation}\"; ${operationIdentities(all)}`);\n  }\n  return new Map([[main.operation, match]]);\n}\n\n/** The renderer aperture: every production page, or exactly the named ones. */\nexport function selectCatalog(views: ViewDef[], pages: true | string[]): PageCatalog {\n  const catalog = new PageCatalog(views);\n  return pages === true ? catalog : catalog.select({ pages });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAYA,0BAA4B;AAC5B,uBAA8B;AAiB9B,MAAM,YAAoC,CAAC,aAAa,UAAU;AAElE,SAAS,gBAAgB,OAA4C;AACnE,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAClB,QAAM,eAAe,OAAO,UAAU,cAAc,YAAY,UAAU,UAAU,SAAS;AAC7F,QAAM,YAAY,OAAO,UAAU,WAAW,YAAY,UAAU,OAAO,SAAS;AACpF,SAAO,iBAAiB;AAC1B;AAEA,SAAS,iBAAiB,OAA0C;AAClE,MAAI,UAAU,KAAM,QAAO;AAC3B,SAAO,MAAM,QAAQ,KAAK,KACrB,MAAM,SAAS,KACf,MAAM,MAAM,CAAC,UAAU,OAAO,UAAU,YAAY,MAAM,SAAS,CAAC;AAC3E;AAEO,SAAS,iBAAiB,WAA4D;AAC3F,MAAI,CAAC,aAAa,OAAO,cAAc,UAAU;AAC/C,UAAM,IAAI,+BAAc,oEAAoE;AAAA,EAC9F;AACA,QAAM,EAAE,MAAM,OAAO,IAAI,IAAI;AAC7B,MAAI,SAAS,UAAa,CAAC,gBAAgB,IAAI,GAAG;AAChD,UAAM,IAAI,+BAAc,4EAA4E;AAAA,EACtG;AACA,MAAI,UAAU,UAAa,CAAC,iBAAiB,KAAK,GAAG;AACnD,UAAM,IAAI,+BAAc,uEAAuE;AAAA,EACjG;AACA,MAAI,QAAQ,UAAa,CAAC,UAAU,SAAS,GAAG,GAAG;AACjD,UAAM,IAAI,+BAAc,mCAAmC,UAAU,KAAK,IAAI,CAAC,EAAE;AAAA,EACnF;AACA,MAAI,QAAQ,UAAa,UAAU,QAAW;AAC5C,UAAM,IAAI,+BAAc,uEAAuE;AAAA,EACjG;AACA,MAAI,SAAS,UAAa,UAAU,QAAW;AAC7C,UAAM,IAAI,+BAAc,uDAAuD;AAAA,EACjF;AACA,SAAO,EAAE,MAAM,QAAQ,MAAM,OAAO,SAAS,MAAM,KAAK,OAAO,KAAK;AACtE;AAEA,SAAS,oBAAoB,YAA+C;AAC1E,MAAI,CAAC,WAAW,KAAM,QAAO;AAC7B,SAAO;AAAA,IAA4B,CAAC,GAAG,WAAW,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC;AACxE;AAGO,SAAS,iBACd,KACA,MAC2B;AAC3B,MAAI,SAAS,KAAM,QAAO,IAAI,IAAI,GAAG;AACrC,MAAI,YAAY,MAAM;AACpB,UAAM,UAAU,IAAI,IAAI,CAAC,GAAG,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,MAAM,UAAU,WAAW,KAAK,MAAM,CAAC;AAC5F,QAAI,QAAQ,KAAM,QAAO;AACzB,UAAM,UAAU,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,UAAU,MAAM,EAAE,OAAO,OAAO,CAAC,CAAC;AACnG,UAAM,IAAI;AAAA,MACR,mBAAmB,KAAK,MAAM,SAC7B,QAAQ,SAAS,sBAAsB,QAAQ,KAAK,IAAI,CAAC,KAAK;AAAA,IACjE;AAAA,EACF;AACA,QAAM,QAAQ,IAAI,IAAI,KAAK,SAAS;AACpC,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,+BAAc,yBAAyB,KAAK,SAAS,MAAM,oBAAoB,GAAG,CAAC,EAAE;AAAA,EACjG;AACA,SAAO,oBAAI,IAAI,CAAC,CAAC,KAAK,WAAW,KAAK,CAAC,CAAC;AAC1C;AAGO,SAAS,cAAc,OAAkB,OAAqC;AACnF,QAAM,UAAU,IAAI,gCAAY,KAAK;AACrC,SAAO,UAAU,OAAO,UAAU,QAAQ,OAAO,EAAE,MAAM,CAAC;AAC5D;","names":[]}

package/dist/testing/wood_test_selection.d.cts

@@ -0,0 +1,39 @@
+import { OperationDef } from '../types/operations.cjs';
+import { ViewDef } from '../types/views.cjs';
+import { PageCatalog } from '../frontend/page_catalog.cjs';
+
+/**
+ * `testWood(configPath).select({...})` — one declarative object says which
+ * tiers exist and how they are observed:
+ *
+ *   main   true | { operation } | { module }   the router + real controllers
+ *   pages  true | [identity, ...]              the renderer page catalog
+ *   dom    'happy-dom' | 'chromium'            the page's real component
+ *
+ * A key that is absent is not built. `pages` implies `main: true`; `dom`
+ * requires `pages`. Nothing opens at build — tests drive `open()`.
+ */
+
+type WoodMainSelection = true | {
+    operation: string;
+} | {
+    module: string;
+};
+type WoodDomMode = 'happy-dom' | 'chromium';
+interface WoodTestSelection {
+    main?: WoodMainSelection;
+    pages?: true | string[];
+    dom?: WoodDomMode;
+}
+interface ResolvedWoodSelection {
+    readonly main: WoodMainSelection;
+    readonly pages: true | string[] | null;
+    readonly dom: WoodDomMode | null;
+}
+declare function resolveSelection(selection: WoodTestSelection | null): ResolvedWoodSelection;
+/** Narrow the production operations to the selected main aperture. */
+declare function selectOperations(all: Map<string, OperationDef>, main: WoodMainSelection): Map<string, OperationDef>;
+/** The renderer aperture: every production page, or exactly the named ones. */
+declare function selectCatalog(views: ViewDef[], pages: true | string[]): PageCatalog;
+
+export { type ResolvedWoodSelection, type WoodDomMode, type WoodMainSelection, type WoodTestSelection, resolveSelection, selectCatalog, selectOperations };

package/dist/testing/wood_test_selection.d.ts

@@ -0,0 +1,39 @@
+import { OperationDef } from '../types/operations.js';
+import { ViewDef } from '../types/views.js';
+import { PageCatalog } from '../frontend/page_catalog.js';
+
+/**
+ * `testWood(configPath).select({...})` — one declarative object says which
+ * tiers exist and how they are observed:
+ *
+ *   main   true | { operation } | { module }   the router + real controllers
+ *   pages  true | [identity, ...]              the renderer page catalog
+ *   dom    'happy-dom' | 'chromium'            the page's real component
+ *
+ * A key that is absent is not built. `pages` implies `main: true`; `dom`
+ * requires `pages`. Nothing opens at build — tests drive `open()`.
+ */
+
+type WoodMainSelection = true | {
+    operation: string;
+} | {
+    module: string;
+};
+type WoodDomMode = 'happy-dom' | 'chromium';
+interface WoodTestSelection {
+    main?: WoodMainSelection;
+    pages?: true | string[];
+    dom?: WoodDomMode;
+}
+interface ResolvedWoodSelection {
+    readonly main: WoodMainSelection;
+    readonly pages: true | string[] | null;
+    readonly dom: WoodDomMode | null;
+}
+declare function resolveSelection(selection: WoodTestSelection | null): ResolvedWoodSelection;
+/** Narrow the production operations to the selected main aperture. */
+declare function selectOperations(all: Map<string, OperationDef>, main: WoodMainSelection): Map<string, OperationDef>;
+/** The renderer aperture: every production page, or exactly the named ones. */
+declare function selectCatalog(views: ViewDef[], pages: true | string[]): PageCatalog;
+
+export { type ResolvedWoodSelection, type WoodDomMode, type WoodMainSelection, type WoodTestSelection, resolveSelection, selectCatalog, selectOperations };

package/dist/testing/wood_test_selection.js

@@ -0,0 +1,68 @@
+import { PageCatalog } from "../frontend/page_catalog.js";
+import { TestWoodError } from "./test_wood.js";
+const DOM_MODES = ["happy-dom", "chromium"];
+function isMainSelection(value) {
+  if (value === true) return true;
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  const hasOperation = typeof candidate.operation === "string" && candidate.operation.length > 0;
+  const hasModule = typeof candidate.module === "string" && candidate.module.length > 0;
+  return hasOperation !== hasModule;
+}
+function isPagesSelection(value) {
+  if (value === true) return true;
+  return Array.isArray(value) && value.length > 0 && value.every((entry) => typeof entry === "string" && entry.length > 0);
+}
+function resolveSelection(selection) {
+  if (!selection || typeof selection !== "object") {
+    throw new TestWoodError("select() requires { main }, { pages }, or both (plus optional dom)");
+  }
+  const { main, pages, dom } = selection;
+  if (main !== void 0 && !isMainSelection(main)) {
+    throw new TestWoodError("select({ main }) must be true, { operation: string } or { module: string }");
+  }
+  if (pages !== void 0 && !isPagesSelection(pages)) {
+    throw new TestWoodError("select({ pages }) must be true or a non-empty list of page identities");
+  }
+  if (dom !== void 0 && !DOM_MODES.includes(dom)) {
+    throw new TestWoodError(`select({ dom }) must be one of: ${DOM_MODES.join(", ")}`);
+  }
+  if (dom !== void 0 && pages === void 0) {
+    throw new TestWoodError("select({ dom }) requires { pages }: a component needs a page to mount");
+  }
+  if (main === void 0 && pages === void 0) {
+    throw new TestWoodError("select() built nothing: add { main } and/or { pages }");
+  }
+  return { main: main ?? true, pages: pages ?? null, dom: dom ?? null };
+}
+function operationIdentities(operations) {
+  if (!operations.size) return "the config defines no operations";
+  return `available operations:
+  ${[...operations.keys()].join("\n  ")}`;
+}
+function selectOperations(all, main) {
+  if (main === true) return new Map(all);
+  if ("module" in main) {
+    const matched = new Map([...all].filter(([, operation]) => operation.module === main.module));
+    if (matched.size) return matched;
+    const modules = [...new Set([...all.values()].map((operation) => operation.module).filter(Boolean))];
+    throw new TestWoodError(
+      `unknown module "${main.module}"; ` + (modules.length ? `available modules: ${modules.join(", ")}` : "the config defines no modules")
+    );
+  }
+  const match = all.get(main.operation);
+  if (!match) {
+    throw new TestWoodError(`no operation matches "${main.operation}"; ${operationIdentities(all)}`);
+  }
+  return /* @__PURE__ */ new Map([[main.operation, match]]);
+}
+function selectCatalog(views, pages) {
+  const catalog = new PageCatalog(views);
+  return pages === true ? catalog : catalog.select({ pages });
+}
+export {
+  resolveSelection,
+  selectCatalog,
+  selectOperations
+};
+//# sourceMappingURL=wood_test_selection.js.map

package/dist/testing/wood_test_selection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/wood_test_selection.ts"],"sourcesContent":["/**\n * `testWood(configPath).select({...})` — one declarative object says which\n * tiers exist and how they are observed:\n *\n *   main   true | { operation } | { module }   the router + real controllers\n *   pages  true | [identity, ...]              the renderer page catalog\n *   dom    'happy-dom' | 'chromium'            the page's real component\n *\n * A key that is absent is not built. `pages` implies `main: true`; `dom`\n * requires `pages`. Nothing opens at build — tests drive `open()`.\n */\nimport type { OperationDef, ViewDef } from '../types/index.js';\nimport { PageCatalog } from '../frontend/page_catalog.js';\nimport { TestWoodError } from './test_wood.js';\n\nexport type WoodMainSelection = true | { operation: string } | { module: string };\nexport type WoodDomMode = 'happy-dom' | 'chromium';\n\nexport interface WoodTestSelection {\n  main?: WoodMainSelection;\n  pages?: true | string[];\n  dom?: WoodDomMode;\n}\n\nexport interface ResolvedWoodSelection {\n  readonly main: WoodMainSelection;\n  readonly pages: true | string[] | null;\n  readonly dom: WoodDomMode | null;\n}\n\nconst DOM_MODES: readonly WoodDomMode[] = ['happy-dom', 'chromium'];\n\nfunction isMainSelection(value: unknown): value is WoodMainSelection {\n  if (value === true) return true;\n  if (!value || typeof value !== 'object') return false;\n  const candidate = value as { operation?: unknown; module?: unknown };\n  const hasOperation = typeof candidate.operation === 'string' && candidate.operation.length > 0;\n  const hasModule = typeof candidate.module === 'string' && candidate.module.length > 0;\n  return hasOperation !== hasModule;\n}\n\nfunction isPagesSelection(value: unknown): value is true | string[] {\n  if (value === true) return true;\n  return Array.isArray(value)\n    && value.length > 0\n    && value.every((entry) => typeof entry === 'string' && entry.length > 0);\n}\n\nexport function resolveSelection(selection: WoodTestSelection | null): ResolvedWoodSelection {\n  if (!selection || typeof selection !== 'object') {\n    throw new TestWoodError('select() requires { main }, { pages }, or both (plus optional dom)');\n  }\n  const { main, pages, dom } = selection;\n  if (main !== undefined && !isMainSelection(main)) {\n    throw new TestWoodError('select({ main }) must be true, { operation: string } or { module: string }');\n  }\n  if (pages !== undefined && !isPagesSelection(pages)) {\n    throw new TestWoodError('select({ pages }) must be true or a non-empty list of page identities');\n  }\n  if (dom !== undefined && !DOM_MODES.includes(dom)) {\n    throw new TestWoodError(`select({ dom }) must be one of: ${DOM_MODES.join(', ')}`);\n  }\n  if (dom !== undefined && pages === undefined) {\n    throw new TestWoodError('select({ dom }) requires { pages }: a component needs a page to mount');\n  }\n  if (main === undefined && pages === undefined) {\n    throw new TestWoodError('select() built nothing: add { main } and/or { pages }');\n  }\n  return { main: main ?? true, pages: pages ?? null, dom: dom ?? null };\n}\n\nfunction operationIdentities(operations: Map<string, OperationDef>): string {\n  if (!operations.size) return 'the config defines no operations';\n  return `available operations:\\n  ${[...operations.keys()].join('\\n  ')}`;\n}\n\n/** Narrow the production operations to the selected main aperture. */\nexport function selectOperations(\n  all: Map<string, OperationDef>,\n  main: WoodMainSelection,\n): Map<string, OperationDef> {\n  if (main === true) return new Map(all);\n  if ('module' in main) {\n    const matched = new Map([...all].filter(([, operation]) => operation.module === main.module));\n    if (matched.size) return matched;\n    const modules = [...new Set([...all.values()].map((operation) => operation.module).filter(Boolean))];\n    throw new TestWoodError(\n      `unknown module \"${main.module}\"; ` +\n      (modules.length ? `available modules: ${modules.join(', ')}` : 'the config defines no modules'),\n    );\n  }\n  const match = all.get(main.operation);\n  if (!match) {\n    throw new TestWoodError(`no operation matches \"${main.operation}\"; ${operationIdentities(all)}`);\n  }\n  return new Map([[main.operation, match]]);\n}\n\n/** The renderer aperture: every production page, or exactly the named ones. */\nexport function selectCatalog(views: ViewDef[], pages: true | string[]): PageCatalog {\n  const catalog = new PageCatalog(views);\n  return pages === true ? catalog : catalog.select({ pages });\n}\n"],"mappings":"AAYA,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB;AAiB9B,MAAM,YAAoC,CAAC,aAAa,UAAU;AAElE,SAAS,gBAAgB,OAA4C;AACnE,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAClB,QAAM,eAAe,OAAO,UAAU,cAAc,YAAY,UAAU,UAAU,SAAS;AAC7F,QAAM,YAAY,OAAO,UAAU,WAAW,YAAY,UAAU,OAAO,SAAS;AACpF,SAAO,iBAAiB;AAC1B;AAEA,SAAS,iBAAiB,OAA0C;AAClE,MAAI,UAAU,KAAM,QAAO;AAC3B,SAAO,MAAM,QAAQ,KAAK,KACrB,MAAM,SAAS,KACf,MAAM,MAAM,CAAC,UAAU,OAAO,UAAU,YAAY,MAAM,SAAS,CAAC;AAC3E;AAEO,SAAS,iBAAiB,WAA4D;AAC3F,MAAI,CAAC,aAAa,OAAO,cAAc,UAAU;AAC/C,UAAM,IAAI,cAAc,oEAAoE;AAAA,EAC9F;AACA,QAAM,EAAE,MAAM,OAAO,IAAI,IAAI;AAC7B,MAAI,SAAS,UAAa,CAAC,gBAAgB,IAAI,GAAG;AAChD,UAAM,IAAI,cAAc,4EAA4E;AAAA,EACtG;AACA,MAAI,UAAU,UAAa,CAAC,iBAAiB,KAAK,GAAG;AACnD,UAAM,IAAI,cAAc,uEAAuE;AAAA,EACjG;AACA,MAAI,QAAQ,UAAa,CAAC,UAAU,SAAS,GAAG,GAAG;AACjD,UAAM,IAAI,cAAc,mCAAmC,UAAU,KAAK,IAAI,CAAC,EAAE;AAAA,EACnF;AACA,MAAI,QAAQ,UAAa,UAAU,QAAW;AAC5C,UAAM,IAAI,cAAc,uEAAuE;AAAA,EACjG;AACA,MAAI,SAAS,UAAa,UAAU,QAAW;AAC7C,UAAM,IAAI,cAAc,uDAAuD;AAAA,EACjF;AACA,SAAO,EAAE,MAAM,QAAQ,MAAM,OAAO,SAAS,MAAM,KAAK,OAAO,KAAK;AACtE;AAEA,SAAS,oBAAoB,YAA+C;AAC1E,MAAI,CAAC,WAAW,KAAM,QAAO;AAC7B,SAAO;AAAA,IAA4B,CAAC,GAAG,WAAW,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC;AACxE;AAGO,SAAS,iBACd,KACA,MAC2B;AAC3B,MAAI,SAAS,KAAM,QAAO,IAAI,IAAI,GAAG;AACrC,MAAI,YAAY,MAAM;AACpB,UAAM,UAAU,IAAI,IAAI,CAAC,GAAG,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,SAAS,MAAM,UAAU,WAAW,KAAK,MAAM,CAAC;AAC5F,QAAI,QAAQ,KAAM,QAAO;AACzB,UAAM,UAAU,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,UAAU,MAAM,EAAE,OAAO,OAAO,CAAC,CAAC;AACnG,UAAM,IAAI;AAAA,MACR,mBAAmB,KAAK,MAAM,SAC7B,QAAQ,SAAS,sBAAsB,QAAQ,KAAK,IAAI,CAAC,KAAK;AAAA,IACjE;AAAA,EACF;AACA,QAAM,QAAQ,IAAI,IAAI,KAAK,SAAS;AACpC,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,cAAc,yBAAyB,KAAK,SAAS,MAAM,oBAAoB,GAAG,CAAC,EAAE;AAAA,EACjG;AACA,SAAO,oBAAI,IAAI,CAAC,CAAC,KAAK,WAAW,KAAK,CAAC,CAAC;AAC1C;AAGO,SAAS,cAAc,OAAkB,OAAqC;AACnF,QAAM,UAAU,IAAI,YAAY,KAAK;AACrC,SAAO,UAAU,OAAO,UAAU,QAAQ,OAAO,EAAE,MAAM,CAAC;AAC5D;","names":[]}

package/dist/trace-testing/index.d.cts

@@ -1,6 +1,5 @@
 export { TraceAssertions, TraceCountSummary, TraceFilter, TraceQuery, TraceRecorderEnableOptions, createTraceAssertions, createTraceQuery, matchesTrace, readPath } from '@noego/trace/testing';
 export { TraceRecorder } from './trace_recorder.cjs';
-import '../trace_hub-Cob54qRx.cjs';
+import '../trace_hub-Cpo_nVze.cjs';
 import 'rxjs';
 import '../tracing/trace_provider.cjs';
-import '@noego/ioc';

package/dist/trace-testing/index.d.ts

@@ -1,6 +1,5 @@
 export { TraceAssertions, TraceCountSummary, TraceFilter, TraceQuery, TraceRecorderEnableOptions, createTraceAssertions, createTraceQuery, matchesTrace, readPath } from '@noego/trace/testing';
 export { TraceRecorder } from './trace_recorder.js';
-import '../trace_hub-Cob54qRx.js';
+import '../trace_hub-Cpo_nVze.js';
 import 'rxjs';
 import '../tracing/trace_provider.js';
-import '@noego/ioc';

package/dist/trace-testing/trace_recorder.cjs

@@ -40,7 +40,7 @@ let TraceRecorder = class extends import_testing.TraceRecorder {
   }
 };
 TraceRecorder = __decorateClass([
-  (0, import_ioc.Component)({ scope: import_ioc.LoadAs.Singleton }),
+  (0, import_ioc.Component)({ scope: import_ioc.LoadAs.Scoped }),
   __decorateParam(0, (0, import_ioc.Inject)(import_tracing.TraceProvider))
 ], TraceRecorder);
 // Annotate the CommonJS export names for ESM import in node:

package/dist/trace-testing/trace_recorder.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/trace-testing/trace_recorder.ts"],"sourcesContent":["import { Component, Inject, LoadAs } from '@noego/ioc';\nimport {\n  TraceRecorder as BaseTraceRecorder,\n  type TraceObservableSource,\n  type TraceRecorderEnableOptions,\n  type TraceRecorderSource,\n  type TraceWaitOptions,\n} from '@noego/trace/testing';\nimport {\n  TraceProvider,\n  type FrameworkTracer,\n  type TraceEvent,\n} from '../tracing/index.js';\nimport { getTraceEvents$ } from '../tracing/trace_hub.js';\n\n@Component({ scope: LoadAs.Singleton })\nexport class TraceRecorder extends BaseTraceRecorder<TraceEvent> {\n  constructor(\n    @Inject(TraceProvider) traceProvider?: FrameworkTracer,\n  ) {\n    super(traceProvider ?? getTraceEvents$());\n  }\n}\n\nexport type {\n  TraceObservableSource,\n  TraceRecorderEnableOptions,\n  TraceRecorderSource,\n  TraceWaitOptions,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAA0C;AAC1C,qBAMO;AACP,qBAIO;AACP,uBAAgC;AAGzB,IAAM,gBAAN,cAA4B,eAAAA,cAA8B;AAAA,EAC/D,YACyB,eACvB;AACA,UAAM,qBAAiB,kCAAgB,CAAC;AAAA,EAC1C;AACF;AANa,gBAAN;AAAA,MADN,sBAAU,EAAE,OAAO,kBAAO,UAAU,CAAC;AAAA,EAGjC,0CAAO,4BAAa;AAAA,GAFZ;","names":["BaseTraceRecorder"]}
+{"version":3,"sources":["../../src/trace-testing/trace_recorder.ts"],"sourcesContent":["import { Component, Inject, LoadAs } from '@noego/ioc';\nimport {\n  TraceRecorder as BaseTraceRecorder,\n  type TraceObservableSource,\n  type TraceRecorderEnableOptions,\n  type TraceRecorderSource,\n  type TraceWaitOptions,\n} from '@noego/trace/testing';\nimport {\n  TraceProvider,\n  type FrameworkTracer,\n  type TraceEvent,\n} from '../tracing/index.js';\nimport { getTraceEvents$ } from '../tracing/trace_hub.js';\n\n// Scoped, not Singleton: TraceProvider injects SCOPED_CONTAINER and is\n// scope-bound, so a recorder capturing it must share that lifetime (a\n// Singleton capturing it silently promoted the provider before ioc 0.5's\n// captive-lifetime validation made the invariant explicit).\n@Component({ scope: LoadAs.Scoped })\nexport class TraceRecorder extends BaseTraceRecorder<TraceEvent> {\n  constructor(\n    @Inject(TraceProvider) traceProvider?: FrameworkTracer,\n  ) {\n    super(traceProvider ?? getTraceEvents$());\n  }\n}\n\nexport type {\n  TraceObservableSource,\n  TraceRecorderEnableOptions,\n  TraceRecorderSource,\n  TraceWaitOptions,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAA0C;AAC1C,qBAMO;AACP,qBAIO;AACP,uBAAgC;AAOzB,IAAM,gBAAN,cAA4B,eAAAA,cAA8B;AAAA,EAC/D,YACyB,eACvB;AACA,UAAM,qBAAiB,kCAAgB,CAAC;AAAA,EAC1C;AACF;AANa,gBAAN;AAAA,MADN,sBAAU,EAAE,OAAO,kBAAO,OAAO,CAAC;AAAA,EAG9B,0CAAO,4BAAa;AAAA,GAFZ;","names":["BaseTraceRecorder"]}

package/dist/trace-testing/trace_recorder.d.cts

@@ -1,9 +1,8 @@
 import { TraceRecorder as TraceRecorder$1 } from '@noego/trace/testing';
 export { TraceObservableSource, TraceRecorderEnableOptions, TraceRecorderSource, TraceWaitOptions } from '@noego/trace/testing';
-import { a as TraceEvent } from '../trace_hub-Cob54qRx.cjs';
+import { a as TraceEvent } from '../trace_hub-Cpo_nVze.cjs';
 import { FrameworkTracer } from '../tracing/trace_provider.cjs';
 import 'rxjs';
-import '@noego/ioc';
 
 declare class TraceRecorder extends TraceRecorder$1<TraceEvent> {
     constructor(traceProvider?: FrameworkTracer);

package/dist/trace-testing/trace_recorder.d.ts

@@ -1,9 +1,8 @@
 import { TraceRecorder as TraceRecorder$1 } from '@noego/trace/testing';
 export { TraceObservableSource, TraceRecorderEnableOptions, TraceRecorderSource, TraceWaitOptions } from '@noego/trace/testing';
-import { a as TraceEvent } from '../trace_hub-Cob54qRx.js';
+import { a as TraceEvent } from '../trace_hub-Cpo_nVze.js';
 import { FrameworkTracer } from '../tracing/trace_provider.js';
 import 'rxjs';
-import '@noego/ioc';
 
 declare class TraceRecorder extends TraceRecorder$1<TraceEvent> {
     constructor(traceProvider?: FrameworkTracer);

package/dist/trace-testing/trace_recorder.js

@@ -23,7 +23,7 @@ let TraceRecorder = class extends BaseTraceRecorder {
   }
 };
 TraceRecorder = __decorateClass([
-  Component({ scope: LoadAs.Singleton }),
+  Component({ scope: LoadAs.Scoped }),
   __decorateParam(0, Inject(TraceProvider))
 ], TraceRecorder);
 export {

package/dist/trace-testing/trace_recorder.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/trace-testing/trace_recorder.ts"],"sourcesContent":["import { Component, Inject, LoadAs } from '@noego/ioc';\nimport {\n  TraceRecorder as BaseTraceRecorder,\n  type TraceObservableSource,\n  type TraceRecorderEnableOptions,\n  type TraceRecorderSource,\n  type TraceWaitOptions,\n} from '@noego/trace/testing';\nimport {\n  TraceProvider,\n  type FrameworkTracer,\n  type TraceEvent,\n} from '../tracing/index.js';\nimport { getTraceEvents$ } from '../tracing/trace_hub.js';\n\n@Component({ scope: LoadAs.Singleton })\nexport class TraceRecorder extends BaseTraceRecorder<TraceEvent> {\n  constructor(\n    @Inject(TraceProvider) traceProvider?: FrameworkTracer,\n  ) {\n    super(traceProvider ?? getTraceEvents$());\n  }\n}\n\nexport type {\n  TraceObservableSource,\n  TraceRecorderEnableOptions,\n  TraceRecorderSource,\n  TraceWaitOptions,\n};\n"],"mappings":";;;;;;;;;;;AAAA,SAAS,WAAW,QAAQ,cAAc;AAC1C;AAAA,EACE,iBAAiB;AAAA,OAKZ;AACP;AAAA,EACE;AAAA,OAGK;AACP,SAAS,uBAAuB;AAGzB,IAAM,gBAAN,cAA4B,kBAA8B;AAAA,EAC/D,YACyB,eACvB;AACA,UAAM,iBAAiB,gBAAgB,CAAC;AAAA,EAC1C;AACF;AANa,gBAAN;AAAA,EADN,UAAU,EAAE,OAAO,OAAO,UAAU,CAAC;AAAA,EAGjC,0BAAO,aAAa;AAAA,GAFZ;","names":[]}
+{"version":3,"sources":["../../src/trace-testing/trace_recorder.ts"],"sourcesContent":["import { Component, Inject, LoadAs } from '@noego/ioc';\nimport {\n  TraceRecorder as BaseTraceRecorder,\n  type TraceObservableSource,\n  type TraceRecorderEnableOptions,\n  type TraceRecorderSource,\n  type TraceWaitOptions,\n} from '@noego/trace/testing';\nimport {\n  TraceProvider,\n  type FrameworkTracer,\n  type TraceEvent,\n} from '../tracing/index.js';\nimport { getTraceEvents$ } from '../tracing/trace_hub.js';\n\n// Scoped, not Singleton: TraceProvider injects SCOPED_CONTAINER and is\n// scope-bound, so a recorder capturing it must share that lifetime (a\n// Singleton capturing it silently promoted the provider before ioc 0.5's\n// captive-lifetime validation made the invariant explicit).\n@Component({ scope: LoadAs.Scoped })\nexport class TraceRecorder extends BaseTraceRecorder<TraceEvent> {\n  constructor(\n    @Inject(TraceProvider) traceProvider?: FrameworkTracer,\n  ) {\n    super(traceProvider ?? getTraceEvents$());\n  }\n}\n\nexport type {\n  TraceObservableSource,\n  TraceRecorderEnableOptions,\n  TraceRecorderSource,\n  TraceWaitOptions,\n};\n"],"mappings":";;;;;;;;;;;AAAA,SAAS,WAAW,QAAQ,cAAc;AAC1C;AAAA,EACE,iBAAiB;AAAA,OAKZ;AACP;AAAA,EACE;AAAA,OAGK;AACP,SAAS,uBAAuB;AAOzB,IAAM,gBAAN,cAA4B,kBAA8B;AAAA,EAC/D,YACyB,eACvB;AACA,UAAM,iBAAiB,gBAAgB,CAAC;AAAA,EAC1C;AACF;AANa,gBAAN;AAAA,EADN,UAAU,EAAE,OAAO,OAAO,OAAO,CAAC;AAAA,EAG9B,0BAAO,aAAa;AAAA,GAFZ;","names":[]}

package/dist/trace-transport/index.d.cts

@@ -2,5 +2,5 @@ export { RendererTraceBatchTransport } from '../tracing/renderer_trace_batch_tra
 export { WoodTraceBatchContract } from '../tracing/wood_trace_batch_contract.cjs';
 export { WoodRendererTraceEvent, WoodRendererTraceInput, WoodTraceBatch, WoodTraceBatchAcknowledgement, WoodTraceBatchAdmissionResult, WoodTraceBatchPort, WoodTraceBatchTransportOptions, WoodTraceBatchTransportStatus } from '../tracing/types/wood_trace_batch.types.cjs';
 import '@noego/telemetry/core';
-import '../trace_hub-Cob54qRx.cjs';
+import '../trace_hub-Cpo_nVze.cjs';
 import 'rxjs';

package/dist/trace-transport/index.d.ts

@@ -2,5 +2,5 @@ export { RendererTraceBatchTransport } from '../tracing/renderer_trace_batch_tra
 export { WoodTraceBatchContract } from '../tracing/wood_trace_batch_contract.js';
 export { WoodRendererTraceEvent, WoodRendererTraceInput, WoodTraceBatch, WoodTraceBatchAcknowledgement, WoodTraceBatchAdmissionResult, WoodTraceBatchPort, WoodTraceBatchTransportOptions, WoodTraceBatchTransportStatus } from '../tracing/types/wood_trace_batch.types.js';
 import '@noego/telemetry/core';
-import '../trace_hub-Cob54qRx.js';
+import '../trace_hub-Cpo_nVze.js';
 import 'rxjs';