@warlock.js/core 5.24.0 → 5.26.0

package/esm/dev-server/legacy-locales-warning.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-locales-warning.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/legacy-locales-warning.ts"],"sourcesContent":["import { log } from \"@warlock.js/logger\";\n\nlet warned = false;\n\n/** Warn once per dev-server process when legacy locale modules are loaded. */\nexport function warnForLegacyLocales(localeFiles: readonly string[]): void {\n  const legacyFiles = localeFiles.filter((file) => /\\/utils\\/locales\\.(ts|tsx)$/.test(file));\n  if (warned || legacyFiles.length === 0) return;\n\n  warned = true;\n  const count = legacyFiles.length;\n  log.warn(\n    \"localization\",\n    \"legacy-locales\",\n    `${count} legacy utils/locales.ts ${count === 1 ? \"file is\" : \"files are\"} auto-loaded. ` +\n      \"Run `warlock doctor --fix` to migrate them; auto-loaded locales.ts is removed in v6.\",\n  );\n}\n\n/** Test-only reset for the process-scoped warning guard. */\nexport function resetLegacyLocalesWarningForTests(): void {\n  warned = false;\n}\n"],"mappings":";;;AAEA,IAAI,SAAS;;AAGb,SAAgB,qBAAqB,aAAsC;CACzE,MAAM,cAAc,YAAY,QAAQ,SAAS,8BAA8B,KAAK,IAAI,CAAC;CACzF,IAAI,UAAU,YAAY,WAAW,GAAG;CAExC,SAAS;CACT,MAAM,QAAQ,YAAY;CAC1B,IAAI,KACF,gBACA,kBACA,GAAG,MAAM,2BAA2B,UAAU,IAAI,YAAY,YAAY,qGAE5E;AACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"manifest-manager.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/manifest-manager.ts"],"sourcesContent":["import { atomicWriteAsync, fileExistsAsync, getJsonFileAsync } from \"@warlock.js/fs\";\r\nimport { FileManager } from \"./file-manager\";\r\nimport type { FileManifest } from \"./types\";\r\nimport { MANIFEST_PATH } from \"./flags\";\r\n\r\nconst MANIFEST_VERSION = \"1.0.0\";\r\n\r\n/**\r\n * Manifest structure with metadata and files\r\n */\r\nexport type Manifest = {\r\n  version: string;\r\n  lastBuildTime: number;\r\n  projectHash?: string;\r\n  stats: {\r\n    totalFiles: number;\r\n    totalDependencies: number;\r\n  };\r\n  files: Record<string, FileManifest>;\r\n};\r\n\r\nexport class ManifestManager {\r\n  /**\r\n   * Manifest data with metadata\r\n   */\r\n  private manifest: Manifest = {\r\n    version: MANIFEST_VERSION,\r\n    lastBuildTime: Date.now(),\r\n    stats: {\r\n      totalFiles: 0,\r\n      totalDependencies: 0,\r\n    },\r\n    files: {},\r\n  };\r\n\r\n  /**\r\n   * Constructor\r\n   */\r\n  public constructor(private readonly files: Map<string, FileManager>) {}\r\n\r\n  /**\r\n   * Initialize manifest manager\r\n   * @returns true if manifest exists, false otherwise\r\n   */\r\n  public async init(): Promise<boolean> {\r\n    if (await fileExistsAsync(MANIFEST_PATH)) {\r\n      try {\r\n        const loaded = await getJsonFileAsync<Manifest>(MANIFEST_PATH);\r\n\r\n        // A torn write or a format change across upgrades is treated as absent.\r\n        if (loaded?.version !== MANIFEST_VERSION || typeof loaded.files !== \"object\") {\r\n          return false;\r\n        }\r\n\r\n        this.manifest = loaded;\r\n        return true;\r\n      } catch {\r\n        return false;\r\n      }\r\n    }\r\n\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Save manifest to disk\r\n   */\r\n  public async save(): Promise<void> {\r\n    // Update stats before saving\r\n    this.manifest.stats.totalFiles = Object.keys(this.manifest.files).length;\r\n    this.manifest.stats.totalDependencies = this.calculateTotalDependencies();\r\n    this.manifest.lastBuildTime = Date.now();\r\n\r\n    await atomicWriteAsync(MANIFEST_PATH, JSON.stringify(this.manifest, null, 2));\r\n  }\r\n\r\n  /**\r\n   * Get file manifest data\r\n   */\r\n  public getFile(filePath: string): FileManifest | undefined {\r\n    return this.manifest.files[filePath];\r\n  }\r\n\r\n  /**\r\n   * Check if file exists in manifest\r\n   */\r\n  public hasFile(filePath: string): boolean {\r\n    return filePath in this.manifest.files;\r\n  }\r\n\r\n  /**\r\n   * Set file manifest data\r\n   */\r\n  public setFile(filePath: string, fileManifest: FileManifest): void {\r\n    this.manifest.files[filePath] = fileManifest;\r\n  }\r\n\r\n  /**\r\n   * Remove file from manifest\r\n   */\r\n  public removeFile(filePath: string): void {\r\n    delete this.manifest.files[filePath];\r\n  }\r\n\r\n  /**\r\n   * Get all file paths in manifest\r\n   */\r\n  public getAllFilePaths(): string[] {\r\n    return Object.keys(this.manifest.files);\r\n  }\r\n\r\n  /**\r\n   * Get all file manifests\r\n   */\r\n  public getAllFiles(): Record<string, FileManifest> {\r\n    return this.manifest.files;\r\n  }\r\n\r\n  /**\r\n   * Get manifest metadata\r\n   */\r\n  public getMetadata() {\r\n    return {\r\n      version: this.manifest.version,\r\n      lastBuildTime: this.manifest.lastBuildTime,\r\n      projectHash: this.manifest.projectHash,\r\n      stats: this.manifest.stats,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Calculate total dependencies across all files\r\n   */\r\n  private calculateTotalDependencies(): number {\r\n    return Object.values(this.manifest.files).reduce(\r\n      (total, file) => total + (file.dependencies?.length || 0),\r\n      0,\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Clear all files from manifest\r\n   */\r\n  public clear(): void {\r\n    this.manifest.files = {};\r\n    this.manifest.stats = {\r\n      totalFiles: 0,\r\n      totalDependencies: 0,\r\n    };\r\n  }\r\n}\r\n"],"mappings":";;;;AAKA,MAAM,mBAAmB;AAgBzB,IAAa,kBAAb,MAA6B;;;;CAiB3B,AAAO,YAAY,AAAiB,OAAiC;EAAjC;kBAbP;GAC3B,SAAS;GACT,eAAe,KAAK,IAAI;GACxB,OAAO;IACL,YAAY;IACZ,mBAAmB;GACrB;GACA,OAAO,CAAC;EACV;CAKsE;;;;;CAMtE,MAAa,OAAyB;EACpC,IAAI,MAAM,gBAAgB,aAAa,GACrC,IAAI;GACF,MAAM,SAAS,MAAM,iBAA2B,aAAa;GAG7D,IAAI,QAAQ,YAAY,oBAAoB,OAAO,OAAO,UAAU,UAClE,OAAO;GAGT,KAAK,WAAW;GAChB,OAAO;EACT,QAAQ;GACN,OAAO;EACT;EAGF,OAAO;CACT;;;;CAKA,MAAa,OAAsB;EAEjC,KAAK,SAAS,MAAM,aAAa,OAAO,KAAK,KAAK,SAAS,KAAK,CAAC,CAAC;EAClE,KAAK,SAAS,MAAM,oBAAoB,KAAK,2BAA2B;EACxE,KAAK,SAAS,gBAAgB,KAAK,IAAI;EAEvC,MAAM,iBAAiB,eAAe,KAAK,UAAU,KAAK,UAAU,MAAM,CAAC,CAAC;CAC9E;;;;CAKA,AAAO,QAAQ,UAA4C;EACzD,OAAO,KAAK,SAAS,MAAM;CAC7B;;;;CAKA,AAAO,QAAQ,UAA2B;EACxC,OAAO,YAAY,KAAK,SAAS;CACnC;;;;CAKA,AAAO,QAAQ,UAAkB,cAAkC;EACjE,KAAK,SAAS,MAAM,YAAY;CAClC;;;;CAKA,AAAO,WAAW,UAAwB;EACxC,OAAO,KAAK,SAAS,MAAM;CAC7B;;;;CAKA,AAAO,kBAA4B;EACjC,OAAO,OAAO,KAAK,KAAK,SAAS,KAAK;CACxC;;;;CAKA,AAAO,cAA4C;EACjD,OAAO,KAAK,SAAS;CACvB;;;;CAKA,AAAO,cAAc;EACnB,OAAO;GACL,SAAS,KAAK,SAAS;GACvB,eAAe,KAAK,SAAS;GAC7B,aAAa,KAAK,SAAS;GAC3B,OAAO,KAAK,SAAS;EACvB;CACF;;;;CAKA,AAAQ,6BAAqC;EAC3C,OAAO,OAAO,OAAO,KAAK,SAAS,KAAK,CAAC,CAAC,QACvC,OAAO,SAAS,SAAS,KAAK,cAAc,UAAU,IACvD,CACF;CACF;;;;CAKA,AAAO,QAAc;EACnB,KAAK,SAAS,QAAQ,CAAC;EACvB,KAAK,SAAS,QAAQ;GACpB,YAAY;GACZ,mBAAmB;EACrB;CACF;AACF"}
+{"version":3,"file":"manifest-manager.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/manifest-manager.ts"],"sourcesContent":["import { atomicWriteAsync, fileExistsAsync, getJsonFileAsync } from \"@warlock.js/fs\";\nimport { FileManager } from \"./file-manager\";\nimport type { FileManifest } from \"./types\";\nimport { MANIFEST_PATH } from \"./flags\";\n\nconst MANIFEST_VERSION = \"1.0.0\";\n\n/**\n * Manifest structure with metadata and files\n */\nexport type Manifest = {\n  version: string;\n  lastBuildTime: number;\n  projectHash?: string;\n  stats: {\n    totalFiles: number;\n    totalDependencies: number;\n  };\n  files: Record<string, FileManifest>;\n};\n\nexport class ManifestManager {\n  /**\n   * Manifest data with metadata\n   */\n  private manifest: Manifest = {\n    version: MANIFEST_VERSION,\n    lastBuildTime: Date.now(),\n    stats: {\n      totalFiles: 0,\n      totalDependencies: 0,\n    },\n    files: {},\n  };\n\n  /**\n   * Constructor\n   */\n  public constructor(private readonly files: Map<string, FileManager>) {}\n\n  /**\n   * Initialize manifest manager\n   * @returns true if manifest exists, false otherwise\n   */\n  public async init(): Promise<boolean> {\n    if (await fileExistsAsync(MANIFEST_PATH)) {\n      try {\n        const loaded = await getJsonFileAsync<Manifest>(MANIFEST_PATH);\n\n        // A torn write or a format change across upgrades is treated as absent.\n        if (loaded?.version !== MANIFEST_VERSION || typeof loaded.files !== \"object\") {\n          return false;\n        }\n\n        this.manifest = loaded;\n        return true;\n      } catch {\n        return false;\n      }\n    }\n\n    return false;\n  }\n\n  /**\n   * Save manifest to disk\n   */\n  public async save(): Promise<void> {\n    // Update stats before saving\n    this.manifest.stats.totalFiles = Object.keys(this.manifest.files).length;\n    this.manifest.stats.totalDependencies = this.calculateTotalDependencies();\n    this.manifest.lastBuildTime = Date.now();\n\n    await atomicWriteAsync(MANIFEST_PATH, JSON.stringify(this.manifest, null, 2));\n  }\n\n  /**\n   * Get file manifest data\n   */\n  public getFile(filePath: string): FileManifest | undefined {\n    return this.manifest.files[filePath];\n  }\n\n  /**\n   * Check if file exists in manifest\n   */\n  public hasFile(filePath: string): boolean {\n    return filePath in this.manifest.files;\n  }\n\n  /**\n   * Set file manifest data\n   */\n  public setFile(filePath: string, fileManifest: FileManifest): void {\n    this.manifest.files[filePath] = fileManifest;\n  }\n\n  /**\n   * Remove file from manifest\n   */\n  public removeFile(filePath: string): void {\n    delete this.manifest.files[filePath];\n  }\n\n  /**\n   * Get all file paths in manifest\n   */\n  public getAllFilePaths(): string[] {\n    return Object.keys(this.manifest.files);\n  }\n\n  /**\n   * Get all file manifests\n   */\n  public getAllFiles(): Record<string, FileManifest> {\n    return this.manifest.files;\n  }\n\n  /**\n   * Get manifest metadata\n   */\n  public getMetadata() {\n    return {\n      version: this.manifest.version,\n      lastBuildTime: this.manifest.lastBuildTime,\n      projectHash: this.manifest.projectHash,\n      stats: this.manifest.stats,\n    };\n  }\n\n  /**\n   * Calculate total dependencies across all files\n   */\n  private calculateTotalDependencies(): number {\n    return Object.values(this.manifest.files).reduce(\n      (total, file) => total + (file.dependencies?.length || 0),\n      0,\n    );\n  }\n\n  /**\n   * Clear all files from manifest\n   */\n  public clear(): void {\n    this.manifest.files = {};\n    this.manifest.stats = {\n      totalFiles: 0,\n      totalDependencies: 0,\n    };\n  }\n}\n"],"mappings":";;;;AAKA,MAAM,mBAAmB;AAgBzB,IAAa,kBAAb,MAA6B;;;;CAiB3B,AAAO,YAAY,AAAiB,OAAiC;EAAjC;kBAbP;GAC3B,SAAS;GACT,eAAe,KAAK,IAAI;GACxB,OAAO;IACL,YAAY;IACZ,mBAAmB;GACrB;GACA,OAAO,CAAC;EACV;CAKsE;;;;;CAMtE,MAAa,OAAyB;EACpC,IAAI,MAAM,gBAAgB,aAAa,GACrC,IAAI;GACF,MAAM,SAAS,MAAM,iBAA2B,aAAa;GAG7D,IAAI,QAAQ,YAAY,oBAAoB,OAAO,OAAO,UAAU,UAClE,OAAO;GAGT,KAAK,WAAW;GAChB,OAAO;EACT,QAAQ;GACN,OAAO;EACT;EAGF,OAAO;CACT;;;;CAKA,MAAa,OAAsB;EAEjC,KAAK,SAAS,MAAM,aAAa,OAAO,KAAK,KAAK,SAAS,KAAK,CAAC,CAAC;EAClE,KAAK,SAAS,MAAM,oBAAoB,KAAK,2BAA2B;EACxE,KAAK,SAAS,gBAAgB,KAAK,IAAI;EAEvC,MAAM,iBAAiB,eAAe,KAAK,UAAU,KAAK,UAAU,MAAM,CAAC,CAAC;CAC9E;;;;CAKA,AAAO,QAAQ,UAA4C;EACzD,OAAO,KAAK,SAAS,MAAM;CAC7B;;;;CAKA,AAAO,QAAQ,UAA2B;EACxC,OAAO,YAAY,KAAK,SAAS;CACnC;;;;CAKA,AAAO,QAAQ,UAAkB,cAAkC;EACjE,KAAK,SAAS,MAAM,YAAY;CAClC;;;;CAKA,AAAO,WAAW,UAAwB;EACxC,OAAO,KAAK,SAAS,MAAM;CAC7B;;;;CAKA,AAAO,kBAA4B;EACjC,OAAO,OAAO,KAAK,KAAK,SAAS,KAAK;CACxC;;;;CAKA,AAAO,cAA4C;EACjD,OAAO,KAAK,SAAS;CACvB;;;;CAKA,AAAO,cAAc;EACnB,OAAO;GACL,SAAS,KAAK,SAAS;GACvB,eAAe,KAAK,SAAS;GAC7B,aAAa,KAAK,SAAS;GAC3B,OAAO,KAAK,SAAS;EACvB;CACF;;;;CAKA,AAAQ,6BAAqC;EAC3C,OAAO,OAAO,OAAO,KAAK,SAAS,KAAK,CAAC,CAAC,QACvC,OAAO,SAAS,SAAS,KAAK,cAAc,UAAU,IACvD,CACF;CACF;;;;CAKA,AAAO,QAAc;EACnB,KAAK,SAAS,QAAQ,CAAC;EACvB,KAAK,SAAS,QAAQ;GACpB,YAAY;GACZ,mBAAmB;EACrB;CACF;AACF"}

