@noego/wood 0.4.9 → 0.5.0

package/dist/codegen/type_generator.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/type_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nconst TYPE_SOURCE_INSTRUCTIONS = [\n  'To change IPC channels, input schemas, controller/action names, or renderer bridge types,',\n  'edit the operations YAML configured by wood.config.yml main.openapi and the matching controller methods.',\n] as const;\n\nfunction formatPropertyKey(key: string): string {\n  if (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)) {\n    return key;\n  }\n\n  return JSON.stringify(key);\n}\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\nfunction jsonSchemaToTS(schema: Record<string, unknown> | undefined, indent: string = ''): string {\n  if (!schema) return 'unknown';\n\n  const type = schema.type as string | undefined;\n\n  if (type === 'string') {\n    if (schema.enum) {\n      return (schema.enum as string[]).map((v) => `'${v}'`).join(' | ');\n    }\n    return 'string';\n  }\n  if (type === 'number' || type === 'integer') return 'number';\n  if (type === 'boolean') return 'boolean';\n  if (type === 'array') {\n    const itemType = jsonSchemaToTS(schema.items as Record<string, unknown>, indent);\n    return `Array<${itemType}>`;\n  }\n  if (type === 'object') {\n    const props = (schema.properties ?? {}) as Record<string, Record<string, unknown>>;\n    const required = new Set((schema.required as string[]) ?? []);\n    const entries = Object.entries(props);\n    if (entries.length === 0) return 'Record<string, unknown>';\n\n    const lines = entries.map(([key, val]) => {\n      const optional = required.has(key) ? '' : '?';\n      const valType = jsonSchemaToTS(val, indent + '  ');\n      return `${indent}  ${formatPropertyKey(key)}${optional}: ${valType};`;\n    });\n    return `{\\n${lines.join('\\n')}\\n${indent}}`;\n  }\n\n  return 'unknown';\n}\n\nfunction buildNestedTypeTree(operations: Map<string, OperationDef>): Record<string, unknown> {\n  const tree: Record<string, unknown> = {};\n  for (const [channel, op] of operations) {\n    const parts = channel.split('.');\n    let current: Record<string, unknown> = tree;\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    current[parts[parts.length - 1]] = { __operation: op };\n  }\n  return tree;\n}\n\nfunction generateTypeTree(node: Record<string, unknown>, indent: string = '  '): string {\n  const lines: string[] = [];\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 inputType = jsonSchemaToTS(op.inputSchema as Record<string, unknown>, indent + '  ');\n      const outputType = jsonSchemaToTS(op.outputSchema as Record<string, unknown>, indent + '  ');\n      const hasInput = operationHasInput(op);\n\n      if (hasInput) {\n        lines.push(`${indent}${formatPropertyKey(key)}(data: ${inputType}): Promise<${outputType}>;`);\n      } else {\n        lines.push(`${indent}${formatPropertyKey(key)}(): Promise<${outputType}>;`);\n      }\n    } else {\n      lines.push(`${indent}${formatPropertyKey(key)}: {`);\n      lines.push(generateTypeTree(entry, indent + '  '));\n      lines.push(`${indent}};`);\n    }\n  }\n  return lines.join('\\n');\n}\n\ntype RpcActionTypeEntry = {\n  channel: string;\n  inputType: string;\n  outputType: string;\n  hasInput: boolean;\n};\n\nfunction buildRpcControllerTree(\n  operations: Map<string, OperationDef>,\n): Record<string, Record<string, RpcActionTypeEntry>> {\n  const tree: Record<string, Record<string, RpcActionTypeEntry>> = {};\n\n  for (const operation of operations.values()) {\n    const controller = operation.controller;\n    const action = operation.action;\n\n    if (!tree[controller]) {\n      tree[controller] = {};\n    }\n\n    if (tree[controller][action]) {\n      throw new Error(\n        `Type codegen failed: duplicate RPC action \"${controller}.${action}\" found in channel \"${operation.channel}\".`,\n      );\n    }\n\n    tree[controller][action] = {\n      channel: operation.channel,\n      inputType: jsonSchemaToTS(operation.inputSchema as Record<string, unknown>, '    '),\n      outputType: jsonSchemaToTS(operation.outputSchema as Record<string, unknown>, '    '),\n      hasInput: operationHasInput(operation),\n    };\n  }\n\n  return tree;\n}\n\nfunction generateRpcTypeTree(operations: Map<string, OperationDef>): string {\n  const controllerTree = buildRpcControllerTree(operations);\n  const controllerNames = Object.keys(controllerTree).sort((a, b) => a.localeCompare(b));\n  const lines: string[] = [];\n\n  for (const controllerName of controllerNames) {\n    lines.push(`  ${formatPropertyKey(controllerName)}: {`);\n    const actions = controllerTree[controllerName];\n    const actionNames = Object.keys(actions).sort((a, b) => a.localeCompare(b));\n    for (const actionName of actionNames) {\n      const action = actions[actionName];\n      if (action.hasInput) {\n        lines.push(`    ${formatPropertyKey(actionName)}(data: ${action.inputType}): Promise<${action.outputType}>;`);\n      } else {\n        lines.push(`    ${formatPropertyKey(actionName)}(): Promise<${action.outputType}>;`);\n      }\n    }\n    lines.push('  };');\n  }\n\n  return lines.join('\\n');\n}\n\nexport function generateTypes(operations: Map<string, OperationDef>): string {\n  const tree = buildNestedTypeTree(operations);\n  const typesCode = generateTypeTree(tree);\n  const rpcTypeCode = generateRpcTypeTree(operations);\n\n  return `${generatedFileNotice(TYPE_SOURCE_INSTRUCTIONS)}\nexport interface WoodRpcManifestEntry {\n  channel: string;\n  controller: string;\n  action: string;\n  path: string[];\n  hasInput: boolean;\n}\n\n/**\n * Project-specific renderer App facade contract.\n *\n * This matches @noego/wood/client getApp() and injected App instances:\n * controller name -> controller action.\n */\nexport interface GeneratedApp {\n${rpcTypeCode}\n}\n\n/** Backward-compatible name for the generated client App facade contract. */\nexport interface WoodRpcApi extends GeneratedApp {}\n\n/**\n * Project-specific raw preload bridge contract.\n *\n * This matches the channel path exposed by preload.generated.ts:\n * operation channel segments -> invoke function.\n */\nexport interface GeneratedWoodBridge {\n${typesCode}\n}\n\nexport interface WoodApi extends GeneratedWoodBridge {\n  __rpcManifest: WoodRpcManifestEntry[];\n  __load(route: string, params: Record<string, string>): Promise<unknown>;\n  __navigate(windowId: string, route: string): Promise<void>;\n  __window: {\n    current(): Promise<{ ok: boolean; windowId?: string; defaultRoute?: string }>;\n    open(windowId: string, options?: Record<string, unknown>): Promise<void>;\n    close(windowId?: string): Promise<void>;\n    focus(windowId: string): Promise<void>;\n    minimize(windowId?: string): Promise<void>;\n    maximize(windowId?: string): Promise<void>;\n  };\n  __debug: {\n    current(): Promise<{\n      ok: boolean;\n      enabled: boolean;\n      mode: 'development' | 'production';\n      port?: number;\n      windows: Array<{\n        windowId: string;\n        title: string;\n        webContentsId: number;\n        url: string;\n        focused: boolean;\n        rendererHealth?: 'ready' | 'loading' | 'unresponsive' | 'gone' | 'destroyed';\n      }>;\n    }>;\n  };\n  __contextMenu: {\n    show(data: {\n      items: Array<{ label?: string; action?: string; data?: string; _callbackId?: string; disabled?: boolean; type?: 'separator' }>;\n      position: { x: number; y: number };\n    }): Promise<void>;\n  };\n  on(channel: string, callback: (...args: unknown[]) => void): () => void;\n  __log(level: string, logger: string, message: string, context?: unknown): Promise<{\n    ok: boolean;\n    forwarded: boolean;\n    configured: boolean;\n    reason?: 'unconfigured' | 'callback-error';\n    errorMessage?: string;\n  }>;\n}\n`;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/codegen/type_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.cjs';\nimport { generatedFileNotice } from './generated_file_notice.cjs';\n\nconst TYPE_SOURCE_INSTRUCTIONS = [\n  'To change IPC channels, input schemas, controller/action names, or renderer bridge types,',\n  'edit the operations YAML configured by wood.config.yml main.openapi and the matching controller methods.',\n] as const;\n\nfunction formatPropertyKey(key: string): string {\n  if (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)) {\n    return key;\n  }\n\n  return JSON.stringify(key);\n}\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\nfunction jsonSchemaToTS(schema: Record<string, unknown> | undefined, indent: string = ''): string {\n  if (!schema) return 'unknown';\n\n  const type = schema.type as string | undefined;\n\n  if (type === 'string') {\n    if (schema.enum) {\n      return (schema.enum as string[]).map((v) => `'${v}'`).join(' | ');\n    }\n    return 'string';\n  }\n  if (type === 'number' || type === 'integer') return 'number';\n  if (type === 'boolean') return 'boolean';\n  if (type === 'array') {\n    const itemType = jsonSchemaToTS(schema.items as Record<string, unknown>, indent);\n    return `Array<${itemType}>`;\n  }\n  if (type === 'object') {\n    const props = (schema.properties ?? {}) as Record<string, Record<string, unknown>>;\n    const required = new Set((schema.required as string[]) ?? []);\n    const entries = Object.entries(props);\n    if (entries.length === 0) return 'Record<string, unknown>';\n\n    const lines = entries.map(([key, val]) => {\n      const optional = required.has(key) ? '' : '?';\n      const valType = jsonSchemaToTS(val, indent + '  ');\n      return `${indent}  ${formatPropertyKey(key)}${optional}: ${valType};`;\n    });\n    return `{\\n${lines.join('\\n')}\\n${indent}}`;\n  }\n\n  return 'unknown';\n}\n\nfunction buildNestedTypeTree(operations: Map<string, OperationDef>): Record<string, unknown> {\n  const tree: Record<string, unknown> = {};\n  for (const [channel, op] of operations) {\n    const parts = channel.split('.');\n    let current: Record<string, unknown> = tree;\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    current[parts[parts.length - 1]] = { __operation: op };\n  }\n  return tree;\n}\n\nfunction generateTypeTree(node: Record<string, unknown>, indent: string = '  '): string {\n  const lines: string[] = [];\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 inputType = jsonSchemaToTS(op.inputSchema as Record<string, unknown>, indent + '  ');\n      const outputType = jsonSchemaToTS(op.outputSchema as Record<string, unknown>, indent + '  ');\n      const hasInput = operationHasInput(op);\n\n      if (hasInput) {\n        lines.push(`${indent}${formatPropertyKey(key)}(data: ${inputType}): Promise<${outputType}>;`);\n      } else {\n        lines.push(`${indent}${formatPropertyKey(key)}(): Promise<${outputType}>;`);\n      }\n    } else {\n      lines.push(`${indent}${formatPropertyKey(key)}: {`);\n      lines.push(generateTypeTree(entry, indent + '  '));\n      lines.push(`${indent}};`);\n    }\n  }\n  return lines.join('\\n');\n}\n\ntype RpcActionTypeEntry = {\n  channel: string;\n  inputType: string;\n  outputType: string;\n  hasInput: boolean;\n};\n\nfunction buildRpcControllerTree(\n  operations: Map<string, OperationDef>,\n): Record<string, Record<string, RpcActionTypeEntry>> {\n  const tree: Record<string, Record<string, RpcActionTypeEntry>> = {};\n\n  for (const operation of operations.values()) {\n    const controller = operation.controller;\n    const action = operation.action;\n\n    if (!tree[controller]) {\n      tree[controller] = {};\n    }\n\n    if (tree[controller][action]) {\n      throw new Error(\n        `Type codegen failed: duplicate RPC action \"${controller}.${action}\" found in channel \"${operation.channel}\".`,\n      );\n    }\n\n    tree[controller][action] = {\n      channel: operation.channel,\n      inputType: jsonSchemaToTS(operation.inputSchema as Record<string, unknown>, '    '),\n      outputType: jsonSchemaToTS(operation.outputSchema as Record<string, unknown>, '    '),\n      hasInput: operationHasInput(operation),\n    };\n  }\n\n  return tree;\n}\n\nfunction generateRpcTypeTree(operations: Map<string, OperationDef>): string {\n  const controllerTree = buildRpcControllerTree(operations);\n  const controllerNames = Object.keys(controllerTree).sort((a, b) => a.localeCompare(b));\n  const lines: string[] = [];\n\n  for (const controllerName of controllerNames) {\n    lines.push(`  ${formatPropertyKey(controllerName)}: {`);\n    const actions = controllerTree[controllerName];\n    const actionNames = Object.keys(actions).sort((a, b) => a.localeCompare(b));\n    for (const actionName of actionNames) {\n      const action = actions[actionName];\n      if (action.hasInput) {\n        lines.push(`    ${formatPropertyKey(actionName)}(data: ${action.inputType}): Promise<${action.outputType}>;`);\n      } else {\n        lines.push(`    ${formatPropertyKey(actionName)}(): Promise<${action.outputType}>;`);\n      }\n    }\n    lines.push('  };');\n  }\n\n  return lines.join('\\n');\n}\n\nexport function generateTypes(operations: Map<string, OperationDef>): string {\n  const tree = buildNestedTypeTree(operations);\n  const typesCode = generateTypeTree(tree);\n  const rpcTypeCode = generateRpcTypeTree(operations);\n\n  return `${generatedFileNotice(TYPE_SOURCE_INSTRUCTIONS)}\nexport interface WoodRpcManifestEntry {\n  channel: string;\n  controller: string;\n  action: string;\n  path: string[];\n  hasInput: boolean;\n}\n\n/**\n * Project-specific renderer App facade contract.\n *\n * This matches @noego/wood/client getApp() and injected App instances:\n * controller name -> controller action.\n */\nexport interface GeneratedApp {\n${rpcTypeCode}\n}\n\n/** Backward-compatible name for the generated client App facade contract. */\nexport interface WoodRpcApi extends GeneratedApp {}\n\n/**\n * Project-specific raw preload bridge contract.\n *\n * This matches the channel path exposed by preload.generated.ts:\n * operation channel segments -> invoke function.\n */\nexport interface GeneratedWoodBridge {\n${typesCode}\n}\n\nexport interface WoodApi extends GeneratedWoodBridge {\n  __rpcManifest: WoodRpcManifestEntry[];\n  __load(route: string, params: Record<string, string>): Promise<unknown>;\n  __navigate(windowId: string, route: string): Promise<void>;\n  __window: {\n    current(): Promise<{ ok: boolean; windowId?: string; defaultRoute?: string }>;\n    open(windowId: string, options?: Record<string, unknown>): Promise<void>;\n    close(windowId?: string): Promise<void>;\n    focus(windowId: string): Promise<void>;\n    minimize(windowId?: string): Promise<void>;\n    maximize(windowId?: string): Promise<void>;\n  };\n  __debug: {\n    current(): Promise<{\n      ok: boolean;\n      enabled: boolean;\n      mode: 'development' | 'production';\n      port?: number;\n      windows: Array<{\n        windowId: string;\n        title: string;\n        webContentsId: number;\n        url: string;\n        focused: boolean;\n        rendererHealth?: 'ready' | 'loading' | 'unresponsive' | 'gone' | 'destroyed';\n      }>;\n    }>;\n  };\n  __contextMenu: {\n    show(data: {\n      items: Array<{ label?: string; action?: string; data?: string; _callbackId?: string; disabled?: boolean; type?: 'separator' }>;\n      position: { x: number; y: number };\n    }): Promise<void>;\n  };\n  on(channel: string, callback: (...args: unknown[]) => void): () => void;\n  __log(level: string, logger: string, message: string, context?: unknown): Promise<{\n    ok: boolean;\n    forwarded: boolean;\n    configured: boolean;\n    reason?: 'unconfigured' | 'callback-error';\n    errorMessage?: string;\n  }>;\n  __logBatch(batch: unknown): void;\n}\n`;\n}\n"],"mappings":"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","names":[]}

