@warlock.js/core 5.1.0 → 5.2.1

package/esm/dev-server/health-checker/files-healthcare.manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"files-healthcare.manager.mjs","names":[],"sources":["../../../../../../../../core/src/dev-server/health-checker/files-healthcare.manager.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { Worker } from \"worker_threads\";\nimport { createWorker } from \"../create-worker\";\nimport { devLogInfo } from \"../dev-logger\";\nimport type { FileManager } from \"../file-manager\";\nimport type {\n  FileHealthCheckerContract,\n  HealthCheckerFilesStats,\n} from \"./file-health-checker.contract\";\n\n/**\n * Serialized file data to send to workers\n */\ntype SerializedFile = {\n  path: string;\n  content: string;\n  relativePath: string;\n};\n\n/**\n * Diagnostic message from worker\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  ruleId?: string;\n};\n\n/**\n * File check result from worker\n */\ntype FileCheckResult = {\n  path: string;\n  relativePath: string;\n  healthy: boolean;\n  errors: DiagnosticMessage[];\n  warnings: DiagnosticMessage[];\n};\n\n/**\n * Worker response type\n */\ntype WorkerResponse =\n  | { type: \"initialized\"; success: boolean; hasConfig?: boolean; error?: string }\n  | { type: \"results\"; results: FileCheckResult[] }\n  | { type: \"error\"; message: string };\n\n/**\n * Files Healthcare Manager\n *\n * Manages health checkers for file validation during development.\n * Supports both main-thread and worker-based checkers.\n *\n * Checkers with `workerPath` run in dedicated worker threads for performance.\n * Checkers without `workerPath` run in the main thread.\n *\n * @example\n * ```typescript\n * const manager = new FilesHealthcareManager(files);\n *\n * manager.setHealthCheckers([\n *   new TypescriptHealthChecker(),  // Has workerPath → runs in worker\n *   new CustomChecker(),             // No workerPath → runs in main thread\n * ]);\n *\n * await manager.initialize();\n * await manager.validateAllFiles();\n * ```\n */\nexport class FilesHealthcareManager {\n  /**\n   * Registered health checkers\n   */\n  private healthCheckers: FileHealthCheckerContract[] = [];\n\n  /**\n   * Active worker instances (checkerName → Worker)\n   */\n  private workers = new Map<string, Worker>();\n\n  /**\n   * Worker initialization promises (for ensuring workers are ready)\n   */\n  private workerInitPromises = new Map<string, Promise<boolean>>();\n\n  /**\n   * Aggregated stats for each checker\n   */\n  private checkerStats = new Map<\n    string,\n    {\n      totalFiles: number;\n      healthyFiles: number;\n      defectiveFiles: number;\n      totalErrors: number;\n      totalWarnings: number;\n      filesWithErrors: number;\n      filesWithWarnings: number;\n    }\n  >();\n\n  /**\n   * Constructor\n   * @param files - Map of tracked files\n   */\n  public constructor(private readonly files: Map<string, FileManager>) {}\n\n  /**\n   * Add health checkers to the manager\n   * @param checkers - Checkers to add\n   */\n  public addHealthCheckers(...checkers: FileHealthCheckerContract[]): FilesHealthcareManager {\n    this.healthCheckers.push(...checkers);\n    return this;\n  }\n\n  /**\n   * Set (replace) all health checkers\n   * @param checkers - New set of checkers\n   */\n  public setHealthCheckers(checkers: FileHealthCheckerContract[]): FilesHealthcareManager {\n    this.healthCheckers = checkers;\n    return this;\n  }\n\n  /**\n   * Initialize all health checkers\n   *\n   * For checkers with `workerPath`, spawns dedicated worker threads.\n   * For other checkers, calls their `initialize()` method directly.\n   */\n  public async initialize(): Promise<void> {\n    const initPromises = this.healthCheckers.map(async (checker) => {\n      // Initialize stats for this checker\n      this.checkerStats.set(checker.name, {\n        totalFiles: 0,\n        healthyFiles: 0,\n        defectiveFiles: 0,\n        totalErrors: 0,\n        totalWarnings: 0,\n        filesWithErrors: 0,\n        filesWithWarnings: 0,\n      });\n\n      if (checker.workerPath) {\n        // Spawn dedicated worker for this checker\n        await this.spawnWorker(checker);\n      } else {\n        // Initialize checker on main thread\n        checker.initialize();\n      }\n    });\n\n    await Promise.all(initPromises);\n  }\n\n  /**\n   * Spawn a worker for a checker\n   */\n  private async spawnWorker(checker: FileHealthCheckerContract): Promise<void> {\n    if (!checker.workerPath) return;\n\n    const worker = createWorker(checker.workerPath, import.meta.url, {\n      workerData: { cwd: process.cwd() },\n    });\n\n    this.workers.set(checker.name, worker);\n\n    // Create init promise\n    const initPromise = new Promise<boolean>((resolve) => {\n      const handler = (response: WorkerResponse) => {\n        if (response.type === \"initialized\") {\n          worker.off(\"message\", handler);\n          resolve(response.success);\n        }\n      };\n\n      worker.on(\"message\", handler);\n\n      // Handle worker errors\n      worker.on(\"error\", (error) => {\n        console.error(`Health Checker Worker Error (${checker.name}):`, error);\n        resolve(false);\n      });\n\n      // Send init message\n      worker.postMessage({ type: \"init\", config: { cwd: process.cwd() } });\n    });\n\n    this.workerInitPromises.set(checker.name, initPromise);\n\n    // Wait for initialization\n    await initPromise;\n  }\n\n  /**\n   * Validate all tracked files\n   */\n  public async validateAllFiles(): Promise<void> {\n    const allFiles = Array.from(this.files.values());\n    await this.checkFiles(allFiles);\n\n    // Display stats\n    await this.displayStats();\n  }\n\n  /**\n   * Check the given files with all registered checkers\n   *\n   * All checkers run in parallel for performance.\n   * Worker-based checkers communicate via postMessage.\n   * Main-thread checkers are called directly.\n   */\n  public async checkFiles(files: FileManager[]): Promise<void> {\n    const checkPromises = this.healthCheckers.map(async (checker) => {\n      if (checker.workerPath) {\n        return this.runInWorker(checker.name, files);\n      } else {\n        return this.runInline(checker, files);\n      }\n    });\n\n    const results = await Promise.all(checkPromises);\n\n    // Display any errors/warnings\n    for (const checkerResults of results) {\n      for (const result of checkerResults) {\n        if (!result.healthy) {\n          this.displayFileResults(result);\n        }\n      }\n    }\n  }\n\n  /**\n   * Run checker in worker thread\n   */\n  private async runInWorker(checkerName: string, files: FileManager[]): Promise<FileCheckResult[]> {\n    const worker = this.workers.get(checkerName);\n\n    if (!worker) {\n      return files.map((f) => ({\n        path: f.absolutePath,\n        relativePath: f.relativePath,\n        healthy: true,\n        errors: [],\n        warnings: [],\n      }));\n    }\n\n    // Wait for worker to be initialized\n    const initPromise = this.workerInitPromises.get(checkerName);\n    if (initPromise) {\n      const success = await initPromise;\n      if (!success) {\n        return files.map((f) => ({\n          path: f.absolutePath,\n          relativePath: f.relativePath,\n          healthy: true,\n          errors: [],\n          warnings: [],\n        }));\n      }\n    }\n\n    // Serialize files for worker\n    const serializedFiles: SerializedFile[] = files.map((f) => ({\n      path: f.absolutePath,\n      content: f.source,\n      relativePath: f.relativePath,\n    }));\n\n    return new Promise((resolve) => {\n      const handler = (response: WorkerResponse) => {\n        if (response.type === \"results\") {\n          worker.off(\"message\", handler);\n\n          // Update stats\n          this.updateStats(checkerName, response.results);\n\n          resolve(response.results);\n        } else if (response.type === \"error\") {\n          worker.off(\"message\", handler);\n          resolve(\n            files.map((f) => ({\n              path: f.absolutePath,\n              relativePath: f.relativePath,\n              healthy: true,\n              errors: [],\n              warnings: [],\n            })),\n          );\n        }\n      };\n\n      worker.on(\"message\", handler);\n      worker.postMessage({ type: \"check\", files: serializedFiles });\n    });\n  }\n\n  /**\n   * Run checker inline (main thread)\n   */\n  private async runInline(\n    checker: FileHealthCheckerContract,\n    files: FileManager[],\n  ): Promise<FileCheckResult[]> {\n    const results: FileCheckResult[] = [];\n\n    for (const file of files) {\n      const healthResult = await checker.check(file);\n      const stats = healthResult.getStats();\n\n      results.push({\n        path: file.absolutePath,\n        relativePath: file.relativePath,\n        healthy: stats.state === \"healthy\",\n        errors: healthResult.messages\n          .filter((m) => m.type === \"error\")\n          .map((m) => ({\n            type: \"error\" as const,\n            message: m.message,\n            lineNumber: m.lineNumber,\n            columnNumber: m.columnNumber,\n            length: m.length || 1,\n            filePath: file.absolutePath,\n            relativePath: file.relativePath,\n            ruleId: m.ruleId,\n          })),\n        warnings: healthResult.messages\n          .filter((m) => m.type === \"warning\")\n          .map((m) => ({\n            type: \"warning\" as const,\n            message: m.message,\n            lineNumber: m.lineNumber,\n            columnNumber: m.columnNumber,\n            length: m.length || 1,\n            filePath: file.absolutePath,\n            relativePath: file.relativePath,\n            ruleId: m.ruleId,\n          })),\n      });\n    }\n\n    // Update stats\n    const checkerResults = results;\n    this.updateStats(checker.name, checkerResults);\n\n    return results;\n  }\n\n  /**\n   * Update aggregated stats for a checker\n   */\n  private updateStats(checkerName: string, results: FileCheckResult[]): void {\n    const stats = this.checkerStats.get(checkerName);\n    if (!stats) return;\n\n    for (const result of results) {\n      stats.totalFiles++;\n      if (result.healthy) {\n        stats.healthyFiles++;\n      } else {\n        stats.defectiveFiles++;\n      }\n      stats.totalErrors += result.errors.length;\n      stats.totalWarnings += result.warnings.length;\n      if (result.errors.length > 0) stats.filesWithErrors++;\n      if (result.warnings.length > 0) stats.filesWithWarnings++;\n    }\n  }\n\n  /**\n   * Detect when files are changed\n   */\n  public async onFileChanges(files: FileManager[]): Promise<void> {\n    // Notify workers of file changes\n    const serializedFiles: SerializedFile[] = files.map((f) => ({\n      path: f.absolutePath,\n      content: f.source,\n      relativePath: f.relativePath,\n    }));\n\n    for (const [, worker] of this.workers) {\n      worker.postMessage({ type: \"fileChanges\", files: serializedFiles });\n    }\n\n    // Notify inline checkers\n    await Promise.all(\n      this.healthCheckers.filter((c) => !c.workerPath).map((c) => c.onFileChanges(files)),\n    );\n  }\n\n  /**\n   * Remove files from tracking\n   * Notifies both inline checkers and worker-based checkers about removed files\n   */\n  public removeFiles(files: FileManager[]): void {\n    // Notify inline checkers\n    this.healthCheckers\n      .filter((c) => !c.workerPath)\n      .forEach((checker) => files.forEach((file) => checker.removeFile(file)));\n\n    // Notify workers about deleted files\n    if (files.length > 0) {\n      const deletedPaths = files.map((f) => ({\n        path: f.absolutePath,\n        relativePath: f.relativePath,\n      }));\n\n      for (const [, worker] of this.workers) {\n        worker.postMessage({ type: \"filesDeleted\", files: deletedPaths });\n      }\n    }\n  }\n\n  /**\n   * Display file results (errors/warnings)\n   */\n  private displayFileResults(result: FileCheckResult): void {\n    const fileName = result.relativePath.replace(/\\\\/g, \"/\");\n\n    // Display errors\n    for (const error of result.errors) {\n      const icon = colors.redBright(\"✖\");\n      const level = colors.redBright(colors.bold(\"ERROR\"));\n      console.log(\n        `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${error.lineNumber},${error.columnNumber})`)}`,\n      );\n      if (error.ruleId) {\n        console.log(\n          `  ${colors.magentaBright(error.ruleId)} ${colors.dim(\"→\")} ${colors.red(error.message)}`,\n        );\n      } else {\n        console.log(`  ${colors.dim(\"→\")} ${colors.red(error.message)}`);\n      }\n    }\n\n    // Display warnings\n    for (const warning of result.warnings) {\n      const icon = colors.yellowBright(\"⚠\");\n      const level = colors.yellowBright(colors.bold(\"WARNING\"));\n      console.log(\n        `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${warning.lineNumber},${warning.columnNumber})`)}`,\n      );\n      if (warning.ruleId) {\n        console.log(\n          `  ${colors.magentaBright(warning.ruleId)} ${colors.dim(\"→\")} ${colors.yellow(warning.message)}`,\n        );\n      } else {\n        console.log(`  ${colors.dim(\"→\")} ${colors.yellow(warning.message)}`);\n      }\n    }\n  }\n\n  /**\n   * Display stats for all health checkers\n   */\n  private async displayStats(): Promise<void> {\n    const allStats: HealthCheckerFilesStats[] = [];\n\n    for (const checker of this.healthCheckers) {\n      const stats = this.checkerStats.get(checker.name);\n      if (stats) {\n        allStats.push({\n          name: checker.name,\n          files: {\n            healthy: stats.healthyFiles,\n            defective: stats.defectiveFiles,\n          },\n          warnings: {\n            total: stats.totalWarnings,\n            totalFiles: stats.filesWithWarnings,\n          },\n          errors: {\n            total: stats.totalErrors,\n            totalFiles: stats.filesWithErrors,\n          },\n        });\n      }\n    }\n\n    console.log(\"\\n\");\n    console.log(colors.bold(colors.cyan(\"━\".repeat(80))));\n    devLogInfo(colors.bold(\"  📊 Health Checker Statistics\"));\n    console.log(colors.bold(colors.cyan(\"━\".repeat(80))));\n    console.log(\"\");\n\n    allStats.forEach((stats: HealthCheckerFilesStats, index: number) => {\n      const totalFiles = stats.files.healthy + stats.files.defective;\n      const hasIssues = stats.files.defective > 0;\n\n      // Checker name with icon\n      const statusIcon = hasIssues ? \"⚠️\" : \"✅\";\n      console.log(colors.bold(`  ${statusIcon}  ${stats.name}`));\n      console.log(colors.dim(\"  \" + \"─\".repeat(76)));\n\n      // Files summary\n      const filesLine = `     Files: ${colors.white(totalFiles.toString())} total  │  ${colors.green(\"✓ \" + stats.files.healthy)} healthy  │  ${hasIssues ? colors.red(\"✗ \" + stats.files.defective) : colors.dim(\"✗ 0\")} defective`;\n      console.log(filesLine);\n\n      // Issues summary\n      const warningsText =\n        stats.warnings.total > 0\n          ? colors.yellow(`⚠ ${stats.warnings.total} warnings`)\n          : colors.dim(\"⚠ 0 warnings\");\n\n      const errorsText =\n        stats.errors.total > 0\n          ? colors.red(`✗ ${stats.errors.total} errors`)\n          : colors.dim(\"✗ 0 errors\");\n\n      console.log(`     Issues: ${warningsText}  │  ${errorsText}`);\n\n      // Add spacing between checkers\n      if (index < allStats.length - 1) {\n        console.log(\"\");\n      }\n    });\n\n    console.log(\"\");\n    console.log(colors.bold(colors.cyan(\"━\".repeat(80))));\n    console.log(\"\");\n  }\n\n  /**\n   * Shutdown all workers\n   */\n  public async shutdown(): Promise<void> {\n    for (const [name, worker] of this.workers) {\n      try {\n        worker.postMessage({ type: \"shutdown\" });\n        await worker.terminate();\n      } catch {\n        // Worker may already be terminated\n      }\n    }\n\n    this.workers.clear();\n    this.workerInitPromises.clear();\n    this.checkerStats.clear();\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"files-healthcare.manager.mjs","names":[],"sources":["../../../../../../../../core/src/dev-server/health-checker/files-healthcare.manager.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { Worker } from \"worker_threads\";\nimport { createWorker } from \"../create-worker\";\nimport { devLogInfo } from \"../dev-logger\";\nimport type { FileManager } from \"../file-manager\";\nimport type {\n  FileHealthCheckerContract,\n  HealthCheckerFilesStats,\n} from \"./file-health-checker.contract\";\n\n/**\n * Serialized file data to send to workers\n */\ntype SerializedFile = {\n  path: string;\n  content: string;\n  relativePath: string;\n};\n\n/**\n * Diagnostic message from worker\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  ruleId?: string;\n};\n\n/**\n * File check result from worker\n */\ntype FileCheckResult = {\n  path: string;\n  relativePath: string;\n  healthy: boolean;\n  errors: DiagnosticMessage[];\n  warnings: DiagnosticMessage[];\n};\n\n/**\n * Worker response type\n */\ntype WorkerResponse =\n  | { type: \"initialized\"; success: boolean; hasConfig?: boolean; error?: string }\n  | { type: \"results\"; results: FileCheckResult[] }\n  | { type: \"error\"; message: string };\n\n/**\n * Files Healthcare Manager\n *\n * Manages health checkers for file validation during development.\n * Supports both main-thread and worker-based checkers.\n *\n * Checkers with `workerPath` run in dedicated worker threads for performance.\n * Checkers without `workerPath` run in the main thread.\n *\n * @example\n * ```typescript\n * const manager = new FilesHealthcareManager(files);\n *\n * manager.setHealthCheckers([\n *   new TypescriptHealthChecker(),  // Has workerPath → runs in worker\n *   new CustomChecker(),             // No workerPath → runs in main thread\n * ]);\n *\n * await manager.initialize();\n * await manager.validateAllFiles();\n * ```\n */\nexport class FilesHealthcareManager {\n  /**\n   * Registered health checkers\n   */\n  private healthCheckers: FileHealthCheckerContract[] = [];\n\n  /**\n   * Active worker instances (checkerName → Worker)\n   */\n  private workers = new Map<string, Worker>();\n\n  /**\n   * Worker initialization promises (for ensuring workers are ready)\n   */\n  private workerInitPromises = new Map<string, Promise<boolean>>();\n\n  /**\n   * Aggregated stats for each checker\n   */\n  private checkerStats = new Map<\n    string,\n    {\n      totalFiles: number;\n      healthyFiles: number;\n      defectiveFiles: number;\n      totalErrors: number;\n      totalWarnings: number;\n      filesWithErrors: number;\n      filesWithWarnings: number;\n    }\n  >();\n\n  /**\n   * Constructor\n   * @param files - Map of tracked files\n   */\n  public constructor(private readonly files: Map<string, FileManager>) {}\n\n  /**\n   * Add health checkers to the manager\n   * @param checkers - Checkers to add\n   */\n  public addHealthCheckers(...checkers: FileHealthCheckerContract[]): FilesHealthcareManager {\n    this.healthCheckers.push(...checkers);\n    return this;\n  }\n\n  /**\n   * Set (replace) all health checkers\n   * @param checkers - New set of checkers\n   */\n  public setHealthCheckers(checkers: FileHealthCheckerContract[]): FilesHealthcareManager {\n    this.healthCheckers = checkers;\n    return this;\n  }\n\n  /**\n   * Initialize all health checkers\n   *\n   * For checkers with `workerPath`, spawns dedicated worker threads.\n   * For other checkers, calls their `initialize()` method directly.\n   */\n  public async initialize(): Promise<void> {\n    const initPromises = this.healthCheckers.map(async (checker) => {\n      // Initialize stats for this checker\n      this.checkerStats.set(checker.name, {\n        totalFiles: 0,\n        healthyFiles: 0,\n        defectiveFiles: 0,\n        totalErrors: 0,\n        totalWarnings: 0,\n        filesWithErrors: 0,\n        filesWithWarnings: 0,\n      });\n\n      if (checker.workerPath) {\n        // Spawn dedicated worker for this checker\n        await this.spawnWorker(checker);\n      } else {\n        // Initialize checker on main thread\n        checker.initialize();\n      }\n    });\n\n    await Promise.all(initPromises);\n  }\n\n  /**\n   * Spawn a worker for a checker\n   */\n  private async spawnWorker(checker: FileHealthCheckerContract): Promise<void> {\n    if (!checker.workerPath) return;\n\n    const worker = createWorker(checker.workerPath, import.meta.url, {\n      workerData: { cwd: process.cwd() },\n    });\n\n    this.workers.set(checker.name, worker);\n\n    // Create init promise\n    const initPromise = new Promise<boolean>((resolve) => {\n      const handler = (response: WorkerResponse) => {\n        if (response.type === \"initialized\") {\n          worker.off(\"message\", handler);\n          resolve(response.success);\n        }\n      };\n\n      worker.on(\"message\", handler);\n\n      // Handle worker errors\n      worker.on(\"error\", (error) => {\n        console.error(`Health Checker Worker Error (${checker.name}):`, error);\n        resolve(false);\n      });\n\n      // Send init message\n      worker.postMessage({ type: \"init\", config: { cwd: process.cwd() } });\n    });\n\n    this.workerInitPromises.set(checker.name, initPromise);\n\n    // Wait for initialization\n    await initPromise;\n  }\n\n  /**\n   * Validate all tracked files\n   */\n  public async validateAllFiles(): Promise<void> {\n    const allFiles = Array.from(this.files.values());\n    await this.checkFiles(allFiles);\n\n    // Display stats\n    await this.displayStats();\n  }\n\n  /**\n   * Check the given files with all registered checkers\n   *\n   * All checkers run in parallel for performance.\n   * Worker-based checkers communicate via postMessage.\n   * Main-thread checkers are called directly.\n   */\n  public async checkFiles(files: FileManager[]): Promise<void> {\n    const checkPromises = this.healthCheckers.map(async (checker) => {\n      if (checker.workerPath) {\n        return this.runInWorker(checker.name, files);\n      } else {\n        return this.runInline(checker, files);\n      }\n    });\n\n    const results = await Promise.all(checkPromises);\n\n    // Display any errors/warnings\n    for (const checkerResults of results) {\n      for (const result of checkerResults) {\n        if (!result.healthy) {\n          this.displayFileResults(result);\n        }\n      }\n    }\n  }\n\n  /**\n   * Run checker in worker thread\n   */\n  private async runInWorker(checkerName: string, files: FileManager[]): Promise<FileCheckResult[]> {\n    const worker = this.workers.get(checkerName);\n\n    if (!worker) {\n      return files.map((f) => ({\n        path: f.absolutePath,\n        relativePath: f.relativePath,\n        healthy: true,\n        errors: [],\n        warnings: [],\n      }));\n    }\n\n    // Wait for worker to be initialized\n    const initPromise = this.workerInitPromises.get(checkerName);\n    if (initPromise) {\n      const success = await initPromise;\n      if (!success) {\n        return files.map((f) => ({\n          path: f.absolutePath,\n          relativePath: f.relativePath,\n          healthy: true,\n          errors: [],\n          warnings: [],\n        }));\n      }\n    }\n\n    // Serialize files for worker\n    const serializedFiles: SerializedFile[] = files.map((f) => ({\n      path: f.absolutePath,\n      content: f.source,\n      relativePath: f.relativePath,\n    }));\n\n    return new Promise((resolve) => {\n      const handler = (response: WorkerResponse) => {\n        if (response.type === \"results\") {\n          worker.off(\"message\", handler);\n\n          // Update stats\n          this.updateStats(checkerName, response.results);\n\n          resolve(response.results);\n        } else if (response.type === \"error\") {\n          worker.off(\"message\", handler);\n          resolve(\n            files.map((f) => ({\n              path: f.absolutePath,\n              relativePath: f.relativePath,\n              healthy: true,\n              errors: [],\n              warnings: [],\n            })),\n          );\n        }\n      };\n\n      worker.on(\"message\", handler);\n      worker.postMessage({ type: \"check\", files: serializedFiles });\n    });\n  }\n\n  /**\n   * Run checker inline (main thread)\n   */\n  private async runInline(\n    checker: FileHealthCheckerContract,\n    files: FileManager[],\n  ): Promise<FileCheckResult[]> {\n    const results: FileCheckResult[] = [];\n\n    for (const file of files) {\n      const healthResult = await checker.check(file);\n      const stats = healthResult.getStats();\n\n      results.push({\n        path: file.absolutePath,\n        relativePath: file.relativePath,\n        healthy: stats.state === \"healthy\",\n        errors: healthResult.messages\n          .filter((m) => m.type === \"error\")\n          .map((m) => ({\n            type: \"error\" as const,\n            message: m.message,\n            lineNumber: m.lineNumber,\n            columnNumber: m.columnNumber,\n            length: m.length || 1,\n            filePath: file.absolutePath,\n            relativePath: file.relativePath,\n            ruleId: m.ruleId,\n          })),\n        warnings: healthResult.messages\n          .filter((m) => m.type === \"warning\")\n          .map((m) => ({\n            type: \"warning\" as const,\n            message: m.message,\n            lineNumber: m.lineNumber,\n            columnNumber: m.columnNumber,\n            length: m.length || 1,\n            filePath: file.absolutePath,\n            relativePath: file.relativePath,\n            ruleId: m.ruleId,\n          })),\n      });\n    }\n\n    // Update stats\n    const checkerResults = results;\n    this.updateStats(checker.name, checkerResults);\n\n    return results;\n  }\n\n  /**\n   * Update aggregated stats for a checker\n   */\n  private updateStats(checkerName: string, results: FileCheckResult[]): void {\n    const stats = this.checkerStats.get(checkerName);\n    if (!stats) return;\n\n    for (const result of results) {\n      stats.totalFiles++;\n      if (result.healthy) {\n        stats.healthyFiles++;\n      } else {\n        stats.defectiveFiles++;\n      }\n      stats.totalErrors += result.errors.length;\n      stats.totalWarnings += result.warnings.length;\n      if (result.errors.length > 0) stats.filesWithErrors++;\n      if (result.warnings.length > 0) stats.filesWithWarnings++;\n    }\n  }\n\n  /**\n   * Detect when files are changed\n   */\n  public async onFileChanges(files: FileManager[]): Promise<void> {\n    // Notify workers of file changes\n    const serializedFiles: SerializedFile[] = files.map((f) => ({\n      path: f.absolutePath,\n      content: f.source,\n      relativePath: f.relativePath,\n    }));\n\n    for (const [, worker] of this.workers) {\n      worker.postMessage({ type: \"fileChanges\", files: serializedFiles });\n    }\n\n    // Notify inline checkers\n    await Promise.all(\n      this.healthCheckers.filter((c) => !c.workerPath).map((c) => c.onFileChanges(files)),\n    );\n  }\n\n  /**\n   * Remove files from tracking\n   * Notifies both inline checkers and worker-based checkers about removed files\n   */\n  public removeFiles(files: FileManager[]): void {\n    // Notify inline checkers\n    this.healthCheckers\n      .filter((c) => !c.workerPath)\n      .forEach((checker) => files.forEach((file) => checker.removeFile(file)));\n\n    // Notify workers about deleted files\n    if (files.length > 0) {\n      const deletedPaths = files.map((f) => ({\n        path: f.absolutePath,\n        relativePath: f.relativePath,\n      }));\n\n      for (const [, worker] of this.workers) {\n        worker.postMessage({ type: \"filesDeleted\", files: deletedPaths });\n      }\n    }\n  }\n\n  /**\n   * Display file results (errors/warnings)\n   */\n  private displayFileResults(result: FileCheckResult): void {\n    const fileName = result.relativePath.replace(/\\\\/g, \"/\");\n\n    // Display errors\n    for (const error of result.errors) {\n      const icon = colors.redBright(\"✖\");\n      const level = colors.redBright(colors.bold(\"ERROR\"));\n      console.log(\n        `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${error.lineNumber},${error.columnNumber})`)}`,\n      );\n      if (error.ruleId) {\n        console.log(\n          `  ${colors.magentaBright(error.ruleId)} ${colors.dim(\"→\")} ${colors.red(error.message)}`,\n        );\n      } else {\n        console.log(`  ${colors.dim(\"→\")} ${colors.red(error.message)}`);\n      }\n    }\n\n    // Display warnings\n    for (const warning of result.warnings) {\n      const icon = colors.yellowBright(\"⚠\");\n      const level = colors.yellowBright(colors.bold(\"WARNING\"));\n      console.log(\n        `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${warning.lineNumber},${warning.columnNumber})`)}`,\n      );\n      if (warning.ruleId) {\n        console.log(\n          `  ${colors.magentaBright(warning.ruleId)} ${colors.dim(\"→\")} ${colors.yellow(warning.message)}`,\n        );\n      } else {\n        console.log(`  ${colors.dim(\"→\")} ${colors.yellow(warning.message)}`);\n      }\n    }\n  }\n\n  /**\n   * Display stats for all health checkers\n   */\n  private async displayStats(): Promise<void> {\n    const allStats: HealthCheckerFilesStats[] = [];\n\n    for (const checker of this.healthCheckers) {\n      const stats = this.checkerStats.get(checker.name);\n      if (stats) {\n        allStats.push({\n          name: checker.name,\n          files: {\n            healthy: stats.healthyFiles,\n            defective: stats.defectiveFiles,\n          },\n          warnings: {\n            total: stats.totalWarnings,\n            totalFiles: stats.filesWithWarnings,\n          },\n          errors: {\n            total: stats.totalErrors,\n            totalFiles: stats.filesWithErrors,\n          },\n        });\n      }\n    }\n\n    console.log(\"\\n\");\n    console.log(colors.bold(colors.cyan(\"━\".repeat(80))));\n    devLogInfo(colors.bold(\"  📊 Health Checker Statistics\"));\n    console.log(colors.bold(colors.cyan(\"━\".repeat(80))));\n    console.log(\"\");\n\n    allStats.forEach((stats: HealthCheckerFilesStats, index: number) => {\n      const totalFiles = stats.files.healthy + stats.files.defective;\n      const hasIssues = stats.files.defective > 0;\n\n      // Checker name with icon\n      const statusIcon = hasIssues ? \"⚠️\" : \"✅\";\n      console.log(colors.bold(`  ${statusIcon}  ${stats.name}`));\n      console.log(colors.dim(\"  \" + \"─\".repeat(76)));\n\n      // Files summary\n      const filesLine = `     Files: ${colors.white(totalFiles.toString())} total  │  ${colors.green(\"✓ \" + stats.files.healthy)} healthy  │  ${hasIssues ? colors.red(\"✗ \" + stats.files.defective) : colors.dim(\"✗ 0\")} defective`;\n      console.log(filesLine);\n\n      // Issues summary\n      const warningsText =\n        stats.warnings.total > 0\n          ? colors.yellow(`⚠ ${stats.warnings.total} warnings`)\n          : colors.dim(\"⚠ 0 warnings\");\n\n      const errorsText =\n        stats.errors.total > 0\n          ? colors.red(`✗ ${stats.errors.total} errors`)\n          : colors.dim(\"✗ 0 errors\");\n\n      console.log(`     Issues: ${warningsText}  │  ${errorsText}`);\n\n      // Add spacing between checkers\n      if (index < allStats.length - 1) {\n        console.log(\"\");\n      }\n    });\n\n    console.log(\"\");\n    console.log(colors.bold(colors.cyan(\"━\".repeat(80))));\n    console.log(\"\");\n  }\n\n  /**\n   * Shutdown all workers\n   */\n  public async shutdown(): Promise<void> {\n    for (const [name, worker] of this.workers) {\n      try {\n        worker.postMessage({ type: \"shutdown\" });\n        await worker.terminate();\n      } catch {\n        // Worker may already be terminated\n      }\n    }\n\n    this.workers.clear();\n    this.workerInitPromises.clear();\n    this.checkerStats.clear();\n  }\n}\n"],"mappings":"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"}