package/esm/dev-server/module-loader.mjs

@@ -1,7 +1,13 @@
 import { router } from "../router/router.mjs";
+import { registerGroupedTranslationKeys, registerLocaleDictionary } from "../localization/register-locale-dictionary.mjs";
+import "../localization/index.mjs";
 import { devLogError, formatModuleNotFoundError } from "./dev-logger.mjs";
+import { importAppModule } from "../loader/app-module-importer.mjs";
+import { extractTranslationKeys } from "./extract-translation-keys.mjs";
+import { warnForLegacyLocales } from "./legacy-locales-warning.mjs";
 import { getDevelopmentModelModuleRegistry } from "./model-module-registry.mjs";
 import { pathToFileURL } from "node:url";
+import ts from "typescript";
 
 //#region ../core/src/dev-server/module-loader.ts
 /**
@@ -20,15 +26,18 @@ var ModuleLoadError = class extends Error {
 	}
 };
 /**
-* The four "special" file kinds that the dev server eagerly imports at boot.
+* The "special" file kinds that the dev server eagerly imports at boot.
 * Order matters: locales first (used by everything), events before main so
-* listeners are registered when main runs, routes last so handlers are bound.
+* listeners are registered when main runs, routes after main so handlers are
+* bound, worker last so scheduled jobs and queue definitions see routes
+* already registered. Dev always loads worker files since dev runs every role.
 */
 const SPECIAL_TYPES = [
 	"locale",
 	"event",
 	"main",
-	"route"
+	"route",
+	"worker"
 ];
 /**
 * Loads application modules through the ESM loader hook. The hook stamps
@@ -52,9 +61,10 @@ var ModuleLoader = class {
 	* try/catch that logs and aborts the boot — so a broken route module aborts
 	* boot loudly rather than booting into a surface that 404s.
 	*/