package/dist/codegen/type_generator.js

@@ -200,6 +200,7 @@ export interface WoodApi extends GeneratedWoodBridge {
     reason?: 'unconfigured' | 'callback-error';
     errorMessage?: string;
   }>;
+  __logBatch(batch: unknown): void;
 }
 `;
 }

package/dist/codegen/type_generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/type_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.js';\nimport { generatedFileNotice } from './generated_file_notice.js';\n\nconst TYPE_SOURCE_INSTRUCTIONS = [\n  'To change IPC channels, input schemas, controller/action names, or renderer bridge types,',\n  'edit the operations YAML configured by wood.config.yml main.openapi and the matching controller methods.',\n] as const;\n\nfunction formatPropertyKey(key: string): string {\n  if (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)) {\n    return key;\n  }\n\n  return JSON.stringify(key);\n}\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\nfunction jsonSchemaToTS(schema: Record<string, unknown> | undefined, indent: string = ''): string {\n  if (!schema) return 'unknown';\n\n  const type = schema.type as string | undefined;\n\n  if (type === 'string') {\n    if (schema.enum) {\n      return (schema.enum as string[]).map((v) => `'${v}'`).join(' | ');\n    }\n    return 'string';\n  }\n  if (type === 'number' || type === 'integer') return 'number';\n  if (type === 'boolean') return 'boolean';\n  if (type === 'array') {\n    const itemType = jsonSchemaToTS(schema.items as Record<string, unknown>, indent);\n    return `Array<${itemType}>`;\n  }\n  if (type === 'object') {\n    const props = (schema.properties ?? {}) as Record<string, Record<string, unknown>>;\n    const required = new Set((schema.required as string[]) ?? []);\n    const entries = Object.entries(props);\n    if (entries.length === 0) return 'Record<string, unknown>';\n\n    const lines = entries.map(([key, val]) => {\n      const optional = required.has(key) ? '' : '?';\n      const valType = jsonSchemaToTS(val, indent + '  ');\n      return `${indent}  ${formatPropertyKey(key)}${optional}: ${valType};`;\n    });\n    return `{\\n${lines.join('\\n')}\\n${indent}}`;\n  }\n\n  return 'unknown';\n}\n\nfunction buildNestedTypeTree(operations: Map<string, OperationDef>): Record<string, unknown> {\n  const tree: Record<string, unknown> = {};\n  for (const [channel, op] of operations) {\n    const parts = channel.split('.');\n    let current: Record<string, unknown> = tree;\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    current[parts[parts.length - 1]] = { __operation: op };\n  }\n  return tree;\n}\n\nfunction generateTypeTree(node: Record<string, unknown>, indent: string = '  '): string {\n  const lines: string[] = [];\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 inputType = jsonSchemaToTS(op.inputSchema as Record<string, unknown>, indent + '  ');\n      const outputType = jsonSchemaToTS(op.outputSchema as Record<string, unknown>, indent + '  ');\n      const hasInput = operationHasInput(op);\n\n      if (hasInput) {\n        lines.push(`${indent}${formatPropertyKey(key)}(data: ${inputType}): Promise<${outputType}>;`);\n      } else {\n        lines.push(`${indent}${formatPropertyKey(key)}(): Promise<${outputType}>;`);\n      }\n    } else {\n      lines.push(`${indent}${formatPropertyKey(key)}: {`);\n      lines.push(generateTypeTree(entry, indent + '  '));\n      lines.push(`${indent}};`);\n    }\n  }\n  return lines.join('\\n');\n}\n\ntype RpcActionTypeEntry = {\n  channel: string;\n  inputType: string;\n  outputType: string;\n  hasInput: boolean;\n};\n\nfunction buildRpcControllerTree(\n  operations: Map<string, OperationDef>,\n): Record<string, Record<string, RpcActionTypeEntry>> {\n  const tree: Record<string, Record<string, RpcActionTypeEntry>> = {};\n\n  for (const operation of operations.values()) {\n    const controller = operation.controller;\n    const action = operation.action;\n\n    if (!tree[controller]) {\n      tree[controller] = {};\n    }\n\n    if (tree[controller][action]) {\n      throw new Error(\n        `Type codegen failed: duplicate RPC action \"${controller}.${action}\" found in channel \"${operation.channel}\".`,\n      );\n    }\n\n    tree[controller][action] = {\n      channel: operation.channel,\n      inputType: jsonSchemaToTS(operation.inputSchema as Record<string, unknown>, '    '),\n      outputType: jsonSchemaToTS(operation.outputSchema as Record<string, unknown>, '    '),\n      hasInput: operationHasInput(operation),\n    };\n  }\n\n  return tree;\n}\n\nfunction generateRpcTypeTree(operations: Map<string, OperationDef>): string {\n  const controllerTree = buildRpcControllerTree(operations);\n  const controllerNames = Object.keys(controllerTree).sort((a, b) => a.localeCompare(b));\n  const lines: string[] = [];\n\n  for (const controllerName of controllerNames) {\n    lines.push(`  ${formatPropertyKey(controllerName)}: {`);\n    const actions = controllerTree[controllerName];\n    const actionNames = Object.keys(actions).sort((a, b) => a.localeCompare(b));\n    for (const actionName of actionNames) {\n      const action = actions[actionName];\n      if (action.hasInput) {\n        lines.push(`    ${formatPropertyKey(actionName)}(data: ${action.inputType}): Promise<${action.outputType}>;`);\n      } else {\n        lines.push(`    ${formatPropertyKey(actionName)}(): Promise<${action.outputType}>;`);\n      }\n    }\n    lines.push('  };');\n  }\n\n  return lines.join('\\n');\n}\n\nexport function generateTypes(operations: Map<string, OperationDef>): string {\n  const tree = buildNestedTypeTree(operations);\n  const typesCode = generateTypeTree(tree);\n  const rpcTypeCode = generateRpcTypeTree(operations);\n\n  return `${generatedFileNotice(TYPE_SOURCE_INSTRUCTIONS)}\nexport interface WoodRpcManifestEntry {\n  channel: string;\n  controller: string;\n  action: string;\n  path: string[];\n  hasInput: boolean;\n}\n\n/**\n * Project-specific renderer App facade contract.\n *\n * This matches @noego/wood/client getApp() and injected App instances:\n * controller name -> controller action.\n */\nexport interface GeneratedApp {\n${rpcTypeCode}\n}\n\n/** Backward-compatible name for the generated client App facade contract. */\nexport interface WoodRpcApi extends GeneratedApp {}\n\n/**\n * Project-specific raw preload bridge contract.\n *\n * This matches the channel path exposed by preload.generated.ts:\n * operation channel segments -> invoke function.\n */\nexport interface GeneratedWoodBridge {\n${typesCode}\n}\n\nexport interface WoodApi extends GeneratedWoodBridge {\n  __rpcManifest: WoodRpcManifestEntry[];\n  __load(route: string, params: Record<string, string>): Promise<unknown>;\n  __navigate(windowId: string, route: string): Promise<void>;\n  __window: {\n    current(): Promise<{ ok: boolean; windowId?: string; defaultRoute?: string }>;\n    open(windowId: string, options?: Record<string, unknown>): Promise<void>;\n    close(windowId?: string): Promise<void>;\n    focus(windowId: string): Promise<void>;\n    minimize(windowId?: string): Promise<void>;\n    maximize(windowId?: string): Promise<void>;\n  };\n  __debug: {\n    current(): Promise<{\n      ok: boolean;\n      enabled: boolean;\n      mode: 'development' | 'production';\n      port?: number;\n      windows: Array<{\n        windowId: string;\n        title: string;\n        webContentsId: number;\n        url: string;\n        focused: boolean;\n        rendererHealth?: 'ready' | 'loading' | 'unresponsive' | 'gone' | 'destroyed';\n      }>;\n    }>;\n  };\n  __contextMenu: {\n    show(data: {\n      items: Array<{ label?: string; action?: string; data?: string; _callbackId?: string; disabled?: boolean; type?: 'separator' }>;\n      position: { x: number; y: number };\n    }): Promise<void>;\n  };\n  on(channel: string, callback: (...args: unknown[]) => void): () => void;\n  __log(level: string, logger: string, message: string, context?: unknown): Promise<{\n    ok: boolean;\n    forwarded: boolean;\n    configured: boolean;\n    reason?: 'unconfigured' | 'callback-error';\n    errorMessage?: string;\n  }>;\n}\n`;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/codegen/type_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.js';\nimport { generatedFileNotice } from './generated_file_notice.js';\n\nconst TYPE_SOURCE_INSTRUCTIONS = [\n  'To change IPC channels, input schemas, controller/action names, or renderer bridge types,',\n  'edit the operations YAML configured by wood.config.yml main.openapi and the matching controller methods.',\n] as const;\n\nfunction formatPropertyKey(key: string): string {\n  if (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)) {\n    return key;\n  }\n\n  return JSON.stringify(key);\n}\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\nfunction jsonSchemaToTS(schema: Record<string, unknown> | undefined, indent: string = ''): string {\n  if (!schema) return 'unknown';\n\n  const type = schema.type as string | undefined;\n\n  if (type === 'string') {\n    if (schema.enum) {\n      return (schema.enum as string[]).map((v) => `'${v}'`).join(' | ');\n    }\n    return 'string';\n  }\n  if (type === 'number' || type === 'integer') return 'number';\n  if (type === 'boolean') return 'boolean';\n  if (type === 'array') {\n    const itemType = jsonSchemaToTS(schema.items as Record<string, unknown>, indent);\n    return `Array<${itemType}>`;\n  }\n  if (type === 'object') {\n    const props = (schema.properties ?? {}) as Record<string, Record<string, unknown>>;\n    const required = new Set((schema.required as string[]) ?? []);\n    const entries = Object.entries(props);\n    if (entries.length === 0) return 'Record<string, unknown>';\n\n    const lines = entries.map(([key, val]) => {\n      const optional = required.has(key) ? '' : '?';\n      const valType = jsonSchemaToTS(val, indent + '  ');\n      return `${indent}  ${formatPropertyKey(key)}${optional}: ${valType};`;\n    });\n    return `{\\n${lines.join('\\n')}\\n${indent}}`;\n  }\n\n  return 'unknown';\n}\n\nfunction buildNestedTypeTree(operations: Map<string, OperationDef>): Record<string, unknown> {\n  const tree: Record<string, unknown> = {};\n  for (const [channel, op] of operations) {\n    const parts = channel.split('.');\n    let current: Record<string, unknown> = tree;\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    current[parts[parts.length - 1]] = { __operation: op };\n  }\n  return tree;\n}\n\nfunction generateTypeTree(node: Record<string, unknown>, indent: string = '  '): string {\n  const lines: string[] = [];\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 inputType = jsonSchemaToTS(op.inputSchema as Record<string, unknown>, indent + '  ');\n      const outputType = jsonSchemaToTS(op.outputSchema as Record<string, unknown>, indent + '  ');\n      const hasInput = operationHasInput(op);\n\n      if (hasInput) {\n        lines.push(`${indent}${formatPropertyKey(key)}(data: ${inputType}): Promise<${outputType}>;`);\n      } else {\n        lines.push(`${indent}${formatPropertyKey(key)}(): Promise<${outputType}>;`);\n      }\n    } else {\n      lines.push(`${indent}${formatPropertyKey(key)}: {`);\n      lines.push(generateTypeTree(entry, indent + '  '));\n      lines.push(`${indent}};`);\n    }\n  }\n  return lines.join('\\n');\n}\n\ntype RpcActionTypeEntry = {\n  channel: string;\n  inputType: string;\n  outputType: string;\n  hasInput: boolean;\n};\n\nfunction buildRpcControllerTree(\n  operations: Map<string, OperationDef>,\n): Record<string, Record<string, RpcActionTypeEntry>> {\n  const tree: Record<string, Record<string, RpcActionTypeEntry>> = {};\n\n  for (const operation of operations.values()) {\n    const controller = operation.controller;\n    const action = operation.action;\n\n    if (!tree[controller]) {\n      tree[controller] = {};\n    }\n\n    if (tree[controller][action]) {\n      throw new Error(\n        `Type codegen failed: duplicate RPC action \"${controller}.${action}\" found in channel \"${operation.channel}\".`,\n      );\n    }\n\n    tree[controller][action] = {\n      channel: operation.channel,\n      inputType: jsonSchemaToTS(operation.inputSchema as Record<string, unknown>, '    '),\n      outputType: jsonSchemaToTS(operation.outputSchema as Record<string, unknown>, '    '),\n      hasInput: operationHasInput(operation),\n    };\n  }\n\n  return tree;\n}\n\nfunction generateRpcTypeTree(operations: Map<string, OperationDef>): string {\n  const controllerTree = buildRpcControllerTree(operations);\n  const controllerNames = Object.keys(controllerTree).sort((a, b) => a.localeCompare(b));\n  const lines: string[] = [];\n\n  for (const controllerName of controllerNames) {\n    lines.push(`  ${formatPropertyKey(controllerName)}: {`);\n    const actions = controllerTree[controllerName];\n    const actionNames = Object.keys(actions).sort((a, b) => a.localeCompare(b));\n    for (const actionName of actionNames) {\n      const action = actions[actionName];\n      if (action.hasInput) {\n        lines.push(`    ${formatPropertyKey(actionName)}(data: ${action.inputType}): Promise<${action.outputType}>;`);\n      } else {\n        lines.push(`    ${formatPropertyKey(actionName)}(): Promise<${action.outputType}>;`);\n      }\n    }\n    lines.push('  };');\n  }\n\n  return lines.join('\\n');\n}\n\nexport function generateTypes(operations: Map<string, OperationDef>): string {\n  const tree = buildNestedTypeTree(operations);\n  const typesCode = generateTypeTree(tree);\n  const rpcTypeCode = generateRpcTypeTree(operations);\n\n  return `${generatedFileNotice(TYPE_SOURCE_INSTRUCTIONS)}\nexport interface WoodRpcManifestEntry {\n  channel: string;\n  controller: string;\n  action: string;\n  path: string[];\n  hasInput: boolean;\n}\n\n/**\n * Project-specific renderer App facade contract.\n *\n * This matches @noego/wood/client getApp() and injected App instances:\n * controller name -> controller action.\n */\nexport interface GeneratedApp {\n${rpcTypeCode}\n}\n\n/** Backward-compatible name for the generated client App facade contract. */\nexport interface WoodRpcApi extends GeneratedApp {}\n\n/**\n * Project-specific raw preload bridge contract.\n *\n * This matches the channel path exposed by preload.generated.ts:\n * operation channel segments -> invoke function.\n */\nexport interface GeneratedWoodBridge {\n${typesCode}\n}\n\nexport interface WoodApi extends GeneratedWoodBridge {\n  __rpcManifest: WoodRpcManifestEntry[];\n  __load(route: string, params: Record<string, string>): Promise<unknown>;\n  __navigate(windowId: string, route: string): Promise<void>;\n  __window: {\n    current(): Promise<{ ok: boolean; windowId?: string; defaultRoute?: string }>;\n    open(windowId: string, options?: Record<string, unknown>): Promise<void>;\n    close(windowId?: string): Promise<void>;\n    focus(windowId: string): Promise<void>;\n    minimize(windowId?: string): Promise<void>;\n    maximize(windowId?: string): Promise<void>;\n  };\n  __debug: {\n    current(): Promise<{\n      ok: boolean;\n      enabled: boolean;\n      mode: 'development' | 'production';\n      port?: number;\n      windows: Array<{\n        windowId: string;\n        title: string;\n        webContentsId: number;\n        url: string;\n        focused: boolean;\n        rendererHealth?: 'ready' | 'loading' | 'unresponsive' | 'gone' | 'destroyed';\n      }>;\n    }>;\n  };\n  __contextMenu: {\n    show(data: {\n      items: Array<{ label?: string; action?: string; data?: string; _callbackId?: string; disabled?: boolean; type?: 'separator' }>;\n      position: { x: number; y: number };\n    }): Promise<void>;\n  };\n  on(channel: string, callback: (...args: unknown[]) => void): () => void;\n  __log(level: string, logger: string, message: string, context?: unknown): Promise<{\n    ok: boolean;\n    forwarded: boolean;\n    configured: boolean;\n    reason?: 'unconfigured' | 'callback-error';\n    errorMessage?: string;\n  }>;\n  __logBatch(batch: unknown): void;\n}\n`;\n}\n"],"mappings":"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","names":[]}

