@noego/wood 0.1.0 → 0.1.2

package/dist/client/index.cjs

@@ -418,9 +418,12 @@ async function startWood(mountRoot, target) {
     const bridge = resolveWoodBridge();
     if (typeof bridge.__woodConfig === "function") {
       const config = await bridge.__woodConfig();
-      const level = config?.traceMinLevel;
+      const traceConfiguration = container.instance ? await container.instance(import_tracing.TraceProviderConfiguration) : null;
+      if (typeof config?.rendererTraceEnabled === "boolean") {
+        traceConfiguration?.configureEnabled(config.rendererTraceEnabled);
+      }
+      const level = config?.rendererTraceMinLevel;
       if (level === "debug" || level === "info" || level === "warn" || level === "error") {
-        const traceConfiguration = container.instance ? await container.instance(import_tracing.TraceProviderConfiguration) : null;
         traceConfiguration?.configureMinLevel(level);
       }
     }

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 trace min level\n  // before the first render so no sub-threshold events cross IPC.\n  try {\n    const bridge = resolveWoodBridge();\n    if (typeof bridge.__woodConfig === 'function') {\n      const config = await bridge.__woodConfig() as { traceMinLevel?: string } | null;\n      const level = config?.traceMinLevel;\n      if (level === 'debug' || level === 'info' || level === 'warn' || level === 'error') {\n        const traceConfiguration = container.instance\n          ? await container.instance(TraceProviderConfiguration)\n          : null;\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';\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"]}

package/dist/client/index.js

@@ -382,9 +382,12 @@ async function startWood(mountRoot, target) {
     const bridge = resolveWoodBridge();
     if (typeof bridge.__woodConfig === "function") {
       const config = await bridge.__woodConfig();
-      const level = config?.traceMinLevel;
+      const traceConfiguration = container.instance ? await container.instance(TraceProviderConfiguration) : null;
+      if (typeof config?.rendererTraceEnabled === "boolean") {
+        traceConfiguration?.configureEnabled(config.rendererTraceEnabled);
+      }
+      const level = config?.rendererTraceMinLevel;
       if (level === "debug" || level === "info" || level === "warn" || level === "error") {
-        const traceConfiguration = container.instance ? await container.instance(TraceProviderConfiguration) : null;
         traceConfiguration?.configureMinLevel(level);
       }
     }

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 trace min level\n  // before the first render so no sub-threshold events cross IPC.\n  try {\n    const bridge = resolveWoodBridge();\n    if (typeof bridge.__woodConfig === 'function') {\n      const config = await bridge.__woodConfig() as { traceMinLevel?: string } | null;\n      const level = config?.traceMinLevel;\n      if (level === 'debug' || level === 'info' || level === 'warn' || level === 'error') {\n        const traceConfiguration = container.instance\n          ? await container.instance(TraceProviderConfiguration)\n          : null;\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"]}
+{"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":"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","names":["TraceProviderConfiguration"]}

package/dist/controller/controller_lifecycle.cjs

@@ -28,6 +28,10 @@ async function disposeControllerLifecycle(target) {
   const lifecycle = target;
   if (typeof lifecycle.dispose === "function") {
     await lifecycle.dispose();
+    return;
+  }
+  if (typeof lifecycle.destroy === "function") {
+    await lifecycle.destroy();
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/controller/controller_lifecycle.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controller/controller_lifecycle.ts"],"sourcesContent":["export interface ControllerLifecycle {\n  dispose?(): void | Promise<void>;\n}\n\n/**\n * Dispose a controller or controller-like instance if it exposes a lifecycle\n * hook.\n */\nexport async function disposeControllerLifecycle(target: unknown): Promise<void> {\n  if (!target || (typeof target !== 'object' && typeof target !== 'function')) {\n    return;\n  }\n\n  const lifecycle = target as ControllerLifecycle;\n  if (typeof lifecycle.dispose === 'function') {\n    await lifecycle.dispose();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,eAAsB,2BAA2B,QAAgC;AAC/E,MAAI,CAAC,UAAW,OAAO,WAAW,YAAY,OAAO,WAAW,YAAa;AAC3E;AAAA,EACF;AAEA,QAAM,YAAY;AAClB,MAAI,OAAO,UAAU,YAAY,YAAY;AAC3C,UAAM,UAAU,QAAQ;AAAA,EAC1B;AACF;","names":[]}
+{"version":3,"sources":["../../src/controller/controller_lifecycle.ts"],"sourcesContent":["export interface ControllerLifecycle {\n  dispose?(): void | Promise<void>;\n  destroy?(): void | Promise<void>;\n}\n\n/**\n * Dispose a controller or controller-like instance if it exposes a lifecycle\n * hook. `dispose` is the preferred Wood lifecycle name; `destroy` is supported\n * for existing page controllers.\n */\nexport async function disposeControllerLifecycle(target: unknown): Promise<void> {\n  if (!target || (typeof target !== 'object' && typeof target !== 'function')) {\n    return;\n  }\n\n  const lifecycle = target as ControllerLifecycle;\n  if (typeof lifecycle.dispose === 'function') {\n    await lifecycle.dispose();\n    return;\n  }\n  if (typeof lifecycle.destroy === 'function') {\n    await lifecycle.destroy();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAUA,eAAsB,2BAA2B,QAAgC;AAC/E,MAAI,CAAC,UAAW,OAAO,WAAW,YAAY,OAAO,WAAW,YAAa;AAC3E;AAAA,EACF;AAEA,QAAM,YAAY;AAClB,MAAI,OAAO,UAAU,YAAY,YAAY;AAC3C,UAAM,UAAU,QAAQ;AACxB;AAAA,EACF;AACA,MAAI,OAAO,UAAU,YAAY,YAAY;AAC3C,UAAM,UAAU,QAAQ;AAAA,EAC1B;AACF;","names":[]}

package/dist/controller/controller_lifecycle.d.cts

@@ -1,9 +1,11 @@
 interface ControllerLifecycle {
     dispose?(): void | Promise<void>;
+    destroy?(): void | Promise<void>;
 }
 /**
  * Dispose a controller or controller-like instance if it exposes a lifecycle
- * hook.
+ * hook. `dispose` is the preferred Wood lifecycle name; `destroy` is supported
+ * for existing page controllers.
  */
 declare function disposeControllerLifecycle(target: unknown): Promise<void>;
 

package/dist/controller/controller_lifecycle.d.ts

@@ -1,9 +1,11 @@
 interface ControllerLifecycle {
     dispose?(): void | Promise<void>;
+    destroy?(): void | Promise<void>;
 }
 /**
  * Dispose a controller or controller-like instance if it exposes a lifecycle
- * hook.
+ * hook. `dispose` is the preferred Wood lifecycle name; `destroy` is supported
+ * for existing page controllers.
  */
 declare function disposeControllerLifecycle(target: unknown): Promise<void>;
 

package/dist/controller/controller_lifecycle.js

@@ -5,6 +5,10 @@ async function disposeControllerLifecycle(target) {
   const lifecycle = target;
   if (typeof lifecycle.dispose === "function") {
     await lifecycle.dispose();
+    return;
+  }
+  if (typeof lifecycle.destroy === "function") {
+    await lifecycle.destroy();
   }
 }
 export {

package/dist/controller/controller_lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controller/controller_lifecycle.ts"],"sourcesContent":["export interface ControllerLifecycle {\n  dispose?(): void | Promise<void>;\n}\n\n/**\n * Dispose a controller or controller-like instance if it exposes a lifecycle\n * hook.\n */\nexport async function disposeControllerLifecycle(target: unknown): Promise<void> {\n  if (!target || (typeof target !== 'object' && typeof target !== 'function')) {\n    return;\n  }\n\n  const lifecycle = target as ControllerLifecycle;\n  if (typeof lifecycle.dispose === 'function') {\n    await lifecycle.dispose();\n  }\n}\n"],"mappings":"AAQA,eAAsB,2BAA2B,QAAgC;AAC/E,MAAI,CAAC,UAAW,OAAO,WAAW,YAAY,OAAO,WAAW,YAAa;AAC3E;AAAA,EACF;AAEA,QAAM,YAAY;AAClB,MAAI,OAAO,UAAU,YAAY,YAAY;AAC3C,UAAM,UAAU,QAAQ;AAAA,EAC1B;AACF;","names":[]}
+{"version":3,"sources":["../../src/controller/controller_lifecycle.ts"],"sourcesContent":["export interface ControllerLifecycle {\n  dispose?(): void | Promise<void>;\n  destroy?(): void | Promise<void>;\n}\n\n/**\n * Dispose a controller or controller-like instance if it exposes a lifecycle\n * hook. `dispose` is the preferred Wood lifecycle name; `destroy` is supported\n * for existing page controllers.\n */\nexport async function disposeControllerLifecycle(target: unknown): Promise<void> {\n  if (!target || (typeof target !== 'object' && typeof target !== 'function')) {\n    return;\n  }\n\n  const lifecycle = target as ControllerLifecycle;\n  if (typeof lifecycle.dispose === 'function') {\n    await lifecycle.dispose();\n    return;\n  }\n  if (typeof lifecycle.destroy === 'function') {\n    await lifecycle.destroy();\n  }\n}\n"],"mappings":"AAUA,eAAsB,2BAA2B,QAAgC;AAC/E,MAAI,CAAC,UAAW,OAAO,WAAW,YAAY,OAAO,WAAW,YAAa;AAC3E;AAAA,EACF;AAEA,QAAM,YAAY;AAClB,MAAI,OAAO,UAAU,YAAY,YAAY;AAC3C,UAAM,UAAU,QAAQ;AACxB;AAAA,EACF;AACA,MAAI,OAAO,UAAU,YAAY,YAAY;AAC3C,UAAM,UAAU,QAAQ;AAAA,EAC1B;AACF;","names":[]}

package/dist/index.cjs

@@ -81,6 +81,7 @@ __export(index_exports, {
   resolveWoodRemoteDebuggingPort: () => import_dev.resolveWoodRemoteDebuggingPort,
   runtime: () => import_runtime.runtime,
   setApplicationRoot: () => import_runtime.setApplicationRoot,
+  setRendererTraceEnabled: () => import_tracing.setRendererTraceEnabled,
   setRendererTraceTransport: () => import_tracing.setRendererTraceTransport,
   startBackendLoop: () => import_bridge.startBackendLoop,
   writeWoodDevMetadata: () => import_dev.writeWoodDevMetadata
@@ -175,6 +176,7 @@ var import_tracing = require("./tracing/index.js");
   resolveWoodRemoteDebuggingPort,
   runtime,
   setApplicationRoot,
+  setRendererTraceEnabled,
   setRendererTraceTransport,
   startBackendLoop,
   writeWoodDevMetadata

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @noego/wood — Declarative Electron desktop apps using the noego ecosystem\n\n// Types\nexport type {\n  WoodConfig,\n  WindowDef,\n  DevConfig,\n  ElectronBuilderConfig,\n  OperationDef,\n  RawOperationsDocument,\n  RawModuleDef,\n  RawOperationEntry,\n  RawModuleOperationEntry,\n  ViewDef,\n  RawViewsDocument,\n  RawViewEntry,\n  ParameterDef,\n  IpcContext,\n  WoodMiddlewareContext,\n  WoodMiddlewareFn,\n  RequestData,\n  ControllerArgs,\n  LoaderResult,\n  BridgeMessage,\n  BridgeRequest,\n  BridgeResponse,\n  BridgeReady,\n  BridgePush,\n  BridgeElectronApi,\n  SerializedError,\n  ContextMenuContext,\n  ContextMenuItem,\n  ContextMenuEvent,\n} from './types';\n\n// Errors\nexport { WoodAuthError, WoodValidationError, BackendRestartingError } from './types/index.cjs';\n\n// Config\nexport { parseConfig } from './config/index.cjs';\n\n// Parsers\nexport { parseOperations, parseOperationsFile } from './parser/index.cjs';\nexport { parseViews, parseViewsFile } from './parser/index.cjs';\n\n// Router\nexport { WoodRouter } from './router/index.cjs';\n\n// Validation\nexport { SchemaValidator } from './validation/index.cjs';\n\n// Middleware\nexport { MiddlewareResolver, buildMiddlewareContext, executeMiddleware } from './middleware/index.cjs';\n\n// Controller\nexport { ControllerResolver, buildControllerArgs, disposeControllerLifecycle } from './controller/index.cjs';\nexport type { ControllerLifecycle } from './controller/index.cjs';\n\n// Codegen\nexport { generatePreload } from './codegen/index.cjs';\nexport { generateTypes } from './codegen/index.cjs';\nexport { generateTestMock } from './codegen/index.cjs';\nexport { generateControllerRegistration } from './codegen/index.cjs';\nexport type { ControllerRegistrationOptions } from './codegen/index.cjs';\nexport { generateRuntime } from './codegen/index.cjs';\nexport type { RuntimeGeneratorOptions } from './codegen/index.cjs';\nexport { generateRendererViewManifest } from './codegen/index.cjs';\nexport type { RendererViewManifestGeneratorOptions } from './codegen/index.cjs';\nexport { generateRendererControllerRegistration } from './codegen/index.cjs';\nexport type { RendererControllerRegistrationOptions } from './codegen/index.cjs';\nexport { generateRendererApp } from './codegen/index.cjs';\nexport type { RendererAppGeneratorOptions } from './codegen/index.cjs';\n\n// Window\nexport { WindowManager, WindowStateStore } from './window/index.cjs';\nexport type { ScreenLike, WindowBounds } from './window/index.cjs';\n\n// Loader\nexport { LoaderRunner } from './loader/index.cjs';\n\n// Bridge\nexport { BackendBridge, startBackendLoop, pushEvent } from './bridge/index.cjs';\n\n// Dev\nexport {\n  WoodDevServer,\n  BackendWatcher,\n  YamlWatcher,\n  DEFAULT_WOOD_REMOTE_DEBUGGING_PORT,\n  WOOD_DEV_DIRECTORY,\n  WOOD_DEV_METADATA_BASENAME,\n  resolveWoodRemoteDebuggingPort,\n  resolveWoodDevDirectory,\n  resolveWoodDevMetadataPath,\n  writeWoodDevMetadata,\n  readWoodDevMetadata,\n  removeWoodDevMetadata,\n} from './dev/index.js';\nexport type { WoodDevMetadata } from './dev/index.js';\n\n// Runtime\nexport {\n  getContainer,\n  clearContainerRegistryForTests,\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n  runtime,\n} from './runtime/index.js';\nexport type {\n  GetContainerOptions,\n  RuntimeOptions,\n  RuntimeResult,\n  RegisterRuntimeRouter,\n} from './runtime';\n\n// Navigation\nexport { Navigation, getNavigation, go, goto, goback } from './navigation/index.cjs';\nexport type { NavigationEntry } from './navigation/index.cjs';\n\n// Isomorphic IPC API\nexport { Ipc, getIpc } from './ipc/index.cjs';\nexport type { IpcPushOptions } from './ipc/index.cjs';\n\n// Tracing\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\n  TraceCapture,\n  clearTraceHubForTests,\n  createTraceCapture,\n  getTraceEvents$,\n  setRendererTraceTransport,\n} from './tracing/index.js';\nexport type {\n  TraceCaptureOptions,\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceLevel,\n  TraceProcess,\n  TraceProviderMode,\n  TraceRuntime,\n  TraceWaitOptions,\n} from './tracing/index.js';\n\n// Testing — available via '@noego/wood/testing' subpath export.\n// Not re-exported here to avoid pulling vitest into production builds.\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoCA,mBAA2E;AAG3E,oBAA4B;AAG5B,oBAAqD;AACrD,IAAAA,iBAA2C;AAG3C,oBAA2B;AAG3B,wBAAgC;AAGhC,wBAA8E;AAG9E,wBAAoF;AAIpF,qBAAgC;AAChC,IAAAC,kBAA8B;AAC9B,IAAAA,kBAAiC;AACjC,IAAAA,kBAA+C;AAE/C,IAAAA,kBAAgC;AAEhC,IAAAA,kBAA6C;AAE7C,IAAAA,kBAAuD;AAEvD,IAAAA,kBAAoC;AAIpC,oBAAgD;AAIhD,oBAA6B;AAG7B,oBAA2D;AAG3D,iBAaO;AAIP,qBAOO;AASP,wBAA4D;AAI5D,iBAA4B;AAI5B,qBAYO;","names":["import_parser","import_codegen"]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @noego/wood — Declarative Electron desktop apps using the noego ecosystem\n\n// Types\nexport type {\n  WoodConfig,\n  WindowDef,\n  DevConfig,\n  ElectronBuilderConfig,\n  OperationDef,\n  RawOperationsDocument,\n  RawModuleDef,\n  RawOperationEntry,\n  RawModuleOperationEntry,\n  ViewDef,\n  RawViewsDocument,\n  RawViewEntry,\n  ParameterDef,\n  IpcContext,\n  WoodMiddlewareContext,\n  WoodMiddlewareFn,\n  RequestData,\n  ControllerArgs,\n  LoaderResult,\n  BridgeMessage,\n  BridgeRequest,\n  BridgeResponse,\n  BridgeReady,\n  BridgePush,\n  BridgeElectronApi,\n  SerializedError,\n  ContextMenuContext,\n  ContextMenuItem,\n  ContextMenuEvent,\n} from './types';\n\n// Errors\nexport { WoodAuthError, WoodValidationError, BackendRestartingError } from './types/index.cjs';\n\n// Config\nexport { parseConfig } from './config/index.cjs';\n\n// Parsers\nexport { parseOperations, parseOperationsFile } from './parser/index.cjs';\nexport { parseViews, parseViewsFile } from './parser/index.cjs';\n\n// Router\nexport { WoodRouter } from './router/index.cjs';\n\n// Validation\nexport { SchemaValidator } from './validation/index.cjs';\n\n// Middleware\nexport { MiddlewareResolver, buildMiddlewareContext, executeMiddleware } from './middleware/index.cjs';\n\n// Controller\nexport { ControllerResolver, buildControllerArgs, disposeControllerLifecycle } from './controller/index.cjs';\nexport type { ControllerLifecycle } from './controller/index.cjs';\n\n// Codegen\nexport { generatePreload } from './codegen/index.cjs';\nexport { generateTypes } from './codegen/index.cjs';\nexport { generateTestMock } from './codegen/index.cjs';\nexport { generateControllerRegistration } from './codegen/index.cjs';\nexport type { ControllerRegistrationOptions } from './codegen/index.cjs';\nexport { generateRuntime } from './codegen/index.cjs';\nexport type { RuntimeGeneratorOptions } from './codegen/index.cjs';\nexport { generateRendererViewManifest } from './codegen/index.cjs';\nexport type { RendererViewManifestGeneratorOptions } from './codegen/index.cjs';\nexport { generateRendererControllerRegistration } from './codegen/index.cjs';\nexport type { RendererControllerRegistrationOptions } from './codegen/index.cjs';\nexport { generateRendererApp } from './codegen/index.cjs';\nexport type { RendererAppGeneratorOptions } from './codegen/index.cjs';\n\n// Window\nexport { WindowManager, WindowStateStore } from './window/index.cjs';\nexport type { ScreenLike, WindowBounds } from './window/index.cjs';\n\n// Loader\nexport { LoaderRunner } from './loader/index.cjs';\n\n// Bridge\nexport { BackendBridge, startBackendLoop, pushEvent } from './bridge/index.cjs';\n\n// Dev\nexport {\n  WoodDevServer,\n  BackendWatcher,\n  YamlWatcher,\n  DEFAULT_WOOD_REMOTE_DEBUGGING_PORT,\n  WOOD_DEV_DIRECTORY,\n  WOOD_DEV_METADATA_BASENAME,\n  resolveWoodRemoteDebuggingPort,\n  resolveWoodDevDirectory,\n  resolveWoodDevMetadataPath,\n  writeWoodDevMetadata,\n  readWoodDevMetadata,\n  removeWoodDevMetadata,\n} from './dev/index.js';\nexport type { WoodDevMetadata } from './dev/index.js';\n\n// Runtime\nexport {\n  getContainer,\n  clearContainerRegistryForTests,\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n  runtime,\n} from './runtime/index.js';\nexport type {\n  GetContainerOptions,\n  RuntimeOptions,\n  RuntimeResult,\n  RegisterRuntimeRouter,\n} from './runtime';\n\n// Navigation\nexport { Navigation, getNavigation, go, goto, goback } from './navigation/index.cjs';\nexport type { NavigationEntry } from './navigation/index.cjs';\n\n// Isomorphic IPC API\nexport { Ipc, getIpc } from './ipc/index.cjs';\nexport type { IpcPushOptions } from './ipc/index.cjs';\n\n// Tracing\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\n  TraceCapture,\n  clearTraceHubForTests,\n  createTraceCapture,\n  getTraceEvents$,\n  setRendererTraceEnabled,\n  setRendererTraceTransport,\n} from './tracing/index.js';\nexport type {\n  TraceCaptureOptions,\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceLevel,\n  TraceProcess,\n  TraceProviderMode,\n  TraceRuntime,\n  TraceWaitOptions,\n} from './tracing/index.js';\n\n// Testing — available via '@noego/wood/testing' subpath export.\n// Not re-exported here to avoid pulling vitest into production builds.\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoCA,mBAA2E;AAG3E,oBAA4B;AAG5B,oBAAqD;AACrD,IAAAA,iBAA2C;AAG3C,oBAA2B;AAG3B,wBAAgC;AAGhC,wBAA8E;AAG9E,wBAAoF;AAIpF,qBAAgC;AAChC,IAAAC,kBAA8B;AAC9B,IAAAA,kBAAiC;AACjC,IAAAA,kBAA+C;AAE/C,IAAAA,kBAAgC;AAEhC,IAAAA,kBAA6C;AAE7C,IAAAA,kBAAuD;AAEvD,IAAAA,kBAAoC;AAIpC,oBAAgD;AAIhD,oBAA6B;AAG7B,oBAA2D;AAG3D,iBAaO;AAIP,qBAOO;AASP,wBAA4D;AAI5D,iBAA4B;AAI5B,qBAaO;","names":["import_parser","import_codegen"]}

package/dist/index.d.cts

@@ -33,7 +33,7 @@ export { YamlWatcher } from './dev/yaml_watcher.cjs';
 export { GetContainerOptions, clearContainerRegistryForTests, getContainer } from './runtime/get_container.cjs';
 export { clearApplicationRootForTests, getApplicationRoot, setApplicationRoot } from './runtime/application_root.cjs';
 export { RegisterRuntimeRouter, RuntimeOptions, RuntimeResult, runtime } from './runtime/runtime.cjs';
-export { TraceCapture, TraceCaptureOptions, TraceDispatchResult, TraceEvent, TraceInput, TraceLevel, TraceProcess, TraceWaitOptions, clearTraceHubForTests, createTraceCapture, getTraceEvents$, setRendererTraceTransport } from './tracing/trace_hub.cjs';
+export { TraceCapture, TraceCaptureOptions, TraceDispatchResult, TraceEvent, TraceInput, TraceLevel, TraceProcess, TraceWaitOptions, clearTraceHubForTests, createTraceCapture, getTraceEvents$, setRendererTraceEnabled, setRendererTraceTransport } from './tracing/trace_hub.cjs';
 export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './tracing/trace_provider.cjs';
 export { Navigation, NavigationEntry, getNavigation, go, goback, goto } from './navigation/index.cjs';
 export { Ipc, getIpc } from './ipc/index.cjs';

package/dist/index.d.ts

@@ -33,7 +33,7 @@ export { YamlWatcher } from './dev/yaml_watcher.js';
 export { GetContainerOptions, clearContainerRegistryForTests, getContainer } from './runtime/get_container.js';
 export { clearApplicationRootForTests, getApplicationRoot, setApplicationRoot } from './runtime/application_root.js';
 export { RegisterRuntimeRouter, RuntimeOptions, RuntimeResult, runtime } from './runtime/runtime.js';
-export { TraceCapture, TraceCaptureOptions, TraceDispatchResult, TraceEvent, TraceInput, TraceLevel, TraceProcess, TraceWaitOptions, clearTraceHubForTests, createTraceCapture, getTraceEvents$, setRendererTraceTransport } from './tracing/trace_hub.js';
+export { TraceCapture, TraceCaptureOptions, TraceDispatchResult, TraceEvent, TraceInput, TraceLevel, TraceProcess, TraceWaitOptions, clearTraceHubForTests, createTraceCapture, getTraceEvents$, setRendererTraceEnabled, setRendererTraceTransport } from './tracing/trace_hub.js';
 export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './tracing/trace_provider.js';
 export { Navigation, NavigationEntry, getNavigation, go, goback, goto } from './navigation/index.js';
 export { Ipc, getIpc } from './ipc/index.js';

package/dist/index.js

@@ -52,6 +52,7 @@ import {
   clearTraceHubForTests,
   createTraceCapture,
   getTraceEvents$,
+  setRendererTraceEnabled,
   setRendererTraceTransport
 } from "./tracing/index.js";
 export {
@@ -118,6 +119,7 @@ export {
   resolveWoodRemoteDebuggingPort,
   runtime,
   setApplicationRoot,
+  setRendererTraceEnabled,
   setRendererTraceTransport,
   startBackendLoop,
   writeWoodDevMetadata

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @noego/wood — Declarative Electron desktop apps using the noego ecosystem\n\n// Types\nexport type {\n  WoodConfig,\n  WindowDef,\n  DevConfig,\n  ElectronBuilderConfig,\n  OperationDef,\n  RawOperationsDocument,\n  RawModuleDef,\n  RawOperationEntry,\n  RawModuleOperationEntry,\n  ViewDef,\n  RawViewsDocument,\n  RawViewEntry,\n  ParameterDef,\n  IpcContext,\n  WoodMiddlewareContext,\n  WoodMiddlewareFn,\n  RequestData,\n  ControllerArgs,\n  LoaderResult,\n  BridgeMessage,\n  BridgeRequest,\n  BridgeResponse,\n  BridgeReady,\n  BridgePush,\n  BridgeElectronApi,\n  SerializedError,\n  ContextMenuContext,\n  ContextMenuItem,\n  ContextMenuEvent,\n} from './types';\n\n// Errors\nexport { WoodAuthError, WoodValidationError, BackendRestartingError } from './types/index.js';\n\n// Config\nexport { parseConfig } from './config/index.js';\n\n// Parsers\nexport { parseOperations, parseOperationsFile } from './parser/index.js';\nexport { parseViews, parseViewsFile } from './parser/index.js';\n\n// Router\nexport { WoodRouter } from './router/index.js';\n\n// Validation\nexport { SchemaValidator } from './validation/index.js';\n\n// Middleware\nexport { MiddlewareResolver, buildMiddlewareContext, executeMiddleware } from './middleware/index.js';\n\n// Controller\nexport { ControllerResolver, buildControllerArgs, disposeControllerLifecycle } from './controller/index.js';\nexport type { ControllerLifecycle } from './controller/index.js';\n\n// Codegen\nexport { generatePreload } from './codegen/index.js';\nexport { generateTypes } from './codegen/index.js';\nexport { generateTestMock } from './codegen/index.js';\nexport { generateControllerRegistration } from './codegen/index.js';\nexport type { ControllerRegistrationOptions } from './codegen/index.js';\nexport { generateRuntime } from './codegen/index.js';\nexport type { RuntimeGeneratorOptions } from './codegen/index.js';\nexport { generateRendererViewManifest } from './codegen/index.js';\nexport type { RendererViewManifestGeneratorOptions } from './codegen/index.js';\nexport { generateRendererControllerRegistration } from './codegen/index.js';\nexport type { RendererControllerRegistrationOptions } from './codegen/index.js';\nexport { generateRendererApp } from './codegen/index.js';\nexport type { RendererAppGeneratorOptions } from './codegen/index.js';\n\n// Window\nexport { WindowManager, WindowStateStore } from './window/index.js';\nexport type { ScreenLike, WindowBounds } from './window/index.js';\n\n// Loader\nexport { LoaderRunner } from './loader/index.js';\n\n// Bridge\nexport { BackendBridge, startBackendLoop, pushEvent } from './bridge/index.js';\n\n// Dev\nexport {\n  WoodDevServer,\n  BackendWatcher,\n  YamlWatcher,\n  DEFAULT_WOOD_REMOTE_DEBUGGING_PORT,\n  WOOD_DEV_DIRECTORY,\n  WOOD_DEV_METADATA_BASENAME,\n  resolveWoodRemoteDebuggingPort,\n  resolveWoodDevDirectory,\n  resolveWoodDevMetadataPath,\n  writeWoodDevMetadata,\n  readWoodDevMetadata,\n  removeWoodDevMetadata,\n} from './dev/index.js';\nexport type { WoodDevMetadata } from './dev/index.js';\n\n// Runtime\nexport {\n  getContainer,\n  clearContainerRegistryForTests,\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n  runtime,\n} from './runtime/index.js';\nexport type {\n  GetContainerOptions,\n  RuntimeOptions,\n  RuntimeResult,\n  RegisterRuntimeRouter,\n} from './runtime';\n\n// Navigation\nexport { Navigation, getNavigation, go, goto, goback } from './navigation/index.js';\nexport type { NavigationEntry } from './navigation/index.js';\n\n// Isomorphic IPC API\nexport { Ipc, getIpc } from './ipc/index.js';\nexport type { IpcPushOptions } from './ipc/index.js';\n\n// Tracing\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\n  TraceCapture,\n  clearTraceHubForTests,\n  createTraceCapture,\n  getTraceEvents$,\n  setRendererTraceTransport,\n} from './tracing/index.js';\nexport type {\n  TraceCaptureOptions,\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceLevel,\n  TraceProcess,\n  TraceProviderMode,\n  TraceRuntime,\n  TraceWaitOptions,\n} from './tracing/index.js';\n\n// Testing — available via '@noego/wood/testing' subpath export.\n// Not re-exported here to avoid pulling vitest into production builds.\n"],"mappings":"AAoCA,SAAS,eAAe,qBAAqB,8BAA8B;AAG3E,SAAS,mBAAmB;AAG5B,SAAS,iBAAiB,2BAA2B;AACrD,SAAS,YAAY,sBAAsB;AAG3C,SAAS,kBAAkB;AAG3B,SAAS,uBAAuB;AAGhC,SAAS,oBAAoB,wBAAwB,yBAAyB;AAG9E,SAAS,oBAAoB,qBAAqB,kCAAkC;AAIpF,SAAS,uBAAuB;AAChC,SAAS,qBAAqB;AAC9B,SAAS,wBAAwB;AACjC,SAAS,sCAAsC;AAE/C,SAAS,uBAAuB;AAEhC,SAAS,oCAAoC;AAE7C,SAAS,8CAA8C;AAEvD,SAAS,2BAA2B;AAIpC,SAAS,eAAe,wBAAwB;AAIhD,SAAS,oBAAoB;AAG7B,SAAS,eAAe,kBAAkB,iBAAiB;AAG3D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,YAAY,eAAe,IAAI,MAAM,cAAc;AAI5D,SAAS,KAAK,cAAc;AAI5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// @noego/wood — Declarative Electron desktop apps using the noego ecosystem\n\n// Types\nexport type {\n  WoodConfig,\n  WindowDef,\n  DevConfig,\n  ElectronBuilderConfig,\n  OperationDef,\n  RawOperationsDocument,\n  RawModuleDef,\n  RawOperationEntry,\n  RawModuleOperationEntry,\n  ViewDef,\n  RawViewsDocument,\n  RawViewEntry,\n  ParameterDef,\n  IpcContext,\n  WoodMiddlewareContext,\n  WoodMiddlewareFn,\n  RequestData,\n  ControllerArgs,\n  LoaderResult,\n  BridgeMessage,\n  BridgeRequest,\n  BridgeResponse,\n  BridgeReady,\n  BridgePush,\n  BridgeElectronApi,\n  SerializedError,\n  ContextMenuContext,\n  ContextMenuItem,\n  ContextMenuEvent,\n} from './types';\n\n// Errors\nexport { WoodAuthError, WoodValidationError, BackendRestartingError } from './types/index.js';\n\n// Config\nexport { parseConfig } from './config/index.js';\n\n// Parsers\nexport { parseOperations, parseOperationsFile } from './parser/index.js';\nexport { parseViews, parseViewsFile } from './parser/index.js';\n\n// Router\nexport { WoodRouter } from './router/index.js';\n\n// Validation\nexport { SchemaValidator } from './validation/index.js';\n\n// Middleware\nexport { MiddlewareResolver, buildMiddlewareContext, executeMiddleware } from './middleware/index.js';\n\n// Controller\nexport { ControllerResolver, buildControllerArgs, disposeControllerLifecycle } from './controller/index.js';\nexport type { ControllerLifecycle } from './controller/index.js';\n\n// Codegen\nexport { generatePreload } from './codegen/index.js';\nexport { generateTypes } from './codegen/index.js';\nexport { generateTestMock } from './codegen/index.js';\nexport { generateControllerRegistration } from './codegen/index.js';\nexport type { ControllerRegistrationOptions } from './codegen/index.js';\nexport { generateRuntime } from './codegen/index.js';\nexport type { RuntimeGeneratorOptions } from './codegen/index.js';\nexport { generateRendererViewManifest } from './codegen/index.js';\nexport type { RendererViewManifestGeneratorOptions } from './codegen/index.js';\nexport { generateRendererControllerRegistration } from './codegen/index.js';\nexport type { RendererControllerRegistrationOptions } from './codegen/index.js';\nexport { generateRendererApp } from './codegen/index.js';\nexport type { RendererAppGeneratorOptions } from './codegen/index.js';\n\n// Window\nexport { WindowManager, WindowStateStore } from './window/index.js';\nexport type { ScreenLike, WindowBounds } from './window/index.js';\n\n// Loader\nexport { LoaderRunner } from './loader/index.js';\n\n// Bridge\nexport { BackendBridge, startBackendLoop, pushEvent } from './bridge/index.js';\n\n// Dev\nexport {\n  WoodDevServer,\n  BackendWatcher,\n  YamlWatcher,\n  DEFAULT_WOOD_REMOTE_DEBUGGING_PORT,\n  WOOD_DEV_DIRECTORY,\n  WOOD_DEV_METADATA_BASENAME,\n  resolveWoodRemoteDebuggingPort,\n  resolveWoodDevDirectory,\n  resolveWoodDevMetadataPath,\n  writeWoodDevMetadata,\n  readWoodDevMetadata,\n  removeWoodDevMetadata,\n} from './dev/index.js';\nexport type { WoodDevMetadata } from './dev/index.js';\n\n// Runtime\nexport {\n  getContainer,\n  clearContainerRegistryForTests,\n  getApplicationRoot,\n  setApplicationRoot,\n  clearApplicationRootForTests,\n  runtime,\n} from './runtime/index.js';\nexport type {\n  GetContainerOptions,\n  RuntimeOptions,\n  RuntimeResult,\n  RegisterRuntimeRouter,\n} from './runtime';\n\n// Navigation\nexport { Navigation, getNavigation, go, goto, goback } from './navigation/index.js';\nexport type { NavigationEntry } from './navigation/index.js';\n\n// Isomorphic IPC API\nexport { Ipc, getIpc } from './ipc/index.js';\nexport type { IpcPushOptions } from './ipc/index.js';\n\n// Tracing\nexport {\n  FrameworkTracer,\n  MainTracer,\n  RendererTracer,\n  TestTracer,\n  TraceProvider,\n  TraceProviderConfiguration,\n  TraceCapture,\n  clearTraceHubForTests,\n  createTraceCapture,\n  getTraceEvents$,\n  setRendererTraceEnabled,\n  setRendererTraceTransport,\n} from './tracing/index.js';\nexport type {\n  TraceCaptureOptions,\n  TraceDispatchResult,\n  TraceEvent,\n  TraceInput,\n  TraceLevel,\n  TraceProcess,\n  TraceProviderMode,\n  TraceRuntime,\n  TraceWaitOptions,\n} from './tracing/index.js';\n\n// Testing — available via '@noego/wood/testing' subpath export.\n// Not re-exported here to avoid pulling vitest into production builds.\n"],"mappings":"AAoCA,SAAS,eAAe,qBAAqB,8BAA8B;AAG3E,SAAS,mBAAmB;AAG5B,SAAS,iBAAiB,2BAA2B;AACrD,SAAS,YAAY,sBAAsB;AAG3C,SAAS,kBAAkB;AAG3B,SAAS,uBAAuB;AAGhC,SAAS,oBAAoB,wBAAwB,yBAAyB;AAG9E,SAAS,oBAAoB,qBAAqB,kCAAkC;AAIpF,SAAS,uBAAuB;AAChC,SAAS,qBAAqB;AAC9B,SAAS,wBAAwB;AACjC,SAAS,sCAAsC;AAE/C,SAAS,uBAAuB;AAEhC,SAAS,oCAAoC;AAE7C,SAAS,8CAA8C;AAEvD,SAAS,2BAA2B;AAIpC,SAAS,eAAe,wBAAwB;AAIhD,SAAS,oBAAoB;AAG7B,SAAS,eAAe,kBAAkB,iBAAiB;AAG3D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,YAAY,eAAe,IAAI,MAAM,cAAc;AAI5D,SAAS,KAAK,cAAc;AAI5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/main/index.cjs

@@ -84,6 +84,8 @@ function startWoodMain(options) {
   const windowState = new import_window_state_store.WindowStateStore();
   const windows = /* @__PURE__ */ new Map();
   let mainWindow = null;
+  let beforeQuitCleanupComplete = false;
+  let beforeQuitCleanupPromise = null;
   let runtimeContext = null;
   let mainBootCleanup;
   for (const stream of [process.stdout, process.stderr]) {
@@ -303,7 +305,7 @@ function startWoodMain(options) {
       } else {
         void win.loadFile(rendererFile);
       }
-      if (options.traceTransport === "messageport") {
+      if (options.traceTransport === "messageport" && options.rendererTraceEnabled === true) {
         const { port1, port2 } = new import_electron.MessageChannelMain();
         const portHandler = (event) => {
           (0, import_tracing.dispatchRendererTracePayload)(event.data);
@@ -326,6 +328,9 @@ function startWoodMain(options) {
         if (windowId === "main") {
           mainWindow = null;
         }
+        if (windows.size === 0) {
+          import_electron.app.quit();
+        }
       });
       logger.info("window created", { windowId });
       return win;
@@ -396,6 +401,8 @@ function startWoodMain(options) {
         controllersDir: resolveRuntimePath(options.controllersDir),
         middlewareDir: resolveRuntimePath(options.middlewareDir),
         ...options.traceMinLevel ? { traceMinLevel: options.traceMinLevel } : {},
+        ...typeof options.rendererTraceEnabled === "boolean" ? { rendererTraceEnabled: options.rendererTraceEnabled } : {},
+        ...options.rendererTraceMinLevel ? { rendererTraceMinLevel: options.rendererTraceMinLevel } : {},
         ...options.traceTransport === "messageport" ? { enableRendererTraceBridge: false } : {},
         onLoad: options.onLoad ?? (async () => {
           throw new Error('Reserved channel "__load" is not configured for this app.');
@@ -481,30 +488,48 @@ function startWoodMain(options) {
         stack: error instanceof Error ? error.stack : void 0
       });
     });
-    import_electron.app.on("before-quit", () => {
+    const destroyWindowsForQuit = () => {
+      for (const [id, win] of windows) {
+        if (!win.isDestroyed()) {
+          win.destroy();
+          logger.debug("destroyed window on quit", { windowId: id });
+        }
+      }
+      windows.clear();
+    };
+    const runBeforeQuitCleanup = async () => {
+      (0, import_shared.clearIpcPushSender)();
+      if (mainBootCleanup) {
+        await mainBootCleanup();
+      }
+      if (options.onBeforeQuit) {
+        await options.onBeforeQuit(runtimeContext);
+      }
+    };
+    import_electron.app.on("before-quit", (event) => {
       if (!runtimeContext) {
         return;
       }
-      void (async () => {
+      if (beforeQuitCleanupComplete) {
+        destroyWindowsForQuit();
+        return;
+      }
+      event.preventDefault();
+      if (beforeQuitCleanupPromise) {
+        return;
+      }
+      beforeQuitCleanupPromise = (async () => {
         try {
-          (0, import_shared.clearIpcPushSender)();
-          if (mainBootCleanup) {
-            await mainBootCleanup();
-          }
-          if (options.onBeforeQuit) {
-            await options.onBeforeQuit(runtimeContext);
-          }
+          await runBeforeQuitCleanup();
         } catch (error) {
           logger.warn("before-quit handler failed", { error: toErrorMessage(error) });
+        } finally {
+          beforeQuitCleanupComplete = true;
+          beforeQuitCleanupPromise = null;
         }
+        destroyWindowsForQuit();
+        import_electron.app.quit();
       })();
-      for (const [id, win] of windows) {
-        if (!win.isDestroyed()) {
-          win.destroy();
-          logger.debug("destroyed window on quit", { windowId: id });
-        }
-      }
-      windows.clear();
     });
     import_electron.app.on("window-all-closed", () => {
       import_electron.app.quit();