@warlock.js/core 5.30.0 → 5.32.0

package/esm/dev-server/health-checker/workers/ts-health.worker.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ts-health.worker.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/dev-server/health-checker/workers/ts-health.worker.ts"],"sourcesContent":["/**\n * TypeScript Health Check Worker\n *\n * This worker runs in a dedicated thread to perform TypeScript type checking\n * without blocking the main dev server thread. It maintains a persistent\n * ts.Program instance for fast incremental type checking.\n *\n * Communication:\n * - Receives: { type: 'init' | 'check' | 'fileChanges' | 'shutdown', ... }\n * - Sends: { type: 'results' | 'initialized' | 'error', ... }\n */\nimport ts from \"typescript\";\nimport path from \"node:path\";\nimport { parentPort, workerData } from \"worker_threads\";\n\n/**\n * Serialized file data received from main thread\n */\ntype SerializedFile = {\n  /** Absolute file path */\n  path: string;\n  /** File content (source code) */\n  content: string;\n  /** Relative path for display */\n  relativePath: string;\n};\n\n/**\n * Diagnostic message sent back to main thread\n */\ntype DiagnosticMessage = {\n  type: \"error\" | \"warning\";\n  message: string;\n  lineNumber: number;\n  columnNumber: number;\n  length: number;\n  filePath: string;\n  relativePath: string;\n};\n\n/**\n * Health check result for a single file\n */\ntype FileCheckResult = {\n  path: string;\n  relativePath: string;\n  healthy: boolean;\n  errors: DiagnosticMessage[];\n  warnings: DiagnosticMessage[];\n};\n\n/**\n * Messages received from main thread\n */\n/**\n * Deleted file info\n */\ntype DeletedFile = {\n  path: string;\n  relativePath: string;\n};\n\n/**\n * Messages received from main thread\n */\ntype WorkerMessage =\n  | { type: \"init\"; config: { cwd: string; tsconfigPath?: string } }\n  | { type: \"check\"; files: SerializedFile[] }\n  | { type: \"fileChanges\"; files: SerializedFile[] }\n  | { type: \"filesDeleted\"; files: DeletedFile[] }\n  | { type: \"shutdown\" };\n\n/**\n * Messages sent to main thread\n */\ntype WorkerResponse =\n  | { type: \"initialized\"; success: boolean; error?: string }\n  | { type: \"results\"; results: FileCheckResult[] }\n  | { type: \"error\"; message: string };\n\n/**\n * TypeScript Health Worker class\n * Maintains persistent ts.Program for incremental type checking\n */\nclass TypeScriptHealthWorker {\n  /**\n   * Cached TypeScript program instance\n   */\n  private program: ts.Program | null = null;\n\n  /**\n   * Parsed TypeScript configuration\n   */\n  private parsedConfig: ts.ParsedCommandLine | null = null;\n\n  /**\n   * In-memory file contents cache\n   */\n  private fileContents = new Map<string, string>();\n\n  /** Source paths removed since the tsconfig was parsed. */\n  private deletedRootPaths = new Set<string>();\n\n  /**\n   * Whether the worker is initialized\n   */\n  private initialized = false;\n\n  /**\n   * Current working directory\n   */\n  private cwd: string = process.cwd();\n\n  /**\n   * Initialize the worker with TypeScript configuration\n   */\n  public initialize(config: { cwd: string; tsconfigPath?: string }): boolean {\n    try {\n      this.cwd = config.cwd || process.cwd();\n\n      // Try to load tsconfig.json\n      const tsconfigPath = config.tsconfigPath || ts.findConfigFile(this.cwd, ts.sys.fileExists);\n\n      if (!tsconfigPath) {\n        this.initialized = true;\n        return true; // No tsconfig, will skip type checking\n      }\n\n      const configFile = ts.readConfigFile(tsconfigPath, ts.sys.readFile);\n\n      if (configFile.error) {\n        console.warn(\"TypeScript Worker: Error reading tsconfig:\", configFile.error);\n        this.initialized = true;\n        return true;\n      }\n\n      this.parsedConfig = ts.parseJsonConfigFileContent(configFile.config, ts.sys, this.cwd);\n\n      if (this.parsedConfig.errors.length > 0) {\n        console.warn(\"TypeScript Worker: tsconfig has errors:\", this.parsedConfig.errors);\n      }\n\n      this.initialized = true;\n      return true;\n    } catch (error) {\n      console.error(\"TypeScript Worker: Failed to initialize:\", error);\n      this.initialized = true;\n      return false;\n    }\n  }\n\n  /**\n   * Check files for TypeScript errors\n   */\n  public checkFiles(files: SerializedFile[]): FileCheckResult[] {\n    if (!this.parsedConfig) {\n      // No config, return all files as healthy\n      return files.map((file) => ({\n        path: file.path,\n        relativePath: file.relativePath,\n        healthy: true,\n        errors: [],\n        warnings: [],\n      }));\n    }\n\n    // Update in-memory file cache\n    for (const file of files) {\n      this.fileContents.set(file.path, file.content);\n      this.deletedRootPaths.delete(this.getPathIdentity(file.path));\n    }\n\n    // Create or update the program (incremental)\n    this.program = ts.createProgram(\n      this.getProgramRootNames(),\n      this.parsedConfig.options,\n      this.createCompilerHost(),\n      this.program || undefined, // Pass old program for incremental compilation\n    );\n\n    // Check each file\n    const results: FileCheckResult[] = [];\n\n    for (const file of files) {\n      const result = this.checkSingleFile(file);\n      results.push(result);\n    }\n\n    return results;\n  }\n\n  /**\n   * Handle file changes (update program incrementally)\n   */\n  public handleFileChanges(files: SerializedFile[]): void {\n    for (const file of files) {\n      this.fileContents.set(file.path, file.content);\n      this.deletedRootPaths.delete(this.getPathIdentity(file.path));\n    }\n\n    // Recreate program with new file contents\n    if (this.parsedConfig && this.program) {\n      this.program = ts.createProgram(\n        this.getProgramRootNames(),\n        this.parsedConfig.options,\n        this.createCompilerHost(),\n        this.program || undefined,\n      );\n    }\n  }\n\n  /**\n   * Handle deleted files (remove from cache)\n   */\n  public handleFilesDeleted(files: DeletedFile[]): void {\n    let hasChanges = false;\n\n    for (const file of files) {\n      const identity = this.getPathIdentity(file.path);\n      const cachedPath = Array.from(this.fileContents.keys()).find(\n        (candidate) => this.getPathIdentity(candidate) === identity,\n      );\n\n      if (cachedPath) {\n        this.fileContents.delete(cachedPath);\n        hasChanges = true;\n      }\n      if (!this.deletedRootPaths.has(identity)) hasChanges = true;\n      this.deletedRootPaths.add(identity);\n    }\n\n    // Recreate program without deleted files\n    if (hasChanges && this.parsedConfig) {\n      this.program = ts.createProgram(\n        this.getProgramRootNames(),\n        this.parsedConfig.options,\n        this.createCompilerHost(),\n        this.program || undefined,\n      );\n    }\n  }\n\n  /**\n   * Check a single file for diagnostics\n   */\n  private checkSingleFile(file: SerializedFile): FileCheckResult {\n    if (!this.program) {\n      return {\n        path: file.path,\n        relativePath: file.relativePath,\n        healthy: true,\n        errors: [],\n        warnings: [],\n      };\n    }\n\n    const sourceFile = this.program.getSourceFile(file.path);\n\n    if (!sourceFile) {\n      return {\n        path: file.path,\n        relativePath: file.relativePath,\n        healthy: true,\n        errors: [],\n        warnings: [],\n      };\n    }\n\n    const syntacticDiagnostics = this.program.getSyntacticDiagnostics(sourceFile);\n    const semanticDiagnostics = this.program.getSemanticDiagnostics(sourceFile);\n    const allDiagnostics = [...syntacticDiagnostics, ...semanticDiagnostics];\n\n    const errors: DiagnosticMessage[] = [];\n    const warnings: DiagnosticMessage[] = [];\n\n    for (const diagnostic of allDiagnostics) {\n      const message = this.formatDiagnostic(diagnostic, file);\n\n      if (diagnostic.category === ts.DiagnosticCategory.Error) {\n        errors.push(message);\n      } else if (diagnostic.category === ts.DiagnosticCategory.Warning) {\n        warnings.push(message);\n      }\n    }\n\n    return {\n      path: file.path,\n      relativePath: file.relativePath,\n      healthy: errors.length === 0 && warnings.length === 0,\n      errors,\n      warnings,\n    };\n  }\n\n  /**\n   * Format a TypeScript diagnostic into our message format\n   */\n  private formatDiagnostic(diagnostic: ts.Diagnostic, file: SerializedFile): DiagnosticMessage {\n    let lineNumber = 1;\n    let columnNumber = 1;\n    let length = 1;\n\n    if (diagnostic.file && diagnostic.start !== undefined) {\n      const pos = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);\n      lineNumber = pos.line + 1;\n      columnNumber = pos.character + 1;\n      length = diagnostic.length || 1;\n    }\n\n    const messageText =\n      typeof diagnostic.messageText === \"string\"\n        ? diagnostic.messageText\n        : diagnostic.messageText.messageText;\n\n    return {\n      type: diagnostic.category === ts.DiagnosticCategory.Error ? \"error\" : \"warning\",\n      message: messageText,\n      lineNumber,\n      columnNumber,\n      length,\n      filePath: file.path,\n      relativePath: file.relativePath,\n    };\n  }\n\n  /**\n   * Create a custom compiler host that reads from in-memory cache\n   */\n  private createCompilerHost(): ts.CompilerHost {\n    const defaultHost = ts.createCompilerHost(this.parsedConfig?.options || {});\n\n    return {\n      ...defaultHost,\n      readFile: (fileName: string) => {\n        // Check in-memory cache first\n        if (this.fileContents.has(fileName)) {\n          return this.fileContents.get(fileName);\n        }\n        // Fall back to disk\n        return defaultHost.readFile(fileName);\n      },\n      fileExists: (fileName: string) => {\n        if (this.fileContents.has(fileName)) {\n          return true;\n        }\n        return defaultHost.fileExists(fileName);\n      },\n    };\n  }\n\n  /** Keep tsconfig-selected declarations in every incremental program. */\n  private getProgramRootNames(): string[] {\n    const configuredRoots = this.parsedConfig?.fileNames || [];\n\n    const rootsByIdentity = new Map<string, string>();\n\n    for (const filePath of [...configuredRoots, ...this.fileContents.keys()]) {\n      const identity = this.getPathIdentity(filePath);\n      if (!this.deletedRootPaths.has(identity)) rootsByIdentity.set(identity, filePath);\n    }\n\n    return [...rootsByIdentity.values()];\n  }\n\n  /** Compare equivalent Windows path spellings as one TypeScript root. */\n  private getPathIdentity(filePath: string): string {\n    const normalized = path.normalize(path.resolve(filePath));\n\n    return ts.sys.useCaseSensitiveFileNames ? normalized : normalized.toLowerCase();\n  }\n}\n\n// Create worker instance\nconst worker = new TypeScriptHealthWorker();\n\n// Handle messages from main thread\nparentPort?.on(\"message\", (message: WorkerMessage) => {\n  try {\n    switch (message.type) {\n      case \"init\": {\n        const success = worker.initialize(message.config);\n        const response: WorkerResponse = { type: \"initialized\", success };\n        parentPort?.postMessage(response);\n        break;\n      }\n\n      case \"check\": {\n        const results = worker.checkFiles(message.files);\n        const response: WorkerResponse = { type: \"results\", results };\n        parentPort?.postMessage(response);\n        break;\n      }\n\n      case \"fileChanges\": {\n        worker.handleFileChanges(message.files);\n        break;\n      }\n\n      case \"filesDeleted\": {\n        worker.handleFilesDeleted(message.files);\n        break;\n      }\n\n      case \"shutdown\": {\n        process.exit(0);\n      }\n    }\n  } catch (error) {\n    const response: WorkerResponse = {\n      type: \"error\",\n      message: error instanceof Error ? error.message : String(error),\n    };\n    parentPort?.postMessage(response);\n  }\n});\n\n// Handle initialization from workerData if provided\nif (workerData?.autoInit) {\n  worker.initialize({ cwd: workerData.cwd || process.cwd() });\n}\n"],"mappings":"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"}
+{"version":3,"file":"ts-health.worker.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/dev-server/health-checker/workers/ts-health.worker.ts"],"sourcesContent":["/**\n * TypeScript Health Check Worker\n *\n * This worker runs in a dedicated thread to perform TypeScript type checking\n * without blocking the main dev server thread. It maintains a persistent\n * native compiler session for fast incremental type checking.\n *\n * Communication:\n * - Receives: { type: 'init' | 'check' | 'fileChanges' | 'shutdown', ... }\n * - Sends: { type: 'results' | 'initialized' | 'error', ... }\n */\nimport { existsSync } from \"node:fs\";\nimport { CompilerSession } from \"../../../tooling/typescript/compiler\";\nimport path from \"node:path\";\nimport { parentPort, workerData } from \"worker_threads\";\n\n/**\n * Serialized file data received from main thread\n */\ntype SerializedFile = {\n  /** Absolute file path */\n  path: string;\n  /** File content (source code) */\n  content: string;\n  /** Relative path for display */\n  relativePath: string;\n};\n\n/**\n * Diagnostic message sent back to main thread\n */\ntype DiagnosticMessage = {\n  type: \"error\" | \"warning\";\n  message: string;\n  lineNumber: number;\n  columnNumber: number;\n  length: number;\n  filePath: string;\n  relativePath: string;\n};\n\n/**\n * Health check result for a single file\n */\ntype FileCheckResult = {\n  path: string;\n  relativePath: string;\n  healthy: boolean;\n  errors: DiagnosticMessage[];\n  warnings: DiagnosticMessage[];\n};\n\n/**\n * Messages received from main thread\n */\n/**\n * Deleted file info\n */\ntype DeletedFile = {\n  path: string;\n  relativePath: string;\n};\n\n/**\n * Messages received from main thread\n */\ntype WorkerMessage =\n  | { type: \"init\"; config: { cwd: string; tsconfigPath?: string } }\n  | { type: \"check\"; files: SerializedFile[] }\n  | { type: \"fileChanges\"; files: SerializedFile[] }\n  | { type: \"filesDeleted\"; files: DeletedFile[] }\n  | { type: \"shutdown\" };\n\n/**\n * Messages sent to main thread\n */\ntype WorkerResponse =\n  | { type: \"initialized\"; success: boolean; error?: string }\n  | { type: \"results\"; results: FileCheckResult[] }\n  | { type: \"error\"; message: string };\n\n/** The session owns one native compiler child and closes it on shutdown. */\nclass TypeScriptHealthWorker {\n  private session: CompilerSession | null = null;\n  public initialize(config: { cwd: string; tsconfigPath?: string }): boolean {\n    this.close();\n    const cwd = config.cwd || process.cwd();\n    const configPath = path.resolve(cwd, config.tsconfigPath ?? \"tsconfig.json\");\n    if (existsSync(configPath)) this.session = new CompilerSession(cwd, configPath);\n    return true;\n  }\n  public checkFiles(files: SerializedFile[]): FileCheckResult[] {\n    this.session?.update(files);\n    return files.map((file) => {\n      const diagnostics = this.session?.diagnostics(file.path) ?? [];\n      const messages: DiagnosticMessage[] = diagnostics.map((diagnostic) => ({\n        type: diagnostic.severity,\n        message: diagnostic.message,\n        lineNumber: diagnostic.line,\n        columnNumber: diagnostic.column,\n        length: diagnostic.length,\n        filePath: file.path,\n        relativePath: file.relativePath,\n      }));\n      const errors = messages.filter((message) => message.type === \"error\");\n      const warnings = messages.filter((message) => message.type === \"warning\");\n      return {\n        path: file.path,\n        relativePath: file.relativePath,\n        healthy: errors.length === 0 && warnings.length === 0,\n        errors,\n        warnings,\n      };\n    });\n  }\n  public handleFileChanges(files: SerializedFile[]): void {\n    this.session?.update(files);\n  }\n  public handleFilesDeleted(files: DeletedFile[]): void {\n    this.session?.update(\n      [],\n      files.map((file) => file.path),\n    );\n  }\n  public close(): void {\n    this.session?.close();\n    this.session = null;\n  }\n}\n\n// Create worker instance\nconst worker = new TypeScriptHealthWorker();\n\n// Handle messages from main thread\nparentPort?.on(\"message\", (message: WorkerMessage) => {\n  try {\n    switch (message.type) {\n      case \"init\": {\n        const success = worker.initialize(message.config);\n        const response: WorkerResponse = { type: \"initialized\", success };\n        parentPort?.postMessage(response);\n        break;\n      }\n\n      case \"check\": {\n        const results = worker.checkFiles(message.files);\n        const response: WorkerResponse = { type: \"results\", results };\n        parentPort?.postMessage(response);\n        break;\n      }\n\n      case \"fileChanges\": {\n        worker.handleFileChanges(message.files);\n        break;\n      }\n\n      case \"filesDeleted\": {\n        worker.handleFilesDeleted(message.files);\n        break;\n      }\n\n      case \"shutdown\": {\n        worker.close();\n        process.exit(0);\n      }\n    }\n  } catch (error) {\n    const response: WorkerResponse = {\n      type: \"error\",\n      message: error instanceof Error ? error.message : String(error),\n    };\n    parentPort?.postMessage(response);\n  }\n});\n\n// Handle initialization from workerData if provided\nif (workerData?.autoInit) {\n  worker.initialize({ cwd: workerData.cwd || process.cwd() });\n}\n\nparentPort?.on(\"close\", () => worker.close());\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkFA,IAAM,yBAAN,MAA6B;;iBACe;;CAC1C,AAAO,WAAW,QAAyD;EACzE,KAAK,MAAM;EACX,MAAM,MAAM,OAAO,OAAO,QAAQ,IAAI;EACtC,MAAM,aAAa,KAAK,QAAQ,KAAK,OAAO,gBAAgB,eAAe;EAC3E,IAAI,WAAW,UAAU,GAAG,KAAK,UAAU,IAAI,gBAAgB,KAAK,UAAU;EAC9E,OAAO;CACT;CACA,AAAO,WAAW,OAA4C;EAC5D,KAAK,SAAS,OAAO,KAAK;EAC1B,OAAO,MAAM,KAAK,SAAS;GAEzB,MAAM,YADc,KAAK,SAAS,YAAY,KAAK,IAAI,KAAK,CAAC,EACZ,CAAC,KAAK,gBAAgB;IACrE,MAAM,WAAW;IACjB,SAAS,WAAW;IACpB,YAAY,WAAW;IACvB,cAAc,WAAW;IACzB,QAAQ,WAAW;IACnB,UAAU,KAAK;IACf,cAAc,KAAK;GACrB,EAAE;GACF,MAAM,SAAS,SAAS,QAAQ,YAAY,QAAQ,SAAS,OAAO;GACpE,MAAM,WAAW,SAAS,QAAQ,YAAY,QAAQ,SAAS,SAAS;GACxE,OAAO;IACL,MAAM,KAAK;IACX,cAAc,KAAK;IACnB,SAAS,OAAO,WAAW,KAAK,SAAS,WAAW;IACpD;IACA;GACF;EACF,CAAC;CACH;CACA,AAAO,kBAAkB,OAA+B;EACtD,KAAK,SAAS,OAAO,KAAK;CAC5B;CACA,AAAO,mBAAmB,OAA4B;EACpD,KAAK,SAAS,OACZ,CAAC,GACD,MAAM,KAAK,SAAS,KAAK,IAAI,CAC/B;CACF;CACA,AAAO,QAAc;EACnB,KAAK,SAAS,MAAM;EACpB,KAAK,UAAU;CACjB;AACF;AAGA,MAAM,SAAS,IAAI,uBAAuB;AAG1C,YAAY,GAAG,YAAY,YAA2B;CACpD,IAAI;EACF,QAAQ,QAAQ,MAAhB;GACE,KAAK,QAAQ;IAEX,MAAM,WAA2B;KAAE,MAAM;KAAe,SADxC,OAAO,WAAW,QAAQ,MACoB;IAAE;IAChE,YAAY,YAAY,QAAQ;IAChC;GACF;GAEA,KAAK,SAAS;IAEZ,MAAM,WAA2B;KAAE,MAAM;KAAW,SADpC,OAAO,WAAW,QAAQ,KACgB;IAAE;IAC5D,YAAY,YAAY,QAAQ;IAChC;GACF;GAEA,KAAK;IACH,OAAO,kBAAkB,QAAQ,KAAK;IACtC;GAGF,KAAK;IACH,OAAO,mBAAmB,QAAQ,KAAK;IACvC;GAGF,KAAK;IACH,OAAO,MAAM;IACb,QAAQ,KAAK,CAAC;EAElB;CACF,SAAS,OAAO;EACd,MAAM,WAA2B;GAC/B,MAAM;GACN,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EAChE;EACA,YAAY,YAAY,QAAQ;CAClC;AACF,CAAC;AAGD,IAAI,YAAY,UACd,OAAO,WAAW,EAAE,KAAK,WAAW,OAAO,QAAQ,IAAI,EAAE,CAAC;AAG5D,YAAY,GAAG,eAAe,OAAO,MAAM,CAAC"}