package/esm/dev-server/layer-executor.mjs

@@ -38,10 +38,13 @@ var LayerExecutor = class {
 		}
 		if (changedPaths.length === 0 && envFilesChanged) {
 			const configPaths = await this.reloadAffectedModules([".env"], filesMap);
-			await this.restartAffectedConnectors(configPaths);
+			await this.restartAffectedConnectors([...deletedFiles, ...configPaths]);
+			return;
+		}
+		if (changedPaths.length === 0) {
+			await this.restartAffectedConnectors(deletedFiles);
 			return;
 		}
-		if (changedPaths.length === 0) return;
 		const invalidationChain = /* @__PURE__ */ new Set();
 		for (const path of changedPaths) {
 			for (const file of this.dependencyGraph.getInvalidationChain(path)) invalidationChain.add(file);
@@ -57,7 +60,11 @@ var LayerExecutor = class {
 		}
 		await this.flushVersionBumps();
 		const affectedConfigPaths = await this.reloadAffectedModules(chain, filesMap);
-		await this.restartAffectedConnectors([...changedPaths, ...affectedConfigPaths]);
+		await this.restartAffectedConnectors([
+			...changedPaths,
+			...deletedFiles,
+			...affectedConfigPaths
+		]);
 	}
 	async restartAffectedConnectors(affectedFiles) {
 		const toRestart = connectorsManager.list().filter((connector) => connector.shouldRestart(affectedFiles));

package/esm/dev-server/layer-executor.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"layer-executor.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/layer-executor.ts"],"sourcesContent":["import { loadEnv } from \"@mongez/dotenv\";\r\nimport { configManager } from \"../config/config-manager\";\r\nimport { connectorsManager } from \"../connectors/connectors-manager\";\r\nimport type { DependencyGraph } from \"./dependency-graph\";\r\nimport { devLogHMR } from \"./dev-logger\";\r\nimport { FileManager } from \"./file-manager\";\r\nimport type { ModuleLoader } from \"./module-loader\";\r\nimport type { SpecialFilesCollector } from \"./special-files-collector\";\r\nimport { environmentLoaderOptions } from \"../utils/load-environment\";\r\n\r\n/**\r\n * Decides what to reload when a batch of files changes.\r\n *\r\n * Strategy: bump the hook's version counter for every file in the\r\n * invalidation chain, wait for the hook worker to flush, then re-import\r\n * any special files (config / main / routes / events / locales) the chain\r\n * touched and restart any connector whose watched-files overlap the change.\r\n */\r\nexport class LayerExecutor {\r\n  public constructor(\r\n    private readonly dependencyGraph: DependencyGraph,\r\n    private readonly specialFilesCollector: SpecialFilesCollector,\r\n    private readonly moduleLoader: ModuleLoader,\r\n    private readonly bumpVersion: (absolutePath: string) => void,\r\n    private readonly flushVersionBumps: () => Promise<void>,\r\n  ) {}\r\n\r\n  /**\r\n   * Entry point for the file watcher batch.\r\n   *\r\n   * @param changedPaths - code files added or changed in this batch\r\n   * @param filesMap - all tracked files (relativePath → FileManager)\r\n   * @param deletedFiles - paths that were removed from disk\r\n   * @param allChangedPaths - includes .env so we can detect config reloads\r\n   */\r\n  public async executeBatchReload(\r\n    changedPaths: string[],\r\n    filesMap: Map<string, FileManager>,\r\n    deletedFiles: string[],\r\n    allChangedPaths?: string[],\r\n  ): Promise<void> {\r\n    const envFilesChanged = (allChangedPaths ?? []).some(isEnvPath);\r\n\r\n    if (changedPaths.length === 0 && deletedFiles.length === 0 && !envFilesChanged) {\r\n      return;\r\n    }\r\n\r\n    // Deletes: clean up routes/cleanup hooks for files that no longer exist.\r\n    for (const path of deletedFiles) {\r\n      const file = filesMap.get(path);\r\n      if (file) this.moduleLoader.cleanupDeletedModule(file);\r\n    }\r\n\r\n    // Env-only change: reload all configs, restart connectors that watch them.\r\n    if (changedPaths.length === 0 && envFilesChanged) {\r\n      const configPaths = await this.reloadAffectedModules([\".env\"], filesMap);\r\n      await this.restartAffectedConnectors(configPaths);\r\n      return;\r\n    }\r\n\r\n    if (changedPaths.length === 0) return;\r\n\r\n    const invalidationChain = new Set<string>();\r\n    for (const path of changedPaths) {\r\n      for (const file of this.dependencyGraph.getInvalidationChain(path)) {\r\n        invalidationChain.add(file);\r\n      }\r\n      devLogHMR(path, invalidationChain.size - 1);\r\n    }\r\n\r\n    const chain = Array.from(invalidationChain);\r\n\r\n    // Step 1: bump version counters so the next import() is fresh.\r\n    for (const relativePath of chain) {\r\n      const file = filesMap.get(relativePath);\r\n      if (!file) continue;\r\n      this.moduleLoader.runCleanup(file);\r\n      this.bumpVersion(file.absolutePath);\r\n      await file.process({ force: true });\r\n    }\r\n\r\n    // Step 2: wait for the hook worker to ack every bump.\r\n    // Without this, resolve() may still return the old ?v=N URL.\r\n    await this.flushVersionBumps();\r\n\r\n    // Step 3: re-import affected special files.\r\n    const affectedConfigPaths = await this.reloadAffectedModules(chain, filesMap);\r\n\r\n    // Step 4: restart any connector whose watched-files overlap the chain.\r\n    await this.restartAffectedConnectors([...changedPaths, ...affectedConfigPaths]);\r\n  }\r\n\r\n  private async restartAffectedConnectors(affectedFiles: string[]): Promise<void> {\r\n    const toRestart = connectorsManager\r\n      .list()\r\n      .filter(connector => connector.shouldRestart(affectedFiles));\r\n\r\n    for (const connector of toRestart) {\r\n      await connector.restart();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Re-import every special file whose path or dependency-set intersects the\r\n   * invalidation chain. Returns the relative paths of any config files that\r\n   * reloaded so the caller can pass them to the connector-restart pass.\r\n   */\r\n  private async reloadAffectedModules(\r\n    chain: string[],\r\n    filesMap: Map<string, FileManager>,\r\n  ): Promise<string[]> {\r\n    const isEnvAffected = chain.some(isEnvPath);\r\n    // Same precedence policy as the boot-time load: an exported variable is not\r\n    // demoted to the file's value just because the file was touched.\r\n    if (isEnvAffected) await loadEnv(undefined, environmentLoaderOptions);\r\n\r\n    const isAffected = (file: FileManager) => isFileAffected(file, chain);\r\n\r\n    // Models self-register via the @RegisterModel decorator and rely on the\r\n    // module-loader's registerCleanup() to attach Model.$cleanup (which\r\n    // unregisters them on the next reload). That only happens inside\r\n    // loadModule(), which models hit exactly once — at boot, via\r\n    // autoDiscoverFiles. During HMR they're otherwise re-imported\r\n    // *transitively* through routes, which never re-runs registerCleanup, so\r\n    // after the first reload the cleanup list is empty and the registration\r\n    // leaks (\"Model X is already registered\" on every subsequent edit).\r\n    //\r\n    // Re-importing changed model files through loadModule here re-attaches\r\n    // $cleanup every cycle. It runs before the route pass so the decorator\r\n    // registers once; the transitive route import then hits the cached ?v=N\r\n    // and does not double-register.\r\n    const affectedModels = chain\r\n      .map(path => filesMap.get(path))\r\n      .filter((file): file is FileManager => !!file && file.type === \"model\");\r\n\r\n    for (const file of affectedModels) {\r\n      await this.moduleLoader.loadModule(file, \"model\");\r\n    }\r\n\r\n    const collector = this.specialFilesCollector;\r\n    const affectedConfigs = collector\r\n      .getFilesByType(\"config\")\r\n      .filter(file => (isEnvAffected ? true : isAffected(file)));\r\n    const affectedMains = collector.getFilesByType(\"main\").filter(isAffected);\r\n    const affectedRoutes = collector.getFilesByType(\"route\").filter(isAffected);\r\n    const affectedEvents = collector.getFilesByType(\"event\").filter(isAffected);\r\n    const affectedLocales = collector.getFilesByType(\"locale\").filter(isAffected);\r\n\r\n    const hasSpecialFiles =\r\n      affectedConfigs.length > 0 ||\r\n      affectedMains.length > 0 ||\r\n      affectedRoutes.length > 0 ||\r\n      affectedEvents.length > 0 ||\r\n      affectedLocales.length > 0;\r\n\r\n    // No entry points touched: reloading internal files alone is wasted work\r\n    // because the hook will re-import them on next access anyway. But the\r\n    // dep chain's last hop is usually the user-facing edge — give it a kick.\r\n    if (!hasSpecialFiles) {\r\n      const tail = filesMap.get(chain[chain.length - 1]);\r\n      if (tail) await this.moduleLoader.reloadModule(tail);\r\n      return [];\r\n    }\r\n\r\n    const configPaths: string[] = [];\r\n    for (const file of affectedConfigs) {\r\n      await configManager.reload(file);\r\n      configPaths.push(file.relativePath);\r\n    }\r\n\r\n    // Order matters: locales first (translations used by main), main before\r\n    // routes (registers state routes consume), events between (listeners).\r\n    for (const file of affectedLocales) await this.moduleLoader.reloadModule(file);\r\n    for (const file of affectedMains) await this.moduleLoader.reloadModule(file);\r\n    for (const file of affectedEvents) await this.moduleLoader.reloadModule(file);\r\n    for (const file of affectedRoutes) await this.moduleLoader.reloadModule(file);\r\n\r\n    return configPaths;\r\n  }\r\n}\r\n\r\nfunction isEnvPath(path: string): boolean {\r\n  const basename = path.split(\"/\").pop() ?? path;\r\n  return basename === \".env\" || basename.startsWith(\".env.\");\r\n}\r\n\r\n/**\r\n * A file is \"affected\" if it itself is in the chain or imports something in it.\r\n */\r\nfunction isFileAffected(file: FileManager, chain: string[]): boolean {\r\n  if (chain.includes(file.relativePath)) return true;\r\n  for (const dep of file.dependencies) {\r\n    if (chain.includes(dep)) return true;\r\n  }\r\n  return false;\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"layer-executor.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/layer-executor.ts"],"sourcesContent":["import { loadEnv } from \"@mongez/dotenv\";\r\nimport { configManager } from \"../config/config-manager\";\r\nimport { connectorsManager } from \"../connectors/connectors-manager\";\r\nimport type { DependencyGraph } from \"./dependency-graph\";\r\nimport { devLogHMR } from \"./dev-logger\";\r\nimport { FileManager } from \"./file-manager\";\r\nimport type { ModuleLoader } from \"./module-loader\";\r\nimport type { SpecialFilesCollector } from \"./special-files-collector\";\r\nimport { environmentLoaderOptions } from \"../utils/load-environment\";\r\n\r\n/**\r\n * Decides what to reload when a batch of files changes.\r\n *\r\n * Strategy: bump the hook's version counter for every file in the\r\n * invalidation chain, wait for the hook worker to flush, then re-import\r\n * any special files (config / main / routes / events / locales) the chain\r\n * touched and restart any connector whose watched-files overlap the change.\r\n */\r\nexport class LayerExecutor {\r\n  public constructor(\r\n    private readonly dependencyGraph: DependencyGraph,\r\n    private readonly specialFilesCollector: SpecialFilesCollector,\r\n    private readonly moduleLoader: ModuleLoader,\r\n    private readonly bumpVersion: (absolutePath: string) => void,\r\n    private readonly flushVersionBumps: () => Promise<void>,\r\n  ) {}\r\n\r\n  /**\r\n   * Entry point for the file watcher batch.\r\n   *\r\n   * @param changedPaths - code files added or changed in this batch\r\n   * @param filesMap - all tracked files (relativePath → FileManager)\r\n   * @param deletedFiles - paths that were removed from disk\r\n   * @param allChangedPaths - includes .env so we can detect config reloads\r\n   */\r\n  public async executeBatchReload(\r\n    changedPaths: string[],\r\n    filesMap: Map<string, FileManager>,\r\n    deletedFiles: string[],\r\n    allChangedPaths?: string[],\r\n  ): Promise<void> {\r\n    const envFilesChanged = (allChangedPaths ?? []).some(isEnvPath);\r\n\r\n    if (changedPaths.length === 0 && deletedFiles.length === 0 && !envFilesChanged) {\r\n      return;\r\n    }\r\n\r\n    // Deletes: clean up routes/cleanup hooks for files that no longer exist.\r\n    for (const path of deletedFiles) {\r\n      const file = filesMap.get(path);\r\n      if (file) this.moduleLoader.cleanupDeletedModule(file);\r\n    }\r\n\r\n    // Env-only change: reload all configs, restart connectors that watch them.\n    if (changedPaths.length === 0 && envFilesChanged) {\n      const configPaths = await this.reloadAffectedModules([\".env\"], filesMap);\n      await this.restartAffectedConnectors([...deletedFiles, ...configPaths]);\n      return;\n    }\n\n    if (changedPaths.length === 0) {\n      await this.restartAffectedConnectors(deletedFiles);\n      return;\n    }\n\r\n    const invalidationChain = new Set<string>();\r\n    for (const path of changedPaths) {\r\n      for (const file of this.dependencyGraph.getInvalidationChain(path)) {\r\n        invalidationChain.add(file);\r\n      }\r\n      devLogHMR(path, invalidationChain.size - 1);\r\n    }\r\n\r\n    const chain = Array.from(invalidationChain);\r\n\r\n    // Step 1: bump version counters so the next import() is fresh.\r\n    for (const relativePath of chain) {\r\n      const file = filesMap.get(relativePath);\r\n      if (!file) continue;\r\n      this.moduleLoader.runCleanup(file);\r\n      this.bumpVersion(file.absolutePath);\r\n      await file.process({ force: true });\r\n    }\r\n\r\n    // Step 2: wait for the hook worker to ack every bump.\r\n    // Without this, resolve() may still return the old ?v=N URL.\r\n    await this.flushVersionBumps();\r\n\r\n    // Step 3: re-import affected special files.\r\n    const affectedConfigPaths = await this.reloadAffectedModules(chain, filesMap);\n\n    // Step 4: restart any connector whose watched-files overlap the chain.\n    await this.restartAffectedConnectors([\n      ...changedPaths,\n      ...deletedFiles,\n      ...affectedConfigPaths,\n    ]);\n  }\n\r\n  private async restartAffectedConnectors(affectedFiles: string[]): Promise<void> {\r\n    const toRestart = connectorsManager\r\n      .list()\r\n      .filter(connector => connector.shouldRestart(affectedFiles));\r\n\r\n    for (const connector of toRestart) {\r\n      await connector.restart();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Re-import every special file whose path or dependency-set intersects the\r\n   * invalidation chain. Returns the relative paths of any config files that\r\n   * reloaded so the caller can pass them to the connector-restart pass.\r\n   */\r\n  private async reloadAffectedModules(\r\n    chain: string[],\r\n    filesMap: Map<string, FileManager>,\r\n  ): Promise<string[]> {\r\n    const isEnvAffected = chain.some(isEnvPath);\r\n    // Same precedence policy as the boot-time load: an exported variable is not\r\n    // demoted to the file's value just because the file was touched.\r\n    if (isEnvAffected) await loadEnv(undefined, environmentLoaderOptions);\r\n\r\n    const isAffected = (file: FileManager) => isFileAffected(file, chain);\r\n\r\n    // Models self-register via the @RegisterModel decorator and rely on the\r\n    // module-loader's registerCleanup() to attach Model.$cleanup (which\r\n    // unregisters them on the next reload). That only happens inside\r\n    // loadModule(), which models hit exactly once — at boot, via\r\n    // autoDiscoverFiles. During HMR they're otherwise re-imported\r\n    // *transitively* through routes, which never re-runs registerCleanup, so\r\n    // after the first reload the cleanup list is empty and the registration\r\n    // leaks (\"Model X is already registered\" on every subsequent edit).\r\n    //\r\n    // Re-importing changed model files through loadModule here re-attaches\r\n    // $cleanup every cycle. It runs before the route pass so the decorator\r\n    // registers once; the transitive route import then hits the cached ?v=N\r\n    // and does not double-register.\r\n    const affectedModels = chain\r\n      .map(path => filesMap.get(path))\r\n      .filter((file): file is FileManager => !!file && file.type === \"model\");\r\n\r\n    for (const file of affectedModels) {\r\n      await this.moduleLoader.loadModule(file, \"model\");\r\n    }\r\n\r\n    const collector = this.specialFilesCollector;\r\n    const affectedConfigs = collector\r\n      .getFilesByType(\"config\")\r\n      .filter(file => (isEnvAffected ? true : isAffected(file)));\r\n    const affectedMains = collector.getFilesByType(\"main\").filter(isAffected);\r\n    const affectedRoutes = collector.getFilesByType(\"route\").filter(isAffected);\r\n    const affectedEvents = collector.getFilesByType(\"event\").filter(isAffected);\r\n    const affectedLocales = collector.getFilesByType(\"locale\").filter(isAffected);\r\n\r\n    const hasSpecialFiles =\r\n      affectedConfigs.length > 0 ||\r\n      affectedMains.length > 0 ||\r\n      affectedRoutes.length > 0 ||\r\n      affectedEvents.length > 0 ||\r\n      affectedLocales.length > 0;\r\n\r\n    // No entry points touched: reloading internal files alone is wasted work\r\n    // because the hook will re-import them on next access anyway. But the\r\n    // dep chain's last hop is usually the user-facing edge — give it a kick.\r\n    if (!hasSpecialFiles) {\r\n      const tail = filesMap.get(chain[chain.length - 1]);\r\n      if (tail) await this.moduleLoader.reloadModule(tail);\r\n      return [];\r\n    }\r\n\r\n    const configPaths: string[] = [];\r\n    for (const file of affectedConfigs) {\r\n      await configManager.reload(file);\r\n      configPaths.push(file.relativePath);\r\n    }\r\n\r\n    // Order matters: locales first (translations used by main), main before\r\n    // routes (registers state routes consume), events between (listeners).\r\n    for (const file of affectedLocales) await this.moduleLoader.reloadModule(file);\r\n    for (const file of affectedMains) await this.moduleLoader.reloadModule(file);\r\n    for (const file of affectedEvents) await this.moduleLoader.reloadModule(file);\r\n    for (const file of affectedRoutes) await this.moduleLoader.reloadModule(file);\r\n\r\n    return configPaths;\r\n  }\r\n}\r\n\r\nfunction isEnvPath(path: string): boolean {\r\n  const basename = path.split(\"/\").pop() ?? path;\r\n  return basename === \".env\" || basename.startsWith(\".env.\");\r\n}\r\n\r\n/**\r\n * A file is \"affected\" if it itself is in the chain or imports something in it.\r\n */\r\nfunction isFileAffected(file: FileManager, chain: string[]): boolean {\r\n  if (chain.includes(file.relativePath)) return true;\r\n  for (const dep of file.dependencies) {\r\n    if (chain.includes(dep)) return true;\r\n  }\r\n  return false;\r\n}\r\n"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"hook-thread.d.mts","names":[],"sources":["../../../../../../../../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":["../../../../../../../../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,CAAA;EAAa,IAAA;EAAM,OAAA;EAAS;AAAA,GAAa,cAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"own-resolver.mjs","names":[],"sources":["../../../../../../../../core/src/dev-server/loader/own-resolver.ts"],"sourcesContent":["import { fileURLToPath, pathToFileURL, URL } from \"node:url\";\n\n/**\n * The framework's own ESM `resolve()` core — the Phase B replacement for\n * delegating resolution to tsx.\n *\n * Scope by design: it owns exactly what Node's default resolver cannot do\n * (TypeScript extension/`index` probing and tsconfig `paths` aliases). For\n * anything else — bare npm packages, `node:` builtins, `file:`/`data:`\n * specifiers — it returns `null`, meaning \"not mine, fall through to the\n * next resolver\" (Node default, which already honours `node_modules` and\n * package `exports`). That keeps the risky surface minimal: we only have\n * to reproduce tsx's TS-path behaviour, not re-implement npm resolution.\n *\n * Pure and dependency-injected (`pathsMatcher`, `fileExists`) so the whole\n * thing is unit-testable and verifiable against the captured tsx-4.21\n * golden fixture without booting.\n */\n\nexport type PathsMatcher = (specifier: string) => string[];\nexport type FileExists = (absolutePath: string) => boolean;\n\n/**\n * Extension/`index` probing for one candidate base path, mirroring tsx's\n * TypeScript-aware order:\n *\n * 1. exact (if it already has a real extension that exists)\n * 2. `.js`/`.jsx`/`.mjs`/`.cjs` specifier → the TS source it compiles from\n *    (`.ts`/`.tsx`) — the standard \"import the .js, ship the .ts\" ESM style\n * 3. append `.ts`, `.tsx`, `.js`, `.jsx`, `.json`\n * 4. directory index: `<dir>/index.{ts,tsx,js,jsx}`\n *\n * Returns the resolved absolute path, or `null` if nothing exists.\n */\nexport function probeFile(basePath: string, fileExists: FileExists): string | null {\n  // 2. `.js` → `.ts`/`.tsx` rewrite (checked before the literal .js so a\n  //    co-located source wins, matching tsx).\n  const jsRewrite = basePath.match(/\\.(js|jsx|mjs|cjs)$/);\n  if (jsRewrite) {\n    const stem = basePath.slice(0, -jsRewrite[0].length);\n    for (const ext of [\".ts\", \".tsx\"]) {\n      if (fileExists(stem + ext)) return stem + ext;\n    }\n  }\n\n  // 1. exact (real extension already present and on disk)\n  if (/\\.[a-z]+$/i.test(basePath) && fileExists(basePath)) {\n    return basePath;\n  }\n\n  // 3. append source/asset extensions\n  for (const ext of [\".ts\", \".tsx\", \".js\", \".jsx\", \".json\"]) {\n    if (fileExists(basePath + ext)) return basePath + ext;\n  }\n\n  // 4. directory index\n  for (const ext of [\".ts\", \".tsx\", \".js\", \".jsx\"]) {\n    const candidate = `${basePath}/index${ext}`;\n    if (fileExists(candidate)) return candidate;\n  }\n\n  return null;\n}\n\nfunction isRelative(specifier: string): boolean {\n  return specifier.startsWith(\"./\") || specifier.startsWith(\"../\");\n}\n\n/**\n * Resolve `specifier` to a `file://` URL we own, or `null` to fall through\n * to the next resolver.\n *\n * @param specifier  - The import specifier.\n * @param parentURL  - Importing module's URL (already `?v=N`-stripped).\n * @param pathsMatcher - `get-tsconfig` paths matcher (alias → candidates).\n * @param fileExists - Existence probe (injected for testing).\n */\nexport function ownResolve(\n  specifier: string,\n  parentURL: string | undefined,\n  pathsMatcher: PathsMatcher | null,\n  fileExists: FileExists,\n): string | null {\n  // Not ours: builtins and already-formed URLs (config-loader imports by\n  // file: URL). Node default handles these.\n  if (\n    specifier.startsWith(\"node:\") ||\n    specifier.startsWith(\"file:\") ||\n    specifier.startsWith(\"data:\")\n  ) {\n    return null;\n  }\n\n  // Relative / absolute path imports → probe against the parent's dir.\n  if (isRelative(specifier) || specifier.startsWith(\"/\") || /^[a-zA-Z]:[\\\\/]/.test(specifier)) {\n    if (!parentURL) return null;\n    const base = fileURLToPath(new URL(specifier, parentURL));\n    const hit = probeFile(base.replace(/\\\\/g, \"/\"), fileExists);\n    return hit ? pathToFileURL(hit).href : null;\n  }\n\n  // Bare / aliased: try tsconfig `paths`. Each candidate is probed; the\n  // first that exists on disk wins. If none do (e.g. a real npm package\n  // whose name happened to match a baseUrl guess), return null so Node\n  // default resolves it from node_modules with full `exports` support.\n  if (pathsMatcher) {\n    for (const candidate of pathsMatcher(specifier)) {\n      const hit = probeFile(candidate.replace(/\\\\/g, \"/\"), fileExists);\n      if (hit) return pathToFileURL(hit).href;\n    }\n  }\n\n  return null;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAkCA,SAAgB,UAAU,UAAkB,YAAuC;CAGjF,MAAM,YAAY,SAAS,MAAM,qBAAqB;CACtD,IAAI,WAAW;EACb,MAAM,OAAO,SAAS,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC,MAAM;EACnD,KAAK,MAAM,OAAO,CAAC,OAAO,MAAM,GAC9B,IAAI,WAAW,OAAO,GAAG,GAAG,OAAO,OAAO;CAE9C;CAGA,IAAI,aAAa,KAAK,QAAQ,KAAK,WAAW,QAAQ,GACpD,OAAO;CAIT,KAAK,MAAM,OAAO;EAAC;EAAO;EAAQ;EAAO;EAAQ;CAAO,GACtD,IAAI,WAAW,WAAW,GAAG,GAAG,OAAO,WAAW;CAIpD,KAAK,MAAM,OAAO;EAAC;EAAO;EAAQ;EAAO;CAAM,GAAG;EAChD,MAAM,YAAY,GAAG,SAAS,QAAQ;EACtC,IAAI,WAAW,SAAS,GAAG,OAAO;CACpC;CAEA,OAAO;AACT;AAEA,SAAS,WAAW,WAA4B;CAC9C,OAAO,UAAU,WAAW,IAAI,KAAK,UAAU,WAAW,KAAK;AACjE;;;;;;;;;;AAWA,SAAgB,WACd,WACA,WACA,cACA,YACe;CAGf,IACE,UAAU,WAAW,OAAO,KAC5B,UAAU,WAAW,OAAO,KAC5B,UAAU,WAAW,OAAO,GAE5B,OAAO;CAIT,IAAI,WAAW,SAAS,KAAK,UAAU,WAAW,GAAG,KAAK,kBAAkB,KAAK,SAAS,GAAG;EAC3F,IAAI,CAAC,WAAW,OAAO;EAEvB,MAAM,MAAM,UADC,cAAc,IAAI,IAAI,WAAW,SAAS,CAC9B,CAAC,CAAC,QAAQ,OAAO,GAAG,GAAG,UAAU;EAC1D,OAAO,MAAM,cAAc,GAAG,CAAC,CAAC,OAAO;CACzC;CAMA,IAAI,cACF,KAAK,MAAM,aAAa,aAAa,SAAS,GAAG;EAC/C,MAAM,MAAM,UAAU,UAAU,QAAQ,OAAO,GAAG,GAAG,UAAU;EAC/D,IAAI,KAAK,OAAO,cAAc,GAAG,CAAC,CAAC;CACrC;CAGF,OAAO;AACT"}
+{"version":3,"file":"own-resolver.mjs","names":[],"sources":["../../../../../../../../core/src/dev-server/loader/own-resolver.ts"],"sourcesContent":["import { fileURLToPath, pathToFileURL, URL } from \"node:url\";\n\n/**\n * The framework's own ESM `resolve()` core — the Phase B replacement for\n * delegating resolution to tsx.\n *\n * Scope by design: it owns exactly what Node's default resolver cannot do\n * (TypeScript extension/`index` probing and tsconfig `paths` aliases). For\n * anything else — bare npm packages, `node:` builtins, `file:`/`data:`\n * specifiers — it returns `null`, meaning \"not mine, fall through to the\n * next resolver\" (Node default, which already honours `node_modules` and\n * package `exports`). That keeps the risky surface minimal: we only have\n * to reproduce tsx's TS-path behaviour, not re-implement npm resolution.\n *\n * Pure and dependency-injected (`pathsMatcher`, `fileExists`) so the whole\n * thing is unit-testable and verifiable against the captured tsx-4.21\n * golden fixture without booting.\n */\n\nexport type PathsMatcher = (specifier: string) => string[];\nexport type FileExists = (absolutePath: string) => boolean;\n\n/**\n * Extension/`index` probing for one candidate base path, mirroring tsx's\n * TypeScript-aware order:\n *\n * 1. exact (if it already has a real extension that exists)\n * 2. `.js`/`.jsx`/`.mjs`/`.cjs` specifier → the TS source it compiles from\n *    (`.ts`/`.tsx`) — the standard \"import the .js, ship the .ts\" ESM style\n * 3. append `.ts`, `.tsx`, `.js`, `.jsx`, `.json`\n * 4. directory index: `<dir>/index.{ts,tsx,js,jsx}`\n *\n * Returns the resolved absolute path, or `null` if nothing exists.\n */\nexport function probeFile(basePath: string, fileExists: FileExists): string | null {\n  // 2. `.js` → `.ts`/`.tsx` rewrite (checked before the literal .js so a\n  //    co-located source wins, matching tsx).\n  const jsRewrite = basePath.match(/\\.(js|jsx|mjs|cjs)$/);\n  if (jsRewrite) {\n    const stem = basePath.slice(0, -jsRewrite[0].length);\n    for (const ext of [\".ts\", \".tsx\"]) {\n      if (fileExists(stem + ext)) return stem + ext;\n    }\n  }\n\n  // 1. exact (real extension already present and on disk)\n  if (/\\.[a-z]+$/i.test(basePath) && fileExists(basePath)) {\n    return basePath;\n  }\n\n  // 3. append source/asset extensions\n  for (const ext of [\".ts\", \".tsx\", \".js\", \".jsx\", \".json\"]) {\n    if (fileExists(basePath + ext)) return basePath + ext;\n  }\n\n  // 4. directory index\n  for (const ext of [\".ts\", \".tsx\", \".js\", \".jsx\"]) {\n    const candidate = `${basePath}/index${ext}`;\n    if (fileExists(candidate)) return candidate;\n  }\n\n  return null;\n}\n\nfunction isRelative(specifier: string): boolean {\n  return specifier.startsWith(\"./\") || specifier.startsWith(\"../\");\n}\n\n/**\n * Resolve `specifier` to a `file://` URL we own, or `null` to fall through\n * to the next resolver.\n *\n * @param specifier  - The import specifier.\n * @param parentURL  - Importing module's URL (already `?v=N`-stripped).\n * @param pathsMatcher - `get-tsconfig` paths matcher (alias → candidates).\n * @param fileExists - Existence probe (injected for testing).\n */\nexport function ownResolve(\n  specifier: string,\n  parentURL: string | undefined,\n  pathsMatcher: PathsMatcher | null,\n  fileExists: FileExists,\n): string | null {\n  // Not ours: builtins and already-formed URLs (config-loader imports by\n  // file: URL). Node default handles these.\n  if (\n    specifier.startsWith(\"node:\") ||\n    specifier.startsWith(\"file:\") ||\n    specifier.startsWith(\"data:\")\n  ) {\n    return null;\n  }\n\n  // Relative / absolute path imports → probe against the parent's dir.\n  if (isRelative(specifier) || specifier.startsWith(\"/\") || /^[a-zA-Z]:[\\\\/]/.test(specifier)) {\n    if (!parentURL) return null;\n    const base = fileURLToPath(new URL(specifier, parentURL));\n    const hit = probeFile(base.replace(/\\\\/g, \"/\"), fileExists);\n    return hit ? pathToFileURL(hit).href : null;\n  }\n\n  // Bare / aliased: try tsconfig `paths`. Each candidate is probed; the\n  // first that exists on disk wins. If none do (e.g. a real npm package\n  // whose name happened to match a baseUrl guess), return null so Node\n  // default resolves it from node_modules with full `exports` support.\n  if (pathsMatcher) {\n    for (const candidate of pathsMatcher(specifier)) {\n      const hit = probeFile(candidate.replace(/\\\\/g, \"/\"), fileExists);\n      if (hit) return pathToFileURL(hit).href;\n    }\n  }\n\n  return null;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAkCA,SAAgB,UAAU,UAAkB,YAAuC;CAGjF,MAAM,YAAY,SAAS,MAAM,qBAAqB;CACtD,IAAI,WAAW;EACb,MAAM,OAAO,SAAS,MAAM,GAAG,CAAC,UAAU,GAAG,MAAM;EACnD,KAAK,MAAM,OAAO,CAAC,OAAO,MAAM,GAC9B,IAAI,WAAW,OAAO,GAAG,GAAG,OAAO,OAAO;CAE9C;CAGA,IAAI,aAAa,KAAK,QAAQ,KAAK,WAAW,QAAQ,GACpD,OAAO;CAIT,KAAK,MAAM,OAAO;EAAC;EAAO;EAAQ;EAAO;EAAQ;CAAO,GACtD,IAAI,WAAW,WAAW,GAAG,GAAG,OAAO,WAAW;CAIpD,KAAK,MAAM,OAAO;EAAC;EAAO;EAAQ;EAAO;CAAM,GAAG;EAChD,MAAM,YAAY,GAAG,SAAS,QAAQ;EACtC,IAAI,WAAW,SAAS,GAAG,OAAO;CACpC;CAEA,OAAO;AACT;AAEA,SAAS,WAAW,WAA4B;CAC9C,OAAO,UAAU,WAAW,IAAI,KAAK,UAAU,WAAW,KAAK;AACjE;;;;;;;;;;AAWA,SAAgB,WACd,WACA,WACA,cACA,YACe;CAGf,IACE,UAAU,WAAW,OAAO,KAC5B,UAAU,WAAW,OAAO,KAC5B,UAAU,WAAW,OAAO,GAE5B,OAAO;CAIT,IAAI,WAAW,SAAS,KAAK,UAAU,WAAW,GAAG,KAAK,kBAAkB,KAAK,SAAS,GAAG;EAC3F,IAAI,CAAC,WAAW,OAAO;EAEvB,MAAM,MAAM,UADC,cAAc,IAAI,IAAI,WAAW,SAAS,CAC9B,EAAE,QAAQ,OAAO,GAAG,GAAG,UAAU;EAC1D,OAAO,MAAM,cAAc,GAAG,EAAE,OAAO;CACzC;CAMA,IAAI,cACF,KAAK,MAAM,aAAa,aAAa,SAAS,GAAG;EAC/C,MAAM,MAAM,UAAU,UAAU,QAAQ,OAAO,GAAG,GAAG,UAAU;EAC/D,IAAI,KAAK,OAAO,cAAc,GAAG,EAAE;CACrC;CAGF,OAAO;AACT"}

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

@@ -1 +1 @@
-{"version":3,"file":"register-loader.mjs","names":[],"sources":["../../../../../../../../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(\n  transpile: TranspileInit,\n): 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(\n    path.dirname(selfPath),\n    `hook-thread${path.extname(selfPath)}`,\n  );\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,IAAG,SAAQ;GAG5C,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,eACpB,WACsB;CACtB,MAAM,EAAE,OAAO,UAAU,IAAI,eAAe;CAI5C,MAAM,WAAW,cAAc,OAAO,KAAK,GAAG;CAqB9C,MAAM,eAAc,MAfO,MAAM;EAC/B,aAAa,CANQ,KAAK,KAC1B,KAAK,QAAQ,QAAQ,GACrB,cAAc,KAAK,QAAQ,QAAQ,GAIR,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":["../../../../../../../../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(\n  transpile: TranspileInit,\n): 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(\n    path.dirname(selfPath),\n    `hook-thread${path.extname(selfPath)}`,\n  );\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,IAAG,SAAQ;GAG5C,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,eACpB,WACsB;CACtB,MAAM,EAAE,OAAO,UAAU,IAAI,eAAe;CAI5C,MAAM,WAAW,cAAc,OAAO,KAAK,GAAG;CAqB9C,MAAM,eAAc,MAfO,MAAM;EAC/B,aAAa,CANQ,KAAK,KAC1B,KAAK,QAAQ,QAAQ,GACrB,cAAc,KAAK,QAAQ,QAAQ,GAIR,CAAC;EAC5B,QAAQ;EACR,QAAQ;EACR,OAAO;EACP,UAAU;EACV,QAAQ;EAKR,UAAU;EACV,SAAS,CAAC,wBAAwB;CACpC,CAAC,GAEgC,YAAY,GAAG;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,EAAE,MAAM,OAAO,KAAK,KAAK;EAC5D,MAAM;GAAE,MAAM;GAAO;GAAS;EAAU;EACxC,cAAc,CAAC,KAAK;CACtB,CAAC;CAED,OAAO;AACT"}

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

@@ -1 +1 @@
-{"version":3,"file":"resolve-hook.mjs","names":[],"sources":["../../../../../../../../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 =\n    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(\n    specifier,\n    cleanContext.parentURL,\n    getPathsMatcher(),\n    existsSync,\n  );\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,eACJ,QAAQ,WAAW,SAAS,KAAK,IAC7B;EAAE,GAAG;EAAS,WAAW,QAAQ,UAAU,QAAQ,YAAY,EAAE;CAAE,IACnE;CAKN,MAAM,QAAQ,WACZ,WACA,aAAa,WACb,gBAAgB,GAChB,UACF;CAKA,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":["../../../../../../../../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 =\n    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(\n    specifier,\n    cleanContext.parentURL,\n    getPathsMatcher(),\n    existsSync,\n  );\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,EAAE,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,eACJ,QAAQ,WAAW,SAAS,KAAK,IAC7B;EAAE,GAAG;EAAS,WAAW,QAAQ,UAAU,QAAQ,YAAY,EAAE;CAAE,IACnE;CAKN,MAAM,QAAQ,WACZ,WACA,aAAa,WACb,gBAAgB,GAChB,UACF;CAKA,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"}

package/esm/dev-server/loader/source-slug.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"source-slug.mjs","names":[],"sources":["../../../../../../../../core/src/dev-server/loader/source-slug.ts"],"sourcesContent":["/**\n * Human-readable label for a cached transpile file, derived from the last\n * three path segments of the source file.\n *\n * Purely cosmetic: it rides in front of the content hash in the cache\n * filename so `ls .warlock/transpile/<shard>/` is browsable when debugging.\n * It is **never** used as a cache key, module URL, or source-map\n * `sourcefile` — correctness still rests entirely on the content hash, so\n * the slug is allowed to be lossy (sanitised, capped).\n *\n * @example\n *   sourceSlug(\"D:/proj/src/app/vectors/utils/locales.ts\")\n *   // → \"vectors-utils-locales\"\n */\nexport function sourceSlug(absolutePath: string): string {\n  const noExt = absolutePath.replace(/\\\\/g, \"/\").replace(/\\.[cm]?[jt]sx?$/, \"\");\n\n  const slug = noExt\n    .split(\"/\")\n    .filter(Boolean)\n    .slice(-3)\n    .join(\"-\")\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n\n  // The hash guarantees uniqueness; the slug is just a label, so capping it\n  // is safe and keeps total path length sane on deep trees / Windows.\n  return slug.slice(0, 60) || \"src\";\n}\n"],"mappings":";;;;;;;;;;;;;;;AAcA,SAAgB,WAAW,cAA8B;CAcvD,OAbc,aAAa,QAAQ,OAAO,GAAG,CAAC,CAAC,QAAQ,mBAAmB,EAEzD,CAAC,CACf,MAAM,GAAG,CAAC,CACV,OAAO,OAAO,CAAC,CACf,MAAM,EAAE,CAAC,CACT,KAAK,GAAG,CAAC,CACT,YAAY,CAAC,CACb,QAAQ,eAAe,GAAG,CAAC,CAC3B,QAAQ,YAAY,EAIb,CAAC,CAAC,MAAM,GAAG,EAAE,KAAK;AAC9B"}
+{"version":3,"file":"source-slug.mjs","names":[],"sources":["../../../../../../../../core/src/dev-server/loader/source-slug.ts"],"sourcesContent":["/**\n * Human-readable label for a cached transpile file, derived from the last\n * three path segments of the source file.\n *\n * Purely cosmetic: it rides in front of the content hash in the cache\n * filename so `ls .warlock/transpile/<shard>/` is browsable when debugging.\n * It is **never** used as a cache key, module URL, or source-map\n * `sourcefile` — correctness still rests entirely on the content hash, so\n * the slug is allowed to be lossy (sanitised, capped).\n *\n * @example\n *   sourceSlug(\"D:/proj/src/app/vectors/utils/locales.ts\")\n *   // → \"vectors-utils-locales\"\n */\nexport function sourceSlug(absolutePath: string): string {\n  const noExt = absolutePath.replace(/\\\\/g, \"/\").replace(/\\.[cm]?[jt]sx?$/, \"\");\n\n  const slug = noExt\n    .split(\"/\")\n    .filter(Boolean)\n    .slice(-3)\n    .join(\"-\")\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n\n  // The hash guarantees uniqueness; the slug is just a label, so capping it\n  // is safe and keeps total path length sane on deep trees / Windows.\n  return slug.slice(0, 60) || \"src\";\n}\n"],"mappings":";;;;;;;;;;;;;;;AAcA,SAAgB,WAAW,cAA8B;CAcvD,OAbc,aAAa,QAAQ,OAAO,GAAG,EAAE,QAAQ,mBAAmB,EAEzD,EACd,MAAM,GAAG,EACT,OAAO,OAAO,EACd,MAAM,EAAE,EACR,KAAK,GAAG,EACR,YAAY,EACZ,QAAQ,eAAe,GAAG,EAC1B,QAAQ,YAAY,EAIb,EAAE,MAAM,GAAG,EAAE,KAAK;AAC9B"}

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

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { createHash } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
 import { mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 
 //#region ../core/src/dev-server/loader/transpile-cache.ts
@@ -118,15 +118,24 @@ var TranspileCache = class {
 		if (entry.map) this.atomicWrite(this.mapPath(key, label), entry.map);
 	}
 	atomicWrite(filePath, content) {
-		const tempPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+		const tempPath = `${filePath}.${process.pid}.${randomUUID()}.tmp`;
 		try {
 			writeFileSync(tempPath, content);
 			renameSync(tempPath, filePath);
 		} catch (error) {
+			const code = error.code;
+			if (!(code === "EEXIST" || code === "EPERM" || code === "EACCES") || !this.hasCommittedContent(filePath, content)) throw error;
+		} finally {
 			try {
 				rmSync(tempPath, { force: true });
 			} catch {}
-			throw error;
+		}
+	}
+	hasCommittedContent(filePath, content) {
+		try {
+			return readFileSync(filePath, "utf8") === content;
+		} catch {
+			return false;
 		}
 	}
 	/**

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

@@ -1 +1 @@
-{"version":3,"file":"transpile-cache.mjs","names":[],"sources":["../../../../../../../../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 } 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\")\n    .update(sourceText)\n    .update(\"\\0\")\n    .update(fingerprint)\n    .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}.${Date.now()}.tmp`;\n    try {\n      writeFileSync(tempPath, content);\n      renameSync(tempPath, filePath);\n    } catch (error) {\n      try {\n        rmSync(tempPath, { force: true });\n      } catch {\n        // best effort — original error is the one that matters\n      }\n      throw error;\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":["../../../../../../../../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\")\n    .update(sourceText)\n    .update(\"\\0\")\n    .update(fingerprint)\n    .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 =\n        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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgFA,SAAS,gBAAgB,OAAwB;CAC/C,IAAI,UAAU,QAAQ,OAAO,UAAU,UACrC,OAAO,KAAK,UAAU,KAAK,KAAK;CAGlC,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,IAAI,MAAM,IAAI,eAAe,EAAE,KAAK,GAAG,EAAE;CAUlD,OAAO,IAPS,OAAO,KAAK,KAAgC,EACzD,KAAK,EACL,KAAI,QAAO;EACV,MAAM,QAAQ,gBAAiB,MAAkC,IAAI;EACrE,OAAO,GAAG,KAAK,UAAU,GAAG,EAAE,GAAG;CACnC,CAEe,EAAE,KAAK,GAAG,EAAE;AAC/B;;;;;AAMA,SAAgB,mBAAmB,OAAiC;CAClE,MAAM,YAAY,gBAAgB;EAChC,gBAAgB,MAAM;EACtB,YAAY,MAAM;EAClB,iBAAiB,MAAM;CACzB,CAAC;CAED,OAAO,WAAW,QAAQ,EAAE,OAAO,SAAS,EAAE,OAAO,KAAK,EAAE,MAAM,GAAG,EAAE;AACzE;;;;;AAMA,SAAgB,SAAS,YAAoB,aAA6B;CACxE,OAAO,WAAW,QAAQ,EACvB,OAAO,UAAU,EACjB,OAAO,IAAI,EACX,OAAO,WAAW,EAClB,OAAO,KAAK;AACjB;;;;;;;;;AAyBA,IAAa,iBAAb,MAA4B;CAC1B,AAAO,YAAY,AAAiB,UAAkB;EAAlB;CAAmB;CAEvD,AAAQ,SAAS,KAAqB;EACpC,OAAO,KAAK,KAAK,KAAK,UAAU,IAAI,MAAM,GAAG,CAAC,CAAC;CACjD;;;;;;CAOA,AAAQ,SAAS,KAAa,OAA2B,KAAqB;EAC5E,OAAO,QAAQ,GAAG,MAAM,GAAG,MAAM,QAAQ,GAAG,MAAM;CACpD;CAEA,AAAQ,SAAS,KAAa,OAAwB;EACpD,OAAO,KAAK,KAAK,KAAK,SAAS,GAAG,GAAG,KAAK,SAAS,KAAK,OAAO,KAAK,CAAC;CACvE;CAEA,AAAQ,QAAQ,KAAa,OAAwB;EACnD,OAAO,KAAK,KAAK,KAAK,SAAS,GAAG,GAAG,KAAK,SAAS,KAAK,OAAO,SAAS,CAAC;CAC3E;;;;;;CAOA,AAAO,IAAI,KAAa,OAAuC;EAC7D,IAAI;GACF,MAAM,OAAO,aAAa,KAAK,SAAS,KAAK,KAAK,GAAG,MAAM;GAC3D,IAAI,MAAM;GACV,IAAI;IACF,MAAM,aAAa,KAAK,QAAQ,KAAK,KAAK,GAAG,MAAM;GACrD,QAAQ,CAER;GACA,OAAO;IAAE;IAAM;GAAI;EACrB,QAAQ;GACN,OAAO;EACT;CACF;;;;;CAMA,AAAO,IAAI,KAAa,OAAuB,OAAsB;EAEnE,UADc,KAAK,SAAS,GACd,GAAG,EAAE,WAAW,KAAK,CAAC;EAEpC,KAAK,YAAY,KAAK,SAAS,KAAK,KAAK,GAAG,MAAM,IAAI;EACtD,IAAI,MAAM,KACR,KAAK,YAAY,KAAK,QAAQ,KAAK,KAAK,GAAG,MAAM,GAAG;CAExD;CAEA,AAAQ,YAAY,UAAkB,SAAuB;EAC3D,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,IAAI,GAAG,WAAW,EAAE;EAC5D,IAAI;GACF,cAAc,UAAU,OAAO;GAC/B,WAAW,UAAU,QAAQ;EAC/B,SAAS,OAAO;GAKd,MAAM,OAAQ,MAAgC;GAI9C,IAAI,EAFF,SAAS,YAAY,SAAS,WAAW,SAAS,aAEtB,CAAC,KAAK,oBAAoB,UAAU,OAAO,GACvE,MAAM;EAEV,UAAU;GACR,IAAI;IACF,OAAO,UAAU,EAAE,OAAO,KAAK,CAAC;GAClC,QAAQ,CAER;EACF;CACF;CAEA,AAAQ,oBAAoB,UAAkB,SAA0B;EACtE,IAAI;GACF,OAAO,aAAa,UAAU,MAAM,MAAM;EAC5C,QAAQ;GACN,OAAO;EACT;CACF;;;;;;;CAQA,AAAO,GAAG,UAAqB,CAAC,GAAS;EACvC,MAAM,EAAE,UAAU,aAAa;EAC/B,IAAI,aAAa,UAAa,aAAa,QAAW;EAEtD,MAAM,QAAQ,KAAK,KAAK;EACxB,MAAM,MAAM,KAAK,IAAI;EAErB,IAAI,OAAO;EAEX,IAAI,aAAa,QAAW;GAC1B,OAAO,CAAC;GACR,KAAK,MAAM,QAAQ,OACjB,IAAI,MAAM,KAAK,UAAU,UACvB,KAAK,MAAM,IAAI;QAEf,KAAK,KAAK,IAAI;EAGpB;EAEA,IAAI,aAAa,QAAW;GAC1B,IAAI,QAAQ,KAAK,QAAQ,KAAK,SAAS,MAAM,KAAK,MAAM,CAAC;GACzD,IAAI,QAAQ,UAAU;IAEpB,KAAK,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,OAAO;IACzC,KAAK,MAAM,QAAQ,MAAM;KACvB,IAAI,SAAS,UAAU;KACvB,SAAS,KAAK;KACd,KAAK,MAAM,IAAI;IACjB;GACF;EACF;CACF;CAEA,AAAQ,OAAwB;EAC9B,MAAM,SAA0B,CAAC;EAEjC,IAAI;EACJ,IAAI;GACF,SAAS,YAAY,KAAK,QAAQ;EACpC,QAAQ;GACN,OAAO;EACT;EAEA,KAAK,MAAM,SAAS,QAAQ;GAC1B,MAAM,YAAY,KAAK,KAAK,KAAK,UAAU,KAAK;GAChD,IAAI;GACJ,IAAI;IACF,UAAU,YAAY,SAAS;GACjC,QAAQ;IACN;GACF;GAEA,KAAK,MAAM,SAAS,SAAS;IAC3B,IAAI,CAAC,MAAM,SAAS,KAAK,GAAG;IAC5B,MAAM,WAAW,KAAK,KAAK,WAAW,KAAK;IAC3C,IAAI;KACF,MAAM,OAAO,SAAS,QAAQ;KAC9B,MAAM,UAAU,GAAG,SAAS;KAC5B,IAAI,UAAU;KACd,IAAI;MACF,UAAU,SAAS,OAAO,EAAE;KAC9B,QAAQ,CAER;KACA,OAAO,KAAK;MACV;MACA;MACA,MAAM,KAAK,OAAO;MAClB,SAAS,KAAK;KAChB,CAAC;IACH,QAAQ,CAER;GACF;EACF;EAEA,OAAO;CACT;CAEA,AAAQ,MAAM,MAA2B;EACvC,IAAI;GACF,OAAO,KAAK,UAAU,EAAE,OAAO,KAAK,CAAC;EACvC,QAAQ,CAER;EACA,IAAI;GACF,OAAO,KAAK,SAAS,EAAE,OAAO,KAAK,CAAC;EACtC,QAAQ,CAER;CACF;;CAGA,AAAO,QAAc;EACnB,IAAI;GACF,OAAO,KAAK,UAAU;IAAE,WAAW;IAAM,OAAO;GAAK,CAAC;EACxD,QAAQ,CAER;CACF;AACF"}

package/esm/dev-server/loader/version-registry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version-registry.mjs","names":[],"sources":["../../../../../../../../core/src/dev-server/loader/version-registry.ts"],"sourcesContent":["/**\n * Version registry for the ESM loader hook.\n *\n * Lives in the hook worker thread. The main thread sends bump messages via\n * MessageChannel; each bump increments the monotonic counter for that path,\n * which causes `resolve()` to produce a new URL — Node sees a fresh module.\n *\n * Monotonic integers are used instead of timestamps so there is no clock-drift\n * risk and the version is trivial to reason about during debugging.\n *\n * @example\n * // Hook worker receives a bump from the file watcher:\n * bumpVersion(\"/abs/path/to/user.model.ts\");\n * // → getVersion returns 1, resolve() appends ?v=1 to the URL\n */\n\nconst versionMap = new Map<string, number>();\n\n/**\n * Normalize a filesystem path to a single canonical form so the main thread\n * (which often holds forward-slash paths from posix-style joins) and the\n * hook worker (which gets backslash paths from `fileURLToPath` on Windows)\n * agree on map keys.\n */\nfunction normalizeKey(absolutePath: string): string {\n  return absolutePath.replace(/\\\\/g, \"/\").toLowerCase();\n}\n\n/**\n * Increment the version counter for the given absolute path.\n * Called when the file watcher detects a change.\n */\nexport function bumpVersion(absolutePath: string): void {\n  const key = normalizeKey(absolutePath);\n  versionMap.set(key, (versionMap.get(key) ?? 0) + 1);\n}\n\n/**\n * Return the current version counter for the given absolute path.\n * Returns 0 for paths not yet seen (first import).\n */\nexport function getVersion(absolutePath: string): number {\n  return versionMap.get(normalizeKey(absolutePath)) ?? 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,MAAM,6BAAa,IAAI,IAAoB;;;;;;;AAQ3C,SAAS,aAAa,cAA8B;CAClD,OAAO,aAAa,QAAQ,OAAO,GAAG,CAAC,CAAC,YAAY;AACtD;;;;;AAMA,SAAgB,YAAY,cAA4B;CACtD,MAAM,MAAM,aAAa,YAAY;CACrC,WAAW,IAAI,MAAM,WAAW,IAAI,GAAG,KAAK,KAAK,CAAC;AACpD;;;;;AAMA,SAAgB,WAAW,cAA8B;CACvD,OAAO,WAAW,IAAI,aAAa,YAAY,CAAC,KAAK;AACvD"}
+{"version":3,"file":"version-registry.mjs","names":[],"sources":["../../../../../../../../core/src/dev-server/loader/version-registry.ts"],"sourcesContent":["/**\n * Version registry for the ESM loader hook.\n *\n * Lives in the hook worker thread. The main thread sends bump messages via\n * MessageChannel; each bump increments the monotonic counter for that path,\n * which causes `resolve()` to produce a new URL — Node sees a fresh module.\n *\n * Monotonic integers are used instead of timestamps so there is no clock-drift\n * risk and the version is trivial to reason about during debugging.\n *\n * @example\n * // Hook worker receives a bump from the file watcher:\n * bumpVersion(\"/abs/path/to/user.model.ts\");\n * // → getVersion returns 1, resolve() appends ?v=1 to the URL\n */\n\nconst versionMap = new Map<string, number>();\n\n/**\n * Normalize a filesystem path to a single canonical form so the main thread\n * (which often holds forward-slash paths from posix-style joins) and the\n * hook worker (which gets backslash paths from `fileURLToPath` on Windows)\n * agree on map keys.\n */\nfunction normalizeKey(absolutePath: string): string {\n  return absolutePath.replace(/\\\\/g, \"/\").toLowerCase();\n}\n\n/**\n * Increment the version counter for the given absolute path.\n * Called when the file watcher detects a change.\n */\nexport function bumpVersion(absolutePath: string): void {\n  const key = normalizeKey(absolutePath);\n  versionMap.set(key, (versionMap.get(key) ?? 0) + 1);\n}\n\n/**\n * Return the current version counter for the given absolute path.\n * Returns 0 for paths not yet seen (first import).\n */\nexport function getVersion(absolutePath: string): number {\n  return versionMap.get(normalizeKey(absolutePath)) ?? 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,MAAM,6BAAa,IAAI,IAAoB;;;;;;;AAQ3C,SAAS,aAAa,cAA8B;CAClD,OAAO,aAAa,QAAQ,OAAO,GAAG,EAAE,YAAY;AACtD;;;;;AAMA,SAAgB,YAAY,cAA4B;CACtD,MAAM,MAAM,aAAa,YAAY;CACrC,WAAW,IAAI,MAAM,WAAW,IAAI,GAAG,KAAK,KAAK,CAAC;AACpD;;;;;AAMA,SAAgB,WAAW,cAA8B;CACvD,OAAO,WAAW,IAAI,aAAa,YAAY,CAAC,KAAK;AACvD"}

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

@@ -1 +1 @@
-{"version":3,"file":"manifest-manager.d.mts","names":[],"sources":["../../../../../../../core/src/dev-server/manifest-manager.ts"],"mappings":";;;;cAmBa,eAAA;EAAA,iBAiByB,KAAA;EAAA;;;EAAA,QAb5B,QAAA;EAa+C;;;cAAnB,KAAA,EAAO,GAAA,SAAY,WAAA;EAkB1C;;;;EAZA,IAAA,IAAQ,OAAA;EA+Bd;;;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":["../../../../../../../core/src/dev-server/manifest-manager.ts"],"mappings":";;;;cAmBa,eAAA;EAAA,iBAiByB,KAAA;EAAA;;;EAAA,QAb5B,QAAA;EAa+C;;;cAAnB,KAAA,EAAO,GAAA,SAAY,WAAA;EAkB1C;;;;EAZA,IAAA,CAAA,GAAQ,OAAA;EA+Bd;;;EAnBM,IAAA,CAAA,GAAQ,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,CAAA;;;;EAOA,WAAA,CAAA,GAAe,MAAA,SAAe,YAAA;;;;EAO9B,WAAA,CAAA;;;;;;;;;;;;UAYC,0BAAA;;;;EAUD,KAAA,CAAA;AAAA"}

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"package-json-manager.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/package-json-manager.ts"],"sourcesContent":["import { getJsonFileAsync } from \"@warlock.js/fs\";\nimport { Path } from \"../utils/normalized-path\";\n\nexport class PackageJsonManager {\n  /**\n   * Package.json data\n   */\n  public packageJson: any = {};\n\n  /**\n   * Initialize the package.json manager\n   */\n  public async init() {\n    this.packageJson = await getJsonFileAsync(Path.toAbsolute(\"package.json\"));\n  }\n\n  /**\n   * Check if the given path is a package path\n   */\n  public isPathPackage(path: string) {\n    const allPackages = Object.keys(this.packageJson.dependencies || {}).concat(\n      Object.keys(this.packageJson.devDependencies || {}),\n    );\n\n    return allPackages.some((packageName) => path.startsWith(packageName));\n  }\n}\n\nexport const packageJsonManager = new PackageJsonManager();\n"],"mappings":";;;;AAGA,IAAa,qBAAb,MAAgC;;qBAIJ,CAAC;;;;;CAK3B,MAAa,OAAO;EAClB,KAAK,cAAc,MAAM,iBAAiB,KAAK,WAAW,cAAc,CAAC;CAC3E;;;;CAKA,AAAO,cAAc,MAAc;EAKjC,OAJoB,OAAO,KAAK,KAAK,YAAY,gBAAgB,CAAC,CAAC,CAAC,CAAC,OACnE,OAAO,KAAK,KAAK,YAAY,mBAAmB,CAAC,CAAC,CAGnC,CAAC,CAAC,MAAM,gBAAgB,KAAK,WAAW,WAAW,CAAC;CACvE;AACF;AAEA,MAAa,qBAAqB,IAAI,mBAAmB"}
+{"version":3,"file":"package-json-manager.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/package-json-manager.ts"],"sourcesContent":["import { getJsonFileAsync } from \"@warlock.js/fs\";\nimport { Path } from \"../utils/normalized-path\";\n\nexport class PackageJsonManager {\n  /**\n   * Package.json data\n   */\n  public packageJson: any = {};\n\n  /**\n   * Initialize the package.json manager\n   */\n  public async init() {\n    this.packageJson = await getJsonFileAsync(Path.toAbsolute(\"package.json\"));\n  }\n\n  /**\n   * Check if the given path is a package path\n   */\n  public isPathPackage(path: string) {\n    const allPackages = Object.keys(this.packageJson.dependencies || {}).concat(\n      Object.keys(this.packageJson.devDependencies || {}),\n    );\n\n    return allPackages.some((packageName) => path.startsWith(packageName));\n  }\n}\n\nexport const packageJsonManager = new PackageJsonManager();\n"],"mappings":";;;;AAGA,IAAa,qBAAb,MAAgC;;qBAIJ,CAAC;;;;;CAK3B,MAAa,OAAO;EAClB,KAAK,cAAc,MAAM,iBAAiB,KAAK,WAAW,cAAc,CAAC;CAC3E;;;;CAKA,AAAO,cAAc,MAAc;EAKjC,OAJoB,OAAO,KAAK,KAAK,YAAY,gBAAgB,CAAC,CAAC,EAAE,OACnE,OAAO,KAAK,KAAK,YAAY,mBAAmB,CAAC,CAAC,CAGnC,EAAE,MAAM,gBAAgB,KAAK,WAAW,WAAW,CAAC;CACvE;AACF;AAEA,MAAa,qBAAqB,IAAI,mBAAmB"}