package/dist/config/config_parser.cjs

@@ -28,7 +28,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var config_parser_exports = {};
 __export(config_parser_exports, {
-  parseConfig: () => parseConfig
+  RENDERER_TRACE_BATCHING_DEFAULTS: () => RENDERER_TRACE_BATCHING_DEFAULTS,
+  parseConfig: () => parseConfig,
+  resolveRendererTraceBatching: () => resolveRendererTraceBatching
 });
 module.exports = __toCommonJS(config_parser_exports);
 var import_js_yaml = __toESM(require("js-yaml"), 1);
@@ -112,6 +114,23 @@ function requireNumber(_doc, field, value) {
     throw new Error(`Config validation error: "${field}" is required and must be a number`);
   }
 }
+function parseTestingSection(section, raw, allowedKeys) {
+  if (raw === void 0) return {};
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    throw new Error(`Config validation error: "${section}.testing" must be an object`);
+  }
+  const testing = {};
+  for (const [key, value] of Object.entries(raw)) {
+    if (!allowedKeys.includes(key)) {
+      throw new Error(
+        `Config validation error: "${section}.testing.${key}" is not a known hook (allowed: ${allowedKeys.join(", ")})`
+      );
+    }
+    requireString(raw, `${section}.testing.${key}`, value);
+    testing[key] = value;
+  }
+  return { testing };
+}
 function applyDefaults(doc) {
   const app = doc.app;
   const main = doc.main;
@@ -140,14 +159,16 @@ function applyDefaults(doc) {
       controllers: main.controllers,
       middleware: main.middleware,
       openapi: main.openapi,
-      watch: Array.isArray(main.watch) ? main.watch : []
+      watch: Array.isArray(main.watch) ? main.watch : [],
+      ...parseTestingSection("main", main.testing, ["compose"])
     },
     renderer: {
       openapi: renderer.openapi,
       componentDir: renderer.componentDir,
       controllers: renderer.controllers,
       ...typeof renderer.entry === "string" ? { entry: renderer.entry } : {},
-      ...Array.isArray(renderer.watch) ? { watch: renderer.watch } : {}
+      ...Array.isArray(renderer.watch) ? { watch: renderer.watch } : {},
+      ...parseTestingSection("renderer", renderer.testing, ["host"])
     },
     windows,
     dev
@@ -167,10 +188,80 @@ function applyDefaults(doc) {
   if (doc.build && typeof doc.build === "object") {
     config.build = doc.build;
   }
+  if (doc.observability && typeof doc.observability === "object") {
+    config.observability = parseObservability(doc.observability);
+  }
   return config;
 }
+const RENDERER_TRACE_BATCHING_DEFAULTS = Object.freeze({
+  maxQueuedEvents: 256,
+  maxBatchEvents: 32,
+  acknowledgementTimeoutMs: 1e3,
+  retryLimit: 3,
+  retryBaseDelayMs: 25
+});
+function resolveRendererTraceBatching(config) {
+  return {
+    ...RENDERER_TRACE_BATCHING_DEFAULTS,
+    ...config.observability?.trace?.rendererToMain?.batching
+  };
+}
+function parseObservability(raw) {
+  const trace = raw.trace;
+  if (trace === void 0) {
+    return {};
+  }
+  if (typeof trace !== "object" || trace === null) {
+    throw new Error('Config validation error: "observability.trace" must be an object');
+  }
+  const rendererToMain = trace.rendererToMain;
+  if (rendererToMain === void 0) {
+    return { trace: {} };
+  }
+  if (typeof rendererToMain !== "object" || rendererToMain === null) {
+    throw new Error('Config validation error: "observability.trace.rendererToMain" must be an object');
+  }
+  const batching = rendererToMain.batching;
+  if (batching === void 0) {
+    return { trace: { rendererToMain: {} } };
+  }
+  if (typeof batching !== "object" || batching === null) {
+    throw new Error('Config validation error: "observability.trace.rendererToMain.batching" must be an object');
+  }
+  const resolved = {
+    ...RENDERER_TRACE_BATCHING_DEFAULTS,
+    ...batching
+  };
+  const positiveIntFields = ["maxQueuedEvents", "maxBatchEvents", "acknowledgementTimeoutMs"];
+  for (const field of positiveIntFields) {
+    const value = resolved[field];
+    if (!Number.isSafeInteger(value) || value <= 0) {
+      throw new Error(
+        `Config validation error: "observability.trace.rendererToMain.batching.${field}" must be a positive integer`
+      );
+    }
+  }
+  if (!Number.isSafeInteger(resolved.retryLimit) || resolved.retryLimit < 0) {
+    throw new Error(
+      'Config validation error: "observability.trace.rendererToMain.batching.retryLimit" must be a non-negative integer'
+    );
+  }
+  if (!Number.isFinite(resolved.retryBaseDelayMs) || resolved.retryBaseDelayMs < 0) {
+    throw new Error(
+      'Config validation error: "observability.trace.rendererToMain.batching.retryBaseDelayMs" must be a non-negative number'
+    );
+  }
+  if (resolved.maxBatchEvents > resolved.maxQueuedEvents) {
+    throw new Error(
+      'Config validation error: "observability.trace.rendererToMain.batching.maxBatchEvents" cannot exceed maxQueuedEvents'
+    );
+  }
+  return { trace: { rendererToMain: { batching: resolved } } };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  parseConfig
+  RENDERER_TRACE_BATCHING_DEFAULTS,
+  parseConfig,
+  resolveRendererTraceBatching
 });
 //# sourceMappingURL=config_parser.cjs.map

