@warlock.js/core 5.29.0 → 5.31.0

package/esm/dev-server/development-server.mjs

@@ -13,6 +13,7 @@ import { restartDevServer } from "./restart-dev-server.mjs";
 import { devServerShortcuts } from "./shortcuts.mjs";
 import { BootPreconditionError } from "./boot-precondition-error.mjs";
 import { buildDevelopmentOpenApiDocument } from "./build-development-openapi-document.mjs";
+import { DevAgentTooling, resolveDevMcpOptions } from "./dev-agent-tooling.mjs";
 import { LayerExecutor } from "./layer-executor.mjs";
 import { printReadyBlock } from "./ready-block.mjs";
 import { registerInstalledDevtools } from "./register-installed-devtools.mjs";
@@ -22,7 +23,7 @@ import { colors } from "@mongez/copper";
 import events from "@mongez/events";
 import { fileExistsAsync, unlinkAsync } from "@warlock.js/fs";
 
-//#region ../core/src/dev-server/development-server.ts
+//#region ../../packages/core/src/dev-server/development-server.ts
 /**
 * Top-level coordinator for `warlock dev`. Wires the file orchestrator, the
 * connectors, and the layer executor together, and listens for the watcher's
@@ -32,6 +33,7 @@ var DevelopmentServer = class {
 	constructor(options = {}) {
 		this.running = false;
 		this.connectorsStarted = false;
+		this.agentTooling = new DevAgentTooling();
 		this.reloadQueue = Promise.resolve();
 		this.options = options;
 		devLogSection("Starting Development Server...");
@@ -73,6 +75,10 @@ var DevelopmentServer = class {
 			const devServerConfig = await warlockConfigManager.get("devServer");
 			const generateTypings = this.options.generateTypings ?? devServerConfig?.generateTypings ?? true;
 			const healthCheckers = this.options.healthCheckers ?? devServerConfig?.healthCheckers ?? true;
+			await this.agentTooling.start({
+				agentsMd: devServerConfig?.agentsMd !== false,
+				mcp: resolveDevMcpOptions(this.options.mcp, devServerConfig?.mcp)
+			});
 			if (generateTypings) await typeGenerator.executeGenerateAllCommand();
 			if (healthCheckers) filesOrchestrator.startCheckingHealth(healthCheckers === true ? void 0 : healthCheckers);
 		} catch (error) {
@@ -108,6 +114,7 @@ var DevelopmentServer = class {
 				...batch.changed,
 				...batch.deleted
 			]);
+			this.agentTooling.afterReload();
 			filesOrchestrator.checkHealth(batch);
 		} catch (error) {
 			devServeLog(colors.redBright(`Failed to execute batch reload: ${error}`));
@@ -144,6 +151,7 @@ var DevelopmentServer = class {
 		devServeLog(colors.redBright("Shutting down Development Server..."));
 		this.running = false;
 		this.connectorsStarted = false;
+		await this.agentTooling.shutdown();
 		await connectorsManager.shutdown();
 		devServeLog(colors.greenBright("Development Server stopped"));
 	}

package/esm/dev-server/development-server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"development-server.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/development-server.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport events from \"@mongez/events\";\nimport { fileExistsAsync, unlinkAsync } from \"@warlock.js/fs\";\nimport { Application } from \"../application\";\nimport { connectorsManager } from \"../connectors/connectors-manager\";\nimport { ConnectorLifecyclePhase } from \"../connectors/types\";\nimport { warlockConfigManager } from \"../warlock-config\";\nimport { registerDevelopmentOpenApiProvider } from \"../openapi/development-openapi-provider\";\nimport { BootPreconditionError } from \"./boot-precondition-error\";\nimport { buildDevelopmentOpenApiDocument } from \"./build-development-openapi-document\";\nimport { devLogInfo, devLogSection, devLogWarn, devServeLog } from \"./dev-logger\";\nimport { filesOrchestrator } from \"./files-orchestrator\";\nimport { MANIFEST_PATH } from \"./flags\";\nimport type { IncomingReloadTimings } from \"./layer-executor\";\nimport { LayerExecutor } from \"./layer-executor\";\nimport { printReadyBlock } from \"./ready-block\";\nimport { registerInstalledDevtools } from \"./register-installed-devtools\";\nimport { restartDevServer } from \"./restart-dev-server\";\nimport { collectDevelopmentApiRoutes } from \"./collect-development-api-routes\";\nimport { publishCurrentRouteTypes } from \"./route-types-publisher\";\nimport { devServerShortcuts } from \"./shortcuts\";\nimport type { StartDevServerOptions } from \"./start-development-server\";\nimport { typeGenerator } from \"./type-generator\";\n\ntype Batch = {\n  added: string[];\n  changed: string[];\n  deleted: string[];\n  /** Non-code `watch.include` files that changed; only a restart applies them. */\n  restartTriggers?: string[];\n  timings?: IncomingReloadTimings;\n};\n\n/**\n * Top-level coordinator for `warlock dev`. Wires the file orchestrator, the\n * connectors, and the layer executor together, and listens for the watcher's\n * batched events to drive HMR.\n */\nexport class DevelopmentServer {\n  private layerExecutor?: LayerExecutor;\n  private running = false;\n\n  /** Set once boot begins, so a failed boot still closes connectors that already started. */\n  private connectorsStarted = false;\n  private readonly options: StartDevServerOptions;\n\n  public constructor(options: StartDevServerOptions = {}) {\n    this.options = options;\n    devLogSection(\"Starting Development Server...\");\n  }\n\n  public async start(): Promise<void> {\n    try {\n      this.connectorsStarted = true;\n      const startedAt = performance.now();\n\n      // Devtools reads this through the root barrel, which must not reach dev-server code.\n      registerDevelopmentOpenApiProvider(buildDevelopmentOpenApiDocument);\n\n      // --fresh deletes the manifest so reconciliation re-parses every file\n      // from disk. Transpile caching is owned by the loader hook (in-memory).\n      if (this.options.fresh && (await fileExistsAsync(MANIFEST_PATH))) {\n        await unlinkAsync(MANIFEST_PATH);\n        devServeLog(colors.cyanBright(\"Cleared manifest (--fresh)\"));\n      }\n\n      await filesOrchestrator.init();\n      await filesOrchestrator.initializeAll();\n      await filesOrchestrator.watchFiles();\n\n      filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.getFiles());\n\n      this.setupEventListeners();\n\n      // Decorator-driven registries (models, etc.) must be populated before\n      // routes/services can resolve symbols by name.\n      await this.autoDiscoverFiles();\n\n      await filesOrchestrator.moduleLoader.loadAll();\n\n      // A rejecting validator (Application.onValidateBoot) must abort boot\n      // before late-phase connectors bind a port — this is what makes the\n      // hook actually prevent serving instead of merely being defined.\n      //\n      // Wrapped and re-thrown as a BootPreconditionError: a rejected\n      // validator is, by definition, a precondition whose cause cannot\n      // change because the worker tried again — the supervisor must not\n      // restart into the same rejection. See boot-precondition-error.ts.\n      try {\n        await Application.runStartupValidators();\n      } catch (error) {\n        throw new BootPreconditionError((error as Error).message, { cause: error });\n      }\n\n      // `@warlock.js/devtools` is a dev dependency the config never names;\n      // when installed it joins the late phase here, and only here.\n      await registerInstalledDevtools();\n\n      // Late-phase connectors (http, socket) bind after app code has\n      // registered routes/listeners.\n      await connectorsManager.startPhase(ConnectorLifecyclePhase.Late);\n\n      // Web installs its page table from its late connector. Generate only\n      // after that installation so `href()` and the declaration table agree.\n      await publishCurrentRouteTypes(process.cwd(), await collectDevelopmentApiRoutes());\n\n      this.layerExecutor = new LayerExecutor(\n        filesOrchestrator.getDependencyGraph(),\n        filesOrchestrator.specialFilesCollector,\n        filesOrchestrator.moduleLoader,\n        (absolutePath) => filesOrchestrator.bumpVersion(absolutePath),\n        () => filesOrchestrator.flushVersionBumps(),\n      );\n\n      this.running = true;\n\n      const duration = performance.now() - startedAt;\n\n      // App modules are loaded and both connector phases are active — signal a\n      // complete boot so `Application.onceBooted(...)` listeners fire.\n      Application.markBooted({\n        environment: Application.environment,\n        runtimeStrategy: Application.runtimeStrategy,\n        bootDurationMs: duration,\n      });\n\n      // ONE block, AFTER the boot it summarises, replacing the scattered\n      // \"N route(s) registered\" / \"Server ready at …\" / \"ready in …\" lines that\n      // used to arrive in completion order. Warnings logged during boot sit\n      // above it and stay there — see `ready-block.ts`.\n      printReadyBlock(duration);\n\n      // Tell the supervisor (when there is one) that boot completed, so its\n      // healthy-uptime window counts from here rather than from spawn.\n      process.send?.(\"warlock:booted\");\n\n      // Precedence: explicit CLI option > devServer.* config > default.\n      const devServerConfig = await warlockConfigManager.get(\"devServer\");\n      const generateTypings =\n        this.options.generateTypings ?? devServerConfig?.generateTypings ?? true;\n      const healthCheckers = this.options.healthCheckers ?? devServerConfig?.healthCheckers ?? true;\n\n      if (generateTypings) await typeGenerator.executeGenerateAllCommand();\n\n      if (healthCheckers) {\n        filesOrchestrator.startCheckingHealth(healthCheckers === true ? undefined : healthCheckers);\n      }\n    } catch (error) {\n      devServeLog(colors.redBright(`Failed to start Development Server: ${error}`));\n      await this.shutdown();\n      throw error;\n    }\n  }\n\n  /**\n   * Eagerly import files whose decorators populate global registries so any\n   * symbol-by-name resolution later in boot finds them.\n   */\n  private async autoDiscoverFiles(): Promise<void> {\n    const discoveryTypes = [\"model\"] as const;\n    for (const file of filesOrchestrator.files.values()) {\n      if (file.type && (discoveryTypes as readonly string[]).includes(file.type)) {\n        await filesOrchestrator.moduleLoader.loadModule(file, file.type);\n      }\n    }\n  }\n\n  /** Tail of the batch-reload chain (see `setupEventListeners`). */\n  private reloadQueue: Promise<void> = Promise.resolve();\n\n  private setupEventListeners(): void {\n    // Reloads run one at a time: a second batch waits for the first to finish\n    // so route re-registration and connector restarts never interleave.\n    events.on(\"dev-server:batch-complete\", (batch: Batch) => {\n      this.reloadQueue = this.reloadQueue\n        .then(() => this.handleBatchComplete(batch))\n        .catch((error) => devServeLog(colors.redBright(`Batch reload failed: ${error}`)));\n    });\n  }\n\n  private async handleBatchComplete(batch: Batch): Promise<void> {\n    if (!this.running || !this.layerExecutor) return;\n\n    // warlock.config.ts holds settings read at boot (CLI commands, build\n    // options, watch patterns, scheduled jobs) and .env feeds every config\n    // that reads it. Neither can be hot-reloaded without leaving running\n    // services configured with stale values, so the only honest response is\n    // a full restart.\n    const restartTrigger = this.findRestartTrigger(batch);\n\n    if (restartTrigger) {\n      // On success this never comes back — the process exits and the\n      // supervisor replaces it. Reaching the next line means the restart was\n      // declined by config or wasn't possible, so we fall through and still\n      // hot-reload whatever ordinary code shared the batch.\n      await this.restartForConfigChange(restartTrigger);\n    }\n\n    // No-op saves (an editor that fsyncs without a content write) are already\n    // filtered upstream by the file hash in FileEventHandler, so batch.changed\n    // only contains genuinely-changed paths by the time it reaches here.\n\n    const total = batch.added.length + batch.changed.length + batch.deleted.length;\n    if (total === 0) return;\n\n    // Boot-time files still ride along in `changed` when a restart was\n    // declined (`restartOnConfigChange: false`) or wasn't possible — they are\n    // never hot-reloaded, so keep them out of the reload set either way.\n    const codeFiles = [...batch.added, ...batch.changed].filter(\n      (p) => !isEnvPath(p) && p !== \"warlock.config.ts\" && !batch.restartTriggers?.includes(p),\n    );\n\n    try {\n      await this.layerExecutor.executeBatchReload(\n        codeFiles,\n        filesOrchestrator.getFiles(),\n        batch.deleted,\n        batch.changed,\n        batch.timings,\n      );\n\n      // `executeBatchReload` includes route re-imports and affected connector\n      // restarts. Publishing earlier could freeze a partial page/API view.\n      // This also refreshes deletion-only batches after their cleanup/restart.\n      await publishCurrentRouteTypes(process.cwd(), await collectDevelopmentApiRoutes());\n\n      typeGenerator.executeTypingsGenerator([...batch.added, ...batch.changed, ...batch.deleted]);\n\n      filesOrchestrator.checkHealth(batch);\n    } catch (error) {\n      devServeLog(colors.redBright(`Failed to execute batch reload: ${error}`));\n    }\n  }\n\n  /**\n   * The boot-time file in this batch that can only be applied by restarting,\n   * or `undefined` when the batch is ordinary application code.\n   */\n  private findRestartTrigger(batch: Batch): string | undefined {\n    if (batch.changed.includes(\"warlock.config.ts\")) {\n      return \"warlock.config.ts\";\n    }\n\n    return [...batch.added, ...batch.changed].find(isEnvPath) ?? batch.restartTriggers?.[0];\n  }\n\n  /**\n   * Restart so a changed boot-time file actually takes effect.\n   *\n   * Opt out with `devServer.restartOnConfigChange: false` and the old\n   * behaviour returns: a warning telling you to restart yourself. If the\n   * restart can't be performed at all (no supervisor, a shutdown that threw),\n   * `restartDevServer` reports it and we fall back to the same warning rather\n   * than leaving the server running against config it isn't using.\n   */\n  private async restartForConfigChange(file: string): Promise<void> {\n    const devServerConfig = await warlockConfigManager.get(\"devServer\");\n\n    if (devServerConfig?.restartOnConfigChange === false) {\n      devLogWarn(`${file} changed — restart the dev server to apply.`);\n      return;\n    }\n\n    devLogInfo(`${file} changed — restarting to apply.`);\n\n    const restarted = await restartDevServer(this);\n\n    if (!restarted) {\n      devLogWarn(`${file} changed — restart the dev server to apply.`);\n    }\n  }\n\n  public async shutdown(): Promise<void> {\n    // Always hand the terminal back, even on a repeat/no-op shutdown — a\n    // process that exits while stdin is still in raw mode leaves the user's\n    // shell without line editing or Ctrl+C.\n    devServerShortcuts.release();\n\n    if (!this.running && !this.connectorsStarted) return;\n    devServeLog(colors.redBright(\"Shutting down Development Server...\"));\n    this.running = false;\n    this.connectorsStarted = false;\n    await connectorsManager.shutdown();\n    devServeLog(colors.greenBright(\"Development Server stopped\"));\n  }\n\n  public isRunning(): boolean {\n    return this.running;\n  }\n}\n\nfunction isEnvPath(path: string): boolean {\n  const basename = path.split(\"/\").pop() ?? path;\n  return basename === \".env\" || basename.startsWith(\".env.\");\n}\n"],"mappings":"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"}
+{"version":3,"file":"development-server.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/development-server.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport events from \"@mongez/events\";\nimport { fileExistsAsync, unlinkAsync } from \"@warlock.js/fs\";\nimport { Application } from \"../application\";\nimport { connectorsManager } from \"../connectors/connectors-manager\";\nimport { ConnectorLifecyclePhase } from \"../connectors/types\";\nimport { warlockConfigManager } from \"../warlock-config\";\nimport { registerDevelopmentOpenApiProvider } from \"../openapi/development-openapi-provider\";\nimport { BootPreconditionError } from \"./boot-precondition-error\";\nimport { buildDevelopmentOpenApiDocument } from \"./build-development-openapi-document\";\nimport { DevAgentTooling, resolveDevMcpOptions } from \"./dev-agent-tooling\";\nimport { devLogInfo, devLogSection, devLogWarn, devServeLog } from \"./dev-logger\";\nimport { filesOrchestrator } from \"./files-orchestrator\";\nimport { MANIFEST_PATH } from \"./flags\";\nimport type { IncomingReloadTimings } from \"./layer-executor\";\nimport { LayerExecutor } from \"./layer-executor\";\nimport { printReadyBlock } from \"./ready-block\";\nimport { registerInstalledDevtools } from \"./register-installed-devtools\";\nimport { restartDevServer } from \"./restart-dev-server\";\nimport { collectDevelopmentApiRoutes } from \"./collect-development-api-routes\";\nimport { publishCurrentRouteTypes } from \"./route-types-publisher\";\nimport { devServerShortcuts } from \"./shortcuts\";\nimport type { StartDevServerOptions } from \"./start-development-server\";\nimport { typeGenerator } from \"./type-generator\";\n\ntype Batch = {\n  added: string[];\n  changed: string[];\n  deleted: string[];\n  /** Non-code `watch.include` files that changed; only a restart applies them. */\n  restartTriggers?: string[];\n  timings?: IncomingReloadTimings;\n};\n\n/**\n * Top-level coordinator for `warlock dev`. Wires the file orchestrator, the\n * connectors, and the layer executor together, and listens for the watcher's\n * batched events to drive HMR.\n */\nexport class DevelopmentServer {\n  private layerExecutor?: LayerExecutor;\n  private running = false;\n\n  /** Set once boot begins, so a failed boot still closes connectors that already started. */\n  private connectorsStarted = false;\n  private readonly options: StartDevServerOptions;\n\n  /** `.warlock/dev-server.json`, the AGENTS.md refresher and `--mcp`. */\n  private readonly agentTooling = new DevAgentTooling();\n\n  public constructor(options: StartDevServerOptions = {}) {\n    this.options = options;\n    devLogSection(\"Starting Development Server...\");\n  }\n\n  public async start(): Promise<void> {\n    try {\n      this.connectorsStarted = true;\n      const startedAt = performance.now();\n\n      // Devtools reads this through the root barrel, which must not reach dev-server code.\n      registerDevelopmentOpenApiProvider(buildDevelopmentOpenApiDocument);\n\n      // --fresh deletes the manifest so reconciliation re-parses every file\n      // from disk. Transpile caching is owned by the loader hook (in-memory).\n      if (this.options.fresh && (await fileExistsAsync(MANIFEST_PATH))) {\n        await unlinkAsync(MANIFEST_PATH);\n        devServeLog(colors.cyanBright(\"Cleared manifest (--fresh)\"));\n      }\n\n      await filesOrchestrator.init();\n      await filesOrchestrator.initializeAll();\n      await filesOrchestrator.watchFiles();\n\n      filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.getFiles());\n\n      this.setupEventListeners();\n\n      // Decorator-driven registries (models, etc.) must be populated before\n      // routes/services can resolve symbols by name.\n      await this.autoDiscoverFiles();\n\n      await filesOrchestrator.moduleLoader.loadAll();\n\n      // A rejecting validator (Application.onValidateBoot) must abort boot\n      // before late-phase connectors bind a port — this is what makes the\n      // hook actually prevent serving instead of merely being defined.\n      //\n      // Wrapped and re-thrown as a BootPreconditionError: a rejected\n      // validator is, by definition, a precondition whose cause cannot\n      // change because the worker tried again — the supervisor must not\n      // restart into the same rejection. See boot-precondition-error.ts.\n      try {\n        await Application.runStartupValidators();\n      } catch (error) {\n        throw new BootPreconditionError((error as Error).message, { cause: error });\n      }\n\n      // `@warlock.js/devtools` is a dev dependency the config never names;\n      // when installed it joins the late phase here, and only here.\n      await registerInstalledDevtools();\n\n      // Late-phase connectors (http, socket) bind after app code has\n      // registered routes/listeners.\n      await connectorsManager.startPhase(ConnectorLifecyclePhase.Late);\n\n      // Web installs its page table from its late connector. Generate only\n      // after that installation so `href()` and the declaration table agree.\n      await publishCurrentRouteTypes(process.cwd(), await collectDevelopmentApiRoutes());\n\n      this.layerExecutor = new LayerExecutor(\n        filesOrchestrator.getDependencyGraph(),\n        filesOrchestrator.specialFilesCollector,\n        filesOrchestrator.moduleLoader,\n        (absolutePath) => filesOrchestrator.bumpVersion(absolutePath),\n        () => filesOrchestrator.flushVersionBumps(),\n      );\n\n      this.running = true;\n\n      const duration = performance.now() - startedAt;\n\n      // App modules are loaded and both connector phases are active — signal a\n      // complete boot so `Application.onceBooted(...)` listeners fire.\n      Application.markBooted({\n        environment: Application.environment,\n        runtimeStrategy: Application.runtimeStrategy,\n        bootDurationMs: duration,\n      });\n\n      // ONE block, AFTER the boot it summarises, replacing the scattered\n      // \"N route(s) registered\" / \"Server ready at …\" / \"ready in …\" lines that\n      // used to arrive in completion order. Warnings logged during boot sit\n      // above it and stay there — see `ready-block.ts`.\n      printReadyBlock(duration);\n\n      // Tell the supervisor (when there is one) that boot completed, so its\n      // healthy-uptime window counts from here rather than from spawn.\n      process.send?.(\"warlock:booted\");\n\n      // Precedence: explicit CLI option > devServer.* config > default.\n      const devServerConfig = await warlockConfigManager.get(\"devServer\");\n      const generateTypings =\n        this.options.generateTypings ?? devServerConfig?.generateTypings ?? true;\n      const healthCheckers = this.options.healthCheckers ?? devServerConfig?.healthCheckers ?? true;\n\n      await this.agentTooling.start({\n        agentsMd: devServerConfig?.agentsMd !== false,\n        mcp: resolveDevMcpOptions(this.options.mcp, devServerConfig?.mcp),\n      });\n\n      if (generateTypings) await typeGenerator.executeGenerateAllCommand();\n\n      if (healthCheckers) {\n        filesOrchestrator.startCheckingHealth(healthCheckers === true ? undefined : healthCheckers);\n      }\n    } catch (error) {\n      devServeLog(colors.redBright(`Failed to start Development Server: ${error}`));\n      await this.shutdown();\n      throw error;\n    }\n  }\n\n  /**\n   * Eagerly import files whose decorators populate global registries so any\n   * symbol-by-name resolution later in boot finds them.\n   */\n  private async autoDiscoverFiles(): Promise<void> {\n    const discoveryTypes = [\"model\"] as const;\n    for (const file of filesOrchestrator.files.values()) {\n      if (file.type && (discoveryTypes as readonly string[]).includes(file.type)) {\n        await filesOrchestrator.moduleLoader.loadModule(file, file.type);\n      }\n    }\n  }\n\n  /** Tail of the batch-reload chain (see `setupEventListeners`). */\n  private reloadQueue: Promise<void> = Promise.resolve();\n\n  private setupEventListeners(): void {\n    // Reloads run one at a time: a second batch waits for the first to finish\n    // so route re-registration and connector restarts never interleave.\n    events.on(\"dev-server:batch-complete\", (batch: Batch) => {\n      this.reloadQueue = this.reloadQueue\n        .then(() => this.handleBatchComplete(batch))\n        .catch((error) => devServeLog(colors.redBright(`Batch reload failed: ${error}`)));\n    });\n  }\n\n  private async handleBatchComplete(batch: Batch): Promise<void> {\n    if (!this.running || !this.layerExecutor) return;\n\n    // warlock.config.ts holds settings read at boot (CLI commands, build\n    // options, watch patterns, scheduled jobs) and .env feeds every config\n    // that reads it. Neither can be hot-reloaded without leaving running\n    // services configured with stale values, so the only honest response is\n    // a full restart.\n    const restartTrigger = this.findRestartTrigger(batch);\n\n    if (restartTrigger) {\n      // On success this never comes back — the process exits and the\n      // supervisor replaces it. Reaching the next line means the restart was\n      // declined by config or wasn't possible, so we fall through and still\n      // hot-reload whatever ordinary code shared the batch.\n      await this.restartForConfigChange(restartTrigger);\n    }\n\n    // No-op saves (an editor that fsyncs without a content write) are already\n    // filtered upstream by the file hash in FileEventHandler, so batch.changed\n    // only contains genuinely-changed paths by the time it reaches here.\n\n    const total = batch.added.length + batch.changed.length + batch.deleted.length;\n    if (total === 0) return;\n\n    // Boot-time files still ride along in `changed` when a restart was\n    // declined (`restartOnConfigChange: false`) or wasn't possible — they are\n    // never hot-reloaded, so keep them out of the reload set either way.\n    const codeFiles = [...batch.added, ...batch.changed].filter(\n      (p) => !isEnvPath(p) && p !== \"warlock.config.ts\" && !batch.restartTriggers?.includes(p),\n    );\n\n    try {\n      await this.layerExecutor.executeBatchReload(\n        codeFiles,\n        filesOrchestrator.getFiles(),\n        batch.deleted,\n        batch.changed,\n        batch.timings,\n      );\n\n      // `executeBatchReload` includes route re-imports and affected connector\n      // restarts. Publishing earlier could freeze a partial page/API view.\n      // This also refreshes deletion-only batches after their cleanup/restart.\n      await publishCurrentRouteTypes(process.cwd(), await collectDevelopmentApiRoutes());\n\n      typeGenerator.executeTypingsGenerator([...batch.added, ...batch.changed, ...batch.deleted]);\n\n      this.agentTooling.afterReload();\n\n      filesOrchestrator.checkHealth(batch);\n    } catch (error) {\n      devServeLog(colors.redBright(`Failed to execute batch reload: ${error}`));\n    }\n  }\n\n  /**\n   * The boot-time file in this batch that can only be applied by restarting,\n   * or `undefined` when the batch is ordinary application code.\n   */\n  private findRestartTrigger(batch: Batch): string | undefined {\n    if (batch.changed.includes(\"warlock.config.ts\")) {\n      return \"warlock.config.ts\";\n    }\n\n    return [...batch.added, ...batch.changed].find(isEnvPath) ?? batch.restartTriggers?.[0];\n  }\n\n  /**\n   * Restart so a changed boot-time file actually takes effect.\n   *\n   * Opt out with `devServer.restartOnConfigChange: false` and the old\n   * behaviour returns: a warning telling you to restart yourself. If the\n   * restart can't be performed at all (no supervisor, a shutdown that threw),\n   * `restartDevServer` reports it and we fall back to the same warning rather\n   * than leaving the server running against config it isn't using.\n   */\n  private async restartForConfigChange(file: string): Promise<void> {\n    const devServerConfig = await warlockConfigManager.get(\"devServer\");\n\n    if (devServerConfig?.restartOnConfigChange === false) {\n      devLogWarn(`${file} changed — restart the dev server to apply.`);\n      return;\n    }\n\n    devLogInfo(`${file} changed — restarting to apply.`);\n\n    const restarted = await restartDevServer(this);\n\n    if (!restarted) {\n      devLogWarn(`${file} changed — restart the dev server to apply.`);\n    }\n  }\n\n  public async shutdown(): Promise<void> {\n    // Always hand the terminal back, even on a repeat/no-op shutdown — a\n    // process that exits while stdin is still in raw mode leaves the user's\n    // shell without line editing or Ctrl+C.\n    devServerShortcuts.release();\n\n    if (!this.running && !this.connectorsStarted) return;\n    devServeLog(colors.redBright(\"Shutting down Development Server...\"));\n    this.running = false;\n    this.connectorsStarted = false;\n    await this.agentTooling.shutdown();\n    await connectorsManager.shutdown();\n    devServeLog(colors.greenBright(\"Development Server stopped\"));\n  }\n\n  public isRunning(): boolean {\n    return this.running;\n  }\n}\n\nfunction isEnvPath(path: string): boolean {\n  const basename = path.split(\"/\").pop() ?? path;\n  return basename === \".env\" || basename.startsWith(\".env.\");\n}\n"],"mappings":"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"}

