@noego/wood 0.4.10 → 0.5.0

package/dist/testing/create_controller_harness.cjs

@@ -22,6 +22,7 @@ __export(create_controller_harness_exports, {
 });
 module.exports = __toCommonJS(create_controller_harness_exports);
 var import_node_fs = require("node:fs");
+var import_ioc = require("@noego/ioc");
 var import_client = require("../client/index.js");
 var import_ipc = require("../ipc/index.js");
 var import_navigation = require("../navigation/index.js");
@@ -29,6 +30,8 @@ var import_tracing = require("../tracing/index.js");
 var import_trace_testing = require("../trace-testing/index.js");
 var import_operations_parser = require("../parser/operations_parser.cjs");
 var import_controller_lifecycle = require("../controller/controller_lifecycle.cjs");
+var import_get_container = require("../runtime/get_container.js");
+var import_build_transport_bridge = require("../transport/build_transport_bridge.js");
 var import_create_router_bridge = require("./create_router_bridge.js");
 var import_create_test_router = require("./create_test_router.js");
 function readOperations(input) {
@@ -52,7 +55,7 @@ function createRpcManifest(operations) {
     controller: operation.controller,
     action: operation.action,
     path: operation.channel.split("."),
-    hasInput: !!operation.inputSchema
+    hasInput: (0, import_build_transport_bridge.operationHasInput)(operation)
   }));
 }
 function registerClientBuiltins(container) {
@@ -63,11 +66,12 @@ function registerClientBuiltins(container) {
   traceConfiguration.configureMode("test");
   traceConfiguration.configureRuntime("renderer");
   traceConfiguration.configureEnabled(true);
-  container.registerFunction(import_navigation.Navigation, () => (0, import_navigation.getNavigation)());
-  container.registerFunction(import_client.App, () => (0, import_client.getApp)());
-  container.registerFunction(import_client.Ipc, () => (0, import_ipc.getIpc)());
-  container.registerFunction(WindowControls, () => (0, import_client.getWindowControls)());
-  container.registerFunction(import_tracing.TraceProviderConfiguration, () => traceConfiguration);
+  const singleton = { loadAs: import_ioc.LoadAs.Singleton };
+  container.registerFunction(import_navigation.Navigation, () => (0, import_navigation.getNavigation)(), singleton);
+  container.registerFunction(import_client.App, () => (0, import_client.getApp)(), singleton);
+  container.registerFunction(import_client.Ipc, () => (0, import_ipc.getIpc)(), singleton);
+  container.registerFunction(WindowControls, () => (0, import_client.getWindowControls)(), singleton);
+  container.registerFunction(import_tracing.TraceProviderConfiguration, () => traceConfiguration, singleton);
 }
 class WindowControls {
   async open(_windowId, _options) {
@@ -110,7 +114,7 @@ async function createControllerHarness(options) {
   (0, import_client.clearClientNavigationForTests)();
   (0, import_client.clearClientWindowControlsForTests)();
   (0, import_client.clearClientLoggersForTests)();
-  const scopedContainer = options.container.extend();
+  const scopedContainer = options.clientContainer === "extend" ? options.container.extend() : (0, import_get_container.createWoodRoot)();
   registerClientBuiltins(scopedContainer);
   if (typeof scopedContainer.registerClass === "function") {
     scopedContainer.registerClass(options.controllerClass);
@@ -120,9 +124,24 @@ async function createControllerHarness(options) {
     bridge: harnessBridge,
     events,
     navigation,
-    container: scopedContainer
+    container: scopedContainer,
+    backendContainer: options.container
   });
   const controller = await scopedContainer.instance(options.controllerClass);
+  const bridgeHandlers = (surface) => {
+    if (!surface || typeof surface !== "object") return;
+    const record = surface;
+    for (const key of Object.keys(record)) {
+      const handler = record[key];
+      if (typeof handler !== "function") continue;
+      record[key] = (...args) => import_ioc.ExecutionContext.current() !== void 0 ? handler(...args) : import_ioc.ExecutionContext.run(
+        scopedContainer,
+        () => handler(...args)
+      );
+    }
+  };
+  bridgeHandlers(controller.input);
+  bridgeHandlers(controller.events);
   const trace = await scopedContainer.instance(import_tracing.TraceProvider);
   const traceRecorder = await scopedContainer.instance(import_trace_testing.TraceRecorder);
   if (options.initialize && typeof controller.initialize === "function") {
@@ -143,6 +162,7 @@ async function createControllerHarness(options) {
     events,
     router,
     container: scopedContainer,
+    backendContainer: options.container,
     navigation,
     traceRecorder,
     destroy: async () => {

package/dist/testing/create_controller_harness.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/create_controller_harness.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport {\n  App,\n  clearClientAppForTests,\n  clearClientContainerForTests,\n  clearClientLoggersForTests,\n  clearClientNavigationForTests,\n  clearClientWindowControlsForTests,\n  getApp,\n  getWindowControls,\n  Ipc,\n  WOOD_INTERNAL_BRIDGE_KEY,\n} from '../client/index.js';\nimport { getIpc } from '../ipc/index.js';\nimport { Navigation, getNavigation } from '../navigation/index.js';\nimport { TraceProvider, TraceProviderConfiguration } from '../tracing/index.js';\nimport { TraceRecorder } from '../trace-testing/index.js';\nimport { parseOperations } from '../parser/operations_parser.cjs';\nimport type { OperationDef } from '../types/operations.cjs';\nimport { disposeControllerLifecycle } from '../controller/controller_lifecycle.cjs';\nimport { createRouterBridge, type RouterBridgeResult } from './create_router_bridge.js';\nimport { createTestRouter } from './create_test_router.js';\n\nexport interface CreateControllerHarnessOptions<T> {\n  controllerClass: new (...args: any[]) => T;\n  container: any;\n  operations: string | string[];\n  controllersDir: string;\n  middlewareDir?: string;\n  configureContainer?: (container: any) => void | Promise<void>;\n  configureRouter?: (router: ReturnType<typeof createTestRouter>['router']) => void | Promise<void>;\n  prepareClient?: (context: {\n    bridge: Record<string, any>;\n    events: RouterBridgeResult['events'];\n    navigation: Navigation;\n    container: any;\n  }) => void | Promise<void>;\n  initialize?: boolean;\n}\n\nexport interface ControllerHarnessResult<T> extends RouterBridgeResult {\n  controller: T;\n  container: any;\n  router: ReturnType<typeof createTestRouter>['router'];\n  navigation: Navigation;\n  traceRecorder: TraceRecorder;\n  destroy: () => void | Promise<void>;\n}\n\ntype MutableGlobal = typeof globalThis & {\n  [WOOD_INTERNAL_BRIDGE_KEY]?: unknown;\n  wood?: unknown;\n};\n\nfunction readOperations(input: string): Map<string, OperationDef> {\n  if (input.includes('\\n') || input.includes(':')) {\n    return parseOperations(input);\n  }\n\n  return parseOperations(readFileSync(input, 'utf-8'));\n}\n\nfunction mergeOperations(inputs: string | string[]): Map<string, OperationDef> {\n  const merged = new Map<string, OperationDef>();\n\n  for (const input of Array.isArray(inputs) ? inputs : [inputs]) {\n    for (const [channel, operation] of readOperations(input)) {\n      merged.set(channel, operation);\n    }\n  }\n\n  return merged;\n}\n\nfunction createRpcManifest(operations: Map<string, OperationDef>) {\n  return Array.from(operations.values()).map((operation) => ({\n    channel: operation.channel,\n    controller: operation.controller,\n    action: operation.action,\n    path: operation.channel.split('.'),\n    hasInput: !!operation.inputSchema,\n  }));\n}\n\nfunction registerClientBuiltins(container: any): void {\n  if (typeof container.registerFunction !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = new TraceProviderConfiguration();\n  traceConfiguration.configureMode('test');\n  traceConfiguration.configureRuntime('renderer');\n  traceConfiguration.configureEnabled(true);\n\n  container.registerFunction(Navigation, () => getNavigation());\n  container.registerFunction(App, () => getApp());\n  container.registerFunction(Ipc, () => getIpc());\n  container.registerFunction(WindowControls, () => getWindowControls());\n  container.registerFunction(TraceProviderConfiguration, () => traceConfiguration);\n}\n\nclass WindowControls {\n  async open(_windowId: string, _options?: Record<string, unknown>): Promise<void> {}\n  async close(_windowId?: string): Promise<void> {}\n  async focus(_windowId: string): Promise<void> {}\n  async minimize(_windowId?: string): Promise<void> {}\n  async maximize(_windowId?: string): Promise<void> {}\n}\n\nexport async function createControllerHarness<T>(\n  options: CreateControllerHarnessOptions<T>,\n): Promise<ControllerHarnessResult<T>> {\n  await options.configureContainer?.(options.container);\n\n  if (typeof options.container.instance === 'function') {\n    const rootTraceConfiguration = await options.container.instance(TraceProviderConfiguration);\n    rootTraceConfiguration.configureMode('test');\n    rootTraceConfiguration.configureRuntime('main');\n  }\n\n  const operations = mergeOperations(options.operations);\n  const { router } = createTestRouter('', {\n    container: options.container,\n    controllersDir: options.controllersDir,\n    middlewareDir: options.middlewareDir,\n  });\n  router.loadOperations(operations);\n  await options.configureRouter?.(router);\n\n  const { bridge, events } = createRouterBridge(router);\n  const harnessBridge = Object.assign(bridge, {\n    __rpcManifest: createRpcManifest(operations),\n  });\n\n  const globalObj = globalThis as MutableGlobal;\n  const previousInternalBridge = globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n  const previousWoodBridge = globalObj.wood;\n  globalObj[WOOD_INTERNAL_BRIDGE_KEY] = harnessBridge;\n  globalObj.wood = harnessBridge;\n\n  clearClientContainerForTests();\n  clearClientAppForTests();\n  clearClientNavigationForTests();\n  clearClientWindowControlsForTests();\n  clearClientLoggersForTests();\n\n  const scopedContainer = options.container.extend();\n  registerClientBuiltins(scopedContainer);\n  if (typeof scopedContainer.registerClass === 'function') {\n    scopedContainer.registerClass(options.controllerClass);\n  }\n  const navigation = getNavigation();\n  await options.prepareClient?.({\n    bridge: harnessBridge,\n    events,\n    navigation,\n    container: scopedContainer,\n  });\n\n  const controller = await scopedContainer.instance(options.controllerClass);\n  const trace = await scopedContainer.instance(TraceProvider);\n  const traceRecorder = await scopedContainer.instance(TraceRecorder);\n  if (options.initialize && typeof (controller as { initialize?: () => void }).initialize === 'function') {\n    await Promise.resolve(\n      (controller as { initialize: () => void | Promise<void> }).initialize(),\n    );\n  }\n\n  trace.info({\n    source: 'wood.testing.controller-harness',\n    type: 'harness.created',\n    payload: {\n      controllerClass: options.controllerClass.name,\n    },\n  });\n\n  return {\n    controller,\n    bridge: harnessBridge,\n    events,\n    router,\n    container: scopedContainer,\n    navigation,\n    traceRecorder,\n    destroy: async () => {\n      trace.info({\n        source: 'wood.testing.controller-harness',\n        type: 'harness.destroyed',\n      });\n      await disposeControllerLifecycle(controller);\n      events.clear();\n      clearClientContainerForTests();\n      clearClientAppForTests();\n      clearClientNavigationForTests();\n      clearClientWindowControlsForTests();\n      clearClientLoggersForTests();\n\n      if (previousInternalBridge === undefined) {\n        delete globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n      } else {\n        globalObj[WOOD_INTERNAL_BRIDGE_KEY] = previousInternalBridge;\n      }\n\n      if (previousWoodBridge === undefined) {\n        delete globalObj.wood;\n      } else {\n        globalObj.wood = previousWoodBridge;\n      }\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/testing/create_controller_harness.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { LoadAs, ExecutionContext } from '@noego/ioc';\nimport {\n  App,\n  clearClientAppForTests,\n  clearClientContainerForTests,\n  clearClientLoggersForTests,\n  clearClientNavigationForTests,\n  clearClientWindowControlsForTests,\n  getApp,\n  getWindowControls,\n  Ipc,\n  WOOD_INTERNAL_BRIDGE_KEY,\n} from '../client/index.js';\nimport { getIpc } from '../ipc/index.js';\nimport { Navigation, getNavigation } from '../navigation/index.js';\nimport { TraceProvider, TraceProviderConfiguration } from '../tracing/index.js';\nimport { TraceRecorder } from '../trace-testing/index.js';\nimport { parseOperations } from '../parser/operations_parser.cjs';\nimport type { OperationDef } from '../types/operations.cjs';\nimport { disposeControllerLifecycle } from '../controller/controller_lifecycle.cjs';\nimport { createWoodRoot } from '../runtime/get_container.js';\nimport { operationHasInput } from '../transport/build_transport_bridge.js';\nimport { createRouterBridge, type RouterBridgeResult } from './create_router_bridge.js';\nimport { createTestRouter } from './create_test_router.js';\n\nexport interface CreateControllerHarnessOptions<T> {\n  controllerClass: new (...args: any[]) => T;\n  container: any;\n  operations: string | string[];\n  controllersDir: string;\n  middlewareDir?: string;\n  configureContainer?: (container: any) => void | Promise<void>;\n  configureRouter?: (router: ReturnType<typeof createTestRouter>['router']) => void | Promise<void>;\n  prepareClient?: (context: {\n    bridge: Record<string, any>;\n    events: RouterBridgeResult['events'];\n    navigation: Navigation;\n    /** The renderer root (fresh per harness). */\n    container: any;\n    /** The backend root (options.container) — resolve backend services here. */\n    backendContainer: any;\n  }) => void | Promise<void>;\n  initialize?: boolean;\n  /**\n   * How the client (renderer) container relates to the backend root.\n   * 'fresh-root' (default) mirrors production's process split: a separate\n   * renderer hierarchy, cross-root traffic through the bridge globals only.\n   * 'extend' is the merged node-frontend tier: renderer services resolve\n   * backend singletons directly in one hierarchy — for integration tests\n   * that intentionally span both sides in-process.\n   */\n  clientContainer?: 'fresh-root' | 'extend';\n}\n\nexport interface ControllerHarnessResult<T> extends RouterBridgeResult {\n  controller: T;\n  /** The renderer root the controller lives in (fresh per harness). */\n  container: any;\n  /** The backend root supplied via options.container — resolve backend services here. */\n  backendContainer: any;\n  router: ReturnType<typeof createTestRouter>['router'];\n  navigation: Navigation;\n  traceRecorder: TraceRecorder;\n  destroy: () => void | Promise<void>;\n}\n\ntype MutableGlobal = typeof globalThis & {\n  [WOOD_INTERNAL_BRIDGE_KEY]?: unknown;\n  wood?: unknown;\n};\n\nfunction readOperations(input: string): Map<string, OperationDef> {\n  if (input.includes('\\n') || input.includes(':')) {\n    return parseOperations(input);\n  }\n\n  return parseOperations(readFileSync(input, 'utf-8'));\n}\n\nfunction mergeOperations(inputs: string | string[]): Map<string, OperationDef> {\n  const merged = new Map<string, OperationDef>();\n\n  for (const input of Array.isArray(inputs) ? inputs : [inputs]) {\n    for (const [channel, operation] of readOperations(input)) {\n      merged.set(channel, operation);\n    }\n  }\n\n  return merged;\n}\n\nfunction createRpcManifest(operations: Map<string, OperationDef>) {\n  return Array.from(operations.values()).map((operation) => ({\n    channel: operation.channel,\n    controller: operation.controller,\n    action: operation.action,\n    path: operation.channel.split('.'),\n    hasInput: operationHasInput(operation),\n  }));\n}\n\nfunction registerClientBuiltins(container: any): void {\n  if (typeof container.registerFunction !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = new TraceProviderConfiguration();\n  traceConfiguration.configureMode('test');\n  traceConfiguration.configureRuntime('renderer');\n  traceConfiguration.configureEnabled(true);\n\n  // Explicit Singleton lifetime: these factories return root-global values,\n  // and registerFunction defaults to Transient, which would override the\n  // classes' own @Component(Singleton) declarations and trip ioc's\n  // captive-lifetime validation for singleton dependents.\n  const singleton = { loadAs: LoadAs.Singleton };\n  container.registerFunction(Navigation, () => getNavigation(), singleton);\n  container.registerFunction(App, () => getApp(), singleton);\n  container.registerFunction(Ipc, () => getIpc(), singleton);\n  container.registerFunction(WindowControls, () => getWindowControls(), singleton);\n  container.registerFunction(TraceProviderConfiguration, () => traceConfiguration, singleton);\n}\n\nclass WindowControls {\n  async open(_windowId: string, _options?: Record<string, unknown>): Promise<void> {}\n  async close(_windowId?: string): Promise<void> {}\n  async focus(_windowId: string): Promise<void> {}\n  async minimize(_windowId?: string): Promise<void> {}\n  async maximize(_windowId?: string): Promise<void> {}\n}\n\nexport async function createControllerHarness<T>(\n  options: CreateControllerHarnessOptions<T>,\n): Promise<ControllerHarnessResult<T>> {\n  await options.configureContainer?.(options.container);\n\n  if (typeof options.container.instance === 'function') {\n    const rootTraceConfiguration = await options.container.instance(TraceProviderConfiguration);\n    rootTraceConfiguration.configureMode('test');\n    rootTraceConfiguration.configureRuntime('main');\n  }\n\n  const operations = mergeOperations(options.operations);\n  const { router } = createTestRouter('', {\n    container: options.container,\n    controllersDir: options.controllersDir,\n    middlewareDir: options.middlewareDir,\n  });\n  router.loadOperations(operations);\n  await options.configureRouter?.(router);\n\n  const { bridge, events } = createRouterBridge(router);\n  const harnessBridge = Object.assign(bridge, {\n    __rpcManifest: createRpcManifest(operations),\n  });\n\n  const globalObj = globalThis as MutableGlobal;\n  const previousInternalBridge = globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n  const previousWoodBridge = globalObj.wood;\n  globalObj[WOOD_INTERNAL_BRIDGE_KEY] = harnessBridge;\n  globalObj.wood = harnessBridge;\n\n  clearClientContainerForTests();\n  clearClientAppForTests();\n  clearClientNavigationForTests();\n  clearClientWindowControlsForTests();\n  clearClientLoggersForTests();\n\n  // The client container is a FRESH RENDERER ROOT, mirroring production\n  // (renderer and main are separate processes with separate roots). A child\n  // scope of the backend root would share singleton storage, so renderer\n  // builtins (notably TraceProviderConfiguration with runtime 'renderer')\n  // would collide with the backend's own singletons. Cross-root traffic\n  // flows through the bridge globals, exactly as in production.\n  const scopedContainer = options.clientContainer === 'extend'\n    ? options.container.extend()\n    : (createWoodRoot() as any);\n  registerClientBuiltins(scopedContainer);\n  if (typeof scopedContainer.registerClass === 'function') {\n    scopedContainer.registerClass(options.controllerClass);\n  }\n  const navigation = getNavigation();\n  await options.prepareClient?.({\n    bridge: harnessBridge,\n    events,\n    navigation,\n    container: scopedContainer,\n    backendContainer: options.container,\n  });\n\n  const controller = await scopedContainer.instance(options.controllerClass);\n  // Controller interaction surfaces (input/events handlers) are plain data\n  // properties holding arrow functions — they bypass the IoC context proxy,\n  // so invoking them from a test would run context-less and singleton\n  // collaborators (e.g. TraceProvider) would resolve root-scope state\n  // instead of this harness scope's registrations. Bridge them so every\n  // handler runs under the harness scope unless a context is already active.\n  const bridgeHandlers = (surface: unknown): void => {\n    if (!surface || typeof surface !== 'object') return;\n    const record = surface as Record<string, unknown>;\n    for (const key of Object.keys(record)) {\n      const handler = record[key];\n      if (typeof handler !== 'function') continue;\n      record[key] = (...args: unknown[]) =>\n        ExecutionContext.current() !== undefined\n          ? (handler as (...a: unknown[]) => unknown)(...args)\n          : ExecutionContext.run(scopedContainer as any, () =>\n              (handler as (...a: unknown[]) => unknown)(...args),\n            );\n    }\n  };\n  bridgeHandlers((controller as { input?: unknown }).input);\n  bridgeHandlers((controller as { events?: unknown }).events);\n  const trace = await scopedContainer.instance(TraceProvider);\n  const traceRecorder = await scopedContainer.instance(TraceRecorder);\n  if (options.initialize && typeof (controller as { initialize?: () => void }).initialize === 'function') {\n    await Promise.resolve(\n      (controller as { initialize: () => void | Promise<void> }).initialize(),\n    );\n  }\n\n  trace.info({\n    source: 'wood.testing.controller-harness',\n    type: 'harness.created',\n    payload: {\n      controllerClass: options.controllerClass.name,\n    },\n  });\n\n  return {\n    controller,\n    bridge: harnessBridge,\n    events,\n    router,\n    container: scopedContainer,\n    backendContainer: options.container,\n    navigation,\n    traceRecorder,\n    destroy: async () => {\n      trace.info({\n        source: 'wood.testing.controller-harness',\n        type: 'harness.destroyed',\n      });\n      await disposeControllerLifecycle(controller);\n      events.clear();\n      clearClientContainerForTests();\n      clearClientAppForTests();\n      clearClientNavigationForTests();\n      clearClientWindowControlsForTests();\n      clearClientLoggersForTests();\n\n      if (previousInternalBridge === undefined) {\n        delete globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n      } else {\n        globalObj[WOOD_INTERNAL_BRIDGE_KEY] = previousInternalBridge;\n      }\n\n      if (previousWoodBridge === undefined) {\n        delete globalObj.wood;\n      } else {\n        globalObj.wood = previousWoodBridge;\n      }\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/testing/create_controller_harness.d.cts

@@ -4,12 +4,12 @@ import { RouterBridgeResult } from './create_router_bridge.cjs';
 import { createTestRouter } from './create_test_router.cjs';
 import '../navigation/automation_introspection.cjs';
 import '@noego/trace/testing';
-import '../trace_hub-Cob54qRx.cjs';
+import '../trace_hub-Cpo_nVze.cjs';
 import 'rxjs';
 import '../tracing/trace_provider.cjs';
-import '@noego/ioc';
 import '../router/wood_router.cjs';
 import '../types/operations.cjs';
+import '../types/context.cjs';
 
 interface CreateControllerHarnessOptions<T> {
     controllerClass: new (...args: any[]) => T;
@@ -23,13 +23,28 @@ interface CreateControllerHarnessOptions<T> {
         bridge: Record<string, any>;
         events: RouterBridgeResult['events'];
         navigation: Navigation;
+        /** The renderer root (fresh per harness). */
         container: any;
+        /** The backend root (options.container) — resolve backend services here. */
+        backendContainer: any;
     }) => void | Promise<void>;
     initialize?: boolean;
+    /**
+     * How the client (renderer) container relates to the backend root.
+     * 'fresh-root' (default) mirrors production's process split: a separate
+     * renderer hierarchy, cross-root traffic through the bridge globals only.
+     * 'extend' is the merged node-frontend tier: renderer services resolve
+     * backend singletons directly in one hierarchy — for integration tests
+     * that intentionally span both sides in-process.
+     */
+    clientContainer?: 'fresh-root' | 'extend';
 }
 interface ControllerHarnessResult<T> extends RouterBridgeResult {
     controller: T;
+    /** The renderer root the controller lives in (fresh per harness). */
     container: any;
+    /** The backend root supplied via options.container — resolve backend services here. */
+    backendContainer: any;
     router: ReturnType<typeof createTestRouter>['router'];
     navigation: Navigation;
     traceRecorder: TraceRecorder;

package/dist/testing/create_controller_harness.d.ts

@@ -4,12 +4,12 @@ import { RouterBridgeResult } from './create_router_bridge.js';
 import { createTestRouter } from './create_test_router.js';
 import '../navigation/automation_introspection.js';
 import '@noego/trace/testing';
-import '../trace_hub-Cob54qRx.js';
+import '../trace_hub-Cpo_nVze.js';
 import 'rxjs';
 import '../tracing/trace_provider.js';
-import '@noego/ioc';
 import '../router/wood_router.js';
 import '../types/operations.js';
+import '../types/context.js';
 
 interface CreateControllerHarnessOptions<T> {
     controllerClass: new (...args: any[]) => T;
@@ -23,13 +23,28 @@ interface CreateControllerHarnessOptions<T> {
         bridge: Record<string, any>;
         events: RouterBridgeResult['events'];
         navigation: Navigation;
+        /** The renderer root (fresh per harness). */
         container: any;
+        /** The backend root (options.container) — resolve backend services here. */
+        backendContainer: any;
     }) => void | Promise<void>;
     initialize?: boolean;
+    /**
+     * How the client (renderer) container relates to the backend root.
+     * 'fresh-root' (default) mirrors production's process split: a separate
+     * renderer hierarchy, cross-root traffic through the bridge globals only.
+     * 'extend' is the merged node-frontend tier: renderer services resolve
+     * backend singletons directly in one hierarchy — for integration tests
+     * that intentionally span both sides in-process.
+     */
+    clientContainer?: 'fresh-root' | 'extend';
 }
 interface ControllerHarnessResult<T> extends RouterBridgeResult {
     controller: T;
+    /** The renderer root the controller lives in (fresh per harness). */
     container: any;
+    /** The backend root supplied via options.container — resolve backend services here. */
+    backendContainer: any;
     router: ReturnType<typeof createTestRouter>['router'];
     navigation: Navigation;
     traceRecorder: TraceRecorder;

package/dist/testing/create_controller_harness.js

@@ -1,4 +1,5 @@
 import { readFileSync } from "node:fs";
+import { LoadAs, ExecutionContext } from "@noego/ioc";
 import {
   App,
   clearClientAppForTests,
@@ -17,6 +18,8 @@ import { TraceProvider, TraceProviderConfiguration } from "../tracing/index.js";
 import { TraceRecorder } from "../trace-testing/index.js";
 import { parseOperations } from "../parser/operations_parser.js";
 import { disposeControllerLifecycle } from "../controller/controller_lifecycle.js";
+import { createWoodRoot } from "../runtime/get_container.js";
+import { operationHasInput } from "../transport/build_transport_bridge.js";
 import { createRouterBridge } from "./create_router_bridge.js";
 import { createTestRouter } from "./create_test_router.js";
 function readOperations(input) {
@@ -40,7 +43,7 @@ function createRpcManifest(operations) {
     controller: operation.controller,
     action: operation.action,
     path: operation.channel.split("."),
-    hasInput: !!operation.inputSchema
+    hasInput: operationHasInput(operation)
   }));
 }
 function registerClientBuiltins(container) {
@@ -51,11 +54,12 @@ function registerClientBuiltins(container) {
   traceConfiguration.configureMode("test");
   traceConfiguration.configureRuntime("renderer");
   traceConfiguration.configureEnabled(true);
-  container.registerFunction(Navigation, () => getNavigation());
-  container.registerFunction(App, () => getApp());
-  container.registerFunction(Ipc, () => getIpc());
-  container.registerFunction(WindowControls, () => getWindowControls());
-  container.registerFunction(TraceProviderConfiguration, () => traceConfiguration);
+  const singleton = { loadAs: LoadAs.Singleton };
+  container.registerFunction(Navigation, () => getNavigation(), singleton);
+  container.registerFunction(App, () => getApp(), singleton);
+  container.registerFunction(Ipc, () => getIpc(), singleton);
+  container.registerFunction(WindowControls, () => getWindowControls(), singleton);
+  container.registerFunction(TraceProviderConfiguration, () => traceConfiguration, singleton);
 }
 class WindowControls {
   async open(_windowId, _options) {
@@ -98,7 +102,7 @@ async function createControllerHarness(options) {
   clearClientNavigationForTests();
   clearClientWindowControlsForTests();
   clearClientLoggersForTests();
-  const scopedContainer = options.container.extend();
+  const scopedContainer = options.clientContainer === "extend" ? options.container.extend() : createWoodRoot();
   registerClientBuiltins(scopedContainer);
   if (typeof scopedContainer.registerClass === "function") {
     scopedContainer.registerClass(options.controllerClass);
@@ -108,9 +112,24 @@ async function createControllerHarness(options) {
     bridge: harnessBridge,
     events,
     navigation,
-    container: scopedContainer
+    container: scopedContainer,
+    backendContainer: options.container
   });
   const controller = await scopedContainer.instance(options.controllerClass);
+  const bridgeHandlers = (surface) => {
+    if (!surface || typeof surface !== "object") return;
+    const record = surface;
+    for (const key of Object.keys(record)) {
+      const handler = record[key];
+      if (typeof handler !== "function") continue;
+      record[key] = (...args) => ExecutionContext.current() !== void 0 ? handler(...args) : ExecutionContext.run(
+        scopedContainer,
+        () => handler(...args)
+      );
+    }
+  };
+  bridgeHandlers(controller.input);
+  bridgeHandlers(controller.events);
   const trace = await scopedContainer.instance(TraceProvider);
   const traceRecorder = await scopedContainer.instance(TraceRecorder);
   if (options.initialize && typeof controller.initialize === "function") {
@@ -131,6 +150,7 @@ async function createControllerHarness(options) {
     events,
     router,
     container: scopedContainer,
+    backendContainer: options.container,
     navigation,
     traceRecorder,
     destroy: async () => {

package/dist/testing/create_controller_harness.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/create_controller_harness.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport {\n  App,\n  clearClientAppForTests,\n  clearClientContainerForTests,\n  clearClientLoggersForTests,\n  clearClientNavigationForTests,\n  clearClientWindowControlsForTests,\n  getApp,\n  getWindowControls,\n  Ipc,\n  WOOD_INTERNAL_BRIDGE_KEY,\n} from '../client/index.js';\nimport { getIpc } from '../ipc/index.js';\nimport { Navigation, getNavigation } from '../navigation/index.js';\nimport { TraceProvider, TraceProviderConfiguration } from '../tracing/index.js';\nimport { TraceRecorder } from '../trace-testing/index.js';\nimport { parseOperations } from '../parser/operations_parser.js';\nimport type { OperationDef } from '../types/operations.js';\nimport { disposeControllerLifecycle } from '../controller/controller_lifecycle.js';\nimport { createRouterBridge, type RouterBridgeResult } from './create_router_bridge.js';\nimport { createTestRouter } from './create_test_router.js';\n\nexport interface CreateControllerHarnessOptions<T> {\n  controllerClass: new (...args: any[]) => T;\n  container: any;\n  operations: string | string[];\n  controllersDir: string;\n  middlewareDir?: string;\n  configureContainer?: (container: any) => void | Promise<void>;\n  configureRouter?: (router: ReturnType<typeof createTestRouter>['router']) => void | Promise<void>;\n  prepareClient?: (context: {\n    bridge: Record<string, any>;\n    events: RouterBridgeResult['events'];\n    navigation: Navigation;\n    container: any;\n  }) => void | Promise<void>;\n  initialize?: boolean;\n}\n\nexport interface ControllerHarnessResult<T> extends RouterBridgeResult {\n  controller: T;\n  container: any;\n  router: ReturnType<typeof createTestRouter>['router'];\n  navigation: Navigation;\n  traceRecorder: TraceRecorder;\n  destroy: () => void | Promise<void>;\n}\n\ntype MutableGlobal = typeof globalThis & {\n  [WOOD_INTERNAL_BRIDGE_KEY]?: unknown;\n  wood?: unknown;\n};\n\nfunction readOperations(input: string): Map<string, OperationDef> {\n  if (input.includes('\\n') || input.includes(':')) {\n    return parseOperations(input);\n  }\n\n  return parseOperations(readFileSync(input, 'utf-8'));\n}\n\nfunction mergeOperations(inputs: string | string[]): Map<string, OperationDef> {\n  const merged = new Map<string, OperationDef>();\n\n  for (const input of Array.isArray(inputs) ? inputs : [inputs]) {\n    for (const [channel, operation] of readOperations(input)) {\n      merged.set(channel, operation);\n    }\n  }\n\n  return merged;\n}\n\nfunction createRpcManifest(operations: Map<string, OperationDef>) {\n  return Array.from(operations.values()).map((operation) => ({\n    channel: operation.channel,\n    controller: operation.controller,\n    action: operation.action,\n    path: operation.channel.split('.'),\n    hasInput: !!operation.inputSchema,\n  }));\n}\n\nfunction registerClientBuiltins(container: any): void {\n  if (typeof container.registerFunction !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = new TraceProviderConfiguration();\n  traceConfiguration.configureMode('test');\n  traceConfiguration.configureRuntime('renderer');\n  traceConfiguration.configureEnabled(true);\n\n  container.registerFunction(Navigation, () => getNavigation());\n  container.registerFunction(App, () => getApp());\n  container.registerFunction(Ipc, () => getIpc());\n  container.registerFunction(WindowControls, () => getWindowControls());\n  container.registerFunction(TraceProviderConfiguration, () => traceConfiguration);\n}\n\nclass WindowControls {\n  async open(_windowId: string, _options?: Record<string, unknown>): Promise<void> {}\n  async close(_windowId?: string): Promise<void> {}\n  async focus(_windowId: string): Promise<void> {}\n  async minimize(_windowId?: string): Promise<void> {}\n  async maximize(_windowId?: string): Promise<void> {}\n}\n\nexport async function createControllerHarness<T>(\n  options: CreateControllerHarnessOptions<T>,\n): Promise<ControllerHarnessResult<T>> {\n  await options.configureContainer?.(options.container);\n\n  if (typeof options.container.instance === 'function') {\n    const rootTraceConfiguration = await options.container.instance(TraceProviderConfiguration);\n    rootTraceConfiguration.configureMode('test');\n    rootTraceConfiguration.configureRuntime('main');\n  }\n\n  const operations = mergeOperations(options.operations);\n  const { router } = createTestRouter('', {\n    container: options.container,\n    controllersDir: options.controllersDir,\n    middlewareDir: options.middlewareDir,\n  });\n  router.loadOperations(operations);\n  await options.configureRouter?.(router);\n\n  const { bridge, events } = createRouterBridge(router);\n  const harnessBridge = Object.assign(bridge, {\n    __rpcManifest: createRpcManifest(operations),\n  });\n\n  const globalObj = globalThis as MutableGlobal;\n  const previousInternalBridge = globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n  const previousWoodBridge = globalObj.wood;\n  globalObj[WOOD_INTERNAL_BRIDGE_KEY] = harnessBridge;\n  globalObj.wood = harnessBridge;\n\n  clearClientContainerForTests();\n  clearClientAppForTests();\n  clearClientNavigationForTests();\n  clearClientWindowControlsForTests();\n  clearClientLoggersForTests();\n\n  const scopedContainer = options.container.extend();\n  registerClientBuiltins(scopedContainer);\n  if (typeof scopedContainer.registerClass === 'function') {\n    scopedContainer.registerClass(options.controllerClass);\n  }\n  const navigation = getNavigation();\n  await options.prepareClient?.({\n    bridge: harnessBridge,\n    events,\n    navigation,\n    container: scopedContainer,\n  });\n\n  const controller = await scopedContainer.instance(options.controllerClass);\n  const trace = await scopedContainer.instance(TraceProvider);\n  const traceRecorder = await scopedContainer.instance(TraceRecorder);\n  if (options.initialize && typeof (controller as { initialize?: () => void }).initialize === 'function') {\n    await Promise.resolve(\n      (controller as { initialize: () => void | Promise<void> }).initialize(),\n    );\n  }\n\n  trace.info({\n    source: 'wood.testing.controller-harness',\n    type: 'harness.created',\n    payload: {\n      controllerClass: options.controllerClass.name,\n    },\n  });\n\n  return {\n    controller,\n    bridge: harnessBridge,\n    events,\n    router,\n    container: scopedContainer,\n    navigation,\n    traceRecorder,\n    destroy: async () => {\n      trace.info({\n        source: 'wood.testing.controller-harness',\n        type: 'harness.destroyed',\n      });\n      await disposeControllerLifecycle(controller);\n      events.clear();\n      clearClientContainerForTests();\n      clearClientAppForTests();\n      clearClientNavigationForTests();\n      clearClientWindowControlsForTests();\n      clearClientLoggersForTests();\n\n      if (previousInternalBridge === undefined) {\n        delete globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n      } else {\n        globalObj[WOOD_INTERNAL_BRIDGE_KEY] = previousInternalBridge;\n      }\n\n      if (previousWoodBridge === undefined) {\n        delete globalObj.wood;\n      } else {\n        globalObj.wood = previousWoodBridge;\n      }\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/testing/create_controller_harness.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { LoadAs, ExecutionContext } from '@noego/ioc';\nimport {\n  App,\n  clearClientAppForTests,\n  clearClientContainerForTests,\n  clearClientLoggersForTests,\n  clearClientNavigationForTests,\n  clearClientWindowControlsForTests,\n  getApp,\n  getWindowControls,\n  Ipc,\n  WOOD_INTERNAL_BRIDGE_KEY,\n} from '../client/index.js';\nimport { getIpc } from '../ipc/index.js';\nimport { Navigation, getNavigation } from '../navigation/index.js';\nimport { TraceProvider, TraceProviderConfiguration } from '../tracing/index.js';\nimport { TraceRecorder } from '../trace-testing/index.js';\nimport { parseOperations } from '../parser/operations_parser.js';\nimport type { OperationDef } from '../types/operations.js';\nimport { disposeControllerLifecycle } from '../controller/controller_lifecycle.js';\nimport { createWoodRoot } from '../runtime/get_container.js';\nimport { operationHasInput } from '../transport/build_transport_bridge.js';\nimport { createRouterBridge, type RouterBridgeResult } from './create_router_bridge.js';\nimport { createTestRouter } from './create_test_router.js';\n\nexport interface CreateControllerHarnessOptions<T> {\n  controllerClass: new (...args: any[]) => T;\n  container: any;\n  operations: string | string[];\n  controllersDir: string;\n  middlewareDir?: string;\n  configureContainer?: (container: any) => void | Promise<void>;\n  configureRouter?: (router: ReturnType<typeof createTestRouter>['router']) => void | Promise<void>;\n  prepareClient?: (context: {\n    bridge: Record<string, any>;\n    events: RouterBridgeResult['events'];\n    navigation: Navigation;\n    /** The renderer root (fresh per harness). */\n    container: any;\n    /** The backend root (options.container) — resolve backend services here. */\n    backendContainer: any;\n  }) => void | Promise<void>;\n  initialize?: boolean;\n  /**\n   * How the client (renderer) container relates to the backend root.\n   * 'fresh-root' (default) mirrors production's process split: a separate\n   * renderer hierarchy, cross-root traffic through the bridge globals only.\n   * 'extend' is the merged node-frontend tier: renderer services resolve\n   * backend singletons directly in one hierarchy — for integration tests\n   * that intentionally span both sides in-process.\n   */\n  clientContainer?: 'fresh-root' | 'extend';\n}\n\nexport interface ControllerHarnessResult<T> extends RouterBridgeResult {\n  controller: T;\n  /** The renderer root the controller lives in (fresh per harness). */\n  container: any;\n  /** The backend root supplied via options.container — resolve backend services here. */\n  backendContainer: any;\n  router: ReturnType<typeof createTestRouter>['router'];\n  navigation: Navigation;\n  traceRecorder: TraceRecorder;\n  destroy: () => void | Promise<void>;\n}\n\ntype MutableGlobal = typeof globalThis & {\n  [WOOD_INTERNAL_BRIDGE_KEY]?: unknown;\n  wood?: unknown;\n};\n\nfunction readOperations(input: string): Map<string, OperationDef> {\n  if (input.includes('\\n') || input.includes(':')) {\n    return parseOperations(input);\n  }\n\n  return parseOperations(readFileSync(input, 'utf-8'));\n}\n\nfunction mergeOperations(inputs: string | string[]): Map<string, OperationDef> {\n  const merged = new Map<string, OperationDef>();\n\n  for (const input of Array.isArray(inputs) ? inputs : [inputs]) {\n    for (const [channel, operation] of readOperations(input)) {\n      merged.set(channel, operation);\n    }\n  }\n\n  return merged;\n}\n\nfunction createRpcManifest(operations: Map<string, OperationDef>) {\n  return Array.from(operations.values()).map((operation) => ({\n    channel: operation.channel,\n    controller: operation.controller,\n    action: operation.action,\n    path: operation.channel.split('.'),\n    hasInput: operationHasInput(operation),\n  }));\n}\n\nfunction registerClientBuiltins(container: any): void {\n  if (typeof container.registerFunction !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = new TraceProviderConfiguration();\n  traceConfiguration.configureMode('test');\n  traceConfiguration.configureRuntime('renderer');\n  traceConfiguration.configureEnabled(true);\n\n  // Explicit Singleton lifetime: these factories return root-global values,\n  // and registerFunction defaults to Transient, which would override the\n  // classes' own @Component(Singleton) declarations and trip ioc's\n  // captive-lifetime validation for singleton dependents.\n  const singleton = { loadAs: LoadAs.Singleton };\n  container.registerFunction(Navigation, () => getNavigation(), singleton);\n  container.registerFunction(App, () => getApp(), singleton);\n  container.registerFunction(Ipc, () => getIpc(), singleton);\n  container.registerFunction(WindowControls, () => getWindowControls(), singleton);\n  container.registerFunction(TraceProviderConfiguration, () => traceConfiguration, singleton);\n}\n\nclass WindowControls {\n  async open(_windowId: string, _options?: Record<string, unknown>): Promise<void> {}\n  async close(_windowId?: string): Promise<void> {}\n  async focus(_windowId: string): Promise<void> {}\n  async minimize(_windowId?: string): Promise<void> {}\n  async maximize(_windowId?: string): Promise<void> {}\n}\n\nexport async function createControllerHarness<T>(\n  options: CreateControllerHarnessOptions<T>,\n): Promise<ControllerHarnessResult<T>> {\n  await options.configureContainer?.(options.container);\n\n  if (typeof options.container.instance === 'function') {\n    const rootTraceConfiguration = await options.container.instance(TraceProviderConfiguration);\n    rootTraceConfiguration.configureMode('test');\n    rootTraceConfiguration.configureRuntime('main');\n  }\n\n  const operations = mergeOperations(options.operations);\n  const { router } = createTestRouter('', {\n    container: options.container,\n    controllersDir: options.controllersDir,\n    middlewareDir: options.middlewareDir,\n  });\n  router.loadOperations(operations);\n  await options.configureRouter?.(router);\n\n  const { bridge, events } = createRouterBridge(router);\n  const harnessBridge = Object.assign(bridge, {\n    __rpcManifest: createRpcManifest(operations),\n  });\n\n  const globalObj = globalThis as MutableGlobal;\n  const previousInternalBridge = globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n  const previousWoodBridge = globalObj.wood;\n  globalObj[WOOD_INTERNAL_BRIDGE_KEY] = harnessBridge;\n  globalObj.wood = harnessBridge;\n\n  clearClientContainerForTests();\n  clearClientAppForTests();\n  clearClientNavigationForTests();\n  clearClientWindowControlsForTests();\n  clearClientLoggersForTests();\n\n  // The client container is a FRESH RENDERER ROOT, mirroring production\n  // (renderer and main are separate processes with separate roots). A child\n  // scope of the backend root would share singleton storage, so renderer\n  // builtins (notably TraceProviderConfiguration with runtime 'renderer')\n  // would collide with the backend's own singletons. Cross-root traffic\n  // flows through the bridge globals, exactly as in production.\n  const scopedContainer = options.clientContainer === 'extend'\n    ? options.container.extend()\n    : (createWoodRoot() as any);\n  registerClientBuiltins(scopedContainer);\n  if (typeof scopedContainer.registerClass === 'function') {\n    scopedContainer.registerClass(options.controllerClass);\n  }\n  const navigation = getNavigation();\n  await options.prepareClient?.({\n    bridge: harnessBridge,\n    events,\n    navigation,\n    container: scopedContainer,\n    backendContainer: options.container,\n  });\n\n  const controller = await scopedContainer.instance(options.controllerClass);\n  // Controller interaction surfaces (input/events handlers) are plain data\n  // properties holding arrow functions — they bypass the IoC context proxy,\n  // so invoking them from a test would run context-less and singleton\n  // collaborators (e.g. TraceProvider) would resolve root-scope state\n  // instead of this harness scope's registrations. Bridge them so every\n  // handler runs under the harness scope unless a context is already active.\n  const bridgeHandlers = (surface: unknown): void => {\n    if (!surface || typeof surface !== 'object') return;\n    const record = surface as Record<string, unknown>;\n    for (const key of Object.keys(record)) {\n      const handler = record[key];\n      if (typeof handler !== 'function') continue;\n      record[key] = (...args: unknown[]) =>\n        ExecutionContext.current() !== undefined\n          ? (handler as (...a: unknown[]) => unknown)(...args)\n          : ExecutionContext.run(scopedContainer as any, () =>\n              (handler as (...a: unknown[]) => unknown)(...args),\n            );\n    }\n  };\n  bridgeHandlers((controller as { input?: unknown }).input);\n  bridgeHandlers((controller as { events?: unknown }).events);\n  const trace = await scopedContainer.instance(TraceProvider);\n  const traceRecorder = await scopedContainer.instance(TraceRecorder);\n  if (options.initialize && typeof (controller as { initialize?: () => void }).initialize === 'function') {\n    await Promise.resolve(\n      (controller as { initialize: () => void | Promise<void> }).initialize(),\n    );\n  }\n\n  trace.info({\n    source: 'wood.testing.controller-harness',\n    type: 'harness.created',\n    payload: {\n      controllerClass: options.controllerClass.name,\n    },\n  });\n\n  return {\n    controller,\n    bridge: harnessBridge,\n    events,\n    router,\n    container: scopedContainer,\n    backendContainer: options.container,\n    navigation,\n    traceRecorder,\n    destroy: async () => {\n      trace.info({\n        source: 'wood.testing.controller-harness',\n        type: 'harness.destroyed',\n      });\n      await disposeControllerLifecycle(controller);\n      events.clear();\n      clearClientContainerForTests();\n      clearClientAppForTests();\n      clearClientNavigationForTests();\n      clearClientWindowControlsForTests();\n      clearClientLoggersForTests();\n\n      if (previousInternalBridge === undefined) {\n        delete globalObj[WOOD_INTERNAL_BRIDGE_KEY];\n      } else {\n        globalObj[WOOD_INTERNAL_BRIDGE_KEY] = previousInternalBridge;\n      }\n\n      if (previousWoodBridge === undefined) {\n        delete globalObj.wood;\n      } else {\n        globalObj.wood = previousWoodBridge;\n      }\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/testing/create_router_bridge.d.cts

@@ -1,5 +1,6 @@
 import { WoodRouter } from '../router/wood_router.cjs';
 import '../types/operations.cjs';
+import '../types/context.cjs';
 
 /**
  * An in-process event emitter that replaces Electron's

package/dist/testing/create_router_bridge.d.ts

@@ -1,5 +1,6 @@
 import { WoodRouter } from '../router/wood_router.js';
 import '../types/operations.js';
+import '../types/context.js';
 
 /**
  * An in-process event emitter that replaces Electron's

package/dist/testing/create_test_router.d.cts

@@ -1,5 +1,6 @@
 import { WoodRouter } from '../router/wood_router.cjs';
 import '../types/operations.cjs';
+import '../types/context.cjs';
 
 interface TestRouterResult {
     router: WoodRouter;

package/dist/testing/create_test_router.d.ts

@@ -1,5 +1,6 @@
 import { WoodRouter } from '../router/wood_router.js';
 import '../types/operations.js';
+import '../types/context.js';
 
 interface TestRouterResult {
     router: WoodRouter;

package/dist/testing/index.cjs

@@ -18,18 +18,28 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var testing_exports = {};
 __export(testing_exports, {
+  FrontendLifecycleOwner: () => import_frontend.FrontendLifecycleOwner,
+  FrontendWorkError: () => import_frontend.FrontendWorkError,
   InProcessRouterTransport: () => import_transport.InProcessRouterTransport,
   LoopbackRemoteTransport: () => import_transport.LoopbackRemoteTransport,
   LoopbackRemoteTransportServer: () => import_transport.LoopbackRemoteTransportServer,
   LoopbackSerializationError: () => import_transport.LoopbackSerializationError,
+  PageCatalog: () => import_frontend.PageCatalog,
+  PageCatalogError: () => import_frontend.PageCatalogError,
   RouterBridgeEvents: () => import_create_router_bridge.RouterBridgeEvents,
+  TestWoodBuilder: () => import_test_wood_config.TestWoodBuilder,
+  TestWoodError: () => import_test_wood.TestWoodError,
   TraceRecorder: () => import_trace_testing.TraceRecorder,
+  TrackedTransport: () => import_frontend.TrackedTransport,
+  WOOD_FRONTEND_BRIDGE: () => import_test_wood.WOOD_FRONTEND_BRIDGE,
+  WorkRegistry: () => import_frontend.WorkRegistry,
   assertLoopbackSerializable: () => import_transport.assertLoopbackSerializable,
   automationAssertions: () => import_automation_assertions.automationAssertions,
   browser: () => import_browser.browser,
   buildTransportBridge: () => import_transport.buildTransportBridge,
   createBrowserBridgeFixture: () => import_browser.createBrowserBridgeFixture,
   createControllerHarness: () => import_create_controller_harness.createControllerHarness,
+  createFrontendSurface: () => import_frontend.createFrontendSurface,
   createRouterBridge: () => import_create_router_bridge.createRouterBridge,
   createTestContainer: () => import_create_test_container.createTestContainer,
   createTestRouter: () => import_create_test_router.createTestRouter,
@@ -43,13 +53,20 @@ __export(testing_exports, {
   mockElectron: () => import_mock_electron.mockElectron,
   notClipped: () => import_automation_assertions.notClipped,
   notOverlapping: () => import_automation_assertions.notOverlapping,
+  pageIdentity: () => import_frontend.pageIdentity,
+  parseViewsSource: () => import_frontend.parseViewsSource,
   rectsOverlap: () => import_automation_assertions.rectsOverlap,
   sharedEdges: () => import_automation_assertions.sharedEdges,
   sharedRectEdges: () => import_automation_assertions.sharedRectEdges,
   stableAfterAnimation: () => import_automation_assertions.stableAfterAnimation,
+  startSharedBrowserViteServer: () => import_browser.startSharedBrowserViteServer,
+  testWood: () => import_test_wood_config.testWood,
   visible: () => import_automation_assertions.visible
 });
 module.exports = __toCommonJS(testing_exports);
+var import_test_wood_config = require("./test_wood_config.cjs");
+var import_test_wood = require("./test_wood.cjs");
+var import_frontend = require("../frontend/index.cjs");
 var import_create_test_container = require("./create_test_container.js");
 var import_create_controller_harness = require("./create_controller_harness.js");
 var import_create_test_router = require("./create_test_router.js");
@@ -61,18 +78,28 @@ var import_transport = require("../transport/index.js");
 var import_trace_testing = require("../trace-testing/index.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  FrontendLifecycleOwner,
+  FrontendWorkError,
   InProcessRouterTransport,
   LoopbackRemoteTransport,
   LoopbackRemoteTransportServer,
   LoopbackSerializationError,
+  PageCatalog,
+  PageCatalogError,
   RouterBridgeEvents,
+  TestWoodBuilder,
+  TestWoodError,
   TraceRecorder,
+  TrackedTransport,
+  WOOD_FRONTEND_BRIDGE,
+  WorkRegistry,
   assertLoopbackSerializable,
   automationAssertions,
   browser,
   buildTransportBridge,
   createBrowserBridgeFixture,
   createControllerHarness,
+  createFrontendSurface,
   createRouterBridge,
   createTestContainer,
   createTestRouter,
@@ -86,10 +113,14 @@ var import_trace_testing = require("../trace-testing/index.js");
   mockElectron,
   notClipped,
   notOverlapping,
+  pageIdentity,
+  parseViewsSource,
   rectsOverlap,
   sharedEdges,
   sharedRectEdges,
   stableAfterAnimation,
+  startSharedBrowserViteServer,
+  testWood,
   visible
 });
 //# sourceMappingURL=index.cjs.map

package/dist/testing/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["export { createTestContainer } from './create_test_container.js';\nexport {\n  createControllerHarness,\n  type ControllerHarnessResult,\n  type CreateControllerHarnessOptions,\n} from './create_controller_harness.js';\nexport { createTestRouter, type TestRouterResult } from './create_test_router.js';\nexport { mockElectron, getElectronMockFactory } from './mock_electron.js';\nexport {\n  createRouterBridge,\n  RouterBridgeEvents,\n  type RouterBridgeResult,\n} from './create_router_bridge.js';\nexport {\n  browser,\n  createBrowserBridgeFixture,\n  type MountedWoodBridge,\n  type MountedWoodComponent,\n  type MountedWoodNavigation,\n  type MountedWoodRoute,\n  type MountedWoodSurface,\n  type MountedWoodTree,\n  type MountComponentOptions,\n  type MountRouteOptions,\n  type MountTreeOptions,\n  type WoodBridgeFixtureContext,\n  type WoodBridgeFixtureInput,\n  type WoodBridgeRecordedCall,\n  type WoodBridgeRecordedEvent,\n  type WoodRpcManifestEntryInput,\n  type WoodBrowserExpect,\n  type WoodHitTestResult,\n  type WoodRectSnapshot,\n  type WoodBrowserHarness,\n  type WoodBrowserHarnessConfig,\n  type WoodBrowserPageContext,\n  type WoodBrowserTraceConfig,\n  type WoodViewport,\n} from './browser.js';\nexport {\n  automationAssertions,\n  visible,\n  hidden,\n  insideViewport,\n  notClipped,\n  notOverlapping,\n  hitTestReachable,\n  sharedEdges,\n  evenSpacing,\n  stableAfterAnimation,\n  rectsOverlap,\n  gaps,\n  sharedRectEdges,\n  evenSpacingRects,\n  type AssertionVerdict,\n  type AutomationTarget,\n  type AutomationRectTarget,\n  type GeometryVerdict,\n  type RectAxis,\n  type RectBox,\n  type RectEdge,\n} from './automation_assertions.js';\nexport {\n  InProcessRouterTransport,\n  LoopbackRemoteTransport,\n  LoopbackRemoteTransportServer,\n  assertLoopbackSerializable,\n  LoopbackSerializationError,\n  buildTransportBridge,\n  type WoodRpcTransport,\n  type WoodChannelContract,\n  type WoodChannelMapLike,\n  type WoodChannelInput,\n  type WoodChannelOutput,\n  type TypedCall,\n  type TransportBridgeResult,\n} from '../transport/index.js';\nexport { TraceRecorder } from '../trace-testing/index.js';\nexport type {\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceWaitOptions,\n} from '../tracing/index.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mCAAoC;AACpC,uCAIO;AACP,gCAAwD;AACxD,2BAAqD;AACrD,kCAIO;AACP,qBAyBO;AACP,mCAsBO;AACP,uBAcO;AACP,2BAA8B;","names":[]}
+{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["// Canonical entry point — config-driven, real-IoC testWood(configPath).\nexport { testWood, TestWoodBuilder } from './test_wood_config.cjs';\nexport type {\n  TestWoodEnvironment,\n  WoodComposeContext,\n  WoodComposeMain,\n  WoodComposeResult,\n} from './test_wood_config.cjs';\nexport type { WoodTestSelection, WoodMainSelection, WoodDomMode } from './wood_test_selection.cjs';\nexport type { WoodPageHost, WoodMountedPage, WoodRendererHooks } from './wood_env_renderer.cjs';\nexport type { ModuleImporter } from './wood_config_source.cjs';\nexport { TestWoodError, WOOD_FRONTEND_BRIDGE } from './test_wood.cjs';\nexport { FrontendLifecycleOwner, FrontendWorkError, PageCatalogError, PageCatalog, WorkRegistry, TrackedTransport, createFrontendSurface, parseViewsSource, pageIdentity } from '../frontend/index.cjs';\nexport type { FrontendApplicationSurface, FrontendOpenOptions, FrontendPage, FrontendLifecycle, RendererSelection, ViewsSource, CreateFrontendSurfaceOptions, WorkFailure, WorkDescriptor } from '../frontend/index.cjs';\n\n/** @deprecated createTestContainer's fake container bypasses real dependency\n * resolution and is retained only for parser/compiler fixtures that do not\n * claim production-equivalent IoC behavior. Canonical tests use testWood /\n * @noego/testing's testIoc, which build fresh REAL @noego/ioc roots. */\nexport { createTestContainer } from './create_test_container.js';\nexport {\n  createControllerHarness,\n  type ControllerHarnessResult,\n  type CreateControllerHarnessOptions,\n} from './create_controller_harness.js';\nexport { createTestRouter, type TestRouterResult } from './create_test_router.js';\nexport { mockElectron, getElectronMockFactory } from './mock_electron.js';\nexport {\n  createRouterBridge,\n  RouterBridgeEvents,\n  type RouterBridgeResult,\n} from './create_router_bridge.js';\nexport {\n  browser,\n  createBrowserBridgeFixture,\n  startSharedBrowserViteServer,\n  type MountedWoodBridge,\n  type MountedWoodComponent,\n  type MountedWoodNavigation,\n  type MountedWoodRoute,\n  type MountedWoodSurface,\n  type MountedWoodTree,\n  type MountComponentOptions,\n  type MountRouteOptions,\n  type MountTreeOptions,\n  type WoodBridgeFixtureContext,\n  type WoodBridgeFixtureInput,\n  type WoodBridgeRecordedCall,\n  type WoodBridgeRecordedEvent,\n  type WoodRpcManifestEntryInput,\n  type WoodBrowserExpect,\n  type WoodHitTestResult,\n  type WoodRectSnapshot,\n  type WoodBrowserHarness,\n  type WoodBrowserHarnessConfig,\n  type WoodBrowserPageContext,\n  type WoodBrowserTraceConfig,\n  type WoodViewport,\n} from './browser.js';\nexport {\n  automationAssertions,\n  visible,\n  hidden,\n  insideViewport,\n  notClipped,\n  notOverlapping,\n  hitTestReachable,\n  sharedEdges,\n  evenSpacing,\n  stableAfterAnimation,\n  rectsOverlap,\n  gaps,\n  sharedRectEdges,\n  evenSpacingRects,\n  type AssertionVerdict,\n  type AutomationTarget,\n  type AutomationRectTarget,\n  type GeometryVerdict,\n  type RectAxis,\n  type RectBox,\n  type RectEdge,\n} from './automation_assertions.js';\nexport {\n  InProcessRouterTransport,\n  LoopbackRemoteTransport,\n  LoopbackRemoteTransportServer,\n  assertLoopbackSerializable,\n  LoopbackSerializationError,\n  buildTransportBridge,\n  type WoodRpcTransport,\n  type WoodChannelContract,\n  type WoodChannelMapLike,\n  type WoodChannelInput,\n  type WoodChannelOutput,\n  type TypedCall,\n  type TransportBridgeResult,\n} from '../transport/index.js';\nexport { TraceRecorder } from '../trace-testing/index.js';\nexport type {\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceWaitOptions,\n} from '../tracing/index.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,8BAA0C;AAU1C,uBAAoD;AACpD,sBAAgL;AAOhL,mCAAoC;AACpC,uCAIO;AACP,gCAAwD;AACxD,2BAAqD;AACrD,kCAIO;AACP,qBA0BO;AACP,mCAsBO;AACP,uBAcO;AACP,2BAA8B;","names":[]}

package/dist/testing/index.d.cts

@@ -1,9 +1,20 @@
+export { TestWoodBuilder, TestWoodEnvironment, WoodComposeContext, WoodComposeMain, WoodComposeResult, testWood } from './test_wood_config.cjs';
+export { WoodDomMode, WoodMainSelection, WoodTestSelection } from './wood_test_selection.cjs';
+export { WoodMountedPage, WoodPageHost, WoodRendererHooks } from './wood_env_renderer.cjs';
+export { ModuleImporter } from './wood_config_source.cjs';
+export { TestWoodError, WOOD_FRONTEND_BRIDGE } from './test_wood.cjs';
+export { FrontendWorkError, WorkDescriptor, WorkFailure, WorkRegistry } from '../frontend/work_registry.cjs';
+export { FrontendLifecycle, FrontendLifecycleOwner } from '../frontend/frontend_lifecycle.cjs';
+export { PageCatalog, PageCatalogError, RendererSelection, ViewsSource, pageIdentity, parseViewsSource } from '../frontend/page_catalog.cjs';
+export { TrackedTransport } from '../frontend/tracked_transport.cjs';
+export { FrontendPage } from '../frontend/frontend_page.cjs';
+export { CreateFrontendSurfaceOptions, FrontendApplicationSurface, FrontendOpenOptions, createFrontendSurface } from '../frontend/frontend_surface.cjs';
 export { createTestContainer } from './create_test_container.cjs';
 export { ControllerHarnessResult, CreateControllerHarnessOptions, createControllerHarness } from './create_controller_harness.cjs';
 export { TestRouterResult, createTestRouter } from './create_test_router.cjs';
 export { getElectronMockFactory, mockElectron } from './mock_electron.cjs';
 export { RouterBridgeEvents, RouterBridgeResult, createRouterBridge } from './create_router_bridge.cjs';
-export { MountComponentOptions, MountRouteOptions, MountTreeOptions, MountedWoodBridge, MountedWoodComponent, MountedWoodNavigation, MountedWoodRoute, MountedWoodSurface, MountedWoodTree, WoodBridgeFixtureContext, WoodBridgeFixtureInput, WoodBridgeRecordedCall, WoodBridgeRecordedEvent, WoodBrowserExpect, WoodBrowserHarness, WoodBrowserHarnessConfig, WoodBrowserPageContext, WoodBrowserTraceConfig, WoodHitTestResult, WoodRectSnapshot, WoodRpcManifestEntryInput, WoodViewport, browser, createBrowserBridgeFixture } from './browser.cjs';
+export { MountComponentOptions, MountRouteOptions, MountTreeOptions, MountedWoodBridge, MountedWoodComponent, MountedWoodNavigation, MountedWoodRoute, MountedWoodSurface, MountedWoodTree, WoodBridgeFixtureContext, WoodBridgeFixtureInput, WoodBridgeRecordedCall, WoodBridgeRecordedEvent, WoodBrowserExpect, WoodBrowserHarness, WoodBrowserHarnessConfig, WoodBrowserPageContext, WoodBrowserTraceConfig, WoodHitTestResult, WoodRectSnapshot, WoodRpcManifestEntryInput, WoodViewport, browser, createBrowserBridgeFixture, startSharedBrowserViteServer } from './browser.cjs';
 export { AssertionVerdict, AutomationRectTarget, AutomationTarget, automationAssertions, evenSpacing, hidden, hitTestReachable, insideViewport, notClipped, notOverlapping, sharedEdges, stableAfterAnimation, visible } from './automation_assertions.cjs';
 export { TypedCall, WoodChannelContract, WoodChannelInput, WoodChannelMapLike, WoodChannelOutput, WoodRpcTransport } from '../transport/wood_rpc_transport.cjs';
 export { InProcessRouterTransport } from '../transport/in_process_router_transport.cjs';
@@ -11,14 +22,18 @@ export { LoopbackRemoteTransport, LoopbackRemoteTransportServer } from '../trans
 export { LoopbackSerializationError, assertLoopbackSerializable } from '../transport/loopback_serialization.cjs';
 export { TransportBridgeResult, buildTransportBridge } from '../transport/build_transport_bridge.cjs';
 export { TraceRecorder } from '../trace-testing/trace_recorder.cjs';
-export { T as TraceDispatchResult, a as TraceEvent, b as TraceInput, f as TraceWaitOptions } from '../trace_hub-Cob54qRx.cjs';
+export { T as TraceDispatchResult, a as TraceEvent, b as TraceInput, f as TraceWaitOptions } from '../trace_hub-Cpo_nVze.cjs';
 export { GeometryVerdict, RectAxis, RectBox, RectEdge, evenSpacing as evenSpacingRects, gaps, rectsOverlap, sharedEdges as sharedRectEdges } from './geometry.cjs';
-import '../navigation/index.cjs';
-import '../navigation/automation_introspection.cjs';
+import '@noego/ioc';
+import '@noego/testing';
 import '../router/wood_router.cjs';
 import '../types/operations.cjs';
+import '../types/context.cjs';
+import '../types/config.cjs';
+import '../types/views.cjs';
+import '../navigation/index.cjs';
+import '../navigation/automation_introspection.cjs';
 import 'playwright';
 import '@noego/trace/testing';
 import '../tracing/trace_provider.cjs';
-import '@noego/ioc';
 import 'rxjs';

package/dist/testing/index.d.ts

@@ -1,9 +1,20 @@
+export { TestWoodBuilder, TestWoodEnvironment, WoodComposeContext, WoodComposeMain, WoodComposeResult, testWood } from './test_wood_config.js';
+export { WoodDomMode, WoodMainSelection, WoodTestSelection } from './wood_test_selection.js';
+export { WoodMountedPage, WoodPageHost, WoodRendererHooks } from './wood_env_renderer.js';
+export { ModuleImporter } from './wood_config_source.js';
+export { TestWoodError, WOOD_FRONTEND_BRIDGE } from './test_wood.js';
+export { FrontendWorkError, WorkDescriptor, WorkFailure, WorkRegistry } from '../frontend/work_registry.js';
+export { FrontendLifecycle, FrontendLifecycleOwner } from '../frontend/frontend_lifecycle.js';
+export { PageCatalog, PageCatalogError, RendererSelection, ViewsSource, pageIdentity, parseViewsSource } from '../frontend/page_catalog.js';
+export { TrackedTransport } from '../frontend/tracked_transport.js';
+export { FrontendPage } from '../frontend/frontend_page.js';
+export { CreateFrontendSurfaceOptions, FrontendApplicationSurface, FrontendOpenOptions, createFrontendSurface } from '../frontend/frontend_surface.js';
 export { createTestContainer } from './create_test_container.js';
 export { ControllerHarnessResult, CreateControllerHarnessOptions, createControllerHarness } from './create_controller_harness.js';
 export { TestRouterResult, createTestRouter } from './create_test_router.js';
 export { getElectronMockFactory, mockElectron } from './mock_electron.js';
 export { RouterBridgeEvents, RouterBridgeResult, createRouterBridge } from './create_router_bridge.js';
-export { MountComponentOptions, MountRouteOptions, MountTreeOptions, MountedWoodBridge, MountedWoodComponent, MountedWoodNavigation, MountedWoodRoute, MountedWoodSurface, MountedWoodTree, WoodBridgeFixtureContext, WoodBridgeFixtureInput, WoodBridgeRecordedCall, WoodBridgeRecordedEvent, WoodBrowserExpect, WoodBrowserHarness, WoodBrowserHarnessConfig, WoodBrowserPageContext, WoodBrowserTraceConfig, WoodHitTestResult, WoodRectSnapshot, WoodRpcManifestEntryInput, WoodViewport, browser, createBrowserBridgeFixture } from './browser.js';
+export { MountComponentOptions, MountRouteOptions, MountTreeOptions, MountedWoodBridge, MountedWoodComponent, MountedWoodNavigation, MountedWoodRoute, MountedWoodSurface, MountedWoodTree, WoodBridgeFixtureContext, WoodBridgeFixtureInput, WoodBridgeRecordedCall, WoodBridgeRecordedEvent, WoodBrowserExpect, WoodBrowserHarness, WoodBrowserHarnessConfig, WoodBrowserPageContext, WoodBrowserTraceConfig, WoodHitTestResult, WoodRectSnapshot, WoodRpcManifestEntryInput, WoodViewport, browser, createBrowserBridgeFixture, startSharedBrowserViteServer } from './browser.js';
 export { AssertionVerdict, AutomationRectTarget, AutomationTarget, automationAssertions, evenSpacing, hidden, hitTestReachable, insideViewport, notClipped, notOverlapping, sharedEdges, stableAfterAnimation, visible } from './automation_assertions.js';
 export { TypedCall, WoodChannelContract, WoodChannelInput, WoodChannelMapLike, WoodChannelOutput, WoodRpcTransport } from '../transport/wood_rpc_transport.js';
 export { InProcessRouterTransport } from '../transport/in_process_router_transport.js';
@@ -11,14 +22,18 @@ export { LoopbackRemoteTransport, LoopbackRemoteTransportServer } from '../trans
 export { LoopbackSerializationError, assertLoopbackSerializable } from '../transport/loopback_serialization.js';
 export { TransportBridgeResult, buildTransportBridge } from '../transport/build_transport_bridge.js';
 export { TraceRecorder } from '../trace-testing/trace_recorder.js';
-export { T as TraceDispatchResult, a as TraceEvent, b as TraceInput, f as TraceWaitOptions } from '../trace_hub-Cob54qRx.js';
+export { T as TraceDispatchResult, a as TraceEvent, b as TraceInput, f as TraceWaitOptions } from '../trace_hub-Cpo_nVze.js';
 export { GeometryVerdict, RectAxis, RectBox, RectEdge, evenSpacing as evenSpacingRects, gaps, rectsOverlap, sharedEdges as sharedRectEdges } from './geometry.js';
-import '../navigation/index.js';
-import '../navigation/automation_introspection.js';
+import '@noego/ioc';
+import '@noego/testing';
 import '../router/wood_router.js';
 import '../types/operations.js';
+import '../types/context.js';
+import '../types/config.js';
+import '../types/views.js';
+import '../navigation/index.js';
+import '../navigation/automation_introspection.js';
 import 'playwright';
 import '@noego/trace/testing';
 import '../tracing/trace_provider.js';
-import '@noego/ioc';
 import 'rxjs';