@noego/wood 0.0.4 → 0.1.1

package/dist/codegen/preload_generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/codegen/preload_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.js';\n\nfunction operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys((op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {}).length > 0,\n  );\n}\n\n/**\n * Build a nested object tree from dot-path operation channels.\n * \"chat.message.send\" -> { chat: { message: { send: ... } } }\n */\nfunction buildNestedTree(operations: Map<string, OperationDef>): Record<string, unknown> {\n  const tree: Record<string, unknown> = {};\n\n  for (const [channel, op] of operations) {\n    const parts = channel.split('.');\n    let current: Record<string, unknown> = tree;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      if (!current[parts[i]]) current[parts[i]] = {};\n      current = current[parts[i]] as Record<string, unknown>;\n    }\n\n    const leaf = parts[parts.length - 1];\n    current[leaf] = { __operation: op };\n  }\n\n  return tree;\n}\n\n/**\n * Generate TypeScript code for a nested tree node.\n */\nfunction generateTreeCode(node: Record<string, unknown>, indent: string = '  '): string {\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(node)) {\n    const entry = value as Record<string, unknown>;\n    if (entry.__operation) {\n      const op = entry.__operation as OperationDef;\n      const hasInput = operationHasInput(op);\n\n      if (hasInput) {\n        lines.push(`${indent}${key}: (data: unknown) =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}', data),`);\n      } else {\n        lines.push(`${indent}${key}: () =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}'),`);\n      }\n    } else {\n      lines.push(`${indent}${key}: {`);\n      lines.push(generateTreeCode(entry, indent + '  '));\n      lines.push(`${indent}},`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\nfunction generateRpcManifestCode(operations: Map<string, OperationDef>): string {\n  const entries = Array.from(operations.values())\n    .sort((a, b) => a.channel.localeCompare(b.channel))\n    .map((op) => {\n      const payload = {\n        channel: op.channel,\n        controller: op.controller,\n        action: op.action,\n        path: op.channel.split('.'),\n        hasInput: operationHasInput(op),\n      };\n      return `  ${JSON.stringify(payload)},`;\n    });\n\n  return `const __WOOD_RPC_MANIFEST = [\n${entries.join('\\n')}\n];`;\n}\n\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\n/**\n * Generate a complete preload.ts file from operations.\n */\nexport function generatePreload(operations: Map<string, OperationDef>): string {\n  const tree = buildNestedTree(operations);\n  const operationsCode = generateTreeCode(tree);\n  const rpcManifestCode = generateRpcManifestCode(operations);\n\n  return `// AUTO-GENERATED by @noego/wood -- do not edit\nimport { contextBridge, ipcRenderer } from 'electron';\n\n${rpcManifestCode}\n\nconst __WOOD_INTERNAL_BRIDGE_KEY = '${INTERNAL_BRIDGE_GLOBAL_KEY}';\n\ncontextBridge.exposeInMainWorld(__WOOD_INTERNAL_BRIDGE_KEY, {\n${operationsCode}\n\n  // Internal: backend controller/action RPC map for @Inject(App)\n  __rpcManifest: __WOOD_RPC_MANIFEST,\n\n  // Internal: loader data requests\n  __load: (route: string, params: Record<string, string>) =>\n    ipcRenderer.invoke('__load', { route, params }),\n\n  // Internal: cross-window navigation\n  __navigate: (windowId: string, route: string) =>\n    ipcRenderer.invoke('__navigate', { windowId, route }),\n\n  // Internal: window management\n  __window: {\n    current: () =>\n      ipcRenderer.invoke('__window', { action: 'current' }),\n    open: (windowId: string, options?: Record<string, unknown>) =>\n      ipcRenderer.invoke('__window', { action: 'open', windowId, options }),\n    close: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'close', windowId }),\n    focus: (windowId: string) =>\n      ipcRenderer.invoke('__window', { action: 'focus', windowId }),\n    minimize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'minimize', windowId }),\n    maximize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'maximize', windowId }),\n  },\n\n  // Internal: framework config (trace min level, etc)\n  __woodConfig: () =>\n    ipcRenderer.invoke('__woodConfig'),\n\n  // Internal: debug metadata\n  __debug: {\n    current: () =>\n      ipcRenderer.invoke('__debug', { action: 'current' }),\n  },\n\n  // Internal: context menu\n  __contextMenu: {\n    show: (data: unknown) =>\n      ipcRenderer.invoke('__contextMenu', { action: 'show', ...data as Record<string, unknown> }),\n  },\n\n  // Push events from main process\n  on: (channel: string, callback: (...args: unknown[]) => void) => {\n    const subscription = (_event: unknown, ...args: unknown[]) => callback(...args);\n    ipcRenderer.on(\\`__event:\\${channel}\\`, subscription);\n    return () => ipcRenderer.removeListener(\\`__event:\\${channel}\\`, subscription);\n  },\n  __trace: (event: unknown) => {\n    ipcRenderer.send('__trace', event);\n  },\n  __log: (level: string, logger: string, message: string, context?: unknown) => {\n    ipcRenderer.send('__log', { level, logger, message, context });\n  },\n});\n`;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/codegen/preload_generator.ts"],"sourcesContent":["import type { OperationDef } from '../types/index.js';\n\nfunction operationHasInput(op: OperationDef): boolean {\n  return Boolean(\n    op.inputSchema &&\n      (op.inputSchema as Record<string, unknown>).type === 'object' &&\n      Object.keys((op.inputSchema as Record<string, Record<string, unknown>>).properties ?? {}).length > 0,\n  );\n}\n\n/**\n * Build a nested object tree from dot-path operation channels.\n * \"chat.message.send\" -> { chat: { message: { send: ... } } }\n */\nfunction buildNestedTree(operations: Map<string, OperationDef>): Record<string, unknown> {\n  const tree: Record<string, unknown> = {};\n\n  for (const [channel, op] of operations) {\n    const parts = channel.split('.');\n    let current: Record<string, unknown> = tree;\n\n    for (let i = 0; i < parts.length - 1; i++) {\n      if (!current[parts[i]]) current[parts[i]] = {};\n      current = current[parts[i]] as Record<string, unknown>;\n    }\n\n    const leaf = parts[parts.length - 1];\n    current[leaf] = { __operation: op };\n  }\n\n  return tree;\n}\n\n/**\n * Generate TypeScript code for a nested tree node.\n */\nfunction generateTreeCode(node: Record<string, unknown>, indent: string = '  '): string {\n  const lines: string[] = [];\n\n  for (const [key, value] of Object.entries(node)) {\n    const entry = value as Record<string, unknown>;\n    if (entry.__operation) {\n      const op = entry.__operation as OperationDef;\n      const hasInput = operationHasInput(op);\n\n      if (hasInput) {\n        lines.push(`${indent}${key}: (data: unknown) =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}', data),`);\n      } else {\n        lines.push(`${indent}${key}: () =>`);\n        lines.push(`${indent}  ipcRenderer.invoke('${op.channel}'),`);\n      }\n    } else {\n      lines.push(`${indent}${key}: {`);\n      lines.push(generateTreeCode(entry, indent + '  '));\n      lines.push(`${indent}},`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\nfunction generateRpcManifestCode(operations: Map<string, OperationDef>): string {\n  const entries = Array.from(operations.values())\n    .sort((a, b) => a.channel.localeCompare(b.channel))\n    .map((op) => {\n      const payload = {\n        channel: op.channel,\n        controller: op.controller,\n        action: op.action,\n        path: op.channel.split('.'),\n        hasInput: operationHasInput(op),\n      };\n      return `  ${JSON.stringify(payload)},`;\n    });\n\n  return `const __WOOD_RPC_MANIFEST = [\n${entries.join('\\n')}\n];`;\n}\n\nconst INTERNAL_BRIDGE_GLOBAL_KEY = '__NOEGO_WOOD_BRIDGE__';\n\n/**\n * Generate a complete preload.ts file from operations.\n */\nexport function generatePreload(operations: Map<string, OperationDef>): string {\n  const tree = buildNestedTree(operations);\n  const operationsCode = generateTreeCode(tree);\n  const rpcManifestCode = generateRpcManifestCode(operations);\n\n  return `// AUTO-GENERATED by @noego/wood -- do not edit\nimport { contextBridge, ipcRenderer } from 'electron';\n\n${rpcManifestCode}\n\nconst __WOOD_INTERNAL_BRIDGE_KEY = '${INTERNAL_BRIDGE_GLOBAL_KEY}';\n\ncontextBridge.exposeInMainWorld(__WOOD_INTERNAL_BRIDGE_KEY, {\n${operationsCode}\n\n  // Internal: backend controller/action RPC map for @Inject(App)\n  __rpcManifest: __WOOD_RPC_MANIFEST,\n\n  // Internal: loader data requests\n  __load: (route: string, params: Record<string, string>) =>\n    ipcRenderer.invoke('__load', { route, params }),\n\n  // Internal: cross-window navigation\n  __navigate: (windowId: string, route: string) =>\n    ipcRenderer.invoke('__navigate', { windowId, route }),\n\n  // Internal: window management\n  __window: {\n    current: () =>\n      ipcRenderer.invoke('__window', { action: 'current' }),\n    open: (windowId: string, options?: Record<string, unknown>) =>\n      ipcRenderer.invoke('__window', { action: 'open', windowId, options }),\n    close: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'close', windowId }),\n    focus: (windowId: string) =>\n      ipcRenderer.invoke('__window', { action: 'focus', windowId }),\n    minimize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'minimize', windowId }),\n    maximize: (windowId?: string) =>\n      ipcRenderer.invoke('__window', { action: 'maximize', windowId }),\n  },\n\n  // Internal: framework config (trace min level, etc)\n  __woodConfig: () =>\n    ipcRenderer.invoke('__woodConfig'),\n\n  // Internal: debug metadata\n  __debug: {\n    current: () =>\n      ipcRenderer.invoke('__debug', { action: 'current' }),\n  },\n\n  // Internal: context menu\n  __contextMenu: {\n    show: (data: unknown) =>\n      ipcRenderer.invoke('__contextMenu', { action: 'show', ...data as Record<string, unknown> }),\n  },\n\n  // Push events from main process\n  on: (channel: string, callback: (...args: unknown[]) => void) => {\n    const subscription = (_event: unknown, ...args: unknown[]) => callback(...args);\n    ipcRenderer.on(\\`__event:\\${channel}\\`, subscription);\n    return () => ipcRenderer.removeListener(\\`__event:\\${channel}\\`, subscription);\n  },\n  __trace: (event: unknown) => {\n    ipcRenderer.send('__trace', event);\n  },\n  __log: (level: string, logger: string, message: string, context?: unknown) => {\n    ipcRenderer.send('__log', { level, logger, message, context });\n  },\n});\n\n// Trace transport via MessagePort (activated when main process sends a port)\nlet __tracePort: MessagePort | null = null;\nconst __traceBuffer: unknown[] = [];\n\nfunction __traceFlush(): void {\n  while (__traceBuffer.length > 0 && __tracePort) {\n    __tracePort.postMessage(__traceBuffer.shift());\n  }\n}\n\nipcRenderer.on('__trace-port', (event) => {\n  __tracePort = event.ports[0];\n  __tracePort.start();\n  __traceFlush();\n});\n\ncontextBridge.exposeInMainWorld('__NOEGO_TRACE__', {\n  send: (data: unknown) => {\n    if (__tracePort) {\n      __tracePort.postMessage(data);\n    } else {\n      __traceBuffer.push(data);\n    }\n  },\n});\n`;\n}\n"],"mappings":"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","names":[]}

