@warlock.js/core 5.28.0 → 5.30.0

package/esm/dev-server/create-worker.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-worker.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/create-worker.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath } from \"url\";\nimport { Worker, type WorkerOptions } from \"worker_threads\";\n\n/**\n * Options for creating a health check worker\n */\nexport type CreateWorkerOptions = WorkerOptions & {\n  /**\n   * Worker data to pass to the worker thread\n   */\n  workerData?: Record<string, unknown>;\n};\n\n/**\n * Create a worker that works in both dev (TypeScript) and production (JavaScript) environments.\n *\n * The worker shares the CALLING module's extension: `.ts` when core runs from\n * source (loaded via tsx), `.mjs` when core is published. Source workers are\n * run through the tsx loader; published `.mjs` workers run as-is.\n *\n * @param workerPath - Relative path to worker file WITHOUT extension (e.g., \"./workers/ts-health.worker\")\n * @param baseUrl - The import.meta.url of the calling module (used to resolve relative paths)\n * @param options - Additional worker options\n * @returns A new Worker instance\n *\n * @example\n * ```typescript\n * // In FilesHealthcareManager\n * const worker = createWorker(\n *   \"./workers/ts-health.worker\",\n *   import.meta.url,\n *   { workerData: { cwd: process.cwd() } }\n * );\n * ```\n */\nexport function createWorker(\n  workerPath: string,\n  baseUrl: string,\n  options?: CreateWorkerOptions,\n): Worker {\n  // The worker shares the CALLING module's extension: `.ts` from source (needs the\n  // tsx loader to execute), `.mjs` when core is published.\n  const callerExtension = path.extname(fileURLToPath(baseUrl));\n  const isSource = callerExtension === \".ts\" || callerExtension === \".tsx\";\n  const workerUrl = new URL(`${workerPath}${callerExtension}`, baseUrl);\n  const workerFilePath = fileURLToPath(workerUrl);\n\n  const workerOptions: WorkerOptions = {\n    ...options,\n  };\n\n  // Source workers are TypeScript — run them through the tsx loader.\n  if (isSource) {\n    workerOptions.execArgv = [...(options?.execArgv || []), \"--import\", \"tsx/esm\"];\n  }\n\n  return new Worker(workerFilePath, workerOptions);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,aACd,YACA,SACA,SACQ;CAGR,MAAM,kBAAkB,KAAK,QAAQ,cAAc,OAAO,CAAC;CAC3D,MAAM,WAAW,oBAAoB,SAAS,oBAAoB;CAElE,MAAM,iBAAiB,cAAc,IADf,IAAI,GAAG,aAAa,mBAAmB,OAChB,CAAC;CAE9C,MAAM,gBAA+B,EACnC,GAAG,QACL;CAGA,IAAI,UACF,cAAc,WAAW;EAAC,GAAI,SAAS,YAAY,CAAC;EAAI;EAAY;CAAS;CAG/E,OAAO,IAAI,OAAO,gBAAgB,aAAa;AACjD"}
+{"version":3,"file":"create-worker.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/create-worker.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath } from \"url\";\nimport { Worker, type WorkerOptions } from \"worker_threads\";\n\n/**\n * Options for creating a health check worker\n */\nexport type CreateWorkerOptions = WorkerOptions & {\n  /**\n   * Worker data to pass to the worker thread\n   */\n  workerData?: Record<string, unknown>;\n};\n\n/**\n * Create a worker that works in both dev (TypeScript) and production (JavaScript) environments.\n *\n * The worker shares the CALLING module's extension: `.ts` when core runs from\n * source (loaded via tsx), `.mjs` when core is published. Source workers are\n * run through the tsx loader; published `.mjs` workers run as-is.\n *\n * @param workerPath - Relative path to worker file WITHOUT extension (e.g., \"./workers/ts-health.worker\")\n * @param baseUrl - The import.meta.url of the calling module (used to resolve relative paths)\n * @param options - Additional worker options\n * @returns A new Worker instance\n *\n * @example\n * ```typescript\n * // In FilesHealthcareManager\n * const worker = createWorker(\n *   \"./workers/ts-health.worker\",\n *   import.meta.url,\n *   { workerData: { cwd: process.cwd() } }\n * );\n * ```\n */\nexport function createWorker(\n  workerPath: string,\n  baseUrl: string,\n  options?: CreateWorkerOptions,\n): Worker {\n  // The worker shares the CALLING module's extension: `.ts` from source (needs the\n  // tsx loader to execute), `.mjs` when core is published.\n  const callerExtension = path.extname(fileURLToPath(baseUrl));\n  const isSource = callerExtension === \".ts\" || callerExtension === \".tsx\";\n  const workerUrl = new URL(`${workerPath}${callerExtension}`, baseUrl);\n  const workerFilePath = fileURLToPath(workerUrl);\n\n  const workerOptions: WorkerOptions = {\n    ...options,\n  };\n\n  // Source workers are TypeScript — run them through the tsx loader.\n  if (isSource) {\n    workerOptions.execArgv = [...(options?.execArgv || []), \"--import\", \"tsx/esm\"];\n  }\n\n  return new Worker(workerFilePath, workerOptions);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,aACd,YACA,SACA,SACQ;CAGR,MAAM,kBAAkB,KAAK,QAAQ,cAAc,OAAO,CAAC;CAC3D,MAAM,WAAW,oBAAoB,SAAS,oBAAoB;CAElE,MAAM,iBAAiB,cAAc,IADf,IAAI,GAAG,aAAa,mBAAmB,OAChB,CAAC;CAE9C,MAAM,gBAA+B,EACnC,GAAG,QACL;CAGA,IAAI,UACF,cAAc,WAAW;EAAC,GAAI,SAAS,YAAY,CAAC;EAAI;EAAY;CAAS;CAG/E,OAAO,IAAI,OAAO,gBAAgB,aAAa;AACjD"}

package/esm/dev-server/dependency-graph.d.mts

@@ -1,6 +1,6 @@
 import { FileManager } from "./file-manager.mjs";
 
