@noego/wood 0.0.1

package/dist/dev/wood_dev_server.js.map

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

package/dist/dev/yaml_watcher.cjs

@@ -0,0 +1,142 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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, from2, except, desc) => {
+  if (from2 && typeof from2 === "object" || typeof from2 === "function") {
+    for (let key of __getOwnPropNames(from2))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from2[key], enumerable: !(desc = __getOwnPropDesc(from2, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var yaml_watcher_exports = {};
+__export(yaml_watcher_exports, {
+  YamlWatcher: () => YamlWatcher
+});
+module.exports = __toCommonJS(yaml_watcher_exports);
+var import_chokidar = require("chokidar");
+var import_rxjs = require("rxjs");
+var import_fs = require("fs");
+var import_path = __toESM(require("path"), 1);
+var import_logger = require("@noego/logger");
+var import_operations_parser = require("../parser/operations_parser.cjs");
+var import_preload_generator = require("../codegen/preload_generator.cjs");
+var import_type_generator = require("../codegen/type_generator.cjs");
+var import_test_mock_generator = require("../codegen/test_mock_generator.cjs");
+var import_controller_registration_generator = require("../codegen/controller_registration_generator.cjs");
+var import_runtime_generator = require("../codegen/runtime_generator.cjs");
+const logger = (0, import_logger.getLogger)("wood:dev:yaml-watcher");
+class YamlWatcher {
+  constructor(options) {
+    this.options = options;
+    this.watcher = null;
+    this.change$ = new import_rxjs.Subject();
+  }
+  start() {
+    const patterns = [
+      this.options.operationsYamlPath,
+      this.options.viewsYamlPath,
+      import_path.default.dirname(this.options.operationsYamlPath) + "/**/*.yaml",
+      import_path.default.dirname(this.options.operationsYamlPath) + "/**/*.yml",
+      import_path.default.dirname(this.options.viewsYamlPath) + "/**/*.yaml",
+      import_path.default.dirname(this.options.viewsYamlPath) + "/**/*.yml"
+    ];
+    this.watcher = (0, import_chokidar.watch)(patterns, {
+      cwd: this.options.cwd,
+      ignoreInitial: true
+    });
+    this.watcher.on("change", (filePath) => {
+      logger.debug("yaml file changed", { filePath });
+      this.change$.next(filePath);
+    });
+    this.change$.pipe(
+      (0, import_rxjs.debounceTime)(100),
+      (0, import_rxjs.switchMap)((filePath) => (0, import_rxjs.from)(this.regenerate(filePath)))
+    ).subscribe({
+      error: (err) => {
+        logger.error("yaml watcher pipeline error", { error: String(err) });
+      }
+    });
+  }
+  stop() {
+    this.watcher?.close();
+    this.change$.complete();
+  }
+  isOperationsYaml(filePath) {
+    const opsDir = import_path.default.dirname(this.options.operationsYamlPath);
+    return filePath.startsWith(opsDir) || filePath === this.options.operationsYamlPath;
+  }
+  isViewsYaml(filePath) {
+    const viewsDir = import_path.default.dirname(this.options.viewsYamlPath);
+    return filePath.startsWith(viewsDir) || filePath === this.options.viewsYamlPath;
+  }
+  async regenerate(filePath) {
+    try {
+      if (this.isOperationsYaml(filePath)) {
+        const opsContent = (0, import_fs.readFileSync)(
+          import_path.default.resolve(this.options.cwd, this.options.operationsYamlPath),
+          "utf-8"
+        );
+        const operations = (0, import_operations_parser.parseOperations)(opsContent);
+        (0, import_fs.writeFileSync)(
+          import_path.default.join(this.options.outDir, "preload.generated.ts"),
+          (0, import_preload_generator.generatePreload)(operations)
+        );
+        (0, import_fs.writeFileSync)(
+          import_path.default.join(this.options.outDir, "wood.d.ts"),
+          (0, import_type_generator.generateTypes)(operations)
+        );
+        (0, import_fs.writeFileSync)(
+          import_path.default.join(this.options.outDir, "wood.mock.ts"),
+          (0, import_test_mock_generator.generateTestMock)(operations)
+        );
+        const controllersDir = import_path.default.resolve(this.options.cwd, this.options.controllersDir);
+        (0, import_fs.writeFileSync)(
+          import_path.default.join(this.options.outDir, "controllers.generated.ts"),
+          (0, import_controller_registration_generator.generateControllerRegistration)(operations, {
+            controllersDir,
+            outDir: this.options.outDir
+          })
+        );
+        (0, import_fs.writeFileSync)(
+          import_path.default.join(this.options.outDir, "runtime.generated.ts"),
+          (0, import_runtime_generator.generateRuntime)(operations, {
+            controllersDir,
+            outDir: this.options.outDir
+          })
+        );
+        logger.info("operations codegen regenerated");
+      }
+      if (this.isViewsYaml(filePath)) {
+        if (this.options.onViewsChange) {
+          await this.options.onViewsChange();
+        }
+        logger.info("views manifest regenerated");
+      }
+    } catch (err) {
+      logger.error("yaml regeneration failed", { error: String(err) });
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  YamlWatcher
+});
+//# sourceMappingURL=yaml_watcher.cjs.map

package/dist/dev/yaml_watcher.cjs.map

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

package/dist/dev/yaml_watcher.d.cts

@@ -0,0 +1,22 @@
+interface YamlWatcherOptions {
+    operationsYamlPath: string;
+    viewsYamlPath: string;
+    controllersDir: string;
+    outDir: string;
+    cwd: string;
+    /** Called after views YAML changes to regenerate the client router manifest. */
+    onViewsChange?: () => Promise<void>;
+}
+declare class YamlWatcher {
+    private options;
+    private watcher;
+    private change$;
+    constructor(options: YamlWatcherOptions);
+    start(): void;
+    stop(): void;
+    private isOperationsYaml;
+    private isViewsYaml;
+    private regenerate;
+}
+
+export { YamlWatcher, type YamlWatcherOptions };

package/dist/dev/yaml_watcher.d.ts

@@ -0,0 +1,22 @@
+interface YamlWatcherOptions {
+    operationsYamlPath: string;
+    viewsYamlPath: string;
+    controllersDir: string;
+    outDir: string;
+    cwd: string;
+    /** Called after views YAML changes to regenerate the client router manifest. */
+    onViewsChange?: () => Promise<void>;
+}
+declare class YamlWatcher {
+    private options;
+    private watcher;
+    private change$;
+    constructor(options: YamlWatcherOptions);
+    start(): void;
+    stop(): void;
+    private isOperationsYaml;
+    private isViewsYaml;
+    private regenerate;
+}
+
+export { YamlWatcher, type YamlWatcherOptions };

package/dist/dev/yaml_watcher.js

@@ -0,0 +1,108 @@
+import { watch } from "chokidar";
+import { Subject, debounceTime, switchMap, from } from "rxjs";
+import { readFileSync, writeFileSync } from "fs";
+import path from "path";
+import { getLogger } from "@noego/logger";
+import { parseOperations } from "../parser/operations_parser.js";
+import { generatePreload } from "../codegen/preload_generator.js";
+import { generateTypes } from "../codegen/type_generator.js";
+import { generateTestMock } from "../codegen/test_mock_generator.js";
+import { generateControllerRegistration } from "../codegen/controller_registration_generator.js";
+import { generateRuntime } from "../codegen/runtime_generator.js";
+const logger = getLogger("wood:dev:yaml-watcher");
+class YamlWatcher {
+  constructor(options) {
+    this.options = options;
+    this.watcher = null;
+    this.change$ = new Subject();
+  }
+  start() {
+    const patterns = [
+      this.options.operationsYamlPath,
+      this.options.viewsYamlPath,
+      path.dirname(this.options.operationsYamlPath) + "/**/*.yaml",
+      path.dirname(this.options.operationsYamlPath) + "/**/*.yml",
+      path.dirname(this.options.viewsYamlPath) + "/**/*.yaml",
+      path.dirname(this.options.viewsYamlPath) + "/**/*.yml"
+    ];
+    this.watcher = watch(patterns, {
+      cwd: this.options.cwd,
+      ignoreInitial: true
+    });
+    this.watcher.on("change", (filePath) => {
+      logger.debug("yaml file changed", { filePath });
+      this.change$.next(filePath);
+    });
+    this.change$.pipe(
+      debounceTime(100),
+      switchMap((filePath) => from(this.regenerate(filePath)))
+    ).subscribe({
+      error: (err) => {
+        logger.error("yaml watcher pipeline error", { error: String(err) });
+      }
+    });
+  }
+  stop() {
+    this.watcher?.close();
+    this.change$.complete();
+  }
+  isOperationsYaml(filePath) {
+    const opsDir = path.dirname(this.options.operationsYamlPath);
+    return filePath.startsWith(opsDir) || filePath === this.options.operationsYamlPath;
+  }
+  isViewsYaml(filePath) {
+    const viewsDir = path.dirname(this.options.viewsYamlPath);
+    return filePath.startsWith(viewsDir) || filePath === this.options.viewsYamlPath;
+  }
+  async regenerate(filePath) {
+    try {
+      if (this.isOperationsYaml(filePath)) {
+        const opsContent = readFileSync(
+          path.resolve(this.options.cwd, this.options.operationsYamlPath),
+          "utf-8"
+        );
+        const operations = parseOperations(opsContent);
+        writeFileSync(
+          path.join(this.options.outDir, "preload.generated.ts"),
+          generatePreload(operations)
+        );
+        writeFileSync(
+          path.join(this.options.outDir, "wood.d.ts"),
+          generateTypes(operations)
+        );
+        writeFileSync(
+          path.join(this.options.outDir, "wood.mock.ts"),
+          generateTestMock(operations)
+        );
+        const controllersDir = path.resolve(this.options.cwd, this.options.controllersDir);
+        writeFileSync(
+          path.join(this.options.outDir, "controllers.generated.ts"),
+          generateControllerRegistration(operations, {
+            controllersDir,
+            outDir: this.options.outDir
+          })
+        );
+        writeFileSync(
+          path.join(this.options.outDir, "runtime.generated.ts"),
+          generateRuntime(operations, {
+            controllersDir,
+            outDir: this.options.outDir
+          })
+        );
+        logger.info("operations codegen regenerated");
+      }
+      if (this.isViewsYaml(filePath)) {
+        if (this.options.onViewsChange) {
+          await this.options.onViewsChange();
+        }
+        logger.info("views manifest regenerated");
+      }
+    } catch (err) {
+      logger.error("yaml regeneration failed", { error: String(err) });
+    }
+  }
+}
+export {
+  YamlWatcher
+};
+//# sourceMappingURL=yaml_watcher.js.map

package/dist/dev/yaml_watcher.js.map

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

package/dist/electron/index.cjs

@@ -0,0 +1,176 @@
+"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 electron_exports = {};
+__export(electron_exports, {
+  BrowserWindow: () => BrowserWindow,
+  Menu: () => Menu,
+  MenuItem: () => MenuItem,
+  Tray: () => Tray,
+  app: () => app,
+  bridgeCall: () => bridgeCall,
+  dialog: () => dialog,
+  globalShortcut: () => globalShortcut,
+  isForkProcess: () => isForkProcess,
+  isMainProcess: () => isMainProcess,
+  nativeTheme: () => nativeTheme,
+  safeStorage: () => safeStorage,
+  shell: () => shell
+});
+module.exports = __toCommonJS(electron_exports);
+var import_logger = require("@noego/logger");
+const logger = (0, import_logger.getLogger)("wood:electron");
+const isElectronMain = !!(typeof process !== "undefined" && process.versions && process.versions.electron && typeof process.send === "undefined");
+const pendingCalls = /* @__PURE__ */ new Map();
+let callId = 0;
+function bridgeCall(api, args) {
+  if (isElectronMain) {
+    throw new Error("bridgeCall should not be used in Electron main process");
+  }
+  const id = `electron-api-${++callId}`;
+  return new Promise((resolve, reject) => {
+    pendingCalls.set(id, { resolve, reject });
+    const message = {
+      type: "electron-api",
+      id,
+      api,
+      args: args !== void 0 ? [args] : []
+    };
+    process.send(message);
+    logger.debug(`bridge call ${id}: ${api}`);
+  });
+}
+if (!isElectronMain && typeof process.on === "function") {
+  process.on("message", (msg) => {
+    const m = msg;
+    if (m?.type === "electron-api-response" && typeof m.id === "string") {
+      const pending = pendingCalls.get(m.id);
+      if (pending) {
+        pendingCalls.delete(m.id);
+        if (m.error) {
+          const err = m.error;
+          pending.reject(new Error(err.message ?? "Electron API error"));
+        } else {
+          pending.resolve(m.result);
+        }
+      }
+    }
+  });
+}
+const pathCache = /* @__PURE__ */ new Map();
+let _dialog;
+let _shell;
+let _safeStorage;
+let _nativeTheme;
+let _app;
+let _globalShortcut;
+let _Tray;
+let _Menu;
+let _MenuItem;
+let _BrowserWindow;
+if (isElectronMain) {
+  const electron = require("electron");
+  _dialog = electron.dialog;
+  _shell = electron.shell;
+  _safeStorage = electron.safeStorage;
+  _nativeTheme = electron.nativeTheme;
+  _app = electron.app;
+  _globalShortcut = electron.globalShortcut;
+  _Tray = electron.Tray;
+  _Menu = electron.Menu;
+  _MenuItem = electron.MenuItem;
+  _BrowserWindow = electron.BrowserWindow;
+  logger.info("using real Electron APIs (main process)");
+} else {
+  _dialog = {
+    showOpenDialog: (options) => bridgeCall("dialog.showOpenDialog", options),
+    showSaveDialog: (options) => bridgeCall("dialog.showSaveDialog", options),
+    showMessageBox: (options) => bridgeCall("dialog.showMessageBox", options)
+  };
+  _shell = {
+    openExternal: (url) => bridgeCall("shell.openExternal", url),
+    openPath: (p) => bridgeCall("shell.openPath", p)
+  };
+  _safeStorage = {
+    encryptString: (str) => bridgeCall("safeStorage.encryptString", str),
+    decryptString: (buf) => bridgeCall("safeStorage.decryptString", buf),
+    isEncryptionAvailable: () => bridgeCall("safeStorage.isEncryptionAvailable")
+  };
+  _nativeTheme = {
+    get shouldUseDarkColors() {
+      return bridgeCall("nativeTheme.shouldUseDarkColors");
+    }
+  };
+  _app = {
+    getPath: (name) => {
+      if (pathCache.has(name)) {
+        return Promise.resolve(pathCache.get(name));
+      }
+      return bridgeCall("app.getPath", name);
+    },
+    /** Allow shell to populate path cache at startup */
+    __setPathCache: (paths) => {
+      for (const [name, value] of Object.entries(paths)) {
+        pathCache.set(name, value);
+      }
+    }
+  };
+  _globalShortcut = {
+    register: (accelerator, _callback) => bridgeCall("globalShortcut.register", accelerator),
+    unregister: (accelerator) => bridgeCall("globalShortcut.unregister", accelerator),
+    unregisterAll: () => bridgeCall("globalShortcut.unregisterAll")
+  };
+  _Tray = null;
+  _Menu = null;
+  _MenuItem = null;
+  _BrowserWindow = null;
+  logger.info("using bridge proxies (fork process)");
+}
+const dialog = _dialog;
+const shell = _shell;
+const safeStorage = _safeStorage;
+const nativeTheme = _nativeTheme;
+const app = _app;
+const globalShortcut = _globalShortcut;
+const Tray = _Tray;
+const Menu = _Menu;
+const MenuItem = _MenuItem;
+const BrowserWindow = _BrowserWindow;
+function isMainProcess() {
+  return isElectronMain;
+}
+function isForkProcess() {
+  return !isElectronMain && typeof process.send === "function";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BrowserWindow,
+  Menu,
+  MenuItem,
+  Tray,
+  app,
+  bridgeCall,
+  dialog,
+  globalShortcut,
+  isForkProcess,
+  isMainProcess,
+  nativeTheme,
+  safeStorage,
+  shell
+});
+//# sourceMappingURL=index.cjs.map

package/dist/electron/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/electron/index.ts"],"sourcesContent":["/**\n * @noego/wood/electron — Runtime-adaptive Electron API exports\n *\n * In production (single Electron process): re-exports real Electron APIs\n * In dev split-serve (Node.js fork): exports proxies that call through the bridge\n *\n * Controllers import from '@noego/wood/electron' and get the right implementation.\n */\n\nimport { getLogger } from '@noego/logger';\nimport type { BridgeElectronApi } from '../types/bridge.js';\n\nconst logger = getLogger('wood:electron');\n\n// Detection: real Electron main = has electron version AND no parent IPC (process.send)\nconst isElectronMain = !!(\n  typeof process !== 'undefined' &&\n  process.versions &&\n  (process.versions as Record<string, string | undefined>).electron &&\n  typeof process.send === 'undefined'\n);\n\n// ---- Bridge call helper for Node.js fork mode ----\n\nconst pendingCalls = new Map<string, { resolve: (v: unknown) => void; reject: (e: Error) => void }>();\nlet callId = 0;\n\n/**\n * Send an Electron API call through the bridge to the shell process.\n * Only valid in Node.js fork mode (dev split-serve).\n */\nexport function bridgeCall(api: string, args?: unknown): Promise<unknown> {\n  if (isElectronMain) {\n    throw new Error('bridgeCall should not be used in Electron main process');\n  }\n\n  const id = `electron-api-${++callId}`;\n  return new Promise((resolve, reject) => {\n    pendingCalls.set(id, { resolve, reject });\n\n    const message: BridgeElectronApi = {\n      type: 'electron-api',\n      id,\n      api,\n      args: args !== undefined ? [args] : [],\n    };\n\n    process.send!(message);\n    logger.debug(`bridge call ${id}: ${api}`);\n  });\n}\n\n// Handle bridge responses in fork mode\nif (!isElectronMain && typeof process.on === 'function') {\n  process.on('message', (msg: unknown) => {\n    const m = msg as Record<string, unknown> | null;\n    if (m?.type === 'electron-api-response' && typeof m.id === 'string') {\n      const pending = pendingCalls.get(m.id);\n      if (pending) {\n        pendingCalls.delete(m.id);\n        if (m.error) {\n          const err = m.error as { message?: string };\n          pending.reject(new Error(err.message ?? 'Electron API error'));\n        } else {\n          pending.resolve(m.result);\n        }\n      }\n    }\n  });\n}\n\n// ---- Path cache for app.getPath optimization ----\n\nconst pathCache = new Map<string, string>();\n\n// ---- Exports ----\n\nlet _dialog: any;\nlet _shell: any;\nlet _safeStorage: any;\nlet _nativeTheme: any;\nlet _app: any;\nlet _globalShortcut: any;\nlet _Tray: any;\nlet _Menu: any;\nlet _MenuItem: any;\nlet _BrowserWindow: any;\n\nif (isElectronMain) {\n  // Production: re-export real Electron\n  const electron = require('electron');\n  _dialog = electron.dialog;\n  _shell = electron.shell;\n  _safeStorage = electron.safeStorage;\n  _nativeTheme = electron.nativeTheme;\n  _app = electron.app;\n  _globalShortcut = electron.globalShortcut;\n  _Tray = electron.Tray;\n  _Menu = electron.Menu;\n  _MenuItem = electron.MenuItem;\n  _BrowserWindow = electron.BrowserWindow;\n\n  logger.info('using real Electron APIs (main process)');\n} else {\n  // Dev fork: export proxies\n  _dialog = {\n    showOpenDialog: (options: unknown) => bridgeCall('dialog.showOpenDialog', options),\n    showSaveDialog: (options: unknown) => bridgeCall('dialog.showSaveDialog', options),\n    showMessageBox: (options: unknown) => bridgeCall('dialog.showMessageBox', options),\n  };\n\n  _shell = {\n    openExternal: (url: string) => bridgeCall('shell.openExternal', url),\n    openPath: (p: string) => bridgeCall('shell.openPath', p),\n  };\n\n  _safeStorage = {\n    encryptString: (str: string) => bridgeCall('safeStorage.encryptString', str),\n    decryptString: (buf: unknown) => bridgeCall('safeStorage.decryptString', buf),\n    isEncryptionAvailable: () => bridgeCall('safeStorage.isEncryptionAvailable'),\n  };\n\n  _nativeTheme = {\n    get shouldUseDarkColors() {\n      // Note: async in proxy mode, unlike the sync Electron API\n      return bridgeCall('nativeTheme.shouldUseDarkColors');\n    },\n  };\n\n  _app = {\n    getPath: (name: string) => {\n      // Check cache first (pre-resolved by shell at startup)\n      if (pathCache.has(name)) {\n        return Promise.resolve(pathCache.get(name));\n      }\n      return bridgeCall('app.getPath', name);\n    },\n    /** Allow shell to populate path cache at startup */\n    __setPathCache: (paths: Record<string, string>) => {\n      for (const [name, value] of Object.entries(paths)) {\n        pathCache.set(name, value);\n      }\n    },\n  };\n\n  _globalShortcut = {\n    register: (accelerator: string, _callback: () => void) =>\n      bridgeCall('globalShortcut.register', accelerator),\n    unregister: (accelerator: string) =>\n      bridgeCall('globalShortcut.unregister', accelerator),\n    unregisterAll: () => bridgeCall('globalShortcut.unregisterAll'),\n  };\n\n  // These classes require direct Electron main process access and are not\n  // proxiable in fork mode.\n  _Tray = null;\n  _Menu = null;\n  _MenuItem = null;\n  _BrowserWindow = null;\n\n  logger.info('using bridge proxies (fork process)');\n}\n\nexport const dialog = _dialog;\nexport const shell = _shell;\nexport const safeStorage = _safeStorage;\nexport const nativeTheme = _nativeTheme;\nexport const app = _app;\nexport const globalShortcut = _globalShortcut;\nexport const Tray = _Tray;\nexport const Menu = _Menu;\nexport const MenuItem = _MenuItem;\nexport const BrowserWindow = _BrowserWindow;\n\n/** Check if running in real Electron main process */\nexport function isMainProcess(): boolean {\n  return isElectronMain;\n}\n\n/** Check if running in Node.js fork (dev split-serve) */\nexport function isForkProcess(): boolean {\n  return !isElectronMain && typeof process.send === 'function';\n}\n"],"mappings":"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","names":[]}

package/dist/electron/index.d.cts

@@ -0,0 +1,29 @@
+/**
+ * @noego/wood/electron — Runtime-adaptive Electron API exports
+ *
+ * In production (single Electron process): re-exports real Electron APIs
+ * In dev split-serve (Node.js fork): exports proxies that call through the bridge
+ *
+ * Controllers import from '@noego/wood/electron' and get the right implementation.
+ */
+/**
+ * Send an Electron API call through the bridge to the shell process.
+ * Only valid in Node.js fork mode (dev split-serve).
+ */
+declare function bridgeCall(api: string, args?: unknown): Promise<unknown>;
+declare const dialog: any;
+declare const shell: any;
+declare const safeStorage: any;
+declare const nativeTheme: any;
+declare const app: any;
+declare const globalShortcut: any;
+declare const Tray: any;
+declare const Menu: any;
+declare const MenuItem: any;
+declare const BrowserWindow: any;
+/** Check if running in real Electron main process */
+declare function isMainProcess(): boolean;
+/** Check if running in Node.js fork (dev split-serve) */
+declare function isForkProcess(): boolean;
+
+export { BrowserWindow, Menu, MenuItem, Tray, app, bridgeCall, dialog, globalShortcut, isForkProcess, isMainProcess, nativeTheme, safeStorage, shell };

package/dist/electron/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @noego/wood/electron — Runtime-adaptive Electron API exports
+ *
+ * In production (single Electron process): re-exports real Electron APIs
+ * In dev split-serve (Node.js fork): exports proxies that call through the bridge
+ *
+ * Controllers import from '@noego/wood/electron' and get the right implementation.
+ */
+/**
+ * Send an Electron API call through the bridge to the shell process.
+ * Only valid in Node.js fork mode (dev split-serve).
+ */
+declare function bridgeCall(api: string, args?: unknown): Promise<unknown>;
+declare const dialog: any;
+declare const shell: any;
+declare const safeStorage: any;
+declare const nativeTheme: any;
+declare const app: any;
+declare const globalShortcut: any;
+declare const Tray: any;
+declare const Menu: any;
+declare const MenuItem: any;
+declare const BrowserWindow: any;
+/** Check if running in real Electron main process */
+declare function isMainProcess(): boolean;
+/** Check if running in Node.js fork (dev split-serve) */
+declare function isForkProcess(): boolean;
+
+export { BrowserWindow, Menu, MenuItem, Tray, app, bridgeCall, dialog, globalShortcut, isForkProcess, isMainProcess, nativeTheme, safeStorage, shell };