package/dist/controller/controller_lifecycle.cjs

@@ -0,0 +1,41 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var controller_lifecycle_exports = {};
+__export(controller_lifecycle_exports, {
+  disposeControllerLifecycle: () => disposeControllerLifecycle
+});
+module.exports = __toCommonJS(controller_lifecycle_exports);
+async function disposeControllerLifecycle(target) {
+  if (!target || typeof target !== "object" && typeof target !== "function") {
+    return;
+  }
+  const lifecycle = target;
+  if (typeof lifecycle.dispose === "function") {
+    await lifecycle.dispose();
+    return;
+  }
+  if (typeof lifecycle.destroy === "function") {
+    await lifecycle.destroy();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  disposeControllerLifecycle
+});
+//# sourceMappingURL=controller_lifecycle.cjs.map

package/dist/controller/controller_lifecycle.cjs.map

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

package/dist/controller/controller_lifecycle.d.cts

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

package/dist/controller/controller_lifecycle.d.ts

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

package/dist/controller/controller_lifecycle.js

@@ -0,0 +1,17 @@
+async function disposeControllerLifecycle(target) {
+  if (!target || typeof target !== "object" && typeof target !== "function") {
+    return;
+  }
+  const lifecycle = target;
+  if (typeof lifecycle.dispose === "function") {
+    await lifecycle.dispose();
+    return;
+  }
+  if (typeof lifecycle.destroy === "function") {
+    await lifecycle.destroy();
+  }
+}
+export {
+  disposeControllerLifecycle
+};
+//# sourceMappingURL=controller_lifecycle.js.map

