@warlock.js/core 5.10.0 → 5.11.0

package/CHANGELOG.md

@@ -6,6 +6,20 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 > ⚠ **Versioning: `@warlock.js/*` does not follow SemVer strictly — breaking changes may ship in a minor.** This is a deliberate decision, not an oversight: the framework is pre-adoption and the cost of a major per behaviour fix currently outweighs the benefit. **Pin an exact version or a tilde range (`~4.13.0`) if you need to opt into changes rather than receive them.** Every breaking change is marked **BREAKING** in its entry and summarised in an *Upgrading* section at the top of the release. **This policy will change once the framework has consumers beyond its author.**
 
+## 5.11.0 - 2026-09-14
+
+### Added
+
+- Tests and documentation for optional file fields: `v.file().optional()` skips an absent upload and reports a present non-file value as a normal validation error.
+
+### Fixed
+
+- `warlock dev` printed `hmr update` for a backend file before the new code was live, so a request made right after the line could still get the old response. The line now prints once the reload has finished and shows how long it took.
+
+### Changed
+
+- Backend file changes are picked up sooner in `warlock dev` (event debounce 150ms → 50ms).
+
 ## 5.10.0 - 2026-09-14
 
 _Released in lockstep with the `@warlock.js/*` family; no package-specific changes in 5.10.0._

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