package/esm/dev-server/events.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/dev-server/events.ts
+//#region ../../packages/core/src/dev-server/events.ts
 const DEV_SERVER_EVENTS = {
 	MANIFEST_NOT_FOUND: "dev-server.manifest.not-found",
 	FILE_READY: "dev-server.file.ready"

package/esm/dev-server/events.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"events.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/events.ts"],"sourcesContent":["export const DEV_SERVER_EVENTS = {\n  MANIFEST_NOT_FOUND: \"dev-server.manifest.not-found\",\n  FILE_READY: \"dev-server.file.ready\",\n};\n"],"mappings":";AAAA,MAAa,oBAAoB;CAC/B,oBAAoB;CACpB,YAAY;AACd"}
+{"version":3,"file":"events.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/events.ts"],"sourcesContent":["export const DEV_SERVER_EVENTS = {\n  MANIFEST_NOT_FOUND: \"dev-server.manifest.not-found\",\n  FILE_READY: \"dev-server.file.ready\",\n};\n"],"mappings":";AAAA,MAAa,oBAAoB;CAC/B,oBAAoB;CACpB,YAAY;AACd"}

package/esm/dev-server/extract-translation-keys.mjs

@@ -1,6 +1,6 @@
 import ts from "typescript";
 
-//#region ../core/src/dev-server/extract-translation-keys.ts
+//#region ../../packages/core/src/dev-server/extract-translation-keys.ts
 /**
 * Extract literal lookup keys registered through `groupedTranslations` calls,
 * statically, without executing the source.

package/esm/dev-server/extract-translation-keys.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"extract-translation-keys.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/extract-translation-keys.ts"],"sourcesContent":["import ts from \"typescript\";\n\n/**\n * Extract literal lookup keys registered through `groupedTranslations` calls,\n * statically, without executing the source.\n *\n * Handles both call shapes:\n * - Named-group: `groupedTranslations(\"site\", { home: { en, ar } })`\n * - Object: `groupedTranslations({ site: { home: { en, ar } } })`\n *\n * Groups nest to any depth (`{ detail: { title: { en, ar } } }` yields\n * `products.detail.title`) — an object is a leaf once none of its own\n * properties hold a further object literal.\n *\n * A dynamic group name, dictionary, or property key (an identifier, spread,\n * or computed name instead of a literal) cannot be resolved statically and is\n * silently skipped; such keys must be documented by the app author instead.\n */\nexport function extractTranslationKeys(sourceFile: ts.SourceFile): string[] {\n  const keys = new Set<string>();\n\n  const visit = (node: ts.Node): void => {\n    if (isGroupedTranslationsCall(node)) {\n      collectFromCall(node, keys);\n    }\n\n    ts.forEachChild(node, visit);\n  };\n\n  ts.forEachChild(sourceFile, visit);\n\n  return Array.from(keys).sort();\n}\n\nfunction isGroupedTranslationsCall(node: ts.Node): node is ts.CallExpression {\n  return (\n    ts.isCallExpression(node) &&\n    ts.isIdentifier(node.expression) &&\n    node.expression.text === \"groupedTranslations\"\n  );\n}\n\nfunction collectFromCall(call: ts.CallExpression, keys: Set<string>): void {\n  const [first, second] = call.arguments;\n\n  if (first === undefined) return;\n\n  if (second !== undefined) {\n    if (ts.isStringLiteral(first) && ts.isObjectLiteralExpression(second)) {\n      collectLeaves(second, first.text, keys);\n    }\n    return;\n  }\n\n  if (ts.isObjectLiteralExpression(first)) {\n    for (const property of first.properties) {\n      if (!ts.isPropertyAssignment(property)) continue;\n\n      const groupName = getPropertyName(property.name);\n      if (groupName === undefined) continue;\n\n      if (ts.isObjectLiteralExpression(property.initializer)) {\n        collectLeaves(property.initializer, groupName, keys);\n      }\n    }\n  }\n}\n\nfunction collectLeaves(\n  object: ts.ObjectLiteralExpression,\n  prefix: string,\n  keys: Set<string>,\n): void {\n  for (const property of object.properties) {\n    if (!ts.isPropertyAssignment(property)) continue;\n\n    const key = getPropertyName(property.name);\n    if (key === undefined) continue;\n\n    if (!ts.isObjectLiteralExpression(property.initializer)) continue;\n\n    const path = `${prefix}.${key}`;\n\n    if (isLeaf(property.initializer)) {\n      keys.add(path);\n    } else {\n      collectLeaves(property.initializer, path, keys);\n    }\n  }\n}\n\n/** A locale map (`{ en: \"...\", ar: \"...\" }`) has no object-literal children. */\nfunction isLeaf(object: ts.ObjectLiteralExpression): boolean {\n  return !object.properties.some(\n    (property) =>\n      ts.isPropertyAssignment(property) && ts.isObjectLiteralExpression(property.initializer),\n  );\n}\n\nfunction getPropertyName(name: ts.PropertyName | undefined): string | undefined {\n  if (name === undefined) {\n    return undefined;\n  }\n\n  if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name)) {\n    return name.text;\n  }\n\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,uBAAuB,YAAqC;CAC1E,MAAM,uBAAO,IAAI,IAAY;CAE7B,MAAM,SAAS,SAAwB;EACrC,IAAI,0BAA0B,IAAI,GAChC,gBAAgB,MAAM,IAAI;EAG5B,GAAG,aAAa,MAAM,KAAK;CAC7B;CAEA,GAAG,aAAa,YAAY,KAAK;CAEjC,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,KAAK;AAC/B;AAEA,SAAS,0BAA0B,MAA0C;CAC3E,OACE,GAAG,iBAAiB,IAAI,KACxB,GAAG,aAAa,KAAK,UAAU,KAC/B,KAAK,WAAW,SAAS;AAE7B;AAEA,SAAS,gBAAgB,MAAyB,MAAyB;CACzE,MAAM,CAAC,OAAO,UAAU,KAAK;CAE7B,IAAI,UAAU,QAAW;CAEzB,IAAI,WAAW,QAAW;EACxB,IAAI,GAAG,gBAAgB,KAAK,KAAK,GAAG,0BAA0B,MAAM,GAClE,cAAc,QAAQ,MAAM,MAAM,IAAI;EAExC;CACF;CAEA,IAAI,GAAG,0BAA0B,KAAK,GACpC,KAAK,MAAM,YAAY,MAAM,YAAY;EACvC,IAAI,CAAC,GAAG,qBAAqB,QAAQ,GAAG;EAExC,MAAM,YAAY,gBAAgB,SAAS,IAAI;EAC/C,IAAI,cAAc,QAAW;EAE7B,IAAI,GAAG,0BAA0B,SAAS,WAAW,GACnD,cAAc,SAAS,aAAa,WAAW,IAAI;CAEvD;AAEJ;AAEA,SAAS,cACP,QACA,QACA,MACM;CACN,KAAK,MAAM,YAAY,OAAO,YAAY;EACxC,IAAI,CAAC,GAAG,qBAAqB,QAAQ,GAAG;EAExC,MAAM,MAAM,gBAAgB,SAAS,IAAI;EACzC,IAAI,QAAQ,QAAW;EAEvB,IAAI,CAAC,GAAG,0BAA0B,SAAS,WAAW,GAAG;EAEzD,MAAM,OAAO,GAAG,OAAO,GAAG;EAE1B,IAAI,OAAO,SAAS,WAAW,GAC7B,KAAK,IAAI,IAAI;OAEb,cAAc,SAAS,aAAa,MAAM,IAAI;CAElD;AACF;;AAGA,SAAS,OAAO,QAA6C;CAC3D,OAAO,CAAC,OAAO,WAAW,MACvB,aACC,GAAG,qBAAqB,QAAQ,KAAK,GAAG,0BAA0B,SAAS,WAAW,CAC1F;AACF;AAEA,SAAS,gBAAgB,MAAuD;CAC9E,IAAI,SAAS,QACX;CAGF,IAAI,GAAG,aAAa,IAAI,KAAK,GAAG,gBAAgB,IAAI,KAAK,GAAG,iBAAiB,IAAI,GAC/E,OAAO,KAAK;AAIhB"}
+{"version":3,"file":"extract-translation-keys.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/extract-translation-keys.ts"],"sourcesContent":["import ts from \"typescript\";\n\n/**\n * Extract literal lookup keys registered through `groupedTranslations` calls,\n * statically, without executing the source.\n *\n * Handles both call shapes:\n * - Named-group: `groupedTranslations(\"site\", { home: { en, ar } })`\n * - Object: `groupedTranslations({ site: { home: { en, ar } } })`\n *\n * Groups nest to any depth (`{ detail: { title: { en, ar } } }` yields\n * `products.detail.title`) — an object is a leaf once none of its own\n * properties hold a further object literal.\n *\n * A dynamic group name, dictionary, or property key (an identifier, spread,\n * or computed name instead of a literal) cannot be resolved statically and is\n * silently skipped; such keys must be documented by the app author instead.\n */\nexport function extractTranslationKeys(sourceFile: ts.SourceFile): string[] {\n  const keys = new Set<string>();\n\n  const visit = (node: ts.Node): void => {\n    if (isGroupedTranslationsCall(node)) {\n      collectFromCall(node, keys);\n    }\n\n    ts.forEachChild(node, visit);\n  };\n\n  ts.forEachChild(sourceFile, visit);\n\n  return Array.from(keys).sort();\n}\n\nfunction isGroupedTranslationsCall(node: ts.Node): node is ts.CallExpression {\n  return (\n    ts.isCallExpression(node) &&\n    ts.isIdentifier(node.expression) &&\n    node.expression.text === \"groupedTranslations\"\n  );\n}\n\nfunction collectFromCall(call: ts.CallExpression, keys: Set<string>): void {\n  const [first, second] = call.arguments;\n\n  if (first === undefined) return;\n\n  if (second !== undefined) {\n    if (ts.isStringLiteral(first) && ts.isObjectLiteralExpression(second)) {\n      collectLeaves(second, first.text, keys);\n    }\n    return;\n  }\n\n  if (ts.isObjectLiteralExpression(first)) {\n    for (const property of first.properties) {\n      if (!ts.isPropertyAssignment(property)) continue;\n\n      const groupName = getPropertyName(property.name);\n      if (groupName === undefined) continue;\n\n      if (ts.isObjectLiteralExpression(property.initializer)) {\n        collectLeaves(property.initializer, groupName, keys);\n      }\n    }\n  }\n}\n\nfunction collectLeaves(\n  object: ts.ObjectLiteralExpression,\n  prefix: string,\n  keys: Set<string>,\n): void {\n  for (const property of object.properties) {\n    if (!ts.isPropertyAssignment(property)) continue;\n\n    const key = getPropertyName(property.name);\n    if (key === undefined) continue;\n\n    if (!ts.isObjectLiteralExpression(property.initializer)) continue;\n\n    const path = `${prefix}.${key}`;\n\n    if (isLeaf(property.initializer)) {\n      keys.add(path);\n    } else {\n      collectLeaves(property.initializer, path, keys);\n    }\n  }\n}\n\n/** A locale map (`{ en: \"...\", ar: \"...\" }`) has no object-literal children. */\nfunction isLeaf(object: ts.ObjectLiteralExpression): boolean {\n  return !object.properties.some(\n    (property) =>\n      ts.isPropertyAssignment(property) && ts.isObjectLiteralExpression(property.initializer),\n  );\n}\n\nfunction getPropertyName(name: ts.PropertyName | undefined): string | undefined {\n  if (name === undefined) {\n    return undefined;\n  }\n\n  if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name)) {\n    return name.text;\n  }\n\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,uBAAuB,YAAqC;CAC1E,MAAM,uBAAO,IAAI,IAAY;CAE7B,MAAM,SAAS,SAAwB;EACrC,IAAI,0BAA0B,IAAI,GAChC,gBAAgB,MAAM,IAAI;EAG5B,GAAG,aAAa,MAAM,KAAK;CAC7B;CAEA,GAAG,aAAa,YAAY,KAAK;CAEjC,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,KAAK;AAC/B;AAEA,SAAS,0BAA0B,MAA0C;CAC3E,OACE,GAAG,iBAAiB,IAAI,KACxB,GAAG,aAAa,KAAK,UAAU,KAC/B,KAAK,WAAW,SAAS;AAE7B;AAEA,SAAS,gBAAgB,MAAyB,MAAyB;CACzE,MAAM,CAAC,OAAO,UAAU,KAAK;CAE7B,IAAI,UAAU,QAAW;CAEzB,IAAI,WAAW,QAAW;EACxB,IAAI,GAAG,gBAAgB,KAAK,KAAK,GAAG,0BAA0B,MAAM,GAClE,cAAc,QAAQ,MAAM,MAAM,IAAI;EAExC;CACF;CAEA,IAAI,GAAG,0BAA0B,KAAK,GACpC,KAAK,MAAM,YAAY,MAAM,YAAY;EACvC,IAAI,CAAC,GAAG,qBAAqB,QAAQ,GAAG;EAExC,MAAM,YAAY,gBAAgB,SAAS,IAAI;EAC/C,IAAI,cAAc,QAAW;EAE7B,IAAI,GAAG,0BAA0B,SAAS,WAAW,GACnD,cAAc,SAAS,aAAa,WAAW,IAAI;CAEvD;AAEJ;AAEA,SAAS,cACP,QACA,QACA,MACM;CACN,KAAK,MAAM,YAAY,OAAO,YAAY;EACxC,IAAI,CAAC,GAAG,qBAAqB,QAAQ,GAAG;EAExC,MAAM,MAAM,gBAAgB,SAAS,IAAI;EACzC,IAAI,QAAQ,QAAW;EAEvB,IAAI,CAAC,GAAG,0BAA0B,SAAS,WAAW,GAAG;EAEzD,MAAM,OAAO,GAAG,OAAO,GAAG;EAE1B,IAAI,OAAO,SAAS,WAAW,GAC7B,KAAK,IAAI,IAAI;OAEb,cAAc,SAAS,aAAa,MAAM,IAAI;CAElD;AACF;;AAGA,SAAS,OAAO,QAA6C;CAC3D,OAAO,CAAC,OAAO,WAAW,MACvB,aACC,GAAG,qBAAqB,QAAQ,KAAK,GAAG,0BAA0B,SAAS,WAAW,CAC1F;AACF;AAEA,SAAS,gBAAgB,MAAuD;CAC9E,IAAI,SAAS,QACX;CAGF,IAAI,GAAG,aAAa,IAAI,KAAK,GAAG,gBAAgB,IAAI,KAAK,GAAG,iBAAiB,IAAI,GAC/E,OAAO,KAAK;AAIhB"}

package/esm/dev-server/file-event-handler.mjs

@@ -5,7 +5,7 @@ import { clearFileExistsCache } from "./parse-imports.mjs";
 import { isCodeFile } from "./special-file-patterns.mjs";
 import events from "@mongez/events";
 
-//#region ../core/src/dev-server/file-event-handler.ts
+//#region ../../packages/core/src/dev-server/file-event-handler.ts
 /** Lets an isolated editor save reach HMR without the former fixed 50ms delay. */
 const ISOLATED_SAVE_QUIET_WINDOW_MS = 12;
 /** Bounds a sustained formatter or checkout stream so it cannot postpone HMR forever. */

package/esm/dev-server/file-event-handler.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"file-event-handler.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/file-event-handler.ts"],"sourcesContent":["import events from \"@mongez/events\";\nimport type { DependencyGraph } from \"./dependency-graph\";\nimport { devLogSuccess } from \"./dev-logger\";\nimport type { FileManager } from \"./file-manager\";\nimport type { FileOperations } from \"./file-operations\";\nimport { FILE_PROCESSING_BATCH_SIZE, isTimingsEnabled } from \"./flags\";\nimport type { ManifestManager } from \"./manifest-manager\";\nimport { clearFileExistsCache } from \"./parse-imports\";\nimport { isCodeFile } from \"./special-file-patterns\";\nimport { Path } from \"../utils/normalized-path\";\n\n/** Lets an isolated editor save reach HMR without the former fixed 50ms delay. */\nconst ISOLATED_SAVE_QUIET_WINDOW_MS = 12;\n\n/** Bounds a sustained formatter or checkout stream so it cannot postpone HMR forever. */\nconst BATCH_MAX_WAIT_MS = 60;\n\n/**\n * Receives raw watcher events and processes them in a single debounced batch.\n * Order within a batch: adds → changes → deletes, so changes can reference\n * newly-added files and deletes fire last.\n */\nexport class FileEventHandler {\n  private pendingChanges = new Set<string>();\n  private pendingAdds = new Set<string>();\n  private pendingDeletes = new Set<string>();\n\n  /** When this batch's first watcher event arrived — the debounce-wait phase start. */\n  private batchStartedAt?: number;\n\n  /** Slowest watcher-settle duration seen so far this batch, when `devServer.timings` is on. */\n  private watcherSettleMs?: number;\n\n  /** Tail of the batch-processing chain; keeps batches strictly sequential. */\n  private batchQueue: Promise<void> = Promise.resolve();\n\n  private debounceTimer?: ReturnType<typeof setTimeout>;\n  private maxWaitTimer?: ReturnType<typeof setTimeout>;\n\n  constructor(\n    private readonly fileOperations: FileOperations,\n    private readonly manifest: ManifestManager,\n    private readonly dependencyGraph: DependencyGraph,\n    private readonly files: Map<string, FileManager>,\n  ) {}\n\n  /** Matches paths the user listed in `devServer.watch.include`. */\n  private includeMatcher: (path: string) => boolean = () => false;\n\n  /**\n   * Non-code files in the include set (`.sql` fixtures, JSON config) can't be\n   * hot-reloaded, so they are reported as restart triggers instead.\n   */\n  public setIncludeMatcher(matcher: (path: string) => boolean): void {\n    this.includeMatcher = matcher;\n  }\n\n  public handleFileChange(absolutePath: string, settleMs?: number): void {\n    this.recordTimingStart(settleMs);\n    this.pendingChanges.add(Path.toRelative(absolutePath));\n    this.schedulePendingEvents();\n  }\n\n  public handleFileAdd(absolutePath: string, settleMs?: number): void {\n    this.recordTimingStart(settleMs);\n    this.pendingAdds.add(Path.toRelative(absolutePath));\n    this.schedulePendingEvents();\n  }\n\n  public handleFileDelete(absolutePath: string, settleMs?: number): void {\n    this.recordTimingStart(settleMs);\n    this.pendingDeletes.add(Path.toRelative(absolutePath));\n    this.schedulePendingEvents();\n  }\n\n  private schedulePendingEvents(): void {\n    if (this.debounceTimer !== undefined) {\n      clearTimeout(this.debounceTimer);\n    }\n\n    this.debounceTimer = setTimeout(() => this.flushPendingEvents(), ISOLATED_SAVE_QUIET_WINDOW_MS);\n\n    if (this.maxWaitTimer === undefined) {\n      this.maxWaitTimer = setTimeout(() => this.flushPendingEvents(), BATCH_MAX_WAIT_MS);\n    }\n  }\n\n  private flushPendingEvents(): void {\n    if (this.debounceTimer !== undefined) {\n      clearTimeout(this.debounceTimer);\n      this.debounceTimer = undefined;\n    }\n\n    if (this.maxWaitTimer !== undefined) {\n      clearTimeout(this.maxWaitTimer);\n      this.maxWaitTimer = undefined;\n    }\n\n    // Serialize: a batch arriving while the previous one is in flight queues\n    // behind it (pending sets keep coalescing meanwhile) instead of racing it.\n    this.batchQueue = this.batchQueue\n      .then(() => this.processBatch())\n      .catch((error) => {\n        console.error(\"[dev-server] batch processing failed\", error);\n      });\n  }\n\n  /**\n   * Mark the debounce-wait phase start on the first event of a batch, and\n   * track the slowest watcher-settle duration seen this batch. `settleMs`\n   * only arrives when `devServer.timings` is on (see `FilesWatcher`), so\n   * this is a no-op past the cheap `performance.now()` call when it's off.\n   */\n  private recordTimingStart(settleMs?: number): void {\n    if (this.batchStartedAt === undefined) {\n      this.batchStartedAt = performance.now();\n    }\n\n    if (settleMs === undefined) return;\n\n    this.watcherSettleMs =\n      this.watcherSettleMs === undefined ? settleMs : Math.max(this.watcherSettleMs, settleMs);\n  }\n\n  private async processBatch(): Promise<void> {\n    const changes = Array.from(this.pendingChanges);\n    const adds = Array.from(this.pendingAdds);\n    const deletes = Array.from(this.pendingDeletes);\n\n    this.pendingChanges.clear();\n    this.pendingAdds.clear();\n    this.pendingDeletes.clear();\n\n    const debounceWaitMs =\n      this.batchStartedAt !== undefined ? performance.now() - this.batchStartedAt : undefined;\n    const watcherSettleMs = this.watcherSettleMs;\n    this.batchStartedAt = undefined;\n    this.watcherSettleMs = undefined;\n\n    if (changes.length === 0 && adds.length === 0 && deletes.length === 0) return;\n\n    // Both .env files and warlock.config.ts live outside src/ — they should\n    // never enter the dep graph, only ride along in the batch event so the\n    // dev server can react (config reload / restart warning).\n    const isIncludedData = (p: string) => !isCodeFile(p) && this.includeMatcher(p);\n    const isExternal = (p: string) => isExternalPath(p) || isIncludedData(p);\n    const externalChanges = changes.filter(isExternal);\n    const externalAdds = adds.filter(isExternal);\n    const codeChanges = changes.filter((p) => !isExternal(p));\n    const codeAdds = adds.filter((p) => !isExternal(p));\n    const restartTriggers = [...changes, ...adds, ...deletes].filter(isIncludedData);\n\n    // Multi-file batches can race the filesystem on Windows.\n    if (codeAdds.length + codeChanges.length > 1) {\n      await new Promise((resolve) => setTimeout(resolve, 500));\n      clearFileExistsCache();\n    }\n\n    const { added: addedCodePaths, vanished } = await this.processBatchAdds(codeAdds);\n    const changedCodePaths = await this.processBatchChanges(codeChanges);\n    await this.processBatchDeletes(deletes);\n\n    this.fileOperations.updateFileDependents();\n    this.fileOperations.syncFilesToManifest();\n    await this.manifest.save();\n\n    // Emit only the code paths that genuinely changed (hash differs). A no-op\n    // save — an editor that fsyncs without writing — reports no change and is\n    // dropped here, where we still know the pre-change hash. (Doing this\n    // downstream is impossible: the source has already been overwritten, so a\n    // content compare always looks unchanged — which is exactly why emptying a\n    // file used to silently skip HMR.) External paths (.env / warlock.config.ts)\n    // ride along untouched so the dev server can still react to them. Paths\n    // that vanished between the add event and their read/stat (a rename or\n    // move racing the filesystem) are folded into `deleted` instead of\n    // `added` — they were already unwound as deletions in processBatchAdds.\n    events.trigger(\"dev-server:batch-complete\", {\n      added: [...externalAdds, ...addedCodePaths],\n      changed: [...externalChanges, ...changedCodePaths],\n      deleted: [...deletes.filter((p) => !isIncludedData(p)), ...vanished],\n      restartTriggers,\n      timings: isTimingsEnabled()\n        ? { watcherSettleMs: watcherSettleMs ?? 0, debounceWaitMs: debounceWaitMs ?? 0 }\n        : undefined,\n    });\n  }\n\n  /**\n   * Reprocess each changed file and return only the paths that genuinely\n   * changed. `updateFile` returns false when the on-disk hash matches the\n   * last-processed hash (e.g. an editor that fsyncs on save without writing),\n   * so those no-ops are kept out of the reload batch. Emptying a file changes\n   * its hash, so it is correctly reported as changed.\n   */\n  private async processBatchChanges(relativePaths: string[]): Promise<string[]> {\n    const changed: string[] = [];\n    await runInBatches(relativePaths, FILE_PROCESSING_BATCH_SIZE, async (path) => {\n      if (await this.fileOperations.updateFile(path)) {\n        changed.push(path);\n      }\n    });\n    return changed;\n  }\n\n  /**\n   * Process pending add events. Returns the paths that genuinely became\n   * available (`added`) separately from paths that no longer existed by the\n   * time they were read/stat'd (`vanished`) — the latter is a rename or move\n   * racing the filesystem, not a failure, so it is unwound as a deletion\n   * instead of being logged as an error.\n   */\n  private async processBatchAdds(\n    relativePaths: string[],\n  ): Promise<{ added: string[]; vanished: string[] }> {\n    const added: string[] = [];\n    const vanished: string[] = [];\n\n    await runInBatches(relativePaths, FILE_PROCESSING_BATCH_SIZE, async (path) => {\n      try {\n        const fileManager = await this.fileOperations.addFile(path);\n\n        if (fileManager.state === \"deleted\") {\n          await this.fileOperations.deleteFile(path);\n          vanished.push(path);\n          return;\n        }\n\n        added.push(path);\n        devLogSuccess(`Added file: ${path}`);\n      } catch (error) {\n        console.error(`Failed to add file ${path}:`, error);\n      }\n    });\n\n    return { added, vanished };\n  }\n\n  private async processBatchDeletes(relativePaths: string[]): Promise<void> {\n    for (const relativePath of relativePaths) {\n      await this.fileOperations.deleteFile(relativePath);\n      devLogSuccess(`Deleted file: ${relativePath}`);\n    }\n  }\n}\n\nfunction isEnvFile(path: string): boolean {\n  const basename = path.split(\"/\").pop() || path;\n  return basename === \".env\" || basename.startsWith(\".env.\");\n}\n\n/** Paths watched but never added to the dependency graph. */\nfunction isExternalPath(path: string): boolean {\n  return isEnvFile(path) || path === \"warlock.config.ts\";\n}\n\nasync function runInBatches<T>(\n  items: T[],\n  size: number,\n  fn: (item: T) => Promise<unknown>,\n): Promise<void> {\n  if (items.length === 0) return;\n  for (let i = 0; i < items.length; i += size) {\n    await Promise.all(items.slice(i, i + size).map(fn));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"file-event-handler.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/file-event-handler.ts"],"sourcesContent":["import events from \"@mongez/events\";\nimport type { DependencyGraph } from \"./dependency-graph\";\nimport { devLogSuccess } from \"./dev-logger\";\nimport type { FileManager } from \"./file-manager\";\nimport type { FileOperations } from \"./file-operations\";\nimport { FILE_PROCESSING_BATCH_SIZE, isTimingsEnabled } from \"./flags\";\nimport type { ManifestManager } from \"./manifest-manager\";\nimport { clearFileExistsCache } from \"./parse-imports\";\nimport { isCodeFile } from \"./special-file-patterns\";\nimport { Path } from \"../utils/normalized-path\";\n\n/** Lets an isolated editor save reach HMR without the former fixed 50ms delay. */\nconst ISOLATED_SAVE_QUIET_WINDOW_MS = 12;\n\n/** Bounds a sustained formatter or checkout stream so it cannot postpone HMR forever. */\nconst BATCH_MAX_WAIT_MS = 60;\n\n/**\n * Receives raw watcher events and processes them in a single debounced batch.\n * Order within a batch: adds → changes → deletes, so changes can reference\n * newly-added files and deletes fire last.\n */\nexport class FileEventHandler {\n  private pendingChanges = new Set<string>();\n  private pendingAdds = new Set<string>();\n  private pendingDeletes = new Set<string>();\n\n  /** When this batch's first watcher event arrived — the debounce-wait phase start. */\n  private batchStartedAt?: number;\n\n  /** Slowest watcher-settle duration seen so far this batch, when `devServer.timings` is on. */\n  private watcherSettleMs?: number;\n\n  /** Tail of the batch-processing chain; keeps batches strictly sequential. */\n  private batchQueue: Promise<void> = Promise.resolve();\n\n  private debounceTimer?: ReturnType<typeof setTimeout>;\n  private maxWaitTimer?: ReturnType<typeof setTimeout>;\n\n  constructor(\n    private readonly fileOperations: FileOperations,\n    private readonly manifest: ManifestManager,\n    private readonly dependencyGraph: DependencyGraph,\n    private readonly files: Map<string, FileManager>,\n  ) {}\n\n  /** Matches paths the user listed in `devServer.watch.include`. */\n  private includeMatcher: (path: string) => boolean = () => false;\n\n  /**\n   * Non-code files in the include set (`.sql` fixtures, JSON config) can't be\n   * hot-reloaded, so they are reported as restart triggers instead.\n   */\n  public setIncludeMatcher(matcher: (path: string) => boolean): void {\n    this.includeMatcher = matcher;\n  }\n\n  public handleFileChange(absolutePath: string, settleMs?: number): void {\n    this.recordTimingStart(settleMs);\n    this.pendingChanges.add(Path.toRelative(absolutePath));\n    this.schedulePendingEvents();\n  }\n\n  public handleFileAdd(absolutePath: string, settleMs?: number): void {\n    this.recordTimingStart(settleMs);\n    this.pendingAdds.add(Path.toRelative(absolutePath));\n    this.schedulePendingEvents();\n  }\n\n  public handleFileDelete(absolutePath: string, settleMs?: number): void {\n    this.recordTimingStart(settleMs);\n    this.pendingDeletes.add(Path.toRelative(absolutePath));\n    this.schedulePendingEvents();\n  }\n\n  private schedulePendingEvents(): void {\n    if (this.debounceTimer !== undefined) {\n      clearTimeout(this.debounceTimer);\n    }\n\n    this.debounceTimer = setTimeout(() => this.flushPendingEvents(), ISOLATED_SAVE_QUIET_WINDOW_MS);\n\n    if (this.maxWaitTimer === undefined) {\n      this.maxWaitTimer = setTimeout(() => this.flushPendingEvents(), BATCH_MAX_WAIT_MS);\n    }\n  }\n\n  private flushPendingEvents(): void {\n    if (this.debounceTimer !== undefined) {\n      clearTimeout(this.debounceTimer);\n      this.debounceTimer = undefined;\n    }\n\n    if (this.maxWaitTimer !== undefined) {\n      clearTimeout(this.maxWaitTimer);\n      this.maxWaitTimer = undefined;\n    }\n\n    // Serialize: a batch arriving while the previous one is in flight queues\n    // behind it (pending sets keep coalescing meanwhile) instead of racing it.\n    this.batchQueue = this.batchQueue\n      .then(() => this.processBatch())\n      .catch((error) => {\n        console.error(\"[dev-server] batch processing failed\", error);\n      });\n  }\n\n  /**\n   * Mark the debounce-wait phase start on the first event of a batch, and\n   * track the slowest watcher-settle duration seen this batch. `settleMs`\n   * only arrives when `devServer.timings` is on (see `FilesWatcher`), so\n   * this is a no-op past the cheap `performance.now()` call when it's off.\n   */\n  private recordTimingStart(settleMs?: number): void {\n    if (this.batchStartedAt === undefined) {\n      this.batchStartedAt = performance.now();\n    }\n\n    if (settleMs === undefined) return;\n\n    this.watcherSettleMs =\n      this.watcherSettleMs === undefined ? settleMs : Math.max(this.watcherSettleMs, settleMs);\n  }\n\n  private async processBatch(): Promise<void> {\n    const changes = Array.from(this.pendingChanges);\n    const adds = Array.from(this.pendingAdds);\n    const deletes = Array.from(this.pendingDeletes);\n\n    this.pendingChanges.clear();\n    this.pendingAdds.clear();\n    this.pendingDeletes.clear();\n\n    const debounceWaitMs =\n      this.batchStartedAt !== undefined ? performance.now() - this.batchStartedAt : undefined;\n    const watcherSettleMs = this.watcherSettleMs;\n    this.batchStartedAt = undefined;\n    this.watcherSettleMs = undefined;\n\n    if (changes.length === 0 && adds.length === 0 && deletes.length === 0) return;\n\n    // Both .env files and warlock.config.ts live outside src/ — they should\n    // never enter the dep graph, only ride along in the batch event so the\n    // dev server can react (config reload / restart warning).\n    const isIncludedData = (p: string) => !isCodeFile(p) && this.includeMatcher(p);\n    const isExternal = (p: string) => isExternalPath(p) || isIncludedData(p);\n    const externalChanges = changes.filter(isExternal);\n    const externalAdds = adds.filter(isExternal);\n    const codeChanges = changes.filter((p) => !isExternal(p));\n    const codeAdds = adds.filter((p) => !isExternal(p));\n    const restartTriggers = [...changes, ...adds, ...deletes].filter(isIncludedData);\n\n    // Multi-file batches can race the filesystem on Windows.\n    if (codeAdds.length + codeChanges.length > 1) {\n      await new Promise((resolve) => setTimeout(resolve, 500));\n      clearFileExistsCache();\n    }\n\n    const { added: addedCodePaths, vanished } = await this.processBatchAdds(codeAdds);\n    const changedCodePaths = await this.processBatchChanges(codeChanges);\n    await this.processBatchDeletes(deletes);\n\n    this.fileOperations.updateFileDependents();\n    this.fileOperations.syncFilesToManifest();\n    await this.manifest.save();\n\n    // Emit only the code paths that genuinely changed (hash differs). A no-op\n    // save — an editor that fsyncs without writing — reports no change and is\n    // dropped here, where we still know the pre-change hash. (Doing this\n    // downstream is impossible: the source has already been overwritten, so a\n    // content compare always looks unchanged — which is exactly why emptying a\n    // file used to silently skip HMR.) External paths (.env / warlock.config.ts)\n    // ride along untouched so the dev server can still react to them. Paths\n    // that vanished between the add event and their read/stat (a rename or\n    // move racing the filesystem) are folded into `deleted` instead of\n    // `added` — they were already unwound as deletions in processBatchAdds.\n    events.trigger(\"dev-server:batch-complete\", {\n      added: [...externalAdds, ...addedCodePaths],\n      changed: [...externalChanges, ...changedCodePaths],\n      deleted: [...deletes.filter((p) => !isIncludedData(p)), ...vanished],\n      restartTriggers,\n      timings: isTimingsEnabled()\n        ? { watcherSettleMs: watcherSettleMs ?? 0, debounceWaitMs: debounceWaitMs ?? 0 }\n        : undefined,\n    });\n  }\n\n  /**\n   * Reprocess each changed file and return only the paths that genuinely\n   * changed. `updateFile` returns false when the on-disk hash matches the\n   * last-processed hash (e.g. an editor that fsyncs on save without writing),\n   * so those no-ops are kept out of the reload batch. Emptying a file changes\n   * its hash, so it is correctly reported as changed.\n   */\n  private async processBatchChanges(relativePaths: string[]): Promise<string[]> {\n    const changed: string[] = [];\n    await runInBatches(relativePaths, FILE_PROCESSING_BATCH_SIZE, async (path) => {\n      if (await this.fileOperations.updateFile(path)) {\n        changed.push(path);\n      }\n    });\n    return changed;\n  }\n\n  /**\n   * Process pending add events. Returns the paths that genuinely became\n   * available (`added`) separately from paths that no longer existed by the\n   * time they were read/stat'd (`vanished`) — the latter is a rename or move\n   * racing the filesystem, not a failure, so it is unwound as a deletion\n   * instead of being logged as an error.\n   */\n  private async processBatchAdds(\n    relativePaths: string[],\n  ): Promise<{ added: string[]; vanished: string[] }> {\n    const added: string[] = [];\n    const vanished: string[] = [];\n\n    await runInBatches(relativePaths, FILE_PROCESSING_BATCH_SIZE, async (path) => {\n      try {\n        const fileManager = await this.fileOperations.addFile(path);\n\n        if (fileManager.state === \"deleted\") {\n          await this.fileOperations.deleteFile(path);\n          vanished.push(path);\n          return;\n        }\n\n        added.push(path);\n        devLogSuccess(`Added file: ${path}`);\n      } catch (error) {\n        console.error(`Failed to add file ${path}:`, error);\n      }\n    });\n\n    return { added, vanished };\n  }\n\n  private async processBatchDeletes(relativePaths: string[]): Promise<void> {\n    for (const relativePath of relativePaths) {\n      await this.fileOperations.deleteFile(relativePath);\n      devLogSuccess(`Deleted file: ${relativePath}`);\n    }\n  }\n}\n\nfunction isEnvFile(path: string): boolean {\n  const basename = path.split(\"/\").pop() || path;\n  return basename === \".env\" || basename.startsWith(\".env.\");\n}\n\n/** Paths watched but never added to the dependency graph. */\nfunction isExternalPath(path: string): boolean {\n  return isEnvFile(path) || path === \"warlock.config.ts\";\n}\n\nasync function runInBatches<T>(\n  items: T[],\n  size: number,\n  fn: (item: T) => Promise<unknown>,\n): Promise<void> {\n  if (items.length === 0) return;\n  for (let i = 0; i < items.length; i += size) {\n    await Promise.all(items.slice(i, i + size).map(fn));\n  }\n}\n"],"mappings":"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"}