package/dist/config/config_parser.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/config/config_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync, existsSync } from 'fs';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\nimport type { WoodConfig, WindowDef, DevConfig } from '../types/config.cjs';\n\nconst logger = getLogger('wood:config');\n\n/** Default values applied when optional fields are omitted. */\nconst WINDOW_DEFAULTS: Partial<WindowDef> = {\n  frame: true,\n  resizable: true,\n  show: true,\n  modal: false,\n};\n\nconst DEV_DEFAULTS: DevConfig = {\n  watch: true,\n  splitServe: true,\n  port: 5173,\n};\n\n/**\n * Parse and validate a wood.config.yml file, returning a fully-typed WoodConfig\n * with defaults applied for optional fields.\n */\nexport function parseConfig(configPath: string): WoodConfig {\n  const resolved = path.resolve(configPath);\n\n  if (!existsSync(resolved)) {\n    throw new Error(`Config file not found: ${resolved}`);\n  }\n\n  const raw = readFileSync(resolved, 'utf-8');\n  const doc = yaml.load(raw) as Record<string, unknown> | null;\n\n  if (!doc || typeof doc !== 'object') {\n    throw new Error(`Invalid YAML in config file: ${resolved}`);\n  }\n\n  validateRequired(doc);\n\n  const config = applyDefaults(doc as RawConfig);\n\n  logger.info('Parsed config', { path: resolved, windows: Object.keys(config.windows) });\n\n  return config;\n}\n\n/** Shape of the raw YAML before defaults are applied. */\ntype RawConfig = Record<string, unknown>;\n\nfunction validateRequired(doc: Record<string, unknown>): void {\n  requireString(doc, 'app.boot', (doc as Record<string, Record<string, unknown>>).app?.boot);\n  requireString(doc, 'main.entry', (doc as Record<string, Record<string, unknown>>).main?.entry);\n  requireString(doc, 'main.controllers', (doc as Record<string, Record<string, unknown>>).main?.controllers);\n  requireString(doc, 'main.middleware', (doc as Record<string, Record<string, unknown>>).main?.middleware);\n  requireString(doc, 'main.openapi', (doc as Record<string, Record<string, unknown>>).main?.openapi);\n  requireString(doc, 'renderer.openapi', (doc as Record<string, Record<string, unknown>>).renderer?.openapi);\n  requireString(doc, 'renderer.componentDir', (doc as Record<string, Record<string, unknown>>).renderer?.componentDir);\n  requireString(doc, 'renderer.controllers', (doc as Record<string, Record<string, unknown>>).renderer?.controllers);\n  const rendererEntry = (doc as Record<string, Record<string, unknown>>).renderer?.entry;\n  if (rendererEntry !== undefined) {\n    requireString(doc, 'renderer.entry', rendererEntry);\n  }\n\n  // Windows validation\n  const windows = doc.windows;\n  if (!windows || typeof windows !== 'object') {\n    throw new Error('Config validation error: \"windows\" is required and must be an object with at least one window');\n  }\n\n  const windowKeys = Object.keys(windows as Record<string, unknown>);\n  if (windowKeys.length === 0) {\n    throw new Error('Config validation error: \"windows\" must contain at least one window definition');\n  }\n\n  for (const key of windowKeys) {\n    const win = (windows as Record<string, Record<string, unknown>>)[key];\n    if (!win || typeof win !== 'object') {\n      throw new Error(`Config validation error: window \"${key}\" must be an object`);\n    }\n    requireString(doc, `windows.${key}.title`, win.title);\n    requireNumber(doc, `windows.${key}.width`, win.width);\n    requireNumber(doc, `windows.${key}.height`, win.height);\n    requireString(doc, `windows.${key}.defaultRoute`, win.defaultRoute);\n\n    if (win.contextMenu !== undefined) {\n      if (typeof win.contextMenu !== 'string') {\n        throw new Error(`Config validation error: \"windows.${key}.contextMenu\" must be a string`);\n      }\n      if (win.contextMenu !== 'native' && win.contextMenu !== 'custom') {\n        throw new Error(`Config validation error: \"windows.${key}.contextMenu\" must be \"native\" or \"custom\"`);\n      }\n    }\n  }\n}\n\nfunction requireString(_doc: Record<string, unknown>, field: string, value: unknown): asserts value is string {\n  if (typeof value !== 'string' || value.length === 0) {\n    throw new Error(`Config validation error: \"${field}\" is required and must be a non-empty string`);\n  }\n}\n\nfunction requireNumber(_doc: Record<string, unknown>, field: string, value: unknown): asserts value is number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    throw new Error(`Config validation error: \"${field}\" is required and must be a number`);\n  }\n}\n\nfunction applyDefaults(doc: RawConfig): WoodConfig {\n  const app = doc.app as Record<string, unknown>;\n  const main = doc.main as Record<string, unknown>;\n  const renderer = doc.renderer as Record<string, unknown>;\n  const rawWindows = doc.windows as Record<string, Record<string, unknown>>;\n\n  const windows: Record<string, WindowDef> = {};\n  for (const [key, rawWin] of Object.entries(rawWindows)) {\n    windows[key] = {\n      ...WINDOW_DEFAULTS,\n      ...rawWin,\n    } as WindowDef;\n  }\n\n  const dev: DevConfig = {\n    ...DEV_DEFAULTS,\n    ...(doc.dev as Record<string, unknown> | undefined),\n  };\n\n  const config: WoodConfig = {\n    root: typeof doc.root === 'string' ? doc.root : '.',\n    outDir: typeof doc.outDir === 'string' ? doc.outDir : 'dist',\n    app: {\n      boot: app.boot as string,\n      watch: Array.isArray(app.watch) ? (app.watch as string[]) : [],\n    },\n    main: {\n      entry: main.entry as string,\n      controllers: main.controllers as string,\n      middleware: main.middleware as string,\n      openapi: main.openapi as string,\n      watch: Array.isArray(main.watch) ? (main.watch as string[]) : [],\n    },\n    renderer: {\n      openapi: renderer.openapi as string,\n      componentDir: renderer.componentDir as string,\n      controllers: renderer.controllers as string,\n      ...(typeof renderer.entry === 'string' ? { entry: renderer.entry as string } : {}),\n      ...(Array.isArray(renderer.watch) ? { watch: renderer.watch as string[] } : {}),\n    },\n    windows,\n    dev,\n  };\n\n  // Optional database section (preserve :userData: token for runtime expansion)\n  if (doc.database && typeof doc.database === 'object') {\n    const db = doc.database as Record<string, unknown>;\n    if (typeof db.path === 'string') {\n      config.database = {\n        path: db.path,\n        ...(typeof db.migrations === 'string' ? { migrations: db.migrations } : {}),\n      };\n    }\n  }\n\n  // Optional assets\n  if (Array.isArray(doc.assets)) {\n    config.assets = doc.assets as string[];\n  }\n\n  // Optional build section\n  if (doc.build && typeof doc.build === 'object') {\n    config.build = doc.build as WoodConfig['build'];\n  }\n\n  return config;\n}\n"],"mappings":"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","names":["path","yaml"]}
+{"version":3,"sources":["../../src/config/config_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync, existsSync } from 'fs';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\nimport type {\n  WoodConfig,\n  WindowDef,\n  DevConfig,\n  RendererTraceBatchingConfig,\n} from '../types/config.cjs';\n\nconst logger = getLogger('wood:config');\n\n/** Default values applied when optional fields are omitted. */\nconst WINDOW_DEFAULTS: Partial<WindowDef> = {\n  frame: true,\n  resizable: true,\n  show: true,\n  modal: false,\n};\n\nconst DEV_DEFAULTS: DevConfig = {\n  watch: true,\n  splitServe: true,\n  port: 5173,\n};\n\n/**\n * Parse and validate a wood.config.yml file, returning a fully-typed WoodConfig\n * with defaults applied for optional fields.\n */\nexport function parseConfig(configPath: string): WoodConfig {\n  const resolved = path.resolve(configPath);\n\n  if (!existsSync(resolved)) {\n    throw new Error(`Config file not found: ${resolved}`);\n  }\n\n  const raw = readFileSync(resolved, 'utf-8');\n  const doc = yaml.load(raw) as Record<string, unknown> | null;\n\n  if (!doc || typeof doc !== 'object') {\n    throw new Error(`Invalid YAML in config file: ${resolved}`);\n  }\n\n  validateRequired(doc);\n\n  const config = applyDefaults(doc as RawConfig);\n\n  logger.info('Parsed config', { path: resolved, windows: Object.keys(config.windows) });\n\n  return config;\n}\n\n/** Shape of the raw YAML before defaults are applied. */\ntype RawConfig = Record<string, unknown>;\n\nfunction validateRequired(doc: Record<string, unknown>): void {\n  requireString(doc, 'app.boot', (doc as Record<string, Record<string, unknown>>).app?.boot);\n  requireString(doc, 'main.entry', (doc as Record<string, Record<string, unknown>>).main?.entry);\n  requireString(doc, 'main.controllers', (doc as Record<string, Record<string, unknown>>).main?.controllers);\n  requireString(doc, 'main.middleware', (doc as Record<string, Record<string, unknown>>).main?.middleware);\n  requireString(doc, 'main.openapi', (doc as Record<string, Record<string, unknown>>).main?.openapi);\n  requireString(doc, 'renderer.openapi', (doc as Record<string, Record<string, unknown>>).renderer?.openapi);\n  requireString(doc, 'renderer.componentDir', (doc as Record<string, Record<string, unknown>>).renderer?.componentDir);\n  requireString(doc, 'renderer.controllers', (doc as Record<string, Record<string, unknown>>).renderer?.controllers);\n  const rendererEntry = (doc as Record<string, Record<string, unknown>>).renderer?.entry;\n  if (rendererEntry !== undefined) {\n    requireString(doc, 'renderer.entry', rendererEntry);\n  }\n\n  // Windows validation\n  const windows = doc.windows;\n  if (!windows || typeof windows !== 'object') {\n    throw new Error('Config validation error: \"windows\" is required and must be an object with at least one window');\n  }\n\n  const windowKeys = Object.keys(windows as Record<string, unknown>);\n  if (windowKeys.length === 0) {\n    throw new Error('Config validation error: \"windows\" must contain at least one window definition');\n  }\n\n  for (const key of windowKeys) {\n    const win = (windows as Record<string, Record<string, unknown>>)[key];\n    if (!win || typeof win !== 'object') {\n      throw new Error(`Config validation error: window \"${key}\" must be an object`);\n    }\n    requireString(doc, `windows.${key}.title`, win.title);\n    requireNumber(doc, `windows.${key}.width`, win.width);\n    requireNumber(doc, `windows.${key}.height`, win.height);\n    requireString(doc, `windows.${key}.defaultRoute`, win.defaultRoute);\n\n    if (win.contextMenu !== undefined) {\n      if (typeof win.contextMenu !== 'string') {\n        throw new Error(`Config validation error: \"windows.${key}.contextMenu\" must be a string`);\n      }\n      if (win.contextMenu !== 'native' && win.contextMenu !== 'custom') {\n        throw new Error(`Config validation error: \"windows.${key}.contextMenu\" must be \"native\" or \"custom\"`);\n      }\n    }\n  }\n}\n\nfunction requireString(_doc: Record<string, unknown>, field: string, value: unknown): asserts value is string {\n  if (typeof value !== 'string' || value.length === 0) {\n    throw new Error(`Config validation error: \"${field}\" is required and must be a non-empty string`);\n  }\n}\n\nfunction requireNumber(_doc: Record<string, unknown>, field: string, value: unknown): asserts value is number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    throw new Error(`Config validation error: \"${field}\" is required and must be a number`);\n  }\n}\n\n/**\n * Parse an optional `<section>.testing` mapping: every allowed key is an\n * optional non-empty string (a config-relative module path); anything else\n * is a validation error so a typo cannot silently drop a hook.\n */\nfunction parseTestingSection(\n  section: 'main' | 'renderer',\n  raw: unknown,\n  allowedKeys: readonly string[],\n): { testing?: Record<string, string> } {\n  if (raw === undefined) return {};\n  if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {\n    throw new Error(`Config validation error: \"${section}.testing\" must be an object`);\n  }\n  const testing: Record<string, string> = {};\n  for (const [key, value] of Object.entries(raw as Record<string, unknown>)) {\n    if (!allowedKeys.includes(key)) {\n      throw new Error(\n        `Config validation error: \"${section}.testing.${key}\" is not a known hook (allowed: ${allowedKeys.join(', ')})`,\n      );\n    }\n    requireString(raw as Record<string, unknown>, `${section}.testing.${key}`, value);\n    testing[key] = value;\n  }\n  return { testing };\n}\n\nfunction applyDefaults(doc: RawConfig): WoodConfig {\n  const app = doc.app as Record<string, unknown>;\n  const main = doc.main as Record<string, unknown>;\n  const renderer = doc.renderer as Record<string, unknown>;\n  const rawWindows = doc.windows as Record<string, Record<string, unknown>>;\n\n  const windows: Record<string, WindowDef> = {};\n  for (const [key, rawWin] of Object.entries(rawWindows)) {\n    windows[key] = {\n      ...WINDOW_DEFAULTS,\n      ...rawWin,\n    } as WindowDef;\n  }\n\n  const dev: DevConfig = {\n    ...DEV_DEFAULTS,\n    ...(doc.dev as Record<string, unknown> | undefined),\n  };\n\n  const config: WoodConfig = {\n    root: typeof doc.root === 'string' ? doc.root : '.',\n    outDir: typeof doc.outDir === 'string' ? doc.outDir : 'dist',\n    app: {\n      boot: app.boot as string,\n      watch: Array.isArray(app.watch) ? (app.watch as string[]) : [],\n    },\n    main: {\n      entry: main.entry as string,\n      controllers: main.controllers as string,\n      middleware: main.middleware as string,\n      openapi: main.openapi as string,\n      watch: Array.isArray(main.watch) ? (main.watch as string[]) : [],\n      ...parseTestingSection('main', main.testing, ['compose']),\n    },\n    renderer: {\n      openapi: renderer.openapi as string,\n      componentDir: renderer.componentDir as string,\n      controllers: renderer.controllers as string,\n      ...(typeof renderer.entry === 'string' ? { entry: renderer.entry as string } : {}),\n      ...(Array.isArray(renderer.watch) ? { watch: renderer.watch as string[] } : {}),\n      ...parseTestingSection('renderer', renderer.testing, ['host']),\n    },\n    windows,\n    dev,\n  };\n\n  // Optional database section (preserve :userData: token for runtime expansion)\n  if (doc.database && typeof doc.database === 'object') {\n    const db = doc.database as Record<string, unknown>;\n    if (typeof db.path === 'string') {\n      config.database = {\n        path: db.path,\n        ...(typeof db.migrations === 'string' ? { migrations: db.migrations } : {}),\n      };\n    }\n  }\n\n  // Optional assets\n  if (Array.isArray(doc.assets)) {\n    config.assets = doc.assets as string[];\n  }\n\n  // Optional build section\n  if (doc.build && typeof doc.build === 'object') {\n    config.build = doc.build as WoodConfig['build'];\n  }\n\n  // Optional observability section (renderer→main trace batching policy)\n  if (doc.observability && typeof doc.observability === 'object') {\n    config.observability = parseObservability(doc.observability as Record<string, unknown>);\n  }\n\n  return config;\n}\n\n/**\n * Default renderer→main IPC trace batching policy. These values match the\n * policy previously hard-coded in the generated preload; wood.config.yml\n * `observability.trace.rendererToMain.batching` is now the owner.\n */\nexport const RENDERER_TRACE_BATCHING_DEFAULTS: RendererTraceBatchingConfig = Object.freeze({\n  maxQueuedEvents: 256,\n  maxBatchEvents: 32,\n  acknowledgementTimeoutMs: 1_000,\n  retryLimit: 3,\n  retryBaseDelayMs: 25,\n});\n\n/** Resolves the renderer trace batching policy from a parsed config. */\nexport function resolveRendererTraceBatching(\n  config: Pick<WoodConfig, 'observability'>,\n): RendererTraceBatchingConfig {\n  return {\n    ...RENDERER_TRACE_BATCHING_DEFAULTS,\n    ...config.observability?.trace?.rendererToMain?.batching,\n  };\n}\n\nfunction parseObservability(raw: Record<string, unknown>): WoodConfig['observability'] {\n  const trace = raw.trace;\n  if (trace === undefined) {\n    return {};\n  }\n  if (typeof trace !== 'object' || trace === null) {\n    throw new Error('Config validation error: \"observability.trace\" must be an object');\n  }\n  const rendererToMain = (trace as Record<string, unknown>).rendererToMain;\n  if (rendererToMain === undefined) {\n    return { trace: {} };\n  }\n  if (typeof rendererToMain !== 'object' || rendererToMain === null) {\n    throw new Error('Config validation error: \"observability.trace.rendererToMain\" must be an object');\n  }\n  const batching = (rendererToMain as Record<string, unknown>).batching;\n  if (batching === undefined) {\n    return { trace: { rendererToMain: {} } };\n  }\n  if (typeof batching !== 'object' || batching === null) {\n    throw new Error('Config validation error: \"observability.trace.rendererToMain.batching\" must be an object');\n  }\n\n  const resolved: RendererTraceBatchingConfig = {\n    ...RENDERER_TRACE_BATCHING_DEFAULTS,\n    ...(batching as Partial<RendererTraceBatchingConfig>),\n  };\n\n  const positiveIntFields = ['maxQueuedEvents', 'maxBatchEvents', 'acknowledgementTimeoutMs'] as const;\n  for (const field of positiveIntFields) {\n    const value = resolved[field];\n    if (!Number.isSafeInteger(value) || value <= 0) {\n      throw new Error(\n        `Config validation error: \"observability.trace.rendererToMain.batching.${field}\" must be a positive integer`,\n      );\n    }\n  }\n  if (!Number.isSafeInteger(resolved.retryLimit) || resolved.retryLimit < 0) {\n    throw new Error(\n      'Config validation error: \"observability.trace.rendererToMain.batching.retryLimit\" must be a non-negative integer',\n    );\n  }\n  if (!Number.isFinite(resolved.retryBaseDelayMs) || resolved.retryBaseDelayMs < 0) {\n    throw new Error(\n      'Config validation error: \"observability.trace.rendererToMain.batching.retryBaseDelayMs\" must be a non-negative number',\n    );\n  }\n  if (resolved.maxBatchEvents > resolved.maxQueuedEvents) {\n    throw new Error(\n      'Config validation error: \"observability.trace.rendererToMain.batching.maxBatchEvents\" cannot exceed maxQueuedEvents',\n    );\n  }\n\n  return { trace: { rendererToMain: { batching: resolved } } };\n}\n"],"mappings":"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","names":["path","yaml"]}

package/dist/config/config_parser.d.cts

@@ -1,9 +1,17 @@
-import { WoodConfig } from '../types/config.cjs';
+import { RendererTraceBatchingConfig, WoodConfig } from '../types/config.cjs';
 
 /**
  * Parse and validate a wood.config.yml file, returning a fully-typed WoodConfig
  * with defaults applied for optional fields.
  */
 declare function parseConfig(configPath: string): WoodConfig;
+/**
+ * Default renderer→main IPC trace batching policy. These values match the
+ * policy previously hard-coded in the generated preload; wood.config.yml
+ * `observability.trace.rendererToMain.batching` is now the owner.
+ */
+declare const RENDERER_TRACE_BATCHING_DEFAULTS: RendererTraceBatchingConfig;
+/** Resolves the renderer trace batching policy from a parsed config. */
+declare function resolveRendererTraceBatching(config: Pick<WoodConfig, 'observability'>): RendererTraceBatchingConfig;
 
-export { parseConfig };
+export { RENDERER_TRACE_BATCHING_DEFAULTS, parseConfig, resolveRendererTraceBatching };

package/dist/config/config_parser.d.ts

@@ -1,9 +1,17 @@
-import { WoodConfig } from '../types/config.js';
+import { RendererTraceBatchingConfig, WoodConfig } from '../types/config.js';
 
 /**
  * Parse and validate a wood.config.yml file, returning a fully-typed WoodConfig
  * with defaults applied for optional fields.
  */
 declare function parseConfig(configPath: string): WoodConfig;
+/**
+ * Default renderer→main IPC trace batching policy. These values match the
+ * policy previously hard-coded in the generated preload; wood.config.yml
+ * `observability.trace.rendererToMain.batching` is now the owner.
+ */
+declare const RENDERER_TRACE_BATCHING_DEFAULTS: RendererTraceBatchingConfig;
+/** Resolves the renderer trace batching policy from a parsed config. */
+declare function resolveRendererTraceBatching(config: Pick<WoodConfig, 'observability'>): RendererTraceBatchingConfig;
 
-export { parseConfig };
+export { RENDERER_TRACE_BATCHING_DEFAULTS, parseConfig, resolveRendererTraceBatching };

package/dist/config/config_parser.js

@@ -79,6 +79,23 @@ function requireNumber(_doc, field, value) {
     throw new Error(`Config validation error: "${field}" is required and must be a number`);
   }
 }
