@noego/wood 0.5.0 → 0.6.0

package/dist/runtime/runtime.js

@@ -1,6 +1,9 @@
+import { getRendererTraceBatchReceiver } from "./renderer_trace_batch_receiver_registry.js";
 import { getLogger } from "@noego/logger";
 import { WoodRouter } from "../router/wood_router.js";
-import { getContainer } from "./get_container.js";
+import { createWoodRoot } from "./get_container.js";
+import { ExecutionContext } from "@noego/ioc";
+import { installWoodRuntime } from "./runtime_module.js";
 import {
   RendererTraceBatchHost,
   TraceProviderConfiguration,
@@ -11,11 +14,11 @@ import {
   setRendererTraceMinLevel
 } from "../tracing/index.js";
 import {
-  getRendererLogDispatcher
+  getRendererLogDispatcher,
+  RendererLogDispatcher
 } from "./renderer_log_dispatcher.js";
 import { dispatchRendererLogBatch } from "./renderer_log_batch_receiver.js";
 import { resolveRendererConfigExtension } from "./renderer_config_extension.js";
-import { getRendererTraceBatchReceiver } from "./renderer_trace_batch_receiver_registry.js";
 import { resolveWoodAppEnv } from "./app_env.js";
 const logger = getLogger("wood:runtime");
 function normalizeRendererLogLevel(level) {
@@ -41,7 +44,6 @@ function coerceRendererLogPayload(rawPayload, event) {
 }
 async function runtime(options) {
   const {
-    ipcMain,
     registerRuntime,
     controllersDir,
     middlewareDir,
@@ -52,60 +54,110 @@ async function runtime(options) {
     rendererTraceEnabled = false,
     rendererTraceMinLevel = "debug"
   } = options;
-  const container = options.container ?? getContainer();
-  const rendererTraceBatchReceiver = options.rendererTraceBatchReceiver ?? getRendererTraceBatchReceiver();
+  const container = options.container ?? createWoodRoot();
+  const rendererTraceBatchReceiver = options.rendererTraceBatchReceiver ?? (options.legacyGlobals ? getRendererTraceBatchReceiver() : null);
   const rendererTraceBatchEnabled = rendererTraceBatchReceiver !== null;
-  const rendererTraceBatchHost = new RendererTraceBatchHost(
-    rendererTraceBatchReceiver
-  );
-  logger.info("runtime start", {
-    mode,
-    hasProvidedContainer: !!options.container,
-    controllersDir,
-    middlewareDir,
-    enableRendererLogBridge,
-    enableRendererTraceBridge,
-    traceMinLevel: traceMinLevel ?? "debug",
-    rendererTraceEnabled,
-    rendererTraceMinLevel,
-    rendererTraceBatchEnabled
-  });
-  const traceSettings = {
-    enableRendererLogBridge,
-    enableRendererTraceBridge,
-    traceMinLevel,
-    rendererTraceEnabled,
-    rendererTraceMinLevel,
-    rendererTraceBatchEnabled
+  const handlers = [];
+  const listeners = [];
+  let router;
+  let closing;
+  const dispose = (timeoutMs) => closing ?? (closing = (async () => {
+    const errors = [];
+    for (const channel of handlers.splice(0)) {
+      try {
+        options.ipcMain.removeHandler?.(channel);
+      } catch (error) {
+        errors.push(error);
+      }
+    }
+    for (const [channel, listener] of listeners.splice(0)) {
+      try {
+        if (options.ipcMain.removeListener) options.ipcMain.removeListener(channel, listener);
+        else options.ipcMain.removeAllListeners?.(channel);
+      } catch (error) {
+        errors.push(error);
+      }
+    }
+    let drained = true;
+    try {
+      await router?.dispose(timeoutMs);
+    } catch (error) {
+      drained = false;
+      errors.push(error);
+    }
+    if (!options.container && drained) {
+      try {
+        await ExecutionContext.run(container, () => container.dispose());
+      } catch (error) {
+        errors.push(error);
+      }
+    }
+    if (errors.length) throw Object.assign(new Error("Wood runtime cleanup failed"), { errors });
+  })().catch((error) => {
+    closing = void 0;
+    throw error;
+  }));
+  const ipcMain = {
+    handle(channel, handler) {
+      options.ipcMain.handle(channel, handler);
+      handlers.push(channel);
+    },
+    on(channel, listener) {
+      options.ipcMain.on(channel, listener);
+      listeners.push([channel, listener]);
+    }
   };
-  await configureRuntimeTracing(container, traceSettings);
-  const router = new WoodRouter({
-    container,
-    controllersDir,
-    middlewareDir,
-    mode
-  });
-  registerRuntime(router);
-  logger.info("runtime registration complete");
-  router.validateControllers();
-  logger.info("runtime controller validation complete");
-  router.precompileSchemas();
-  logger.info("runtime schema pre-compilation complete");
-  registerReservedRuntimeHandlers(router, options, traceSettings, rendererTraceBatchHost);
-  registerRuntimeObservationBridges(ipcMain, traceSettings, options.resolveRendererTraceContext);
-  router.registerIpcHandlers(ipcMain);
-  logger.info("runtime ipc handlers registered", {
-    channelCount: router.getChannels().length,
-    enableRendererLogBridge,
-    enableRendererTraceBridge
-  });
-  return { router };
+  try {
+    installWoodRuntime(container, { controllersDir, middlewareDir, mode, registerRuntime });
+    if (!container.isRegistered(RendererTraceBatchHost)) {
+      container.registerFunction(RendererTraceBatchHost, () => new RendererTraceBatchHost(rendererTraceBatchReceiver));
+    }
+    const rendererTraceBatchHost = await ExecutionContext.run(container, () => container.get(RendererTraceBatchHost));
+    logger.info("runtime start", {
+      mode,
+      hasProvidedContainer: !!options.container,
+      controllersDir,
+      middlewareDir,
+      enableRendererLogBridge,
+      enableRendererTraceBridge,
+      traceMinLevel: traceMinLevel ?? "debug",
+      rendererTraceEnabled,
+      rendererTraceMinLevel,
+      rendererTraceBatchEnabled
+    });
+    const traceSettings = {
+      enableRendererLogBridge,
+      enableRendererTraceBridge,
+      traceMinLevel,
+      rendererTraceEnabled,
+      rendererTraceMinLevel,
+      rendererTraceBatchEnabled
+    };
+    await configureRuntimeTracing(container, traceSettings, options.legacyGlobals ?? false);
+    router = await ExecutionContext.run(container, () => container.get(WoodRouter));
+    registerReservedRuntimeHandlers(router, options, traceSettings, rendererTraceBatchHost);
+    registerRuntimeObservationBridges(ipcMain, traceSettings, options.resolveRendererTraceContext, options.rendererLogDispatcher ?? (options.legacyGlobals ? getRendererLogDispatcher() : new RendererLogDispatcher()));
+    router.registerIpcHandlers(ipcMain);
+    logger.info("runtime ipc handlers registered", {
+      channelCount: router.getChannels().length,
+      enableRendererLogBridge,
+      enableRendererTraceBridge
+    });
+    return { router, dispose };
+  } catch (error) {
+    try {
+      await dispose();
+    } catch (cleanupError) {
+      throw Object.assign(new Error("Wood runtime startup and cleanup failed"), { cause: error, errors: [error, cleanupError] });
+    }
+    throw error;
+  }
 }
-async function configureRuntimeTracing(container, settings) {
-  if (settings.traceMinLevel) {
-    setMainTraceMinLevel(settings.traceMinLevel);
+async function configureRuntimeTracing(container, settings, legacyGlobals) {
+  if (legacyGlobals) {
+    if (settings.traceMinLevel) setMainTraceMinLevel(settings.traceMinLevel);
+    setRendererTraceMinLevel(settings.rendererTraceMinLevel);
   }
-  setRendererTraceMinLevel(settings.rendererTraceMinLevel);
   if (typeof container.instance !== "function") {
     return;
   }
@@ -126,7 +178,7 @@ function registerReservedRuntimeHandlers(router, options, settings, rendererTrac
   );
   router.registerReservedHandler("__woodConfig", async () => ({
     // App extension fields first so Wood's reserved keys always win.
-    ...await resolveRendererConfigExtension(),
+    ...await resolveRendererConfigExtension(options.rendererConfigExtension ?? (options.legacyGlobals ? void 0 : null)),
     rendererTraceEnabled: settings.rendererTraceEnabled,
     rendererTraceMinLevel: settings.rendererTraceMinLevel,
     rendererTraceBatchEnabled: settings.rendererTraceBatchEnabled,
@@ -136,9 +188,9 @@ function registerReservedRuntimeHandlers(router, options, settings, rendererTrac
     return rendererTraceBatchHost.receive(data, options.resolveRendererTraceContext?.(event) ?? {});
   });
 }
-function registerRuntimeObservationBridges(ipcMain, settings, resolveContext) {
+function registerRuntimeObservationBridges(ipcMain, settings, resolveContext, dispatcher) {
   if (settings.enableRendererLogBridge) {
-    registerRendererLogBridge(ipcMain);
+    registerRendererLogBridge(ipcMain, dispatcher);
   }
   ipcMain.removeAllListeners?.("__trace");
   if (settings.enableRendererTraceBridge && settings.rendererTraceEnabled) {
@@ -160,8 +212,7 @@ function registerRendererTraceBridge(ipcMain, resolveContext) {
   });
   logger.info("renderer trace bridge registered (fire-and-forget)");
 }
-function registerRendererLogBridge(ipcMain) {
-  const dispatcher = getRendererLogDispatcher();
+function registerRendererLogBridge(ipcMain, dispatcher) {
   ipcMain.removeAllListeners?.("__log");
   ipcMain.on("__log", (_event, rawPayload) => {
     const entry = coerceRendererLogPayload(rawPayload, null);

package/dist/runtime/runtime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/runtime/runtime.ts"],"sourcesContent":["import { getLogger } from '@noego/logger';\nimport { WoodRouter } from '../router/wood_router.js';\nimport { getContainer } from './get_container.js';\nimport {\n  RendererTraceBatchHost,\n  TraceProviderConfiguration,\n  dispatchRendererTracePayload,\n} from '../tracing/index.js';\nimport {\n  setMainTraceMinLevel,\n  setRendererTraceMinLevel,\n  type TraceLevel,\n  type TraceRuntimeContext,\n  type WoodTraceBatchReceiver,\n} from '../tracing/index.js';\nimport {\n  getRendererLogDispatcher,\n  type RendererLogDispatchResult,\n  type RendererLogEntry,\n  type RendererLogLevel,\n} from './renderer_log_dispatcher.js';\nimport { dispatchRendererLogBatch } from './renderer_log_batch_receiver.js';\nimport { resolveRendererConfigExtension } from './renderer_config_extension.js';\nimport { getRendererTraceBatchReceiver } from './renderer_trace_batch_receiver_registry.js';\nimport { resolveWoodAppEnv, type WoodAppEnv } from './app_env.js';\n\nconst logger = getLogger('wood:runtime');\n\ntype IpcMainLike = {\n  handle: (channel: string, handler: (_event: unknown, data: unknown) => Promise<unknown> | unknown) => void;\n  on: (channel: string, handler: (_event: unknown, ...args: unknown[]) => void) => void;\n  removeHandler?: (channel: string) => void;\n  removeAllListeners?: (channel: string) => void;\n};\n\nexport interface RegisterRuntimeRouter {\n  registerController(name: string, cls: any): void;\n  loadOperations(operations: Map<string, any>): void;\n}\n\nexport interface RuntimeOptions {\n  ipcMain: IpcMainLike;\n  registerRuntime: (router: RegisterRuntimeRouter) => void;\n  container?: any;\n  controllersDir: string;\n  middlewareDir: string;\n  mode?: 'bundled' | 'dev';\n  /** Override the resolved app environment tier reported to renderers via __woodConfig. */\n  appEnv?: WoodAppEnv;\n  enableRendererLogBridge?: boolean;\n  enableRendererTraceBridge?: boolean;\n  traceMinLevel?: TraceLevel;\n  rendererTraceEnabled?: boolean;\n  rendererTraceMinLevel?: TraceLevel;\n  /** Resolves only with the acknowledgement produced by the downstream durable receiver. */\n  rendererTraceBatchReceiver?: WoodTraceBatchReceiver;\n  onLoad?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onNavigate?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onWindow?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onDebug?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onContextMenu?: (data: unknown, event?: unknown) => Promise<unknown>;\n  resolveRendererTraceContext?: (event: unknown) => TraceRuntimeContext | undefined;\n}\n\nexport interface RuntimeResult {\n  router: WoodRouter;\n}\n\ntype RendererLogPayload = {\n  level: string;\n  logger: string;\n  message: string;\n  context?: unknown;\n};\n\ntype IpcInvokeEventLike = {\n  sender?: {\n    id?: number;\n  };\n};\n\ntype RuntimeReservedHandler = (\n  data: unknown,\n  event?: unknown,\n) => Promise<unknown>;\n\ntype RuntimeTraceSettings = Readonly<{\n  enableRendererLogBridge: boolean;\n  enableRendererTraceBridge: boolean;\n  traceMinLevel: TraceLevel | undefined;\n  rendererTraceEnabled: boolean;\n  rendererTraceMinLevel: TraceLevel;\n  rendererTraceBatchEnabled: boolean;\n}>;\n\nfunction normalizeRendererLogLevel(level: unknown): RendererLogLevel {\n  if (typeof level === 'string') {\n    const normalized = level.trim().toLowerCase();\n    if (normalized.length > 0) {\n      return normalized;\n    }\n  }\n  return 'info';\n}\n\nfunction coerceRendererLogPayload(\n  rawPayload: unknown,\n  event: unknown,\n): RendererLogEntry {\n  const payload = (rawPayload ?? {}) as Partial<RendererLogPayload>;\n  const ipcEvent = event as IpcInvokeEventLike;\n\n  return {\n    level: normalizeRendererLogLevel(payload.level),\n    logger: typeof payload.logger === 'string' && payload.logger.trim().length > 0\n      ? payload.logger\n      : 'renderer',\n    message: typeof payload.message === 'string' ? payload.message : '',\n    context: payload.context,\n    timestamp: new Date().toISOString(),\n    senderId: typeof ipcEvent?.sender?.id === 'number' ? ipcEvent.sender.id : null,\n  };\n}\n\n/**\n * Boot a bundled-safe Wood runtime using pre-generated static runtime artifacts.\n */\nexport async function runtime(options: RuntimeOptions): Promise<RuntimeResult> {\n  const {\n    ipcMain,\n    registerRuntime,\n    controllersDir,\n    middlewareDir,\n    mode = 'bundled',\n    enableRendererLogBridge = true,\n    enableRendererTraceBridge = true,\n    traceMinLevel,\n    rendererTraceEnabled = false,\n    rendererTraceMinLevel = 'debug',\n  } = options;\n\n  const container = options.container ?? getContainer();\n  const rendererTraceBatchReceiver = options.rendererTraceBatchReceiver\n    ?? getRendererTraceBatchReceiver();\n  const rendererTraceBatchEnabled = rendererTraceBatchReceiver !== null;\n  const rendererTraceBatchHost = new RendererTraceBatchHost(\n    rendererTraceBatchReceiver,\n  );\n\n  logger.info('runtime start', {\n    mode,\n    hasProvidedContainer: !!options.container,\n    controllersDir,\n    middlewareDir,\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n    traceMinLevel: traceMinLevel ?? 'debug',\n    rendererTraceEnabled,\n    rendererTraceMinLevel,\n    rendererTraceBatchEnabled,\n  });\n\n  const traceSettings: RuntimeTraceSettings = {\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n    traceMinLevel,\n    rendererTraceEnabled,\n    rendererTraceMinLevel,\n    rendererTraceBatchEnabled,\n  };\n  await configureRuntimeTracing(container, traceSettings);\n\n  const router = new WoodRouter({\n    container,\n    controllersDir,\n    middlewareDir,\n    mode,\n  });\n\n  registerRuntime(router);\n  logger.info('runtime registration complete');\n\n  router.validateControllers();\n  logger.info('runtime controller validation complete');\n\n  router.precompileSchemas();\n  logger.info('runtime schema pre-compilation complete');\n\n  registerReservedRuntimeHandlers(router, options, traceSettings, rendererTraceBatchHost);\n  registerRuntimeObservationBridges(ipcMain, traceSettings, options.resolveRendererTraceContext);\n\n  router.registerIpcHandlers(ipcMain);\n  logger.info('runtime ipc handlers registered', {\n    channelCount: router.getChannels().length,\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n  });\n\n  return { router };\n}\n\nasync function configureRuntimeTracing(\n  container: any,\n  settings: RuntimeTraceSettings,\n): Promise<void> {\n  if (settings.traceMinLevel) {\n    setMainTraceMinLevel(settings.traceMinLevel);\n  }\n  setRendererTraceMinLevel(settings.rendererTraceMinLevel);\n  if (typeof container.instance !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = await container.instance(TraceProviderConfiguration);\n  traceConfiguration.configureRuntime('main');\n  if (settings.traceMinLevel) {\n    traceConfiguration.configureMinLevel(settings.traceMinLevel);\n  }\n}\n\nfunction registerReservedRuntimeHandlers(\n  router: WoodRouter,\n  options: RuntimeOptions,\n  settings: RuntimeTraceSettings,\n  rendererTraceBatchHost: RendererTraceBatchHost,\n): void {\n  router.registerReservedHandler('__load', requireRuntimeHandler('__load', 'onLoad', options.onLoad));\n  router.registerReservedHandler('__navigate', requireRuntimeHandler('__navigate', 'onNavigate', options.onNavigate));\n  router.registerReservedHandler('__window', requireRuntimeHandler('__window', 'onWindow', options.onWindow));\n  router.registerReservedHandler('__debug', requireRuntimeHandler('__debug', 'onDebug', options.onDebug));\n  router.registerReservedHandler(\n    '__contextMenu',\n    requireRuntimeHandler('__contextMenu', 'onContextMenu', options.onContextMenu),\n  );\n  router.registerReservedHandler('__woodConfig', async () => ({\n    // App extension fields first so Wood's reserved keys always win.\n    ...(await resolveRendererConfigExtension()),\n    rendererTraceEnabled: settings.rendererTraceEnabled,\n    rendererTraceMinLevel: settings.rendererTraceMinLevel,\n    rendererTraceBatchEnabled: settings.rendererTraceBatchEnabled,\n    appEnv: options.appEnv ?? await resolveWoodAppEnv(),\n  }));\n  router.registerReservedHandler('__traceBatch', async (data, event) => {\n    return rendererTraceBatchHost.receive(data, options.resolveRendererTraceContext?.(event) ?? {});\n  });\n}\n\nfunction registerRuntimeObservationBridges(\n  ipcMain: IpcMainLike,\n  settings: RuntimeTraceSettings,\n  resolveContext: RuntimeOptions['resolveRendererTraceContext'],\n): void {\n  if (settings.enableRendererLogBridge) {\n    registerRendererLogBridge(ipcMain);\n  }\n  ipcMain.removeAllListeners?.('__trace');\n  if (settings.enableRendererTraceBridge && settings.rendererTraceEnabled) {\n    registerRendererTraceBridge(ipcMain, resolveContext);\n  }\n}\n\nfunction requireRuntimeHandler(\n  channel: string,\n  optionName: string,\n  handler: RuntimeReservedHandler | undefined,\n): RuntimeReservedHandler {\n  return async (data, event) => {\n    if (!handler) {\n      throw new Error(`Reserved channel \"${channel}\" not configured. Provide runtime({ ${optionName} }).`);\n    }\n    return handler(data, event);\n  };\n}\n\nfunction registerRendererTraceBridge(\n  ipcMain: IpcMainLike,\n  resolveContext?: (event: unknown) => TraceRuntimeContext | undefined,\n): void {\n  ipcMain.removeAllListeners?.('__trace');\n\n  ipcMain.on('__trace', (event, rawPayload) => {\n    dispatchRendererTracePayload(rawPayload, resolveContext?.(event));\n  });\n\n  logger.info('renderer trace bridge registered (fire-and-forget)');\n}\n\nfunction registerRendererLogBridge(ipcMain: IpcMainLike): void {\n  const dispatcher = getRendererLogDispatcher();\n\n  ipcMain.removeAllListeners?.('__log');\n\n  ipcMain.on('__log', (_event, rawPayload) => {\n    const entry = coerceRendererLogPayload(rawPayload, null);\n    void dispatcher.dispatch(entry).then((result) => {\n      const typedResult = result as RendererLogDispatchResult;\n      if (!typedResult.ok) {\n        logger.warn('renderer log dispatch failed', {\n          logger: entry.logger,\n          messageLength: entry.message.length,\n          reason: typedResult.reason ?? null,\n          errorMessage: typedResult.errorMessage ?? null,\n        });\n      }\n    });\n  });\n\n  ipcMain.removeAllListeners?.('__log_batch');\n\n  ipcMain.on('__log_batch', (_event, rawPayload) => {\n    const result = dispatchRendererLogBatch(rawPayload);\n    if (!result.ok) {\n      logger.warn('renderer log batch rejected', {\n        reason: result.reason ?? null,\n        errorMessage: result.errorMessage ?? null,\n      });\n    }\n  });\n\n  logger.info('renderer log bridge registered (fire-and-forget)');\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/runtime/runtime.ts"],"sourcesContent":["import { getRendererTraceBatchReceiver } from './renderer_trace_batch_receiver_registry.js';\nimport { getLogger } from '@noego/logger';\nimport { WoodRouter } from '../router/wood_router.js';\nimport { createWoodRoot } from './get_container.js';\nimport { ExecutionContext } from '@noego/ioc';\nimport { installWoodRuntime } from './runtime_module.js';\nimport {\n  RendererTraceBatchHost,\n  TraceProviderConfiguration,\n  dispatchRendererTracePayload,\n} from '../tracing/index.js';\nimport {\n  setMainTraceMinLevel,\n  setRendererTraceMinLevel,\n  type TraceLevel,\n  type TraceRuntimeContext,\n  type WoodTraceBatchReceiver,\n} from '../tracing/index.js';\nimport {\n  getRendererLogDispatcher,\n  RendererLogDispatcher,\n  type RendererLogDispatchResult,\n  type RendererLogEntry,\n  type RendererLogLevel,\n} from './renderer_log_dispatcher.js';\nimport { dispatchRendererLogBatch } from './renderer_log_batch_receiver.js';\nimport { resolveRendererConfigExtension, type RendererConfigExtension } from './renderer_config_extension.js';\nimport { resolveWoodAppEnv, type WoodAppEnv } from './app_env.js';\n\nconst logger = getLogger('wood:runtime');\n\ntype IpcMainLike = {\n  handle: (channel: string, handler: (_event: unknown, data: unknown) => Promise<unknown> | unknown) => void;\n  on: (channel: string, handler: (_event: unknown, ...args: unknown[]) => void) => void;\n  removeHandler?: (channel: string) => void;\n  removeAllListeners?: (channel: string) => void;\n  removeListener?: (channel: string, listener: (...args: any[]) => void) => void;\n};\n\nexport interface RegisterRuntimeRouter {\n  registerController(name: string, cls: any): void;\n  loadOperations(operations: Map<string, any>): void;\n}\n\nexport interface RuntimeOptions {\n  ipcMain: IpcMainLike;\n  /** Explicit migration adapter for the old process-global observation hooks. */\n  legacyGlobals?: boolean;\n  rendererLogDispatcher?: RendererLogDispatcher;\n  rendererConfigExtension?: RendererConfigExtension;\n  registerRuntime: (router: RegisterRuntimeRouter) => void;\n  container?: any;\n  controllersDir: string;\n  middlewareDir: string;\n  mode?: 'bundled' | 'dev';\n  /** Override the resolved app environment tier reported to renderers via __woodConfig. */\n  appEnv?: WoodAppEnv;\n  enableRendererLogBridge?: boolean;\n  enableRendererTraceBridge?: boolean;\n  traceMinLevel?: TraceLevel;\n  rendererTraceEnabled?: boolean;\n  rendererTraceMinLevel?: TraceLevel;\n  /** Resolves only with the acknowledgement produced by the downstream durable receiver. */\n  rendererTraceBatchReceiver?: WoodTraceBatchReceiver;\n  onLoad?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onNavigate?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onWindow?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onDebug?: (data: unknown, event?: unknown) => Promise<unknown>;\n  onContextMenu?: (data: unknown, event?: unknown) => Promise<unknown>;\n  resolveRendererTraceContext?: (event: unknown) => TraceRuntimeContext | undefined;\n}\n\nexport interface RuntimeResult {\n  router: WoodRouter;\n  /** Stop admission, drain operations, remove owned IPC handlers and dispose an internally created root. */\n  dispose(timeoutMs?: number): Promise<void>;\n}\n\ntype RendererLogPayload = {\n  level: string;\n  logger: string;\n  message: string;\n  context?: unknown;\n};\n\ntype IpcInvokeEventLike = {\n  sender?: {\n    id?: number;\n  };\n};\n\ntype RuntimeReservedHandler = (\n  data: unknown,\n  event?: unknown,\n) => Promise<unknown>;\n\ntype RuntimeTraceSettings = Readonly<{\n  enableRendererLogBridge: boolean;\n  enableRendererTraceBridge: boolean;\n  traceMinLevel: TraceLevel | undefined;\n  rendererTraceEnabled: boolean;\n  rendererTraceMinLevel: TraceLevel;\n  rendererTraceBatchEnabled: boolean;\n}>;\n\nfunction normalizeRendererLogLevel(level: unknown): RendererLogLevel {\n  if (typeof level === 'string') {\n    const normalized = level.trim().toLowerCase();\n    if (normalized.length > 0) {\n      return normalized;\n    }\n  }\n  return 'info';\n}\n\nfunction coerceRendererLogPayload(\n  rawPayload: unknown,\n  event: unknown,\n): RendererLogEntry {\n  const payload = (rawPayload ?? {}) as Partial<RendererLogPayload>;\n  const ipcEvent = event as IpcInvokeEventLike;\n\n  return {\n    level: normalizeRendererLogLevel(payload.level),\n    logger: typeof payload.logger === 'string' && payload.logger.trim().length > 0\n      ? payload.logger\n      : 'renderer',\n    message: typeof payload.message === 'string' ? payload.message : '',\n    context: payload.context,\n    timestamp: new Date().toISOString(),\n    senderId: typeof ipcEvent?.sender?.id === 'number' ? ipcEvent.sender.id : null,\n  };\n}\n\n/**\n * Boot a bundled-safe Wood runtime using pre-generated static runtime artifacts.\n */\nexport async function runtime(options: RuntimeOptions): Promise<RuntimeResult> {\n  const {\n    registerRuntime,\n    controllersDir,\n    middlewareDir,\n    mode = 'bundled',\n    enableRendererLogBridge = true,\n    enableRendererTraceBridge = true,\n    traceMinLevel,\n    rendererTraceEnabled = false,\n    rendererTraceMinLevel = 'debug',\n  } = options;\n\n  const container = options.container ?? createWoodRoot();\n  const rendererTraceBatchReceiver = options.rendererTraceBatchReceiver\n    ?? (options.legacyGlobals ? getRendererTraceBatchReceiver() : null);\n  const rendererTraceBatchEnabled = rendererTraceBatchReceiver !== null;\n  const handlers: string[] = [];\n  const listeners: Array<[string, (...args: any[]) => void]> = [];\n  let router: WoodRouter | undefined;\n  let closing: Promise<void> | undefined;\n  const dispose = (timeoutMs?: number): Promise<void> => closing ??= (async () => {\n    const errors: unknown[] = [];\n    for (const channel of handlers.splice(0)) {\n      try { options.ipcMain.removeHandler?.(channel); } catch (error) { errors.push(error); }\n    }\n    for (const [channel, listener] of listeners.splice(0)) {\n      try {\n        if (options.ipcMain.removeListener) options.ipcMain.removeListener(channel, listener);\n        else options.ipcMain.removeAllListeners?.(channel);\n      } catch (error) { errors.push(error); }\n    }\n    let drained = true;\n    try { await router?.dispose(timeoutMs); } catch (error) { drained = false; errors.push(error); }\n    // Pending work retains its root after a timeout. The caller can retry disposal.\n    if (!options.container && drained) {\n      try { await ExecutionContext.run(container, () => container.dispose()); } catch (error) { errors.push(error); }\n    }\n    if (errors.length) throw Object.assign(new Error('Wood runtime cleanup failed'), { errors });\n  })().catch(error => { closing = undefined; throw error; });\n  const ipcMain: IpcMainLike = {\n    handle(channel, handler) {\n      options.ipcMain.handle(channel, handler);\n      handlers.push(channel);\n    },\n    on(channel, listener) {\n      options.ipcMain.on(channel, listener);\n      listeners.push([channel, listener]);\n    },\n  };\n  try {\n  installWoodRuntime(container, { controllersDir, middlewareDir, mode, registerRuntime });\n  if (!container.isRegistered(RendererTraceBatchHost)) {\n    container.registerFunction(RendererTraceBatchHost, () => new RendererTraceBatchHost(rendererTraceBatchReceiver));\n  }\n  const rendererTraceBatchHost = await ExecutionContext.run(container, () => container.get(RendererTraceBatchHost)) as RendererTraceBatchHost;\n\n  logger.info('runtime start', {\n    mode,\n    hasProvidedContainer: !!options.container,\n    controllersDir,\n    middlewareDir,\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n    traceMinLevel: traceMinLevel ?? 'debug',\n    rendererTraceEnabled,\n    rendererTraceMinLevel,\n    rendererTraceBatchEnabled,\n  });\n\n  const traceSettings: RuntimeTraceSettings = {\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n    traceMinLevel,\n    rendererTraceEnabled,\n    rendererTraceMinLevel,\n    rendererTraceBatchEnabled,\n  };\n  await configureRuntimeTracing(container, traceSettings, options.legacyGlobals ?? false);\n\n  router = await ExecutionContext.run(container, () => container.get(WoodRouter)) as WoodRouter;\n\n  registerReservedRuntimeHandlers(router, options, traceSettings, rendererTraceBatchHost);\n  registerRuntimeObservationBridges(ipcMain, traceSettings, options.resolveRendererTraceContext, options.rendererLogDispatcher ?? (options.legacyGlobals ? getRendererLogDispatcher() : new RendererLogDispatcher()));\n\n  router.registerIpcHandlers(ipcMain);\n  logger.info('runtime ipc handlers registered', {\n    channelCount: router.getChannels().length,\n    enableRendererLogBridge,\n    enableRendererTraceBridge,\n  });\n\n  return { router, dispose };\n  } catch (error) {\n    try { await dispose(); } catch (cleanupError) {\n      throw Object.assign(new Error('Wood runtime startup and cleanup failed'), { cause: error, errors: [error, cleanupError] });\n    }\n    throw error;\n  }\n}\n\nasync function configureRuntimeTracing(\n  container: any,\n  settings: RuntimeTraceSettings,\n  legacyGlobals: boolean,\n): Promise<void> {\n  if (legacyGlobals) {\n    if (settings.traceMinLevel) setMainTraceMinLevel(settings.traceMinLevel);\n    setRendererTraceMinLevel(settings.rendererTraceMinLevel);\n  }\n  if (typeof container.instance !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = await container.instance(TraceProviderConfiguration);\n  traceConfiguration.configureRuntime('main');\n  if (settings.traceMinLevel) {\n    traceConfiguration.configureMinLevel(settings.traceMinLevel);\n  }\n}\n\nfunction registerReservedRuntimeHandlers(\n  router: WoodRouter,\n  options: RuntimeOptions,\n  settings: RuntimeTraceSettings,\n  rendererTraceBatchHost: RendererTraceBatchHost,\n): void {\n  router.registerReservedHandler('__load', requireRuntimeHandler('__load', 'onLoad', options.onLoad));\n  router.registerReservedHandler('__navigate', requireRuntimeHandler('__navigate', 'onNavigate', options.onNavigate));\n  router.registerReservedHandler('__window', requireRuntimeHandler('__window', 'onWindow', options.onWindow));\n  router.registerReservedHandler('__debug', requireRuntimeHandler('__debug', 'onDebug', options.onDebug));\n  router.registerReservedHandler(\n    '__contextMenu',\n    requireRuntimeHandler('__contextMenu', 'onContextMenu', options.onContextMenu),\n  );\n  router.registerReservedHandler('__woodConfig', async () => ({\n    // App extension fields first so Wood's reserved keys always win.\n    ...(await resolveRendererConfigExtension(options.rendererConfigExtension ?? (options.legacyGlobals ? undefined : null))),\n    rendererTraceEnabled: settings.rendererTraceEnabled,\n    rendererTraceMinLevel: settings.rendererTraceMinLevel,\n    rendererTraceBatchEnabled: settings.rendererTraceBatchEnabled,\n    appEnv: options.appEnv ?? await resolveWoodAppEnv(),\n  }));\n  router.registerReservedHandler('__traceBatch', async (data, event) => {\n    return rendererTraceBatchHost.receive(data, options.resolveRendererTraceContext?.(event) ?? {});\n  });\n}\n\nfunction registerRuntimeObservationBridges(\n  ipcMain: IpcMainLike,\n  settings: RuntimeTraceSettings,\n  resolveContext: RuntimeOptions['resolveRendererTraceContext'],\n  dispatcher: RendererLogDispatcher,\n): void {\n  if (settings.enableRendererLogBridge) {\n    registerRendererLogBridge(ipcMain, dispatcher);\n  }\n  ipcMain.removeAllListeners?.('__trace');\n  if (settings.enableRendererTraceBridge && settings.rendererTraceEnabled) {\n    registerRendererTraceBridge(ipcMain, resolveContext);\n  }\n}\n\nfunction requireRuntimeHandler(\n  channel: string,\n  optionName: string,\n  handler: RuntimeReservedHandler | undefined,\n): RuntimeReservedHandler {\n  return async (data, event) => {\n    if (!handler) {\n      throw new Error(`Reserved channel \"${channel}\" not configured. Provide runtime({ ${optionName} }).`);\n    }\n    return handler(data, event);\n  };\n}\n\nfunction registerRendererTraceBridge(\n  ipcMain: IpcMainLike,\n  resolveContext?: (event: unknown) => TraceRuntimeContext | undefined,\n): void {\n  ipcMain.removeAllListeners?.('__trace');\n\n  ipcMain.on('__trace', (event, rawPayload) => {\n    dispatchRendererTracePayload(rawPayload, resolveContext?.(event));\n  });\n\n  logger.info('renderer trace bridge registered (fire-and-forget)');\n}\n\nfunction registerRendererLogBridge(ipcMain: IpcMainLike, dispatcher: RendererLogDispatcher): void {\n\n  ipcMain.removeAllListeners?.('__log');\n\n  ipcMain.on('__log', (_event, rawPayload) => {\n    const entry = coerceRendererLogPayload(rawPayload, null);\n    void dispatcher.dispatch(entry).then((result) => {\n      const typedResult = result as RendererLogDispatchResult;\n      if (!typedResult.ok) {\n        logger.warn('renderer log dispatch failed', {\n          logger: entry.logger,\n          messageLength: entry.message.length,\n          reason: typedResult.reason ?? null,\n          errorMessage: typedResult.errorMessage ?? null,\n        });\n      }\n    });\n  });\n\n  ipcMain.removeAllListeners?.('__log_batch');\n\n  ipcMain.on('__log_batch', (_event, rawPayload) => {\n    const result = dispatchRendererLogBatch(rawPayload);\n    if (!result.ok) {\n      logger.warn('renderer log batch rejected', {\n        reason: result.reason ?? null,\n        errorMessage: result.errorMessage ?? null,\n      });\n    }\n  });\n\n  logger.info('renderer log bridge registered (fire-and-forget)');\n}\n"],"mappings":"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","names":[]}

package/dist/runtime/runtime_module.cjs

@@ -0,0 +1,58 @@
+"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 runtime_module_exports = {};
+__export(runtime_module_exports, {
+  ControllerResolver: () => import_controller_resolver.ControllerResolver,
+  MiddlewareResolver: () => import_middleware_resolver.MiddlewareResolver,
+  SchemaValidator: () => import_schema_validator.SchemaValidator,
+  WoodRouter: () => import_wood_router.WoodRouter,
+  installWoodRuntime: () => installWoodRuntime
+});
+module.exports = __toCommonJS(runtime_module_exports);
+var import_ioc = require("@noego/ioc");
+var import_wood_router = require("../router/wood_router.js");
+var import_schema_validator = require("../validation/schema_validator.js");
+var import_middleware_resolver = require("../middleware/middleware_resolver.js");
+var import_controller_resolver = require("../controller/controller_resolver.js");
+function installWoodRuntime(root, options) {
+  if (typeof root.isRegistered !== "function" || typeof root.registerFunction !== "function") {
+    throw new Error("Wood runtime requires an explicit IoC root; use createWoodRoot().");
+  }
+  if (!root.isRegistered(import_schema_validator.SchemaValidator)) root.registerFunction(import_schema_validator.SchemaValidator, () => new import_schema_validator.SchemaValidator());
+  if (!root.isRegistered(import_middleware_resolver.MiddlewareResolver)) root.registerFunction(import_middleware_resolver.MiddlewareResolver, () => new import_middleware_resolver.MiddlewareResolver(options.middlewareDir));
+  if (!root.isRegistered(import_controller_resolver.ControllerResolver)) root.registerFunction(import_controller_resolver.ControllerResolver, () => new import_controller_resolver.ControllerResolver(options.controllersDir, { mode: options.mode }));
+  if (!root.isRegistered(import_wood_router.WoodRouter)) {
+    root.registerFunction(import_wood_router.WoodRouter, (validator, middlewareResolver, controllerResolver) => {
+      const router = new import_wood_router.WoodRouter({ container: root, ...options, validator, middlewareResolver, controllerResolver });
+      options.registerRuntime(router);
+      router.validateControllers();
+      router.precompileSchemas();
+      return router;
+    }, { loadAs: import_ioc.LoadAs.Scoped, param: [import_schema_validator.SchemaValidator, import_middleware_resolver.MiddlewareResolver, import_controller_resolver.ControllerResolver] });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ControllerResolver,
+  MiddlewareResolver,
+  SchemaValidator,
+  WoodRouter,
+  installWoodRuntime
+});
+//# sourceMappingURL=runtime_module.cjs.map

package/dist/runtime/runtime_module.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/runtime_module.ts"],"sourcesContent":["import { LoadAs, type IContainer } from '@noego/ioc';\nimport { WoodRouter } from '../router/wood_router.js';\nimport { SchemaValidator } from '../validation/schema_validator.js';\nimport { MiddlewareResolver } from '../middleware/middleware_resolver.js';\nimport { ControllerResolver } from '../controller/controller_resolver.js';\n\nexport interface WoodRuntimeModuleOptions {\n  controllersDir: string;\n  middlewareDir: string;\n  mode?: 'bundled' | 'dev';\n  registerRuntime(router: WoodRouter): void;\n}\n\n/**\n * Registration-only production module, also installed by testWood before\n * scenario overlays. Resolving WoodRouter starts the selected real pipeline.\n * Existing registrations remain authoritative; token identities are exact.\n */\nexport function installWoodRuntime(root: IContainer, options: WoodRuntimeModuleOptions): void {\n  if (typeof root.isRegistered !== 'function' || typeof root.registerFunction !== 'function') {\n    throw new Error('Wood runtime requires an explicit IoC root; use createWoodRoot().');\n  }\n  if (!root.isRegistered(SchemaValidator)) root.registerFunction(SchemaValidator, () => new SchemaValidator());\n  if (!root.isRegistered(MiddlewareResolver)) root.registerFunction(MiddlewareResolver, () => new MiddlewareResolver(options.middlewareDir));\n  if (!root.isRegistered(ControllerResolver)) root.registerFunction(ControllerResolver, () => new ControllerResolver(options.controllersDir, { mode: options.mode }));\n  if (!root.isRegistered(WoodRouter)) {\n    root.registerFunction(WoodRouter, (validator: SchemaValidator, middlewareResolver: MiddlewareResolver, controllerResolver: ControllerResolver) => {\n      const router = new WoodRouter({ container: root, ...options, validator, middlewareResolver, controllerResolver });\n      options.registerRuntime(router);\n      router.validateControllers();\n      router.precompileSchemas();\n      return router;\n    }, { loadAs: LoadAs.Scoped, param: [SchemaValidator, MiddlewareResolver, ControllerResolver] });\n  }\n}\n\nexport { WoodRouter, SchemaValidator, MiddlewareResolver, ControllerResolver };\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAAwC;AACxC,yBAA2B;AAC3B,8BAAgC;AAChC,iCAAmC;AACnC,iCAAmC;AAc5B,SAAS,mBAAmB,MAAkB,SAAyC;AAC5F,MAAI,OAAO,KAAK,iBAAiB,cAAc,OAAO,KAAK,qBAAqB,YAAY;AAC1F,UAAM,IAAI,MAAM,mEAAmE;AAAA,EACrF;AACA,MAAI,CAAC,KAAK,aAAa,uCAAe,EAAG,MAAK,iBAAiB,yCAAiB,MAAM,IAAI,wCAAgB,CAAC;AAC3G,MAAI,CAAC,KAAK,aAAa,6CAAkB,EAAG,MAAK,iBAAiB,+CAAoB,MAAM,IAAI,8CAAmB,QAAQ,aAAa,CAAC;AACzI,MAAI,CAAC,KAAK,aAAa,6CAAkB,EAAG,MAAK,iBAAiB,+CAAoB,MAAM,IAAI,8CAAmB,QAAQ,gBAAgB,EAAE,MAAM,QAAQ,KAAK,CAAC,CAAC;AAClK,MAAI,CAAC,KAAK,aAAa,6BAAU,GAAG;AAClC,SAAK,iBAAiB,+BAAY,CAAC,WAA4B,oBAAwC,uBAA2C;AAChJ,YAAM,SAAS,IAAI,8BAAW,EAAE,WAAW,MAAM,GAAG,SAAS,WAAW,oBAAoB,mBAAmB,CAAC;AAChH,cAAQ,gBAAgB,MAAM;AAC9B,aAAO,oBAAoB;AAC3B,aAAO,kBAAkB;AACzB,aAAO;AAAA,IACT,GAAG,EAAE,QAAQ,kBAAO,QAAQ,OAAO,CAAC,yCAAiB,+CAAoB,6CAAkB,EAAE,CAAC;AAAA,EAChG;AACF;","names":[]}

package/dist/runtime/runtime_module.d.cts

@@ -0,0 +1,22 @@
+import { IContainer } from '@noego/ioc';
+import { WoodRouter } from '../router/wood_router.cjs';
+export { SchemaValidator } from '../validation/schema_validator.cjs';
+export { MiddlewareResolver } from '../middleware/middleware_resolver.cjs';
+export { ControllerResolver } from '../controller/controller_resolver.cjs';
+import '../types/operations.cjs';
+import '../types/context.cjs';
+
+interface WoodRuntimeModuleOptions {
+    controllersDir: string;
+    middlewareDir: string;
+    mode?: 'bundled' | 'dev';
+    registerRuntime(router: WoodRouter): void;
+}
+/**
+ * Registration-only production module, also installed by testWood before
+ * scenario overlays. Resolving WoodRouter starts the selected real pipeline.
+ * Existing registrations remain authoritative; token identities are exact.
+ */
+declare function installWoodRuntime(root: IContainer, options: WoodRuntimeModuleOptions): void;
+
+export { WoodRouter, type WoodRuntimeModuleOptions, installWoodRuntime };

package/dist/runtime/runtime_module.d.ts

@@ -0,0 +1,22 @@
+import { IContainer } from '@noego/ioc';
+import { WoodRouter } from '../router/wood_router.js';
+export { SchemaValidator } from '../validation/schema_validator.js';
+export { MiddlewareResolver } from '../middleware/middleware_resolver.js';
+export { ControllerResolver } from '../controller/controller_resolver.js';
+import '../types/operations.js';
+import '../types/context.js';
+
+interface WoodRuntimeModuleOptions {
+    controllersDir: string;
+    middlewareDir: string;
+    mode?: 'bundled' | 'dev';
+    registerRuntime(router: WoodRouter): void;
+}
+/**
+ * Registration-only production module, also installed by testWood before
+ * scenario overlays. Resolving WoodRouter starts the selected real pipeline.
+ * Existing registrations remain authoritative; token identities are exact.
+ */
+declare function installWoodRuntime(root: IContainer, options: WoodRuntimeModuleOptions): void;
+
+export { WoodRouter, type WoodRuntimeModuleOptions, installWoodRuntime };

package/dist/runtime/runtime_module.js

@@ -0,0 +1,30 @@
+import { LoadAs } from "@noego/ioc";
+import { WoodRouter } from "../router/wood_router.js";
+import { SchemaValidator } from "../validation/schema_validator.js";
+import { MiddlewareResolver } from "../middleware/middleware_resolver.js";
+import { ControllerResolver } from "../controller/controller_resolver.js";
+function installWoodRuntime(root, options) {
+  if (typeof root.isRegistered !== "function" || typeof root.registerFunction !== "function") {
+    throw new Error("Wood runtime requires an explicit IoC root; use createWoodRoot().");
+  }
+  if (!root.isRegistered(SchemaValidator)) root.registerFunction(SchemaValidator, () => new SchemaValidator());
+  if (!root.isRegistered(MiddlewareResolver)) root.registerFunction(MiddlewareResolver, () => new MiddlewareResolver(options.middlewareDir));
+  if (!root.isRegistered(ControllerResolver)) root.registerFunction(ControllerResolver, () => new ControllerResolver(options.controllersDir, { mode: options.mode }));
+  if (!root.isRegistered(WoodRouter)) {
+    root.registerFunction(WoodRouter, (validator, middlewareResolver, controllerResolver) => {
+      const router = new WoodRouter({ container: root, ...options, validator, middlewareResolver, controllerResolver });
+      options.registerRuntime(router);
+      router.validateControllers();
+      router.precompileSchemas();
+      return router;
+    }, { loadAs: LoadAs.Scoped, param: [SchemaValidator, MiddlewareResolver, ControllerResolver] });
+  }
+}
+export {
+  ControllerResolver,
+  MiddlewareResolver,
+  SchemaValidator,
+  WoodRouter,
+  installWoodRuntime
+};
+//# sourceMappingURL=runtime_module.js.map

package/dist/runtime/runtime_module.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/runtime_module.ts"],"sourcesContent":["import { LoadAs, type IContainer } from '@noego/ioc';\nimport { WoodRouter } from '../router/wood_router.js';\nimport { SchemaValidator } from '../validation/schema_validator.js';\nimport { MiddlewareResolver } from '../middleware/middleware_resolver.js';\nimport { ControllerResolver } from '../controller/controller_resolver.js';\n\nexport interface WoodRuntimeModuleOptions {\n  controllersDir: string;\n  middlewareDir: string;\n  mode?: 'bundled' | 'dev';\n  registerRuntime(router: WoodRouter): void;\n}\n\n/**\n * Registration-only production module, also installed by testWood before\n * scenario overlays. Resolving WoodRouter starts the selected real pipeline.\n * Existing registrations remain authoritative; token identities are exact.\n */\nexport function installWoodRuntime(root: IContainer, options: WoodRuntimeModuleOptions): void {\n  if (typeof root.isRegistered !== 'function' || typeof root.registerFunction !== 'function') {\n    throw new Error('Wood runtime requires an explicit IoC root; use createWoodRoot().');\n  }\n  if (!root.isRegistered(SchemaValidator)) root.registerFunction(SchemaValidator, () => new SchemaValidator());\n  if (!root.isRegistered(MiddlewareResolver)) root.registerFunction(MiddlewareResolver, () => new MiddlewareResolver(options.middlewareDir));\n  if (!root.isRegistered(ControllerResolver)) root.registerFunction(ControllerResolver, () => new ControllerResolver(options.controllersDir, { mode: options.mode }));\n  if (!root.isRegistered(WoodRouter)) {\n    root.registerFunction(WoodRouter, (validator: SchemaValidator, middlewareResolver: MiddlewareResolver, controllerResolver: ControllerResolver) => {\n      const router = new WoodRouter({ container: root, ...options, validator, middlewareResolver, controllerResolver });\n      options.registerRuntime(router);\n      router.validateControllers();\n      router.precompileSchemas();\n      return router;\n    }, { loadAs: LoadAs.Scoped, param: [SchemaValidator, MiddlewareResolver, ControllerResolver] });\n  }\n}\n\nexport { WoodRouter, SchemaValidator, MiddlewareResolver, ControllerResolver };\n"],"mappings":"AAAA,SAAS,cAA+B;AACxC,SAAS,kBAAkB;AAC3B,SAAS,uBAAuB;AAChC,SAAS,0BAA0B;AACnC,SAAS,0BAA0B;AAc5B,SAAS,mBAAmB,MAAkB,SAAyC;AAC5F,MAAI,OAAO,KAAK,iBAAiB,cAAc,OAAO,KAAK,qBAAqB,YAAY;AAC1F,UAAM,IAAI,MAAM,mEAAmE;AAAA,EACrF;AACA,MAAI,CAAC,KAAK,aAAa,eAAe,EAAG,MAAK,iBAAiB,iBAAiB,MAAM,IAAI,gBAAgB,CAAC;AAC3G,MAAI,CAAC,KAAK,aAAa,kBAAkB,EAAG,MAAK,iBAAiB,oBAAoB,MAAM,IAAI,mBAAmB,QAAQ,aAAa,CAAC;AACzI,MAAI,CAAC,KAAK,aAAa,kBAAkB,EAAG,MAAK,iBAAiB,oBAAoB,MAAM,IAAI,mBAAmB,QAAQ,gBAAgB,EAAE,MAAM,QAAQ,KAAK,CAAC,CAAC;AAClK,MAAI,CAAC,KAAK,aAAa,UAAU,GAAG;AAClC,SAAK,iBAAiB,YAAY,CAAC,WAA4B,oBAAwC,uBAA2C;AAChJ,YAAM,SAAS,IAAI,WAAW,EAAE,WAAW,MAAM,GAAG,SAAS,WAAW,oBAAoB,mBAAmB,CAAC;AAChH,cAAQ,gBAAgB,MAAM;AAC9B,aAAO,oBAAoB;AAC3B,aAAO,kBAAkB;AACzB,aAAO;AAAA,IACT,GAAG,EAAE,QAAQ,OAAO,QAAQ,OAAO,CAAC,iBAAiB,oBAAoB,kBAAkB,EAAE,CAAC;AAAA,EAChG;AACF;","names":[]}

package/dist/testing/create_controller_harness.d.cts

@@ -10,6 +10,9 @@ import '../tracing/trace_provider.cjs';
 import '../router/wood_router.cjs';
 import '../types/operations.cjs';
 import '../types/context.cjs';
+import '../validation/schema_validator.cjs';
+import '../middleware/middleware_resolver.cjs';
+import '../controller/controller_resolver.cjs';
 
 interface CreateControllerHarnessOptions<T> {
     controllerClass: new (...args: any[]) => T;

package/dist/testing/create_controller_harness.d.ts

@@ -10,6 +10,9 @@ import '../tracing/trace_provider.js';
 import '../router/wood_router.js';
 import '../types/operations.js';
 import '../types/context.js';
+import '../validation/schema_validator.js';
+import '../middleware/middleware_resolver.js';
+import '../controller/controller_resolver.js';
 
 interface CreateControllerHarnessOptions<T> {
     controllerClass: new (...args: any[]) => T;

package/dist/testing/create_router_bridge.d.cts

@@ -1,6 +1,9 @@
 import { WoodRouter } from '../router/wood_router.cjs';
 import '../types/operations.cjs';
 import '../types/context.cjs';
+import '../validation/schema_validator.cjs';
+import '../middleware/middleware_resolver.cjs';
+import '../controller/controller_resolver.cjs';
 
 /**
  * An in-process event emitter that replaces Electron's

package/dist/testing/create_router_bridge.d.ts

@@ -1,6 +1,9 @@
 import { WoodRouter } from '../router/wood_router.js';
 import '../types/operations.js';
 import '../types/context.js';
+import '../validation/schema_validator.js';
+import '../middleware/middleware_resolver.js';
+import '../controller/controller_resolver.js';
 
 /**
  * An in-process event emitter that replaces Electron's

package/dist/testing/create_test_router.d.cts

@@ -1,6 +1,9 @@
 import { WoodRouter } from '../router/wood_router.cjs';
 import '../types/operations.cjs';
 import '../types/context.cjs';
+import '../validation/schema_validator.cjs';
+import '../middleware/middleware_resolver.cjs';
+import '../controller/controller_resolver.cjs';
 
 interface TestRouterResult {
     router: WoodRouter;

package/dist/testing/create_test_router.d.ts

@@ -1,6 +1,9 @@
 import { WoodRouter } from '../router/wood_router.js';
 import '../types/operations.js';
 import '../types/context.js';
+import '../validation/schema_validator.js';
+import '../middleware/middleware_resolver.js';
+import '../controller/controller_resolver.js';
 
 interface TestRouterResult {
     router: WoodRouter;

package/dist/testing/index.cjs

@@ -28,6 +28,7 @@ __export(testing_exports, {
   PageCatalogError: () => import_frontend.PageCatalogError,
   RouterBridgeEvents: () => import_create_router_bridge.RouterBridgeEvents,
   TestWoodBuilder: () => import_test_wood_config.TestWoodBuilder,
+  TestWoodCleanupError: () => import_registration_only_root.TestWoodCleanupError,
   TestWoodError: () => import_test_wood.TestWoodError,
   TraceRecorder: () => import_trace_testing.TraceRecorder,
   TrackedTransport: () => import_frontend.TrackedTransport,
@@ -66,6 +67,7 @@ __export(testing_exports, {
 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_registration_only_root = require("./registration_only_root.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");
@@ -88,6 +90,7 @@ var import_trace_testing = require("../trace-testing/index.js");
   PageCatalogError,
   RouterBridgeEvents,
   TestWoodBuilder,
+  TestWoodCleanupError,
   TestWoodError,
   TraceRecorder,
   TrackedTransport,

package/dist/testing/index.cjs.map

@@ -1 +1 @@
-{"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":[]}
+{"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  WoodRootComposer,\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 { TestWoodCleanupError, type CleanupFailure } from './registration_only_root.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;AAAA;AACA,8BAA0C;AAW1C,uBAAoD;AACpD,oCAA0D;AAC1D,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,8 +1,9 @@
-export { TestWoodBuilder, TestWoodEnvironment, WoodComposeContext, WoodComposeMain, WoodComposeResult, testWood } from './test_wood_config.cjs';
+export { TestWoodBuilder, TestWoodEnvironment, WoodComposeContext, WoodComposeMain, WoodComposeResult, WoodRootComposer, 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 { CleanupFailure, TestWoodCleanupError } from './registration_only_root.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';
@@ -29,8 +30,12 @@ import '@noego/testing';
 import '../router/wood_router.cjs';
 import '../types/operations.cjs';
 import '../types/context.cjs';
+import '../validation/schema_validator.cjs';
+import '../middleware/middleware_resolver.cjs';
+import '../controller/controller_resolver.cjs';
 import '../types/config.cjs';
 import '../types/views.cjs';
+import './wood_dom_animation.cjs';
 import '../navigation/index.cjs';
 import '../navigation/automation_introspection.cjs';
 import 'playwright';

package/dist/testing/index.d.ts

@@ -1,8 +1,9 @@
-export { TestWoodBuilder, TestWoodEnvironment, WoodComposeContext, WoodComposeMain, WoodComposeResult, testWood } from './test_wood_config.js';
+export { TestWoodBuilder, TestWoodEnvironment, WoodComposeContext, WoodComposeMain, WoodComposeResult, WoodRootComposer, 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 { CleanupFailure, TestWoodCleanupError } from './registration_only_root.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';
@@ -29,8 +30,12 @@ import '@noego/testing';
 import '../router/wood_router.js';
 import '../types/operations.js';
 import '../types/context.js';
+import '../validation/schema_validator.js';
+import '../middleware/middleware_resolver.js';
+import '../controller/controller_resolver.js';
 import '../types/config.js';
 import '../types/views.js';
+import './wood_dom_animation.js';
 import '../navigation/index.js';
 import '../navigation/automation_introspection.js';
 import 'playwright';