package/esm/dev-server/file-manager.d.mts

@@ -1,7 +1,7 @@
 import { FileManifest, FileState, FileType } from "./types.mjs";
 import { FileOperations } from "./file-operations.mjs";
 
-//#region ../core/src/dev-server/file-manager.d.ts
+//#region ../../packages/core/src/dev-server/file-manager.d.ts
 type CleanupFunction = () => void;
 /**
  * FileManager — per-file metadata for the dependency graph.

package/esm/dev-server/file-manager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"file-manager.d.mts","names":[],"sources":["../../../../../../../core/src/dev-server/file-manager.ts"],"mappings":";;;;KASY,eAAA;;AAAZ;;;;AAA2B;AAyB3B;;cAAa,WAAA;EAAA,SAgCO,YAAA;EACT,KAAA,EAAO,GAAA,SAAY,WAAA;EACnB,cAAA,EAAgB,cAAA;EAjClB,YAAA;EACA,YAAA;EACA,IAAA;EACA,MAAA;EAiBM;EAdN,YAAA,EAAY,GAAA;EAsBL;;;;EAhBP,oBAAA,EAAoB,GAAA;EAwBkB;EArBtC,SAAA,EAAS,GAAA;EAmCiB;EAhC1B,UAAA,EAAU,GAAA;EAEV,IAAA,EAAM,QAAA;EAwDsD;EArD5D,OAAA,EAAS,eAAA;EAoIuC;EAjIhD,cAAA;EAEA,KAAA,EAAO,SAAA;cAGI,YAAA,UACT,KAAA,EAAO,GAAA,SAAY,WAAA,GACnB,cAAA,EAAgB,cAAA;EAGlB,UAAA,CAAW,OAAA,EAAS,eAAA,GAAkB,eAAA;EAMtC,YAAA;EAXW;;;;EAmBL,IAAA,CAAK,YAAA,GAAe,OAAA,CAAQ,YAAA,IAAgB,OAAA;EAjBhC;;;;;;;;;;;;;;;EA2CZ,OAAA;IAAU;EAAA;IAAmB,KAAA;EAAA,IAAyB,OAAA;EAhD5D;;;;;;EAAA,UA+FS,qBAAA,IAAyB,OAAA;EA1FhB;;;;;EAAA,UA0HT,gBAAA,CAAiB,YAAA,EAAc,OAAA,CAAQ,YAAA,IAAgB,OAAA;EAAA,UA6B7D,cAAA;EAuBH,UAAA,IAAc,YAAA;AAAA"}
+{"version":3,"file":"file-manager.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/file-manager.ts"],"mappings":";;;;KASY,eAAA;;AAAZ;;;;AAA2B;AAyB3B;;cAAa,WAAA;EAAA,SAgCO,YAAA;EACT,KAAA,EAAO,GAAA,SAAY,WAAA;EACnB,cAAA,EAAgB,cAAA;EAjClB,YAAA;EACA,YAAA;EACA,IAAA;EACA,MAAA;EAiBM;EAdN,YAAA,EAAY,GAAA;EAsBL;;;;EAhBP,oBAAA,EAAoB,GAAA;EAwBkB;EArBtC,SAAA,EAAS,GAAA;EAmCiB;EAhC1B,UAAA,EAAU,GAAA;EAEV,IAAA,EAAM,QAAA;EAwDsD;EArD5D,OAAA,EAAS,eAAA;EAoIuC;EAjIhD,cAAA;EAEA,KAAA,EAAO,SAAA;cAGI,YAAA,UACT,KAAA,EAAO,GAAA,SAAY,WAAA,GACnB,cAAA,EAAgB,cAAA;EAGlB,UAAA,CAAW,OAAA,EAAS,eAAA,GAAkB,eAAA;EAMtC,YAAA;EAXW;;;;EAmBL,IAAA,CAAK,YAAA,GAAe,OAAA,CAAQ,YAAA,IAAgB,OAAA;EAjBhC;;;;;;;;;;;;;;;EA2CZ,OAAA;IAAU;EAAA;IAAmB,KAAA;EAAA,IAAyB,OAAA;EAhD5D;;;;;;EAAA,UA+FS,qBAAA,IAAyB,OAAA;EA1FhB;;;;;EAAA,UA0HT,gBAAA,CAAiB,YAAA,EAAc,OAAA,CAAQ,YAAA,IAAgB,OAAA;EAAA,UA6B7D,cAAA;EAuBH,UAAA,IAAc,YAAA;AAAA"}

package/esm/dev-server/file-manager.mjs

@@ -5,7 +5,7 @@ import events from "@mongez/events";
 import { getFileAsync, lastModifiedAsync } from "@warlock.js/fs";
 import crypto from "crypto";
 
-//#region ../core/src/dev-server/file-manager.ts
+//#region ../../packages/core/src/dev-server/file-manager.ts
 /**
 * Whether `error` is a Node `ENOENT` (path does not exist) error. Used to
 * distinguish a file that has genuinely vanished between the watcher event

package/esm/dev-server/file-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"file-manager.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/file-manager.ts"],"sourcesContent":["import events from \"@mongez/events\";\nimport { getFileAsync, lastModifiedAsync } from \"@warlock.js/fs\";\nimport crypto from \"crypto\";\nimport { DEV_SERVER_EVENTS } from \"./events\";\nimport { type FileOperations } from \"./file-operations\";\nimport { isTypeOnlyFile, parseImports } from \"./parse-imports\";\nimport { Path } from \"../utils/normalized-path\";\nimport type { FileManifest, FileState, FileType } from \"./types\";\n\nexport type CleanupFunction = () => void;\n\n/**\n * Whether `error` is a Node `ENOENT` (path does not exist) error. Used to\n * distinguish a file that has genuinely vanished between the watcher event\n * and its read/stat (a rename or move racing the filesystem) from a real\n * failure such as `EACCES` or a parse error, which must still surface.\n */\nfunction isEnoentError(error: unknown): boolean {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    (error as NodeJS.ErrnoException).code === \"ENOENT\"\n  );\n}\n\n/**\n * FileManager — per-file metadata for the dependency graph.\n *\n * The loader hook transpiles and caches on-demand at import time, so this\n * class never touches disk for anything beyond reading source to hash it\n * and parse its imports. Its job is keeping the metadata that the\n * orchestrator needs to invalidate dependents on change.\n */\nexport class FileManager {\n  public relativePath = \"\";\n  public lastModified = 0;\n  public hash = \"\";\n  public source = \"\";\n\n  /** Files this file imports (relative paths). */\n  public dependencies = new Set<string>();\n\n  /**\n   * Subset of `dependencies` reached only through type-only imports — a single\n   * runtime occurrence makes the whole edge runtime.\n   */\n  public typeOnlyDependencies = new Set<string>();\n\n  /** Original specifier → resolved absolute path. */\n  public importMap = new Map<string, string>();\n\n  /** Files that import this file (relative paths). */\n  public dependents = new Set<string>();\n\n  public type: FileType | undefined;\n\n  /** Cleanup hooks the loaded module registered for itself. */\n  public cleanup: CleanupFunction[] = [];\n\n  /** Whether the source has zero runtime imports/exports. */\n  public isTypeOnlyFile = false;\n\n  public state: FileState = \"idle\";\n\n  public constructor(\n    public readonly absolutePath: string,\n    public files: Map<string, FileManager>,\n    public fileOperations: FileOperations,\n  ) {}\n\n  public addCleanup(cleanup: CleanupFunction | CleanupFunction[]) {\n    const next = Array.isArray(cleanup) ? cleanup : [cleanup];\n    this.cleanup.push(...next);\n    this.cleanup = [...new Set(this.cleanup)];\n  }\n\n  public resetCleanup() {\n    this.cleanup = [];\n  }\n\n  /**\n   * Initial setup. Restores from manifest if the hash still matches,\n   * otherwise re-processes from disk.\n   */\n  public async init(fileManifest?: Partial<FileManifest>): Promise<void> {\n    this.relativePath = Path.toRelative(this.absolutePath);\n    this.detectFileType();\n\n    if (fileManifest) {\n      await this.initFromManifest(fileManifest);\n    } else {\n      await this.process();\n    }\n  }\n\n  /**\n   * Read source, hash, parse imports, emit ready. The only file-system\n   * touch happens here; transpilation is the loader hook's job.\n   *\n   * Both the read and the stat happen up front, before anything on this\n   * instance is mutated. A path that disappears between the watcher event\n   * and either of those calls (`ENOENT`) — typically a rename or move\n   * racing the filesystem — is treated as a deletion rather than a thrown\n   * error, and never leaves `source`/`hash` pointing at content that then\n   * vanished. A real failure (`EACCES`, a permissions error, etc.) still\n   * throws.\n   *\n   * @param force - re-parse even when the hash matches.\n   * @returns true if the file was (re)parsed.\n   */\n  public async process({ force = false }: { force?: boolean } = {}): Promise<boolean> {\n    if (!this.relativePath) this.relativePath = Path.toRelative(this.absolutePath);\n    if (!this.type) this.detectFileType();\n\n    this.state = \"loading\";\n\n    let newSource: string;\n    let modifiedTime: Date;\n\n    try {\n      newSource = await getFileAsync(this.absolutePath);\n      modifiedTime = await lastModifiedAsync(this.absolutePath);\n    } catch (error) {\n      if (isEnoentError(error)) {\n        this.state = \"deleted\";\n        return false;\n      }\n\n      throw error;\n    }\n\n    const newHash = crypto.createHash(\"sha256\").update(newSource).digest(\"hex\");\n\n    if (!force && newHash === this.hash) {\n      this.state = \"ready\";\n      return false;\n    }\n\n    this.source = newSource;\n    this.hash = newHash;\n    this.lastModified = modifiedTime.getTime();\n\n    await this.rebuildImportMetadata();\n    this.isTypeOnlyFile = isTypeOnlyFile(this.source);\n\n    this.state = \"ready\";\n    events.trigger(DEV_SERVER_EVENTS.FILE_READY, this);\n\n    return true;\n  }\n\n  /**\n   * Parse the current source and refresh `importMap`, `dependencies`, and\n   * `typeOnlyDependencies`. A dependency is classified type-only iff every\n   * import/export statement that resolves to it is type-only — a single\n   * runtime reference makes the whole edge runtime.\n   */\n  protected async rebuildImportMetadata(): Promise<void> {\n    const resolved = await parseImports(this.source, this.absolutePath);\n\n    this.importMap = new Map();\n    this.dependencies = new Set();\n    this.typeOnlyDependencies = new Set();\n\n    const runtimePaths = new Set<string>();\n\n    for (const [originalPath, { absolutePath, isTypeOnly }] of resolved) {\n      this.importMap.set(originalPath, absolutePath);\n\n      const relativePath = Path.toRelative(absolutePath);\n      this.dependencies.add(relativePath);\n\n      if (!isTypeOnly) {\n        runtimePaths.add(relativePath);\n      }\n    }\n\n    for (const dependency of this.dependencies) {\n      if (!runtimePaths.has(dependency)) {\n        this.typeOnlyDependencies.add(dependency);\n      }\n    }\n  }\n\n  /**\n   * Restore from a cached manifest entry. If the on-disk hash matches the\n   * manifest hash, dep-graph metadata is restored from the manifest without\n   * re-parsing. Otherwise the file is reprocessed.\n   */\n  protected async initFromManifest(fileManifest: Partial<FileManifest>): Promise<void> {\n    this.type = fileManifest.type;\n\n    this.state = \"loading\";\n\n    try {\n      this.source = await getFileAsync(this.absolutePath);\n    } catch {\n      this.state = \"deleted\";\n      return;\n    }\n\n    const currentHash = crypto.createHash(\"sha256\").update(this.source).digest(\"hex\");\n\n    if (currentHash !== fileManifest.hash) {\n      await this.process({ force: true });\n      return;\n    }\n\n    this.hash = fileManifest.hash!;\n    this.lastModified = fileManifest.lastModified!;\n    this.dependencies = new Set(fileManifest.dependencies || []);\n    this.typeOnlyDependencies = new Set(fileManifest.typeOnlyDependencies || []);\n    this.dependents = new Set(fileManifest.dependents || []);\n\n    this.state = \"ready\";\n    events.trigger(DEV_SERVER_EVENTS.FILE_READY, this);\n  }\n\n  protected detectFileType(): void {\n    const path = this.relativePath;\n\n    if (/(^|\\/)main\\.tsx?$/.test(path)) {\n      this.type = \"main\";\n    } else if (/\\.model\\.tsx?$/.test(path)) {\n      // Before the folder-name checks below: `events/models/x.model.ts` is a model.\n      this.type = \"model\";\n    } else if (path.startsWith(\"src/config/\")) {\n      this.type = \"config\";\n    } else if (path.endsWith(\"routes.ts\") || path.endsWith(\"routes.tsx\")) {\n      this.type = \"route\";\n    } else if (path.includes(\"/events/\")) {\n      this.type = \"event\";\n    } else if (path.includes(\"controller\")) {\n      this.type = \"controller\";\n    } else if (path.includes(\"service\")) {\n      this.type = \"service\";\n    } else {\n      this.type = \"other\";\n    }\n  }\n\n  public toManifest(): FileManifest {\n    return {\n      absolutePath: this.absolutePath,\n      relativePath: this.relativePath,\n      lastModified: this.lastModified,\n      hash: this.hash,\n      dependencies: Array.from(this.dependencies),\n      typeOnlyDependencies: Array.from(this.typeOnlyDependencies),\n      dependents: Array.from(this.dependents),\n      type: this.type!,\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"file-manager.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/file-manager.ts"],"sourcesContent":["import events from \"@mongez/events\";\nimport { getFileAsync, lastModifiedAsync } from \"@warlock.js/fs\";\nimport crypto from \"crypto\";\nimport { DEV_SERVER_EVENTS } from \"./events\";\nimport { type FileOperations } from \"./file-operations\";\nimport { isTypeOnlyFile, parseImports } from \"./parse-imports\";\nimport { Path } from \"../utils/normalized-path\";\nimport type { FileManifest, FileState, FileType } from \"./types\";\n\nexport type CleanupFunction = () => void;\n\n/**\n * Whether `error` is a Node `ENOENT` (path does not exist) error. Used to\n * distinguish a file that has genuinely vanished between the watcher event\n * and its read/stat (a rename or move racing the filesystem) from a real\n * failure such as `EACCES` or a parse error, which must still surface.\n */\nfunction isEnoentError(error: unknown): boolean {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    (error as NodeJS.ErrnoException).code === \"ENOENT\"\n  );\n}\n\n/**\n * FileManager — per-file metadata for the dependency graph.\n *\n * The loader hook transpiles and caches on-demand at import time, so this\n * class never touches disk for anything beyond reading source to hash it\n * and parse its imports. Its job is keeping the metadata that the\n * orchestrator needs to invalidate dependents on change.\n */\nexport class FileManager {\n  public relativePath = \"\";\n  public lastModified = 0;\n  public hash = \"\";\n  public source = \"\";\n\n  /** Files this file imports (relative paths). */\n  public dependencies = new Set<string>();\n\n  /**\n   * Subset of `dependencies` reached only through type-only imports — a single\n   * runtime occurrence makes the whole edge runtime.\n   */\n  public typeOnlyDependencies = new Set<string>();\n\n  /** Original specifier → resolved absolute path. */\n  public importMap = new Map<string, string>();\n\n  /** Files that import this file (relative paths). */\n  public dependents = new Set<string>();\n\n  public type: FileType | undefined;\n\n  /** Cleanup hooks the loaded module registered for itself. */\n  public cleanup: CleanupFunction[] = [];\n\n  /** Whether the source has zero runtime imports/exports. */\n  public isTypeOnlyFile = false;\n\n  public state: FileState = \"idle\";\n\n  public constructor(\n    public readonly absolutePath: string,\n    public files: Map<string, FileManager>,\n    public fileOperations: FileOperations,\n  ) {}\n\n  public addCleanup(cleanup: CleanupFunction | CleanupFunction[]) {\n    const next = Array.isArray(cleanup) ? cleanup : [cleanup];\n    this.cleanup.push(...next);\n    this.cleanup = [...new Set(this.cleanup)];\n  }\n\n  public resetCleanup() {\n    this.cleanup = [];\n  }\n\n  /**\n   * Initial setup. Restores from manifest if the hash still matches,\n   * otherwise re-processes from disk.\n   */\n  public async init(fileManifest?: Partial<FileManifest>): Promise<void> {\n    this.relativePath = Path.toRelative(this.absolutePath);\n    this.detectFileType();\n\n    if (fileManifest) {\n      await this.initFromManifest(fileManifest);\n    } else {\n      await this.process();\n    }\n  }\n\n  /**\n   * Read source, hash, parse imports, emit ready. The only file-system\n   * touch happens here; transpilation is the loader hook's job.\n   *\n   * Both the read and the stat happen up front, before anything on this\n   * instance is mutated. A path that disappears between the watcher event\n   * and either of those calls (`ENOENT`) — typically a rename or move\n   * racing the filesystem — is treated as a deletion rather than a thrown\n   * error, and never leaves `source`/`hash` pointing at content that then\n   * vanished. A real failure (`EACCES`, a permissions error, etc.) still\n   * throws.\n   *\n   * @param force - re-parse even when the hash matches.\n   * @returns true if the file was (re)parsed.\n   */\n  public async process({ force = false }: { force?: boolean } = {}): Promise<boolean> {\n    if (!this.relativePath) this.relativePath = Path.toRelative(this.absolutePath);\n    if (!this.type) this.detectFileType();\n\n    this.state = \"loading\";\n\n    let newSource: string;\n    let modifiedTime: Date;\n\n    try {\n      newSource = await getFileAsync(this.absolutePath);\n      modifiedTime = await lastModifiedAsync(this.absolutePath);\n    } catch (error) {\n      if (isEnoentError(error)) {\n        this.state = \"deleted\";\n        return false;\n      }\n\n      throw error;\n    }\n\n    const newHash = crypto.createHash(\"sha256\").update(newSource).digest(\"hex\");\n\n    if (!force && newHash === this.hash) {\n      this.state = \"ready\";\n      return false;\n    }\n\n    this.source = newSource;\n    this.hash = newHash;\n    this.lastModified = modifiedTime.getTime();\n\n    await this.rebuildImportMetadata();\n    this.isTypeOnlyFile = isTypeOnlyFile(this.source);\n\n    this.state = \"ready\";\n    events.trigger(DEV_SERVER_EVENTS.FILE_READY, this);\n\n    return true;\n  }\n\n  /**\n   * Parse the current source and refresh `importMap`, `dependencies`, and\n   * `typeOnlyDependencies`. A dependency is classified type-only iff every\n   * import/export statement that resolves to it is type-only — a single\n   * runtime reference makes the whole edge runtime.\n   */\n  protected async rebuildImportMetadata(): Promise<void> {\n    const resolved = await parseImports(this.source, this.absolutePath);\n\n    this.importMap = new Map();\n    this.dependencies = new Set();\n    this.typeOnlyDependencies = new Set();\n\n    const runtimePaths = new Set<string>();\n\n    for (const [originalPath, { absolutePath, isTypeOnly }] of resolved) {\n      this.importMap.set(originalPath, absolutePath);\n\n      const relativePath = Path.toRelative(absolutePath);\n      this.dependencies.add(relativePath);\n\n      if (!isTypeOnly) {\n        runtimePaths.add(relativePath);\n      }\n    }\n\n    for (const dependency of this.dependencies) {\n      if (!runtimePaths.has(dependency)) {\n        this.typeOnlyDependencies.add(dependency);\n      }\n    }\n  }\n\n  /**\n   * Restore from a cached manifest entry. If the on-disk hash matches the\n   * manifest hash, dep-graph metadata is restored from the manifest without\n   * re-parsing. Otherwise the file is reprocessed.\n   */\n  protected async initFromManifest(fileManifest: Partial<FileManifest>): Promise<void> {\n    this.type = fileManifest.type;\n\n    this.state = \"loading\";\n\n    try {\n      this.source = await getFileAsync(this.absolutePath);\n    } catch {\n      this.state = \"deleted\";\n      return;\n    }\n\n    const currentHash = crypto.createHash(\"sha256\").update(this.source).digest(\"hex\");\n\n    if (currentHash !== fileManifest.hash) {\n      await this.process({ force: true });\n      return;\n    }\n\n    this.hash = fileManifest.hash!;\n    this.lastModified = fileManifest.lastModified!;\n    this.dependencies = new Set(fileManifest.dependencies || []);\n    this.typeOnlyDependencies = new Set(fileManifest.typeOnlyDependencies || []);\n    this.dependents = new Set(fileManifest.dependents || []);\n\n    this.state = \"ready\";\n    events.trigger(DEV_SERVER_EVENTS.FILE_READY, this);\n  }\n\n  protected detectFileType(): void {\n    const path = this.relativePath;\n\n    if (/(^|\\/)main\\.tsx?$/.test(path)) {\n      this.type = \"main\";\n    } else if (/\\.model\\.tsx?$/.test(path)) {\n      // Before the folder-name checks below: `events/models/x.model.ts` is a model.\n      this.type = \"model\";\n    } else if (path.startsWith(\"src/config/\")) {\n      this.type = \"config\";\n    } else if (path.endsWith(\"routes.ts\") || path.endsWith(\"routes.tsx\")) {\n      this.type = \"route\";\n    } else if (path.includes(\"/events/\")) {\n      this.type = \"event\";\n    } else if (path.includes(\"controller\")) {\n      this.type = \"controller\";\n    } else if (path.includes(\"service\")) {\n      this.type = \"service\";\n    } else {\n      this.type = \"other\";\n    }\n  }\n\n  public toManifest(): FileManifest {\n    return {\n      absolutePath: this.absolutePath,\n      relativePath: this.relativePath,\n      lastModified: this.lastModified,\n      hash: this.hash,\n      dependencies: Array.from(this.dependencies),\n      typeOnlyDependencies: Array.from(this.typeOnlyDependencies),\n      dependents: Array.from(this.dependents),\n      type: this.type!,\n    };\n  }\n}\n"],"mappings":"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"}