-	async loadAll() {
+	async loadAll(options = {}) {
 		const failures = [];
 		for (const type of SPECIAL_TYPES) for (const file of this.specialFilesCollector.getFilesByType(type)) try {
+			await options.onBeforeLoad?.(file);
 			await this.loadModule(file, type);
 		} catch (error) {
 			failures.push(error instanceof ModuleLoadError ? error : new ModuleLoadError(type, file, error));
@@ -67,11 +77,22 @@ var ModuleLoader = class {
 	*/
 	async loadModule(file, type) {
 		if (file.relativePath.endsWith(".env")) return void 0;
+		if (type === "locale" && /\/utils\/locales\.(ts|tsx)$/.test(file.relativePath)) warnForLegacyLocales(this.specialFilesCollector.getFilesByType("locale").map((locale) => locale.relativePath));
+		if (type === "locale" && file.relativePath.endsWith(".json")) {
+			const cleanup = registerLocaleDictionary({
+				sourceFile: file.relativePath,
+				source: file.source,
+				defaultNamespace: file.relativePath.split("/")[2]
+			});
+			file.addCleanup(cleanup);
+			return;
+		}
+		if (type === "locale") registerGroupedTranslationKeys(file.relativePath, extractTranslationKeys(ts.createSourceFile(file.relativePath, file.source, ts.ScriptTarget.Latest)));
 		globalThis.__currentModuleFile = file;
 		try {
 			const fileUrl = pathToFileURL(file.absolutePath).href;
 			const load = async () => {
-				const module = await import(fileUrl);
+				const module = await importAppModule(fileUrl);
 				this.loadedModules.set(file.absolutePath, module);
 				this.registerCleanup(file, module);
 				if (type === "model") getDevelopmentModelModuleRegistry().publish(file.absolutePath, fileUrl, module);

package/esm/dev-server/module-loader.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"module-loader.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/module-loader.ts"],"sourcesContent":["import { pathToFileURL } from \"node:url\";\nimport { router } from \"../router/router\";\nimport { devLogError, formatModuleNotFoundError } from \"./dev-logger\";\nimport type { CleanupFunction, FileManager } from \"./file-manager\";\nimport { getDevelopmentModelModuleRegistry } from \"./model-module-registry\";\nimport type { SpecialFileType, SpecialFilesCollector } from \"./special-files-collector\";\n\ndeclare global {\n  var __currentModuleFile: FileManager | undefined;\n}\n\n/**\n * Thrown when a special file (route/event/main/locale) fails to import or\n * register. Carries the file that failed and the original cause so a broken\n * module surfaces with its origin instead of vanishing into a 404.\n */\nexport class ModuleLoadError extends Error {\n  public constructor(\n    public readonly type: string,\n    public readonly file: FileManager,\n    public readonly cause: unknown,\n  ) {\n    const reason = cause instanceof Error ? cause.message : String(cause);\n    super(`Failed to load ${type}: ${file.relativePath} - ${reason}`);\n    this.name = \"ModuleLoadError\";\n  }\n}\n\n/**\n * The four \"special\" file kinds that the dev server eagerly imports at boot.\n * Order matters: locales first (used by everything), events before main so\n * listeners are registered when main runs, routes last so handlers are bound.\n */\nconst SPECIAL_TYPES: readonly SpecialFileType[] = [\"locale\", \"event\", \"main\", \"route\"] as const;\n\n/**\n * Loads application modules through the ESM loader hook. The hook stamps\n * `?v=N` on every import, so each reload is a fresh module without any\n * userland cache-busting plumbing.\n */\nexport class ModuleLoader {\n  private readonly loadedModules = new Map<string, unknown>();\n\n  public constructor(private readonly specialFilesCollector: SpecialFilesCollector) {\n    // Web creates its Vite bridge after Core's development orchestration has\n    // constructed ModuleLoader. Create the carrier now so a zero-model app can\n    // subscribe before a model is added later through HMR.\n    getDevelopmentModelModuleRegistry();\n  }\n\n  /**\n   * Eagerly load every special file at boot, in the canonical order so\n   * later phases (e.g. routes) see state earlier phases registered.\n   *\n   * A failing module no longer vanishes silently: each failure is collected\n   * (so one broken file doesn't hide the others) and, once every file has been\n   * attempted, an aggregate error is thrown. The boot callers\n   * (`DevelopmentServer.start`, the HTTP test bootstrap) already wrap this in a\n   * try/catch that logs and aborts the boot — so a broken route module aborts\n   * boot loudly rather than booting into a surface that 404s.\n   */\n  public async loadAll(): Promise<void> {\n    const failures: ModuleLoadError[] = [];\n\n    for (const type of SPECIAL_TYPES) {\n      for (const file of this.specialFilesCollector.getFilesByType(type)) {\n        try {\n          await this.loadModule(file, type);\n        } catch (error) {\n          failures.push(\n            error instanceof ModuleLoadError ? error : new ModuleLoadError(type, file, error),\n          );\n        }\n      }\n    }\n\n    if (failures.length > 0) {\n      throw new AggregateError(\n        failures,\n        `${failures.length} module(s) failed to load during boot:\\n` +\n          failures.map((failure) => `  - ${failure.message}`).join(\"\\n\"),\n      );\n    }\n  }\n\n  /**\n   * Import a file through the loader hook. For routes, scopes the import in\n   * `router.withSourceFile()` so the added routes carry their origin.\n   */\n  public async loadModule<T = unknown>(file: FileManager, type: string): Promise<T | undefined> {\n    if (file.relativePath.endsWith(\".env\")) return undefined;\n\n    globalThis.__currentModuleFile = file;\n\n    try {\n      const fileUrl = pathToFileURL(file.absolutePath).href;\n\n      const load = async () => {\n        const module = (await import(fileUrl)) as Record<string, unknown>;\n        this.loadedModules.set(file.absolutePath, module);\n        this.registerCleanup(file, module);\n        if (type === \"model\") {\n          getDevelopmentModelModuleRegistry().publish(file.absolutePath, fileUrl, module);\n        }\n        return module as T;\n      };\n\n      return type === \"route\" ? await router.withSourceFile(file.relativePath, load) : await load();\n    } catch (error: any) {\n      if (error.code === \"ERR_MODULE_NOT_FOUND\") {\n        devLogError(formatModuleNotFoundError(error));\n      } else {\n        // Pass the error through so devLogError prints the stack. With dev\n        // source maps enabled, frames remap to the original `.ts` line/col\n        // (e.g. the actual call site of an undefined symbol) instead of\n        // vanishing — a one-line \"x is not defined\" is undebuggable.\n        devLogError(\n          `Failed to load ${type}: ${file.relativePath} - ${error?.message || error}`,\n          error,\n        );\n      }\n\n      // RETHROW after logging. Previously this returned undefined, so a route\n      // file that threw on import or registration disappeared with no boot\n      // error — the whole surface 404'd silently. Boot callers abort on the\n      // throw; the HMR batch-reload handler catches it, keeps the server\n      // alive, and shows it loudly.\n      throw error instanceof ModuleLoadError ? error : new ModuleLoadError(type, file, error);\n    } finally {\n      globalThis.__currentModuleFile = undefined;\n    }\n  }\n\n  /**\n   * Reload a previously-loaded special file. The version-bump that makes the\n   * import fresh is done by the caller (layer-executor) before invoking this.\n   * Routes are removed from the registry first so re-registration is clean.\n   */\n  public async reloadModule(file: FileManager): Promise<void> {\n    const moduleType = this.specialFilesCollector.getFileType(file.relativePath);\n    if (!moduleType) return;\n\n    this.runCleanup(file);\n\n    if (moduleType === \"route\") {\n      router.removeRoutesBySourceFile(file.relativePath);\n    }\n\n    this.loadedModules.delete(file.absolutePath);\n    await this.loadModule(file, moduleType);\n  }\n\n  /**\n   * Run every cleanup hook the file registered (or `$cleanup` on its exports)\n   * and reset the list. Called once per HMR reload.\n   */\n  public runCleanup(file: FileManager): void {\n    for (const hook of file.cleanup) {\n      try {\n        if (typeof hook === \"function\") {\n          hook();\n        } else if (\n          hook &&\n          typeof (hook as { unsubscribe?: () => void }).unsubscribe === \"function\"\n        ) {\n          (hook as { unsubscribe: () => void }).unsubscribe();\n        }\n      } catch {\n        // Cleanup errors shouldn't break HMR.\n      }\n    }\n    file.resetCleanup();\n  }\n\n  /**\n   * Clean up after a file whose source was deleted from disk.\n   */\n  public cleanupDeletedModule(file: FileManager): void {\n    this.loadedModules.delete(file.absolutePath);\n\n    if (file.type === \"model\") {\n      getDevelopmentModelModuleRegistry().remove(file.absolutePath);\n    }\n\n    if (file.type === \"route\") {\n      router.removeRoutesBySourceFile(file.relativePath);\n    }\n\n    this.runCleanup(file);\n  }\n\n  /**\n   * Scan a freshly-loaded module for cleanup handlers and register them on\n   * the FileManager so they run before the next reload. Priority: explicit\n   * `export function cleanup()` → `.$cleanup` on any exported value.\n   */\n  private registerCleanup(file: FileManager, module: Record<string, unknown>): void {\n    if (typeof module.cleanup === \"function\") {\n      file.addCleanup(module.cleanup as CleanupFunction);\n      return;\n    }\n\n    const cleanups: CleanupFunction[] = [];\n\n    for (const exportedValue of Object.values(module)) {\n      const cleanup = (exportedValue as { $cleanup?: unknown })?.$cleanup;\n      if (typeof cleanup === \"function\") {\n        cleanups.push(cleanup.bind(exportedValue) as CleanupFunction);\n      }\n    }\n\n    if (cleanups.length > 0) {\n      file.addCleanup(cleanups);\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"module-loader.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/module-loader.ts"],"sourcesContent":["import { pathToFileURL } from \"node:url\";\nimport ts from \"typescript\";\nimport { importAppModule } from \"../loader/app-module-importer\";\nimport { registerGroupedTranslationKeys, registerLocaleDictionary } from \"../localization\";\nimport { router } from \"../router/router\";\nimport { devLogError, formatModuleNotFoundError } from \"./dev-logger\";\nimport { extractTranslationKeys } from \"./extract-translation-keys\";\nimport type { CleanupFunction, FileManager } from \"./file-manager\";\nimport { warnForLegacyLocales } from \"./legacy-locales-warning\";\nimport { getDevelopmentModelModuleRegistry } from \"./model-module-registry\";\nimport type { SpecialFileType, SpecialFilesCollector } from \"./special-files-collector\";\n\ndeclare global {\n  var __currentModuleFile: FileManager | undefined;\n}\n\n/**\n * Thrown when a special file (route/event/main/locale) fails to import or\n * register. Carries the file that failed and the original cause so a broken\n * module surfaces with its origin instead of vanishing into a 404.\n */\nexport class ModuleLoadError extends Error {\n  public constructor(\n    public readonly type: string,\n    public readonly file: FileManager,\n    public readonly cause: unknown,\n  ) {\n    const reason = cause instanceof Error ? cause.message : String(cause);\n    super(`Failed to load ${type}: ${file.relativePath} - ${reason}`);\n    this.name = \"ModuleLoadError\";\n  }\n}\n\n/**\n * The \"special\" file kinds that the dev server eagerly imports at boot.\n * Order matters: locales first (used by everything), events before main so\n * listeners are registered when main runs, routes after main so handlers are\n * bound, worker last so scheduled jobs and queue definitions see routes\n * already registered. Dev always loads worker files since dev runs every role.\n */\nconst SPECIAL_TYPES: readonly SpecialFileType[] = [\n  \"locale\",\n  \"event\",\n  \"main\",\n  \"route\",\n  \"worker\",\n] as const;\n\n/**\n * Loads application modules through the ESM loader hook. The hook stamps\n * `?v=N` on every import, so each reload is a fresh module without any\n * userland cache-busting plumbing.\n */\nexport class ModuleLoader {\n  private readonly loadedModules = new Map<string, unknown>();\n\n  public constructor(private readonly specialFilesCollector: SpecialFilesCollector) {\n    // Web creates its Vite bridge after Core's development orchestration has\n    // constructed ModuleLoader. Create the carrier now so a zero-model app can\n    // subscribe before a model is added later through HMR.\n    getDevelopmentModelModuleRegistry();\n  }\n\n  /**\n   * Eagerly load every special file at boot, in the canonical order so\n   * later phases (e.g. routes) see state earlier phases registered.\n   *\n   * A failing module no longer vanishes silently: each failure is collected\n   * (so one broken file doesn't hide the others) and, once every file has been\n   * attempted, an aggregate error is thrown. The boot callers\n   * (`DevelopmentServer.start`, the HTTP test bootstrap) already wrap this in a\n   * try/catch that logs and aborts the boot — so a broken route module aborts\n   * boot loudly rather than booting into a surface that 404s.\n   */\n  public async loadAll(\n    options: { onBeforeLoad?: (file: FileManager) => void | Promise<void> } = {},\n  ): Promise<void> {\n    const failures: ModuleLoadError[] = [];\n\n    for (const type of SPECIAL_TYPES) {\n      for (const file of this.specialFilesCollector.getFilesByType(type)) {\n        try {\n          await options.onBeforeLoad?.(file);\n          await this.loadModule(file, type);\n        } catch (error) {\n          failures.push(\n            error instanceof ModuleLoadError ? error : new ModuleLoadError(type, file, error),\n          );\n        }\n      }\n    }\n\n    if (failures.length > 0) {\n      throw new AggregateError(\n        failures,\n        `${failures.length} module(s) failed to load during boot:\\n` +\n          failures.map((failure) => `  - ${failure.message}`).join(\"\\n\"),\n      );\n    }\n  }\n\n  /**\n   * Import a file through the loader hook. For routes, scopes the import in\n   * `router.withSourceFile()` so the added routes carry their origin.\n   */\n  public async loadModule<T = unknown>(file: FileManager, type: string): Promise<T | undefined> {\n    if (file.relativePath.endsWith(\".env\")) return undefined;\n\n    if (type === \"locale\" && /\\/utils\\/locales\\.(ts|tsx)$/.test(file.relativePath)) {\n      warnForLegacyLocales(\n        this.specialFilesCollector.getFilesByType(\"locale\").map((locale) => locale.relativePath),\n      );\n    }\n\n    if (type === \"locale\" && file.relativePath.endsWith(\".json\")) {\n      const cleanup = registerLocaleDictionary({\n        sourceFile: file.relativePath,\n        source: file.source,\n        defaultNamespace: file.relativePath.split(\"/\")[2]!,\n      });\n      file.addCleanup(cleanup);\n      return undefined;\n    }\n\n    if (type === \"locale\") {\n      registerGroupedTranslationKeys(\n        file.relativePath,\n        extractTranslationKeys(\n          ts.createSourceFile(file.relativePath, file.source, ts.ScriptTarget.Latest),\n        ),\n      );\n    }\n\n    globalThis.__currentModuleFile = file;\n\n    try {\n      const fileUrl = pathToFileURL(file.absolutePath).href;\n\n      const load = async () => {\n        const module = (await importAppModule(fileUrl)) as Record<string, unknown>;\n        this.loadedModules.set(file.absolutePath, module);\n        this.registerCleanup(file, module);\n        if (type === \"model\") {\n          getDevelopmentModelModuleRegistry().publish(file.absolutePath, fileUrl, module);\n        }\n        return module as T;\n      };\n\n      return type === \"route\" ? await router.withSourceFile(file.relativePath, load) : await load();\n    } catch (error: any) {\n      if (error.code === \"ERR_MODULE_NOT_FOUND\") {\n        devLogError(formatModuleNotFoundError(error));\n      } else {\n        // Pass the error through so devLogError prints the stack. With dev\n        // source maps enabled, frames remap to the original `.ts` line/col\n        // (e.g. the actual call site of an undefined symbol) instead of\n        // vanishing — a one-line \"x is not defined\" is undebuggable.\n        devLogError(\n          `Failed to load ${type}: ${file.relativePath} - ${error?.message || error}`,\n          error,\n        );\n      }\n\n      // RETHROW after logging. Previously this returned undefined, so a route\n      // file that threw on import or registration disappeared with no boot\n      // error — the whole surface 404'd silently. Boot callers abort on the\n      // throw; the HMR batch-reload handler catches it, keeps the server\n      // alive, and shows it loudly.\n      throw error instanceof ModuleLoadError ? error : new ModuleLoadError(type, file, error);\n    } finally {\n      globalThis.__currentModuleFile = undefined;\n    }\n  }\n\n  /**\n   * Reload a previously-loaded special file. The version-bump that makes the\n   * import fresh is done by the caller (layer-executor) before invoking this.\n   * Routes are removed from the registry first so re-registration is clean.\n   */\n  public async reloadModule(file: FileManager): Promise<void> {\n    const moduleType = this.specialFilesCollector.getFileType(file.relativePath);\n    if (!moduleType) return;\n\n    this.runCleanup(file);\n\n    if (moduleType === \"route\") {\n      router.removeRoutesBySourceFile(file.relativePath);\n    }\n\n    this.loadedModules.delete(file.absolutePath);\n    await this.loadModule(file, moduleType);\n  }\n\n  /**\n   * Run every cleanup hook the file registered (or `$cleanup` on its exports)\n   * and reset the list. Called once per HMR reload.\n   */\n  public runCleanup(file: FileManager): void {\n    for (const hook of file.cleanup) {\n      try {\n        if (typeof hook === \"function\") {\n          hook();\n        } else if (\n          hook &&\n          typeof (hook as { unsubscribe?: () => void }).unsubscribe === \"function\"\n        ) {\n          (hook as { unsubscribe: () => void }).unsubscribe();\n        }\n      } catch {\n        // Cleanup errors shouldn't break HMR.\n      }\n    }\n    file.resetCleanup();\n  }\n\n  /**\n   * Clean up after a file whose source was deleted from disk.\n   */\n  public cleanupDeletedModule(file: FileManager): void {\n    this.loadedModules.delete(file.absolutePath);\n\n    if (file.type === \"model\") {\n      getDevelopmentModelModuleRegistry().remove(file.absolutePath);\n    }\n\n    if (file.type === \"route\") {\n      router.removeRoutesBySourceFile(file.relativePath);\n    }\n\n    this.runCleanup(file);\n  }\n\n  /**\n   * Scan a freshly-loaded module for cleanup handlers and register them on\n   * the FileManager so they run before the next reload. Priority: explicit\n   * `export function cleanup()` → `.$cleanup` on any exported value.\n   */\n  private registerCleanup(file: FileManager, module: Record<string, unknown>): void {\n    if (typeof module.cleanup === \"function\") {\n      file.addCleanup(module.cleanup as CleanupFunction);\n      return;\n    }\n\n    const cleanups: CleanupFunction[] = [];\n\n    for (const exportedValue of Object.values(module)) {\n      const cleanup = (exportedValue as { $cleanup?: unknown })?.$cleanup;\n      if (typeof cleanup === \"function\") {\n        cleanups.push(cleanup.bind(exportedValue) as CleanupFunction);\n      }\n    }\n\n    if (cleanups.length > 0) {\n      file.addCleanup(cleanups);\n    }\n  }\n}\n"],"mappings":"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"}

package/esm/dev-server/register-installed-devtools.mjs

@@ -0,0 +1,47 @@
+import { connectorsManager } from "../connectors/connectors-manager.mjs";
+import { devLogWarn } from "./dev-logger.mjs";
+
+//#region ../core/src/dev-server/register-installed-devtools.ts
+const DEVTOOLS_PACKAGE = "@warlock.js/devtools";
+/**
+* Register `@warlock.js/devtools` when the app has it installed.
+*
+* Called by `warlock dev` only, before the late connector phase, so the app
+* never names devtools in `warlock.config.ts`. That matters because devtools
+* is a DEV dependency: a production install omits it, and a config import of
+* it would fail to resolve there. The production entry never calls this.
+*
+* Skipped when a connector named `devtools` is already registered (an app
+* that wires it by hand keeps control). A missing package is the normal case
+* and stays silent; any other load failure is reported and ignored, because
+* a dev tool must never stop the app from booting.
+*/
+async function registerInstalledDevtools(load = () => import(DEVTOOLS_PACKAGE)) {
+	if (connectorsManager.has("devtools")) return false;
+	let devtools;
+	try {
+		devtools = await load();
+	} catch (error) {
+		if (!isMissingPackage(error)) devLogWarn(`${DEVTOOLS_PACKAGE} is installed but failed to load: ${describe(error)}`);
+		return false;
+	}
+	if (typeof devtools.devtoolsConnector !== "function") {
+		devLogWarn(`${DEVTOOLS_PACKAGE} does not export devtoolsConnector(); it was not started`);
+		return false;
+	}
+	connectorsManager.register(devtools.devtoolsConnector());
+	return true;
+}
+/** True when the error says the devtools package itself is not installed. */
+function isMissingPackage(error) {
+	const code = error?.code;
+	if (code !== "ERR_MODULE_NOT_FOUND" && code !== "MODULE_NOT_FOUND") return false;
+	return describe(error).includes(`'${DEVTOOLS_PACKAGE}'`) || describe(error).includes(`"${DEVTOOLS_PACKAGE}"`);
+}
+function describe(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+
+//#endregion
+export { registerInstalledDevtools };
+//# sourceMappingURL=register-installed-devtools.mjs.map

package/esm/dev-server/register-installed-devtools.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-installed-devtools.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/register-installed-devtools.ts"],"sourcesContent":["import { connectorsManager } from \"../connectors/connectors-manager\";\nimport type { Connector } from \"../connectors/types\";\nimport { devLogWarn } from \"./dev-logger\";\n\nconst DEVTOOLS_PACKAGE = \"@warlock.js/devtools\";\n\ntype DevtoolsModule = {\n  devtoolsConnector?: () => Connector;\n};\n\n/**\n * Register `@warlock.js/devtools` when the app has it installed.\n *\n * Called by `warlock dev` only, before the late connector phase, so the app\n * never names devtools in `warlock.config.ts`. That matters because devtools\n * is a DEV dependency: a production install omits it, and a config import of\n * it would fail to resolve there. The production entry never calls this.\n *\n * Skipped when a connector named `devtools` is already registered (an app\n * that wires it by hand keeps control). A missing package is the normal case\n * and stays silent; any other load failure is reported and ignored, because\n * a dev tool must never stop the app from booting.\n */\nexport async function registerInstalledDevtools(\n  load: () => Promise<DevtoolsModule> = () => import(DEVTOOLS_PACKAGE),\n): Promise<boolean> {\n  if (connectorsManager.has(\"devtools\")) {\n    return false;\n  }\n\n  let devtools: DevtoolsModule;\n\n  try {\n    devtools = await load();\n  } catch (error) {\n    if (!isMissingPackage(error)) {\n      devLogWarn(`${DEVTOOLS_PACKAGE} is installed but failed to load: ${describe(error)}`);\n    }\n\n    return false;\n  }\n\n  if (typeof devtools.devtoolsConnector !== \"function\") {\n    devLogWarn(`${DEVTOOLS_PACKAGE} does not export devtoolsConnector(); it was not started`);\n\n    return false;\n  }\n\n  connectorsManager.register(devtools.devtoolsConnector());\n\n  return true;\n}\n\n/** True when the error says the devtools package itself is not installed. */\nfunction isMissingPackage(error: unknown): boolean {\n  const code = (error as { code?: unknown } | undefined)?.code;\n\n  if (code !== \"ERR_MODULE_NOT_FOUND\" && code !== \"MODULE_NOT_FOUND\") {\n    return false;\n  }\n\n  // A missing module INSIDE an installed devtools is a broken install, not an\n  // absent package — only the package's own name counts as \"not installed\".\n  return (\n    describe(error).includes(`'${DEVTOOLS_PACKAGE}'`) ||\n    describe(error).includes(`\"${DEVTOOLS_PACKAGE}\"`)\n  );\n}\n\nfunction describe(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"],"mappings":";;;;AAIA,MAAM,mBAAmB;;;;;;;;;;;;;;AAmBzB,eAAsB,0BACpB,aAA4C,OAAO,mBACjC;CAClB,IAAI,kBAAkB,IAAI,UAAU,GAClC,OAAO;CAGT,IAAI;CAEJ,IAAI;EACF,WAAW,MAAM,KAAK;CACxB,SAAS,OAAO;EACd,IAAI,CAAC,iBAAiB,KAAK,GACzB,WAAW,GAAG,iBAAiB,oCAAoC,SAAS,KAAK,GAAG;EAGtF,OAAO;CACT;CAEA,IAAI,OAAO,SAAS,sBAAsB,YAAY;EACpD,WAAW,GAAG,iBAAiB,yDAAyD;EAExF,OAAO;CACT;CAEA,kBAAkB,SAAS,SAAS,kBAAkB,CAAC;CAEvD,OAAO;AACT;;AAGA,SAAS,iBAAiB,OAAyB;CACjD,MAAM,OAAQ,OAA0C;CAExD,IAAI,SAAS,0BAA0B,SAAS,oBAC9C,OAAO;CAKT,OACE,SAAS,KAAK,CAAC,CAAC,SAAS,IAAI,iBAAiB,EAAE,KAChD,SAAS,KAAK,CAAC,CAAC,SAAS,IAAI,iBAAiB,EAAE;AAEpD;AAEA,SAAS,SAAS,OAAwB;CACxC,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D"}

package/esm/dev-server/run-connector-typings.mjs

@@ -0,0 +1,28 @@
+import { warlockPath } from "../utils/paths.mjs";
+import "../utils/index.mjs";
+import { runTypingsContributions } from "../production/build-contributions.mjs";
+
+//#region ../core/src/dev-server/run-connector-typings.ts
+/**
+* Let connectors write their own typings during `warlock generate.typings`.
+*
+* Core cannot import web, so this drains the `typings` hook of each connector's
+* `build` contribution — the seam `warlock build` reads. The named API snapshot
+* (a child process) is collected only when a hook exists AND the web connector
+* is configured, exactly as the builder does; an API-only app pays nothing and
+* cannot fail here.
+*/
+async function runConnectorTypings({ connectors, appRoot, options, collectRoutes }) {
+	if (!connectors.some((connector) => Boolean(connector.build?.typings))) return;
+	const namedApiRoutes = connectors.some((connector) => connector.name === "web") ? await collectRoutes() : void 0;
+	await runTypingsContributions(connectors, {
+		productionDir: warlockPath("production"),
+		appRoot,
+		options: options(),
+		namedApiRoutes
+	});
+}
+
+//#endregion
+export { runConnectorTypings };
+//# sourceMappingURL=run-connector-typings.mjs.map

package/esm/dev-server/run-connector-typings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-connector-typings.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/run-connector-typings.ts"],"sourcesContent":["import type { Connector } from \"../connectors/types\";\nimport { runTypingsContributions } from \"../production/build-contributions\";\nimport type { NamedApiRoute } from \"../router/types\";\nimport { warlockPath } from \"../utils\";\nimport type { ResolvedBuildConfig } from \"../production/resolve-build-config\";\n\nexport type ConnectorTypingsInput = {\n  connectors: readonly Connector[];\n  appRoot: string;\n  /** Resolved lazily: an app with no typings hook never needs a loaded build config. */\n  options(): ResolvedBuildConfig;\n  /** Fresh registration-only named API route snapshot (a child process in production). */\n  collectRoutes(): Promise<readonly NamedApiRoute[]>;\n};\n\n/**\n * Let connectors write their own typings during `warlock generate.typings`.\n *\n * Core cannot import web, so this drains the `typings` hook of each connector's\n * `build` contribution — the seam `warlock build` reads. The named API snapshot\n * (a child process) is collected only when a hook exists AND the web connector\n * is configured, exactly as the builder does; an API-only app pays nothing and\n * cannot fail here.\n */\nexport async function runConnectorTypings({\n  connectors,\n  appRoot,\n  options,\n  collectRoutes,\n}: ConnectorTypingsInput): Promise<void> {\n  if (!connectors.some((connector) => Boolean(connector.build?.typings))) return;\n\n  const namedApiRoutes = connectors.some((connector) => connector.name === \"web\")\n    ? await collectRoutes()\n    : undefined;\n\n  await runTypingsContributions(connectors, {\n    productionDir: warlockPath(\"production\"),\n    appRoot,\n    options: options(),\n    namedApiRoutes,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;AAwBA,eAAsB,oBAAoB,EACxC,YACA,SACA,SACA,iBACuC;CACvC,IAAI,CAAC,WAAW,MAAM,cAAc,QAAQ,UAAU,OAAO,OAAO,CAAC,GAAG;CAExE,MAAM,iBAAiB,WAAW,MAAM,cAAc,UAAU,SAAS,KAAK,IAC1E,MAAM,cAAc,IACpB;CAEJ,MAAM,wBAAwB,YAAY;EACxC,eAAe,YAAY,YAAY;EACvC;EACA,SAAS,QAAQ;EACjB;CACF,CAAC;AACH"}

package/esm/dev-server/special-file-patterns.mjs

@@ -6,13 +6,15 @@ const isConfigFile = (path) => /^src\/config\/.*\.(ts|tsx)$/.test(normalize(path
 const isMainFile = (path) => /^src\/app\/([^/]+\/)?main\.(ts|tsx)$/.test(normalize(path));
 /** `src/app/<module>/routes.ts` — one level deep */
 const isRouteFile = (path) => /^src\/app\/[^/]+\/routes\.(ts|tsx)$/.test(normalize(path));
+/** `src/app/worker.ts` or `src/app/<module>/worker.ts` — mirrors `isMainFile`'s optional module dir */
+const isWorkerFile = (path) => /^src\/app\/([^/]+\/)?worker\.(ts|tsx)$/.test(normalize(path));
 /** `src/app/<module>/events/<file>.ts` */
 const isEventFile = (path) => /^src\/app\/[^/]+\/events\/[^/]+\.(ts|tsx)$/.test(normalize(path));
-/** `src/app/<module>/utils/locales.ts` */
-const isLocaleFile = (path) => /^src\/app\/[^/]+\/utils\/locales\.(ts|tsx)$/.test(normalize(path));
+/** `src/app/<module>/utils/locales.ts` or `locales.json` */
+const isLocaleFile = (path) => /^src\/app\/[^/]+\/utils\/locales\.(ts|tsx|json)$/.test(normalize(path));
 /** Source files the dev server can hot-reload; anything else is data (`.sql`, `.json`, …) */
 const isCodeFile = (path) => /\.(ts|tsx|js|jsx|mjs|cjs|mts|cts)$/.test(normalize(path));
 
 //#endregion
-export { isCodeFile, isConfigFile, isEventFile, isLocaleFile, isMainFile, isRouteFile };
+export { isCodeFile, isConfigFile, isEventFile, isLocaleFile, isMainFile, isRouteFile, isWorkerFile };
 //# sourceMappingURL=special-file-patterns.mjs.map

package/esm/dev-server/special-file-patterns.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"special-file-patterns.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/special-file-patterns.ts"],"sourcesContent":["const normalize = (path: string) => path.replace(/\\\\/g, \"/\");\n\n/** `src/config/**` — any depth, the config key is the raw path */\nexport const isConfigFile = (path: string) => /^src\\/config\\/.*\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/main.ts` or `src/app/<module>/main.ts` */\nexport const isMainFile = (path: string) =>\n  /^src\\/app\\/([^/]+\\/)?main\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/<module>/routes.ts` — one level deep */\nexport const isRouteFile = (path: string) =>\n  /^src\\/app\\/[^/]+\\/routes\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/<module>/events/<file>.ts` */\nexport const isEventFile = (path: string) =>\n  /^src\\/app\\/[^/]+\\/events\\/[^/]+\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/<module>/utils/locales.ts` */\nexport const isLocaleFile = (path: string) =>\n  /^src\\/app\\/[^/]+\\/utils\\/locales\\.(ts|tsx)$/.test(normalize(path));\n\n/** Source files the dev server can hot-reload; anything else is data (`.sql`, `.json`, …) */\nexport const isCodeFile = (path: string) =>\n  /\\.(ts|tsx|js|jsx|mjs|cjs|mts|cts)$/.test(normalize(path));\n"],"mappings":";AAAA,MAAM,aAAa,SAAiB,KAAK,QAAQ,OAAO,GAAG;;AAG3D,MAAa,gBAAgB,SAAiB,8BAA8B,KAAK,UAAU,IAAI,CAAC;;AAGhG,MAAa,cAAc,SACzB,uCAAuC,KAAK,UAAU,IAAI,CAAC;;AAG7D,MAAa,eAAe,SAC1B,sCAAsC,KAAK,UAAU,IAAI,CAAC;;AAG5D,MAAa,eAAe,SAC1B,6CAA6C,KAAK,UAAU,IAAI,CAAC;;AAGnE,MAAa,gBAAgB,SAC3B,8CAA8C,KAAK,UAAU,IAAI,CAAC;;AAGpE,MAAa,cAAc,SACzB,qCAAqC,KAAK,UAAU,IAAI,CAAC"}
+{"version":3,"file":"special-file-patterns.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/special-file-patterns.ts"],"sourcesContent":["const normalize = (path: string) => path.replace(/\\\\/g, \"/\");\n\n/** `src/config/**` — any depth, the config key is the raw path */\nexport const isConfigFile = (path: string) => /^src\\/config\\/.*\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/main.ts` or `src/app/<module>/main.ts` */\nexport const isMainFile = (path: string) =>\n  /^src\\/app\\/([^/]+\\/)?main\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/<module>/routes.ts` — one level deep */\nexport const isRouteFile = (path: string) =>\n  /^src\\/app\\/[^/]+\\/routes\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/worker.ts` or `src/app/<module>/worker.ts` — mirrors `isMainFile`'s optional module dir */\nexport const isWorkerFile = (path: string) =>\n  /^src\\/app\\/([^/]+\\/)?worker\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/<module>/events/<file>.ts` */\nexport const isEventFile = (path: string) =>\n  /^src\\/app\\/[^/]+\\/events\\/[^/]+\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/<module>/utils/locales.ts` or `locales.json` */\nexport const isLocaleFile = (path: string) =>\n  /^src\\/app\\/[^/]+\\/utils\\/locales\\.(ts|tsx|json)$/.test(normalize(path));\n\n/** Source files the dev server can hot-reload; anything else is data (`.sql`, `.json`, …) */\nexport const isCodeFile = (path: string) =>\n  /\\.(ts|tsx|js|jsx|mjs|cjs|mts|cts)$/.test(normalize(path));\n"],"mappings":";AAAA,MAAM,aAAa,SAAiB,KAAK,QAAQ,OAAO,GAAG;;AAG3D,MAAa,gBAAgB,SAAiB,8BAA8B,KAAK,UAAU,IAAI,CAAC;;AAGhG,MAAa,cAAc,SACzB,uCAAuC,KAAK,UAAU,IAAI,CAAC;;AAG7D,MAAa,eAAe,SAC1B,sCAAsC,KAAK,UAAU,IAAI,CAAC;;AAG5D,MAAa,gBAAgB,SAC3B,yCAAyC,KAAK,UAAU,IAAI,CAAC;;AAG/D,MAAa,eAAe,SAC1B,6CAA6C,KAAK,UAAU,IAAI,CAAC;;AAGnE,MAAa,gBAAgB,SAC3B,mDAAmD,KAAK,UAAU,IAAI,CAAC;;AAGzE,MAAa,cAAc,SACzB,qCAAqC,KAAK,UAAU,IAAI,CAAC"}

package/esm/dev-server/special-files-collector.d.mts

@@ -1,10 +1,10 @@
 import { FileManager } from "./file-manager.mjs";
 
 //#region ../core/src/dev-server/special-files-collector.d.ts
-type SpecialFileType = "config" | "main" | "route" | "event" | "locale";
+type SpecialFileType = "config" | "main" | "route" | "event" | "locale" | "worker";
 /**
  * Categorises files into the kinds the dev server treats specially
- * (config / main / route / event / locale) and exposes typed accessors.
+ * (config / main / route / event / locale / worker) and exposes typed accessors.
  */
 declare class SpecialFilesCollector {
   private readonly buckets;

package/esm/dev-server/special-files-collector.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"special-files-collector.d.mts","names":[],"sources":["../../../../../../../core/src/dev-server/special-files-collector.ts"],"mappings":";;;KASY,eAAA;;AAAZ;;;cAMa,qBAAA;EAAA,iBACM,OAAA;EAQV,OAAA,CAAQ,KAAA,EAAO,GAAA,SAAY,WAAA;EAO3B,OAAA,CAAQ,WAAA,EAAa,WAAA;EAIrB,UAAA,CAAW,YAAA;EAIX,UAAA,CAAW,WAAA,EAAa,WAAA;EAKxB,WAAA,CAAY,YAAA,WAAuB,eAAA;EAUnC,cAAA,CAAe,IAAA,EAAM,eAAA,GAAkB,WAAA;EAUvC,QAAA,IAAY,MAAA,CAAO,eAAA;EAUnB,KAAA;EAAA,QAIC,UAAA;AAAA"}
+{"version":3,"file":"special-files-collector.d.mts","names":[],"sources":["../../../../../../../core/src/dev-server/special-files-collector.ts"],"mappings":";;;KAUY,eAAA;;AAAZ;;;cAMa,qBAAA;EAAA,iBACM,OAAA;EASV,OAAA,CAAQ,KAAA,EAAO,GAAA,SAAY,WAAA;EAO3B,OAAA,CAAQ,WAAA,EAAa,WAAA;EAIrB,UAAA,CAAW,YAAA;EAIX,UAAA,CAAW,WAAA,EAAa,WAAA;EAKxB,WAAA,CAAY,YAAA,WAAuB,eAAA;EAUnC,cAAA,CAAe,IAAA,EAAM,eAAA,GAAkB,WAAA;EAUvC,QAAA,IAAY,MAAA,CAAO,eAAA;EAWnB,KAAA;EAAA,QAIC,UAAA;AAAA"}

package/esm/dev-server/special-files-collector.mjs

@@ -1,9 +1,9 @@
-import { isConfigFile, isEventFile, isLocaleFile, isMainFile, isRouteFile } from "./special-file-patterns.mjs";
+import { isConfigFile, isEventFile, isLocaleFile, isMainFile, isRouteFile, isWorkerFile } from "./special-file-patterns.mjs";
 
 //#region ../core/src/dev-server/special-files-collector.ts
 /**
 * Categorises files into the kinds the dev server treats specially
-* (config / main / route / event / locale) and exposes typed accessors.
+* (config / main / route / event / locale / worker) and exposes typed accessors.
 */
 var SpecialFilesCollector = class {
 	constructor() {
@@ -12,7 +12,8 @@ var SpecialFilesCollector = class {
 			main: /* @__PURE__ */ new Map(),
 			route: /* @__PURE__ */ new Map(),
 			event: /* @__PURE__ */ new Map(),
-			locale: /* @__PURE__ */ new Map()
+			locale: /* @__PURE__ */ new Map(),
+			worker: /* @__PURE__ */ new Map()
 		};
 	}
 	collect(files) {
@@ -44,7 +45,8 @@ var SpecialFilesCollector = class {
 			main: this.buckets.main.size,
 			route: this.buckets.route.size,
 			event: this.buckets.event.size,
-			locale: this.buckets.locale.size
+			locale: this.buckets.locale.size,
+			worker: this.buckets.worker.size
 		};
 	}
 	clear() {
@@ -56,6 +58,7 @@ var SpecialFilesCollector = class {
 		else if (isRouteFile(relativePath)) this.buckets.route.set(relativePath, fileManager);
 		else if (isEventFile(relativePath)) this.buckets.event.set(relativePath, fileManager);
 		else if (isLocaleFile(relativePath)) this.buckets.locale.set(relativePath, fileManager);
+		else if (isWorkerFile(relativePath)) this.buckets.worker.set(relativePath, fileManager);
 	}
 };
 

package/esm/dev-server/special-files-collector.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"special-files-collector.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/special-files-collector.ts"],"sourcesContent":["import { FileManager } from \"./file-manager\";\r\nimport {\r\n  isConfigFile,\r\n  isEventFile,\r\n  isLocaleFile,\r\n  isMainFile,\r\n  isRouteFile,\r\n} from \"./special-file-patterns\";\r\n\r\nexport type SpecialFileType = \"config\" | \"main\" | \"route\" | \"event\" | \"locale\";\r\n\r\n/**\r\n * Categorises files into the kinds the dev server treats specially\r\n * (config / main / route / event / locale) and exposes typed accessors.\r\n */\r\nexport class SpecialFilesCollector {\r\n  private readonly buckets: Record<SpecialFileType, Map<string, FileManager>> = {\r\n    config: new Map(),\r\n    main: new Map(),\r\n    route: new Map(),\r\n    event: new Map(),\r\n    locale: new Map(),\r\n  };\r\n\r\n  public collect(files: Map<string, FileManager>): void {\r\n    for (const bucket of Object.values(this.buckets)) bucket.clear();\r\n    for (const [relativePath, fileManager] of files) {\r\n      this.categorise(relativePath, fileManager);\r\n    }\r\n  }\r\n\r\n  public addFile(fileManager: FileManager): void {\r\n    this.categorise(fileManager.relativePath, fileManager);\r\n  }\r\n\r\n  public removeFile(relativePath: string): void {\r\n    for (const bucket of Object.values(this.buckets)) bucket.delete(relativePath);\r\n  }\r\n\r\n  public updateFile(fileManager: FileManager): void {\r\n    this.removeFile(fileManager.relativePath);\r\n    this.categorise(fileManager.relativePath, fileManager);\r\n  }\r\n\r\n  public getFileType(relativePath: string): SpecialFileType | null {\r\n    for (const [type, bucket] of Object.entries(this.buckets) as [\r\n      SpecialFileType,\r\n      Map<string, FileManager>,\r\n    ][]) {\r\n      if (bucket.has(relativePath)) return type;\r\n    }\r\n    return null;\r\n  }\r\n\r\n  public getFilesByType(type: SpecialFileType): FileManager[] {\r\n    const files = Array.from(this.buckets[type].values());\r\n    // Routes are loaded sequentially in alphabetical order so registration\r\n    // is deterministic across runs.\r\n    if (type === \"route\") {\r\n      files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));\r\n    }\r\n    return files;\r\n  }\r\n\r\n  public getStats(): Record<SpecialFileType, number> {\r\n    return {\r\n      config: this.buckets.config.size,\r\n      main: this.buckets.main.size,\r\n      route: this.buckets.route.size,\r\n      event: this.buckets.event.size,\r\n      locale: this.buckets.locale.size,\r\n    };\r\n  }\r\n\r\n  public clear(): void {\r\n    for (const bucket of Object.values(this.buckets)) bucket.clear();\r\n  }\r\n\r\n  private categorise(relativePath: string, fileManager: FileManager): void {\r\n    if (isConfigFile(relativePath)) {\r\n      this.buckets.config.set(relativePath, fileManager);\r\n    } else if (isMainFile(relativePath)) {\r\n      this.buckets.main.set(relativePath, fileManager);\r\n    } else if (isRouteFile(relativePath)) {\r\n      this.buckets.route.set(relativePath, fileManager);\r\n    } else if (isEventFile(relativePath)) {\r\n      this.buckets.event.set(relativePath, fileManager);\r\n    } else if (isLocaleFile(relativePath)) {\r\n      this.buckets.locale.set(relativePath, fileManager);\r\n    }\r\n  }\r\n}\r\n\r\n"],"mappings":";;;;;;;AAeA,IAAa,wBAAb,MAAmC;;iBAC6C;GAC5E,wBAAQ,IAAI,IAAI;GAChB,sBAAM,IAAI,IAAI;GACd,uBAAO,IAAI,IAAI;GACf,uBAAO,IAAI,IAAI;GACf,wBAAQ,IAAI,IAAI;EAClB;;CAEA,AAAO,QAAQ,OAAuC;EACpD,KAAK,MAAM,UAAU,OAAO,OAAO,KAAK,OAAO,GAAG,OAAO,MAAM;EAC/D,KAAK,MAAM,CAAC,cAAc,gBAAgB,OACxC,KAAK,WAAW,cAAc,WAAW;CAE7C;CAEA,AAAO,QAAQ,aAAgC;EAC7C,KAAK,WAAW,YAAY,cAAc,WAAW;CACvD;CAEA,AAAO,WAAW,cAA4B;EAC5C,KAAK,MAAM,UAAU,OAAO,OAAO,KAAK,OAAO,GAAG,OAAO,OAAO,YAAY;CAC9E;CAEA,AAAO,WAAW,aAAgC;EAChD,KAAK,WAAW,YAAY,YAAY;EACxC,KAAK,WAAW,YAAY,cAAc,WAAW;CACvD;CAEA,AAAO,YAAY,cAA8C;EAC/D,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,KAAK,OAAO,GAItD,IAAI,OAAO,IAAI,YAAY,GAAG,OAAO;EAEvC,OAAO;CACT;CAEA,AAAO,eAAe,MAAsC;EAC1D,MAAM,QAAQ,MAAM,KAAK,KAAK,QAAQ,KAAK,CAAC,OAAO,CAAC;EAGpD,IAAI,SAAS,SACX,MAAM,MAAM,GAAG,MAAM,EAAE,aAAa,cAAc,EAAE,YAAY,CAAC;EAEnE,OAAO;CACT;CAEA,AAAO,WAA4C;EACjD,OAAO;GACL,QAAQ,KAAK,QAAQ,OAAO;GAC5B,MAAM,KAAK,QAAQ,KAAK;GACxB,OAAO,KAAK,QAAQ,MAAM;GAC1B,OAAO,KAAK,QAAQ,MAAM;GAC1B,QAAQ,KAAK,QAAQ,OAAO;EAC9B;CACF;CAEA,AAAO,QAAc;EACnB,KAAK,MAAM,UAAU,OAAO,OAAO,KAAK,OAAO,GAAG,OAAO,MAAM;CACjE;CAEA,AAAQ,WAAW,cAAsB,aAAgC;EACvE,IAAI,aAAa,YAAY,GAC3B,KAAK,QAAQ,OAAO,IAAI,cAAc,WAAW;OAC5C,IAAI,WAAW,YAAY,GAChC,KAAK,QAAQ,KAAK,IAAI,cAAc,WAAW;OAC1C,IAAI,YAAY,YAAY,GACjC,KAAK,QAAQ,MAAM,IAAI,cAAc,WAAW;OAC3C,IAAI,YAAY,YAAY,GACjC,KAAK,QAAQ,MAAM,IAAI,cAAc,WAAW;OAC3C,IAAI,aAAa,YAAY,GAClC,KAAK,QAAQ,OAAO,IAAI,cAAc,WAAW;CAErD;AACF"}
+{"version":3,"file":"special-files-collector.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/special-files-collector.ts"],"sourcesContent":["import { FileManager } from \"./file-manager\";\nimport {\n  isConfigFile,\n  isEventFile,\n  isLocaleFile,\n  isMainFile,\n  isRouteFile,\n  isWorkerFile,\n} from \"./special-file-patterns\";\n\nexport type SpecialFileType = \"config\" | \"main\" | \"route\" | \"event\" | \"locale\" | \"worker\";\n\n/**\n * Categorises files into the kinds the dev server treats specially\n * (config / main / route / event / locale / worker) and exposes typed accessors.\n */\nexport class SpecialFilesCollector {\n  private readonly buckets: Record<SpecialFileType, Map<string, FileManager>> = {\n    config: new Map(),\n    main: new Map(),\n    route: new Map(),\n    event: new Map(),\n    locale: new Map(),\n    worker: new Map(),\n  };\n\n  public collect(files: Map<string, FileManager>): void {\n    for (const bucket of Object.values(this.buckets)) bucket.clear();\n    for (const [relativePath, fileManager] of files) {\n      this.categorise(relativePath, fileManager);\n    }\n  }\n\n  public addFile(fileManager: FileManager): void {\n    this.categorise(fileManager.relativePath, fileManager);\n  }\n\n  public removeFile(relativePath: string): void {\n    for (const bucket of Object.values(this.buckets)) bucket.delete(relativePath);\n  }\n\n  public updateFile(fileManager: FileManager): void {\n    this.removeFile(fileManager.relativePath);\n    this.categorise(fileManager.relativePath, fileManager);\n  }\n\n  public getFileType(relativePath: string): SpecialFileType | null {\n    for (const [type, bucket] of Object.entries(this.buckets) as [\n      SpecialFileType,\n      Map<string, FileManager>,\n    ][]) {\n      if (bucket.has(relativePath)) return type;\n    }\n    return null;\n  }\n\n  public getFilesByType(type: SpecialFileType): FileManager[] {\n    const files = Array.from(this.buckets[type].values());\n    // Routes are loaded sequentially in alphabetical order so registration\n    // is deterministic across runs.\n    if (type === \"route\") {\n      files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));\n    }\n    return files;\n  }\n\n  public getStats(): Record<SpecialFileType, number> {\n    return {\n      config: this.buckets.config.size,\n      main: this.buckets.main.size,\n      route: this.buckets.route.size,\n      event: this.buckets.event.size,\n      locale: this.buckets.locale.size,\n      worker: this.buckets.worker.size,\n    };\n  }\n\n  public clear(): void {\n    for (const bucket of Object.values(this.buckets)) bucket.clear();\n  }\n\n  private categorise(relativePath: string, fileManager: FileManager): void {\n    if (isConfigFile(relativePath)) {\n      this.buckets.config.set(relativePath, fileManager);\n    } else if (isMainFile(relativePath)) {\n      this.buckets.main.set(relativePath, fileManager);\n    } else if (isRouteFile(relativePath)) {\n      this.buckets.route.set(relativePath, fileManager);\n    } else if (isEventFile(relativePath)) {\n      this.buckets.event.set(relativePath, fileManager);\n    } else if (isLocaleFile(relativePath)) {\n      this.buckets.locale.set(relativePath, fileManager);\n    } else if (isWorkerFile(relativePath)) {\n      this.buckets.worker.set(relativePath, fileManager);\n    }\n  }\n}\n"],"mappings":";;;;;;;AAgBA,IAAa,wBAAb,MAAmC;;iBAC6C;GAC5E,wBAAQ,IAAI,IAAI;GAChB,sBAAM,IAAI,IAAI;GACd,uBAAO,IAAI,IAAI;GACf,uBAAO,IAAI,IAAI;GACf,wBAAQ,IAAI,IAAI;GAChB,wBAAQ,IAAI,IAAI;EAClB;;CAEA,AAAO,QAAQ,OAAuC;EACpD,KAAK,MAAM,UAAU,OAAO,OAAO,KAAK,OAAO,GAAG,OAAO,MAAM;EAC/D,KAAK,MAAM,CAAC,cAAc,gBAAgB,OACxC,KAAK,WAAW,cAAc,WAAW;CAE7C;CAEA,AAAO,QAAQ,aAAgC;EAC7C,KAAK,WAAW,YAAY,cAAc,WAAW;CACvD;CAEA,AAAO,WAAW,cAA4B;EAC5C,KAAK,MAAM,UAAU,OAAO,OAAO,KAAK,OAAO,GAAG,OAAO,OAAO,YAAY;CAC9E;CAEA,AAAO,WAAW,aAAgC;EAChD,KAAK,WAAW,YAAY,YAAY;EACxC,KAAK,WAAW,YAAY,cAAc,WAAW;CACvD;CAEA,AAAO,YAAY,cAA8C;EAC/D,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,KAAK,OAAO,GAItD,IAAI,OAAO,IAAI,YAAY,GAAG,OAAO;EAEvC,OAAO;CACT;CAEA,AAAO,eAAe,MAAsC;EAC1D,MAAM,QAAQ,MAAM,KAAK,KAAK,QAAQ,KAAK,CAAC,OAAO,CAAC;EAGpD,IAAI,SAAS,SACX,MAAM,MAAM,GAAG,MAAM,EAAE,aAAa,cAAc,EAAE,YAAY,CAAC;EAEnE,OAAO;CACT;CAEA,AAAO,WAA4C;EACjD,OAAO;GACL,QAAQ,KAAK,QAAQ,OAAO;GAC5B,MAAM,KAAK,QAAQ,KAAK;GACxB,OAAO,KAAK,QAAQ,MAAM;GAC1B,OAAO,KAAK,QAAQ,MAAM;GAC1B,QAAQ,KAAK,QAAQ,OAAO;GAC5B,QAAQ,KAAK,QAAQ,OAAO;EAC9B;CACF;CAEA,AAAO,QAAc;EACnB,KAAK,MAAM,UAAU,OAAO,OAAO,KAAK,OAAO,GAAG,OAAO,MAAM;CACjE;CAEA,AAAQ,WAAW,cAAsB,aAAgC;EACvE,IAAI,aAAa,YAAY,GAC3B,KAAK,QAAQ,OAAO,IAAI,cAAc,WAAW;OAC5C,IAAI,WAAW,YAAY,GAChC,KAAK,QAAQ,KAAK,IAAI,cAAc,WAAW;OAC1C,IAAI,YAAY,YAAY,GACjC,KAAK,QAAQ,MAAM,IAAI,cAAc,WAAW;OAC3C,IAAI,YAAY,YAAY,GACjC,KAAK,QAAQ,MAAM,IAAI,cAAc,WAAW;OAC3C,IAAI,aAAa,YAAY,GAClC,KAAK,QAAQ,OAAO,IAAI,cAAc,WAAW;OAC5C,IAAI,aAAa,YAAY,GAClC,KAAK,QAAQ,OAAO,IAAI,cAAc,WAAW;CAErD;AACF"}

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

