@noego/wood 0.4.9 → 0.5.0

package/dist/dev/wood_dev_server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/dev/wood_dev_server.ts"],"sourcesContent":["import { readFileSync, writeFileSync, mkdirSync } from 'fs';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\nimport { parseConfig } from '../config/config_parser.js';\nimport { parseOperations } from '../parser/operations_parser.js';\nimport { parseViews } from '../parser/views_parser.js';\nimport { generatePreload } from '../codegen/preload_generator.js';\nimport { generateTypes } from '../codegen/type_generator.js';\nimport { generateTestMock } from '../codegen/test_mock_generator.js';\nimport { generateControllerRegistration } from '../codegen/controller_registration_generator.js';\nimport { generateRuntime } from '../codegen/runtime_generator.js';\nimport { generateRendererApp } from '../codegen/renderer_app_generator.js';\nimport { BackendBridge } from '../bridge/backend_bridge.js';\nimport { BackendWatcher } from './backend_watcher.js';\nimport { YamlWatcher } from './yaml_watcher.js';\nimport { EsbuildBackend } from './esbuild_backend.js';\nimport type { WoodConfig } from '../types/index.js';\n\nconst logger = getLogger('wood:dev');\n\nexport interface DevServerOptions {\n  configPath?: string;\n  cwd?: string;\n}\n\nexport class WoodDevServer {\n  private config: WoodConfig | null = null;\n  private bridge: BackendBridge | null = null;\n  private backendWatcher: BackendWatcher | null = null;\n  private yamlWatcher: YamlWatcher | null = null;\n  private esbuild: EsbuildBackend | null = null;\n  private cwd: string;\n\n  constructor(options: DevServerOptions = {}) {\n    this.cwd = options.cwd ?? process.cwd();\n  }\n\n  /**\n   * Start the Wood development server.\n   *\n   * Automatically sets process.env.WOOD_MODE = 'development' so the app\n   * can conditionally use dynamic controller imports (dev) vs pre-registered\n   * controllers from the generated file (production).\n   *\n   * Steps:\n   * 1. Parse config\n   * 2. Parse + stitch YAML\n   * 3. Generate preload, types, mock\n   * 4. Build backend with esbuild\n   * 5. (electron-vite would be started here -- omitted for MVP)\n   * 6. Spawn backend via bridge\n   * 7. Start watchers\n   */\n  async start(): Promise<void> {\n    process.env.WOOD_MODE = 'development';\n\n    // 1. Parse config\n    const configPath = path.resolve(this.cwd, 'wood.config.yml');\n    this.config = parseConfig(configPath);\n    logger.info('config loaded', { outDir: this.config.outDir });\n\n    // 2. Parse operations YAML\n    const opsYamlPath = path.resolve(this.cwd, this.config.main.openapi);\n    const opsContent = readFileSync(opsYamlPath, 'utf-8');\n    const operations = parseOperations(opsContent);\n    logger.info('operations parsed', { count: operations.size });\n\n    // 3. Parse views YAML\n    const viewsYamlPath = path.resolve(this.cwd, this.config.renderer.openapi);\n    const viewsContent = readFileSync(viewsYamlPath, 'utf-8');\n    const views = parseViews(viewsContent);\n    logger.info('views parsed', { count: views.length });\n\n    // 4. Generate files\n    const outDir = path.resolve(this.cwd, this.config.outDir);\n    mkdirSync(outDir, { recursive: true });\n\n    const preloadCode = generatePreload(operations);\n    writeFileSync(path.join(outDir, 'preload.generated.ts'), preloadCode);\n\n    const typesCode = generateTypes(operations);\n    writeFileSync(path.join(outDir, 'wood.d.ts'), typesCode);\n\n    const mockCode = generateTestMock(operations);\n    writeFileSync(path.join(outDir, 'wood.mock.ts'), mockCode);\n\n    const controllersDir = path.resolve(this.cwd, this.config.main.controllers);\n    const controllerRegCode = generateControllerRegistration(operations, {\n      controllersDir,\n      outDir,\n    });\n    writeFileSync(path.join(outDir, 'controllers.generated.ts'), controllerRegCode);\n\n    const runtimeCode = generateRuntime(operations, {\n      controllersDir,\n      outDir,\n    });\n    writeFileSync(path.join(outDir, 'runtime.generated.ts'), runtimeCode);\n\n    const rendererComponentDir = path.resolve(this.cwd, this.config.renderer.componentDir);\n    const rendererOutDir = path.resolve(this.cwd, this.config.renderer.componentDir, 'generated');\n    mkdirSync(rendererOutDir, { recursive: true });\n\n    writeFileSync(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":[]}
+{"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.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      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":[]}

package/dist/dev/yaml_watcher.cjs

@@ -98,7 +98,7 @@ class YamlWatcher {
         const typesCode = (0, import_type_generator.generateTypes)(operations);
         (0, import_fs.writeFileSync)(
           import_path.default.join(this.options.outDir, "preload.generated.ts"),
-          (0, import_preload_generator.generatePreload)(operations)
+          (0, import_preload_generator.generatePreload)(operations, { traceBatching: this.options.traceBatching })
         );
         (0, import_fs.writeFileSync)(
           import_path.default.join(this.options.outDir, "wood.d.ts"),

package/dist/dev/yaml_watcher.cjs.map

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

package/dist/dev/yaml_watcher.d.cts

@@ -1,3 +1,5 @@
+import { RendererTraceBatchingConfig } from '../types/config.cjs';
+
 interface YamlWatcherOptions {
     operationsYamlPath: string;
     viewsYamlPath: string;
@@ -5,6 +7,8 @@ interface YamlWatcherOptions {
     outDir: string;
     rendererOutDir?: string;
     cwd: string;
+    /** Resolved renderer→main trace batching policy for preload generation. */
+    traceBatching?: RendererTraceBatchingConfig;
     /** Called after views YAML changes to regenerate the client router manifest. */
     onViewsChange?: () => Promise<void>;
 }

package/dist/dev/yaml_watcher.d.ts

@@ -1,3 +1,5 @@
+import { RendererTraceBatchingConfig } from '../types/config.js';
+
 interface YamlWatcherOptions {
     operationsYamlPath: string;
     viewsYamlPath: string;
@@ -5,6 +7,8 @@ interface YamlWatcherOptions {
     outDir: string;
     rendererOutDir?: string;
     cwd: string;
+    /** Resolved renderer→main trace batching policy for preload generation. */
+    traceBatching?: RendererTraceBatchingConfig;
     /** Called after views YAML changes to regenerate the client router manifest. */
     onViewsChange?: () => Promise<void>;
 }

package/dist/dev/yaml_watcher.js

@@ -65,7 +65,7 @@ class YamlWatcher {
         const typesCode = generateTypes(operations);
         writeFileSync(
           path.join(this.options.outDir, "preload.generated.ts"),
-          generatePreload(operations)
+          generatePreload(operations, { traceBatching: this.options.traceBatching })
         );
         writeFileSync(
           path.join(this.options.outDir, "wood.d.ts"),

package/dist/dev/yaml_watcher.js.map

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

package/dist/frontend/frontend_lifecycle.cjs

@@ -0,0 +1,74 @@
+"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 frontend_lifecycle_exports = {};
+__export(frontend_lifecycle_exports, {
+  FrontendLifecycleOwner: () => FrontendLifecycleOwner
+});
+module.exports = __toCommonJS(frontend_lifecycle_exports);
+var import_work_registry = require("./work_registry.js");
+class FrontendLifecycleOwner {
+  constructor(registry, owner) {
+    this.registry = registry;
+    this.owner = owner;
+    this.abortController = new AbortController();
+    this.resources = [];
+    this.disposed = false;
+  }
+  get signal() {
+    return this.abortController.signal;
+  }
+  track(work, options) {
+    if (this.disposed) {
+      throw new import_work_registry.FrontendWorkError(
+        `cannot track "${options.label}": lifecycle "${this.owner}" is disposed. Work started after a page/environment ended is a product lifecycle bug.`
+      );
+    }
+    return this.registry.track(work, {
+      label: options.label,
+      kind: options.kind ?? "tracked",
+      owner: this.owner
+    });
+  }
+  own(resource) {
+    if (this.disposed) {
+      throw new import_work_registry.FrontendWorkError(
+        `cannot own a resource: lifecycle "${this.owner}" is disposed.`
+      );
+    }
+    this.resources.push(resource);
+  }
+  get isDisposed() {
+    return this.disposed;
+  }
+  /** Abort owned work and dispose owned resources in reverse order. */
+  async dispose() {
+    if (this.disposed) return;
+    this.disposed = true;
+    this.abortController.abort();
+    for (const resource of this.resources.reverse()) {
+      await resource.dispose();
+    }
+    this.resources.length = 0;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FrontendLifecycleOwner
+});
+//# sourceMappingURL=frontend_lifecycle.cjs.map

package/dist/frontend/frontend_lifecycle.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/frontend/frontend_lifecycle.ts"],"sourcesContent":["/**\n * Production lifecycle owners for deliberately detached frontend work\n * (18A D-FAS-01 §2.2). Two natural owners exist per environment:\n *\n *   page lifecycle         — default for PageController work; aborted and\n *                            disposed when that page ends\n *   application lifecycle  — explicit for work that intentionally survives\n *                            page navigation; disposed with the environment\n *\n * PageControllers/client services register their own deliberately detached\n * finite work through their injected lifecycle owner — tests do not repair\n * unowned product code by wrapping it in track() from the outside.\n */\nimport { WorkRegistry, FrontendWorkError } from './work_registry.js';\n\nexport interface FrontendLifecycle {\n  readonly signal: AbortSignal;\n\n  track<T>(\n    work: Promise<T>,\n    options: {\n      label: string;\n      kind?: string;\n    },\n  ): Promise<T>;\n\n  own(resource: { dispose(): void | Promise<void> }): void;\n}\n\nexport class FrontendLifecycleOwner implements FrontendLifecycle {\n  private readonly abortController = new AbortController();\n  private readonly resources: Array<{ dispose(): void | Promise<void> }> = [];\n  private disposed = false;\n\n  constructor(\n    private readonly registry: WorkRegistry,\n    /** Diagnostic owner identity, e.g. `page main.chat_dom` or `application`. */\n    readonly owner: string,\n  ) {}\n\n  get signal(): AbortSignal {\n    return this.abortController.signal;\n  }\n\n  track<T>(work: Promise<T>, options: { label: string; kind?: string }): Promise<T> {\n    if (this.disposed) {\n      throw new FrontendWorkError(\n        `cannot track \"${options.label}\": lifecycle \"${this.owner}\" is disposed. ` +\n        'Work started after a page/environment ended is a product lifecycle bug.',\n      );\n    }\n    return this.registry.track(work, {\n      label: options.label,\n      kind: options.kind ?? 'tracked',\n      owner: this.owner,\n    });\n  }\n\n  own(resource: { dispose(): void | Promise<void> }): void {\n    if (this.disposed) {\n      throw new FrontendWorkError(\n        `cannot own a resource: lifecycle \"${this.owner}\" is disposed.`,\n      );\n    }\n    this.resources.push(resource);\n  }\n\n  get isDisposed(): boolean {\n    return this.disposed;\n  }\n\n  /** Abort owned work and dispose owned resources in reverse order. */\n  async dispose(): Promise<void> {\n    if (this.disposed) return;\n    this.disposed = true;\n    this.abortController.abort();\n    for (const resource of this.resources.reverse()) {\n      await resource.dispose();\n    }\n    this.resources.length = 0;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,2BAAgD;AAgBzC,MAAM,uBAAoD;AAAA,EAK/D,YACmB,UAER,OACT;AAHiB;AAER;AAPX,SAAiB,kBAAkB,IAAI,gBAAgB;AACvD,SAAiB,YAAwD,CAAC;AAC1E,SAAQ,WAAW;AAAA,EAMhB;AAAA,EAEH,IAAI,SAAsB;AACxB,WAAO,KAAK,gBAAgB;AAAA,EAC9B;AAAA,EAEA,MAAS,MAAkB,SAAuD;AAChF,QAAI,KAAK,UAAU;AACjB,YAAM,IAAI;AAAA,QACR,iBAAiB,QAAQ,KAAK,iBAAiB,KAAK,KAAK;AAAA,MAE3D;AAAA,IACF;AACA,WAAO,KAAK,SAAS,MAAM,MAAM;AAAA,MAC/B,OAAO,QAAQ;AAAA,MACf,MAAM,QAAQ,QAAQ;AAAA,MACtB,OAAO,KAAK;AAAA,IACd,CAAC;AAAA,EACH;AAAA,EAEA,IAAI,UAAqD;AACvD,QAAI,KAAK,UAAU;AACjB,YAAM,IAAI;AAAA,QACR,qCAAqC,KAAK,KAAK;AAAA,MACjD;AAAA,IACF;AACA,SAAK,UAAU,KAAK,QAAQ;AAAA,EAC9B;AAAA,EAEA,IAAI,aAAsB;AACxB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,MAAM,UAAyB;AAC7B,QAAI,KAAK,SAAU;AACnB,SAAK,WAAW;AAChB,SAAK,gBAAgB,MAAM;AAC3B,eAAW,YAAY,KAAK,UAAU,QAAQ,GAAG;AAC/C,YAAM,SAAS,QAAQ;AAAA,IACzB;AACA,SAAK,UAAU,SAAS;AAAA,EAC1B;AACF;","names":[]}

package/dist/frontend/frontend_lifecycle.d.cts

@@ -0,0 +1,50 @@
+import { WorkRegistry } from './work_registry.cjs';
+
+/**
+ * Production lifecycle owners for deliberately detached frontend work
+ * (18A D-FAS-01 §2.2). Two natural owners exist per environment:
+ *
+ *   page lifecycle         — default for PageController work; aborted and
+ *                            disposed when that page ends
+ *   application lifecycle  — explicit for work that intentionally survives
+ *                            page navigation; disposed with the environment
+ *
+ * PageControllers/client services register their own deliberately detached
+ * finite work through their injected lifecycle owner — tests do not repair
+ * unowned product code by wrapping it in track() from the outside.
+ */
+
+interface FrontendLifecycle {
+    readonly signal: AbortSignal;
+    track<T>(work: Promise<T>, options: {
+        label: string;
+        kind?: string;
+    }): Promise<T>;
+    own(resource: {
+        dispose(): void | Promise<void>;
+    }): void;
+}
+declare class FrontendLifecycleOwner implements FrontendLifecycle {
+    private readonly registry;
+    /** Diagnostic owner identity, e.g. `page main.chat_dom` or `application`. */
+    readonly owner: string;
+    private readonly abortController;
+    private readonly resources;
+    private disposed;
+    constructor(registry: WorkRegistry, 
+    /** Diagnostic owner identity, e.g. `page main.chat_dom` or `application`. */
+    owner: string);
+    get signal(): AbortSignal;
+    track<T>(work: Promise<T>, options: {
+        label: string;
+        kind?: string;
+    }): Promise<T>;
+    own(resource: {
+        dispose(): void | Promise<void>;
+    }): void;
+    get isDisposed(): boolean;
+    /** Abort owned work and dispose owned resources in reverse order. */
+    dispose(): Promise<void>;
+}
+
+export { type FrontendLifecycle, FrontendLifecycleOwner };

package/dist/frontend/frontend_lifecycle.d.ts

@@ -0,0 +1,50 @@
+import { WorkRegistry } from './work_registry.js';
+
+/**
+ * Production lifecycle owners for deliberately detached frontend work
+ * (18A D-FAS-01 §2.2). Two natural owners exist per environment:
+ *
+ *   page lifecycle         — default for PageController work; aborted and
+ *                            disposed when that page ends
+ *   application lifecycle  — explicit for work that intentionally survives
+ *                            page navigation; disposed with the environment
+ *
+ * PageControllers/client services register their own deliberately detached
+ * finite work through their injected lifecycle owner — tests do not repair
+ * unowned product code by wrapping it in track() from the outside.
+ */
+
+interface FrontendLifecycle {
+    readonly signal: AbortSignal;
+    track<T>(work: Promise<T>, options: {
+        label: string;
+        kind?: string;
+    }): Promise<T>;
+    own(resource: {
+        dispose(): void | Promise<void>;
+    }): void;
+}
+declare class FrontendLifecycleOwner implements FrontendLifecycle {
+    private readonly registry;
+    /** Diagnostic owner identity, e.g. `page main.chat_dom` or `application`. */
+    readonly owner: string;
+    private readonly abortController;
+    private readonly resources;
+    private disposed;
+    constructor(registry: WorkRegistry, 
+    /** Diagnostic owner identity, e.g. `page main.chat_dom` or `application`. */
+    owner: string);
+    get signal(): AbortSignal;
+    track<T>(work: Promise<T>, options: {
+        label: string;
+        kind?: string;
+    }): Promise<T>;
+    own(resource: {
+        dispose(): void | Promise<void>;
+    }): void;
+    get isDisposed(): boolean;
+    /** Abort owned work and dispose owned resources in reverse order. */
+    dispose(): Promise<void>;
+}
+
+export { type FrontendLifecycle, FrontendLifecycleOwner };

package/dist/frontend/frontend_lifecycle.js

@@ -0,0 +1,50 @@
+import { FrontendWorkError } from "./work_registry.js";
+class FrontendLifecycleOwner {
+  constructor(registry, owner) {
+    this.registry = registry;
+    this.owner = owner;
+    this.abortController = new AbortController();
+    this.resources = [];
+    this.disposed = false;
+  }
+  get signal() {
+    return this.abortController.signal;
+  }
+  track(work, options) {
+    if (this.disposed) {
+      throw new FrontendWorkError(
+        `cannot track "${options.label}": lifecycle "${this.owner}" is disposed. Work started after a page/environment ended is a product lifecycle bug.`
+      );
+    }
+    return this.registry.track(work, {
+      label: options.label,
+      kind: options.kind ?? "tracked",
+      owner: this.owner
+    });
+  }
+  own(resource) {
+    if (this.disposed) {
+      throw new FrontendWorkError(
+        `cannot own a resource: lifecycle "${this.owner}" is disposed.`
+      );
+    }
+    this.resources.push(resource);
+  }
+  get isDisposed() {
+    return this.disposed;
+  }
+  /** Abort owned work and dispose owned resources in reverse order. */
+  async dispose() {
+    if (this.disposed) return;
+    this.disposed = true;
+    this.abortController.abort();
+    for (const resource of this.resources.reverse()) {
+      await resource.dispose();
+    }
+    this.resources.length = 0;
+  }
+}
+export {
+  FrontendLifecycleOwner
+};
+//# sourceMappingURL=frontend_lifecycle.js.map

package/dist/frontend/frontend_lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/frontend/frontend_lifecycle.ts"],"sourcesContent":["/**\n * Production lifecycle owners for deliberately detached frontend work\n * (18A D-FAS-01 §2.2). Two natural owners exist per environment:\n *\n *   page lifecycle         — default for PageController work; aborted and\n *                            disposed when that page ends\n *   application lifecycle  — explicit for work that intentionally survives\n *                            page navigation; disposed with the environment\n *\n * PageControllers/client services register their own deliberately detached\n * finite work through their injected lifecycle owner — tests do not repair\n * unowned product code by wrapping it in track() from the outside.\n */\nimport { WorkRegistry, FrontendWorkError } from './work_registry.js';\n\nexport interface FrontendLifecycle {\n  readonly signal: AbortSignal;\n\n  track<T>(\n    work: Promise<T>,\n    options: {\n      label: string;\n      kind?: string;\n    },\n  ): Promise<T>;\n\n  own(resource: { dispose(): void | Promise<void> }): void;\n}\n\nexport class FrontendLifecycleOwner implements FrontendLifecycle {\n  private readonly abortController = new AbortController();\n  private readonly resources: Array<{ dispose(): void | Promise<void> }> = [];\n  private disposed = false;\n\n  constructor(\n    private readonly registry: WorkRegistry,\n    /** Diagnostic owner identity, e.g. `page main.chat_dom` or `application`. */\n    readonly owner: string,\n  ) {}\n\n  get signal(): AbortSignal {\n    return this.abortController.signal;\n  }\n\n  track<T>(work: Promise<T>, options: { label: string; kind?: string }): Promise<T> {\n    if (this.disposed) {\n      throw new FrontendWorkError(\n        `cannot track \"${options.label}\": lifecycle \"${this.owner}\" is disposed. ` +\n        'Work started after a page/environment ended is a product lifecycle bug.',\n      );\n    }\n    return this.registry.track(work, {\n      label: options.label,\n      kind: options.kind ?? 'tracked',\n      owner: this.owner,\n    });\n  }\n\n  own(resource: { dispose(): void | Promise<void> }): void {\n    if (this.disposed) {\n      throw new FrontendWorkError(\n        `cannot own a resource: lifecycle \"${this.owner}\" is disposed.`,\n      );\n    }\n    this.resources.push(resource);\n  }\n\n  get isDisposed(): boolean {\n    return this.disposed;\n  }\n\n  /** Abort owned work and dispose owned resources in reverse order. */\n  async dispose(): Promise<void> {\n    if (this.disposed) return;\n    this.disposed = true;\n    this.abortController.abort();\n    for (const resource of this.resources.reverse()) {\n      await resource.dispose();\n    }\n    this.resources.length = 0;\n  }\n}\n"],"mappings":"AAaA,SAAuB,yBAAyB;AAgBzC,MAAM,uBAAoD;AAAA,EAK/D,YACmB,UAER,OACT;AAHiB;AAER;AAPX,SAAiB,kBAAkB,IAAI,gBAAgB;AACvD,SAAiB,YAAwD,CAAC;AAC1E,SAAQ,WAAW;AAAA,EAMhB;AAAA,EAEH,IAAI,SAAsB;AACxB,WAAO,KAAK,gBAAgB;AAAA,EAC9B;AAAA,EAEA,MAAS,MAAkB,SAAuD;AAChF,QAAI,KAAK,UAAU;AACjB,YAAM,IAAI;AAAA,QACR,iBAAiB,QAAQ,KAAK,iBAAiB,KAAK,KAAK;AAAA,MAE3D;AAAA,IACF;AACA,WAAO,KAAK,SAAS,MAAM,MAAM;AAAA,MAC/B,OAAO,QAAQ;AAAA,MACf,MAAM,QAAQ,QAAQ;AAAA,MACtB,OAAO,KAAK;AAAA,IACd,CAAC;AAAA,EACH;AAAA,EAEA,IAAI,UAAqD;AACvD,QAAI,KAAK,UAAU;AACjB,YAAM,IAAI;AAAA,QACR,qCAAqC,KAAK,KAAK;AAAA,MACjD;AAAA,IACF;AACA,SAAK,UAAU,KAAK,QAAQ;AAAA,EAC9B;AAAA,EAEA,IAAI,aAAsB;AACxB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,MAAM,UAAyB;AAC7B,QAAI,KAAK,SAAU;AACnB,SAAK,WAAW;AAChB,SAAK,gBAAgB,MAAM;AAC3B,eAAW,YAAY,KAAK,UAAU,QAAQ,GAAG;AAC/C,YAAM,SAAS,QAAQ;AAAA,IACzB;AACA,SAAK,UAAU,SAAS;AAAA,EAC1B;AACF;","names":[]}

package/dist/frontend/frontend_page.cjs

@@ -0,0 +1,122 @@
+"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 frontend_page_exports = {};
+__export(frontend_page_exports, {
+  createFrontendPage: () => createFrontendPage
+});
+module.exports = __toCommonJS(frontend_page_exports);
+var import_ioc = require("@noego/ioc");
+var import_work_registry = require("./work_registry.js");
+function bridgeSurface(surface, scope) {
+  if (!surface || typeof surface !== "object") return surface;
+  const wrapped = /* @__PURE__ */ new WeakMap();
+  return new Proxy(surface, {
+    get(target, property, receiver) {
+      const value = Reflect.get(target, property, receiver === void 0 ? target : target);
+      if (typeof value !== "function") return value;
+      const fn = value;
+      const cached = wrapped.get(fn);
+      if (cached) return cached;
+      const bridged = (...args) => import_ioc.ExecutionContext.current() !== void 0 ? fn.apply(target, args) : import_ioc.ExecutionContext.run(scope, () => fn.apply(target, args));
+      wrapped.set(fn, bridged);
+      return bridged;
+    }
+  });
+}
+function createFrontendPage(options) {
+  const { identity, controller, scope } = options;
+  let closed = false;
+  const bridgedInput = bridgeSurface(controller.input, scope);
+  const bridgedEvents = bridgeSurface(controller.events, scope);
+  const layouts = (options.layouts ?? []).map((mounted) => {
+    const layoutInput = bridgeSurface(mounted.instance.input, mounted.scope);
+    const layoutEvents = bridgeSurface(mounted.instance.events, mounted.scope);
+    return {
+      path: mounted.path,
+      controller: mounted.controller,
+      preserve: mounted.preserve,
+      get data() {
+        guard();
+        return mounted.instance.data;
+      },
+      get input() {
+        guard();
+        return layoutInput;
+      },
+      get events() {
+        guard();
+        return layoutEvents;
+      }
+    };
+  });
+  const guard = () => {
+    if (closed) {
+      throw new import_work_registry.FrontendWorkError(
+        `page "${identity}" is closed; a closed/navigated-away page handle must not be used. Re-open the page or use frontend.current().`
+      );
+    }
+  };
+  const page = {
+    identity,
+    get data() {
+      guard();
+      return controller.data;
+    },
+    get input() {
+      guard();
+      return bridgedInput;
+    },
+    get events() {
+      guard();
+      return bridgedEvents;
+    },
+    get layouts() {
+      guard();
+      return layouts;
+    },
+    get layout() {
+      guard();
+      if (layouts.length === 1) return layouts[0];
+      if (!layouts.length) {
+        throw new import_work_registry.FrontendWorkError(
+          `page "${identity}" mounts no layout controller; its views entry binds none.`
+        );
+      }
+      throw new import_work_registry.FrontendWorkError(
+        `page "${identity}" mounts ${layouts.length} layout controllers (${layouts.map((entry) => entry.controller).join(", ")}); use page.layouts and name the one you mean.`
+      );
+    },
+    close: async () => {
+      if (closed) return;
+      closed = true;
+      await options.onClose();
+    }
+  };
+  return {
+    page,
+    invalidate: () => {
+      closed = true;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createFrontendPage
+});
+//# sourceMappingURL=frontend_page.cjs.map

package/dist/frontend/frontend_page.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/frontend/frontend_page.ts"],"sourcesContent":["/**\n * The public frontend page projection (18A D-FAS-05).\n *\n * `FrontendPage` exposes the production `data / input / events` contract of\n * the selected PageController — never the controller instance itself, never\n * private or IoC-only members. References are not cloned (reactivity is\n * preserved); `input`/`events` handlers are bridged so they execute under\n * the page scope's IoC execution context, exactly as the production\n * renderer runtime invokes them (they are plain data properties holding\n * arrow functions, which would otherwise run context-less from a test).\n */\nimport { ExecutionContext } from '@noego/ioc';\nimport { FrontendWorkError } from './work_registry.js';\n\n/**\n * The public projection of one mounted LAYOUT controller (18A D-FAS-05).\n *\n * Layout controllers are production page members — the views YAML binds\n * them, the renderer mounts them alongside the view controller, and a\n * `preserve: true` layout outlives page transitions. They therefore expose\n * the same public `data / input / events` contract as the page controller,\n * never their instance.\n */\nexport interface FrontendLayout<Data = unknown, Input = unknown, Events = unknown> {\n  /** The layout view path as declared in the views source. */\n  readonly path: string;\n  /** The layout controller identity as declared in the views source. */\n  readonly controller: string;\n  /** Whether the views source declares this layout preservable. */\n  readonly preserve: boolean;\n  readonly data: Data;\n  readonly input: Input;\n  readonly events: Events | undefined;\n}\n\nexport interface FrontendPage<Data = unknown, Input = unknown, Events = unknown> {\n  /** Canonical `window.page` production identity. */\n  readonly identity: string;\n  readonly data: Data;\n  readonly input: Input;\n  readonly events: Events | undefined;\n  /** Every mounted layout controller of this page, outermost first. */\n  readonly layouts: readonly FrontendLayout[];\n  /**\n   * The page's sole layout controller. Throws when the page declares none,\n   * or more than one — use `layouts` and name the layout explicitly there.\n   */\n  readonly layout: FrontendLayout;\n  close(): Promise<void>;\n}\n\ninterface PageControllerLike {\n  data?: unknown;\n  input?: unknown;\n  events?: unknown;\n}\n\nfunction bridgeSurface(surface: unknown, scope: unknown): unknown {\n  if (!surface || typeof surface !== 'object') return surface;\n  // Proxy, not a copy: input/events surfaces are often class instances\n  // (methods on the prototype) or reactive objects (accessor-backed state);\n  // a proxy preserves both while wrapping function reads so handlers run\n  // under the page scope's execution context.\n  const wrapped = new WeakMap<object, unknown>();\n  return new Proxy(surface as object, {\n    get(target, property, receiver) {\n      const value = Reflect.get(target, property, receiver === undefined ? target : target);\n      if (typeof value !== 'function') return value;\n      const fn = value as (...args: unknown[]) => unknown;\n      const cached = wrapped.get(fn);\n      if (cached) return cached;\n      const bridged = (...args: unknown[]) =>\n        ExecutionContext.current() !== undefined\n          ? fn.apply(target, args)\n          : ExecutionContext.run(scope as never, () => fn.apply(target, args));\n      wrapped.set(fn, bridged);\n      return bridged;\n    },\n  });\n}\n\nexport interface FrontendPageHandle<Data = unknown, Input = unknown, Events = unknown> {\n  page: FrontendPage<Data, Input, Events>;\n  /** Mark the projection stale without disposing (navigation already disposed the scope). */\n  invalidate: () => void;\n}\n\n/** One mounted layout controller with the scope its handlers run under. */\nexport interface MountedLayout {\n  path: string;\n  controller: string;\n  preserve: boolean;\n  instance: PageControllerLike;\n  scope: unknown;\n}\n\nexport function createFrontendPage<Data, Input, Events>(options: {\n  identity: string;\n  controller: PageControllerLike;\n  scope: unknown;\n  layouts?: readonly MountedLayout[];\n  onClose: () => Promise<void>;\n}): FrontendPageHandle<Data, Input, Events> {\n  const { identity, controller, scope } = options;\n  let closed = false;\n\n  const bridgedInput = bridgeSurface(controller.input, scope);\n  const bridgedEvents = bridgeSurface(controller.events, scope);\n\n  const layouts: FrontendLayout[] = (options.layouts ?? []).map((mounted) => {\n    const layoutInput = bridgeSurface(mounted.instance.input, mounted.scope);\n    const layoutEvents = bridgeSurface(mounted.instance.events, mounted.scope);\n    return {\n      path: mounted.path,\n      controller: mounted.controller,\n      preserve: mounted.preserve,\n      get data() {\n        guard();\n        return mounted.instance.data;\n      },\n      get input() {\n        guard();\n        return layoutInput;\n      },\n      get events() {\n        guard();\n        return layoutEvents;\n      },\n    };\n  });\n\n  const guard = (): void => {\n    if (closed) {\n      throw new FrontendWorkError(\n        `page \"${identity}\" is closed; a closed/navigated-away page handle must not be used. ` +\n        'Re-open the page or use frontend.current().',\n      );\n    }\n  };\n\n  const page: FrontendPage<Data, Input, Events> = {\n    identity,\n    get data(): Data {\n      guard();\n      return controller.data as Data;\n    },\n    get input(): Input {\n      guard();\n      return bridgedInput as Input;\n    },\n    get events(): Events | undefined {\n      guard();\n      return bridgedEvents as Events | undefined;\n    },\n    get layouts(): readonly FrontendLayout[] {\n      guard();\n      return layouts;\n    },\n    get layout(): FrontendLayout {\n      guard();\n      if (layouts.length === 1) return layouts[0];\n      if (!layouts.length) {\n        throw new FrontendWorkError(\n          `page \"${identity}\" mounts no layout controller; its views entry binds none.`,\n        );\n      }\n      throw new FrontendWorkError(\n        `page \"${identity}\" mounts ${layouts.length} layout controllers ` +\n        `(${layouts.map((entry) => entry.controller).join(', ')}); ` +\n        'use page.layouts and name the one you mean.',\n      );\n    },\n    close: async () => {\n      if (closed) return;\n      closed = true;\n      await options.onClose();\n    },\n  };\n\n  return {\n    page,\n    invalidate: () => {\n      closed = true;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAWA,iBAAiC;AACjC,2BAAkC;AA6ClC,SAAS,cAAc,SAAkB,OAAyB;AAChE,MAAI,CAAC,WAAW,OAAO,YAAY,SAAU,QAAO;AAKpD,QAAM,UAAU,oBAAI,QAAyB;AAC7C,SAAO,IAAI,MAAM,SAAmB;AAAA,IAClC,IAAI,QAAQ,UAAU,UAAU;AAC9B,YAAM,QAAQ,QAAQ,IAAI,QAAQ,UAAU,aAAa,SAAY,SAAS,MAAM;AACpF,UAAI,OAAO,UAAU,WAAY,QAAO;AACxC,YAAM,KAAK;AACX,YAAM,SAAS,QAAQ,IAAI,EAAE;AAC7B,UAAI,OAAQ,QAAO;AACnB,YAAM,UAAU,IAAI,SAClB,4BAAiB,QAAQ,MAAM,SAC3B,GAAG,MAAM,QAAQ,IAAI,IACrB,4BAAiB,IAAI,OAAgB,MAAM,GAAG,MAAM,QAAQ,IAAI,CAAC;AACvE,cAAQ,IAAI,IAAI,OAAO;AACvB,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AACH;AAiBO,SAAS,mBAAwC,SAMZ;AAC1C,QAAM,EAAE,UAAU,YAAY,MAAM,IAAI;AACxC,MAAI,SAAS;AAEb,QAAM,eAAe,cAAc,WAAW,OAAO,KAAK;AAC1D,QAAM,gBAAgB,cAAc,WAAW,QAAQ,KAAK;AAE5D,QAAM,WAA6B,QAAQ,WAAW,CAAC,GAAG,IAAI,CAAC,YAAY;AACzE,UAAM,cAAc,cAAc,QAAQ,SAAS,OAAO,QAAQ,KAAK;AACvE,UAAM,eAAe,cAAc,QAAQ,SAAS,QAAQ,QAAQ,KAAK;AACzE,WAAO;AAAA,MACL,MAAM,QAAQ;AAAA,MACd,YAAY,QAAQ;AAAA,MACpB,UAAU,QAAQ;AAAA,MAClB,IAAI,OAAO;AACT,cAAM;AACN,eAAO,QAAQ,SAAS;AAAA,MAC1B;AAAA,MACA,IAAI,QAAQ;AACV,cAAM;AACN,eAAO;AAAA,MACT;AAAA,MACA,IAAI,SAAS;AACX,cAAM;AACN,eAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF,CAAC;AAED,QAAM,QAAQ,MAAY;AACxB,QAAI,QAAQ;AACV,YAAM,IAAI;AAAA,QACR,SAAS,QAAQ;AAAA,MAEnB;AAAA,IACF;AAAA,EACF;AAEA,QAAM,OAA0C;AAAA,IAC9C;AAAA,IACA,IAAI,OAAa;AACf,YAAM;AACN,aAAO,WAAW;AAAA,IACpB;AAAA,IACA,IAAI,QAAe;AACjB,YAAM;AACN,aAAO;AAAA,IACT;AAAA,IACA,IAAI,SAA6B;AAC/B,YAAM;AACN,aAAO;AAAA,IACT;AAAA,IACA,IAAI,UAAqC;AACvC,YAAM;AACN,aAAO;AAAA,IACT;AAAA,IACA,IAAI,SAAyB;AAC3B,YAAM;AACN,UAAI,QAAQ,WAAW,EAAG,QAAO,QAAQ,CAAC;AAC1C,UAAI,CAAC,QAAQ,QAAQ;AACnB,cAAM,IAAI;AAAA,UACR,SAAS,QAAQ;AAAA,QACnB;AAAA,MACF;AACA,YAAM,IAAI;AAAA,QACR,SAAS,QAAQ,YAAY,QAAQ,MAAM,wBACvC,QAAQ,IAAI,CAAC,UAAU,MAAM,UAAU,EAAE,KAAK,IAAI,CAAC;AAAA,MAEzD;AAAA,IACF;AAAA,IACA,OAAO,YAAY;AACjB,UAAI,OAAQ;AACZ,eAAS;AACT,YAAM,QAAQ,QAAQ;AAAA,IACxB;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA,YAAY,MAAM;AAChB,eAAS;AAAA,IACX;AAAA,EACF;AACF;","names":[]}