@warlock.js/core 5.19.1 → 5.21.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\")) {\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(process.pid, \"SIGINT\");\n}\n\n/** The keypress shape emitted by `readline.emitKeypressEvents`. */\ntype KeypressEvent = {\n  name?: 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,IAAI,IAAI,SAAS,IAAI,SAAS,OAAO,IAAI,SAAS,MAAM;GACtD,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;CAC9B,QAAQ,KAAK,QAAQ,KAAK,QAAQ;AACpC;;AAWA,MAAa,qBAAqB,IAAI,mBAAmB"}
+{"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"}

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

@@ -0,0 +1,18 @@
+//#region ../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));
+/** `src/app/main.ts` or `src/app/<module>/main.ts` */
+const isMainFile = (path) => /^src\/app\/([^/]+\/)?main\.(ts|tsx)$/.test(normalize(path));
+/** `src/app/<module>/routes.ts` — one level deep */
+const isRouteFile = (path) => /^src\/app\/[^/]+\/routes\.(ts|tsx)$/.test(normalize(path));
+/** `src/app/<module>/events/<file>.ts` */
+const isEventFile = (path) => /^src\/app\/[^/]+\/events\/[^/]+\.(ts|tsx)$/.test(normalize(path));
+/** `src/app/<module>/utils/locales.ts` */
+const isLocaleFile = (path) => /^src\/app\/[^/]+\/utils\/locales\.(ts|tsx)$/.test(normalize(path));
+/** Source files the dev server can hot-reload; anything else is data (`.sql`, `.json`, …) */
+const isCodeFile = (path) => /\.(ts|tsx|js|jsx|mjs|cjs|mts|cts)$/.test(normalize(path));
+
+//#endregion
+export { isCodeFile, isConfigFile, isEventFile, isLocaleFile, isMainFile, isRouteFile };
+//# sourceMappingURL=special-file-patterns.mjs.map

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

