@warlock.js/core 5.29.0 → 5.31.0

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

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

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

@@ -1,4 +1,4 @@
-//#region ../core/src/dev-server/loader/version-registry.ts
+//#region ../../packages/core/src/dev-server/loader/version-registry.ts
 /**
 * Version registry for the ESM loader hook.
 *

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

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

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

@@ -1,7 +1,7 @@
 import { FileManifest } from "./types.mjs";
 import { FileManager } from "./file-manager.mjs";
 
-//#region ../core/src/dev-server/manifest-manager.d.ts
+//#region ../../packages/core/src/dev-server/manifest-manager.d.ts
 declare class ManifestManager {
   private readonly files;
   /**

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

@@ -1 +1 @@
-{"version":3,"file":"manifest-manager.d.mts","names":[],"sources":["../../../../../../../core/src/dev-server/manifest-manager.ts"],"mappings":";;;;cAqBa,eAAA;EAAA,iBAiByB,KAAA;EAAA;;;EAAA,QAb5B,QAAA;EAa+C;;;cAAnB,KAAA,EAAO,GAAA,SAAY,WAAA;EA6B1C;;;;EAvBA,IAAA,IAAQ,OAAA;EA0Cd;;;EAnBM,IAAA,IAAQ,OAAA;EA0B0B;;;EAdxC,OAAA,CAAQ,QAAA,WAAmB,YAAA;EA4B3B;;;EArBA,OAAA,CAAQ,QAAA;EAmCR;;;EA5BA,OAAA,CAAQ,QAAA,UAAkB,YAAA,EAAc,YAAA;;;;EAOxC,UAAA,CAAW,QAAA;EA2CX;;AAAK;EApCL,eAAA;;;;EAOA,WAAA,IAAe,MAAA,SAAe,YAAA;;;;EAO9B,WAAA;;;;;;;;;;;;UAYC,0BAAA;;;;EAUD,KAAA;AAAA"}
+{"version":3,"file":"manifest-manager.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/manifest-manager.ts"],"mappings":";;;;cAqBa,eAAA;EAAA,iBAiByB,KAAA;EAAA;;;EAAA,QAb5B,QAAA;EAa+C;;;cAAnB,KAAA,EAAO,GAAA,SAAY,WAAA;EA6B1C;;;;EAvBA,IAAA,IAAQ,OAAA;EA0Cd;;;EAnBM,IAAA,IAAQ,OAAA;EA0B0B;;;EAdxC,OAAA,CAAQ,QAAA,WAAmB,YAAA;EA4B3B;;;EArBA,OAAA,CAAQ,QAAA;EAmCR;;;EA5BA,OAAA,CAAQ,QAAA,UAAkB,YAAA,EAAc,YAAA;;;;EAOxC,UAAA,CAAW,QAAA;EA2CX;;AAAK;EApCL,eAAA;;;;EAOA,WAAA,IAAe,MAAA,SAAe,YAAA;;;;EAO9B,WAAA;;;;;;;;;;;;UAYC,0BAAA;;;;EAUD,KAAA;AAAA"}

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

@@ -1,7 +1,7 @@
 import { MANIFEST_PATH } from "./flags.mjs";
 import { atomicWriteAsync, fileExistsAsync, getJsonFileAsync } from "@warlock.js/fs";
 
-//#region ../core/src/dev-server/manifest-manager.ts
+//#region ../../packages/core/src/dev-server/manifest-manager.ts
 const MANIFEST_VERSION = "1.0.0";
 var ManifestManager = class {
 	/**

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

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

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

@@ -3,7 +3,7 @@ import path from "node:path";
 import fs from "node:fs";
 import { pathToFileURL } from "node:url";
 
-//#region ../core/src/dev-server/model-module-registry.ts
+//#region ../../packages/core/src/dev-server/model-module-registry.ts
 function normalizeInputPath(absolutePath) {
 	const slashNormalized = path.resolve(absolutePath).replaceAll("\\", "/");
 	return process.platform === "win32" ? slashNormalized.toLowerCase() : slashNormalized;

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

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

package/esm/dev-server/model-resource-typings.mjs

@@ -2,7 +2,7 @@ import { dirname, isAbsolute, relative } from "node:path";
 import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
 import ts from "typescript";
 
-//#region ../core/src/dev-server/model-resource-typings.ts
+//#region ../../packages/core/src/dev-server/model-resource-typings.ts
 const IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
 function hasModifier(node, kind) {
 	return ts.canHaveModifiers(node) && (ts.getModifiers(node)?.some((m) => m.kind === kind) ?? false);

package/esm/dev-server/model-resource-typings.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"model-resource-typings.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/model-resource-typings.ts"],"sourcesContent":["import { mkdir, readFile, rename, rm, writeFile } from \"node:fs/promises\";\nimport { dirname, isAbsolute, relative } from \"node:path\";\nimport ts from \"typescript\";\n\n/**\n * Static `ModelResourceRegistry` generation.\n *\n * `Serialized<User>` can only resolve a model to its resource output through an\n * entry in the augmentable `ModelResourceRegistry` (see `http/serialized.ts`).\n * This module derives those entries from source: a model class that declares\n * `static resource = UserResource` produces\n *\n * ```ts\n * \"User\": { model: import(\"<model file>\").User; resource: typeof import(\"<resource file>\").UserResource };\n * ```\n *\n * Everything here is syntactic. It reads one `ts.createSourceFile` AST per model\n * file, follows the identifier through that file's own imports, and never\n * imports or executes application code (`read-config-ast.ts` explains why a\n * type checker is not an option). Anything it cannot prove from the AST alone\n * (a computed expression, `lazy(...)`, a namespace import, a class that is not\n * exported) is skipped, and nothing is recorded for it: a guessed entry would\n * make `Serialized` lie, which is worse than the raw-data type it falls back to.\n */\n\n/** One model class whose resource could be resolved statically. */\nexport type ModelResourceEntry = {\n  /** The model class name (the registry key before de-duplication). */\n  className: string;\n  /** Absolute path of the model file. */\n  modelFile: string;\n  /** How the model file exports the class: its export name, or `\"default\"`. */\n  modelExport: string;\n  /** Absolute path of the module that exports the resource. */\n  resourceFile: string;\n  /** How that module exports the resource: its export name, or `\"default\"`. */\n  resourceExport: string;\n};\n\n/** A model that declares `static resource` but could not be resolved. */\nexport type SkippedModelResource = {\n  className: string;\n  modelFile: string;\n  reason: string;\n};\n\nexport type ModelResourceExtraction = {\n  entries: ModelResourceEntry[];\n  skipped: SkippedModelResource[];\n};\n\nexport type ExtractModelResourcesInput = {\n  /** Source text of the model file. */\n  source: string;\n  /** Absolute path of the model file. */\n  absolutePath: string;\n  /**\n   * Resolve an import specifier of the model file (relative or tsconfig alias) to\n   * an absolute file path, or `undefined` when it does not point at app source.\n   */\n  resolveImport: (specifier: string) => string | undefined;\n};\n\ntype ImportBinding = { specifier: string; exportName: string };\n\nconst IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\nfunction hasModifier(node: ts.Node, kind: ts.SyntaxKind): boolean {\n  return ts.canHaveModifiers(node) && (ts.getModifiers(node)?.some((m) => m.kind === kind) ?? false);\n}\n\nfunction unwrapParentheses(expression: ts.Expression): ts.Expression {\n  let current = expression;\n\n  while (ts.isParenthesizedExpression(current)) {\n    current = current.expression;\n  }\n\n  return current;\n}\n\n/** Top-level names this file declares, and the names each is exported under. */\nfunction readLocalDeclarations(sourceFile: ts.SourceFile): {\n  declared: Set<string>;\n  exportNames: Map<string, string[]>;\n} {\n  const declared = new Set<string>();\n  const exportNames = new Map<string, string[]>();\n\n  const addExport = (local: string, exported: string): void => {\n    const names = exportNames.get(local) ?? [];\n\n    names.push(exported);\n    exportNames.set(local, names);\n  };\n\n  for (const statement of sourceFile.statements) {\n    const exported = hasModifier(statement, ts.SyntaxKind.ExportKeyword);\n    const isDefault = hasModifier(statement, ts.SyntaxKind.DefaultKeyword);\n\n    if (\n      (ts.isClassDeclaration(statement) ||\n        ts.isFunctionDeclaration(statement) ||\n        ts.isEnumDeclaration(statement)) &&\n      statement.name\n    ) {\n      declared.add(statement.name.text);\n\n      if (exported) {\n        addExport(statement.name.text, isDefault ? \"default\" : statement.name.text);\n      }\n\n      continue;\n    }\n\n    if (ts.isVariableStatement(statement)) {\n      for (const declaration of statement.declarationList.declarations) {\n        if (!ts.isIdentifier(declaration.name)) continue;\n\n        declared.add(declaration.name.text);\n\n        if (exported) {\n          addExport(declaration.name.text, declaration.name.text);\n        }\n      }\n\n      continue;\n    }\n\n    // `export { A, B as C }` (local form only; a `from` clause re-exports a foreign name).\n    if (\n      ts.isExportDeclaration(statement) &&\n      !statement.moduleSpecifier &&\n      !statement.isTypeOnly &&\n      statement.exportClause &&\n      ts.isNamedExports(statement.exportClause)\n    ) {\n      for (const element of statement.exportClause.elements) {\n        if (element.isTypeOnly) continue;\n\n        addExport((element.propertyName ?? element.name).text, element.name.text);\n      }\n\n      continue;\n    }\n\n    // `export default UserResource;`\n    if (\n      ts.isExportAssignment(statement) &&\n      !statement.isExportEquals &&\n      ts.isIdentifier(statement.expression)\n    ) {\n      addExport(statement.expression.text, \"default\");\n    }\n  }\n\n  return { declared, exportNames };\n}\n\n/** Prefer a named export over `default`; among named exports, the first sorted. */\nfunction pickExportName(names: readonly string[] | undefined): string | undefined {\n  if (!names || names.length === 0) return undefined;\n\n  const named = names.filter((name) => name !== \"default\").sort();\n\n  return named[0] ?? \"default\";\n}\n\nfunction readImportBindings(sourceFile: ts.SourceFile): Map<string, ImportBinding> {\n  const bindings = new Map<string, ImportBinding>();\n\n  for (const statement of sourceFile.statements) {\n    if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) {\n      continue;\n    }\n\n    const clause = statement.importClause;\n    const specifier = statement.moduleSpecifier.text;\n\n    if (!clause) continue;\n\n    if (clause.name) {\n      bindings.set(clause.name.text, { specifier, exportName: \"default\" });\n    }\n\n    // A namespace import (`import * as ns`) cannot be the bare identifier a\n    // `static resource = X` reads, so it never becomes a binding.\n    if (clause.namedBindings && ts.isNamedImports(clause.namedBindings)) {\n      for (const element of clause.namedBindings.elements) {\n        bindings.set(element.name.text, {\n          specifier,\n          exportName: (element.propertyName ?? element.name).text,\n        });\n      }\n    }\n  }\n\n  return bindings;\n}\n\n/** The identifier a class assigns to `static resource`, when it is a bare identifier. */\nfunction readStaticResourceReference(\n  member: ts.ClassElement,\n): { name: string } | \"computed\" | undefined {\n  if (!ts.isPropertyDeclaration(member)) return undefined;\n  if (!hasModifier(member, ts.SyntaxKind.StaticKeyword)) return undefined;\n  if (hasModifier(member, ts.SyntaxKind.DeclareKeyword)) return undefined;\n\n  const isResourceName =\n    (ts.isIdentifier(member.name) || ts.isStringLiteral(member.name)) &&\n    member.name.text === \"resource\";\n\n  if (!isResourceName) return undefined;\n  if (!member.initializer) return undefined;\n\n  const initializer = unwrapParentheses(member.initializer);\n\n  return ts.isIdentifier(initializer) ? { name: initializer.text } : \"computed\";\n}\n\n/**\n * Read every model class of one file that declares `static resource = <Identifier>`\n * and resolve it to a model export plus a resource export. Pure: the only\n * outside knowledge is the injected {@link ExtractModelResourcesInput.resolveImport}.\n */\nexport function extractModelResourceEntries(\n  input: ExtractModelResourcesInput,\n): ModelResourceExtraction {\n  const result: ModelResourceExtraction = { entries: [], skipped: [] };\n\n  // Cheap exit: most model files declare no resource.\n  if (!input.source.includes(\"resource\")) return result;\n\n  const sourceFile = ts.createSourceFile(\n    input.absolutePath,\n    input.source,\n    ts.ScriptTarget.ESNext,\n    /* setParentNodes */ false,\n    input.absolutePath.endsWith(\"x\") ? ts.ScriptKind.TSX : ts.ScriptKind.TS,\n  );\n\n  const { declared, exportNames } = readLocalDeclarations(sourceFile);\n  const imports = readImportBindings(sourceFile);\n\n  for (const statement of sourceFile.statements) {\n    if (!ts.isClassDeclaration(statement) || !statement.name) continue;\n\n    const className = statement.name.text;\n\n    let reference: { name: string } | \"computed\" | undefined;\n\n    for (const member of statement.members) {\n      reference = readStaticResourceReference(member) ?? reference;\n    }\n\n    if (reference === undefined) continue;\n\n    const skip = (reason: string): void => {\n      result.skipped.push({ className, modelFile: input.absolutePath, reason });\n    };\n\n    if (reference === \"computed\") {\n      skip(\"`static resource` is not a plain identifier\");\n      continue;\n    }\n\n    const requiresTypeArguments = statement.typeParameters?.some(\n      (parameter) => parameter.default === undefined,\n    );\n\n    if (requiresTypeArguments) {\n      skip(\"the model class is generic\");\n      continue;\n    }\n\n    const modelExport = pickExportName(exportNames.get(className));\n\n    if (modelExport === undefined) {\n      skip(\"the model class is not exported\");\n      continue;\n    }\n\n    if (modelExport !== \"default\" && !IDENTIFIER.test(modelExport)) {\n      skip(\"the model export name is not an identifier\");\n      continue;\n    }\n\n    const binding = imports.get(reference.name);\n\n    let resourceFile: string | undefined;\n    let resourceExport: string | undefined;\n\n    if (binding) {\n      resourceFile = input.resolveImport(binding.specifier);\n      resourceExport = binding.exportName;\n    } else if (declared.has(reference.name)) {\n      resourceFile = input.absolutePath;\n      resourceExport = pickExportName(exportNames.get(reference.name));\n    }\n\n    if (resourceFile === undefined || resourceExport === undefined) {\n      skip(`\\`${reference.name}\\` cannot be resolved to an exported module member`);\n      continue;\n    }\n\n    if (resourceExport !== \"default\" && !IDENTIFIER.test(resourceExport)) {\n      skip(\"the resource export name is not an identifier\");\n      continue;\n    }\n\n    result.entries.push({\n      className,\n      modelFile: input.absolutePath,\n      modelExport,\n      resourceFile,\n      resourceExport,\n    });\n  }\n\n  return result;\n}\n\n/** Module specifier, relative to the typings directory, without a TypeScript extension. */\nfunction toTypeImportSpecifier(typingsDirectory: string, absoluteFile: string): string | undefined {\n  const path = relative(typingsDirectory, absoluteFile).replaceAll(\"\\\\\", \"/\");\n\n  // A different drive (Windows) has no relative form; do not emit a guess.\n  if (isAbsolute(path)) return undefined;\n\n  const withoutExtension = path.replace(/\\.(?:d\\.)?(?:ts|tsx|mts|cts)$/, \"\");\n\n  return withoutExtension.startsWith(\".\") ? withoutExtension : `./${withoutExtension}`;\n}\n\n/**\n * Registry keys: the class name, suffixed `_2`, `_3`, ... when several model\n * files declare the same class name. Order is by class name, then by file path,\n * so the same set of models always yields the same keys and the same text.\n */\nexport function assignRegistryKeys(\n  entries: readonly ModelResourceEntry[],\n): Array<{ key: string; entry: ModelResourceEntry }> {\n  const sorted = [...entries].sort(\n    (a, b) =>\n      a.className.localeCompare(b.className, \"en\") ||\n      a.modelFile.localeCompare(b.modelFile, \"en\") ||\n      a.modelExport.localeCompare(b.modelExport, \"en\"),\n  );\n\n  const taken = new Set<string>();\n  const counts = new Map<string, number>();\n\n  return sorted.map((entry) => {\n    let count = (counts.get(entry.className) ?? 0) + 1;\n    let key = count === 1 ? entry.className : `${entry.className}_${count}`;\n\n    while (taken.has(key)) {\n      count += 1;\n      key = `${entry.className}_${count}`;\n    }\n\n    counts.set(entry.className, count);\n    taken.add(key);\n\n    return { key, entry };\n  });\n}\n\n/**\n * Text of the generated declaration file.\n *\n * @param entries Every resolved model, in any order.\n * @param typingsDirectory Absolute directory the file is written to; import\n * specifiers are relative to it.\n */\nexport function renderModelResourceRegistry(\n  entries: readonly ModelResourceEntry[],\n  typingsDirectory: string,\n): string {\n  const lines: string[] = [];\n\n  for (const { key, entry } of assignRegistryKeys(entries)) {\n    const modelPath = toTypeImportSpecifier(typingsDirectory, entry.modelFile);\n    const resourcePath = toTypeImportSpecifier(typingsDirectory, entry.resourceFile);\n\n    if (modelPath === undefined || resourcePath === undefined) continue;\n\n    const model = `import(${JSON.stringify(modelPath)}).${entry.modelExport}`;\n    const resource = `typeof import(${JSON.stringify(resourcePath)}).${entry.resourceExport}`;\n\n    lines.push(`    ${JSON.stringify(key)}: { model: ${model}; resource: ${resource} };`);\n  }\n\n  return `// Auto-generated by Warlock.js - DO NOT EDIT\n// One entry per model class that declares \\`static resource = <Resource>\\`, so\n// \\`Serialized<Model>\\` resolves to the resource output. Models whose resource\n// cannot be resolved statically are left out.\n\nimport \"@warlock.js/core\";\n\ndeclare module \"@warlock.js/core\" {\n  interface ModelResourceRegistry {\n${lines.join(\"\\n\")}\n  }\n}\n`;\n}\n\n/**\n * Write `content` to `filePath` through a temporary sibling and a rename, so a\n * reader (the editor's TypeScript server) never sees a half-written file, and\n * skip the write entirely when the file already holds exactly this text.\n *\n * @returns `true` when the file was written.\n */\nexport async function writeFileIfChanged(filePath: string, content: string): Promise<boolean> {\n  try {\n    if ((await readFile(filePath, \"utf-8\")) === content) return false;\n  } catch {\n    // Missing file: write it.\n  }\n\n  await mkdir(dirname(filePath), { recursive: true });\n\n  const temporaryPath = `${filePath}.${process.pid}.tmp`;\n\n  try {\n    await writeFile(temporaryPath, content, \"utf-8\");\n    await rename(temporaryPath, filePath);\n  } catch (error) {\n    await rm(temporaryPath, { force: true });\n\n    throw error;\n  }\n\n  return true;\n}\n"],"mappings":";;;;;AAiEA,MAAM,aAAa;AAEnB,SAAS,YAAY,MAAe,MAA8B;CAChE,OAAO,GAAG,iBAAiB,IAAI,MAAM,GAAG,aAAa,IAAI,CAAC,EAAE,MAAM,MAAM,EAAE,SAAS,IAAI,KAAK;AAC9F;AAEA,SAAS,kBAAkB,YAA0C;CACnE,IAAI,UAAU;CAEd,OAAO,GAAG,0BAA0B,OAAO,GACzC,UAAU,QAAQ;CAGpB,OAAO;AACT;;AAGA,SAAS,sBAAsB,YAG7B;CACA,MAAM,2BAAW,IAAI,IAAY;CACjC,MAAM,8BAAc,IAAI,IAAsB;CAE9C,MAAM,aAAa,OAAe,aAA2B;EAC3D,MAAM,QAAQ,YAAY,IAAI,KAAK,KAAK,CAAC;EAEzC,MAAM,KAAK,QAAQ;EACnB,YAAY,IAAI,OAAO,KAAK;CAC9B;CAEA,KAAK,MAAM,aAAa,WAAW,YAAY;EAC7C,MAAM,WAAW,YAAY,WAAW,GAAG,WAAW,aAAa;EACnE,MAAM,YAAY,YAAY,WAAW,GAAG,WAAW,cAAc;EAErE,KACG,GAAG,mBAAmB,SAAS,KAC9B,GAAG,sBAAsB,SAAS,KAClC,GAAG,kBAAkB,SAAS,MAChC,UAAU,MACV;GACA,SAAS,IAAI,UAAU,KAAK,IAAI;GAEhC,IAAI,UACF,UAAU,UAAU,KAAK,MAAM,YAAY,YAAY,UAAU,KAAK,IAAI;GAG5E;EACF;EAEA,IAAI,GAAG,oBAAoB,SAAS,GAAG;GACrC,KAAK,MAAM,eAAe,UAAU,gBAAgB,cAAc;IAChE,IAAI,CAAC,GAAG,aAAa,YAAY,IAAI,GAAG;IAExC,SAAS,IAAI,YAAY,KAAK,IAAI;IAElC,IAAI,UACF,UAAU,YAAY,KAAK,MAAM,YAAY,KAAK,IAAI;GAE1D;GAEA;EACF;EAGA,IACE,GAAG,oBAAoB,SAAS,KAChC,CAAC,UAAU,mBACX,CAAC,UAAU,cACX,UAAU,gBACV,GAAG,eAAe,UAAU,YAAY,GACxC;GACA,KAAK,MAAM,WAAW,UAAU,aAAa,UAAU;IACrD,IAAI,QAAQ,YAAY;IAExB,WAAW,QAAQ,gBAAgB,QAAQ,KAAI,CAAE,MAAM,QAAQ,KAAK,IAAI;GAC1E;GAEA;EACF;EAGA,IACE,GAAG,mBAAmB,SAAS,KAC/B,CAAC,UAAU,kBACX,GAAG,aAAa,UAAU,UAAU,GAEpC,UAAU,UAAU,WAAW,MAAM,SAAS;CAElD;CAEA,OAAO;EAAE;EAAU;CAAY;AACjC;;AAGA,SAAS,eAAe,OAA0D;CAChF,IAAI,CAAC,SAAS,MAAM,WAAW,GAAG,OAAO;CAIzC,OAFc,MAAM,QAAQ,SAAS,SAAS,SAAS,CAAC,CAAC,KAE9C,CAAC,CAAC,MAAM;AACrB;AAEA,SAAS,mBAAmB,YAAuD;CACjF,MAAM,2BAAW,IAAI,IAA2B;CAEhD,KAAK,MAAM,aAAa,WAAW,YAAY;EAC7C,IAAI,CAAC,GAAG,oBAAoB,SAAS,KAAK,CAAC,GAAG,gBAAgB,UAAU,eAAe,GACrF;EAGF,MAAM,SAAS,UAAU;EACzB,MAAM,YAAY,UAAU,gBAAgB;EAE5C,IAAI,CAAC,QAAQ;EAEb,IAAI,OAAO,MACT,SAAS,IAAI,OAAO,KAAK,MAAM;GAAE;GAAW,YAAY;EAAU,CAAC;EAKrE,IAAI,OAAO,iBAAiB,GAAG,eAAe,OAAO,aAAa,GAChE,KAAK,MAAM,WAAW,OAAO,cAAc,UACzC,SAAS,IAAI,QAAQ,KAAK,MAAM;GAC9B;GACA,aAAa,QAAQ,gBAAgB,QAAQ,KAAI,CAAE;EACrD,CAAC;CAGP;CAEA,OAAO;AACT;;AAGA,SAAS,4BACP,QAC2C;CAC3C,IAAI,CAAC,GAAG,sBAAsB,MAAM,GAAG,OAAO;CAC9C,IAAI,CAAC,YAAY,QAAQ,GAAG,WAAW,aAAa,GAAG,OAAO;CAC9D,IAAI,YAAY,QAAQ,GAAG,WAAW,cAAc,GAAG,OAAO;CAM9D,IAAI,GAHD,GAAG,aAAa,OAAO,IAAI,KAAK,GAAG,gBAAgB,OAAO,IAAI,MAC/D,OAAO,KAAK,SAAS,aAEF,OAAO;CAC5B,IAAI,CAAC,OAAO,aAAa,OAAO;CAEhC,MAAM,cAAc,kBAAkB,OAAO,WAAW;CAExD,OAAO,GAAG,aAAa,WAAW,IAAI,EAAE,MAAM,YAAY,KAAK,IAAI;AACrE;;;;;;AAOA,SAAgB,4BACd,OACyB;CACzB,MAAM,SAAkC;EAAE,SAAS,CAAC;EAAG,SAAS,CAAC;CAAE;CAGnE,IAAI,CAAC,MAAM,OAAO,SAAS,UAAU,GAAG,OAAO;CAE/C,MAAM,aAAa,GAAG,iBACpB,MAAM,cACN,MAAM,QACN,GAAG,aAAa,QACK,OACrB,MAAM,aAAa,SAAS,GAAG,IAAI,GAAG,WAAW,MAAM,GAAG,WAAW,EACvE;CAEA,MAAM,EAAE,UAAU,gBAAgB,sBAAsB,UAAU;CAClE,MAAM,UAAU,mBAAmB,UAAU;CAE7C,KAAK,MAAM,aAAa,WAAW,YAAY;EAC7C,IAAI,CAAC,GAAG,mBAAmB,SAAS,KAAK,CAAC,UAAU,MAAM;EAE1D,MAAM,YAAY,UAAU,KAAK;EAEjC,IAAI;EAEJ,KAAK,MAAM,UAAU,UAAU,SAC7B,YAAY,4BAA4B,MAAM,KAAK;EAGrD,IAAI,cAAc,QAAW;EAE7B,MAAM,QAAQ,WAAyB;GACrC,OAAO,QAAQ,KAAK;IAAE;IAAW,WAAW,MAAM;IAAc;GAAO,CAAC;EAC1E;EAEA,IAAI,cAAc,YAAY;GAC5B,KAAK,6CAA6C;GAClD;EACF;EAMA,IAJ8B,UAAU,gBAAgB,MACrD,cAAc,UAAU,YAAY,MACvC,GAE2B;GACzB,KAAK,4BAA4B;GACjC;EACF;EAEA,MAAM,cAAc,eAAe,YAAY,IAAI,SAAS,CAAC;EAE7D,IAAI,gBAAgB,QAAW;GAC7B,KAAK,iCAAiC;GACtC;EACF;EAEA,IAAI,gBAAgB,aAAa,CAAC,WAAW,KAAK,WAAW,GAAG;GAC9D,KAAK,4CAA4C;GACjD;EACF;EAEA,MAAM,UAAU,QAAQ,IAAI,UAAU,IAAI;EAE1C,IAAI;EACJ,IAAI;EAEJ,IAAI,SAAS;GACX,eAAe,MAAM,cAAc,QAAQ,SAAS;GACpD,iBAAiB,QAAQ;EAC3B,OAAO,IAAI,SAAS,IAAI,UAAU,IAAI,GAAG;GACvC,eAAe,MAAM;GACrB,iBAAiB,eAAe,YAAY,IAAI,UAAU,IAAI,CAAC;EACjE;EAEA,IAAI,iBAAiB,UAAa,mBAAmB,QAAW;GAC9D,KAAK,KAAK,UAAU,KAAK,mDAAmD;GAC5E;EACF;EAEA,IAAI,mBAAmB,aAAa,CAAC,WAAW,KAAK,cAAc,GAAG;GACpE,KAAK,+CAA+C;GACpD;EACF;EAEA,OAAO,QAAQ,KAAK;GAClB;GACA,WAAW,MAAM;GACjB;GACA;GACA;EACF,CAAC;CACH;CAEA,OAAO;AACT;;AAGA,SAAS,sBAAsB,kBAA0B,cAA0C;CACjG,MAAM,OAAO,SAAS,kBAAkB,YAAY,CAAC,CAAC,WAAW,MAAM,GAAG;CAG1E,IAAI,WAAW,IAAI,GAAG,OAAO;CAE7B,MAAM,mBAAmB,KAAK,QAAQ,iCAAiC,EAAE;CAEzE,OAAO,iBAAiB,WAAW,GAAG,IAAI,mBAAmB,KAAK;AACpE;;;;;;AAOA,SAAgB,mBACd,SACmD;CACnD,MAAM,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,MACzB,GAAG,MACF,EAAE,UAAU,cAAc,EAAE,WAAW,IAAI,KAC3C,EAAE,UAAU,cAAc,EAAE,WAAW,IAAI,KAC3C,EAAE,YAAY,cAAc,EAAE,aAAa,IAAI,CACnD;CAEA,MAAM,wBAAQ,IAAI,IAAY;CAC9B,MAAM,yBAAS,IAAI,IAAoB;CAEvC,OAAO,OAAO,KAAK,UAAU;EAC3B,IAAI,SAAS,OAAO,IAAI,MAAM,SAAS,KAAK,KAAK;EACjD,IAAI,MAAM,UAAU,IAAI,MAAM,YAAY,GAAG,MAAM,UAAU,GAAG;EAEhE,OAAO,MAAM,IAAI,GAAG,GAAG;GACrB,SAAS;GACT,MAAM,GAAG,MAAM,UAAU,GAAG;EAC9B;EAEA,OAAO,IAAI,MAAM,WAAW,KAAK;EACjC,MAAM,IAAI,GAAG;EAEb,OAAO;GAAE;GAAK;EAAM;CACtB,CAAC;AACH;;;;;;;;AASA,SAAgB,4BACd,SACA,kBACQ;CACR,MAAM,QAAkB,CAAC;CAEzB,KAAK,MAAM,EAAE,KAAK,WAAW,mBAAmB,OAAO,GAAG;EACxD,MAAM,YAAY,sBAAsB,kBAAkB,MAAM,SAAS;EACzE,MAAM,eAAe,sBAAsB,kBAAkB,MAAM,YAAY;EAE/E,IAAI,cAAc,UAAa,iBAAiB,QAAW;EAE3D,MAAM,QAAQ,UAAU,KAAK,UAAU,SAAS,EAAE,IAAI,MAAM;EAC5D,MAAM,WAAW,iBAAiB,KAAK,UAAU,YAAY,EAAE,IAAI,MAAM;EAEzE,MAAM,KAAK,OAAO,KAAK,UAAU,GAAG,EAAE,aAAa,MAAM,cAAc,SAAS,IAAI;CACtF;CAEA,OAAO;;;;;;;;;EASP,MAAM,KAAK,IAAI,EAAE;;;;AAInB;;;;;;;;AASA,eAAsB,mBAAmB,UAAkB,SAAmC;CAC5F,IAAI;EACF,IAAK,MAAM,SAAS,UAAU,OAAO,MAAO,SAAS,OAAO;CAC9D,QAAQ,CAER;CAEA,MAAM,MAAM,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;CAElD,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,IAAI;CAEjD,IAAI;EACF,MAAM,UAAU,eAAe,SAAS,OAAO;EAC/C,MAAM,OAAO,eAAe,QAAQ;CACtC,SAAS,OAAO;EACd,MAAM,GAAG,eAAe,EAAE,OAAO,KAAK,CAAC;EAEvC,MAAM;CACR;CAEA,OAAO;AACT"}
+{"version":3,"file":"model-resource-typings.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/model-resource-typings.ts"],"sourcesContent":["import { mkdir, readFile, rename, rm, writeFile } from \"node:fs/promises\";\nimport { dirname, isAbsolute, relative } from \"node:path\";\nimport ts from \"typescript\";\n\n/**\n * Static `ModelResourceRegistry` generation.\n *\n * `Serialized<User>` can only resolve a model to its resource output through an\n * entry in the augmentable `ModelResourceRegistry` (see `http/serialized.ts`).\n * This module derives those entries from source: a model class that declares\n * `static resource = UserResource` produces\n *\n * ```ts\n * \"User\": { model: import(\"<model file>\").User; resource: typeof import(\"<resource file>\").UserResource };\n * ```\n *\n * Everything here is syntactic. It reads one `ts.createSourceFile` AST per model\n * file, follows the identifier through that file's own imports, and never\n * imports or executes application code (`read-config-ast.ts` explains why a\n * type checker is not an option). Anything it cannot prove from the AST alone\n * (a computed expression, `lazy(...)`, a namespace import, a class that is not\n * exported) is skipped, and nothing is recorded for it: a guessed entry would\n * make `Serialized` lie, which is worse than the raw-data type it falls back to.\n */\n\n/** One model class whose resource could be resolved statically. */\nexport type ModelResourceEntry = {\n  /** The model class name (the registry key before de-duplication). */\n  className: string;\n  /** Absolute path of the model file. */\n  modelFile: string;\n  /** How the model file exports the class: its export name, or `\"default\"`. */\n  modelExport: string;\n  /** Absolute path of the module that exports the resource. */\n  resourceFile: string;\n  /** How that module exports the resource: its export name, or `\"default\"`. */\n  resourceExport: string;\n};\n\n/** A model that declares `static resource` but could not be resolved. */\nexport type SkippedModelResource = {\n  className: string;\n  modelFile: string;\n  reason: string;\n};\n\nexport type ModelResourceExtraction = {\n  entries: ModelResourceEntry[];\n  skipped: SkippedModelResource[];\n};\n\nexport type ExtractModelResourcesInput = {\n  /** Source text of the model file. */\n  source: string;\n  /** Absolute path of the model file. */\n  absolutePath: string;\n  /**\n   * Resolve an import specifier of the model file (relative or tsconfig alias) to\n   * an absolute file path, or `undefined` when it does not point at app source.\n   */\n  resolveImport: (specifier: string) => string | undefined;\n};\n\ntype ImportBinding = { specifier: string; exportName: string };\n\nconst IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\nfunction hasModifier(node: ts.Node, kind: ts.SyntaxKind): boolean {\n  return (\n    ts.canHaveModifiers(node) && (ts.getModifiers(node)?.some((m) => m.kind === kind) ?? false)\n  );\n}\n\nfunction unwrapParentheses(expression: ts.Expression): ts.Expression {\n  let current = expression;\n\n  while (ts.isParenthesizedExpression(current)) {\n    current = current.expression;\n  }\n\n  return current;\n}\n\n/** Top-level names this file declares, and the names each is exported under. */\nfunction readLocalDeclarations(sourceFile: ts.SourceFile): {\n  declared: Set<string>;\n  exportNames: Map<string, string[]>;\n} {\n  const declared = new Set<string>();\n  const exportNames = new Map<string, string[]>();\n\n  const addExport = (local: string, exported: string): void => {\n    const names = exportNames.get(local) ?? [];\n\n    names.push(exported);\n    exportNames.set(local, names);\n  };\n\n  for (const statement of sourceFile.statements) {\n    const exported = hasModifier(statement, ts.SyntaxKind.ExportKeyword);\n    const isDefault = hasModifier(statement, ts.SyntaxKind.DefaultKeyword);\n\n    if (\n      (ts.isClassDeclaration(statement) ||\n        ts.isFunctionDeclaration(statement) ||\n        ts.isEnumDeclaration(statement)) &&\n      statement.name\n    ) {\n      declared.add(statement.name.text);\n\n      if (exported) {\n        addExport(statement.name.text, isDefault ? \"default\" : statement.name.text);\n      }\n\n      continue;\n    }\n\n    if (ts.isVariableStatement(statement)) {\n      for (const declaration of statement.declarationList.declarations) {\n        if (!ts.isIdentifier(declaration.name)) continue;\n\n        declared.add(declaration.name.text);\n\n        if (exported) {\n          addExport(declaration.name.text, declaration.name.text);\n        }\n      }\n\n      continue;\n    }\n\n    // `export { A, B as C }` (local form only; a `from` clause re-exports a foreign name).\n    if (\n      ts.isExportDeclaration(statement) &&\n      !statement.moduleSpecifier &&\n      !statement.isTypeOnly &&\n      statement.exportClause &&\n      ts.isNamedExports(statement.exportClause)\n    ) {\n      for (const element of statement.exportClause.elements) {\n        if (element.isTypeOnly) continue;\n\n        addExport((element.propertyName ?? element.name).text, element.name.text);\n      }\n\n      continue;\n    }\n\n    // `export default UserResource;`\n    if (\n      ts.isExportAssignment(statement) &&\n      !statement.isExportEquals &&\n      ts.isIdentifier(statement.expression)\n    ) {\n      addExport(statement.expression.text, \"default\");\n    }\n  }\n\n  return { declared, exportNames };\n}\n\n/** Prefer a named export over `default`; among named exports, the first sorted. */\nfunction pickExportName(names: readonly string[] | undefined): string | undefined {\n  if (!names || names.length === 0) return undefined;\n\n  const named = names.filter((name) => name !== \"default\").sort();\n\n  return named[0] ?? \"default\";\n}\n\nfunction readImportBindings(sourceFile: ts.SourceFile): Map<string, ImportBinding> {\n  const bindings = new Map<string, ImportBinding>();\n\n  for (const statement of sourceFile.statements) {\n    if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) {\n      continue;\n    }\n\n    const clause = statement.importClause;\n    const specifier = statement.moduleSpecifier.text;\n\n    if (!clause) continue;\n\n    if (clause.name) {\n      bindings.set(clause.name.text, { specifier, exportName: \"default\" });\n    }\n\n    // A namespace import (`import * as ns`) cannot be the bare identifier a\n    // `static resource = X` reads, so it never becomes a binding.\n    if (clause.namedBindings && ts.isNamedImports(clause.namedBindings)) {\n      for (const element of clause.namedBindings.elements) {\n        bindings.set(element.name.text, {\n          specifier,\n          exportName: (element.propertyName ?? element.name).text,\n        });\n      }\n    }\n  }\n\n  return bindings;\n}\n\n/** The identifier a class assigns to `static resource`, when it is a bare identifier. */\nfunction readStaticResourceReference(\n  member: ts.ClassElement,\n): { name: string } | \"computed\" | undefined {\n  if (!ts.isPropertyDeclaration(member)) return undefined;\n  if (!hasModifier(member, ts.SyntaxKind.StaticKeyword)) return undefined;\n  if (hasModifier(member, ts.SyntaxKind.DeclareKeyword)) return undefined;\n\n  const isResourceName =\n    (ts.isIdentifier(member.name) || ts.isStringLiteral(member.name)) &&\n    member.name.text === \"resource\";\n\n  if (!isResourceName) return undefined;\n  if (!member.initializer) return undefined;\n\n  const initializer = unwrapParentheses(member.initializer);\n\n  return ts.isIdentifier(initializer) ? { name: initializer.text } : \"computed\";\n}\n\n/**\n * Read every model class of one file that declares `static resource = <Identifier>`\n * and resolve it to a model export plus a resource export. Pure: the only\n * outside knowledge is the injected {@link ExtractModelResourcesInput.resolveImport}.\n */\nexport function extractModelResourceEntries(\n  input: ExtractModelResourcesInput,\n): ModelResourceExtraction {\n  const result: ModelResourceExtraction = { entries: [], skipped: [] };\n\n  // Cheap exit: most model files declare no resource.\n  if (!input.source.includes(\"resource\")) return result;\n\n  const sourceFile = ts.createSourceFile(\n    input.absolutePath,\n    input.source,\n    ts.ScriptTarget.ESNext,\n    /* setParentNodes */ false,\n    input.absolutePath.endsWith(\"x\") ? ts.ScriptKind.TSX : ts.ScriptKind.TS,\n  );\n\n  const { declared, exportNames } = readLocalDeclarations(sourceFile);\n  const imports = readImportBindings(sourceFile);\n\n  for (const statement of sourceFile.statements) {\n    if (!ts.isClassDeclaration(statement) || !statement.name) continue;\n\n    const className = statement.name.text;\n\n    let reference: { name: string } | \"computed\" | undefined;\n\n    for (const member of statement.members) {\n      reference = readStaticResourceReference(member) ?? reference;\n    }\n\n    if (reference === undefined) continue;\n\n    const skip = (reason: string): void => {\n      result.skipped.push({ className, modelFile: input.absolutePath, reason });\n    };\n\n    if (reference === \"computed\") {\n      skip(\"`static resource` is not a plain identifier\");\n      continue;\n    }\n\n    const requiresTypeArguments = statement.typeParameters?.some(\n      (parameter) => parameter.default === undefined,\n    );\n\n    if (requiresTypeArguments) {\n      skip(\"the model class is generic\");\n      continue;\n    }\n\n    const modelExport = pickExportName(exportNames.get(className));\n\n    if (modelExport === undefined) {\n      skip(\"the model class is not exported\");\n      continue;\n    }\n\n    if (modelExport !== \"default\" && !IDENTIFIER.test(modelExport)) {\n      skip(\"the model export name is not an identifier\");\n      continue;\n    }\n\n    const binding = imports.get(reference.name);\n\n    let resourceFile: string | undefined;\n    let resourceExport: string | undefined;\n\n    if (binding) {\n      resourceFile = input.resolveImport(binding.specifier);\n      resourceExport = binding.exportName;\n    } else if (declared.has(reference.name)) {\n      resourceFile = input.absolutePath;\n      resourceExport = pickExportName(exportNames.get(reference.name));\n    }\n\n    if (resourceFile === undefined || resourceExport === undefined) {\n      skip(`\\`${reference.name}\\` cannot be resolved to an exported module member`);\n      continue;\n    }\n\n    if (resourceExport !== \"default\" && !IDENTIFIER.test(resourceExport)) {\n      skip(\"the resource export name is not an identifier\");\n      continue;\n    }\n\n    result.entries.push({\n      className,\n      modelFile: input.absolutePath,\n      modelExport,\n      resourceFile,\n      resourceExport,\n    });\n  }\n\n  return result;\n}\n\n/** Module specifier, relative to the typings directory, without a TypeScript extension. */\nfunction toTypeImportSpecifier(typingsDirectory: string, absoluteFile: string): string | undefined {\n  const path = relative(typingsDirectory, absoluteFile).replaceAll(\"\\\\\", \"/\");\n\n  // A different drive (Windows) has no relative form; do not emit a guess.\n  if (isAbsolute(path)) return undefined;\n\n  const withoutExtension = path.replace(/\\.(?:d\\.)?(?:ts|tsx|mts|cts)$/, \"\");\n\n  return withoutExtension.startsWith(\".\") ? withoutExtension : `./${withoutExtension}`;\n}\n\n/**\n * Registry keys: the class name, suffixed `_2`, `_3`, ... when several model\n * files declare the same class name. Order is by class name, then by file path,\n * so the same set of models always yields the same keys and the same text.\n */\nexport function assignRegistryKeys(\n  entries: readonly ModelResourceEntry[],\n): Array<{ key: string; entry: ModelResourceEntry }> {\n  const sorted = [...entries].sort(\n    (a, b) =>\n      a.className.localeCompare(b.className, \"en\") ||\n      a.modelFile.localeCompare(b.modelFile, \"en\") ||\n      a.modelExport.localeCompare(b.modelExport, \"en\"),\n  );\n\n  const taken = new Set<string>();\n  const counts = new Map<string, number>();\n\n  return sorted.map((entry) => {\n    let count = (counts.get(entry.className) ?? 0) + 1;\n    let key = count === 1 ? entry.className : `${entry.className}_${count}`;\n\n    while (taken.has(key)) {\n      count += 1;\n      key = `${entry.className}_${count}`;\n    }\n\n    counts.set(entry.className, count);\n    taken.add(key);\n\n    return { key, entry };\n  });\n}\n\n/**\n * Text of the generated declaration file.\n *\n * @param entries Every resolved model, in any order.\n * @param typingsDirectory Absolute directory the file is written to; import\n * specifiers are relative to it.\n */\nexport function renderModelResourceRegistry(\n  entries: readonly ModelResourceEntry[],\n  typingsDirectory: string,\n): string {\n  const lines: string[] = [];\n\n  for (const { key, entry } of assignRegistryKeys(entries)) {\n    const modelPath = toTypeImportSpecifier(typingsDirectory, entry.modelFile);\n    const resourcePath = toTypeImportSpecifier(typingsDirectory, entry.resourceFile);\n\n    if (modelPath === undefined || resourcePath === undefined) continue;\n\n    const model = `import(${JSON.stringify(modelPath)}).${entry.modelExport}`;\n    const resource = `typeof import(${JSON.stringify(resourcePath)}).${entry.resourceExport}`;\n\n    lines.push(`    ${JSON.stringify(key)}: { model: ${model}; resource: ${resource} };`);\n  }\n\n  return `// Auto-generated by Warlock.js - DO NOT EDIT\n// One entry per model class that declares \\`static resource = <Resource>\\`, so\n// \\`Serialized<Model>\\` resolves to the resource output. Models whose resource\n// cannot be resolved statically are left out.\n\nimport \"@warlock.js/core\";\n\ndeclare module \"@warlock.js/core\" {\n  interface ModelResourceRegistry {\n${lines.join(\"\\n\")}\n  }\n}\n`;\n}\n\n/**\n * Write `content` to `filePath` through a temporary sibling and a rename, so a\n * reader (the editor's TypeScript server) never sees a half-written file, and\n * skip the write entirely when the file already holds exactly this text.\n *\n * @returns `true` when the file was written.\n */\nexport async function writeFileIfChanged(filePath: string, content: string): Promise<boolean> {\n  try {\n    if ((await readFile(filePath, \"utf-8\")) === content) return false;\n  } catch {\n    // Missing file: write it.\n  }\n\n  await mkdir(dirname(filePath), { recursive: true });\n\n  const temporaryPath = `${filePath}.${process.pid}.tmp`;\n\n  try {\n    await writeFile(temporaryPath, content, \"utf-8\");\n    await rename(temporaryPath, filePath);\n  } catch (error) {\n    await rm(temporaryPath, { force: true });\n\n    throw error;\n  }\n\n  return true;\n}\n"],"mappings":"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"}

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

@@ -9,7 +9,7 @@ import { getDevelopmentModelModuleRegistry } from "./model-module-registry.mjs";
 import { pathToFileURL } from "node:url";
 import ts from "typescript";
 
-//#region ../core/src/dev-server/module-loader.ts
+//#region ../../packages/core/src/dev-server/module-loader.ts
 /**
 * Thrown when a special file (route/event/main/locale) fails to import or
 * register. Carries the file that failed and the original cause so a broken
@@ -22,6 +22,7 @@ var ModuleLoadError = class extends Error {
 		this.type = type;
 		this.file = file;
 		this.cause = cause;
+		this.code = "WL2001";
 		this.name = "ModuleLoadError";
 	}
 };

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

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

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

@@ -1,7 +1,7 @@
 import { Path } from "../utils/normalized-path.mjs";
 import { getJsonFileAsync } from "@warlock.js/fs";
 
-//#region ../core/src/dev-server/package-json-manager.ts
+//#region ../../packages/core/src/dev-server/package-json-manager.ts
 var PackageJsonManager = class {
 	constructor() {
 		this.packageJson = {};

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

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

package/esm/dev-server/parse-imports.mjs

@@ -3,8 +3,9 @@ import { tsconfigManager } from "./tsconfig-manager.mjs";
 import path from "node:path";
 import { directoryExistsAsync, fileExistsAsync } from "@warlock.js/fs";
 import { parse } from "es-module-lexer";
+import ts from "typescript";
 
-//#region ../core/src/dev-server/parse-imports.ts
+//#region ../../packages/core/src/dev-server/parse-imports.ts
 /**
 * Detect if a file contains only type definitions (no runtime code)
 *
@@ -73,7 +74,7 @@ function isTypeOnlyFile(source) {
 */
 function isTypeOnlyImport(line) {
 	const trimmed = line.trim();
-	return trimmed.startsWith("import type ") || !!trimmed.match(/^import\s+type\s+[\{\*]/);
+	return trimmed.startsWith("import type ") || !!trimmed.match(/^import\s+type\s+[{*]/);
 }
 /**
 * Decide whether an `import ... from "m"` statement contributes any runtime
@@ -150,11 +151,12 @@ function extractImportPathsWithRegex(source) {
 		if (dynamicPath === void 0) continue;
 		record(dynamicPath, match[0], false);
 	}
-	const exportFromPattern = /export\s+(?:\{[^}]*\}|\*|\w+)\s+from\s+['"]([^'"]+)['"]/g;
+	const exportFromPattern = /export\s+(?:type\s+)?(?:\{[^}]*\}|\*(?:\s+as\s+\w+)?|\w+)\s+from\s+['"]([^'"]+)['"]/g;
 	while ((match = exportFromPattern.exec(source)) !== null) {
 		const fullMatch = match[0];
 		const exportPath = match[1];
 		if (exportPath === void 0) continue;
+		if (/^export\s+type\s/.test(fullMatch)) continue;
 		record(exportPath, fullMatch, isExportTypeOnlyStatement(fullMatch));
 	}
 	return imports;
@@ -177,8 +179,8 @@ async function parseImports(source, filePath) {
 		try {
 			const [imports] = await parse(source);
 			if (imports && imports.length > 0) return await resolveImports(imports, source, filePath);
-		} catch (lexerError) {}
-		const regexImports = extractImportPathsWithRegex(source);
+		} catch {}
+		const regexImports = extractImportPathsWithRegex(stripComments(source, filePath));
 		const resolvedImports = /* @__PURE__ */ new Map();
 		for (const { path: importPath, isTypeOnly } of regexImports) {
 			if (isNodeBuiltin(importPath)) continue;
@@ -186,7 +188,7 @@ async function parseImports(source, filePath) {
 			let resolvedPath = null;
 			if (tsconfigManager.isAlias(importPath)) resolvedPath = await resolveAliasImport(importPath);
 			else if (importPath.startsWith(".")) resolvedPath = await resolveRelativeImport(importPath, filePath);
-			if (resolvedPath) mergeResolvedImport(resolvedImports, importPath, resolvedPath, isTypeOnly);
+			if (resolvedPath && !isSameFile(resolvedPath, filePath)) mergeResolvedImport(resolvedImports, importPath, resolvedPath, isTypeOnly);
 		}
 		return resolvedImports;
 	} catch (error) {
@@ -194,6 +196,71 @@ async function parseImports(source, filePath) {
 		return /* @__PURE__ */ new Map();
 	}
 }
+/** True when both paths name the same file (case-insensitively on Windows). */
+function isSameFile(first, second) {
+	const normalize = (filePath) => {
+		const resolved = Path.normalize(path.resolve(filePath));
+		return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+	};
+	return normalize(first) === normalize(second);
+}
+/**
+* Remove `//` and `/* *\/` comments, keeping every newline in place (so
+* line-based matches keep their lines). Only the regex fallback needs it; the
+* lexer already skips comments.
+*
+* Comment ranges come from a real TypeScript parse, never from scanning
+* characters: only the parser can tell a regex literal (`/\/*$/`), a template
+* literal or JSX text (`<p>// not a comment</p>`) from a comment. A character
+* scanner read the `/*` in `p.replace(/\/*$/, "")` as a block comment and
+* erased every import after it.
+*
+* `filePath` picks the dialect (`.tsx`/`.jsx` parse JSX); without it the
+* source is parsed as TSX.
+*/
+function stripComments(source, filePath = "source.tsx") {
+	const sourceFile = ts.createSourceFile(filePath, source, ts.ScriptTarget.Latest, false, scriptKindFor(filePath));
+	const ranges = [];
+	const seen = /* @__PURE__ */ new Set();
+	const collect = (node) => {
+		if (node.kind >= ts.SyntaxKind.FirstJSDocNode && node.kind <= ts.SyntaxKind.LastJSDocNode) return;
+		const children = node.getChildren(sourceFile);
+		if (children.length > 0) {
+			for (const child of children) collect(child);
+			return;
+		}
+		if (node.kind === ts.SyntaxKind.JsxText || node.kind === ts.SyntaxKind.JsxTextAllWhiteSpaces) return;
+		const tokenStart = node.getStart(sourceFile);
+		const trivia = [...ts.getTrailingCommentRanges(source, node.pos) ?? [], ...ts.getLeadingCommentRanges(source, node.pos) ?? []];
+		for (const range of trivia) if (range.end <= tokenStart && !seen.has(range.pos)) {
+			seen.add(range.pos);
+			ranges.push(range);
+		}
+	};
+	collect(sourceFile);
+	ranges.sort((first, second) => first.pos - second.pos);
+	let output = "";
+	let cursor = 0;
+	for (const range of ranges) {
+		output += source.slice(cursor, range.pos);
+		output += source.slice(range.pos, range.end).replace(/[^\n]/g, "");
+		cursor = range.end;
+	}
+	return output + source.slice(cursor);
+}
+/** The parse dialect for a file: JSX only where the extension allows it. */
+function scriptKindFor(filePath) {
+	switch (path.extname(filePath).toLowerCase()) {
+		case ".ts":
+		case ".mts":
+		case ".cts": return ts.ScriptKind.TS;
+		case ".js":
+		case ".mjs":
+		case ".cjs": return ts.ScriptKind.JS;
+		case ".jsx": return ts.ScriptKind.JSX;
+		default: return ts.ScriptKind.TSX;
+	}
+}
 /**
 * Merge a resolved import into the output map, preserving the type-only rule:
 * a path is type-only iff every statement that references it is type-only.
@@ -224,7 +291,7 @@ async function resolveImports(imports, source, filePath) {
 		let resolvedPath = null;
 		if (tsconfigManager.isAlias(importPath)) resolvedPath = await resolveAliasImport(importPath);
 		else if (importPath.startsWith(".")) resolvedPath = await resolveRelativeImport(importPath, filePath);
-		if (!resolvedPath) continue;
+		if (!resolvedPath || isSameFile(resolvedPath, filePath)) continue;
 		const isTypeOnly = isLexerStatementTypeOnly(imp, source);
 		mergeResolvedImport(resolvedImports, importPath, resolvedPath, isTypeOnly);
 	}