@warlock.js/core 5.26.0 → 5.28.0

package/esm/dev-server/files-orchestrator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"files-orchestrator.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/files-orchestrator.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { init } from \"es-module-lexer\";\nimport { fileURLToPath } from \"node:url\";\nimport type { MessagePort } from \"node:worker_threads\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\nimport { DependencyGraph } from \"./dependency-graph\";\nimport { devLogDim, devLogSuccess } from \"./dev-logger\";\nimport { FileEventHandler } from \"./file-event-handler\";\nimport { FileManager } from \"./file-manager\";\nimport { FileOperations } from \"./file-operations\";\nimport { FilesWatcher, createIgnoredMatcher } from \"./files-watcher\";\nimport { FILE_PROCESSING_BATCH_SIZE } from \"./flags\";\nimport { EslintHealthChecker } from \"./health-checker/checkers/eslint-health-checker\";\nimport { TypescriptHealthChecker } from \"./health-checker/checkers/typescript-health-checker\";\nimport type { FileHealthCheckerContract } from \"./health-checker/file-health-checker.contract\";\nimport { FilesHealthcareManager } from \"./health-checker/files-healthcare.manager\";\nimport { buildTranspileInit } from \"./loader/build-transpile-init.js\";\nimport { registerLoader } from \"./loader/register-loader.js\";\nimport { ManifestManager } from \"./manifest-manager\";\nimport { ModuleLoader } from \"./module-loader\";\nimport { packageJsonManager } from \"./package-json-manager\";\nimport { Path } from \"../utils/normalized-path\";\nimport { SpecialFilesCollector } from \"./special-files-collector\";\nimport { tsconfigManager } from \"./tsconfig-manager\";\nimport { ensureWarlockDirectory, getFilesFromDirectory } from \"./utils\";\n\n/**\n * Register a cleanup callback that fires before the current module is\n * unloaded by HMR. Stack-inspects the caller so user code doesn't need to\n * thread the FileManager through.\n */\nexport function onCleanup(callback: () => any) {\n  if (globalThis.__currentModuleFile) {\n    globalThis.__currentModuleFile.addCleanup(callback);\n    return;\n  }\n\n  const stack = new Error().stack;\n  const callerLine = stack?.split(\"\\n\")[2];\n  const match = callerLine?.match(/\\((.+?):\\d+:\\d+\\)/) || callerLine?.match(/at (.+?):\\d+:\\d+/);\n  const rawCaller = match?.[1];\n\n  // Loaded modules report `file:///…?v=N`; turn that back into a plain path.\n  const callerFile = rawCaller?.startsWith(\"file://\")\n    ? fileURLToPath(rawCaller.replace(/\\?.*$/, \"\"))\n    : rawCaller;\n\n  if (!callerFile) return;\n  const fileManager = filesOrchestrator.files.get(Path.toRelative(callerFile));\n  fileManager?.addCleanup(callback);\n}\n\n/**\n * Top-level coordinator for the dev server's file system.\n *\n * Owns: file discovery, the dependency graph, the manifest, the special-files\n * index, the file watcher, and the lifecycle of the ESM loader hook (which\n * provides cache-busting via `?v=N` version tokens).\n */\nexport class FilesOrchestrator {\n  public readonly filesWatcher = new FilesWatcher();\n  public readonly files = new Map<string, FileManager>();\n  private readonly manifest = new ManifestManager(this.files);\n  private readonly dependencyGraph = new DependencyGraph();\n  private readonly healthCheckerManager = new FilesHealthcareManager(this.files);\n  public readonly specialFilesCollector = new SpecialFilesCollector();\n  public readonly moduleLoader = new ModuleLoader(this.specialFilesCollector);\n  public readonly fileOperations: FileOperations;\n  private readonly eventHandler: FileEventHandler;\n\n  /** Main-thread end of the MessageChannel to the loader hook worker. */\n  private loaderPort: MessagePort | null = null;\n\n  /** Resolve callbacks for pending `flushVersionBumps()` calls. */\n  private readonly pendingFlushes: Array<() => void> = [];\n\n  public isInitialized = false;\n\n  public constructor() {\n    this.fileOperations = new FileOperations(\n      this.files,\n      this.dependencyGraph,\n      this.manifest,\n      this.specialFilesCollector,\n    );\n\n    this.eventHandler = new FileEventHandler(\n      this.fileOperations,\n      this.manifest,\n      this.dependencyGraph,\n      this.files,\n    );\n  }\n\n  public async add(relativePath: string): Promise<FileManager> {\n    return this.fileOperations.addFile(relativePath);\n  }\n\n  public async load<T>(relativePath: string, type = \"other\") {\n    // Guarantee the ESM loader hook is registered before we import anything.\n    // `load()` is the dynamic-import entrypoint, so it is the one place that\n    // must satisfy `init()`'s documented precondition (\"Must be called before\n    // any user src/ module is dynamically imported\") on its own — it cannot\n    // assume a caller ran `init()` first.\n    //\n    // The CLI command-resolution path proves why: `cliCommandsLoader.load()`\n    // imports a project command module during command *lookup* (before the\n    // command's own `execute()` runs), whereas `loadPreloaders()` only calls\n    // `init()` from *inside* `execute()`. So a `warlock <command>` whose\n    // command file imports an `app/*` alias or a `.ts` sibling was imported\n    // with no hook registered and died on `ERR_MODULE_NOT_FOUND` (f9d8f99f).\n    //\n    // `init()` is idempotent (guarded by `isInitialized`), so this is a no-op\n    // on the dev-server path, which already calls it explicitly at startup.\n    await this.init();\n\n    const fileManager = await this.add(relativePath);\n    return this.moduleLoader.loadModule<T>(fileManager, fileManager.type || type);\n  }\n\n  public getDependencyGraph(): DependencyGraph {\n    return this.dependencyGraph;\n  }\n\n  public getInvalidationChain(file: string): string[] {\n    return this.dependencyGraph.getInvalidationChain(file);\n  }\n\n  public getFiles(): Map<string, FileManager> {\n    return this.files;\n  }\n\n  public getHealthCheckerManager(): FilesHealthcareManager {\n    return this.healthCheckerManager;\n  }\n\n  /**\n   * Initialise managers and register the ESM loader hook. Must be called\n   * before any user `src/` module is dynamically imported.\n   */\n  public async init() {\n    if (this.isInitialized) return;\n    this.isInitialized = true;\n\n    await init;\n    await Promise.all([tsconfigManager.init(), packageJsonManager.init()]);\n\n    // The loader hook writes itself into .warlock/, so ensure the dir exists.\n    await ensureWarlockDirectory();\n\n    const devServerConfig = await warlockConfigManager.lazyGet(\"devServer\");\n    const transpileInit = buildTranspileInit(\n      tsconfigManager.tsconfig?.compilerOptions,\n      devServerConfig?.transpileCacheDebug === true,\n    );\n\n    this.loaderPort = await registerLoader(transpileInit);\n\n    this.loaderPort.on(\"message\", (msg: { type: string }) => {\n      if (msg.type === \"sync-ack\") {\n        this.pendingFlushes.shift()?.();\n      }\n    });\n  }\n\n  /**\n   * Tell the hook worker a file changed. The next `import()` of it will get\n   * a fresh `?v=N` URL → Node cache miss → fresh content.\n   */\n  public bumpVersion(absolutePath: string): void {\n    this.loaderPort?.postMessage({ type: \"bump\", absolutePath });\n  }\n\n  /**\n   * Wait until the hook worker has processed every pending bump.\n   *\n   * `postMessage` is async — without this, a follow-up `import()` may\n   * resolve before the worker increments the counter and Node will return\n   * the cached old module.\n   */\n  public flushVersionBumps(): Promise<void> {\n    if (!this.loaderPort) return Promise.resolve();\n\n    return new Promise<void>((resolve) => {\n      this.pendingFlushes.push(resolve);\n      this.loaderPort!.postMessage({ type: \"sync\" });\n    });\n  }\n\n  /**\n   * Discover files on disk, reconcile against the manifest, build the dep\n   * graph, and persist the new manifest. Idempotent.\n   */\n  public async initializeAll() {\n    const [filesInFilesystem, manifestExists] = await Promise.all([\n      this.getAllFilesFromFilesystem(),\n      this.manifest.init(),\n    ]);\n\n    if (!manifestExists) {\n      await this.processFiles(filesInFilesystem);\n    } else {\n      await this.reconcileFiles(filesInFilesystem);\n    }\n\n    this.dependencyGraph.build(this.files);\n    this.fileOperations.updateFileDependents();\n    this.fileOperations.syncFilesToManifest();\n    await this.manifest.save();\n  }\n\n  public async checkHealth(files: { added: string[]; changed: string[]; deleted: string[] }) {\n    const filesToCheck = [...files.added, ...files.changed]\n      .map((file) => this.files.get(Path.toRelative(file)))\n      .filter((file): file is FileManager => !!file);\n\n    const filesToDelete = files.deleted\n      .map((file) => this.files.get(Path.toRelative(file)))\n      .filter((file): file is FileManager => !!file);\n\n    await this.healthCheckerManager.onFileChanges(filesToCheck);\n    this.healthCheckerManager.removeFiles(filesToDelete);\n    this.healthCheckerManager.checkFiles(filesToCheck);\n  }\n\n  public async startCheckingHealth(healthCheckers?: FileHealthCheckerContract[]): Promise<void> {\n    devLogDim(\"Started File Health Checks in the background.\");\n\n    const checkers = healthCheckers ?? [new TypescriptHealthChecker(), new EslintHealthChecker()];\n    await this.healthCheckerManager.setHealthCheckers(checkers).initialize();\n    await this.healthCheckerManager.validateAllFiles();\n  }\n\n  /**\n   * Glob the src directory, returning relative paths.\n   */\n  public async getAllFilesFromFilesystem(): Promise<string[]> {\n    const absolutePaths = await getFilesFromDirectory();\n    return absolutePaths.map((absPath) => Path.toRelative(absPath));\n  }\n\n  /**\n   * Process every file from scratch — used when no manifest exists.\n   */\n  private async processFiles(filePaths: string[]) {\n    devLogDim(`processing ${filePaths.length} files...`);\n    await runInBatches(filePaths, FILE_PROCESSING_BATCH_SIZE, async (relativePath) => {\n      const fileManager = new FileManager(\n        Path.toAbsolute(relativePath),\n        this.files,\n        this.fileOperations,\n      );\n      this.files.set(relativePath, fileManager);\n      await fileManager.process();\n    });\n    devLogSuccess(`processed ${filePaths.length} files`);\n  }\n\n  private async reconcileFiles(filesInFilesystem: string[]) {\n    const filesInManifest = new Set(this.manifest.getAllFilePaths());\n    const filesInFilesystemSet = new Set(filesInFilesystem);\n\n    const newFiles = filesInFilesystem.filter((f) => !filesInManifest.has(f));\n    const deletedFiles = Array.from(filesInManifest).filter((f) => !filesInFilesystemSet.has(f));\n    const existingFiles = filesInFilesystem.filter((f) => filesInManifest.has(f));\n\n    if (newFiles.length > 0 || deletedFiles.length > 0) {\n      devLogDim(\n        `reconciling: ${colors.green(newFiles.length)} new, ${colors.red(deletedFiles.length)} deleted, ${colors.blue(existingFiles.length)} existing`,\n      );\n    }\n\n    await this.processFiles(newFiles);\n\n    for (const relativePath of deletedFiles) {\n      this.manifest.removeFile(relativePath);\n      this.files.delete(relativePath);\n    }\n\n    await runInBatches(existingFiles, FILE_PROCESSING_BATCH_SIZE, async (relativePath) => {\n      const fileManager = new FileManager(\n        Path.toAbsolute(relativePath),\n        this.files,\n        this.fileOperations,\n      );\n      this.files.set(relativePath, fileManager);\n      await fileManager.init(this.manifest.getFile(relativePath));\n    });\n  }\n\n  public async watchFiles() {\n    devLogSuccess(\"watching for file changes (not serving yet)\");\n\n    this.filesWatcher.onFileChange((p, settleMs) => this.eventHandler.handleFileChange(p, settleMs));\n    this.filesWatcher.onFileAdd((p, settleMs) => this.eventHandler.handleFileAdd(p, settleMs));\n    this.filesWatcher.onFileDelete((p, settleMs) => this.eventHandler.handleFileDelete(p, settleMs));\n\n    const watchConfig = warlockConfigManager.get(\"devServer\")?.watch;\n    if (watchConfig?.include?.length) {\n      this.eventHandler.setIncludeMatcher(createIgnoredMatcher(watchConfig.include));\n    }\n\n    await this.filesWatcher.watch(watchConfig);\n  }\n}\n\nasync function runInBatches<T>(\n  items: T[],\n  size: number,\n  fn: (item: T) => Promise<unknown>,\n): Promise<void> {\n  if (items.length === 0) return;\n  for (let i = 0; i < items.length; i += size) {\n    await Promise.all(items.slice(i, i + size).map(fn));\n  }\n}\n\nexport const filesOrchestrator = new FilesOrchestrator();\n"],"mappings":"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"}
+{"version":3,"file":"files-orchestrator.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/files-orchestrator.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { init } from \"es-module-lexer\";\nimport { fileURLToPath } from \"node:url\";\nimport type { MessagePort } from \"node:worker_threads\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\nimport { DependencyGraph } from \"./dependency-graph\";\nimport { devLogDim, devLogSuccess } from \"./dev-logger\";\nimport { FileEventHandler } from \"./file-event-handler\";\nimport { FileManager } from \"./file-manager\";\nimport { FileOperations } from \"./file-operations\";\nimport { FilesWatcher, createIgnoredMatcher } from \"./files-watcher\";\nimport { FILE_PROCESSING_BATCH_SIZE } from \"./flags\";\nimport { EslintHealthChecker } from \"./health-checker/checkers/eslint-health-checker\";\nimport { TypescriptHealthChecker } from \"./health-checker/checkers/typescript-health-checker\";\nimport type { FileHealthCheckerContract } from \"./health-checker/file-health-checker.contract\";\nimport { FilesHealthcareManager } from \"./health-checker/files-healthcare.manager\";\nimport { buildTranspileInit } from \"./loader/build-transpile-init.js\";\nimport { registerLoader } from \"./loader/register-loader.js\";\nimport { ManifestManager } from \"./manifest-manager\";\nimport { ModuleLoader } from \"./module-loader\";\nimport { packageJsonManager } from \"./package-json-manager\";\nimport { Path } from \"../utils/normalized-path\";\nimport { SpecialFilesCollector } from \"./special-files-collector\";\nimport { tsconfigManager } from \"./tsconfig-manager\";\nimport { ensureWarlockDirectory, getFilesFromDirectory } from \"./utils\";\n\n/**\n * Register a cleanup callback that fires before the current module is\n * unloaded by HMR. Stack-inspects the caller so user code doesn't need to\n * thread the FileManager through.\n */\nexport function onCleanup(callback: () => any) {\n  if (globalThis.__currentModuleFile) {\n    globalThis.__currentModuleFile.addCleanup(callback);\n    return;\n  }\n\n  const stack = new Error().stack;\n  const callerLine = stack?.split(\"\\n\")[2];\n  const match = callerLine?.match(/\\((.+?):\\d+:\\d+\\)/) || callerLine?.match(/at (.+?):\\d+:\\d+/);\n  const rawCaller = match?.[1];\n\n  // Loaded modules report `file:///…?v=N`; turn that back into a plain path.\n  const callerFile = rawCaller?.startsWith(\"file://\")\n    ? fileURLToPath(rawCaller.replace(/\\?.*$/, \"\"))\n    : rawCaller;\n\n  if (!callerFile) return;\n  const fileManager = filesOrchestrator.files.get(Path.toRelative(callerFile));\n  fileManager?.addCleanup(callback);\n}\n\n/**\n * Top-level coordinator for the dev server's file system.\n *\n * Owns: file discovery, the dependency graph, the manifest, the special-files\n * index, the file watcher, and the lifecycle of the ESM loader hook (which\n * provides cache-busting via `?v=N` version tokens).\n */\nexport class FilesOrchestrator {\n  public readonly filesWatcher = new FilesWatcher();\n  public readonly files = new Map<string, FileManager>();\n  private readonly manifest = new ManifestManager(this.files);\n  private readonly dependencyGraph = new DependencyGraph();\n  private readonly healthCheckerManager = new FilesHealthcareManager(this.files);\n  public readonly specialFilesCollector = new SpecialFilesCollector();\n  public readonly moduleLoader = new ModuleLoader(this.specialFilesCollector);\n  public readonly fileOperations: FileOperations;\n  private readonly eventHandler: FileEventHandler;\n\n  /** Main-thread end of the MessageChannel to the loader hook worker. */\n  private loaderPort: MessagePort | null = null;\n\n  /** Resolve callbacks for pending `flushVersionBumps()` calls. */\n  private readonly pendingFlushes: Array<() => void> = [];\n\n  public isInitialized = false;\n\n  public constructor() {\n    this.fileOperations = new FileOperations(\n      this.files,\n      this.dependencyGraph,\n      this.manifest,\n      this.specialFilesCollector,\n    );\n\n    this.eventHandler = new FileEventHandler(\n      this.fileOperations,\n      this.manifest,\n      this.dependencyGraph,\n      this.files,\n    );\n  }\n\n  public async add(relativePath: string): Promise<FileManager> {\n    return this.fileOperations.addFile(relativePath);\n  }\n\n  public async load<T>(relativePath: string, type = \"other\") {\n    // Guarantee the ESM loader hook is registered before we import anything.\n    // `load()` is the dynamic-import entrypoint, so it is the one place that\n    // must satisfy `init()`'s documented precondition (\"Must be called before\n    // any user src/ module is dynamically imported\") on its own — it cannot\n    // assume a caller ran `init()` first.\n    //\n    // The CLI command-resolution path proves why: `cliCommandsLoader.load()`\n    // imports a project command module during command *lookup* (before the\n    // command's own `execute()` runs), whereas `loadPreloaders()` only calls\n    // `init()` from *inside* `execute()`. So a `warlock <command>` whose\n    // command file imports an `app/*` alias or a `.ts` sibling was imported\n    // with no hook registered and died on `ERR_MODULE_NOT_FOUND` (f9d8f99f).\n    //\n    // `init()` is idempotent (guarded by `isInitialized`), so this is a no-op\n    // on the dev-server path, which already calls it explicitly at startup.\n    await this.init();\n\n    const fileManager = await this.add(relativePath);\n    return this.moduleLoader.loadModule<T>(fileManager, fileManager.type || type);\n  }\n\n  public getDependencyGraph(): DependencyGraph {\n    return this.dependencyGraph;\n  }\n\n  public getInvalidationChain(file: string): string[] {\n    return this.dependencyGraph.getInvalidationChain(file);\n  }\n\n  public getFiles(): Map<string, FileManager> {\n    return this.files;\n  }\n\n  public getHealthCheckerManager(): FilesHealthcareManager {\n    return this.healthCheckerManager;\n  }\n\n  /**\n   * Initialise managers and register the ESM loader hook. Must be called\n   * before any user `src/` module is dynamically imported.\n   */\n  public async init() {\n    if (this.isInitialized) return;\n    this.isInitialized = true;\n\n    await init;\n    await Promise.all([tsconfigManager.init(), packageJsonManager.init()]);\n\n    // The loader hook writes itself into .warlock/, so ensure the dir exists.\n    await ensureWarlockDirectory();\n\n    const devServerConfig = await warlockConfigManager.lazyGet(\"devServer\");\n    const transpileInit = buildTranspileInit(\n      tsconfigManager.tsconfig?.compilerOptions,\n      devServerConfig?.transpileCacheDebug === true,\n    );\n\n    this.loaderPort = await registerLoader(transpileInit);\n\n    this.loaderPort.on(\"message\", (msg: { type: string }) => {\n      if (msg.type === \"sync-ack\") {\n        this.pendingFlushes.shift()?.();\n      }\n    });\n  }\n\n  /**\n   * Tell the hook worker a file changed. The next `import()` of it will get\n   * a fresh `?v=N` URL → Node cache miss → fresh content.\n   */\n  public bumpVersion(absolutePath: string): void {\n    this.loaderPort?.postMessage({ type: \"bump\", absolutePath });\n  }\n\n  /**\n   * Wait until the hook worker has processed every pending bump.\n   *\n   * `postMessage` is async — without this, a follow-up `import()` may\n   * resolve before the worker increments the counter and Node will return\n   * the cached old module.\n   */\n  public flushVersionBumps(): Promise<void> {\n    if (!this.loaderPort) return Promise.resolve();\n\n    return new Promise<void>((resolve) => {\n      this.pendingFlushes.push(resolve);\n      this.loaderPort!.postMessage({ type: \"sync\" });\n    });\n  }\n\n  /**\n   * Discover files on disk, reconcile against the manifest, build the dep\n   * graph, and persist the new manifest. Idempotent.\n   */\n  public async initializeAll() {\n    const [filesInFilesystem, manifestExists] = await Promise.all([\n      this.getAllFilesFromFilesystem(),\n      this.manifest.init(),\n    ]);\n\n    if (!manifestExists) {\n      await this.processFiles(filesInFilesystem);\n    } else {\n      await this.reconcileFiles(filesInFilesystem);\n    }\n\n    this.dependencyGraph.build(this.files);\n    this.fileOperations.updateFileDependents();\n    this.fileOperations.syncFilesToManifest();\n    await this.manifest.save();\n  }\n\n  public async checkHealth(files: { added: string[]; changed: string[]; deleted: string[] }) {\n    const filesToCheck = [...files.added, ...files.changed]\n      .map((file) => this.files.get(Path.toRelative(file)))\n      .filter((file): file is FileManager => !!file);\n\n    const filesToDelete = files.deleted\n      .map((file) => this.files.get(Path.toRelative(file)))\n      .filter((file): file is FileManager => !!file);\n\n    await this.healthCheckerManager.onFileChanges(filesToCheck);\n    this.healthCheckerManager.removeFiles(filesToDelete);\n    this.healthCheckerManager.checkFiles(filesToCheck);\n  }\n\n  public async startCheckingHealth(healthCheckers?: FileHealthCheckerContract[]): Promise<void> {\n    devLogDim(\"Started File Health Checks in the background.\");\n\n    const checkers = healthCheckers ?? [new TypescriptHealthChecker(), new EslintHealthChecker()];\n    await this.healthCheckerManager.setHealthCheckers(checkers).initialize();\n    await this.healthCheckerManager.validateAllFiles();\n  }\n\n  /**\n   * Glob the src directory, returning relative paths.\n   */\n  public async getAllFilesFromFilesystem(): Promise<string[]> {\n    const absolutePaths = await getFilesFromDirectory();\n    return absolutePaths.map((absPath) => Path.toRelative(absPath));\n  }\n\n  /**\n   * Process every file from scratch — used when no manifest exists.\n   */\n  private async processFiles(filePaths: string[]) {\n    devLogDim(`processing ${filePaths.length} files...`);\n    await runInBatches(filePaths, FILE_PROCESSING_BATCH_SIZE, async (relativePath) => {\n      const fileManager = new FileManager(\n        Path.toAbsolute(relativePath),\n        this.files,\n        this.fileOperations,\n      );\n      this.files.set(relativePath, fileManager);\n      await fileManager.process();\n    });\n    devLogSuccess(`processed ${filePaths.length} files`);\n  }\n\n  private async reconcileFiles(filesInFilesystem: string[]) {\n    const filesInManifest = new Set(this.manifest.getAllFilePaths());\n    const filesInFilesystemSet = new Set(filesInFilesystem);\n\n    const newFiles = filesInFilesystem.filter((f) => !filesInManifest.has(f));\n    const deletedFiles = Array.from(filesInManifest).filter((f) => !filesInFilesystemSet.has(f));\n    const existingFiles = filesInFilesystem.filter((f) => filesInManifest.has(f));\n\n    if (newFiles.length > 0 || deletedFiles.length > 0) {\n      devLogDim(\n        `reconciling: ${colors.green(newFiles.length)} new, ${colors.red(deletedFiles.length)} deleted, ${colors.blue(existingFiles.length)} existing`,\n      );\n    }\n\n    await this.processFiles(newFiles);\n\n    for (const relativePath of deletedFiles) {\n      this.manifest.removeFile(relativePath);\n      this.files.delete(relativePath);\n    }\n\n    await runInBatches(existingFiles, FILE_PROCESSING_BATCH_SIZE, async (relativePath) => {\n      const fileManager = new FileManager(\n        Path.toAbsolute(relativePath),\n        this.files,\n        this.fileOperations,\n      );\n      this.files.set(relativePath, fileManager);\n      await fileManager.init(this.manifest.getFile(relativePath));\n    });\n  }\n\n  public async watchFiles() {\n    devLogSuccess(\"watching for file changes (not serving yet)\");\n\n    this.filesWatcher.onFileChange((p, settleMs) => this.eventHandler.handleFileChange(p, settleMs));\n    this.filesWatcher.onFileAdd((p, settleMs) => this.eventHandler.handleFileAdd(p, settleMs));\n    this.filesWatcher.onFileDelete((p, settleMs) => this.eventHandler.handleFileDelete(p, settleMs));\n\n    const watchConfig = warlockConfigManager.get(\"devServer\")?.watch;\n    if (watchConfig?.include?.length) {\n      this.eventHandler.setIncludeMatcher(createIgnoredMatcher(watchConfig.include));\n    }\n\n    await this.filesWatcher.watch(watchConfig);\n  }\n}\n\nasync function runInBatches<T>(\n  items: T[],\n  size: number,\n  fn: (item: T) => Promise<unknown>,\n): Promise<void> {\n  if (items.length === 0) return;\n  for (let i = 0; i < items.length; i += size) {\n    await Promise.all(items.slice(i, i + size).map(fn));\n  }\n}\n\nexport const filesOrchestrator = new FilesOrchestrator();\n"],"mappings":"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"}

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

