@noego/wood 0.5.1 → 0.6.1

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, LoadAs } from '@noego/ioc';\nimport {\n  Navigation,\n  getNavigation,\n  clearNavigationForTests as clearNavigationSingletonForTests,\n} from '../navigation/index.js';\nimport { Ipc, getIpc } from '../ipc/index.js';\nimport { setWoodAppEnv } from './app_env.js';\nexport { getWoodAppEnv, type WoodAppEnv } from './app_env.js';\nimport {\n  TraceProviderConfiguration,\n  clearTraceHubForTests,\n  emitRendererTrace,\n  setRendererTraceTransport,\n} from '../tracing/index.js';\nexport type {\n  ControllerEvents,\n  ControllerInput,\n  ControllerLifecycle,\n  ControllerState,\n  PageController,\n} from './controller_contract.js';\nimport {\n  RendererLogTransport,\n  getRendererLogTransport,\n  clearRendererLogTransportForTests as clearRendererLogTransportSingletonForTests,\n} from './renderer_log_transport.js';\nexport {\n  configureRendererLogTransport,\n  flushRendererLogs,\n  type RendererLogTransportConfig,\n} from './renderer_log_transport.js';\n\n/** Resets the renderer log transport singleton, its bridge wiring latch, and any app sender. */\nexport function clearRendererLogTransportForTests(): void {\n  rendererLogWiringDone = false;\n  appRendererLogSender = null;\n  rendererBootConfig = null;\n  clearRendererLogTransportSingletonForTests();\n}\n\n/** An app-installed outlet for admitted renderer log batches (e.g. a WebSocket to a log host). */\nexport type RendererLogSender = (batch: unknown) => void;\n\nlet appRendererLogSender: RendererLogSender | null = null;\n\n/**\n * Installs (or with `null`, removes) an app-owned batch sender that takes\n * precedence over the preload `__logBatch` IPC path. Records already buffered\n * are flushed through the previous outlet first so nothing is reordered or\n * lost across the swap. A sender that throws falls back to the preload/legacy\n * chain for that batch, exactly like the default outlet.\n */\nexport function setRendererLogSender(sender: RendererLogSender | null): void {\n  const transport = getRendererLogTransport();\n  transport.flush();\n  appRendererLogSender = sender;\n  rendererLogWiringDone = false;\n  ensureRendererLogWiring(transport);\n}\n\n/** The most recent `__woodConfig` payload received in `startWood`, or null before boot. */\nexport function getRendererBootConfig(): Readonly<Record<string, unknown>> | null {\n  return rendererBootConfig;\n}\n\nlet rendererBootConfig: Readonly<Record<string, unknown>> | null = null;\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  __logBatch?: (batch: unknown) => 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]?: object;\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<TApp extends object = App>(): TApp {\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 TApp;\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' | (string & {});\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  logAt(level: RendererLogLevel, rawMessage: unknown, context?: unknown): void {\n    this.log(level, rawMessage, context);\n  }\n\n  private log(level: RendererLogLevel, rawMessage: unknown, context?: unknown): void {\n    const message = stringifyLogMessage(rawMessage);\n\n    const transport = getRendererLogTransport();\n    ensureRendererLogWiring(transport);\n    transport.admit(level, this.loggerName, message, context);\n  }\n}\n\nlet rendererLogWiringDone = false;\n\n/**\n * Lazily binds the renderer log pipe's outlet to the preload bridge: batches\n * ride __logBatch (admitted records, one IPC message per flush); the per-entry\n * legacy __log channel and finally the console act as fallbacks when the\n * bridge predates batching or is absent (tests, plain browsers).\n */\nfunction ensureRendererLogWiring(transport: RendererLogTransport): void {\n  if (rendererLogWiringDone) return;\n\n  let bridge: WoodBridgeLike | null = null;\n  try {\n    bridge = resolveWoodBridge();\n  } catch {\n    bridge = null;\n  }\n\n  const preloadSend = bridge && typeof bridge.__logBatch === 'function'\n    ? bridge.__logBatch.bind(bridge)\n    : null;\n  const appSend = appRendererLogSender;\n\n  if (appSend) {\n    // App sender wins; a throw here degrades to the preload batch path for\n    // that batch, then to the per-record fallback if that throws too.\n    transport.setSender((batch) => {\n      try {\n        appSend(batch);\n      } catch (error) {\n        if (!preloadSend) throw error;\n        preloadSend(batch);\n      }\n    });\n  } else if (preloadSend) {\n    transport.setSender((batch) => preloadSend(batch));\n  } else {\n    transport.setSender(null);\n  }\n\n  const legacyLog = bridge && typeof bridge.__log === 'function' ? bridge.__log.bind(bridge) : null;\n  transport.setFallback((record) => {\n    if (legacyLog) {\n      try {\n        legacyLog(record.level, record.logger, record.message, record.context);\n        return;\n      } catch {\n        // fall through to console\n      }\n    }\n    writeConsole(record.level, record.logger, record.message, record.context);\n  });\n\n  // Only latch once a bridge was found (or an app sender makes the bridge\n  // optional); keep retrying while both are absent so a late-injected bridge\n  // (tests, slow preload) still gets wired.\n  rendererLogWiringDone = bridge !== null || appSend !== null;\n}\n\ntype RendererLoggerShape = {\n  logAt(level: RendererLogLevel, message: unknown, context?: unknown): void;\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  // Explicit Singleton lifetime: these factories return renderer-root\n  // globals, and registerFunction defaults to Transient — which ioc >= 0.5's\n  // captive-lifetime validation rejects under singleton dependents.\n  const singleton = { loadAs: LoadAs.Singleton };\n  container.registerFunction(Navigation, () => getNavigation(), singleton);\n  container.registerFunction(App, () => getApp(), singleton);\n  container.registerFunction(Ipc, () => getIpc(), singleton);\n  container.registerFunction(WindowControls, () => getWindowControls(), singleton);\n  container.registerFunction(TraceProviderConfiguration, () => traceConfiguration, singleton);\n}\n\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\ntype RendererTraceBootstrapConfiguration = {\n  rendererTraceEnabled?: boolean;\n  rendererTraceMinLevel?: string;\n  rendererTraceBatchEnabled?: boolean;\n  appEnv?: string;\n};\n\nfunction configureRendererTraceTransport(config: RendererTraceBootstrapConfiguration | null): void {\n  const globalObj = globalThis as Record<string, unknown>;\n  if (config?.rendererTraceBatchEnabled) {\n    const batchGlobal = globalObj.__NOEGO_WOOD_TRACE_BATCH__ as\n      | { send?: (data: unknown) => unknown }\n      | undefined;\n    if (batchGlobal && typeof batchGlobal.send === 'function') {\n      const sender = batchGlobal.send.bind(batchGlobal);\n      setRendererTraceTransport((payload: unknown) => {\n        sender(payload);\n      });\n      return;\n    }\n  }\n\n  const traceGlobal = globalObj.__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}\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  // Fetch framework config from the main process and apply renderer trace\n  // controls before the first render.\n  let rendererTraceConfig: RendererTraceBootstrapConfiguration | null = null;\n  try {\n    const bridge = resolveWoodBridge();\n    if (typeof bridge.__woodConfig === 'function') {\n      const config = await bridge.__woodConfig() as RendererTraceBootstrapConfiguration | null;\n      rendererTraceConfig = config;\n      rendererBootConfig = config && typeof config === 'object'\n        ? Object.freeze({ ...(config as Record<string, unknown>) })\n        : null;\n      setWoodAppEnv(config?.appEnv);\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 (typeof level === 'string' && level.trim().length > 0) {\n        traceConfiguration?.configureMinLevel(level);\n      }\n    }\n  } catch {\n    // Config fetch is best-effort; fall back to defaults.\n  }\n\n  try {\n    configureRendererTraceTransport(rendererTraceConfig);\n  } catch {\n    // Trace transport selection is best-effort; the internal IPC bridge remains available.\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  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, LoadAs } from '@noego/ioc';\nimport {\n  Navigation,\n  getNavigation,\n  clearNavigationForTests as clearNavigationSingletonForTests,\n} from '../navigation/index.js';\nimport { Ipc, getIpc } from '../ipc/index.js';\nimport { setWoodAppEnv } from './app_env.js';\nexport { getWoodAppEnv, type WoodAppEnv } from './app_env.js';\nimport {\n  TraceProviderConfiguration,\n  clearTraceHubForTests,\n  emitRendererTrace,\n  setRendererTraceTransport,\n} from '../tracing/index.js';\nexport type {\n  ControllerEvents,\n  ControllerInput,\n  ControllerLifecycle,\n  ControllerState,\n  PageController,\n} from './controller_contract.js';\nimport {\n  RendererLogTransport,\n  getRendererLogTransport,\n  clearRendererLogTransportForTests as clearRendererLogTransportSingletonForTests,\n} from './renderer_log_transport.js';\nexport {\n  configureRendererLogTransport,\n  flushRendererLogs,\n  type RendererLogTransportConfig,\n} from './renderer_log_transport.js';\n\n/** Resets the renderer log transport singleton, its bridge wiring latch, and any app sender. */\nexport function clearRendererLogTransportForTests(): void {\n  rendererLogWiringDone = false;\n  appRendererLogSender = null;\n  rendererBootConfig = null;\n  clearRendererLogTransportSingletonForTests();\n}\n\n/** An app-installed outlet for admitted renderer log batches (e.g. a WebSocket to a log host). */\nexport type RendererLogSender = (batch: unknown) => void;\n\nlet appRendererLogSender: RendererLogSender | null = null;\n\n/**\n * Installs (or with `null`, removes) an app-owned batch sender that takes\n * precedence over the preload `__logBatch` IPC path. Records already buffered\n * are flushed through the previous outlet first so nothing is reordered or\n * lost across the swap. A sender that throws falls back to the preload/legacy\n * chain for that batch, exactly like the default outlet.\n */\nexport function setRendererLogSender(sender: RendererLogSender | null): void {\n  const transport = getRendererLogTransport();\n  transport.flush();\n  appRendererLogSender = sender;\n  rendererLogWiringDone = false;\n  ensureRendererLogWiring(transport);\n}\n\n/** The most recent `__woodConfig` payload received in `startWood`, or null before boot. */\nexport function getRendererBootConfig(): Readonly<Record<string, unknown>> | null {\n  return rendererBootConfig;\n}\n\nlet rendererBootConfig: Readonly<Record<string, unknown>> | null = null;\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>;\n\nexport interface WoodClientBridge extends Record<string, unknown> {\n  __rpcManifest?: WoodRpcManifestEntry[];\n  on?: (channel: string, callback: (...args: unknown[]) => void) => () => void;\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  __logBatch?: (batch: unknown) => void;\n  __woodConfig?: () => Promise<unknown>;\n  __trace?: (event: unknown) => void;\n}\n\ntype WoodBridgeLike = WoodClientBridge;\n\ntype GlobalWithClientContainer = typeof globalThis & {\n  [CLIENT_CONTAINER_SYMBOL]?: any;\n};\n\ntype GlobalWithClientApp = typeof globalThis & {\n  [CLIENT_APP_SYMBOL]?: object;\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(bridge: WoodClientBridge): App {\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\n/** Builds an uncached renderer App client owned by the supplied bridge. */\nexport function createAppWithBridge<TApp extends object = App>(bridge: WoodClientBridge): TApp {\n  return createAppInstance(bridge) as TApp;\n}\n\nexport function getApp<TApp extends object = App>(): TApp {\n  const globalObj = globalThis as GlobalWithClientApp;\n  if (!globalObj[CLIENT_APP_SYMBOL]) {\n    globalObj[CLIENT_APP_SYMBOL] = createAppInstance(resolveWoodBridge());\n  }\n  return globalObj[CLIENT_APP_SYMBOL] as TApp;\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  bridge: WoodClientBridge | undefined,\n  method: keyof NonNullable<WoodBridgeLike['__window']>,\n): T {\n  const resolvedBridge = bridge ?? resolveWoodBridge();\n  const fn = resolvedBridge.__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  constructor(private readonly bridge?: WoodClientBridge) {}\n\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    >(this.bridge, '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    >(this.bridge, 'close');\n    await close(windowId);\n  }\n\n  async focus(windowId: string): Promise<void> {\n    const focus = resolveWindowControlsBridgeMethod<\n      (id: string) => Promise<unknown>\n    >(this.bridge, 'focus');\n    await focus(windowId);\n  }\n\n  async minimize(windowId?: string): Promise<void> {\n    const minimize = resolveWindowControlsBridgeMethod<\n      (id?: string) => Promise<unknown>\n    >(this.bridge, 'minimize');\n    await minimize(windowId);\n  }\n\n  async maximize(windowId?: string): Promise<void> {\n    const maximize = resolveWindowControlsBridgeMethod<\n      (id?: string) => Promise<unknown>\n    >(this.bridge, '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' | (string & {});\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  logAt(level: RendererLogLevel, rawMessage: unknown, context?: unknown): void {\n    this.log(level, rawMessage, context);\n  }\n\n  private log(level: RendererLogLevel, rawMessage: unknown, context?: unknown): void {\n    const message = stringifyLogMessage(rawMessage);\n\n    const transport = getRendererLogTransport();\n    ensureRendererLogWiring(transport);\n    transport.admit(level, this.loggerName, message, context);\n  }\n}\n\nlet rendererLogWiringDone = false;\n\n/**\n * Lazily binds the renderer log pipe's outlet to the preload bridge: batches\n * ride __logBatch (admitted records, one IPC message per flush); the per-entry\n * legacy __log channel and finally the console act as fallbacks when the\n * bridge predates batching or is absent (tests, plain browsers).\n */\nfunction ensureRendererLogWiring(transport: RendererLogTransport): void {\n  if (rendererLogWiringDone) return;\n\n  let bridge: WoodBridgeLike | null = null;\n  try {\n    bridge = resolveWoodBridge();\n  } catch {\n    bridge = null;\n  }\n\n  const preloadSend = bridge && typeof bridge.__logBatch === 'function'\n    ? bridge.__logBatch.bind(bridge)\n    : null;\n  const appSend = appRendererLogSender;\n\n  if (appSend) {\n    // App sender wins; a throw here degrades to the preload batch path for\n    // that batch, then to the per-record fallback if that throws too.\n    transport.setSender((batch) => {\n      try {\n        appSend(batch);\n      } catch (error) {\n        if (!preloadSend) throw error;\n        preloadSend(batch);\n      }\n    });\n  } else if (preloadSend) {\n    transport.setSender((batch) => preloadSend(batch));\n  } else {\n    transport.setSender(null);\n  }\n\n  const legacyLog = bridge && typeof bridge.__log === 'function' ? bridge.__log.bind(bridge) : null;\n  transport.setFallback((record) => {\n    if (legacyLog) {\n      try {\n        legacyLog(record.level, record.logger, record.message, record.context);\n        return;\n      } catch {\n        // fall through to console\n      }\n    }\n    writeConsole(record.level, record.logger, record.message, record.context);\n  });\n\n  // Only latch once a bridge was found (or an app sender makes the bridge\n  // optional); keep retrying while both are absent so a late-injected bridge\n  // (tests, slow preload) still gets wired.\n  rendererLogWiringDone = bridge !== null || appSend !== null;\n}\n\ntype RendererLoggerShape = {\n  logAt(level: RendererLogLevel, message: unknown, context?: unknown): void;\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  // Explicit Singleton lifetime: these factories return renderer-root\n  // globals, and registerFunction defaults to Transient — which ioc >= 0.5's\n  // captive-lifetime validation rejects under singleton dependents.\n  const singleton = { loadAs: LoadAs.Singleton };\n  container.registerFunction(Navigation, () => getNavigation(), singleton);\n  container.registerFunction(App, () => getApp(), singleton);\n  container.registerFunction(Ipc, () => getIpc(), singleton);\n  container.registerFunction(WindowControls, () => getWindowControls(), singleton);\n  container.registerFunction(TraceProviderConfiguration, () => traceConfiguration, singleton);\n}\n\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\ntype RendererTraceBootstrapConfiguration = {\n  rendererTraceEnabled?: boolean;\n  rendererTraceMinLevel?: string;\n  rendererTraceBatchEnabled?: boolean;\n  appEnv?: string;\n};\n\n/**\n * Hook awaited by the main process shutdown drain before this window is\n * destroyed. `deadlineMs` is the absolute epoch deadline; work still pending\n * at the deadline is abandoned, so flush only essential user state here.\n */\nexport type RendererShutdownDrainHook = (deadlineMs: number) => unknown;\n\n/**\n * Register essential user-state persistence to run during Wood's bounded\n * shutdown drain (last-window Close or Quit). Returns an unregister function.\n * Outside a Wood preload (tests, plain browsers) this is a no-op.\n */\nexport function registerRendererShutdownDrainHook(hook: RendererShutdownDrainHook): () => void {\n  const shutdownGlobal = (globalThis as Record<string, unknown>).__NOEGO_WOOD_SHUTDOWN__ as\n    | { onDrain?: (hook: RendererShutdownDrainHook) => (() => void) | undefined }\n    | undefined;\n  if (!shutdownGlobal || typeof shutdownGlobal.onDrain !== 'function') {\n    return () => {};\n  }\n  const unregister = shutdownGlobal.onDrain(hook);\n  return typeof unregister === 'function' ? unregister : () => {};\n}\n\nfunction configureRendererTraceTransport(config: RendererTraceBootstrapConfiguration | null): void {\n  const globalObj = globalThis as Record<string, unknown>;\n  if (config?.rendererTraceBatchEnabled) {\n    const batchGlobal = globalObj.__NOEGO_WOOD_TRACE_BATCH__ as\n      | { send?: (data: unknown) => unknown }\n      | undefined;\n    if (batchGlobal && typeof batchGlobal.send === 'function') {\n      const sender = batchGlobal.send.bind(batchGlobal);\n      setRendererTraceTransport((payload: unknown) => {\n        sender(payload);\n      });\n      return;\n    }\n  }\n\n  const traceGlobal = globalObj.__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}\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  // Fetch framework config from the main process and apply renderer trace\n  // controls before the first render.\n  let rendererTraceConfig: RendererTraceBootstrapConfiguration | null = null;\n  try {\n    const bridge = resolveWoodBridge();\n    if (typeof bridge.__woodConfig === 'function') {\n      const config = await bridge.__woodConfig() as RendererTraceBootstrapConfiguration | null;\n      rendererTraceConfig = config;\n      rendererBootConfig = config && typeof config === 'object'\n        ? Object.freeze({ ...(config as Record<string, unknown>) })\n        : null;\n      setWoodAppEnv(config?.appEnv);\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 (typeof level === 'string' && level.trim().length > 0) {\n        traceConfiguration?.configureMinLevel(level);\n      }\n    }\n  } catch {\n    // Config fetch is best-effort; fall back to defaults.\n  }\n\n  try {\n    configureRendererTraceTransport(rendererTraceConfig);\n  } catch {\n    // Trace transport selection is best-effort; the internal IPC bridge remains available.\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  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/codegen/preload_generator.cjs

@@ -255,6 +255,39 @@ contextBridge.exposeInMainWorld('__NOEGO_WOOD_TRACE_BATCH__', {
   close: (deadlineMs: number) => __traceBatchTransport.close(deadlineMs),
 });
 
+// App-registered shutdown drain hooks (essential user-state persistence).
+// Main waits for the drain acknowledgement, bounded by deadlineMs, before it
+// destroys this window, so hooks must flush quickly and never block forever.
+type __WoodShutdownDrainHook = (deadlineMs: number) => unknown;
+const __shutdownDrainHooks = new Set<__WoodShutdownDrainHook>();
+
+async function __runShutdownDrainHooks(deadlineMs: number): Promise<{ hooks: number; settled: number; failed: number }> {
+  const hooks = [...__shutdownDrainHooks];
+  if (hooks.length === 0) {
+    return { hooks: 0, settled: 0, failed: 0 };
+  }
+  const remainingMs = Math.max(0, deadlineMs - Date.now());
+  const outcomes = await Promise.race([
+    Promise.allSettled(hooks.map(async (hook) => hook(deadlineMs))),
+    new Promise<null>((resolve) => setTimeout(() => resolve(null), remainingMs)),
+  ]);
+  if (outcomes === null) {
+    return { hooks: hooks.length, settled: 0, failed: 0 };
+  }
+  const failed = outcomes.filter((outcome) => outcome.status === 'rejected').length;
+  return { hooks: hooks.length, settled: outcomes.length, failed };
+}
+
+contextBridge.exposeInMainWorld('__NOEGO_WOOD_SHUTDOWN__', {
+  onDrain: (hook: __WoodShutdownDrainHook) => {
+    if (typeof hook !== 'function') {
+      return () => {};
+    }
+    __shutdownDrainHooks.add(hook);
+    return () => { __shutdownDrainHooks.delete(hook); };
+  },
+});
+
 ipcRenderer.on('__woodTraceDrainRequest', (_event, payload: unknown) => {
   if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
     return;
@@ -266,12 +299,18 @@ ipcRenderer.on('__woodTraceDrainRequest', (_event, payload: unknown) => {
     || !Number.isFinite(deadlineMs)) {
     return;
   }
-  void __traceBatchTransport.close(deadlineMs).finally(() => {
-    ipcRenderer.send('__woodTraceDrainAck', {
-      requestId,
-      status: __traceBatchTransport.status(),
+  let persistence: { hooks: number; settled: number; failed: number } = { hooks: 0, settled: 0, failed: 0 };
+  void __runShutdownDrainHooks(deadlineMs)
+    .then((result) => { persistence = result; })
+    .catch(() => {})
+    .then(() => __traceBatchTransport.close(deadlineMs))
+    .finally(() => {
+      ipcRenderer.send('__woodTraceDrainAck', {
+        requestId,
+        status: __traceBatchTransport.status(),
+        persistence,
+      });
     });
-  });
 });
 
 globalThis.addEventListener?.('pagehide', () => {

package/dist/codegen/preload_generator.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/preload_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.cjs';\nimport type { RendererTraceBatchingConfig } from '../types/config.cjs';\nimport { RENDERER_TRACE_BATCHING_DEFAULTS } from '../config/config_parser.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nexport type GeneratePreloadOptions = {\n  /**\n   * Renderer→main IPC trace batching policy resolved from\n   * wood.config.yml `observability.trace.rendererToMain.batching`.\n   * The generated preload embeds these values but does not own them.\n   */\n  traceBatching?: RendererTraceBatchingConfig;\n};\n\nconst PRELOAD_SOURCE_INSTRUCTIONS = [\n  'To change IPC channels or preload bridge methods, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and regenerate with `wood dev` or `wood build`.',\n] as const;\n\nfunction operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys((op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {}).length > 0,\n  );\n}\n\n/**\n * Build a nested object tree from dot-path operation channels.\n * \"chat.message.send\" -> { chat: { message: { send: ... } } }\n */\nfunction buildNestedTree(operations: Map<string, OperationDef>): Record<string, unknown> {\n  const tree: Record<string, unknown> = {};\n\n  for (const [channel, op] of operations) {\n    const parts = channel.split('.');\n    let current: Record<string, unknown> = tree;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      if (!current[parts[i]]) current[parts[i]] = {};\n      current = current[parts[i]] as Record<string, unknown>;\n    }\n\n    const leaf = parts[parts.length - 1];\n    current[leaf] = { __operation: op };\n  }\n\n  return tree;\n}\n\n/**\n * Generate TypeScript code for a nested tree node.\n */\nfunction generateTreeCode(node: Record<string, unknown>, indent: string = '  '): string {\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(node)) {\n    const entry = value as Record<string, unknown>;\n    if (entry.__operation) {\n      const op = entry.__operation as OperationDef;\n      const hasInput = operationHasInput(op);\n\n      if (hasInput) {\n        lines.push(`${indent}${key}: (data: unknown) =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}', data),`);\n      } else {\n        lines.push(`${indent}${key}: () =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}'),`);\n      }\n    } else {\n      lines.push(`${indent}${key}: {`);\n      lines.push(generateTreeCode(entry, indent + '  '));\n      lines.push(`${indent}},`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\nfunction generateRpcManifestCode(operations: Map<string, OperationDef>): string {\n  const entries = Array.from(operations.values())\n    .sort((a, b) => a.channel.localeCompare(b.channel))\n    .map((op) => {\n      const payload = {\n        channel: op.channel,\n        controller: op.controller,\n        action: op.action,\n        path: op.channel.split('.'),\n        hasInput: operationHasInput(op),\n      };\n      return `  ${JSON.stringify(payload)},`;\n    });\n\n  return `const __WOOD_RPC_MANIFEST = [\n${entries.join('\\n')}\n];`;\n}\n\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\n/**\n * Generate a complete preload.ts file from operations.\n */\nexport function generatePreload(\n  operations: Map<string, OperationDef>,\n  options: GeneratePreloadOptions = {},\n): string {\n  const tree = buildNestedTree(operations);\n  const operationsCode = generateTreeCode(tree);\n  const rpcManifestCode = generateRpcManifestCode(operations);\n  const traceBatching = options.traceBatching ?? RENDERER_TRACE_BATCHING_DEFAULTS;\n\n  return `${generatedFileNotice(PRELOAD_SOURCE_INSTRUCTIONS)}\nimport { contextBridge, ipcRenderer } from 'electron';\nimport {\n  RendererTraceBatchTransport,\n  type WoodRendererTraceInput,\n  type WoodTraceBatch,\n  type WoodTraceBatchAcknowledgement,\n  type WoodTraceBatchPort,\n} from '@noego/wood/trace-transport';\n\n${rpcManifestCode}\n\nconst __WOOD_INTERNAL_BRIDGE_KEY = '${INTERNAL_BRIDGE_GLOBAL_KEY}';\n\ncontextBridge.exposeInMainWorld(__WOOD_INTERNAL_BRIDGE_KEY, {\n${operationsCode}\n\n  // Internal: backend controller/action RPC map for @Inject(App)\n  __rpcManifest: __WOOD_RPC_MANIFEST,\n\n  // Internal: loader data requests\n  __load: (route: string, params: Record<string, string>) =>\n    ipcRenderer.invoke('__load', { route, params }),\n\n  // Internal: cross-window navigation\n  __navigate: (windowId: string, route: string) =>\n    ipcRenderer.invoke('__navigate', { windowId, route }),\n\n  // Internal: window management\n  __window: {\n    current: () =>\n      ipcRenderer.invoke('__window', { action: 'current' }),\n    open: (windowId: string, options?: Record<string, unknown>) =>\n      ipcRenderer.invoke('__window', { action: 'open', windowId, options }),\n    close: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'close', windowId }),\n    focus: (windowId: string) =>\n      ipcRenderer.invoke('__window', { action: 'focus', windowId }),\n    minimize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'minimize', windowId }),\n    maximize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'maximize', windowId }),\n  },\n\n  // Internal: framework config (trace min level, etc)\n  __woodConfig: () =>\n    ipcRenderer.invoke('__woodConfig'),\n\n  // Internal: debug metadata\n  __debug: {\n    current: () =>\n      ipcRenderer.invoke('__debug', { action: 'current' }),\n  },\n\n  // Internal: context menu\n  __contextMenu: {\n    show: (data: unknown) =>\n      ipcRenderer.invoke('__contextMenu', { action: 'show', ...data as Record<string, unknown> }),\n  },\n\n  // Push events from main process\n  on: (channel: string, callback: (...args: unknown[]) => void) => {\n    const subscription = (_event: unknown, ...args: unknown[]) => callback(...args);\n    ipcRenderer.on(\\`__event:\\${channel}\\`, subscription);\n    return () => ipcRenderer.removeListener(\\`__event:\\${channel}\\`, subscription);\n  },\n  __trace: (event: unknown) => {\n    ipcRenderer.send('__trace', event);\n  },\n  __log: (level: string, logger: string, message: string, context?: unknown) => {\n    ipcRenderer.send('__log', { level, logger, message, context });\n  },\n  __logBatch: (batch: unknown) => {\n    ipcRenderer.send('__log_batch', batch);\n  },\n});\n\n// Trace transport via MessagePort (activated when main process sends a port)\nlet __tracePort: MessagePort | null = null;\nconst __traceBuffer: unknown[] = [];\nconst __TRACE_BUFFER_CAPACITY = 256;\nlet __traceDroppedCapacity = 0;\n\nfunction __traceFlush(): void {\n  while (__traceBuffer.length > 0 && __tracePort) {\n    __tracePort.postMessage(__traceBuffer.shift());\n  }\n}\n\nipcRenderer.on('__trace-port', (event) => {\n  __tracePort = event.ports[0];\n  __tracePort.start();\n  __traceFlush();\n});\n\ncontextBridge.exposeInMainWorld('__NOEGO_TRACE__', {\n  send: (data: unknown) => {\n    if (__tracePort) {\n      __tracePort.postMessage(data);\n    } else if (__traceBuffer.length >= __TRACE_BUFFER_CAPACITY) {\n      __traceDroppedCapacity += 1;\n    } else {\n      __traceBuffer.push(data);\n    }\n  },\n  status: () => ({\n    queuedEvents: __traceBuffer.length,\n    droppedCapacity: __traceDroppedCapacity,\n  }),\n});\n\nconst __traceBatchProducerId = typeof globalThis.crypto?.randomUUID === 'function'\n  ? globalThis.crypto.randomUUID()\n  : \\`wood-renderer-\\${Date.now()}-\\${Math.random().toString(16).slice(2)}\\`;\nlet __traceBatchListener: ((message: unknown) => void) | null = null;\n\nconst __traceBatchPort: WoodTraceBatchPort = {\n  postMessage: (batch: WoodTraceBatch) => {\n    void ipcRenderer.invoke('__traceBatch', batch)\n      .then((acknowledgement: WoodTraceBatchAcknowledgement) => {\n        __traceBatchListener?.(acknowledgement);\n      })\n      .catch((error: unknown) => {\n        __traceBatchListener?.({\n          kind: 'retryable',\n          batchId: batch.batchId,\n          reason: error instanceof Error ? error.message : String(error),\n          retryAfterMs: 100,\n        });\n      });\n  },\n  subscribe: (listener: (message: unknown) => void) => {\n    __traceBatchListener = listener;\n    return () => {\n      if (__traceBatchListener === listener) {\n        __traceBatchListener = null;\n      }\n    };\n  },\n  close: () => {\n    __traceBatchListener = null;\n  },\n};\n\n// Batching policy resolved from wood.config.yml observability configuration\n// at generation time; this file embeds but does not own it.\nconst __traceBatchTransport = new RendererTraceBatchTransport({\n  producerId: __traceBatchProducerId,\n  maxQueuedEvents: ${traceBatching.maxQueuedEvents},\n  maxBatchEvents: ${traceBatching.maxBatchEvents},\n  acknowledgementTimeoutMs: ${traceBatching.acknowledgementTimeoutMs},\n  retryLimit: ${traceBatching.retryLimit},\n  retryBaseDelayMs: ${traceBatching.retryBaseDelayMs},\n  now: () => Date.now(),\n  schedule: (work: () => void) => queueMicrotask(work),\n  delay: (durationMs: number) => new Promise((resolve) => setTimeout(resolve, durationMs)),\n});\n__traceBatchTransport.attachPort(__traceBatchPort);\n\ncontextBridge.exposeInMainWorld('__NOEGO_WOOD_TRACE_BATCH__', {\n  send: (event: WoodRendererTraceInput) => __traceBatchTransport.admit(event),\n  status: () => __traceBatchTransport.status(),\n  flush: (deadlineMs: number) => __traceBatchTransport.flush(deadlineMs),\n  close: (deadlineMs: number) => __traceBatchTransport.close(deadlineMs),\n});\n\nipcRenderer.on('__woodTraceDrainRequest', (_event, payload: unknown) => {\n  if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {\n    return;\n  }\n  const requestId = Reflect.get(payload, 'requestId');\n  const deadlineMs = Reflect.get(payload, 'deadlineMs');\n  if (typeof requestId !== 'string'\n    || typeof deadlineMs !== 'number'\n    || !Number.isFinite(deadlineMs)) {\n    return;\n  }\n  void __traceBatchTransport.close(deadlineMs).finally(() => {\n    ipcRenderer.send('__woodTraceDrainAck', {\n      requestId,\n      status: __traceBatchTransport.status(),\n    });\n  });\n});\n\nglobalThis.addEventListener?.('pagehide', () => {\n  void __traceBatchTransport.flush(Date.now() + 100);\n});\n`;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/codegen/preload_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.cjs';\nimport type { RendererTraceBatchingConfig } from '../types/config.cjs';\nimport { RENDERER_TRACE_BATCHING_DEFAULTS } from '../config/config_parser.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nexport type GeneratePreloadOptions = {\n  /**\n   * Renderer→main IPC trace batching policy resolved from\n   * wood.config.yml `observability.trace.rendererToMain.batching`.\n   * The generated preload embeds these values but does not own them.\n   */\n  traceBatching?: RendererTraceBatchingConfig;\n};\n\nconst PRELOAD_SOURCE_INSTRUCTIONS = [\n  'To change IPC channels or preload bridge methods, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and regenerate with `wood dev` or `wood build`.',\n] as const;\n\nfunction operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys((op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {}).length > 0,\n  );\n}\n\n/**\n * Build a nested object tree from dot-path operation channels.\n * \"chat.message.send\" -> { chat: { message: { send: ... } } }\n */\nfunction buildNestedTree(operations: Map<string, OperationDef>): Record<string, unknown> {\n  const tree: Record<string, unknown> = {};\n\n  for (const [channel, op] of operations) {\n    const parts = channel.split('.');\n    let current: Record<string, unknown> = tree;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      if (!current[parts[i]]) current[parts[i]] = {};\n      current = current[parts[i]] as Record<string, unknown>;\n    }\n\n    const leaf = parts[parts.length - 1];\n    current[leaf] = { __operation: op };\n  }\n\n  return tree;\n}\n\n/**\n * Generate TypeScript code for a nested tree node.\n */\nfunction generateTreeCode(node: Record<string, unknown>, indent: string = '  '): string {\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(node)) {\n    const entry = value as Record<string, unknown>;\n    if (entry.__operation) {\n      const op = entry.__operation as OperationDef;\n      const hasInput = operationHasInput(op);\n\n      if (hasInput) {\n        lines.push(`${indent}${key}: (data: unknown) =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}', data),`);\n      } else {\n        lines.push(`${indent}${key}: () =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}'),`);\n      }\n    } else {\n      lines.push(`${indent}${key}: {`);\n      lines.push(generateTreeCode(entry, indent + '  '));\n      lines.push(`${indent}},`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\nfunction generateRpcManifestCode(operations: Map<string, OperationDef>): string {\n  const entries = Array.from(operations.values())\n    .sort((a, b) => a.channel.localeCompare(b.channel))\n    .map((op) => {\n      const payload = {\n        channel: op.channel,\n        controller: op.controller,\n        action: op.action,\n        path: op.channel.split('.'),\n        hasInput: operationHasInput(op),\n      };\n      return `  ${JSON.stringify(payload)},`;\n    });\n\n  return `const __WOOD_RPC_MANIFEST = [\n${entries.join('\\n')}\n];`;\n}\n\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\n/**\n * Generate a complete preload.ts file from operations.\n */\nexport function generatePreload(\n  operations: Map<string, OperationDef>,\n  options: GeneratePreloadOptions = {},\n): string {\n  const tree = buildNestedTree(operations);\n  const operationsCode = generateTreeCode(tree);\n  const rpcManifestCode = generateRpcManifestCode(operations);\n  const traceBatching = options.traceBatching ?? RENDERER_TRACE_BATCHING_DEFAULTS;\n\n  return `${generatedFileNotice(PRELOAD_SOURCE_INSTRUCTIONS)}\nimport { contextBridge, ipcRenderer } from 'electron';\nimport {\n  RendererTraceBatchTransport,\n  type WoodRendererTraceInput,\n  type WoodTraceBatch,\n  type WoodTraceBatchAcknowledgement,\n  type WoodTraceBatchPort,\n} from '@noego/wood/trace-transport';\n\n${rpcManifestCode}\n\nconst __WOOD_INTERNAL_BRIDGE_KEY = '${INTERNAL_BRIDGE_GLOBAL_KEY}';\n\ncontextBridge.exposeInMainWorld(__WOOD_INTERNAL_BRIDGE_KEY, {\n${operationsCode}\n\n  // Internal: backend controller/action RPC map for @Inject(App)\n  __rpcManifest: __WOOD_RPC_MANIFEST,\n\n  // Internal: loader data requests\n  __load: (route: string, params: Record<string, string>) =>\n    ipcRenderer.invoke('__load', { route, params }),\n\n  // Internal: cross-window navigation\n  __navigate: (windowId: string, route: string) =>\n    ipcRenderer.invoke('__navigate', { windowId, route }),\n\n  // Internal: window management\n  __window: {\n    current: () =>\n      ipcRenderer.invoke('__window', { action: 'current' }),\n    open: (windowId: string, options?: Record<string, unknown>) =>\n      ipcRenderer.invoke('__window', { action: 'open', windowId, options }),\n    close: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'close', windowId }),\n    focus: (windowId: string) =>\n      ipcRenderer.invoke('__window', { action: 'focus', windowId }),\n    minimize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'minimize', windowId }),\n    maximize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'maximize', windowId }),\n  },\n\n  // Internal: framework config (trace min level, etc)\n  __woodConfig: () =>\n    ipcRenderer.invoke('__woodConfig'),\n\n  // Internal: debug metadata\n  __debug: {\n    current: () =>\n      ipcRenderer.invoke('__debug', { action: 'current' }),\n  },\n\n  // Internal: context menu\n  __contextMenu: {\n    show: (data: unknown) =>\n      ipcRenderer.invoke('__contextMenu', { action: 'show', ...data as Record<string, unknown> }),\n  },\n\n  // Push events from main process\n  on: (channel: string, callback: (...args: unknown[]) => void) => {\n    const subscription = (_event: unknown, ...args: unknown[]) => callback(...args);\n    ipcRenderer.on(\\`__event:\\${channel}\\`, subscription);\n    return () => ipcRenderer.removeListener(\\`__event:\\${channel}\\`, subscription);\n  },\n  __trace: (event: unknown) => {\n    ipcRenderer.send('__trace', event);\n  },\n  __log: (level: string, logger: string, message: string, context?: unknown) => {\n    ipcRenderer.send('__log', { level, logger, message, context });\n  },\n  __logBatch: (batch: unknown) => {\n    ipcRenderer.send('__log_batch', batch);\n  },\n});\n\n// Trace transport via MessagePort (activated when main process sends a port)\nlet __tracePort: MessagePort | null = null;\nconst __traceBuffer: unknown[] = [];\nconst __TRACE_BUFFER_CAPACITY = 256;\nlet __traceDroppedCapacity = 0;\n\nfunction __traceFlush(): void {\n  while (__traceBuffer.length > 0 && __tracePort) {\n    __tracePort.postMessage(__traceBuffer.shift());\n  }\n}\n\nipcRenderer.on('__trace-port', (event) => {\n  __tracePort = event.ports[0];\n  __tracePort.start();\n  __traceFlush();\n});\n\ncontextBridge.exposeInMainWorld('__NOEGO_TRACE__', {\n  send: (data: unknown) => {\n    if (__tracePort) {\n      __tracePort.postMessage(data);\n    } else if (__traceBuffer.length >= __TRACE_BUFFER_CAPACITY) {\n      __traceDroppedCapacity += 1;\n    } else {\n      __traceBuffer.push(data);\n    }\n  },\n  status: () => ({\n    queuedEvents: __traceBuffer.length,\n    droppedCapacity: __traceDroppedCapacity,\n  }),\n});\n\nconst __traceBatchProducerId = typeof globalThis.crypto?.randomUUID === 'function'\n  ? globalThis.crypto.randomUUID()\n  : \\`wood-renderer-\\${Date.now()}-\\${Math.random().toString(16).slice(2)}\\`;\nlet __traceBatchListener: ((message: unknown) => void) | null = null;\n\nconst __traceBatchPort: WoodTraceBatchPort = {\n  postMessage: (batch: WoodTraceBatch) => {\n    void ipcRenderer.invoke('__traceBatch', batch)\n      .then((acknowledgement: WoodTraceBatchAcknowledgement) => {\n        __traceBatchListener?.(acknowledgement);\n      })\n      .catch((error: unknown) => {\n        __traceBatchListener?.({\n          kind: 'retryable',\n          batchId: batch.batchId,\n          reason: error instanceof Error ? error.message : String(error),\n          retryAfterMs: 100,\n        });\n      });\n  },\n  subscribe: (listener: (message: unknown) => void) => {\n    __traceBatchListener = listener;\n    return () => {\n      if (__traceBatchListener === listener) {\n        __traceBatchListener = null;\n      }\n    };\n  },\n  close: () => {\n    __traceBatchListener = null;\n  },\n};\n\n// Batching policy resolved from wood.config.yml observability configuration\n// at generation time; this file embeds but does not own it.\nconst __traceBatchTransport = new RendererTraceBatchTransport({\n  producerId: __traceBatchProducerId,\n  maxQueuedEvents: ${traceBatching.maxQueuedEvents},\n  maxBatchEvents: ${traceBatching.maxBatchEvents},\n  acknowledgementTimeoutMs: ${traceBatching.acknowledgementTimeoutMs},\n  retryLimit: ${traceBatching.retryLimit},\n  retryBaseDelayMs: ${traceBatching.retryBaseDelayMs},\n  now: () => Date.now(),\n  schedule: (work: () => void) => queueMicrotask(work),\n  delay: (durationMs: number) => new Promise((resolve) => setTimeout(resolve, durationMs)),\n});\n__traceBatchTransport.attachPort(__traceBatchPort);\n\ncontextBridge.exposeInMainWorld('__NOEGO_WOOD_TRACE_BATCH__', {\n  send: (event: WoodRendererTraceInput) => __traceBatchTransport.admit(event),\n  status: () => __traceBatchTransport.status(),\n  flush: (deadlineMs: number) => __traceBatchTransport.flush(deadlineMs),\n  close: (deadlineMs: number) => __traceBatchTransport.close(deadlineMs),\n});\n\n// App-registered shutdown drain hooks (essential user-state persistence).\n// Main waits for the drain acknowledgement, bounded by deadlineMs, before it\n// destroys this window, so hooks must flush quickly and never block forever.\ntype __WoodShutdownDrainHook = (deadlineMs: number) => unknown;\nconst __shutdownDrainHooks = new Set<__WoodShutdownDrainHook>();\n\nasync function __runShutdownDrainHooks(deadlineMs: number): Promise<{ hooks: number; settled: number; failed: number }> {\n  const hooks = [...__shutdownDrainHooks];\n  if (hooks.length === 0) {\n    return { hooks: 0, settled: 0, failed: 0 };\n  }\n  const remainingMs = Math.max(0, deadlineMs - Date.now());\n  const outcomes = await Promise.race([\n    Promise.allSettled(hooks.map(async (hook) => hook(deadlineMs))),\n    new Promise<null>((resolve) => setTimeout(() => resolve(null), remainingMs)),\n  ]);\n  if (outcomes === null) {\n    return { hooks: hooks.length, settled: 0, failed: 0 };\n  }\n  const failed = outcomes.filter((outcome) => outcome.status === 'rejected').length;\n  return { hooks: hooks.length, settled: outcomes.length, failed };\n}\n\ncontextBridge.exposeInMainWorld('__NOEGO_WOOD_SHUTDOWN__', {\n  onDrain: (hook: __WoodShutdownDrainHook) => {\n    if (typeof hook !== 'function') {\n      return () => {};\n    }\n    __shutdownDrainHooks.add(hook);\n    return () => { __shutdownDrainHooks.delete(hook); };\n  },\n});\n\nipcRenderer.on('__woodTraceDrainRequest', (_event, payload: unknown) => {\n  if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {\n    return;\n  }\n  const requestId = Reflect.get(payload, 'requestId');\n  const deadlineMs = Reflect.get(payload, 'deadlineMs');\n  if (typeof requestId !== 'string'\n    || typeof deadlineMs !== 'number'\n    || !Number.isFinite(deadlineMs)) {\n    return;\n  }\n  let persistence: { hooks: number; settled: number; failed: number } = { hooks: 0, settled: 0, failed: 0 };\n  void __runShutdownDrainHooks(deadlineMs)\n    .then((result) => { persistence = result; })\n    .catch(() => {})\n    .then(() => __traceBatchTransport.close(deadlineMs))\n    .finally(() => {\n      ipcRenderer.send('__woodTraceDrainAck', {\n        requestId,\n        status: __traceBatchTransport.status(),\n        persistence,\n      });\n    });\n});\n\nglobalThis.addEventListener?.('pagehide', () => {\n  void __traceBatchTransport.flush(Date.now() + 100);\n});\n`;\n}\n"],"mappings":"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","names":[]}

package/dist/codegen/preload_generator.js

@@ -232,6 +232,39 @@ contextBridge.exposeInMainWorld('__NOEGO_WOOD_TRACE_BATCH__', {
   close: (deadlineMs: number) => __traceBatchTransport.close(deadlineMs),
 });
 
+// App-registered shutdown drain hooks (essential user-state persistence).
+// Main waits for the drain acknowledgement, bounded by deadlineMs, before it
+// destroys this window, so hooks must flush quickly and never block forever.
+type __WoodShutdownDrainHook = (deadlineMs: number) => unknown;
+const __shutdownDrainHooks = new Set<__WoodShutdownDrainHook>();
+
+async function __runShutdownDrainHooks(deadlineMs: number): Promise<{ hooks: number; settled: number; failed: number }> {
+  const hooks = [...__shutdownDrainHooks];
+  if (hooks.length === 0) {
+    return { hooks: 0, settled: 0, failed: 0 };
+  }
+  const remainingMs = Math.max(0, deadlineMs - Date.now());
+  const outcomes = await Promise.race([
+    Promise.allSettled(hooks.map(async (hook) => hook(deadlineMs))),
+    new Promise<null>((resolve) => setTimeout(() => resolve(null), remainingMs)),
+  ]);
+  if (outcomes === null) {
+    return { hooks: hooks.length, settled: 0, failed: 0 };
+  }
+  const failed = outcomes.filter((outcome) => outcome.status === 'rejected').length;
+  return { hooks: hooks.length, settled: outcomes.length, failed };
+}
+
+contextBridge.exposeInMainWorld('__NOEGO_WOOD_SHUTDOWN__', {
+  onDrain: (hook: __WoodShutdownDrainHook) => {
+    if (typeof hook !== 'function') {
+      return () => {};
+    }
+    __shutdownDrainHooks.add(hook);
+    return () => { __shutdownDrainHooks.delete(hook); };
+  },
+});
+
 ipcRenderer.on('__woodTraceDrainRequest', (_event, payload: unknown) => {
   if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
     return;
@@ -243,12 +276,18 @@ ipcRenderer.on('__woodTraceDrainRequest', (_event, payload: unknown) => {
     || !Number.isFinite(deadlineMs)) {
     return;
   }
-  void __traceBatchTransport.close(deadlineMs).finally(() => {
-    ipcRenderer.send('__woodTraceDrainAck', {
-      requestId,
-      status: __traceBatchTransport.status(),
+  let persistence: { hooks: number; settled: number; failed: number } = { hooks: 0, settled: 0, failed: 0 };
+  void __runShutdownDrainHooks(deadlineMs)
+    .then((result) => { persistence = result; })
+    .catch(() => {})
+    .then(() => __traceBatchTransport.close(deadlineMs))
+    .finally(() => {
+      ipcRenderer.send('__woodTraceDrainAck', {
+        requestId,
+        status: __traceBatchTransport.status(),
+        persistence,
+      });
     });
-  });
 });
 
 globalThis.addEventListener?.('pagehide', () => {

package/dist/codegen/preload_generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/preload_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.js';\nimport type { RendererTraceBatchingConfig } from '../types/config.js';\nimport { RENDERER_TRACE_BATCHING_DEFAULTS } from '../config/config_parser.js';\nimport { generatedFileNotice } from './generated_file_notice.js';\n\nexport type GeneratePreloadOptions = {\n  /**\n   * Renderer→main IPC trace batching policy resolved from\n   * wood.config.yml `observability.trace.rendererToMain.batching`.\n   * The generated preload embeds these values but does not own them.\n   */\n  traceBatching?: RendererTraceBatchingConfig;\n};\n\nconst PRELOAD_SOURCE_INSTRUCTIONS = [\n  'To change IPC channels or preload bridge methods, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and regenerate with `wood dev` or `wood build`.',\n] as const;\n\nfunction operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys((op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {}).length > 0,\n  );\n}\n\n/**\n * Build a nested object tree from dot-path operation channels.\n * \"chat.message.send\" -> { chat: { message: { send: ... } } }\n */\nfunction buildNestedTree(operations: Map<string, OperationDef>): Record<string, unknown> {\n  const tree: Record<string, unknown> = {};\n\n  for (const [channel, op] of operations) {\n    const parts = channel.split('.');\n    let current: Record<string, unknown> = tree;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      if (!current[parts[i]]) current[parts[i]] = {};\n      current = current[parts[i]] as Record<string, unknown>;\n    }\n\n    const leaf = parts[parts.length - 1];\n    current[leaf] = { __operation: op };\n  }\n\n  return tree;\n}\n\n/**\n * Generate TypeScript code for a nested tree node.\n */\nfunction generateTreeCode(node: Record<string, unknown>, indent: string = '  '): string {\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(node)) {\n    const entry = value as Record<string, unknown>;\n    if (entry.__operation) {\n      const op = entry.__operation as OperationDef;\n      const hasInput = operationHasInput(op);\n\n      if (hasInput) {\n        lines.push(`${indent}${key}: (data: unknown) =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}', data),`);\n      } else {\n        lines.push(`${indent}${key}: () =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}'),`);\n      }\n    } else {\n      lines.push(`${indent}${key}: {`);\n      lines.push(generateTreeCode(entry, indent + '  '));\n      lines.push(`${indent}},`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\nfunction generateRpcManifestCode(operations: Map<string, OperationDef>): string {\n  const entries = Array.from(operations.values())\n    .sort((a, b) => a.channel.localeCompare(b.channel))\n    .map((op) => {\n      const payload = {\n        channel: op.channel,\n        controller: op.controller,\n        action: op.action,\n        path: op.channel.split('.'),\n        hasInput: operationHasInput(op),\n      };\n      return `  ${JSON.stringify(payload)},`;\n    });\n\n  return `const __WOOD_RPC_MANIFEST = [\n${entries.join('\\n')}\n];`;\n}\n\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\n/**\n * Generate a complete preload.ts file from operations.\n */\nexport function generatePreload(\n  operations: Map<string, OperationDef>,\n  options: GeneratePreloadOptions = {},\n): string {\n  const tree = buildNestedTree(operations);\n  const operationsCode = generateTreeCode(tree);\n  const rpcManifestCode = generateRpcManifestCode(operations);\n  const traceBatching = options.traceBatching ?? RENDERER_TRACE_BATCHING_DEFAULTS;\n\n  return `${generatedFileNotice(PRELOAD_SOURCE_INSTRUCTIONS)}\nimport { contextBridge, ipcRenderer } from 'electron';\nimport {\n  RendererTraceBatchTransport,\n  type WoodRendererTraceInput,\n  type WoodTraceBatch,\n  type WoodTraceBatchAcknowledgement,\n  type WoodTraceBatchPort,\n} from '@noego/wood/trace-transport';\n\n${rpcManifestCode}\n\nconst __WOOD_INTERNAL_BRIDGE_KEY = '${INTERNAL_BRIDGE_GLOBAL_KEY}';\n\ncontextBridge.exposeInMainWorld(__WOOD_INTERNAL_BRIDGE_KEY, {\n${operationsCode}\n\n  // Internal: backend controller/action RPC map for @Inject(App)\n  __rpcManifest: __WOOD_RPC_MANIFEST,\n\n  // Internal: loader data requests\n  __load: (route: string, params: Record<string, string>) =>\n    ipcRenderer.invoke('__load', { route, params }),\n\n  // Internal: cross-window navigation\n  __navigate: (windowId: string, route: string) =>\n    ipcRenderer.invoke('__navigate', { windowId, route }),\n\n  // Internal: window management\n  __window: {\n    current: () =>\n      ipcRenderer.invoke('__window', { action: 'current' }),\n    open: (windowId: string, options?: Record<string, unknown>) =>\n      ipcRenderer.invoke('__window', { action: 'open', windowId, options }),\n    close: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'close', windowId }),\n    focus: (windowId: string) =>\n      ipcRenderer.invoke('__window', { action: 'focus', windowId }),\n    minimize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'minimize', windowId }),\n    maximize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'maximize', windowId }),\n  },\n\n  // Internal: framework config (trace min level, etc)\n  __woodConfig: () =>\n    ipcRenderer.invoke('__woodConfig'),\n\n  // Internal: debug metadata\n  __debug: {\n    current: () =>\n      ipcRenderer.invoke('__debug', { action: 'current' }),\n  },\n\n  // Internal: context menu\n  __contextMenu: {\n    show: (data: unknown) =>\n      ipcRenderer.invoke('__contextMenu', { action: 'show', ...data as Record<string, unknown> }),\n  },\n\n  // Push events from main process\n  on: (channel: string, callback: (...args: unknown[]) => void) => {\n    const subscription = (_event: unknown, ...args: unknown[]) => callback(...args);\n    ipcRenderer.on(\\`__event:\\${channel}\\`, subscription);\n    return () => ipcRenderer.removeListener(\\`__event:\\${channel}\\`, subscription);\n  },\n  __trace: (event: unknown) => {\n    ipcRenderer.send('__trace', event);\n  },\n  __log: (level: string, logger: string, message: string, context?: unknown) => {\n    ipcRenderer.send('__log', { level, logger, message, context });\n  },\n  __logBatch: (batch: unknown) => {\n    ipcRenderer.send('__log_batch', batch);\n  },\n});\n\n// Trace transport via MessagePort (activated when main process sends a port)\nlet __tracePort: MessagePort | null = null;\nconst __traceBuffer: unknown[] = [];\nconst __TRACE_BUFFER_CAPACITY = 256;\nlet __traceDroppedCapacity = 0;\n\nfunction __traceFlush(): void {\n  while (__traceBuffer.length > 0 && __tracePort) {\n    __tracePort.postMessage(__traceBuffer.shift());\n  }\n}\n\nipcRenderer.on('__trace-port', (event) => {\n  __tracePort = event.ports[0];\n  __tracePort.start();\n  __traceFlush();\n});\n\ncontextBridge.exposeInMainWorld('__NOEGO_TRACE__', {\n  send: (data: unknown) => {\n    if (__tracePort) {\n      __tracePort.postMessage(data);\n    } else if (__traceBuffer.length >= __TRACE_BUFFER_CAPACITY) {\n      __traceDroppedCapacity += 1;\n    } else {\n      __traceBuffer.push(data);\n    }\n  },\n  status: () => ({\n    queuedEvents: __traceBuffer.length,\n    droppedCapacity: __traceDroppedCapacity,\n  }),\n});\n\nconst __traceBatchProducerId = typeof globalThis.crypto?.randomUUID === 'function'\n  ? globalThis.crypto.randomUUID()\n  : \\`wood-renderer-\\${Date.now()}-\\${Math.random().toString(16).slice(2)}\\`;\nlet __traceBatchListener: ((message: unknown) => void) | null = null;\n\nconst __traceBatchPort: WoodTraceBatchPort = {\n  postMessage: (batch: WoodTraceBatch) => {\n    void ipcRenderer.invoke('__traceBatch', batch)\n      .then((acknowledgement: WoodTraceBatchAcknowledgement) => {\n        __traceBatchListener?.(acknowledgement);\n      })\n      .catch((error: unknown) => {\n        __traceBatchListener?.({\n          kind: 'retryable',\n          batchId: batch.batchId,\n          reason: error instanceof Error ? error.message : String(error),\n          retryAfterMs: 100,\n        });\n      });\n  },\n  subscribe: (listener: (message: unknown) => void) => {\n    __traceBatchListener = listener;\n    return () => {\n      if (__traceBatchListener === listener) {\n        __traceBatchListener = null;\n      }\n    };\n  },\n  close: () => {\n    __traceBatchListener = null;\n  },\n};\n\n// Batching policy resolved from wood.config.yml observability configuration\n// at generation time; this file embeds but does not own it.\nconst __traceBatchTransport = new RendererTraceBatchTransport({\n  producerId: __traceBatchProducerId,\n  maxQueuedEvents: ${traceBatching.maxQueuedEvents},\n  maxBatchEvents: ${traceBatching.maxBatchEvents},\n  acknowledgementTimeoutMs: ${traceBatching.acknowledgementTimeoutMs},\n  retryLimit: ${traceBatching.retryLimit},\n  retryBaseDelayMs: ${traceBatching.retryBaseDelayMs},\n  now: () => Date.now(),\n  schedule: (work: () => void) => queueMicrotask(work),\n  delay: (durationMs: number) => new Promise((resolve) => setTimeout(resolve, durationMs)),\n});\n__traceBatchTransport.attachPort(__traceBatchPort);\n\ncontextBridge.exposeInMainWorld('__NOEGO_WOOD_TRACE_BATCH__', {\n  send: (event: WoodRendererTraceInput) => __traceBatchTransport.admit(event),\n  status: () => __traceBatchTransport.status(),\n  flush: (deadlineMs: number) => __traceBatchTransport.flush(deadlineMs),\n  close: (deadlineMs: number) => __traceBatchTransport.close(deadlineMs),\n});\n\nipcRenderer.on('__woodTraceDrainRequest', (_event, payload: unknown) => {\n  if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {\n    return;\n  }\n  const requestId = Reflect.get(payload, 'requestId');\n  const deadlineMs = Reflect.get(payload, 'deadlineMs');\n  if (typeof requestId !== 'string'\n    || typeof deadlineMs !== 'number'\n    || !Number.isFinite(deadlineMs)) {\n    return;\n  }\n  void __traceBatchTransport.close(deadlineMs).finally(() => {\n    ipcRenderer.send('__woodTraceDrainAck', {\n      requestId,\n      status: __traceBatchTransport.status(),\n    });\n  });\n});\n\nglobalThis.addEventListener?.('pagehide', () => {\n  void __traceBatchTransport.flush(Date.now() + 100);\n});\n`;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/codegen/preload_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.js';\nimport type { RendererTraceBatchingConfig } from '../types/config.js';\nimport { RENDERER_TRACE_BATCHING_DEFAULTS } from '../config/config_parser.js';\nimport { generatedFileNotice } from './generated_file_notice.js';\n\nexport type GeneratePreloadOptions = {\n  /**\n   * Renderer→main IPC trace batching policy resolved from\n   * wood.config.yml `observability.trace.rendererToMain.batching`.\n   * The generated preload embeds these values but does not own them.\n   */\n  traceBatching?: RendererTraceBatchingConfig;\n};\n\nconst PRELOAD_SOURCE_INSTRUCTIONS = [\n  'To change IPC channels or preload bridge methods, edit the operations YAML configured by',\n  'wood.config.yml main.openapi and regenerate with `wood dev` or `wood build`.',\n] as const;\n\nfunction operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys((op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {}).length > 0,\n  );\n}\n\n/**\n * Build a nested object tree from dot-path operation channels.\n * \"chat.message.send\" -> { chat: { message: { send: ... } } }\n */\nfunction buildNestedTree(operations: Map<string, OperationDef>): Record<string, unknown> {\n  const tree: Record<string, unknown> = {};\n\n  for (const [channel, op] of operations) {\n    const parts = channel.split('.');\n    let current: Record<string, unknown> = tree;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      if (!current[parts[i]]) current[parts[i]] = {};\n      current = current[parts[i]] as Record<string, unknown>;\n    }\n\n    const leaf = parts[parts.length - 1];\n    current[leaf] = { __operation: op };\n  }\n\n  return tree;\n}\n\n/**\n * Generate TypeScript code for a nested tree node.\n */\nfunction generateTreeCode(node: Record<string, unknown>, indent: string = '  '): string {\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(node)) {\n    const entry = value as Record<string, unknown>;\n    if (entry.__operation) {\n      const op = entry.__operation as OperationDef;\n      const hasInput = operationHasInput(op);\n\n      if (hasInput) {\n        lines.push(`${indent}${key}: (data: unknown) =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}', data),`);\n      } else {\n        lines.push(`${indent}${key}: () =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}'),`);\n      }\n    } else {\n      lines.push(`${indent}${key}: {`);\n      lines.push(generateTreeCode(entry, indent + '  '));\n      lines.push(`${indent}},`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\nfunction generateRpcManifestCode(operations: Map<string, OperationDef>): string {\n  const entries = Array.from(operations.values())\n    .sort((a, b) => a.channel.localeCompare(b.channel))\n    .map((op) => {\n      const payload = {\n        channel: op.channel,\n        controller: op.controller,\n        action: op.action,\n        path: op.channel.split('.'),\n        hasInput: operationHasInput(op),\n      };\n      return `  ${JSON.stringify(payload)},`;\n    });\n\n  return `const __WOOD_RPC_MANIFEST = [\n${entries.join('\\n')}\n];`;\n}\n\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\n/**\n * Generate a complete preload.ts file from operations.\n */\nexport function generatePreload(\n  operations: Map<string, OperationDef>,\n  options: GeneratePreloadOptions = {},\n): string {\n  const tree = buildNestedTree(operations);\n  const operationsCode = generateTreeCode(tree);\n  const rpcManifestCode = generateRpcManifestCode(operations);\n  const traceBatching = options.traceBatching ?? RENDERER_TRACE_BATCHING_DEFAULTS;\n\n  return `${generatedFileNotice(PRELOAD_SOURCE_INSTRUCTIONS)}\nimport { contextBridge, ipcRenderer } from 'electron';\nimport {\n  RendererTraceBatchTransport,\n  type WoodRendererTraceInput,\n  type WoodTraceBatch,\n  type WoodTraceBatchAcknowledgement,\n  type WoodTraceBatchPort,\n} from '@noego/wood/trace-transport';\n\n${rpcManifestCode}\n\nconst __WOOD_INTERNAL_BRIDGE_KEY = '${INTERNAL_BRIDGE_GLOBAL_KEY}';\n\ncontextBridge.exposeInMainWorld(__WOOD_INTERNAL_BRIDGE_KEY, {\n${operationsCode}\n\n  // Internal: backend controller/action RPC map for @Inject(App)\n  __rpcManifest: __WOOD_RPC_MANIFEST,\n\n  // Internal: loader data requests\n  __load: (route: string, params: Record<string, string>) =>\n    ipcRenderer.invoke('__load', { route, params }),\n\n  // Internal: cross-window navigation\n  __navigate: (windowId: string, route: string) =>\n    ipcRenderer.invoke('__navigate', { windowId, route }),\n\n  // Internal: window management\n  __window: {\n    current: () =>\n      ipcRenderer.invoke('__window', { action: 'current' }),\n    open: (windowId: string, options?: Record<string, unknown>) =>\n      ipcRenderer.invoke('__window', { action: 'open', windowId, options }),\n    close: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'close', windowId }),\n    focus: (windowId: string) =>\n      ipcRenderer.invoke('__window', { action: 'focus', windowId }),\n    minimize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'minimize', windowId }),\n    maximize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'maximize', windowId }),\n  },\n\n  // Internal: framework config (trace min level, etc)\n  __woodConfig: () =>\n    ipcRenderer.invoke('__woodConfig'),\n\n  // Internal: debug metadata\n  __debug: {\n    current: () =>\n      ipcRenderer.invoke('__debug', { action: 'current' }),\n  },\n\n  // Internal: context menu\n  __contextMenu: {\n    show: (data: unknown) =>\n      ipcRenderer.invoke('__contextMenu', { action: 'show', ...data as Record<string, unknown> }),\n  },\n\n  // Push events from main process\n  on: (channel: string, callback: (...args: unknown[]) => void) => {\n    const subscription = (_event: unknown, ...args: unknown[]) => callback(...args);\n    ipcRenderer.on(\\`__event:\\${channel}\\`, subscription);\n    return () => ipcRenderer.removeListener(\\`__event:\\${channel}\\`, subscription);\n  },\n  __trace: (event: unknown) => {\n    ipcRenderer.send('__trace', event);\n  },\n  __log: (level: string, logger: string, message: string, context?: unknown) => {\n    ipcRenderer.send('__log', { level, logger, message, context });\n  },\n  __logBatch: (batch: unknown) => {\n    ipcRenderer.send('__log_batch', batch);\n  },\n});\n\n// Trace transport via MessagePort (activated when main process sends a port)\nlet __tracePort: MessagePort | null = null;\nconst __traceBuffer: unknown[] = [];\nconst __TRACE_BUFFER_CAPACITY = 256;\nlet __traceDroppedCapacity = 0;\n\nfunction __traceFlush(): void {\n  while (__traceBuffer.length > 0 && __tracePort) {\n    __tracePort.postMessage(__traceBuffer.shift());\n  }\n}\n\nipcRenderer.on('__trace-port', (event) => {\n  __tracePort = event.ports[0];\n  __tracePort.start();\n  __traceFlush();\n});\n\ncontextBridge.exposeInMainWorld('__NOEGO_TRACE__', {\n  send: (data: unknown) => {\n    if (__tracePort) {\n      __tracePort.postMessage(data);\n    } else if (__traceBuffer.length >= __TRACE_BUFFER_CAPACITY) {\n      __traceDroppedCapacity += 1;\n    } else {\n      __traceBuffer.push(data);\n    }\n  },\n  status: () => ({\n    queuedEvents: __traceBuffer.length,\n    droppedCapacity: __traceDroppedCapacity,\n  }),\n});\n\nconst __traceBatchProducerId = typeof globalThis.crypto?.randomUUID === 'function'\n  ? globalThis.crypto.randomUUID()\n  : \\`wood-renderer-\\${Date.now()}-\\${Math.random().toString(16).slice(2)}\\`;\nlet __traceBatchListener: ((message: unknown) => void) | null = null;\n\nconst __traceBatchPort: WoodTraceBatchPort = {\n  postMessage: (batch: WoodTraceBatch) => {\n    void ipcRenderer.invoke('__traceBatch', batch)\n      .then((acknowledgement: WoodTraceBatchAcknowledgement) => {\n        __traceBatchListener?.(acknowledgement);\n      })\n      .catch((error: unknown) => {\n        __traceBatchListener?.({\n          kind: 'retryable',\n          batchId: batch.batchId,\n          reason: error instanceof Error ? error.message : String(error),\n          retryAfterMs: 100,\n        });\n      });\n  },\n  subscribe: (listener: (message: unknown) => void) => {\n    __traceBatchListener = listener;\n    return () => {\n      if (__traceBatchListener === listener) {\n        __traceBatchListener = null;\n      }\n    };\n  },\n  close: () => {\n    __traceBatchListener = null;\n  },\n};\n\n// Batching policy resolved from wood.config.yml observability configuration\n// at generation time; this file embeds but does not own it.\nconst __traceBatchTransport = new RendererTraceBatchTransport({\n  producerId: __traceBatchProducerId,\n  maxQueuedEvents: ${traceBatching.maxQueuedEvents},\n  maxBatchEvents: ${traceBatching.maxBatchEvents},\n  acknowledgementTimeoutMs: ${traceBatching.acknowledgementTimeoutMs},\n  retryLimit: ${traceBatching.retryLimit},\n  retryBaseDelayMs: ${traceBatching.retryBaseDelayMs},\n  now: () => Date.now(),\n  schedule: (work: () => void) => queueMicrotask(work),\n  delay: (durationMs: number) => new Promise((resolve) => setTimeout(resolve, durationMs)),\n});\n__traceBatchTransport.attachPort(__traceBatchPort);\n\ncontextBridge.exposeInMainWorld('__NOEGO_WOOD_TRACE_BATCH__', {\n  send: (event: WoodRendererTraceInput) => __traceBatchTransport.admit(event),\n  status: () => __traceBatchTransport.status(),\n  flush: (deadlineMs: number) => __traceBatchTransport.flush(deadlineMs),\n  close: (deadlineMs: number) => __traceBatchTransport.close(deadlineMs),\n});\n\n// App-registered shutdown drain hooks (essential user-state persistence).\n// Main waits for the drain acknowledgement, bounded by deadlineMs, before it\n// destroys this window, so hooks must flush quickly and never block forever.\ntype __WoodShutdownDrainHook = (deadlineMs: number) => unknown;\nconst __shutdownDrainHooks = new Set<__WoodShutdownDrainHook>();\n\nasync function __runShutdownDrainHooks(deadlineMs: number): Promise<{ hooks: number; settled: number; failed: number }> {\n  const hooks = [...__shutdownDrainHooks];\n  if (hooks.length === 0) {\n    return { hooks: 0, settled: 0, failed: 0 };\n  }\n  const remainingMs = Math.max(0, deadlineMs - Date.now());\n  const outcomes = await Promise.race([\n    Promise.allSettled(hooks.map(async (hook) => hook(deadlineMs))),\n    new Promise<null>((resolve) => setTimeout(() => resolve(null), remainingMs)),\n  ]);\n  if (outcomes === null) {\n    return { hooks: hooks.length, settled: 0, failed: 0 };\n  }\n  const failed = outcomes.filter((outcome) => outcome.status === 'rejected').length;\n  return { hooks: hooks.length, settled: outcomes.length, failed };\n}\n\ncontextBridge.exposeInMainWorld('__NOEGO_WOOD_SHUTDOWN__', {\n  onDrain: (hook: __WoodShutdownDrainHook) => {\n    if (typeof hook !== 'function') {\n      return () => {};\n    }\n    __shutdownDrainHooks.add(hook);\n    return () => { __shutdownDrainHooks.delete(hook); };\n  },\n});\n\nipcRenderer.on('__woodTraceDrainRequest', (_event, payload: unknown) => {\n  if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {\n    return;\n  }\n  const requestId = Reflect.get(payload, 'requestId');\n  const deadlineMs = Reflect.get(payload, 'deadlineMs');\n  if (typeof requestId !== 'string'\n    || typeof deadlineMs !== 'number'\n    || !Number.isFinite(deadlineMs)) {\n    return;\n  }\n  let persistence: { hooks: number; settled: number; failed: number } = { hooks: 0, settled: 0, failed: 0 };\n  void __runShutdownDrainHooks(deadlineMs)\n    .then((result) => { persistence = result; })\n    .catch(() => {})\n    .then(() => __traceBatchTransport.close(deadlineMs))\n    .finally(() => {\n      ipcRenderer.send('__woodTraceDrainAck', {\n        requestId,\n        status: __traceBatchTransport.status(),\n        persistence,\n      });\n    });\n});\n\nglobalThis.addEventListener?.('pagehide', () => {\n  void __traceBatchTransport.flush(Date.now() + 100);\n});\n`;\n}\n"],"mappings":"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","names":[]}

package/dist/codegen/renderer_app_generator.cjs

@@ -269,15 +269,8 @@ function createScopedContainer(): WoodScopedContainer {
     throw new Error('Wood client container does not support get().');
   }
 
-  if (typeof scopedContainer.registerFunction === 'function') {
-    // Explicit Singleton lifetime: these return renderer-root globals, and
-    // registerFunction defaults to Transient \u2014 rejected by ioc >= 0.5's
-    // captive-lifetime validation under singleton dependents.
-    const singleton = { loadAs: 0 /* LoadAs.Singleton */ };
-    scopedContainer.registerFunction(Navigation, () => getNavigation(), singleton);
-    scopedContainer.registerFunction(App, () => getApp(), singleton);
-    scopedContainer.registerFunction(Ipc, () => getIpc(), singleton);
-  }
+  // Renderer builtins belong to the root created by getContainer().
+  // Page scopes inherit them; re-registering resolved ancestor singletons is invalid.
 
   return scopedContainer as WoodScopedContainer;
 }

package/dist/codegen/renderer_app_generator.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/renderer_app_generator.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport path from 'path';\nimport type { ViewDef } from '../types/index.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nconst RENDERER_APP_SOURCE_INSTRUCTIONS = [\n  'To change routes, page components, layouts, or renderer controllers, edit the views YAML',\n  'configured by wood.config.yml renderer.openapi and the matching UI source files.',\n] as const;\n\nexport interface RendererAppGeneratorOptions {\n  /** Absolute path to renderer component root (e.g. /app/ui) */\n  componentDir: string;\n  /** Absolute output directory where generated file will be written */\n  outDir: string;\n  /** Optional explicit default view key (e.g. \"main.chat\") */\n  entryViewKey?: string;\n}\n\nfunction computeImportPath(fromDir: string, toFile: string): string {\n  let rel = path.relative(fromDir, toFile);\n\n  if (!rel.startsWith('.')) {\n    rel = './' + rel;\n  }\n\n  return rel.replace(/\\\\/g, '/');\n}\n\nfunction resolveFromComponentDir(componentDir: string, fileRef: string): string {\n  if (path.isAbsolute(fileRef)) {\n    return fileRef;\n  }\n\n  const normalizedRef = fileRef.replace(/\\\\/g, '/');\n  const componentDirName = path.basename(componentDir).replace(/\\\\/g, '/');\n\n  if (normalizedRef.startsWith(componentDirName + '/')) {\n    const stripped = normalizedRef.slice(componentDirName.length + 1);\n    return path.resolve(componentDir, stripped);\n  }\n\n  return path.resolve(componentDir, normalizedRef);\n}\n\nfunction viewKey(view: ViewDef): string {\n  return `${view.windowName}.${view.pageName}`;\n}\n\nfunction toIdentifier(prefix: string, value: string): string {\n  const core = value\n    .replace(/[^a-zA-Z0-9]+/g, ' ')\n    .trim()\n    .split(/\\s+/)\n    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))\n    .join('');\n\n  return `${prefix}${core || 'Component'}`;\n}\n\nfunction escapeSingleQuoted(value: string): string {\n  return value.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n}\n\nconst CONTROLLER_FILE_SUFFIXES = [\n  '.ts',\n  '.js',\n  '.controller.ts',\n  '.controller.js',\n] as const;\n\nconst CONTROLLER_INDEX_CANDIDATES = [\n  'index.ts',\n  'index.js',\n] as const;\n\nfunction resolveControllerFile(controllerRef: string, componentDir: string): string | null {\n  const normalized = controllerRef.trim();\n  const basePath = resolveFromComponentDir(componentDir, normalized);\n\n  if (existsSync(basePath)) {\n    return basePath;\n  }\n\n  if (path.extname(basePath)) {\n    return null;\n  }\n\n  for (const suffix of CONTROLLER_FILE_SUFFIXES) {\n    const candidate = basePath + suffix;\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  for (const indexFile of CONTROLLER_INDEX_CANDIDATES) {\n    const candidate = path.resolve(basePath, indexFile);\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  return null;\n}\n\nfunction resolveDefaultViewKey(sortedViews: ViewDef[], entryViewKey?: string): string {\n  if (sortedViews.length === 0) return '';\n\n  const configuredEntry = entryViewKey?.trim();\n  if (!configuredEntry) {\n    return viewKey(sortedViews[0]);\n  }\n\n  const availableKeys = sortedViews.map((view) => viewKey(view));\n  if (availableKeys.includes(configuredEntry)) {\n    return configuredEntry;\n  }\n\n  throw new Error(\n    `Renderer entry \"${configuredEntry}\" was not found in parsed views. Available view keys: ${availableKeys.join(', ')}`,\n  );\n}\n\nexport function generateRendererApp(\n  views: ViewDef[],\n  options: RendererAppGeneratorOptions,\n): string {\n  const sortedViews = [...views].sort((a, b) => viewKey(a).localeCompare(viewKey(b)));\n  const defaultViewKey = resolveDefaultViewKey(sortedViews, options.entryViewKey);\n\n  const importLines: string[] = [];\n  const viewIdentifiers = new Map<string, string>();\n  const layoutIdentifiers = new Map<string, string>();\n  const controllerIdentifiers = new Map<string, { identifier: string; importPath: string }>();\n  const usedNames = new Set<string>();\n\n  const allocateName = (prefix: string, filePath: string): string => {\n    const base = toIdentifier(prefix, filePath);\n    let name = base;\n    let suffix = 2;\n    while (usedNames.has(name)) {\n      name = `${base}${suffix}`;\n      suffix += 1;\n    }\n    usedNames.add(name);\n    return name;\n  };\n\n  const ensureControllerImported = (controllerRef: string, owningViewKey: string): void => {\n    if (controllerIdentifiers.has(controllerRef)) return;\n\n    const resolvedControllerFile = resolveControllerFile(controllerRef, options.componentDir);\n    if (!resolvedControllerFile) {\n      throw new Error(\n        `Renderer app codegen failed: controller \"${controllerRef}\" for view \"${owningViewKey}\" was not found. ` +\n        'Controller must point to an existing file with a default exported class.',\n      );\n    }\n\n    const identifier = allocateName('PageController', controllerRef);\n    const importPath = computeImportPath(options.outDir, resolvedControllerFile);\n    controllerIdentifiers.set(controllerRef, { identifier, importPath });\n    importLines.push(`import ${identifier} from '${importPath}';`);\n  };\n\n  for (const view of sortedViews) {\n    if (!viewIdentifiers.has(view.viewPath)) {\n      const identifier = allocateName('View', view.viewPath);\n      viewIdentifiers.set(view.viewPath, identifier);\n      const abs = resolveFromComponentDir(options.componentDir, view.viewPath);\n      const importPath = computeImportPath(options.outDir, abs);\n      importLines.push(`import ${identifier} from '${importPath}';`);\n    }\n\n    for (const layoutPath of view.layouts) {\n      if (layoutIdentifiers.has(layoutPath)) continue;\n      const identifier = allocateName('Layout', layoutPath);\n      layoutIdentifiers.set(layoutPath, identifier);\n      const abs = resolveFromComponentDir(options.componentDir, layoutPath);\n      const importPath = computeImportPath(options.outDir, abs);\n      importLines.push(`import ${identifier} from '${importPath}';`);\n    }\n\n    if (view.controller) {\n      ensureControllerImported(view.controller, viewKey(view));\n    }\n\n    for (const layoutController of view.layoutControllers ?? []) {\n      if (!layoutController) continue;\n      ensureControllerImported(layoutController, viewKey(view));\n    }\n  }\n\n  const manifestEntries = sortedViews.map((view) => {\n    const key = viewKey(view);\n    const viewIdentifier = viewIdentifiers.get(view.viewPath)!;\n    const layoutList = view.layouts.map((layoutPath) => layoutIdentifiers.get(layoutPath)!);\n    const controllerPath = view.controller ? `'${escapeSingleQuoted(view.controller)}'` : 'undefined';\n    const controllerClass = view.controller\n      ? controllerIdentifiers.get(view.controller)!.identifier\n      : 'undefined';\n    const layoutControllerRefs = view.layoutControllers;\n    if (layoutControllerRefs && layoutControllerRefs.length !== view.layouts.length) {\n      throw new Error(\n        `Renderer app codegen failed: layout controller count for view \"${key}\" does not match layout count.`,\n      );\n    }\n    const normalizedLayoutControllerRefs = layoutControllerRefs ?? Array.from(\n      { length: view.layouts.length },\n      () => undefined,\n    );\n    const layoutControllerPaths = `[${normalizedLayoutControllerRefs\n      .map((controllerRef) => (controllerRef ? `'${escapeSingleQuoted(controllerRef)}'` : 'undefined'))\n      .join(', ')}]`;\n    const layoutControllerClasses = `[${normalizedLayoutControllerRefs\n      .map((controllerRef) => (controllerRef ? controllerIdentifiers.get(controllerRef)!.identifier : 'undefined'))\n      .join(', ')}]`;\n    const layoutPreserve = view.layoutPreserve ?? Array.from(\n      { length: view.layouts.length },\n      () => false,\n    );\n    if (layoutPreserve.length !== view.layouts.length) {\n      throw new Error(\n        `Renderer app codegen failed: layout preserve count for view \"${key}\" does not match layout count.`,\n      );\n    }\n\n    return `  '${escapeSingleQuoted(key)}': {\n    key: '${escapeSingleQuoted(key)}',\n    windowName: '${escapeSingleQuoted(view.windowName)}',\n    pageName: '${escapeSingleQuoted(view.pageName)}',\n    viewPath: '${escapeSingleQuoted(view.viewPath)}',\n    layoutPaths: ${JSON.stringify(view.layouts)},\n    layoutControllers: ${layoutControllerPaths},\n    layoutPreserve: ${JSON.stringify(layoutPreserve)},\n    controller: ${controllerPath},\n    layoutControllerClasses: ${layoutControllerClasses},\n    controllerClass: ${controllerClass},\n    view: ${viewIdentifier},\n    layouts: [${layoutList.join(', ')}],\n  },`;\n  });\n\n  return `${generatedFileNotice(RENDERER_APP_SOURCE_INSTRUCTIONS)}\nimport { mount } from 'svelte';\nimport { App, getApp, getContainer } from '@noego/wood/client';\nimport { Navigation, getNavigation, installAutomationIntrospection } from '@noego/wood/navigation';\nimport { Ipc, getIpc } from '@noego/wood/ipc';\nimport NavigationShell from '@noego/wood/navigation-shell';\n${importLines.join('\\n')}\n\ninterface GeneratedAppViewEntry {\n  key: string;\n  windowName: string;\n  pageName: string;\n  viewPath: string;\n  layoutPaths: string[];\n  layoutControllers: Array<string | undefined>;\n  layoutPreserve: boolean[];\n  controller?: string;\n  layoutControllerClasses: Array<any | undefined>;\n  controllerClass?: any;\n  view: any;\n  layouts: any[];\n}\n\nconst VIEW_MANIFEST: Record<string, GeneratedAppViewEntry> = {\n${manifestEntries.join('\\n')}\n};\n\nfunction getViewManifestEntry(viewKey: string): GeneratedAppViewEntry | null {\n  return VIEW_MANIFEST[viewKey] ?? null;\n}\n\ninterface WoodScopedContainer {\n  get(token: any): unknown | Promise<unknown>;\n  registerClass?(token: any): void;\n  registerFunction?(\n    token: any,\n    resolver: (...args: any[]) => unknown,\n    options?: Record<string, unknown>,\n  ): void;\n}\n\ninterface WoodContainer extends WoodScopedContainer {\n  extend?(): WoodScopedContainer;\n}\n\nfunction createScopedContainer(): WoodScopedContainer {\n  const container = getContainer() as WoodContainer;\n  if (typeof container.extend !== 'function') {\n    throw new Error('Wood client container does not support extend().');\n  }\n\n  const scopedContainer = container.extend();\n\n  if (!scopedContainer || typeof scopedContainer.get !== 'function') {\n    throw new Error('Wood client container does not support get().');\n  }\n\n  if (typeof scopedContainer.registerFunction === 'function') {\n    // Explicit Singleton lifetime: these return renderer-root globals, and\n    // registerFunction defaults to Transient — rejected by ioc >= 0.5's\n    // captive-lifetime validation under singleton dependents.\n    const singleton = { loadAs: 0 /* LoadAs.Singleton */ };\n    scopedContainer.registerFunction(Navigation, () => getNavigation(), singleton);\n    scopedContainer.registerFunction(App, () => getApp(), singleton);\n    scopedContainer.registerFunction(Ipc, () => getIpc(), singleton);\n  }\n\n  return scopedContainer as WoodScopedContainer;\n}\n\nasync function resolveControllerInScope(\n  scope: WoodScopedContainer,\n  entry: GeneratedAppViewEntry,\n  ControllerClass: any,\n  contextLabel: string,\n): Promise<unknown> {\n  if (typeof ControllerClass !== 'function') {\n    throw new Error(\n      \\`Controller for \\${contextLabel} in view \"\\${entry.key}\" is invalid. Expected a default exported class.\\`,\n    );\n  }\n\n  if (typeof scope.registerClass === 'function') {\n    scope.registerClass(ControllerClass);\n  }\n\n  return await scope.get(ControllerClass);\n}\n\nasync function disposeScopeQuietly(scope: { dispose?: () => Promise<void> } | null): Promise<void> {\n  if (!scope || typeof scope.dispose !== 'function') return;\n  try {\n    await scope.dispose();\n  } catch (error) {\n    console.error('[wood] renderer scope disposal failed:', error);\n  }\n}\n\n/**\n * One page scope per view lifecycle: the view controller and every\n * non-preservable layout controller resolve from the SAME scope, so Scoped\n * services/state are shared within the page (the NoEgo renderer model).\n * Layouts marked preservable in the manifest own dedicated scopes that\n * survive page transitions and dispose when the layout finally leaves.\n */\nasync function createControllerSet(\n  entry: GeneratedAppViewEntry,\n  preservedDepth = 0,\n): Promise<{\n  controller: unknown;\n  layoutControllers: Array<unknown>;\n  pageScope: WoodScopedContainer;\n  layoutScopes: Array<WoodScopedContainer | null>;\n}> {\n  const pageScope = createScopedContainer();\n  const layoutControllers: unknown[] = [];\n  const layoutScopes: Array<WoodScopedContainer | null> = [];\n  const createdLayoutScopes: WoodScopedContainer[] = [];\n\n  try {\n    for (let i = 0; i < preservedDepth; i += 1) {\n      layoutControllers.push(undefined);\n      layoutScopes.push(null);\n    }\n\n    for (let i = preservedDepth; i < entry.layoutControllerClasses.length; i += 1) {\n      const LayoutController = entry.layoutControllerClasses[i];\n      if (!LayoutController) {\n        layoutControllers.push(undefined);\n        layoutScopes.push(null);\n        continue;\n      }\n      const preservable = entry.layoutPreserve?.[i] === true;\n      let scope = pageScope;\n      if (preservable) {\n        scope = createScopedContainer();\n        createdLayoutScopes.push(scope);\n      }\n      const controller = await resolveControllerInScope(\n        scope,\n        entry,\n        LayoutController,\n        \\`layout[\\${i}]\\`,\n      );\n      layoutControllers.push(controller);\n      layoutScopes.push(preservable ? scope : null);\n    }\n\n    const controller = entry.controllerClass\n      ? await resolveControllerInScope(pageScope, entry, entry.controllerClass, 'page')\n      : undefined;\n\n    return { controller, layoutControllers, pageScope, layoutScopes };\n  } catch (error) {\n    // Failed transitions must not orphan scopes: dispose everything this\n    // set created before rethrowing.\n    for (const scope of createdLayoutScopes) await disposeScopeQuietly(scope as any);\n    await disposeScopeQuietly(pageScope as any);\n    throw error;\n  }\n}\n\nconst DEFAULT_VIEW_KEY = '${escapeSingleQuoted(defaultViewKey)}';\n\ntype WoodWindowBootstrapInfo = {\n  ok?: boolean;\n  windowId?: string;\n  defaultRoute?: string;\n};\n\ntype WoodBootstrapBridgeLike = {\n  __window?: {\n    current?: () => Promise<WoodWindowBootstrapInfo>;\n  };\n};\n\nfunction getWoodBridge(): WoodBootstrapBridgeLike | null {\n  const globalObj = globalThis as typeof globalThis & {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    window?: {\n      __NOEGO_WOOD_BRIDGE__?: unknown;\n    };\n  };\n\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__ ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n\n  return bridge as WoodBootstrapBridgeLike;\n}\n\nasync function resolveInitialEntry(): Promise<GeneratedAppViewEntry> {\n  if (!DEFAULT_VIEW_KEY) {\n    throw new Error('No views available in renderer manifest. Define at least one view in renderer OpenAPI YAML.');\n  }\n\n  const bridge = getWoodBridge();\n  const bootstrapWindow = await bridge?.__window?.current?.();\n  const requestedRoute = bootstrapWindow?.defaultRoute;\n\n  if (requestedRoute) {\n    const routeEntry = getViewManifestEntry(requestedRoute);\n    if (routeEntry) {\n      return routeEntry;\n    }\n  }\n\n  const entry = getViewManifestEntry(DEFAULT_VIEW_KEY);\n  if (!entry) {\n    throw new Error(\\`Default view \"\\${DEFAULT_VIEW_KEY}\" is missing from generated view manifest.\\`);\n  }\n\n  return entry;\n}\n\nfunction isAutomationBuild(): boolean {\n  try {\n    const env = (import.meta as { env?: { DEV?: boolean; MODE?: string } }).env;\n    return Boolean(env?.DEV) || env?.MODE === 'test';\n  } catch {\n    return false;\n  }\n}\n\nexport async function app(target: Element) {\n  const entry = await resolveInitialEntry();\n\n  getNavigation().replace(entry.key, {}, {});\n\n  // Dev/test-only Axe introspection surface; never present in production builds.\n  if (isAutomationBuild()) {\n    const bootstrapWindow = await getWoodBridge()?.__window?.current?.();\n    installAutomationIntrospection({ windowId: bootstrapWindow?.windowId ?? null });\n  }\n  const initialSet = await createControllerSet(entry);\n\n  return mount(NavigationShell, {\n    target,\n    props: {\n      manifest: VIEW_MANIFEST,\n      initialEntry: entry,\n      initialControllerSet: initialSet,\n      createControllerSetFn: createControllerSet,\n      getViewManifestEntryFn: getViewManifestEntry,\n    },\n  });\n}\n`;\n}\n"],"mappings":"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","names":["path"]}
+{"version":3,"sources":["../../src/codegen/renderer_app_generator.ts"],"sourcesContent":["import { existsSync } from 'fs';\nimport path from 'path';\nimport type { ViewDef } from '../types/index.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nconst RENDERER_APP_SOURCE_INSTRUCTIONS = [\n  'To change routes, page components, layouts, or renderer controllers, edit the views YAML',\n  'configured by wood.config.yml renderer.openapi and the matching UI source files.',\n] as const;\n\nexport interface RendererAppGeneratorOptions {\n  /** Absolute path to renderer component root (e.g. /app/ui) */\n  componentDir: string;\n  /** Absolute output directory where generated file will be written */\n  outDir: string;\n  /** Optional explicit default view key (e.g. \"main.chat\") */\n  entryViewKey?: string;\n}\n\nfunction computeImportPath(fromDir: string, toFile: string): string {\n  let rel = path.relative(fromDir, toFile);\n\n  if (!rel.startsWith('.')) {\n    rel = './' + rel;\n  }\n\n  return rel.replace(/\\\\/g, '/');\n}\n\nfunction resolveFromComponentDir(componentDir: string, fileRef: string): string {\n  if (path.isAbsolute(fileRef)) {\n    return fileRef;\n  }\n\n  const normalizedRef = fileRef.replace(/\\\\/g, '/');\n  const componentDirName = path.basename(componentDir).replace(/\\\\/g, '/');\n\n  if (normalizedRef.startsWith(componentDirName + '/')) {\n    const stripped = normalizedRef.slice(componentDirName.length + 1);\n    return path.resolve(componentDir, stripped);\n  }\n\n  return path.resolve(componentDir, normalizedRef);\n}\n\nfunction viewKey(view: ViewDef): string {\n  return `${view.windowName}.${view.pageName}`;\n}\n\nfunction toIdentifier(prefix: string, value: string): string {\n  const core = value\n    .replace(/[^a-zA-Z0-9]+/g, ' ')\n    .trim()\n    .split(/\\s+/)\n    .map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1))\n    .join('');\n\n  return `${prefix}${core || 'Component'}`;\n}\n\nfunction escapeSingleQuoted(value: string): string {\n  return value.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\");\n}\n\nconst CONTROLLER_FILE_SUFFIXES = [\n  '.ts',\n  '.js',\n  '.controller.ts',\n  '.controller.js',\n] as const;\n\nconst CONTROLLER_INDEX_CANDIDATES = [\n  'index.ts',\n  'index.js',\n] as const;\n\nfunction resolveControllerFile(controllerRef: string, componentDir: string): string | null {\n  const normalized = controllerRef.trim();\n  const basePath = resolveFromComponentDir(componentDir, normalized);\n\n  if (existsSync(basePath)) {\n    return basePath;\n  }\n\n  if (path.extname(basePath)) {\n    return null;\n  }\n\n  for (const suffix of CONTROLLER_FILE_SUFFIXES) {\n    const candidate = basePath + suffix;\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  for (const indexFile of CONTROLLER_INDEX_CANDIDATES) {\n    const candidate = path.resolve(basePath, indexFile);\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  return null;\n}\n\nfunction resolveDefaultViewKey(sortedViews: ViewDef[], entryViewKey?: string): string {\n  if (sortedViews.length === 0) return '';\n\n  const configuredEntry = entryViewKey?.trim();\n  if (!configuredEntry) {\n    return viewKey(sortedViews[0]);\n  }\n\n  const availableKeys = sortedViews.map((view) => viewKey(view));\n  if (availableKeys.includes(configuredEntry)) {\n    return configuredEntry;\n  }\n\n  throw new Error(\n    `Renderer entry \"${configuredEntry}\" was not found in parsed views. Available view keys: ${availableKeys.join(', ')}`,\n  );\n}\n\nexport function generateRendererApp(\n  views: ViewDef[],\n  options: RendererAppGeneratorOptions,\n): string {\n  const sortedViews = [...views].sort((a, b) => viewKey(a).localeCompare(viewKey(b)));\n  const defaultViewKey = resolveDefaultViewKey(sortedViews, options.entryViewKey);\n\n  const importLines: string[] = [];\n  const viewIdentifiers = new Map<string, string>();\n  const layoutIdentifiers = new Map<string, string>();\n  const controllerIdentifiers = new Map<string, { identifier: string; importPath: string }>();\n  const usedNames = new Set<string>();\n\n  const allocateName = (prefix: string, filePath: string): string => {\n    const base = toIdentifier(prefix, filePath);\n    let name = base;\n    let suffix = 2;\n    while (usedNames.has(name)) {\n      name = `${base}${suffix}`;\n      suffix += 1;\n    }\n    usedNames.add(name);\n    return name;\n  };\n\n  const ensureControllerImported = (controllerRef: string, owningViewKey: string): void => {\n    if (controllerIdentifiers.has(controllerRef)) return;\n\n    const resolvedControllerFile = resolveControllerFile(controllerRef, options.componentDir);\n    if (!resolvedControllerFile) {\n      throw new Error(\n        `Renderer app codegen failed: controller \"${controllerRef}\" for view \"${owningViewKey}\" was not found. ` +\n        'Controller must point to an existing file with a default exported class.',\n      );\n    }\n\n    const identifier = allocateName('PageController', controllerRef);\n    const importPath = computeImportPath(options.outDir, resolvedControllerFile);\n    controllerIdentifiers.set(controllerRef, { identifier, importPath });\n    importLines.push(`import ${identifier} from '${importPath}';`);\n  };\n\n  for (const view of sortedViews) {\n    if (!viewIdentifiers.has(view.viewPath)) {\n      const identifier = allocateName('View', view.viewPath);\n      viewIdentifiers.set(view.viewPath, identifier);\n      const abs = resolveFromComponentDir(options.componentDir, view.viewPath);\n      const importPath = computeImportPath(options.outDir, abs);\n      importLines.push(`import ${identifier} from '${importPath}';`);\n    }\n\n    for (const layoutPath of view.layouts) {\n      if (layoutIdentifiers.has(layoutPath)) continue;\n      const identifier = allocateName('Layout', layoutPath);\n      layoutIdentifiers.set(layoutPath, identifier);\n      const abs = resolveFromComponentDir(options.componentDir, layoutPath);\n      const importPath = computeImportPath(options.outDir, abs);\n      importLines.push(`import ${identifier} from '${importPath}';`);\n    }\n\n    if (view.controller) {\n      ensureControllerImported(view.controller, viewKey(view));\n    }\n\n    for (const layoutController of view.layoutControllers ?? []) {\n      if (!layoutController) continue;\n      ensureControllerImported(layoutController, viewKey(view));\n    }\n  }\n\n  const manifestEntries = sortedViews.map((view) => {\n    const key = viewKey(view);\n    const viewIdentifier = viewIdentifiers.get(view.viewPath)!;\n    const layoutList = view.layouts.map((layoutPath) => layoutIdentifiers.get(layoutPath)!);\n    const controllerPath = view.controller ? `'${escapeSingleQuoted(view.controller)}'` : 'undefined';\n    const controllerClass = view.controller\n      ? controllerIdentifiers.get(view.controller)!.identifier\n      : 'undefined';\n    const layoutControllerRefs = view.layoutControllers;\n    if (layoutControllerRefs && layoutControllerRefs.length !== view.layouts.length) {\n      throw new Error(\n        `Renderer app codegen failed: layout controller count for view \"${key}\" does not match layout count.`,\n      );\n    }\n    const normalizedLayoutControllerRefs = layoutControllerRefs ?? Array.from(\n      { length: view.layouts.length },\n      () => undefined,\n    );\n    const layoutControllerPaths = `[${normalizedLayoutControllerRefs\n      .map((controllerRef) => (controllerRef ? `'${escapeSingleQuoted(controllerRef)}'` : 'undefined'))\n      .join(', ')}]`;\n    const layoutControllerClasses = `[${normalizedLayoutControllerRefs\n      .map((controllerRef) => (controllerRef ? controllerIdentifiers.get(controllerRef)!.identifier : 'undefined'))\n      .join(', ')}]`;\n    const layoutPreserve = view.layoutPreserve ?? Array.from(\n      { length: view.layouts.length },\n      () => false,\n    );\n    if (layoutPreserve.length !== view.layouts.length) {\n      throw new Error(\n        `Renderer app codegen failed: layout preserve count for view \"${key}\" does not match layout count.`,\n      );\n    }\n\n    return `  '${escapeSingleQuoted(key)}': {\n    key: '${escapeSingleQuoted(key)}',\n    windowName: '${escapeSingleQuoted(view.windowName)}',\n    pageName: '${escapeSingleQuoted(view.pageName)}',\n    viewPath: '${escapeSingleQuoted(view.viewPath)}',\n    layoutPaths: ${JSON.stringify(view.layouts)},\n    layoutControllers: ${layoutControllerPaths},\n    layoutPreserve: ${JSON.stringify(layoutPreserve)},\n    controller: ${controllerPath},\n    layoutControllerClasses: ${layoutControllerClasses},\n    controllerClass: ${controllerClass},\n    view: ${viewIdentifier},\n    layouts: [${layoutList.join(', ')}],\n  },`;\n  });\n\n  return `${generatedFileNotice(RENDERER_APP_SOURCE_INSTRUCTIONS)}\nimport { mount } from 'svelte';\nimport { App, getApp, getContainer } from '@noego/wood/client';\nimport { Navigation, getNavigation, installAutomationIntrospection } from '@noego/wood/navigation';\nimport { Ipc, getIpc } from '@noego/wood/ipc';\nimport NavigationShell from '@noego/wood/navigation-shell';\n${importLines.join('\\n')}\n\ninterface GeneratedAppViewEntry {\n  key: string;\n  windowName: string;\n  pageName: string;\n  viewPath: string;\n  layoutPaths: string[];\n  layoutControllers: Array<string | undefined>;\n  layoutPreserve: boolean[];\n  controller?: string;\n  layoutControllerClasses: Array<any | undefined>;\n  controllerClass?: any;\n  view: any;\n  layouts: any[];\n}\n\nconst VIEW_MANIFEST: Record<string, GeneratedAppViewEntry> = {\n${manifestEntries.join('\\n')}\n};\n\nfunction getViewManifestEntry(viewKey: string): GeneratedAppViewEntry | null {\n  return VIEW_MANIFEST[viewKey] ?? null;\n}\n\ninterface WoodScopedContainer {\n  get(token: any): unknown | Promise<unknown>;\n  registerClass?(token: any): void;\n  registerFunction?(\n    token: any,\n    resolver: (...args: any[]) => unknown,\n    options?: Record<string, unknown>,\n  ): void;\n}\n\ninterface WoodContainer extends WoodScopedContainer {\n  extend?(): WoodScopedContainer;\n}\n\nfunction createScopedContainer(): WoodScopedContainer {\n  const container = getContainer() as WoodContainer;\n  if (typeof container.extend !== 'function') {\n    throw new Error('Wood client container does not support extend().');\n  }\n\n  const scopedContainer = container.extend();\n\n  if (!scopedContainer || typeof scopedContainer.get !== 'function') {\n    throw new Error('Wood client container does not support get().');\n  }\n\n  // Renderer builtins belong to the root created by getContainer().\n  // Page scopes inherit them; re-registering resolved ancestor singletons is invalid.\n\n  return scopedContainer as WoodScopedContainer;\n}\n\nasync function resolveControllerInScope(\n  scope: WoodScopedContainer,\n  entry: GeneratedAppViewEntry,\n  ControllerClass: any,\n  contextLabel: string,\n): Promise<unknown> {\n  if (typeof ControllerClass !== 'function') {\n    throw new Error(\n      \\`Controller for \\${contextLabel} in view \"\\${entry.key}\" is invalid. Expected a default exported class.\\`,\n    );\n  }\n\n  if (typeof scope.registerClass === 'function') {\n    scope.registerClass(ControllerClass);\n  }\n\n  return await scope.get(ControllerClass);\n}\n\nasync function disposeScopeQuietly(scope: { dispose?: () => Promise<void> } | null): Promise<void> {\n  if (!scope || typeof scope.dispose !== 'function') return;\n  try {\n    await scope.dispose();\n  } catch (error) {\n    console.error('[wood] renderer scope disposal failed:', error);\n  }\n}\n\n/**\n * One page scope per view lifecycle: the view controller and every\n * non-preservable layout controller resolve from the SAME scope, so Scoped\n * services/state are shared within the page (the NoEgo renderer model).\n * Layouts marked preservable in the manifest own dedicated scopes that\n * survive page transitions and dispose when the layout finally leaves.\n */\nasync function createControllerSet(\n  entry: GeneratedAppViewEntry,\n  preservedDepth = 0,\n): Promise<{\n  controller: unknown;\n  layoutControllers: Array<unknown>;\n  pageScope: WoodScopedContainer;\n  layoutScopes: Array<WoodScopedContainer | null>;\n}> {\n  const pageScope = createScopedContainer();\n  const layoutControllers: unknown[] = [];\n  const layoutScopes: Array<WoodScopedContainer | null> = [];\n  const createdLayoutScopes: WoodScopedContainer[] = [];\n\n  try {\n    for (let i = 0; i < preservedDepth; i += 1) {\n      layoutControllers.push(undefined);\n      layoutScopes.push(null);\n    }\n\n    for (let i = preservedDepth; i < entry.layoutControllerClasses.length; i += 1) {\n      const LayoutController = entry.layoutControllerClasses[i];\n      if (!LayoutController) {\n        layoutControllers.push(undefined);\n        layoutScopes.push(null);\n        continue;\n      }\n      const preservable = entry.layoutPreserve?.[i] === true;\n      let scope = pageScope;\n      if (preservable) {\n        scope = createScopedContainer();\n        createdLayoutScopes.push(scope);\n      }\n      const controller = await resolveControllerInScope(\n        scope,\n        entry,\n        LayoutController,\n        \\`layout[\\${i}]\\`,\n      );\n      layoutControllers.push(controller);\n      layoutScopes.push(preservable ? scope : null);\n    }\n\n    const controller = entry.controllerClass\n      ? await resolveControllerInScope(pageScope, entry, entry.controllerClass, 'page')\n      : undefined;\n\n    return { controller, layoutControllers, pageScope, layoutScopes };\n  } catch (error) {\n    // Failed transitions must not orphan scopes: dispose everything this\n    // set created before rethrowing.\n    for (const scope of createdLayoutScopes) await disposeScopeQuietly(scope as any);\n    await disposeScopeQuietly(pageScope as any);\n    throw error;\n  }\n}\n\nconst DEFAULT_VIEW_KEY = '${escapeSingleQuoted(defaultViewKey)}';\n\ntype WoodWindowBootstrapInfo = {\n  ok?: boolean;\n  windowId?: string;\n  defaultRoute?: string;\n};\n\ntype WoodBootstrapBridgeLike = {\n  __window?: {\n    current?: () => Promise<WoodWindowBootstrapInfo>;\n  };\n};\n\nfunction getWoodBridge(): WoodBootstrapBridgeLike | null {\n  const globalObj = globalThis as typeof globalThis & {\n    __NOEGO_WOOD_BRIDGE__?: unknown;\n    window?: {\n      __NOEGO_WOOD_BRIDGE__?: unknown;\n    };\n  };\n\n  const bridge = globalObj.__NOEGO_WOOD_BRIDGE__ ?? globalObj.window?.__NOEGO_WOOD_BRIDGE__;\n  if (!bridge || typeof bridge !== 'object') {\n    return null;\n  }\n\n  return bridge as WoodBootstrapBridgeLike;\n}\n\nasync function resolveInitialEntry(): Promise<GeneratedAppViewEntry> {\n  if (!DEFAULT_VIEW_KEY) {\n    throw new Error('No views available in renderer manifest. Define at least one view in renderer OpenAPI YAML.');\n  }\n\n  const bridge = getWoodBridge();\n  const bootstrapWindow = await bridge?.__window?.current?.();\n  const requestedRoute = bootstrapWindow?.defaultRoute;\n\n  if (requestedRoute) {\n    const routeEntry = getViewManifestEntry(requestedRoute);\n    if (routeEntry) {\n      return routeEntry;\n    }\n  }\n\n  const entry = getViewManifestEntry(DEFAULT_VIEW_KEY);\n  if (!entry) {\n    throw new Error(\\`Default view \"\\${DEFAULT_VIEW_KEY}\" is missing from generated view manifest.\\`);\n  }\n\n  return entry;\n}\n\nfunction isAutomationBuild(): boolean {\n  try {\n    const env = (import.meta as { env?: { DEV?: boolean; MODE?: string } }).env;\n    return Boolean(env?.DEV) || env?.MODE === 'test';\n  } catch {\n    return false;\n  }\n}\n\nexport async function app(target: Element) {\n  const entry = await resolveInitialEntry();\n\n  getNavigation().replace(entry.key, {}, {});\n\n  // Dev/test-only Axe introspection surface; never present in production builds.\n  if (isAutomationBuild()) {\n    const bootstrapWindow = await getWoodBridge()?.__window?.current?.();\n    installAutomationIntrospection({ windowId: bootstrapWindow?.windowId ?? null });\n  }\n  const initialSet = await createControllerSet(entry);\n\n  return mount(NavigationShell, {\n    target,\n    props: {\n      manifest: VIEW_MANIFEST,\n      initialEntry: entry,\n      initialControllerSet: initialSet,\n      createControllerSetFn: createControllerSet,\n      getViewManifestEntryFn: getViewManifestEntry,\n    },\n  });\n}\n`;\n}\n"],"mappings":"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","names":["path"]}

package/dist/codegen/renderer_app_generator.js

@@ -236,15 +236,8 @@ function createScopedContainer(): WoodScopedContainer {
     throw new Error('Wood client container does not support get().');
   }
 
-  if (typeof scopedContainer.registerFunction === 'function') {
-    // Explicit Singleton lifetime: these return renderer-root globals, and
-    // registerFunction defaults to Transient \u2014 rejected by ioc >= 0.5's
-    // captive-lifetime validation under singleton dependents.
-    const singleton = { loadAs: 0 /* LoadAs.Singleton */ };
-    scopedContainer.registerFunction(Navigation, () => getNavigation(), singleton);
-    scopedContainer.registerFunction(App, () => getApp(), singleton);
-    scopedContainer.registerFunction(Ipc, () => getIpc(), singleton);
-  }
+  // Renderer builtins belong to the root created by getContainer().
+  // Page scopes inherit them; re-registering resolved ancestor singletons is invalid.
 
   return scopedContainer as WoodScopedContainer;
 }