@warlock.js/core 5.28.0 → 5.30.0

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

@@ -1 +1 @@
-{"version":3,"file":"shortcuts.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/shortcuts.ts"],"sourcesContent":["import readline from \"node:readline\";\n\n/**\n * A single-keypress shortcut offered by the dev server while it runs.\n */\nexport type DevServerShortcut = {\n  /** The key that triggers it, e.g. `\"u\"`. Matched case-insensitively. */\n  key: string;\n  /** Short human label, used when we print the available shortcuts. */\n  description: string;\n  /** What to run when the key is pressed. Rejections are swallowed. */\n  handler: () => void | Promise<void>;\n};\n\n/**\n * Single-keypress shortcuts for the dev server (`press u to update`, …).\n *\n * Reading one key at a time requires putting stdin into raw mode, which\n * means this process — not the terminal driver — becomes responsible for\n * `Ctrl+C`. The manager therefore re-raises `SIGINT` itself so the existing\n * graceful-shutdown handlers keep working exactly as before.\n *\n * Everything is opt-in and self-guarding: with no TTY (piped output, CI,\n * a supervisor) `register()` reports `false` and stdin is never touched, so\n * callers can fall back to printing a plain \"run `npx warlock update`\" hint.\n */\nexport class DevServerShortcuts {\n  private readonly shortcuts = new Map<string, DevServerShortcut>();\n\n  /** Whether we currently hold stdin in raw mode. */\n  private listening = false;\n\n  /** Set while a handler runs, so a second keypress can't re-enter it. */\n  private busy = false;\n\n  private keypressListener?: (character: string, key: KeypressEvent) => void;\n\n  /**\n   * @param explicitInput The stream to read keys from. Tests pass a fake TTY;\n   *                      production code omits it and gets `process.stdin`,\n   *                      resolved lazily — see {@link input}.\n   * @param onInterrupt   What `Ctrl+C` does once raw mode has taken it away\n   *                      from the terminal driver. Defaults to re-raising\n   *                      `SIGINT`.\n   */\n  public constructor(\n    private readonly explicitInput?: NodeJS.ReadStream,\n    private readonly onInterrupt: () => void = raiseInterrupt,\n  ) {}\n\n  /**\n   * The stream to read keys from, resolved on first USE rather than at\n   * construction.\n   *\n   * `devServerShortcuts` below is a process-wide singleton, and every CLI\n   * command loads it merely by importing `dev-server.command.ts` —\n   * `framework-cli-commands.ts` statically imports every command module up\n   * front, for `warlock add`/`migrate`/`routes`/etc. just as much as for\n   * `warlock dev`. A constructor-default of `process.stdin` used to run at\n   * THAT import, not at `register()`, so simply running any command touched\n   * `process.stdin` and made Node construct a real stdin handle nobody asked\n   * for — including one-shot commands that never call `register()` and have\n   * no terminal to manage. A getter defers the touch to the methods that\n   * actually need a stream (`isSupported`/`register`/`listen`/`release`),\n   * none of which run for a command that never offers a shortcut.\n   */\n  private get input(): NodeJS.ReadStream {\n    return this.explicitInput ?? process.stdin;\n  }\n\n  /**\n   * Whether the current terminal can deliver individual keypresses. False in\n   * CI, when stdin is a pipe, and in any non-interactive shell.\n   */\n  public isSupported(): boolean {\n    return Boolean(this.input.isTTY && typeof this.input.setRawMode === \"function\");\n  }\n\n  /**\n   * Offer a shortcut. Returns whether it was actually registered — `false`\n   * means the terminal can't support keypresses and the caller should print\n   * a copy-and-paste command instead.\n   */\n  public register(shortcut: DevServerShortcut): boolean {\n    if (!this.isSupported()) {\n      return false;\n    }\n\n    this.shortcuts.set(shortcut.key.toLowerCase(), shortcut);\n    this.listen();\n\n    return true;\n  }\n\n  /** Every armed shortcut, in the order it was registered. */\n  public list(): DevServerShortcut[] {\n    return [...this.shortcuts.values()];\n  }\n\n  /** Drop a shortcut, releasing the terminal once none are left. */\n  public unregister(key: string): void {\n    this.shortcuts.delete(key.toLowerCase());\n\n    if (this.shortcuts.size === 0) {\n      this.release();\n    }\n  }\n\n  /**\n   * Hand the terminal back: leave raw mode and stop listening. Call this\n   * before spawning a child process that needs stdin (the package manager\n   * install), and on shutdown. Registered shortcuts are kept, so `register()`\n   * (or `resume()`) can take the terminal again afterwards.\n   */\n  public release(): void {\n    if (!this.listening) {\n      return;\n    }\n\n    this.listening = false;\n\n    if (this.keypressListener) {\n      this.input.off(\"keypress\", this.keypressListener);\n      this.keypressListener = undefined;\n    }\n\n    if (this.input.isTTY) {\n      this.input.setRawMode(false);\n    }\n\n    this.input.pause();\n  }\n\n  /** Re-take the terminal after a {@link release}, if shortcuts remain. */\n  public resume(): void {\n    if (this.shortcuts.size > 0) {\n      this.listen();\n    }\n  }\n\n  /** Start (or keep) listening for keypresses. */\n  private listen(): void {\n    if (this.listening || !this.isSupported()) {\n      return;\n    }\n\n    this.listening = true;\n\n    readline.emitKeypressEvents(this.input);\n    this.input.setRawMode(true);\n    this.input.resume();\n\n    this.keypressListener = (_character, key) => {\n      void this.handleKeypress(key);\n    };\n\n    this.input.on(\"keypress\", this.keypressListener);\n  }\n\n  /**\n   * Route a keypress to its shortcut. In raw mode the terminal no longer\n   * turns `Ctrl+C` into a signal for us, so we translate it back into a\n   * `SIGINT` and let the dev server's shutdown handlers take it from there.\n   */\n  private async handleKeypress(key: KeypressEvent | undefined): Promise<void> {\n    if (!key) {\n      return;\n    }\n\n    if ((key.ctrl && (key.name === \"c\" || key.name === \"d\")) || key.sequence === \"\\u0003\") {\n      this.release();\n      this.onInterrupt();\n      return;\n    }\n\n    if (this.busy) {\n      return;\n    }\n\n    const shortcut = key.name ? this.shortcuts.get(key.name.toLowerCase()) : undefined;\n\n    if (!shortcut) {\n      return;\n    }\n\n    this.busy = true;\n\n    try {\n      await shortcut.handler();\n    } catch {\n      // A shortcut is a convenience — never let it take the dev server down.\n    } finally {\n      this.busy = false;\n    }\n  }\n}\n\n/** Re-raise the interrupt the terminal would have sent outside raw mode. */\nfunction raiseInterrupt(): void {\n  // `process.kill(pid, \"SIGINT\")` is TerminateProcess on Windows, skipping the\n  // graceful shutdown; emitting runs the registered handlers on every OS.\n  process.emit(\"SIGINT\");\n}\n\n/** The keypress shape emitted by `readline.emitKeypressEvents`. */\ntype KeypressEvent = {\n  name?: string;\n  sequence?: string;\n  ctrl?: boolean;\n  meta?: boolean;\n  shift?: boolean;\n};\n\n/** Process-wide shortcuts for the running dev server. */\nexport const devServerShortcuts = new DevServerShortcuts();\n"],"mappings":";;;;;;;;;;;;;;;AA0BA,IAAa,qBAAb,MAAgC;;;;;;;;;CAmB9B,AAAO,YACL,AAAiB,eACjB,AAAiB,cAA0B,gBAC3C;EAFiB;EACA;mCApBU,IAAI,IAA+B;mBAG5C;cAGL;CAeZ;;;;;;;;;;;;;;;;;CAkBH,IAAY,QAA2B;EACrC,OAAO,KAAK,iBAAiB,QAAQ;CACvC;;;;;CAMA,AAAO,cAAuB;EAC5B,OAAO,QAAQ,KAAK,MAAM,SAAS,OAAO,KAAK,MAAM,eAAe,UAAU;CAChF;;;;;;CAOA,AAAO,SAAS,UAAsC;EACpD,IAAI,CAAC,KAAK,YAAY,GACpB,OAAO;EAGT,KAAK,UAAU,IAAI,SAAS,IAAI,YAAY,GAAG,QAAQ;EACvD,KAAK,OAAO;EAEZ,OAAO;CACT;;CAGA,AAAO,OAA4B;EACjC,OAAO,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC;CACpC;;CAGA,AAAO,WAAW,KAAmB;EACnC,KAAK,UAAU,OAAO,IAAI,YAAY,CAAC;EAEvC,IAAI,KAAK,UAAU,SAAS,GAC1B,KAAK,QAAQ;CAEjB;;;;;;;CAQA,AAAO,UAAgB;EACrB,IAAI,CAAC,KAAK,WACR;EAGF,KAAK,YAAY;EAEjB,IAAI,KAAK,kBAAkB;GACzB,KAAK,MAAM,IAAI,YAAY,KAAK,gBAAgB;GAChD,KAAK,mBAAmB;EAC1B;EAEA,IAAI,KAAK,MAAM,OACb,KAAK,MAAM,WAAW,KAAK;EAG7B,KAAK,MAAM,MAAM;CACnB;;CAGA,AAAO,SAAe;EACpB,IAAI,KAAK,UAAU,OAAO,GACxB,KAAK,OAAO;CAEhB;;CAGA,AAAQ,SAAe;EACrB,IAAI,KAAK,aAAa,CAAC,KAAK,YAAY,GACtC;EAGF,KAAK,YAAY;EAEjB,SAAS,mBAAmB,KAAK,KAAK;EACtC,KAAK,MAAM,WAAW,IAAI;EAC1B,KAAK,MAAM,OAAO;EAElB,KAAK,oBAAoB,YAAY,QAAQ;GAC3C,AAAK,KAAK,eAAe,GAAG;EAC9B;EAEA,KAAK,MAAM,GAAG,YAAY,KAAK,gBAAgB;CACjD;;;;;;CAOA,MAAc,eAAe,KAA+C;EAC1E,IAAI,CAAC,KACH;EAGF,IAAK,IAAI,SAAS,IAAI,SAAS,OAAO,IAAI,SAAS,QAAS,IAAI,aAAa,KAAU;GACrF,KAAK,QAAQ;GACb,KAAK,YAAY;GACjB;EACF;EAEA,IAAI,KAAK,MACP;EAGF,MAAM,WAAW,IAAI,OAAO,KAAK,UAAU,IAAI,IAAI,KAAK,YAAY,CAAC,IAAI;EAEzE,IAAI,CAAC,UACH;EAGF,KAAK,OAAO;EAEZ,IAAI;GACF,MAAM,SAAS,QAAQ;EACzB,QAAQ,CAER,UAAU;GACR,KAAK,OAAO;EACd;CACF;AACF;;AAGA,SAAS,iBAAuB;CAG9B,QAAQ,KAAK,QAAQ;AACvB;;AAYA,MAAa,qBAAqB,IAAI,mBAAmB"}
+{"version":3,"file":"shortcuts.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/shortcuts.ts"],"sourcesContent":["import readline from \"node:readline\";\n\n/**\n * A single-keypress shortcut offered by the dev server while it runs.\n */\nexport type DevServerShortcut = {\n  /** The key that triggers it, e.g. `\"u\"`. Matched case-insensitively. */\n  key: string;\n  /** Short human label, used when we print the available shortcuts. */\n  description: string;\n  /** What to run when the key is pressed. Rejections are swallowed. */\n  handler: () => void | Promise<void>;\n};\n\n/**\n * Single-keypress shortcuts for the dev server (`press u to update`, …).\n *\n * Reading one key at a time requires putting stdin into raw mode, which\n * means this process — not the terminal driver — becomes responsible for\n * `Ctrl+C`. The manager therefore re-raises `SIGINT` itself so the existing\n * graceful-shutdown handlers keep working exactly as before.\n *\n * Everything is opt-in and self-guarding: with no TTY (piped output, CI,\n * a supervisor) `register()` reports `false` and stdin is never touched, so\n * callers can fall back to printing a plain \"run `npx warlock update`\" hint.\n */\nexport class DevServerShortcuts {\n  private readonly shortcuts = new Map<string, DevServerShortcut>();\n\n  /** Whether we currently hold stdin in raw mode. */\n  private listening = false;\n\n  /** Set while a handler runs, so a second keypress can't re-enter it. */\n  private busy = false;\n\n  private keypressListener?: (character: string, key: KeypressEvent) => void;\n\n  /**\n   * @param explicitInput The stream to read keys from. Tests pass a fake TTY;\n   *                      production code omits it and gets `process.stdin`,\n   *                      resolved lazily — see {@link input}.\n   * @param onInterrupt   What `Ctrl+C` does once raw mode has taken it away\n   *                      from the terminal driver. Defaults to re-raising\n   *                      `SIGINT`.\n   */\n  public constructor(\n    private readonly explicitInput?: NodeJS.ReadStream,\n    private readonly onInterrupt: () => void = raiseInterrupt,\n  ) {}\n\n  /**\n   * The stream to read keys from, resolved on first USE rather than at\n   * construction.\n   *\n   * `devServerShortcuts` below is a process-wide singleton, and every CLI\n   * command loads it merely by importing `dev-server.command.ts` —\n   * `framework-cli-commands.ts` statically imports every command module up\n   * front, for `warlock add`/`migrate`/`routes`/etc. just as much as for\n   * `warlock dev`. A constructor-default of `process.stdin` used to run at\n   * THAT import, not at `register()`, so simply running any command touched\n   * `process.stdin` and made Node construct a real stdin handle nobody asked\n   * for — including one-shot commands that never call `register()` and have\n   * no terminal to manage. A getter defers the touch to the methods that\n   * actually need a stream (`isSupported`/`register`/`listen`/`release`),\n   * none of which run for a command that never offers a shortcut.\n   */\n  private get input(): NodeJS.ReadStream {\n    return this.explicitInput ?? process.stdin;\n  }\n\n  /**\n   * Whether the current terminal can deliver individual keypresses. False in\n   * CI, when stdin is a pipe, and in any non-interactive shell.\n   */\n  public isSupported(): boolean {\n    return Boolean(this.input.isTTY && typeof this.input.setRawMode === \"function\");\n  }\n\n  /**\n   * Offer a shortcut. Returns whether it was actually registered — `false`\n   * means the terminal can't support keypresses and the caller should print\n   * a copy-and-paste command instead.\n   */\n  public register(shortcut: DevServerShortcut): boolean {\n    if (!this.isSupported()) {\n      return false;\n    }\n\n    this.shortcuts.set(shortcut.key.toLowerCase(), shortcut);\n    this.listen();\n\n    return true;\n  }\n\n  /** Every armed shortcut, in the order it was registered. */\n  public list(): DevServerShortcut[] {\n    return [...this.shortcuts.values()];\n  }\n\n  /** Drop a shortcut, releasing the terminal once none are left. */\n  public unregister(key: string): void {\n    this.shortcuts.delete(key.toLowerCase());\n\n    if (this.shortcuts.size === 0) {\n      this.release();\n    }\n  }\n\n  /**\n   * Hand the terminal back: leave raw mode and stop listening. Call this\n   * before spawning a child process that needs stdin (the package manager\n   * install), and on shutdown. Registered shortcuts are kept, so `register()`\n   * (or `resume()`) can take the terminal again afterwards.\n   */\n  public release(): void {\n    if (!this.listening) {\n      return;\n    }\n\n    this.listening = false;\n\n    if (this.keypressListener) {\n      this.input.off(\"keypress\", this.keypressListener);\n      this.keypressListener = undefined;\n    }\n\n    if (this.input.isTTY) {\n      this.input.setRawMode(false);\n    }\n\n    this.input.pause();\n  }\n\n  /** Re-take the terminal after a {@link release}, if shortcuts remain. */\n  public resume(): void {\n    if (this.shortcuts.size > 0) {\n      this.listen();\n    }\n  }\n\n  /** Start (or keep) listening for keypresses. */\n  private listen(): void {\n    if (this.listening || !this.isSupported()) {\n      return;\n    }\n\n    this.listening = true;\n\n    readline.emitKeypressEvents(this.input);\n    this.input.setRawMode(true);\n    this.input.resume();\n\n    this.keypressListener = (_character, key) => {\n      void this.handleKeypress(key);\n    };\n\n    this.input.on(\"keypress\", this.keypressListener);\n  }\n\n  /**\n   * Route a keypress to its shortcut. In raw mode the terminal no longer\n   * turns `Ctrl+C` into a signal for us, so we translate it back into a\n   * `SIGINT` and let the dev server's shutdown handlers take it from there.\n   */\n  private async handleKeypress(key: KeypressEvent | undefined): Promise<void> {\n    if (!key) {\n      return;\n    }\n\n    if ((key.ctrl && (key.name === \"c\" || key.name === \"d\")) || key.sequence === \"\\u0003\") {\n      this.release();\n      this.onInterrupt();\n      return;\n    }\n\n    if (this.busy) {\n      return;\n    }\n\n    const shortcut = key.name ? this.shortcuts.get(key.name.toLowerCase()) : undefined;\n\n    if (!shortcut) {\n      return;\n    }\n\n    this.busy = true;\n\n    try {\n      await shortcut.handler();\n    } catch {\n      // A shortcut is a convenience — never let it take the dev server down.\n    } finally {\n      this.busy = false;\n    }\n  }\n}\n\n/** Re-raise the interrupt the terminal would have sent outside raw mode. */\nfunction raiseInterrupt(): void {\n  // `process.kill(pid, \"SIGINT\")` is TerminateProcess on Windows, skipping the\n  // graceful shutdown; emitting runs the registered handlers on every OS.\n  process.emit(\"SIGINT\");\n}\n\n/** The keypress shape emitted by `readline.emitKeypressEvents`. */\ntype KeypressEvent = {\n  name?: string;\n  sequence?: string;\n  ctrl?: boolean;\n  meta?: boolean;\n  shift?: boolean;\n};\n\n/** Process-wide shortcuts for the running dev server. */\nexport const devServerShortcuts = new DevServerShortcuts();\n"],"mappings":";;;;;;;;;;;;;;;AA0BA,IAAa,qBAAb,MAAgC;;;;;;;;;CAmB9B,AAAO,YACL,AAAiB,eACjB,AAAiB,cAA0B,gBAC3C;EAFiB;EACA;mCApBU,IAAI,IAA+B;mBAG5C;cAGL;CAeZ;;;;;;;;;;;;;;;;;CAkBH,IAAY,QAA2B;EACrC,OAAO,KAAK,iBAAiB,QAAQ;CACvC;;;;;CAMA,AAAO,cAAuB;EAC5B,OAAO,QAAQ,KAAK,MAAM,SAAS,OAAO,KAAK,MAAM,eAAe,UAAU;CAChF;;;;;;CAOA,AAAO,SAAS,UAAsC;EACpD,IAAI,CAAC,KAAK,YAAY,GACpB,OAAO;EAGT,KAAK,UAAU,IAAI,SAAS,IAAI,YAAY,GAAG,QAAQ;EACvD,KAAK,OAAO;EAEZ,OAAO;CACT;;CAGA,AAAO,OAA4B;EACjC,OAAO,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC;CACpC;;CAGA,AAAO,WAAW,KAAmB;EACnC,KAAK,UAAU,OAAO,IAAI,YAAY,CAAC;EAEvC,IAAI,KAAK,UAAU,SAAS,GAC1B,KAAK,QAAQ;CAEjB;;;;;;;CAQA,AAAO,UAAgB;EACrB,IAAI,CAAC,KAAK,WACR;EAGF,KAAK,YAAY;EAEjB,IAAI,KAAK,kBAAkB;GACzB,KAAK,MAAM,IAAI,YAAY,KAAK,gBAAgB;GAChD,KAAK,mBAAmB;EAC1B;EAEA,IAAI,KAAK,MAAM,OACb,KAAK,MAAM,WAAW,KAAK;EAG7B,KAAK,MAAM,MAAM;CACnB;;CAGA,AAAO,SAAe;EACpB,IAAI,KAAK,UAAU,OAAO,GACxB,KAAK,OAAO;CAEhB;;CAGA,AAAQ,SAAe;EACrB,IAAI,KAAK,aAAa,CAAC,KAAK,YAAY,GACtC;EAGF,KAAK,YAAY;EAEjB,SAAS,mBAAmB,KAAK,KAAK;EACtC,KAAK,MAAM,WAAW,IAAI;EAC1B,KAAK,MAAM,OAAO;EAElB,KAAK,oBAAoB,YAAY,QAAQ;GAC3C,AAAK,KAAK,eAAe,GAAG;EAC9B;EAEA,KAAK,MAAM,GAAG,YAAY,KAAK,gBAAgB;CACjD;;;;;;CAOA,MAAc,eAAe,KAA+C;EAC1E,IAAI,CAAC,KACH;EAGF,IAAK,IAAI,SAAS,IAAI,SAAS,OAAO,IAAI,SAAS,QAAS,IAAI,aAAa,KAAU;GACrF,KAAK,QAAQ;GACb,KAAK,YAAY;GACjB;EACF;EAEA,IAAI,KAAK,MACP;EAGF,MAAM,WAAW,IAAI,OAAO,KAAK,UAAU,IAAI,IAAI,KAAK,YAAY,CAAC,IAAI;EAEzE,IAAI,CAAC,UACH;EAGF,KAAK,OAAO;EAEZ,IAAI;GACF,MAAM,SAAS,QAAQ;EACzB,QAAQ,CAER,UAAU;GACR,KAAK,OAAO;EACd;CACF;AACF;;AAGA,SAAS,iBAAuB;CAG9B,QAAQ,KAAK,QAAQ;AACvB;;AAYA,MAAa,qBAAqB,IAAI,mBAAmB"}

