@noego/wood 0.4.4 → 0.4.5

package/README.md

@@ -167,6 +167,36 @@ wood build
 
 Both commands generate project artifacts and pass remaining options through to `electron-vite`.
 
+### Generated client contracts
+
+`wood dev` and `wood build` generate `ui/generated/wood.d.ts` from the
+operation manifest. It exports two project-specific contracts:
+
+- `GeneratedApp` matches `@noego/wood/client` `getApp()` and injected `App`
+  instances: controller name -> controller action.
+- `GeneratedWoodBridge` matches the raw preload bridge path: operation channel
+  segments -> invoke function.
+- `WoodRpcApi` remains as a backward-compatible alias for `GeneratedApp`.
+
+Use `GeneratedApp` when testing renderer services that call the injected client
+app:
+
+```ts
+import type { GeneratedApp } from '../generated/wood';
+
+const app = {
+  threads: {
+    updateThreadMode: async () => ({ ok: true }),
+  },
+} satisfies GeneratedApp;
+```
+
+This keeps mocks aligned with the production client facade and makes
+nonexistent methods fail TypeScript instead of failing only at runtime.
+
+Use `GeneratedWoodBridge` only when typing direct access to the raw preload
+bridge shape. Most renderer code should use `GeneratedApp` instead.
+
 ## Development
 
 Repository scripts:

package/bin/wood.js

@@ -24,6 +24,7 @@ const {
   parseOperationsFile,
   parseViewsFile,
   generatePreload,
+  generateTypes,
   generateRuntime,
   generateRendererApp,
 } = await import(distUrl('index.js'));