-//#region ../core/src/dev-server/dependency-graph.d.ts
+//#region ../../packages/core/src/dev-server/dependency-graph.d.ts
 /**
  * Dependency Graph
  * Tracks bidirectional relationships between files:

package/esm/dev-server/dependency-graph.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"dependency-graph.d.mts","names":[],"sources":["../../../../../../../core/src/dev-server/dependency-graph.ts"],"mappings":";;;;;AAYA;;;;;;;;cAAa,eAAA;EA0L4B;;;;;EAAA,QApL/B,YAAA;EAkBY;;;;;EAAA,QAXZ,UAAA;EAiD+C;;;;EAAA,QA3C/C,KAAA;EA8EU;;;EAzEX,KAAA,CAAM,KAAA,EAAO,GAAA,SAAY,WAAA;EA2G9B;;;;;;;;;EArEK,aAAA,CAAc,IAAA,UAAc,UAAA,UAAoB,UAAA;EA4HlC;;;;;EAlGd,gBAAA,CAAiB,IAAA,UAAc,UAAA;EA+M9B;;;;EAtMD,UAAA,CAAW,IAAA;;;;;;;;;;;;EAgCX,UAAA,CACL,IAAA,UACA,eAAA,EAAiB,GAAA,UACjB,oBAAA,GAAsB,GAAA;;;;;;EA+BjB,eAAA,CAAgB,IAAA,WAAe,GAAA;;;;;EAc/B,cAAA,CAAe,IAAA,UAAc,UAAA;;;;;;EAS7B,aAAA,CAAc,IAAA,WAAe,GAAA;;;;;;;;EAW7B,oBAAA,CAAqB,IAAA;;;;;;;;;;;;;EA+BrB,0BAAA;;;;;;;UA2CC,cAAA;;;;;UAwBA,iCAAA;;;;EAwGD,QAAA"}
+{"version":3,"file":"dependency-graph.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/dependency-graph.ts"],"mappings":";;;;;AAYA;;;;;;;;cAAa,eAAA;EA0L4B;;;;;EAAA,QApL/B,YAAA;EAkBY;;;;;EAAA,QAXZ,UAAA;EAiD+C;;;;EAAA,QA3C/C,KAAA;EA8EU;;;EAzEX,KAAA,CAAM,KAAA,EAAO,GAAA,SAAY,WAAA;EA2G9B;;;;;;;;;EArEK,aAAA,CAAc,IAAA,UAAc,UAAA,UAAoB,UAAA;EA4HlC;;;;;EAlGd,gBAAA,CAAiB,IAAA,UAAc,UAAA;EA+M9B;;;;EAtMD,UAAA,CAAW,IAAA;;;;;;;;;;;;EAgCX,UAAA,CACL,IAAA,UACA,eAAA,EAAiB,GAAA,UACjB,oBAAA,GAAsB,GAAA;;;;;;EA+BjB,eAAA,CAAgB,IAAA,WAAe,GAAA;;;;;EAc/B,cAAA,CAAe,IAAA,UAAc,UAAA;;;;;;EAS7B,aAAA,CAAc,IAAA,WAAe,GAAA;;;;;;;;EAW7B,oBAAA,CAAqB,IAAA;;;;;;;;;;;;;EA+BrB,0BAAA;;;;;;;UA2CC,cAAA;;;;;UAwBA,iCAAA;;;;EAwGD,QAAA"}

package/esm/dev-server/dependency-graph.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/dev-server/dependency-graph.ts
+//#region ../../packages/core/src/dev-server/dependency-graph.ts
 /**
 * Dependency Graph
 * Tracks bidirectional relationships between files:

package/esm/dev-server/dependency-graph.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dependency-graph.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/dependency-graph.ts"],"sourcesContent":["import type { FileManager } from \"./file-manager\";\n\n/**\n * Dependency Graph\n * Tracks bidirectional relationships between files:\n * - dependencies: files that this file imports\n * - dependents: files that import this file\n *\n * Each forward edge also carries an `isTypeOnly` flag so cycle detection\n * can distinguish runtime cycles from ones formed purely by `import type`\n * edges — the latter are erased by TypeScript and have no runtime effect.\n */\nexport class DependencyGraph {\n  /**\n   * Map of file -> files it depends on (imports).\n   * Key: relative file path.\n   * Value: relative dependency path → `{ isTypeOnly }` for that edge.\n   */\n  private dependencies = new Map<string, Map<string, { isTypeOnly: boolean }>>();\n\n  /**\n   * Map of file -> files that depend on it (importers)\n   * Key: relative file path\n   * Value: Set of relative file paths that import this file\n   */\n  private dependents = new Map<string, Set<string>>();\n\n  /**\n   * Reference to the files map for accessing FileManager instances\n   * Used to read per-file typeOnlyDependencies during graph build.\n   */\n  private files: Map<string, FileManager> | null = null;\n\n  /**\n   * Build dependency graph from FileManager map\n   */\n  public build(files: Map<string, FileManager>) {\n    this.files = files;\n\n    this.dependencies.clear();\n    this.dependents.clear();\n\n    for (const [relativePath, fileManager] of files) {\n      if (!this.dependencies.has(relativePath)) {\n        this.dependencies.set(relativePath, new Map());\n      }\n\n      if (!this.dependents.has(relativePath)) {\n        this.dependents.set(relativePath, new Set());\n      }\n\n      for (const dependency of fileManager.dependencies) {\n        const isTypeOnly = fileManager.typeOnlyDependencies.has(dependency);\n\n        this.addDependency(relativePath, dependency, isTypeOnly);\n      }\n    }\n\n    const cycles = this.detectCircularDependencies();\n\n    if (cycles.length > 0) {\n      this.displayCircularDependencyWarnings(cycles);\n    }\n  }\n\n  /**\n   * Add a dependency relationship.\n   * If the edge already exists, the type-only flag is ANDed: any runtime\n   * statement between the two files makes the edge runtime permanently.\n   *\n   * @param file The file that has the dependency\n   * @param dependency The file being depended upon\n   * @param isTypeOnly Whether every reference from `file` to `dependency` is type-only\n   */\n  public addDependency(file: string, dependency: string, isTypeOnly: boolean = false) {\n    if (!this.dependencies.has(file)) {\n      this.dependencies.set(file, new Map());\n    }\n\n    if (!this.dependents.has(dependency)) {\n      this.dependents.set(dependency, new Set());\n    }\n\n    const edges = this.dependencies.get(file)!;\n    const existing = edges.get(dependency);\n\n    if (existing) {\n      existing.isTypeOnly = existing.isTypeOnly && isTypeOnly;\n    } else {\n      edges.set(dependency, { isTypeOnly });\n    }\n\n    this.dependents.get(dependency)!.add(file);\n  }\n\n  /**\n   * Remove a dependency relationship\n   * @param file The file that has the dependency\n   * @param dependency The file being depended upon\n   */\n  public removeDependency(file: string, dependency: string) {\n    this.dependencies.get(file)?.delete(dependency);\n    this.dependents.get(dependency)?.delete(file);\n  }\n\n  /**\n   * Remove all relationships for a file\n   * @param file The file to remove\n   */\n  public removeFile(file: string) {\n    const deps = this.dependencies.get(file);\n\n    if (deps) {\n      for (const dependency of deps.keys()) {\n        this.dependents.get(dependency)?.delete(file);\n      }\n    }\n\n    const dependents = this.dependents.get(file);\n\n    if (dependents) {\n      for (const dependent of dependents) {\n        this.dependencies.get(dependent)?.delete(file);\n      }\n    }\n\n    this.dependencies.delete(file);\n    this.dependents.delete(file);\n  }\n\n  /**\n   * Update dependencies for a file.\n   *\n   * Accepts the updated `Set<string>` of dependency paths; when the caller\n   * has per-edge type-only info, pass `typeOnlyDependencies` so the new\n   * edges get the correct flag. Missing flag defaults to runtime.\n   *\n   * @param file The file to update\n   * @param newDependencies New set of dependency paths\n   * @param typeOnlyDependencies Subset of `newDependencies` whose edges are type-only\n   */\n  public updateFile(\n    file: string,\n    newDependencies: Set<string>,\n    typeOnlyDependencies: Set<string> = new Set(),\n  ) {\n    const oldEdges = this.dependencies.get(file) ?? new Map<string, { isTypeOnly: boolean }>();\n\n    for (const oldDep of oldEdges.keys()) {\n      if (!newDependencies.has(oldDep)) {\n        this.removeDependency(file, oldDep);\n      }\n    }\n\n    for (const newDep of newDependencies) {\n      const isTypeOnly = typeOnlyDependencies.has(newDep);\n      const existing = oldEdges.get(newDep);\n\n      if (!existing) {\n        this.addDependency(file, newDep, isTypeOnly);\n\n        continue;\n      }\n\n      if (existing.isTypeOnly !== isTypeOnly) {\n        existing.isTypeOnly = isTypeOnly;\n      }\n    }\n  }\n\n  /**\n   * Get files that this file depends on (imports)\n   * @param file The file to check\n   * @returns Set of files this file imports\n   */\n  public getDependencies(file: string): Set<string> {\n    const edges = this.dependencies.get(file);\n\n    if (!edges) {\n      return new Set();\n    }\n\n    return new Set(edges.keys());\n  }\n\n  /**\n   * Check whether the edge `file → dependency` is type-only.\n   * Returns false if the edge does not exist.\n   */\n  public isEdgeTypeOnly(file: string, dependency: string): boolean {\n    return this.dependencies.get(file)?.get(dependency)?.isTypeOnly === true;\n  }\n\n  /**\n   * Get files that depend on this file (importers)\n   * @param file The file to check\n   * @returns Set of files that import this file\n   */\n  public getDependents(file: string): Set<string> {\n    return this.dependents.get(file) || new Set();\n  }\n\n  /**\n   * Get invalidation chain for a file\n   * Returns all files that need to be reloaded when this file changes\n   * Includes the file itself and all transitive dependents\n   * @param file The file that changed\n   * @returns Array of files to invalidate (in order)\n   */\n  public getInvalidationChain(file: string): string[] {\n    const chain: string[] = [file];\n    const visited = new Set([file]);\n\n    const traverse = (current: string) => {\n      const deps = this.getDependents(current);\n      for (const dep of deps) {\n        if (!visited.has(dep)) {\n          visited.add(dep);\n          chain.push(dep);\n          traverse(dep); // Recursive traversal\n        }\n      }\n    };\n\n    traverse(file);\n    return chain;\n  }\n\n  /**\n   * Detect circular dependencies in the dependency graph.\n   * Uses depth-first search to find cycles.\n   *\n   * Filtering rule (per-edge): a cycle is suppressed when **any** edge in\n   * the chain is type-only. TypeScript erases type-only imports entirely,\n   * so a single type-only edge breaks the cycle at runtime. Only warn when\n   * every edge is a runtime binding — that's the cycle that actually loops\n   * at load time.\n   *\n   * @returns Array of circular dependency chains (each chain is an array of file paths)\n   */\n  public detectCircularDependencies(): string[][] {\n    const cycles: string[][] = [];\n    const visited = new Set<string>();\n    const recursionStack = new Set<string>();\n\n    const dfs = (file: string, path: string[]): void => {\n      visited.add(file);\n      recursionStack.add(file);\n      path.push(file);\n\n      const edges = this.dependencies.get(file);\n\n      if (edges) {\n        for (const dep of edges.keys()) {\n          if (!visited.has(dep)) {\n            dfs(dep, [...path]);\n          } else if (recursionStack.has(dep)) {\n            const cycleStart = path.indexOf(dep);\n            const cycle = [...path.slice(cycleStart), dep];\n\n            cycles.push(cycle);\n          }\n        }\n      }\n\n      recursionStack.delete(file);\n    };\n\n    for (const file of this.dependencies.keys()) {\n      if (!visited.has(file)) {\n        dfs(file, []);\n      }\n    }\n\n    return cycles.filter((cycle) => this.isRuntimeCycle(cycle));\n  }\n\n  /**\n   * True iff every edge in the cycle is a runtime binding. The cycle array\n   * ends with a duplicate of its start (`[A, B, C, A]`) so we walk the\n   * consecutive pairs once — any type-only edge means TS erases the loop\n   * and there is no runtime cycle to report.\n   */\n  private isRuntimeCycle(cycle: string[]): boolean {\n    for (let index = 0; index < cycle.length - 1; index++) {\n      const from = cycle[index];\n      const to = cycle[index + 1];\n\n      // `index < cycle.length - 1` bounds both reads. Skipping an unreadable\n      // edge rather than defaulting: this decides whether a cycle is\n      // TYPE-ONLY, and a `?? \"\"` would ask `isEdgeTypeOnly(\"\", \"\")`, whose\n      // answer is about a pair of edges that do not exist. A cycle wrongly\n      // classified as type-only is a real circular import reported as harmless.\n      if (from === undefined || to === undefined) continue;\n\n      if (this.isEdgeTypeOnly(from, to)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * Display circular dependency warnings in a formatted, user-friendly way\n   * Shows each cycle with visual tree structure and helpful recommendations\n   */\n  private displayCircularDependencyWarnings(cycles: string[][]): void {\n    const colors = {\n      yellow: (text: string) => `\\x1b[33m${text}\\x1b[0m`,\n      cyan: (text: string) => `\\x1b[36m${text}\\x1b[0m`,\n      dim: (text: string) => `\\x1b[2m${text}\\x1b[0m`,\n      bold: (text: string) => `\\x1b[1m${text}\\x1b[0m`,\n      green: (text: string) => `\\x1b[32m${text}\\x1b[0m`,\n    };\n\n    console.log(\"\");\n    console.log(colors.yellow(\"⚠️  Circular Dependencies Detected\"));\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(\"\");\n    console.log(\n      colors.dim(\n        `Found ${colors.bold(cycles.length.toString())} circular dependency chain${cycles.length > 1 ? \"s\" : \"\"}`,\n      ),\n    );\n    console.log(\"\");\n\n    cycles.forEach((cycle, index) => {\n      console.log(colors.cyan(`  ${index + 1}. Cycle with ${cycle.length - 1} files:`));\n      console.log(\"\");\n\n      // Display the cycle chain\n      cycle.forEach((file, fileIndex) => {\n        const isLast = fileIndex === cycle.length - 1;\n        const arrow = isLast ? colors.dim(\"   └─→ \") : colors.dim(\"   ├─→ \");\n        const fileName = file.split(\"/\").pop() || file;\n        const filePath = colors.dim(file.replace(fileName, \"\"));\n\n        if (isLast) {\n          // Last item is the same as first (completes the cycle)\n          console.log(\n            arrow + colors.yellow(`${filePath}${colors.bold(fileName)} (cycle completes)`),\n          );\n        } else {\n          console.log(arrow + filePath + colors.bold(fileName));\n        }\n      });\n\n      console.log(\"\");\n    });\n\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(colors.yellow(\"💡 How to Fix:\"));\n    console.log(\"\");\n\n    // This whole block prints \"How to Fix\" advice for a cycle that was just\n    // reported, so there is always one — but this is diagnostic OUTPUT, and a\n    // formatter that throws while explaining a problem replaces the problem\n    // with itself. An empty list simply has no example to show.\n    const exampleCycle = cycles[0] ?? [];\n    const fileA = exampleCycle[0]?.split(\"/\").pop() || \"fileA.ts\";\n    const fileB = exampleCycle[1]?.split(\"/\").pop() || \"fileB.ts\";\n    const stripExt = (file: string) => file.replace(/\\.tsx?$/, \"\");\n\n    const kind = classifyCycle(exampleCycle);\n\n    if (kind === \"resource\" || kind === \"model\") {\n      // Cascade's `lazy()` is purpose-built for circular relations between\n      // resources and models — recommend it first, not as a footnote.\n      console.log(colors.green(`  ✨ Use lazy() for the back-reference`));\n      console.log(\n        colors.dim(\n          `   ${kind === \"resource\" ? \"Resources\" : \"Models\"} that reference each other should declare`,\n        ),\n      );\n      console.log(colors.dim(`   one side with lazy() so the import resolves at access time:`));\n      console.log(\"\");\n      console.log(colors.dim(`     import { lazy } from \"@warlock.js/cascade\";`));\n      console.log(colors.dim(`     // inside ${fileB}:`));\n      console.log(\n        colors.dim(\n          `     other: lazy(() => ${kind === \"resource\" ? \"OtherResource\" : \"OtherModel\"})`,\n        ),\n      );\n      console.log(\"\");\n    } else {\n      // Generic cycle — dynamic import is the most common reliable fix.\n      console.log(colors.green(`  ✨ Convert one edge to a dynamic import`));\n      console.log(colors.dim(`   In ${fileB}, change:`));\n      console.log(colors.dim(`     import { SomeClass } from \"./${stripExt(fileA)}\";`));\n      console.log(colors.dim(`   To:`));\n      console.log(colors.dim(`     const { SomeClass } = await import(\"./${stripExt(fileA)}\");`));\n      console.log(\"\");\n    }\n\n    console.log(colors.dim(\"  Other options:\"));\n    console.log(colors.dim(\"    • Extract the shared symbols into a third file both can import.\"));\n    console.log(\n      colors.dim(\"    • Pass the dependency as a constructor/function parameter instead.\"),\n    );\n    console.log(\"\");\n\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(colors.dim(\"   Circular dependencies can cause HMR issues and hard-to-debug\"));\n    console.log(colors.dim(\"   initialization order problems. Consider refactoring.\"));\n    console.log(\"\");\n  }\n\n  /**\n   * Get statistics about the dependency graph\n   */\n  public getStats() {\n    let totalDependencies = 0;\n    let maxDependencies = 0;\n    let maxDependents = 0;\n    let mostDependedFile = \"\";\n    let mostDependingFile = \"\";\n\n    for (const [file, deps] of this.dependencies) {\n      totalDependencies += deps.size;\n      if (deps.size > maxDependencies) {\n        maxDependencies = deps.size;\n        mostDependingFile = file;\n      }\n    }\n\n    for (const [file, deps] of this.dependents) {\n      if (deps.size > maxDependents) {\n        maxDependents = deps.size;\n        mostDependedFile = file;\n      }\n    }\n\n    return {\n      totalFiles: this.dependencies.size,\n      totalDependencies,\n      avgDependenciesPerFile: totalDependencies / this.dependencies.size || 0,\n      maxDependencies,\n      maxDependents,\n      mostDependingFile,\n      mostDependedFile,\n    };\n  }\n}\n\n/**\n * Pick the most useful \"fix-it\" hint for a cycle by inspecting the file\n * extensions involved. Cascade resources/models have a first-class fix\n * (`lazy()`); generic cycles just want a dynamic import.\n */\nfunction classifyCycle(cycle: string[]): \"resource\" | \"model\" | \"generic\" {\n  const files = cycle.slice(0, -1); // last entry repeats the first\n  if (files.every((file) => file.endsWith(\".resource.ts\") || file.endsWith(\".resource.tsx\"))) {\n    return \"resource\";\n  }\n  if (files.every((file) => file.endsWith(\".model.ts\") || file.endsWith(\".model.tsx\"))) {\n    return \"model\";\n  }\n  return \"generic\";\n}\n"],"mappings":"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"}
+{"version":3,"file":"dependency-graph.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/dependency-graph.ts"],"sourcesContent":["import type { FileManager } from \"./file-manager\";\n\n/**\n * Dependency Graph\n * Tracks bidirectional relationships between files:\n * - dependencies: files that this file imports\n * - dependents: files that import this file\n *\n * Each forward edge also carries an `isTypeOnly` flag so cycle detection\n * can distinguish runtime cycles from ones formed purely by `import type`\n * edges — the latter are erased by TypeScript and have no runtime effect.\n */\nexport class DependencyGraph {\n  /**\n   * Map of file -> files it depends on (imports).\n   * Key: relative file path.\n   * Value: relative dependency path → `{ isTypeOnly }` for that edge.\n   */\n  private dependencies = new Map<string, Map<string, { isTypeOnly: boolean }>>();\n\n  /**\n   * Map of file -> files that depend on it (importers)\n   * Key: relative file path\n   * Value: Set of relative file paths that import this file\n   */\n  private dependents = new Map<string, Set<string>>();\n\n  /**\n   * Reference to the files map for accessing FileManager instances\n   * Used to read per-file typeOnlyDependencies during graph build.\n   */\n  private files: Map<string, FileManager> | null = null;\n\n  /**\n   * Build dependency graph from FileManager map\n   */\n  public build(files: Map<string, FileManager>) {\n    this.files = files;\n\n    this.dependencies.clear();\n    this.dependents.clear();\n\n    for (const [relativePath, fileManager] of files) {\n      if (!this.dependencies.has(relativePath)) {\n        this.dependencies.set(relativePath, new Map());\n      }\n\n      if (!this.dependents.has(relativePath)) {\n        this.dependents.set(relativePath, new Set());\n      }\n\n      for (const dependency of fileManager.dependencies) {\n        const isTypeOnly = fileManager.typeOnlyDependencies.has(dependency);\n\n        this.addDependency(relativePath, dependency, isTypeOnly);\n      }\n    }\n\n    const cycles = this.detectCircularDependencies();\n\n    if (cycles.length > 0) {\n      this.displayCircularDependencyWarnings(cycles);\n    }\n  }\n\n  /**\n   * Add a dependency relationship.\n   * If the edge already exists, the type-only flag is ANDed: any runtime\n   * statement between the two files makes the edge runtime permanently.\n   *\n   * @param file The file that has the dependency\n   * @param dependency The file being depended upon\n   * @param isTypeOnly Whether every reference from `file` to `dependency` is type-only\n   */\n  public addDependency(file: string, dependency: string, isTypeOnly: boolean = false) {\n    if (!this.dependencies.has(file)) {\n      this.dependencies.set(file, new Map());\n    }\n\n    if (!this.dependents.has(dependency)) {\n      this.dependents.set(dependency, new Set());\n    }\n\n    const edges = this.dependencies.get(file)!;\n    const existing = edges.get(dependency);\n\n    if (existing) {\n      existing.isTypeOnly = existing.isTypeOnly && isTypeOnly;\n    } else {\n      edges.set(dependency, { isTypeOnly });\n    }\n\n    this.dependents.get(dependency)!.add(file);\n  }\n\n  /**\n   * Remove a dependency relationship\n   * @param file The file that has the dependency\n   * @param dependency The file being depended upon\n   */\n  public removeDependency(file: string, dependency: string) {\n    this.dependencies.get(file)?.delete(dependency);\n    this.dependents.get(dependency)?.delete(file);\n  }\n\n  /**\n   * Remove all relationships for a file\n   * @param file The file to remove\n   */\n  public removeFile(file: string) {\n    const deps = this.dependencies.get(file);\n\n    if (deps) {\n      for (const dependency of deps.keys()) {\n        this.dependents.get(dependency)?.delete(file);\n      }\n    }\n\n    const dependents = this.dependents.get(file);\n\n    if (dependents) {\n      for (const dependent of dependents) {\n        this.dependencies.get(dependent)?.delete(file);\n      }\n    }\n\n    this.dependencies.delete(file);\n    this.dependents.delete(file);\n  }\n\n  /**\n   * Update dependencies for a file.\n   *\n   * Accepts the updated `Set<string>` of dependency paths; when the caller\n   * has per-edge type-only info, pass `typeOnlyDependencies` so the new\n   * edges get the correct flag. Missing flag defaults to runtime.\n   *\n   * @param file The file to update\n   * @param newDependencies New set of dependency paths\n   * @param typeOnlyDependencies Subset of `newDependencies` whose edges are type-only\n   */\n  public updateFile(\n    file: string,\n    newDependencies: Set<string>,\n    typeOnlyDependencies: Set<string> = new Set(),\n  ) {\n    const oldEdges = this.dependencies.get(file) ?? new Map<string, { isTypeOnly: boolean }>();\n\n    for (const oldDep of oldEdges.keys()) {\n      if (!newDependencies.has(oldDep)) {\n        this.removeDependency(file, oldDep);\n      }\n    }\n\n    for (const newDep of newDependencies) {\n      const isTypeOnly = typeOnlyDependencies.has(newDep);\n      const existing = oldEdges.get(newDep);\n\n      if (!existing) {\n        this.addDependency(file, newDep, isTypeOnly);\n\n        continue;\n      }\n\n      if (existing.isTypeOnly !== isTypeOnly) {\n        existing.isTypeOnly = isTypeOnly;\n      }\n    }\n  }\n\n  /**\n   * Get files that this file depends on (imports)\n   * @param file The file to check\n   * @returns Set of files this file imports\n   */\n  public getDependencies(file: string): Set<string> {\n    const edges = this.dependencies.get(file);\n\n    if (!edges) {\n      return new Set();\n    }\n\n    return new Set(edges.keys());\n  }\n\n  /**\n   * Check whether the edge `file → dependency` is type-only.\n   * Returns false if the edge does not exist.\n   */\n  public isEdgeTypeOnly(file: string, dependency: string): boolean {\n    return this.dependencies.get(file)?.get(dependency)?.isTypeOnly === true;\n  }\n\n  /**\n   * Get files that depend on this file (importers)\n   * @param file The file to check\n   * @returns Set of files that import this file\n   */\n  public getDependents(file: string): Set<string> {\n    return this.dependents.get(file) || new Set();\n  }\n\n  /**\n   * Get invalidation chain for a file\n   * Returns all files that need to be reloaded when this file changes\n   * Includes the file itself and all transitive dependents\n   * @param file The file that changed\n   * @returns Array of files to invalidate (in order)\n   */\n  public getInvalidationChain(file: string): string[] {\n    const chain: string[] = [file];\n    const visited = new Set([file]);\n\n    const traverse = (current: string) => {\n      const deps = this.getDependents(current);\n      for (const dep of deps) {\n        if (!visited.has(dep)) {\n          visited.add(dep);\n          chain.push(dep);\n          traverse(dep); // Recursive traversal\n        }\n      }\n    };\n\n    traverse(file);\n    return chain;\n  }\n\n  /**\n   * Detect circular dependencies in the dependency graph.\n   * Uses depth-first search to find cycles.\n   *\n   * Filtering rule (per-edge): a cycle is suppressed when **any** edge in\n   * the chain is type-only. TypeScript erases type-only imports entirely,\n   * so a single type-only edge breaks the cycle at runtime. Only warn when\n   * every edge is a runtime binding — that's the cycle that actually loops\n   * at load time.\n   *\n   * @returns Array of circular dependency chains (each chain is an array of file paths)\n   */\n  public detectCircularDependencies(): string[][] {\n    const cycles: string[][] = [];\n    const visited = new Set<string>();\n    const recursionStack = new Set<string>();\n\n    const dfs = (file: string, path: string[]): void => {\n      visited.add(file);\n      recursionStack.add(file);\n      path.push(file);\n\n      const edges = this.dependencies.get(file);\n\n      if (edges) {\n        for (const dep of edges.keys()) {\n          if (!visited.has(dep)) {\n            dfs(dep, [...path]);\n          } else if (recursionStack.has(dep)) {\n            const cycleStart = path.indexOf(dep);\n            const cycle = [...path.slice(cycleStart), dep];\n\n            cycles.push(cycle);\n          }\n        }\n      }\n\n      recursionStack.delete(file);\n    };\n\n    for (const file of this.dependencies.keys()) {\n      if (!visited.has(file)) {\n        dfs(file, []);\n      }\n    }\n\n    return cycles.filter((cycle) => this.isRuntimeCycle(cycle));\n  }\n\n  /**\n   * True iff every edge in the cycle is a runtime binding. The cycle array\n   * ends with a duplicate of its start (`[A, B, C, A]`) so we walk the\n   * consecutive pairs once — any type-only edge means TS erases the loop\n   * and there is no runtime cycle to report.\n   */\n  private isRuntimeCycle(cycle: string[]): boolean {\n    for (let index = 0; index < cycle.length - 1; index++) {\n      const from = cycle[index];\n      const to = cycle[index + 1];\n\n      // `index < cycle.length - 1` bounds both reads. Skipping an unreadable\n      // edge rather than defaulting: this decides whether a cycle is\n      // TYPE-ONLY, and a `?? \"\"` would ask `isEdgeTypeOnly(\"\", \"\")`, whose\n      // answer is about a pair of edges that do not exist. A cycle wrongly\n      // classified as type-only is a real circular import reported as harmless.\n      if (from === undefined || to === undefined) continue;\n\n      if (this.isEdgeTypeOnly(from, to)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  /**\n   * Display circular dependency warnings in a formatted, user-friendly way\n   * Shows each cycle with visual tree structure and helpful recommendations\n   */\n  private displayCircularDependencyWarnings(cycles: string[][]): void {\n    const colors = {\n      yellow: (text: string) => `\\x1b[33m${text}\\x1b[0m`,\n      cyan: (text: string) => `\\x1b[36m${text}\\x1b[0m`,\n      dim: (text: string) => `\\x1b[2m${text}\\x1b[0m`,\n      bold: (text: string) => `\\x1b[1m${text}\\x1b[0m`,\n      green: (text: string) => `\\x1b[32m${text}\\x1b[0m`,\n    };\n\n    console.log(\"\");\n    console.log(colors.yellow(\"⚠️  Circular Dependencies Detected\"));\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(\"\");\n    console.log(\n      colors.dim(\n        `Found ${colors.bold(cycles.length.toString())} circular dependency chain${cycles.length > 1 ? \"s\" : \"\"}`,\n      ),\n    );\n    console.log(\"\");\n\n    cycles.forEach((cycle, index) => {\n      console.log(colors.cyan(`  ${index + 1}. Cycle with ${cycle.length - 1} files:`));\n      console.log(\"\");\n\n      // Display the cycle chain\n      cycle.forEach((file, fileIndex) => {\n        const isLast = fileIndex === cycle.length - 1;\n        const arrow = isLast ? colors.dim(\"   └─→ \") : colors.dim(\"   ├─→ \");\n        const fileName = file.split(\"/\").pop() || file;\n        const filePath = colors.dim(file.replace(fileName, \"\"));\n\n        if (isLast) {\n          // Last item is the same as first (completes the cycle)\n          console.log(\n            arrow + colors.yellow(`${filePath}${colors.bold(fileName)} (cycle completes)`),\n          );\n        } else {\n          console.log(arrow + filePath + colors.bold(fileName));\n        }\n      });\n\n      console.log(\"\");\n    });\n\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(colors.yellow(\"💡 How to Fix:\"));\n    console.log(\"\");\n\n    // This whole block prints \"How to Fix\" advice for a cycle that was just\n    // reported, so there is always one — but this is diagnostic OUTPUT, and a\n    // formatter that throws while explaining a problem replaces the problem\n    // with itself. An empty list simply has no example to show.\n    const exampleCycle = cycles[0] ?? [];\n    const fileA = exampleCycle[0]?.split(\"/\").pop() || \"fileA.ts\";\n    const fileB = exampleCycle[1]?.split(\"/\").pop() || \"fileB.ts\";\n    const stripExt = (file: string) => file.replace(/\\.tsx?$/, \"\");\n\n    const kind = classifyCycle(exampleCycle);\n\n    if (kind === \"resource\" || kind === \"model\") {\n      // Cascade's `lazy()` is purpose-built for circular relations between\n      // resources and models — recommend it first, not as a footnote.\n      console.log(colors.green(`  ✨ Use lazy() for the back-reference`));\n      console.log(\n        colors.dim(\n          `   ${kind === \"resource\" ? \"Resources\" : \"Models\"} that reference each other should declare`,\n        ),\n      );\n      console.log(colors.dim(`   one side with lazy() so the import resolves at access time:`));\n      console.log(\"\");\n      console.log(colors.dim(`     import { lazy } from \"@warlock.js/cascade\";`));\n      console.log(colors.dim(`     // inside ${fileB}:`));\n      console.log(\n        colors.dim(\n          `     other: lazy(() => ${kind === \"resource\" ? \"OtherResource\" : \"OtherModel\"})`,\n        ),\n      );\n      console.log(\"\");\n    } else {\n      // Generic cycle — dynamic import is the most common reliable fix.\n      console.log(colors.green(`  ✨ Convert one edge to a dynamic import`));\n      console.log(colors.dim(`   In ${fileB}, change:`));\n      console.log(colors.dim(`     import { SomeClass } from \"./${stripExt(fileA)}\";`));\n      console.log(colors.dim(`   To:`));\n      console.log(colors.dim(`     const { SomeClass } = await import(\"./${stripExt(fileA)}\");`));\n      console.log(\"\");\n    }\n\n    console.log(colors.dim(\"  Other options:\"));\n    console.log(colors.dim(\"    • Extract the shared symbols into a third file both can import.\"));\n    console.log(\n      colors.dim(\"    • Pass the dependency as a constructor/function parameter instead.\"),\n    );\n    console.log(\"\");\n\n    console.log(colors.dim(\"━\".repeat(60)));\n    console.log(colors.dim(\"   Circular dependencies can cause HMR issues and hard-to-debug\"));\n    console.log(colors.dim(\"   initialization order problems. Consider refactoring.\"));\n    console.log(\"\");\n  }\n\n  /**\n   * Get statistics about the dependency graph\n   */\n  public getStats() {\n    let totalDependencies = 0;\n    let maxDependencies = 0;\n    let maxDependents = 0;\n    let mostDependedFile = \"\";\n    let mostDependingFile = \"\";\n\n    for (const [file, deps] of this.dependencies) {\n      totalDependencies += deps.size;\n      if (deps.size > maxDependencies) {\n        maxDependencies = deps.size;\n        mostDependingFile = file;\n      }\n    }\n\n    for (const [file, deps] of this.dependents) {\n      if (deps.size > maxDependents) {\n        maxDependents = deps.size;\n        mostDependedFile = file;\n      }\n    }\n\n    return {\n      totalFiles: this.dependencies.size,\n      totalDependencies,\n      avgDependenciesPerFile: totalDependencies / this.dependencies.size || 0,\n      maxDependencies,\n      maxDependents,\n      mostDependingFile,\n      mostDependedFile,\n    };\n  }\n}\n\n/**\n * Pick the most useful \"fix-it\" hint for a cycle by inspecting the file\n * extensions involved. Cascade resources/models have a first-class fix\n * (`lazy()`); generic cycles just want a dynamic import.\n */\nfunction classifyCycle(cycle: string[]): \"resource\" | \"model\" | \"generic\" {\n  const files = cycle.slice(0, -1); // last entry repeats the first\n  if (files.every((file) => file.endsWith(\".resource.ts\") || file.endsWith(\".resource.tsx\"))) {\n    return \"resource\";\n  }\n  if (files.every((file) => file.endsWith(\".model.ts\") || file.endsWith(\".model.tsx\"))) {\n    return \"model\";\n  }\n  return \"generic\";\n}\n"],"mappings":"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"}

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

@@ -2,7 +2,7 @@ import { Path } from "../utils/normalized-path.mjs";
 import { colors } from "@mongez/copper";
 import dayjs from "dayjs";
 
-//#region ../core/src/dev-server/dev-logger.ts
+//#region ../../packages/core/src/dev-server/dev-logger.ts
 /**
 * Dev server logger — Vite-style formatting helpers.
 */

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

@@ -1 +1 @@
-{"version":3,"file":"dev-logger.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/dev-logger.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport dayjs from \"dayjs\";\nimport { Path } from \"../utils/normalized-path\";\n\n/**\n * Dev server logger — Vite-style formatting helpers.\n */\n\nfunction timestamp(): string {\n  return colors.dim(`${dayjs().format(\"HH:mm:ss A\")}`);\n}\n\nexport function devLog(message: string) {\n  console.log(`${timestamp()} ${message}`);\n}\n\nexport function devLogSuccess(message: string) {\n  console.log(`${timestamp()} ${colors.green(\"✓\")} ${colors.green(message)}`);\n}\n\n/**\n * Colourise a stack trace so the eye lands on *your* code.\n *\n * - Error header (`ReferenceError: x is not defined`) → bold red.\n * - Frames in project `src/` → highlighted: a green `›` pointer, yellow\n *   function name, cyan relative path, dim `:line:col`. These are almost\n *   always where the bug is.\n * - Framework (`@warlock.js`), `node_modules`, and `node:` internal frames\n *   → dimmed and relativised. Still there for context, just out of the way.\n *\n * Source maps are enabled in dev, so the paths/lines here are already the\n * original `.ts` locations — this only changes how they're painted.\n */\nexport function formatErrorStack(stack: string): string {\n  const frame = /^(\\s*)at (.+?) \\((.+):(\\d+):(\\d+)\\)$/;\n  const bareFrame = /^(\\s*)at (.+):(\\d+):(\\d+)$/;\n  let headerDone = false;\n\n  return stack\n    .split(\"\\n\")\n    .map((line) => {\n      const withFn = line.match(frame);\n      const bare = line.match(bareFrame);\n\n      if (!withFn && !bare) {\n        // Header line(s) before the first frame.\n        const painted = headerDone ? colors.dim(line) : colors.bold(colors.red(line));\n        return painted;\n      }\n\n      headerDone = true;\n\n      // Every read here is defaulted rather than asserted, and the reason is\n      // what this function IS: a stack-trace formatter. If it throws while\n      // formatting, it throws INSIDE error reporting — and what the developer\n      // then sees is this function's failure instead of the error they were\n      // actually chasing. An unreadable frame should degrade to a blank field,\n      // never take the report down with it — every fatal needs an\n      // unconditional floor.\n      const fn = (withFn ? withFn[2] : \"\") ?? \"\";\n      const file = (withFn ? withFn[3] : bare?.[2]) ?? \"\";\n      const lineNo = (withFn ? withFn[4] : bare?.[3]) ?? \"\";\n      const col = (withFn ? withFn[5] : bare?.[4]) ?? \"\";\n\n      const isNodeInternal = file.startsWith(\"node:\");\n      const isDep = file.includes(\"node_modules\");\n      const isFramework = /[\\\\/]@warlock\\.js[\\\\/]/.test(file);\n      const isUserCode = !isNodeInternal && !isDep && !isFramework;\n\n      const rel = isNodeInternal ? file : Path.toRelative(file);\n      const loc = `:${lineNo}:${col}`;\n\n      if (isUserCode) {\n        return (\n          `  ${colors.green(\"›\")} ${colors.dim(\"at\")} ` +\n          `${colors.yellow(fn || \"<anonymous>\")} ` +\n          `${colors.cyan(rel)}${colors.dim(loc)}`\n        );\n      }\n\n      const label = fn ? `at ${fn} ${rel}${loc}` : `at ${rel}${loc}`;\n      return `    ${colors.dim(label)}`;\n    })\n    .join(\"\\n\");\n}\n\nexport function devLogError(message: string, error?: any) {\n  console.log(`${timestamp()} ${colors.red(\"✗\")} ${colors.red(message)}`);\n  if (error?.stack) console.log(formatErrorStack(error.stack));\n}\n\nexport function devLogWarn(message: string) {\n  console.log(`${timestamp()} ${colors.yellow(\"⚠\")} ${colors.yellow(message)}`);\n}\n\nexport function devLogInfo(message: string) {\n  console.log(`${timestamp()} ${colors.cyan(message)}`);\n}\n\nexport function devLogDim(message: string) {\n  console.log(`${timestamp()} ${colors.dim(message)}`);\n}\n\nexport function devLogHMR(file: string, dependents?: number, durationMs?: number) {\n  const relativePath = Path.toRelative(file);\n  const depInfo = dependents\n    ? colors.dim(` +${dependents} module${dependents > 1 ? \"s\" : \"\"}`)\n    : \"\";\n  const durationInfo = durationMs !== undefined ? colors.dim(` (${durationMs}ms)`) : \"\";\n  console.log(\n    `${timestamp()} 🔥 ${colors.green(\"hmr update\")} ${colors.dim(relativePath)}${depInfo}${durationInfo}`,\n  );\n}\n\n/**\n * Per-phase breakdown for one hot reload, printed only when\n * `devServer.timings` is on. Phases run in this order: the watcher's\n * `awaitWriteFinish` settle wait, this handler's own debounce wait,\n * module-graph invalidation (version bumps), re-import of the changed\n * modules, and connector restart/rebind.\n */\nexport type ReloadPhaseTimings = {\n  watcherSettleMs: number;\n  debounceWaitMs: number;\n  moduleGraphInvalidationMs: number;\n  reimportMs: number;\n  connectorRestartMs: number;\n};\n\nexport function devLogTimings(timings: ReloadPhaseTimings) {\n  const phase = (label: string, ms: number) => `${colors.dim(label)} ${colors.dim(`${Math.round(ms)}ms`)}`;\n  const line = [\n    phase(\"watcher\", timings.watcherSettleMs),\n    phase(\"debounce\", timings.debounceWaitMs),\n    phase(\"graph\", timings.moduleGraphInvalidationMs),\n    phase(\"reimport\", timings.reimportMs),\n    phase(\"connectors\", timings.connectorRestartMs),\n  ].join(colors.dim(\" · \"));\n  console.log(`${timestamp()}   ${colors.dim(\"⏱\")} ${line}`);\n}\n\nexport function devLogConfig(file: string, connectors?: string[]) {\n  const relativePath = Path.toRelative(file);\n  const connectorInfo =\n    connectors && connectors.length > 0 ? colors.dim(` → restarting ${connectors.join(\", \")}`) : \"\";\n  console.log(\n    `${timestamp()} ${colors.cyan(\"config reload\")} ${colors.dim(relativePath)}${connectorInfo}`,\n  );\n}\n\nexport function devLogReady(message: string) {\n  console.log(`\\n${timestamp()}  ${colors.green(\"➜\")}  ${colors.bold(message)}`);\n}\n\nexport function devLogSection(title: string) {\n  console.log(`\\n${timestamp()} ${colors.bold(colors.cyan(title))}`);\n}\n\n/**\n * Format ERR_MODULE_NOT_FOUND so the displayed paths are relative to the\n * project root. The loader hook keeps source paths in the URL so we only\n * need to strip the absolute prefix — no cache-path translation any more.\n */\nexport function formatModuleNotFoundError(error: Error, suggestions?: string[]): string {\n  const match = error.message.match(/Cannot find module '([^']+)' imported from '([^']+)'/);\n  if (!match) return error.message;\n\n  // Same rule as the frame formatter above: this renders a MODULE NOT FOUND\n  // report, so a missing capture must degrade the message, not replace the\n  // user's error with a crash inside the reporter.\n  const [, rawModulePath, rawImporterPath] = match;\n  const modulePath = rawModulePath ?? \"\";\n  const importerPath = rawImporterPath ?? \"\";\n  const lines: string[] = [\n    \"\",\n    `${colors.red(\"❌ MODULE NOT FOUND\")}`,\n    \"\",\n    `${colors.dim(\"Cannot find:\")} ${colors.cyan(Path.toRelative(modulePath))}`,\n    \"\",\n    `${colors.dim(\"Imported by:\")}`,\n    `  ${colors.yellow(\"→\")} ${colors.white(Path.toRelative(importerPath))}`,\n  ];\n\n  if (suggestions && suggestions.length > 0) {\n    lines.push(\"\");\n    lines.push(`${colors.dim(\"Did you mean?\")}`);\n    suggestions.forEach((s) => lines.push(`  ${colors.cyan(\"→\")} ${colors.green(s)}`));\n  }\n\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n\n/** @deprecated alias retained for older callers. Use `devLog` directly. */\nexport const devServeLog = devLog;\n"],"mappings":"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"}
+{"version":3,"file":"dev-logger.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/dev-logger.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport dayjs from \"dayjs\";\nimport { Path } from \"../utils/normalized-path\";\n\n/**\n * Dev server logger — Vite-style formatting helpers.\n */\n\nfunction timestamp(): string {\n  return colors.dim(`${dayjs().format(\"HH:mm:ss A\")}`);\n}\n\nexport function devLog(message: string) {\n  console.log(`${timestamp()} ${message}`);\n}\n\nexport function devLogSuccess(message: string) {\n  console.log(`${timestamp()} ${colors.green(\"✓\")} ${colors.green(message)}`);\n}\n\n/**\n * Colourise a stack trace so the eye lands on *your* code.\n *\n * - Error header (`ReferenceError: x is not defined`) → bold red.\n * - Frames in project `src/` → highlighted: a green `›` pointer, yellow\n *   function name, cyan relative path, dim `:line:col`. These are almost\n *   always where the bug is.\n * - Framework (`@warlock.js`), `node_modules`, and `node:` internal frames\n *   → dimmed and relativised. Still there for context, just out of the way.\n *\n * Source maps are enabled in dev, so the paths/lines here are already the\n * original `.ts` locations — this only changes how they're painted.\n */\nexport function formatErrorStack(stack: string): string {\n  const frame = /^(\\s*)at (.+?) \\((.+):(\\d+):(\\d+)\\)$/;\n  const bareFrame = /^(\\s*)at (.+):(\\d+):(\\d+)$/;\n  let headerDone = false;\n\n  return stack\n    .split(\"\\n\")\n    .map((line) => {\n      const withFn = line.match(frame);\n      const bare = line.match(bareFrame);\n\n      if (!withFn && !bare) {\n        // Header line(s) before the first frame.\n        const painted = headerDone ? colors.dim(line) : colors.bold(colors.red(line));\n        return painted;\n      }\n\n      headerDone = true;\n\n      // Every read here is defaulted rather than asserted, and the reason is\n      // what this function IS: a stack-trace formatter. If it throws while\n      // formatting, it throws INSIDE error reporting — and what the developer\n      // then sees is this function's failure instead of the error they were\n      // actually chasing. An unreadable frame should degrade to a blank field,\n      // never take the report down with it — every fatal needs an\n      // unconditional floor.\n      const fn = (withFn ? withFn[2] : \"\") ?? \"\";\n      const file = (withFn ? withFn[3] : bare?.[2]) ?? \"\";\n      const lineNo = (withFn ? withFn[4] : bare?.[3]) ?? \"\";\n      const col = (withFn ? withFn[5] : bare?.[4]) ?? \"\";\n\n      const isNodeInternal = file.startsWith(\"node:\");\n      const isDep = file.includes(\"node_modules\");\n      const isFramework = /[\\\\/]@warlock\\.js[\\\\/]/.test(file);\n      const isUserCode = !isNodeInternal && !isDep && !isFramework;\n\n      const rel = isNodeInternal ? file : Path.toRelative(file);\n      const loc = `:${lineNo}:${col}`;\n\n      if (isUserCode) {\n        return (\n          `  ${colors.green(\"›\")} ${colors.dim(\"at\")} ` +\n          `${colors.yellow(fn || \"<anonymous>\")} ` +\n          `${colors.cyan(rel)}${colors.dim(loc)}`\n        );\n      }\n\n      const label = fn ? `at ${fn} ${rel}${loc}` : `at ${rel}${loc}`;\n      return `    ${colors.dim(label)}`;\n    })\n    .join(\"\\n\");\n}\n\nexport function devLogError(message: string, error?: any) {\n  console.log(`${timestamp()} ${colors.red(\"✗\")} ${colors.red(message)}`);\n  if (error?.stack) console.log(formatErrorStack(error.stack));\n}\n\nexport function devLogWarn(message: string) {\n  console.log(`${timestamp()} ${colors.yellow(\"⚠\")} ${colors.yellow(message)}`);\n}\n\nexport function devLogInfo(message: string) {\n  console.log(`${timestamp()} ${colors.cyan(message)}`);\n}\n\nexport function devLogDim(message: string) {\n  console.log(`${timestamp()} ${colors.dim(message)}`);\n}\n\nexport function devLogHMR(file: string, dependents?: number, durationMs?: number) {\n  const relativePath = Path.toRelative(file);\n  const depInfo = dependents\n    ? colors.dim(` +${dependents} module${dependents > 1 ? \"s\" : \"\"}`)\n    : \"\";\n  const durationInfo = durationMs !== undefined ? colors.dim(` (${durationMs}ms)`) : \"\";\n  console.log(\n    `${timestamp()} 🔥 ${colors.green(\"hmr update\")} ${colors.dim(relativePath)}${depInfo}${durationInfo}`,\n  );\n}\n\n/**\n * Per-phase breakdown for one hot reload, printed only when\n * `devServer.timings` is on. Phases run in this order: the watcher's\n * `awaitWriteFinish` settle wait, this handler's own debounce wait,\n * module-graph invalidation (version bumps), re-import of the changed\n * modules, and connector restart/rebind.\n */\nexport type ReloadPhaseTimings = {\n  watcherSettleMs: number;\n  debounceWaitMs: number;\n  moduleGraphInvalidationMs: number;\n  reimportMs: number;\n  connectorRestartMs: number;\n};\n\nexport function devLogTimings(timings: ReloadPhaseTimings) {\n  const phase = (label: string, ms: number) => `${colors.dim(label)} ${colors.dim(`${Math.round(ms)}ms`)}`;\n  const line = [\n    phase(\"watcher\", timings.watcherSettleMs),\n    phase(\"debounce\", timings.debounceWaitMs),\n    phase(\"graph\", timings.moduleGraphInvalidationMs),\n    phase(\"reimport\", timings.reimportMs),\n    phase(\"connectors\", timings.connectorRestartMs),\n  ].join(colors.dim(\" · \"));\n  console.log(`${timestamp()}   ${colors.dim(\"⏱\")} ${line}`);\n}\n\nexport function devLogConfig(file: string, connectors?: string[]) {\n  const relativePath = Path.toRelative(file);\n  const connectorInfo =\n    connectors && connectors.length > 0 ? colors.dim(` → restarting ${connectors.join(\", \")}`) : \"\";\n  console.log(\n    `${timestamp()} ${colors.cyan(\"config reload\")} ${colors.dim(relativePath)}${connectorInfo}`,\n  );\n}\n\nexport function devLogReady(message: string) {\n  console.log(`\\n${timestamp()}  ${colors.green(\"➜\")}  ${colors.bold(message)}`);\n}\n\nexport function devLogSection(title: string) {\n  console.log(`\\n${timestamp()} ${colors.bold(colors.cyan(title))}`);\n}\n\n/**\n * Format ERR_MODULE_NOT_FOUND so the displayed paths are relative to the\n * project root. The loader hook keeps source paths in the URL so we only\n * need to strip the absolute prefix — no cache-path translation any more.\n */\nexport function formatModuleNotFoundError(error: Error, suggestions?: string[]): string {\n  const match = error.message.match(/Cannot find module '([^']+)' imported from '([^']+)'/);\n  if (!match) return error.message;\n\n  // Same rule as the frame formatter above: this renders a MODULE NOT FOUND\n  // report, so a missing capture must degrade the message, not replace the\n  // user's error with a crash inside the reporter.\n  const [, rawModulePath, rawImporterPath] = match;\n  const modulePath = rawModulePath ?? \"\";\n  const importerPath = rawImporterPath ?? \"\";\n  const lines: string[] = [\n    \"\",\n    `${colors.red(\"❌ MODULE NOT FOUND\")}`,\n    \"\",\n    `${colors.dim(\"Cannot find:\")} ${colors.cyan(Path.toRelative(modulePath))}`,\n    \"\",\n    `${colors.dim(\"Imported by:\")}`,\n    `  ${colors.yellow(\"→\")} ${colors.white(Path.toRelative(importerPath))}`,\n  ];\n\n  if (suggestions && suggestions.length > 0) {\n    lines.push(\"\");\n    lines.push(`${colors.dim(\"Did you mean?\")}`);\n    suggestions.forEach((s) => lines.push(`  ${colors.cyan(\"→\")} ${colors.green(s)}`));\n  }\n\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n\n/** @deprecated alias retained for older callers. Use `devLog` directly. */\nexport const devServeLog = devLog;\n"],"mappings":"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"}

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

@@ -22,7 +22,7 @@ import { colors } from "@mongez/copper";
 import events from "@mongez/events";
 import { fileExistsAsync, unlinkAsync } from "@warlock.js/fs";
 
-//#region ../core/src/dev-server/development-server.ts
+//#region ../../packages/core/src/dev-server/development-server.ts
 /**
 * Top-level coordinator for `warlock dev`. Wires the file orchestrator, the
 * connectors, and the layer executor together, and listens for the watcher's

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

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

package/esm/dev-server/events.mjs

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

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

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

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

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

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"file-event-handler.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/file-event-handler.ts"],"sourcesContent":["import events from \"@mongez/events\";\nimport type { DependencyGraph } from \"./dependency-graph\";\nimport { devLogSuccess } from \"./dev-logger\";\nimport type { FileManager } from \"./file-manager\";\nimport type { FileOperations } from \"./file-operations\";\nimport { FILE_PROCESSING_BATCH_SIZE, isTimingsEnabled } from \"./flags\";\nimport type { ManifestManager } from \"./manifest-manager\";\nimport { clearFileExistsCache } from \"./parse-imports\";\nimport { isCodeFile } from \"./special-file-patterns\";\nimport { Path } from \"../utils/normalized-path\";\n\n/** Lets an isolated editor save reach HMR without the former fixed 50ms delay. */\nconst ISOLATED_SAVE_QUIET_WINDOW_MS = 12;\n\n/** Bounds a sustained formatter or checkout stream so it cannot postpone HMR forever. */\nconst BATCH_MAX_WAIT_MS = 60;\n\n/**\n * Receives raw watcher events and processes them in a single debounced batch.\n * Order within a batch: adds → changes → deletes, so changes can reference\n * newly-added files and deletes fire last.\n */\nexport class FileEventHandler {\n  private pendingChanges = new Set<string>();\n  private pendingAdds = new Set<string>();\n  private pendingDeletes = new Set<string>();\n\n  /** When this batch's first watcher event arrived — the debounce-wait phase start. */\n  private batchStartedAt?: number;\n\n  /** Slowest watcher-settle duration seen so far this batch, when `devServer.timings` is on. */\n  private watcherSettleMs?: number;\n\n  /** Tail of the batch-processing chain; keeps batches strictly sequential. */\n  private batchQueue: Promise<void> = Promise.resolve();\n\n  private debounceTimer?: ReturnType<typeof setTimeout>;\n  private maxWaitTimer?: ReturnType<typeof setTimeout>;\n\n  constructor(\n    private readonly fileOperations: FileOperations,\n    private readonly manifest: ManifestManager,\n    private readonly dependencyGraph: DependencyGraph,\n    private readonly files: Map<string, FileManager>,\n  ) {}\n\n  /** Matches paths the user listed in `devServer.watch.include`. */\n  private includeMatcher: (path: string) => boolean = () => false;\n\n  /**\n   * Non-code files in the include set (`.sql` fixtures, JSON config) can't be\n   * hot-reloaded, so they are reported as restart triggers instead.\n   */\n  public setIncludeMatcher(matcher: (path: string) => boolean): void {\n    this.includeMatcher = matcher;\n  }\n\n  public handleFileChange(absolutePath: string, settleMs?: number): void {\n    this.recordTimingStart(settleMs);\n    this.pendingChanges.add(Path.toRelative(absolutePath));\n    this.schedulePendingEvents();\n  }\n\n  public handleFileAdd(absolutePath: string, settleMs?: number): void {\n    this.recordTimingStart(settleMs);\n    this.pendingAdds.add(Path.toRelative(absolutePath));\n    this.schedulePendingEvents();\n  }\n\n  public handleFileDelete(absolutePath: string, settleMs?: number): void {\n    this.recordTimingStart(settleMs);\n    this.pendingDeletes.add(Path.toRelative(absolutePath));\n    this.schedulePendingEvents();\n  }\n\n  private schedulePendingEvents(): void {\n    if (this.debounceTimer !== undefined) {\n      clearTimeout(this.debounceTimer);\n    }\n\n    this.debounceTimer = setTimeout(() => this.flushPendingEvents(), ISOLATED_SAVE_QUIET_WINDOW_MS);\n\n    if (this.maxWaitTimer === undefined) {\n      this.maxWaitTimer = setTimeout(() => this.flushPendingEvents(), BATCH_MAX_WAIT_MS);\n    }\n  }\n\n  private flushPendingEvents(): void {\n    if (this.debounceTimer !== undefined) {\n      clearTimeout(this.debounceTimer);\n      this.debounceTimer = undefined;\n    }\n\n    if (this.maxWaitTimer !== undefined) {\n      clearTimeout(this.maxWaitTimer);\n      this.maxWaitTimer = undefined;\n    }\n\n    // Serialize: a batch arriving while the previous one is in flight queues\n    // behind it (pending sets keep coalescing meanwhile) instead of racing it.\n    this.batchQueue = this.batchQueue\n      .then(() => this.processBatch())\n      .catch((error) => {\n        console.error(\"[dev-server] batch processing failed\", error);\n      });\n  }\n\n  /**\n   * Mark the debounce-wait phase start on the first event of a batch, and\n   * track the slowest watcher-settle duration seen this batch. `settleMs`\n   * only arrives when `devServer.timings` is on (see `FilesWatcher`), so\n   * this is a no-op past the cheap `performance.now()` call when it's off.\n   */\n  private recordTimingStart(settleMs?: number): void {\n    if (this.batchStartedAt === undefined) {\n      this.batchStartedAt = performance.now();\n    }\n\n    if (settleMs === undefined) return;\n\n    this.watcherSettleMs =\n      this.watcherSettleMs === undefined ? settleMs : Math.max(this.watcherSettleMs, settleMs);\n  }\n\n  private async processBatch(): Promise<void> {\n    const changes = Array.from(this.pendingChanges);\n    const adds = Array.from(this.pendingAdds);\n    const deletes = Array.from(this.pendingDeletes);\n\n    this.pendingChanges.clear();\n    this.pendingAdds.clear();\n    this.pendingDeletes.clear();\n\n    const debounceWaitMs =\n      this.batchStartedAt !== undefined ? performance.now() - this.batchStartedAt : undefined;\n    const watcherSettleMs = this.watcherSettleMs;\n    this.batchStartedAt = undefined;\n    this.watcherSettleMs = undefined;\n\n    if (changes.length === 0 && adds.length === 0 && deletes.length === 0) return;\n\n    // Both .env files and warlock.config.ts live outside src/ — they should\n    // never enter the dep graph, only ride along in the batch event so the\n    // dev server can react (config reload / restart warning).\n    const isIncludedData = (p: string) => !isCodeFile(p) && this.includeMatcher(p);\n    const isExternal = (p: string) => isExternalPath(p) || isIncludedData(p);\n    const externalChanges = changes.filter(isExternal);\n    const externalAdds = adds.filter(isExternal);\n    const codeChanges = changes.filter((p) => !isExternal(p));\n    const codeAdds = adds.filter((p) => !isExternal(p));\n    const restartTriggers = [...changes, ...adds, ...deletes].filter(isIncludedData);\n\n    // Multi-file batches can race the filesystem on Windows.\n    if (codeAdds.length + codeChanges.length > 1) {\n      await new Promise((resolve) => setTimeout(resolve, 500));\n      clearFileExistsCache();\n    }\n\n    const { added: addedCodePaths, vanished } = await this.processBatchAdds(codeAdds);\n    const changedCodePaths = await this.processBatchChanges(codeChanges);\n    await this.processBatchDeletes(deletes);\n\n    this.fileOperations.updateFileDependents();\n    this.fileOperations.syncFilesToManifest();\n    await this.manifest.save();\n\n    // Emit only the code paths that genuinely changed (hash differs). A no-op\n    // save — an editor that fsyncs without writing — reports no change and is\n    // dropped here, where we still know the pre-change hash. (Doing this\n    // downstream is impossible: the source has already been overwritten, so a\n    // content compare always looks unchanged — which is exactly why emptying a\n    // file used to silently skip HMR.) External paths (.env / warlock.config.ts)\n    // ride along untouched so the dev server can still react to them. Paths\n    // that vanished between the add event and their read/stat (a rename or\n    // move racing the filesystem) are folded into `deleted` instead of\n    // `added` — they were already unwound as deletions in processBatchAdds.\n    events.trigger(\"dev-server:batch-complete\", {\n      added: [...externalAdds, ...addedCodePaths],\n      changed: [...externalChanges, ...changedCodePaths],\n      deleted: [...deletes.filter((p) => !isIncludedData(p)), ...vanished],\n      restartTriggers,\n      timings: isTimingsEnabled()\n        ? { watcherSettleMs: watcherSettleMs ?? 0, debounceWaitMs: debounceWaitMs ?? 0 }\n        : undefined,\n    });\n  }\n\n  /**\n   * Reprocess each changed file and return only the paths that genuinely\n   * changed. `updateFile` returns false when the on-disk hash matches the\n   * last-processed hash (e.g. an editor that fsyncs on save without writing),\n   * so those no-ops are kept out of the reload batch. Emptying a file changes\n   * its hash, so it is correctly reported as changed.\n   */\n  private async processBatchChanges(relativePaths: string[]): Promise<string[]> {\n    const changed: string[] = [];\n    await runInBatches(relativePaths, FILE_PROCESSING_BATCH_SIZE, async (path) => {\n      if (await this.fileOperations.updateFile(path)) {\n        changed.push(path);\n      }\n    });\n    return changed;\n  }\n\n  /**\n   * Process pending add events. Returns the paths that genuinely became\n   * available (`added`) separately from paths that no longer existed by the\n   * time they were read/stat'd (`vanished`) — the latter is a rename or move\n   * racing the filesystem, not a failure, so it is unwound as a deletion\n   * instead of being logged as an error.\n   */\n  private async processBatchAdds(\n    relativePaths: string[],\n  ): Promise<{ added: string[]; vanished: string[] }> {\n    const added: string[] = [];\n    const vanished: string[] = [];\n\n    await runInBatches(relativePaths, FILE_PROCESSING_BATCH_SIZE, async (path) => {\n      try {\n        const fileManager = await this.fileOperations.addFile(path);\n\n        if (fileManager.state === \"deleted\") {\n          await this.fileOperations.deleteFile(path);\n          vanished.push(path);\n          return;\n        }\n\n        added.push(path);\n        devLogSuccess(`Added file: ${path}`);\n      } catch (error) {\n        console.error(`Failed to add file ${path}:`, error);\n      }\n    });\n\n    return { added, vanished };\n  }\n\n  private async processBatchDeletes(relativePaths: string[]): Promise<void> {\n    for (const relativePath of relativePaths) {\n      await this.fileOperations.deleteFile(relativePath);\n      devLogSuccess(`Deleted file: ${relativePath}`);\n    }\n  }\n}\n\nfunction isEnvFile(path: string): boolean {\n  const basename = path.split(\"/\").pop() || path;\n  return basename === \".env\" || basename.startsWith(\".env.\");\n}\n\n/** Paths watched but never added to the dependency graph. */\nfunction isExternalPath(path: string): boolean {\n  return isEnvFile(path) || path === \"warlock.config.ts\";\n}\n\nasync function runInBatches<T>(\n  items: T[],\n  size: number,\n  fn: (item: T) => Promise<unknown>,\n): Promise<void> {\n  if (items.length === 0) return;\n  for (let i = 0; i < items.length; i += size) {\n    await Promise.all(items.slice(i, i + size).map(fn));\n  }\n}\n"],"mappings":";;;;;;;;;AAYA,MAAM,gCAAgC;;AAGtC,MAAM,oBAAoB;;;;;;AAO1B,IAAa,mBAAb,MAA8B;CAiB5B,YACE,AAAiB,gBACjB,AAAiB,UACjB,AAAiB,iBACjB,AAAiB,OACjB;EAJiB;EACA;EACA;EACA;wCApBM,IAAI,IAAY;qCACnB,IAAI,IAAY;wCACb,IAAI,IAAY;oBASL,QAAQ,QAAQ;8BAaM;CAHvD;;;;;CASH,AAAO,kBAAkB,SAA0C;EACjE,KAAK,iBAAiB;CACxB;CAEA,AAAO,iBAAiB,cAAsB,UAAyB;EACrE,KAAK,kBAAkB,QAAQ;EAC/B,KAAK,eAAe,IAAI,KAAK,WAAW,YAAY,CAAC;EACrD,KAAK,sBAAsB;CAC7B;CAEA,AAAO,cAAc,cAAsB,UAAyB;EAClE,KAAK,kBAAkB,QAAQ;EAC/B,KAAK,YAAY,IAAI,KAAK,WAAW,YAAY,CAAC;EAClD,KAAK,sBAAsB;CAC7B;CAEA,AAAO,iBAAiB,cAAsB,UAAyB;EACrE,KAAK,kBAAkB,QAAQ;EAC/B,KAAK,eAAe,IAAI,KAAK,WAAW,YAAY,CAAC;EACrD,KAAK,sBAAsB;CAC7B;CAEA,AAAQ,wBAA8B;EACpC,IAAI,KAAK,kBAAkB,QACzB,aAAa,KAAK,aAAa;EAGjC,KAAK,gBAAgB,iBAAiB,KAAK,mBAAmB,GAAG,6BAA6B;EAE9F,IAAI,KAAK,iBAAiB,QACxB,KAAK,eAAe,iBAAiB,KAAK,mBAAmB,GAAG,iBAAiB;CAErF;CAEA,AAAQ,qBAA2B;EACjC,IAAI,KAAK,kBAAkB,QAAW;GACpC,aAAa,KAAK,aAAa;GAC/B,KAAK,gBAAgB;EACvB;EAEA,IAAI,KAAK,iBAAiB,QAAW;GACnC,aAAa,KAAK,YAAY;GAC9B,KAAK,eAAe;EACtB;EAIA,KAAK,aAAa,KAAK,WACpB,WAAW,KAAK,aAAa,CAAC,CAAC,CAC/B,OAAO,UAAU;GAChB,QAAQ,MAAM,wCAAwC,KAAK;EAC7D,CAAC;CACL;;;;;;;CAQA,AAAQ,kBAAkB,UAAyB;EACjD,IAAI,KAAK,mBAAmB,QAC1B,KAAK,iBAAiB,YAAY,IAAI;EAGxC,IAAI,aAAa,QAAW;EAE5B,KAAK,kBACH,KAAK,oBAAoB,SAAY,WAAW,KAAK,IAAI,KAAK,iBAAiB,QAAQ;CAC3F;CAEA,MAAc,eAA8B;EAC1C,MAAM,UAAU,MAAM,KAAK,KAAK,cAAc;EAC9C,MAAM,OAAO,MAAM,KAAK,KAAK,WAAW;EACxC,MAAM,UAAU,MAAM,KAAK,KAAK,cAAc;EAE9C,KAAK,eAAe,MAAM;EAC1B,KAAK,YAAY,MAAM;EACvB,KAAK,eAAe,MAAM;EAE1B,MAAM,iBACJ,KAAK,mBAAmB,SAAY,YAAY,IAAI,IAAI,KAAK,iBAAiB;EAChF,MAAM,kBAAkB,KAAK;EAC7B,KAAK,iBAAiB;EACtB,KAAK,kBAAkB;EAEvB,IAAI,QAAQ,WAAW,KAAK,KAAK,WAAW,KAAK,QAAQ,WAAW,GAAG;EAKvE,MAAM,kBAAkB,MAAc,CAAC,WAAW,CAAC,KAAK,KAAK,eAAe,CAAC;EAC7E,MAAM,cAAc,MAAc,eAAe,CAAC,KAAK,eAAe,CAAC;EACvE,MAAM,kBAAkB,QAAQ,OAAO,UAAU;EACjD,MAAM,eAAe,KAAK,OAAO,UAAU;EAC3C,MAAM,cAAc,QAAQ,QAAQ,MAAM,CAAC,WAAW,CAAC,CAAC;EACxD,MAAM,WAAW,KAAK,QAAQ,MAAM,CAAC,WAAW,CAAC,CAAC;EAClD,MAAM,kBAAkB;GAAC,GAAG;GAAS,GAAG;GAAM,GAAG;EAAO,CAAC,CAAC,OAAO,cAAc;EAG/E,IAAI,SAAS,SAAS,YAAY,SAAS,GAAG;GAC5C,MAAM,IAAI,SAAS,YAAY,WAAW,SAAS,GAAG,CAAC;GACvD,qBAAqB;EACvB;EAEA,MAAM,EAAE,OAAO,gBAAgB,aAAa,MAAM,KAAK,iBAAiB,QAAQ;EAChF,MAAM,mBAAmB,MAAM,KAAK,oBAAoB,WAAW;EACnE,MAAM,KAAK,oBAAoB,OAAO;EAEtC,KAAK,eAAe,qBAAqB;EACzC,KAAK,eAAe,oBAAoB;EACxC,MAAM,KAAK,SAAS,KAAK;EAYzB,OAAO,QAAQ,6BAA6B;GAC1C,OAAO,CAAC,GAAG,cAAc,GAAG,cAAc;GAC1C,SAAS,CAAC,GAAG,iBAAiB,GAAG,gBAAgB;GACjD,SAAS,CAAC,GAAG,QAAQ,QAAQ,MAAM,CAAC,eAAe,CAAC,CAAC,GAAG,GAAG,QAAQ;GACnE;GACA,SAAS,iBAAiB,IACtB;IAAE,iBAAiB,mBAAmB;IAAG,gBAAgB,kBAAkB;GAAE,IAC7E;EACN,CAAC;CACH;;;;;;;;CASA,MAAc,oBAAoB,eAA4C;EAC5E,MAAM,UAAoB,CAAC;EAC3B,MAAM,aAAa,oBAA2C,OAAO,SAAS;GAC5E,IAAI,MAAM,KAAK,eAAe,WAAW,IAAI,GAC3C,QAAQ,KAAK,IAAI;EAErB,CAAC;EACD,OAAO;CACT;;;;;;;;CASA,MAAc,iBACZ,eACkD;EAClD,MAAM,QAAkB,CAAC;EACzB,MAAM,WAAqB,CAAC;EAE5B,MAAM,aAAa,oBAA2C,OAAO,SAAS;GAC5E,IAAI;IAGF,KAAI,MAFsB,KAAK,eAAe,QAAQ,IAAI,EAE3C,CAAC,UAAU,WAAW;KACnC,MAAM,KAAK,eAAe,WAAW,IAAI;KACzC,SAAS,KAAK,IAAI;KAClB;IACF;IAEA,MAAM,KAAK,IAAI;IACf,cAAc,eAAe,MAAM;GACrC,SAAS,OAAO;IACd,QAAQ,MAAM,sBAAsB,KAAK,IAAI,KAAK;GACpD;EACF,CAAC;EAED,OAAO;GAAE;GAAO;EAAS;CAC3B;CAEA,MAAc,oBAAoB,eAAwC;EACxE,KAAK,MAAM,gBAAgB,eAAe;GACxC,MAAM,KAAK,eAAe,WAAW,YAAY;GACjD,cAAc,iBAAiB,cAAc;EAC/C;CACF;AACF;AAEA,SAAS,UAAU,MAAuB;CACxC,MAAM,WAAW,KAAK,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK;CAC1C,OAAO,aAAa,UAAU,SAAS,WAAW,OAAO;AAC3D;;AAGA,SAAS,eAAe,MAAuB;CAC7C,OAAO,UAAU,IAAI,KAAK,SAAS;AACrC;AAEA,eAAe,aACb,OACA,MACA,IACe;CACf,IAAI,MAAM,WAAW,GAAG;CACxB,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,MACrC,MAAM,QAAQ,IAAI,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAEtD"}
+{"version":3,"file":"file-event-handler.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/file-event-handler.ts"],"sourcesContent":["import events from \"@mongez/events\";\nimport type { DependencyGraph } from \"./dependency-graph\";\nimport { devLogSuccess } from \"./dev-logger\";\nimport type { FileManager } from \"./file-manager\";\nimport type { FileOperations } from \"./file-operations\";\nimport { FILE_PROCESSING_BATCH_SIZE, isTimingsEnabled } from \"./flags\";\nimport type { ManifestManager } from \"./manifest-manager\";\nimport { clearFileExistsCache } from \"./parse-imports\";\nimport { isCodeFile } from \"./special-file-patterns\";\nimport { Path } from \"../utils/normalized-path\";\n\n/** Lets an isolated editor save reach HMR without the former fixed 50ms delay. */\nconst ISOLATED_SAVE_QUIET_WINDOW_MS = 12;\n\n/** Bounds a sustained formatter or checkout stream so it cannot postpone HMR forever. */\nconst BATCH_MAX_WAIT_MS = 60;\n\n/**\n * Receives raw watcher events and processes them in a single debounced batch.\n * Order within a batch: adds → changes → deletes, so changes can reference\n * newly-added files and deletes fire last.\n */\nexport class FileEventHandler {\n  private pendingChanges = new Set<string>();\n  private pendingAdds = new Set<string>();\n  private pendingDeletes = new Set<string>();\n\n  /** When this batch's first watcher event arrived — the debounce-wait phase start. */\n  private batchStartedAt?: number;\n\n  /** Slowest watcher-settle duration seen so far this batch, when `devServer.timings` is on. */\n  private watcherSettleMs?: number;\n\n  /** Tail of the batch-processing chain; keeps batches strictly sequential. */\n  private batchQueue: Promise<void> = Promise.resolve();\n\n  private debounceTimer?: ReturnType<typeof setTimeout>;\n  private maxWaitTimer?: ReturnType<typeof setTimeout>;\n\n  constructor(\n    private readonly fileOperations: FileOperations,\n    private readonly manifest: ManifestManager,\n    private readonly dependencyGraph: DependencyGraph,\n    private readonly files: Map<string, FileManager>,\n  ) {}\n\n  /** Matches paths the user listed in `devServer.watch.include`. */\n  private includeMatcher: (path: string) => boolean = () => false;\n\n  /**\n   * Non-code files in the include set (`.sql` fixtures, JSON config) can't be\n   * hot-reloaded, so they are reported as restart triggers instead.\n   */\n  public setIncludeMatcher(matcher: (path: string) => boolean): void {\n    this.includeMatcher = matcher;\n  }\n\n  public handleFileChange(absolutePath: string, settleMs?: number): void {\n    this.recordTimingStart(settleMs);\n    this.pendingChanges.add(Path.toRelative(absolutePath));\n    this.schedulePendingEvents();\n  }\n\n  public handleFileAdd(absolutePath: string, settleMs?: number): void {\n    this.recordTimingStart(settleMs);\n    this.pendingAdds.add(Path.toRelative(absolutePath));\n    this.schedulePendingEvents();\n  }\n\n  public handleFileDelete(absolutePath: string, settleMs?: number): void {\n    this.recordTimingStart(settleMs);\n    this.pendingDeletes.add(Path.toRelative(absolutePath));\n    this.schedulePendingEvents();\n  }\n\n  private schedulePendingEvents(): void {\n    if (this.debounceTimer !== undefined) {\n      clearTimeout(this.debounceTimer);\n    }\n\n    this.debounceTimer = setTimeout(() => this.flushPendingEvents(), ISOLATED_SAVE_QUIET_WINDOW_MS);\n\n    if (this.maxWaitTimer === undefined) {\n      this.maxWaitTimer = setTimeout(() => this.flushPendingEvents(), BATCH_MAX_WAIT_MS);\n    }\n  }\n\n  private flushPendingEvents(): void {\n    if (this.debounceTimer !== undefined) {\n      clearTimeout(this.debounceTimer);\n      this.debounceTimer = undefined;\n    }\n\n    if (this.maxWaitTimer !== undefined) {\n      clearTimeout(this.maxWaitTimer);\n      this.maxWaitTimer = undefined;\n    }\n\n    // Serialize: a batch arriving while the previous one is in flight queues\n    // behind it (pending sets keep coalescing meanwhile) instead of racing it.\n    this.batchQueue = this.batchQueue\n      .then(() => this.processBatch())\n      .catch((error) => {\n        console.error(\"[dev-server] batch processing failed\", error);\n      });\n  }\n\n  /**\n   * Mark the debounce-wait phase start on the first event of a batch, and\n   * track the slowest watcher-settle duration seen this batch. `settleMs`\n   * only arrives when `devServer.timings` is on (see `FilesWatcher`), so\n   * this is a no-op past the cheap `performance.now()` call when it's off.\n   */\n  private recordTimingStart(settleMs?: number): void {\n    if (this.batchStartedAt === undefined) {\n      this.batchStartedAt = performance.now();\n    }\n\n    if (settleMs === undefined) return;\n\n    this.watcherSettleMs =\n      this.watcherSettleMs === undefined ? settleMs : Math.max(this.watcherSettleMs, settleMs);\n  }\n\n  private async processBatch(): Promise<void> {\n    const changes = Array.from(this.pendingChanges);\n    const adds = Array.from(this.pendingAdds);\n    const deletes = Array.from(this.pendingDeletes);\n\n    this.pendingChanges.clear();\n    this.pendingAdds.clear();\n    this.pendingDeletes.clear();\n\n    const debounceWaitMs =\n      this.batchStartedAt !== undefined ? performance.now() - this.batchStartedAt : undefined;\n    const watcherSettleMs = this.watcherSettleMs;\n    this.batchStartedAt = undefined;\n    this.watcherSettleMs = undefined;\n\n    if (changes.length === 0 && adds.length === 0 && deletes.length === 0) return;\n\n    // Both .env files and warlock.config.ts live outside src/ — they should\n    // never enter the dep graph, only ride along in the batch event so the\n    // dev server can react (config reload / restart warning).\n    const isIncludedData = (p: string) => !isCodeFile(p) && this.includeMatcher(p);\n    const isExternal = (p: string) => isExternalPath(p) || isIncludedData(p);\n    const externalChanges = changes.filter(isExternal);\n    const externalAdds = adds.filter(isExternal);\n    const codeChanges = changes.filter((p) => !isExternal(p));\n    const codeAdds = adds.filter((p) => !isExternal(p));\n    const restartTriggers = [...changes, ...adds, ...deletes].filter(isIncludedData);\n\n    // Multi-file batches can race the filesystem on Windows.\n    if (codeAdds.length + codeChanges.length > 1) {\n      await new Promise((resolve) => setTimeout(resolve, 500));\n      clearFileExistsCache();\n    }\n\n    const { added: addedCodePaths, vanished } = await this.processBatchAdds(codeAdds);\n    const changedCodePaths = await this.processBatchChanges(codeChanges);\n    await this.processBatchDeletes(deletes);\n\n    this.fileOperations.updateFileDependents();\n    this.fileOperations.syncFilesToManifest();\n    await this.manifest.save();\n\n    // Emit only the code paths that genuinely changed (hash differs). A no-op\n    // save — an editor that fsyncs without writing — reports no change and is\n    // dropped here, where we still know the pre-change hash. (Doing this\n    // downstream is impossible: the source has already been overwritten, so a\n    // content compare always looks unchanged — which is exactly why emptying a\n    // file used to silently skip HMR.) External paths (.env / warlock.config.ts)\n    // ride along untouched so the dev server can still react to them. Paths\n    // that vanished between the add event and their read/stat (a rename or\n    // move racing the filesystem) are folded into `deleted` instead of\n    // `added` — they were already unwound as deletions in processBatchAdds.\n    events.trigger(\"dev-server:batch-complete\", {\n      added: [...externalAdds, ...addedCodePaths],\n      changed: [...externalChanges, ...changedCodePaths],\n      deleted: [...deletes.filter((p) => !isIncludedData(p)), ...vanished],\n      restartTriggers,\n      timings: isTimingsEnabled()\n        ? { watcherSettleMs: watcherSettleMs ?? 0, debounceWaitMs: debounceWaitMs ?? 0 }\n        : undefined,\n    });\n  }\n\n  /**\n   * Reprocess each changed file and return only the paths that genuinely\n   * changed. `updateFile` returns false when the on-disk hash matches the\n   * last-processed hash (e.g. an editor that fsyncs on save without writing),\n   * so those no-ops are kept out of the reload batch. Emptying a file changes\n   * its hash, so it is correctly reported as changed.\n   */\n  private async processBatchChanges(relativePaths: string[]): Promise<string[]> {\n    const changed: string[] = [];\n    await runInBatches(relativePaths, FILE_PROCESSING_BATCH_SIZE, async (path) => {\n      if (await this.fileOperations.updateFile(path)) {\n        changed.push(path);\n      }\n    });\n    return changed;\n  }\n\n  /**\n   * Process pending add events. Returns the paths that genuinely became\n   * available (`added`) separately from paths that no longer existed by the\n   * time they were read/stat'd (`vanished`) — the latter is a rename or move\n   * racing the filesystem, not a failure, so it is unwound as a deletion\n   * instead of being logged as an error.\n   */\n  private async processBatchAdds(\n    relativePaths: string[],\n  ): Promise<{ added: string[]; vanished: string[] }> {\n    const added: string[] = [];\n    const vanished: string[] = [];\n\n    await runInBatches(relativePaths, FILE_PROCESSING_BATCH_SIZE, async (path) => {\n      try {\n        const fileManager = await this.fileOperations.addFile(path);\n\n        if (fileManager.state === \"deleted\") {\n          await this.fileOperations.deleteFile(path);\n          vanished.push(path);\n          return;\n        }\n\n        added.push(path);\n        devLogSuccess(`Added file: ${path}`);\n      } catch (error) {\n        console.error(`Failed to add file ${path}:`, error);\n      }\n    });\n\n    return { added, vanished };\n  }\n\n  private async processBatchDeletes(relativePaths: string[]): Promise<void> {\n    for (const relativePath of relativePaths) {\n      await this.fileOperations.deleteFile(relativePath);\n      devLogSuccess(`Deleted file: ${relativePath}`);\n    }\n  }\n}\n\nfunction isEnvFile(path: string): boolean {\n  const basename = path.split(\"/\").pop() || path;\n  return basename === \".env\" || basename.startsWith(\".env.\");\n}\n\n/** Paths watched but never added to the dependency graph. */\nfunction isExternalPath(path: string): boolean {\n  return isEnvFile(path) || path === \"warlock.config.ts\";\n}\n\nasync function runInBatches<T>(\n  items: T[],\n  size: number,\n  fn: (item: T) => Promise<unknown>,\n): Promise<void> {\n  if (items.length === 0) return;\n  for (let i = 0; i < items.length; i += size) {\n    await Promise.all(items.slice(i, i + size).map(fn));\n  }\n}\n"],"mappings":"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"}

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

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

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

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

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

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

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

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

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

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

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

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

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

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