@@ -1,5 +1,9 @@
 //#region ../core/src/dev-server/translation-keys-sources.ts
 const GROUPED_TRANSLATIONS_MARKER = "groupedTranslations";
+/** `src/app/<module>/utils/locales.json`, the data-only module dictionary. */
+function isModuleLocaleDictionaryPath(path) {
+	return /^src\/app\/[^/]+\/utils\/locales\.json$/.test(path.replace(/\\\\/g, "/"));
+}
 /**
 * Cheap pre-filter for candidate translation-registering source files.
 *
@@ -10,10 +14,10 @@ const GROUPED_TRANSLATIONS_MARKER = "groupedTranslations";
 * every file — this text check keeps that cheap by skipping the AST parse
 * for the files that plainly do not call it, without executing app code.
 */
-function isTranslationRegisteringSource(source) {
-	return source.includes(GROUPED_TRANSLATIONS_MARKER);
+function isTranslationRegisteringSource(path, source) {
+	return isModuleLocaleDictionaryPath(path) || source.includes(GROUPED_TRANSLATIONS_MARKER);
 }
 
 //#endregion
-export { isTranslationRegisteringSource };
+export { isModuleLocaleDictionaryPath, isTranslationRegisteringSource };
 //# sourceMappingURL=translation-keys-sources.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"translation-keys-sources.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/translation-keys-sources.ts"],"sourcesContent":["const GROUPED_TRANSLATIONS_MARKER = \"groupedTranslations\";\n\n/**\n * Cheap pre-filter for candidate translation-registering source files.\n *\n * `groupedTranslations` calls used to be scanned for on dedicated\n * `src/**​/utils/locales.*` files only, so a web module registering keys\n * elsewhere (e.g. `src/web/layout.register.ts`) was silently invisible to the\n * generator. Any app source file can call it, so discovery has to consider\n * every file — this text check keeps that cheap by skipping the AST parse\n * for the files that plainly do not call it, without executing app code.\n */\nexport function isTranslationRegisteringSource(source: string): boolean {\n  return source.includes(GROUPED_TRANSLATIONS_MARKER);\n}\n"],"mappings":";AAAA,MAAM,8BAA8B;;;;;;;;;;;AAYpC,SAAgB,+BAA+B,QAAyB;CACtE,OAAO,OAAO,SAAS,2BAA2B;AACpD"}
+{"version":3,"file":"translation-keys-sources.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/translation-keys-sources.ts"],"sourcesContent":["const GROUPED_TRANSLATIONS_MARKER = \"groupedTranslations\";\n\n/** `src/app/<module>/utils/locales.json`, the data-only module dictionary. */\nexport function isModuleLocaleDictionaryPath(path: string): boolean {\n  return /^src\\/app\\/[^/]+\\/utils\\/locales\\.json$/.test(path.replace(/\\\\\\\\/g, \"/\"));\n}\n\n/**\n * Cheap pre-filter for candidate translation-registering source files.\n *\n * `groupedTranslations` calls used to be scanned for on dedicated\n * `src/**​/utils/locales.*` files only, so a web module registering keys\n * elsewhere (e.g. `src/web/layout.register.ts`) was silently invisible to the\n * generator. Any app source file can call it, so discovery has to consider\n * every file — this text check keeps that cheap by skipping the AST parse\n * for the files that plainly do not call it, without executing app code.\n */\nexport function isTranslationRegisteringSource(path: string, source: string): boolean {\n  return isModuleLocaleDictionaryPath(path) || source.includes(GROUPED_TRANSLATIONS_MARKER);\n}\n"],"mappings":";AAAA,MAAM,8BAA8B;;AAGpC,SAAgB,6BAA6B,MAAuB;CAClE,OAAO,0CAA0C,KAAK,KAAK,QAAQ,SAAS,GAAG,CAAC;AAClF;;;;;;;;;;;AAYA,SAAgB,+BAA+B,MAAc,QAAyB;CACpF,OAAO,6BAA6B,IAAI,KAAK,OAAO,SAAS,2BAA2B;AAC1F"}