package/esm/dev-server/loader/hook-thread.d.mts

@@ -1,11 +1,11 @@
 import { TranspileInit, load } from "./load-hook.mjs";
 import { resolve } from "./resolve-hook.mjs";
 import { MessagePort } from "node:worker_threads";
-
 //#region ../../packages/core/src/dev-server/loader/hook-thread.d.ts
 type InitializeData = {
   port: MessagePort;
-  srcRoot: string; /** Transpile config (always present — esbuild transpile is unconditional). */
+  srcRoot: string;
+  /** Transpile config (always present — esbuild transpile is unconditional). */
   transpile: TranspileInit;
 };
 /**
@@ -38,11 +38,7 @@ type InitializeData = {
  * // File watcher later:
  * port1.postMessage({ type: "bump", absolutePath: "/abs/path/to/user.model.ts" });
  */
-declare function initialize({
-  port,
-  srcRoot,
-  transpile
-}: InitializeData): void;
+export declare function initialize({ port, srcRoot, transpile }: InitializeData): void;
 //#endregion
-export { initialize, load, resolve };
+export { load, resolve };
 //# sourceMappingURL=hook-thread.d.mts.map

package/esm/dev-server/loader/hook-thread.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"hook-thread.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/hook-thread.ts"],"mappings":";;;;;KAKK,cAAA;EACH,IAAA,EAAM,WAAA;EACN,OAAA,UAFiB;EAIjB,SAAA,EAAW,aAAa;AAAA;;;;;;;AAAA;AAiC1B;;;;;;;;;;;;;;;;;AAAuE;;;;;;iBAAvD,UAAA;EAAa,IAAA;EAAM,OAAA;EAAS;AAAA,GAAa,cAAA"}
+{"version":3,"file":"hook-thread.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/hook-thread.ts"],"mappings":";;;;KAKK;EACH,MAAM;EACN;;EAEA,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAiCG,aAAa,MAAM,SAAS,aAAa"}

package/esm/dev-server/loader/load-hook.d.mts

@@ -14,10 +14,14 @@ type NextLoad = (url: string, context?: LoadContext) => Promise<LoadResult>;
  * shipped into the hook worker via `initialize()`. Always present — esbuild
  * transpile is unconditional now (tsx is no longer in the TS path).
  */
-type TranspileInit = {
-  /** Absolute `.warlock/transpile` directory. */cacheDir: string; /** Source-content key salt: esbuild version + epoch + tsconfig blob. */
-  fingerprint: string; /** esbuild `target` (e.g. `"node22"` — must match the prod builder). */
-  target: string; /** JSON string of `{ compilerOptions }` handed to esbuild as tsconfigRaw. */
+export type TranspileInit = {
+  /** Absolute `.warlock/transpile` directory. */
+  cacheDir: string;
+  /** Source-content key salt: esbuild version + epoch + tsconfig blob. */
+  fingerprint: string;
+  /** esbuild `target` (e.g. `"node22"` — must match the prod builder). */
+  target: string;
+  /** JSON string of `{ compilerOptions }` handed to esbuild as tsconfigRaw. */
   tsconfigRaw: string;
   /**
    * Debug-only: name cache files `<slug>.<hash>.js` and append a trailing
@@ -52,7 +56,7 @@ type TranspileInit = {
  * // load("file:///@warlock.js/core/src/x.ts") → esbuild transpile + cache
  * // load("file:///node_modules/ms/index.js")  → nextLoad (Node default)
  */
-declare function load(url: string, context: LoadContext, nextLoad: NextLoad): Promise<LoadResult>;
+export declare function load(url: string, context: LoadContext, nextLoad: NextLoad): Promise<LoadResult>;
 //#endregion
-export { TranspileInit, load };
+export {};
 //# sourceMappingURL=load-hook.d.mts.map

package/esm/dev-server/loader/load-hook.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"load-hook.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/load-hook.ts"],"mappings":";KAMK,WAAA;EACH,MAAA;EACA,gBAAA,GAAmB,MAAM;AAAA;AAAA,KAGtB,UAAA;EACH,MAAA;EACA,MAAA,WAAiB,MAAM;EACvB,YAAA;AAAA;AAAA,KAGG,QAAA,IAAY,GAAA,UAAa,OAAA,GAAU,WAAA,KAAgB,OAAA,CAAQ,UAAA;AATrC;;;;;AAAA,KAgBf,aAAA;EAXO,+CAajB,QAAA,UAZY;EAcZ,WAAA,UAXG;EAaH,MAAA;EAEA,WAAA;EAf8D;;;;;EAqB9D,UAAA;AAAA;;;;;;;;;AAAU;AAqDZ;;;;;;;;;;;;;;;;;iBAAsB,IAAA,CACpB,GAAA,UACA,OAAA,EAAS,WAAA,EACT,QAAA,EAAU,QAAA,GACT,OAAA,CAAQ,UAAA"}
+{"version":3,"file":"load-hook.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/load-hook.ts"],"mappings":";KAMK;EACH;EACA,mBAAmB;;KAGhB;EACH;EACA,iBAAiB;EACjB;;KAGG,YAAY,aAAa,UAAU,gBAAgB,QAAQ;;;;;;YAOpD;;EAEV;;EAEA;;EAEA;;EAEA;;;;;;EAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqDoB,KACpB,aACA,SAAS,aACT,UAAU,WACT,QAAQ"}

package/esm/dev-server/loader/load-hook.mjs