+function parseTestingSection(section, raw, allowedKeys) {
+  if (raw === void 0) return {};
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    throw new Error(`Config validation error: "${section}.testing" must be an object`);
+  }
+  const testing = {};
+  for (const [key, value] of Object.entries(raw)) {
+    if (!allowedKeys.includes(key)) {
+      throw new Error(
+        `Config validation error: "${section}.testing.${key}" is not a known hook (allowed: ${allowedKeys.join(", ")})`
+      );
+    }
+    requireString(raw, `${section}.testing.${key}`, value);
+    testing[key] = value;
+  }
+  return { testing };
+}
 function applyDefaults(doc) {
   const app = doc.app;
   const main = doc.main;
@@ -107,14 +124,16 @@ function applyDefaults(doc) {
       controllers: main.controllers,
       middleware: main.middleware,
       openapi: main.openapi,
-      watch: Array.isArray(main.watch) ? main.watch : []
+      watch: Array.isArray(main.watch) ? main.watch : [],
+      ...parseTestingSection("main", main.testing, ["compose"])
     },
     renderer: {
       openapi: renderer.openapi,
       componentDir: renderer.componentDir,
       controllers: renderer.controllers,
       ...typeof renderer.entry === "string" ? { entry: renderer.entry } : {},
-      ...Array.isArray(renderer.watch) ? { watch: renderer.watch } : {}
+      ...Array.isArray(renderer.watch) ? { watch: renderer.watch } : {},
+      ...parseTestingSection("renderer", renderer.testing, ["host"])
     },
     windows,
     dev
@@ -134,9 +153,79 @@ function applyDefaults(doc) {
   if (doc.build && typeof doc.build === "object") {
     config.build = doc.build;
   }
+  if (doc.observability && typeof doc.observability === "object") {
+    config.observability = parseObservability(doc.observability);
+  }
   return config;
 }
+const RENDERER_TRACE_BATCHING_DEFAULTS = Object.freeze({
+  maxQueuedEvents: 256,
+  maxBatchEvents: 32,
+  acknowledgementTimeoutMs: 1e3,
+  retryLimit: 3,
+  retryBaseDelayMs: 25
+});
+function resolveRendererTraceBatching(config) {
+  return {
+    ...RENDERER_TRACE_BATCHING_DEFAULTS,
+    ...config.observability?.trace?.rendererToMain?.batching
+  };
+}
+function parseObservability(raw) {
+  const trace = raw.trace;
+  if (trace === void 0) {
+    return {};
+  }
+  if (typeof trace !== "object" || trace === null) {
+    throw new Error('Config validation error: "observability.trace" must be an object');
+  }
+  const rendererToMain = trace.rendererToMain;
+  if (rendererToMain === void 0) {
+    return { trace: {} };
+  }
+  if (typeof rendererToMain !== "object" || rendererToMain === null) {
+    throw new Error('Config validation error: "observability.trace.rendererToMain" must be an object');
+  }
+  const batching = rendererToMain.batching;
+  if (batching === void 0) {
+    return { trace: { rendererToMain: {} } };
+  }
+  if (typeof batching !== "object" || batching === null) {
+    throw new Error('Config validation error: "observability.trace.rendererToMain.batching" must be an object');
+  }
+  const resolved = {
+    ...RENDERER_TRACE_BATCHING_DEFAULTS,
+    ...batching
+  };
+  const positiveIntFields = ["maxQueuedEvents", "maxBatchEvents", "acknowledgementTimeoutMs"];
+  for (const field of positiveIntFields) {
+    const value = resolved[field];
+    if (!Number.isSafeInteger(value) || value <= 0) {
+      throw new Error(
+        `Config validation error: "observability.trace.rendererToMain.batching.${field}" must be a positive integer`
+      );
+    }
+  }
+  if (!Number.isSafeInteger(resolved.retryLimit) || resolved.retryLimit < 0) {
+    throw new Error(
+      'Config validation error: "observability.trace.rendererToMain.batching.retryLimit" must be a non-negative integer'
+    );
+  }
+  if (!Number.isFinite(resolved.retryBaseDelayMs) || resolved.retryBaseDelayMs < 0) {
+    throw new Error(
+      'Config validation error: "observability.trace.rendererToMain.batching.retryBaseDelayMs" must be a non-negative number'
+    );
+  }
+  if (resolved.maxBatchEvents > resolved.maxQueuedEvents) {
+    throw new Error(
+      'Config validation error: "observability.trace.rendererToMain.batching.maxBatchEvents" cannot exceed maxQueuedEvents'
+    );
+  }
+  return { trace: { rendererToMain: { batching: resolved } } };
+}
 export {
-  parseConfig
+  RENDERER_TRACE_BATCHING_DEFAULTS,
+  parseConfig,
+  resolveRendererTraceBatching
 };
 //# sourceMappingURL=config_parser.js.map

package/dist/config/config_parser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/config/config_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync, existsSync } from 'fs';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\nimport type { WoodConfig, WindowDef, DevConfig } from '../types/config.js';\n\nconst logger = getLogger('wood:config');\n\n/** Default values applied when optional fields are omitted. */\nconst WINDOW_DEFAULTS: Partial<WindowDef> = {\n  frame: true,\n  resizable: true,\n  show: true,\n  modal: false,\n};\n\nconst DEV_DEFAULTS: DevConfig = {\n  watch: true,\n  splitServe: true,\n  port: 5173,\n};\n\n/**\n * Parse and validate a wood.config.yml file, returning a fully-typed WoodConfig\n * with defaults applied for optional fields.\n */\nexport function parseConfig(configPath: string): WoodConfig {\n  const resolved = path.resolve(configPath);\n\n  if (!existsSync(resolved)) {\n    throw new Error(`Config file not found: ${resolved}`);\n  }\n\n  const raw = readFileSync(resolved, 'utf-8');\n  const doc = yaml.load(raw) as Record<string, unknown> | null;\n\n  if (!doc || typeof doc !== 'object') {\n    throw new Error(`Invalid YAML in config file: ${resolved}`);\n  }\n\n  validateRequired(doc);\n\n  const config = applyDefaults(doc as RawConfig);\n\n  logger.info('Parsed config', { path: resolved, windows: Object.keys(config.windows) });\n\n  return config;\n}\n\n/** Shape of the raw YAML before defaults are applied. */\ntype RawConfig = Record<string, unknown>;\n\nfunction validateRequired(doc: Record<string, unknown>): void {\n  requireString(doc, 'app.boot', (doc as Record<string, Record<string, unknown>>).app?.boot);\n  requireString(doc, 'main.entry', (doc as Record<string, Record<string, unknown>>).main?.entry);\n  requireString(doc, 'main.controllers', (doc as Record<string, Record<string, unknown>>).main?.controllers);\n  requireString(doc, 'main.middleware', (doc as Record<string, Record<string, unknown>>).main?.middleware);\n  requireString(doc, 'main.openapi', (doc as Record<string, Record<string, unknown>>).main?.openapi);\n  requireString(doc, 'renderer.openapi', (doc as Record<string, Record<string, unknown>>).renderer?.openapi);\n  requireString(doc, 'renderer.componentDir', (doc as Record<string, Record<string, unknown>>).renderer?.componentDir);\n  requireString(doc, 'renderer.controllers', (doc as Record<string, Record<string, unknown>>).renderer?.controllers);\n  const rendererEntry = (doc as Record<string, Record<string, unknown>>).renderer?.entry;\n  if (rendererEntry !== undefined) {\n    requireString(doc, 'renderer.entry', rendererEntry);\n  }\n\n  // Windows validation\n  const windows = doc.windows;\n  if (!windows || typeof windows !== 'object') {\n    throw new Error('Config validation error: \"windows\" is required and must be an object with at least one window');\n  }\n\n  const windowKeys = Object.keys(windows as Record<string, unknown>);\n  if (windowKeys.length === 0) {\n    throw new Error('Config validation error: \"windows\" must contain at least one window definition');\n  }\n\n  for (const key of windowKeys) {\n    const win = (windows as Record<string, Record<string, unknown>>)[key];\n    if (!win || typeof win !== 'object') {\n      throw new Error(`Config validation error: window \"${key}\" must be an object`);\n    }\n    requireString(doc, `windows.${key}.title`, win.title);\n    requireNumber(doc, `windows.${key}.width`, win.width);\n    requireNumber(doc, `windows.${key}.height`, win.height);\n    requireString(doc, `windows.${key}.defaultRoute`, win.defaultRoute);\n\n    if (win.contextMenu !== undefined) {\n      if (typeof win.contextMenu !== 'string') {\n        throw new Error(`Config validation error: \"windows.${key}.contextMenu\" must be a string`);\n      }\n      if (win.contextMenu !== 'native' && win.contextMenu !== 'custom') {\n        throw new Error(`Config validation error: \"windows.${key}.contextMenu\" must be \"native\" or \"custom\"`);\n      }\n    }\n  }\n}\n\nfunction requireString(_doc: Record<string, unknown>, field: string, value: unknown): asserts value is string {\n  if (typeof value !== 'string' || value.length === 0) {\n    throw new Error(`Config validation error: \"${field}\" is required and must be a non-empty string`);\n  }\n}\n\nfunction requireNumber(_doc: Record<string, unknown>, field: string, value: unknown): asserts value is number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    throw new Error(`Config validation error: \"${field}\" is required and must be a number`);\n  }\n}\n\nfunction applyDefaults(doc: RawConfig): WoodConfig {\n  const app = doc.app as Record<string, unknown>;\n  const main = doc.main as Record<string, unknown>;\n  const renderer = doc.renderer as Record<string, unknown>;\n  const rawWindows = doc.windows as Record<string, Record<string, unknown>>;\n\n  const windows: Record<string, WindowDef> = {};\n  for (const [key, rawWin] of Object.entries(rawWindows)) {\n    windows[key] = {\n      ...WINDOW_DEFAULTS,\n      ...rawWin,\n    } as WindowDef;\n  }\n\n  const dev: DevConfig = {\n    ...DEV_DEFAULTS,\n    ...(doc.dev as Record<string, unknown> | undefined),\n  };\n\n  const config: WoodConfig = {\n    root: typeof doc.root === 'string' ? doc.root : '.',\n    outDir: typeof doc.outDir === 'string' ? doc.outDir : 'dist',\n    app: {\n      boot: app.boot as string,\n      watch: Array.isArray(app.watch) ? (app.watch as string[]) : [],\n    },\n    main: {\n      entry: main.entry as string,\n      controllers: main.controllers as string,\n      middleware: main.middleware as string,\n      openapi: main.openapi as string,\n      watch: Array.isArray(main.watch) ? (main.watch as string[]) : [],\n    },\n    renderer: {\n      openapi: renderer.openapi as string,\n      componentDir: renderer.componentDir as string,\n      controllers: renderer.controllers as string,\n      ...(typeof renderer.entry === 'string' ? { entry: renderer.entry as string } : {}),\n      ...(Array.isArray(renderer.watch) ? { watch: renderer.watch as string[] } : {}),\n    },\n    windows,\n    dev,\n  };\n\n  // Optional database section (preserve :userData: token for runtime expansion)\n  if (doc.database && typeof doc.database === 'object') {\n    const db = doc.database as Record<string, unknown>;\n    if (typeof db.path === 'string') {\n      config.database = {\n        path: db.path,\n        ...(typeof db.migrations === 'string' ? { migrations: db.migrations } : {}),\n      };\n    }\n  }\n\n  // Optional assets\n  if (Array.isArray(doc.assets)) {\n    config.assets = doc.assets as string[];\n  }\n\n  // Optional build section\n  if (doc.build && typeof doc.build === 'object') {\n    config.build = doc.build as WoodConfig['build'];\n  }\n\n  return config;\n}\n"],"mappings":"AAAA,OAAO,UAAU;AACjB,SAAS,cAAc,kBAAkB;AACzC,OAAO,UAAU;AACjB,SAAS,iBAAiB;AAG1B,MAAM,SAAS,UAAU,aAAa;AAGtC,MAAM,kBAAsC;AAAA,EAC1C,OAAO;AAAA,EACP,WAAW;AAAA,EACX,MAAM;AAAA,EACN,OAAO;AACT;AAEA,MAAM,eAA0B;AAAA,EAC9B,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,MAAM;AACR;AAMO,SAAS,YAAY,YAAgC;AAC1D,QAAM,WAAW,KAAK,QAAQ,UAAU;AAExC,MAAI,CAAC,WAAW,QAAQ,GAAG;AACzB,UAAM,IAAI,MAAM,0BAA0B,QAAQ,EAAE;AAAA,EACtD;AAEA,QAAM,MAAM,aAAa,UAAU,OAAO;AAC1C,QAAM,MAAM,KAAK,KAAK,GAAG;AAEzB,MAAI,CAAC,OAAO,OAAO,QAAQ,UAAU;AACnC,UAAM,IAAI,MAAM,gCAAgC,QAAQ,EAAE;AAAA,EAC5D;AAEA,mBAAiB,GAAG;AAEpB,QAAM,SAAS,cAAc,GAAgB;AAE7C,SAAO,KAAK,iBAAiB,EAAE,MAAM,UAAU,SAAS,OAAO,KAAK,OAAO,OAAO,EAAE,CAAC;AAErF,SAAO;AACT;AAKA,SAAS,iBAAiB,KAAoC;AAC5D,gBAAc,KAAK,YAAa,IAAgD,KAAK,IAAI;AACzF,gBAAc,KAAK,cAAe,IAAgD,MAAM,KAAK;AAC7F,gBAAc,KAAK,oBAAqB,IAAgD,MAAM,WAAW;AACzG,gBAAc,KAAK,mBAAoB,IAAgD,MAAM,UAAU;AACvG,gBAAc,KAAK,gBAAiB,IAAgD,MAAM,OAAO;AACjG,gBAAc,KAAK,oBAAqB,IAAgD,UAAU,OAAO;AACzG,gBAAc,KAAK,yBAA0B,IAAgD,UAAU,YAAY;AACnH,gBAAc,KAAK,wBAAyB,IAAgD,UAAU,WAAW;AACjH,QAAM,gBAAiB,IAAgD,UAAU;AACjF,MAAI,kBAAkB,QAAW;AAC/B,kBAAc,KAAK,kBAAkB,aAAa;AAAA,EACpD;AAGA,QAAM,UAAU,IAAI;AACpB,MAAI,CAAC,WAAW,OAAO,YAAY,UAAU;AAC3C,UAAM,IAAI,MAAM,+FAA+F;AAAA,EACjH;AAEA,QAAM,aAAa,OAAO,KAAK,OAAkC;AACjE,MAAI,WAAW,WAAW,GAAG;AAC3B,UAAM,IAAI,MAAM,gFAAgF;AAAA,EAClG;AAEA,aAAW,OAAO,YAAY;AAC5B,UAAM,MAAO,QAAoD,GAAG;AACpE,QAAI,CAAC,OAAO,OAAO,QAAQ,UAAU;AACnC,YAAM,IAAI,MAAM,oCAAoC,GAAG,qBAAqB;AAAA,IAC9E;AACA,kBAAc,KAAK,WAAW,GAAG,UAAU,IAAI,KAAK;AACpD,kBAAc,KAAK,WAAW,GAAG,UAAU,IAAI,KAAK;AACpD,kBAAc,KAAK,WAAW,GAAG,WAAW,IAAI,MAAM;AACtD,kBAAc,KAAK,WAAW,GAAG,iBAAiB,IAAI,YAAY;AAElE,QAAI,IAAI,gBAAgB,QAAW;AACjC,UAAI,OAAO,IAAI,gBAAgB,UAAU;AACvC,cAAM,IAAI,MAAM,qCAAqC,GAAG,gCAAgC;AAAA,MAC1F;AACA,UAAI,IAAI,gBAAgB,YAAY,IAAI,gBAAgB,UAAU;AAChE,cAAM,IAAI,MAAM,qCAAqC,GAAG,4CAA4C;AAAA,MACtG;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,cAAc,MAA+B,OAAe,OAAyC;AAC5G,MAAI,OAAO,UAAU,YAAY,MAAM,WAAW,GAAG;AACnD,UAAM,IAAI,MAAM,6BAA6B,KAAK,8CAA8C;AAAA,EAClG;AACF;AAEA,SAAS,cAAc,MAA+B,OAAe,OAAyC;AAC5G,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,GAAG;AACxD,UAAM,IAAI,MAAM,6BAA6B,KAAK,oCAAoC;AAAA,EACxF;AACF;AAEA,SAAS,cAAc,KAA4B;AACjD,QAAM,MAAM,IAAI;AAChB,QAAM,OAAO,IAAI;AACjB,QAAM,WAAW,IAAI;AACrB,QAAM,aAAa,IAAI;AAEvB,QAAM,UAAqC,CAAC;AAC5C,aAAW,CAAC,KAAK,MAAM,KAAK,OAAO,QAAQ,UAAU,GAAG;AACtD,YAAQ,GAAG,IAAI;AAAA,MACb,GAAG;AAAA,MACH,GAAG;AAAA,IACL;AAAA,EACF;AAEA,QAAM,MAAiB;AAAA,IACrB,GAAG;AAAA,IACH,GAAI,IAAI;AAAA,EACV;AAEA,QAAM,SAAqB;AAAA,IACzB,MAAM,OAAO,IAAI,SAAS,WAAW,IAAI,OAAO;AAAA,IAChD,QAAQ,OAAO,IAAI,WAAW,WAAW,IAAI,SAAS;AAAA,IACtD,KAAK;AAAA,MACH,MAAM,IAAI;AAAA,MACV,OAAO,MAAM,QAAQ,IAAI,KAAK,IAAK,IAAI,QAAqB,CAAC;AAAA,IAC/D;AAAA,IACA,MAAM;AAAA,MACJ,OAAO,KAAK;AAAA,MACZ,aAAa,KAAK;AAAA,MAClB,YAAY,KAAK;AAAA,MACjB,SAAS,KAAK;AAAA,MACd,OAAO,MAAM,QAAQ,KAAK,KAAK,IAAK,KAAK,QAAqB,CAAC;AAAA,IACjE;AAAA,IACA,UAAU;AAAA,MACR,SAAS,SAAS;AAAA,MAClB,cAAc,SAAS;AAAA,MACvB,aAAa,SAAS;AAAA,MACtB,GAAI,OAAO,SAAS,UAAU,WAAW,EAAE,OAAO,SAAS,MAAgB,IAAI,CAAC;AAAA,MAChF,GAAI,MAAM,QAAQ,SAAS,KAAK,IAAI,EAAE,OAAO,SAAS,MAAkB,IAAI,CAAC;AAAA,IAC/E;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAGA,MAAI,IAAI,YAAY,OAAO,IAAI,aAAa,UAAU;AACpD,UAAM,KAAK,IAAI;AACf,QAAI,OAAO,GAAG,SAAS,UAAU;AAC/B,aAAO,WAAW;AAAA,QAChB,MAAM,GAAG;AAAA,QACT,GAAI,OAAO,GAAG,eAAe,WAAW,EAAE,YAAY,GAAG,WAAW,IAAI,CAAC;AAAA,MAC3E;AAAA,IACF;AAAA,EACF;AAGA,MAAI,MAAM,QAAQ,IAAI,MAAM,GAAG;AAC7B,WAAO,SAAS,IAAI;AAAA,EACtB;AAGA,MAAI,IAAI,SAAS,OAAO,IAAI,UAAU,UAAU;AAC9C,WAAO,QAAQ,IAAI;AAAA,EACrB;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/config/config_parser.ts"],"sourcesContent":["import yaml from 'js-yaml';\nimport { readFileSync, existsSync } from 'fs';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\nimport type {\n  WoodConfig,\n  WindowDef,\n  DevConfig,\n  RendererTraceBatchingConfig,\n} from '../types/config.js';\n\nconst logger = getLogger('wood:config');\n\n/** Default values applied when optional fields are omitted. */\nconst WINDOW_DEFAULTS: Partial<WindowDef> = {\n  frame: true,\n  resizable: true,\n  show: true,\n  modal: false,\n};\n\nconst DEV_DEFAULTS: DevConfig = {\n  watch: true,\n  splitServe: true,\n  port: 5173,\n};\n\n/**\n * Parse and validate a wood.config.yml file, returning a fully-typed WoodConfig\n * with defaults applied for optional fields.\n */\nexport function parseConfig(configPath: string): WoodConfig {\n  const resolved = path.resolve(configPath);\n\n  if (!existsSync(resolved)) {\n    throw new Error(`Config file not found: ${resolved}`);\n  }\n\n  const raw = readFileSync(resolved, 'utf-8');\n  const doc = yaml.load(raw) as Record<string, unknown> | null;\n\n  if (!doc || typeof doc !== 'object') {\n    throw new Error(`Invalid YAML in config file: ${resolved}`);\n  }\n\n  validateRequired(doc);\n\n  const config = applyDefaults(doc as RawConfig);\n\n  logger.info('Parsed config', { path: resolved, windows: Object.keys(config.windows) });\n\n  return config;\n}\n\n/** Shape of the raw YAML before defaults are applied. */\ntype RawConfig = Record<string, unknown>;\n\nfunction validateRequired(doc: Record<string, unknown>): void {\n  requireString(doc, 'app.boot', (doc as Record<string, Record<string, unknown>>).app?.boot);\n  requireString(doc, 'main.entry', (doc as Record<string, Record<string, unknown>>).main?.entry);\n  requireString(doc, 'main.controllers', (doc as Record<string, Record<string, unknown>>).main?.controllers);\n  requireString(doc, 'main.middleware', (doc as Record<string, Record<string, unknown>>).main?.middleware);\n  requireString(doc, 'main.openapi', (doc as Record<string, Record<string, unknown>>).main?.openapi);\n  requireString(doc, 'renderer.openapi', (doc as Record<string, Record<string, unknown>>).renderer?.openapi);\n  requireString(doc, 'renderer.componentDir', (doc as Record<string, Record<string, unknown>>).renderer?.componentDir);\n  requireString(doc, 'renderer.controllers', (doc as Record<string, Record<string, unknown>>).renderer?.controllers);\n  const rendererEntry = (doc as Record<string, Record<string, unknown>>).renderer?.entry;\n  if (rendererEntry !== undefined) {\n    requireString(doc, 'renderer.entry', rendererEntry);\n  }\n\n  // Windows validation\n  const windows = doc.windows;\n  if (!windows || typeof windows !== 'object') {\n    throw new Error('Config validation error: \"windows\" is required and must be an object with at least one window');\n  }\n\n  const windowKeys = Object.keys(windows as Record<string, unknown>);\n  if (windowKeys.length === 0) {\n    throw new Error('Config validation error: \"windows\" must contain at least one window definition');\n  }\n\n  for (const key of windowKeys) {\n    const win = (windows as Record<string, Record<string, unknown>>)[key];\n    if (!win || typeof win !== 'object') {\n      throw new Error(`Config validation error: window \"${key}\" must be an object`);\n    }\n    requireString(doc, `windows.${key}.title`, win.title);\n    requireNumber(doc, `windows.${key}.width`, win.width);\n    requireNumber(doc, `windows.${key}.height`, win.height);\n    requireString(doc, `windows.${key}.defaultRoute`, win.defaultRoute);\n\n    if (win.contextMenu !== undefined) {\n      if (typeof win.contextMenu !== 'string') {\n        throw new Error(`Config validation error: \"windows.${key}.contextMenu\" must be a string`);\n      }\n      if (win.contextMenu !== 'native' && win.contextMenu !== 'custom') {\n        throw new Error(`Config validation error: \"windows.${key}.contextMenu\" must be \"native\" or \"custom\"`);\n      }\n    }\n  }\n}\n\nfunction requireString(_doc: Record<string, unknown>, field: string, value: unknown): asserts value is string {\n  if (typeof value !== 'string' || value.length === 0) {\n    throw new Error(`Config validation error: \"${field}\" is required and must be a non-empty string`);\n  }\n}\n\nfunction requireNumber(_doc: Record<string, unknown>, field: string, value: unknown): asserts value is number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    throw new Error(`Config validation error: \"${field}\" is required and must be a number`);\n  }\n}\n\n/**\n * Parse an optional `<section>.testing` mapping: every allowed key is an\n * optional non-empty string (a config-relative module path); anything else\n * is a validation error so a typo cannot silently drop a hook.\n */\nfunction parseTestingSection(\n  section: 'main' | 'renderer',\n  raw: unknown,\n  allowedKeys: readonly string[],\n): { testing?: Record<string, string> } {\n  if (raw === undefined) return {};\n  if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {\n    throw new Error(`Config validation error: \"${section}.testing\" must be an object`);\n  }\n  const testing: Record<string, string> = {};\n  for (const [key, value] of Object.entries(raw as Record<string, unknown>)) {\n    if (!allowedKeys.includes(key)) {\n      throw new Error(\n        `Config validation error: \"${section}.testing.${key}\" is not a known hook (allowed: ${allowedKeys.join(', ')})`,\n      );\n    }\n    requireString(raw as Record<string, unknown>, `${section}.testing.${key}`, value);\n    testing[key] = value;\n  }\n  return { testing };\n}\n\nfunction applyDefaults(doc: RawConfig): WoodConfig {\n  const app = doc.app as Record<string, unknown>;\n  const main = doc.main as Record<string, unknown>;\n  const renderer = doc.renderer as Record<string, unknown>;\n  const rawWindows = doc.windows as Record<string, Record<string, unknown>>;\n\n  const windows: Record<string, WindowDef> = {};\n  for (const [key, rawWin] of Object.entries(rawWindows)) {\n    windows[key] = {\n      ...WINDOW_DEFAULTS,\n      ...rawWin,\n    } as WindowDef;\n  }\n\n  const dev: DevConfig = {\n    ...DEV_DEFAULTS,\n    ...(doc.dev as Record<string, unknown> | undefined),\n  };\n\n  const config: WoodConfig = {\n    root: typeof doc.root === 'string' ? doc.root : '.',\n    outDir: typeof doc.outDir === 'string' ? doc.outDir : 'dist',\n    app: {\n      boot: app.boot as string,\n      watch: Array.isArray(app.watch) ? (app.watch as string[]) : [],\n    },\n    main: {\n      entry: main.entry as string,\n      controllers: main.controllers as string,\n      middleware: main.middleware as string,\n      openapi: main.openapi as string,\n      watch: Array.isArray(main.watch) ? (main.watch as string[]) : [],\n      ...parseTestingSection('main', main.testing, ['compose']),\n    },\n    renderer: {\n      openapi: renderer.openapi as string,\n      componentDir: renderer.componentDir as string,\n      controllers: renderer.controllers as string,\n      ...(typeof renderer.entry === 'string' ? { entry: renderer.entry as string } : {}),\n      ...(Array.isArray(renderer.watch) ? { watch: renderer.watch as string[] } : {}),\n      ...parseTestingSection('renderer', renderer.testing, ['host']),\n    },\n    windows,\n    dev,\n  };\n\n  // Optional database section (preserve :userData: token for runtime expansion)\n  if (doc.database && typeof doc.database === 'object') {\n    const db = doc.database as Record<string, unknown>;\n    if (typeof db.path === 'string') {\n      config.database = {\n        path: db.path,\n        ...(typeof db.migrations === 'string' ? { migrations: db.migrations } : {}),\n      };\n    }\n  }\n\n  // Optional assets\n  if (Array.isArray(doc.assets)) {\n    config.assets = doc.assets as string[];\n  }\n\n  // Optional build section\n  if (doc.build && typeof doc.build === 'object') {\n    config.build = doc.build as WoodConfig['build'];\n  }\n\n  // Optional observability section (renderer→main trace batching policy)\n  if (doc.observability && typeof doc.observability === 'object') {\n    config.observability = parseObservability(doc.observability as Record<string, unknown>);\n  }\n\n  return config;\n}\n\n/**\n * Default renderer→main IPC trace batching policy. These values match the\n * policy previously hard-coded in the generated preload; wood.config.yml\n * `observability.trace.rendererToMain.batching` is now the owner.\n */\nexport const RENDERER_TRACE_BATCHING_DEFAULTS: RendererTraceBatchingConfig = Object.freeze({\n  maxQueuedEvents: 256,\n  maxBatchEvents: 32,\n  acknowledgementTimeoutMs: 1_000,\n  retryLimit: 3,\n  retryBaseDelayMs: 25,\n});\n\n/** Resolves the renderer trace batching policy from a parsed config. */\nexport function resolveRendererTraceBatching(\n  config: Pick<WoodConfig, 'observability'>,\n): RendererTraceBatchingConfig {\n  return {\n    ...RENDERER_TRACE_BATCHING_DEFAULTS,\n    ...config.observability?.trace?.rendererToMain?.batching,\n  };\n}\n\nfunction parseObservability(raw: Record<string, unknown>): WoodConfig['observability'] {\n  const trace = raw.trace;\n  if (trace === undefined) {\n    return {};\n  }\n  if (typeof trace !== 'object' || trace === null) {\n    throw new Error('Config validation error: \"observability.trace\" must be an object');\n  }\n  const rendererToMain = (trace as Record<string, unknown>).rendererToMain;\n  if (rendererToMain === undefined) {\n    return { trace: {} };\n  }\n  if (typeof rendererToMain !== 'object' || rendererToMain === null) {\n    throw new Error('Config validation error: \"observability.trace.rendererToMain\" must be an object');\n  }\n  const batching = (rendererToMain as Record<string, unknown>).batching;\n  if (batching === undefined) {\n    return { trace: { rendererToMain: {} } };\n  }\n  if (typeof batching !== 'object' || batching === null) {\n    throw new Error('Config validation error: \"observability.trace.rendererToMain.batching\" must be an object');\n  }\n\n  const resolved: RendererTraceBatchingConfig = {\n    ...RENDERER_TRACE_BATCHING_DEFAULTS,\n    ...(batching as Partial<RendererTraceBatchingConfig>),\n  };\n\n  const positiveIntFields = ['maxQueuedEvents', 'maxBatchEvents', 'acknowledgementTimeoutMs'] as const;\n  for (const field of positiveIntFields) {\n    const value = resolved[field];\n    if (!Number.isSafeInteger(value) || value <= 0) {\n      throw new Error(\n        `Config validation error: \"observability.trace.rendererToMain.batching.${field}\" must be a positive integer`,\n      );\n    }\n  }\n  if (!Number.isSafeInteger(resolved.retryLimit) || resolved.retryLimit < 0) {\n    throw new Error(\n      'Config validation error: \"observability.trace.rendererToMain.batching.retryLimit\" must be a non-negative integer',\n    );\n  }\n  if (!Number.isFinite(resolved.retryBaseDelayMs) || resolved.retryBaseDelayMs < 0) {\n    throw new Error(\n      'Config validation error: \"observability.trace.rendererToMain.batching.retryBaseDelayMs\" must be a non-negative number',\n    );\n  }\n  if (resolved.maxBatchEvents > resolved.maxQueuedEvents) {\n    throw new Error(\n      'Config validation error: \"observability.trace.rendererToMain.batching.maxBatchEvents\" cannot exceed maxQueuedEvents',\n    );\n  }\n\n  return { trace: { rendererToMain: { batching: resolved } } };\n}\n"],"mappings":"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","names":[]}

package/dist/config/index.cjs

@@ -18,12 +18,16 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var config_exports = {};
 __export(config_exports, {
-  parseConfig: () => import_config_parser.parseConfig
+  RENDERER_TRACE_BATCHING_DEFAULTS: () => import_config_parser.RENDERER_TRACE_BATCHING_DEFAULTS,
+  parseConfig: () => import_config_parser.parseConfig,
+  resolveRendererTraceBatching: () => import_config_parser.resolveRendererTraceBatching
 });
 module.exports = __toCommonJS(config_exports);
 var import_config_parser = require("./config_parser.cjs");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  parseConfig
+  RENDERER_TRACE_BATCHING_DEFAULTS,
+  parseConfig,
+  resolveRendererTraceBatching
 });
 //# sourceMappingURL=index.cjs.map