package/esm/dev-server/special-file-patterns.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/dev-server/special-file-patterns.ts
+//#region ../../packages/core/src/dev-server/special-file-patterns.ts
 const normalize = (path) => path.replace(/\\/g, "/");
 /** `src/config/**` — any depth, the config key is the raw path */
 const isConfigFile = (path) => /^src\/config\/.*\.(ts|tsx)$/.test(normalize(path));

package/esm/dev-server/special-file-patterns.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"special-file-patterns.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/special-file-patterns.ts"],"sourcesContent":["const normalize = (path: string) => path.replace(/\\\\/g, \"/\");\n\n/** `src/config/**` — any depth, the config key is the raw path */\nexport const isConfigFile = (path: string) => /^src\\/config\\/.*\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/main.ts` or `src/app/<module>/main.ts` */\nexport const isMainFile = (path: string) =>\n  /^src\\/app\\/([^/]+\\/)?main\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/<module>/routes.ts` — one level deep */\nexport const isRouteFile = (path: string) =>\n  /^src\\/app\\/[^/]+\\/routes\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/worker.ts` or `src/app/<module>/worker.ts` — mirrors `isMainFile`'s optional module dir */\nexport const isWorkerFile = (path: string) =>\n  /^src\\/app\\/([^/]+\\/)?worker\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/<module>/events/<file>.ts` */\nexport const isEventFile = (path: string) =>\n  /^src\\/app\\/[^/]+\\/events\\/[^/]+\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/<module>/utils/locales.ts` or `locales.json` */\nexport const isLocaleFile = (path: string) =>\n  /^src\\/app\\/[^/]+\\/utils\\/locales\\.(ts|tsx|json)$/.test(normalize(path));\n\n/** Source files the dev server can hot-reload; anything else is data (`.sql`, `.json`, …) */\nexport const isCodeFile = (path: string) =>\n  /\\.(ts|tsx|js|jsx|mjs|cjs|mts|cts)$/.test(normalize(path));\n"],"mappings":";AAAA,MAAM,aAAa,SAAiB,KAAK,QAAQ,OAAO,GAAG;;AAG3D,MAAa,gBAAgB,SAAiB,8BAA8B,KAAK,UAAU,IAAI,CAAC;;AAGhG,MAAa,cAAc,SACzB,uCAAuC,KAAK,UAAU,IAAI,CAAC;;AAG7D,MAAa,eAAe,SAC1B,sCAAsC,KAAK,UAAU,IAAI,CAAC;;AAG5D,MAAa,gBAAgB,SAC3B,yCAAyC,KAAK,UAAU,IAAI,CAAC;;AAG/D,MAAa,eAAe,SAC1B,6CAA6C,KAAK,UAAU,IAAI,CAAC;;AAGnE,MAAa,gBAAgB,SAC3B,mDAAmD,KAAK,UAAU,IAAI,CAAC;;AAGzE,MAAa,cAAc,SACzB,qCAAqC,KAAK,UAAU,IAAI,CAAC"}
+{"version":3,"file":"special-file-patterns.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/special-file-patterns.ts"],"sourcesContent":["const normalize = (path: string) => path.replace(/\\\\/g, \"/\");\n\n/** `src/config/**` — any depth, the config key is the raw path */\nexport const isConfigFile = (path: string) => /^src\\/config\\/.*\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/main.ts` or `src/app/<module>/main.ts` */\nexport const isMainFile = (path: string) =>\n  /^src\\/app\\/([^/]+\\/)?main\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/<module>/routes.ts` — one level deep */\nexport const isRouteFile = (path: string) =>\n  /^src\\/app\\/[^/]+\\/routes\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/worker.ts` or `src/app/<module>/worker.ts` — mirrors `isMainFile`'s optional module dir */\nexport const isWorkerFile = (path: string) =>\n  /^src\\/app\\/([^/]+\\/)?worker\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/<module>/events/<file>.ts` */\nexport const isEventFile = (path: string) =>\n  /^src\\/app\\/[^/]+\\/events\\/[^/]+\\.(ts|tsx)$/.test(normalize(path));\n\n/** `src/app/<module>/utils/locales.ts` or `locales.json` */\nexport const isLocaleFile = (path: string) =>\n  /^src\\/app\\/[^/]+\\/utils\\/locales\\.(ts|tsx|json)$/.test(normalize(path));\n\n/** Source files the dev server can hot-reload; anything else is data (`.sql`, `.json`, …) */\nexport const isCodeFile = (path: string) =>\n  /\\.(ts|tsx|js|jsx|mjs|cjs|mts|cts)$/.test(normalize(path));\n"],"mappings":";AAAA,MAAM,aAAa,SAAiB,KAAK,QAAQ,OAAO,GAAG;;AAG3D,MAAa,gBAAgB,SAAiB,8BAA8B,KAAK,UAAU,IAAI,CAAC;;AAGhG,MAAa,cAAc,SACzB,uCAAuC,KAAK,UAAU,IAAI,CAAC;;AAG7D,MAAa,eAAe,SAC1B,sCAAsC,KAAK,UAAU,IAAI,CAAC;;AAG5D,MAAa,gBAAgB,SAC3B,yCAAyC,KAAK,UAAU,IAAI,CAAC;;AAG/D,MAAa,eAAe,SAC1B,6CAA6C,KAAK,UAAU,IAAI,CAAC;;AAGnE,MAAa,gBAAgB,SAC3B,mDAAmD,KAAK,UAAU,IAAI,CAAC;;AAGzE,MAAa,cAAc,SACzB,qCAAqC,KAAK,UAAU,IAAI,CAAC"}

package/esm/dev-server/special-files-collector.d.mts

@@ -1,6 +1,6 @@
 import { FileManager } from "./file-manager.mjs";
 