@@ -18,8 +18,8 @@ function configureTranspile(init) {
 	transpile = init;
 	cache = new TranspileCache(init.cacheDir);
 	cache.gc({
-		maxBytes: 256 * 1024 * 1024,
-		maxAgeMs: 336 * 60 * 60 * 1e3
+		maxBytes: 268435456,
+		maxAgeMs: 12096e5
 	});
 }
 /**
@@ -61,8 +61,9 @@ async function load(url, context, nextLoad) {
 		source: hit.code,
 		shortCircuit: true
 	};
+	const loader = absolutePath.endsWith(".tsx") ? "tsx" : "ts";
 	const result = transformSync(source, {
-		loader: absolutePath.endsWith(".tsx") ? "tsx" : "ts",
+		loader,
 		format: "esm",
 		target: transpile.target,
 		sourcefile: absolutePath,

package/esm/dev-server/loader/load-hook.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"load-hook.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/load-hook.ts"],"sourcesContent":["import { transformSync } from \"esbuild\";\nimport { readFileSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { sourceSlug } from \"./source-slug.js\";\nimport { cacheKey, TranspileCache } from \"./transpile-cache.js\";\n\ntype LoadContext = {\n  format?: string;\n  importAttributes?: Record<string, string>;\n};\n\ntype LoadResult = {\n  format: string;\n  source: string | Buffer;\n  shortCircuit?: boolean;\n};\n\ntype NextLoad = (url: string, context?: LoadContext) => Promise<LoadResult>;\n\n/**\n * Everything the transpile path needs, computed once on the main thread and\n * shipped into the hook worker via `initialize()`. Always present — esbuild\n * transpile is unconditional now (tsx is no longer in the TS path).\n */\nexport type TranspileInit = {\n  /** Absolute `.warlock/transpile` directory. */\n  cacheDir: string;\n  /** Source-content key salt: esbuild version + epoch + tsconfig blob. */\n  fingerprint: string;\n  /** esbuild `target` (e.g. `\"node22\"` — must match the prod builder). */\n  target: string;\n  /** JSON string of `{ compilerOptions }` handed to esbuild as tsconfigRaw. */\n  tsconfigRaw: string;\n  /**\n   * Debug-only: name cache files `<slug>.<hash>.js` and append a trailing\n   * `// @source <path>` marker so entries are eyeball-identifiable. Off by\n   * default (opaque `<hash>.js`). Cosmetic — never affects keys or lookup.\n   */\n  debugNames: boolean;\n};\n\nconst VERSION_QUERY = /\\?v=\\d+$/;\nconst TS_FILE = /\\.(ts|tsx|mts|cts)$/;\n\nlet transpile: TranspileInit;\nlet cache: TranspileCache;\n\n/**\n * Called once from the hook worker's `initialize()`. Wires the persisted\n * transpile cache and runs one opportunistic GC pass at boot — cheap, off\n * the hot path, single directory scan.\n */\nexport function configureTranspile(init: TranspileInit): void {\n  transpile = init;\n  cache = new TranspileCache(init.cacheDir);\n\n  // Boot-time eviction so the cache can't grow unbounded across weeks of\n  // dev. Bounds are generous; correctness never depends on GC (content\n  // hashing already guarantees that) — this is purely disk hygiene.\n  cache.gc({\n    maxBytes: 256 * 1024 * 1024,\n    maxAgeMs: 14 * 24 * 60 * 60 * 1000,\n  });\n}\n\n/**\n * ESM loader `load()` hook.\n *\n * Owns the transpile for **every** TypeScript file — project `src/`,\n * `@warlock.js/*` framework source, and `warlock.config.ts` alike. There\n * is no tsx in the TypeScript path any more: we read the source, key it by\n * a content hash + options fingerprint, serve the cached JS on a hit, and\n * otherwise transform it with esbuild directly and persist. Non-TypeScript\n * URLs (npm `.js`/`.cjs`/`.mjs`, `node:` builtins, JSON) are not ours —\n * they fall through to the next loader (Node's default).\n *\n * The `?v=<N>` query drives Node's module identity (HMR) for `src/` files\n * and is **never** part of the cache key — the cache is keyed purely by\n * source content, so the two mechanisms are fully orthogonal. Framework\n * and config `.ts` carry no `?v` (no HMR) but are transpiled and cached\n * exactly the same way.\n *\n * The source map esbuild emits is inline base64 with `sourcefile` set to\n * the clean absolute `.ts` path, so V8 (run with source maps enabled)\n * reports stack frames at the original TypeScript location.\n *\n * @example\n * // load(\"file:///src/user.model.ts?v=3\")  → esbuild transpile + cache\n * // load(\"file:///@warlock.js/core/src/x.ts\") → esbuild transpile + cache\n * // load(\"file:///node_modules/ms/index.js\")  → nextLoad (Node default)\n */\nexport async function load(\n  url: string,\n  context: LoadContext,\n  nextLoad: NextLoad,\n): Promise<LoadResult> {\n  const cleanUrl = url.replace(VERSION_QUERY, \"\");\n\n  // Not TypeScript → not ours. npm packages, node: builtins, JSON, etc.\n  if (!TS_FILE.test(cleanUrl)) {\n    return nextLoad(url, context);\n  }\n\n  const absolutePath = fileURLToPath(cleanUrl);\n  const source = readFileSync(absolutePath, \"utf8\");\n  const key = cacheKey(source, transpile.fingerprint);\n\n  // Cosmetic filename label; undefined keeps opaque <hash>.js names.\n  const label = transpile.debugNames ? sourceSlug(absolutePath) : undefined;\n\n  const hit = cache.get(key, label);\n  if (hit) {\n    return { format: \"module\", source: hit.code, shortCircuit: true };\n  }\n\n  const loader = absolutePath.endsWith(\".tsx\") ? \"tsx\" : \"ts\";\n\n  const result = transformSync(source, {\n    loader,\n    format: \"esm\",\n    target: transpile.target,\n    sourcefile: absolutePath,\n    // Inline base64 map, self-contained (sourcesContent on by default), so\n    // it survives the ?v=N URL with no extra resolution step.\n    sourcemap: \"inline\",\n    tsconfigRaw: transpile.tsconfigRaw,\n  });\n\n  // result.code already carries the inline //# sourceMappingURL. The\n  // marker goes AFTER that line: a trailing comment can't shift earlier\n  // generated lines, so the inline map (and therefore stack-frame line\n  // numbers) stays exact. A leading marker would desync it by one line.\n  const code = label ? `${result.code}\\n// @source ${absolutePath}\\n` : result.code;\n\n  cache.put(key, { code, map: \"\" }, label);\n\n  return { format: \"module\", source: code, shortCircuit: true };\n}\n"],"mappings":";;;;;;;AAyCA,MAAM,gBAAgB;AACtB,MAAM,UAAU;AAEhB,IAAI;AACJ,IAAI;;;;;;AAOJ,SAAgB,mBAAmB,MAA2B;CAC5D,YAAY;CACZ,QAAQ,IAAI,eAAe,KAAK,QAAQ;CAKxC,MAAM,GAAG;EACP,UAAU,MAAM,OAAO;EACvB,UAAU,MAAU,KAAK,KAAK;CAChC,CAAC;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,eAAsB,KACpB,KACA,SACA,UACqB;CACrB,MAAM,WAAW,IAAI,QAAQ,eAAe,EAAE;CAG9C,IAAI,CAAC,QAAQ,KAAK,QAAQ,GACxB,OAAO,SAAS,KAAK,OAAO;CAG9B,MAAM,eAAe,cAAc,QAAQ;CAC3C,MAAM,SAAS,aAAa,cAAc,MAAM;CAChD,MAAM,MAAM,SAAS,QAAQ,UAAU,WAAW;CAGlD,MAAM,QAAQ,UAAU,aAAa,WAAW,YAAY,IAAI;CAEhE,MAAM,MAAM,MAAM,IAAI,KAAK,KAAK;CAChC,IAAI,KACF,OAAO;EAAE,QAAQ;EAAU,QAAQ,IAAI;EAAM,cAAc;CAAK;CAKlE,MAAM,SAAS,cAAc,QAAQ;EACnC,QAHa,aAAa,SAAS,MAAM,IAAI,QAAQ;EAIrD,QAAQ;EACR,QAAQ,UAAU;EAClB,YAAY;EAGZ,WAAW;EACX,aAAa,UAAU;CACzB,CAAC;CAMD,MAAM,OAAO,QAAQ,GAAG,OAAO,KAAK,eAAe,aAAa,MAAM,OAAO;CAE7E,MAAM,IAAI,KAAK;EAAE;EAAM,KAAK;CAAG,GAAG,KAAK;CAEvC,OAAO;EAAE,QAAQ;EAAU,QAAQ;EAAM,cAAc;CAAK;AAC9D"}
+{"version":3,"file":"load-hook.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/load-hook.ts"],"sourcesContent":["import { transformSync } from \"esbuild\";\nimport { readFileSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { sourceSlug } from \"./source-slug.js\";\nimport { cacheKey, TranspileCache } from \"./transpile-cache.js\";\n\ntype LoadContext = {\n  format?: string;\n  importAttributes?: Record<string, string>;\n};\n\ntype LoadResult = {\n  format: string;\n  source: string | Buffer;\n  shortCircuit?: boolean;\n};\n\ntype NextLoad = (url: string, context?: LoadContext) => Promise<LoadResult>;\n\n/**\n * Everything the transpile path needs, computed once on the main thread and\n * shipped into the hook worker via `initialize()`. Always present — esbuild\n * transpile is unconditional now (tsx is no longer in the TS path).\n */\nexport type TranspileInit = {\n  /** Absolute `.warlock/transpile` directory. */\n  cacheDir: string;\n  /** Source-content key salt: esbuild version + epoch + tsconfig blob. */\n  fingerprint: string;\n  /** esbuild `target` (e.g. `\"node22\"` — must match the prod builder). */\n  target: string;\n  /** JSON string of `{ compilerOptions }` handed to esbuild as tsconfigRaw. */\n  tsconfigRaw: string;\n  /**\n   * Debug-only: name cache files `<slug>.<hash>.js` and append a trailing\n   * `// @source <path>` marker so entries are eyeball-identifiable. Off by\n   * default (opaque `<hash>.js`). Cosmetic — never affects keys or lookup.\n   */\n  debugNames: boolean;\n};\n\nconst VERSION_QUERY = /\\?v=\\d+$/;\nconst TS_FILE = /\\.(ts|tsx|mts|cts)$/;\n\nlet transpile: TranspileInit;\nlet cache: TranspileCache;\n\n/**\n * Called once from the hook worker's `initialize()`. Wires the persisted\n * transpile cache and runs one opportunistic GC pass at boot — cheap, off\n * the hot path, single directory scan.\n */\nexport function configureTranspile(init: TranspileInit): void {\n  transpile = init;\n  cache = new TranspileCache(init.cacheDir);\n\n  // Boot-time eviction so the cache can't grow unbounded across weeks of\n  // dev. Bounds are generous; correctness never depends on GC (content\n  // hashing already guarantees that) — this is purely disk hygiene.\n  cache.gc({\n    maxBytes: 256 * 1024 * 1024,\n    maxAgeMs: 14 * 24 * 60 * 60 * 1000,\n  });\n}\n\n/**\n * ESM loader `load()` hook.\n *\n * Owns the transpile for **every** TypeScript file — project `src/`,\n * `@warlock.js/*` framework source, and `warlock.config.ts` alike. There\n * is no tsx in the TypeScript path any more: we read the source, key it by\n * a content hash + options fingerprint, serve the cached JS on a hit, and\n * otherwise transform it with esbuild directly and persist. Non-TypeScript\n * URLs (npm `.js`/`.cjs`/`.mjs`, `node:` builtins, JSON) are not ours —\n * they fall through to the next loader (Node's default).\n *\n * The `?v=<N>` query drives Node's module identity (HMR) for `src/` files\n * and is **never** part of the cache key — the cache is keyed purely by\n * source content, so the two mechanisms are fully orthogonal. Framework\n * and config `.ts` carry no `?v` (no HMR) but are transpiled and cached\n * exactly the same way.\n *\n * The source map esbuild emits is inline base64 with `sourcefile` set to\n * the clean absolute `.ts` path, so V8 (run with source maps enabled)\n * reports stack frames at the original TypeScript location.\n *\n * @example\n * // load(\"file:///src/user.model.ts?v=3\")  → esbuild transpile + cache\n * // load(\"file:///@warlock.js/core/src/x.ts\") → esbuild transpile + cache\n * // load(\"file:///node_modules/ms/index.js\")  → nextLoad (Node default)\n */\nexport async function load(\n  url: string,\n  context: LoadContext,\n  nextLoad: NextLoad,\n): Promise<LoadResult> {\n  const cleanUrl = url.replace(VERSION_QUERY, \"\");\n\n  // Not TypeScript → not ours. npm packages, node: builtins, JSON, etc.\n  if (!TS_FILE.test(cleanUrl)) {\n    return nextLoad(url, context);\n  }\n\n  const absolutePath = fileURLToPath(cleanUrl);\n  const source = readFileSync(absolutePath, \"utf8\");\n  const key = cacheKey(source, transpile.fingerprint);\n\n  // Cosmetic filename label; undefined keeps opaque <hash>.js names.\n  const label = transpile.debugNames ? sourceSlug(absolutePath) : undefined;\n\n  const hit = cache.get(key, label);\n  if (hit) {\n    return { format: \"module\", source: hit.code, shortCircuit: true };\n  }\n\n  const loader = absolutePath.endsWith(\".tsx\") ? \"tsx\" : \"ts\";\n\n  const result = transformSync(source, {\n    loader,\n    format: \"esm\",\n    target: transpile.target,\n    sourcefile: absolutePath,\n    // Inline base64 map, self-contained (sourcesContent on by default), so\n    // it survives the ?v=N URL with no extra resolution step.\n    sourcemap: \"inline\",\n    tsconfigRaw: transpile.tsconfigRaw,\n  });\n\n  // result.code already carries the inline //# sourceMappingURL. The\n  // marker goes AFTER that line: a trailing comment can't shift earlier\n  // generated lines, so the inline map (and therefore stack-frame line\n  // numbers) stays exact. A leading marker would desync it by one line.\n  const code = label ? `${result.code}\\n// @source ${absolutePath}\\n` : result.code;\n\n  cache.put(key, { code, map: \"\" }, label);\n\n  return { format: \"module\", source: code, shortCircuit: true };\n}\n"],"mappings":";;;;;;;AAyCA,MAAM,gBAAgB;AACtB,MAAM,UAAU;AAEhB,IAAI;AACJ,IAAI;;;;;;AAOJ,SAAgB,mBAAmB,MAA2B;CAC5D,YAAY;CACZ,QAAQ,IAAI,eAAe,KAAK,QAAQ;CAKxC,MAAM,GAAG;EACP,UAAU;EACV,UAAU;CACZ,CAAC;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,eAAsB,KACpB,KACA,SACA,UACqB;CACrB,MAAM,WAAW,IAAI,QAAQ,eAAe,EAAE;CAG9C,IAAI,CAAC,QAAQ,KAAK,QAAQ,GACxB,OAAO,SAAS,KAAK,OAAO;CAG9B,MAAM,eAAe,cAAc,QAAQ;CAC3C,MAAM,SAAS,aAAa,cAAc,MAAM;CAChD,MAAM,MAAM,SAAS,QAAQ,UAAU,WAAW;CAGlD,MAAM,QAAQ,UAAU,aAAa,WAAW,YAAY,IAAI;CAEhE,MAAM,MAAM,MAAM,IAAI,KAAK,KAAK;CAChC,IAAI,KACF,OAAO;EAAE,QAAQ;EAAU,QAAQ,IAAI;EAAM,cAAc;CAAK;CAGlE,MAAM,SAAS,aAAa,SAAS,MAAM,IAAI,QAAQ;CAEvD,MAAM,SAAS,cAAc,QAAQ;EACnC;EACA,QAAQ;EACR,QAAQ,UAAU;EAClB,YAAY;EAGZ,WAAW;EACX,aAAa,UAAU;CACzB,CAAC;CAMD,MAAM,OAAO,QAAQ,GAAG,OAAO,KAAK,eAAe,aAAa,MAAM,OAAO;CAE7E,MAAM,IAAI,KAAK;EAAE;EAAM,KAAK;CAAG,GAAG,KAAK;CAEvC,OAAO;EAAE,QAAQ;EAAU,QAAQ;EAAM,cAAc;CAAK;AAC9D"}

package/esm/dev-server/loader/loader-port-acks.mjs

@@ -6,7 +6,7 @@
 * A `message` listener refs a `MessagePort`, and the hook thread lives for the
 * whole process, so a referenced port holds the event loop open after
 * everything else has closed: the HTTP test server's teardown finished, yet
-* Vitest's main process could not exit (FW-05). The port is unreferenced as
+* Vitest's main process could not exit. The port is unreferenced as
 * soon as the listener is attached and referenced again only while a `sync`
 * waits for its acknowledgement, so a pending flush still completes.
 *

package/esm/dev-server/loader/loader-port-acks.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"loader-port-acks.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/loader-port-acks.ts"],"sourcesContent":["import type { MessagePort } from \"node:worker_threads\";\n\nexport type LoaderPortAcks = {\n  /**\n   * Post a `sync` message and resolve once the hook thread answers with\n   * `sync-ack`. Every message posted before it has been processed by then.\n   */\n  sync(): Promise<void>;\n};\n\n/**\n * Wire the main-thread end of the loader-hook channel so it never keeps the\n * process alive on its own.\n *\n * A `message` listener refs a `MessagePort`, and the hook thread lives for the\n * whole process, so a referenced port holds the event loop open after\n * everything else has closed: the HTTP test server's teardown finished, yet\n * Vitest's main process could not exit (FW-05). The port is unreferenced as\n * soon as the listener is attached and referenced again only while a `sync`\n * waits for its acknowledgement, so a pending flush still completes.\n *\n * Acks arrive in the order the syncs were posted, so the waiters form a queue.\n */\nexport function trackLoaderPortAcks(port: MessagePort): LoaderPortAcks {\n  const waiters: Array<() => void> = [];\n\n  port.on(\"message\", (message: { type?: string }) => {\n    if (message?.type !== \"sync-ack\") return;\n\n    waiters.shift()?.();\n\n    if (waiters.length === 0) port.unref();\n  });\n\n  port.unref();\n\n  return {\n    sync() {\n      return new Promise<void>((resolve) => {\n        waiters.push(resolve);\n        port.ref();\n        port.postMessage({ type: \"sync\" });\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAuBA,SAAgB,oBAAoB,MAAmC;CACrE,MAAM,UAA6B,CAAC;CAEpC,KAAK,GAAG,YAAY,YAA+B;EACjD,IAAI,SAAS,SAAS,YAAY;EAElC,QAAQ,MAAM,CAAC,GAAG;EAElB,IAAI,QAAQ,WAAW,GAAG,KAAK,MAAM;CACvC,CAAC;CAED,KAAK,MAAM;CAEX,OAAO,EACL,OAAO;EACL,OAAO,IAAI,SAAe,YAAY;GACpC,QAAQ,KAAK,OAAO;GACpB,KAAK,IAAI;GACT,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;EACnC,CAAC;CACH,EACF;AACF"}
+{"version":3,"file":"loader-port-acks.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/loader-port-acks.ts"],"sourcesContent":["import type { MessagePort } from \"node:worker_threads\";\n\nexport type LoaderPortAcks = {\n  /**\n   * Post a `sync` message and resolve once the hook thread answers with\n   * `sync-ack`. Every message posted before it has been processed by then.\n   */\n  sync(): Promise<void>;\n};\n\n/**\n * Wire the main-thread end of the loader-hook channel so it never keeps the\n * process alive on its own.\n *\n * A `message` listener refs a `MessagePort`, and the hook thread lives for the\n * whole process, so a referenced port holds the event loop open after\n * everything else has closed: the HTTP test server's teardown finished, yet\n * Vitest's main process could not exit. The port is unreferenced as\n * soon as the listener is attached and referenced again only while a `sync`\n * waits for its acknowledgement, so a pending flush still completes.\n *\n * Acks arrive in the order the syncs were posted, so the waiters form a queue.\n */\nexport function trackLoaderPortAcks(port: MessagePort): LoaderPortAcks {\n  const waiters: Array<() => void> = [];\n\n  port.on(\"message\", (message: { type?: string }) => {\n    if (message?.type !== \"sync-ack\") return;\n\n    waiters.shift()?.();\n\n    if (waiters.length === 0) port.unref();\n  });\n\n  port.unref();\n\n  return {\n    sync() {\n      return new Promise<void>((resolve) => {\n        waiters.push(resolve);\n        port.ref();\n        port.postMessage({ type: \"sync\" });\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAuBA,SAAgB,oBAAoB,MAAmC;CACrE,MAAM,UAA6B,CAAC;CAEpC,KAAK,GAAG,YAAY,YAA+B;EACjD,IAAI,SAAS,SAAS,YAAY;EAElC,QAAQ,MAAM,CAAC,GAAG;EAElB,IAAI,QAAQ,WAAW,GAAG,KAAK,MAAM;CACvC,CAAC;CAED,KAAK,MAAM;CAEX,OAAO,EACL,OAAO;EACL,OAAO,IAAI,SAAe,YAAY;GACpC,QAAQ,KAAK,OAAO;GACpB,KAAK,IAAI;GACT,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;EACnC,CAAC;CACH,EACF;AACF"}