package/dist/config/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/config/index.ts"],"sourcesContent":["export { parseConfig } from './config_parser.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,2BAA4B;","names":[]}
+{"version":3,"sources":["../../src/config/index.ts"],"sourcesContent":["export {\n  parseConfig,\n  resolveRendererTraceBatching,\n  RENDERER_TRACE_BATCHING_DEFAULTS,\n} from './config_parser.cjs';\nexport type {\n  ObservabilityConfig,\n  RendererTraceBatchingConfig,\n} from '../types/config.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,2BAIO;","names":[]}

package/dist/config/index.d.cts

@@ -1,2 +1,2 @@
-export { parseConfig } from './config_parser.cjs';
-import '../types/config.cjs';
+export { RENDERER_TRACE_BATCHING_DEFAULTS, parseConfig, resolveRendererTraceBatching } from './config_parser.cjs';
+export { ObservabilityConfig, RendererTraceBatchingConfig } from '../types/config.cjs';

package/dist/config/index.d.ts

@@ -1,2 +1,2 @@
-export { parseConfig } from './config_parser.js';
-import '../types/config.js';
+export { RENDERER_TRACE_BATCHING_DEFAULTS, parseConfig, resolveRendererTraceBatching } from './config_parser.js';
+export { ObservabilityConfig, RendererTraceBatchingConfig } from '../types/config.js';

package/dist/config/index.js

@@ -1,5 +1,11 @@
-import { parseConfig } from "./config_parser.js";
+import {
+  parseConfig,
+  resolveRendererTraceBatching,
+  RENDERER_TRACE_BATCHING_DEFAULTS
+} from "./config_parser.js";
 export {
-  parseConfig
+  RENDERER_TRACE_BATCHING_DEFAULTS,
+  parseConfig,
+  resolveRendererTraceBatching
 };
 //# sourceMappingURL=index.js.map