package/esm/dev-server/type-generator.mjs

@@ -1,12 +1,15 @@
 import { Path } from "../utils/normalized-path.mjs";
 import { warlockPath } from "../utils/paths.mjs";
 import "../utils/index.mjs";
+import { parseLocaleDictionary } from "../localization/parse-locale-dictionary.mjs";
+import "../localization/index.mjs";
 import { devLogError, devLogInfo, devLogSuccess, devServeLog } from "./dev-logger.mjs";
+import { getFilesFromDirectory } from "./utils.mjs";
+import { extractTranslationKeys } from "./extract-translation-keys.mjs";
 import { filesOrchestrator } from "./files-orchestrator.mjs";
 import { readConfigAst } from "./read-config-ast.mjs";
 import { runTypingsGeneration } from "./run-typings-generation.mjs";
-import { extractTranslationKeys } from "./extract-translation-keys.mjs";
-import { isTranslationRegisteringSource } from "./translation-keys-sources.mjs";
+import { isModuleLocaleDictionaryPath, isTranslationRegisteringSource } from "./translation-keys-sources.mjs";
 import { join, resolve } from "path";
 import { ensureDirectoryAsync } from "@warlock.js/fs";
 import { constants } from "fs";
@@ -233,11 +236,30 @@ ${driverKeys.map((k) => `    ${this.toInterfaceKey(k)}: true;`).join("\n")}
 		const keys = /* @__PURE__ */ new Set();
 		const sourceFiles = /* @__PURE__ */ new Set();
 		for (const [path, fileManager] of filesOrchestrator.getFiles()) {
-			if (!isTranslationRegisteringSource(fileManager.source)) continue;
+			if (!isTranslationRegisteringSource(path, fileManager.source)) continue;
 			sourceFiles.add(path);
+			if (isModuleLocaleDictionaryPath(path)) {
+				const dictionary = parseLocaleDictionary({
+					sourceFile: path,
+					source: fileManager.source,
+					defaultNamespace: path.split("/")[2]
+				});
+				for (const key of Object.keys(dictionary.entries)) keys.add(key);
+				continue;
+			}
 			const sourceFile = await readConfigAst(fileManager.absolutePath);
 			if (sourceFile) for (const key of extractTranslationKeys(sourceFile)) keys.add(key);
 		}
