@noego/wood 0.4.9 → 0.5.0

package/dist/config/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/config/index.ts"],"sourcesContent":["export { parseConfig } from './config_parser.js';\n"],"mappings":"AAAA,SAAS,mBAAmB;","names":[]}
+{"version":3,"sources":["../../src/config/index.ts"],"sourcesContent":["export {\n  parseConfig,\n  resolveRendererTraceBatching,\n  RENDERER_TRACE_BATCHING_DEFAULTS,\n} from './config_parser.js';\nexport type {\n  ObservabilityConfig,\n  RendererTraceBatchingConfig,\n} from '../types/config.js';\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/controller/controller_resolver.cjs

@@ -29,7 +29,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var controller_resolver_exports = {};
 __export(controller_resolver_exports, {
   ControllerResolver: () => ControllerResolver,
-  buildControllerArgs: () => buildControllerArgs
+  buildControllerArgs: () => buildControllerArgs,
+  buildOperationContext: () => buildOperationContext,
+  usesOperationContext: () => usesOperationContext
 });
 module.exports = __toCommonJS(controller_resolver_exports);
 var import_path = __toESM(require("path"), 1);
@@ -43,6 +45,8 @@ class ControllerResolver {
   constructor(controllersDir, options) {
     this.classCache = /* @__PURE__ */ new Map();
     this.pathCache = /* @__PURE__ */ new Map();
+    // name -> import path
+    this.loaderCache = /* @__PURE__ */ new Map();
     this.baseDir = controllersDir;
     this.mode = options?.mode ?? (process.env.WOOD_MODE === "development" ? "dev" : "bundled");
   }
@@ -50,7 +54,20 @@ class ControllerResolver {
    * Check whether a controller name has been pre-registered (class or path).
    */
   has(name) {
-    return this.classCache.has(name) || this.pathCache.has(name);
+    return this.classCache.has(name) || this.pathCache.has(name) || this.loaderCache.has(name);
+  }
+  /**
+   * Register a lazy module loader for a controller. The loader is the
+   * CALLER's `() => import('...literal specifier...')`, so the import runs in
+   * the caller's module resolution (bundler/test-runner identity) instead of
+   * a raw filesystem import — same class identity as every other import of
+   * that module. Invoked only on first resolution.
+   */
+  registerLoader(name, loader) {
+    if (typeof loader !== "function") {
+      throw new Error(`registerLoader("${name}"): expected a () => Promise<module> function`);
+    }
+    this.loaderCache.set(name, loader);
   }
   /**
    * Register an import path for a controller. The controller will be lazily
@@ -75,6 +92,19 @@ class ControllerResolver {
   async resolveClass(controllerName) {
     const cached = this.classCache.get(controllerName);
     if (cached) return cached;
+    const loader = this.loaderCache.get(controllerName);
+    if (loader) {
+      const mod = await loader();
+      const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];
+      if (!ControllerClass || typeof ControllerClass !== "function") {
+        throw new Error(
+          `Controller "${controllerName}": registered loader's module does not export a class`
+        );
+      }
+      this.classCache.set(controllerName, ControllerClass);
+      logger.debug(`Resolved controller "${controllerName}" from registered loader`);
+      return ControllerClass;
+    }
     const importPath = this.pathCache.get(controllerName);
     if (importPath) {
       const mod = await import(toImportSpecifier(importPath));
@@ -154,6 +184,22 @@ Registered controllers: [${Array.from(this.pathCache.keys()).join(", ")}]`
     this.classCache.clear();
   }
 }
+function usesOperationContext(ControllerClass) {
+  return ControllerClass?.woodContext === "operation";
+}
+function buildOperationContext(operation, ipcContext) {
+  const state = ipcContext.context ?? {};
+  return {
+    operation,
+    input: ipcContext.body,
+    state,
+    sender: ipcContext.sender,
+    windowId: ipcContext.windowId,
+    get(key) {
+      return state[key];
+    }
+  };
+}
 function buildControllerArgs(ipcContext, container) {
   return {
     req: {
@@ -179,6 +225,8 @@ function buildControllerArgs(ipcContext, container) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ControllerResolver,
-  buildControllerArgs
+  buildControllerArgs,
+  buildOperationContext,
+  usesOperationContext
 });
 //# sourceMappingURL=controller_resolver.cjs.map

package/dist/controller/controller_resolver.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controller/controller_resolver.ts"],"sourcesContent":["import path from 'path';\nimport { pathToFileURL } from 'node:url';\nimport { getLogger } from '@noego/logger';\nimport type { IpcContext, ControllerArgs } from '../types/context.cjs';\n\nconst logger = getLogger('wood:controller');\n\n// Node's ESM loader rejects raw absolute Windows paths (`C:\\...`) — they must\n// be file:// URLs. Bare specifiers and relative paths pass through unchanged.\nfunction toImportSpecifier(spec: string): string {\n  return path.isAbsolute(spec) ? pathToFileURL(spec).href : spec;\n}\n\nexport class ControllerResolver {\n  private baseDir: string;\n  private classCache = new Map<string, any>();\n  private pathCache = new Map<string, string>(); // name -> import path\n  private mode: 'bundled' | 'dev';\n\n  constructor(controllersDir: string, options?: { mode?: 'bundled' | 'dev' }) {\n    this.baseDir = controllersDir;\n    // Default to bundled mode for safety. Dev mode must be explicitly opted into.\n    this.mode = options?.mode ?? (process.env.WOOD_MODE === 'development' ? 'dev' : 'bundled');\n  }\n\n  /**\n   * Check whether a controller name has been pre-registered (class or path).\n   */\n  has(name: string): boolean {\n    return this.classCache.has(name) || this.pathCache.has(name);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed. This avoids circular dependencies\n   * at module load time.\n   */\n  registerPath(name: string, importPath: string): void {\n    if (!importPath) {\n      throw new Error(`registerPath(\"${name}\"): importPath cannot be empty`);\n    }\n    this.pathCache.set(name, importPath);\n  }\n\n  /**\n   * Resolve a controller name to its class.\n   *\n   * 1. Check class cache (already imported)\n   * 2. Check path cache (registered via registerPath) and lazily import\n   * 3. In dev mode only: fall back to filesystem resolution\n   *\n   * Classes are cached -- same class reference returned for same name.\n   */\n  async resolveClass(controllerName: string): Promise<any> {\n    const cached = this.classCache.get(controllerName);\n    if (cached) return cached;\n\n    // Check if import path is registered — lazily load it\n    const importPath = this.pathCache.get(controllerName);\n    if (importPath) {\n      const mod = await import(toImportSpecifier(importPath));\n      const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];\n      if (!ControllerClass || typeof ControllerClass !== 'function') {\n        throw new Error(\n          `Controller \"${controllerName}\" at ${importPath}: module does not export a class`\n        );\n      }\n      this.classCache.set(controllerName, ControllerClass);\n      logger.debug(`Resolved controller \"${controllerName}\" from registered path`);\n      return ControllerClass;\n    }\n\n    if (this.mode === 'bundled') {\n      throw new Error(\n        `Controller \"${controllerName}\" is not registered. ` +\n        `In bundled mode, all controllers must be pre-registered via controllers.generated.ts. ` +\n        `Run \"npx wood build\" to regenerate the registration file.\\n` +\n        `Registered controllers: [${Array.from(this.pathCache.keys()).join(', ')}]`\n      );\n    }\n\n    // Dev mode: attempt dynamic filesystem imports\n    return this.resolveFromFilesystem(controllerName);\n  }\n\n  private async resolveFromFilesystem(controllerName: string): Promise<any> {\n    const basePath = path.resolve(this.baseDir, controllerName);\n    const candidates = [\n      basePath + '.ts',\n      basePath + '.controller.ts',\n      basePath + '.js',\n      basePath + '.controller.js',\n      path.resolve(this.baseDir, controllerName, 'index.ts'),\n      path.resolve(this.baseDir, controllerName, 'index.js'),\n    ];\n\n    let mod: any;\n    let loaded = false;\n\n    for (const candidate of candidates) {\n      try {\n        mod = await import(toImportSpecifier(candidate));\n        loaded = true;\n        break;\n      } catch {\n        // Try next candidate\n      }\n    }\n\n    if (!loaded) {\n      throw new Error(\n        `Controller \"${controllerName}\" not found. Searched:\\n` +\n        candidates.map(c => `  - ${c}`).join('\\n')\n      );\n    }\n\n    const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];\n    if (!ControllerClass || typeof ControllerClass !== 'function') {\n      throw new Error(\n        `Controller \"${controllerName}\": module does not export a class`\n      );\n    }\n\n    logger.debug(`Resolved controller \"${controllerName}\" from ${this.baseDir}`);\n    this.classCache.set(controllerName, ControllerClass);\n    return ControllerClass;\n  }\n\n  /**\n   * Create a controller instance using IoC container.\n   * Per-request scoped: container.extend() creates an isolated scope.\n   */\n  async createInstance(ControllerClass: any, container: any): Promise<any> {\n    const scopedContainer = container.extend();\n    return scopedContainer.instance(ControllerClass);\n  }\n\n  /**\n   * Pre-register a controller class by name so that resolveClass()\n   * finds it in the cache without attempting a filesystem import.\n   */\n  register(name: string, ControllerClass: any): void {\n    if (typeof ControllerClass !== 'function') {\n      throw new Error(`register(\"${name}\"): expected a class/constructor, got ${typeof ControllerClass}`);\n    }\n    this.classCache.set(name, ControllerClass);\n  }\n\n  clearCache(): void {\n    this.classCache.clear();\n  }\n}\n\n/**\n * Build controller args from IPC context.\n * Creates a fake req/res that matches the Dinner web pattern so\n * existing controllers work without modification.\n */\nexport function buildControllerArgs(ipcContext: IpcContext, container: unknown): ControllerArgs {\n  return {\n    req: {\n      body: ipcContext.body ?? {},\n      params: ipcContext.params ?? {},\n      query: ipcContext.query ?? {},\n      context: ipcContext.context ?? {},\n      headers: {},\n    },\n    res: {\n      status: (_code: number) => {},\n      cookie: (_name: string, _value: string, _opts?: unknown) => {},\n      clearCookie: (_name: string, _opts?: unknown) => {},\n      set: (_header: string, _value: string) => {},\n    },\n    container,\n  };\n}\n"],"mappings":"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","names":["path"]}
+{"version":3,"sources":["../../src/controller/controller_resolver.ts"],"sourcesContent":["import path from 'path';\nimport { pathToFileURL } from 'node:url';\nimport { getLogger } from '@noego/logger';\nimport type { IpcContext, ControllerArgs } from '../types/context.cjs';\n\nconst logger = getLogger('wood:controller');\n\n// Node's ESM loader rejects raw absolute Windows paths (`C:\\...`) — they must\n// be file:// URLs. Bare specifiers and relative paths pass through unchanged.\nfunction toImportSpecifier(spec: string): string {\n  return path.isAbsolute(spec) ? pathToFileURL(spec).href : spec;\n}\n\nexport class ControllerResolver {\n  private baseDir: string;\n  private classCache = new Map<string, any>();\n  private pathCache = new Map<string, string>(); // name -> import path\n  private loaderCache = new Map<string, () => Promise<unknown>>(); // name -> lazy module loader\n  private mode: 'bundled' | 'dev';\n\n  constructor(controllersDir: string, options?: { mode?: 'bundled' | 'dev' }) {\n    this.baseDir = controllersDir;\n    // Default to bundled mode for safety. Dev mode must be explicitly opted into.\n    this.mode = options?.mode ?? (process.env.WOOD_MODE === 'development' ? 'dev' : 'bundled');\n  }\n\n  /**\n   * Check whether a controller name has been pre-registered (class or path).\n   */\n  has(name: string): boolean {\n    return this.classCache.has(name) || this.pathCache.has(name) || this.loaderCache.has(name);\n  }\n\n  /**\n   * Register a lazy module loader for a controller. The loader is the\n   * CALLER's `() => import('...literal specifier...')`, so the import runs in\n   * the caller's module resolution (bundler/test-runner identity) instead of\n   * a raw filesystem import — same class identity as every other import of\n   * that module. Invoked only on first resolution.\n   */\n  registerLoader(name: string, loader: () => Promise<unknown>): void {\n    if (typeof loader !== 'function') {\n      throw new Error(`registerLoader(\"${name}\"): expected a () => Promise<module> function`);\n    }\n    this.loaderCache.set(name, loader);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed. This avoids circular dependencies\n   * at module load time.\n   */\n  registerPath(name: string, importPath: string): void {\n    if (!importPath) {\n      throw new Error(`registerPath(\"${name}\"): importPath cannot be empty`);\n    }\n    this.pathCache.set(name, importPath);\n  }\n\n  /**\n   * Resolve a controller name to its class.\n   *\n   * 1. Check class cache (already imported)\n   * 2. Check path cache (registered via registerPath) and lazily import\n   * 3. In dev mode only: fall back to filesystem resolution\n   *\n   * Classes are cached -- same class reference returned for same name.\n   */\n  async resolveClass(controllerName: string): Promise<any> {\n    const cached = this.classCache.get(controllerName);\n    if (cached) return cached;\n\n    // Lazy loader (caller-owned import) takes precedence: it preserves the\n    // caller's module identity for the controller and its dependency graph.\n    const loader = this.loaderCache.get(controllerName);\n    if (loader) {\n      const mod = (await loader()) as Record<string, unknown>;\n      const ControllerClass = (mod.default ?? mod[Object.keys(mod)[0]]) as unknown;\n      if (!ControllerClass || typeof ControllerClass !== 'function') {\n        throw new Error(\n          `Controller \"${controllerName}\": registered loader's module does not export a class`\n        );\n      }\n      this.classCache.set(controllerName, ControllerClass);\n      logger.debug(`Resolved controller \"${controllerName}\" from registered loader`);\n      return ControllerClass;\n    }\n\n    // Check if import path is registered — lazily load it\n    const importPath = this.pathCache.get(controllerName);\n    if (importPath) {\n      const mod = await import(toImportSpecifier(importPath));\n      const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];\n      if (!ControllerClass || typeof ControllerClass !== 'function') {\n        throw new Error(\n          `Controller \"${controllerName}\" at ${importPath}: module does not export a class`\n        );\n      }\n      this.classCache.set(controllerName, ControllerClass);\n      logger.debug(`Resolved controller \"${controllerName}\" from registered path`);\n      return ControllerClass;\n    }\n\n    if (this.mode === 'bundled') {\n      throw new Error(\n        `Controller \"${controllerName}\" is not registered. ` +\n        `In bundled mode, all controllers must be pre-registered via controllers.generated.ts. ` +\n        `Run \"npx wood build\" to regenerate the registration file.\\n` +\n        `Registered controllers: [${Array.from(this.pathCache.keys()).join(', ')}]`\n      );\n    }\n\n    // Dev mode: attempt dynamic filesystem imports\n    return this.resolveFromFilesystem(controllerName);\n  }\n\n  private async resolveFromFilesystem(controllerName: string): Promise<any> {\n    const basePath = path.resolve(this.baseDir, controllerName);\n    const candidates = [\n      basePath + '.ts',\n      basePath + '.controller.ts',\n      basePath + '.js',\n      basePath + '.controller.js',\n      path.resolve(this.baseDir, controllerName, 'index.ts'),\n      path.resolve(this.baseDir, controllerName, 'index.js'),\n    ];\n\n    let mod: any;\n    let loaded = false;\n\n    for (const candidate of candidates) {\n      try {\n        mod = await import(toImportSpecifier(candidate));\n        loaded = true;\n        break;\n      } catch {\n        // Try next candidate\n      }\n    }\n\n    if (!loaded) {\n      throw new Error(\n        `Controller \"${controllerName}\" not found. Searched:\\n` +\n        candidates.map(c => `  - ${c}`).join('\\n')\n      );\n    }\n\n    const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];\n    if (!ControllerClass || typeof ControllerClass !== 'function') {\n      throw new Error(\n        `Controller \"${controllerName}\": module does not export a class`\n      );\n    }\n\n    logger.debug(`Resolved controller \"${controllerName}\" from ${this.baseDir}`);\n    this.classCache.set(controllerName, ControllerClass);\n    return ControllerClass;\n  }\n\n  /**\n   * Create a controller instance using IoC container.\n   * Per-request scoped: container.extend() creates an isolated scope.\n   */\n  async createInstance(ControllerClass: any, container: any): Promise<any> {\n    const scopedContainer = container.extend();\n    return scopedContainer.instance(ControllerClass);\n  }\n\n  /**\n   * Pre-register a controller class by name so that resolveClass()\n   * finds it in the cache without attempting a filesystem import.\n   */\n  register(name: string, ControllerClass: any): void {\n    if (typeof ControllerClass !== 'function') {\n      throw new Error(`register(\"${name}\"): expected a class/constructor, got ${typeof ControllerClass}`);\n    }\n    this.classCache.set(name, ControllerClass);\n  }\n\n  clearCache(): void {\n    this.classCache.clear();\n  }\n}\n\n/**\n * Whether a controller class opted into the native Desktop boundary\n * (`static woodContext = 'operation'`). Native actions receive a\n * WoodOperationContext; everything else keeps the legacy args pair.\n */\nexport function usesOperationContext(ControllerClass: unknown): boolean {\n  return (ControllerClass as { woodContext?: string })?.woodContext === 'operation';\n}\n\n/**\n * Build the native Wood operation context for a controller action.\n * Desktop-shaped: operation identity, validated input, middleware state,\n * sender/window — no fabricated HTTP surface, no container.\n */\nexport function buildOperationContext(\n  operation: string,\n  ipcContext: IpcContext\n): import('../types/context.cjs').WoodOperationContext {\n  const state = ipcContext.context ?? {};\n  return {\n    operation,\n    input: ipcContext.body,\n    state,\n    sender: ipcContext.sender,\n    windowId: ipcContext.windowId,\n    get<T>(key: string): T | undefined {\n      return state[key] as T | undefined;\n    },\n  };\n}\n\n/**\n * Build controller args from IPC context.\n * LEGACY-COMPAT: creates a fake req/res matching the Dinner web pattern so\n * pre-native controllers work without modification. New controllers declare\n * `static woodContext = 'operation'` and receive a WoodOperationContext\n * (see buildOperationContext) instead.\n */\nexport function buildControllerArgs(ipcContext: IpcContext, container: unknown): ControllerArgs {\n  return {\n    req: {\n      body: ipcContext.body ?? {},\n      params: ipcContext.params ?? {},\n      query: ipcContext.query ?? {},\n      context: ipcContext.context ?? {},\n      headers: {},\n    },\n    res: {\n      status: (_code: number) => {},\n      cookie: (_name: string, _value: string, _opts?: unknown) => {},\n      clearCookie: (_name: string, _opts?: unknown) => {},\n      set: (_header: string, _value: string) => {},\n    },\n    container,\n  };\n}\n"],"mappings":"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","names":["path"]}

package/dist/controller/controller_resolver.d.cts

@@ -1,9 +1,10 @@
-import { IpcContext, ControllerArgs } from '../types/context.cjs';
+import { IpcContext, ControllerArgs, WoodOperationContext } from '../types/context.cjs';
 
 declare class ControllerResolver {
     private baseDir;
     private classCache;
     private pathCache;
+    private loaderCache;
     private mode;
     constructor(controllersDir: string, options?: {
         mode?: 'bundled' | 'dev';
@@ -12,6 +13,14 @@ declare class ControllerResolver {
      * Check whether a controller name has been pre-registered (class or path).
      */
     has(name: string): boolean;
+    /**
+     * Register a lazy module loader for a controller. The loader is the
+     * CALLER's `() => import('...literal specifier...')`, so the import runs in
+     * the caller's module resolution (bundler/test-runner identity) instead of
+     * a raw filesystem import — same class identity as every other import of
+     * that module. Invoked only on first resolution.
+     */
+    registerLoader(name: string, loader: () => Promise<unknown>): void;
     /**
      * Register an import path for a controller. The controller will be lazily
      * imported from this path when first needed. This avoids circular dependencies
@@ -41,11 +50,25 @@ declare class ControllerResolver {
     register(name: string, ControllerClass: any): void;
     clearCache(): void;
 }
+/**
+ * Whether a controller class opted into the native Desktop boundary
+ * (`static woodContext = 'operation'`). Native actions receive a
+ * WoodOperationContext; everything else keeps the legacy args pair.
+ */
+declare function usesOperationContext(ControllerClass: unknown): boolean;
+/**
+ * Build the native Wood operation context for a controller action.
+ * Desktop-shaped: operation identity, validated input, middleware state,
+ * sender/window — no fabricated HTTP surface, no container.
+ */
+declare function buildOperationContext(operation: string, ipcContext: IpcContext): WoodOperationContext;
 /**
  * Build controller args from IPC context.
- * Creates a fake req/res that matches the Dinner web pattern so
- * existing controllers work without modification.
+ * LEGACY-COMPAT: creates a fake req/res matching the Dinner web pattern so
+ * pre-native controllers work without modification. New controllers declare
+ * `static woodContext = 'operation'` and receive a WoodOperationContext
+ * (see buildOperationContext) instead.
  */
 declare function buildControllerArgs(ipcContext: IpcContext, container: unknown): ControllerArgs;
 
-export { ControllerResolver, buildControllerArgs };
+export { ControllerResolver, buildControllerArgs, buildOperationContext, usesOperationContext };

package/dist/controller/controller_resolver.d.ts

@@ -1,9 +1,10 @@
-import { IpcContext, ControllerArgs } from '../types/context.js';
+import { IpcContext, ControllerArgs, WoodOperationContext } from '../types/context.js';
 
 declare class ControllerResolver {
     private baseDir;
     private classCache;
     private pathCache;
+    private loaderCache;
     private mode;
     constructor(controllersDir: string, options?: {
         mode?: 'bundled' | 'dev';
@@ -12,6 +13,14 @@ declare class ControllerResolver {
      * Check whether a controller name has been pre-registered (class or path).
      */
     has(name: string): boolean;
+    /**
+     * Register a lazy module loader for a controller. The loader is the
+     * CALLER's `() => import('...literal specifier...')`, so the import runs in
+     * the caller's module resolution (bundler/test-runner identity) instead of
+     * a raw filesystem import — same class identity as every other import of
+     * that module. Invoked only on first resolution.
+     */
+    registerLoader(name: string, loader: () => Promise<unknown>): void;
     /**
      * Register an import path for a controller. The controller will be lazily
      * imported from this path when first needed. This avoids circular dependencies
@@ -41,11 +50,25 @@ declare class ControllerResolver {
     register(name: string, ControllerClass: any): void;
     clearCache(): void;
 }
+/**
+ * Whether a controller class opted into the native Desktop boundary
+ * (`static woodContext = 'operation'`). Native actions receive a
+ * WoodOperationContext; everything else keeps the legacy args pair.
+ */
+declare function usesOperationContext(ControllerClass: unknown): boolean;
+/**
+ * Build the native Wood operation context for a controller action.
+ * Desktop-shaped: operation identity, validated input, middleware state,
+ * sender/window — no fabricated HTTP surface, no container.
+ */
+declare function buildOperationContext(operation: string, ipcContext: IpcContext): WoodOperationContext;
 /**
  * Build controller args from IPC context.
- * Creates a fake req/res that matches the Dinner web pattern so
- * existing controllers work without modification.
+ * LEGACY-COMPAT: creates a fake req/res matching the Dinner web pattern so
+ * pre-native controllers work without modification. New controllers declare
+ * `static woodContext = 'operation'` and receive a WoodOperationContext
+ * (see buildOperationContext) instead.
  */
 declare function buildControllerArgs(ipcContext: IpcContext, container: unknown): ControllerArgs;
 
-export { ControllerResolver, buildControllerArgs };
+export { ControllerResolver, buildControllerArgs, buildOperationContext, usesOperationContext };

package/dist/controller/controller_resolver.js

@@ -9,6 +9,8 @@ class ControllerResolver {
   constructor(controllersDir, options) {
     this.classCache = /* @__PURE__ */ new Map();
     this.pathCache = /* @__PURE__ */ new Map();
+    // name -> import path
+    this.loaderCache = /* @__PURE__ */ new Map();
     this.baseDir = controllersDir;
     this.mode = options?.mode ?? (process.env.WOOD_MODE === "development" ? "dev" : "bundled");
   }
@@ -16,7 +18,20 @@ class ControllerResolver {
    * Check whether a controller name has been pre-registered (class or path).
    */
   has(name) {
-    return this.classCache.has(name) || this.pathCache.has(name);
+    return this.classCache.has(name) || this.pathCache.has(name) || this.loaderCache.has(name);
+  }
+  /**
+   * Register a lazy module loader for a controller. The loader is the
+   * CALLER's `() => import('...literal specifier...')`, so the import runs in
+   * the caller's module resolution (bundler/test-runner identity) instead of
+   * a raw filesystem import — same class identity as every other import of
+   * that module. Invoked only on first resolution.
+   */
+  registerLoader(name, loader) {
+    if (typeof loader !== "function") {
+      throw new Error(`registerLoader("${name}"): expected a () => Promise<module> function`);
+    }
+    this.loaderCache.set(name, loader);
   }
   /**
    * Register an import path for a controller. The controller will be lazily
@@ -41,6 +56,19 @@ class ControllerResolver {
   async resolveClass(controllerName) {
     const cached = this.classCache.get(controllerName);
     if (cached) return cached;
+    const loader = this.loaderCache.get(controllerName);
+    if (loader) {
+      const mod = await loader();
+      const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];
+      if (!ControllerClass || typeof ControllerClass !== "function") {
+        throw new Error(
+          `Controller "${controllerName}": registered loader's module does not export a class`
+        );
+      }
+      this.classCache.set(controllerName, ControllerClass);
+      logger.debug(`Resolved controller "${controllerName}" from registered loader`);
+      return ControllerClass;
+    }
     const importPath = this.pathCache.get(controllerName);
     if (importPath) {
       const mod = await import(toImportSpecifier(importPath));
@@ -120,6 +148,22 @@ Registered controllers: [${Array.from(this.pathCache.keys()).join(", ")}]`
     this.classCache.clear();
   }
 }
+function usesOperationContext(ControllerClass) {
+  return ControllerClass?.woodContext === "operation";
+}
+function buildOperationContext(operation, ipcContext) {
+  const state = ipcContext.context ?? {};
+  return {
+    operation,
+    input: ipcContext.body,
+    state,
+    sender: ipcContext.sender,
+    windowId: ipcContext.windowId,
+    get(key) {
+      return state[key];
+    }
+  };
+}
 function buildControllerArgs(ipcContext, container) {
   return {
     req: {
@@ -144,6 +188,8 @@ function buildControllerArgs(ipcContext, container) {
 }
 export {
   ControllerResolver,
-  buildControllerArgs
+  buildControllerArgs,
+  buildOperationContext,
+  usesOperationContext
 };
 //# sourceMappingURL=controller_resolver.js.map

package/dist/controller/controller_resolver.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controller/controller_resolver.ts"],"sourcesContent":["import path from 'path';\nimport { pathToFileURL } from 'node:url';\nimport { getLogger } from '@noego/logger';\nimport type { IpcContext, ControllerArgs } from '../types/context.js';\n\nconst logger = getLogger('wood:controller');\n\n// Node's ESM loader rejects raw absolute Windows paths (`C:\\...`) — they must\n// be file:// URLs. Bare specifiers and relative paths pass through unchanged.\nfunction toImportSpecifier(spec: string): string {\n  return path.isAbsolute(spec) ? pathToFileURL(spec).href : spec;\n}\n\nexport class ControllerResolver {\n  private baseDir: string;\n  private classCache = new Map<string, any>();\n  private pathCache = new Map<string, string>(); // name -> import path\n  private mode: 'bundled' | 'dev';\n\n  constructor(controllersDir: string, options?: { mode?: 'bundled' | 'dev' }) {\n    this.baseDir = controllersDir;\n    // Default to bundled mode for safety. Dev mode must be explicitly opted into.\n    this.mode = options?.mode ?? (process.env.WOOD_MODE === 'development' ? 'dev' : 'bundled');\n  }\n\n  /**\n   * Check whether a controller name has been pre-registered (class or path).\n   */\n  has(name: string): boolean {\n    return this.classCache.has(name) || this.pathCache.has(name);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed. This avoids circular dependencies\n   * at module load time.\n   */\n  registerPath(name: string, importPath: string): void {\n    if (!importPath) {\n      throw new Error(`registerPath(\"${name}\"): importPath cannot be empty`);\n    }\n    this.pathCache.set(name, importPath);\n  }\n\n  /**\n   * Resolve a controller name to its class.\n   *\n   * 1. Check class cache (already imported)\n   * 2. Check path cache (registered via registerPath) and lazily import\n   * 3. In dev mode only: fall back to filesystem resolution\n   *\n   * Classes are cached -- same class reference returned for same name.\n   */\n  async resolveClass(controllerName: string): Promise<any> {\n    const cached = this.classCache.get(controllerName);\n    if (cached) return cached;\n\n    // Check if import path is registered — lazily load it\n    const importPath = this.pathCache.get(controllerName);\n    if (importPath) {\n      const mod = await import(toImportSpecifier(importPath));\n      const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];\n      if (!ControllerClass || typeof ControllerClass !== 'function') {\n        throw new Error(\n          `Controller \"${controllerName}\" at ${importPath}: module does not export a class`\n        );\n      }\n      this.classCache.set(controllerName, ControllerClass);\n      logger.debug(`Resolved controller \"${controllerName}\" from registered path`);\n      return ControllerClass;\n    }\n\n    if (this.mode === 'bundled') {\n      throw new Error(\n        `Controller \"${controllerName}\" is not registered. ` +\n        `In bundled mode, all controllers must be pre-registered via controllers.generated.ts. ` +\n        `Run \"npx wood build\" to regenerate the registration file.\\n` +\n        `Registered controllers: [${Array.from(this.pathCache.keys()).join(', ')}]`\n      );\n    }\n\n    // Dev mode: attempt dynamic filesystem imports\n    return this.resolveFromFilesystem(controllerName);\n  }\n\n  private async resolveFromFilesystem(controllerName: string): Promise<any> {\n    const basePath = path.resolve(this.baseDir, controllerName);\n    const candidates = [\n      basePath + '.ts',\n      basePath + '.controller.ts',\n      basePath + '.js',\n      basePath + '.controller.js',\n      path.resolve(this.baseDir, controllerName, 'index.ts'),\n      path.resolve(this.baseDir, controllerName, 'index.js'),\n    ];\n\n    let mod: any;\n    let loaded = false;\n\n    for (const candidate of candidates) {\n      try {\n        mod = await import(toImportSpecifier(candidate));\n        loaded = true;\n        break;\n      } catch {\n        // Try next candidate\n      }\n    }\n\n    if (!loaded) {\n      throw new Error(\n        `Controller \"${controllerName}\" not found. Searched:\\n` +\n        candidates.map(c => `  - ${c}`).join('\\n')\n      );\n    }\n\n    const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];\n    if (!ControllerClass || typeof ControllerClass !== 'function') {\n      throw new Error(\n        `Controller \"${controllerName}\": module does not export a class`\n      );\n    }\n\n    logger.debug(`Resolved controller \"${controllerName}\" from ${this.baseDir}`);\n    this.classCache.set(controllerName, ControllerClass);\n    return ControllerClass;\n  }\n\n  /**\n   * Create a controller instance using IoC container.\n   * Per-request scoped: container.extend() creates an isolated scope.\n   */\n  async createInstance(ControllerClass: any, container: any): Promise<any> {\n    const scopedContainer = container.extend();\n    return scopedContainer.instance(ControllerClass);\n  }\n\n  /**\n   * Pre-register a controller class by name so that resolveClass()\n   * finds it in the cache without attempting a filesystem import.\n   */\n  register(name: string, ControllerClass: any): void {\n    if (typeof ControllerClass !== 'function') {\n      throw new Error(`register(\"${name}\"): expected a class/constructor, got ${typeof ControllerClass}`);\n    }\n    this.classCache.set(name, ControllerClass);\n  }\n\n  clearCache(): void {\n    this.classCache.clear();\n  }\n}\n\n/**\n * Build controller args from IPC context.\n * Creates a fake req/res that matches the Dinner web pattern so\n * existing controllers work without modification.\n */\nexport function buildControllerArgs(ipcContext: IpcContext, container: unknown): ControllerArgs {\n  return {\n    req: {\n      body: ipcContext.body ?? {},\n      params: ipcContext.params ?? {},\n      query: ipcContext.query ?? {},\n      context: ipcContext.context ?? {},\n      headers: {},\n    },\n    res: {\n      status: (_code: number) => {},\n      cookie: (_name: string, _value: string, _opts?: unknown) => {},\n      clearCookie: (_name: string, _opts?: unknown) => {},\n      set: (_header: string, _value: string) => {},\n    },\n    container,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/controller/controller_resolver.ts"],"sourcesContent":["import path from 'path';\nimport { pathToFileURL } from 'node:url';\nimport { getLogger } from '@noego/logger';\nimport type { IpcContext, ControllerArgs } from '../types/context.js';\n\nconst logger = getLogger('wood:controller');\n\n// Node's ESM loader rejects raw absolute Windows paths (`C:\\...`) — they must\n// be file:// URLs. Bare specifiers and relative paths pass through unchanged.\nfunction toImportSpecifier(spec: string): string {\n  return path.isAbsolute(spec) ? pathToFileURL(spec).href : spec;\n}\n\nexport class ControllerResolver {\n  private baseDir: string;\n  private classCache = new Map<string, any>();\n  private pathCache = new Map<string, string>(); // name -> import path\n  private loaderCache = new Map<string, () => Promise<unknown>>(); // name -> lazy module loader\n  private mode: 'bundled' | 'dev';\n\n  constructor(controllersDir: string, options?: { mode?: 'bundled' | 'dev' }) {\n    this.baseDir = controllersDir;\n    // Default to bundled mode for safety. Dev mode must be explicitly opted into.\n    this.mode = options?.mode ?? (process.env.WOOD_MODE === 'development' ? 'dev' : 'bundled');\n  }\n\n  /**\n   * Check whether a controller name has been pre-registered (class or path).\n   */\n  has(name: string): boolean {\n    return this.classCache.has(name) || this.pathCache.has(name) || this.loaderCache.has(name);\n  }\n\n  /**\n   * Register a lazy module loader for a controller. The loader is the\n   * CALLER's `() => import('...literal specifier...')`, so the import runs in\n   * the caller's module resolution (bundler/test-runner identity) instead of\n   * a raw filesystem import — same class identity as every other import of\n   * that module. Invoked only on first resolution.\n   */\n  registerLoader(name: string, loader: () => Promise<unknown>): void {\n    if (typeof loader !== 'function') {\n      throw new Error(`registerLoader(\"${name}\"): expected a () => Promise<module> function`);\n    }\n    this.loaderCache.set(name, loader);\n  }\n\n  /**\n   * Register an import path for a controller. The controller will be lazily\n   * imported from this path when first needed. This avoids circular dependencies\n   * at module load time.\n   */\n  registerPath(name: string, importPath: string): void {\n    if (!importPath) {\n      throw new Error(`registerPath(\"${name}\"): importPath cannot be empty`);\n    }\n    this.pathCache.set(name, importPath);\n  }\n\n  /**\n   * Resolve a controller name to its class.\n   *\n   * 1. Check class cache (already imported)\n   * 2. Check path cache (registered via registerPath) and lazily import\n   * 3. In dev mode only: fall back to filesystem resolution\n   *\n   * Classes are cached -- same class reference returned for same name.\n   */\n  async resolveClass(controllerName: string): Promise<any> {\n    const cached = this.classCache.get(controllerName);\n    if (cached) return cached;\n\n    // Lazy loader (caller-owned import) takes precedence: it preserves the\n    // caller's module identity for the controller and its dependency graph.\n    const loader = this.loaderCache.get(controllerName);\n    if (loader) {\n      const mod = (await loader()) as Record<string, unknown>;\n      const ControllerClass = (mod.default ?? mod[Object.keys(mod)[0]]) as unknown;\n      if (!ControllerClass || typeof ControllerClass !== 'function') {\n        throw new Error(\n          `Controller \"${controllerName}\": registered loader's module does not export a class`\n        );\n      }\n      this.classCache.set(controllerName, ControllerClass);\n      logger.debug(`Resolved controller \"${controllerName}\" from registered loader`);\n      return ControllerClass;\n    }\n\n    // Check if import path is registered — lazily load it\n    const importPath = this.pathCache.get(controllerName);\n    if (importPath) {\n      const mod = await import(toImportSpecifier(importPath));\n      const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];\n      if (!ControllerClass || typeof ControllerClass !== 'function') {\n        throw new Error(\n          `Controller \"${controllerName}\" at ${importPath}: module does not export a class`\n        );\n      }\n      this.classCache.set(controllerName, ControllerClass);\n      logger.debug(`Resolved controller \"${controllerName}\" from registered path`);\n      return ControllerClass;\n    }\n\n    if (this.mode === 'bundled') {\n      throw new Error(\n        `Controller \"${controllerName}\" is not registered. ` +\n        `In bundled mode, all controllers must be pre-registered via controllers.generated.ts. ` +\n        `Run \"npx wood build\" to regenerate the registration file.\\n` +\n        `Registered controllers: [${Array.from(this.pathCache.keys()).join(', ')}]`\n      );\n    }\n\n    // Dev mode: attempt dynamic filesystem imports\n    return this.resolveFromFilesystem(controllerName);\n  }\n\n  private async resolveFromFilesystem(controllerName: string): Promise<any> {\n    const basePath = path.resolve(this.baseDir, controllerName);\n    const candidates = [\n      basePath + '.ts',\n      basePath + '.controller.ts',\n      basePath + '.js',\n      basePath + '.controller.js',\n      path.resolve(this.baseDir, controllerName, 'index.ts'),\n      path.resolve(this.baseDir, controllerName, 'index.js'),\n    ];\n\n    let mod: any;\n    let loaded = false;\n\n    for (const candidate of candidates) {\n      try {\n        mod = await import(toImportSpecifier(candidate));\n        loaded = true;\n        break;\n      } catch {\n        // Try next candidate\n      }\n    }\n\n    if (!loaded) {\n      throw new Error(\n        `Controller \"${controllerName}\" not found. Searched:\\n` +\n        candidates.map(c => `  - ${c}`).join('\\n')\n      );\n    }\n\n    const ControllerClass = mod.default ?? mod[Object.keys(mod)[0]];\n    if (!ControllerClass || typeof ControllerClass !== 'function') {\n      throw new Error(\n        `Controller \"${controllerName}\": module does not export a class`\n      );\n    }\n\n    logger.debug(`Resolved controller \"${controllerName}\" from ${this.baseDir}`);\n    this.classCache.set(controllerName, ControllerClass);\n    return ControllerClass;\n  }\n\n  /**\n   * Create a controller instance using IoC container.\n   * Per-request scoped: container.extend() creates an isolated scope.\n   */\n  async createInstance(ControllerClass: any, container: any): Promise<any> {\n    const scopedContainer = container.extend();\n    return scopedContainer.instance(ControllerClass);\n  }\n\n  /**\n   * Pre-register a controller class by name so that resolveClass()\n   * finds it in the cache without attempting a filesystem import.\n   */\n  register(name: string, ControllerClass: any): void {\n    if (typeof ControllerClass !== 'function') {\n      throw new Error(`register(\"${name}\"): expected a class/constructor, got ${typeof ControllerClass}`);\n    }\n    this.classCache.set(name, ControllerClass);\n  }\n\n  clearCache(): void {\n    this.classCache.clear();\n  }\n}\n\n/**\n * Whether a controller class opted into the native Desktop boundary\n * (`static woodContext = 'operation'`). Native actions receive a\n * WoodOperationContext; everything else keeps the legacy args pair.\n */\nexport function usesOperationContext(ControllerClass: unknown): boolean {\n  return (ControllerClass as { woodContext?: string })?.woodContext === 'operation';\n}\n\n/**\n * Build the native Wood operation context for a controller action.\n * Desktop-shaped: operation identity, validated input, middleware state,\n * sender/window — no fabricated HTTP surface, no container.\n */\nexport function buildOperationContext(\n  operation: string,\n  ipcContext: IpcContext\n): import('../types/context.js').WoodOperationContext {\n  const state = ipcContext.context ?? {};\n  return {\n    operation,\n    input: ipcContext.body,\n    state,\n    sender: ipcContext.sender,\n    windowId: ipcContext.windowId,\n    get<T>(key: string): T | undefined {\n      return state[key] as T | undefined;\n    },\n  };\n}\n\n/**\n * Build controller args from IPC context.\n * LEGACY-COMPAT: creates a fake req/res matching the Dinner web pattern so\n * pre-native controllers work without modification. New controllers declare\n * `static woodContext = 'operation'` and receive a WoodOperationContext\n * (see buildOperationContext) instead.\n */\nexport function buildControllerArgs(ipcContext: IpcContext, container: unknown): ControllerArgs {\n  return {\n    req: {\n      body: ipcContext.body ?? {},\n      params: ipcContext.params ?? {},\n      query: ipcContext.query ?? {},\n      context: ipcContext.context ?? {},\n      headers: {},\n    },\n    res: {\n      status: (_code: number) => {},\n      cookie: (_name: string, _value: string, _opts?: unknown) => {},\n      clearCookie: (_name: string, _opts?: unknown) => {},\n      set: (_header: string, _value: string) => {},\n    },\n    container,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/controller/index.cjs

@@ -20,7 +20,9 @@ var controller_exports = {};
 __export(controller_exports, {
   ControllerResolver: () => import_controller_resolver.ControllerResolver,
   buildControllerArgs: () => import_controller_resolver.buildControllerArgs,
-  disposeControllerLifecycle: () => import_controller_lifecycle.disposeControllerLifecycle
+  buildOperationContext: () => import_controller_resolver.buildOperationContext,
+  disposeControllerLifecycle: () => import_controller_lifecycle.disposeControllerLifecycle,
+  usesOperationContext: () => import_controller_resolver.usesOperationContext
 });
 module.exports = __toCommonJS(controller_exports);
 var import_controller_resolver = require("./controller_resolver.cjs");
@@ -29,6 +31,8 @@ var import_controller_lifecycle = require("./controller_lifecycle.cjs");
 0 && (module.exports = {
   ControllerResolver,
   buildControllerArgs,
-  disposeControllerLifecycle
+  buildOperationContext,
+  disposeControllerLifecycle,
+  usesOperationContext
 });
 //# 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';\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":[]}
+{"version":3,"sources":["../../src/controller/index.ts"],"sourcesContent":["export { ControllerResolver, buildControllerArgs, buildOperationContext, usesOperationContext } 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;AAAA;AAAA,iCAAqG;AAErG,kCAA2C;","names":[]}

package/dist/controller/index.d.cts

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

package/dist/controller/index.d.ts

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

package/dist/controller/index.js

@@ -1,8 +1,10 @@
-import { ControllerResolver, buildControllerArgs } from "./controller_resolver.js";
+import { ControllerResolver, buildControllerArgs, buildOperationContext, usesOperationContext } from "./controller_resolver.js";
 import { disposeControllerLifecycle } from "./controller_lifecycle.js";
 export {
   ControllerResolver,
   buildControllerArgs,
-  disposeControllerLifecycle
+  buildOperationContext,
+  disposeControllerLifecycle,
+  usesOperationContext
 };
 //# 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';\nexport type { ControllerLifecycle } from './controller_lifecycle.js';\nexport { disposeControllerLifecycle } from './controller_lifecycle.js';\n"],"mappings":"AAAA,SAAS,oBAAoB,2BAA2B;AAExD,SAAS,kCAAkC;","names":[]}
+{"version":3,"sources":["../../src/controller/index.ts"],"sourcesContent":["export { ControllerResolver, buildControllerArgs, buildOperationContext, usesOperationContext } from './controller_resolver.js';\nexport type { ControllerLifecycle } from './controller_lifecycle.js';\nexport { disposeControllerLifecycle } from './controller_lifecycle.js';\n"],"mappings":"AAAA,SAAS,oBAAoB,qBAAqB,uBAAuB,4BAA4B;AAErG,SAAS,kCAAkC;","names":[]}

package/dist/dev/wood_dev_server.cjs

@@ -88,7 +88,9 @@ class WoodDevServer {
     logger.info("views parsed", { count: views.length });
     const outDir = import_path.default.resolve(this.cwd, this.config.outDir);
     (0, import_fs.mkdirSync)(outDir, { recursive: true });
-    const preloadCode = (0, import_preload_generator.generatePreload)(operations);
+    const preloadCode = (0, import_preload_generator.generatePreload)(operations, {
+      traceBatching: (0, import_config_parser.resolveRendererTraceBatching)(this.config)
+    });
     (0, import_fs.writeFileSync)(import_path.default.join(outDir, "preload.generated.ts"), preloadCode);
     const typesCode = (0, import_type_generator.generateTypes)(operations);
     (0, import_fs.writeFileSync)(import_path.default.join(outDir, "wood.d.ts"), typesCode);
@@ -191,6 +193,7 @@ class WoodDevServer {
       outDir,
       rendererOutDir: import_path.default.resolve(this.cwd, this.config.renderer.componentDir, "generated"),
       cwd: this.cwd,
+      traceBatching: (0, import_config_parser.resolveRendererTraceBatching)(this.config),
       onViewsChange: async () => {
         const viewsContent = (0, import_fs.readFileSync)(
           import_path.default.resolve(this.cwd, this.config.renderer.openapi),

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(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"]}
+{"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, resolveRendererTraceBatching } 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      traceBatching: resolveRendererTraceBatching(this.config),\n    });\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      traceBatching: resolveRendererTraceBatching(this.config),\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

@@ -1,7 +1,7 @@
 import { readFileSync, writeFileSync, mkdirSync } from "fs";
 import path from "path";
 import { getLogger } from "@noego/logger";
-import { parseConfig } from "../config/config_parser.js";
+import { parseConfig, resolveRendererTraceBatching } from "../config/config_parser.js";
 import { parseOperations } from "../parser/operations_parser.js";
 import { parseViews } from "../parser/views_parser.js";
 import { generatePreload } from "../codegen/preload_generator.js";
@@ -55,7 +55,9 @@ class WoodDevServer {
     logger.info("views parsed", { count: views.length });
     const outDir = path.resolve(this.cwd, this.config.outDir);
     mkdirSync(outDir, { recursive: true });
-    const preloadCode = generatePreload(operations);
+    const preloadCode = generatePreload(operations, {
+      traceBatching: resolveRendererTraceBatching(this.config)
+    });
     writeFileSync(path.join(outDir, "preload.generated.ts"), preloadCode);
     const typesCode = generateTypes(operations);
     writeFileSync(path.join(outDir, "wood.d.ts"), typesCode);
@@ -158,6 +160,7 @@ class WoodDevServer {
       outDir,
       rendererOutDir: path.resolve(this.cwd, this.config.renderer.componentDir, "generated"),
       cwd: this.cwd,
+      traceBatching: resolveRendererTraceBatching(this.config),
       onViewsChange: async () => {
         const viewsContent = readFileSync(
           path.resolve(this.cwd, this.config.renderer.openapi),