package/dist/controller/controller_lifecycle.js.map

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

package/dist/controller/index.cjs

@@ -19,13 +19,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var controller_exports = {};
 __export(controller_exports, {
   ControllerResolver: () => import_controller_resolver.ControllerResolver,
-  buildControllerArgs: () => import_controller_resolver.buildControllerArgs
+  buildControllerArgs: () => import_controller_resolver.buildControllerArgs,
+  disposeControllerLifecycle: () => import_controller_lifecycle.disposeControllerLifecycle
 });
 module.exports = __toCommonJS(controller_exports);
 var import_controller_resolver = require("./controller_resolver.cjs");
+var import_controller_lifecycle = require("./controller_lifecycle.cjs");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ControllerResolver,
-  buildControllerArgs
+  buildControllerArgs,
+  disposeControllerLifecycle
 });
 //# sourceMappingURL=index.cjs.map

package/dist/controller/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controller/index.ts"],"sourcesContent":["export { ControllerResolver, buildControllerArgs } from './controller_resolver.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iCAAwD;","names":[]}
+{"version":3,"sources":["../../src/controller/index.ts"],"sourcesContent":["export { ControllerResolver, buildControllerArgs } from './controller_resolver.cjs';\nexport type { ControllerLifecycle } from './controller_lifecycle.cjs';\nexport { disposeControllerLifecycle } from './controller_lifecycle.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iCAAwD;AAExD,kCAA2C;","names":[]}

package/dist/controller/index.d.cts

@@ -1,2 +1,3 @@
 export { ControllerResolver, buildControllerArgs } from './controller_resolver.cjs';
+export { ControllerLifecycle, disposeControllerLifecycle } from './controller_lifecycle.cjs';
 import '../types/context.cjs';

package/dist/controller/index.d.ts

@@ -1,2 +1,3 @@
 export { ControllerResolver, buildControllerArgs } from './controller_resolver.js';
+export { ControllerLifecycle, disposeControllerLifecycle } from './controller_lifecycle.js';
 import '../types/context.js';

package/dist/controller/index.js

@@ -1,6 +1,8 @@
 import { ControllerResolver, buildControllerArgs } from "./controller_resolver.js";
+import { disposeControllerLifecycle } from "./controller_lifecycle.js";
 export {
   ControllerResolver,
-  buildControllerArgs
+  buildControllerArgs,
+  disposeControllerLifecycle
 };
 //# sourceMappingURL=index.js.map

package/dist/controller/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controller/index.ts"],"sourcesContent":["export { ControllerResolver, buildControllerArgs } from './controller_resolver.js';\n"],"mappings":"AAAA,SAAS,oBAAoB,2BAA2B;","names":[]}
+{"version":3,"sources":["../../src/controller/index.ts"],"sourcesContent":["export { ControllerResolver, buildControllerArgs } from './controller_resolver.js';\nexport type { ControllerLifecycle } from './controller_lifecycle.js';\nexport { disposeControllerLifecycle } from './controller_lifecycle.js';\n"],"mappings":"AAAA,SAAS,oBAAoB,2BAA2B;AAExD,SAAS,kCAAkC;","names":[]}

package/dist/index.cjs

@@ -50,6 +50,7 @@ __export(index_exports, {
   clearContainerRegistryForTests: () => import_runtime.clearContainerRegistryForTests,
   clearTraceHubForTests: () => import_tracing.clearTraceHubForTests,
   createTraceCapture: () => import_tracing.createTraceCapture,
+  disposeControllerLifecycle: () => import_controller.disposeControllerLifecycle,
   executeMiddleware: () => import_middleware.executeMiddleware,
   generateControllerRegistration: () => import_codegen4.generateControllerRegistration,
   generatePreload: () => import_codegen.generatePreload,
@@ -80,6 +81,8 @@ __export(index_exports, {
   resolveWoodRemoteDebuggingPort: () => import_dev.resolveWoodRemoteDebuggingPort,
   runtime: () => import_runtime.runtime,
   setApplicationRoot: () => import_runtime.setApplicationRoot,
+  setRendererTraceEnabled: () => import_tracing.setRendererTraceEnabled,
+  setRendererTraceTransport: () => import_tracing.setRendererTraceTransport,
   startBackendLoop: () => import_bridge.startBackendLoop,
   writeWoodDevMetadata: () => import_dev.writeWoodDevMetadata
 });
@@ -142,6 +145,7 @@ var import_tracing = require("./tracing/index.js");
   clearContainerRegistryForTests,
   clearTraceHubForTests,
   createTraceCapture,
+  disposeControllerLifecycle,
   executeMiddleware,
   generateControllerRegistration,
   generatePreload,
@@ -172,6 +176,8 @@ var import_tracing = require("./tracing/index.js");
   resolveWoodRemoteDebuggingPort,
   runtime,
   setApplicationRoot,
+  setRendererTraceEnabled,
+  setRendererTraceTransport,
   startBackendLoop,
   writeWoodDevMetadata
 });

package/dist/index.cjs.map

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

package/dist/index.d.cts

@@ -12,6 +12,7 @@ export { SchemaValidator } from './validation/schema_validator.cjs';
 export { MiddlewareResolver } from './middleware/middleware_resolver.cjs';
 export { buildMiddlewareContext, executeMiddleware } from './middleware/middleware_pipeline.cjs';
 export { ControllerResolver, buildControllerArgs } from './controller/controller_resolver.cjs';
+export { ControllerLifecycle, disposeControllerLifecycle } from './controller/controller_lifecycle.cjs';
 export { generatePreload } from './codegen/preload_generator.cjs';
 export { generateTypes } from './codegen/type_generator.cjs';
 export { generateTestMock } from './codegen/test_mock_generator.cjs';
@@ -32,7 +33,7 @@ export { YamlWatcher } from './dev/yaml_watcher.cjs';
 export { GetContainerOptions, clearContainerRegistryForTests, getContainer } from './runtime/get_container.cjs';
 export { clearApplicationRootForTests, getApplicationRoot, setApplicationRoot } from './runtime/application_root.cjs';
 export { RegisterRuntimeRouter, RuntimeOptions, RuntimeResult, runtime } from './runtime/runtime.cjs';
-export { TraceCapture, TraceCaptureOptions, TraceDispatchResult, TraceEvent, TraceInput, TraceLevel, TraceProcess, TraceWaitOptions, clearTraceHubForTests, createTraceCapture, getTraceEvents$ } from './tracing/trace_hub.cjs';
+export { TraceCapture, TraceCaptureOptions, TraceDispatchResult, TraceEvent, TraceInput, TraceLevel, TraceProcess, TraceWaitOptions, clearTraceHubForTests, createTraceCapture, getTraceEvents$, setRendererTraceEnabled, setRendererTraceTransport } from './tracing/trace_hub.cjs';
 export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './tracing/trace_provider.cjs';
 export { Navigation, NavigationEntry, getNavigation, go, goback, goto } from './navigation/index.cjs';
 export { Ipc, getIpc } from './ipc/index.cjs';

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export { SchemaValidator } from './validation/schema_validator.js';
 export { MiddlewareResolver } from './middleware/middleware_resolver.js';
 export { buildMiddlewareContext, executeMiddleware } from './middleware/middleware_pipeline.js';
 export { ControllerResolver, buildControllerArgs } from './controller/controller_resolver.js';
+export { ControllerLifecycle, disposeControllerLifecycle } from './controller/controller_lifecycle.js';
 export { generatePreload } from './codegen/preload_generator.js';
 export { generateTypes } from './codegen/type_generator.js';
 export { generateTestMock } from './codegen/test_mock_generator.js';
@@ -32,7 +33,7 @@ export { YamlWatcher } from './dev/yaml_watcher.js';
 export { GetContainerOptions, clearContainerRegistryForTests, getContainer } from './runtime/get_container.js';
 export { clearApplicationRootForTests, getApplicationRoot, setApplicationRoot } from './runtime/application_root.js';
 export { RegisterRuntimeRouter, RuntimeOptions, RuntimeResult, runtime } from './runtime/runtime.js';
-export { TraceCapture, TraceCaptureOptions, TraceDispatchResult, TraceEvent, TraceInput, TraceLevel, TraceProcess, TraceWaitOptions, clearTraceHubForTests, createTraceCapture, getTraceEvents$ } from './tracing/trace_hub.js';
+export { TraceCapture, TraceCaptureOptions, TraceDispatchResult, TraceEvent, TraceInput, TraceLevel, TraceProcess, TraceWaitOptions, clearTraceHubForTests, createTraceCapture, getTraceEvents$, setRendererTraceEnabled, setRendererTraceTransport } from './tracing/trace_hub.js';
 export { FrameworkTracer, MainTracer, RendererTracer, TestTracer, TraceProvider, TraceProviderConfiguration, TraceProviderMode, TraceRuntime } from './tracing/trace_provider.js';
 export { Navigation, NavigationEntry, getNavigation, go, goback, goto } from './navigation/index.js';
 export { Ipc, getIpc } from './ipc/index.js';

package/dist/index.js

@@ -5,7 +5,7 @@ import { parseViews, parseViewsFile } from "./parser/index.js";
 import { WoodRouter } from "./router/index.js";
 import { SchemaValidator } from "./validation/index.js";
 import { MiddlewareResolver, buildMiddlewareContext, executeMiddleware } from "./middleware/index.js";
-import { ControllerResolver, buildControllerArgs } from "./controller/index.js";
+import { ControllerResolver, buildControllerArgs, disposeControllerLifecycle } from "./controller/index.js";
 import { generatePreload } from "./codegen/index.js";
 import { generateTypes } from "./codegen/index.js";
 import { generateTestMock } from "./codegen/index.js";
@@ -51,7 +51,9 @@ import {
   TraceCapture,
   clearTraceHubForTests,
   createTraceCapture,
-  getTraceEvents$
+  getTraceEvents$,
+  setRendererTraceEnabled,
+  setRendererTraceTransport
 } from "./tracing/index.js";
 export {
   BackendBridge,
@@ -86,6 +88,7 @@ export {
   clearContainerRegistryForTests,
   clearTraceHubForTests,
   createTraceCapture,
+  disposeControllerLifecycle,
   executeMiddleware,
   generateControllerRegistration,
   generatePreload,
@@ -116,6 +119,8 @@ export {
   resolveWoodRemoteDebuggingPort,
   runtime,
   setApplicationRoot,
+  setRendererTraceEnabled,
+  setRendererTraceTransport,
   startBackendLoop,
   writeWoodDevMetadata
 };

package/dist/index.js.map

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

package/dist/main/index.cjs

@@ -38,6 +38,7 @@ var import_logger = require("@noego/logger");
 var import_window_state_store = require("../window/window_state_store.js");
 var import_get_container = require("../runtime/get_container.js");
 var import_runtime = require("../runtime/runtime.js");
+var import_tracing = require("../tracing/index.js");
 var import_application_root = require("../runtime/application_root.js");
 var import_renderer_log_dispatcher = require("../runtime/renderer_log_dispatcher.js");
 var import_ipc = require("../ipc/index.js");
@@ -83,6 +84,8 @@ function startWoodMain(options) {
   const windowState = new import_window_state_store.WindowStateStore();
   const windows = /* @__PURE__ */ new Map();
   let mainWindow = null;
+  let beforeQuitCleanupComplete = false;
+  let beforeQuitCleanupPromise = null;
   let runtimeContext = null;
   let mainBootCleanup;
   for (const stream of [process.stdout, process.stderr]) {
@@ -302,11 +305,32 @@ function startWoodMain(options) {
       } else {
         void win.loadFile(rendererFile);
       }
+      if (options.traceTransport === "messageport" && options.rendererTraceEnabled === true) {
+        const { port1, port2 } = new import_electron.MessageChannelMain();
+        const portHandler = (event) => {
+          (0, import_tracing.dispatchRendererTracePayload)(event.data);
+        };
+        port1.on("message", portHandler);
+        port1.start();
+        win.webContents.once("did-finish-load", () => {
+          if (!win.isDestroyed()) {
+            win.webContents.postMessage("__trace-port", null, [port2]);
+            logger.info("trace messageport sent to renderer", { windowId });
+          }
+        });
+        win.on("closed", () => {
+          port1.off("message", portHandler);
+          port1.close();
+        });
+      }
       win.on("closed", () => {
         windows.delete(windowId);
         if (windowId === "main") {
           mainWindow = null;
         }
+        if (windows.size === 0) {
+          import_electron.app.quit();
+        }
       });
       logger.info("window created", { windowId });
       return win;
@@ -377,6 +401,9 @@ function startWoodMain(options) {
         controllersDir: resolveRuntimePath(options.controllersDir),
         middlewareDir: resolveRuntimePath(options.middlewareDir),
         ...options.traceMinLevel ? { traceMinLevel: options.traceMinLevel } : {},
+        ...typeof options.rendererTraceEnabled === "boolean" ? { rendererTraceEnabled: options.rendererTraceEnabled } : {},
+        ...options.rendererTraceMinLevel ? { rendererTraceMinLevel: options.rendererTraceMinLevel } : {},
+        ...options.traceTransport === "messageport" ? { enableRendererTraceBridge: false } : {},
         onLoad: options.onLoad ?? (async () => {
           throw new Error('Reserved channel "__load" is not configured for this app.');
         }),
@@ -461,30 +488,48 @@ function startWoodMain(options) {
         stack: error instanceof Error ? error.stack : void 0
       });
     });
-    import_electron.app.on("before-quit", () => {
+    const destroyWindowsForQuit = () => {
+      for (const [id, win] of windows) {
+        if (!win.isDestroyed()) {
+          win.destroy();
+          logger.debug("destroyed window on quit", { windowId: id });
+        }
+      }
+      windows.clear();
+    };
+    const runBeforeQuitCleanup = async () => {
+      (0, import_shared.clearIpcPushSender)();
+      if (mainBootCleanup) {
+        await mainBootCleanup();
+      }
+      if (options.onBeforeQuit) {
+        await options.onBeforeQuit(runtimeContext);
+      }
+    };
+    import_electron.app.on("before-quit", (event) => {
       if (!runtimeContext) {
         return;
       }
-      void (async () => {
+      if (beforeQuitCleanupComplete) {
+        destroyWindowsForQuit();
+        return;
+      }
+      event.preventDefault();
+      if (beforeQuitCleanupPromise) {
+        return;
+      }
+      beforeQuitCleanupPromise = (async () => {
         try {
-          (0, import_shared.clearIpcPushSender)();
-          if (mainBootCleanup) {
-            await mainBootCleanup();
-          }
-          if (options.onBeforeQuit) {
-            await options.onBeforeQuit(runtimeContext);
-          }
+          await runBeforeQuitCleanup();
         } catch (error) {
           logger.warn("before-quit handler failed", { error: toErrorMessage(error) });
+        } finally {
+          beforeQuitCleanupComplete = true;
+          beforeQuitCleanupPromise = null;
         }
+        destroyWindowsForQuit();
+        import_electron.app.quit();
       })();
-      for (const [id, win] of windows) {
-        if (!win.isDestroyed()) {
-          win.destroy();
-          logger.debug("destroyed window on quit", { windowId: id });
-        }
-      }
-      windows.clear();
     });
     import_electron.app.on("window-all-closed", () => {
       import_electron.app.quit();