-//#region ../core/src/dev-server/special-files-collector.d.ts
+//#region ../../packages/core/src/dev-server/special-files-collector.d.ts
 type SpecialFileType = "config" | "main" | "route" | "event" | "locale" | "worker";
 /**
  * Categorises files into the kinds the dev server treats specially

package/esm/dev-server/special-files-collector.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"special-files-collector.d.mts","names":[],"sources":["../../../../../../../core/src/dev-server/special-files-collector.ts"],"mappings":";;;KAUY,eAAA;;AAAZ;;;cAMa,qBAAA;EAAA,iBACM,OAAA;EASV,OAAA,CAAQ,KAAA,EAAO,GAAA,SAAY,WAAA;EAO3B,OAAA,CAAQ,WAAA,EAAa,WAAA;EAIrB,UAAA,CAAW,YAAA;EAIX,UAAA,CAAW,WAAA,EAAa,WAAA;EAKxB,WAAA,CAAY,YAAA,WAAuB,eAAA;EAUnC,cAAA,CAAe,IAAA,EAAM,eAAA,GAAkB,WAAA;EAUvC,QAAA,IAAY,MAAA,CAAO,eAAA;EAWnB,KAAA;EAAA,QAIC,UAAA;AAAA"}
+{"version":3,"file":"special-files-collector.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/special-files-collector.ts"],"mappings":";;;KAUY,eAAA;;AAAZ;;;cAMa,qBAAA;EAAA,iBACM,OAAA;EASV,OAAA,CAAQ,KAAA,EAAO,GAAA,SAAY,WAAA;EAO3B,OAAA,CAAQ,WAAA,EAAa,WAAA;EAIrB,UAAA,CAAW,YAAA;EAIX,UAAA,CAAW,WAAA,EAAa,WAAA;EAKxB,WAAA,CAAY,YAAA,WAAuB,eAAA;EAUnC,cAAA,CAAe,IAAA,EAAM,eAAA,GAAkB,WAAA;EAUvC,QAAA,IAAY,MAAA,CAAO,eAAA;EAWnB,KAAA;EAAA,QAIC,UAAA;AAAA"}

package/esm/dev-server/special-files-collector.mjs

@@ -1,6 +1,6 @@
 import { isConfigFile, isEventFile, isLocaleFile, isMainFile, isRouteFile, isWorkerFile } from "./special-file-patterns.mjs";
 
-//#region ../core/src/dev-server/special-files-collector.ts
+//#region ../../packages/core/src/dev-server/special-files-collector.ts
 /**
 * Categorises files into the kinds the dev server treats specially
 * (config / main / route / event / locale / worker) and exposes typed accessors.

package/esm/dev-server/special-files-collector.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"special-files-collector.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/special-files-collector.ts"],"sourcesContent":["import { FileManager } from \"./file-manager\";\nimport {\n  isConfigFile,\n  isEventFile,\n  isLocaleFile,\n  isMainFile,\n  isRouteFile,\n  isWorkerFile,\n} from \"./special-file-patterns\";\n\nexport type SpecialFileType = \"config\" | \"main\" | \"route\" | \"event\" | \"locale\" | \"worker\";\n\n/**\n * Categorises files into the kinds the dev server treats specially\n * (config / main / route / event / locale / worker) and exposes typed accessors.\n */\nexport class SpecialFilesCollector {\n  private readonly buckets: Record<SpecialFileType, Map<string, FileManager>> = {\n    config: new Map(),\n    main: new Map(),\n    route: new Map(),\n    event: new Map(),\n    locale: new Map(),\n    worker: new Map(),\n  };\n\n  public collect(files: Map<string, FileManager>): void {\n    for (const bucket of Object.values(this.buckets)) bucket.clear();\n    for (const [relativePath, fileManager] of files) {\n      this.categorise(relativePath, fileManager);\n    }\n  }\n\n  public addFile(fileManager: FileManager): void {\n    this.categorise(fileManager.relativePath, fileManager);\n  }\n\n  public removeFile(relativePath: string): void {\n    for (const bucket of Object.values(this.buckets)) bucket.delete(relativePath);\n  }\n\n  public updateFile(fileManager: FileManager): void {\n    this.removeFile(fileManager.relativePath);\n    this.categorise(fileManager.relativePath, fileManager);\n  }\n\n  public getFileType(relativePath: string): SpecialFileType | null {\n    for (const [type, bucket] of Object.entries(this.buckets) as [\n      SpecialFileType,\n      Map<string, FileManager>,\n    ][]) {\n      if (bucket.has(relativePath)) return type;\n    }\n    return null;\n  }\n\n  public getFilesByType(type: SpecialFileType): FileManager[] {\n    const files = Array.from(this.buckets[type].values());\n    // Routes are loaded sequentially in alphabetical order so registration\n    // is deterministic across runs.\n    if (type === \"route\") {\n      files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));\n    }\n    return files;\n  }\n\n  public getStats(): Record<SpecialFileType, number> {\n    return {\n      config: this.buckets.config.size,\n      main: this.buckets.main.size,\n      route: this.buckets.route.size,\n      event: this.buckets.event.size,\n      locale: this.buckets.locale.size,\n      worker: this.buckets.worker.size,\n    };\n  }\n\n  public clear(): void {\n    for (const bucket of Object.values(this.buckets)) bucket.clear();\n  }\n\n  private categorise(relativePath: string, fileManager: FileManager): void {\n    if (isConfigFile(relativePath)) {\n      this.buckets.config.set(relativePath, fileManager);\n    } else if (isMainFile(relativePath)) {\n      this.buckets.main.set(relativePath, fileManager);\n    } else if (isRouteFile(relativePath)) {\n      this.buckets.route.set(relativePath, fileManager);\n    } else if (isEventFile(relativePath)) {\n      this.buckets.event.set(relativePath, fileManager);\n    } else if (isLocaleFile(relativePath)) {\n      this.buckets.locale.set(relativePath, fileManager);\n    } else if (isWorkerFile(relativePath)) {\n      this.buckets.worker.set(relativePath, fileManager);\n    }\n  }\n}\n"],"mappings":";;;;;;;AAgBA,IAAa,wBAAb,MAAmC;;iBAC6C;GAC5E,wBAAQ,IAAI,IAAI;GAChB,sBAAM,IAAI,IAAI;GACd,uBAAO,IAAI,IAAI;GACf,uBAAO,IAAI,IAAI;GACf,wBAAQ,IAAI,IAAI;GAChB,wBAAQ,IAAI,IAAI;EAClB;;CAEA,AAAO,QAAQ,OAAuC;EACpD,KAAK,MAAM,UAAU,OAAO,OAAO,KAAK,OAAO,GAAG,OAAO,MAAM;EAC/D,KAAK,MAAM,CAAC,cAAc,gBAAgB,OACxC,KAAK,WAAW,cAAc,WAAW;CAE7C;CAEA,AAAO,QAAQ,aAAgC;EAC7C,KAAK,WAAW,YAAY,cAAc,WAAW;CACvD;CAEA,AAAO,WAAW,cAA4B;EAC5C,KAAK,MAAM,UAAU,OAAO,OAAO,KAAK,OAAO,GAAG,OAAO,OAAO,YAAY;CAC9E;CAEA,AAAO,WAAW,aAAgC;EAChD,KAAK,WAAW,YAAY,YAAY;EACxC,KAAK,WAAW,YAAY,cAAc,WAAW;CACvD;CAEA,AAAO,YAAY,cAA8C;EAC/D,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,KAAK,OAAO,GAItD,IAAI,OAAO,IAAI,YAAY,GAAG,OAAO;EAEvC,OAAO;CACT;CAEA,AAAO,eAAe,MAAsC;EAC1D,MAAM,QAAQ,MAAM,KAAK,KAAK,QAAQ,KAAK,CAAC,OAAO,CAAC;EAGpD,IAAI,SAAS,SACX,MAAM,MAAM,GAAG,MAAM,EAAE,aAAa,cAAc,EAAE,YAAY,CAAC;EAEnE,OAAO;CACT;CAEA,AAAO,WAA4C;EACjD,OAAO;GACL,QAAQ,KAAK,QAAQ,OAAO;GAC5B,MAAM,KAAK,QAAQ,KAAK;GACxB,OAAO,KAAK,QAAQ,MAAM;GAC1B,OAAO,KAAK,QAAQ,MAAM;GAC1B,QAAQ,KAAK,QAAQ,OAAO;GAC5B,QAAQ,KAAK,QAAQ,OAAO;EAC9B;CACF;CAEA,AAAO,QAAc;EACnB,KAAK,MAAM,UAAU,OAAO,OAAO,KAAK,OAAO,GAAG,OAAO,MAAM;CACjE;CAEA,AAAQ,WAAW,cAAsB,aAAgC;EACvE,IAAI,aAAa,YAAY,GAC3B,KAAK,QAAQ,OAAO,IAAI,cAAc,WAAW;OAC5C,IAAI,WAAW,YAAY,GAChC,KAAK,QAAQ,KAAK,IAAI,cAAc,WAAW;OAC1C,IAAI,YAAY,YAAY,GACjC,KAAK,QAAQ,MAAM,IAAI,cAAc,WAAW;OAC3C,IAAI,YAAY,YAAY,GACjC,KAAK,QAAQ,MAAM,IAAI,cAAc,WAAW;OAC3C,IAAI,aAAa,YAAY,GAClC,KAAK,QAAQ,OAAO,IAAI,cAAc,WAAW;OAC5C,IAAI,aAAa,YAAY,GAClC,KAAK,QAAQ,OAAO,IAAI,cAAc,WAAW;CAErD;AACF"}
+{"version":3,"file":"special-files-collector.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/special-files-collector.ts"],"sourcesContent":["import { FileManager } from \"./file-manager\";\nimport {\n  isConfigFile,\n  isEventFile,\n  isLocaleFile,\n  isMainFile,\n  isRouteFile,\n  isWorkerFile,\n} from \"./special-file-patterns\";\n\nexport type SpecialFileType = \"config\" | \"main\" | \"route\" | \"event\" | \"locale\" | \"worker\";\n\n/**\n * Categorises files into the kinds the dev server treats specially\n * (config / main / route / event / locale / worker) and exposes typed accessors.\n */\nexport class SpecialFilesCollector {\n  private readonly buckets: Record<SpecialFileType, Map<string, FileManager>> = {\n    config: new Map(),\n    main: new Map(),\n    route: new Map(),\n    event: new Map(),\n    locale: new Map(),\n    worker: new Map(),\n  };\n\n  public collect(files: Map<string, FileManager>): void {\n    for (const bucket of Object.values(this.buckets)) bucket.clear();\n    for (const [relativePath, fileManager] of files) {\n      this.categorise(relativePath, fileManager);\n    }\n  }\n\n  public addFile(fileManager: FileManager): void {\n    this.categorise(fileManager.relativePath, fileManager);\n  }\n\n  public removeFile(relativePath: string): void {\n    for (const bucket of Object.values(this.buckets)) bucket.delete(relativePath);\n  }\n\n  public updateFile(fileManager: FileManager): void {\n    this.removeFile(fileManager.relativePath);\n    this.categorise(fileManager.relativePath, fileManager);\n  }\n\n  public getFileType(relativePath: string): SpecialFileType | null {\n    for (const [type, bucket] of Object.entries(this.buckets) as [\n      SpecialFileType,\n      Map<string, FileManager>,\n    ][]) {\n      if (bucket.has(relativePath)) return type;\n    }\n    return null;\n  }\n\n  public getFilesByType(type: SpecialFileType): FileManager[] {\n    const files = Array.from(this.buckets[type].values());\n    // Routes are loaded sequentially in alphabetical order so registration\n    // is deterministic across runs.\n    if (type === \"route\") {\n      files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));\n    }\n    return files;\n  }\n\n  public getStats(): Record<SpecialFileType, number> {\n    return {\n      config: this.buckets.config.size,\n      main: this.buckets.main.size,\n      route: this.buckets.route.size,\n      event: this.buckets.event.size,\n      locale: this.buckets.locale.size,\n      worker: this.buckets.worker.size,\n    };\n  }\n\n  public clear(): void {\n    for (const bucket of Object.values(this.buckets)) bucket.clear();\n  }\n\n  private categorise(relativePath: string, fileManager: FileManager): void {\n    if (isConfigFile(relativePath)) {\n      this.buckets.config.set(relativePath, fileManager);\n    } else if (isMainFile(relativePath)) {\n      this.buckets.main.set(relativePath, fileManager);\n    } else if (isRouteFile(relativePath)) {\n      this.buckets.route.set(relativePath, fileManager);\n    } else if (isEventFile(relativePath)) {\n      this.buckets.event.set(relativePath, fileManager);\n    } else if (isLocaleFile(relativePath)) {\n      this.buckets.locale.set(relativePath, fileManager);\n    } else if (isWorkerFile(relativePath)) {\n      this.buckets.worker.set(relativePath, fileManager);\n    }\n  }\n}\n"],"mappings":";;;;;;;AAgBA,IAAa,wBAAb,MAAmC;;iBAC6C;GAC5E,wBAAQ,IAAI,IAAI;GAChB,sBAAM,IAAI,IAAI;GACd,uBAAO,IAAI,IAAI;GACf,uBAAO,IAAI,IAAI;GACf,wBAAQ,IAAI,IAAI;GAChB,wBAAQ,IAAI,IAAI;EAClB;;CAEA,AAAO,QAAQ,OAAuC;EACpD,KAAK,MAAM,UAAU,OAAO,OAAO,KAAK,OAAO,GAAG,OAAO,MAAM;EAC/D,KAAK,MAAM,CAAC,cAAc,gBAAgB,OACxC,KAAK,WAAW,cAAc,WAAW;CAE7C;CAEA,AAAO,QAAQ,aAAgC;EAC7C,KAAK,WAAW,YAAY,cAAc,WAAW;CACvD;CAEA,AAAO,WAAW,cAA4B;EAC5C,KAAK,MAAM,UAAU,OAAO,OAAO,KAAK,OAAO,GAAG,OAAO,OAAO,YAAY;CAC9E;CAEA,AAAO,WAAW,aAAgC;EAChD,KAAK,WAAW,YAAY,YAAY;EACxC,KAAK,WAAW,YAAY,cAAc,WAAW;CACvD;CAEA,AAAO,YAAY,cAA8C;EAC/D,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,KAAK,OAAO,GAItD,IAAI,OAAO,IAAI,YAAY,GAAG,OAAO;EAEvC,OAAO;CACT;CAEA,AAAO,eAAe,MAAsC;EAC1D,MAAM,QAAQ,MAAM,KAAK,KAAK,QAAQ,KAAK,CAAC,OAAO,CAAC;EAGpD,IAAI,SAAS,SACX,MAAM,MAAM,GAAG,MAAM,EAAE,aAAa,cAAc,EAAE,YAAY,CAAC;EAEnE,OAAO;CACT;CAEA,AAAO,WAA4C;EACjD,OAAO;GACL,QAAQ,KAAK,QAAQ,OAAO;GAC5B,MAAM,KAAK,QAAQ,KAAK;GACxB,OAAO,KAAK,QAAQ,MAAM;GAC1B,OAAO,KAAK,QAAQ,MAAM;GAC1B,QAAQ,KAAK,QAAQ,OAAO;GAC5B,QAAQ,KAAK,QAAQ,OAAO;EAC9B;CACF;CAEA,AAAO,QAAc;EACnB,KAAK,MAAM,UAAU,OAAO,OAAO,KAAK,OAAO,GAAG,OAAO,MAAM;CACjE;CAEA,AAAQ,WAAW,cAAsB,aAAgC;EACvE,IAAI,aAAa,YAAY,GAC3B,KAAK,QAAQ,OAAO,IAAI,cAAc,WAAW;OAC5C,IAAI,WAAW,YAAY,GAChC,KAAK,QAAQ,KAAK,IAAI,cAAc,WAAW;OAC1C,IAAI,YAAY,YAAY,GACjC,KAAK,QAAQ,MAAM,IAAI,cAAc,WAAW;OAC3C,IAAI,YAAY,YAAY,GACjC,KAAK,QAAQ,MAAM,IAAI,cAAc,WAAW;OAC3C,IAAI,aAAa,YAAY,GAClC,KAAK,QAAQ,OAAO,IAAI,cAAc,WAAW;OAC5C,IAAI,aAAa,YAAY,GAClC,KAAK,QAAQ,OAAO,IAAI,cAAc,WAAW;CAErD;AACF"}

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

@@ -5,7 +5,7 @@ import { DevelopmentServer } from "./development-server.mjs";
 import { registerDevShortcuts } from "./register-dev-shortcuts.mjs";
 import { colors } from "@mongez/copper";
 
-//#region ../core/src/dev-server/start-development-server.ts
+//#region ../../packages/core/src/dev-server/start-development-server.ts
 let handlersRegistered = false;
 /**
 * Start the development server.

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

@@ -1 +1 @@
-{"version":3,"file":"start-development-server.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/start-development-server.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { isBootPreconditionError } from \"./boot-precondition-error\";\nimport { devLogError, devServeLog } from \"./dev-logger\";\nimport { DevelopmentServer } from \"./development-server\";\nimport { registerDevShortcuts } from \"./register-dev-shortcuts\";\nimport { BOOT_PRECONDITION_EXIT_CODE, QUIT_EXIT_CODE } from \"./supervisor\";\n\nlet handlersRegistered = false;\n\n/**\n * Options accepted by `startDevelopmentServer`. CLI flags translate to\n * these; programmatic callers (tests, scripts) can pass them directly.\n *\n * `undefined` for any field means \"fall through to `warlock.config.ts >\n * devServer.*` defaults.\" Pass an explicit value only to override.\n */\nexport type StartDevServerOptions = {\n  /**\n   * Delete `.warlock/manifest.json` before starting — forces every file\n   * to be re-parsed from disk instead of restored from the cached graph.\n   */\n  fresh?: boolean;\n  /** Run background type generation. Default from devServer config (true). */\n  generateTypings?: boolean;\n  /** Run file health checkers. Default from devServer config (true). */\n  healthCheckers?: boolean;\n};\n\n/**\n * Start the development server.\n *\n * Boots the file orchestrator, loads app modules, starts late-phase\n * connectors, then wires graceful shutdown for SIGINT/SIGTERM (plus\n * SIGHUP on Windows where Ctrl+C in spawned children lands as SIGHUP).\n *\n * If startup throws, shuts down cleanly and exits 1 — dev should die\n * loudly rather than hang with a half-initialized state.\n */\nexport async function startDevelopmentServer(\n  options: StartDevServerOptions = {},\n): Promise<DevelopmentServer> {\n  // V8 honours inline source maps embedded by the transpile cache (and\n  // tsx's own maps in passthrough mode), so thrown-error stack frames point\n  // at the original `src/**.ts` line/column instead of transpiled output.\n  process.setSourceMapsEnabled(true);\n\n  const devServer = new DevelopmentServer(options);\n\n  registerShutdownHandlers(devServer);\n\n  try {\n    await devServer.start();\n  } catch (error) {\n    // `DevelopmentServer.start()` already logged the failure once.\n    await safeShutdown(devServer);\n\n    // A boot-precondition failure (busy port, rejected validator, ...) has\n    // already printed a good message above — exit with the dedicated code so\n    // the supervisor treats it as terminal instead of restart-looping into\n    // the same failure. Every other error keeps exit 1, the ordinary\n    // restart-worthy path.\n    process.exit(isBootPreconditionError(error) ? BOOT_PRECONDITION_EXIT_CODE : 1);\n  }\n\n  // Only once the server is actually up — a half-started process has nothing\n  // worth restarting, and taking raw mode before then would swallow the\n  // Ctrl+C of a developer trying to escape a slow boot.\n  registerDevShortcuts(devServer);\n\n  return devServer;\n}\n\n/**\n * Register signal handlers once per process. Guards against handler\n * accumulation if `startDevelopmentServer` is invoked more than once\n * (tests, programmatic restart).\n */\nfunction registerShutdownHandlers(devServer: DevelopmentServer): void {\n  if (handlersRegistered) return;\n  handlersRegistered = true;\n\n  const onSignal = (signal: NodeJS.Signals) => async () => {\n    devServeLog(colors.yellow(`📡 Received ${signal}`));\n    const ok = await safeShutdown(devServer);\n    process.exit(ok ? 0 : QUIT_EXIT_CODE);\n  };\n\n  process.on(\"SIGINT\", onSignal(\"SIGINT\"));\n  process.on(\"SIGTERM\", onSignal(\"SIGTERM\"));\n  // Ctrl+C in spawned Windows children lands as SIGHUP, not SIGINT.\n  if (process.platform === \"win32\") {\n    process.on(\"SIGHUP\", onSignal(\"SIGHUP\"));\n  }\n}\n\n/**\n * Shut down the dev server without swallowing async errors. Returns\n * whether shutdown completed cleanly so the caller picks the exit code.\n */\nasync function safeShutdown(devServer: DevelopmentServer): Promise<boolean> {\n  try {\n    await devServer.shutdown();\n    return true;\n  } catch (error) {\n    devLogError(`Shutdown failed: ${(error as Error).message}`);\n    return false;\n  }\n}\n"],"mappings":";;;;;;;;AAOA,IAAI,qBAAqB;;;;;;;;;;;AA+BzB,eAAsB,uBACpB,UAAiC,CAAC,GACN;CAI5B,QAAQ,qBAAqB,IAAI;CAEjC,MAAM,YAAY,IAAI,kBAAkB,OAAO;CAE/C,yBAAyB,SAAS;CAElC,IAAI;EACF,MAAM,UAAU,MAAM;CACxB,SAAS,OAAO;EAEd,MAAM,aAAa,SAAS;EAO5B,QAAQ,KAAK,wBAAwB,KAAK,SAAkC,CAAC;CAC/E;CAKA,qBAAqB,SAAS;CAE9B,OAAO;AACT;;;;;;AAOA,SAAS,yBAAyB,WAAoC;CACpE,IAAI,oBAAoB;CACxB,qBAAqB;CAErB,MAAM,YAAY,WAA2B,YAAY;EACvD,YAAY,OAAO,OAAO,eAAe,QAAQ,CAAC;EAClD,MAAM,KAAK,MAAM,aAAa,SAAS;EACvC,QAAQ,KAAK,KAAK,MAAkB;CACtC;CAEA,QAAQ,GAAG,UAAU,SAAS,QAAQ,CAAC;CACvC,QAAQ,GAAG,WAAW,SAAS,SAAS,CAAC;CAEzC,IAAI,QAAQ,aAAa,SACvB,QAAQ,GAAG,UAAU,SAAS,QAAQ,CAAC;AAE3C;;;;;AAMA,eAAe,aAAa,WAAgD;CAC1E,IAAI;EACF,MAAM,UAAU,SAAS;EACzB,OAAO;CACT,SAAS,OAAO;EACd,YAAY,oBAAqB,MAAgB,SAAS;EAC1D,OAAO;CACT;AACF"}
+{"version":3,"file":"start-development-server.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/start-development-server.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { isBootPreconditionError } from \"./boot-precondition-error\";\nimport { devLogError, devServeLog } from \"./dev-logger\";\nimport { DevelopmentServer } from \"./development-server\";\nimport { registerDevShortcuts } from \"./register-dev-shortcuts\";\nimport { BOOT_PRECONDITION_EXIT_CODE, QUIT_EXIT_CODE } from \"./supervisor\";\n\nlet handlersRegistered = false;\n\n/**\n * Options accepted by `startDevelopmentServer`. CLI flags translate to\n * these; programmatic callers (tests, scripts) can pass them directly.\n *\n * `undefined` for any field means \"fall through to `warlock.config.ts >\n * devServer.*` defaults.\" Pass an explicit value only to override.\n */\nexport type StartDevServerOptions = {\n  /**\n   * Delete `.warlock/manifest.json` before starting — forces every file\n   * to be re-parsed from disk instead of restored from the cached graph.\n   */\n  fresh?: boolean;\n  /** Run background type generation. Default from devServer config (true). */\n  generateTypings?: boolean;\n  /** Run file health checkers. Default from devServer config (true). */\n  healthCheckers?: boolean;\n};\n\n/**\n * Start the development server.\n *\n * Boots the file orchestrator, loads app modules, starts late-phase\n * connectors, then wires graceful shutdown for SIGINT/SIGTERM (plus\n * SIGHUP on Windows where Ctrl+C in spawned children lands as SIGHUP).\n *\n * If startup throws, shuts down cleanly and exits 1 — dev should die\n * loudly rather than hang with a half-initialized state.\n */\nexport async function startDevelopmentServer(\n  options: StartDevServerOptions = {},\n): Promise<DevelopmentServer> {\n  // V8 honours inline source maps embedded by the transpile cache (and\n  // tsx's own maps in passthrough mode), so thrown-error stack frames point\n  // at the original `src/**.ts` line/column instead of transpiled output.\n  process.setSourceMapsEnabled(true);\n\n  const devServer = new DevelopmentServer(options);\n\n  registerShutdownHandlers(devServer);\n\n  try {\n    await devServer.start();\n  } catch (error) {\n    // `DevelopmentServer.start()` already logged the failure once.\n    await safeShutdown(devServer);\n\n    // A boot-precondition failure (busy port, rejected validator, ...) has\n    // already printed a good message above — exit with the dedicated code so\n    // the supervisor treats it as terminal instead of restart-looping into\n    // the same failure. Every other error keeps exit 1, the ordinary\n    // restart-worthy path.\n    process.exit(isBootPreconditionError(error) ? BOOT_PRECONDITION_EXIT_CODE : 1);\n  }\n\n  // Only once the server is actually up — a half-started process has nothing\n  // worth restarting, and taking raw mode before then would swallow the\n  // Ctrl+C of a developer trying to escape a slow boot.\n  registerDevShortcuts(devServer);\n\n  return devServer;\n}\n\n/**\n * Register signal handlers once per process. Guards against handler\n * accumulation if `startDevelopmentServer` is invoked more than once\n * (tests, programmatic restart).\n */\nfunction registerShutdownHandlers(devServer: DevelopmentServer): void {\n  if (handlersRegistered) return;\n  handlersRegistered = true;\n\n  const onSignal = (signal: NodeJS.Signals) => async () => {\n    devServeLog(colors.yellow(`📡 Received ${signal}`));\n    const ok = await safeShutdown(devServer);\n    process.exit(ok ? 0 : QUIT_EXIT_CODE);\n  };\n\n  process.on(\"SIGINT\", onSignal(\"SIGINT\"));\n  process.on(\"SIGTERM\", onSignal(\"SIGTERM\"));\n  // Ctrl+C in spawned Windows children lands as SIGHUP, not SIGINT.\n  if (process.platform === \"win32\") {\n    process.on(\"SIGHUP\", onSignal(\"SIGHUP\"));\n  }\n}\n\n/**\n * Shut down the dev server without swallowing async errors. Returns\n * whether shutdown completed cleanly so the caller picks the exit code.\n */\nasync function safeShutdown(devServer: DevelopmentServer): Promise<boolean> {\n  try {\n    await devServer.shutdown();\n    return true;\n  } catch (error) {\n    devLogError(`Shutdown failed: ${(error as Error).message}`);\n    return false;\n  }\n}\n"],"mappings":";;;;;;;;AAOA,IAAI,qBAAqB;;;;;;;;;;;AA+BzB,eAAsB,uBACpB,UAAiC,CAAC,GACN;CAI5B,QAAQ,qBAAqB,IAAI;CAEjC,MAAM,YAAY,IAAI,kBAAkB,OAAO;CAE/C,yBAAyB,SAAS;CAElC,IAAI;EACF,MAAM,UAAU,MAAM;CACxB,SAAS,OAAO;EAEd,MAAM,aAAa,SAAS;EAO5B,QAAQ,KAAK,wBAAwB,KAAK,SAAkC,CAAC;CAC/E;CAKA,qBAAqB,SAAS;CAE9B,OAAO;AACT;;;;;;AAOA,SAAS,yBAAyB,WAAoC;CACpE,IAAI,oBAAoB;CACxB,qBAAqB;CAErB,MAAM,YAAY,WAA2B,YAAY;EACvD,YAAY,OAAO,OAAO,eAAe,QAAQ,CAAC;EAClD,MAAM,KAAK,MAAM,aAAa,SAAS;EACvC,QAAQ,KAAK,KAAK,MAAkB;CACtC;CAEA,QAAQ,GAAG,UAAU,SAAS,QAAQ,CAAC;CACvC,QAAQ,GAAG,WAAW,SAAS,SAAS,CAAC;CAEzC,IAAI,QAAQ,aAAa,SACvB,QAAQ,GAAG,UAAU,SAAS,QAAQ,CAAC;AAE3C;;;;;AAMA,eAAe,aAAa,WAAgD;CAC1E,IAAI;EACF,MAAM,UAAU,SAAS;EACzB,OAAO;CACT,SAAS,OAAO;EACd,YAAY,oBAAqB,MAAgB,SAAS;EAC1D,OAAO;CACT;AACF"}

package/esm/dev-server/supervisor.mjs

@@ -1,7 +1,7 @@
 import { devLogError, devLogWarn } from "./dev-logger.mjs";
 import { spawn } from "node:child_process";
 
-//#region ../core/src/dev-server/supervisor.ts
+//#region ../../packages/core/src/dev-server/supervisor.ts
 /**
 * Set on the worker process so it knows it was launched by a supervisor —
 * and so `warlock dev` inside the worker runs the server instead of

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

@@ -1 +1 @@
-{"version":3,"file":"supervisor.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/supervisor.ts"],"sourcesContent":["import { spawn, type ChildProcess } from \"node:child_process\";\nimport { devLogError, devLogWarn } from \"./dev-logger\";\n\n/**\n * Set on the worker process so it knows it was launched by a supervisor —\n * and so `warlock dev` inside the worker runs the server instead of\n * supervising a third process.\n */\nexport const WORKER_ENV_FLAG = \"WARLOCK_DEV_WORKER\";\n\n/**\n * Exit code a worker uses to ask for a fresh process. Chosen as EX_TEMPFAIL,\n * whose conventional meaning (\"temporary failure, retry\") is close enough that\n * a stray supervisor-less exit reads sensibly in a shell.\n */\nexport const RESTART_EXIT_CODE = 75;\n\n/**\n * Exit code a worker uses when it hit a startup precondition whose cause\n * cannot change by trying again — a busy port, a rejected boot validator, an\n * unusable configured value. Chosen as EX_CONFIG, whose conventional meaning\n * (\"configuration error\") matches the class. The supervisor treats this as\n * terminal: no restart, no crash-budget spend, and no extra banner — the\n * worker has already printed a good message, and the whole point of this\n * exit code is that the supervisor does not scroll it away with a\n * \"restarting\" line and then reprint the same failure a moment later.\n */\nexport const BOOT_PRECONDITION_EXIT_CODE = 78;\n\n/**\n * Exit code a worker uses when the user deliberately quit (Ctrl+C, `q`, a\n * signal) but the connector shutdown failed. The supervisor honours it as\n * final — never a crash to recover from — and exits 1.\n */\nexport const QUIT_EXIT_CODE = 79;\n\n/** Signals the supervisor must hand to the worker rather than act on itself. */\nconst FORWARDED_SIGNALS: NodeJS.Signals[] = [\"SIGTERM\", \"SIGHUP\"];\n\n/**\n * How long a worker must survive before an abnormal exit counts as a crash\n * worth recovering from rather than a failed boot worth reporting once.\n */\nconst HEALTHY_UPTIME_MS = 5_000;\n\n/** IPC message the worker sends once boot completes; uptime counts from it. */\nexport const WORKER_BOOTED_MESSAGE = \"warlock:booted\";\n\n/** Crashes allowed inside {@link CRASH_WINDOW_MS} before we stop restarting. */\nconst CRASH_RESTART_LIMIT = 3;\n\n/** The rolling window flapping is measured over. */\nconst CRASH_WINDOW_MS = 60_000;\n\n/** Whether this process is the worker (i.e. a supervisor already exists). */\nexport function isDevWorker(): boolean {\n  return process.env[WORKER_ENV_FLAG] === \"1\";\n}\n\n/**\n * Run `warlock dev` as a supervised pair: a thin parent that owns the terminal\n * and a disposable child that is the actual dev server.\n *\n * The child asks to be replaced by exiting {@link RESTART_EXIT_CODE}; the\n * supervisor spawns a fresh one in its place. Because the parent is never\n * itself replaced, the process tree stays exactly two deep no matter how many\n * restarts happen — the previous design re-exec'd itself and left one idle\n * waiter behind per restart.\n *\n * The supervisor deliberately loads no config, no connectors, and no\n * application code, so a worker that wedges or dies can always be replaced by\n * a process that is known-good.\n *\n * Never resolves: the returned promise is a deliberate dead end so callers can\n * `return` it to stop everything downstream (notably the command's preloaders,\n * which must only ever run in the worker). The process ends with the last\n * worker, not with this promise.\n */\nexport function superviseDevServer(now: () => number = Date.now): Promise<never> {\n  let worker: ChildProcess | undefined;\n  let shuttingDown = false;\n\n  /** Timestamps of recent crash-restarts, used to detect flapping. */\n  let crashes: number[] = [];\n\n  const spawnWorker = (): void => {\n    // Stays undefined until the worker reports a completed boot: a worker that\n    // dies before that failed to boot, however long it took to fail.\n    let bootedAt: number | undefined;\n\n    const spawnedWorker = spawn(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {\n      cwd: process.cwd(),\n      env: { ...process.env, [WORKER_ENV_FLAG]: \"1\" },\n      stdio: [\"inherit\", \"inherit\", \"inherit\", \"ipc\"],\n      windowsHide: false,\n    });\n    worker = spawnedWorker;\n\n    spawnedWorker.on(\"message\", (message) => {\n      if (message === WORKER_BOOTED_MESSAGE) bootedAt = now();\n    });\n\n    spawnedWorker.on(\"error\", (error) => {\n      if (worker !== spawnedWorker) return;\n\n      shuttingDown = true;\n      devLogError(`Could not start the development server: ${error.message}`);\n      process.exit(1);\n    });\n\n    spawnedWorker.on(\"exit\", (code, signal) => {\n      // A replaced worker can finish emitting lifecycle events after its\n      // successor is already healthy. It must not spend that successor's crash\n      // budget, spawn another worker, or print a terminal flapping diagnosis.\n      if (worker !== spawnedWorker) return;\n\n      worker = undefined;\n      releaseTerminal();\n\n      // `return` after every exit deliberately: `process.exit` is typed\n      // `never`, but treating it as control flow means anything that stubs it\n      // out turns \"we are shutting down\" into \"spawn another worker\".\n      if (shuttingDown) {\n        process.exit(signal ? 1 : (code ?? 0));\n        return;\n      }\n\n      if (code === RESTART_EXIT_CODE) {\n        spawnWorker();\n        return;\n      }\n\n      // A boot precondition failure cannot be fixed by trying again — skip\n      // the crash-recovery path entirely (no uptime check, no crash-budget\n      // spend, no \"restarting\" banner) and mirror the exit code exactly, the\n      // same way a deliberate shutdown does just below.\n      if (code === BOOT_PRECONDITION_EXIT_CODE) {\n        process.exit(code);\n        return;\n      }\n\n      if (code === QUIT_EXIT_CODE) {\n        process.exit(1);\n        return;\n      }\n\n      const crashed = signal !== null || (code ?? 0) !== 0;\n\n      if (crashed && shouldRecoverFromCrash(bootedAt === undefined ? 0 : now() - bootedAt)) {\n        devLogWarn(\n          `Development server ${signal ? `was killed by ${signal}` : `exited with code ${code}`} — restarting.`,\n        );\n        spawnWorker();\n        return;\n      }\n\n      // The worker owns its own error reporting; the supervisor only mirrors\n      // the outcome so `npm run dev` and CI see the code they expect.\n      process.exit(signal ? 1 : (code ?? 0));\n    });\n  };\n\n  /**\n   * Whether a worker that died on its own should be replaced.\n   *\n   * The rule is minimum healthy uptime, not a bare retry count. A worker that\n   * dies almost immediately failed to *boot* — a broken config, a port already\n   * taken — and it has already printed why; respawning would just reprint the\n   * same error and bury it. A worker that ran fine for a while and then died\n   * (OOM, a native crash, a dead loader thread) is the case worth recovering,\n   * because the state that killed it is usually not reproduced on a fresh boot.\n   *\n   * Flapping is still capped: enough crashes inside one window and we stop and\n   * say so, rather than restarting forever behind the developer's back.\n   */\n  function shouldRecoverFromCrash(uptimeMs: number): boolean {\n    if (uptimeMs < HEALTHY_UPTIME_MS) {\n      return false;\n    }\n\n    const at = now();\n\n    crashes = [...crashes.filter((time) => at - time < CRASH_WINDOW_MS), at];\n\n    if (crashes.length > CRASH_RESTART_LIMIT) {\n      devLogError(\n        `Development server crashed ${crashes.length} times in ` +\n          `${Math.round(CRASH_WINDOW_MS / 1000)}s — not restarting again. ` +\n          `Fix the cause and run \\`warlock dev\\` when you're ready.`,\n      );\n      return false;\n    }\n\n    return true;\n  }\n\n  // SIGINT reaches the worker directly from the terminal (same process group),\n  // so the supervisor must NOT act on it — exiting here would orphan a server\n  // that is still draining. It only notes that the next exit is final.\n  process.on(\"SIGINT\", () => {\n    shuttingDown = true;\n  });\n\n  for (const signal of FORWARDED_SIGNALS) {\n    process.on(signal, () => {\n      shuttingDown = true;\n      worker?.kill(signal);\n    });\n  }\n\n  spawnWorker();\n\n  return new Promise<never>(() => {\n    // Intentionally never settles — see the doc comment.\n  });\n}\n\n/**\n * Put the shared TTY back into a sane state after a worker exits.\n *\n * The worker takes stdin into raw mode for its keyboard shortcuts and releases\n * it on shutdown — but a worker that was killed outright never got the chance,\n * and the mode belongs to the terminal, not the process that set it. Without\n * this, the next worker (or the user's shell) inherits a stdin with no line\n * editing and no Ctrl+C.\n */\nfunction releaseTerminal(): void {\n  try {\n    if (process.stdin.isTTY) {\n      process.stdin.setRawMode(false);\n    }\n  } catch {\n    // Nothing to recover if the terminal is already gone.\n  }\n}\n"],"mappings":";;;;;;;;;AAQA,MAAa,kBAAkB;;;;;;AAO/B,MAAa,oBAAoB;;;;;;;;;;;AAYjC,MAAa,8BAA8B;;;;;;AAO3C,MAAa,iBAAiB;;AAG9B,MAAM,oBAAsC,CAAC,WAAW,QAAQ;;;;;AAMhE,MAAM,oBAAoB;;AAG1B,MAAa,wBAAwB;;AAGrC,MAAM,sBAAsB;;AAG5B,MAAM,kBAAkB;;AAGxB,SAAgB,cAAuB;CACrC,OAAO,QAAQ,IAAI,qBAAqB;AAC1C;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,mBAAmB,MAAoB,KAAK,KAAqB;CAC/E,IAAI;CACJ,IAAI,eAAe;;CAGnB,IAAI,UAAoB,CAAC;CAEzB,MAAM,oBAA0B;EAG9B,IAAI;EAEJ,MAAM,gBAAgB,MAAM,QAAQ,UAAU,CAAC,GAAG,QAAQ,UAAU,GAAG,QAAQ,KAAK,MAAM,CAAC,CAAC,GAAG;GAC7F,KAAK,QAAQ,IAAI;GACjB,KAAK;IAAE,GAAG,QAAQ;KAAM,kBAAkB;GAAI;GAC9C,OAAO;IAAC;IAAW;IAAW;IAAW;GAAK;GAC9C,aAAa;EACf,CAAC;EACD,SAAS;EAET,cAAc,GAAG,YAAY,YAAY;GACvC,IAAI,8BAAmC,WAAW,IAAI;EACxD,CAAC;EAED,cAAc,GAAG,UAAU,UAAU;GACnC,IAAI,WAAW,eAAe;GAE9B,eAAe;GACf,YAAY,2CAA2C,MAAM,SAAS;GACtE,QAAQ,KAAK,CAAC;EAChB,CAAC;EAED,cAAc,GAAG,SAAS,MAAM,WAAW;GAIzC,IAAI,WAAW,eAAe;GAE9B,SAAS;GACT,gBAAgB;GAKhB,IAAI,cAAc;IAChB,QAAQ,KAAK,SAAS,IAAK,QAAQ,CAAE;IACrC;GACF;GAEA,IAAI,aAA4B;IAC9B,YAAY;IACZ;GACF;GAMA,IAAI,aAAsC;IACxC,QAAQ,KAAK,IAAI;IACjB;GACF;GAEA,IAAI,aAAyB;IAC3B,QAAQ,KAAK,CAAC;IACd;GACF;GAIA,KAFgB,WAAW,SAAS,QAAQ,OAAO,MAEpC,uBAAuB,aAAa,SAAY,IAAI,IAAI,IAAI,QAAQ,GAAG;IACpF,WACE,sBAAsB,SAAS,iBAAiB,WAAW,oBAAoB,OAAO,eACxF;IACA,YAAY;IACZ;GACF;GAIA,QAAQ,KAAK,SAAS,IAAK,QAAQ,CAAE;EACvC,CAAC;CACH;;;;;;;;;;;;;;CAeA,SAAS,uBAAuB,UAA2B;EACzD,IAAI,WAAW,mBACb,OAAO;EAGT,MAAM,KAAK,IAAI;EAEf,UAAU,CAAC,GAAG,QAAQ,QAAQ,SAAS,KAAK,OAAO,eAAe,GAAG,EAAE;EAEvE,IAAI,QAAQ,SAAS,qBAAqB;GACxC,YACE,8BAA8B,QAAQ,OAAO,YACxC,KAAK,MAAM,kBAAkB,GAAI,EAAE,mFAE1C;GACA,OAAO;EACT;EAEA,OAAO;CACT;CAKA,QAAQ,GAAG,gBAAgB;EACzB,eAAe;CACjB,CAAC;CAED,KAAK,MAAM,UAAU,mBACnB,QAAQ,GAAG,cAAc;EACvB,eAAe;EACf,QAAQ,KAAK,MAAM;CACrB,CAAC;CAGH,YAAY;CAEZ,OAAO,IAAI,cAAqB,CAEhC,CAAC;AACH;;;;;;;;;;AAWA,SAAS,kBAAwB;CAC/B,IAAI;EACF,IAAI,QAAQ,MAAM,OAChB,QAAQ,MAAM,WAAW,KAAK;CAElC,QAAQ,CAER;AACF"}
+{"version":3,"file":"supervisor.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/supervisor.ts"],"sourcesContent":["import { spawn, type ChildProcess } from \"node:child_process\";\nimport { devLogError, devLogWarn } from \"./dev-logger\";\n\n/**\n * Set on the worker process so it knows it was launched by a supervisor —\n * and so `warlock dev` inside the worker runs the server instead of\n * supervising a third process.\n */\nexport const WORKER_ENV_FLAG = \"WARLOCK_DEV_WORKER\";\n\n/**\n * Exit code a worker uses to ask for a fresh process. Chosen as EX_TEMPFAIL,\n * whose conventional meaning (\"temporary failure, retry\") is close enough that\n * a stray supervisor-less exit reads sensibly in a shell.\n */\nexport const RESTART_EXIT_CODE = 75;\n\n/**\n * Exit code a worker uses when it hit a startup precondition whose cause\n * cannot change by trying again — a busy port, a rejected boot validator, an\n * unusable configured value. Chosen as EX_CONFIG, whose conventional meaning\n * (\"configuration error\") matches the class. The supervisor treats this as\n * terminal: no restart, no crash-budget spend, and no extra banner — the\n * worker has already printed a good message, and the whole point of this\n * exit code is that the supervisor does not scroll it away with a\n * \"restarting\" line and then reprint the same failure a moment later.\n */\nexport const BOOT_PRECONDITION_EXIT_CODE = 78;\n\n/**\n * Exit code a worker uses when the user deliberately quit (Ctrl+C, `q`, a\n * signal) but the connector shutdown failed. The supervisor honours it as\n * final — never a crash to recover from — and exits 1.\n */\nexport const QUIT_EXIT_CODE = 79;\n\n/** Signals the supervisor must hand to the worker rather than act on itself. */\nconst FORWARDED_SIGNALS: NodeJS.Signals[] = [\"SIGTERM\", \"SIGHUP\"];\n\n/**\n * How long a worker must survive before an abnormal exit counts as a crash\n * worth recovering from rather than a failed boot worth reporting once.\n */\nconst HEALTHY_UPTIME_MS = 5_000;\n\n/** IPC message the worker sends once boot completes; uptime counts from it. */\nexport const WORKER_BOOTED_MESSAGE = \"warlock:booted\";\n\n/** Crashes allowed inside {@link CRASH_WINDOW_MS} before we stop restarting. */\nconst CRASH_RESTART_LIMIT = 3;\n\n/** The rolling window flapping is measured over. */\nconst CRASH_WINDOW_MS = 60_000;\n\n/** Whether this process is the worker (i.e. a supervisor already exists). */\nexport function isDevWorker(): boolean {\n  return process.env[WORKER_ENV_FLAG] === \"1\";\n}\n\n/**\n * Run `warlock dev` as a supervised pair: a thin parent that owns the terminal\n * and a disposable child that is the actual dev server.\n *\n * The child asks to be replaced by exiting {@link RESTART_EXIT_CODE}; the\n * supervisor spawns a fresh one in its place. Because the parent is never\n * itself replaced, the process tree stays exactly two deep no matter how many\n * restarts happen — the previous design re-exec'd itself and left one idle\n * waiter behind per restart.\n *\n * The supervisor deliberately loads no config, no connectors, and no\n * application code, so a worker that wedges or dies can always be replaced by\n * a process that is known-good.\n *\n * Never resolves: the returned promise is a deliberate dead end so callers can\n * `return` it to stop everything downstream (notably the command's preloaders,\n * which must only ever run in the worker). The process ends with the last\n * worker, not with this promise.\n */\nexport function superviseDevServer(now: () => number = Date.now): Promise<never> {\n  let worker: ChildProcess | undefined;\n  let shuttingDown = false;\n\n  /** Timestamps of recent crash-restarts, used to detect flapping. */\n  let crashes: number[] = [];\n\n  const spawnWorker = (): void => {\n    // Stays undefined until the worker reports a completed boot: a worker that\n    // dies before that failed to boot, however long it took to fail.\n    let bootedAt: number | undefined;\n\n    const spawnedWorker = spawn(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {\n      cwd: process.cwd(),\n      env: { ...process.env, [WORKER_ENV_FLAG]: \"1\" },\n      stdio: [\"inherit\", \"inherit\", \"inherit\", \"ipc\"],\n      windowsHide: false,\n    });\n    worker = spawnedWorker;\n\n    spawnedWorker.on(\"message\", (message) => {\n      if (message === WORKER_BOOTED_MESSAGE) bootedAt = now();\n    });\n\n    spawnedWorker.on(\"error\", (error) => {\n      if (worker !== spawnedWorker) return;\n\n      shuttingDown = true;\n      devLogError(`Could not start the development server: ${error.message}`);\n      process.exit(1);\n    });\n\n    spawnedWorker.on(\"exit\", (code, signal) => {\n      // A replaced worker can finish emitting lifecycle events after its\n      // successor is already healthy. It must not spend that successor's crash\n      // budget, spawn another worker, or print a terminal flapping diagnosis.\n      if (worker !== spawnedWorker) return;\n\n      worker = undefined;\n      releaseTerminal();\n\n      // `return` after every exit deliberately: `process.exit` is typed\n      // `never`, but treating it as control flow means anything that stubs it\n      // out turns \"we are shutting down\" into \"spawn another worker\".\n      if (shuttingDown) {\n        process.exit(signal ? 1 : (code ?? 0));\n        return;\n      }\n\n      if (code === RESTART_EXIT_CODE) {\n        spawnWorker();\n        return;\n      }\n\n      // A boot precondition failure cannot be fixed by trying again — skip\n      // the crash-recovery path entirely (no uptime check, no crash-budget\n      // spend, no \"restarting\" banner) and mirror the exit code exactly, the\n      // same way a deliberate shutdown does just below.\n      if (code === BOOT_PRECONDITION_EXIT_CODE) {\n        process.exit(code);\n        return;\n      }\n\n      if (code === QUIT_EXIT_CODE) {\n        process.exit(1);\n        return;\n      }\n\n      const crashed = signal !== null || (code ?? 0) !== 0;\n\n      if (crashed && shouldRecoverFromCrash(bootedAt === undefined ? 0 : now() - bootedAt)) {\n        devLogWarn(\n          `Development server ${signal ? `was killed by ${signal}` : `exited with code ${code}`} — restarting.`,\n        );\n        spawnWorker();\n        return;\n      }\n\n      // The worker owns its own error reporting; the supervisor only mirrors\n      // the outcome so `npm run dev` and CI see the code they expect.\n      process.exit(signal ? 1 : (code ?? 0));\n    });\n  };\n\n  /**\n   * Whether a worker that died on its own should be replaced.\n   *\n   * The rule is minimum healthy uptime, not a bare retry count. A worker that\n   * dies almost immediately failed to *boot* — a broken config, a port already\n   * taken — and it has already printed why; respawning would just reprint the\n   * same error and bury it. A worker that ran fine for a while and then died\n   * (OOM, a native crash, a dead loader thread) is the case worth recovering,\n   * because the state that killed it is usually not reproduced on a fresh boot.\n   *\n   * Flapping is still capped: enough crashes inside one window and we stop and\n   * say so, rather than restarting forever behind the developer's back.\n   */\n  function shouldRecoverFromCrash(uptimeMs: number): boolean {\n    if (uptimeMs < HEALTHY_UPTIME_MS) {\n      return false;\n    }\n\n    const at = now();\n\n    crashes = [...crashes.filter((time) => at - time < CRASH_WINDOW_MS), at];\n\n    if (crashes.length > CRASH_RESTART_LIMIT) {\n      devLogError(\n        `Development server crashed ${crashes.length} times in ` +\n          `${Math.round(CRASH_WINDOW_MS / 1000)}s — not restarting again. ` +\n          `Fix the cause and run \\`warlock dev\\` when you're ready.`,\n      );\n      return false;\n    }\n\n    return true;\n  }\n\n  // SIGINT reaches the worker directly from the terminal (same process group),\n  // so the supervisor must NOT act on it — exiting here would orphan a server\n  // that is still draining. It only notes that the next exit is final.\n  process.on(\"SIGINT\", () => {\n    shuttingDown = true;\n  });\n\n  for (const signal of FORWARDED_SIGNALS) {\n    process.on(signal, () => {\n      shuttingDown = true;\n      worker?.kill(signal);\n    });\n  }\n\n  spawnWorker();\n\n  return new Promise<never>(() => {\n    // Intentionally never settles — see the doc comment.\n  });\n}\n\n/**\n * Put the shared TTY back into a sane state after a worker exits.\n *\n * The worker takes stdin into raw mode for its keyboard shortcuts and releases\n * it on shutdown — but a worker that was killed outright never got the chance,\n * and the mode belongs to the terminal, not the process that set it. Without\n * this, the next worker (or the user's shell) inherits a stdin with no line\n * editing and no Ctrl+C.\n */\nfunction releaseTerminal(): void {\n  try {\n    if (process.stdin.isTTY) {\n      process.stdin.setRawMode(false);\n    }\n  } catch {\n    // Nothing to recover if the terminal is already gone.\n  }\n}\n"],"mappings":";;;;;;;;;AAQA,MAAa,kBAAkB;;;;;;AAO/B,MAAa,oBAAoB;;;;;;;;;;;AAYjC,MAAa,8BAA8B;;;;;;AAO3C,MAAa,iBAAiB;;AAG9B,MAAM,oBAAsC,CAAC,WAAW,QAAQ;;;;;AAMhE,MAAM,oBAAoB;;AAG1B,MAAa,wBAAwB;;AAGrC,MAAM,sBAAsB;;AAG5B,MAAM,kBAAkB;;AAGxB,SAAgB,cAAuB;CACrC,OAAO,QAAQ,IAAI,qBAAqB;AAC1C;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,mBAAmB,MAAoB,KAAK,KAAqB;CAC/E,IAAI;CACJ,IAAI,eAAe;;CAGnB,IAAI,UAAoB,CAAC;CAEzB,MAAM,oBAA0B;EAG9B,IAAI;EAEJ,MAAM,gBAAgB,MAAM,QAAQ,UAAU,CAAC,GAAG,QAAQ,UAAU,GAAG,QAAQ,KAAK,MAAM,CAAC,CAAC,GAAG;GAC7F,KAAK,QAAQ,IAAI;GACjB,KAAK;IAAE,GAAG,QAAQ;KAAM,kBAAkB;GAAI;GAC9C,OAAO;IAAC;IAAW;IAAW;IAAW;GAAK;GAC9C,aAAa;EACf,CAAC;EACD,SAAS;EAET,cAAc,GAAG,YAAY,YAAY;GACvC,IAAI,8BAAmC,WAAW,IAAI;EACxD,CAAC;EAED,cAAc,GAAG,UAAU,UAAU;GACnC,IAAI,WAAW,eAAe;GAE9B,eAAe;GACf,YAAY,2CAA2C,MAAM,SAAS;GACtE,QAAQ,KAAK,CAAC;EAChB,CAAC;EAED,cAAc,GAAG,SAAS,MAAM,WAAW;GAIzC,IAAI,WAAW,eAAe;GAE9B,SAAS;GACT,gBAAgB;GAKhB,IAAI,cAAc;IAChB,QAAQ,KAAK,SAAS,IAAK,QAAQ,CAAE;IACrC;GACF;GAEA,IAAI,aAA4B;IAC9B,YAAY;IACZ;GACF;GAMA,IAAI,aAAsC;IACxC,QAAQ,KAAK,IAAI;IACjB;GACF;GAEA,IAAI,aAAyB;IAC3B,QAAQ,KAAK,CAAC;IACd;GACF;GAIA,KAFgB,WAAW,SAAS,QAAQ,OAAO,MAEpC,uBAAuB,aAAa,SAAY,IAAI,IAAI,IAAI,QAAQ,GAAG;IACpF,WACE,sBAAsB,SAAS,iBAAiB,WAAW,oBAAoB,OAAO,eACxF;IACA,YAAY;IACZ;GACF;GAIA,QAAQ,KAAK,SAAS,IAAK,QAAQ,CAAE;EACvC,CAAC;CACH;;;;;;;;;;;;;;CAeA,SAAS,uBAAuB,UAA2B;EACzD,IAAI,WAAW,mBACb,OAAO;EAGT,MAAM,KAAK,IAAI;EAEf,UAAU,CAAC,GAAG,QAAQ,QAAQ,SAAS,KAAK,OAAO,eAAe,GAAG,EAAE;EAEvE,IAAI,QAAQ,SAAS,qBAAqB;GACxC,YACE,8BAA8B,QAAQ,OAAO,YACxC,KAAK,MAAM,kBAAkB,GAAI,EAAE,mFAE1C;GACA,OAAO;EACT;EAEA,OAAO;CACT;CAKA,QAAQ,GAAG,gBAAgB;EACzB,eAAe;CACjB,CAAC;CAED,KAAK,MAAM,UAAU,mBACnB,QAAQ,GAAG,cAAc;EACvB,eAAe;EACf,QAAQ,KAAK,MAAM;CACrB,CAAC;CAGH,YAAY;CAEZ,OAAO,IAAI,cAAqB,CAEhC,CAAC;AACH;;;;;;;;;;AAWA,SAAS,kBAAwB;CAC/B,IAAI;EACF,IAAI,QAAQ,MAAM,OAChB,QAAQ,MAAM,WAAW,KAAK;CAElC,QAAQ,CAER;AACF"}

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

