@noego/wood 0.6.0 → 0.6.2

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":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,2BAAiD;AACjD,mCAAoC;AAWpC,MAAM,8BAA8B;AAAA,EAClC;AAAA,EACA;AACF;AAEA,SAAS,kBAAkB,IAA2B;AACpD,SAAO;AAAA,IACL,GAAG,eACA,GAAG,YAAwC,SAAS,YACrD,OAAO,KAAM,GAAG,YAAwD,cAAc,CAAC,CAAC,EAAE,SAAS;AAAA,EACvG;AACF;AAMA,SAAS,gBAAgB,YAAgE;AACvF,QAAM,OAAgC,CAAC;AAEvC,aAAW,CAAC,SAAS,EAAE,KAAK,YAAY;AACtC,UAAM,QAAQ,QAAQ,MAAM,GAAG;AAC/B,QAAI,UAAmC;AAEvC,aAAS,IAAI,GAAG,IAAI,MAAM,SAAS,GAAG,KAAK;AACzC,UAAI,CAAC,QAAQ,MAAM,CAAC,CAAC,EAAG,SAAQ,MAAM,CAAC,CAAC,IAAI,CAAC;AAC7C,gBAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,IAC5B;AAEA,UAAM,OAAO,MAAM,MAAM,SAAS,CAAC;AACnC,YAAQ,IAAI,IAAI,EAAE,aAAa,GAAG;AAAA,EACpC;AAEA,SAAO;AACT;AAKA,SAAS,iBAAiB,MAA+B,SAAiB,MAAc;AACtF,QAAM,QAAkB,CAAC;AAEzB,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC/C,UAAM,QAAQ;AACd,QAAI,MAAM,aAAa;AACrB,YAAM,KAAK,MAAM;AACjB,YAAM,WAAW,kBAAkB,EAAE;AAErC,UAAI,UAAU;AACZ,cAAM,KAAK,GAAG,MAAM,GAAG,GAAG,sBAAsB;AAChD,cAAM,KAAK,GAAG,MAAM,yBAAyB,GAAG,OAAO,WAAW;AAAA,MACpE,OAAO;AACL,cAAM,KAAK,GAAG,MAAM,GAAG,GAAG,SAAS;AACnC,cAAM,KAAK,GAAG,MAAM,yBAAyB,GAAG,OAAO,KAAK;AAAA,MAC9D;AAAA,IACF,OAAO;AACL,YAAM,KAAK,GAAG,MAAM,GAAG,GAAG,KAAK;AAC/B,YAAM,KAAK,iBAAiB,OAAO,SAAS,IAAI,CAAC;AACjD,YAAM,KAAK,GAAG,MAAM,IAAI;AAAA,IAC1B;AAAA,EACF;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;AAEA,SAAS,wBAAwB,YAA+C;AAC9E,QAAM,UAAU,MAAM,KAAK,WAAW,OAAO,CAAC,EAC3C,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,cAAc,EAAE,OAAO,CAAC,EACjD,IAAI,CAAC,OAAO;AACX,UAAM,UAAU;AAAA,MACd,SAAS,GAAG;AAAA,MACZ,YAAY,GAAG;AAAA,MACf,QAAQ,GAAG;AAAA,MACX,MAAM,GAAG,QAAQ,MAAM,GAAG;AAAA,MAC1B,UAAU,kBAAkB,EAAE;AAAA,IAChC;AACA,WAAO,KAAK,KAAK,UAAU,OAAO,CAAC;AAAA,EACrC,CAAC;AAEH,SAAO;AAAA,EACP,QAAQ,KAAK,IAAI,CAAC;AAAA;AAEpB;AAEA,MAAM,6BAA6B;AAK5B,SAAS,gBACd,YACA,UAAkC,CAAC,GAC3B;AACR,QAAM,OAAO,gBAAgB,UAAU;AACvC,QAAM,iBAAiB,iBAAiB,IAAI;AAC5C,QAAM,kBAAkB,wBAAwB,UAAU;AAC1D,QAAM,gBAAgB,QAAQ,iBAAiB;AAE/C,SAAO,OAAG,kDAAoB,2BAA2B,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAU1D,eAAe;AAAA;AAAA,sCAEqB,0BAA0B;AAAA;AAAA;AAAA,EAG9D,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAqIK,cAAc,eAAe;AAAA,oBAC9B,cAAc,cAAc;AAAA,8BAClB,cAAc,wBAAwB;AAAA,gBACpD,cAAc,UAAU;AAAA,sBAClB,cAAc,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4EpD;","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/frontend/frontend_surface.d.cts

