@noego/wood 0.4.9 → 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

@@ -2,13 +2,14 @@ import { Navigation } from '../navigation/index.cjs';
 import { TraceRecorder } from '../trace-testing/trace_recorder.cjs';
 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;
@@ -22,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

@@ -2,13 +2,14 @@ import { Navigation } from '../navigation/index.js';
 import { TraceRecorder } from '../trace-testing/trace_recorder.js';
 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;
@@ -22,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/geometry.cjs

@@ -0,0 +1,109 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var geometry_exports = {};
+__export(geometry_exports, {
+  axisEdges: () => axisEdges,
+  axisGap: () => axisGap,
+  evenSpacing: () => evenSpacing,
+  gaps: () => gaps,
+  rectsOverlap: () => rectsOverlap,
+  sharedEdges: () => sharedEdges,
+  snapshotRectsOverlap: () => snapshotRectsOverlap
+});
+module.exports = __toCommonJS(geometry_exports);
+function axisEdges(rect, axis) {
+  return axis === "horizontal" ? { leading: rect.left, trailing: rect.right } : { leading: rect.top, trailing: rect.bottom };
+}
+function axisGap(first, second, axis) {
+  const a = axisEdges(first, axis);
+  const b = axisEdges(second, axis);
+  const [earlier, later] = a.leading <= b.leading ? [a, b] : [b, a];
+  return later.leading - earlier.trailing;
+}
+function rectsOverlap(a, b) {
+  return Boolean(
+    a && b && a.left < b.right && a.right > b.left && a.top < b.bottom && a.bottom > b.top
+  );
+}
+function snapshotRectsOverlap(a, b) {
+  return a.x < b.x + b.w && a.x + a.w > b.x && a.y < b.y + b.h && a.y + a.h > b.y;
+}
+function sharedEdges(rects, edge, options = {}) {
+  const tolerance = options.tolerance ?? 1;
+  if (rects.length < 2) {
+    return {
+      pass: false,
+      message: "sharedEdges requires at least two rects.",
+      details: { count: rects.length, edge, tolerance }
+    };
+  }
+  const expected = rects[0][edge];
+  const deltas = rects.slice(1).map((rect) => Math.abs(rect[edge] - expected));
+  const maximumDelta = Math.max(...deltas);
+  const pass = maximumDelta <= tolerance;
+  return {
+    pass,
+    message: pass ? `All rects share the ${edge} edge within ${tolerance}px.` : `Rects do not share the ${edge} edge within ${tolerance}px (maximum delta ${maximumDelta.toFixed(2)}px).`,
+    details: { edge, tolerance, expected, deltas, maximumDelta }
+  };
+}
+function gaps(rects, axis) {
+  const sorted = [...rects].sort(
+    (a, b) => axisEdges(a, axis).leading - axisEdges(b, axis).leading
+  );
+  return sorted.slice(1).map((rect, index) => axisGap(sorted[index], rect, axis));
+}
+function evenSpacing(rects, axis, options = {}) {
+  const tolerance = options.tolerance ?? 1;
+  if (rects.length < 3) {
+    return {
+      pass: false,
+      message: `evenSpacing requires at least three rects, got ${rects.length}.`,
+      details: { count: rects.length, axis, tolerance }
+    };
+  }
+  const measuredGaps = gaps(rects, axis);
+  const widest = Math.max(...measuredGaps);
+  const narrowest = Math.min(...measuredGaps);
+  const spread = widest - narrowest;
+  const pass = spread <= tolerance;
+  return {
+    pass,
+    message: pass ? `Rects are evenly spaced along ${axis} within ${tolerance}px.` : `Rects are not evenly spaced along ${axis}: gap spread ${spread.toFixed(2)}px exceeds ${tolerance}px.`,
+    details: {
+      axis,
+      tolerance,
+      gaps: measuredGaps,
+      widest,
+      narrowest,
+      spread
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  axisEdges,
+  axisGap,
+  evenSpacing,
+  gaps,
+  rectsOverlap,
+  sharedEdges,
+  snapshotRectsOverlap
+});
+//# sourceMappingURL=geometry.cjs.map

package/dist/testing/geometry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/geometry.ts"],"sourcesContent":["export type RectAxis = 'horizontal' | 'vertical';\n\nexport interface RectBox {\n  top: number;\n  left: number;\n  right: number;\n  bottom: number;\n  width: number;\n  height: number;\n}\n\nexport interface SnapshotRect {\n  x: number;\n  y: number;\n  w: number;\n  h: number;\n}\n\nexport interface GeometryVerdict {\n  pass: boolean;\n  message: string;\n  details?: Record<string, unknown>;\n}\n\nexport type RectEdge = 'left' | 'right' | 'top' | 'bottom';\n\nexport function axisEdges(\n  rect: RectBox,\n  axis: RectAxis,\n): { leading: number; trailing: number } {\n  return axis === 'horizontal'\n    ? { leading: rect.left, trailing: rect.right }\n    : { leading: rect.top, trailing: rect.bottom };\n}\n\n/**\n * Edge-to-edge gap between two border boxes. The box with the smaller leading\n * edge is treated as the earlier box, so negative values mean overlap.\n */\nexport function axisGap(first: RectBox, second: RectBox, axis: RectAxis): number {\n  const a = axisEdges(first, axis);\n  const b = axisEdges(second, axis);\n  const [earlier, later] = a.leading <= b.leading ? [a, b] : [b, a];\n  return later.leading - earlier.trailing;\n}\n\nexport function rectsOverlap(\n  a: RectBox | null | undefined,\n  b: RectBox | null | undefined,\n): boolean {\n  return Boolean(\n    a && b\n    && a.left < b.right && a.right > b.left\n    && a.top < b.bottom && a.bottom > b.top,\n  );\n}\n\n/** Two CDP snapshot `[x,y,w,h]` rects overlap on both axes. */\nexport function snapshotRectsOverlap(a: SnapshotRect, b: SnapshotRect): boolean {\n  return a.x < b.x + b.w\n    && a.x + a.w > b.x\n    && a.y < b.y + b.h\n    && a.y + a.h > b.y;\n}\n\n/** Assert that every rect shares one named edge with the first rect. */\nexport function sharedEdges(\n  rects: readonly RectBox[],\n  edge: RectEdge,\n  options: { tolerance?: number } = {},\n): GeometryVerdict {\n  const tolerance = options.tolerance ?? 1;\n  if (rects.length < 2) {\n    return {\n      pass: false,\n      message: 'sharedEdges requires at least two rects.',\n      details: { count: rects.length, edge, tolerance },\n    };\n  }\n\n  const expected = rects[0][edge];\n  const deltas = rects.slice(1).map((rect) => Math.abs(rect[edge] - expected));\n  const maximumDelta = Math.max(...deltas);\n  const pass = maximumDelta <= tolerance;\n  return {\n    pass,\n    message: pass\n      ? `All rects share the ${edge} edge within ${tolerance}px.`\n      : `Rects do not share the ${edge} edge within ${tolerance}px (maximum delta ${maximumDelta.toFixed(2)}px).`,\n    details: { edge, tolerance, expected, deltas, maximumDelta },\n  };\n}\n\n/** Consecutive edge-to-edge gaps, after sorting rects along the requested axis. */\nexport function gaps(rects: readonly RectBox[], axis: RectAxis): number[] {\n  const sorted = [...rects].sort(\n    (a, b) => axisEdges(a, axis).leading - axisEdges(b, axis).leading,\n  );\n  return sorted.slice(1).map((rect, index) => axisGap(sorted[index], rect, axis));\n}\n\n/** Assert that consecutive rect gaps have no more than the requested spread. */\nexport function evenSpacing(\n  rects: readonly RectBox[],\n  axis: RectAxis,\n  options: { tolerance?: number } = {},\n): GeometryVerdict {\n  const tolerance = options.tolerance ?? 1;\n  if (rects.length < 3) {\n    return {\n      pass: false,\n      message: `evenSpacing requires at least three rects, got ${rects.length}.`,\n      details: { count: rects.length, axis, tolerance },\n    };\n  }\n\n  const measuredGaps = gaps(rects, axis);\n  const widest = Math.max(...measuredGaps);\n  const narrowest = Math.min(...measuredGaps);\n  const spread = widest - narrowest;\n  const pass = spread <= tolerance;\n  return {\n    pass,\n    message: pass\n      ? `Rects are evenly spaced along ${axis} within ${tolerance}px.`\n      : `Rects are not evenly spaced along ${axis}: gap spread ${spread.toFixed(2)}px exceeds ${tolerance}px.`,\n    details: {\n      axis,\n      tolerance,\n      gaps: measuredGaps,\n      widest,\n      narrowest,\n      spread,\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/testing/geometry.d.cts

@@ -0,0 +1,45 @@
+type RectAxis = 'horizontal' | 'vertical';
+interface RectBox {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+}
+interface SnapshotRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+interface GeometryVerdict {
+    pass: boolean;
+    message: string;
+    details?: Record<string, unknown>;
+}
+type RectEdge = 'left' | 'right' | 'top' | 'bottom';
+declare function axisEdges(rect: RectBox, axis: RectAxis): {
+    leading: number;
+    trailing: number;
+};
+/**
+ * Edge-to-edge gap between two border boxes. The box with the smaller leading
+ * edge is treated as the earlier box, so negative values mean overlap.
+ */
+declare function axisGap(first: RectBox, second: RectBox, axis: RectAxis): number;
+declare function rectsOverlap(a: RectBox | null | undefined, b: RectBox | null | undefined): boolean;
+/** Two CDP snapshot `[x,y,w,h]` rects overlap on both axes. */
+declare function snapshotRectsOverlap(a: SnapshotRect, b: SnapshotRect): boolean;
+/** Assert that every rect shares one named edge with the first rect. */
+declare function sharedEdges(rects: readonly RectBox[], edge: RectEdge, options?: {
+    tolerance?: number;
+}): GeometryVerdict;
+/** Consecutive edge-to-edge gaps, after sorting rects along the requested axis. */
+declare function gaps(rects: readonly RectBox[], axis: RectAxis): number[];
+/** Assert that consecutive rect gaps have no more than the requested spread. */
+declare function evenSpacing(rects: readonly RectBox[], axis: RectAxis, options?: {
+    tolerance?: number;
+}): GeometryVerdict;
+
+export { type GeometryVerdict, type RectAxis, type RectBox, type RectEdge, type SnapshotRect, axisEdges, axisGap, evenSpacing, gaps, rectsOverlap, sharedEdges, snapshotRectsOverlap };

package/dist/testing/geometry.d.ts

@@ -0,0 +1,45 @@
+type RectAxis = 'horizontal' | 'vertical';
+interface RectBox {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+}
+interface SnapshotRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+interface GeometryVerdict {
+    pass: boolean;
+    message: string;
+    details?: Record<string, unknown>;
+}
+type RectEdge = 'left' | 'right' | 'top' | 'bottom';
+declare function axisEdges(rect: RectBox, axis: RectAxis): {
+    leading: number;
+    trailing: number;
+};
+/**
+ * Edge-to-edge gap between two border boxes. The box with the smaller leading
+ * edge is treated as the earlier box, so negative values mean overlap.
+ */
+declare function axisGap(first: RectBox, second: RectBox, axis: RectAxis): number;
+declare function rectsOverlap(a: RectBox | null | undefined, b: RectBox | null | undefined): boolean;
+/** Two CDP snapshot `[x,y,w,h]` rects overlap on both axes. */
+declare function snapshotRectsOverlap(a: SnapshotRect, b: SnapshotRect): boolean;
+/** Assert that every rect shares one named edge with the first rect. */
+declare function sharedEdges(rects: readonly RectBox[], edge: RectEdge, options?: {
+    tolerance?: number;
+}): GeometryVerdict;
+/** Consecutive edge-to-edge gaps, after sorting rects along the requested axis. */
+declare function gaps(rects: readonly RectBox[], axis: RectAxis): number[];
+/** Assert that consecutive rect gaps have no more than the requested spread. */
+declare function evenSpacing(rects: readonly RectBox[], axis: RectAxis, options?: {
+    tolerance?: number;
+}): GeometryVerdict;
+
+export { type GeometryVerdict, type RectAxis, type RectBox, type RectEdge, type SnapshotRect, axisEdges, axisGap, evenSpacing, gaps, rectsOverlap, sharedEdges, snapshotRectsOverlap };