@@ -1,4 +1,4 @@
-//#region ../core/src/dev-server/translation-keys-sources.ts
+//#region ../../packages/core/src/dev-server/translation-keys-sources.ts
 const GROUPED_TRANSLATIONS_MARKER = "groupedTranslations";
 /** `src/app/<module>/utils/locales.json`, the data-only module dictionary. */
 function isModuleLocaleDictionaryPath(path) {

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

@@ -1 +1 @@
-{"version":3,"file":"translation-keys-sources.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/translation-keys-sources.ts"],"sourcesContent":["const GROUPED_TRANSLATIONS_MARKER = \"groupedTranslations\";\n\n/** `src/app/<module>/utils/locales.json`, the data-only module dictionary. */\nexport function isModuleLocaleDictionaryPath(path: string): boolean {\n  return /^src\\/app\\/[^/]+\\/utils\\/locales\\.json$/.test(path.replace(/\\\\\\\\/g, \"/\"));\n}\n\n/**\n * Cheap pre-filter for candidate translation-registering source files.\n *\n * `groupedTranslations` calls used to be scanned for on dedicated\n * `src/**​/utils/locales.*` files only, so a web module registering keys\n * elsewhere (e.g. `src/web/layout.register.ts`) was silently invisible to the\n * generator. Any app source file can call it, so discovery has to consider\n * every file — this text check keeps that cheap by skipping the AST parse\n * for the files that plainly do not call it, without executing app code.\n */\nexport function isTranslationRegisteringSource(path: string, source: string): boolean {\n  return isModuleLocaleDictionaryPath(path) || source.includes(GROUPED_TRANSLATIONS_MARKER);\n}\n"],"mappings":";AAAA,MAAM,8BAA8B;;AAGpC,SAAgB,6BAA6B,MAAuB;CAClE,OAAO,0CAA0C,KAAK,KAAK,QAAQ,SAAS,GAAG,CAAC;AAClF;;;;;;;;;;;AAYA,SAAgB,+BAA+B,MAAc,QAAyB;CACpF,OAAO,6BAA6B,IAAI,KAAK,OAAO,SAAS,2BAA2B;AAC1F"}
+{"version":3,"file":"translation-keys-sources.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/translation-keys-sources.ts"],"sourcesContent":["const GROUPED_TRANSLATIONS_MARKER = \"groupedTranslations\";\n\n/** `src/app/<module>/utils/locales.json`, the data-only module dictionary. */\nexport function isModuleLocaleDictionaryPath(path: string): boolean {\n  return /^src\\/app\\/[^/]+\\/utils\\/locales\\.json$/.test(path.replace(/\\\\\\\\/g, \"/\"));\n}\n\n/**\n * Cheap pre-filter for candidate translation-registering source files.\n *\n * `groupedTranslations` calls used to be scanned for on dedicated\n * `src/**​/utils/locales.*` files only, so a web module registering keys\n * elsewhere (e.g. `src/web/layout.register.ts`) was silently invisible to the\n * generator. Any app source file can call it, so discovery has to consider\n * every file — this text check keeps that cheap by skipping the AST parse\n * for the files that plainly do not call it, without executing app code.\n */\nexport function isTranslationRegisteringSource(path: string, source: string): boolean {\n  return isModuleLocaleDictionaryPath(path) || source.includes(GROUPED_TRANSLATIONS_MARKER);\n}\n"],"mappings":";AAAA,MAAM,8BAA8B;;AAGpC,SAAgB,6BAA6B,MAAuB;CAClE,OAAO,0CAA0C,KAAK,KAAK,QAAQ,SAAS,GAAG,CAAC;AAClF;;;;;;;;;;;AAYA,SAAgB,+BAA+B,MAAc,QAAyB;CACpF,OAAO,6BAA6B,IAAI,KAAK,OAAO,SAAS,2BAA2B;AAC1F"}

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