+		for (const absolutePath of await getFilesFromDirectory(join(process.cwd(), "src", "app"), "**/utils/locales.json")) {
+			const path = Path.toRelative(absolutePath);
+			sourceFiles.add(path);
+			const dictionary = parseLocaleDictionary({
+				sourceFile: path,
+				source: await readFile(absolutePath, "utf-8"),
+				defaultNamespace: path.split("/")[2]
+			});
+			for (const key of Object.keys(dictionary.entries)) keys.add(key);
+		}
 		for (const key of await listRouteLocaleKeysForTypeGeneration()) keys.add(key);
 		this.translationSourceFiles = sourceFiles;
 		const content = `// Auto-generated by Warlock.js - DO NOT EDIT
@@ -517,9 +539,10 @@ ${allKeys.map((key) => `    "${key}": true;`).join("\n")}
 			const normalizedPath = Path.normalize(file);
 			if (normalizedPath.includes("src/config/")) return true;
 			if (isRouteLocalesJsonPath(normalizedPath)) return true;
+			if (isModuleLocaleDictionaryPath(normalizedPath)) return true;
 			if (this.translationSourceFiles.has(normalizedPath)) return true;
 			const fileManager = files.get(normalizedPath);
-			return fileManager !== void 0 && isTranslationRegisteringSource(fileManager.source);
+			return fileManager !== void 0 && isTranslationRegisteringSource(normalizedPath, fileManager.source);
 		}))) return;
 		await runTypingsGeneration(this.typingsGenerationPorts);
 	}