@@ -0,0 +1,246 @@
+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
+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);
+}
+function unwrapParentheses(expression) {
+	let current = expression;
+	while (ts.isParenthesizedExpression(current)) current = current.expression;
+	return current;
+}
+/** Top-level names this file declares, and the names each is exported under. */
+function readLocalDeclarations(sourceFile) {
+	const declared = /* @__PURE__ */ new Set();
+	const exportNames = /* @__PURE__ */ new Map();
+	const addExport = (local, exported) => {
+		const names = exportNames.get(local) ?? [];
+		names.push(exported);
+		exportNames.set(local, names);
+	};
+	for (const statement of sourceFile.statements) {
+		const exported = hasModifier(statement, ts.SyntaxKind.ExportKeyword);
+		const isDefault = hasModifier(statement, ts.SyntaxKind.DefaultKeyword);
+		if ((ts.isClassDeclaration(statement) || ts.isFunctionDeclaration(statement) || ts.isEnumDeclaration(statement)) && statement.name) {
+			declared.add(statement.name.text);
+			if (exported) addExport(statement.name.text, isDefault ? "default" : statement.name.text);
+			continue;
+		}
+		if (ts.isVariableStatement(statement)) {
+			for (const declaration of statement.declarationList.declarations) {
+				if (!ts.isIdentifier(declaration.name)) continue;
+				declared.add(declaration.name.text);
+				if (exported) addExport(declaration.name.text, declaration.name.text);
+			}
+			continue;
+		}
+		if (ts.isExportDeclaration(statement) && !statement.moduleSpecifier && !statement.isTypeOnly && statement.exportClause && ts.isNamedExports(statement.exportClause)) {
+			for (const element of statement.exportClause.elements) {
+				if (element.isTypeOnly) continue;
+				addExport((element.propertyName ?? element.name).text, element.name.text);
+			}
+			continue;
+		}
+		if (ts.isExportAssignment(statement) && !statement.isExportEquals && ts.isIdentifier(statement.expression)) addExport(statement.expression.text, "default");
+	}
+	return {
+		declared,
+		exportNames
+	};
+}
+/** Prefer a named export over `default`; among named exports, the first sorted. */
+function pickExportName(names) {
+	if (!names || names.length === 0) return void 0;
+	return names.filter((name) => name !== "default").sort()[0] ?? "default";
+}
+function readImportBindings(sourceFile) {
+	const bindings = /* @__PURE__ */ new Map();
+	for (const statement of sourceFile.statements) {
+		if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) continue;
+		const clause = statement.importClause;
+		const specifier = statement.moduleSpecifier.text;
+		if (!clause) continue;
+		if (clause.name) bindings.set(clause.name.text, {
+			specifier,
+			exportName: "default"
+		});
+		if (clause.namedBindings && ts.isNamedImports(clause.namedBindings)) for (const element of clause.namedBindings.elements) bindings.set(element.name.text, {
+			specifier,
+			exportName: (element.propertyName ?? element.name).text
+		});
+	}
+	return bindings;
+}
+/** The identifier a class assigns to `static resource`, when it is a bare identifier. */
+function readStaticResourceReference(member) {
+	if (!ts.isPropertyDeclaration(member)) return void 0;
+	if (!hasModifier(member, ts.SyntaxKind.StaticKeyword)) return void 0;
+	if (hasModifier(member, ts.SyntaxKind.DeclareKeyword)) return void 0;
+	if (!((ts.isIdentifier(member.name) || ts.isStringLiteral(member.name)) && member.name.text === "resource")) return void 0;
+	if (!member.initializer) return void 0;
+	const initializer = unwrapParentheses(member.initializer);
+	return ts.isIdentifier(initializer) ? { name: initializer.text } : "computed";
+}
+/**
+* Read every model class of one file that declares `static resource = <Identifier>`
+* and resolve it to a model export plus a resource export. Pure: the only
+* outside knowledge is the injected {@link ExtractModelResourcesInput.resolveImport}.
+*/
+function extractModelResourceEntries(input) {
+	const result = {
+		entries: [],
+		skipped: []
+	};
+	if (!input.source.includes("resource")) return result;
+	const sourceFile = ts.createSourceFile(input.absolutePath, input.source, ts.ScriptTarget.ESNext, false, input.absolutePath.endsWith("x") ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
+	const { declared, exportNames } = readLocalDeclarations(sourceFile);
+	const imports = readImportBindings(sourceFile);
+	for (const statement of sourceFile.statements) {
+		if (!ts.isClassDeclaration(statement) || !statement.name) continue;
+		const className = statement.name.text;
+		let reference;
+		for (const member of statement.members) reference = readStaticResourceReference(member) ?? reference;
+		if (reference === void 0) continue;
+		const skip = (reason) => {
+			result.skipped.push({
+				className,
+				modelFile: input.absolutePath,
+				reason
+			});
+		};
+		if (reference === "computed") {
+			skip("`static resource` is not a plain identifier");
+			continue;
+		}
+		if (statement.typeParameters?.some((parameter) => parameter.default === void 0)) {
+			skip("the model class is generic");
+			continue;
+		}
+		const modelExport = pickExportName(exportNames.get(className));
+		if (modelExport === void 0) {
+			skip("the model class is not exported");
+			continue;
+		}
+		if (modelExport !== "default" && !IDENTIFIER.test(modelExport)) {
+			skip("the model export name is not an identifier");
+			continue;
+		}
+		const binding = imports.get(reference.name);
+		let resourceFile;
+		let resourceExport;
+		if (binding) {
+			resourceFile = input.resolveImport(binding.specifier);
+			resourceExport = binding.exportName;
+		} else if (declared.has(reference.name)) {
+			resourceFile = input.absolutePath;
+			resourceExport = pickExportName(exportNames.get(reference.name));
+		}
+		if (resourceFile === void 0 || resourceExport === void 0) {
+			skip(`\`${reference.name}\` cannot be resolved to an exported module member`);
+			continue;
+		}
+		if (resourceExport !== "default" && !IDENTIFIER.test(resourceExport)) {
+			skip("the resource export name is not an identifier");
+			continue;
+		}
+		result.entries.push({
+			className,
+			modelFile: input.absolutePath,
+			modelExport,
+			resourceFile,
+			resourceExport
+		});
+	}
+	return result;
+}
+/** Module specifier, relative to the typings directory, without a TypeScript extension. */
+function toTypeImportSpecifier(typingsDirectory, absoluteFile) {
+	const path = relative(typingsDirectory, absoluteFile).replaceAll("\\", "/");
+	if (isAbsolute(path)) return void 0;
+	const withoutExtension = path.replace(/\.(?:d\.)?(?:ts|tsx|mts|cts)$/, "");
+	return withoutExtension.startsWith(".") ? withoutExtension : `./${withoutExtension}`;
+}
+/**
+* Registry keys: the class name, suffixed `_2`, `_3`, ... when several model
+* files declare the same class name. Order is by class name, then by file path,
+* so the same set of models always yields the same keys and the same text.
+*/
+function assignRegistryKeys(entries) {
+	const sorted = [...entries].sort((a, b) => a.className.localeCompare(b.className, "en") || a.modelFile.localeCompare(b.modelFile, "en") || a.modelExport.localeCompare(b.modelExport, "en"));
+	const taken = /* @__PURE__ */ new Set();
+	const counts = /* @__PURE__ */ new Map();
+	return sorted.map((entry) => {
+		let count = (counts.get(entry.className) ?? 0) + 1;
+		let key = count === 1 ? entry.className : `${entry.className}_${count}`;
+		while (taken.has(key)) {
+			count += 1;
+			key = `${entry.className}_${count}`;
+		}
+		counts.set(entry.className, count);
+		taken.add(key);
+		return {
+			key,
+			entry
+		};
+	});
+}
+/**
+* Text of the generated declaration file.
+*
+* @param entries Every resolved model, in any order.
+* @param typingsDirectory Absolute directory the file is written to; import
+* specifiers are relative to it.
+*/
+function renderModelResourceRegistry(entries, typingsDirectory) {
+	const lines = [];
+	for (const { key, entry } of assignRegistryKeys(entries)) {
+		const modelPath = toTypeImportSpecifier(typingsDirectory, entry.modelFile);
+		const resourcePath = toTypeImportSpecifier(typingsDirectory, entry.resourceFile);
+		if (modelPath === void 0 || resourcePath === void 0) continue;
+		const model = `import(${JSON.stringify(modelPath)}).${entry.modelExport}`;
+		const resource = `typeof import(${JSON.stringify(resourcePath)}).${entry.resourceExport}`;
+		lines.push(`    ${JSON.stringify(key)}: { model: ${model}; resource: ${resource} };`);
+	}
+	return `// Auto-generated by Warlock.js - DO NOT EDIT
+// One entry per model class that declares \`static resource = <Resource>\`, so
+// \`Serialized<Model>\` resolves to the resource output. Models whose resource
+// cannot be resolved statically are left out.
+
+import "@warlock.js/core";
+
+declare module "@warlock.js/core" {
+  interface ModelResourceRegistry {
+${lines.join("\n")}
+  }
+}
+`;
+}
+/**
+* Write `content` to `filePath` through a temporary sibling and a rename, so a
+* reader (the editor's TypeScript server) never sees a half-written file, and
+* skip the write entirely when the file already holds exactly this text.
+*
+* @returns `true` when the file was written.
+*/
+async function writeFileIfChanged(filePath, content) {
+	try {
+		if (await readFile(filePath, "utf-8") === content) return false;
+	} catch {}
+	await mkdir(dirname(filePath), { recursive: true });
+	const temporaryPath = `${filePath}.${process.pid}.tmp`;
+	try {
+		await writeFile(temporaryPath, content, "utf-8");
+		await rename(temporaryPath, filePath);
+	} catch (error) {
+		await rm(temporaryPath, { force: true });
+		throw error;
+	}
+	return true;
+}
+
+//#endregion
+export { extractModelResourceEntries, renderModelResourceRegistry, writeFileIfChanged };
+//# sourceMappingURL=model-resource-typings.mjs.map

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

@@ -0,0 +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":"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"}

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

@@ -3,13 +3,15 @@ import { warlockPath } from "../utils/paths.mjs";
 import "../utils/index.mjs";
 import { parseLocaleDictionary } from "../localization/parse-locale-dictionary.mjs";
 import "../localization/index.mjs";
-import { devLogError, devLogInfo, devLogSuccess, devServeLog } from "./dev-logger.mjs";
+import { devLogDim, devLogError, devLogInfo, devLogSuccess, devServeLog } from "./dev-logger.mjs";
+import { parseImports } from "./parse-imports.mjs";
 import { getFilesFromDirectory } from "./utils.mjs";
 import { extractTranslationKeys } from "./extract-translation-keys.mjs";
 import { filesOrchestrator } from "./files-orchestrator.mjs";
 import { readConfigAst } from "./read-config-ast.mjs";
 import { runTypingsGeneration } from "./run-typings-generation.mjs";
 import { isModuleLocaleDictionaryPath, isTranslationRegisteringSource } from "./translation-keys-sources.mjs";
+import { extractModelResourceEntries, renderModelResourceRegistry, writeFileIfChanged } from "./model-resource-typings.mjs";
 import { join, resolve } from "path";
 import { ensureDirectoryAsync } from "@warlock.js/fs";
 import { constants } from "fs";
@@ -58,6 +60,7 @@ var TypeGenerator = class {
 		this.manifest = null;
 		this.configCache = /* @__PURE__ */ new Map();
 		this.translationSourceFiles = /* @__PURE__ */ new Set();
+		this.modelResourceSourceFiles = /* @__PURE__ */ new Set();
 	}
 	/**
 	* Generate all framework type definitions
@@ -83,6 +86,7 @@ var TypeGenerator = class {
 			await this.reconcile();
 		}
 		await this.generateTranslationTypes();
+		await this.generateModelResourceTypes();
 		await this.saveManifest();
 	}
 	/**
@@ -278,6 +282,42 @@ ${Array.from(keys).sort().map((key) => `    ${JSON.stringify(key)}: true;`).join
 		await writeFile(join(this.outputDir, "translations.d.ts"), content, "utf-8");
 		devLogSuccess(`Generated translation types: ${keys.size} keys`);
 	}
+	/**
+	* Generate `model-resources.d.ts`: the `ModelResourceRegistry` augmentation
+	* behind `Serialized<Model>`.
+	*
+	* Reads every discovered model file (`*.model.ts`) and records the ones that
+	* declare `static resource = <Identifier>`. Static AST read only, no app
+	* module is imported; see `model-resource-typings.ts` for what is skipped.
+	* The file is rewritten only when its text changes.
+	*/
+	async generateModelResourceTypes() {
+		try {
+			const entries = [];
+			const sourceFiles = /* @__PURE__ */ new Set();
+			const skippedModels = [];
+			for (const [path, fileManager] of filesOrchestrator.getFiles()) {
+				if (fileManager.type !== "model" || !fileManager.source.includes("resource")) continue;
+				const imports = await parseImports(fileManager.source, fileManager.absolutePath);
+				const extraction = extractModelResourceEntries({
+					source: fileManager.source,
+					absolutePath: fileManager.absolutePath,
+					resolveImport: (specifier) => imports.get(specifier)?.absolutePath
+				});
+				if (extraction.entries.length > 0) sourceFiles.add(path);
+				for (const entry of extraction.entries) {
+					entries.push(entry);
+					sourceFiles.add(Path.toRelative(entry.resourceFile));
+				}
+				for (const skipped of extraction.skipped) skippedModels.push(`${skipped.className} (${skipped.reason})`);
+			}
+			this.modelResourceSourceFiles = sourceFiles;
+			if (await writeFileIfChanged(join(this.outputDir, "model-resources.d.ts"), renderModelResourceRegistry(entries, this.outputDir))) devLogSuccess(`Generated model resource types: ${entries.length} models`);
+			if (skippedModels.length > 0) devLogDim(`Model resources not typed (not statically resolvable): ${skippedModels.join(", ")}`);
+		} catch (error) {
+			devServeLog(`⚠️ Failed to generate model resource types: ${error}`);
+		}
+	}
 	isLocalesFile(path) {
 		return Path.normalize(path).includes("/utils/locales.");
 	}
@@ -535,12 +575,16 @@ ${allKeys.map((key) => `    "${key}": true;`).join("\n")}
 	*/
 	async executeTypingsGenerator(upcomingFiles) {
 		const files = filesOrchestrator.getFiles();
-		if (!(Array.from(this.translationSourceFiles).some((path) => !files.has(path)) || Array.from(new Set(upcomingFiles)).some((file) => {
+		const aKnownTranslationSourceVanished = Array.from(this.translationSourceFiles).some((path) => !files.has(path));
+		const aKnownModelResourceSourceVanished = Array.from(this.modelResourceSourceFiles).some((path) => !files.has(path));
+		if (!(aKnownTranslationSourceVanished || aKnownModelResourceSourceVanished || Array.from(new Set(upcomingFiles)).some((file) => {
 			const normalizedPath = Path.normalize(file);
 			if (normalizedPath.includes("src/config/")) return true;
 			if (isRouteLocalesJsonPath(normalizedPath)) return true;
 			if (isModuleLocaleDictionaryPath(normalizedPath)) return true;
 			if (this.translationSourceFiles.has(normalizedPath)) return true;
+			if (this.modelResourceSourceFiles.has(normalizedPath)) return true;
+			if (files.get(normalizedPath)?.type === "model") return true;
 			const fileManager = files.get(normalizedPath);
 			return fileManager !== void 0 && isTranslationRegisteringSource(normalizedPath, fileManager.source);
 		}))) return;