@noego/wood 0.2.0 → 0.2.1

package/dist/client/index.cjs

@@ -45,7 +45,7 @@ module.exports = __toCommonJS(client_exports);
 var import_global_polyfill = require("./global_polyfill.cjs");
 var import_reflect_metadata = require("reflect-metadata");
 var import_ioc = require("@noego/ioc");
-var import_navigation = require("../navigation");
+var import_navigation = require("../navigation/index.js");
 var import_ipc = require("../ipc/index.js");
 var import_tracing = require("../tracing/index.js");
 var import_tracing2 = require("../tracing/index.js");

package/dist/client/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/client/index.ts"],"sourcesContent":["import './global_polyfill.cjs';\nimport 'reflect-metadata';\nimport { Container } from '@noego/ioc';\nimport {\n  Navigation,\n  getNavigation,\n  clearNavigationForTests as clearNavigationSingletonForTests,\n} from '../navigation';\nimport { Ipc, getIpc } from '../ipc/index.js';\nimport {\n  TraceProviderConfiguration,\n  clearTraceHubForTests,\n  emitRendererTrace,\n  setRendererTraceTransport,\n} from '../tracing/index.js';\nexport type {\n  ControllerEvents,\n  ControllerInput,\n  ControllerLifecycle,\n  ControllerState,\n  PageController,\n} from './controller_contract';\n\nconst CLIENT_CONTAINER_SYMBOL = Symbol.for('@noego/wood.client.container');\nconst CLIENT_APP_SYMBOL = Symbol.for('@noego/wood.client.app');\nconst CLIENT_WINDOW_CONTROLS_SYMBOL = Symbol.for('@noego/wood.client.window-controls');\nconst CLIENT_LOGGER_REGISTRY_SYMBOL = Symbol.for('@noego/wood.client.logger-registry');\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\nexport const WOOD_INTERNAL_BRIDGE_KEY = INTERNAL_BRIDGE_GLOBAL_KEY;\n\nexport interface WoodRpcManifestEntry {\n  channel: string;\n  controller: string;\n  action: string;\n  path: string[];\n  hasInput: boolean;\n}\n\ntype WoodBridgeRpcFunction = (data?: unknown) => Promise<unknown>;\ntype WoodBridgeLike = Record<string, unknown> & {\n  __rpcManifest?: WoodRpcManifestEntry[];\n  __window?: {\n    current?: () => Promise<unknown>;\n    open?: (windowId: string, options?: Record<string, unknown>) => Promise<unknown>;\n    close?: (windowId?: string) => Promise<unknown>;\n    focus?: (windowId: string) => Promise<unknown>;\n    minimize?: (windowId?: string) => Promise<unknown>;\n    maximize?: (windowId?: string) => Promise<unknown>;\n  };\n  __log?: (\n    level: string,\n    logger: string,\n    message: string,\n    context?: unknown,\n  ) => void;\n  __woodConfig?: () => Promise<unknown>;\n  __trace?: (event: unknown) => void;\n};\n\ntype GlobalWithClientContainer = typeof globalThis & {\n  [CLIENT_CONTAINER_SYMBOL]?: any;\n};\n\ntype GlobalWithClientApp = typeof globalThis & {\n  [CLIENT_APP_SYMBOL]?: App;\n};\n\ntype GlobalWithWindowControls = typeof globalThis & {\n  [CLIENT_WINDOW_CONTROLS_SYMBOL]?: WindowControls;\n};\n\ntype GlobalWithLoggerRegistry = typeof globalThis & {\n  [CLIENT_LOGGER_REGISTRY_SYMBOL]?: Map<string, RendererLogger>;\n};\n\ninterface WoodContainerRegistration {\n  registerFunction?(\n    token: any,\n    resolver: (...args: any[]) => unknown,\n    options?: Record<string, unknown>,\n  ): void;\n}\n\nexport class App {\n  [controllerName: string]: unknown;\n}\n\nfunction resolveWoodBridge(): WoodBridgeLike {\n  const globalObj = globalThis as typeof globalThis & {\n    [INTERNAL_BRIDGE_GLOBAL_KEY]?: unknown;\n    wood?: unknown;\n    window?: {\n      [INTERNAL_BRIDGE_GLOBAL_KEY]?: unknown;\n      wood?: unknown;\n    };\n  };\n\n  const bridge = globalObj[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.window?.[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    throw new Error(\n      `Wood bridge is not available on globalThis.${INTERNAL_BRIDGE_GLOBAL_KEY}.`,\n    );\n  }\n\n  return bridge as WoodBridgeLike;\n}\n\nfunction resolveRpcManifest(bridge: WoodBridgeLike): WoodRpcManifestEntry[] {\n  const manifest = bridge.__rpcManifest;\n  if (!Array.isArray(manifest)) {\n    throw new Error(\n      'Wood bridge is missing \"__rpcManifest\". Regenerate preload with the latest @noego/wood.',\n    );\n  }\n\n  return manifest;\n}\n\nfunction resolveBridgeFunction(\n  bridge: WoodBridgeLike,\n  pathSegments: string[],\n  operationKey: string,\n): WoodBridgeRpcFunction {\n  let current: unknown = bridge;\n\n  for (const segment of pathSegments) {\n    if (!current || typeof current !== 'object') {\n      throw new Error(\n        `Wood bridge operation \"${operationKey}\" is missing path \"${pathSegments.join('.')}\".`,\n      );\n    }\n    current = (current as Record<string, unknown>)[segment];\n  }\n\n  if (typeof current !== 'function') {\n    throw new Error(\n      `Wood bridge path \"${pathSegments.join('.')}\" for \"${operationKey}\" is not callable.`,\n    );\n  }\n\n  return current as WoodBridgeRpcFunction;\n}\n\nfunction assertSerializable(value: unknown, operationKey: string): void {\n  if (typeof structuredClone !== 'function') {\n    return;\n  }\n\n  try {\n    structuredClone(value);\n  } catch (error) {\n    const reason = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `App RPC \"${operationKey}\" payload is not serializable: ${reason}`,\n    );\n  }\n}\n\nfunction extractTraceConversationId(value: unknown): number | string | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.conversationId === 'number' || typeof record.conversationId === 'string') {\n    return record.conversationId;\n  }\n  if (typeof record.threadId === 'number' || typeof record.threadId === 'string') {\n    return record.threadId;\n  }\n\n  return undefined;\n}\n\nfunction validateManifestEntry(entry: WoodRpcManifestEntry, index: number): void {\n  if (!entry.channel || !entry.controller || !entry.action) {\n    throw new Error(`Invalid Wood RPC manifest entry at index ${index}.`);\n  }\n  if (!Array.isArray(entry.path) || entry.path.length === 0) {\n    throw new Error(\n      `Invalid Wood RPC manifest path for \"${entry.controller}.${entry.action}\".`,\n    );\n  }\n}\n\nfunction createAppInstance(): App {\n  const bridge = resolveWoodBridge();\n  const manifest = resolveRpcManifest(bridge);\n  const app: Record<string, Record<string, (...args: unknown[]) => Promise<unknown>>> = {};\n\n  manifest.forEach((entry, index) => {\n    validateManifestEntry(entry, index);\n\n    const operationKey = `${entry.controller}.${entry.action}`;\n    const invoke = resolveBridgeFunction(bridge, entry.path, operationKey);\n\n    if (!app[entry.controller]) {\n      app[entry.controller] = {};\n    }\n\n    if (app[entry.controller][entry.action]) {\n      throw new Error(\n        `Duplicate RPC action \"${operationKey}\" in Wood manifest. Actions must be unique per controller.`,\n      );\n    }\n\n    app[entry.controller][entry.action] = (...args: unknown[]): Promise<unknown> => {\n      if (entry.hasInput) {\n        if (args.length !== 1) {\n          throw new Error(\n            `App RPC \"${operationKey}\" expects exactly one payload argument.`,\n          );\n        }\n        assertSerializable(args[0], operationKey);\n        const conversationId = extractTraceConversationId(args[0]);\n        emitRendererTrace('debug', {\n          source: 'wood.client.app',\n          type: 'rpc.request',\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            operationKey,\n            channel: entry.channel,\n            hasInput: entry.hasInput,\n          },\n        });\n        return invoke(args[0])\n          .then((result) => {\n            emitRendererTrace('debug', {\n              source: 'wood.client.app',\n              type: 'rpc.response',\n              ...(conversationId !== undefined ? { conversationId } : {}),\n              payload: {\n                operationKey,\n                channel: entry.channel,\n                outcome: 'ok',\n              },\n            });\n            return result;\n          })\n          .catch((error) => {\n            emitRendererTrace('error', {\n              source: 'wood.client.app',\n              type: 'rpc.response',\n              message: error instanceof Error ? error.message : String(error),\n              ...(conversationId !== undefined ? { conversationId } : {}),\n              payload: {\n                operationKey,\n                channel: entry.channel,\n                outcome: 'error',\n              },\n            });\n            throw error;\n          });\n      }\n\n      if (args.length !== 0) {\n        throw new Error(\n          `App RPC \"${operationKey}\" expects no arguments.`,\n        );\n      }\n\n      emitRendererTrace('debug', {\n        source: 'wood.client.app',\n        type: 'rpc.request',\n        payload: {\n          operationKey,\n          channel: entry.channel,\n          hasInput: entry.hasInput,\n        },\n      });\n      return invoke()\n        .then((result) => {\n          emitRendererTrace('debug', {\n            source: 'wood.client.app',\n            type: 'rpc.response',\n            payload: {\n              operationKey,\n              channel: entry.channel,\n              outcome: 'ok',\n            },\n          });\n          return result;\n        })\n        .catch((error) => {\n          emitRendererTrace('error', {\n            source: 'wood.client.app',\n            type: 'rpc.response',\n            message: error instanceof Error ? error.message : String(error),\n            payload: {\n              operationKey,\n              channel: entry.channel,\n              outcome: 'error',\n            },\n          });\n          throw error;\n        });\n    };\n  });\n\n  return app as unknown as App;\n}\n\nexport function getApp(): App {\n  const globalObj = globalThis as GlobalWithClientApp;\n  if (!globalObj[CLIENT_APP_SYMBOL]) {\n    globalObj[CLIENT_APP_SYMBOL] = createAppInstance();\n  }\n  return globalObj[CLIENT_APP_SYMBOL] as App;\n}\n\n/** Test-only helper to clear the client App singleton. */\nexport function clearClientAppForTests(): void {\n  const globalObj = globalThis as GlobalWithClientApp;\n  delete globalObj[CLIENT_APP_SYMBOL];\n}\n\nfunction resolveWindowControlsBridgeMethod<T>(\n  method: keyof NonNullable<WoodBridgeLike['__window']>,\n): T {\n  const bridge = resolveWoodBridge();\n  const fn = bridge.__window?.[method];\n  if (typeof fn !== 'function') {\n    throw new Error(`Wood bridge does not expose \"__window.${String(method)}\".`);\n  }\n  return fn as unknown as T;\n}\n\nexport class WindowControls {\n  async open(windowId: string, options?: Record<string, unknown>): Promise<void> {\n    const open = resolveWindowControlsBridgeMethod<\n      (id: string, opts?: Record<string, unknown>) => Promise<unknown>\n    >('open');\n    await open(windowId, options);\n  }\n\n  async close(windowId?: string): Promise<void> {\n    const close = resolveWindowControlsBridgeMethod<\n      (id?: string) => Promise<unknown>\n    >('close');\n    await close(windowId);\n  }\n\n  async focus(windowId: string): Promise<void> {\n    const focus = resolveWindowControlsBridgeMethod<\n      (id: string) => Promise<unknown>\n    >('focus');\n    await focus(windowId);\n  }\n\n  async minimize(windowId?: string): Promise<void> {\n    const minimize = resolveWindowControlsBridgeMethod<\n      (id?: string) => Promise<unknown>\n    >('minimize');\n    await minimize(windowId);\n  }\n\n  async maximize(windowId?: string): Promise<void> {\n    const maximize = resolveWindowControlsBridgeMethod<\n      (id?: string) => Promise<unknown>\n    >('maximize');\n    await maximize(windowId);\n  }\n}\n\nexport function getWindowControls(): WindowControls {\n  const globalObj = globalThis as GlobalWithWindowControls;\n  if (!globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL]) {\n    globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL] = new WindowControls();\n  }\n  return globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL] as WindowControls;\n}\n\n/** Test-only helper to clear the client WindowControls singleton. */\nexport function clearClientWindowControlsForTests(): void {\n  const globalObj = globalThis as GlobalWithWindowControls;\n  delete globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL];\n}\n\ntype RendererLogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nfunction stringifyLogMessage(message: unknown): string {\n  if (typeof message === 'string') return message;\n  if (message instanceof Error) return message.message;\n  return String(message);\n}\n\nfunction writeConsole(level: RendererLogLevel, logger: string, message: string, context?: unknown): void {\n  const prefix = `[${logger}] ${message}`;\n  switch (level) {\n    case 'debug':\n      console.debug(prefix, context);\n      return;\n    case 'warn':\n      console.warn(prefix, context);\n      return;\n    case 'error':\n      console.error(prefix, context);\n      return;\n    default:\n      console.info(prefix, context);\n  }\n}\n\nclass RendererLogger {\n  constructor(private readonly loggerName: string) {}\n\n  debug(message: unknown, context?: unknown): void {\n    this.log('debug', message, context);\n  }\n\n  info(message: unknown, context?: unknown): void {\n    this.log('info', message, context);\n  }\n\n  warn(message: unknown, context?: unknown): void {\n    this.log('warn', message, context);\n  }\n\n  error(message: unknown, context?: unknown): void {\n    this.log('error', message, context);\n  }\n\n  private log(level: RendererLogLevel, rawMessage: unknown, context?: unknown): void {\n    const message = stringifyLogMessage(rawMessage);\n\n    let bridge: WoodBridgeLike;\n    try {\n      bridge = resolveWoodBridge();\n    } catch {\n      writeConsole(level, this.loggerName, message, context);\n      return;\n    }\n\n    if (typeof bridge.__log !== 'function') {\n      writeConsole(level, this.loggerName, message, context);\n      return;\n    }\n\n    try {\n      bridge.__log(level, this.loggerName, message, context);\n    } catch {\n      writeConsole(level, this.loggerName, message, context);\n    }\n  }\n}\n\ntype RendererLoggerShape = {\n  debug(message: unknown, context?: unknown): void;\n  info(message: unknown, context?: unknown): void;\n  warn(message: unknown, context?: unknown): void;\n  error(message: unknown, context?: unknown): void;\n};\n\nexport function createLogger(name: string): RendererLoggerShape {\n  const loggerName = name.trim() || 'renderer';\n  const globalObj = globalThis as GlobalWithLoggerRegistry;\n  if (!globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL]) {\n    globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL] = new Map<string, RendererLogger>();\n  }\n\n  const existing = globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL]?.get(loggerName);\n  if (existing) return existing;\n\n  const logger = new RendererLogger(loggerName);\n  globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL]?.set(loggerName, logger);\n  return logger;\n}\n\n/** Test-only helper to clear client logger singletons. */\nexport function clearClientLoggersForTests(): void {\n  const globalObj = globalThis as GlobalWithLoggerRegistry;\n  delete globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL];\n}\n\nfunction registerClientBuiltins(container: WoodContainerRegistration): void {\n  if (typeof container.registerFunction !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = new TraceProviderConfiguration();\n  traceConfiguration.configureRuntime('renderer');\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\nfunction createClientContainerInstance(): any {\n  const container = new Container();\n  registerClientBuiltins(container as WoodContainerRegistration);\n  return container;\n}\n\n/**\n * Return a process-global client container instance.\n *\n * - First call creates the container and stores it on a symbol.\n * - Later calls return the same container instance.\n */\nexport function getContainer(): any {\n  const globalObj = globalThis as GlobalWithClientContainer;\n  if (!globalObj[CLIENT_CONTAINER_SYMBOL]) {\n    globalObj[CLIENT_CONTAINER_SYMBOL] = createClientContainerInstance();\n  }\n  return globalObj[CLIENT_CONTAINER_SYMBOL];\n}\n\n/** Test-only helper to clear the client container singleton. */\nexport function clearClientContainerForTests(): void {\n  const globalObj = globalThis as GlobalWithClientContainer;\n  delete globalObj[CLIENT_CONTAINER_SYMBOL];\n}\n\n/** Test-only helper to clear the client navigation singleton. */\nexport function clearClientNavigationForTests(): void {\n  clearNavigationSingletonForTests();\n}\n\n/** Clamp a menu position so it stays within viewport bounds. */\nexport function clampMenuPosition(\n  x: number,\n  y: number,\n  menuWidth: number,\n  menuHeight: number,\n): { x: number; y: number } {\n  const vw = typeof window !== 'undefined' ? window.innerWidth : Infinity;\n  const vh = typeof window !== 'undefined' ? window.innerHeight : Infinity;\n  return {\n    x: Math.min(x, Math.max(0, vw - menuWidth)),\n    y: Math.min(y, Math.max(0, vh - menuHeight)),\n  };\n}\n\nfunction resolveTarget(target: Element | null): Element {\n  if (!target) {\n    throw new Error('Missing renderer mount target');\n  }\n  return target;\n}\n\n/**\n * Start a Wood renderer app by mounting it to a target element.\n * Usage:\n *   import { app } from './generated/app.cjs';\n *   startWood(app, document.getElementById('app'));\n */\nexport async function startWood<T>(\n  mountRoot: (target: Element) => T,\n  target: Element | null,\n): Promise<T> {\n  // Ensure container singleton exists and registers built-in client tokens.\n  const container = getContainer();\n  // Ensure navigation singleton exists at first client boot.\n  getNavigation();\n\n  // Auto-detect MessagePort-based trace transport\n  try {\n    const traceGlobal = (globalThis as Record<string, unknown>).__NOEGO_TRACE__ as\n      | { send?: (data: unknown) => void }\n      | undefined;\n    if (traceGlobal && typeof traceGlobal.send === 'function') {\n      const sender = traceGlobal.send.bind(traceGlobal);\n      setRendererTraceTransport((payload: unknown) => sender(payload));\n    }\n  } catch {\n    // MessagePort trace transport not available; IPC fallback remains active.\n  }\n\n  // Fetch framework config from the main process and apply renderer trace\n  // controls before the first render.\n  try {\n    const bridge = resolveWoodBridge();\n    if (typeof bridge.__woodConfig === 'function') {\n      const config = await bridge.__woodConfig() as {\n        rendererTraceEnabled?: boolean;\n        rendererTraceMinLevel?: string;\n      } | null;\n      const traceConfiguration = container.instance\n        ? await container.instance(TraceProviderConfiguration)\n        : null;\n      if (typeof config?.rendererTraceEnabled === 'boolean') {\n        traceConfiguration?.configureEnabled(config.rendererTraceEnabled);\n      }\n      const level = config?.rendererTraceMinLevel;\n      if (level === 'debug' || level === 'info' || level === 'warn' || level === 'error') {\n        traceConfiguration?.configureMinLevel(level);\n      }\n    }\n  } catch {\n    // Config fetch is best-effort; fall back to defaults.\n  }\n\n  return mountRoot(resolveTarget(target));\n}\n\n/**\n * Backward-compatible helper that returns a target-aware boot function.\n * Usage:\n *   const boot = createSvelteBoot(app);\n *   const mounted = boot(document.getElementById('app'));\n */\nexport function createSvelteBoot<T>(\n  mountRoot: (target: Element) => T,\n) {\n  return (target: Element | null): T => mountRoot(resolveTarget(target));\n}\n\nexport { getNavigation };\nexport { Ipc, getIpc };\nexport { clearTraceHubForTests };\nexport { setRendererTraceTransport };\nexport { TraceProvider, TraceProviderConfiguration } from '../tracing/index.js';\nexport type {\n  FrameworkTracer,\n  TraceCaptureOptions,\n  TraceEvent,\n  TraceInput,\n  TraceLevel,\n  TraceProcess,\n  TraceProviderMode,\n  TraceRuntime,\n  TraceWaitOptions,\n} from '../tracing/index.js';\n"],"mappings":"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","names":["import_tracing","clearNavigationSingletonForTests"]}
+{"version":3,"sources":["../../src/client/index.ts"],"sourcesContent":["import './global_polyfill.cjs';\nimport 'reflect-metadata';\nimport { Container } from '@noego/ioc';\nimport {\n  Navigation,\n  getNavigation,\n  clearNavigationForTests as clearNavigationSingletonForTests,\n} from '../navigation/index.js';\nimport { Ipc, getIpc } from '../ipc/index.js';\nimport {\n  TraceProviderConfiguration,\n  clearTraceHubForTests,\n  emitRendererTrace,\n  setRendererTraceTransport,\n} from '../tracing/index.js';\nexport type {\n  ControllerEvents,\n  ControllerInput,\n  ControllerLifecycle,\n  ControllerState,\n  PageController,\n} from './controller_contract.js';\n\nconst CLIENT_CONTAINER_SYMBOL = Symbol.for('@noego/wood.client.container');\nconst CLIENT_APP_SYMBOL = Symbol.for('@noego/wood.client.app');\nconst CLIENT_WINDOW_CONTROLS_SYMBOL = Symbol.for('@noego/wood.client.window-controls');\nconst CLIENT_LOGGER_REGISTRY_SYMBOL = Symbol.for('@noego/wood.client.logger-registry');\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\nexport const WOOD_INTERNAL_BRIDGE_KEY = INTERNAL_BRIDGE_GLOBAL_KEY;\n\nexport interface WoodRpcManifestEntry {\n  channel: string;\n  controller: string;\n  action: string;\n  path: string[];\n  hasInput: boolean;\n}\n\ntype WoodBridgeRpcFunction = (data?: unknown) => Promise<unknown>;\ntype WoodBridgeLike = Record<string, unknown> & {\n  __rpcManifest?: WoodRpcManifestEntry[];\n  __window?: {\n    current?: () => Promise<unknown>;\n    open?: (windowId: string, options?: Record<string, unknown>) => Promise<unknown>;\n    close?: (windowId?: string) => Promise<unknown>;\n    focus?: (windowId: string) => Promise<unknown>;\n    minimize?: (windowId?: string) => Promise<unknown>;\n    maximize?: (windowId?: string) => Promise<unknown>;\n  };\n  __log?: (\n    level: string,\n    logger: string,\n    message: string,\n    context?: unknown,\n  ) => void;\n  __woodConfig?: () => Promise<unknown>;\n  __trace?: (event: unknown) => void;\n};\n\ntype GlobalWithClientContainer = typeof globalThis & {\n  [CLIENT_CONTAINER_SYMBOL]?: any;\n};\n\ntype GlobalWithClientApp = typeof globalThis & {\n  [CLIENT_APP_SYMBOL]?: App;\n};\n\ntype GlobalWithWindowControls = typeof globalThis & {\n  [CLIENT_WINDOW_CONTROLS_SYMBOL]?: WindowControls;\n};\n\ntype GlobalWithLoggerRegistry = typeof globalThis & {\n  [CLIENT_LOGGER_REGISTRY_SYMBOL]?: Map<string, RendererLogger>;\n};\n\ninterface WoodContainerRegistration {\n  registerFunction?(\n    token: any,\n    resolver: (...args: any[]) => unknown,\n    options?: Record<string, unknown>,\n  ): void;\n}\n\nexport class App {\n  [controllerName: string]: unknown;\n}\n\nfunction resolveWoodBridge(): WoodBridgeLike {\n  const globalObj = globalThis as typeof globalThis & {\n    [INTERNAL_BRIDGE_GLOBAL_KEY]?: unknown;\n    wood?: unknown;\n    window?: {\n      [INTERNAL_BRIDGE_GLOBAL_KEY]?: unknown;\n      wood?: unknown;\n    };\n  };\n\n  const bridge = globalObj[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.window?.[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    throw new Error(\n      `Wood bridge is not available on globalThis.${INTERNAL_BRIDGE_GLOBAL_KEY}.`,\n    );\n  }\n\n  return bridge as WoodBridgeLike;\n}\n\nfunction resolveRpcManifest(bridge: WoodBridgeLike): WoodRpcManifestEntry[] {\n  const manifest = bridge.__rpcManifest;\n  if (!Array.isArray(manifest)) {\n    throw new Error(\n      'Wood bridge is missing \"__rpcManifest\". Regenerate preload with the latest @noego/wood.',\n    );\n  }\n\n  return manifest;\n}\n\nfunction resolveBridgeFunction(\n  bridge: WoodBridgeLike,\n  pathSegments: string[],\n  operationKey: string,\n): WoodBridgeRpcFunction {\n  let current: unknown = bridge;\n\n  for (const segment of pathSegments) {\n    if (!current || typeof current !== 'object') {\n      throw new Error(\n        `Wood bridge operation \"${operationKey}\" is missing path \"${pathSegments.join('.')}\".`,\n      );\n    }\n    current = (current as Record<string, unknown>)[segment];\n  }\n\n  if (typeof current !== 'function') {\n    throw new Error(\n      `Wood bridge path \"${pathSegments.join('.')}\" for \"${operationKey}\" is not callable.`,\n    );\n  }\n\n  return current as WoodBridgeRpcFunction;\n}\n\nfunction assertSerializable(value: unknown, operationKey: string): void {\n  if (typeof structuredClone !== 'function') {\n    return;\n  }\n\n  try {\n    structuredClone(value);\n  } catch (error) {\n    const reason = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `App RPC \"${operationKey}\" payload is not serializable: ${reason}`,\n    );\n  }\n}\n\nfunction extractTraceConversationId(value: unknown): number | string | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.conversationId === 'number' || typeof record.conversationId === 'string') {\n    return record.conversationId;\n  }\n  if (typeof record.threadId === 'number' || typeof record.threadId === 'string') {\n    return record.threadId;\n  }\n\n  return undefined;\n}\n\nfunction validateManifestEntry(entry: WoodRpcManifestEntry, index: number): void {\n  if (!entry.channel || !entry.controller || !entry.action) {\n    throw new Error(`Invalid Wood RPC manifest entry at index ${index}.`);\n  }\n  if (!Array.isArray(entry.path) || entry.path.length === 0) {\n    throw new Error(\n      `Invalid Wood RPC manifest path for \"${entry.controller}.${entry.action}\".`,\n    );\n  }\n}\n\nfunction createAppInstance(): App {\n  const bridge = resolveWoodBridge();\n  const manifest = resolveRpcManifest(bridge);\n  const app: Record<string, Record<string, (...args: unknown[]) => Promise<unknown>>> = {};\n\n  manifest.forEach((entry, index) => {\n    validateManifestEntry(entry, index);\n\n    const operationKey = `${entry.controller}.${entry.action}`;\n    const invoke = resolveBridgeFunction(bridge, entry.path, operationKey);\n\n    if (!app[entry.controller]) {\n      app[entry.controller] = {};\n    }\n\n    if (app[entry.controller][entry.action]) {\n      throw new Error(\n        `Duplicate RPC action \"${operationKey}\" in Wood manifest. Actions must be unique per controller.`,\n      );\n    }\n\n    app[entry.controller][entry.action] = (...args: unknown[]): Promise<unknown> => {\n      if (entry.hasInput) {\n        if (args.length !== 1) {\n          throw new Error(\n            `App RPC \"${operationKey}\" expects exactly one payload argument.`,\n          );\n        }\n        assertSerializable(args[0], operationKey);\n        const conversationId = extractTraceConversationId(args[0]);\n        emitRendererTrace('debug', {\n          source: 'wood.client.app',\n          type: 'rpc.request',\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            operationKey,\n            channel: entry.channel,\n            hasInput: entry.hasInput,\n          },\n        });\n        return invoke(args[0])\n          .then((result) => {\n            emitRendererTrace('debug', {\n              source: 'wood.client.app',\n              type: 'rpc.response',\n              ...(conversationId !== undefined ? { conversationId } : {}),\n              payload: {\n                operationKey,\n                channel: entry.channel,\n                outcome: 'ok',\n              },\n            });\n            return result;\n          })\n          .catch((error) => {\n            emitRendererTrace('error', {\n              source: 'wood.client.app',\n              type: 'rpc.response',\n              message: error instanceof Error ? error.message : String(error),\n              ...(conversationId !== undefined ? { conversationId } : {}),\n              payload: {\n                operationKey,\n                channel: entry.channel,\n                outcome: 'error',\n              },\n            });\n            throw error;\n          });\n      }\n\n      if (args.length !== 0) {\n        throw new Error(\n          `App RPC \"${operationKey}\" expects no arguments.`,\n        );\n      }\n\n      emitRendererTrace('debug', {\n        source: 'wood.client.app',\n        type: 'rpc.request',\n        payload: {\n          operationKey,\n          channel: entry.channel,\n          hasInput: entry.hasInput,\n        },\n      });\n      return invoke()\n        .then((result) => {\n          emitRendererTrace('debug', {\n            source: 'wood.client.app',\n            type: 'rpc.response',\n            payload: {\n              operationKey,\n              channel: entry.channel,\n              outcome: 'ok',\n            },\n          });\n          return result;\n        })\n        .catch((error) => {\n          emitRendererTrace('error', {\n            source: 'wood.client.app',\n            type: 'rpc.response',\n            message: error instanceof Error ? error.message : String(error),\n            payload: {\n              operationKey,\n              channel: entry.channel,\n              outcome: 'error',\n            },\n          });\n          throw error;\n        });\n    };\n  });\n\n  return app as unknown as App;\n}\n\nexport function getApp(): App {\n  const globalObj = globalThis as GlobalWithClientApp;\n  if (!globalObj[CLIENT_APP_SYMBOL]) {\n    globalObj[CLIENT_APP_SYMBOL] = createAppInstance();\n  }\n  return globalObj[CLIENT_APP_SYMBOL] as App;\n}\n\n/** Test-only helper to clear the client App singleton. */\nexport function clearClientAppForTests(): void {\n  const globalObj = globalThis as GlobalWithClientApp;\n  delete globalObj[CLIENT_APP_SYMBOL];\n}\n\nfunction resolveWindowControlsBridgeMethod<T>(\n  method: keyof NonNullable<WoodBridgeLike['__window']>,\n): T {\n  const bridge = resolveWoodBridge();\n  const fn = bridge.__window?.[method];\n  if (typeof fn !== 'function') {\n    throw new Error(`Wood bridge does not expose \"__window.${String(method)}\".`);\n  }\n  return fn as unknown as T;\n}\n\nexport class WindowControls {\n  async open(windowId: string, options?: Record<string, unknown>): Promise<void> {\n    const open = resolveWindowControlsBridgeMethod<\n      (id: string, opts?: Record<string, unknown>) => Promise<unknown>\n    >('open');\n    await open(windowId, options);\n  }\n\n  async close(windowId?: string): Promise<void> {\n    const close = resolveWindowControlsBridgeMethod<\n      (id?: string) => Promise<unknown>\n    >('close');\n    await close(windowId);\n  }\n\n  async focus(windowId: string): Promise<void> {\n    const focus = resolveWindowControlsBridgeMethod<\n      (id: string) => Promise<unknown>\n    >('focus');\n    await focus(windowId);\n  }\n\n  async minimize(windowId?: string): Promise<void> {\n    const minimize = resolveWindowControlsBridgeMethod<\n      (id?: string) => Promise<unknown>\n    >('minimize');\n    await minimize(windowId);\n  }\n\n  async maximize(windowId?: string): Promise<void> {\n    const maximize = resolveWindowControlsBridgeMethod<\n      (id?: string) => Promise<unknown>\n    >('maximize');\n    await maximize(windowId);\n  }\n}\n\nexport function getWindowControls(): WindowControls {\n  const globalObj = globalThis as GlobalWithWindowControls;\n  if (!globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL]) {\n    globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL] = new WindowControls();\n  }\n  return globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL] as WindowControls;\n}\n\n/** Test-only helper to clear the client WindowControls singleton. */\nexport function clearClientWindowControlsForTests(): void {\n  const globalObj = globalThis as GlobalWithWindowControls;\n  delete globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL];\n}\n\ntype RendererLogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nfunction stringifyLogMessage(message: unknown): string {\n  if (typeof message === 'string') return message;\n  if (message instanceof Error) return message.message;\n  return String(message);\n}\n\nfunction writeConsole(level: RendererLogLevel, logger: string, message: string, context?: unknown): void {\n  const prefix = `[${logger}] ${message}`;\n  switch (level) {\n    case 'debug':\n      console.debug(prefix, context);\n      return;\n    case 'warn':\n      console.warn(prefix, context);\n      return;\n    case 'error':\n      console.error(prefix, context);\n      return;\n    default:\n      console.info(prefix, context);\n  }\n}\n\nclass RendererLogger {\n  constructor(private readonly loggerName: string) {}\n\n  debug(message: unknown, context?: unknown): void {\n    this.log('debug', message, context);\n  }\n\n  info(message: unknown, context?: unknown): void {\n    this.log('info', message, context);\n  }\n\n  warn(message: unknown, context?: unknown): void {\n    this.log('warn', message, context);\n  }\n\n  error(message: unknown, context?: unknown): void {\n    this.log('error', message, context);\n  }\n\n  private log(level: RendererLogLevel, rawMessage: unknown, context?: unknown): void {\n    const message = stringifyLogMessage(rawMessage);\n\n    let bridge: WoodBridgeLike;\n    try {\n      bridge = resolveWoodBridge();\n    } catch {\n      writeConsole(level, this.loggerName, message, context);\n      return;\n    }\n\n    if (typeof bridge.__log !== 'function') {\n      writeConsole(level, this.loggerName, message, context);\n      return;\n    }\n\n    try {\n      bridge.__log(level, this.loggerName, message, context);\n    } catch {\n      writeConsole(level, this.loggerName, message, context);\n    }\n  }\n}\n\ntype RendererLoggerShape = {\n  debug(message: unknown, context?: unknown): void;\n  info(message: unknown, context?: unknown): void;\n  warn(message: unknown, context?: unknown): void;\n  error(message: unknown, context?: unknown): void;\n};\n\nexport function createLogger(name: string): RendererLoggerShape {\n  const loggerName = name.trim() || 'renderer';\n  const globalObj = globalThis as GlobalWithLoggerRegistry;\n  if (!globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL]) {\n    globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL] = new Map<string, RendererLogger>();\n  }\n\n  const existing = globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL]?.get(loggerName);\n  if (existing) return existing;\n\n  const logger = new RendererLogger(loggerName);\n  globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL]?.set(loggerName, logger);\n  return logger;\n}\n\n/** Test-only helper to clear client logger singletons. */\nexport function clearClientLoggersForTests(): void {\n  const globalObj = globalThis as GlobalWithLoggerRegistry;\n  delete globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL];\n}\n\nfunction registerClientBuiltins(container: WoodContainerRegistration): void {\n  if (typeof container.registerFunction !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = new TraceProviderConfiguration();\n  traceConfiguration.configureRuntime('renderer');\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\nfunction createClientContainerInstance(): any {\n  const container = new Container();\n  registerClientBuiltins(container as WoodContainerRegistration);\n  return container;\n}\n\n/**\n * Return a process-global client container instance.\n *\n * - First call creates the container and stores it on a symbol.\n * - Later calls return the same container instance.\n */\nexport function getContainer(): any {\n  const globalObj = globalThis as GlobalWithClientContainer;\n  if (!globalObj[CLIENT_CONTAINER_SYMBOL]) {\n    globalObj[CLIENT_CONTAINER_SYMBOL] = createClientContainerInstance();\n  }\n  return globalObj[CLIENT_CONTAINER_SYMBOL];\n}\n\n/** Test-only helper to clear the client container singleton. */\nexport function clearClientContainerForTests(): void {\n  const globalObj = globalThis as GlobalWithClientContainer;\n  delete globalObj[CLIENT_CONTAINER_SYMBOL];\n}\n\n/** Test-only helper to clear the client navigation singleton. */\nexport function clearClientNavigationForTests(): void {\n  clearNavigationSingletonForTests();\n}\n\n/** Clamp a menu position so it stays within viewport bounds. */\nexport function clampMenuPosition(\n  x: number,\n  y: number,\n  menuWidth: number,\n  menuHeight: number,\n): { x: number; y: number } {\n  const vw = typeof window !== 'undefined' ? window.innerWidth : Infinity;\n  const vh = typeof window !== 'undefined' ? window.innerHeight : Infinity;\n  return {\n    x: Math.min(x, Math.max(0, vw - menuWidth)),\n    y: Math.min(y, Math.max(0, vh - menuHeight)),\n  };\n}\n\nfunction resolveTarget(target: Element | null): Element {\n  if (!target) {\n    throw new Error('Missing renderer mount target');\n  }\n  return target;\n}\n\n/**\n * Start a Wood renderer app by mounting it to a target element.\n * Usage:\n *   import { app } from './generated/app.cjs';\n *   startWood(app, document.getElementById('app'));\n */\nexport async function startWood<T>(\n  mountRoot: (target: Element) => T,\n  target: Element | null,\n): Promise<T> {\n  // Ensure container singleton exists and registers built-in client tokens.\n  const container = getContainer();\n  // Ensure navigation singleton exists at first client boot.\n  getNavigation();\n\n  // Auto-detect MessagePort-based trace transport\n  try {\n    const traceGlobal = (globalThis as Record<string, unknown>).__NOEGO_TRACE__ as\n      | { send?: (data: unknown) => void }\n      | undefined;\n    if (traceGlobal && typeof traceGlobal.send === 'function') {\n      const sender = traceGlobal.send.bind(traceGlobal);\n      setRendererTraceTransport((payload: unknown) => sender(payload));\n    }\n  } catch {\n    // MessagePort trace transport not available; IPC fallback remains active.\n  }\n\n  // Fetch framework config from the main process and apply renderer trace\n  // controls before the first render.\n  try {\n    const bridge = resolveWoodBridge();\n    if (typeof bridge.__woodConfig === 'function') {\n      const config = await bridge.__woodConfig() as {\n        rendererTraceEnabled?: boolean;\n        rendererTraceMinLevel?: string;\n      } | null;\n      const traceConfiguration = container.instance\n        ? await container.instance(TraceProviderConfiguration)\n        : null;\n      if (typeof config?.rendererTraceEnabled === 'boolean') {\n        traceConfiguration?.configureEnabled(config.rendererTraceEnabled);\n      }\n      const level = config?.rendererTraceMinLevel;\n      if (level === 'debug' || level === 'info' || level === 'warn' || level === 'error') {\n        traceConfiguration?.configureMinLevel(level);\n      }\n    }\n  } catch {\n    // Config fetch is best-effort; fall back to defaults.\n  }\n\n  return mountRoot(resolveTarget(target));\n}\n\n/**\n * Backward-compatible helper that returns a target-aware boot function.\n * Usage:\n *   const boot = createSvelteBoot(app);\n *   const mounted = boot(document.getElementById('app'));\n */\nexport function createSvelteBoot<T>(\n  mountRoot: (target: Element) => T,\n) {\n  return (target: Element | null): T => mountRoot(resolveTarget(target));\n}\n\nexport { getNavigation };\nexport { Ipc, getIpc };\nexport { clearTraceHubForTests };\nexport { setRendererTraceTransport };\nexport { TraceProvider, TraceProviderConfiguration } from '../tracing/index.js';\nexport type {\n  FrameworkTracer,\n  TraceCaptureOptions,\n  TraceEvent,\n  TraceInput,\n  TraceLevel,\n  TraceProcess,\n  TraceProviderMode,\n  TraceRuntime,\n  TraceWaitOptions,\n} from '../tracing/index.js';\n"],"mappings":"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","names":["import_tracing","clearNavigationSingletonForTests"]}

package/dist/client/index.js

@@ -5,7 +5,7 @@ import {
   Navigation,
   getNavigation,
   clearNavigationForTests as clearNavigationSingletonForTests
-} from "../navigation";
+} from "../navigation/index.js";
 import { Ipc, getIpc } from "../ipc/index.js";
 import {
   TraceProviderConfiguration,

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/client/index.ts"],"sourcesContent":["import './global_polyfill.js';\nimport 'reflect-metadata';\nimport { Container } from '@noego/ioc';\nimport {\n  Navigation,\n  getNavigation,\n  clearNavigationForTests as clearNavigationSingletonForTests,\n} from '../navigation';\nimport { Ipc, getIpc } from '../ipc/index.js';\nimport {\n  TraceProviderConfiguration,\n  clearTraceHubForTests,\n  emitRendererTrace,\n  setRendererTraceTransport,\n} from '../tracing/index.js';\nexport type {\n  ControllerEvents,\n  ControllerInput,\n  ControllerLifecycle,\n  ControllerState,\n  PageController,\n} from './controller_contract';\n\nconst CLIENT_CONTAINER_SYMBOL = Symbol.for('@noego/wood.client.container');\nconst CLIENT_APP_SYMBOL = Symbol.for('@noego/wood.client.app');\nconst CLIENT_WINDOW_CONTROLS_SYMBOL = Symbol.for('@noego/wood.client.window-controls');\nconst CLIENT_LOGGER_REGISTRY_SYMBOL = Symbol.for('@noego/wood.client.logger-registry');\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\nexport const WOOD_INTERNAL_BRIDGE_KEY = INTERNAL_BRIDGE_GLOBAL_KEY;\n\nexport interface WoodRpcManifestEntry {\n  channel: string;\n  controller: string;\n  action: string;\n  path: string[];\n  hasInput: boolean;\n}\n\ntype WoodBridgeRpcFunction = (data?: unknown) => Promise<unknown>;\ntype WoodBridgeLike = Record<string, unknown> & {\n  __rpcManifest?: WoodRpcManifestEntry[];\n  __window?: {\n    current?: () => Promise<unknown>;\n    open?: (windowId: string, options?: Record<string, unknown>) => Promise<unknown>;\n    close?: (windowId?: string) => Promise<unknown>;\n    focus?: (windowId: string) => Promise<unknown>;\n    minimize?: (windowId?: string) => Promise<unknown>;\n    maximize?: (windowId?: string) => Promise<unknown>;\n  };\n  __log?: (\n    level: string,\n    logger: string,\n    message: string,\n    context?: unknown,\n  ) => void;\n  __woodConfig?: () => Promise<unknown>;\n  __trace?: (event: unknown) => void;\n};\n\ntype GlobalWithClientContainer = typeof globalThis & {\n  [CLIENT_CONTAINER_SYMBOL]?: any;\n};\n\ntype GlobalWithClientApp = typeof globalThis & {\n  [CLIENT_APP_SYMBOL]?: App;\n};\n\ntype GlobalWithWindowControls = typeof globalThis & {\n  [CLIENT_WINDOW_CONTROLS_SYMBOL]?: WindowControls;\n};\n\ntype GlobalWithLoggerRegistry = typeof globalThis & {\n  [CLIENT_LOGGER_REGISTRY_SYMBOL]?: Map<string, RendererLogger>;\n};\n\ninterface WoodContainerRegistration {\n  registerFunction?(\n    token: any,\n    resolver: (...args: any[]) => unknown,\n    options?: Record<string, unknown>,\n  ): void;\n}\n\nexport class App {\n  [controllerName: string]: unknown;\n}\n\nfunction resolveWoodBridge(): WoodBridgeLike {\n  const globalObj = globalThis as typeof globalThis & {\n    [INTERNAL_BRIDGE_GLOBAL_KEY]?: unknown;\n    wood?: unknown;\n    window?: {\n      [INTERNAL_BRIDGE_GLOBAL_KEY]?: unknown;\n      wood?: unknown;\n    };\n  };\n\n  const bridge = globalObj[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.window?.[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    throw new Error(\n      `Wood bridge is not available on globalThis.${INTERNAL_BRIDGE_GLOBAL_KEY}.`,\n    );\n  }\n\n  return bridge as WoodBridgeLike;\n}\n\nfunction resolveRpcManifest(bridge: WoodBridgeLike): WoodRpcManifestEntry[] {\n  const manifest = bridge.__rpcManifest;\n  if (!Array.isArray(manifest)) {\n    throw new Error(\n      'Wood bridge is missing \"__rpcManifest\". Regenerate preload with the latest @noego/wood.',\n    );\n  }\n\n  return manifest;\n}\n\nfunction resolveBridgeFunction(\n  bridge: WoodBridgeLike,\n  pathSegments: string[],\n  operationKey: string,\n): WoodBridgeRpcFunction {\n  let current: unknown = bridge;\n\n  for (const segment of pathSegments) {\n    if (!current || typeof current !== 'object') {\n      throw new Error(\n        `Wood bridge operation \"${operationKey}\" is missing path \"${pathSegments.join('.')}\".`,\n      );\n    }\n    current = (current as Record<string, unknown>)[segment];\n  }\n\n  if (typeof current !== 'function') {\n    throw new Error(\n      `Wood bridge path \"${pathSegments.join('.')}\" for \"${operationKey}\" is not callable.`,\n    );\n  }\n\n  return current as WoodBridgeRpcFunction;\n}\n\nfunction assertSerializable(value: unknown, operationKey: string): void {\n  if (typeof structuredClone !== 'function') {\n    return;\n  }\n\n  try {\n    structuredClone(value);\n  } catch (error) {\n    const reason = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `App RPC \"${operationKey}\" payload is not serializable: ${reason}`,\n    );\n  }\n}\n\nfunction extractTraceConversationId(value: unknown): number | string | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.conversationId === 'number' || typeof record.conversationId === 'string') {\n    return record.conversationId;\n  }\n  if (typeof record.threadId === 'number' || typeof record.threadId === 'string') {\n    return record.threadId;\n  }\n\n  return undefined;\n}\n\nfunction validateManifestEntry(entry: WoodRpcManifestEntry, index: number): void {\n  if (!entry.channel || !entry.controller || !entry.action) {\n    throw new Error(`Invalid Wood RPC manifest entry at index ${index}.`);\n  }\n  if (!Array.isArray(entry.path) || entry.path.length === 0) {\n    throw new Error(\n      `Invalid Wood RPC manifest path for \"${entry.controller}.${entry.action}\".`,\n    );\n  }\n}\n\nfunction createAppInstance(): App {\n  const bridge = resolveWoodBridge();\n  const manifest = resolveRpcManifest(bridge);\n  const app: Record<string, Record<string, (...args: unknown[]) => Promise<unknown>>> = {};\n\n  manifest.forEach((entry, index) => {\n    validateManifestEntry(entry, index);\n\n    const operationKey = `${entry.controller}.${entry.action}`;\n    const invoke = resolveBridgeFunction(bridge, entry.path, operationKey);\n\n    if (!app[entry.controller]) {\n      app[entry.controller] = {};\n    }\n\n    if (app[entry.controller][entry.action]) {\n      throw new Error(\n        `Duplicate RPC action \"${operationKey}\" in Wood manifest. Actions must be unique per controller.`,\n      );\n    }\n\n    app[entry.controller][entry.action] = (...args: unknown[]): Promise<unknown> => {\n      if (entry.hasInput) {\n        if (args.length !== 1) {\n          throw new Error(\n            `App RPC \"${operationKey}\" expects exactly one payload argument.`,\n          );\n        }\n        assertSerializable(args[0], operationKey);\n        const conversationId = extractTraceConversationId(args[0]);\n        emitRendererTrace('debug', {\n          source: 'wood.client.app',\n          type: 'rpc.request',\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            operationKey,\n            channel: entry.channel,\n            hasInput: entry.hasInput,\n          },\n        });\n        return invoke(args[0])\n          .then((result) => {\n            emitRendererTrace('debug', {\n              source: 'wood.client.app',\n              type: 'rpc.response',\n              ...(conversationId !== undefined ? { conversationId } : {}),\n              payload: {\n                operationKey,\n                channel: entry.channel,\n                outcome: 'ok',\n              },\n            });\n            return result;\n          })\n          .catch((error) => {\n            emitRendererTrace('error', {\n              source: 'wood.client.app',\n              type: 'rpc.response',\n              message: error instanceof Error ? error.message : String(error),\n              ...(conversationId !== undefined ? { conversationId } : {}),\n              payload: {\n                operationKey,\n                channel: entry.channel,\n                outcome: 'error',\n              },\n            });\n            throw error;\n          });\n      }\n\n      if (args.length !== 0) {\n        throw new Error(\n          `App RPC \"${operationKey}\" expects no arguments.`,\n        );\n      }\n\n      emitRendererTrace('debug', {\n        source: 'wood.client.app',\n        type: 'rpc.request',\n        payload: {\n          operationKey,\n          channel: entry.channel,\n          hasInput: entry.hasInput,\n        },\n      });\n      return invoke()\n        .then((result) => {\n          emitRendererTrace('debug', {\n            source: 'wood.client.app',\n            type: 'rpc.response',\n            payload: {\n              operationKey,\n              channel: entry.channel,\n              outcome: 'ok',\n            },\n          });\n          return result;\n        })\n        .catch((error) => {\n          emitRendererTrace('error', {\n            source: 'wood.client.app',\n            type: 'rpc.response',\n            message: error instanceof Error ? error.message : String(error),\n            payload: {\n              operationKey,\n              channel: entry.channel,\n              outcome: 'error',\n            },\n          });\n          throw error;\n        });\n    };\n  });\n\n  return app as unknown as App;\n}\n\nexport function getApp(): App {\n  const globalObj = globalThis as GlobalWithClientApp;\n  if (!globalObj[CLIENT_APP_SYMBOL]) {\n    globalObj[CLIENT_APP_SYMBOL] = createAppInstance();\n  }\n  return globalObj[CLIENT_APP_SYMBOL] as App;\n}\n\n/** Test-only helper to clear the client App singleton. */\nexport function clearClientAppForTests(): void {\n  const globalObj = globalThis as GlobalWithClientApp;\n  delete globalObj[CLIENT_APP_SYMBOL];\n}\n\nfunction resolveWindowControlsBridgeMethod<T>(\n  method: keyof NonNullable<WoodBridgeLike['__window']>,\n): T {\n  const bridge = resolveWoodBridge();\n  const fn = bridge.__window?.[method];\n  if (typeof fn !== 'function') {\n    throw new Error(`Wood bridge does not expose \"__window.${String(method)}\".`);\n  }\n  return fn as unknown as T;\n}\n\nexport class WindowControls {\n  async open(windowId: string, options?: Record<string, unknown>): Promise<void> {\n    const open = resolveWindowControlsBridgeMethod<\n      (id: string, opts?: Record<string, unknown>) => Promise<unknown>\n    >('open');\n    await open(windowId, options);\n  }\n\n  async close(windowId?: string): Promise<void> {\n    const close = resolveWindowControlsBridgeMethod<\n      (id?: string) => Promise<unknown>\n    >('close');\n    await close(windowId);\n  }\n\n  async focus(windowId: string): Promise<void> {\n    const focus = resolveWindowControlsBridgeMethod<\n      (id: string) => Promise<unknown>\n    >('focus');\n    await focus(windowId);\n  }\n\n  async minimize(windowId?: string): Promise<void> {\n    const minimize = resolveWindowControlsBridgeMethod<\n      (id?: string) => Promise<unknown>\n    >('minimize');\n    await minimize(windowId);\n  }\n\n  async maximize(windowId?: string): Promise<void> {\n    const maximize = resolveWindowControlsBridgeMethod<\n      (id?: string) => Promise<unknown>\n    >('maximize');\n    await maximize(windowId);\n  }\n}\n\nexport function getWindowControls(): WindowControls {\n  const globalObj = globalThis as GlobalWithWindowControls;\n  if (!globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL]) {\n    globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL] = new WindowControls();\n  }\n  return globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL] as WindowControls;\n}\n\n/** Test-only helper to clear the client WindowControls singleton. */\nexport function clearClientWindowControlsForTests(): void {\n  const globalObj = globalThis as GlobalWithWindowControls;\n  delete globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL];\n}\n\ntype RendererLogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nfunction stringifyLogMessage(message: unknown): string {\n  if (typeof message === 'string') return message;\n  if (message instanceof Error) return message.message;\n  return String(message);\n}\n\nfunction writeConsole(level: RendererLogLevel, logger: string, message: string, context?: unknown): void {\n  const prefix = `[${logger}] ${message}`;\n  switch (level) {\n    case 'debug':\n      console.debug(prefix, context);\n      return;\n    case 'warn':\n      console.warn(prefix, context);\n      return;\n    case 'error':\n      console.error(prefix, context);\n      return;\n    default:\n      console.info(prefix, context);\n  }\n}\n\nclass RendererLogger {\n  constructor(private readonly loggerName: string) {}\n\n  debug(message: unknown, context?: unknown): void {\n    this.log('debug', message, context);\n  }\n\n  info(message: unknown, context?: unknown): void {\n    this.log('info', message, context);\n  }\n\n  warn(message: unknown, context?: unknown): void {\n    this.log('warn', message, context);\n  }\n\n  error(message: unknown, context?: unknown): void {\n    this.log('error', message, context);\n  }\n\n  private log(level: RendererLogLevel, rawMessage: unknown, context?: unknown): void {\n    const message = stringifyLogMessage(rawMessage);\n\n    let bridge: WoodBridgeLike;\n    try {\n      bridge = resolveWoodBridge();\n    } catch {\n      writeConsole(level, this.loggerName, message, context);\n      return;\n    }\n\n    if (typeof bridge.__log !== 'function') {\n      writeConsole(level, this.loggerName, message, context);\n      return;\n    }\n\n    try {\n      bridge.__log(level, this.loggerName, message, context);\n    } catch {\n      writeConsole(level, this.loggerName, message, context);\n    }\n  }\n}\n\ntype RendererLoggerShape = {\n  debug(message: unknown, context?: unknown): void;\n  info(message: unknown, context?: unknown): void;\n  warn(message: unknown, context?: unknown): void;\n  error(message: unknown, context?: unknown): void;\n};\n\nexport function createLogger(name: string): RendererLoggerShape {\n  const loggerName = name.trim() || 'renderer';\n  const globalObj = globalThis as GlobalWithLoggerRegistry;\n  if (!globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL]) {\n    globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL] = new Map<string, RendererLogger>();\n  }\n\n  const existing = globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL]?.get(loggerName);\n  if (existing) return existing;\n\n  const logger = new RendererLogger(loggerName);\n  globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL]?.set(loggerName, logger);\n  return logger;\n}\n\n/** Test-only helper to clear client logger singletons. */\nexport function clearClientLoggersForTests(): void {\n  const globalObj = globalThis as GlobalWithLoggerRegistry;\n  delete globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL];\n}\n\nfunction registerClientBuiltins(container: WoodContainerRegistration): void {\n  if (typeof container.registerFunction !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = new TraceProviderConfiguration();\n  traceConfiguration.configureRuntime('renderer');\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\nfunction createClientContainerInstance(): any {\n  const container = new Container();\n  registerClientBuiltins(container as WoodContainerRegistration);\n  return container;\n}\n\n/**\n * Return a process-global client container instance.\n *\n * - First call creates the container and stores it on a symbol.\n * - Later calls return the same container instance.\n */\nexport function getContainer(): any {\n  const globalObj = globalThis as GlobalWithClientContainer;\n  if (!globalObj[CLIENT_CONTAINER_SYMBOL]) {\n    globalObj[CLIENT_CONTAINER_SYMBOL] = createClientContainerInstance();\n  }\n  return globalObj[CLIENT_CONTAINER_SYMBOL];\n}\n\n/** Test-only helper to clear the client container singleton. */\nexport function clearClientContainerForTests(): void {\n  const globalObj = globalThis as GlobalWithClientContainer;\n  delete globalObj[CLIENT_CONTAINER_SYMBOL];\n}\n\n/** Test-only helper to clear the client navigation singleton. */\nexport function clearClientNavigationForTests(): void {\n  clearNavigationSingletonForTests();\n}\n\n/** Clamp a menu position so it stays within viewport bounds. */\nexport function clampMenuPosition(\n  x: number,\n  y: number,\n  menuWidth: number,\n  menuHeight: number,\n): { x: number; y: number } {\n  const vw = typeof window !== 'undefined' ? window.innerWidth : Infinity;\n  const vh = typeof window !== 'undefined' ? window.innerHeight : Infinity;\n  return {\n    x: Math.min(x, Math.max(0, vw - menuWidth)),\n    y: Math.min(y, Math.max(0, vh - menuHeight)),\n  };\n}\n\nfunction resolveTarget(target: Element | null): Element {\n  if (!target) {\n    throw new Error('Missing renderer mount target');\n  }\n  return target;\n}\n\n/**\n * Start a Wood renderer app by mounting it to a target element.\n * Usage:\n *   import { app } from './generated/app.js';\n *   startWood(app, document.getElementById('app'));\n */\nexport async function startWood<T>(\n  mountRoot: (target: Element) => T,\n  target: Element | null,\n): Promise<T> {\n  // Ensure container singleton exists and registers built-in client tokens.\n  const container = getContainer();\n  // Ensure navigation singleton exists at first client boot.\n  getNavigation();\n\n  // Auto-detect MessagePort-based trace transport\n  try {\n    const traceGlobal = (globalThis as Record<string, unknown>).__NOEGO_TRACE__ as\n      | { send?: (data: unknown) => void }\n      | undefined;\n    if (traceGlobal && typeof traceGlobal.send === 'function') {\n      const sender = traceGlobal.send.bind(traceGlobal);\n      setRendererTraceTransport((payload: unknown) => sender(payload));\n    }\n  } catch {\n    // MessagePort trace transport not available; IPC fallback remains active.\n  }\n\n  // Fetch framework config from the main process and apply renderer trace\n  // controls before the first render.\n  try {\n    const bridge = resolveWoodBridge();\n    if (typeof bridge.__woodConfig === 'function') {\n      const config = await bridge.__woodConfig() as {\n        rendererTraceEnabled?: boolean;\n        rendererTraceMinLevel?: string;\n      } | null;\n      const traceConfiguration = container.instance\n        ? await container.instance(TraceProviderConfiguration)\n        : null;\n      if (typeof config?.rendererTraceEnabled === 'boolean') {\n        traceConfiguration?.configureEnabled(config.rendererTraceEnabled);\n      }\n      const level = config?.rendererTraceMinLevel;\n      if (level === 'debug' || level === 'info' || level === 'warn' || level === 'error') {\n        traceConfiguration?.configureMinLevel(level);\n      }\n    }\n  } catch {\n    // Config fetch is best-effort; fall back to defaults.\n  }\n\n  return mountRoot(resolveTarget(target));\n}\n\n/**\n * Backward-compatible helper that returns a target-aware boot function.\n * Usage:\n *   const boot = createSvelteBoot(app);\n *   const mounted = boot(document.getElementById('app'));\n */\nexport function createSvelteBoot<T>(\n  mountRoot: (target: Element) => T,\n) {\n  return (target: Element | null): T => mountRoot(resolveTarget(target));\n}\n\nexport { getNavigation };\nexport { Ipc, getIpc };\nexport { clearTraceHubForTests };\nexport { setRendererTraceTransport };\nexport { TraceProvider, TraceProviderConfiguration } from '../tracing/index.js';\nexport type {\n  FrameworkTracer,\n  TraceCaptureOptions,\n  TraceEvent,\n  TraceInput,\n  TraceLevel,\n  TraceProcess,\n  TraceProviderMode,\n  TraceRuntime,\n  TraceWaitOptions,\n} from '../tracing/index.js';\n"],"mappings":"AAAA,OAAO;AACP,OAAO;AACP,SAAS,iBAAiB;AAC1B;AAAA,EACE;AAAA,EACA;AAAA,EACA,2BAA2B;AAAA,OACtB;AACP,SAAS,KAAK,cAAc;AAC5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,MAAM,0BAA0B,uBAAO,IAAI,8BAA8B;AACzE,MAAM,oBAAoB,uBAAO,IAAI,wBAAwB;AAC7D,MAAM,gCAAgC,uBAAO,IAAI,oCAAoC;AACrF,MAAM,gCAAgC,uBAAO,IAAI,oCAAoC;AACrF,MAAM,6BAA6B;AAE5B,MAAM,2BAA2B;AAuDjC,MAAM,IAAI;AAEjB;AAEA,SAAS,oBAAoC;AAC3C,QAAM,YAAY;AASlB,QAAM,SAAS,UAAU,0BAA0B,KAC9C,UAAU,SAAS,0BAA0B,KAC7C,UAAU,QACV,UAAU,QAAQ;AACvB,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,UAAM,IAAI;AAAA,MACR,8CAA8C,0BAA0B;AAAA,IAC1E;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,mBAAmB,QAAgD;AAC1E,QAAM,WAAW,OAAO;AACxB,MAAI,CAAC,MAAM,QAAQ,QAAQ,GAAG;AAC5B,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,sBACP,QACA,cACA,cACuB;AACvB,MAAI,UAAmB;AAEvB,aAAW,WAAW,cAAc;AAClC,QAAI,CAAC,WAAW,OAAO,YAAY,UAAU;AAC3C,YAAM,IAAI;AAAA,QACR,0BAA0B,YAAY,sBAAsB,aAAa,KAAK,GAAG,CAAC;AAAA,MACpF;AAAA,IACF;AACA,cAAW,QAAoC,OAAO;AAAA,EACxD;AAEA,MAAI,OAAO,YAAY,YAAY;AACjC,UAAM,IAAI;AAAA,MACR,qBAAqB,aAAa,KAAK,GAAG,CAAC,UAAU,YAAY;AAAA,IACnE;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,mBAAmB,OAAgB,cAA4B;AACtE,MAAI,OAAO,oBAAoB,YAAY;AACzC;AAAA,EACF;AAEA,MAAI;AACF,oBAAgB,KAAK;AAAA,EACvB,SAAS,OAAO;AACd,UAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,UAAM,IAAI;AAAA,MACR,YAAY,YAAY,kCAAkC,MAAM;AAAA,IAClE;AAAA,EACF;AACF;AAEA,SAAS,2BAA2B,OAA6C;AAC/E,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG;AAC/D,WAAO;AAAA,EACT;AAEA,QAAM,SAAS;AACf,MAAI,OAAO,OAAO,mBAAmB,YAAY,OAAO,OAAO,mBAAmB,UAAU;AAC1F,WAAO,OAAO;AAAA,EAChB;AACA,MAAI,OAAO,OAAO,aAAa,YAAY,OAAO,OAAO,aAAa,UAAU;AAC9E,WAAO,OAAO;AAAA,EAChB;AAEA,SAAO;AACT;AAEA,SAAS,sBAAsB,OAA6B,OAAqB;AAC/E,MAAI,CAAC,MAAM,WAAW,CAAC,MAAM,cAAc,CAAC,MAAM,QAAQ;AACxD,UAAM,IAAI,MAAM,4CAA4C,KAAK,GAAG;AAAA,EACtE;AACA,MAAI,CAAC,MAAM,QAAQ,MAAM,IAAI,KAAK,MAAM,KAAK,WAAW,GAAG;AACzD,UAAM,IAAI;AAAA,MACR,uCAAuC,MAAM,UAAU,IAAI,MAAM,MAAM;AAAA,IACzE;AAAA,EACF;AACF;AAEA,SAAS,oBAAyB;AAChC,QAAM,SAAS,kBAAkB;AACjC,QAAM,WAAW,mBAAmB,MAAM;AAC1C,QAAM,MAAgF,CAAC;AAEvF,WAAS,QAAQ,CAAC,OAAO,UAAU;AACjC,0BAAsB,OAAO,KAAK;AAElC,UAAM,eAAe,GAAG,MAAM,UAAU,IAAI,MAAM,MAAM;AACxD,UAAM,SAAS,sBAAsB,QAAQ,MAAM,MAAM,YAAY;AAErE,QAAI,CAAC,IAAI,MAAM,UAAU,GAAG;AAC1B,UAAI,MAAM,UAAU,IAAI,CAAC;AAAA,IAC3B;AAEA,QAAI,IAAI,MAAM,UAAU,EAAE,MAAM,MAAM,GAAG;AACvC,YAAM,IAAI;AAAA,QACR,yBAAyB,YAAY;AAAA,MACvC;AAAA,IACF;AAEA,QAAI,MAAM,UAAU,EAAE,MAAM,MAAM,IAAI,IAAI,SAAsC;AAC9E,UAAI,MAAM,UAAU;AAClB,YAAI,KAAK,WAAW,GAAG;AACrB,gBAAM,IAAI;AAAA,YACR,YAAY,YAAY;AAAA,UAC1B;AAAA,QACF;AACA,2BAAmB,KAAK,CAAC,GAAG,YAAY;AACxC,cAAM,iBAAiB,2BAA2B,KAAK,CAAC,CAAC;AACzD,0BAAkB,SAAS;AAAA,UACzB,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,GAAI,mBAAmB,SAAY,EAAE,eAAe,IAAI,CAAC;AAAA,UACzD,SAAS;AAAA,YACP;AAAA,YACA,SAAS,MAAM;AAAA,YACf,UAAU,MAAM;AAAA,UAClB;AAAA,QACF,CAAC;AACD,eAAO,OAAO,KAAK,CAAC,CAAC,EAClB,KAAK,CAAC,WAAW;AAChB,4BAAkB,SAAS;AAAA,YACzB,QAAQ;AAAA,YACR,MAAM;AAAA,YACN,GAAI,mBAAmB,SAAY,EAAE,eAAe,IAAI,CAAC;AAAA,YACzD,SAAS;AAAA,cACP;AAAA,cACA,SAAS,MAAM;AAAA,cACf,SAAS;AAAA,YACX;AAAA,UACF,CAAC;AACD,iBAAO;AAAA,QACT,CAAC,EACA,MAAM,CAAC,UAAU;AAChB,4BAAkB,SAAS;AAAA,YACzB,QAAQ;AAAA,YACR,MAAM;AAAA,YACN,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,YAC9D,GAAI,mBAAmB,SAAY,EAAE,eAAe,IAAI,CAAC;AAAA,YACzD,SAAS;AAAA,cACP;AAAA,cACA,SAAS,MAAM;AAAA,cACf,SAAS;AAAA,YACX;AAAA,UACF,CAAC;AACD,gBAAM;AAAA,QACR,CAAC;AAAA,MACL;AAEA,UAAI,KAAK,WAAW,GAAG;AACrB,cAAM,IAAI;AAAA,UACR,YAAY,YAAY;AAAA,QAC1B;AAAA,MACF;AAEA,wBAAkB,SAAS;AAAA,QACzB,QAAQ;AAAA,QACR,MAAM;AAAA,QACN,SAAS;AAAA,UACP;AAAA,UACA,SAAS,MAAM;AAAA,UACf,UAAU,MAAM;AAAA,QAClB;AAAA,MACF,CAAC;AACD,aAAO,OAAO,EACX,KAAK,CAAC,WAAW;AAChB,0BAAkB,SAAS;AAAA,UACzB,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,SAAS;AAAA,YACP;AAAA,YACA,SAAS,MAAM;AAAA,YACf,SAAS;AAAA,UACX;AAAA,QACF,CAAC;AACD,eAAO;AAAA,MACT,CAAC,EACA,MAAM,CAAC,UAAU;AAChB,0BAAkB,SAAS;AAAA,UACzB,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAAA,UAC9D,SAAS;AAAA,YACP;AAAA,YACA,SAAS,MAAM;AAAA,YACf,SAAS;AAAA,UACX;AAAA,QACF,CAAC;AACD,cAAM;AAAA,MACR,CAAC;AAAA,IACL;AAAA,EACF,CAAC;AAED,SAAO;AACT;AAEO,SAAS,SAAc;AAC5B,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,iBAAiB,GAAG;AACjC,cAAU,iBAAiB,IAAI,kBAAkB;AAAA,EACnD;AACA,SAAO,UAAU,iBAAiB;AACpC;AAGO,SAAS,yBAA+B;AAC7C,QAAM,YAAY;AAClB,SAAO,UAAU,iBAAiB;AACpC;AAEA,SAAS,kCACP,QACG;AACH,QAAM,SAAS,kBAAkB;AACjC,QAAM,KAAK,OAAO,WAAW,MAAM;AACnC,MAAI,OAAO,OAAO,YAAY;AAC5B,UAAM,IAAI,MAAM,yCAAyC,OAAO,MAAM,CAAC,IAAI;AAAA,EAC7E;AACA,SAAO;AACT;AAEO,MAAM,eAAe;AAAA,EAC1B,MAAM,KAAK,UAAkB,SAAkD;AAC7E,UAAM,OAAO,kCAEX,MAAM;AACR,UAAM,KAAK,UAAU,OAAO;AAAA,EAC9B;AAAA,EAEA,MAAM,MAAM,UAAkC;AAC5C,UAAM,QAAQ,kCAEZ,OAAO;AACT,UAAM,MAAM,QAAQ;AAAA,EACtB;AAAA,EAEA,MAAM,MAAM,UAAiC;AAC3C,UAAM,QAAQ,kCAEZ,OAAO;AACT,UAAM,MAAM,QAAQ;AAAA,EACtB;AAAA,EAEA,MAAM,SAAS,UAAkC;AAC/C,UAAM,WAAW,kCAEf,UAAU;AACZ,UAAM,SAAS,QAAQ;AAAA,EACzB;AAAA,EAEA,MAAM,SAAS,UAAkC;AAC/C,UAAM,WAAW,kCAEf,UAAU;AACZ,UAAM,SAAS,QAAQ;AAAA,EACzB;AACF;AAEO,SAAS,oBAAoC;AAClD,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,6BAA6B,GAAG;AAC7C,cAAU,6BAA6B,IAAI,IAAI,eAAe;AAAA,EAChE;AACA,SAAO,UAAU,6BAA6B;AAChD;AAGO,SAAS,oCAA0C;AACxD,QAAM,YAAY;AAClB,SAAO,UAAU,6BAA6B;AAChD;AAIA,SAAS,oBAAoB,SAA0B;AACrD,MAAI,OAAO,YAAY,SAAU,QAAO;AACxC,MAAI,mBAAmB,MAAO,QAAO,QAAQ;AAC7C,SAAO,OAAO,OAAO;AACvB;AAEA,SAAS,aAAa,OAAyB,QAAgB,SAAiB,SAAyB;AACvG,QAAM,SAAS,IAAI,MAAM,KAAK,OAAO;AACrC,UAAQ,OAAO;AAAA,IACb,KAAK;AACH,cAAQ,MAAM,QAAQ,OAAO;AAC7B;AAAA,IACF,KAAK;AACH,cAAQ,KAAK,QAAQ,OAAO;AAC5B;AAAA,IACF,KAAK;AACH,cAAQ,MAAM,QAAQ,OAAO;AAC7B;AAAA,IACF;AACE,cAAQ,KAAK,QAAQ,OAAO;AAAA,EAChC;AACF;AAEA,MAAM,eAAe;AAAA,EACnB,YAA6B,YAAoB;AAApB;AAAA,EAAqB;AAAA,EAElD,MAAM,SAAkB,SAAyB;AAC/C,SAAK,IAAI,SAAS,SAAS,OAAO;AAAA,EACpC;AAAA,EAEA,KAAK,SAAkB,SAAyB;AAC9C,SAAK,IAAI,QAAQ,SAAS,OAAO;AAAA,EACnC;AAAA,EAEA,KAAK,SAAkB,SAAyB;AAC9C,SAAK,IAAI,QAAQ,SAAS,OAAO;AAAA,EACnC;AAAA,EAEA,MAAM,SAAkB,SAAyB;AAC/C,SAAK,IAAI,SAAS,SAAS,OAAO;AAAA,EACpC;AAAA,EAEQ,IAAI,OAAyB,YAAqB,SAAyB;AACjF,UAAM,UAAU,oBAAoB,UAAU;AAE9C,QAAI;AACJ,QAAI;AACF,eAAS,kBAAkB;AAAA,IAC7B,QAAQ;AACN,mBAAa,OAAO,KAAK,YAAY,SAAS,OAAO;AACrD;AAAA,IACF;AAEA,QAAI,OAAO,OAAO,UAAU,YAAY;AACtC,mBAAa,OAAO,KAAK,YAAY,SAAS,OAAO;AACrD;AAAA,IACF;AAEA,QAAI;AACF,aAAO,MAAM,OAAO,KAAK,YAAY,SAAS,OAAO;AAAA,IACvD,QAAQ;AACN,mBAAa,OAAO,KAAK,YAAY,SAAS,OAAO;AAAA,IACvD;AAAA,EACF;AACF;AASO,SAAS,aAAa,MAAmC;AAC9D,QAAM,aAAa,KAAK,KAAK,KAAK;AAClC,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,6BAA6B,GAAG;AAC7C,cAAU,6BAA6B,IAAI,oBAAI,IAA4B;AAAA,EAC7E;AAEA,QAAM,WAAW,UAAU,6BAA6B,GAAG,IAAI,UAAU;AACzE,MAAI,SAAU,QAAO;AAErB,QAAM,SAAS,IAAI,eAAe,UAAU;AAC5C,YAAU,6BAA6B,GAAG,IAAI,YAAY,MAAM;AAChE,SAAO;AACT;AAGO,SAAS,6BAAmC;AACjD,QAAM,YAAY;AAClB,SAAO,UAAU,6BAA6B;AAChD;AAEA,SAAS,uBAAuB,WAA4C;AAC1E,MAAI,OAAO,UAAU,qBAAqB,YAAY;AACpD;AAAA,EACF;AAEA,QAAM,qBAAqB,IAAI,2BAA2B;AAC1D,qBAAmB,iBAAiB,UAAU;AAE9C,YAAU,iBAAiB,YAAY,MAAM,cAAc,CAAC;AAC5D,YAAU,iBAAiB,KAAK,MAAM,OAAO,CAAC;AAC9C,YAAU,iBAAiB,KAAK,MAAM,OAAO,CAAC;AAC9C,YAAU,iBAAiB,gBAAgB,MAAM,kBAAkB,CAAC;AACpE,YAAU,iBAAiB,4BAA4B,MAAM,kBAAkB;AACjF;AAEA,SAAS,gCAAqC;AAC5C,QAAM,YAAY,IAAI,UAAU;AAChC,yBAAuB,SAAsC;AAC7D,SAAO;AACT;AAQO,SAAS,eAAoB;AAClC,QAAM,YAAY;AAClB,MAAI,CAAC,UAAU,uBAAuB,GAAG;AACvC,cAAU,uBAAuB,IAAI,8BAA8B;AAAA,EACrE;AACA,SAAO,UAAU,uBAAuB;AAC1C;AAGO,SAAS,+BAAqC;AACnD,QAAM,YAAY;AAClB,SAAO,UAAU,uBAAuB;AAC1C;AAGO,SAAS,gCAAsC;AACpD,mCAAiC;AACnC;AAGO,SAAS,kBACd,GACA,GACA,WACA,YAC0B;AAC1B,QAAM,KAAK,OAAO,WAAW,cAAc,OAAO,aAAa;AAC/D,QAAM,KAAK,OAAO,WAAW,cAAc,OAAO,cAAc;AAChE,SAAO;AAAA,IACL,GAAG,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,SAAS,CAAC;AAAA,IAC1C,GAAG,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,UAAU,CAAC;AAAA,EAC7C;AACF;AAEA,SAAS,cAAc,QAAiC;AACtD,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,+BAA+B;AAAA,EACjD;AACA,SAAO;AACT;AAQA,eAAsB,UACpB,WACA,QACY;AAEZ,QAAM,YAAY,aAAa;AAE/B,gBAAc;AAGd,MAAI;AACF,UAAM,cAAe,WAAuC;AAG5D,QAAI,eAAe,OAAO,YAAY,SAAS,YAAY;AACzD,YAAM,SAAS,YAAY,KAAK,KAAK,WAAW;AAChD,gCAA0B,CAAC,YAAqB,OAAO,OAAO,CAAC;AAAA,IACjE;AAAA,EACF,QAAQ;AAAA,EAER;AAIA,MAAI;AACF,UAAM,SAAS,kBAAkB;AACjC,QAAI,OAAO,OAAO,iBAAiB,YAAY;AAC7C,YAAM,SAAS,MAAM,OAAO,aAAa;AAIzC,YAAM,qBAAqB,UAAU,WACjC,MAAM,UAAU,SAAS,0BAA0B,IACnD;AACJ,UAAI,OAAO,QAAQ,yBAAyB,WAAW;AACrD,4BAAoB,iBAAiB,OAAO,oBAAoB;AAAA,MAClE;AACA,YAAM,QAAQ,QAAQ;AACtB,UAAI,UAAU,WAAW,UAAU,UAAU,UAAU,UAAU,UAAU,SAAS;AAClF,4BAAoB,kBAAkB,KAAK;AAAA,MAC7C;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,SAAO,UAAU,cAAc,MAAM,CAAC;AACxC;AAQO,SAAS,iBACd,WACA;AACA,SAAO,CAAC,WAA8B,UAAU,cAAc,MAAM,CAAC;AACvE;AAMA,SAAS,eAAe,8BAAAA,mCAAkC;","names":["TraceProviderConfiguration"]}
+{"version":3,"sources":["../../src/client/index.ts"],"sourcesContent":["import './global_polyfill.js';\nimport 'reflect-metadata';\nimport { Container } from '@noego/ioc';\nimport {\n  Navigation,\n  getNavigation,\n  clearNavigationForTests as clearNavigationSingletonForTests,\n} from '../navigation/index.js';\nimport { Ipc, getIpc } from '../ipc/index.js';\nimport {\n  TraceProviderConfiguration,\n  clearTraceHubForTests,\n  emitRendererTrace,\n  setRendererTraceTransport,\n} from '../tracing/index.js';\nexport type {\n  ControllerEvents,\n  ControllerInput,\n  ControllerLifecycle,\n  ControllerState,\n  PageController,\n} from './controller_contract.js';\n\nconst CLIENT_CONTAINER_SYMBOL = Symbol.for('@noego/wood.client.container');\nconst CLIENT_APP_SYMBOL = Symbol.for('@noego/wood.client.app');\nconst CLIENT_WINDOW_CONTROLS_SYMBOL = Symbol.for('@noego/wood.client.window-controls');\nconst CLIENT_LOGGER_REGISTRY_SYMBOL = Symbol.for('@noego/wood.client.logger-registry');\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\nexport const WOOD_INTERNAL_BRIDGE_KEY = INTERNAL_BRIDGE_GLOBAL_KEY;\n\nexport interface WoodRpcManifestEntry {\n  channel: string;\n  controller: string;\n  action: string;\n  path: string[];\n  hasInput: boolean;\n}\n\ntype WoodBridgeRpcFunction = (data?: unknown) => Promise<unknown>;\ntype WoodBridgeLike = Record<string, unknown> & {\n  __rpcManifest?: WoodRpcManifestEntry[];\n  __window?: {\n    current?: () => Promise<unknown>;\n    open?: (windowId: string, options?: Record<string, unknown>) => Promise<unknown>;\n    close?: (windowId?: string) => Promise<unknown>;\n    focus?: (windowId: string) => Promise<unknown>;\n    minimize?: (windowId?: string) => Promise<unknown>;\n    maximize?: (windowId?: string) => Promise<unknown>;\n  };\n  __log?: (\n    level: string,\n    logger: string,\n    message: string,\n    context?: unknown,\n  ) => void;\n  __woodConfig?: () => Promise<unknown>;\n  __trace?: (event: unknown) => void;\n};\n\ntype GlobalWithClientContainer = typeof globalThis & {\n  [CLIENT_CONTAINER_SYMBOL]?: any;\n};\n\ntype GlobalWithClientApp = typeof globalThis & {\n  [CLIENT_APP_SYMBOL]?: App;\n};\n\ntype GlobalWithWindowControls = typeof globalThis & {\n  [CLIENT_WINDOW_CONTROLS_SYMBOL]?: WindowControls;\n};\n\ntype GlobalWithLoggerRegistry = typeof globalThis & {\n  [CLIENT_LOGGER_REGISTRY_SYMBOL]?: Map<string, RendererLogger>;\n};\n\ninterface WoodContainerRegistration {\n  registerFunction?(\n    token: any,\n    resolver: (...args: any[]) => unknown,\n    options?: Record<string, unknown>,\n  ): void;\n}\n\nexport class App {\n  [controllerName: string]: unknown;\n}\n\nfunction resolveWoodBridge(): WoodBridgeLike {\n  const globalObj = globalThis as typeof globalThis & {\n    [INTERNAL_BRIDGE_GLOBAL_KEY]?: unknown;\n    wood?: unknown;\n    window?: {\n      [INTERNAL_BRIDGE_GLOBAL_KEY]?: unknown;\n      wood?: unknown;\n    };\n  };\n\n  const bridge = globalObj[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.window?.[INTERNAL_BRIDGE_GLOBAL_KEY]\n    ?? globalObj.wood\n    ?? globalObj.window?.wood;\n  if (!bridge || typeof bridge !== 'object') {\n    throw new Error(\n      `Wood bridge is not available on globalThis.${INTERNAL_BRIDGE_GLOBAL_KEY}.`,\n    );\n  }\n\n  return bridge as WoodBridgeLike;\n}\n\nfunction resolveRpcManifest(bridge: WoodBridgeLike): WoodRpcManifestEntry[] {\n  const manifest = bridge.__rpcManifest;\n  if (!Array.isArray(manifest)) {\n    throw new Error(\n      'Wood bridge is missing \"__rpcManifest\". Regenerate preload with the latest @noego/wood.',\n    );\n  }\n\n  return manifest;\n}\n\nfunction resolveBridgeFunction(\n  bridge: WoodBridgeLike,\n  pathSegments: string[],\n  operationKey: string,\n): WoodBridgeRpcFunction {\n  let current: unknown = bridge;\n\n  for (const segment of pathSegments) {\n    if (!current || typeof current !== 'object') {\n      throw new Error(\n        `Wood bridge operation \"${operationKey}\" is missing path \"${pathSegments.join('.')}\".`,\n      );\n    }\n    current = (current as Record<string, unknown>)[segment];\n  }\n\n  if (typeof current !== 'function') {\n    throw new Error(\n      `Wood bridge path \"${pathSegments.join('.')}\" for \"${operationKey}\" is not callable.`,\n    );\n  }\n\n  return current as WoodBridgeRpcFunction;\n}\n\nfunction assertSerializable(value: unknown, operationKey: string): void {\n  if (typeof structuredClone !== 'function') {\n    return;\n  }\n\n  try {\n    structuredClone(value);\n  } catch (error) {\n    const reason = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `App RPC \"${operationKey}\" payload is not serializable: ${reason}`,\n    );\n  }\n}\n\nfunction extractTraceConversationId(value: unknown): number | string | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n\n  const record = value as Record<string, unknown>;\n  if (typeof record.conversationId === 'number' || typeof record.conversationId === 'string') {\n    return record.conversationId;\n  }\n  if (typeof record.threadId === 'number' || typeof record.threadId === 'string') {\n    return record.threadId;\n  }\n\n  return undefined;\n}\n\nfunction validateManifestEntry(entry: WoodRpcManifestEntry, index: number): void {\n  if (!entry.channel || !entry.controller || !entry.action) {\n    throw new Error(`Invalid Wood RPC manifest entry at index ${index}.`);\n  }\n  if (!Array.isArray(entry.path) || entry.path.length === 0) {\n    throw new Error(\n      `Invalid Wood RPC manifest path for \"${entry.controller}.${entry.action}\".`,\n    );\n  }\n}\n\nfunction createAppInstance(): App {\n  const bridge = resolveWoodBridge();\n  const manifest = resolveRpcManifest(bridge);\n  const app: Record<string, Record<string, (...args: unknown[]) => Promise<unknown>>> = {};\n\n  manifest.forEach((entry, index) => {\n    validateManifestEntry(entry, index);\n\n    const operationKey = `${entry.controller}.${entry.action}`;\n    const invoke = resolveBridgeFunction(bridge, entry.path, operationKey);\n\n    if (!app[entry.controller]) {\n      app[entry.controller] = {};\n    }\n\n    if (app[entry.controller][entry.action]) {\n      throw new Error(\n        `Duplicate RPC action \"${operationKey}\" in Wood manifest. Actions must be unique per controller.`,\n      );\n    }\n\n    app[entry.controller][entry.action] = (...args: unknown[]): Promise<unknown> => {\n      if (entry.hasInput) {\n        if (args.length !== 1) {\n          throw new Error(\n            `App RPC \"${operationKey}\" expects exactly one payload argument.`,\n          );\n        }\n        assertSerializable(args[0], operationKey);\n        const conversationId = extractTraceConversationId(args[0]);\n        emitRendererTrace('debug', {\n          source: 'wood.client.app',\n          type: 'rpc.request',\n          ...(conversationId !== undefined ? { conversationId } : {}),\n          payload: {\n            operationKey,\n            channel: entry.channel,\n            hasInput: entry.hasInput,\n          },\n        });\n        return invoke(args[0])\n          .then((result) => {\n            emitRendererTrace('debug', {\n              source: 'wood.client.app',\n              type: 'rpc.response',\n              ...(conversationId !== undefined ? { conversationId } : {}),\n              payload: {\n                operationKey,\n                channel: entry.channel,\n                outcome: 'ok',\n              },\n            });\n            return result;\n          })\n          .catch((error) => {\n            emitRendererTrace('error', {\n              source: 'wood.client.app',\n              type: 'rpc.response',\n              message: error instanceof Error ? error.message : String(error),\n              ...(conversationId !== undefined ? { conversationId } : {}),\n              payload: {\n                operationKey,\n                channel: entry.channel,\n                outcome: 'error',\n              },\n            });\n            throw error;\n          });\n      }\n\n      if (args.length !== 0) {\n        throw new Error(\n          `App RPC \"${operationKey}\" expects no arguments.`,\n        );\n      }\n\n      emitRendererTrace('debug', {\n        source: 'wood.client.app',\n        type: 'rpc.request',\n        payload: {\n          operationKey,\n          channel: entry.channel,\n          hasInput: entry.hasInput,\n        },\n      });\n      return invoke()\n        .then((result) => {\n          emitRendererTrace('debug', {\n            source: 'wood.client.app',\n            type: 'rpc.response',\n            payload: {\n              operationKey,\n              channel: entry.channel,\n              outcome: 'ok',\n            },\n          });\n          return result;\n        })\n        .catch((error) => {\n          emitRendererTrace('error', {\n            source: 'wood.client.app',\n            type: 'rpc.response',\n            message: error instanceof Error ? error.message : String(error),\n            payload: {\n              operationKey,\n              channel: entry.channel,\n              outcome: 'error',\n            },\n          });\n          throw error;\n        });\n    };\n  });\n\n  return app as unknown as App;\n}\n\nexport function getApp(): App {\n  const globalObj = globalThis as GlobalWithClientApp;\n  if (!globalObj[CLIENT_APP_SYMBOL]) {\n    globalObj[CLIENT_APP_SYMBOL] = createAppInstance();\n  }\n  return globalObj[CLIENT_APP_SYMBOL] as App;\n}\n\n/** Test-only helper to clear the client App singleton. */\nexport function clearClientAppForTests(): void {\n  const globalObj = globalThis as GlobalWithClientApp;\n  delete globalObj[CLIENT_APP_SYMBOL];\n}\n\nfunction resolveWindowControlsBridgeMethod<T>(\n  method: keyof NonNullable<WoodBridgeLike['__window']>,\n): T {\n  const bridge = resolveWoodBridge();\n  const fn = bridge.__window?.[method];\n  if (typeof fn !== 'function') {\n    throw new Error(`Wood bridge does not expose \"__window.${String(method)}\".`);\n  }\n  return fn as unknown as T;\n}\n\nexport class WindowControls {\n  async open(windowId: string, options?: Record<string, unknown>): Promise<void> {\n    const open = resolveWindowControlsBridgeMethod<\n      (id: string, opts?: Record<string, unknown>) => Promise<unknown>\n    >('open');\n    await open(windowId, options);\n  }\n\n  async close(windowId?: string): Promise<void> {\n    const close = resolveWindowControlsBridgeMethod<\n      (id?: string) => Promise<unknown>\n    >('close');\n    await close(windowId);\n  }\n\n  async focus(windowId: string): Promise<void> {\n    const focus = resolveWindowControlsBridgeMethod<\n      (id: string) => Promise<unknown>\n    >('focus');\n    await focus(windowId);\n  }\n\n  async minimize(windowId?: string): Promise<void> {\n    const minimize = resolveWindowControlsBridgeMethod<\n      (id?: string) => Promise<unknown>\n    >('minimize');\n    await minimize(windowId);\n  }\n\n  async maximize(windowId?: string): Promise<void> {\n    const maximize = resolveWindowControlsBridgeMethod<\n      (id?: string) => Promise<unknown>\n    >('maximize');\n    await maximize(windowId);\n  }\n}\n\nexport function getWindowControls(): WindowControls {\n  const globalObj = globalThis as GlobalWithWindowControls;\n  if (!globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL]) {\n    globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL] = new WindowControls();\n  }\n  return globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL] as WindowControls;\n}\n\n/** Test-only helper to clear the client WindowControls singleton. */\nexport function clearClientWindowControlsForTests(): void {\n  const globalObj = globalThis as GlobalWithWindowControls;\n  delete globalObj[CLIENT_WINDOW_CONTROLS_SYMBOL];\n}\n\ntype RendererLogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nfunction stringifyLogMessage(message: unknown): string {\n  if (typeof message === 'string') return message;\n  if (message instanceof Error) return message.message;\n  return String(message);\n}\n\nfunction writeConsole(level: RendererLogLevel, logger: string, message: string, context?: unknown): void {\n  const prefix = `[${logger}] ${message}`;\n  switch (level) {\n    case 'debug':\n      console.debug(prefix, context);\n      return;\n    case 'warn':\n      console.warn(prefix, context);\n      return;\n    case 'error':\n      console.error(prefix, context);\n      return;\n    default:\n      console.info(prefix, context);\n  }\n}\n\nclass RendererLogger {\n  constructor(private readonly loggerName: string) {}\n\n  debug(message: unknown, context?: unknown): void {\n    this.log('debug', message, context);\n  }\n\n  info(message: unknown, context?: unknown): void {\n    this.log('info', message, context);\n  }\n\n  warn(message: unknown, context?: unknown): void {\n    this.log('warn', message, context);\n  }\n\n  error(message: unknown, context?: unknown): void {\n    this.log('error', message, context);\n  }\n\n  private log(level: RendererLogLevel, rawMessage: unknown, context?: unknown): void {\n    const message = stringifyLogMessage(rawMessage);\n\n    let bridge: WoodBridgeLike;\n    try {\n      bridge = resolveWoodBridge();\n    } catch {\n      writeConsole(level, this.loggerName, message, context);\n      return;\n    }\n\n    if (typeof bridge.__log !== 'function') {\n      writeConsole(level, this.loggerName, message, context);\n      return;\n    }\n\n    try {\n      bridge.__log(level, this.loggerName, message, context);\n    } catch {\n      writeConsole(level, this.loggerName, message, context);\n    }\n  }\n}\n\ntype RendererLoggerShape = {\n  debug(message: unknown, context?: unknown): void;\n  info(message: unknown, context?: unknown): void;\n  warn(message: unknown, context?: unknown): void;\n  error(message: unknown, context?: unknown): void;\n};\n\nexport function createLogger(name: string): RendererLoggerShape {\n  const loggerName = name.trim() || 'renderer';\n  const globalObj = globalThis as GlobalWithLoggerRegistry;\n  if (!globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL]) {\n    globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL] = new Map<string, RendererLogger>();\n  }\n\n  const existing = globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL]?.get(loggerName);\n  if (existing) return existing;\n\n  const logger = new RendererLogger(loggerName);\n  globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL]?.set(loggerName, logger);\n  return logger;\n}\n\n/** Test-only helper to clear client logger singletons. */\nexport function clearClientLoggersForTests(): void {\n  const globalObj = globalThis as GlobalWithLoggerRegistry;\n  delete globalObj[CLIENT_LOGGER_REGISTRY_SYMBOL];\n}\n\nfunction registerClientBuiltins(container: WoodContainerRegistration): void {\n  if (typeof container.registerFunction !== 'function') {\n    return;\n  }\n\n  const traceConfiguration = new TraceProviderConfiguration();\n  traceConfiguration.configureRuntime('renderer');\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\nfunction createClientContainerInstance(): any {\n  const container = new Container();\n  registerClientBuiltins(container as WoodContainerRegistration);\n  return container;\n}\n\n/**\n * Return a process-global client container instance.\n *\n * - First call creates the container and stores it on a symbol.\n * - Later calls return the same container instance.\n */\nexport function getContainer(): any {\n  const globalObj = globalThis as GlobalWithClientContainer;\n  if (!globalObj[CLIENT_CONTAINER_SYMBOL]) {\n    globalObj[CLIENT_CONTAINER_SYMBOL] = createClientContainerInstance();\n  }\n  return globalObj[CLIENT_CONTAINER_SYMBOL];\n}\n\n/** Test-only helper to clear the client container singleton. */\nexport function clearClientContainerForTests(): void {\n  const globalObj = globalThis as GlobalWithClientContainer;\n  delete globalObj[CLIENT_CONTAINER_SYMBOL];\n}\n\n/** Test-only helper to clear the client navigation singleton. */\nexport function clearClientNavigationForTests(): void {\n  clearNavigationSingletonForTests();\n}\n\n/** Clamp a menu position so it stays within viewport bounds. */\nexport function clampMenuPosition(\n  x: number,\n  y: number,\n  menuWidth: number,\n  menuHeight: number,\n): { x: number; y: number } {\n  const vw = typeof window !== 'undefined' ? window.innerWidth : Infinity;\n  const vh = typeof window !== 'undefined' ? window.innerHeight : Infinity;\n  return {\n    x: Math.min(x, Math.max(0, vw - menuWidth)),\n    y: Math.min(y, Math.max(0, vh - menuHeight)),\n  };\n}\n\nfunction resolveTarget(target: Element | null): Element {\n  if (!target) {\n    throw new Error('Missing renderer mount target');\n  }\n  return target;\n}\n\n/**\n * Start a Wood renderer app by mounting it to a target element.\n * Usage:\n *   import { app } from './generated/app.js';\n *   startWood(app, document.getElementById('app'));\n */\nexport async function startWood<T>(\n  mountRoot: (target: Element) => T,\n  target: Element | null,\n): Promise<T> {\n  // Ensure container singleton exists and registers built-in client tokens.\n  const container = getContainer();\n  // Ensure navigation singleton exists at first client boot.\n  getNavigation();\n\n  // Auto-detect MessagePort-based trace transport\n  try {\n    const traceGlobal = (globalThis as Record<string, unknown>).__NOEGO_TRACE__ as\n      | { send?: (data: unknown) => void }\n      | undefined;\n    if (traceGlobal && typeof traceGlobal.send === 'function') {\n      const sender = traceGlobal.send.bind(traceGlobal);\n      setRendererTraceTransport((payload: unknown) => sender(payload));\n    }\n  } catch {\n    // MessagePort trace transport not available; IPC fallback remains active.\n  }\n\n  // Fetch framework config from the main process and apply renderer trace\n  // controls before the first render.\n  try {\n    const bridge = resolveWoodBridge();\n    if (typeof bridge.__woodConfig === 'function') {\n      const config = await bridge.__woodConfig() as {\n        rendererTraceEnabled?: boolean;\n        rendererTraceMinLevel?: string;\n      } | null;\n      const traceConfiguration = container.instance\n        ? await container.instance(TraceProviderConfiguration)\n        : null;\n      if (typeof config?.rendererTraceEnabled === 'boolean') {\n        traceConfiguration?.configureEnabled(config.rendererTraceEnabled);\n      }\n      const level = config?.rendererTraceMinLevel;\n      if (level === 'debug' || level === 'info' || level === 'warn' || level === 'error') {\n        traceConfiguration?.configureMinLevel(level);\n      }\n    }\n  } catch {\n    // Config fetch is best-effort; fall back to defaults.\n  }\n\n  return mountRoot(resolveTarget(target));\n}\n\n/**\n * Backward-compatible helper that returns a target-aware boot function.\n * Usage:\n *   const boot = createSvelteBoot(app);\n *   const mounted = boot(document.getElementById('app'));\n */\nexport function createSvelteBoot<T>(\n  mountRoot: (target: Element) => T,\n) {\n  return (target: Element | null): T => mountRoot(resolveTarget(target));\n}\n\nexport { getNavigation };\nexport { Ipc, getIpc };\nexport { clearTraceHubForTests };\nexport { setRendererTraceTransport };\nexport { TraceProvider, TraceProviderConfiguration } from '../tracing/index.js';\nexport type {\n  FrameworkTracer,\n  TraceCaptureOptions,\n  TraceEvent,\n  TraceInput,\n  TraceLevel,\n  TraceProcess,\n  TraceProviderMode,\n  TraceRuntime,\n  TraceWaitOptions,\n} from '../tracing/index.js';\n"],"mappings":"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","names":["TraceProviderConfiguration"]}

package/dist/testing/create_controller_harness.cjs

@@ -28,8 +28,8 @@ var import_navigation = require("../navigation/index.js");
 var import_tracing = require("../tracing/index.js");
 var import_operations_parser = require("../parser/operations_parser.cjs");
 var import_controller_lifecycle = require("../controller/controller_lifecycle.cjs");
-var import_create_router_bridge = require("./create_router_bridge.cjs");
-var import_create_test_router = require("./create_test_router.cjs");
+var import_create_router_bridge = require("./create_router_bridge.js");
+var import_create_test_router = require("./create_test_router.js");
 function readOperations(input) {
   if (input.includes("\n") || input.includes(":")) {
     return (0, import_operations_parser.parseOperations)(input);

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 { 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.cjs';\nimport { createTestRouter } from './create_test_router.cjs';\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  trace: TraceProvider;\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  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    trace,\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 {\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 { 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  trace: TraceProvider;\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  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    trace,\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_test_router.cjs

@@ -23,7 +23,7 @@ __export(create_test_router_exports, {
 module.exports = __toCommonJS(create_test_router_exports);
 var import_wood_router = require("../router/wood_router.cjs");
 var import_operations_parser = require("../parser/operations_parser.cjs");
-var import_create_test_container = require("./create_test_container.cjs");
+var import_create_test_container = require("./create_test_container.js");
 var import_fs = require("fs");
 function createTestRouter(yamlPathOrContent, options) {
   let operations;

package/dist/testing/create_test_router.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/create_test_router.ts"],"sourcesContent":["import { WoodRouter } from '../router/wood_router.cjs';\nimport { parseOperations } from '../parser/operations_parser.cjs';\nimport { createTestContainer } from './create_test_container.cjs';\nimport { readFileSync } from 'fs';\n\nexport interface TestRouterResult {\n  router: WoodRouter;\n  dispatch: (channel: string, data?: unknown) => Promise<unknown>;\n  channels: string[];\n}\n\n/**\n * Create a WoodRouter from operations YAML, ready for integration testing.\n * No real ipcMain -- operations are callable via dispatch().\n */\nexport function createTestRouter(\n  yamlPathOrContent: string,\n  options?: {\n    container?: any;\n    controllersDir?: string;\n    middlewareDir?: string;\n  },\n): TestRouterResult {\n  // Parse operations\n  let operations: Map<string, any>;\n  if (yamlPathOrContent.trim() === '') {\n    operations = new Map();\n  } else if (yamlPathOrContent.includes('\\n') || yamlPathOrContent.includes(':')) {\n    // Looks like YAML content\n    operations = parseOperations(yamlPathOrContent);\n  } else {\n    // Looks like a file path\n    const content = readFileSync(yamlPathOrContent, 'utf-8');\n    operations = parseOperations(content);\n  }\n\n  const container = options?.container ?? createTestContainer();\n\n  const router = new WoodRouter({\n    container,\n    controllersDir: options?.controllersDir ?? './server/controller',\n    middlewareDir: options?.middlewareDir ?? './middleware',\n    mode: 'dev', // Tests use filesystem-based controller resolution\n  });\n\n  router.loadOperations(operations);\n\n  return {\n    router,\n    dispatch: (channel: string, data?: unknown) => router.dispatch(channel, data ?? {}),\n    channels: router.getChannels(),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAA2B;AAC3B,+BAAgC;AAChC,mCAAoC;AACpC,gBAA6B;AAYtB,SAAS,iBACd,mBACA,SAKkB;AAElB,MAAI;AACJ,MAAI,kBAAkB,KAAK,MAAM,IAAI;AACnC,iBAAa,oBAAI,IAAI;AAAA,EACvB,WAAW,kBAAkB,SAAS,IAAI,KAAK,kBAAkB,SAAS,GAAG,GAAG;AAE9E,qBAAa,0CAAgB,iBAAiB;AAAA,EAChD,OAAO;AAEL,UAAM,cAAU,wBAAa,mBAAmB,OAAO;AACvD,qBAAa,0CAAgB,OAAO;AAAA,EACtC;AAEA,QAAM,YAAY,SAAS,iBAAa,kDAAoB;AAE5D,QAAM,SAAS,IAAI,8BAAW;AAAA,IAC5B;AAAA,IACA,gBAAgB,SAAS,kBAAkB;AAAA,IAC3C,eAAe,SAAS,iBAAiB;AAAA,IACzC,MAAM;AAAA;AAAA,EACR,CAAC;AAED,SAAO,eAAe,UAAU;AAEhC,SAAO;AAAA,IACL;AAAA,IACA,UAAU,CAAC,SAAiB,SAAmB,OAAO,SAAS,SAAS,QAAQ,CAAC,CAAC;AAAA,IAClF,UAAU,OAAO,YAAY;AAAA,EAC/B;AACF;","names":[]}
+{"version":3,"sources":["../../src/testing/create_test_router.ts"],"sourcesContent":["import { WoodRouter } from '../router/wood_router.cjs';\nimport { parseOperations } from '../parser/operations_parser.cjs';\nimport { createTestContainer } from './create_test_container.js';\nimport { readFileSync } from 'fs';\n\nexport interface TestRouterResult {\n  router: WoodRouter;\n  dispatch: (channel: string, data?: unknown) => Promise<unknown>;\n  channels: string[];\n}\n\n/**\n * Create a WoodRouter from operations YAML, ready for integration testing.\n * No real ipcMain -- operations are callable via dispatch().\n */\nexport function createTestRouter(\n  yamlPathOrContent: string,\n  options?: {\n    container?: any;\n    controllersDir?: string;\n    middlewareDir?: string;\n  },\n): TestRouterResult {\n  // Parse operations\n  let operations: Map<string, any>;\n  if (yamlPathOrContent.trim() === '') {\n    operations = new Map();\n  } else if (yamlPathOrContent.includes('\\n') || yamlPathOrContent.includes(':')) {\n    // Looks like YAML content\n    operations = parseOperations(yamlPathOrContent);\n  } else {\n    // Looks like a file path\n    const content = readFileSync(yamlPathOrContent, 'utf-8');\n    operations = parseOperations(content);\n  }\n\n  const container = options?.container ?? createTestContainer();\n\n  const router = new WoodRouter({\n    container,\n    controllersDir: options?.controllersDir ?? './server/controller',\n    middlewareDir: options?.middlewareDir ?? './middleware',\n    mode: 'dev', // Tests use filesystem-based controller resolution\n  });\n\n  router.loadOperations(operations);\n\n  return {\n    router,\n    dispatch: (channel: string, data?: unknown) => router.dispatch(channel, data ?? {}),\n    channels: router.getChannels(),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAA2B;AAC3B,+BAAgC;AAChC,mCAAoC;AACpC,gBAA6B;AAYtB,SAAS,iBACd,mBACA,SAKkB;AAElB,MAAI;AACJ,MAAI,kBAAkB,KAAK,MAAM,IAAI;AACnC,iBAAa,oBAAI,IAAI;AAAA,EACvB,WAAW,kBAAkB,SAAS,IAAI,KAAK,kBAAkB,SAAS,GAAG,GAAG;AAE9E,qBAAa,0CAAgB,iBAAiB;AAAA,EAChD,OAAO;AAEL,UAAM,cAAU,wBAAa,mBAAmB,OAAO;AACvD,qBAAa,0CAAgB,OAAO;AAAA,EACtC;AAEA,QAAM,YAAY,SAAS,iBAAa,kDAAoB;AAE5D,QAAM,SAAS,IAAI,8BAAW;AAAA,IAC5B;AAAA,IACA,gBAAgB,SAAS,kBAAkB;AAAA,IAC3C,eAAe,SAAS,iBAAiB;AAAA,IACzC,MAAM;AAAA;AAAA,EACR,CAAC;AAED,SAAO,eAAe,UAAU;AAEhC,SAAO;AAAA,IACL;AAAA,IACA,UAAU,CAAC,SAAiB,SAAmB,OAAO,SAAS,SAAS,QAAQ,CAAC,CAAC;AAAA,IAClF,UAAU,OAAO,YAAY;AAAA,EAC/B;AACF;","names":[]}

package/dist/testing/index.cjs

@@ -30,12 +30,12 @@ __export(testing_exports, {
   mockElectron: () => import_mock_electron.mockElectron
 });
 module.exports = __toCommonJS(testing_exports);
-var import_create_test_container = require("./create_test_container.cjs");
-var import_create_controller_harness = require("./create_controller_harness");
-var import_create_test_router = require("./create_test_router.cjs");
-var import_mock_electron = require("./mock_electron.cjs");
-var import_create_router_bridge = require("./create_router_bridge");
-var import_browser = require("./browser");
+var import_create_test_container = require("./create_test_container.js");
+var import_create_controller_harness = require("./create_controller_harness.js");
+var import_create_test_router = require("./create_test_router.js");
+var import_mock_electron = require("./mock_electron.js");
+var import_create_router_bridge = require("./create_router_bridge.js");
+var import_browser = require("./browser.js");
 var import_tracing = require("../tracing/index.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/testing/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["export { createTestContainer } from './create_test_container.cjs';\nexport {\n  createControllerHarness,\n  type ControllerHarnessResult,\n  type CreateControllerHarnessOptions,\n} from './create_controller_harness';\nexport { createTestRouter, type TestRouterResult } from './create_test_router.cjs';\nexport { mockElectron, getElectronMockFactory } from './mock_electron.cjs';\nexport {\n  createRouterBridge,\n  RouterBridgeEvents,\n  type RouterBridgeResult,\n} from './create_router_bridge';\nexport {\n  browser,\n  createBrowserBridgeFixture,\n  type MountedWoodBridge,\n  type MountedWoodComponent,\n  type MountedWoodNavigation,\n  type MountedWoodRoute,\n  type MountedWoodSurface,\n  type MountedWoodTree,\n  type MountComponentOptions,\n  type MountRouteOptions,\n  type MountTreeOptions,\n  type WoodBridgeFixtureContext,\n  type WoodBridgeFixtureInput,\n  type WoodBridgeRecordedCall,\n  type WoodBridgeRecordedEvent,\n  type WoodBrowserExpect,\n  type WoodBrowserHarness,\n  type WoodBrowserHarnessConfig,\n  type WoodBrowserPageContext,\n  type WoodViewport,\n} from './browser';\nexport { TraceCapture } from '../tracing/index.js';\nexport type {\n  TraceCaptureOptions,\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,mCAAoC;AACpC,uCAIO;AACP,gCAAwD;AACxD,2BAAqD;AACrD,kCAIO;AACP,qBAqBO;AACP,qBAA6B;","names":[]}
+{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["export { createTestContainer } from './create_test_container.js';\nexport {\n  createControllerHarness,\n  type ControllerHarnessResult,\n  type CreateControllerHarnessOptions,\n} from './create_controller_harness.js';\nexport { createTestRouter, type TestRouterResult } from './create_test_router.js';\nexport { mockElectron, getElectronMockFactory } from './mock_electron.js';\nexport {\n  createRouterBridge,\n  RouterBridgeEvents,\n  type RouterBridgeResult,\n} from './create_router_bridge.js';\nexport {\n  browser,\n  createBrowserBridgeFixture,\n  type MountedWoodBridge,\n  type MountedWoodComponent,\n  type MountedWoodNavigation,\n  type MountedWoodRoute,\n  type MountedWoodSurface,\n  type MountedWoodTree,\n  type MountComponentOptions,\n  type MountRouteOptions,\n  type MountTreeOptions,\n  type WoodBridgeFixtureContext,\n  type WoodBridgeFixtureInput,\n  type WoodBridgeRecordedCall,\n  type WoodBridgeRecordedEvent,\n  type WoodBrowserExpect,\n  type WoodBrowserHarness,\n  type WoodBrowserHarnessConfig,\n  type WoodBrowserPageContext,\n  type WoodViewport,\n} from './browser.js';\nexport { TraceCapture } from '../tracing/index.js';\nexport type {\n  TraceCaptureOptions,\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,mCAAoC;AACpC,uCAIO;AACP,gCAAwD;AACxD,2BAAqD;AACrD,kCAIO;AACP,qBAqBO;AACP,qBAA6B;","names":[]}

package/dist/testing/index.js

@@ -1,17 +1,17 @@
 import { createTestContainer } from "./create_test_container.js";
 import {
   createControllerHarness
-} from "./create_controller_harness";
+} from "./create_controller_harness.js";
 import { createTestRouter } from "./create_test_router.js";
 import { mockElectron, getElectronMockFactory } from "./mock_electron.js";
 import {
   createRouterBridge,
   RouterBridgeEvents
-} from "./create_router_bridge";
+} from "./create_router_bridge.js";
 import {
   browser,
   createBrowserBridgeFixture
-} from "./browser";
+} from "./browser.js";
 import { TraceCapture } from "../tracing/index.js";
 export {
   RouterBridgeEvents,

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["export { createTestContainer } from './create_test_container.js';\nexport {\n  createControllerHarness,\n  type ControllerHarnessResult,\n  type CreateControllerHarnessOptions,\n} from './create_controller_harness';\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';\nexport {\n  browser,\n  createBrowserBridgeFixture,\n  type MountedWoodBridge,\n  type MountedWoodComponent,\n  type MountedWoodNavigation,\n  type MountedWoodRoute,\n  type MountedWoodSurface,\n  type MountedWoodTree,\n  type MountComponentOptions,\n  type MountRouteOptions,\n  type MountTreeOptions,\n  type WoodBridgeFixtureContext,\n  type WoodBridgeFixtureInput,\n  type WoodBridgeRecordedCall,\n  type WoodBridgeRecordedEvent,\n  type WoodBrowserExpect,\n  type WoodBrowserHarness,\n  type WoodBrowserHarnessConfig,\n  type WoodBrowserPageContext,\n  type WoodViewport,\n} from './browser';\nexport { TraceCapture } from '../tracing/index.js';\nexport type {\n  TraceCaptureOptions,\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceWaitOptions,\n} from '../tracing/index.js';\n"],"mappings":"AAAA,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,OAGK;AACP,SAAS,wBAA+C;AACxD,SAAS,cAAc,8BAA8B;AACrD;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAmBK;AACP,SAAS,oBAAoB;","names":[]}
+{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["export { createTestContainer } from './create_test_container.js';\nexport {\n  createControllerHarness,\n  type ControllerHarnessResult,\n  type CreateControllerHarnessOptions,\n} from './create_controller_harness.js';\nexport { createTestRouter, type TestRouterResult } from './create_test_router.js';\nexport { mockElectron, getElectronMockFactory } from './mock_electron.js';\nexport {\n  createRouterBridge,\n  RouterBridgeEvents,\n  type RouterBridgeResult,\n} from './create_router_bridge.js';\nexport {\n  browser,\n  createBrowserBridgeFixture,\n  type MountedWoodBridge,\n  type MountedWoodComponent,\n  type MountedWoodNavigation,\n  type MountedWoodRoute,\n  type MountedWoodSurface,\n  type MountedWoodTree,\n  type MountComponentOptions,\n  type MountRouteOptions,\n  type MountTreeOptions,\n  type WoodBridgeFixtureContext,\n  type WoodBridgeFixtureInput,\n  type WoodBridgeRecordedCall,\n  type WoodBridgeRecordedEvent,\n  type WoodBrowserExpect,\n  type WoodBrowserHarness,\n  type WoodBrowserHarnessConfig,\n  type WoodBrowserPageContext,\n  type WoodViewport,\n} from './browser.js';\nexport { TraceCapture } from '../tracing/index.js';\nexport type {\n  TraceCaptureOptions,\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceWaitOptions,\n} from '../tracing/index.js';\n"],"mappings":"AAAA,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,OAGK;AACP,SAAS,wBAA+C;AACxD,SAAS,cAAc,8BAA8B;AACrD;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAmBK;AACP,SAAS,oBAAoB;","names":[]}

package/dist/testing/mock_electron.cjs

@@ -22,69 +22,89 @@ __export(mock_electron_exports, {
   mockElectron: () => mockElectron
 });
 module.exports = __toCommonJS(mock_electron_exports);
-var import_vitest = require("vitest");
+function createMockFunction(implementation) {
+  let currentImplementation = implementation ?? (() => void 0);
+  const mock = ((...args) => {
+    mock.calls.push(args);
+    return currentImplementation(...args);
+  });
+  mock.calls = [];
+  mock.mockImplementation = (nextImplementation) => {
+    currentImplementation = nextImplementation;
+    return mock;
+  };
+  mock.mockResolvedValue = (value) => {
+    currentImplementation = () => Promise.resolve(value);
+    return mock;
+  };
+  mock.mockReturnValue = (value) => {
+    currentImplementation = () => value;
+    return mock;
+  };
+  return mock;
+}
 function mockElectron() {
   const mocks = {
     ipcMain: {
-      handle: import_vitest.vi.fn(),
-      removeHandler: import_vitest.vi.fn(),
-      on: import_vitest.vi.fn()
+      handle: createMockFunction(),
+      removeHandler: createMockFunction(),
+      on: createMockFunction()
     },
     ipcRenderer: {
-      invoke: import_vitest.vi.fn().mockResolvedValue(void 0),
-      send: import_vitest.vi.fn(),
-      on: import_vitest.vi.fn(),
-      removeListener: import_vitest.vi.fn()
+      invoke: createMockFunction().mockResolvedValue(void 0),
+      send: createMockFunction(),
+      on: createMockFunction(),
+      removeListener: createMockFunction()
     },
-    BrowserWindow: import_vitest.vi.fn().mockImplementation(() => ({
-      loadURL: import_vitest.vi.fn().mockResolvedValue(void 0),
-      loadFile: import_vitest.vi.fn().mockResolvedValue(void 0),
+    BrowserWindow: createMockFunction().mockImplementation(() => ({
+      loadURL: createMockFunction().mockResolvedValue(void 0),
+      loadFile: createMockFunction().mockResolvedValue(void 0),
       webContents: {
-        send: import_vitest.vi.fn(),
-        reload: import_vitest.vi.fn(),
-        on: import_vitest.vi.fn()
+        send: createMockFunction(),
+        reload: createMockFunction(),
+        on: createMockFunction()
       },
-      on: import_vitest.vi.fn(),
-      once: import_vitest.vi.fn(),
-      close: import_vitest.vi.fn(),
-      focus: import_vitest.vi.fn(),
-      show: import_vitest.vi.fn(),
-      destroy: import_vitest.vi.fn(),
-      isDestroyed: import_vitest.vi.fn().mockReturnValue(false)
+      on: createMockFunction(),
+      once: createMockFunction(),
+      close: createMockFunction(),
+      focus: createMockFunction(),
+      show: createMockFunction(),
+      destroy: createMockFunction(),
+      isDestroyed: createMockFunction().mockReturnValue(false)
     })),
     app: {
-      getPath: import_vitest.vi.fn((name) => `/mock/${name}`),
-      on: import_vitest.vi.fn(),
-      once: import_vitest.vi.fn(),
-      whenReady: import_vitest.vi.fn().mockResolvedValue(void 0),
+      getPath: createMockFunction((name) => `/mock/${name}`),
+      on: createMockFunction(),
+      once: createMockFunction(),
+      whenReady: createMockFunction().mockResolvedValue(void 0),
       isPackaged: false,
-      quit: import_vitest.vi.fn()
+      quit: createMockFunction()
     },
     dialog: {
-      showOpenDialog: import_vitest.vi.fn().mockResolvedValue({ filePaths: [], canceled: false }),
-      showSaveDialog: import_vitest.vi.fn().mockResolvedValue({ filePath: "", canceled: false }),
-      showMessageBox: import_vitest.vi.fn().mockResolvedValue({ response: 0 })
+      showOpenDialog: createMockFunction().mockResolvedValue({ filePaths: [], canceled: false }),
+      showSaveDialog: createMockFunction().mockResolvedValue({ filePath: "", canceled: false }),
+      showMessageBox: createMockFunction().mockResolvedValue({ response: 0 })
     },
     shell: {
-      openExternal: import_vitest.vi.fn().mockResolvedValue(void 0),
-      openPath: import_vitest.vi.fn().mockResolvedValue("")
+      openExternal: createMockFunction().mockResolvedValue(void 0),
+      openPath: createMockFunction().mockResolvedValue("")
     },
     safeStorage: {
-      encryptString: import_vitest.vi.fn().mockReturnValue(Buffer.from("")),
-      decryptString: import_vitest.vi.fn().mockReturnValue(""),
-      isEncryptionAvailable: import_vitest.vi.fn().mockReturnValue(true)
+      encryptString: createMockFunction().mockReturnValue(Buffer.from("")),
+      decryptString: createMockFunction().mockReturnValue(""),
+      isEncryptionAvailable: createMockFunction().mockReturnValue(true)
     },
     nativeTheme: {
       shouldUseDarkColors: false,
-      on: import_vitest.vi.fn()
+      on: createMockFunction()
     },
     globalShortcut: {
-      register: import_vitest.vi.fn().mockReturnValue(true),
-      unregister: import_vitest.vi.fn(),
-      unregisterAll: import_vitest.vi.fn()
+      register: createMockFunction().mockReturnValue(true),
+      unregister: createMockFunction(),
+      unregisterAll: createMockFunction()
     },
     contextBridge: {
-      exposeInMainWorld: import_vitest.vi.fn()
+      exposeInMainWorld: createMockFunction()
     }
   };
   return mocks;

package/dist/testing/mock_electron.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/mock_electron.ts"],"sourcesContent":["import { vi } from 'vitest';\n\n/**\n * Comprehensive Electron mock for vitest.\n * Call this in your test setup or beforeAll.\n */\nexport function mockElectron(): Record<string, any> {\n  // This needs to be called with vi.mock in the test file itself\n  // because vi.mock is hoisted. This function returns the mock object.\n  const mocks = {\n    ipcMain: {\n      handle: vi.fn(),\n      removeHandler: vi.fn(),\n      on: vi.fn(),\n    },\n    ipcRenderer: {\n      invoke: vi.fn().mockResolvedValue(undefined),\n      send: vi.fn(),\n      on: vi.fn(),\n      removeListener: vi.fn(),\n    },\n    BrowserWindow: vi.fn().mockImplementation(() => ({\n      loadURL: vi.fn().mockResolvedValue(undefined),\n      loadFile: vi.fn().mockResolvedValue(undefined),\n      webContents: {\n        send: vi.fn(),\n        reload: vi.fn(),\n        on: vi.fn(),\n      },\n      on: vi.fn(),\n      once: vi.fn(),\n      close: vi.fn(),\n      focus: vi.fn(),\n      show: vi.fn(),\n      destroy: vi.fn(),\n      isDestroyed: vi.fn().mockReturnValue(false),\n    })),\n    app: {\n      getPath: vi.fn((name: string) => `/mock/${name}`),\n      on: vi.fn(),\n      once: vi.fn(),\n      whenReady: vi.fn().mockResolvedValue(undefined),\n      isPackaged: false,\n      quit: vi.fn(),\n    },\n    dialog: {\n      showOpenDialog: vi.fn().mockResolvedValue({ filePaths: [], canceled: false }),\n      showSaveDialog: vi.fn().mockResolvedValue({ filePath: '', canceled: false }),\n      showMessageBox: vi.fn().mockResolvedValue({ response: 0 }),\n    },\n    shell: {\n      openExternal: vi.fn().mockResolvedValue(undefined),\n      openPath: vi.fn().mockResolvedValue(''),\n    },\n    safeStorage: {\n      encryptString: vi.fn().mockReturnValue(Buffer.from('')),\n      decryptString: vi.fn().mockReturnValue(''),\n      isEncryptionAvailable: vi.fn().mockReturnValue(true),\n    },\n    nativeTheme: {\n      shouldUseDarkColors: false,\n      on: vi.fn(),\n    },\n    globalShortcut: {\n      register: vi.fn().mockReturnValue(true),\n      unregister: vi.fn(),\n      unregisterAll: vi.fn(),\n    },\n    contextBridge: {\n      exposeInMainWorld: vi.fn(),\n    },\n  };\n\n  return mocks;\n}\n\n/**\n * Get the vi.mock factory for Electron.\n * Usage: vi.mock('electron', () => getElectronMockFactory())\n */\nexport function getElectronMockFactory(): Record<string, any> {\n  return mockElectron();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAAmB;AAMZ,SAAS,eAAoC;AAGlD,QAAM,QAAQ;AAAA,IACZ,SAAS;AAAA,MACP,QAAQ,iBAAG,GAAG;AAAA,MACd,eAAe,iBAAG,GAAG;AAAA,MACrB,IAAI,iBAAG,GAAG;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,QAAQ,iBAAG,GAAG,EAAE,kBAAkB,MAAS;AAAA,MAC3C,MAAM,iBAAG,GAAG;AAAA,MACZ,IAAI,iBAAG,GAAG;AAAA,MACV,gBAAgB,iBAAG,GAAG;AAAA,IACxB;AAAA,IACA,eAAe,iBAAG,GAAG,EAAE,mBAAmB,OAAO;AAAA,MAC/C,SAAS,iBAAG,GAAG,EAAE,kBAAkB,MAAS;AAAA,MAC5C,UAAU,iBAAG,GAAG,EAAE,kBAAkB,MAAS;AAAA,MAC7C,aAAa;AAAA,QACX,MAAM,iBAAG,GAAG;AAAA,QACZ,QAAQ,iBAAG,GAAG;AAAA,QACd,IAAI,iBAAG,GAAG;AAAA,MACZ;AAAA,MACA,IAAI,iBAAG,GAAG;AAAA,MACV,MAAM,iBAAG,GAAG;AAAA,MACZ,OAAO,iBAAG,GAAG;AAAA,MACb,OAAO,iBAAG,GAAG;AAAA,MACb,MAAM,iBAAG,GAAG;AAAA,MACZ,SAAS,iBAAG,GAAG;AAAA,MACf,aAAa,iBAAG,GAAG,EAAE,gBAAgB,KAAK;AAAA,IAC5C,EAAE;AAAA,IACF,KAAK;AAAA,MACH,SAAS,iBAAG,GAAG,CAAC,SAAiB,SAAS,IAAI,EAAE;AAAA,MAChD,IAAI,iBAAG,GAAG;AAAA,MACV,MAAM,iBAAG,GAAG;AAAA,MACZ,WAAW,iBAAG,GAAG,EAAE,kBAAkB,MAAS;AAAA,MAC9C,YAAY;AAAA,MACZ,MAAM,iBAAG,GAAG;AAAA,IACd;AAAA,IACA,QAAQ;AAAA,MACN,gBAAgB,iBAAG,GAAG,EAAE,kBAAkB,EAAE,WAAW,CAAC,GAAG,UAAU,MAAM,CAAC;AAAA,MAC5E,gBAAgB,iBAAG,GAAG,EAAE,kBAAkB,EAAE,UAAU,IAAI,UAAU,MAAM,CAAC;AAAA,MAC3E,gBAAgB,iBAAG,GAAG,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAC;AAAA,IAC3D;AAAA,IACA,OAAO;AAAA,MACL,cAAc,iBAAG,GAAG,EAAE,kBAAkB,MAAS;AAAA,MACjD,UAAU,iBAAG,GAAG,EAAE,kBAAkB,EAAE;AAAA,IACxC;AAAA,IACA,aAAa;AAAA,MACX,eAAe,iBAAG,GAAG,EAAE,gBAAgB,OAAO,KAAK,EAAE,CAAC;AAAA,MACtD,eAAe,iBAAG,GAAG,EAAE,gBAAgB,EAAE;AAAA,MACzC,uBAAuB,iBAAG,GAAG,EAAE,gBAAgB,IAAI;AAAA,IACrD;AAAA,IACA,aAAa;AAAA,MACX,qBAAqB;AAAA,MACrB,IAAI,iBAAG,GAAG;AAAA,IACZ;AAAA,IACA,gBAAgB;AAAA,MACd,UAAU,iBAAG,GAAG,EAAE,gBAAgB,IAAI;AAAA,MACtC,YAAY,iBAAG,GAAG;AAAA,MAClB,eAAe,iBAAG,GAAG;AAAA,IACvB;AAAA,IACA,eAAe;AAAA,MACb,mBAAmB,iBAAG,GAAG;AAAA,IAC3B;AAAA,EACF;AAEA,SAAO;AACT;AAMO,SAAS,yBAA8C;AAC5D,SAAO,aAAa;AACtB;","names":[]}
+{"version":3,"sources":["../../src/testing/mock_electron.ts"],"sourcesContent":["type MockFunction = ((...args: any[]) => any) & {\n  calls: any[][];\n  mockImplementation: (implementation: (...args: any[]) => any) => MockFunction;\n  mockResolvedValue: (value: any) => MockFunction;\n  mockReturnValue: (value: any) => MockFunction;\n};\n\nfunction createMockFunction(implementation?: (...args: any[]) => any): MockFunction {\n  let currentImplementation = implementation ?? (() => undefined);\n  const mock = ((...args: any[]) => {\n    mock.calls.push(args);\n    return currentImplementation(...args);\n  }) as MockFunction;\n  mock.calls = [];\n  mock.mockImplementation = (nextImplementation: (...args: any[]) => any) => {\n    currentImplementation = nextImplementation;\n    return mock;\n  };\n  mock.mockResolvedValue = (value: any) => {\n    currentImplementation = () => Promise.resolve(value);\n    return mock;\n  };\n  mock.mockReturnValue = (value: any) => {\n    currentImplementation = () => value;\n    return mock;\n  };\n  return mock;\n}\n\n/**\n * Comprehensive Electron mock for tests.\n * Call this in your test setup or beforeAll.\n */\nexport function mockElectron(): Record<string, any> {\n  // This returns the mock object for use with a test runner's module mock factory.\n  const mocks = {\n    ipcMain: {\n      handle: createMockFunction(),\n      removeHandler: createMockFunction(),\n      on: createMockFunction(),\n    },\n    ipcRenderer: {\n      invoke: createMockFunction().mockResolvedValue(undefined),\n      send: createMockFunction(),\n      on: createMockFunction(),\n      removeListener: createMockFunction(),\n    },\n    BrowserWindow: createMockFunction().mockImplementation(() => ({\n      loadURL: createMockFunction().mockResolvedValue(undefined),\n      loadFile: createMockFunction().mockResolvedValue(undefined),\n      webContents: {\n        send: createMockFunction(),\n        reload: createMockFunction(),\n        on: createMockFunction(),\n      },\n      on: createMockFunction(),\n      once: createMockFunction(),\n      close: createMockFunction(),\n      focus: createMockFunction(),\n      show: createMockFunction(),\n      destroy: createMockFunction(),\n      isDestroyed: createMockFunction().mockReturnValue(false),\n    })),\n    app: {\n      getPath: createMockFunction((name: string) => `/mock/${name}`),\n      on: createMockFunction(),\n      once: createMockFunction(),\n      whenReady: createMockFunction().mockResolvedValue(undefined),\n      isPackaged: false,\n      quit: createMockFunction(),\n    },\n    dialog: {\n      showOpenDialog: createMockFunction().mockResolvedValue({ filePaths: [], canceled: false }),\n      showSaveDialog: createMockFunction().mockResolvedValue({ filePath: '', canceled: false }),\n      showMessageBox: createMockFunction().mockResolvedValue({ response: 0 }),\n    },\n    shell: {\n      openExternal: createMockFunction().mockResolvedValue(undefined),\n      openPath: createMockFunction().mockResolvedValue(''),\n    },\n    safeStorage: {\n      encryptString: createMockFunction().mockReturnValue(Buffer.from('')),\n      decryptString: createMockFunction().mockReturnValue(''),\n      isEncryptionAvailable: createMockFunction().mockReturnValue(true),\n    },\n    nativeTheme: {\n      shouldUseDarkColors: false,\n      on: createMockFunction(),\n    },\n    globalShortcut: {\n      register: createMockFunction().mockReturnValue(true),\n      unregister: createMockFunction(),\n      unregisterAll: createMockFunction(),\n    },\n    contextBridge: {\n      exposeInMainWorld: createMockFunction(),\n    },\n  };\n\n  return mocks;\n}\n\n/**\n * Get a module mock factory for Electron.\n * Usage: vi.mock('electron', () => getElectronMockFactory())\n */\nexport function getElectronMockFactory(): Record<string, any> {\n  return mockElectron();\n}\n"],"mappings":"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","names":[]}

package/dist/testing/mock_electron.d.cts

@@ -1,10 +1,10 @@
 /**
- * Comprehensive Electron mock for vitest.
+ * Comprehensive Electron mock for tests.
  * Call this in your test setup or beforeAll.
  */
 declare function mockElectron(): Record<string, any>;
 /**
- * Get the vi.mock factory for Electron.
+ * Get a module mock factory for Electron.
  * Usage: vi.mock('electron', () => getElectronMockFactory())
  */
 declare function getElectronMockFactory(): Record<string, any>;

package/dist/testing/mock_electron.d.ts

@@ -1,10 +1,10 @@
 /**
- * Comprehensive Electron mock for vitest.
+ * Comprehensive Electron mock for tests.
  * Call this in your test setup or beforeAll.
  */
 declare function mockElectron(): Record<string, any>;
 /**
- * Get the vi.mock factory for Electron.
+ * Get a module mock factory for Electron.
  * Usage: vi.mock('electron', () => getElectronMockFactory())
  */
 declare function getElectronMockFactory(): Record<string, any>;

package/dist/testing/mock_electron.js

@@ -1,66 +1,86 @@
-import { vi } from "vitest";
+function createMockFunction(implementation) {
+  let currentImplementation = implementation ?? (() => void 0);
+  const mock = ((...args) => {
+    mock.calls.push(args);
+    return currentImplementation(...args);
+  });
+  mock.calls = [];
+  mock.mockImplementation = (nextImplementation) => {
+    currentImplementation = nextImplementation;
+    return mock;
+  };
+  mock.mockResolvedValue = (value) => {
+    currentImplementation = () => Promise.resolve(value);
+    return mock;
+  };
+  mock.mockReturnValue = (value) => {
+    currentImplementation = () => value;
+    return mock;
+  };
+  return mock;
+}
 function mockElectron() {
   const mocks = {
     ipcMain: {
-      handle: vi.fn(),
-      removeHandler: vi.fn(),
-      on: vi.fn()
+      handle: createMockFunction(),
+      removeHandler: createMockFunction(),
+      on: createMockFunction()
     },
     ipcRenderer: {
-      invoke: vi.fn().mockResolvedValue(void 0),
-      send: vi.fn(),
-      on: vi.fn(),
-      removeListener: vi.fn()
+      invoke: createMockFunction().mockResolvedValue(void 0),
+      send: createMockFunction(),
+      on: createMockFunction(),
+      removeListener: createMockFunction()
     },
-    BrowserWindow: vi.fn().mockImplementation(() => ({
-      loadURL: vi.fn().mockResolvedValue(void 0),
-      loadFile: vi.fn().mockResolvedValue(void 0),
+    BrowserWindow: createMockFunction().mockImplementation(() => ({
+      loadURL: createMockFunction().mockResolvedValue(void 0),
+      loadFile: createMockFunction().mockResolvedValue(void 0),
       webContents: {
-        send: vi.fn(),
-        reload: vi.fn(),
-        on: vi.fn()
+        send: createMockFunction(),
+        reload: createMockFunction(),
+        on: createMockFunction()
       },
-      on: vi.fn(),
-      once: vi.fn(),
-      close: vi.fn(),
-      focus: vi.fn(),
-      show: vi.fn(),
-      destroy: vi.fn(),
-      isDestroyed: vi.fn().mockReturnValue(false)
+      on: createMockFunction(),
+      once: createMockFunction(),
+      close: createMockFunction(),
+      focus: createMockFunction(),
+      show: createMockFunction(),
+      destroy: createMockFunction(),
+      isDestroyed: createMockFunction().mockReturnValue(false)
     })),
     app: {
-      getPath: vi.fn((name) => `/mock/${name}`),
-      on: vi.fn(),
-      once: vi.fn(),
-      whenReady: vi.fn().mockResolvedValue(void 0),
+      getPath: createMockFunction((name) => `/mock/${name}`),
+      on: createMockFunction(),
+      once: createMockFunction(),
+      whenReady: createMockFunction().mockResolvedValue(void 0),
       isPackaged: false,
-      quit: vi.fn()
+      quit: createMockFunction()
     },
     dialog: {
-      showOpenDialog: vi.fn().mockResolvedValue({ filePaths: [], canceled: false }),
-      showSaveDialog: vi.fn().mockResolvedValue({ filePath: "", canceled: false }),
-      showMessageBox: vi.fn().mockResolvedValue({ response: 0 })
+      showOpenDialog: createMockFunction().mockResolvedValue({ filePaths: [], canceled: false }),
+      showSaveDialog: createMockFunction().mockResolvedValue({ filePath: "", canceled: false }),
+      showMessageBox: createMockFunction().mockResolvedValue({ response: 0 })
     },
     shell: {
-      openExternal: vi.fn().mockResolvedValue(void 0),
-      openPath: vi.fn().mockResolvedValue("")
+      openExternal: createMockFunction().mockResolvedValue(void 0),
+      openPath: createMockFunction().mockResolvedValue("")
     },
     safeStorage: {
-      encryptString: vi.fn().mockReturnValue(Buffer.from("")),
-      decryptString: vi.fn().mockReturnValue(""),
-      isEncryptionAvailable: vi.fn().mockReturnValue(true)
+      encryptString: createMockFunction().mockReturnValue(Buffer.from("")),
+      decryptString: createMockFunction().mockReturnValue(""),
+      isEncryptionAvailable: createMockFunction().mockReturnValue(true)
     },
     nativeTheme: {
       shouldUseDarkColors: false,
-      on: vi.fn()
+      on: createMockFunction()
     },
     globalShortcut: {
-      register: vi.fn().mockReturnValue(true),
-      unregister: vi.fn(),
-      unregisterAll: vi.fn()
+      register: createMockFunction().mockReturnValue(true),
+      unregister: createMockFunction(),
+      unregisterAll: createMockFunction()
     },
     contextBridge: {
-      exposeInMainWorld: vi.fn()
+      exposeInMainWorld: createMockFunction()
     }
   };
   return mocks;

package/dist/testing/mock_electron.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/mock_electron.ts"],"sourcesContent":["import { vi } from 'vitest';\n\n/**\n * Comprehensive Electron mock for vitest.\n * Call this in your test setup or beforeAll.\n */\nexport function mockElectron(): Record<string, any> {\n  // This needs to be called with vi.mock in the test file itself\n  // because vi.mock is hoisted. This function returns the mock object.\n  const mocks = {\n    ipcMain: {\n      handle: vi.fn(),\n      removeHandler: vi.fn(),\n      on: vi.fn(),\n    },\n    ipcRenderer: {\n      invoke: vi.fn().mockResolvedValue(undefined),\n      send: vi.fn(),\n      on: vi.fn(),\n      removeListener: vi.fn(),\n    },\n    BrowserWindow: vi.fn().mockImplementation(() => ({\n      loadURL: vi.fn().mockResolvedValue(undefined),\n      loadFile: vi.fn().mockResolvedValue(undefined),\n      webContents: {\n        send: vi.fn(),\n        reload: vi.fn(),\n        on: vi.fn(),\n      },\n      on: vi.fn(),\n      once: vi.fn(),\n      close: vi.fn(),\n      focus: vi.fn(),\n      show: vi.fn(),\n      destroy: vi.fn(),\n      isDestroyed: vi.fn().mockReturnValue(false),\n    })),\n    app: {\n      getPath: vi.fn((name: string) => `/mock/${name}`),\n      on: vi.fn(),\n      once: vi.fn(),\n      whenReady: vi.fn().mockResolvedValue(undefined),\n      isPackaged: false,\n      quit: vi.fn(),\n    },\n    dialog: {\n      showOpenDialog: vi.fn().mockResolvedValue({ filePaths: [], canceled: false }),\n      showSaveDialog: vi.fn().mockResolvedValue({ filePath: '', canceled: false }),\n      showMessageBox: vi.fn().mockResolvedValue({ response: 0 }),\n    },\n    shell: {\n      openExternal: vi.fn().mockResolvedValue(undefined),\n      openPath: vi.fn().mockResolvedValue(''),\n    },\n    safeStorage: {\n      encryptString: vi.fn().mockReturnValue(Buffer.from('')),\n      decryptString: vi.fn().mockReturnValue(''),\n      isEncryptionAvailable: vi.fn().mockReturnValue(true),\n    },\n    nativeTheme: {\n      shouldUseDarkColors: false,\n      on: vi.fn(),\n    },\n    globalShortcut: {\n      register: vi.fn().mockReturnValue(true),\n      unregister: vi.fn(),\n      unregisterAll: vi.fn(),\n    },\n    contextBridge: {\n      exposeInMainWorld: vi.fn(),\n    },\n  };\n\n  return mocks;\n}\n\n/**\n * Get the vi.mock factory for Electron.\n * Usage: vi.mock('electron', () => getElectronMockFactory())\n */\nexport function getElectronMockFactory(): Record<string, any> {\n  return mockElectron();\n}\n"],"mappings":"AAAA,SAAS,UAAU;AAMZ,SAAS,eAAoC;AAGlD,QAAM,QAAQ;AAAA,IACZ,SAAS;AAAA,MACP,QAAQ,GAAG,GAAG;AAAA,MACd,eAAe,GAAG,GAAG;AAAA,MACrB,IAAI,GAAG,GAAG;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,QAAQ,GAAG,GAAG,EAAE,kBAAkB,MAAS;AAAA,MAC3C,MAAM,GAAG,GAAG;AAAA,MACZ,IAAI,GAAG,GAAG;AAAA,MACV,gBAAgB,GAAG,GAAG;AAAA,IACxB;AAAA,IACA,eAAe,GAAG,GAAG,EAAE,mBAAmB,OAAO;AAAA,MAC/C,SAAS,GAAG,GAAG,EAAE,kBAAkB,MAAS;AAAA,MAC5C,UAAU,GAAG,GAAG,EAAE,kBAAkB,MAAS;AAAA,MAC7C,aAAa;AAAA,QACX,MAAM,GAAG,GAAG;AAAA,QACZ,QAAQ,GAAG,GAAG;AAAA,QACd,IAAI,GAAG,GAAG;AAAA,MACZ;AAAA,MACA,IAAI,GAAG,GAAG;AAAA,MACV,MAAM,GAAG,GAAG;AAAA,MACZ,OAAO,GAAG,GAAG;AAAA,MACb,OAAO,GAAG,GAAG;AAAA,MACb,MAAM,GAAG,GAAG;AAAA,MACZ,SAAS,GAAG,GAAG;AAAA,MACf,aAAa,GAAG,GAAG,EAAE,gBAAgB,KAAK;AAAA,IAC5C,EAAE;AAAA,IACF,KAAK;AAAA,MACH,SAAS,GAAG,GAAG,CAAC,SAAiB,SAAS,IAAI,EAAE;AAAA,MAChD,IAAI,GAAG,GAAG;AAAA,MACV,MAAM,GAAG,GAAG;AAAA,MACZ,WAAW,GAAG,GAAG,EAAE,kBAAkB,MAAS;AAAA,MAC9C,YAAY;AAAA,MACZ,MAAM,GAAG,GAAG;AAAA,IACd;AAAA,IACA,QAAQ;AAAA,MACN,gBAAgB,GAAG,GAAG,EAAE,kBAAkB,EAAE,WAAW,CAAC,GAAG,UAAU,MAAM,CAAC;AAAA,MAC5E,gBAAgB,GAAG,GAAG,EAAE,kBAAkB,EAAE,UAAU,IAAI,UAAU,MAAM,CAAC;AAAA,MAC3E,gBAAgB,GAAG,GAAG,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAC;AAAA,IAC3D;AAAA,IACA,OAAO;AAAA,MACL,cAAc,GAAG,GAAG,EAAE,kBAAkB,MAAS;AAAA,MACjD,UAAU,GAAG,GAAG,EAAE,kBAAkB,EAAE;AAAA,IACxC;AAAA,IACA,aAAa;AAAA,MACX,eAAe,GAAG,GAAG,EAAE,gBAAgB,OAAO,KAAK,EAAE,CAAC;AAAA,MACtD,eAAe,GAAG,GAAG,EAAE,gBAAgB,EAAE;AAAA,MACzC,uBAAuB,GAAG,GAAG,EAAE,gBAAgB,IAAI;AAAA,IACrD;AAAA,IACA,aAAa;AAAA,MACX,qBAAqB;AAAA,MACrB,IAAI,GAAG,GAAG;AAAA,IACZ;AAAA,IACA,gBAAgB;AAAA,MACd,UAAU,GAAG,GAAG,EAAE,gBAAgB,IAAI;AAAA,MACtC,YAAY,GAAG,GAAG;AAAA,MAClB,eAAe,GAAG,GAAG;AAAA,IACvB;AAAA,IACA,eAAe;AAAA,MACb,mBAAmB,GAAG,GAAG;AAAA,IAC3B;AAAA,EACF;AAEA,SAAO;AACT;AAMO,SAAS,yBAA8C;AAC5D,SAAO,aAAa;AACtB;","names":[]}
+{"version":3,"sources":["../../src/testing/mock_electron.ts"],"sourcesContent":["type MockFunction = ((...args: any[]) => any) & {\n  calls: any[][];\n  mockImplementation: (implementation: (...args: any[]) => any) => MockFunction;\n  mockResolvedValue: (value: any) => MockFunction;\n  mockReturnValue: (value: any) => MockFunction;\n};\n\nfunction createMockFunction(implementation?: (...args: any[]) => any): MockFunction {\n  let currentImplementation = implementation ?? (() => undefined);\n  const mock = ((...args: any[]) => {\n    mock.calls.push(args);\n    return currentImplementation(...args);\n  }) as MockFunction;\n  mock.calls = [];\n  mock.mockImplementation = (nextImplementation: (...args: any[]) => any) => {\n    currentImplementation = nextImplementation;\n    return mock;\n  };\n  mock.mockResolvedValue = (value: any) => {\n    currentImplementation = () => Promise.resolve(value);\n    return mock;\n  };\n  mock.mockReturnValue = (value: any) => {\n    currentImplementation = () => value;\n    return mock;\n  };\n  return mock;\n}\n\n/**\n * Comprehensive Electron mock for tests.\n * Call this in your test setup or beforeAll.\n */\nexport function mockElectron(): Record<string, any> {\n  // This returns the mock object for use with a test runner's module mock factory.\n  const mocks = {\n    ipcMain: {\n      handle: createMockFunction(),\n      removeHandler: createMockFunction(),\n      on: createMockFunction(),\n    },\n    ipcRenderer: {\n      invoke: createMockFunction().mockResolvedValue(undefined),\n      send: createMockFunction(),\n      on: createMockFunction(),\n      removeListener: createMockFunction(),\n    },\n    BrowserWindow: createMockFunction().mockImplementation(() => ({\n      loadURL: createMockFunction().mockResolvedValue(undefined),\n      loadFile: createMockFunction().mockResolvedValue(undefined),\n      webContents: {\n        send: createMockFunction(),\n        reload: createMockFunction(),\n        on: createMockFunction(),\n      },\n      on: createMockFunction(),\n      once: createMockFunction(),\n      close: createMockFunction(),\n      focus: createMockFunction(),\n      show: createMockFunction(),\n      destroy: createMockFunction(),\n      isDestroyed: createMockFunction().mockReturnValue(false),\n    })),\n    app: {\n      getPath: createMockFunction((name: string) => `/mock/${name}`),\n      on: createMockFunction(),\n      once: createMockFunction(),\n      whenReady: createMockFunction().mockResolvedValue(undefined),\n      isPackaged: false,\n      quit: createMockFunction(),\n    },\n    dialog: {\n      showOpenDialog: createMockFunction().mockResolvedValue({ filePaths: [], canceled: false }),\n      showSaveDialog: createMockFunction().mockResolvedValue({ filePath: '', canceled: false }),\n      showMessageBox: createMockFunction().mockResolvedValue({ response: 0 }),\n    },\n    shell: {\n      openExternal: createMockFunction().mockResolvedValue(undefined),\n      openPath: createMockFunction().mockResolvedValue(''),\n    },\n    safeStorage: {\n      encryptString: createMockFunction().mockReturnValue(Buffer.from('')),\n      decryptString: createMockFunction().mockReturnValue(''),\n      isEncryptionAvailable: createMockFunction().mockReturnValue(true),\n    },\n    nativeTheme: {\n      shouldUseDarkColors: false,\n      on: createMockFunction(),\n    },\n    globalShortcut: {\n      register: createMockFunction().mockReturnValue(true),\n      unregister: createMockFunction(),\n      unregisterAll: createMockFunction(),\n    },\n    contextBridge: {\n      exposeInMainWorld: createMockFunction(),\n    },\n  };\n\n  return mocks;\n}\n\n/**\n * Get a module mock factory for Electron.\n * Usage: vi.mock('electron', () => getElectronMockFactory())\n */\nexport function getElectronMockFactory(): Record<string, any> {\n  return mockElectron();\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noego/wood",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",