@@ -316,6 +317,7 @@ function buildCodegenArtifacts(allOperations, allViews) {
   const runtimeWithWindowConfigCode = `${runtimeCode}\n\n${windowConfigSnippet}`;
 
   const preloadCode = generatePreload(allOperations);
+  const typesCode = generateTypes(allOperations);
 
   const rendererComponentDir = path.resolve(projectRoot, rendererSection.componentDir);
   const rendererCodegenOutDir = path.resolve(projectRoot, rendererSection.componentDir, 'generated');
@@ -332,6 +334,7 @@ function buildCodegenArtifacts(allOperations, allViews) {
     codegenOutDir,
     runtimeCode: runtimeWithWindowConfigCode,
     preloadCode,
+    typesCode,
     rendererCodegenOutDir,
     rendererAppCode,
     mainCodegenOutDir,
@@ -361,6 +364,12 @@ function writeCodegenArtifacts(artifacts) {
   );
   console.log('[wood] Generated ui/generated/app.ts');
 
+  writeFileSync(
+    path.join(artifacts.rendererCodegenOutDir, 'wood.d.ts'),
+    artifacts.typesCode,
+  );
+  console.log('[wood] Generated ui/generated/wood.d.ts');
+
   mkdirSync(artifacts.mainCodegenOutDir, { recursive: true });
   writeFileSync(
     path.join(artifacts.mainCodegenOutDir, 'app.ts'),

package/dist/client/index.cjs.map

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

package/dist/client/index.d.cts

@@ -19,7 +19,7 @@ interface WoodRpcManifestEntry {
 declare class App {
     [controllerName: string]: unknown;
 }
-declare function getApp(): App;
+declare function getApp<TApp extends object = App>(): TApp;
 /** Test-only helper to clear the client App singleton. */
 declare function clearClientAppForTests(): void;
 declare class WindowControls {

package/dist/client/index.d.ts

@@ -19,7 +19,7 @@ interface WoodRpcManifestEntry {
 declare class App {
     [controllerName: string]: unknown;
 }
-declare function getApp(): App;
+declare function getApp<TApp extends object = App>(): TApp;
 /** Test-only helper to clear the client App singleton. */
 declare function clearClientAppForTests(): void;
 declare class WindowControls {

package/dist/client/index.js.map

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

package/dist/codegen/type_generator.cjs

@@ -21,6 +21,12 @@ __export(type_generator_exports, {
   generateTypes: () => generateTypes
 });
 module.exports = __toCommonJS(type_generator_exports);
+function formatPropertyKey(key) {
+  if (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)) {
+    return key;
+  }
+  return JSON.stringify(key);
+}
 function operationHasInput(op) {
   return Boolean(
     op.inputSchema && op.inputSchema.type === "object" && Object.keys(op.inputSchema.properties ?? {}).length > 0
@@ -49,7 +55,7 @@ function jsonSchemaToTS(schema, indent = "") {
     const lines = entries.map(([key, val]) => {
       const optional = required.has(key) ? "" : "?";
       const valType = jsonSchemaToTS(val, indent + "  ");
-      return `${indent}  ${key}${optional}: ${valType};`;
+      return `${indent}  ${formatPropertyKey(key)}${optional}: ${valType};`;
     });
     return `{
 ${lines.join("\n")}
@@ -80,12 +86,12 @@ function generateTypeTree(node, indent = "  ") {
       const outputType = jsonSchemaToTS(op.outputSchema, indent + "  ");
       const hasInput = operationHasInput(op);
       if (hasInput) {
-        lines.push(`${indent}${key}(data: ${inputType}): Promise<${outputType}>;`);
+        lines.push(`${indent}${formatPropertyKey(key)}(data: ${inputType}): Promise<${outputType}>;`);
       } else {
-        lines.push(`${indent}${key}(): Promise<${outputType}>;`);
+        lines.push(`${indent}${formatPropertyKey(key)}(): Promise<${outputType}>;`);
       }
     } else {
-      lines.push(`${indent}${key}: {`);
+      lines.push(`${indent}${formatPropertyKey(key)}: {`);
       lines.push(generateTypeTree(entry, indent + "  "));
       lines.push(`${indent}};`);
     }
@@ -119,15 +125,15 @@ function generateRpcTypeTree(operations) {
   const controllerNames = Object.keys(controllerTree).sort((a, b) => a.localeCompare(b));
   const lines = [];
   for (const controllerName of controllerNames) {
-    lines.push(`  ${controllerName}: {`);
+    lines.push(`  ${formatPropertyKey(controllerName)}: {`);
     const actions = controllerTree[controllerName];
     const actionNames = Object.keys(actions).sort((a, b) => a.localeCompare(b));
     for (const actionName of actionNames) {
       const action = actions[actionName];
       if (action.hasInput) {
-        lines.push(`    ${actionName}(data: ${action.inputType}): Promise<${action.outputType}>;`);
+        lines.push(`    ${formatPropertyKey(actionName)}(data: ${action.inputType}): Promise<${action.outputType}>;`);
       } else {
-        lines.push(`    ${actionName}(): Promise<${action.outputType}>;`);
+        lines.push(`    ${formatPropertyKey(actionName)}(): Promise<${action.outputType}>;`);
       }
     }
     lines.push("  };");
@@ -147,12 +153,30 @@ export interface WoodRpcManifestEntry {
   hasInput: boolean;
 }
 
-export interface WoodRpcApi {
+/**
+ * Project-specific renderer App facade contract.
+ *
+ * This matches @noego/wood/client getApp() and injected App instances:
+ * controller name -> controller action.
+ */
+export interface GeneratedApp {
 ${rpcTypeCode}
 }
 
-export interface WoodApi {
+/** Backward-compatible name for the generated client App facade contract. */
+export interface WoodRpcApi extends GeneratedApp {}
+
+/**
+ * Project-specific raw preload bridge contract.
+ *
+ * This matches the channel path exposed by preload.generated.ts:
+ * operation channel segments -> invoke function.
+ */
+export interface GeneratedWoodBridge {
 ${typesCode}
+}
+
+export interface WoodApi extends GeneratedWoodBridge {
   __rpcManifest: WoodRpcManifestEntry[];
   __load(route: string, params: Record<string, string>): Promise<unknown>;
   __navigate(windowId: string, route: string): Promise<void>;

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';\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}  ${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}${key}(data: ${inputType}): Promise<${outputType}>;`);\n      } else {\n        lines.push(`${indent}${key}(): Promise<${outputType}>;`);\n      }\n    } else {\n      lines.push(`${indent}${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(`  ${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(`    ${actionName}(data: ${action.inputType}): Promise<${action.outputType}>;`);\n      } else {\n        lines.push(`    ${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 `// AUTO-GENERATED by @noego/wood -- do not edit\nexport interface WoodRpcManifestEntry {\n  channel: string;\n  controller: string;\n  action: string;\n  path: string[];\n  hasInput: boolean;\n}\n\nexport interface WoodRpcApi {\n${rpcTypeCode}\n}\n\nexport interface WoodApi {\n${typesCode}\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      }>;\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';\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 `// AUTO-GENERATED by @noego/wood -- do not edit\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      }>;\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":[]}

package/dist/codegen/type_generator.js

@@ -1,3 +1,9 @@
+function formatPropertyKey(key) {
+  if (/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)) {
+    return key;
+  }
+  return JSON.stringify(key);
+}
 function operationHasInput(op) {
   return Boolean(
     op.inputSchema && op.inputSchema.type === "object" && Object.keys(op.inputSchema.properties ?? {}).length > 0
@@ -26,7 +32,7 @@ function jsonSchemaToTS(schema, indent = "") {
     const lines = entries.map(([key, val]) => {
       const optional = required.has(key) ? "" : "?";
       const valType = jsonSchemaToTS(val, indent + "  ");
-      return `${indent}  ${key}${optional}: ${valType};`;
+      return `${indent}  ${formatPropertyKey(key)}${optional}: ${valType};`;
     });
     return `{
 ${lines.join("\n")}
@@ -57,12 +63,12 @@ function generateTypeTree(node, indent = "  ") {
       const outputType = jsonSchemaToTS(op.outputSchema, indent + "  ");
       const hasInput = operationHasInput(op);
       if (hasInput) {
-        lines.push(`${indent}${key}(data: ${inputType}): Promise<${outputType}>;`);
+        lines.push(`${indent}${formatPropertyKey(key)}(data: ${inputType}): Promise<${outputType}>;`);
       } else {
-        lines.push(`${indent}${key}(): Promise<${outputType}>;`);
+        lines.push(`${indent}${formatPropertyKey(key)}(): Promise<${outputType}>;`);
       }
     } else {
-      lines.push(`${indent}${key}: {`);
+      lines.push(`${indent}${formatPropertyKey(key)}: {`);
       lines.push(generateTypeTree(entry, indent + "  "));
       lines.push(`${indent}};`);
     }
@@ -96,15 +102,15 @@ function generateRpcTypeTree(operations) {
   const controllerNames = Object.keys(controllerTree).sort((a, b) => a.localeCompare(b));
   const lines = [];
   for (const controllerName of controllerNames) {
-    lines.push(`  ${controllerName}: {`);
+    lines.push(`  ${formatPropertyKey(controllerName)}: {`);
     const actions = controllerTree[controllerName];
     const actionNames = Object.keys(actions).sort((a, b) => a.localeCompare(b));
     for (const actionName of actionNames) {
       const action = actions[actionName];
       if (action.hasInput) {
-        lines.push(`    ${actionName}(data: ${action.inputType}): Promise<${action.outputType}>;`);
+        lines.push(`    ${formatPropertyKey(actionName)}(data: ${action.inputType}): Promise<${action.outputType}>;`);
       } else {
-        lines.push(`    ${actionName}(): Promise<${action.outputType}>;`);
+        lines.push(`    ${formatPropertyKey(actionName)}(): Promise<${action.outputType}>;`);
       }
     }
     lines.push("  };");
@@ -124,12 +130,30 @@ export interface WoodRpcManifestEntry {
   hasInput: boolean;
 }
 
-export interface WoodRpcApi {
+/**
+ * Project-specific renderer App facade contract.
+ *
+ * This matches @noego/wood/client getApp() and injected App instances:
+ * controller name -> controller action.
+ */
+export interface GeneratedApp {
 ${rpcTypeCode}
 }
 
-export interface WoodApi {
+/** Backward-compatible name for the generated client App facade contract. */
+export interface WoodRpcApi extends GeneratedApp {}
+
+/**
+ * Project-specific raw preload bridge contract.
+ *
+ * This matches the channel path exposed by preload.generated.ts:
+ * operation channel segments -> invoke function.
+ */
+export interface GeneratedWoodBridge {
 ${typesCode}
+}
+
+export interface WoodApi extends GeneratedWoodBridge {
   __rpcManifest: WoodRpcManifestEntry[];
   __load(route: string, params: Record<string, string>): Promise<unknown>;
   __navigate(windowId: string, route: string): Promise<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';\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}  ${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}${key}(data: ${inputType}): Promise<${outputType}>;`);\n      } else {\n        lines.push(`${indent}${key}(): Promise<${outputType}>;`);\n      }\n    } else {\n      lines.push(`${indent}${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(`  ${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(`    ${actionName}(data: ${action.inputType}): Promise<${action.outputType}>;`);\n      } else {\n        lines.push(`    ${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 `// AUTO-GENERATED by @noego/wood -- do not edit\nexport interface WoodRpcManifestEntry {\n  channel: string;\n  controller: string;\n  action: string;\n  path: string[];\n  hasInput: boolean;\n}\n\nexport interface WoodRpcApi {\n${rpcTypeCode}\n}\n\nexport interface WoodApi {\n${typesCode}\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      }>;\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';\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 `// AUTO-GENERATED by @noego/wood -- do not edit\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      }>;\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":[]}

package/dist/dev/wood_dev_server.cjs

@@ -108,6 +108,7 @@ class WoodDevServer {
     const rendererComponentDir = import_path.default.resolve(this.cwd, this.config.renderer.componentDir);
     const rendererOutDir = import_path.default.resolve(this.cwd, this.config.renderer.componentDir, "generated");
     (0, import_fs.mkdirSync)(rendererOutDir, { recursive: true });
+    (0, import_fs.writeFileSync)(import_path.default.join(rendererOutDir, "wood.d.ts"), typesCode);
     (0, import_fs.writeFileSync)(
       import_path.default.join(rendererOutDir, "app.ts"),
       (0, import_renderer_app_generator.generateRendererApp)(views, {
@@ -188,6 +189,7 @@ class WoodDevServer {
       viewsYamlPath: this.config.renderer.openapi,
       controllersDir: this.config.main.controllers,
       outDir,
+      rendererOutDir: import_path.default.resolve(this.cwd, this.config.renderer.componentDir, "generated"),
       cwd: this.cwd,
       onViewsChange: async () => {
         const viewsContent = (0, import_fs.readFileSync)(

package/dist/dev/wood_dev_server.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/dev/wood_dev_server.ts"],"sourcesContent":["import { readFileSync, writeFileSync, mkdirSync } from 'fs';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\nimport { parseConfig } from '../config/config_parser.cjs';\nimport { parseOperations } from '../parser/operations_parser.cjs';\nimport { parseViews } from '../parser/views_parser.cjs';\nimport { generatePreload } from '../codegen/preload_generator.cjs';\nimport { generateTypes } from '../codegen/type_generator.cjs';\nimport { generateTestMock } from '../codegen/test_mock_generator.cjs';\nimport { generateControllerRegistration } from '../codegen/controller_registration_generator.cjs';\nimport { generateRuntime } from '../codegen/runtime_generator.cjs';\nimport { generateRendererApp } from '../codegen/renderer_app_generator.cjs';\nimport { BackendBridge } from '../bridge/backend_bridge.cjs';\nimport { BackendWatcher } from './backend_watcher.cjs';\nimport { YamlWatcher } from './yaml_watcher.cjs';\nimport { EsbuildBackend } from './esbuild_backend.cjs';\nimport type { WoodConfig } from '../types/index.cjs';\n\nconst logger = getLogger('wood:dev');\n\nexport interface DevServerOptions {\n  configPath?: string;\n  cwd?: string;\n}\n\nexport class WoodDevServer {\n  private config: WoodConfig | null = null;\n  private bridge: BackendBridge | null = null;\n  private backendWatcher: BackendWatcher | null = null;\n  private yamlWatcher: YamlWatcher | null = null;\n  private esbuild: EsbuildBackend | null = null;\n  private cwd: string;\n\n  constructor(options: DevServerOptions = {}) {\n    this.cwd = options.cwd ?? process.cwd();\n  }\n\n  /**\n   * Start the Wood development server.\n   *\n   * Automatically sets process.env.WOOD_MODE = 'development' so the app\n   * can conditionally use dynamic controller imports (dev) vs pre-registered\n   * controllers from the generated file (production).\n   *\n   * Steps:\n   * 1. Parse config\n   * 2. Parse + stitch YAML\n   * 3. Generate preload, types, mock\n   * 4. Build backend with esbuild\n   * 5. (electron-vite would be started here -- omitted for MVP)\n   * 6. Spawn backend via bridge\n   * 7. Start watchers\n   */\n  async start(): Promise<void> {\n    process.env.WOOD_MODE = 'development';\n\n    // 1. Parse config\n    const configPath = path.resolve(this.cwd, 'wood.config.yml');\n    this.config = parseConfig(configPath);\n    logger.info('config loaded', { outDir: this.config.outDir });\n\n    // 2. Parse operations YAML\n    const opsYamlPath = path.resolve(this.cwd, this.config.main.openapi);\n    const opsContent = readFileSync(opsYamlPath, 'utf-8');\n    const operations = parseOperations(opsContent);\n    logger.info('operations parsed', { count: operations.size });\n\n    // 3. Parse views YAML\n    const viewsYamlPath = path.resolve(this.cwd, this.config.renderer.openapi);\n    const viewsContent = readFileSync(viewsYamlPath, 'utf-8');\n    const views = parseViews(viewsContent);\n    logger.info('views parsed', { count: views.length });\n\n    // 4. Generate files\n    const outDir = path.resolve(this.cwd, this.config.outDir);\n    mkdirSync(outDir, { recursive: true });\n\n    const preloadCode = generatePreload(operations);\n    writeFileSync(path.join(outDir, 'preload.generated.ts'), preloadCode);\n\n    const typesCode = generateTypes(operations);\n    writeFileSync(path.join(outDir, 'wood.d.ts'), typesCode);\n\n    const mockCode = generateTestMock(operations);\n    writeFileSync(path.join(outDir, 'wood.mock.ts'), mockCode);\n\n    const controllersDir = path.resolve(this.cwd, this.config.main.controllers);\n    const controllerRegCode = generateControllerRegistration(operations, {\n      controllersDir,\n      outDir,\n    });\n    writeFileSync(path.join(outDir, 'controllers.generated.ts'), controllerRegCode);\n\n    const runtimeCode = generateRuntime(operations, {\n      controllersDir,\n      outDir,\n    });\n    writeFileSync(path.join(outDir, 'runtime.generated.ts'), runtimeCode);\n\n    const rendererComponentDir = path.resolve(this.cwd, this.config.renderer.componentDir);\n    const rendererOutDir = path.resolve(this.cwd, this.config.renderer.componentDir, 'generated');\n    mkdirSync(rendererOutDir, { recursive: true });\n\n    writeFileSync(\n      path.join(rendererOutDir, 'app.ts'),\n      generateRendererApp(views, {\n        componentDir: rendererComponentDir,\n        outDir: rendererOutDir,\n        entryViewKey: this.config.renderer.entry,\n      }),\n    );\n\n    logger.info('codegen complete', { outDir });\n\n    // 5. Build backend with esbuild (initial build + create incremental context)\n    const backendEntry = this.config.main.entry;\n    const backendOutfile = path.join(this.config.outDir, 'backend', 'index.js');\n\n    this.esbuild = new EsbuildBackend({\n      entryPoint: backendEntry,\n      outfile: backendOutfile,\n      cwd: this.cwd,\n      external: this.config.build ? [] : undefined,\n    });\n\n    await this.esbuild.build();\n    await this.esbuild.createContext();\n\n    // 6. Start backend bridge (split-serve)\n    if (this.config.dev?.splitServe !== false) {\n      const resolvedBackendEntry = path.resolve(this.cwd, backendOutfile);\n      this.bridge = new BackendBridge({\n        backendEntry: resolvedBackendEntry,\n        onReady: () => {\n          logger.info('backend ready (split-serve)');\n        },\n        onPush: (channel, data) => {\n          logger.debug('backend push', { channel, data });\n        },\n        onExit: (code, signal) => {\n          logger.debug('backend exited', { code, signal });\n        },\n      });\n      await this.bridge.start();\n    }\n\n    // 7. Start watchers\n    if (this.config.dev?.watch !== false) {\n      this.startWatchers(outDir);\n    }\n  }\n\n  /** Stop the dev server and clean up all resources. */\n  async stop(): Promise<void> {\n    this.backendWatcher?.stop();\n    this.yamlWatcher?.stop();\n\n    if (this.bridge) {\n      await this.bridge.stop();\n      logger.info('backend bridge stopped');\n    }\n\n    if (this.esbuild) {\n      await this.esbuild.dispose();\n    }\n  }\n\n  /** Get the parsed config. */\n  getConfig(): WoodConfig | null {\n    return this.config;\n  }\n\n  private startWatchers(outDir: string): void {\n    if (!this.config) return;\n\n    // Backend watcher: server + middleware files -> rebuild + restart\n    if (this.bridge && this.esbuild) {\n      const backendPatterns = [\n        `${this.config.main.controllers}/**/*.ts`,\n        `${this.config.main.middleware}/**/*.ts`,\n        `${this.config.main.entry}`,\n        ...(this.config.main.watch ?? []),\n      ];\n\n      const esbuild = this.esbuild;\n      this.backendWatcher = new BackendWatcher({\n        patterns: backendPatterns,\n        bridge: this.bridge,\n        buildFn: () => esbuild.rebuild().then(() => {}),\n        cwd: this.cwd,\n      });\n      this.backendWatcher.start();\n      logger.info('backend watcher started', { patterns: backendPatterns });\n    }\n\n    // YAML watcher: operations + views YAML -> regenerate codegen\n    this.yamlWatcher = new YamlWatcher({\n      operationsYamlPath: this.config.main.openapi,\n      viewsYamlPath: this.config.renderer.openapi,\n      controllersDir: this.config.main.controllers,\n      outDir,\n      cwd: this.cwd,\n      onViewsChange: async () => {\n        // Re-parse views and regenerate client router manifest\n        const viewsContent = readFileSync(\n          path.resolve(this.cwd, this.config!.renderer.openapi),\n          'utf-8',\n        );\n        const views = parseViews(viewsContent);\n\n        const rendererComponentDir = path.resolve(this.cwd, this.config!.renderer.componentDir);\n        const rendererOutDir = path.resolve(this.cwd, this.config!.renderer.componentDir, 'generated');\n        mkdirSync(rendererOutDir, { recursive: true });\n\n        writeFileSync(\n          path.join(rendererOutDir, 'app.ts'),\n          generateRendererApp(views, {\n            componentDir: rendererComponentDir,\n            outDir: rendererOutDir,\n            entryViewKey: this.config!.renderer.entry,\n          }),\n        );\n\n        logger.info('views renderer codegen regenerated', { rendererOutDir });\n      },\n    });\n    this.yamlWatcher.start();\n    logger.info('yaml watcher started');\n  }\n}\n"],"mappings":"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","names":["path"]}
+{"version":3,"sources":["../../src/dev/wood_dev_server.ts"],"sourcesContent":["import { readFileSync, writeFileSync, mkdirSync } from 'fs';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\nimport { parseConfig } from '../config/config_parser.cjs';\nimport { parseOperations } from '../parser/operations_parser.cjs';\nimport { parseViews } from '../parser/views_parser.cjs';\nimport { generatePreload } from '../codegen/preload_generator.cjs';\nimport { generateTypes } from '../codegen/type_generator.cjs';\nimport { generateTestMock } from '../codegen/test_mock_generator.cjs';\nimport { generateControllerRegistration } from '../codegen/controller_registration_generator.cjs';\nimport { generateRuntime } from '../codegen/runtime_generator.cjs';\nimport { generateRendererApp } from '../codegen/renderer_app_generator.cjs';\nimport { BackendBridge } from '../bridge/backend_bridge.cjs';\nimport { BackendWatcher } from './backend_watcher.cjs';\nimport { YamlWatcher } from './yaml_watcher.cjs';\nimport { EsbuildBackend } from './esbuild_backend.cjs';\nimport type { WoodConfig } from '../types/index.cjs';\n\nconst logger = getLogger('wood:dev');\n\nexport interface DevServerOptions {\n  configPath?: string;\n  cwd?: string;\n}\n\nexport class WoodDevServer {\n  private config: WoodConfig | null = null;\n  private bridge: BackendBridge | null = null;\n  private backendWatcher: BackendWatcher | null = null;\n  private yamlWatcher: YamlWatcher | null = null;\n  private esbuild: EsbuildBackend | null = null;\n  private cwd: string;\n\n  constructor(options: DevServerOptions = {}) {\n    this.cwd = options.cwd ?? process.cwd();\n  }\n\n  /**\n   * Start the Wood development server.\n   *\n   * Automatically sets process.env.WOOD_MODE = 'development' so the app\n   * can conditionally use dynamic controller imports (dev) vs pre-registered\n   * controllers from the generated file (production).\n   *\n   * Steps:\n   * 1. Parse config\n   * 2. Parse + stitch YAML\n   * 3. Generate preload, types, mock\n   * 4. Build backend with esbuild\n   * 5. (electron-vite would be started here -- omitted for MVP)\n   * 6. Spawn backend via bridge\n   * 7. Start watchers\n   */\n  async start(): Promise<void> {\n    process.env.WOOD_MODE = 'development';\n\n    // 1. Parse config\n    const configPath = path.resolve(this.cwd, 'wood.config.yml');\n    this.config = parseConfig(configPath);\n    logger.info('config loaded', { outDir: this.config.outDir });\n\n    // 2. Parse operations YAML\n    const opsYamlPath = path.resolve(this.cwd, this.config.main.openapi);\n    const opsContent = readFileSync(opsYamlPath, 'utf-8');\n    const operations = parseOperations(opsContent);\n    logger.info('operations parsed', { count: operations.size });\n\n    // 3. Parse views YAML\n    const viewsYamlPath = path.resolve(this.cwd, this.config.renderer.openapi);\n    const viewsContent = readFileSync(viewsYamlPath, 'utf-8');\n    const views = parseViews(viewsContent);\n    logger.info('views parsed', { count: views.length });\n\n    // 4. Generate files\n    const outDir = path.resolve(this.cwd, this.config.outDir);\n    mkdirSync(outDir, { recursive: true });\n\n    const preloadCode = generatePreload(operations);\n    writeFileSync(path.join(outDir, 'preload.generated.ts'), preloadCode);\n\n    const typesCode = generateTypes(operations);\n    writeFileSync(path.join(outDir, 'wood.d.ts'), typesCode);\n\n    const mockCode = generateTestMock(operations);\n    writeFileSync(path.join(outDir, 'wood.mock.ts'), mockCode);\n\n    const controllersDir = path.resolve(this.cwd, this.config.main.controllers);\n    const controllerRegCode = generateControllerRegistration(operations, {\n      controllersDir,\n      outDir,\n    });\n    writeFileSync(path.join(outDir, 'controllers.generated.ts'), controllerRegCode);\n\n    const runtimeCode = generateRuntime(operations, {\n      controllersDir,\n      outDir,\n    });\n    writeFileSync(path.join(outDir, 'runtime.generated.ts'), runtimeCode);\n\n    const rendererComponentDir = path.resolve(this.cwd, this.config.renderer.componentDir);\n    const rendererOutDir = path.resolve(this.cwd, this.config.renderer.componentDir, 'generated');\n    mkdirSync(rendererOutDir, { recursive: true });\n\n    writeFileSync(path.join(rendererOutDir, 'wood.d.ts'), typesCode);\n\n    writeFileSync(\n      path.join(rendererOutDir, 'app.ts'),\n      generateRendererApp(views, {\n        componentDir: rendererComponentDir,\n        outDir: rendererOutDir,\n        entryViewKey: this.config.renderer.entry,\n      }),\n    );\n\n    logger.info('codegen complete', { outDir });\n\n    // 5. Build backend with esbuild (initial build + create incremental context)\n    const backendEntry = this.config.main.entry;\n    const backendOutfile = path.join(this.config.outDir, 'backend', 'index.js');\n\n    this.esbuild = new EsbuildBackend({\n      entryPoint: backendEntry,\n      outfile: backendOutfile,\n      cwd: this.cwd,\n      external: this.config.build ? [] : undefined,\n    });\n\n    await this.esbuild.build();\n    await this.esbuild.createContext();\n\n    // 6. Start backend bridge (split-serve)\n    if (this.config.dev?.splitServe !== false) {\n      const resolvedBackendEntry = path.resolve(this.cwd, backendOutfile);\n      this.bridge = new BackendBridge({\n        backendEntry: resolvedBackendEntry,\n        onReady: () => {\n          logger.info('backend ready (split-serve)');\n        },\n        onPush: (channel, data) => {\n          logger.debug('backend push', { channel, data });\n        },\n        onExit: (code, signal) => {\n          logger.debug('backend exited', { code, signal });\n        },\n      });\n      await this.bridge.start();\n    }\n\n    // 7. Start watchers\n    if (this.config.dev?.watch !== false) {\n      this.startWatchers(outDir);\n    }\n  }\n\n  /** Stop the dev server and clean up all resources. */\n  async stop(): Promise<void> {\n    this.backendWatcher?.stop();\n    this.yamlWatcher?.stop();\n\n    if (this.bridge) {\n      await this.bridge.stop();\n      logger.info('backend bridge stopped');\n    }\n\n    if (this.esbuild) {\n      await this.esbuild.dispose();\n    }\n  }\n\n  /** Get the parsed config. */\n  getConfig(): WoodConfig | null {\n    return this.config;\n  }\n\n  private startWatchers(outDir: string): void {\n    if (!this.config) return;\n\n    // Backend watcher: server + middleware files -> rebuild + restart\n    if (this.bridge && this.esbuild) {\n      const backendPatterns = [\n        `${this.config.main.controllers}/**/*.ts`,\n        `${this.config.main.middleware}/**/*.ts`,\n        `${this.config.main.entry}`,\n        ...(this.config.main.watch ?? []),\n      ];\n\n      const esbuild = this.esbuild;\n      this.backendWatcher = new BackendWatcher({\n        patterns: backendPatterns,\n        bridge: this.bridge,\n        buildFn: () => esbuild.rebuild().then(() => {}),\n        cwd: this.cwd,\n      });\n      this.backendWatcher.start();\n      logger.info('backend watcher started', { patterns: backendPatterns });\n    }\n\n    // YAML watcher: operations + views YAML -> regenerate codegen\n    this.yamlWatcher = new YamlWatcher({\n      operationsYamlPath: this.config.main.openapi,\n      viewsYamlPath: this.config.renderer.openapi,\n      controllersDir: this.config.main.controllers,\n      outDir,\n      rendererOutDir: path.resolve(this.cwd, this.config.renderer.componentDir, 'generated'),\n      cwd: this.cwd,\n      onViewsChange: async () => {\n        // Re-parse views and regenerate client router manifest\n        const viewsContent = readFileSync(\n          path.resolve(this.cwd, this.config!.renderer.openapi),\n          'utf-8',\n        );\n        const views = parseViews(viewsContent);\n\n        const rendererComponentDir = path.resolve(this.cwd, this.config!.renderer.componentDir);\n        const rendererOutDir = path.resolve(this.cwd, this.config!.renderer.componentDir, 'generated');\n        mkdirSync(rendererOutDir, { recursive: true });\n\n        writeFileSync(\n          path.join(rendererOutDir, 'app.ts'),\n          generateRendererApp(views, {\n            componentDir: rendererComponentDir,\n            outDir: rendererOutDir,\n            entryViewKey: this.config!.renderer.entry,\n          }),\n        );\n\n        logger.info('views renderer codegen regenerated', { rendererOutDir });\n      },\n    });\n    this.yamlWatcher.start();\n    logger.info('yaml watcher started');\n  }\n}\n"],"mappings":"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","names":["path"]}

package/dist/dev/wood_dev_server.js

@@ -75,6 +75,7 @@ class WoodDevServer {
     const rendererComponentDir = path.resolve(this.cwd, this.config.renderer.componentDir);
     const rendererOutDir = path.resolve(this.cwd, this.config.renderer.componentDir, "generated");
     mkdirSync(rendererOutDir, { recursive: true });
+    writeFileSync(path.join(rendererOutDir, "wood.d.ts"), typesCode);
     writeFileSync(
       path.join(rendererOutDir, "app.ts"),
       generateRendererApp(views, {
@@ -155,6 +156,7 @@ class WoodDevServer {
       viewsYamlPath: this.config.renderer.openapi,
       controllersDir: this.config.main.controllers,
       outDir,
+      rendererOutDir: path.resolve(this.cwd, this.config.renderer.componentDir, "generated"),
       cwd: this.cwd,
       onViewsChange: async () => {
         const viewsContent = readFileSync(

package/dist/dev/wood_dev_server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/dev/wood_dev_server.ts"],"sourcesContent":["import { readFileSync, writeFileSync, mkdirSync } from 'fs';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\nimport { parseConfig } from '../config/config_parser.js';\nimport { parseOperations } from '../parser/operations_parser.js';\nimport { parseViews } from '../parser/views_parser.js';\nimport { generatePreload } from '../codegen/preload_generator.js';\nimport { generateTypes } from '../codegen/type_generator.js';\nimport { generateTestMock } from '../codegen/test_mock_generator.js';\nimport { generateControllerRegistration } from '../codegen/controller_registration_generator.js';\nimport { generateRuntime } from '../codegen/runtime_generator.js';\nimport { generateRendererApp } from '../codegen/renderer_app_generator.js';\nimport { BackendBridge } from '../bridge/backend_bridge.js';\nimport { BackendWatcher } from './backend_watcher.js';\nimport { YamlWatcher } from './yaml_watcher.js';\nimport { EsbuildBackend } from './esbuild_backend.js';\nimport type { WoodConfig } from '../types/index.js';\n\nconst logger = getLogger('wood:dev');\n\nexport interface DevServerOptions {\n  configPath?: string;\n  cwd?: string;\n}\n\nexport class WoodDevServer {\n  private config: WoodConfig | null = null;\n  private bridge: BackendBridge | null = null;\n  private backendWatcher: BackendWatcher | null = null;\n  private yamlWatcher: YamlWatcher | null = null;\n  private esbuild: EsbuildBackend | null = null;\n  private cwd: string;\n\n  constructor(options: DevServerOptions = {}) {\n    this.cwd = options.cwd ?? process.cwd();\n  }\n\n  /**\n   * Start the Wood development server.\n   *\n   * Automatically sets process.env.WOOD_MODE = 'development' so the app\n   * can conditionally use dynamic controller imports (dev) vs pre-registered\n   * controllers from the generated file (production).\n   *\n   * Steps:\n   * 1. Parse config\n   * 2. Parse + stitch YAML\n   * 3. Generate preload, types, mock\n   * 4. Build backend with esbuild\n   * 5. (electron-vite would be started here -- omitted for MVP)\n   * 6. Spawn backend via bridge\n   * 7. Start watchers\n   */\n  async start(): Promise<void> {\n    process.env.WOOD_MODE = 'development';\n\n    // 1. Parse config\n    const configPath = path.resolve(this.cwd, 'wood.config.yml');\n    this.config = parseConfig(configPath);\n    logger.info('config loaded', { outDir: this.config.outDir });\n\n    // 2. Parse operations YAML\n    const opsYamlPath = path.resolve(this.cwd, this.config.main.openapi);\n    const opsContent = readFileSync(opsYamlPath, 'utf-8');\n    const operations = parseOperations(opsContent);\n    logger.info('operations parsed', { count: operations.size });\n\n    // 3. Parse views YAML\n    const viewsYamlPath = path.resolve(this.cwd, this.config.renderer.openapi);\n    const viewsContent = readFileSync(viewsYamlPath, 'utf-8');\n    const views = parseViews(viewsContent);\n    logger.info('views parsed', { count: views.length });\n\n    // 4. Generate files\n    const outDir = path.resolve(this.cwd, this.config.outDir);\n    mkdirSync(outDir, { recursive: true });\n\n    const preloadCode = generatePreload(operations);\n    writeFileSync(path.join(outDir, 'preload.generated.ts'), preloadCode);\n\n    const typesCode = generateTypes(operations);\n    writeFileSync(path.join(outDir, 'wood.d.ts'), typesCode);\n\n    const mockCode = generateTestMock(operations);\n    writeFileSync(path.join(outDir, 'wood.mock.ts'), mockCode);\n\n    const controllersDir = path.resolve(this.cwd, this.config.main.controllers);\n    const controllerRegCode = generateControllerRegistration(operations, {\n      controllersDir,\n      outDir,\n    });\n    writeFileSync(path.join(outDir, 'controllers.generated.ts'), controllerRegCode);\n\n    const runtimeCode = generateRuntime(operations, {\n      controllersDir,\n      outDir,\n    });\n    writeFileSync(path.join(outDir, 'runtime.generated.ts'), runtimeCode);\n\n    const rendererComponentDir = path.resolve(this.cwd, this.config.renderer.componentDir);\n    const rendererOutDir = path.resolve(this.cwd, this.config.renderer.componentDir, 'generated');\n    mkdirSync(rendererOutDir, { recursive: true });\n\n    writeFileSync(\n      path.join(rendererOutDir, 'app.ts'),\n      generateRendererApp(views, {\n        componentDir: rendererComponentDir,\n        outDir: rendererOutDir,\n        entryViewKey: this.config.renderer.entry,\n      }),\n    );\n\n    logger.info('codegen complete', { outDir });\n\n    // 5. Build backend with esbuild (initial build + create incremental context)\n    const backendEntry = this.config.main.entry;\n    const backendOutfile = path.join(this.config.outDir, 'backend', 'index.js');\n\n    this.esbuild = new EsbuildBackend({\n      entryPoint: backendEntry,\n      outfile: backendOutfile,\n      cwd: this.cwd,\n      external: this.config.build ? [] : undefined,\n    });\n\n    await this.esbuild.build();\n    await this.esbuild.createContext();\n\n    // 6. Start backend bridge (split-serve)\n    if (this.config.dev?.splitServe !== false) {\n      const resolvedBackendEntry = path.resolve(this.cwd, backendOutfile);\n      this.bridge = new BackendBridge({\n        backendEntry: resolvedBackendEntry,\n        onReady: () => {\n          logger.info('backend ready (split-serve)');\n        },\n        onPush: (channel, data) => {\n          logger.debug('backend push', { channel, data });\n        },\n        onExit: (code, signal) => {\n          logger.debug('backend exited', { code, signal });\n        },\n      });\n      await this.bridge.start();\n    }\n\n    // 7. Start watchers\n    if (this.config.dev?.watch !== false) {\n      this.startWatchers(outDir);\n    }\n  }\n\n  /** Stop the dev server and clean up all resources. */\n  async stop(): Promise<void> {\n    this.backendWatcher?.stop();\n    this.yamlWatcher?.stop();\n\n    if (this.bridge) {\n      await this.bridge.stop();\n      logger.info('backend bridge stopped');\n    }\n\n    if (this.esbuild) {\n      await this.esbuild.dispose();\n    }\n  }\n\n  /** Get the parsed config. */\n  getConfig(): WoodConfig | null {\n    return this.config;\n  }\n\n  private startWatchers(outDir: string): void {\n    if (!this.config) return;\n\n    // Backend watcher: server + middleware files -> rebuild + restart\n    if (this.bridge && this.esbuild) {\n      const backendPatterns = [\n        `${this.config.main.controllers}/**/*.ts`,\n        `${this.config.main.middleware}/**/*.ts`,\n        `${this.config.main.entry}`,\n        ...(this.config.main.watch ?? []),\n      ];\n\n      const esbuild = this.esbuild;\n      this.backendWatcher = new BackendWatcher({\n        patterns: backendPatterns,\n        bridge: this.bridge,\n        buildFn: () => esbuild.rebuild().then(() => {}),\n        cwd: this.cwd,\n      });\n      this.backendWatcher.start();\n      logger.info('backend watcher started', { patterns: backendPatterns });\n    }\n\n    // YAML watcher: operations + views YAML -> regenerate codegen\n    this.yamlWatcher = new YamlWatcher({\n      operationsYamlPath: this.config.main.openapi,\n      viewsYamlPath: this.config.renderer.openapi,\n      controllersDir: this.config.main.controllers,\n      outDir,\n      cwd: this.cwd,\n      onViewsChange: async () => {\n        // Re-parse views and regenerate client router manifest\n        const viewsContent = readFileSync(\n          path.resolve(this.cwd, this.config!.renderer.openapi),\n          'utf-8',\n        );\n        const views = parseViews(viewsContent);\n\n        const rendererComponentDir = path.resolve(this.cwd, this.config!.renderer.componentDir);\n        const rendererOutDir = path.resolve(this.cwd, this.config!.renderer.componentDir, 'generated');\n        mkdirSync(rendererOutDir, { recursive: true });\n\n        writeFileSync(\n          path.join(rendererOutDir, 'app.ts'),\n          generateRendererApp(views, {\n            componentDir: rendererComponentDir,\n            outDir: rendererOutDir,\n            entryViewKey: this.config!.renderer.entry,\n          }),\n        );\n\n        logger.info('views renderer codegen regenerated', { rendererOutDir });\n      },\n    });\n    this.yamlWatcher.start();\n    logger.info('yaml watcher started');\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/dev/wood_dev_server.ts"],"sourcesContent":["import { readFileSync, writeFileSync, mkdirSync } from 'fs';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\nimport { parseConfig } from '../config/config_parser.js';\nimport { parseOperations } from '../parser/operations_parser.js';\nimport { parseViews } from '../parser/views_parser.js';\nimport { generatePreload } from '../codegen/preload_generator.js';\nimport { generateTypes } from '../codegen/type_generator.js';\nimport { generateTestMock } from '../codegen/test_mock_generator.js';\nimport { generateControllerRegistration } from '../codegen/controller_registration_generator.js';\nimport { generateRuntime } from '../codegen/runtime_generator.js';\nimport { generateRendererApp } from '../codegen/renderer_app_generator.js';\nimport { BackendBridge } from '../bridge/backend_bridge.js';\nimport { BackendWatcher } from './backend_watcher.js';\nimport { YamlWatcher } from './yaml_watcher.js';\nimport { EsbuildBackend } from './esbuild_backend.js';\nimport type { WoodConfig } from '../types/index.js';\n\nconst logger = getLogger('wood:dev');\n\nexport interface DevServerOptions {\n  configPath?: string;\n  cwd?: string;\n}\n\nexport class WoodDevServer {\n  private config: WoodConfig | null = null;\n  private bridge: BackendBridge | null = null;\n  private backendWatcher: BackendWatcher | null = null;\n  private yamlWatcher: YamlWatcher | null = null;\n  private esbuild: EsbuildBackend | null = null;\n  private cwd: string;\n\n  constructor(options: DevServerOptions = {}) {\n    this.cwd = options.cwd ?? process.cwd();\n  }\n\n  /**\n   * Start the Wood development server.\n   *\n   * Automatically sets process.env.WOOD_MODE = 'development' so the app\n   * can conditionally use dynamic controller imports (dev) vs pre-registered\n   * controllers from the generated file (production).\n   *\n   * Steps:\n   * 1. Parse config\n   * 2. Parse + stitch YAML\n   * 3. Generate preload, types, mock\n   * 4. Build backend with esbuild\n   * 5. (electron-vite would be started here -- omitted for MVP)\n   * 6. Spawn backend via bridge\n   * 7. Start watchers\n   */\n  async start(): Promise<void> {\n    process.env.WOOD_MODE = 'development';\n\n    // 1. Parse config\n    const configPath = path.resolve(this.cwd, 'wood.config.yml');\n    this.config = parseConfig(configPath);\n    logger.info('config loaded', { outDir: this.config.outDir });\n\n    // 2. Parse operations YAML\n    const opsYamlPath = path.resolve(this.cwd, this.config.main.openapi);\n    const opsContent = readFileSync(opsYamlPath, 'utf-8');\n    const operations = parseOperations(opsContent);\n    logger.info('operations parsed', { count: operations.size });\n\n    // 3. Parse views YAML\n    const viewsYamlPath = path.resolve(this.cwd, this.config.renderer.openapi);\n    const viewsContent = readFileSync(viewsYamlPath, 'utf-8');\n    const views = parseViews(viewsContent);\n    logger.info('views parsed', { count: views.length });\n\n    // 4. Generate files\n    const outDir = path.resolve(this.cwd, this.config.outDir);\n    mkdirSync(outDir, { recursive: true });\n\n    const preloadCode = generatePreload(operations);\n    writeFileSync(path.join(outDir, 'preload.generated.ts'), preloadCode);\n\n    const typesCode = generateTypes(operations);\n    writeFileSync(path.join(outDir, 'wood.d.ts'), typesCode);\n\n    const mockCode = generateTestMock(operations);\n    writeFileSync(path.join(outDir, 'wood.mock.ts'), mockCode);\n\n    const controllersDir = path.resolve(this.cwd, this.config.main.controllers);\n    const controllerRegCode = generateControllerRegistration(operations, {\n      controllersDir,\n      outDir,\n    });\n    writeFileSync(path.join(outDir, 'controllers.generated.ts'), controllerRegCode);\n\n    const runtimeCode = generateRuntime(operations, {\n      controllersDir,\n      outDir,\n    });\n    writeFileSync(path.join(outDir, 'runtime.generated.ts'), runtimeCode);\n\n    const rendererComponentDir = path.resolve(this.cwd, this.config.renderer.componentDir);\n    const rendererOutDir = path.resolve(this.cwd, this.config.renderer.componentDir, 'generated');\n    mkdirSync(rendererOutDir, { recursive: true });\n\n    writeFileSync(path.join(rendererOutDir, 'wood.d.ts'), typesCode);\n\n    writeFileSync(\n      path.join(rendererOutDir, 'app.ts'),\n      generateRendererApp(views, {\n        componentDir: rendererComponentDir,\n        outDir: rendererOutDir,\n        entryViewKey: this.config.renderer.entry,\n      }),\n    );\n\n    logger.info('codegen complete', { outDir });\n\n    // 5. Build backend with esbuild (initial build + create incremental context)\n    const backendEntry = this.config.main.entry;\n    const backendOutfile = path.join(this.config.outDir, 'backend', 'index.js');\n\n    this.esbuild = new EsbuildBackend({\n      entryPoint: backendEntry,\n      outfile: backendOutfile,\n      cwd: this.cwd,\n      external: this.config.build ? [] : undefined,\n    });\n\n    await this.esbuild.build();\n    await this.esbuild.createContext();\n\n    // 6. Start backend bridge (split-serve)\n    if (this.config.dev?.splitServe !== false) {\n      const resolvedBackendEntry = path.resolve(this.cwd, backendOutfile);\n      this.bridge = new BackendBridge({\n        backendEntry: resolvedBackendEntry,\n        onReady: () => {\n          logger.info('backend ready (split-serve)');\n        },\n        onPush: (channel, data) => {\n          logger.debug('backend push', { channel, data });\n        },\n        onExit: (code, signal) => {\n          logger.debug('backend exited', { code, signal });\n        },\n      });\n      await this.bridge.start();\n    }\n\n    // 7. Start watchers\n    if (this.config.dev?.watch !== false) {\n      this.startWatchers(outDir);\n    }\n  }\n\n  /** Stop the dev server and clean up all resources. */\n  async stop(): Promise<void> {\n    this.backendWatcher?.stop();\n    this.yamlWatcher?.stop();\n\n    if (this.bridge) {\n      await this.bridge.stop();\n      logger.info('backend bridge stopped');\n    }\n\n    if (this.esbuild) {\n      await this.esbuild.dispose();\n    }\n  }\n\n  /** Get the parsed config. */\n  getConfig(): WoodConfig | null {\n    return this.config;\n  }\n\n  private startWatchers(outDir: string): void {\n    if (!this.config) return;\n\n    // Backend watcher: server + middleware files -> rebuild + restart\n    if (this.bridge && this.esbuild) {\n      const backendPatterns = [\n        `${this.config.main.controllers}/**/*.ts`,\n        `${this.config.main.middleware}/**/*.ts`,\n        `${this.config.main.entry}`,\n        ...(this.config.main.watch ?? []),\n      ];\n\n      const esbuild = this.esbuild;\n      this.backendWatcher = new BackendWatcher({\n        patterns: backendPatterns,\n        bridge: this.bridge,\n        buildFn: () => esbuild.rebuild().then(() => {}),\n        cwd: this.cwd,\n      });\n      this.backendWatcher.start();\n      logger.info('backend watcher started', { patterns: backendPatterns });\n    }\n\n    // YAML watcher: operations + views YAML -> regenerate codegen\n    this.yamlWatcher = new YamlWatcher({\n      operationsYamlPath: this.config.main.openapi,\n      viewsYamlPath: this.config.renderer.openapi,\n      controllersDir: this.config.main.controllers,\n      outDir,\n      rendererOutDir: path.resolve(this.cwd, this.config.renderer.componentDir, 'generated'),\n      cwd: this.cwd,\n      onViewsChange: async () => {\n        // Re-parse views and regenerate client router manifest\n        const viewsContent = readFileSync(\n          path.resolve(this.cwd, this.config!.renderer.openapi),\n          'utf-8',\n        );\n        const views = parseViews(viewsContent);\n\n        const rendererComponentDir = path.resolve(this.cwd, this.config!.renderer.componentDir);\n        const rendererOutDir = path.resolve(this.cwd, this.config!.renderer.componentDir, 'generated');\n        mkdirSync(rendererOutDir, { recursive: true });\n\n        writeFileSync(\n          path.join(rendererOutDir, 'app.ts'),\n          generateRendererApp(views, {\n            componentDir: rendererComponentDir,\n            outDir: rendererOutDir,\n            entryViewKey: this.config!.renderer.entry,\n          }),\n        );\n\n        logger.info('views renderer codegen regenerated', { rendererOutDir });\n      },\n    });\n    this.yamlWatcher.start();\n    logger.info('yaml watcher started');\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/dev/yaml_watcher.cjs

@@ -95,14 +95,21 @@ class YamlWatcher {
           "utf-8"
         );
         const operations = (0, import_operations_parser.parseOperations)(opsContent);
+        const typesCode = (0, import_type_generator.generateTypes)(operations);
         (0, import_fs.writeFileSync)(
           import_path.default.join(this.options.outDir, "preload.generated.ts"),
           (0, import_preload_generator.generatePreload)(operations)
         );
         (0, import_fs.writeFileSync)(
           import_path.default.join(this.options.outDir, "wood.d.ts"),
-          (0, import_type_generator.generateTypes)(operations)
+          typesCode
         );
+        if (this.options.rendererOutDir) {
+          (0, import_fs.writeFileSync)(
+            import_path.default.join(this.options.rendererOutDir, "wood.d.ts"),
+            typesCode
+          );
+        }
         (0, import_fs.writeFileSync)(
           import_path.default.join(this.options.outDir, "wood.mock.ts"),
           (0, import_test_mock_generator.generateTestMock)(operations)

package/dist/dev/yaml_watcher.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/dev/yaml_watcher.ts"],"sourcesContent":["import { watch, type FSWatcher } from 'chokidar';\nimport { Subject, debounceTime, switchMap, from } from 'rxjs';\nimport { readFileSync, writeFileSync } from 'fs';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\nimport { parseOperations } from '../parser/operations_parser.cjs';\nimport { generatePreload } from '../codegen/preload_generator.cjs';\nimport { generateTypes } from '../codegen/type_generator.cjs';\nimport { generateTestMock } from '../codegen/test_mock_generator.cjs';\nimport { generateControllerRegistration } from '../codegen/controller_registration_generator.cjs';\nimport { generateRuntime } from '../codegen/runtime_generator.cjs';\n\nconst logger = getLogger('wood:dev:yaml-watcher');\n\nexport interface YamlWatcherOptions {\n  operationsYamlPath: string;\n  viewsYamlPath: string;\n  controllersDir: string;\n  outDir: string;\n  cwd: string;\n  /** Called after views YAML changes to regenerate the client router manifest. */\n  onViewsChange?: () => Promise<void>;\n}\n\nexport class YamlWatcher {\n  private watcher: FSWatcher | null = null;\n  private change$ = new Subject<string>();\n\n  constructor(private options: YamlWatcherOptions) {}\n\n  start(): void {\n    const patterns = [\n      this.options.operationsYamlPath,\n      this.options.viewsYamlPath,\n      path.dirname(this.options.operationsYamlPath) + '/**/*.yaml',\n      path.dirname(this.options.operationsYamlPath) + '/**/*.yml',\n      path.dirname(this.options.viewsYamlPath) + '/**/*.yaml',\n      path.dirname(this.options.viewsYamlPath) + '/**/*.yml',\n    ];\n\n    this.watcher = watch(patterns, {\n      cwd: this.options.cwd,\n      ignoreInitial: true,\n    });\n\n    this.watcher.on('change', (filePath: string) => {\n      logger.debug('yaml file changed', { filePath });\n      this.change$.next(filePath);\n    });\n\n    this.change$.pipe(\n      debounceTime(100),\n      switchMap((filePath) => from(this.regenerate(filePath))),\n    ).subscribe({\n      error: (err) => {\n        logger.error('yaml watcher pipeline error', { error: String(err) });\n      },\n    });\n  }\n\n  stop(): void {\n    this.watcher?.close();\n    this.change$.complete();\n  }\n\n  private isOperationsYaml(filePath: string): boolean {\n    const opsDir = path.dirname(this.options.operationsYamlPath);\n    return filePath.startsWith(opsDir) || filePath === this.options.operationsYamlPath;\n  }\n\n  private isViewsYaml(filePath: string): boolean {\n    const viewsDir = path.dirname(this.options.viewsYamlPath);\n    return filePath.startsWith(viewsDir) || filePath === this.options.viewsYamlPath;\n  }\n\n  private async regenerate(filePath: string): Promise<void> {\n    try {\n      if (this.isOperationsYaml(filePath)) {\n        // Operations change -> regenerate preload + types + mock\n        const opsContent = readFileSync(\n          path.resolve(this.options.cwd, this.options.operationsYamlPath),\n          'utf-8',\n        );\n        const operations = parseOperations(opsContent);\n\n        writeFileSync(\n          path.join(this.options.outDir, 'preload.generated.ts'),\n          generatePreload(operations),\n        );\n        writeFileSync(\n          path.join(this.options.outDir, 'wood.d.ts'),\n          generateTypes(operations),\n        );\n        writeFileSync(\n          path.join(this.options.outDir, 'wood.mock.ts'),\n          generateTestMock(operations),\n        );\n\n        const controllersDir = path.resolve(this.options.cwd, this.options.controllersDir);\n        writeFileSync(\n          path.join(this.options.outDir, 'controllers.generated.ts'),\n          generateControllerRegistration(operations, {\n            controllersDir,\n            outDir: this.options.outDir,\n          }),\n        );\n\n        writeFileSync(\n          path.join(this.options.outDir, 'runtime.generated.ts'),\n          generateRuntime(operations, {\n            controllersDir,\n            outDir: this.options.outDir,\n          }),\n        );\n\n        logger.info('operations codegen regenerated');\n      }\n\n      if (this.isViewsYaml(filePath)) {\n        // Views change -> regenerate client router manifest\n        if (this.options.onViewsChange) {\n          await this.options.onViewsChange();\n        }\n\n        logger.info('views manifest regenerated');\n      }\n    } catch (err) {\n      logger.error('yaml regeneration failed', { error: String(err) });\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAsC;AACtC,kBAAuD;AACvD,gBAA4C;AAC5C,kBAAiB;AACjB,oBAA0B;AAC1B,+BAAgC;AAChC,+BAAgC;AAChC,4BAA8B;AAC9B,iCAAiC;AACjC,+CAA+C;AAC/C,+BAAgC;AAEhC,MAAM,aAAS,yBAAU,uBAAuB;AAYzC,MAAM,YAAY;AAAA,EAIvB,YAAoB,SAA6B;AAA7B;AAHpB,SAAQ,UAA4B;AACpC,SAAQ,UAAU,IAAI,oBAAgB;AAAA,EAEY;AAAA,EAElD,QAAc;AACZ,UAAM,WAAW;AAAA,MACf,KAAK,QAAQ;AAAA,MACb,KAAK,QAAQ;AAAA,MACb,YAAAA,QAAK,QAAQ,KAAK,QAAQ,kBAAkB,IAAI;AAAA,MAChD,YAAAA,QAAK,QAAQ,KAAK,QAAQ,kBAAkB,IAAI;AAAA,MAChD,YAAAA,QAAK,QAAQ,KAAK,QAAQ,aAAa,IAAI;AAAA,MAC3C,YAAAA,QAAK,QAAQ,KAAK,QAAQ,aAAa,IAAI;AAAA,IAC7C;AAEA,SAAK,cAAU,uBAAM,UAAU;AAAA,MAC7B,KAAK,KAAK,QAAQ;AAAA,MAClB,eAAe;AAAA,IACjB,CAAC;AAED,SAAK,QAAQ,GAAG,UAAU,CAAC,aAAqB;AAC9C,aAAO,MAAM,qBAAqB,EAAE,SAAS,CAAC;AAC9C,WAAK,QAAQ,KAAK,QAAQ;AAAA,IAC5B,CAAC;AAED,SAAK,QAAQ;AAAA,UACX,0BAAa,GAAG;AAAA,UAChB,uBAAU,CAAC,iBAAa,kBAAK,KAAK,WAAW,QAAQ,CAAC,CAAC;AAAA,IACzD,EAAE,UAAU;AAAA,MACV,OAAO,CAAC,QAAQ;AACd,eAAO,MAAM,+BAA+B,EAAE,OAAO,OAAO,GAAG,EAAE,CAAC;AAAA,MACpE;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,OAAa;AACX,SAAK,SAAS,MAAM;AACpB,SAAK,QAAQ,SAAS;AAAA,EACxB;AAAA,EAEQ,iBAAiB,UAA2B;AAClD,UAAM,SAAS,YAAAA,QAAK,QAAQ,KAAK,QAAQ,kBAAkB;AAC3D,WAAO,SAAS,WAAW,MAAM,KAAK,aAAa,KAAK,QAAQ;AAAA,EAClE;AAAA,EAEQ,YAAY,UAA2B;AAC7C,UAAM,WAAW,YAAAA,QAAK,QAAQ,KAAK,QAAQ,aAAa;AACxD,WAAO,SAAS,WAAW,QAAQ,KAAK,aAAa,KAAK,QAAQ;AAAA,EACpE;AAAA,EAEA,MAAc,WAAW,UAAiC;AACxD,QAAI;AACF,UAAI,KAAK,iBAAiB,QAAQ,GAAG;AAEnC,cAAM,iBAAa;AAAA,UACjB,YAAAA,QAAK,QAAQ,KAAK,QAAQ,KAAK,KAAK,QAAQ,kBAAkB;AAAA,UAC9D;AAAA,QACF;AACA,cAAM,iBAAa,0CAAgB,UAAU;AAE7C;AAAA,UACE,YAAAA,QAAK,KAAK,KAAK,QAAQ,QAAQ,sBAAsB;AAAA,cACrD,0CAAgB,UAAU;AAAA,QAC5B;AACA;AAAA,UACE,YAAAA,QAAK,KAAK,KAAK,QAAQ,QAAQ,WAAW;AAAA,cAC1C,qCAAc,UAAU;AAAA,QAC1B;AACA;AAAA,UACE,YAAAA,QAAK,KAAK,KAAK,QAAQ,QAAQ,cAAc;AAAA,cAC7C,6CAAiB,UAAU;AAAA,QAC7B;AAEA,cAAM,iBAAiB,YAAAA,QAAK,QAAQ,KAAK,QAAQ,KAAK,KAAK,QAAQ,cAAc;AACjF;AAAA,UACE,YAAAA,QAAK,KAAK,KAAK,QAAQ,QAAQ,0BAA0B;AAAA,cACzD,yEAA+B,YAAY;AAAA,YACzC;AAAA,YACA,QAAQ,KAAK,QAAQ;AAAA,UACvB,CAAC;AAAA,QACH;AAEA;AAAA,UACE,YAAAA,QAAK,KAAK,KAAK,QAAQ,QAAQ,sBAAsB;AAAA,cACrD,0CAAgB,YAAY;AAAA,YAC1B;AAAA,YACA,QAAQ,KAAK,QAAQ;AAAA,UACvB,CAAC;AAAA,QACH;AAEA,eAAO,KAAK,gCAAgC;AAAA,MAC9C;AAEA,UAAI,KAAK,YAAY,QAAQ,GAAG;AAE9B,YAAI,KAAK,QAAQ,eAAe;AAC9B,gBAAM,KAAK,QAAQ,cAAc;AAAA,QACnC;AAEA,eAAO,KAAK,4BAA4B;AAAA,MAC1C;AAAA,IACF,SAAS,KAAK;AACZ,aAAO,MAAM,4BAA4B,EAAE,OAAO,OAAO,GAAG,EAAE,CAAC;AAAA,IACjE;AAAA,EACF;AACF;","names":["path"]}
+{"version":3,"sources":["../../src/dev/yaml_watcher.ts"],"sourcesContent":["import { watch, type FSWatcher } from 'chokidar';\nimport { Subject, debounceTime, switchMap, from } from 'rxjs';\nimport { readFileSync, writeFileSync } from 'fs';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\nimport { parseOperations } from '../parser/operations_parser.cjs';\nimport { generatePreload } from '../codegen/preload_generator.cjs';\nimport { generateTypes } from '../codegen/type_generator.cjs';\nimport { generateTestMock } from '../codegen/test_mock_generator.cjs';\nimport { generateControllerRegistration } from '../codegen/controller_registration_generator.cjs';\nimport { generateRuntime } from '../codegen/runtime_generator.cjs';\n\nconst logger = getLogger('wood:dev:yaml-watcher');\n\nexport interface YamlWatcherOptions {\n  operationsYamlPath: string;\n  viewsYamlPath: string;\n  controllersDir: string;\n  outDir: string;\n  rendererOutDir?: string;\n  cwd: string;\n  /** Called after views YAML changes to regenerate the client router manifest. */\n  onViewsChange?: () => Promise<void>;\n}\n\nexport class YamlWatcher {\n  private watcher: FSWatcher | null = null;\n  private change$ = new Subject<string>();\n\n  constructor(private options: YamlWatcherOptions) {}\n\n  start(): void {\n    const patterns = [\n      this.options.operationsYamlPath,\n      this.options.viewsYamlPath,\n      path.dirname(this.options.operationsYamlPath) + '/**/*.yaml',\n      path.dirname(this.options.operationsYamlPath) + '/**/*.yml',\n      path.dirname(this.options.viewsYamlPath) + '/**/*.yaml',\n      path.dirname(this.options.viewsYamlPath) + '/**/*.yml',\n    ];\n\n    this.watcher = watch(patterns, {\n      cwd: this.options.cwd,\n      ignoreInitial: true,\n    });\n\n    this.watcher.on('change', (filePath: string) => {\n      logger.debug('yaml file changed', { filePath });\n      this.change$.next(filePath);\n    });\n\n    this.change$.pipe(\n      debounceTime(100),\n      switchMap((filePath) => from(this.regenerate(filePath))),\n    ).subscribe({\n      error: (err) => {\n        logger.error('yaml watcher pipeline error', { error: String(err) });\n      },\n    });\n  }\n\n  stop(): void {\n    this.watcher?.close();\n    this.change$.complete();\n  }\n\n  private isOperationsYaml(filePath: string): boolean {\n    const opsDir = path.dirname(this.options.operationsYamlPath);\n    return filePath.startsWith(opsDir) || filePath === this.options.operationsYamlPath;\n  }\n\n  private isViewsYaml(filePath: string): boolean {\n    const viewsDir = path.dirname(this.options.viewsYamlPath);\n    return filePath.startsWith(viewsDir) || filePath === this.options.viewsYamlPath;\n  }\n\n  private async regenerate(filePath: string): Promise<void> {\n    try {\n      if (this.isOperationsYaml(filePath)) {\n        // Operations change -> regenerate preload + types + mock\n        const opsContent = readFileSync(\n          path.resolve(this.options.cwd, this.options.operationsYamlPath),\n          'utf-8',\n        );\n        const operations = parseOperations(opsContent);\n        const typesCode = generateTypes(operations);\n\n        writeFileSync(\n          path.join(this.options.outDir, 'preload.generated.ts'),\n          generatePreload(operations),\n        );\n        writeFileSync(\n          path.join(this.options.outDir, 'wood.d.ts'),\n          typesCode,\n        );\n        if (this.options.rendererOutDir) {\n          writeFileSync(\n            path.join(this.options.rendererOutDir, 'wood.d.ts'),\n            typesCode,\n          );\n        }\n        writeFileSync(\n          path.join(this.options.outDir, 'wood.mock.ts'),\n          generateTestMock(operations),\n        );\n\n        const controllersDir = path.resolve(this.options.cwd, this.options.controllersDir);\n        writeFileSync(\n          path.join(this.options.outDir, 'controllers.generated.ts'),\n          generateControllerRegistration(operations, {\n            controllersDir,\n            outDir: this.options.outDir,\n          }),\n        );\n\n        writeFileSync(\n          path.join(this.options.outDir, 'runtime.generated.ts'),\n          generateRuntime(operations, {\n            controllersDir,\n            outDir: this.options.outDir,\n          }),\n        );\n\n        logger.info('operations codegen regenerated');\n      }\n\n      if (this.isViewsYaml(filePath)) {\n        // Views change -> regenerate client router manifest\n        if (this.options.onViewsChange) {\n          await this.options.onViewsChange();\n        }\n\n        logger.info('views manifest regenerated');\n      }\n    } catch (err) {\n      logger.error('yaml regeneration failed', { error: String(err) });\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAsC;AACtC,kBAAuD;AACvD,gBAA4C;AAC5C,kBAAiB;AACjB,oBAA0B;AAC1B,+BAAgC;AAChC,+BAAgC;AAChC,4BAA8B;AAC9B,iCAAiC;AACjC,+CAA+C;AAC/C,+BAAgC;AAEhC,MAAM,aAAS,yBAAU,uBAAuB;AAazC,MAAM,YAAY;AAAA,EAIvB,YAAoB,SAA6B;AAA7B;AAHpB,SAAQ,UAA4B;AACpC,SAAQ,UAAU,IAAI,oBAAgB;AAAA,EAEY;AAAA,EAElD,QAAc;AACZ,UAAM,WAAW;AAAA,MACf,KAAK,QAAQ;AAAA,MACb,KAAK,QAAQ;AAAA,MACb,YAAAA,QAAK,QAAQ,KAAK,QAAQ,kBAAkB,IAAI;AAAA,MAChD,YAAAA,QAAK,QAAQ,KAAK,QAAQ,kBAAkB,IAAI;AAAA,MAChD,YAAAA,QAAK,QAAQ,KAAK,QAAQ,aAAa,IAAI;AAAA,MAC3C,YAAAA,QAAK,QAAQ,KAAK,QAAQ,aAAa,IAAI;AAAA,IAC7C;AAEA,SAAK,cAAU,uBAAM,UAAU;AAAA,MAC7B,KAAK,KAAK,QAAQ;AAAA,MAClB,eAAe;AAAA,IACjB,CAAC;AAED,SAAK,QAAQ,GAAG,UAAU,CAAC,aAAqB;AAC9C,aAAO,MAAM,qBAAqB,EAAE,SAAS,CAAC;AAC9C,WAAK,QAAQ,KAAK,QAAQ;AAAA,IAC5B,CAAC;AAED,SAAK,QAAQ;AAAA,UACX,0BAAa,GAAG;AAAA,UAChB,uBAAU,CAAC,iBAAa,kBAAK,KAAK,WAAW,QAAQ,CAAC,CAAC;AAAA,IACzD,EAAE,UAAU;AAAA,MACV,OAAO,CAAC,QAAQ;AACd,eAAO,MAAM,+BAA+B,EAAE,OAAO,OAAO,GAAG,EAAE,CAAC;AAAA,MACpE;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,OAAa;AACX,SAAK,SAAS,MAAM;AACpB,SAAK,QAAQ,SAAS;AAAA,EACxB;AAAA,EAEQ,iBAAiB,UAA2B;AAClD,UAAM,SAAS,YAAAA,QAAK,QAAQ,KAAK,QAAQ,kBAAkB;AAC3D,WAAO,SAAS,WAAW,MAAM,KAAK,aAAa,KAAK,QAAQ;AAAA,EAClE;AAAA,EAEQ,YAAY,UAA2B;AAC7C,UAAM,WAAW,YAAAA,QAAK,QAAQ,KAAK,QAAQ,aAAa;AACxD,WAAO,SAAS,WAAW,QAAQ,KAAK,aAAa,KAAK,QAAQ;AAAA,EACpE;AAAA,EAEA,MAAc,WAAW,UAAiC;AACxD,QAAI;AACF,UAAI,KAAK,iBAAiB,QAAQ,GAAG;AAEnC,cAAM,iBAAa;AAAA,UACjB,YAAAA,QAAK,QAAQ,KAAK,QAAQ,KAAK,KAAK,QAAQ,kBAAkB;AAAA,UAC9D;AAAA,QACF;AACA,cAAM,iBAAa,0CAAgB,UAAU;AAC7C,cAAM,gBAAY,qCAAc,UAAU;AAE1C;AAAA,UACE,YAAAA,QAAK,KAAK,KAAK,QAAQ,QAAQ,sBAAsB;AAAA,cACrD,0CAAgB,UAAU;AAAA,QAC5B;AACA;AAAA,UACE,YAAAA,QAAK,KAAK,KAAK,QAAQ,QAAQ,WAAW;AAAA,UAC1C;AAAA,QACF;AACA,YAAI,KAAK,QAAQ,gBAAgB;AAC/B;AAAA,YACE,YAAAA,QAAK,KAAK,KAAK,QAAQ,gBAAgB,WAAW;AAAA,YAClD;AAAA,UACF;AAAA,QACF;AACA;AAAA,UACE,YAAAA,QAAK,KAAK,KAAK,QAAQ,QAAQ,cAAc;AAAA,cAC7C,6CAAiB,UAAU;AAAA,QAC7B;AAEA,cAAM,iBAAiB,YAAAA,QAAK,QAAQ,KAAK,QAAQ,KAAK,KAAK,QAAQ,cAAc;AACjF;AAAA,UACE,YAAAA,QAAK,KAAK,KAAK,QAAQ,QAAQ,0BAA0B;AAAA,cACzD,yEAA+B,YAAY;AAAA,YACzC;AAAA,YACA,QAAQ,KAAK,QAAQ;AAAA,UACvB,CAAC;AAAA,QACH;AAEA;AAAA,UACE,YAAAA,QAAK,KAAK,KAAK,QAAQ,QAAQ,sBAAsB;AAAA,cACrD,0CAAgB,YAAY;AAAA,YAC1B;AAAA,YACA,QAAQ,KAAK,QAAQ;AAAA,UACvB,CAAC;AAAA,QACH;AAEA,eAAO,KAAK,gCAAgC;AAAA,MAC9C;AAEA,UAAI,KAAK,YAAY,QAAQ,GAAG;AAE9B,YAAI,KAAK,QAAQ,eAAe;AAC9B,gBAAM,KAAK,QAAQ,cAAc;AAAA,QACnC;AAEA,eAAO,KAAK,4BAA4B;AAAA,MAC1C;AAAA,IACF,SAAS,KAAK;AACZ,aAAO,MAAM,4BAA4B,EAAE,OAAO,OAAO,GAAG,EAAE,CAAC;AAAA,IACjE;AAAA,EACF;AACF;","names":["path"]}

package/dist/dev/yaml_watcher.d.cts

@@ -3,6 +3,7 @@ interface YamlWatcherOptions {
     viewsYamlPath: string;
     controllersDir: string;
     outDir: string;
+    rendererOutDir?: string;
     cwd: string;
     /** Called after views YAML changes to regenerate the client router manifest. */
     onViewsChange?: () => Promise<void>;

package/dist/dev/yaml_watcher.d.ts

@@ -3,6 +3,7 @@ interface YamlWatcherOptions {
     viewsYamlPath: string;
     controllersDir: string;
     outDir: string;
+    rendererOutDir?: string;
     cwd: string;
     /** Called after views YAML changes to regenerate the client router manifest. */
     onViewsChange?: () => Promise<void>;

package/dist/dev/yaml_watcher.js

@@ -62,14 +62,21 @@ class YamlWatcher {
           "utf-8"
         );
         const operations = parseOperations(opsContent);
+        const typesCode = generateTypes(operations);
         writeFileSync(
           path.join(this.options.outDir, "preload.generated.ts"),
           generatePreload(operations)
         );
         writeFileSync(
           path.join(this.options.outDir, "wood.d.ts"),
-          generateTypes(operations)
+          typesCode
         );
+        if (this.options.rendererOutDir) {
+          writeFileSync(
+            path.join(this.options.rendererOutDir, "wood.d.ts"),
+            typesCode
+          );
+        }
         writeFileSync(
           path.join(this.options.outDir, "wood.mock.ts"),
           generateTestMock(operations)

package/dist/dev/yaml_watcher.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/dev/yaml_watcher.ts"],"sourcesContent":["import { watch, type FSWatcher } from 'chokidar';\nimport { Subject, debounceTime, switchMap, from } from 'rxjs';\nimport { readFileSync, writeFileSync } from 'fs';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\nimport { parseOperations } from '../parser/operations_parser.js';\nimport { generatePreload } from '../codegen/preload_generator.js';\nimport { generateTypes } from '../codegen/type_generator.js';\nimport { generateTestMock } from '../codegen/test_mock_generator.js';\nimport { generateControllerRegistration } from '../codegen/controller_registration_generator.js';\nimport { generateRuntime } from '../codegen/runtime_generator.js';\n\nconst logger = getLogger('wood:dev:yaml-watcher');\n\nexport interface YamlWatcherOptions {\n  operationsYamlPath: string;\n  viewsYamlPath: string;\n  controllersDir: string;\n  outDir: string;\n  cwd: string;\n  /** Called after views YAML changes to regenerate the client router manifest. */\n  onViewsChange?: () => Promise<void>;\n}\n\nexport class YamlWatcher {\n  private watcher: FSWatcher | null = null;\n  private change$ = new Subject<string>();\n\n  constructor(private options: YamlWatcherOptions) {}\n\n  start(): void {\n    const patterns = [\n      this.options.operationsYamlPath,\n      this.options.viewsYamlPath,\n      path.dirname(this.options.operationsYamlPath) + '/**/*.yaml',\n      path.dirname(this.options.operationsYamlPath) + '/**/*.yml',\n      path.dirname(this.options.viewsYamlPath) + '/**/*.yaml',\n      path.dirname(this.options.viewsYamlPath) + '/**/*.yml',\n    ];\n\n    this.watcher = watch(patterns, {\n      cwd: this.options.cwd,\n      ignoreInitial: true,\n    });\n\n    this.watcher.on('change', (filePath: string) => {\n      logger.debug('yaml file changed', { filePath });\n      this.change$.next(filePath);\n    });\n\n    this.change$.pipe(\n      debounceTime(100),\n      switchMap((filePath) => from(this.regenerate(filePath))),\n    ).subscribe({\n      error: (err) => {\n        logger.error('yaml watcher pipeline error', { error: String(err) });\n      },\n    });\n  }\n\n  stop(): void {\n    this.watcher?.close();\n    this.change$.complete();\n  }\n\n  private isOperationsYaml(filePath: string): boolean {\n    const opsDir = path.dirname(this.options.operationsYamlPath);\n    return filePath.startsWith(opsDir) || filePath === this.options.operationsYamlPath;\n  }\n\n  private isViewsYaml(filePath: string): boolean {\n    const viewsDir = path.dirname(this.options.viewsYamlPath);\n    return filePath.startsWith(viewsDir) || filePath === this.options.viewsYamlPath;\n  }\n\n  private async regenerate(filePath: string): Promise<void> {\n    try {\n      if (this.isOperationsYaml(filePath)) {\n        // Operations change -> regenerate preload + types + mock\n        const opsContent = readFileSync(\n          path.resolve(this.options.cwd, this.options.operationsYamlPath),\n          'utf-8',\n        );\n        const operations = parseOperations(opsContent);\n\n        writeFileSync(\n          path.join(this.options.outDir, 'preload.generated.ts'),\n          generatePreload(operations),\n        );\n        writeFileSync(\n          path.join(this.options.outDir, 'wood.d.ts'),\n          generateTypes(operations),\n        );\n        writeFileSync(\n          path.join(this.options.outDir, 'wood.mock.ts'),\n          generateTestMock(operations),\n        );\n\n        const controllersDir = path.resolve(this.options.cwd, this.options.controllersDir);\n        writeFileSync(\n          path.join(this.options.outDir, 'controllers.generated.ts'),\n          generateControllerRegistration(operations, {\n            controllersDir,\n            outDir: this.options.outDir,\n          }),\n        );\n\n        writeFileSync(\n          path.join(this.options.outDir, 'runtime.generated.ts'),\n          generateRuntime(operations, {\n            controllersDir,\n            outDir: this.options.outDir,\n          }),\n        );\n\n        logger.info('operations codegen regenerated');\n      }\n\n      if (this.isViewsYaml(filePath)) {\n        // Views change -> regenerate client router manifest\n        if (this.options.onViewsChange) {\n          await this.options.onViewsChange();\n        }\n\n        logger.info('views manifest regenerated');\n      }\n    } catch (err) {\n      logger.error('yaml regeneration failed', { error: String(err) });\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/dev/yaml_watcher.ts"],"sourcesContent":["import { watch, type FSWatcher } from 'chokidar';\nimport { Subject, debounceTime, switchMap, from } from 'rxjs';\nimport { readFileSync, writeFileSync } from 'fs';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\nimport { parseOperations } from '../parser/operations_parser.js';\nimport { generatePreload } from '../codegen/preload_generator.js';\nimport { generateTypes } from '../codegen/type_generator.js';\nimport { generateTestMock } from '../codegen/test_mock_generator.js';\nimport { generateControllerRegistration } from '../codegen/controller_registration_generator.js';\nimport { generateRuntime } from '../codegen/runtime_generator.js';\n\nconst logger = getLogger('wood:dev:yaml-watcher');\n\nexport interface YamlWatcherOptions {\n  operationsYamlPath: string;\n  viewsYamlPath: string;\n  controllersDir: string;\n  outDir: string;\n  rendererOutDir?: string;\n  cwd: string;\n  /** Called after views YAML changes to regenerate the client router manifest. */\n  onViewsChange?: () => Promise<void>;\n}\n\nexport class YamlWatcher {\n  private watcher: FSWatcher | null = null;\n  private change$ = new Subject<string>();\n\n  constructor(private options: YamlWatcherOptions) {}\n\n  start(): void {\n    const patterns = [\n      this.options.operationsYamlPath,\n      this.options.viewsYamlPath,\n      path.dirname(this.options.operationsYamlPath) + '/**/*.yaml',\n      path.dirname(this.options.operationsYamlPath) + '/**/*.yml',\n      path.dirname(this.options.viewsYamlPath) + '/**/*.yaml',\n      path.dirname(this.options.viewsYamlPath) + '/**/*.yml',\n    ];\n\n    this.watcher = watch(patterns, {\n      cwd: this.options.cwd,\n      ignoreInitial: true,\n    });\n\n    this.watcher.on('change', (filePath: string) => {\n      logger.debug('yaml file changed', { filePath });\n      this.change$.next(filePath);\n    });\n\n    this.change$.pipe(\n      debounceTime(100),\n      switchMap((filePath) => from(this.regenerate(filePath))),\n    ).subscribe({\n      error: (err) => {\n        logger.error('yaml watcher pipeline error', { error: String(err) });\n      },\n    });\n  }\n\n  stop(): void {\n    this.watcher?.close();\n    this.change$.complete();\n  }\n\n  private isOperationsYaml(filePath: string): boolean {\n    const opsDir = path.dirname(this.options.operationsYamlPath);\n    return filePath.startsWith(opsDir) || filePath === this.options.operationsYamlPath;\n  }\n\n  private isViewsYaml(filePath: string): boolean {\n    const viewsDir = path.dirname(this.options.viewsYamlPath);\n    return filePath.startsWith(viewsDir) || filePath === this.options.viewsYamlPath;\n  }\n\n  private async regenerate(filePath: string): Promise<void> {\n    try {\n      if (this.isOperationsYaml(filePath)) {\n        // Operations change -> regenerate preload + types + mock\n        const opsContent = readFileSync(\n          path.resolve(this.options.cwd, this.options.operationsYamlPath),\n          'utf-8',\n        );\n        const operations = parseOperations(opsContent);\n        const typesCode = generateTypes(operations);\n\n        writeFileSync(\n          path.join(this.options.outDir, 'preload.generated.ts'),\n          generatePreload(operations),\n        );\n        writeFileSync(\n          path.join(this.options.outDir, 'wood.d.ts'),\n          typesCode,\n        );\n        if (this.options.rendererOutDir) {\n          writeFileSync(\n            path.join(this.options.rendererOutDir, 'wood.d.ts'),\n            typesCode,\n          );\n        }\n        writeFileSync(\n          path.join(this.options.outDir, 'wood.mock.ts'),\n          generateTestMock(operations),\n        );\n\n        const controllersDir = path.resolve(this.options.cwd, this.options.controllersDir);\n        writeFileSync(\n          path.join(this.options.outDir, 'controllers.generated.ts'),\n          generateControllerRegistration(operations, {\n            controllersDir,\n            outDir: this.options.outDir,\n          }),\n        );\n\n        writeFileSync(\n          path.join(this.options.outDir, 'runtime.generated.ts'),\n          generateRuntime(operations, {\n            controllersDir,\n            outDir: this.options.outDir,\n          }),\n        );\n\n        logger.info('operations codegen regenerated');\n      }\n\n      if (this.isViewsYaml(filePath)) {\n        // Views change -> regenerate client router manifest\n        if (this.options.onViewsChange) {\n          await this.options.onViewsChange();\n        }\n\n        logger.info('views manifest regenerated');\n      }\n    } catch (err) {\n      logger.error('yaml regeneration failed', { error: String(err) });\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

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