@@ -3,7 +3,7 @@ import path from "node:path";
 import fs from "node:fs";
 import { readTsconfig } from "get-tsconfig";
 
-//#region ../core/src/dev-server/tsconfig-manager.ts
+//#region ../../packages/core/src/dev-server/tsconfig-manager.ts
 var TSConfigManager = class {
 	constructor() {
 		this.aliases = {};

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

@@ -1 +1 @@
-{"version":3,"file":"tsconfig-manager.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/tsconfig-manager.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { readTsconfig } from \"get-tsconfig\";\nimport { Path } from \"../utils/normalized-path\";\n\nexport class TSConfigManager {\n  /**\n   * Aliases list (from tsconfig paths)\n   */\n  public aliases: Record<string, string[]> = {};\n\n  /**\n   * Base URL for resolving paths\n   */\n  public baseUrl: string = \".\";\n\n  /**\n   * TSConfig\n   */\n  public tsconfig: any;\n\n  public init() {\n    if (this.tsconfig) return;\n\n    // `ts.readConfigFile` does not follow `extends`; `readTsconfig` resolves the\n    // whole chain (paths, baseUrl, decorator flags) and keeps string enum values,\n    // which is what esbuild's `tsconfigRaw` expects.\n    const configPath = Path.toAbsolute(\"tsconfig.json\");\n    const parsed = fs.existsSync(configPath)\n      ? readTsconfig(configPath, { typescriptVersion: false }).config\n      : {};\n    const compilerOptions = parsed.compilerOptions ?? {};\n\n    this.tsconfig = { ...parsed, compilerOptions };\n\n    this.aliases = (compilerOptions.paths as Record<string, string[]> | undefined) || {};\n\n    this.baseUrl = compilerOptions.baseUrl || \".\";\n  }\n\n  /**\n   * Check if the given path is an alias\n   * This checks if it's a REAL path alias (not an external package alias)\n   *\n   * Real aliases map to local paths (e.g., app/* -> src/app/*, src/* -> src/*)\n   * External package aliases map to themselves with @ prefix (e.g., @warlock.js/core -> @warlock.js/core)\n   */\n  public isAlias(path: string) {\n    if (!this.tsconfig) {\n      this.init();\n    }\n\n    return Object.keys(this.aliases).some((alias) => {\n      if (!this.matchesAliasPattern(alias, path)) {\n        return false;\n      }\n\n      const aliasTargets = this.aliases[alias];\n      if (!Array.isArray(aliasTargets) || aliasTargets.length === 0) {\n        return false;\n      }\n\n      // A package mapped onto itself is an external package, not a local alias\n      // Example: \"@warlock.js/core\" -> \"@warlock.js/core\"\n      // (self-referencing local ones like src/* -> src/* are still aliases)\n      if (!alias.endsWith(\"/*\") && aliasTargets.every((target) => target === alias)) {\n        return false;\n      }\n\n      return true;\n    });\n  }\n\n  /**\n   * Check if an import path matches a tsconfig paths pattern\n   * (exact match, or `prefix/*` matching anything under `prefix/`)\n   */\n  private matchesAliasPattern(alias: string, importPath: string): boolean {\n    if (alias.endsWith(\"/*\")) {\n      return importPath.startsWith(alias.slice(0, -1));\n    }\n\n    return importPath === alias;\n  }\n\n  /**\n   * Get the alias key that matches the given import path\n   */\n  public getMatchingAlias(path: string): string | null {\n    const aliasKey = Object.keys(this.aliases).find((alias) => this.matchesAliasPattern(alias, path));\n\n    return aliasKey || null;\n  }\n\n  /**\n   * Resolve an alias import path to a relative path based on tsconfig paths\n   * Example: \"app/users/services/get-users.service\" -> \"src/app/users/services/get-users.service\"\n   *\n   * @param path - The import path with alias (e.g., \"app/users/services/get-users.service\")\n   * @returns The resolved relative path or null if alias not found\n   */\n  public resolveAliasPath(checkingPath: string): string | null {\n    // Find matching alias from tsconfig paths\n    const aliasKey = this.getMatchingAlias(checkingPath);\n\n    if (!aliasKey) return null;\n\n    const aliasTargets = this.aliases[aliasKey];\n    if (!Array.isArray(aliasTargets) || aliasTargets.length === 0) {\n      return null;\n    }\n\n    // Get the first target path (usually there's only one)\n    const targetPattern = aliasTargets[0];\n\n    if (targetPattern === undefined) {\n      return null;\n    }\n\n    // Replace alias pattern with target pattern\n    const aliasPattern = aliasKey.replace(\"/*\", \"\");\n    const targetBase = targetPattern.replace(\"/*\", \"\");\n    // Remove any leading slash so path.join does not drop the base\n    const relativePart = checkingPath.substring(aliasPattern.length).replace(/^[/\\\\]/, \"\");\n\n    // Join the target base with the relative part\n    const resolvedPath = path.join(targetBase, relativePart);\n\n    return Path.normalize(resolvedPath);\n  }\n\n  /**\n   * Resolve an alias import path to an absolute path\n   * Example: \"app/users/services/get-users.service\" -> \"/absolute/path/to/src/app/users/services/get-users.service\"\n   *\n   * @param path - The import path with alias\n   * @returns The resolved absolute path or null if alias not found\n   */\n  public resolveAliasToAbsolute(path: string): string | null {\n    const relativePath = this.resolveAliasPath(path);\n\n    if (!relativePath) return null;\n\n    return Path.normalize(Path.toAbsolute(relativePath));\n  }\n}\n\nexport const tsconfigManager = new TSConfigManager();\n"],"mappings":";;;;;;AAKA,IAAa,kBAAb,MAA6B;;iBAIgB,CAAC;iBAKnB;;CAOzB,AAAO,OAAO;EACZ,IAAI,KAAK,UAAU;EAKnB,MAAM,aAAa,KAAK,WAAW,eAAe;EAClD,MAAM,SAAS,GAAG,WAAW,UAAU,IACnC,aAAa,YAAY,EAAE,mBAAmB,MAAM,CAAC,CAAC,CAAC,SACvD,CAAC;EACL,MAAM,kBAAkB,OAAO,mBAAmB,CAAC;EAEnD,KAAK,WAAW;GAAE,GAAG;GAAQ;EAAgB;EAE7C,KAAK,UAAW,gBAAgB,SAAkD,CAAC;EAEnF,KAAK,UAAU,gBAAgB,WAAW;CAC5C;;;;;;;;CASA,AAAO,QAAQ,MAAc;EAC3B,IAAI,CAAC,KAAK,UACR,KAAK,KAAK;EAGZ,OAAO,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,MAAM,UAAU;GAC/C,IAAI,CAAC,KAAK,oBAAoB,OAAO,IAAI,GACvC,OAAO;GAGT,MAAM,eAAe,KAAK,QAAQ;GAClC,IAAI,CAAC,MAAM,QAAQ,YAAY,KAAK,aAAa,WAAW,GAC1D,OAAO;GAMT,IAAI,CAAC,MAAM,SAAS,IAAI,KAAK,aAAa,OAAO,WAAW,WAAW,KAAK,GAC1E,OAAO;GAGT,OAAO;EACT,CAAC;CACH;;;;;CAMA,AAAQ,oBAAoB,OAAe,YAA6B;EACtE,IAAI,MAAM,SAAS,IAAI,GACrB,OAAO,WAAW,WAAW,MAAM,MAAM,GAAG,EAAE,CAAC;EAGjD,OAAO,eAAe;CACxB;;;;CAKA,AAAO,iBAAiB,MAA6B;EAGnD,OAFiB,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,MAAM,UAAU,KAAK,oBAAoB,OAAO,IAAI,CAEjF,KAAK;CACrB;;;;;;;;CASA,AAAO,iBAAiB,cAAqC;EAE3D,MAAM,WAAW,KAAK,iBAAiB,YAAY;EAEnD,IAAI,CAAC,UAAU,OAAO;EAEtB,MAAM,eAAe,KAAK,QAAQ;EAClC,IAAI,CAAC,MAAM,QAAQ,YAAY,KAAK,aAAa,WAAW,GAC1D,OAAO;EAIT,MAAM,gBAAgB,aAAa;EAEnC,IAAI,kBAAkB,QACpB,OAAO;EAIT,MAAM,eAAe,SAAS,QAAQ,MAAM,EAAE;EAC9C,MAAM,aAAa,cAAc,QAAQ,MAAM,EAAE;EAEjD,MAAM,eAAe,aAAa,UAAU,aAAa,MAAM,CAAC,CAAC,QAAQ,UAAU,EAAE;EAGrF,MAAM,eAAe,KAAK,KAAK,YAAY,YAAY;EAEvD,OAAO,KAAK,UAAU,YAAY;CACpC;;;;;;;;CASA,AAAO,uBAAuB,MAA6B;EACzD,MAAM,eAAe,KAAK,iBAAiB,IAAI;EAE/C,IAAI,CAAC,cAAc,OAAO;EAE1B,OAAO,KAAK,UAAU,KAAK,WAAW,YAAY,CAAC;CACrD;AACF;AAEA,MAAa,kBAAkB,IAAI,gBAAgB"}
+{"version":3,"file":"tsconfig-manager.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/tsconfig-manager.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { readTsconfig } from \"get-tsconfig\";\nimport { Path } from \"../utils/normalized-path\";\n\nexport class TSConfigManager {\n  /**\n   * Aliases list (from tsconfig paths)\n   */\n  public aliases: Record<string, string[]> = {};\n\n  /**\n   * Base URL for resolving paths\n   */\n  public baseUrl: string = \".\";\n\n  /**\n   * TSConfig\n   */\n  public tsconfig: any;\n\n  public init() {\n    if (this.tsconfig) return;\n\n    // `ts.readConfigFile` does not follow `extends`; `readTsconfig` resolves the\n    // whole chain (paths, baseUrl, decorator flags) and keeps string enum values,\n    // which is what esbuild's `tsconfigRaw` expects.\n    const configPath = Path.toAbsolute(\"tsconfig.json\");\n    const parsed = fs.existsSync(configPath)\n      ? readTsconfig(configPath, { typescriptVersion: false }).config\n      : {};\n    const compilerOptions = parsed.compilerOptions ?? {};\n\n    this.tsconfig = { ...parsed, compilerOptions };\n\n    this.aliases = (compilerOptions.paths as Record<string, string[]> | undefined) || {};\n\n    this.baseUrl = compilerOptions.baseUrl || \".\";\n  }\n\n  /**\n   * Check if the given path is an alias\n   * This checks if it's a REAL path alias (not an external package alias)\n   *\n   * Real aliases map to local paths (e.g., app/* -> src/app/*, src/* -> src/*)\n   * External package aliases map to themselves with @ prefix (e.g., @warlock.js/core -> @warlock.js/core)\n   */\n  public isAlias(path: string) {\n    if (!this.tsconfig) {\n      this.init();\n    }\n\n    return Object.keys(this.aliases).some((alias) => {\n      if (!this.matchesAliasPattern(alias, path)) {\n        return false;\n      }\n\n      const aliasTargets = this.aliases[alias];\n      if (!Array.isArray(aliasTargets) || aliasTargets.length === 0) {\n        return false;\n      }\n\n      // A package mapped onto itself is an external package, not a local alias\n      // Example: \"@warlock.js/core\" -> \"@warlock.js/core\"\n      // (self-referencing local ones like src/* -> src/* are still aliases)\n      if (!alias.endsWith(\"/*\") && aliasTargets.every((target) => target === alias)) {\n        return false;\n      }\n\n      return true;\n    });\n  }\n\n  /**\n   * Check if an import path matches a tsconfig paths pattern\n   * (exact match, or `prefix/*` matching anything under `prefix/`)\n   */\n  private matchesAliasPattern(alias: string, importPath: string): boolean {\n    if (alias.endsWith(\"/*\")) {\n      return importPath.startsWith(alias.slice(0, -1));\n    }\n\n    return importPath === alias;\n  }\n\n  /**\n   * Get the alias key that matches the given import path\n   */\n  public getMatchingAlias(path: string): string | null {\n    const aliasKey = Object.keys(this.aliases).find((alias) => this.matchesAliasPattern(alias, path));\n\n    return aliasKey || null;\n  }\n\n  /**\n   * Resolve an alias import path to a relative path based on tsconfig paths\n   * Example: \"app/users/services/get-users.service\" -> \"src/app/users/services/get-users.service\"\n   *\n   * @param path - The import path with alias (e.g., \"app/users/services/get-users.service\")\n   * @returns The resolved relative path or null if alias not found\n   */\n  public resolveAliasPath(checkingPath: string): string | null {\n    // Find matching alias from tsconfig paths\n    const aliasKey = this.getMatchingAlias(checkingPath);\n\n    if (!aliasKey) return null;\n\n    const aliasTargets = this.aliases[aliasKey];\n    if (!Array.isArray(aliasTargets) || aliasTargets.length === 0) {\n      return null;\n    }\n\n    // Get the first target path (usually there's only one)\n    const targetPattern = aliasTargets[0];\n\n    if (targetPattern === undefined) {\n      return null;\n    }\n\n    // Replace alias pattern with target pattern\n    const aliasPattern = aliasKey.replace(\"/*\", \"\");\n    const targetBase = targetPattern.replace(\"/*\", \"\");\n    // Remove any leading slash so path.join does not drop the base\n    const relativePart = checkingPath.substring(aliasPattern.length).replace(/^[/\\\\]/, \"\");\n\n    // Join the target base with the relative part\n    const resolvedPath = path.join(targetBase, relativePart);\n\n    return Path.normalize(resolvedPath);\n  }\n\n  /**\n   * Resolve an alias import path to an absolute path\n   * Example: \"app/users/services/get-users.service\" -> \"/absolute/path/to/src/app/users/services/get-users.service\"\n   *\n   * @param path - The import path with alias\n   * @returns The resolved absolute path or null if alias not found\n   */\n  public resolveAliasToAbsolute(path: string): string | null {\n    const relativePath = this.resolveAliasPath(path);\n\n    if (!relativePath) return null;\n\n    return Path.normalize(Path.toAbsolute(relativePath));\n  }\n}\n\nexport const tsconfigManager = new TSConfigManager();\n"],"mappings":";;;;;;AAKA,IAAa,kBAAb,MAA6B;;iBAIgB,CAAC;iBAKnB;;CAOzB,AAAO,OAAO;EACZ,IAAI,KAAK,UAAU;EAKnB,MAAM,aAAa,KAAK,WAAW,eAAe;EAClD,MAAM,SAAS,GAAG,WAAW,UAAU,IACnC,aAAa,YAAY,EAAE,mBAAmB,MAAM,CAAC,CAAC,CAAC,SACvD,CAAC;EACL,MAAM,kBAAkB,OAAO,mBAAmB,CAAC;EAEnD,KAAK,WAAW;GAAE,GAAG;GAAQ;EAAgB;EAE7C,KAAK,UAAW,gBAAgB,SAAkD,CAAC;EAEnF,KAAK,UAAU,gBAAgB,WAAW;CAC5C;;;;;;;;CASA,AAAO,QAAQ,MAAc;EAC3B,IAAI,CAAC,KAAK,UACR,KAAK,KAAK;EAGZ,OAAO,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,MAAM,UAAU;GAC/C,IAAI,CAAC,KAAK,oBAAoB,OAAO,IAAI,GACvC,OAAO;GAGT,MAAM,eAAe,KAAK,QAAQ;GAClC,IAAI,CAAC,MAAM,QAAQ,YAAY,KAAK,aAAa,WAAW,GAC1D,OAAO;GAMT,IAAI,CAAC,MAAM,SAAS,IAAI,KAAK,aAAa,OAAO,WAAW,WAAW,KAAK,GAC1E,OAAO;GAGT,OAAO;EACT,CAAC;CACH;;;;;CAMA,AAAQ,oBAAoB,OAAe,YAA6B;EACtE,IAAI,MAAM,SAAS,IAAI,GACrB,OAAO,WAAW,WAAW,MAAM,MAAM,GAAG,EAAE,CAAC;EAGjD,OAAO,eAAe;CACxB;;;;CAKA,AAAO,iBAAiB,MAA6B;EAGnD,OAFiB,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,MAAM,UAAU,KAAK,oBAAoB,OAAO,IAAI,CAEjF,KAAK;CACrB;;;;;;;;CASA,AAAO,iBAAiB,cAAqC;EAE3D,MAAM,WAAW,KAAK,iBAAiB,YAAY;EAEnD,IAAI,CAAC,UAAU,OAAO;EAEtB,MAAM,eAAe,KAAK,QAAQ;EAClC,IAAI,CAAC,MAAM,QAAQ,YAAY,KAAK,aAAa,WAAW,GAC1D,OAAO;EAIT,MAAM,gBAAgB,aAAa;EAEnC,IAAI,kBAAkB,QACpB,OAAO;EAIT,MAAM,eAAe,SAAS,QAAQ,MAAM,EAAE;EAC9C,MAAM,aAAa,cAAc,QAAQ,MAAM,EAAE;EAEjD,MAAM,eAAe,aAAa,UAAU,aAAa,MAAM,CAAC,CAAC,QAAQ,UAAU,EAAE;EAGrF,MAAM,eAAe,KAAK,KAAK,YAAY,YAAY;EAEvD,OAAO,KAAK,UAAU,YAAY;CACpC;;;;;;;;CASA,AAAO,uBAAuB,MAA6B;EACzD,MAAM,eAAe,KAAK,iBAAiB,IAAI;EAE/C,IAAI,CAAC,cAAc,OAAO;EAE1B,OAAO,KAAK,UAAU,KAAK,WAAW,YAAY,CAAC;CACrD;AACF;AAEA,MAAa,kBAAkB,IAAI,gBAAgB"}

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