@@ -5,6 +5,7 @@ import { WorkRegistry, WorkFailure } from './work_registry.cjs';
 export { FrontendWorkError } from './work_registry.cjs';
 export { FrontendLifecycle } from './frontend_lifecycle.cjs';
 import { FrontendPage } from './frontend_page.cjs';
+import '../navigation/layout_preservation.cjs';
 import '../navigation/automation_introspection.cjs';
 
 interface FrontendOpenOptions {

package/dist/frontend/frontend_surface.d.ts

@@ -5,6 +5,7 @@ import { WorkRegistry, WorkFailure } from './work_registry.js';
 export { FrontendWorkError } from './work_registry.js';
 export { FrontendLifecycle } from './frontend_lifecycle.js';
 import { FrontendPage } from './frontend_page.js';
+import '../navigation/layout_preservation.js';
 import '../navigation/automation_introspection.js';
 
 interface FrontendOpenOptions {

package/dist/frontend/index.d.cts

@@ -7,4 +7,5 @@ export { CreateFrontendSurfaceOptions, FrontendApplicationSurface, FrontendOpenO
 import '../types/views.cjs';
 import '../transport/wood_rpc_transport.cjs';
 import '../navigation/index.cjs';
+import '../navigation/layout_preservation.cjs';
 import '../navigation/automation_introspection.cjs';

package/dist/frontend/index.d.ts

@@ -7,4 +7,5 @@ export { CreateFrontendSurfaceOptions, FrontendApplicationSurface, FrontendOpenO
 import '../types/views.js';
 import '../transport/wood_rpc_transport.js';
 import '../navigation/index.js';
+import '../navigation/layout_preservation.js';
 import '../navigation/automation_introspection.js';

package/dist/index.d.cts

@@ -38,9 +38,10 @@ export { WoodRendererTraceEvent, WoodRendererTraceInput, WoodTraceBatch, WoodTra
 export { WoodTraceBatchContract } from './tracing/wood_trace_batch_contract.cjs';
 export { TraceCommitRow, TraceCommitWriter, TraceCommitWriterOptions, TraceFlushOptions, TraceFlushResult, WoodTracePersistencePort } from './tracing/trace_commit_writer.cjs';
 export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './tracing/trace_provider.cjs';
-export { Navigation, NavigationEntry, NavigationOptions, getNavigation, go, goback, goto } from './navigation/index.cjs';
+export { Navigation, NavigationEntry, getNavigation, go, goback, goto } from './navigation/index.cjs';
 export { Ipc, getIpc } from './ipc/index.cjs';
 export { IpcPushOptions } from './ipc/shared.cjs';
+export { NavigationOptions } from './navigation/layout_preservation.cjs';
 import '@noego/ioc';
 import './runtime/renderer_log_dispatcher.cjs';
 import './runtime/renderer_config_extension.cjs';

package/dist/index.d.ts

@@ -38,9 +38,10 @@ export { WoodRendererTraceEvent, WoodRendererTraceInput, WoodTraceBatch, WoodTra
 export { WoodTraceBatchContract } from './tracing/wood_trace_batch_contract.js';
 export { TraceCommitRow, TraceCommitWriter, TraceCommitWriterOptions, TraceFlushOptions, TraceFlushResult, WoodTracePersistencePort } from './tracing/trace_commit_writer.js';
 export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './tracing/trace_provider.js';
-export { Navigation, NavigationEntry, NavigationOptions, getNavigation, go, goback, goto } from './navigation/index.js';
+export { Navigation, NavigationEntry, getNavigation, go, goback, goto } from './navigation/index.js';
 export { Ipc, getIpc } from './ipc/index.js';
 export { IpcPushOptions } from './ipc/shared.js';
+export { NavigationOptions } from './navigation/layout_preservation.js';
 import '@noego/ioc';
 import './runtime/renderer_log_dispatcher.js';
 import './runtime/renderer_config_extension.js';

package/dist/main/index.cjs

@@ -29,10 +29,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var main_exports = {};
 __export(main_exports, {
   BootstrapActivationGate: () => BootstrapActivationGate,
+  RENDERER_SHUTDOWN_DRAIN_TIMEOUT_MS: () => import_shutdown_coordinator2.RENDERER_SHUTDOWN_DRAIN_TIMEOUT_MS,
+  ShutdownCoordinator: () => import_shutdown_coordinator2.ShutdownCoordinator,
   resolveWoodDebugMetadataConfiguration: () => resolveWoodDebugMetadataConfiguration,
   setRendererConfigExtension: () => import_renderer_config_extension2.setRendererConfigExtension,
   setRendererLogRecordFilter: () => import_renderer_log_batch_receiver2.setRendererLogRecordFilter,
-  shouldDeferLastWindowCloseForCleanup: () => shouldDeferLastWindowCloseForCleanup,
+  shouldDeferLastWindowCloseForCleanup: () => import_shutdown_coordinator2.shouldDeferLastWindowCloseForCleanup,
   startWoodMain: () => startWoodMain
 });
 module.exports = __toCommonJS(main_exports);
@@ -54,6 +56,8 @@ var import_renderer_config_extension2 = require("../runtime/renderer_config_exte
 var import_ipc = require("../ipc/index.js");
 var import_shared = require("../ipc/shared.js");
 var import_renderer_trace_drain_coordinator = require("./renderer_trace_drain_coordinator.js");
+var import_shutdown_coordinator = require("./shutdown_coordinator.js");
+var import_shutdown_coordinator2 = require("./shutdown_coordinator.js");
 class BootstrapActivationGate {
   constructor(hasWindow, createMainWindow) {
     this.hasWindow = hasWindow;
@@ -81,9 +85,6 @@ class BootstrapActivationGate {
     }
   }
 }
-function shouldDeferLastWindowCloseForCleanup(trackedWindowCount, cleanupComplete) {
-  return trackedWindowCount === 1 && !cleanupComplete;
-}
 const DEFAULT_WOOD_REMOTE_DEBUGGING_PORT = 9333;
 function resolveWoodDebugMetadataConfiguration(env = process.env) {
   const isDevelopment = env.WOOD_MODE === "development";
@@ -133,8 +134,7 @@ function startWoodMain(options) {
   const windows = /* @__PURE__ */ new Map();
   const rendererHealth = /* @__PURE__ */ new Map();
   let mainWindow = null;
-  let beforeQuitCleanupComplete = false;
-  let beforeQuitCleanupPromise = null;
+  let shutdownCoordinator = null;
   let runtimeContext = null;
   let mainBootCleanup;
   let runtimeCleanup;
@@ -525,7 +525,11 @@ function startWoodMain(options) {
           mainWindow = null;
         }
         if (windows.size === 0) {
-          import_electron.app.quit();
+          if (shutdownCoordinator) {
+            shutdownCoordinator.handleAllWindowsClosed();
+          } else {
+            import_electron.app.quit();
+          }
         }
       });
       if (options.onWindowCreated) {
@@ -727,73 +731,52 @@ function startWoodMain(options) {
     };
     void import_electron.app.whenReady().then(bootstrap).catch(handleBootstrapFailure);
     const registerApplicationLifecycle = () => {
+      const coordinator = new import_shutdown_coordinator.ShutdownCoordinator({
+        trackedWindows: () => windows.entries(),
+        clearTrackedWindows: () => {
+          windows.clear();
+        },
+        drainRenderers: () => (0, import_renderer_trace_drain_coordinator.drainRendererTracesBeforeQuit)(
+          rendererTraceDrain,
+          windows.values(),
+          logger,
+          Date.now() + import_shutdown_coordinator.RENDERER_SHUTDOWN_DRAIN_TIMEOUT_MS
+        ),
+        cleanupBackend: () => (0, import_cleanup.cleanupAll)([
+          () => runtimeCleanup?.(),
+          () => {
+            if (options.legacyGlobals) (0, import_shared.clearIpcPushSender)();
+          },
+          () => mainBootCleanup?.(),
+          () => options.onBeforeQuit?.(runtimeContext),
+          () => import_ioc.ExecutionContext.run(container, () => container.dispose())
+        ], "Wood main shutdown failed"),
+        requestQuit: () => {
+          import_electron.app.quit();
+        },
+        logger
+      });
+      shutdownCoordinator = coordinator;
       import_electron.app.on(
         "browser-window-created",
         (_event, window) => {
           window.on("close", (event) => {
             const isTrackedWindow = [...windows.values()].includes(window);
-            if (!isTrackedWindow || !shouldDeferLastWindowCloseForCleanup(
-              windows.size,
-              beforeQuitCleanupComplete
-            )) {
+            if (!isTrackedWindow) {
               return;
             }
-            event.preventDefault();
-            if (!beforeQuitCleanupPromise) {
-              logger.debug("deferring last window close for renderer trace drain");
-              import_electron.app.quit();
-            }
+            coordinator.handleTrackedWindowClose(event, windows.size);
           });
         }
       );
-      const destroyWindowsForQuit = () => {
-        for (const [id, win] of windows) {
-          if (!win.isDestroyed()) {
-            win.destroy();
-            logger.debug("destroyed window on quit", { windowId: id });
-          }
-        }
-        windows.clear();
-      };
-      const runBeforeQuitCleanup = async () => {
-        await (0, import_cleanup.cleanupAll)([
-          () => (0, import_renderer_trace_drain_coordinator.drainRendererTracesBeforeQuit)(rendererTraceDrain, windows.values(), logger, Date.now() + 1e3),
-          () => runtimeCleanup?.(),
-          () => {
-            if (options.legacyGlobals) (0, import_shared.clearIpcPushSender)();
-          },
-          () => mainBootCleanup?.(),
-          () => options.onBeforeQuit?.(runtimeContext),
-          () => import_ioc.ExecutionContext.run(container, () => container.dispose())
-        ], "Wood main shutdown failed");
-      };
       import_electron.app.on("before-quit", (event) => {
         if (!runtimeContext) {
           return;
         }
-        if (beforeQuitCleanupComplete) {
-          destroyWindowsForQuit();
-          return;
-        }
-        event.preventDefault();
-        if (beforeQuitCleanupPromise) {
-          return;
-        }
-        beforeQuitCleanupPromise = (async () => {
-          try {
-            await runBeforeQuitCleanup();
-          } catch (error) {
-            logger.warn("before-quit handler failed", { error: toErrorMessage(error) });
-          } finally {
-            beforeQuitCleanupComplete = true;
-            beforeQuitCleanupPromise = null;
-          }
-          destroyWindowsForQuit();
-          import_electron.app.quit();
-        })();
+        coordinator.handleBeforeQuit(event);
       });
       import_electron.app.on("window-all-closed", () => {
-        import_electron.app.quit();
+        coordinator.handleAllWindowsClosed();
       });
       import_electron.app.on("activate", () => {
         bootstrapActivationGate.activate();
@@ -812,6 +795,8 @@ function startWoodMain(options) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BootstrapActivationGate,
+  RENDERER_SHUTDOWN_DRAIN_TIMEOUT_MS,
+  ShutdownCoordinator,
   resolveWoodDebugMetadataConfiguration,
   setRendererConfigExtension,
   setRendererLogRecordFilter,