package/esm/dev-server/loader/own-resolver.mjs

@@ -65,5 +65,5 @@ function ownResolve(specifier, parentURL, pathsMatcher, fileExists) {
 }
 
 //#endregion
-export { ownResolve };
+export { ownResolve, probeFile };
 //# sourceMappingURL=own-resolver.mjs.map

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

@@ -1,7 +1,7 @@
 import { register } from "node:module";
 import path from "node:path";
-import { putFileAsync } from "@warlock.js/fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
+import { putFileAsync } from "@warlock.js/fs";
 import { build } from "esbuild";
 import { MessageChannel } from "node:worker_threads";
 
@@ -77,8 +77,9 @@ const resolveExternalsFromCore = {
 async function registerLoader(transpile) {
 	const { port1, port2 } = new MessageChannel();
 	const selfPath = fileURLToPath(import.meta.url);
+	const hookThreadPath = path.join(path.dirname(selfPath), `hook-thread${path.extname(selfPath)}`);
 	const bundledCode = (await build({
-		entryPoints: [path.join(path.dirname(selfPath), `hook-thread${path.extname(selfPath)}`)],
+		entryPoints: [hookThreadPath],
 		bundle: true,
 		format: "esm",
 		write: false,
@@ -102,5 +103,5 @@ async function registerLoader(transpile) {
 }
 
 //#endregion
-export { registerLoader };
+export { registerLoader, resolveExternalsFromCore };
 //# sourceMappingURL=register-loader.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"register-loader.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/register-loader.ts"],"sourcesContent":["import { putFileAsync } from \"@warlock.js/fs\";\nimport { build, type Plugin } from \"esbuild\";\nimport { register } from \"node:module\";\nimport path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { type MessagePort, MessageChannel } from \"node:worker_threads\";\nimport type { TranspileInit } from \"./load-hook.js\";\n\n/**\n * Rewrite the hook bundle's remaining npm imports to absolute paths resolved\n * from **core's own** location.\n *\n * The bundle is written into the consuming app's `.warlock/` directory, so a\n * bare `import \"esbuild\"` in it resolves starting from the *app*, walking up\n * the app's `node_modules`. `esbuild` and `get-tsconfig` are core's\n * dependencies, not the app's — under npm/yarn's flat hoisting they happen to\n * be reachable anyway, but under pnpm's strict layout they are not, and the\n * dev server dies with `ERR_MODULE_NOT_FOUND` for a package the app never\n * imported. That is a phantom dependency baked into generated code.\n *\n * Bundling them in instead is not an option for `esbuild`: its JS API is a\n * thin wrapper that spawns a platform-specific native binary, so inlining the\n * JavaScript would not remove the need for the package on disk. Resolving to\n * an absolute `file://` URL at generation time does — the generated file then\n * points straight at the copy core itself is using, whatever the installer's\n * layout.\n */\nexport const resolveExternalsFromCore: Plugin = {\n  name: \"warlock-resolve-externals-from-core\",\n  setup(build) {\n    // The filter is deliberately loose — anything not starting `.` or `/` —\n    // so the guards below carry the real logic.\n    build.onResolve({ filter: /^[^./]/ }, (args) => {\n      // The entry point comes through here too, and on Windows its absolute\n      // path (\"D:\\\\…\") is not `.` or `/`. Marking it external fails the build.\n      if (args.kind === \"entry-point\" || path.isAbsolute(args.path)) {\n        return null;\n      }\n\n      if (args.path.startsWith(\"node:\")) {\n        return { external: true };\n      }\n\n      try {\n        return { path: import.meta.resolve(args.path), external: true };\n      } catch {\n        // Unresolvable from here — leave it bare and let Node try, which is\n        // exactly the previous behaviour rather than a hard failure.\n        return { external: true };\n      }\n    });\n  },\n};\n\n/**\n * Bundle, write, and register the ESM loader hook.\n *\n * **Why bundle?**\n * `module.register()` runs the hook file in a fresh Node.js worker thread that\n * has no tsx hook of its own. The hook source is TypeScript, so we must produce\n * a plain ESM bundle before registering. esbuild inline-bundles all three hook\n * modules (`hook-thread`, `resolve-hook`, `load-hook`, `version-registry`)\n * into a single `.mjs` file written to `.warlock/`. External npm packages\n * (`esbuild`, `node:*`) are kept external — the hook thread can resolve those\n * from `node_modules` normally.\n *\n * **Why a file and not a `data:` URL?**\n * Some Node versions have issues resolving `import.meta.url` inside `data:`\n * modules. A real file under `.warlock/` is simpler and debuggable.\n *\n * **Timing**\n * Called from `FilesOrchestrator.init()` before any user `src/` module is\n * dynamically imported. `module.register()` takes effect for all subsequent\n * `import()` calls, which is exactly the window we need.\n *\n * @param transpile - Transpile-cache config to ship into the hook worker,\n *   or `null` to keep the hook in tsx-passthrough mode.\n *\n * @returns The main-thread side of the MessageChannel. Callers post\n *   `{ type: \"bump\", absolutePath }` messages on it to invalidate modules.\n *\n * @example\n * const port = await registerLoader(transpileInit);\n * // Later, when a file changes:\n * port.postMessage({ type: \"bump\", absolutePath: \"/abs/path/to/user.model.ts\" });\n */\nexport async function registerLoader(transpile: TranspileInit): Promise<MessagePort> {\n  const { port1, port2 } = new MessageChannel();\n\n  // hook-thread is a sibling module, so it shares THIS file's extension:\n  // `.ts` when core runs from source (tsx), `.mjs` when published.\n  const selfPath = fileURLToPath(import.meta.url);\n  const hookThreadPath = path.join(path.dirname(selfPath), `hook-thread${path.extname(selfPath)}`);\n\n  const bundleResult = await build({\n    entryPoints: [hookThreadPath],\n    bundle: true,\n    format: \"esm\",\n    write: false,\n    platform: \"node\",\n    target: \"node20\",\n    // npm packages and Node built-ins stay external, but the plugin rewrites\n    // each remaining npm specifier to an absolute path resolved from core's\n    // own install — see `resolveExternalsFromCore` for why bare imports break\n    // under pnpm's strict layout.\n    packages: \"external\",\n    plugins: [resolveExternalsFromCore],\n  });\n\n  const bundledCode = bundleResult.outputFiles[0].text;\n  // Caller (filesOrchestrator.init) guarantees .warlock/ exists before this runs.\n  const hookBundlePath = path.join(process.cwd(), \".warlock\", \"loader-hook.mjs\");\n  await putFileAsync(hookBundlePath, bundledCode);\n\n  const srcRoot = path.join(process.cwd(), \"src\");\n\n  // No tsx registration: our hook owns resolution (own-resolver) and the\n  // transpile of every `.ts`/`.tsx` (esbuild, in the load hook). The chain\n  // is simply [our hook] → [Node default] for non-TS (npm/.js, node:).\n  // In this monorepo tsx is still the *launcher* (`tsx start.ts`) so its\n  // loader is present anyway, but it is never consulted for TypeScript —\n  // our hook short-circuits first. A released `node bin/warlock.js` has no\n  // tsx at all and relies entirely on this hook.\n\n  register(pathToFileURL(hookBundlePath).href, import.meta.url, {\n    data: { port: port2, srcRoot, transpile },\n    transferList: [port2],\n  });\n\n  return port1;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,MAAa,2BAAmC;CAC9C,MAAM;CACN,MAAM,OAAO;EAGX,MAAM,UAAU,EAAE,QAAQ,SAAS,IAAI,SAAS;GAG9C,IAAI,KAAK,SAAS,iBAAiB,KAAK,WAAW,KAAK,IAAI,GAC1D,OAAO;GAGT,IAAI,KAAK,KAAK,WAAW,OAAO,GAC9B,OAAO,EAAE,UAAU,KAAK;GAG1B,IAAI;IACF,OAAO;KAAE,MAAM,OAAO,KAAK,QAAQ,KAAK,IAAI;KAAG,UAAU;IAAK;GAChE,QAAQ;IAGN,OAAO,EAAE,UAAU,KAAK;GAC1B;EACF,CAAC;CACH;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,eAAsB,eAAe,WAAgD;CACnF,MAAM,EAAE,OAAO,UAAU,IAAI,eAAe;CAI5C,MAAM,WAAW,cAAc,OAAO,KAAK,GAAG;CAkB9C,MAAM,eAAc,MAfO,MAAM;EAC/B,aAAa,CAHQ,KAAK,KAAK,KAAK,QAAQ,QAAQ,GAAG,cAAc,KAAK,QAAQ,QAAQ,GAG/D,CAAC;EAC5B,QAAQ;EACR,QAAQ;EACR,OAAO;EACP,UAAU;EACV,QAAQ;EAKR,UAAU;EACV,SAAS,CAAC,wBAAwB;CACpC,CAAC,EAE+B,CAAC,YAAY,EAAE,CAAC;CAEhD,MAAM,iBAAiB,KAAK,KAAK,QAAQ,IAAI,GAAG,YAAY,iBAAiB;CAC7E,MAAM,aAAa,gBAAgB,WAAW;CAE9C,MAAM,UAAU,KAAK,KAAK,QAAQ,IAAI,GAAG,KAAK;CAU9C,SAAS,cAAc,cAAc,CAAC,CAAC,MAAM,OAAO,KAAK,KAAK;EAC5D,MAAM;GAAE,MAAM;GAAO;GAAS;EAAU;EACxC,cAAc,CAAC,KAAK;CACtB,CAAC;CAED,OAAO;AACT"}
+{"version":3,"file":"register-loader.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/register-loader.ts"],"sourcesContent":["import { putFileAsync } from \"@warlock.js/fs\";\nimport { build, type Plugin } from \"esbuild\";\nimport { register } from \"node:module\";\nimport path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { type MessagePort, MessageChannel } from \"node:worker_threads\";\nimport type { TranspileInit } from \"./load-hook.js\";\n\n/**\n * Rewrite the hook bundle's remaining npm imports to absolute paths resolved\n * from **core's own** location.\n *\n * The bundle is written into the consuming app's `.warlock/` directory, so a\n * bare `import \"esbuild\"` in it resolves starting from the *app*, walking up\n * the app's `node_modules`. `esbuild` and `get-tsconfig` are core's\n * dependencies, not the app's — under npm/yarn's flat hoisting they happen to\n * be reachable anyway, but under pnpm's strict layout they are not, and the\n * dev server dies with `ERR_MODULE_NOT_FOUND` for a package the app never\n * imported. That is a phantom dependency baked into generated code.\n *\n * Bundling them in instead is not an option for `esbuild`: its JS API is a\n * thin wrapper that spawns a platform-specific native binary, so inlining the\n * JavaScript would not remove the need for the package on disk. Resolving to\n * an absolute `file://` URL at generation time does — the generated file then\n * points straight at the copy core itself is using, whatever the installer's\n * layout.\n */\nexport const resolveExternalsFromCore: Plugin = {\n  name: \"warlock-resolve-externals-from-core\",\n  setup(build) {\n    // The filter is deliberately loose — anything not starting `.` or `/` —\n    // so the guards below carry the real logic.\n    build.onResolve({ filter: /^[^./]/ }, (args) => {\n      // The entry point comes through here too, and on Windows its absolute\n      // path (\"D:\\\\…\") is not `.` or `/`. Marking it external fails the build.\n      if (args.kind === \"entry-point\" || path.isAbsolute(args.path)) {\n        return null;\n      }\n\n      if (args.path.startsWith(\"node:\")) {\n        return { external: true };\n      }\n\n      try {\n        return { path: import.meta.resolve(args.path), external: true };\n      } catch {\n        // Unresolvable from here — leave it bare and let Node try, which is\n        // exactly the previous behaviour rather than a hard failure.\n        return { external: true };\n      }\n    });\n  },\n};\n\n/**\n * Bundle, write, and register the ESM loader hook.\n *\n * **Why bundle?**\n * `module.register()` runs the hook file in a fresh Node.js worker thread that\n * has no tsx hook of its own. The hook source is TypeScript, so we must produce\n * a plain ESM bundle before registering. esbuild inline-bundles all three hook\n * modules (`hook-thread`, `resolve-hook`, `load-hook`, `version-registry`)\n * into a single `.mjs` file written to `.warlock/`. External npm packages\n * (`esbuild`, `node:*`) are kept external — the hook thread can resolve those\n * from `node_modules` normally.\n *\n * **Why a file and not a `data:` URL?**\n * Some Node versions have issues resolving `import.meta.url` inside `data:`\n * modules. A real file under `.warlock/` is simpler and debuggable.\n *\n * **Timing**\n * Called from `FilesOrchestrator.init()` before any user `src/` module is\n * dynamically imported. `module.register()` takes effect for all subsequent\n * `import()` calls, which is exactly the window we need.\n *\n * @param transpile - Transpile-cache config to ship into the hook worker,\n *   or `null` to keep the hook in tsx-passthrough mode.\n *\n * @returns The main-thread side of the MessageChannel. Callers post\n *   `{ type: \"bump\", absolutePath }` messages on it to invalidate modules.\n *\n * @example\n * const port = await registerLoader(transpileInit);\n * // Later, when a file changes:\n * port.postMessage({ type: \"bump\", absolutePath: \"/abs/path/to/user.model.ts\" });\n */\nexport async function registerLoader(transpile: TranspileInit): Promise<MessagePort> {\n  const { port1, port2 } = new MessageChannel();\n\n  // hook-thread is a sibling module, so it shares THIS file's extension:\n  // `.ts` when core runs from source (tsx), `.mjs` when published.\n  const selfPath = fileURLToPath(import.meta.url);\n  const hookThreadPath = path.join(path.dirname(selfPath), `hook-thread${path.extname(selfPath)}`);\n\n  const bundleResult = await build({\n    entryPoints: [hookThreadPath],\n    bundle: true,\n    format: \"esm\",\n    write: false,\n    platform: \"node\",\n    target: \"node20\",\n    // npm packages and Node built-ins stay external, but the plugin rewrites\n    // each remaining npm specifier to an absolute path resolved from core's\n    // own install — see `resolveExternalsFromCore` for why bare imports break\n    // under pnpm's strict layout.\n    packages: \"external\",\n    plugins: [resolveExternalsFromCore],\n  });\n\n  const bundledCode = bundleResult.outputFiles[0]!.text;\n  // Caller (filesOrchestrator.init) guarantees .warlock/ exists before this runs.\n  const hookBundlePath = path.join(process.cwd(), \".warlock\", \"loader-hook.mjs\");\n  await putFileAsync(hookBundlePath, bundledCode);\n\n  const srcRoot = path.join(process.cwd(), \"src\");\n\n  // No tsx registration: our hook owns resolution (own-resolver) and the\n  // transpile of every `.ts`/`.tsx` (esbuild, in the load hook). The chain\n  // is simply [our hook] → [Node default] for non-TS (npm/.js, node:).\n  // In this monorepo tsx is still the *launcher* (`tsx start.ts`) so its\n  // loader is present anyway, but it is never consulted for TypeScript —\n  // our hook short-circuits first. A released `node bin/warlock.js` has no\n  // tsx at all and relies entirely on this hook.\n\n  register(pathToFileURL(hookBundlePath).href, import.meta.url, {\n    data: { port: port2, srcRoot, transpile },\n    transferList: [port2],\n  });\n\n  return port1;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,MAAa,2BAAmC;CAC9C,MAAM;CACN,MAAM,OAAO;EAGX,MAAM,UAAU,EAAE,QAAQ,SAAS,IAAI,SAAS;GAG9C,IAAI,KAAK,SAAS,iBAAiB,KAAK,WAAW,KAAK,IAAI,GAC1D,OAAO;GAGT,IAAI,KAAK,KAAK,WAAW,OAAO,GAC9B,OAAO,EAAE,UAAU,KAAK;GAG1B,IAAI;IACF,OAAO;KAAE,MAAM,YAAY,QAAQ,KAAK,IAAI;KAAG,UAAU;IAAK;GAChE,QAAQ;IAGN,OAAO,EAAE,UAAU,KAAK;GAC1B;EACF,CAAC;CACH;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,eAAsB,eAAe,WAAgD;CACnF,MAAM,EAAE,OAAO,UAAU,IAAI,eAAe;CAI5C,MAAM,WAAW,cAAc,YAAY,GAAG;CAC9C,MAAM,iBAAiB,KAAK,KAAK,KAAK,QAAQ,QAAQ,GAAG,cAAc,KAAK,QAAQ,QAAQ,GAAG;CAiB/F,MAAM,eAAc,MAfO,MAAM;EAC/B,aAAa,CAAC,cAAc;EAC5B,QAAQ;EACR,QAAQ;EACR,OAAO;EACP,UAAU;EACV,QAAQ;EAKR,UAAU;EACV,SAAS,CAAC,wBAAwB;CACpC,CAAC,EAE+B,CAAC,YAAY,EAAE,CAAE;CAEjD,MAAM,iBAAiB,KAAK,KAAK,QAAQ,IAAI,GAAG,YAAY,iBAAiB;CAC7E,MAAM,aAAa,gBAAgB,WAAW;CAE9C,MAAM,UAAU,KAAK,KAAK,QAAQ,IAAI,GAAG,KAAK;CAU9C,SAAS,cAAc,cAAc,CAAC,CAAC,MAAM,YAAY,KAAK;EAC5D,MAAM;GAAE,MAAM;GAAO;GAAS;EAAU;EACxC,cAAc,CAAC,KAAK;CACtB,CAAC;CAED,OAAO;AACT"}

package/esm/dev-server/loader/resolve-hook.d.mts

@@ -35,7 +35,7 @@ type NextResolve = (specifier: string, context?: ResolveContext) => Promise<Reso
  * // First import of user.model.ts → ?v=0
  * // File watcher bumps → next import → ?v=1 → fresh module
  */
-declare function resolve(specifier: string, context: ResolveContext, nextResolve: NextResolve): Promise<ResolveResult>;
+export declare function resolve(specifier: string, context: ResolveContext, nextResolve: NextResolve): Promise<ResolveResult>;
 //#endregion
-export { resolve };
+export {};
 //# sourceMappingURL=resolve-hook.d.mts.map

package/esm/dev-server/loader/resolve-hook.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-hook.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/resolve-hook.ts"],"mappings":";KAqCK,cAAA;EACH,SAAA;EACA,UAAA;EACA,gBAAA,GAAmB,MAAM;AAAA;AAAA,KAGtB,aAAA;EACH,GAAA;EACA,MAAA;EACA,YAAA;AAAA;AAAA,KAGG,WAAA,IAAe,SAAA,UAAmB,OAAA,GAAU,cAAA,KAAmB,OAAA,CAAQ,aAAA;;AAH9D;AAAA;;;;;;;;;;;;;;AAG2E;AA2BzF;;;;;;;;iBAAsB,OAAA,CACpB,SAAA,UACA,OAAA,EAAS,cAAA,EACT,WAAA,EAAa,WAAA,GACZ,OAAA,CAAQ,aAAA"}
+{"version":3,"file":"resolve-hook.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/resolve-hook.ts"],"mappings":";KAqCK;EACH;EACA;EACA,mBAAmB;;KAGhB;EACH;EACA;EACA;;KAGG,eAAe,mBAAmB,UAAU,mBAAmB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;wBA2BtD,QACpB,mBACA,SAAS,gBACT,aAAa,cACZ,QAAQ"}

package/esm/dev-server/loader/resolve-hook.mjs

@@ -2,8 +2,8 @@ import { ownResolve } from "./own-resolver.mjs";
 import { captureResolution } from "./resolve-capture.mjs";
 import { getVersion } from "./version-registry.mjs";
 import { existsSync } from "node:fs";
-import { getTsconfig, resolvePathAlias } from "get-tsconfig";
 import { fileURLToPath, pathToFileURL } from "node:url";
+import { getTsconfig, resolvePathAlias } from "get-tsconfig";
 
 //#region ../../packages/core/src/dev-server/loader/resolve-hook.ts
 /**
@@ -74,7 +74,8 @@ async function resolve(specifier, context, nextResolve) {
 	});
 	const cleanUrl = url.replace(/\?v=\d+$/, "");
 	if (!cleanUrl.startsWith(srcRootUrl) || !cleanUrl.endsWith(".ts") && !cleanUrl.endsWith(".tsx")) return result;
-	const version = getVersion(fileURLToPath(cleanUrl));
+	const absolutePath = fileURLToPath(cleanUrl);
+	const version = getVersion(absolutePath);
 	return {
 		...result,
 		url: `${cleanUrl}?v=${version}`,

package/esm/dev-server/loader/resolve-hook.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-hook.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/resolve-hook.ts"],"sourcesContent":["import { getTsconfig, resolvePathAlias } from \"get-tsconfig\";\nimport { existsSync } from \"node:fs\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { ownResolve, type PathsMatcher } from \"./own-resolver.js\";\nimport { captureResolution } from \"./resolve-capture.js\";\nimport { getVersion } from \"./version-registry.js\";\n\n/**\n * The `file://` URL prefix for the project's `src/` root, set once during\n * `initialize()`. Used to identify which resolved URLs belong to user code.\n */\nlet srcRootUrl = \"\";\n\n/**\n * Configure the source root used by the resolve hook.\n * Must be called from `initialize()` before any imports are resolved.\n *\n * @param srcRoot - Absolute filesystem path to the project `src/` directory.\n */\nexport function setSrcRoot(srcRoot: string): void {\n  srcRootUrl = pathToFileURL(srcRoot).href + \"/\";\n}\n\n/** Lazily-built tsconfig `paths` matcher (worker has no startup hook). */\nlet pathsMatcher: PathsMatcher | null = null;\nlet pathsMatcherBuilt = false;\n\nfunction getPathsMatcher(): PathsMatcher | null {\n  if (pathsMatcherBuilt) return pathsMatcher;\n  pathsMatcherBuilt = true;\n  const tsconfig = getTsconfig(process.cwd());\n  // get-tsconfig v5 renamed the curried `createPathsMatcher(t)(spec)` to a direct\n  // `resolvePathAlias(t, spec)`. Wrap it to keep the PathsMatcher closure shape.\n  pathsMatcher = tsconfig ? (specifier: string) => resolvePathAlias(tsconfig, specifier) : null;\n  return pathsMatcher;\n}\n\ntype ResolveContext = {\n  parentURL?: string;\n  conditions?: string[];\n  importAttributes?: Record<string, string>;\n};\n\ntype ResolveResult = {\n  url: string;\n  format?: string;\n  shortCircuit?: boolean;\n};\n\ntype NextResolve = (specifier: string, context?: ResolveContext) => Promise<ResolveResult>;\n\n/**\n * ESM loader `resolve()` hook.\n *\n * The framework's own resolver (`ownResolve`) handles tsconfig `paths`,\n * aliases, and TS extension/`index` probing. Specifiers it doesn't own\n * (bare npm, `node:`, `file:`) fall through to `nextResolve` (Node\n * default). After resolution, stamps a `?v=<N>` version token onto any\n * `.ts` / `.tsx` file that lives under the configured `src/` root.\n *\n * The version token is the cache-bust mechanism: when a file changes the main\n * thread bumps its counter, the next `import()` produces a new URL, Node sees\n * a cache miss, and loads fresh content — native ESM cycles are preserved\n * because static imports remain static throughout.\n *\n * **parentURL cleaning**: the resolved URL carries `?v=N` as a suffix. If a\n * module loaded this way statically imports a relative sibling, Node uses that\n * `?v=N` URL as the `parentURL` for the next `resolve()` call. Passing it\n * unmodified to `nextResolve()` causes tsx to produce paths like\n * `some-sibling.ts?v=0` (the query leaks into URL joining). We strip `?v=N`\n * from `parentURL` before forwarding to prevent this.\n *\n * @example\n * // First import of user.model.ts → ?v=0\n * // File watcher bumps → next import → ?v=1 → fresh module\n */\nexport async function resolve(\n  specifier: string,\n  context: ResolveContext,\n  nextResolve: NextResolve,\n): Promise<ResolveResult> {\n  const cleanContext = context.parentURL?.includes(\"?v=\")\n    ? { ...context, parentURL: context.parentURL.replace(/\\?v=\\d+$/, \"\") }\n    : context;\n\n  // The framework's own resolver owns tsconfig `paths` + TS\n  // extension/index probing. Anything it returns `null` for (bare npm,\n  // `node:`, `file:`) falls through to Node default via `nextResolve`.\n  const owned = ownResolve(specifier, cleanContext.parentURL, getPathsMatcher(), existsSync);\n  // When we produced the URL ourselves we did NOT call nextResolve, so the\n  // result must short-circuit the loader chain or Node throws\n  // ERR_LOADER_CHAIN_INCOMPLETE (e.g. for @warlock.js/* .ts that resolve\n  // outside the project src root and hit the early return below).\n  const result: ResolveResult = owned\n    ? { url: owned, shortCircuit: true }\n    : await nextResolve(specifier, cleanContext);\n\n  const { url } = result;\n\n  // Ground-truth recorder (no-op unless WARLOCK_RESOLVE_CAPTURE is set):\n  // logs the answer for this (specifier, parentURL) so the Phase B\n  // resolver can be proven to reproduce tsx exactly.\n  captureResolution({\n    specifier,\n    parentURL: cleanContext.parentURL,\n    url,\n    format: result.format,\n  });\n\n  const cleanUrl = url.replace(/\\?v=\\d+$/, \"\");\n\n  if (\n    !cleanUrl.startsWith(srcRootUrl) ||\n    (!cleanUrl.endsWith(\".ts\") && !cleanUrl.endsWith(\".tsx\"))\n  ) {\n    return result;\n  }\n\n  const absolutePath = fileURLToPath(cleanUrl);\n  const version = getVersion(absolutePath);\n\n  // Spread the full result from nextResolve (preserves `format` and any other\n  // fields tsx sets) and only override `url`. Dropping `format` would cause\n  // tsx's load hook to see an undefined format and fall through to Node's\n  // default loader, which rejects unknown extensions like .tsx.\n  return { ...result, url: `${cleanUrl}?v=${version}`, shortCircuit: true };\n}\n"],"mappings":";;;;;;;;;;;;AAWA,IAAI,aAAa;;;;;;;AAQjB,SAAgB,WAAW,SAAuB;CAChD,aAAa,cAAc,OAAO,CAAC,CAAC,OAAO;AAC7C;;AAGA,IAAI,eAAoC;AACxC,IAAI,oBAAoB;AAExB,SAAS,kBAAuC;CAC9C,IAAI,mBAAmB,OAAO;CAC9B,oBAAoB;CACpB,MAAM,WAAW,YAAY,QAAQ,IAAI,CAAC;CAG1C,eAAe,YAAY,cAAsB,iBAAiB,UAAU,SAAS,IAAI;CACzF,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,eAAsB,QACpB,WACA,SACA,aACwB;CACxB,MAAM,eAAe,QAAQ,WAAW,SAAS,KAAK,IAClD;EAAE,GAAG;EAAS,WAAW,QAAQ,UAAU,QAAQ,YAAY,EAAE;CAAE,IACnE;CAKJ,MAAM,QAAQ,WAAW,WAAW,aAAa,WAAW,gBAAgB,GAAG,UAAU;CAKzF,MAAM,SAAwB,QAC1B;EAAE,KAAK;EAAO,cAAc;CAAK,IACjC,MAAM,YAAY,WAAW,YAAY;CAE7C,MAAM,EAAE,QAAQ;CAKhB,kBAAkB;EAChB;EACA,WAAW,aAAa;EACxB;EACA,QAAQ,OAAO;CACjB,CAAC;CAED,MAAM,WAAW,IAAI,QAAQ,YAAY,EAAE;CAE3C,IACE,CAAC,SAAS,WAAW,UAAU,KAC9B,CAAC,SAAS,SAAS,KAAK,KAAK,CAAC,SAAS,SAAS,MAAM,GAEvD,OAAO;CAIT,MAAM,UAAU,WADK,cAAc,QACG,CAAC;CAMvC,OAAO;EAAE,GAAG;EAAQ,KAAK,GAAG,SAAS,KAAK;EAAW,cAAc;CAAK;AAC1E"}
+{"version":3,"file":"resolve-hook.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/resolve-hook.ts"],"sourcesContent":["import { getTsconfig, resolvePathAlias } from \"get-tsconfig\";\nimport { existsSync } from \"node:fs\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { ownResolve, type PathsMatcher } from \"./own-resolver.js\";\nimport { captureResolution } from \"./resolve-capture.js\";\nimport { getVersion } from \"./version-registry.js\";\n\n/**\n * The `file://` URL prefix for the project's `src/` root, set once during\n * `initialize()`. Used to identify which resolved URLs belong to user code.\n */\nlet srcRootUrl = \"\";\n\n/**\n * Configure the source root used by the resolve hook.\n * Must be called from `initialize()` before any imports are resolved.\n *\n * @param srcRoot - Absolute filesystem path to the project `src/` directory.\n */\nexport function setSrcRoot(srcRoot: string): void {\n  srcRootUrl = pathToFileURL(srcRoot).href + \"/\";\n}\n\n/** Lazily-built tsconfig `paths` matcher (worker has no startup hook). */\nlet pathsMatcher: PathsMatcher | null = null;\nlet pathsMatcherBuilt = false;\n\nfunction getPathsMatcher(): PathsMatcher | null {\n  if (pathsMatcherBuilt) return pathsMatcher;\n  pathsMatcherBuilt = true;\n  const tsconfig = getTsconfig(process.cwd());\n  // get-tsconfig v5 renamed the curried `createPathsMatcher(t)(spec)` to a direct\n  // `resolvePathAlias(t, spec)`. Wrap it to keep the PathsMatcher closure shape.\n  pathsMatcher = tsconfig ? (specifier: string) => resolvePathAlias(tsconfig, specifier) : null;\n  return pathsMatcher;\n}\n\ntype ResolveContext = {\n  parentURL?: string;\n  conditions?: string[];\n  importAttributes?: Record<string, string>;\n};\n\ntype ResolveResult = {\n  url: string;\n  format?: string;\n  shortCircuit?: boolean;\n};\n\ntype NextResolve = (specifier: string, context?: ResolveContext) => Promise<ResolveResult>;\n\n/**\n * ESM loader `resolve()` hook.\n *\n * The framework's own resolver (`ownResolve`) handles tsconfig `paths`,\n * aliases, and TS extension/`index` probing. Specifiers it doesn't own\n * (bare npm, `node:`, `file:`) fall through to `nextResolve` (Node\n * default). After resolution, stamps a `?v=<N>` version token onto any\n * `.ts` / `.tsx` file that lives under the configured `src/` root.\n *\n * The version token is the cache-bust mechanism: when a file changes the main\n * thread bumps its counter, the next `import()` produces a new URL, Node sees\n * a cache miss, and loads fresh content — native ESM cycles are preserved\n * because static imports remain static throughout.\n *\n * **parentURL cleaning**: the resolved URL carries `?v=N` as a suffix. If a\n * module loaded this way statically imports a relative sibling, Node uses that\n * `?v=N` URL as the `parentURL` for the next `resolve()` call. Passing it\n * unmodified to `nextResolve()` causes tsx to produce paths like\n * `some-sibling.ts?v=0` (the query leaks into URL joining). We strip `?v=N`\n * from `parentURL` before forwarding to prevent this.\n *\n * @example\n * // First import of user.model.ts → ?v=0\n * // File watcher bumps → next import → ?v=1 → fresh module\n */\nexport async function resolve(\n  specifier: string,\n  context: ResolveContext,\n  nextResolve: NextResolve,\n): Promise<ResolveResult> {\n  const cleanContext = context.parentURL?.includes(\"?v=\")\n    ? { ...context, parentURL: context.parentURL.replace(/\\?v=\\d+$/, \"\") }\n    : context;\n\n  // The framework's own resolver owns tsconfig `paths` + TS\n  // extension/index probing. Anything it returns `null` for (bare npm,\n  // `node:`, `file:`) falls through to Node default via `nextResolve`.\n  const owned = ownResolve(specifier, cleanContext.parentURL, getPathsMatcher(), existsSync);\n  // When we produced the URL ourselves we did NOT call nextResolve, so the\n  // result must short-circuit the loader chain or Node throws\n  // ERR_LOADER_CHAIN_INCOMPLETE (e.g. for @warlock.js/* .ts that resolve\n  // outside the project src root and hit the early return below).\n  const result: ResolveResult = owned\n    ? { url: owned, shortCircuit: true }\n    : await nextResolve(specifier, cleanContext);\n\n  const { url } = result;\n\n  // Ground-truth recorder (no-op unless WARLOCK_RESOLVE_CAPTURE is set):\n  // logs the answer for this (specifier, parentURL) so the Phase B\n  // resolver can be proven to reproduce tsx exactly.\n  captureResolution({\n    specifier,\n    parentURL: cleanContext.parentURL,\n    url,\n    format: result.format,\n  });\n\n  const cleanUrl = url.replace(/\\?v=\\d+$/, \"\");\n\n  if (\n    !cleanUrl.startsWith(srcRootUrl) ||\n    (!cleanUrl.endsWith(\".ts\") && !cleanUrl.endsWith(\".tsx\"))\n  ) {\n    return result;\n  }\n\n  const absolutePath = fileURLToPath(cleanUrl);\n  const version = getVersion(absolutePath);\n\n  // Spread the full result from nextResolve (preserves `format` and any other\n  // fields tsx sets) and only override `url`. Dropping `format` would cause\n  // tsx's load hook to see an undefined format and fall through to Node's\n  // default loader, which rejects unknown extensions like .tsx.\n  return { ...result, url: `${cleanUrl}?v=${version}`, shortCircuit: true };\n}\n"],"mappings":";;;;;;;;;;;;AAWA,IAAI,aAAa;;;;;;;AAQjB,SAAgB,WAAW,SAAuB;CAChD,aAAa,cAAc,OAAO,CAAC,CAAC,OAAO;AAC7C;;AAGA,IAAI,eAAoC;AACxC,IAAI,oBAAoB;AAExB,SAAS,kBAAuC;CAC9C,IAAI,mBAAmB,OAAO;CAC9B,oBAAoB;CACpB,MAAM,WAAW,YAAY,QAAQ,IAAI,CAAC;CAG1C,eAAe,YAAY,cAAsB,iBAAiB,UAAU,SAAS,IAAI;CACzF,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,eAAsB,QACpB,WACA,SACA,aACwB;CACxB,MAAM,eAAe,QAAQ,WAAW,SAAS,KAAK,IAClD;EAAE,GAAG;EAAS,WAAW,QAAQ,UAAU,QAAQ,YAAY,EAAE;CAAE,IACnE;CAKJ,MAAM,QAAQ,WAAW,WAAW,aAAa,WAAW,gBAAgB,GAAG,UAAU;CAKzF,MAAM,SAAwB,QAC1B;EAAE,KAAK;EAAO,cAAc;CAAK,IACjC,MAAM,YAAY,WAAW,YAAY;CAE7C,MAAM,EAAE,QAAQ;CAKhB,kBAAkB;EAChB;EACA,WAAW,aAAa;EACxB;EACA,QAAQ,OAAO;CACjB,CAAC;CAED,MAAM,WAAW,IAAI,QAAQ,YAAY,EAAE;CAE3C,IACE,CAAC,SAAS,WAAW,UAAU,KAC9B,CAAC,SAAS,SAAS,KAAK,KAAK,CAAC,SAAS,SAAS,MAAM,GAEvD,OAAO;CAGT,MAAM,eAAe,cAAc,QAAQ;CAC3C,MAAM,UAAU,WAAW,YAAY;CAMvC,OAAO;EAAE,GAAG;EAAQ,KAAK,GAAG,SAAS,KAAK;EAAW,cAAc;CAAK;AAC1E"}

package/esm/dev-server/loader/transpile-cache.mjs

@@ -1,5 +1,5 @@
-import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
+import path from "node:path";
 import { mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 
 //#region ../../packages/core/src/dev-server/loader/transpile-cache.ts
@@ -113,7 +113,8 @@ var TranspileCache = class {
 	* concurrent {@link get} never observes a half-written module.
 	*/
 	put(key, entry, label) {
-		mkdirSync(this.shardDir(key), { recursive: true });
+		const shard = this.shardDir(key);
+		mkdirSync(shard, { recursive: true });
 		this.atomicWrite(this.codePath(key, label), entry.code);
 		if (entry.map) this.atomicWrite(this.mapPath(key, label), entry.map);
 	}

package/esm/dev-server/loader/transpile-cache.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transpile-cache.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/transpile-cache.ts"],"sourcesContent":["/**\n * Persisted transpile cache.\n *\n * Keyed by a hash of *source content* plus a transform-options fingerprint.\n * Same source + same options → same key → same output, always. Changed\n * content → different key → fresh transpile. There is no path-keyed entry\n * anywhere, so the old \"stack trace points at a mangled cache filename\" bug\n * class is structurally impossible — the on-disk filename is opaque and the\n * source identity lives only inside the source map.\n *\n * This module is pure and hook-agnostic on purpose: it knows how to read,\n * write and evict cache entries given a key, nothing about the ESM loader,\n * `?v=N` versioning, or esbuild. Phase 2 wires it into the load hook.\n *\n * @example\n *   const fp = computeFingerprint({\n *     esbuildVersion: esbuild.version,\n *     cacheEpoch: CACHE_EPOCH,\n *     compilerOptions,\n *   });\n *   const key = cacheKey(sourceText, fp);\n *   const hit = cache.get(key);\n *   if (!hit) cache.put(key, { code, map });\n */\n\nimport { createHash, randomUUID } from \"node:crypto\";\nimport {\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  renameSync,\n  rmSync,\n  statSync,\n  writeFileSync,\n} from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * A cached transpile result: the emitted JS and its source map (raw JSON\n * string, exactly as esbuild produced it). Either may be empty for code\n * that produced no map.\n */\nexport type TranspileEntry = {\n  code: string;\n  map: string;\n};\n\n/**\n * Inputs that change transpiled output for identical source text. Bumping\n * any of these must invalidate every entry — that is achieved structurally\n * by folding them into the key, not by sweeping the cache.\n */\nexport type FingerprintParts = {\n  /** `esbuild.version` — a transform-engine upgrade can change output. */\n  esbuildVersion: string;\n  /**\n   * Monotonic cache-format epoch owned by the framework. Bump it whenever\n   * the cache contract (entry shape, map handling, key derivation) changes\n   * so old entries are guaranteed to miss after a framework upgrade.\n   */\n  cacheEpoch: number;\n  /**\n   * The resolved tsconfig `compilerOptions` blob, hashed wholesale rather\n   * than cherry-picking fields — safer against tsconfig drift (a new option\n   * that affects output can't silently serve stale code).\n   */\n  compilerOptions: unknown;\n};\n\n/**\n * Current cache-format epoch. Bump on any change to {@link TranspileEntry}\n * shape, the storage layout, or how the loader consumes entries.\n */\nexport const CACHE_EPOCH = 1;\n\n/**\n * Stable JSON stringify — object keys sorted recursively so semantically\n * equal option blobs always produce the same fingerprint regardless of key\n * insertion order.\n */\nfunction stableStringify(value: unknown): string {\n  if (value === null || typeof value !== \"object\") {\n    return JSON.stringify(value) ?? \"null\";\n  }\n\n  if (Array.isArray(value)) {\n    return `[${value.map(stableStringify).join(\",\")}]`;\n  }\n\n  const entries = Object.keys(value as Record<string, unknown>)\n    .sort()\n    .map((key) => {\n      const child = stableStringify((value as Record<string, unknown>)[key]);\n      return `${JSON.stringify(key)}:${child}`;\n    });\n\n  return `{${entries.join(\",\")}}`;\n}\n\n/**\n * Fold every output-affecting input into one short hex fingerprint that\n * becomes part of every cache key.\n */\nexport function computeFingerprint(parts: FingerprintParts): string {\n  const canonical = stableStringify({\n    esbuildVersion: parts.esbuildVersion,\n    cacheEpoch: parts.cacheEpoch,\n    compilerOptions: parts.compilerOptions,\n  });\n\n  return createHash(\"sha256\").update(canonical).digest(\"hex\").slice(0, 16);\n}\n\n/**\n * Derive the cache key for a source file. The NUL separator makes\n * `sourceText` and `fingerprint` unambiguous (no concatenation collision).\n */\nexport function cacheKey(sourceText: string, fingerprint: string): string {\n  return createHash(\"sha256\").update(sourceText).update(\"\\0\").update(fingerprint).digest(\"hex\");\n}\n\n/** Options for {@link TranspileCache.gc}. */\nexport type GcOptions = {\n  /** Evict least-recently-modified entries once total size exceeds this. */\n  maxBytes?: number;\n  /** Evict entries whose mtime is older than this many milliseconds. */\n  maxAgeMs?: number;\n};\n\ntype CacheFileInfo = {\n  codePath: string;\n  mapPath: string;\n  size: number;\n  mtimeMs: number;\n};\n\n/**\n * Content-hash-addressed transpile cache stored on disk.\n *\n * Layout: `<cacheDir>/<first2-of-key>/<key>.js` plus a sibling `.js.map`.\n * Sharding by the first two hex chars keeps any single directory small on\n * large projects. GC metadata is derived from filesystem mtime so there is\n * no second source of truth (no sidecar index to keep consistent).\n */\nexport class TranspileCache {\n  public constructor(private readonly cacheDir: string) {}\n\n  private shardDir(key: string): string {\n    return path.join(this.cacheDir, key.slice(0, 2));\n  }\n\n  /**\n   * `label` is an optional human-readable prefix (e.g. a path slug). It is\n   * cosmetic only — the content `key` is still what makes the name unique,\n   * so the same `(key, label)` pair must be passed to `get` and `put`.\n   */\n  private fileName(key: string, label: string | undefined, ext: string): string {\n    return label ? `${label}.${key}${ext}` : `${key}${ext}`;\n  }\n\n  private codePath(key: string, label?: string): string {\n    return path.join(this.shardDir(key), this.fileName(key, label, \".js\"));\n  }\n\n  private mapPath(key: string, label?: string): string {\n    return path.join(this.shardDir(key), this.fileName(key, label, \".js.map\"));\n  }\n\n  /**\n   * Return the cached entry for `key`, or `null` on a miss. Synchronous on\n   * purpose: this sits on the module-load hot path and must not pay an\n   * event-loop hop per import.\n   */\n  public get(key: string, label?: string): TranspileEntry | null {\n    try {\n      const code = readFileSync(this.codePath(key, label), \"utf8\");\n      let map = \"\";\n      try {\n        map = readFileSync(this.mapPath(key, label), \"utf8\");\n      } catch {\n        // A code entry with no map is valid (e.g. map-less transform).\n      }\n      return { code, map };\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Store an entry for `key`. Written atomically (temp file + rename) so a\n   * concurrent {@link get} never observes a half-written module.\n   */\n  public put(key: string, entry: TranspileEntry, label?: string): void {\n    const shard = this.shardDir(key);\n    mkdirSync(shard, { recursive: true });\n\n    this.atomicWrite(this.codePath(key, label), entry.code);\n    if (entry.map) {\n      this.atomicWrite(this.mapPath(key, label), entry.map);\n    }\n  }\n\n  private atomicWrite(filePath: string, content: string): void {\n    const tempPath = `${filePath}.${process.pid}.${randomUUID()}.tmp`;\n    try {\n      writeFileSync(tempPath, content);\n      renameSync(tempPath, filePath);\n    } catch (error) {\n      // Windows can report EPERM/EACCES when another loader process wins the\n      // rename to this content-addressed destination. The winner's file is a\n      // valid commit only when it contains the exact bytes we meant to store;\n      // otherwise preserve the original error instead of accepting corruption.\n      const code = (error as NodeJS.ErrnoException).code;\n      const mayBeConcurrentCommit = code === \"EEXIST\" || code === \"EPERM\" || code === \"EACCES\";\n\n      if (!mayBeConcurrentCommit || !this.hasCommittedContent(filePath, content)) {\n        throw error;\n      }\n    } finally {\n      try {\n        rmSync(tempPath, { force: true });\n      } catch {\n        // Best effort: a cleanup failure must not mask the rename result.\n      }\n    }\n  }\n\n  private hasCommittedContent(filePath: string, content: string): boolean {\n    try {\n      return readFileSync(filePath, \"utf8\") === content;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Opportunistic eviction. Cheap, runs at boot (not on the hot path).\n   * Removes age-expired entries first, then trims to the size budget by\n   * evicting least-recently-modified entries. Both bounds are optional;\n   * with neither set this is a no-op.\n   */\n  public gc(options: GcOptions = {}): void {\n    const { maxBytes, maxAgeMs } = options;\n    if (maxBytes === undefined && maxAgeMs === undefined) return;\n\n    const files = this.scan();\n    const now = Date.now();\n\n    let live = files;\n\n    if (maxAgeMs !== undefined) {\n      live = [];\n      for (const file of files) {\n        if (now - file.mtimeMs > maxAgeMs) {\n          this.evict(file);\n        } else {\n          live.push(file);\n        }\n      }\n    }\n\n    if (maxBytes !== undefined) {\n      let total = live.reduce((sum, file) => sum + file.size, 0);\n      if (total > maxBytes) {\n        // Oldest first — least-recently-modified is the eviction order.\n        live.sort((a, b) => a.mtimeMs - b.mtimeMs);\n        for (const file of live) {\n          if (total <= maxBytes) break;\n          total -= file.size;\n          this.evict(file);\n        }\n      }\n    }\n  }\n\n  private scan(): CacheFileInfo[] {\n    const result: CacheFileInfo[] = [];\n\n    let shards: string[];\n    try {\n      shards = readdirSync(this.cacheDir);\n    } catch {\n      return result;\n    }\n\n    for (const shard of shards) {\n      const shardPath = path.join(this.cacheDir, shard);\n      let entries: string[];\n      try {\n        entries = readdirSync(shardPath);\n      } catch {\n        continue;\n      }\n\n      for (const entry of entries) {\n        if (!entry.endsWith(\".js\")) continue;\n        const codePath = path.join(shardPath, entry);\n        try {\n          const stat = statSync(codePath);\n          const mapPath = `${codePath}.map`;\n          let mapSize = 0;\n          try {\n            mapSize = statSync(mapPath).size;\n          } catch {\n            // no map sidecar — fine\n          }\n          result.push({\n            codePath,\n            mapPath,\n            size: stat.size + mapSize,\n            mtimeMs: stat.mtimeMs,\n          });\n        } catch {\n          // entry vanished mid-scan — skip\n        }\n      }\n    }\n\n    return result;\n  }\n\n  private evict(file: CacheFileInfo): void {\n    try {\n      rmSync(file.codePath, { force: true });\n    } catch {\n      // best effort\n    }\n    try {\n      rmSync(file.mapPath, { force: true });\n    } catch {\n      // best effort\n    }\n  }\n\n  /** Remove the entire cache directory (used by `--fresh`). */\n  public clear(): void {\n    try {\n      rmSync(this.cacheDir, { recursive: true, force: true });\n    } catch {\n      // best effort\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"transpile-cache.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/loader/transpile-cache.ts"],"sourcesContent":["/**\n * Persisted transpile cache.\n *\n * Keyed by a hash of *source content* plus a transform-options fingerprint.\n * Same source + same options → same key → same output, always. Changed\n * content → different key → fresh transpile. There is no path-keyed entry\n * anywhere, so the old \"stack trace points at a mangled cache filename\" bug\n * class is structurally impossible — the on-disk filename is opaque and the\n * source identity lives only inside the source map.\n *\n * This module is pure and hook-agnostic on purpose: it knows how to read,\n * write and evict cache entries given a key, nothing about the ESM loader,\n * `?v=N` versioning, or esbuild. Phase 2 wires it into the load hook.\n *\n * @example\n *   const fp = computeFingerprint({\n *     esbuildVersion: esbuild.version,\n *     cacheEpoch: CACHE_EPOCH,\n *     compilerOptions,\n *   });\n *   const key = cacheKey(sourceText, fp);\n *   const hit = cache.get(key);\n *   if (!hit) cache.put(key, { code, map });\n */\n\nimport { createHash, randomUUID } from \"node:crypto\";\nimport {\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  renameSync,\n  rmSync,\n  statSync,\n  writeFileSync,\n} from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * A cached transpile result: the emitted JS and its source map (raw JSON\n * string, exactly as esbuild produced it). Either may be empty for code\n * that produced no map.\n */\nexport type TranspileEntry = {\n  code: string;\n  map: string;\n};\n\n/**\n * Inputs that change transpiled output for identical source text. Bumping\n * any of these must invalidate every entry — that is achieved structurally\n * by folding them into the key, not by sweeping the cache.\n */\nexport type FingerprintParts = {\n  /** `esbuild.version` — a transform-engine upgrade can change output. */\n  esbuildVersion: string;\n  /**\n   * Monotonic cache-format epoch owned by the framework. Bump it whenever\n   * the cache contract (entry shape, map handling, key derivation) changes\n   * so old entries are guaranteed to miss after a framework upgrade.\n   */\n  cacheEpoch: number;\n  /**\n   * The resolved tsconfig `compilerOptions` blob, hashed wholesale rather\n   * than cherry-picking fields — safer against tsconfig drift (a new option\n   * that affects output can't silently serve stale code).\n   */\n  compilerOptions: unknown;\n};\n\n/**\n * Current cache-format epoch. Bump on any change to {@link TranspileEntry}\n * shape, the storage layout, or how the loader consumes entries.\n */\nexport const CACHE_EPOCH = 1;\n\n/**\n * Stable JSON stringify — object keys sorted recursively so semantically\n * equal option blobs always produce the same fingerprint regardless of key\n * insertion order.\n */\nfunction stableStringify(value: unknown): string {\n  if (value === null || typeof value !== \"object\") {\n    return JSON.stringify(value) ?? \"null\";\n  }\n\n  if (Array.isArray(value)) {\n    return `[${value.map(stableStringify).join(\",\")}]`;\n  }\n\n  const entries = Object.keys(value as Record<string, unknown>)\n    .sort()\n    .map((key) => {\n      const child = stableStringify((value as Record<string, unknown>)[key]);\n      return `${JSON.stringify(key)}:${child}`;\n    });\n\n  return `{${entries.join(\",\")}}`;\n}\n\n/**\n * Fold every output-affecting input into one short hex fingerprint that\n * becomes part of every cache key.\n */\nexport function computeFingerprint(parts: FingerprintParts): string {\n  const canonical = stableStringify({\n    esbuildVersion: parts.esbuildVersion,\n    cacheEpoch: parts.cacheEpoch,\n    compilerOptions: parts.compilerOptions,\n  });\n\n  return createHash(\"sha256\").update(canonical).digest(\"hex\").slice(0, 16);\n}\n\n/**\n * Derive the cache key for a source file. The NUL separator makes\n * `sourceText` and `fingerprint` unambiguous (no concatenation collision).\n */\nexport function cacheKey(sourceText: string, fingerprint: string): string {\n  return createHash(\"sha256\").update(sourceText).update(\"\\0\").update(fingerprint).digest(\"hex\");\n}\n\n/** Options for {@link TranspileCache.gc}. */\nexport type GcOptions = {\n  /** Evict least-recently-modified entries once total size exceeds this. */\n  maxBytes?: number;\n  /** Evict entries whose mtime is older than this many milliseconds. */\n  maxAgeMs?: number;\n};\n\ntype CacheFileInfo = {\n  codePath: string;\n  mapPath: string;\n  size: number;\n  mtimeMs: number;\n};\n\n/**\n * Content-hash-addressed transpile cache stored on disk.\n *\n * Layout: `<cacheDir>/<first2-of-key>/<key>.js` plus a sibling `.js.map`.\n * Sharding by the first two hex chars keeps any single directory small on\n * large projects. GC metadata is derived from filesystem mtime so there is\n * no second source of truth (no sidecar index to keep consistent).\n */\nexport class TranspileCache {\n  public constructor(private readonly cacheDir: string) {}\n\n  private shardDir(key: string): string {\n    return path.join(this.cacheDir, key.slice(0, 2));\n  }\n\n  /**\n   * `label` is an optional human-readable prefix (e.g. a path slug). It is\n   * cosmetic only — the content `key` is still what makes the name unique,\n   * so the same `(key, label)` pair must be passed to `get` and `put`.\n   */\n  private fileName(key: string, label: string | undefined, ext: string): string {\n    return label ? `${label}.${key}${ext}` : `${key}${ext}`;\n  }\n\n  private codePath(key: string, label?: string): string {\n    return path.join(this.shardDir(key), this.fileName(key, label, \".js\"));\n  }\n\n  private mapPath(key: string, label?: string): string {\n    return path.join(this.shardDir(key), this.fileName(key, label, \".js.map\"));\n  }\n\n  /**\n   * Return the cached entry for `key`, or `null` on a miss. Synchronous on\n   * purpose: this sits on the module-load hot path and must not pay an\n   * event-loop hop per import.\n   */\n  public get(key: string, label?: string): TranspileEntry | null {\n    try {\n      const code = readFileSync(this.codePath(key, label), \"utf8\");\n      let map = \"\";\n      try {\n        map = readFileSync(this.mapPath(key, label), \"utf8\");\n      } catch {\n        // A code entry with no map is valid (e.g. map-less transform).\n      }\n      return { code, map };\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Store an entry for `key`. Written atomically (temp file + rename) so a\n   * concurrent {@link get} never observes a half-written module.\n   */\n  public put(key: string, entry: TranspileEntry, label?: string): void {\n    const shard = this.shardDir(key);\n    mkdirSync(shard, { recursive: true });\n\n    this.atomicWrite(this.codePath(key, label), entry.code);\n    if (entry.map) {\n      this.atomicWrite(this.mapPath(key, label), entry.map);\n    }\n  }\n\n  private atomicWrite(filePath: string, content: string): void {\n    const tempPath = `${filePath}.${process.pid}.${randomUUID()}.tmp`;\n    try {\n      writeFileSync(tempPath, content);\n      renameSync(tempPath, filePath);\n    } catch (error) {\n      // Windows can report EPERM/EACCES when another loader process wins the\n      // rename to this content-addressed destination. The winner's file is a\n      // valid commit only when it contains the exact bytes we meant to store;\n      // otherwise preserve the original error instead of accepting corruption.\n      const code = (error as NodeJS.ErrnoException).code;\n      const mayBeConcurrentCommit = code === \"EEXIST\" || code === \"EPERM\" || code === \"EACCES\";\n\n      if (!mayBeConcurrentCommit || !this.hasCommittedContent(filePath, content)) {\n        throw error;\n      }\n    } finally {\n      try {\n        rmSync(tempPath, { force: true });\n      } catch {\n        // Best effort: a cleanup failure must not mask the rename result.\n      }\n    }\n  }\n\n  private hasCommittedContent(filePath: string, content: string): boolean {\n    try {\n      return readFileSync(filePath, \"utf8\") === content;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Opportunistic eviction. Cheap, runs at boot (not on the hot path).\n   * Removes age-expired entries first, then trims to the size budget by\n   * evicting least-recently-modified entries. Both bounds are optional;\n   * with neither set this is a no-op.\n   */\n  public gc(options: GcOptions = {}): void {\n    const { maxBytes, maxAgeMs } = options;\n    if (maxBytes === undefined && maxAgeMs === undefined) return;\n\n    const files = this.scan();\n    const now = Date.now();\n\n    let live = files;\n\n    if (maxAgeMs !== undefined) {\n      live = [];\n      for (const file of files) {\n        if (now - file.mtimeMs > maxAgeMs) {\n          this.evict(file);\n        } else {\n          live.push(file);\n        }\n      }\n    }\n\n    if (maxBytes !== undefined) {\n      let total = live.reduce((sum, file) => sum + file.size, 0);\n      if (total > maxBytes) {\n        // Oldest first — least-recently-modified is the eviction order.\n        live.sort((a, b) => a.mtimeMs - b.mtimeMs);\n        for (const file of live) {\n          if (total <= maxBytes) break;\n          total -= file.size;\n          this.evict(file);\n        }\n      }\n    }\n  }\n\n  private scan(): CacheFileInfo[] {\n    const result: CacheFileInfo[] = [];\n\n    let shards: string[];\n    try {\n      shards = readdirSync(this.cacheDir);\n    } catch {\n      return result;\n    }\n\n    for (const shard of shards) {\n      const shardPath = path.join(this.cacheDir, shard);\n      let entries: string[];\n      try {\n        entries = readdirSync(shardPath);\n      } catch {\n        continue;\n      }\n\n      for (const entry of entries) {\n        if (!entry.endsWith(\".js\")) continue;\n        const codePath = path.join(shardPath, entry);\n        try {\n          const stat = statSync(codePath);\n          const mapPath = `${codePath}.map`;\n          let mapSize = 0;\n          try {\n            mapSize = statSync(mapPath).size;\n          } catch {\n            // no map sidecar — fine\n          }\n          result.push({\n            codePath,\n            mapPath,\n            size: stat.size + mapSize,\n            mtimeMs: stat.mtimeMs,\n          });\n        } catch {\n          // entry vanished mid-scan — skip\n        }\n      }\n    }\n\n    return result;\n  }\n\n  private evict(file: CacheFileInfo): void {\n    try {\n      rmSync(file.codePath, { force: true });\n    } catch {\n      // best effort\n    }\n    try {\n      rmSync(file.mapPath, { force: true });\n    } catch {\n      // best effort\n    }\n  }\n\n  /** Remove the entire cache directory (used by `--fresh`). */\n  public clear(): void {\n    try {\n      rmSync(this.cacheDir, { recursive: true, force: true });\n    } catch {\n      // best effort\n    }\n  }\n}\n"],"mappings":"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"}

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

@@ -1,8 +1,7 @@
 import { FileManifest } from "./types.mjs";
 import { FileManager } from "./file-manager.mjs";
-
 //#region ../../packages/core/src/dev-server/manifest-manager.d.ts
-declare class ManifestManager {
+export declare class ManifestManager {
   private readonly files;
   /**
    * Manifest data with metadata
@@ -67,5 +66,4 @@ declare class ManifestManager {
   clear(): void;
 }
 //#endregion
-export { ManifestManager };
 //# sourceMappingURL=manifest-manager.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"manifest-manager.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/manifest-manager.ts"],"mappings":";;;;cAqBa,eAAA;EAAA,iBAiByB,KAAA;EAAA;;;EAAA,QAb5B,QAAA;EAa+C;;;cAAnB,KAAA,EAAO,GAAA,SAAY,WAAA;EA6B1C;;;;EAvBA,IAAA,IAAQ,OAAA;EA0Cd;;;EAnBM,IAAA,IAAQ,OAAA;EA0B0B;;;EAdxC,OAAA,CAAQ,QAAA,WAAmB,YAAA;EA4B3B;;;EArBA,OAAA,CAAQ,QAAA;EAmCR;;;EA5BA,OAAA,CAAQ,QAAA,UAAkB,YAAA,EAAc,YAAA;;;;EAOxC,UAAA,CAAW,QAAA;EA2CX;;AAAK;EApCL,eAAA;;;;EAOA,WAAA,IAAe,MAAA,SAAe,YAAA;;;;EAO9B,WAAA;;;;;;;;;;;;UAYC,0BAAA;;;;EAUD,KAAA;AAAA"}
+{"version":3,"file":"manifest-manager.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/manifest-manager.ts"],"mappings":";;;qBAqBa;mBAiByB;;;;UAb5B;;;;EAaR,YAAoC,OAAO,YAAY;;;;;EAM1C,QAAQ;;;;EAuBR,QAAQ;;;;EAYd,QAAQ,mBAAmB;;;;EAO3B,QAAQ;;;;EAOR,QAAQ,kBAAkB,cAAc;;;;EAOxC,WAAW;;;;EAOX;;;;EAOA,eAAe,eAAe;;;;EAO9B;IAEH;IACA;IACA;IACA;MA/GU;MACO;;;;;;UAqHb;;;;EAUD"}

package/esm/dev-server/model-module-registry.mjs

@@ -1,6 +1,6 @@
 import { container } from "../container/index.mjs";
 import path from "node:path";
-import fs from "node:fs";
+import fsSync from "node:fs";
 import { pathToFileURL } from "node:url";
 
 //#region ../../packages/core/src/dev-server/model-module-registry.ts
@@ -11,7 +11,7 @@ function normalizeInputPath(absolutePath) {
 function canonicalPath(absolutePath) {
 	let resolvedPath = path.resolve(absolutePath);
 	try {
-		resolvedPath = fs.realpathSync.native(resolvedPath);
+		resolvedPath = fsSync.realpathSync.native(resolvedPath);
 	} catch {}
 	return normalizeInputPath(resolvedPath);
 }
@@ -86,5 +86,5 @@ function getDevelopmentModelModuleRegistry() {
 }
 
 //#endregion
-export { getDevelopmentModelModuleRegistry };
+export { DevelopmentModelModuleRegistry, getDevelopmentModelModuleRegistry };
 //# sourceMappingURL=model-module-registry.mjs.map

package/esm/dev-server/model-module-registry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"model-module-registry.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/model-module-registry.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { container } from \"../container\";\nimport type {\n  DevelopmentModelModuleEntry,\n  DevelopmentModelModules,\n} from \"../container/development-model-modules\";\n\ntype StoredEntry = DevelopmentModelModuleEntry & { readonly namespace?: object };\n\nfunction normalizeInputPath(absolutePath: string): string {\n  const slashNormalized = path.resolve(absolutePath).replaceAll(\"\\\\\", \"/\");\n  return process.platform === \"win32\" ? slashNormalized.toLowerCase() : slashNormalized;\n}\n\nfunction canonicalPath(absolutePath: string): string {\n  let resolvedPath = path.resolve(absolutePath);\n\n  try {\n    resolvedPath = fs.realpathSync.native(resolvedPath);\n  } catch {\n    // A deleted model must still resolve to the key it had before deletion.\n  }\n\n  return normalizeInputPath(resolvedPath);\n}\n\n/** Internal writer for the container's read-only development model carrier. */\nexport class DevelopmentModelModuleRegistry implements DevelopmentModelModules {\n  private readonly entries = new Map<string, StoredEntry>();\n  private readonly aliases = new Map<string, string>();\n  private readonly listeners = new Set<(entry: DevelopmentModelModuleEntry) => void>();\n\n  public get(absolutePath: string): DevelopmentModelModuleEntry | undefined {\n    const inputPath = normalizeInputPath(absolutePath);\n    const key = this.aliases.get(inputPath) ?? canonicalPath(absolutePath);\n    const entry = this.entries.get(key);\n    if (entry !== undefined) this.aliases.set(inputPath, key);\n    return entry === undefined ? undefined : this.toPublicEntry(entry);\n  }\n\n  public subscribe(listener: (entry: DevelopmentModelModuleEntry) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  public publish(absolutePath: string, url: string, namespace: object): void {\n    const inputPath = normalizeInputPath(absolutePath);\n    const key = canonicalPath(absolutePath);\n    this.aliases.set(inputPath, key);\n    const current = this.entries.get(key);\n\n    if (current?.state === \"ready\" && current.namespace === namespace) return;\n\n    const entry: StoredEntry = {\n      url,\n      generation: (current?.generation ?? 0) + 1,\n      hasDefault: Object.hasOwn(namespace, \"default\"),\n      state: \"ready\",\n      namespace,\n    };\n    this.entries.set(key, entry);\n    this.notify(entry);\n  }\n\n  public remove(absolutePath: string): void {\n    const inputPath = normalizeInputPath(absolutePath);\n    const key = this.aliases.get(inputPath) ?? canonicalPath(absolutePath);\n    this.aliases.set(inputPath, key);\n    const current = this.entries.get(key);\n\n    if (current?.state === \"removed\") return;\n\n    const entry: DevelopmentModelModuleEntry = {\n      url: current?.url ?? pathToFileURL(absolutePath).href,\n      generation: (current?.generation ?? 0) + 1,\n      hasDefault: false,\n      state: \"removed\",\n    };\n    this.entries.set(key, entry);\n    this.notify(entry);\n  }\n\n  private notify(entry: DevelopmentModelModuleEntry): void {\n    const publicEntry = this.toPublicEntry(entry);\n    for (const listener of this.listeners) listener(publicEntry);\n  }\n\n  private toPublicEntry(entry: DevelopmentModelModuleEntry): DevelopmentModelModuleEntry {\n    return {\n      url: entry.url,\n      generation: entry.generation,\n      hasDefault: entry.hasDefault,\n      state: entry.state,\n    };\n  }\n}\n\nexport function getDevelopmentModelModuleRegistry(): DevelopmentModelModuleRegistry {\n  const existing = container.tryGet(\"development.modelModules\");\n\n  if (existing instanceof DevelopmentModelModuleRegistry) return existing;\n\n  const registry = new DevelopmentModelModuleRegistry();\n  container.set(\"development.modelModules\", registry);\n  return registry;\n}\n"],"mappings":";;;;;;AAWA,SAAS,mBAAmB,cAA8B;CACxD,MAAM,kBAAkB,KAAK,QAAQ,YAAY,CAAC,CAAC,WAAW,MAAM,GAAG;CACvE,OAAO,QAAQ,aAAa,UAAU,gBAAgB,YAAY,IAAI;AACxE;AAEA,SAAS,cAAc,cAA8B;CACnD,IAAI,eAAe,KAAK,QAAQ,YAAY;CAE5C,IAAI;EACF,eAAe,GAAG,aAAa,OAAO,YAAY;CACpD,QAAQ,CAER;CAEA,OAAO,mBAAmB,YAAY;AACxC;;AAGA,IAAa,iCAAb,MAA+E;;iCAClD,IAAI,IAAyB;iCAC7B,IAAI,IAAoB;mCACtB,IAAI,IAAkD;;CAEnF,AAAO,IAAI,cAA+D;EACxE,MAAM,YAAY,mBAAmB,YAAY;EACjD,MAAM,MAAM,KAAK,QAAQ,IAAI,SAAS,KAAK,cAAc,YAAY;EACrE,MAAM,QAAQ,KAAK,QAAQ,IAAI,GAAG;EAClC,IAAI,UAAU,QAAW,KAAK,QAAQ,IAAI,WAAW,GAAG;EACxD,OAAO,UAAU,SAAY,SAAY,KAAK,cAAc,KAAK;CACnE;CAEA,AAAO,UAAU,UAAoE;EACnF,KAAK,UAAU,IAAI,QAAQ;EAC3B,aAAa,KAAK,UAAU,OAAO,QAAQ;CAC7C;CAEA,AAAO,QAAQ,cAAsB,KAAa,WAAyB;EACzE,MAAM,YAAY,mBAAmB,YAAY;EACjD,MAAM,MAAM,cAAc,YAAY;EACtC,KAAK,QAAQ,IAAI,WAAW,GAAG;EAC/B,MAAM,UAAU,KAAK,QAAQ,IAAI,GAAG;EAEpC,IAAI,SAAS,UAAU,WAAW,QAAQ,cAAc,WAAW;EAEnE,MAAM,QAAqB;GACzB;GACA,aAAa,SAAS,cAAc,KAAK;GACzC,YAAY,OAAO,OAAO,WAAW,SAAS;GAC9C,OAAO;GACP;EACF;EACA,KAAK,QAAQ,IAAI,KAAK,KAAK;EAC3B,KAAK,OAAO,KAAK;CACnB;CAEA,AAAO,OAAO,cAA4B;EACxC,MAAM,YAAY,mBAAmB,YAAY;EACjD,MAAM,MAAM,KAAK,QAAQ,IAAI,SAAS,KAAK,cAAc,YAAY;EACrE,KAAK,QAAQ,IAAI,WAAW,GAAG;EAC/B,MAAM,UAAU,KAAK,QAAQ,IAAI,GAAG;EAEpC,IAAI,SAAS,UAAU,WAAW;EAElC,MAAM,QAAqC;GACzC,KAAK,SAAS,OAAO,cAAc,YAAY,CAAC,CAAC;GACjD,aAAa,SAAS,cAAc,KAAK;GACzC,YAAY;GACZ,OAAO;EACT;EACA,KAAK,QAAQ,IAAI,KAAK,KAAK;EAC3B,KAAK,OAAO,KAAK;CACnB;CAEA,AAAQ,OAAO,OAA0C;EACvD,MAAM,cAAc,KAAK,cAAc,KAAK;EAC5C,KAAK,MAAM,YAAY,KAAK,WAAW,SAAS,WAAW;CAC7D;CAEA,AAAQ,cAAc,OAAiE;EACrF,OAAO;GACL,KAAK,MAAM;GACX,YAAY,MAAM;GAClB,YAAY,MAAM;GAClB,OAAO,MAAM;EACf;CACF;AACF;AAEA,SAAgB,oCAAoE;CAClF,MAAM,WAAW,UAAU,OAAO,0BAA0B;CAE5D,IAAI,oBAAoB,gCAAgC,OAAO;CAE/D,MAAM,WAAW,IAAI,+BAA+B;CACpD,UAAU,IAAI,4BAA4B,QAAQ;CAClD,OAAO;AACT"}
+{"version":3,"file":"model-module-registry.mjs","names":["fs"],"sources":["../../../../../../../../packages/core/src/dev-server/model-module-registry.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { container } from \"../container\";\nimport type {\n  DevelopmentModelModuleEntry,\n  DevelopmentModelModules,\n} from \"../container/development-model-modules\";\n\ntype StoredEntry = DevelopmentModelModuleEntry & { readonly namespace?: object };\n\nfunction normalizeInputPath(absolutePath: string): string {\n  const slashNormalized = path.resolve(absolutePath).replaceAll(\"\\\\\", \"/\");\n  return process.platform === \"win32\" ? slashNormalized.toLowerCase() : slashNormalized;\n}\n\nfunction canonicalPath(absolutePath: string): string {\n  let resolvedPath = path.resolve(absolutePath);\n\n  try {\n    resolvedPath = fs.realpathSync.native(resolvedPath);\n  } catch {\n    // A deleted model must still resolve to the key it had before deletion.\n  }\n\n  return normalizeInputPath(resolvedPath);\n}\n\n/** Internal writer for the container's read-only development model carrier. */\nexport class DevelopmentModelModuleRegistry implements DevelopmentModelModules {\n  private readonly entries = new Map<string, StoredEntry>();\n  private readonly aliases = new Map<string, string>();\n  private readonly listeners = new Set<(entry: DevelopmentModelModuleEntry) => void>();\n\n  public get(absolutePath: string): DevelopmentModelModuleEntry | undefined {\n    const inputPath = normalizeInputPath(absolutePath);\n    const key = this.aliases.get(inputPath) ?? canonicalPath(absolutePath);\n    const entry = this.entries.get(key);\n    if (entry !== undefined) this.aliases.set(inputPath, key);\n    return entry === undefined ? undefined : this.toPublicEntry(entry);\n  }\n\n  public subscribe(listener: (entry: DevelopmentModelModuleEntry) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  public publish(absolutePath: string, url: string, namespace: object): void {\n    const inputPath = normalizeInputPath(absolutePath);\n    const key = canonicalPath(absolutePath);\n    this.aliases.set(inputPath, key);\n    const current = this.entries.get(key);\n\n    if (current?.state === \"ready\" && current.namespace === namespace) return;\n\n    const entry: StoredEntry = {\n      url,\n      generation: (current?.generation ?? 0) + 1,\n      hasDefault: Object.hasOwn(namespace, \"default\"),\n      state: \"ready\",\n      namespace,\n    };\n    this.entries.set(key, entry);\n    this.notify(entry);\n  }\n\n  public remove(absolutePath: string): void {\n    const inputPath = normalizeInputPath(absolutePath);\n    const key = this.aliases.get(inputPath) ?? canonicalPath(absolutePath);\n    this.aliases.set(inputPath, key);\n    const current = this.entries.get(key);\n\n    if (current?.state === \"removed\") return;\n\n    const entry: DevelopmentModelModuleEntry = {\n      url: current?.url ?? pathToFileURL(absolutePath).href,\n      generation: (current?.generation ?? 0) + 1,\n      hasDefault: false,\n      state: \"removed\",\n    };\n    this.entries.set(key, entry);\n    this.notify(entry);\n  }\n\n  private notify(entry: DevelopmentModelModuleEntry): void {\n    const publicEntry = this.toPublicEntry(entry);\n    for (const listener of this.listeners) listener(publicEntry);\n  }\n\n  private toPublicEntry(entry: DevelopmentModelModuleEntry): DevelopmentModelModuleEntry {\n    return {\n      url: entry.url,\n      generation: entry.generation,\n      hasDefault: entry.hasDefault,\n      state: entry.state,\n    };\n  }\n}\n\nexport function getDevelopmentModelModuleRegistry(): DevelopmentModelModuleRegistry {\n  const existing = container.tryGet(\"development.modelModules\");\n\n  if (existing instanceof DevelopmentModelModuleRegistry) return existing;\n\n  const registry = new DevelopmentModelModuleRegistry();\n  container.set(\"development.modelModules\", registry);\n  return registry;\n}\n"],"mappings":";;;;;;AAWA,SAAS,mBAAmB,cAA8B;CACxD,MAAM,kBAAkB,KAAK,QAAQ,YAAY,CAAC,CAAC,WAAW,MAAM,GAAG;CACvE,OAAO,QAAQ,aAAa,UAAU,gBAAgB,YAAY,IAAI;AACxE;AAEA,SAAS,cAAc,cAA8B;CACnD,IAAI,eAAe,KAAK,QAAQ,YAAY;CAE5C,IAAI;EACF,eAAeA,OAAG,aAAa,OAAO,YAAY;CACpD,QAAQ,CAER;CAEA,OAAO,mBAAmB,YAAY;AACxC;;AAGA,IAAa,iCAAb,MAA+E;;iCAClD,IAAI,IAAyB;iCAC7B,IAAI,IAAoB;mCACtB,IAAI,IAAkD;;CAEnF,AAAO,IAAI,cAA+D;EACxE,MAAM,YAAY,mBAAmB,YAAY;EACjD,MAAM,MAAM,KAAK,QAAQ,IAAI,SAAS,KAAK,cAAc,YAAY;EACrE,MAAM,QAAQ,KAAK,QAAQ,IAAI,GAAG;EAClC,IAAI,UAAU,QAAW,KAAK,QAAQ,IAAI,WAAW,GAAG;EACxD,OAAO,UAAU,SAAY,SAAY,KAAK,cAAc,KAAK;CACnE;CAEA,AAAO,UAAU,UAAoE;EACnF,KAAK,UAAU,IAAI,QAAQ;EAC3B,aAAa,KAAK,UAAU,OAAO,QAAQ;CAC7C;CAEA,AAAO,QAAQ,cAAsB,KAAa,WAAyB;EACzE,MAAM,YAAY,mBAAmB,YAAY;EACjD,MAAM,MAAM,cAAc,YAAY;EACtC,KAAK,QAAQ,IAAI,WAAW,GAAG;EAC/B,MAAM,UAAU,KAAK,QAAQ,IAAI,GAAG;EAEpC,IAAI,SAAS,UAAU,WAAW,QAAQ,cAAc,WAAW;EAEnE,MAAM,QAAqB;GACzB;GACA,aAAa,SAAS,cAAc,KAAK;GACzC,YAAY,OAAO,OAAO,WAAW,SAAS;GAC9C,OAAO;GACP;EACF;EACA,KAAK,QAAQ,IAAI,KAAK,KAAK;EAC3B,KAAK,OAAO,KAAK;CACnB;CAEA,AAAO,OAAO,cAA4B;EACxC,MAAM,YAAY,mBAAmB,YAAY;EACjD,MAAM,MAAM,KAAK,QAAQ,IAAI,SAAS,KAAK,cAAc,YAAY;EACrE,KAAK,QAAQ,IAAI,WAAW,GAAG;EAC/B,MAAM,UAAU,KAAK,QAAQ,IAAI,GAAG;EAEpC,IAAI,SAAS,UAAU,WAAW;EAElC,MAAM,QAAqC;GACzC,KAAK,SAAS,OAAO,cAAc,YAAY,CAAC,CAAC;GACjD,aAAa,SAAS,cAAc,KAAK;GACzC,YAAY;GACZ,OAAO;EACT;EACA,KAAK,QAAQ,IAAI,KAAK,KAAK;EAC3B,KAAK,OAAO,KAAK;CACnB;CAEA,AAAQ,OAAO,OAA0C;EACvD,MAAM,cAAc,KAAK,cAAc,KAAK;EAC5C,KAAK,MAAM,YAAY,KAAK,WAAW,SAAS,WAAW;CAC7D;CAEA,AAAQ,cAAc,OAAiE;EACrF,OAAO;GACL,KAAK,MAAM;GACX,YAAY,MAAM;GAClB,YAAY,MAAM;GAClB,OAAO,MAAM;EACf;CACF;AACF;AAEA,SAAgB,oCAAoE;CAClF,MAAM,WAAW,UAAU,OAAO,0BAA0B;CAE5D,IAAI,oBAAoB,gCAAgC,OAAO;CAE/D,MAAM,WAAW,IAAI,+BAA+B;CACpD,UAAU,IAAI,4BAA4B,QAAQ;CAClD,OAAO;AACT"}