@@ -0,0 +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/<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` */\nexport const isLocaleFile = (path: string) =>\n  /^src\\/app\\/[^/]+\\/utils\\/locales\\.(ts|tsx)$/.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,eAAe,SAC1B,6CAA6C,KAAK,UAAU,IAAI,CAAC;;AAGnE,MAAa,gBAAgB,SAC3B,8CAA8C,KAAK,UAAU,IAAI,CAAC;;AAGpE,MAAa,cAAc,SACzB,qCAAqC,KAAK,UAAU,IAAI,CAAC"}

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":";;;KAEY,eAAA;;AAAZ;;;cAMa,qBAAA;EAAA,iBACM,OAAA;EAQV,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;EAUnB,KAAA;EAAA,QAIC,UAAA;AAAA"}
+{"version":3,"file":"special-files-collector.d.mts","names":[],"sources":["../../../../../../../core/src/dev-server/special-files-collector.ts"],"mappings":";;;KASY,eAAA;;AAAZ;;;cAMa,qBAAA;EAAA,iBACM,OAAA;EAQV,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;EAUnB,KAAA;EAAA,QAIC,UAAA;AAAA"}

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

@@ -1,3 +1,5 @@
+import { isConfigFile, isEventFile, isLocaleFile, isMainFile, isRouteFile } from "./special-file-patterns.mjs";
+
 //#region ../core/src/dev-server/special-files-collector.ts
 /**
 * Categorises files into the kinds the dev server treats specially
@@ -56,11 +58,6 @@ var SpecialFilesCollector = class {
 		else if (isLocaleFile(relativePath)) this.buckets.locale.set(relativePath, fileManager);
 	}
 };
-const isConfigFile = (path) => /^src\/config\/.*\.(ts|tsx)$/.test(path);
-const isMainFile = (path) => /^src\/app\/[^/]+\/main\.(ts|tsx)$/.test(path) || path === "src/app/main.ts" || path === "src/app/main.tsx";
-const isRouteFile = (path) => /^src\/app\/[^/]+\/routes\.(ts|tsx)$/.test(path);
-const isEventFile = (path) => /^src\/app\/[^/]+\/events\/[^/]+\.(ts|tsx)$/.test(path);
-const isLocaleFile = (path) => /^src\/app\/[^/]+\/utils\/locales\.(ts|tsx)$/.test(path);
 
 //#endregion
 export { SpecialFilesCollector };

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\";\r\n\r\nexport type SpecialFileType = \"config\" | \"main\" | \"route\" | \"event\" | \"locale\";\r\n\r\n/**\r\n * Categorises files into the kinds the dev server treats specially\r\n * (config / main / route / event / locale) and exposes typed accessors.\r\n */\r\nexport class SpecialFilesCollector {\r\n  private readonly buckets: Record<SpecialFileType, Map<string, FileManager>> = {\r\n    config: new Map(),\r\n    main: new Map(),\r\n    route: new Map(),\r\n    event: new Map(),\r\n    locale: new Map(),\r\n  };\r\n\r\n  public collect(files: Map<string, FileManager>): void {\r\n    for (const bucket of Object.values(this.buckets)) bucket.clear();\r\n    for (const [relativePath, fileManager] of files) {\r\n      this.categorise(relativePath, fileManager);\r\n    }\r\n  }\r\n\r\n  public addFile(fileManager: FileManager): void {\r\n    this.categorise(fileManager.relativePath, fileManager);\r\n  }\r\n\r\n  public removeFile(relativePath: string): void {\r\n    for (const bucket of Object.values(this.buckets)) bucket.delete(relativePath);\r\n  }\r\n\r\n  public updateFile(fileManager: FileManager): void {\r\n    this.removeFile(fileManager.relativePath);\r\n    this.categorise(fileManager.relativePath, fileManager);\r\n  }\r\n\r\n  public getFileType(relativePath: string): SpecialFileType | null {\r\n    for (const [type, bucket] of Object.entries(this.buckets) as [\r\n      SpecialFileType,\r\n      Map<string, FileManager>,\r\n    ][]) {\r\n      if (bucket.has(relativePath)) return type;\r\n    }\r\n    return null;\r\n  }\r\n\r\n  public getFilesByType(type: SpecialFileType): FileManager[] {\r\n    const files = Array.from(this.buckets[type].values());\r\n    // Routes are loaded sequentially in alphabetical order so registration\r\n    // is deterministic across runs.\r\n    if (type === \"route\") {\r\n      files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));\r\n    }\r\n    return files;\r\n  }\r\n\r\n  public getStats(): Record<SpecialFileType, number> {\r\n    return {\r\n      config: this.buckets.config.size,\r\n      main: this.buckets.main.size,\r\n      route: this.buckets.route.size,\r\n      event: this.buckets.event.size,\r\n      locale: this.buckets.locale.size,\r\n    };\r\n  }\r\n\r\n  public clear(): void {\r\n    for (const bucket of Object.values(this.buckets)) bucket.clear();\r\n  }\r\n\r\n  private categorise(relativePath: string, fileManager: FileManager): void {\r\n    if (isConfigFile(relativePath)) {\r\n      this.buckets.config.set(relativePath, fileManager);\r\n    } else if (isMainFile(relativePath)) {\r\n      this.buckets.main.set(relativePath, fileManager);\r\n    } else if (isRouteFile(relativePath)) {\r\n      this.buckets.route.set(relativePath, fileManager);\r\n    } else if (isEventFile(relativePath)) {\r\n      this.buckets.event.set(relativePath, fileManager);\r\n    } else if (isLocaleFile(relativePath)) {\r\n      this.buckets.locale.set(relativePath, fileManager);\r\n    }\r\n  }\r\n}\r\n\r\nconst isConfigFile = (path: string) => /^src\\/config\\/.*\\.(ts|tsx)$/.test(path);\r\nconst isMainFile = (path: string) =>\r\n  /^src\\/app\\/[^/]+\\/main\\.(ts|tsx)$/.test(path) ||\r\n  path === \"src/app/main.ts\" ||\r\n  path === \"src/app/main.tsx\";\r\nconst isRouteFile = (path: string) => /^src\\/app\\/[^/]+\\/routes\\.(ts|tsx)$/.test(path);\r\nconst isEventFile = (path: string) => /^src\\/app\\/[^/]+\\/events\\/[^/]+\\.(ts|tsx)$/.test(path);\r\nconst isLocaleFile = (path: string) => /^src\\/app\\/[^/]+\\/utils\\/locales\\.(ts|tsx)$/.test(path);\r\n"],"mappings":";;;;;AAQA,IAAa,wBAAb,MAAmC;;iBAC6C;GAC5E,wBAAQ,IAAI,IAAI;GAChB,sBAAM,IAAI,IAAI;GACd,uBAAO,IAAI,IAAI;GACf,uBAAO,IAAI,IAAI;GACf,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;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;CAErD;AACF;AAEA,MAAM,gBAAgB,SAAiB,8BAA8B,KAAK,IAAI;AAC9E,MAAM,cAAc,SAClB,oCAAoC,KAAK,IAAI,KAC7C,SAAS,qBACT,SAAS;AACX,MAAM,eAAe,SAAiB,sCAAsC,KAAK,IAAI;AACrF,MAAM,eAAe,SAAiB,6CAA6C,KAAK,IAAI;AAC5F,MAAM,gBAAgB,SAAiB,8CAA8C,KAAK,IAAI"}
+{"version":3,"file":"special-files-collector.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/special-files-collector.ts"],"sourcesContent":["import { FileManager } from \"./file-manager\";\r\nimport {\r\n  isConfigFile,\r\n  isEventFile,\r\n  isLocaleFile,\r\n  isMainFile,\r\n  isRouteFile,\r\n} from \"./special-file-patterns\";\r\n\r\nexport type SpecialFileType = \"config\" | \"main\" | \"route\" | \"event\" | \"locale\";\r\n\r\n/**\r\n * Categorises files into the kinds the dev server treats specially\r\n * (config / main / route / event / locale) and exposes typed accessors.\r\n */\r\nexport class SpecialFilesCollector {\r\n  private readonly buckets: Record<SpecialFileType, Map<string, FileManager>> = {\r\n    config: new Map(),\r\n    main: new Map(),\r\n    route: new Map(),\r\n    event: new Map(),\r\n    locale: new Map(),\r\n  };\r\n\r\n  public collect(files: Map<string, FileManager>): void {\r\n    for (const bucket of Object.values(this.buckets)) bucket.clear();\r\n    for (const [relativePath, fileManager] of files) {\r\n      this.categorise(relativePath, fileManager);\r\n    }\r\n  }\r\n\r\n  public addFile(fileManager: FileManager): void {\r\n    this.categorise(fileManager.relativePath, fileManager);\r\n  }\r\n\r\n  public removeFile(relativePath: string): void {\r\n    for (const bucket of Object.values(this.buckets)) bucket.delete(relativePath);\r\n  }\r\n\r\n  public updateFile(fileManager: FileManager): void {\r\n    this.removeFile(fileManager.relativePath);\r\n    this.categorise(fileManager.relativePath, fileManager);\r\n  }\r\n\r\n  public getFileType(relativePath: string): SpecialFileType | null {\r\n    for (const [type, bucket] of Object.entries(this.buckets) as [\r\n      SpecialFileType,\r\n      Map<string, FileManager>,\r\n    ][]) {\r\n      if (bucket.has(relativePath)) return type;\r\n    }\r\n    return null;\r\n  }\r\n\r\n  public getFilesByType(type: SpecialFileType): FileManager[] {\r\n    const files = Array.from(this.buckets[type].values());\r\n    // Routes are loaded sequentially in alphabetical order so registration\r\n    // is deterministic across runs.\r\n    if (type === \"route\") {\r\n      files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));\r\n    }\r\n    return files;\r\n  }\r\n\r\n  public getStats(): Record<SpecialFileType, number> {\r\n    return {\r\n      config: this.buckets.config.size,\r\n      main: this.buckets.main.size,\r\n      route: this.buckets.route.size,\r\n      event: this.buckets.event.size,\r\n      locale: this.buckets.locale.size,\r\n    };\r\n  }\r\n\r\n  public clear(): void {\r\n    for (const bucket of Object.values(this.buckets)) bucket.clear();\r\n  }\r\n\r\n  private categorise(relativePath: string, fileManager: FileManager): void {\r\n    if (isConfigFile(relativePath)) {\r\n      this.buckets.config.set(relativePath, fileManager);\r\n    } else if (isMainFile(relativePath)) {\r\n      this.buckets.main.set(relativePath, fileManager);\r\n    } else if (isRouteFile(relativePath)) {\r\n      this.buckets.route.set(relativePath, fileManager);\r\n    } else if (isEventFile(relativePath)) {\r\n      this.buckets.event.set(relativePath, fileManager);\r\n    } else if (isLocaleFile(relativePath)) {\r\n      this.buckets.locale.set(relativePath, fileManager);\r\n    }\r\n  }\r\n}\r\n\r\n"],"mappings":";;;;;;;AAeA,IAAa,wBAAb,MAAmC;;iBAC6C;GAC5E,wBAAQ,IAAI,IAAI;GAChB,sBAAM,IAAI,IAAI;GACd,uBAAO,IAAI,IAAI;GACf,uBAAO,IAAI,IAAI;GACf,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;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;CAErD;AACF"}

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

@@ -24,7 +24,6 @@ async function startDevelopmentServer(options = {}) {
 	try {
 		await devServer.start();
 	} catch (error) {
-		devLogError(`Failed to start Development Server: ${error.message}`);
 		await safeShutdown(devServer);
 		process.exit(isBootPreconditionError(error) ? 78 : 1);
 	}
@@ -42,7 +41,7 @@ function registerShutdownHandlers(devServer) {
 	const onSignal = (signal) => async () => {
 		devServeLog(colors.yellow(`📡 Received ${signal}`));
 		const ok = await safeShutdown(devServer);
-		process.exit(ok ? 0 : 1);
+		process.exit(ok ? 0 : 79);
 	};
 	process.on("SIGINT", onSignal("SIGINT"));
 	process.on("SIGTERM", onSignal("SIGTERM"));

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 } 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    devLogError(`Failed to start Development Server: ${(error as Error).message}`);\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 : 1);\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;EACd,YAAY,uCAAwC,MAAgB,SAAS;EAC7E,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,IAAI,CAAC;CACzB;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":["../../../../../../../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

@@ -25,6 +25,12 @@ const RESTART_EXIT_CODE = 75;
 * "restarting" line and then reprint the same failure a moment later.
 */
 const BOOT_PRECONDITION_EXIT_CODE = 78;
+/**
+* Exit code a worker uses when the user deliberately quit (Ctrl+C, `q`, a
+* signal) but the connector shutdown failed. The supervisor honours it as
+* final — never a crash to recover from — and exits 1.
+*/
+const QUIT_EXIT_CODE = 79;
 /** Signals the supervisor must hand to the worker rather than act on itself. */
 const FORWARDED_SIGNALS = ["SIGTERM", "SIGHUP"];
 /**
@@ -32,6 +38,8 @@ const FORWARDED_SIGNALS = ["SIGTERM", "SIGHUP"];
 * worth recovering from rather than a failed boot worth reporting once.
 */
 const HEALTHY_UPTIME_MS = 5e3;
+/** IPC message the worker sends once boot completes; uptime counts from it. */
+const WORKER_BOOTED_MESSAGE = "warlock:booted";
 /** Crashes allowed inside {@link CRASH_WINDOW_MS} before we stop restarting. */
 const CRASH_RESTART_LIMIT = 3;
 /** The rolling window flapping is measured over. */
@@ -65,17 +73,25 @@ function superviseDevServer(now = Date.now) {
 	/** Timestamps of recent crash-restarts, used to detect flapping. */
 	let crashes = [];
 	const spawnWorker = () => {
-		const spawnedAt = now();
+		let bootedAt;
 		const spawnedWorker = spawn(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {
 			cwd: process.cwd(),
 			env: {
 				...process.env,
 				[WORKER_ENV_FLAG]: "1"
 			},
-			stdio: "inherit",
+			stdio: [
+				"inherit",
+				"inherit",
+				"inherit",
+				"ipc"
+			],
 			windowsHide: false
 		});
 		worker = spawnedWorker;
+		spawnedWorker.on("message", (message) => {
+			if (message === "warlock:booted") bootedAt = now();
+		});
 		spawnedWorker.on("error", (error) => {
 			if (worker !== spawnedWorker) return;
 			shuttingDown = true;
@@ -98,7 +114,11 @@ function superviseDevServer(now = Date.now) {
 				process.exit(code);
 				return;
 			}
-			if ((signal !== null || (code ?? 0) !== 0) && shouldRecoverFromCrash(now() - spawnedAt)) {
+			if (code === 79) {
+				process.exit(1);
+				return;
+			}
+			if ((signal !== null || (code ?? 0) !== 0) && shouldRecoverFromCrash(bootedAt === void 0 ? 0 : now() - bootedAt)) {
 				devLogWarn(`Development server ${signal ? `was killed by ${signal}` : `exited with code ${code}`} — restarting.`);
 				spawnWorker();
 				return;

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/** 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/** 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    const spawnedAt = now();\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\",\n      windowsHide: false,\n    });\n    worker = spawnedWorker;\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      const crashed = signal !== null || (code ?? 0) !== 0;\n\n      if (crashed && shouldRecoverFromCrash(now() - spawnedAt)) {\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;;AAG3C,MAAM,oBAAsC,CAAC,WAAW,QAAQ;;;;;AAMhE,MAAM,oBAAoB;;AAG1B,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;EAC9B,MAAM,YAAY,IAAI;EAEtB,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;GACP,aAAa;EACf,CAAC;EACD,SAAS;EAET,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;GAIA,KAFgB,WAAW,SAAS,QAAQ,OAAO,MAEpC,uBAAuB,IAAI,IAAI,SAAS,GAAG;IACxD,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":["../../../../../../../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/tsconfig-manager.mjs

@@ -1,6 +1,7 @@
 import { Path } from "../utils/normalized-path.mjs";
 import path from "node:path";
-import ts from "typescript";
+import fs from "node:fs";
+import { readTsconfig } from "get-tsconfig";
 
 //#region ../core/src/dev-server/tsconfig-manager.ts
 var TSConfigManager = class {
@@ -10,10 +11,15 @@ var TSConfigManager = class {
 	}
 	init() {
 		if (this.tsconfig) return;
-		const output = ts.readConfigFile(Path.toAbsolute("tsconfig.json"), ts.sys.readFile);
-		this.tsconfig = output.config;
-		this.aliases = output.config?.compilerOptions?.paths || {};
-		this.baseUrl = output.config?.compilerOptions?.baseUrl || ".";
+		const configPath = Path.toAbsolute("tsconfig.json");
+		const parsed = fs.existsSync(configPath) ? readTsconfig(configPath, { typescriptVersion: false }).config : {};
+		const compilerOptions = parsed.compilerOptions ?? {};
+		this.tsconfig = {
+			...parsed,
+			compilerOptions
+		};
+		this.aliases = compilerOptions.paths || {};
+		this.baseUrl = compilerOptions.baseUrl || ".";
 	}
 	/**
 	* Check if the given path is an alias
@@ -25,22 +31,26 @@ var TSConfigManager = class {
 	isAlias(path) {
 		if (!this.tsconfig) this.init();
 		return Object.keys(this.aliases).some((alias) => {
-			const aliasPattern = alias.replace("/*", "");
-			if (!path.startsWith(aliasPattern)) return false;
+			if (!this.matchesAliasPattern(alias, path)) return false;
 			const aliasTargets = this.aliases[alias];
 			if (!Array.isArray(aliasTargets) || aliasTargets.length === 0) return false;
-			if (aliasPattern.startsWith("@")) return false;
+			if (!alias.endsWith("/*") && aliasTargets.every((target) => target === alias)) return false;
 			return true;
 		});
 	}
 	/**
+	* Check if an import path matches a tsconfig paths pattern
+	* (exact match, or `prefix/*` matching anything under `prefix/`)
+	*/
+	matchesAliasPattern(alias, importPath) {
+		if (alias.endsWith("/*")) return importPath.startsWith(alias.slice(0, -1));
+		return importPath === alias;
+	}
+	/**
 	* Get the alias key that matches the given import path
 	*/
 	getMatchingAlias(path) {
-		return Object.keys(this.aliases).find((alias) => {
-			const aliasPattern = alias.replace("/*", "");
-			return path.startsWith(aliasPattern);
-		}) || null;
+		return Object.keys(this.aliases).find((alias) => this.matchesAliasPattern(alias, path)) || null;
 	}
 	/**
 	* Resolve an alias import path to a relative path based on tsconfig paths

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 path from \"node:path\";\nimport ts from \"typescript\";\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    // use typescript to load the tsconfig.json file\n    const output = ts.readConfigFile(Path.toAbsolute(\"tsconfig.json\"), ts.sys.readFile);\n\n    this.tsconfig = output.config!;\n\n    this.aliases = output.config?.compilerOptions?.paths || {};\n\n    this.baseUrl = output.config?.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      // Remove /* from alias pattern for matching\n      const aliasPattern = alias.replace(\"/*\", \"\");\n\n      if (!path.startsWith(aliasPattern)) {\n        return false;\n      }\n\n      // Check if this is a real alias or just an external package mapping\n      const aliasTargets = this.aliases[alias];\n      if (!Array.isArray(aliasTargets) || aliasTargets.length === 0) {\n        return false;\n      }\n\n      // If the alias starts with @, it's likely an external package alias\n      // Example: \"@warlock.js/core\" -> \"@warlock.js/core\" (external package)\n      if (aliasPattern.startsWith(\"@\")) {\n        return false;\n      }\n\n      // Otherwise, it's a real path alias (including self-referencing ones like src/* -> src/*)\n      // Example: \"app/*\" -> \"src/app/*\" (real alias)\n      // Example: \"src/*\" -> \"src/*\" (self-referencing alias, still valid)\n      return true;\n    });\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) => {\n      const aliasPattern = alias.replace(\"/*\", \"\");\n      return path.startsWith(aliasPattern);\n    });\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":";;;;;AAIA,IAAa,kBAAb,MAA6B;;iBAIgB,CAAC;iBAKnB;;CAOzB,AAAO,OAAO;EACZ,IAAI,KAAK,UAAU;EAGnB,MAAM,SAAS,GAAG,eAAe,KAAK,WAAW,eAAe,GAAG,GAAG,IAAI,QAAQ;EAElF,KAAK,WAAW,OAAO;EAEvB,KAAK,UAAU,OAAO,QAAQ,iBAAiB,SAAS,CAAC;EAEzD,KAAK,UAAU,OAAO,QAAQ,iBAAiB,WAAW;CAC5D;;;;;;;;CASA,AAAO,QAAQ,MAAc;EAC3B,IAAI,CAAC,KAAK,UACR,KAAK,KAAK;EAGZ,OAAO,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,MAAM,UAAU;GAE/C,MAAM,eAAe,MAAM,QAAQ,MAAM,EAAE;GAE3C,IAAI,CAAC,KAAK,WAAW,YAAY,GAC/B,OAAO;GAIT,MAAM,eAAe,KAAK,QAAQ;GAClC,IAAI,CAAC,MAAM,QAAQ,YAAY,KAAK,aAAa,WAAW,GAC1D,OAAO;GAKT,IAAI,aAAa,WAAW,GAAG,GAC7B,OAAO;GAMT,OAAO;EACT,CAAC;CACH;;;;CAKA,AAAO,iBAAiB,MAA6B;EAMnD,OALiB,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,MAAM,UAAU;GACzD,MAAM,eAAe,MAAM,QAAQ,MAAM,EAAE;GAC3C,OAAO,KAAK,WAAW,YAAY;EACrC,CAEc,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":["../../../../../../../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

@@ -11,8 +11,8 @@ import { join, resolve } from "path";
 import { ensureDirectoryAsync } from "@warlock.js/fs";
 import { constants } from "fs";
 import { access, readFile, writeFile } from "fs/promises";
-import ts from "typescript";
 import { pathToFileURL } from "node:url";
+import ts from "typescript";
 import { moduleResolve } from "import-meta-resolve";
 
 //#region ../core/src/dev-server/type-generator.ts
@@ -97,6 +97,7 @@ var TypeGenerator = class {
 		const files = filesOrchestrator.getFiles();
 		let configChanged = false;
 		let unchangedCount = 0;
+		this.configCache.clear();
 		for (const [path, fileManager] of files) if (path.startsWith("src/config/storage")) {
 			const manifestEntry = this.manifest?.storage;
 			if (!manifestEntry || manifestEntry.sourceHash !== fileManager.hash) await this.generateStorageTypes(path);
@@ -104,7 +105,7 @@ var TypeGenerator = class {
 		}
 		for (const [path, fileManager] of files) {
 			if (!path.startsWith("src/config/")) continue;
-			if (path.includes("index")) continue;
+			if (path.split("/").pop()?.replace(/[.][^.]+$/, "") === "index") continue;
 			const configName = path.replace("src/config/", "").replace(/\.[^.]+$/, "");
 			const manifestEntry = this.manifest?.config[configName];
 			if (!manifestEntry || manifestEntry.sourceHash !== fileManager.hash) {
@@ -131,7 +132,7 @@ var TypeGenerator = class {
 		try {
 			const driverKeys = await this.extractStorageDriverKeys(configPath);
 			if (driverKeys.length === 0) {
-				devServeLog("âš\xA0️ No storage drivers found in config");
+				devServeLog("⚠️ No storage drivers found in config");
 				return;
 			}
 			const sourceHash = filesOrchestrator.getFiles().get(configPath)?.hash || "";
@@ -155,7 +156,7 @@ ${driverKeys.map((k) => `    ${this.toInterfaceKey(k)}: true;`).join("\n")}
 			await writeFile(join(this.outputDir, "storage.d.ts"), content, "utf-8");
 			devLogSuccess(`Generated storage types: ${driverKeys.join(", ")}`);
 		} catch (error) {
-			devServeLog(`⚠️ Failed to generate storage types: ${error}`);
+			devServeLog(`⚠️ Failed to generate storage types: ${error}`);
 		}
 	}
 	/**
@@ -181,7 +182,7 @@ ${driverKeys.map((k) => `    ${this.toInterfaceKey(k)}: true;`).join("\n")}
 		const match = changedPath.match(/config\/([^/]+)\.[^.]+$/);
 		if (!match) return;
 		const configName = match[1];
-		if (configName === "index") return;
+		if (!configName || configName === "index") return;
 		devLogInfo(`Config changed: ${configName}, updating...`);
 		const sourceHash = filesOrchestrator.getFiles().get(changedPath)?.hash || Date.now().toString();
 		const configPath = join(join(process.cwd(), "src/config"), `${configName}.ts`);
@@ -204,7 +205,7 @@ ${driverKeys.map((k) => `    ${this.toInterfaceKey(k)}: true;`).join("\n")}
 			this.configCache.clear();
 			for (const [path, fileManager] of files) {
 				if (!path.startsWith("src/config/")) continue;
-				if (path.includes("index")) continue;
+				if (path.split("/").pop()?.replace(/[.][^.]+$/, "") === "index") continue;
 				const configName = path.replace("src/config/", "").replace(/\.[^.]+$/, "");
 				const info = await this.extractConfigInfo(fileManager.absolutePath, configName);
 				this.configCache.set(configName, {
@@ -216,7 +217,7 @@ ${driverKeys.map((k) => `    ${this.toInterfaceKey(k)}: true;`).join("\n")}
 			}
 			await this.writeConfigTypesFromCache();
 		} catch (error) {
-			devServeLog(`⚠️ Failed to generate config types: ${error}`);
+			devServeLog(`⚠️ Failed to generate config types: ${error}`);
 		}
 	}
 	/**
@@ -424,12 +425,12 @@ ${allKeys.map((key) => `    "${key}": true;`).join("\n")}
 	async extractStorageDriverKeys(configPath) {
 		const absolutePath = resolve(configPath);
 		if (!await this.exists(absolutePath)) {
-			devServeLog(`⚠️ Storage config not found: ${absolutePath}`);
+			devServeLog(`⚠️ Storage config not found: ${absolutePath}`);
 			return [];
 		}
 		const sourceFile = await readConfigAst(absolutePath);
 		if (!sourceFile) {
-			devServeLog(`⚠️ Could not parse storage config: ${absolutePath}`);
+			devServeLog(`⚠️ Could not parse storage config: ${absolutePath}`);
 			return [];
 		}
 		const keys = [];