package/esm/dev-server/file-operations.d.mts

@@ -3,7 +3,7 @@ import { ManifestManager } from "./manifest-manager.mjs";
 import { SpecialFilesCollector } from "./special-files-collector.mjs";
 import { FileManager } from "./file-manager.mjs";
 
-//#region ../core/src/dev-server/file-operations.d.ts
+//#region ../../packages/core/src/dev-server/file-operations.d.ts
 /**
  * FileOperations — add/update/delete lifecycle for a single file.
  *

package/esm/dev-server/file-operations.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"file-operations.d.mts","names":[],"sources":["../../../../../../../core/src/dev-server/file-operations.ts"],"mappings":";;;;;;;;AAgBA;;;;cAAa,cAAA;EAAA,iBAEQ,KAAA;EAAA,iBACA,eAAA;EAAA,iBACA,QAAA;EAAA,iBACA,qBAAA;cAHA,KAAA,EAAO,GAAA,SAAY,WAAA,GACnB,eAAA,EAAiB,eAAA,EACjB,QAAA,EAAU,eAAA,EACV,qBAAA,EAAuB,qBAAA;EA2CK;;;;EApClC,OAAA,CAAQ,YAAA,WAAuB,OAAA,CAAQ,WAAA;EATjC;;;;EA6CN,UAAA,CAAW,YAAA,WAAuB,OAAA;EA9CT;;;EA6EzB,UAAA,CAAW,YAAA,WAAuB,OAAA;EA3ElB;;;;EAAA,QAoGf,+BAAA;EAoCP,oBAAA;EAMA,mBAAA;AAAA"}
+{"version":3,"file":"file-operations.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/file-operations.ts"],"mappings":";;;;;;;;AAgBA;;;;cAAa,cAAA;EAAA,iBAEQ,KAAA;EAAA,iBACA,eAAA;EAAA,iBACA,QAAA;EAAA,iBACA,qBAAA;cAHA,KAAA,EAAO,GAAA,SAAY,WAAA,GACnB,eAAA,EAAiB,eAAA,EACjB,QAAA,EAAU,eAAA,EACV,qBAAA,EAAuB,qBAAA;EA2CK;;;;EApClC,OAAA,CAAQ,YAAA,WAAuB,OAAA,CAAQ,WAAA;EATjC;;;;EA6CN,UAAA,CAAW,YAAA,WAAuB,OAAA;EA9CT;;;EA6EzB,UAAA,CAAW,YAAA,WAAuB,OAAA;EA3ElB;;;;EAAA,QAoGf,+BAAA;EAoCP,oBAAA;EAMA,mBAAA;AAAA"}

package/esm/dev-server/file-operations.mjs

@@ -5,7 +5,7 @@ import { FileManager } from "./file-manager.mjs";
 import { areSetsEqual } from "./utils.mjs";
 import events from "@mongez/events";
 
-//#region ../core/src/dev-server/file-operations.ts
+//#region ../../packages/core/src/dev-server/file-operations.ts
 /**
 * FileOperations — add/update/delete lifecycle for a single file.
 *

package/esm/dev-server/file-operations.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"file-operations.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/file-operations.ts"],"sourcesContent":["import events from \"@mongez/events\";\nimport type { DependencyGraph } from \"./dependency-graph\";\nimport { DEV_SERVER_EVENTS } from \"./events\";\nimport { FileManager } from \"./file-manager\";\nimport type { ManifestManager } from \"./manifest-manager\";\nimport { parseImports } from \"./parse-imports\";\nimport { Path } from \"../utils/normalized-path\";\nimport type { SpecialFilesCollector } from \"./special-files-collector\";\nimport { areSetsEqual } from \"./utils\";\n\n/**\n * FileOperations — add/update/delete lifecycle for a single file.\n *\n * Coordinates the dependency graph, manifest, and special-files collector\n * so the orchestrator and event handler can stay declarative.\n */\nexport class FileOperations {\n  public constructor(\n    private readonly files: Map<string, FileManager>,\n    private readonly dependencyGraph: DependencyGraph,\n    private readonly manifest: ManifestManager,\n    private readonly specialFilesCollector: SpecialFilesCollector,\n  ) {}\n\n  /**\n   * Register and process a new file. Recursively pulls in any\n   * not-yet-tracked dependencies so the dep graph is complete.\n   */\n  public async addFile(relativePath: string): Promise<FileManager> {\n    const existing = this.files.get(relativePath);\n    if (existing) return existing;\n\n    const fileManager = new FileManager(Path.toAbsolute(relativePath), this.files, this);\n\n    // Register before processing so recursive deps see us.\n    this.files.set(relativePath, fileManager);\n\n    await fileManager.process();\n\n    for (const depPath of fileManager.dependencies) {\n      if (!this.files.has(depPath)) {\n        try {\n          await this.addFile(depPath);\n        } catch {\n          // External or missing — let the importer surface it at load time.\n        }\n      }\n    }\n\n    for (const dependency of fileManager.dependencies) {\n      this.dependencyGraph.addDependency(relativePath, dependency);\n    }\n\n    this.specialFilesCollector.addFile(fileManager);\n\n    await this.reloadFilesWaitingForDependency(relativePath);\n\n    return fileManager;\n  }\n\n  /**\n   * Reprocess a file after a change. Re-syncs the dep graph and special-files\n   * collector when its imports or path classification shift.\n   */\n  public async updateFile(relativePath: string): Promise<boolean> {\n    const fileManager = this.files.get(relativePath);\n    if (!fileManager) {\n      await this.addFile(relativePath);\n      return true;\n    }\n\n    const oldDependencies = new Set(fileManager.dependencies);\n\n    try {\n      const hasChanged = await fileManager.process();\n      if (!hasChanged) return false;\n\n      if (!areSetsEqual(oldDependencies, fileManager.dependencies)) {\n        this.dependencyGraph.updateFile(\n          relativePath,\n          fileManager.dependencies,\n          fileManager.typeOnlyDependencies,\n        );\n      }\n\n      this.specialFilesCollector.updateFile(fileManager);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Remove a file. Notifies dependents so they surface broken-import errors.\n   */\n  public async deleteFile(relativePath: string): Promise<void> {\n    const fileManager = this.files.get(relativePath);\n    if (!fileManager) return;\n\n    const dependents = this.dependencyGraph.getDependents(relativePath);\n\n    this.dependencyGraph.removeFile(relativePath);\n    this.specialFilesCollector.removeFile(relativePath);\n    this.manifest.removeFile(relativePath);\n\n    for (const dependentPath of dependents) {\n      const dependentFile = this.files.get(dependentPath);\n      if (dependentFile) {\n        events.trigger(DEV_SERVER_EVENTS.FILE_READY, dependentFile);\n      }\n    }\n\n    // Slight delay so in-flight reads still find the FileManager.\n    setTimeout(() => this.files.delete(relativePath), 300);\n  }\n\n  /**\n   * Re-process any file whose imports might now resolve to a freshly added\n   * file. Covers \"import A from './b'\" where b.ts only just got created.\n   */\n  private async reloadFilesWaitingForDependency(newFilePath: string): Promise<void> {\n    const dependents: string[] = [];\n\n    for (const [existingPath, existingFile] of this.files) {\n      if (existingPath === newFilePath) continue;\n      if (existingFile.state !== \"ready\") continue;\n\n      try {\n        const importMap = await parseImports(existingFile.source, existingFile.absolutePath);\n        for (const [, resolved] of importMap) {\n          if (resolved && Path.toRelative(resolved.absolutePath) === newFilePath) {\n            dependents.push(existingPath);\n            break;\n          }\n        }\n      } catch {\n        continue;\n      }\n    }\n\n    for (const dependentPath of dependents) {\n      const dependentFile = this.files.get(dependentPath);\n      if (!dependentFile) continue;\n      try {\n        await dependentFile.process({ force: true });\n        this.dependencyGraph.updateFile(\n          dependentPath,\n          dependentFile.dependencies,\n          dependentFile.typeOnlyDependencies,\n        );\n      } catch {\n        // File still has issues — ignore.\n      }\n    }\n  }\n\n  public updateFileDependents(): void {\n    for (const [relativePath, fileManager] of this.files) {\n      fileManager.dependents = this.dependencyGraph.getDependents(relativePath);\n    }\n  }\n\n  public syncFilesToManifest(): void {\n    for (const [relativePath, fileManager] of this.files) {\n      this.manifest.setFile(relativePath, fileManager.toManifest());\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"file-operations.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/file-operations.ts"],"sourcesContent":["import events from \"@mongez/events\";\nimport type { DependencyGraph } from \"./dependency-graph\";\nimport { DEV_SERVER_EVENTS } from \"./events\";\nimport { FileManager } from \"./file-manager\";\nimport type { ManifestManager } from \"./manifest-manager\";\nimport { parseImports } from \"./parse-imports\";\nimport { Path } from \"../utils/normalized-path\";\nimport type { SpecialFilesCollector } from \"./special-files-collector\";\nimport { areSetsEqual } from \"./utils\";\n\n/**\n * FileOperations — add/update/delete lifecycle for a single file.\n *\n * Coordinates the dependency graph, manifest, and special-files collector\n * so the orchestrator and event handler can stay declarative.\n */\nexport class FileOperations {\n  public constructor(\n    private readonly files: Map<string, FileManager>,\n    private readonly dependencyGraph: DependencyGraph,\n    private readonly manifest: ManifestManager,\n    private readonly specialFilesCollector: SpecialFilesCollector,\n  ) {}\n\n  /**\n   * Register and process a new file. Recursively pulls in any\n   * not-yet-tracked dependencies so the dep graph is complete.\n   */\n  public async addFile(relativePath: string): Promise<FileManager> {\n    const existing = this.files.get(relativePath);\n    if (existing) return existing;\n\n    const fileManager = new FileManager(Path.toAbsolute(relativePath), this.files, this);\n\n    // Register before processing so recursive deps see us.\n    this.files.set(relativePath, fileManager);\n\n    await fileManager.process();\n\n    for (const depPath of fileManager.dependencies) {\n      if (!this.files.has(depPath)) {\n        try {\n          await this.addFile(depPath);\n        } catch {\n          // External or missing — let the importer surface it at load time.\n        }\n      }\n    }\n\n    for (const dependency of fileManager.dependencies) {\n      this.dependencyGraph.addDependency(relativePath, dependency);\n    }\n\n    this.specialFilesCollector.addFile(fileManager);\n\n    await this.reloadFilesWaitingForDependency(relativePath);\n\n    return fileManager;\n  }\n\n  /**\n   * Reprocess a file after a change. Re-syncs the dep graph and special-files\n   * collector when its imports or path classification shift.\n   */\n  public async updateFile(relativePath: string): Promise<boolean> {\n    const fileManager = this.files.get(relativePath);\n    if (!fileManager) {\n      await this.addFile(relativePath);\n      return true;\n    }\n\n    const oldDependencies = new Set(fileManager.dependencies);\n\n    try {\n      const hasChanged = await fileManager.process();\n      if (!hasChanged) return false;\n\n      if (!areSetsEqual(oldDependencies, fileManager.dependencies)) {\n        this.dependencyGraph.updateFile(\n          relativePath,\n          fileManager.dependencies,\n          fileManager.typeOnlyDependencies,\n        );\n      }\n\n      this.specialFilesCollector.updateFile(fileManager);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Remove a file. Notifies dependents so they surface broken-import errors.\n   */\n  public async deleteFile(relativePath: string): Promise<void> {\n    const fileManager = this.files.get(relativePath);\n    if (!fileManager) return;\n\n    const dependents = this.dependencyGraph.getDependents(relativePath);\n\n    this.dependencyGraph.removeFile(relativePath);\n    this.specialFilesCollector.removeFile(relativePath);\n    this.manifest.removeFile(relativePath);\n\n    for (const dependentPath of dependents) {\n      const dependentFile = this.files.get(dependentPath);\n      if (dependentFile) {\n        events.trigger(DEV_SERVER_EVENTS.FILE_READY, dependentFile);\n      }\n    }\n\n    // Slight delay so in-flight reads still find the FileManager.\n    setTimeout(() => this.files.delete(relativePath), 300);\n  }\n\n  /**\n   * Re-process any file whose imports might now resolve to a freshly added\n   * file. Covers \"import A from './b'\" where b.ts only just got created.\n   */\n  private async reloadFilesWaitingForDependency(newFilePath: string): Promise<void> {\n    const dependents: string[] = [];\n\n    for (const [existingPath, existingFile] of this.files) {\n      if (existingPath === newFilePath) continue;\n      if (existingFile.state !== \"ready\") continue;\n\n      try {\n        const importMap = await parseImports(existingFile.source, existingFile.absolutePath);\n        for (const [, resolved] of importMap) {\n          if (resolved && Path.toRelative(resolved.absolutePath) === newFilePath) {\n            dependents.push(existingPath);\n            break;\n          }\n        }\n      } catch {\n        continue;\n      }\n    }\n\n    for (const dependentPath of dependents) {\n      const dependentFile = this.files.get(dependentPath);\n      if (!dependentFile) continue;\n      try {\n        await dependentFile.process({ force: true });\n        this.dependencyGraph.updateFile(\n          dependentPath,\n          dependentFile.dependencies,\n          dependentFile.typeOnlyDependencies,\n        );\n      } catch {\n        // File still has issues — ignore.\n      }\n    }\n  }\n\n  public updateFileDependents(): void {\n    for (const [relativePath, fileManager] of this.files) {\n      fileManager.dependents = this.dependencyGraph.getDependents(relativePath);\n    }\n  }\n\n  public syncFilesToManifest(): void {\n    for (const [relativePath, fileManager] of this.files) {\n      this.manifest.setFile(relativePath, fileManager.toManifest());\n    }\n  }\n}\n"],"mappings":"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"}

package/esm/dev-server/files-orchestrator.mjs

@@ -10,20 +10,22 @@ import { FileManager } from "./file-manager.mjs";
 import { ensureWarlockDirectory, getFilesFromDirectory } from "./utils.mjs";
 import { FileOperations } from "./file-operations.mjs";
 import { FilesWatcher, createIgnoredMatcher } from "./files-watcher.mjs";
-import { EslintHealthChecker } from "./health-checker/checkers/eslint-health-checker.mjs";
-import { TypescriptHealthChecker } from "./health-checker/checkers/typescript-health-checker.mjs";
+import { defaultHealthCheckers } from "./health-checker/default-health-checkers.mjs";
 import { FilesHealthcareManager } from "./health-checker/files-healthcare.manager.mjs";
 import { buildTranspileInit } from "./loader/build-transpile-init.mjs";
+import { trackLoaderPortAcks } from "./loader/loader-port-acks.mjs";
 import { registerLoader } from "./loader/register-loader.mjs";
 import { ManifestManager } from "./manifest-manager.mjs";
 import { ModuleLoader } from "./module-loader.mjs";
 import { packageJsonManager } from "./package-json-manager.mjs";
 import { SpecialFilesCollector } from "./special-files-collector.mjs";
+import { fileURLToPath } from "node:url";
 import { colors } from "@mongez/copper";
 import { init } from "es-module-lexer";
-import { fileURLToPath } from "node:url";
 
-//#region ../core/src/dev-server/files-orchestrator.ts
+//#region ../../packages/core/src/dev-server/files-orchestrator.ts
+/** Module dictionaries, relative to `src/`; matches what `isLocaleFile` accepts as JSON. */
+const MODULE_LOCALES_JSON_GLOB = "app/*/utils/locales.json";
 /**
 * Register a cleanup callback that fires before the current module is
 * unloaded by HMR. Stack-inspects the caller so user code doesn't need to
@@ -57,7 +59,7 @@ var FilesOrchestrator = class {
 		this.specialFilesCollector = new SpecialFilesCollector();
 		this.moduleLoader = new ModuleLoader(this.specialFilesCollector);
 		this.loaderPort = null;
-		this.pendingFlushes = [];
+		this.loaderAcks = null;
 		this.pendingBumpedPaths = [];
 		this.isInitialized = false;
 		getDevelopmentAppModuleRegistry();
@@ -97,9 +99,7 @@ var FilesOrchestrator = class {
 		const devServerConfig = await warlockConfigManager.lazyGet("devServer");
 		const transpileInit = buildTranspileInit(tsconfigManager.tsconfig?.compilerOptions, devServerConfig?.transpileCacheDebug === true);
 		this.loaderPort = await registerLoader(transpileInit);
-		this.loaderPort.on("message", (msg) => {
-			if (msg.type === "sync-ack") this.pendingFlushes.shift()?.();
-		});
+		this.loaderAcks = trackLoaderPortAcks(this.loaderPort);
 	}
 	/**
 	* Tell the hook worker a file changed. The next `import()` of it will get
@@ -121,16 +121,12 @@ var FilesOrchestrator = class {
 	* the cached old module.
 	*/
 	flushVersionBumps() {
-		if (!this.loaderPort) return Promise.resolve();
+		if (!this.loaderAcks) return Promise.resolve();
 		const bumpedPaths = this.pendingBumpedPaths;
 		this.pendingBumpedPaths = [];
-		return new Promise((resolve) => {
-			this.pendingFlushes.push(() => {
-				const appModules = getDevelopmentAppModuleRegistry();
-				for (const absolutePath of bumpedPaths) appModules.bump(absolutePath);
-				resolve();
-			});
-			this.loaderPort.postMessage({ type: "sync" });
+		return this.loaderAcks.sync().then(() => {
+			const appModules = getDevelopmentAppModuleRegistry();
+			for (const absolutePath of bumpedPaths) appModules.bump(absolutePath);
 		});
 	}
 	/**
@@ -155,15 +151,21 @@ var FilesOrchestrator = class {
 	}
 	async startCheckingHealth(healthCheckers) {
 		devLogDim("Started File Health Checks in the background.");
-		const checkers = healthCheckers ?? [new TypescriptHealthChecker(), new EslintHealthChecker()];
+		const checkers = Array.isArray(healthCheckers) ? healthCheckers : defaultHealthCheckers(healthCheckers);
 		await this.healthCheckerManager.setHealthCheckers(checkers).initialize();
 		await this.healthCheckerManager.validateAllFiles();
 	}
 	/**
-	* Glob the src directory, returning relative paths.
+	* Glob the src directory, returning relative paths: every `.ts`/`.tsx`
+	* file plus each module's `utils/locales.json`.
+	*
+	* The JSON dictionaries must be in the boot set: the module loader
+	* registers them like any other locale file, but a code-only glob left them
+	* out, so `t()` printed raw keys until the watcher reported an edit.
 	*/
 	async getAllFilesFromFilesystem() {
-		return (await getFilesFromDirectory()).map((absPath) => Path.toRelative(absPath));
+		const [codePaths, localePaths] = await Promise.all([getFilesFromDirectory(), getFilesFromDirectory(void 0, MODULE_LOCALES_JSON_GLOB)]);
+		return Array.from(new Set([...codePaths, ...localePaths].map((absPath) => Path.toRelative(absPath))));
 	}
 	/**
 	* Process every file from scratch — used when no manifest exists.
@@ -212,5 +214,5 @@ async function runInBatches(items, size, fn) {
 const filesOrchestrator = new FilesOrchestrator();
 
 //#endregion
-export { FilesOrchestrator, filesOrchestrator, onCleanup };
+export { FilesOrchestrator, MODULE_LOCALES_JSON_GLOB, filesOrchestrator, onCleanup };
 //# sourceMappingURL=files-orchestrator.mjs.map