@@ -65,10 +65,11 @@ function devLogInfo(message) {
 function devLogDim(message) {
 	console.log(`${timestamp()} ${colors.dim(message)}`);
 }
-function devLogHMR(file, dependents) {
+function devLogHMR(file, dependents, durationMs) {
 	const relativePath = Path.toRelative(file);
 	const depInfo = dependents ? colors.dim(` +${dependents} module${dependents > 1 ? "s" : ""}`) : "";
-	console.log(`${timestamp()} 🔥 ${colors.green("hmr update")} ${colors.dim(relativePath)}${depInfo}`);
+	const durationInfo = durationMs !== void 0 ? colors.dim(` (${durationMs}ms)`) : "";
+	console.log(`${timestamp()} 🔥 ${colors.green("hmr update")} ${colors.dim(relativePath)}${depInfo}${durationInfo}`);
 }
 function devLogSection(title) {
 	console.log(`\n${timestamp()} ${colors.bold(colors.cyan(title))}`);

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

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

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

@@ -20,7 +20,7 @@ var FileEventHandler = class {
 		this.pendingChanges = /* @__PURE__ */ new Set();
 		this.pendingAdds = /* @__PURE__ */ new Set();
 		this.pendingDeletes = /* @__PURE__ */ new Set();
-		this.processPendingEvents = debounce(() => this.processBatch(), 150);
+		this.processPendingEvents = debounce(() => this.processBatch(), 50);
 	}
 	handleFileChange(absolutePath) {
 		this.pendingChanges.add(Path.toRelative(absolutePath));

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

@@ -1 +1 @@
-{"version":3,"file":"file-event-handler.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/file-event-handler.ts"],"sourcesContent":["import events from \"@mongez/events\";\nimport { debounce } from \"@mongez/reinforcements\";\nimport type { DependencyGraph } from \"./dependency-graph\";\nimport { devLogSuccess } from \"./dev-logger\";\nimport type { FileManager } from \"./file-manager\";\nimport type { FileOperations } from \"./file-operations\";\nimport { FILE_PROCESSING_BATCH_SIZE } from \"./flags\";\nimport type { ManifestManager } from \"./manifest-manager\";\nimport { clearFileExistsCache } from \"./parse-imports\";\nimport { Path } from \"../utils/normalized-path\";\n\n/**\n * Receives raw watcher events and processes them in a single debounced batch.\n * Order within a batch: adds → changes → deletes, so changes can reference\n * newly-added files and deletes fire last.\n */\nexport class FileEventHandler {\n  private pendingChanges = new Set<string>();\n  private pendingAdds = new Set<string>();\n  private pendingDeletes = new Set<string>();\n\n  private readonly processPendingEvents = debounce(() => this.processBatch(), 150);\n\n  constructor(\n    private readonly fileOperations: FileOperations,\n    private readonly manifest: ManifestManager,\n    private readonly dependencyGraph: DependencyGraph,\n    private readonly files: Map<string, FileManager>,\n  ) {}\n\n  public handleFileChange(absolutePath: string): void {\n    this.pendingChanges.add(Path.toRelative(absolutePath));\n    this.processPendingEvents();\n  }\n\n  public handleFileAdd(absolutePath: string): void {\n    this.pendingAdds.add(Path.toRelative(absolutePath));\n    this.processPendingEvents();\n  }\n\n  public handleFileDelete(absolutePath: string): void {\n    this.pendingDeletes.add(Path.toRelative(absolutePath));\n    this.processPendingEvents();\n  }\n\n  private async processBatch(): Promise<void> {\n    const changes = Array.from(this.pendingChanges);\n    const adds = Array.from(this.pendingAdds);\n    const deletes = Array.from(this.pendingDeletes);\n\n    this.pendingChanges.clear();\n    this.pendingAdds.clear();\n    this.pendingDeletes.clear();\n\n    if (changes.length === 0 && adds.length === 0 && deletes.length === 0) return;\n\n    // Both .env files and warlock.config.ts live outside src/ — they should\n    // never enter the dep graph, only ride along in the batch event so the\n    // dev server can react (config reload / restart warning).\n    const externalChanges = changes.filter(isExternalPath);\n    const codeChanges = changes.filter((p) => !isExternalPath(p));\n    const codeAdds = adds.filter((p) => !isExternalPath(p));\n\n    // Multi-file batches can race the filesystem on Windows.\n    if (codeAdds.length + codeChanges.length > 1) {\n      await new Promise((resolve) => setTimeout(resolve, 500));\n      clearFileExistsCache();\n    }\n\n    await this.processBatchAdds(codeAdds);\n    const changedCodePaths = await this.processBatchChanges(codeChanges);\n    await this.processBatchDeletes(deletes);\n\n    this.fileOperations.updateFileDependents();\n    this.fileOperations.syncFilesToManifest();\n    await this.manifest.save();\n\n    // Emit only the code paths that genuinely changed (hash differs). A no-op\n    // save — an editor that fsyncs without writing — reports no change and is\n    // dropped here, where we still know the pre-change hash. (Doing this\n    // downstream is impossible: the source has already been overwritten, so a\n    // content compare always looks unchanged — which is exactly why emptying a\n    // file used to silently skip HMR.) External paths (.env / warlock.config.ts)\n    // ride along untouched so the dev server can still react to them.\n    events.trigger(\"dev-server:batch-complete\", {\n      added: adds,\n      changed: [...externalChanges, ...changedCodePaths],\n      deleted: deletes,\n    });\n  }\n\n  /**\n   * Reprocess each changed file and return only the paths that genuinely\n   * changed. `updateFile` returns false when the on-disk hash matches the\n   * last-processed hash (e.g. an editor that fsyncs on save without writing),\n   * so those no-ops are kept out of the reload batch. Emptying a file changes\n   * its hash, so it is correctly reported as changed.\n   */\n  private async processBatchChanges(relativePaths: string[]): Promise<string[]> {\n    const changed: string[] = [];\n    await runInBatches(relativePaths, FILE_PROCESSING_BATCH_SIZE, async (path) => {\n      if (await this.fileOperations.updateFile(path)) {\n        changed.push(path);\n      }\n    });\n    return changed;\n  }\n\n  private async processBatchAdds(relativePaths: string[]): Promise<void> {\n    await runInBatches(relativePaths, FILE_PROCESSING_BATCH_SIZE, async (path) => {\n      try {\n        await this.fileOperations.addFile(path);\n        devLogSuccess(`Added file: ${path}`);\n      } catch (error) {\n        console.error(`Failed to add file ${path}:`, error);\n      }\n    });\n  }\n\n  private async processBatchDeletes(relativePaths: string[]): Promise<void> {\n    for (const relativePath of relativePaths) {\n      await this.fileOperations.deleteFile(relativePath);\n      devLogSuccess(`Deleted file: ${relativePath}`);\n    }\n  }\n}\n\nfunction isEnvFile(path: string): boolean {\n  const basename = path.split(\"/\").pop() || path;\n  return basename === \".env\" || basename.startsWith(\".env.\");\n}\n\n/** Paths watched but never added to the dependency graph. */\nfunction isExternalPath(path: string): boolean {\n  return isEnvFile(path) || path === \"warlock.config.ts\";\n}\n\nasync function runInBatches<T>(\n  items: T[],\n  size: number,\n  fn: (item: T) => Promise<unknown>,\n): Promise<void> {\n  if (items.length === 0) return;\n  for (let i = 0; i < items.length; i += size) {\n    await Promise.all(items.slice(i, i + size).map(fn));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"file-event-handler.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/file-event-handler.ts"],"sourcesContent":["import events from \"@mongez/events\";\nimport { debounce } from \"@mongez/reinforcements\";\nimport type { DependencyGraph } from \"./dependency-graph\";\nimport { devLogSuccess } from \"./dev-logger\";\nimport type { FileManager } from \"./file-manager\";\nimport type { FileOperations } from \"./file-operations\";\nimport { FILE_PROCESSING_BATCH_SIZE } from \"./flags\";\nimport type { ManifestManager } from \"./manifest-manager\";\nimport { clearFileExistsCache } from \"./parse-imports\";\nimport { Path } from \"../utils/normalized-path\";\n\n/**\n * Receives raw watcher events and processes them in a single debounced batch.\n * Order within a batch: adds → changes → deletes, so changes can reference\n * newly-added files and deletes fire last.\n */\nexport class FileEventHandler {\n  private pendingChanges = new Set<string>();\n  private pendingAdds = new Set<string>();\n  private pendingDeletes = new Set<string>();\n\n  private readonly processPendingEvents = debounce(() => this.processBatch(), 50);\n\n  constructor(\n    private readonly fileOperations: FileOperations,\n    private readonly manifest: ManifestManager,\n    private readonly dependencyGraph: DependencyGraph,\n    private readonly files: Map<string, FileManager>,\n  ) {}\n\n  public handleFileChange(absolutePath: string): void {\n    this.pendingChanges.add(Path.toRelative(absolutePath));\n    this.processPendingEvents();\n  }\n\n  public handleFileAdd(absolutePath: string): void {\n    this.pendingAdds.add(Path.toRelative(absolutePath));\n    this.processPendingEvents();\n  }\n\n  public handleFileDelete(absolutePath: string): void {\n    this.pendingDeletes.add(Path.toRelative(absolutePath));\n    this.processPendingEvents();\n  }\n\n  private async processBatch(): Promise<void> {\n    const changes = Array.from(this.pendingChanges);\n    const adds = Array.from(this.pendingAdds);\n    const deletes = Array.from(this.pendingDeletes);\n\n    this.pendingChanges.clear();\n    this.pendingAdds.clear();\n    this.pendingDeletes.clear();\n\n    if (changes.length === 0 && adds.length === 0 && deletes.length === 0) return;\n\n    // Both .env files and warlock.config.ts live outside src/ — they should\n    // never enter the dep graph, only ride along in the batch event so the\n    // dev server can react (config reload / restart warning).\n    const externalChanges = changes.filter(isExternalPath);\n    const codeChanges = changes.filter((p) => !isExternalPath(p));\n    const codeAdds = adds.filter((p) => !isExternalPath(p));\n\n    // Multi-file batches can race the filesystem on Windows.\n    if (codeAdds.length + codeChanges.length > 1) {\n      await new Promise((resolve) => setTimeout(resolve, 500));\n      clearFileExistsCache();\n    }\n\n    await this.processBatchAdds(codeAdds);\n    const changedCodePaths = await this.processBatchChanges(codeChanges);\n    await this.processBatchDeletes(deletes);\n\n    this.fileOperations.updateFileDependents();\n    this.fileOperations.syncFilesToManifest();\n    await this.manifest.save();\n\n    // Emit only the code paths that genuinely changed (hash differs). A no-op\n    // save — an editor that fsyncs without writing — reports no change and is\n    // dropped here, where we still know the pre-change hash. (Doing this\n    // downstream is impossible: the source has already been overwritten, so a\n    // content compare always looks unchanged — which is exactly why emptying a\n    // file used to silently skip HMR.) External paths (.env / warlock.config.ts)\n    // ride along untouched so the dev server can still react to them.\n    events.trigger(\"dev-server:batch-complete\", {\n      added: adds,\n      changed: [...externalChanges, ...changedCodePaths],\n      deleted: deletes,\n    });\n  }\n\n  /**\n   * Reprocess each changed file and return only the paths that genuinely\n   * changed. `updateFile` returns false when the on-disk hash matches the\n   * last-processed hash (e.g. an editor that fsyncs on save without writing),\n   * so those no-ops are kept out of the reload batch. Emptying a file changes\n   * its hash, so it is correctly reported as changed.\n   */\n  private async processBatchChanges(relativePaths: string[]): Promise<string[]> {\n    const changed: string[] = [];\n    await runInBatches(relativePaths, FILE_PROCESSING_BATCH_SIZE, async (path) => {\n      if (await this.fileOperations.updateFile(path)) {\n        changed.push(path);\n      }\n    });\n    return changed;\n  }\n\n  private async processBatchAdds(relativePaths: string[]): Promise<void> {\n    await runInBatches(relativePaths, FILE_PROCESSING_BATCH_SIZE, async (path) => {\n      try {\n        await this.fileOperations.addFile(path);\n        devLogSuccess(`Added file: ${path}`);\n      } catch (error) {\n        console.error(`Failed to add file ${path}:`, error);\n      }\n    });\n  }\n\n  private async processBatchDeletes(relativePaths: string[]): Promise<void> {\n    for (const relativePath of relativePaths) {\n      await this.fileOperations.deleteFile(relativePath);\n      devLogSuccess(`Deleted file: ${relativePath}`);\n    }\n  }\n}\n\nfunction isEnvFile(path: string): boolean {\n  const basename = path.split(\"/\").pop() || path;\n  return basename === \".env\" || basename.startsWith(\".env.\");\n}\n\n/** Paths watched but never added to the dependency graph. */\nfunction isExternalPath(path: string): boolean {\n  return isEnvFile(path) || path === \"warlock.config.ts\";\n}\n\nasync function runInBatches<T>(\n  items: T[],\n  size: number,\n  fn: (item: T) => Promise<unknown>,\n): Promise<void> {\n  if (items.length === 0) return;\n  for (let i = 0; i < items.length; i += size) {\n    await Promise.all(items.slice(i, i + size).map(fn));\n  }\n}\n"],"mappings":"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"}

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

@@ -46,11 +46,16 @@ var LayerExecutor = class {
 			return;
 		}
 		const invalidationChain = /* @__PURE__ */ new Set();
+		const pendingHmrLogs = [];
 		for (const path of changedPaths) {
 			for (const file of this.dependencyGraph.getInvalidationChain(path)) invalidationChain.add(file);
-			devLogHMR(path, invalidationChain.size - 1);
+			pendingHmrLogs.push({
+				path,
+				dependents: invalidationChain.size - 1
+			});
 		}
 		const chain = Array.from(invalidationChain);
+		const reloadStartedAt = Date.now();
 		for (const relativePath of chain) {
 			const file = filesMap.get(relativePath);
 			if (!file) continue;
@@ -65,6 +70,8 @@ var LayerExecutor = class {
 			...deletedFiles,
 			...affectedConfigPaths
 		]);
+		const elapsedMs = Date.now() - reloadStartedAt;
+		for (const { path, dependents } of pendingHmrLogs) devLogHMR(path, dependents, elapsedMs);
 	}
 	async restartAffectedConnectors(affectedFiles) {
 		const toRestart = connectorsManager.list().filter((connector) => connector.shouldRestart(affectedFiles));

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

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

package/llms-full.txt

@@ -5884,6 +5884,18 @@ v.file()                                          // must be UploadedFile
 
 Size accepts either bytes (`.maxSize(5_242_880)`) or `{ unit, size }` (`{ unit: "MB", size: 5 }`). See [`validate-input`](../validate-input/SKILL.md) for the full validation pattern.
 
+### Optional file field
+
+Chain `.optional()` in front of the file rules for a field the caller may or may not send — no hand-rolled "was a file attached" check needed:
+
+```ts
+const updateAvatarSchema = v.object({
+  avatar: v.file().optional().image(),
+});
+```
+
+An absent (or `null`) `avatar` key passes validation with `avatar` coming back `undefined`. A present `avatar` value that isn't a file fails with a normal, structured `avatar` error — the framework never throws for it.
+
 For ad-hoc validation outside a schema:
 
 ```ts
@@ -7833,6 +7845,19 @@ const uploadAvatarSchema = v.object({
 
 Full file chain: `.image()`, `.accept(extensions)`, `.mimeType(types)`, `.pdf()`, `.excel()`, `.word()`, `.minSize(n)`, `.maxSize(n)`, `.minWidth(px)`, `.maxWidth(px)`, `.minHeight(px)`, `.maxHeight(px)`. See [`upload-file`](../upload-file/SKILL.md) for the full upload flow.
 
+### Optional file field
+
+`.optional()` composes with `v.file()` the same as any other validator — no need to hand-roll an "if a file was sent" guard in the controller:
+
+```ts
+const updateAvatarSchema = v.object({
+  avatar: v.file().optional().image(),
+});
+```
+
+- Key absent (or `null`) → valid, `avatar` comes back `undefined`.
+- Key present but not a file (e.g. a stray string) → invalid, with a normal `avatar` error in the response — it never throws.
+
 ## What the framework sends on failure
 
 The framework calls `response.failedSchema(result)` which sends `400` with the shape configured under `validation.response` (defaults shown):

package/package.json

@@ -25,13 +25,13 @@
     "@mongez/slug": "^1.0.7",
     "@mongez/supportive-is": "^2.1.4",
     "@mongez/time-wizard": "^1.0.6",
-    "@warlock.js/auth": "5.10.0",
-    "@warlock.js/cache": "5.10.0",
-    "@warlock.js/cascade": "5.10.0",
-    "@warlock.js/context": "5.10.0",
-    "@warlock.js/logger": "5.10.0",
-    "@warlock.js/seal": "5.10.0",
-    "@warlock.js/fs": "5.10.0",
+    "@warlock.js/auth": "5.11.0",
+    "@warlock.js/cache": "5.11.0",
+    "@warlock.js/cascade": "5.11.0",
+    "@warlock.js/context": "5.11.0",
+    "@warlock.js/logger": "5.11.0",
+    "@warlock.js/seal": "5.11.0",
+    "@warlock.js/fs": "5.11.0",
     "chokidar": "^5.0.0",
     "dayjs": "^1.11.19",
     "es-module-lexer": "^2.0.0",
@@ -57,10 +57,10 @@
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
     "@react-email/render": "^2.0.5",
-    "@warlock.js/herald": "5.10.0",
-    "@warlock.js/ai": "5.10.0",
-    "@warlock.js/access": "5.10.0",
-    "@warlock.js/notifications": "5.10.0"
+    "@warlock.js/herald": "5.11.0",
+    "@warlock.js/ai": "5.11.0",
+    "@warlock.js/access": "5.11.0",
+    "@warlock.js/notifications": "5.11.0"
   },
   "peerDependenciesMeta": {
     "sharp": {
@@ -123,7 +123,7 @@
   ],
   "author": "hassanzohdy",
   "license": "MIT",
-  "version": "5.10.0",
+  "version": "5.11.0",
   "type": "module",
   "main": "./esm/index.mjs",
   "module": "./esm/index.mjs",

package/skills/upload-file/SKILL.md

@@ -210,6 +210,18 @@ v.file()                                          // must be UploadedFile
 
 Size accepts either bytes (`.maxSize(5_242_880)`) or `{ unit, size }` (`{ unit: "MB", size: 5 }`). See [`validate-input`](../validate-input/SKILL.md) for the full validation pattern.
 
+### Optional file field
+
+Chain `.optional()` in front of the file rules for a field the caller may or may not send — no hand-rolled "was a file attached" check needed:
+
+```ts
+const updateAvatarSchema = v.object({
+  avatar: v.file().optional().image(),
+});
+```
+
+An absent (or `null`) `avatar` key passes validation with `avatar` coming back `undefined`. A present `avatar` value that isn't a file fails with a normal, structured `avatar` error — the framework never throws for it.
+
 For ad-hoc validation outside a schema:
 
 ```ts

package/skills/validate-input/SKILL.md

@@ -170,6 +170,19 @@ const uploadAvatarSchema = v.object({
 
 Full file chain: `.image()`, `.accept(extensions)`, `.mimeType(types)`, `.pdf()`, `.excel()`, `.word()`, `.minSize(n)`, `.maxSize(n)`, `.minWidth(px)`, `.maxWidth(px)`, `.minHeight(px)`, `.maxHeight(px)`. See [`upload-file`](../upload-file/SKILL.md) for the full upload flow.
 
+### Optional file field
+
+`.optional()` composes with `v.file()` the same as any other validator — no need to hand-roll an "if a file was sent" guard in the controller:
+
+```ts
+const updateAvatarSchema = v.object({
+  avatar: v.file().optional().image(),
+});
+```
+
+- Key absent (or `null`) → valid, `avatar` comes back `undefined`.
+- Key present but not a file (e.g. a stray string) → invalid, with a normal `avatar` error in the response — it never throws.
+
 ## What the framework sends on failure
 
 The framework calls `response.failedSchema(result)` which sends `400` with the shape configured under `validation.response` (defaults shown):