@@ -20,7 +20,7 @@ import { pathToFileURL } from "node:url";
 import ts from "typescript";
 import { moduleResolve } from "import-meta-resolve";
 
-//#region ../core/src/dev-server/type-generator.ts
+//#region ../../packages/core/src/dev-server/type-generator.ts
 const WEB_PACKAGE = "@warlock.js/web";
 const WEB_BUILD_PACKAGE = "@warlock.js/web/build";
 function isAbsentOptionalWebPackage(thrown) {
@@ -39,6 +39,17 @@ async function listRouteLocaleKeysForTypeGeneration(appRoot = process.cwd()) {
 	if (typeof buildModule.listRouteLocaleKeys !== "function") throw new Error(`${WEB_BUILD_PACKAGE} does not export listRouteLocaleKeys. Upgrade @warlock.js/web to a compatible version.`);
 	return buildModule.listRouteLocaleKeys({ appRoot });
 }
+/**
+* The key a property name stands for at runtime, without the quotes it was
+* written with: `"machine-thumb"`, `'machine-thumb'` and `machine-thumb` in a
+* template all read `machine-thumb`. `getText()` kept the quotes, so a quoted
+* config key was written as `"uploads.images.variants."machine-thumb""` and
+* broke the generated `config.d.ts` (FW-06). Computed names (`[KEY]`) and
+* private names have no static key and return `undefined`.
+*/
+function readPropertyName(name) {
+	if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name) || ts.isNoSubstitutionTemplateLiteral(name)) return name.text;
+}
 /** True only for the route-locales convention under the canonical web root. */
 function isRouteLocalesJsonPath(path) {
 	const normalized = Path.normalize(path);
@@ -46,6 +57,16 @@ function isRouteLocalesJsonPath(path) {
 	return /^src\/web(?:\/.*)?\/locales\.json$/.test(relativePath);
 }
 /**
+* Version of what the generator writes into the typings manifest. Bump it when
+* the cached data changes meaning, so caches written by an older generator are
+* thrown away instead of reused while their source hashes still match.
+*
+* 2: config and storage-driver keys are stored unquoted (FW-06); 5.29 cached
+*    keys such as `"machine-thumb"` with their quotes, which kept producing an
+*    invalid `config.d.ts` until a config file changed.
+*/
+const TYPINGS_MANIFEST_VERSION = "2";
+/**
 * TypeGenerator - Generates TypeScript type definitions from config files
 *
 * Parses source config files using the TypeScript Compiler API to extract
@@ -80,11 +101,10 @@ var TypeGenerator = class {
 			this.exists(configFile),
 			this.exists(translationsFile)
 		]);
-		if (!manifestExists || !storageExists || !configExists || !translationsExist) await this.fullGeneration();
-		else {
-			await this.loadManifest();
-			await this.reconcile();
-		}
+		if (!(manifestExists && storageExists && configExists && translationsExist && await this.loadManifest() && this.manifest?.version === "2")) {
+			this.manifest = this.createEmptyManifest();
+			await this.fullGeneration();
+		} else await this.reconcile();
 		await this.generateTranslationTypes();
 		await this.generateModelResourceTypes();
 		await this.saveManifest();
@@ -364,7 +384,7 @@ ${configTypeInfos.map((info) => `    ${this.toInterfaceKey(info.name)}: ${info.t
   }
 
   interface ConfigKeyRegistry {
-${allKeys.map((key) => `    "${key}": true;`).join("\n")}
+${allKeys.map((key) => `    ${JSON.stringify(key)}: true;`).join("\n")}
   }
 }
 `;
@@ -398,7 +418,7 @@ ${allKeys.map((key) => `    "${key}": true;`).join("\n")}
 	*/
 	createEmptyManifest() {
 		return {
-			version: "1.0.0",
+			version: "2",
 			lastBuildTime: Date.now(),
 			storage: null,
 			config: {}
@@ -452,7 +472,8 @@ ${allKeys.map((key) => `    "${key}": true;`).join("\n")}
 				if (node.initializer && ts.isObjectLiteralExpression(node.initializer)) {
 					const visitKeys = (objNode, prefix) => {
 						for (const prop of objNode.properties) if (ts.isPropertyAssignment(prop) && prop.name) {
-							const keyName = prop.name.getText(sourceFile);
+							const keyName = readPropertyName(prop.name);
+							if (keyName === void 0) continue;
 							const fullKey = prefix ? `${prefix}.${keyName}` : keyName;
 							keys.push(fullKey);
 							if (ts.isObjectLiteralExpression(prop.initializer)) visitKeys(prop.initializer, fullKey);
@@ -498,9 +519,9 @@ ${allKeys.map((key) => `    "${key}": true;`).join("\n")}
 		const keys = [];
 		const visit = (node) => {
 			if (ts.isPropertyAssignment(node)) {
-				if (node.name.getText(sourceFile) === "drivers" && ts.isObjectLiteralExpression(node.initializer)) {
+				if (readPropertyName(node.name) === "drivers" && ts.isObjectLiteralExpression(node.initializer)) {
 					for (const prop of node.initializer.properties) if (ts.isPropertyAssignment(prop) || ts.isShorthandPropertyAssignment(prop)) {
-						const keyName = prop.name?.getText(sourceFile);
+						const keyName = readPropertyName(prop.name);
 						if (keyName) keys.push(keyName);
 					}
 				}