alepha 0.22.0 → 0.24.0

package/dist/cli/devtools/index.d.ts

@@ -1,19 +1,13 @@
 import { Static } from "alepha";
-
 //#region ../../src/cli/devtools/atoms/devtoolsOptions.d.ts
 /**
  * Devtools configuration atom.
  *
  * Filled from the `devtools` section of `alepha.config.ts`.
  */
-declare const devtoolsOptions: import("alepha").Atom<import("typebox").TOptional<import("typebox").TObject<{
-  /**
-   * Hide the floating devtools button in the browser.
-   *
-   * The devtools UI is still accessible at `/__devtools/`.
-   */
-  hideButton: import("typebox").TOptional<import("typebox").TBoolean>;
-}>>, "alepha.cli.devtools.options">;
+declare const devtoolsOptions: import("alepha").Atom<import("zod").ZodOptional<import("zod").ZodObject<{
+  hideButton: import("zod").ZodOptional<import("zod").ZodDefault<import("zod").ZodBoolean>>;
+}, import("zod/v4/core").$strip>>, "alepha.cli.devtools.options">;
 /**
  * Type for devtools options.
  */

package/dist/cli/devtools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/cli/devtools/atoms/devtoolsOptions.ts","../../../src/cli/devtools/index.ts"],"mappings":";;;;;AAOA;;;cAAa,eAAA,mBAAe,IAAA,mBAAA,SAAA,mBAAA,OAAA;EAAA;;;;;;;;AAkB5B;;KAAY,eAAA,GAAkB,MAAM,QAAQ,eAAA,CAAgB,MAAA;;;;;AAlB5D;;;;;;;;;;;;AAkBA;;;;cCuFa,uBAAA,mBAAuB,OAAA,kBAAA,MAAA;AAAA,cAkFvB,QAAA,GAAY,OAA6B,GAApB,eAAoB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/cli/devtools/atoms/devtoolsOptions.ts","../../../src/cli/devtools/index.ts"],"mappings":";;;;;;;cAOa,kCAAe,mBAAA,0BAAA;;;;;;KAkBhB,kBAAkB,cAAc,gBAAgB;;;;;;;;;;;;;;;;;;;;;cCuF/C,0CAAuB,yBAAA;cAkFvB,WAAQ,UAAa"}

package/dist/cli/devtools/index.js

@@ -1,7 +1,7 @@
 import { createRequire } from "node:module";
 import { readFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
-import { $atom, $context, $module, AlephaError, t } from "alepha";
+import { $atom, $context, $module, AlephaError, z } from "alepha";
 import { ViteDevServerProvider } from "alepha/cli";
 //#region ../../src/cli/devtools/atoms/devtoolsOptions.ts
 /**
@@ -12,13 +12,13 @@ import { ViteDevServerProvider } from "alepha/cli";
 const devtoolsOptions = $atom({
 	name: "alepha.cli.devtools.options",
 	description: "Devtools plugin configuration",
-	schema: t.optional(t.object({ 
+	schema: z.object({ 
 	/**
 	* Hide the floating devtools button in the browser.
 	*
 	* The devtools UI is still accessible at `/__devtools/`.
 	*/
-hideButton: t.optional(t.boolean({ default: false })) }))
+hideButton: z.boolean().default(false).optional() }).optional()
 });
 //#endregion
 //#region ../../src/cli/devtools/index.ts

package/dist/cli/devtools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/cli/devtools/atoms/devtoolsOptions.ts","../../../src/cli/devtools/index.ts"],"sourcesContent":["import { $atom, type Static, t } from \"alepha\";\n\n/**\n * Devtools configuration atom.\n *\n * Filled from the `devtools` section of `alepha.config.ts`.\n */\nexport const devtoolsOptions = $atom({\n  name: \"alepha.cli.devtools.options\",\n  description: \"Devtools plugin configuration\",\n  schema: t.optional(\n    t.object({\n      /**\n       * Hide the floating devtools button in the browser.\n       *\n       * The devtools UI is still accessible at `/__devtools/`.\n       */\n      hideButton: t.optional(t.boolean({ default: false })),\n    }),\n  ),\n});\n\n/**\n * Type for devtools options.\n */\nexport type DevtoolsOptions = Static<typeof devtoolsOptions.schema>;\n","import { readFile } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join } from \"node:path\";\nimport { $context, $module, AlephaError } from \"alepha\";\nimport { ViteDevServerProvider } from \"alepha/cli\";\nimport {\n  type DevtoolsOptions,\n  devtoolsOptions,\n} from \"./atoms/devtoolsOptions.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst DEVTOOLS_OVERLAY_SCRIPT = `\n(function () {\n  if (window.__alepha_devtools_injected) return;\n  window.__alepha_devtools_injected = true;\n\n  const STORAGE_KEY = \"alepha-devtools-open\";\n\n  // Button\n  const btn = document.createElement(\"button\");\n  btn.id = \"alepha-devtools-btn\";\n  btn.innerHTML = \\`<svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M12 15a3 3 0 1 0 0-6 3 3 0 0 0 0 6Z\"/><path d=\"M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 1 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 1 1-4 0v-.09a1.65 1.65 0 0 0-1-1.51 1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 1 1-2.83-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 1 1 0-4h.09a1.65 1.65 0 0 0 1.51-1 1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 1 1 2.83-2.83l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 1 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 1 1 2.83 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 1 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1Z\"/></svg>\\`;\n  Object.assign(btn.style, {\n    position: \"fixed\", bottom: \"16px\", left: \"16px\", zIndex: \"99998\",\n    width: \"36px\", height: \"36px\", borderRadius: \"50%\",\n    background: \"rgba(255,255,255,0.85)\", color: \"#3f3f46\",\n    border: \"none\", backdropFilter: \"blur(8px)\", WebkitBackdropFilter: \"blur(8px)\",\n    cursor: \"pointer\", display: \"flex\", alignItems: \"center\", justifyContent: \"center\",\n    boxShadow: \"0 1px 2px rgba(0,0,0,0.06), 0 4px 12px rgba(0,0,0,0.08)\",\n    transition: \"transform 0.2s ease, box-shadow 0.2s ease\",\n    padding: \"0\", fontSize: \"0\",\n  });\n  btn.addEventListener(\"mouseenter\", () => {\n    btn.style.transform = \"translateY(-1px) rotate(45deg)\";\n    btn.style.boxShadow = \"0 2px 4px rgba(0,0,0,0.08), 0 8px 20px rgba(0,0,0,0.12)\";\n  });\n  btn.addEventListener(\"mouseleave\", () => {\n    btn.style.transform = \"translateY(0) rotate(0deg)\";\n    btn.style.boxShadow = \"0 1px 2px rgba(0,0,0,0.06), 0 4px 12px rgba(0,0,0,0.08)\";\n  });\n\n  // Overlay\n  const overlay = document.createElement(\"div\");\n  overlay.id = \"alepha-devtools-overlay\";\n  Object.assign(overlay.style, {\n    position: \"fixed\", inset: \"0\", zIndex: \"99999\",\n    background: \"rgba(0,0,0,0.6)\", backdropFilter: \"blur(2px)\",\n    display: \"none\", alignItems: \"center\", justifyContent: \"center\",\n  });\n\n  // Panel\n  const panel = document.createElement(\"div\");\n  Object.assign(panel.style, {\n    width: \"90vw\", height: \"85vh\", maxWidth: \"1400px\",\n    borderRadius: \"12px\", overflow: \"hidden\",\n    boxShadow: \"0 8px 32px rgba(0,0,0,0.5)\",\n    border: \"1px solid #2a2a4a\",\n  });\n\n  const iframe = document.createElement(\"iframe\");\n  iframe.style.cssText = \"width:100%;height:100%;border:none;\";\n\n  panel.appendChild(iframe);\n  overlay.appendChild(panel);\n  document.body.appendChild(btn);\n  document.body.appendChild(overlay);\n\n  function open() {\n    if (!iframe.src) iframe.src = \"/__devtools/\";\n    overlay.style.display = \"flex\";\n    btn.style.display = \"none\";\n    sessionStorage.setItem(STORAGE_KEY, \"1\");\n  }\n\n  function close() {\n    overlay.style.display = \"none\";\n    btn.style.display = \"flex\";\n    sessionStorage.removeItem(STORAGE_KEY);\n  }\n\n  btn.addEventListener(\"click\", open);\n  overlay.addEventListener(\"click\", (e) => {\n    if (e.target === overlay) close();\n  });\n  document.addEventListener(\"keydown\", (e) => {\n    if (e.key === \"Escape\" && overlay.style.display === \"flex\") close();\n  });\n\n  // Restore state after HMR\n  if (sessionStorage.getItem(STORAGE_KEY)) open();\n})();\n`;\n\n/**\n * CLI plugin that integrates @alepha/devtools into the Vite dev server.\n *\n * This module is intentionally lightweight — it does NOT statically import\n * `@alepha/devtools` (which pulls in `alepha/react` and `.tsx` files).\n * Instead, it lazy-loads devtools via Vite's SSR module loader at runtime.\n *\n * Usage in `alepha.config.ts`:\n * ```ts\n * import { devtools } from \"alepha/cli/devtools\";\n *\n * export default defineConfig({\n *   plugins: [devtools()],\n * });\n * ```\n *\n * @module alepha.devtools.plugin\n */\nexport const AlephaCliDevtoolsPlugin = $module({\n  name: \"alepha.cli.plugins.devtools\",\n  atoms: [devtoolsOptions],\n  register: (alepha) => {\n    const vite = alepha.inject(ViteDevServerProvider) as ViteDevServerProvider;\n\n    const require = createRequire(import.meta.url);\n    const pkgPath = require.resolve(\"@alepha/devtools/package.json\");\n    const assetsPath = join(dirname(pkgPath), \"assets/ui\");\n\n    process.env.VITE_ALEPHA_DEVTOOLS = \"true\";\n\n    vite.addVitePlugin({\n      name: \"alepha-devtools\",\n      configureServer: (server) => {\n        // Reload endpoint\n        server.middlewares.use((req, res, next) => {\n          if (req.url !== \"/__devtools/api/reload\" || req.method !== \"POST\") {\n            return next();\n          }\n\n          vite.reload();\n          res.writeHead(200, { \"content-type\": \"application/json\" });\n          res.end(JSON.stringify({ ok: true }));\n        });\n\n        // Serve devtools HTML\n        server.middlewares.use(async (req, res, next) => {\n          const url = req.url || \"/\";\n\n          if (\n            !url.startsWith(\"/__devtools\") ||\n            !req.headers.accept?.includes(\"text/html\")\n          ) {\n            return next();\n          }\n\n          const indexPath = join(assetsPath, \"index.html\");\n\n          try {\n            let html = await readFile(indexPath, \"utf-8\");\n            html = html.replace(\n              \"<head>\",\n              `<head><script type=\"module\" src=\"/@vite/client\"></script>`,\n            );\n\n            res.writeHead(200, { \"content-type\": \"text/html\" });\n            res.end(html);\n          } catch {\n            next();\n          }\n        });\n      },\n      transformIndexHtml: () => {\n        const options = alepha.store.get(devtoolsOptions);\n        if (options?.hideButton) return [];\n\n        return [\n          {\n            tag: \"script\",\n            attrs: { type: \"module\" },\n            children: DEVTOOLS_OVERLAY_SCRIPT,\n            injectTo: \"head\",\n          },\n        ];\n      },\n    });\n\n    vite.onAlephaLoaded(async (appAlepha, server) => {\n      try {\n        const mod = await server.ssrLoadModule(\"@alepha/devtools\");\n        appAlepha.with(mod.AlephaDevtools);\n      } catch (err) {\n        throw new AlephaError(\n          \"Failed to load @alepha/devtools. Make sure the package is installed\",\n          { cause: err },\n        );\n      }\n    });\n  },\n});\n\nexport const devtools = (options: DevtoolsOptions = {}) => {\n  return () => {\n    const { alepha } = $context();\n    alepha.with(AlephaCliDevtoolsPlugin).set(devtoolsOptions, options);\n  };\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./atoms/devtoolsOptions.ts\";\n"],"mappings":";;;;;;;;;;;AAOA,MAAa,kBAAkB,MAAM;CACnC,MAAM;CACN,aAAa;CACb,QAAQ,EAAE,SACR,EAAE,OAAO;;;;;;AAMP,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,MAAM,CAAC,CAAC,EACtD,CAAC,CACH;AACF,CAAC;;;ACRD,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoGhC,MAAa,0BAA0B,QAAQ;CAC7C,MAAM;CACN,OAAO,CAAC,eAAe;CACvB,WAAW,WAAW;EACpB,MAAM,OAAO,OAAO,OAAO,qBAAqB;EAIhD,MAAM,aAAa,KAAK,QAFR,cAAc,OAAO,KAAK,GACpB,EAAE,QAAQ,+BACM,CAAC,GAAG,WAAW;EAErD,QAAQ,IAAI,uBAAuB;EAEnC,KAAK,cAAc;GACjB,MAAM;GACN,kBAAkB,WAAW;IAE3B,OAAO,YAAY,KAAK,KAAK,KAAK,SAAS;KACzC,IAAI,IAAI,QAAQ,4BAA4B,IAAI,WAAW,QACzD,OAAO,KAAK;KAGd,KAAK,OAAO;KACZ,IAAI,UAAU,KAAK,EAAE,gBAAgB,mBAAmB,CAAC;KACzD,IAAI,IAAI,KAAK,UAAU,EAAE,IAAI,KAAK,CAAC,CAAC;IACtC,CAAC;IAGD,OAAO,YAAY,IAAI,OAAO,KAAK,KAAK,SAAS;KAG/C,IACE,EAHU,IAAI,OAAO,KAGhB,WAAW,aAAa,KAC7B,CAAC,IAAI,QAAQ,QAAQ,SAAS,WAAW,GAEzC,OAAO,KAAK;KAGd,MAAM,YAAY,KAAK,YAAY,YAAY;KAE/C,IAAI;MACF,IAAI,OAAO,MAAM,SAAS,WAAW,OAAO;MAC5C,OAAO,KAAK,QACV,UACA,4DACF;MAEA,IAAI,UAAU,KAAK,EAAE,gBAAgB,YAAY,CAAC;MAClD,IAAI,IAAI,IAAI;KACd,QAAQ;MACN,KAAK;KACP;IACF,CAAC;GACH;GACA,0BAA0B;IAExB,IADgB,OAAO,MAAM,IAAI,eACvB,GAAG,YAAY,OAAO,CAAC;IAEjC,OAAO,CACL;KACE,KAAK;KACL,OAAO,EAAE,MAAM,SAAS;KACxB,UAAU;KACV,UAAU;IACZ,CACF;GACF;EACF,CAAC;EAED,KAAK,eAAe,OAAO,WAAW,WAAW;GAC/C,IAAI;IACF,MAAM,MAAM,MAAM,OAAO,cAAc,kBAAkB;IACzD,UAAU,KAAK,IAAI,cAAc;GACnC,SAAS,KAAK;IACZ,MAAM,IAAI,YACR,uEACA,EAAE,OAAO,IAAI,CACf;GACF;EACF,CAAC;CACH;AACF,CAAC;AAED,MAAa,YAAY,UAA2B,CAAC,MAAM;CACzD,aAAa;EACX,MAAM,EAAE,WAAW,SAAS;EAC5B,OAAO,KAAK,uBAAuB,EAAE,IAAI,iBAAiB,OAAO;CACnE;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/cli/devtools/atoms/devtoolsOptions.ts","../../../src/cli/devtools/index.ts"],"sourcesContent":["import { $atom, type Static, z } from \"alepha\";\n\n/**\n * Devtools configuration atom.\n *\n * Filled from the `devtools` section of `alepha.config.ts`.\n */\nexport const devtoolsOptions = $atom({\n  name: \"alepha.cli.devtools.options\",\n  description: \"Devtools plugin configuration\",\n  schema: z\n    .object({\n      /**\n       * Hide the floating devtools button in the browser.\n       *\n       * The devtools UI is still accessible at `/__devtools/`.\n       */\n      hideButton: z.boolean().default(false).optional(),\n    })\n    .optional(),\n});\n\n/**\n * Type for devtools options.\n */\nexport type DevtoolsOptions = Static<typeof devtoolsOptions.schema>;\n","import { readFile } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join } from \"node:path\";\nimport { $context, $module, AlephaError } from \"alepha\";\nimport { ViteDevServerProvider } from \"alepha/cli\";\nimport {\n  type DevtoolsOptions,\n  devtoolsOptions,\n} from \"./atoms/devtoolsOptions.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst DEVTOOLS_OVERLAY_SCRIPT = `\n(function () {\n  if (window.__alepha_devtools_injected) return;\n  window.__alepha_devtools_injected = true;\n\n  const STORAGE_KEY = \"alepha-devtools-open\";\n\n  // Button\n  const btn = document.createElement(\"button\");\n  btn.id = \"alepha-devtools-btn\";\n  btn.innerHTML = \\`<svg width=\"18\" height=\"18\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M12 15a3 3 0 1 0 0-6 3 3 0 0 0 0 6Z\"/><path d=\"M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 1 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 1 1-4 0v-.09a1.65 1.65 0 0 0-1-1.51 1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 1 1-2.83-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 1 1 0-4h.09a1.65 1.65 0 0 0 1.51-1 1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 1 1 2.83-2.83l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 1 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 1 1 2.83 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 1 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1Z\"/></svg>\\`;\n  Object.assign(btn.style, {\n    position: \"fixed\", bottom: \"16px\", left: \"16px\", zIndex: \"99998\",\n    width: \"36px\", height: \"36px\", borderRadius: \"50%\",\n    background: \"rgba(255,255,255,0.85)\", color: \"#3f3f46\",\n    border: \"none\", backdropFilter: \"blur(8px)\", WebkitBackdropFilter: \"blur(8px)\",\n    cursor: \"pointer\", display: \"flex\", alignItems: \"center\", justifyContent: \"center\",\n    boxShadow: \"0 1px 2px rgba(0,0,0,0.06), 0 4px 12px rgba(0,0,0,0.08)\",\n    transition: \"transform 0.2s ease, box-shadow 0.2s ease\",\n    padding: \"0\", fontSize: \"0\",\n  });\n  btn.addEventListener(\"mouseenter\", () => {\n    btn.style.transform = \"translateY(-1px) rotate(45deg)\";\n    btn.style.boxShadow = \"0 2px 4px rgba(0,0,0,0.08), 0 8px 20px rgba(0,0,0,0.12)\";\n  });\n  btn.addEventListener(\"mouseleave\", () => {\n    btn.style.transform = \"translateY(0) rotate(0deg)\";\n    btn.style.boxShadow = \"0 1px 2px rgba(0,0,0,0.06), 0 4px 12px rgba(0,0,0,0.08)\";\n  });\n\n  // Overlay\n  const overlay = document.createElement(\"div\");\n  overlay.id = \"alepha-devtools-overlay\";\n  Object.assign(overlay.style, {\n    position: \"fixed\", inset: \"0\", zIndex: \"99999\",\n    background: \"rgba(0,0,0,0.6)\", backdropFilter: \"blur(2px)\",\n    display: \"none\", alignItems: \"center\", justifyContent: \"center\",\n  });\n\n  // Panel\n  const panel = document.createElement(\"div\");\n  Object.assign(panel.style, {\n    width: \"90vw\", height: \"85vh\", maxWidth: \"1400px\",\n    borderRadius: \"12px\", overflow: \"hidden\",\n    boxShadow: \"0 8px 32px rgba(0,0,0,0.5)\",\n    border: \"1px solid #2a2a4a\",\n  });\n\n  const iframe = document.createElement(\"iframe\");\n  iframe.style.cssText = \"width:100%;height:100%;border:none;\";\n\n  panel.appendChild(iframe);\n  overlay.appendChild(panel);\n  document.body.appendChild(btn);\n  document.body.appendChild(overlay);\n\n  function open() {\n    if (!iframe.src) iframe.src = \"/__devtools/\";\n    overlay.style.display = \"flex\";\n    btn.style.display = \"none\";\n    sessionStorage.setItem(STORAGE_KEY, \"1\");\n  }\n\n  function close() {\n    overlay.style.display = \"none\";\n    btn.style.display = \"flex\";\n    sessionStorage.removeItem(STORAGE_KEY);\n  }\n\n  btn.addEventListener(\"click\", open);\n  overlay.addEventListener(\"click\", (e) => {\n    if (e.target === overlay) close();\n  });\n  document.addEventListener(\"keydown\", (e) => {\n    if (e.key === \"Escape\" && overlay.style.display === \"flex\") close();\n  });\n\n  // Restore state after HMR\n  if (sessionStorage.getItem(STORAGE_KEY)) open();\n})();\n`;\n\n/**\n * CLI plugin that integrates @alepha/devtools into the Vite dev server.\n *\n * This module is intentionally lightweight — it does NOT statically import\n * `@alepha/devtools` (which pulls in `alepha/react` and `.tsx` files).\n * Instead, it lazy-loads devtools via Vite's SSR module loader at runtime.\n *\n * Usage in `alepha.config.ts`:\n * ```ts\n * import { devtools } from \"alepha/cli/devtools\";\n *\n * export default defineConfig({\n *   plugins: [devtools()],\n * });\n * ```\n *\n * @module alepha.devtools.plugin\n */\nexport const AlephaCliDevtoolsPlugin = $module({\n  name: \"alepha.cli.plugins.devtools\",\n  atoms: [devtoolsOptions],\n  register: (alepha) => {\n    const vite = alepha.inject(ViteDevServerProvider) as ViteDevServerProvider;\n\n    const require = createRequire(import.meta.url);\n    const pkgPath = require.resolve(\"@alepha/devtools/package.json\");\n    const assetsPath = join(dirname(pkgPath), \"assets/ui\");\n\n    process.env.VITE_ALEPHA_DEVTOOLS = \"true\";\n\n    vite.addVitePlugin({\n      name: \"alepha-devtools\",\n      configureServer: (server) => {\n        // Reload endpoint\n        server.middlewares.use((req, res, next) => {\n          if (req.url !== \"/__devtools/api/reload\" || req.method !== \"POST\") {\n            return next();\n          }\n\n          vite.reload();\n          res.writeHead(200, { \"content-type\": \"application/json\" });\n          res.end(JSON.stringify({ ok: true }));\n        });\n\n        // Serve devtools HTML\n        server.middlewares.use(async (req, res, next) => {\n          const url = req.url || \"/\";\n\n          if (\n            !url.startsWith(\"/__devtools\") ||\n            !req.headers.accept?.includes(\"text/html\")\n          ) {\n            return next();\n          }\n\n          const indexPath = join(assetsPath, \"index.html\");\n\n          try {\n            let html = await readFile(indexPath, \"utf-8\");\n            html = html.replace(\n              \"<head>\",\n              `<head><script type=\"module\" src=\"/@vite/client\"></script>`,\n            );\n\n            res.writeHead(200, { \"content-type\": \"text/html\" });\n            res.end(html);\n          } catch {\n            next();\n          }\n        });\n      },\n      transformIndexHtml: () => {\n        const options = alepha.store.get(devtoolsOptions);\n        if (options?.hideButton) return [];\n\n        return [\n          {\n            tag: \"script\",\n            attrs: { type: \"module\" },\n            children: DEVTOOLS_OVERLAY_SCRIPT,\n            injectTo: \"head\",\n          },\n        ];\n      },\n    });\n\n    vite.onAlephaLoaded(async (appAlepha, server) => {\n      try {\n        const mod = await server.ssrLoadModule(\"@alepha/devtools\");\n        appAlepha.with(mod.AlephaDevtools);\n      } catch (err) {\n        throw new AlephaError(\n          \"Failed to load @alepha/devtools. Make sure the package is installed\",\n          { cause: err },\n        );\n      }\n    });\n  },\n});\n\nexport const devtools = (options: DevtoolsOptions = {}) => {\n  return () => {\n    const { alepha } = $context();\n    alepha.with(AlephaCliDevtoolsPlugin).set(devtoolsOptions, options);\n  };\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./atoms/devtoolsOptions.ts\";\n"],"mappings":";;;;;;;;;;;AAOA,MAAa,kBAAkB,MAAM;CACnC,MAAM;CACN,aAAa;CACb,QAAQ,EACL,OAAO;;;;;;AAMN,YAAY,EAAE,QAAQ,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,SAAS,EAClD,CAAC,CAAC,CACD,SAAS;AACd,CAAC;;;ACRD,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoGhC,MAAa,0BAA0B,QAAQ;CAC7C,MAAM;CACN,OAAO,CAAC,eAAe;CACvB,WAAW,WAAW;EACpB,MAAM,OAAO,OAAO,OAAO,qBAAqB;EAIhD,MAAM,aAAa,KAAK,QAFR,cAAc,OAAO,KAAK,GACpB,CAAC,CAAC,QAAQ,+BACM,CAAC,GAAG,WAAW;EAErD,QAAQ,IAAI,uBAAuB;EAEnC,KAAK,cAAc;GACjB,MAAM;GACN,kBAAkB,WAAW;IAE3B,OAAO,YAAY,KAAK,KAAK,KAAK,SAAS;KACzC,IAAI,IAAI,QAAQ,4BAA4B,IAAI,WAAW,QACzD,OAAO,KAAK;KAGd,KAAK,OAAO;KACZ,IAAI,UAAU,KAAK,EAAE,gBAAgB,mBAAmB,CAAC;KACzD,IAAI,IAAI,KAAK,UAAU,EAAE,IAAI,KAAK,CAAC,CAAC;IACtC,CAAC;IAGD,OAAO,YAAY,IAAI,OAAO,KAAK,KAAK,SAAS;KAG/C,IACE,EAHU,IAAI,OAAO,IAAA,CAGhB,WAAW,aAAa,KAC7B,CAAC,IAAI,QAAQ,QAAQ,SAAS,WAAW,GAEzC,OAAO,KAAK;KAGd,MAAM,YAAY,KAAK,YAAY,YAAY;KAE/C,IAAI;MACF,IAAI,OAAO,MAAM,SAAS,WAAW,OAAO;MAC5C,OAAO,KAAK,QACV,UACA,4DACF;MAEA,IAAI,UAAU,KAAK,EAAE,gBAAgB,YAAY,CAAC;MAClD,IAAI,IAAI,IAAI;KACd,QAAQ;MACN,KAAK;KACP;IACF,CAAC;GACH;GACA,0BAA0B;IAExB,IADgB,OAAO,MAAM,IAAI,eACvB,CAAC,EAAE,YAAY,OAAO,CAAC;IAEjC,OAAO,CACL;KACE,KAAK;KACL,OAAO,EAAE,MAAM,SAAS;KACxB,UAAU;KACV,UAAU;IACZ,CACF;GACF;EACF,CAAC;EAED,KAAK,eAAe,OAAO,WAAW,WAAW;GAC/C,IAAI;IACF,MAAM,MAAM,MAAM,OAAO,cAAc,kBAAkB;IACzD,UAAU,KAAK,IAAI,cAAc;GACnC,SAAS,KAAK;IACZ,MAAM,IAAI,YACR,uEACA,EAAE,OAAO,IAAI,CACf;GACF;EACF,CAAC;CACH;AACF,CAAC;AAED,MAAa,YAAY,UAA2B,CAAC,MAAM;CACzD,aAAa;EACX,MAAM,EAAE,WAAW,SAAS;EAC5B,OAAO,KAAK,uBAAuB,CAAC,CAAC,IAAI,iBAAiB,OAAO;CACnE;AACF"}

package/dist/cli/i18n/index.d.ts

@@ -1,7 +1,6 @@
 import { Static } from "alepha";
 import { ConsoleColorProvider } from "alepha/logger";
 import { FileSystemProvider } from "alepha/system";
-
 //#region ../../src/cli/i18n/atoms/i18nOptions.d.ts
 /**
  * i18n CLI configuration atom.
@@ -9,36 +8,11 @@ import { FileSystemProvider } from "alepha/system";
  * Filled from the `i18n` plugin in `alepha.config.ts`.
  * Read by `I18nCommand` to drive `alepha i18n check`.
  */
-declare const i18nOptions: import("alepha").Atom<import("typebox").TOptional<import("typebox").TObject<{
-  /**
-   * Directories (relative to the project root) to scan both for
-   * `$dictionary(...)` declarations and for translation key usage.
-   *
-   * @default ["src"]
-   */
-  scan: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
-  /**
-   * Key prefixes that are constructed at runtime (e.g. via template
-   * literals like `` tr(`archive.type.${kind}`) ``). Every key
-   * starting with one of these prefixes is exempted from the
-   * unused check.
-   *
-   * Keep this list short and audit it when a feature is removed —
-   * a stale prefix here means dead keys can hide.
-   *
-   * @default []
-   */
-  dynamicPrefixes: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
-  /**
-   * Additional path substrings (matched against the full file
-   * path) that should be excluded from the scan, on top of the
-   * defaults (`node_modules`, `dist`, `__tests__`, `.spec.*`,
-   * `.test.*`, `.alepha`).
-   *
-   * @default []
-   */
-  exclude: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
-}>>, "alepha.cli.i18n.options">;
+declare const i18nOptions: import("alepha").Atom<import("zod").ZodOptional<import("zod").ZodObject<{
+  scan: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+  dynamicPrefixes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+  exclude: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+}, import("zod/v4/core").$strip>>, "alepha.cli.i18n.options">;
 /**
  * Type for i18n options.
  */
@@ -69,13 +43,20 @@ declare class I18nCheckService {
    * Find unused translation keys.
    *
    * Discovery is fully static: we walk `scan` dirs, identify files
-   * that import `$dictionary` (matched via the literal substring),
-   * extract every `"a.b.c": ...` property key declared in them, then
-   * grep the remaining source files for a quoted-literal occurrence
-   * of each key. Anything matching a `dynamicPrefixes` entry is
-   * exempted.
+   * that import `$dictionary` (matched via the literal substring) plus
+   * any per-language files they lazily `import(...)`, extract every
+   * `"a.b.c": ...` property key declared across them, then grep the
+   * remaining source files for a quoted-literal occurrence of each key.
+   * Anything matching a `dynamicPrefixes` entry is exempted.
    */
   check(options: I18nCheckOptions): Promise<I18nCheckResult>;
+  /**
+   * Resolve a relative `import("…")` specifier from `fromFile` to an absolute
+   * path that was actually scanned. Returns `undefined` for bare/package
+   * specifiers or targets outside the scan set. Extensionless specifiers are
+   * probed against each supported source extension.
+   */
+  protected resolveImport(fromFile: string, spec: string, files: Map<string, string>): string | undefined;
 }
 //#endregion
 //#region ../../src/cli/i18n/commands/I18nCommand.d.ts
@@ -85,7 +66,7 @@ declare class I18nCommand {
     scan?: string[] | undefined;
     dynamicPrefixes?: string[] | undefined;
     exclude?: string[] | undefined;
-  }>;
+  } | undefined>;
   protected readonly checkService: I18nCheckService;
   protected readonly color: ConsoleColorProvider;
   protected resolveOptions(): {
@@ -93,8 +74,8 @@ declare class I18nCommand {
     dynamicPrefixes: string[];
     exclude: string[];
   };
-  protected readonly check: import("alepha/command").CommandPrimitive<import("typebox").TObject<import("typebox").TProperties>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
-  readonly i18n: import("alepha/command").CommandPrimitive<import("typebox").TObject<import("typebox").TProperties>, import("typebox").TSchema, import("typebox").TObject<import("typebox").TProperties>>;
+  protected readonly check: import("alepha/command").CommandPrimitive<import("alepha").TObject, import("alepha").ZType, import("alepha").TObject>;
+  readonly i18n: import("alepha/command").CommandPrimitive<import("alepha").TObject, import("alepha").ZType, import("alepha").TObject>;
 }
 //#endregion
 //#region ../../src/cli/i18n/index.d.ts

package/dist/cli/i18n/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/cli/i18n/atoms/i18nOptions.ts","../../../src/cli/i18n/services/I18nCheckService.ts","../../../src/cli/i18n/commands/I18nCommand.ts","../../../src/cli/i18n/index.ts"],"mappings":";;;;;;;;;AAQA;;cAAa,WAAA,mBAAW,IAAA,mBAAA,SAAA,mBAAA,OAAA;EAqCtB;;;;;;;;;;;;;;;;;;;EAKqB;;;;;;;AAAmC;;;;ACb1D;;KDaY,WAAA,GAAc,MAAM,QAAQ,WAAA,CAAY,MAAA;;;UCbnC,gBAAA;EACf,IAAA;EACA,IAAA;EACA,eAAA;EACA,OAAA;AAAA;AAAA,UAGe,eAAA;EDCf;ECCA,SAAA;EDtCsB;ECwCtB,UAAA;;EAEA,YAAA;;EAEA,eAAA;;EAEA,MAAA;AAAA;AAAA,cAGW,gBAAA;EAAA,mBACQ,EAAA,EAAE,kBAAA;;;;;;ADRvB;;;;;ECoBQ,KAAA,CAAM,OAAA,EAAS,gBAAA,GAAmB,OAAA,CAAQ,eAAA;AAAA;;;cChErC,WAAA;EAAA,mBACQ,GAAA,0BAAG,MAAA;EAAA,mBACH,OAAA,EAAO,QAAA;;;;;qBACP,YAAA,EAAY,gBAAA;EAAA,mBACZ,KAAA,EAAK,oBAAA;EAAA,UAEd,cAAA;;;;;qBAQS,KAAA,2BAAK,gBAAA,mBAAA,OAAA,mBAAA,WAAA,qBAAA,OAAA,oBAAA,OAAA,mBAAA,WAAA;EAAA,SAoDR,IAAA,2BAAI,gBAAA,mBAAA,OAAA,mBAAA,WAAA,qBAAA,OAAA,oBAAA,OAAA,mBAAA,WAAA;AAAA;;;;;;;AFhEtB;;;;;;;;;;;;;;;;;;;;;AA0CA;;cGhBa,mBAAA,mBAAmB,OAAA,kBAAA,MAAA;AAAA,cAMnB,IAAA,GAAQ,OAAyB,GAAhB,WAAgB"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/cli/i18n/atoms/i18nOptions.ts","../../../src/cli/i18n/services/I18nCheckService.ts","../../../src/cli/i18n/commands/I18nCommand.ts","../../../src/cli/i18n/index.ts"],"mappings":";;;;;;;;;;cAQa,8BAAW,mBAAA,0BAAA;;;;;;;;KA0CZ,cAAc,cAAc,YAAY;;;UCGnC;EACf;EACA;EACA;EACA;;UAGe;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;cAGW;qBACQ,IAAE;;;;;;;;;;;EAYf,MAAM,SAAS,mBAAmB,QAAQ;;;;;;;YAgGtC,cACR,kBACA,cACA,OAAO;;;;cCnLE;qBACQ,6BAAG;qBACH,SAAO;;;;;qBACP,cAAY;qBACZ,OAAK;YAEd;IAEN;IACA;IACA;;qBAIe,gCAAK,kCAAA,0BAAA,wBAAA;WAoDR,+BAAI,kCAAA,0BAAA,wBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cCtCT,sCAAmB,yBAAA;cAMnB,OAAI,UAAa"}

package/dist/cli/i18n/index.js

@@ -1,4 +1,4 @@
-import { $atom, $context, $inject, $module, $state, t } from "alepha";
+import { $atom, $context, $inject, $module, $state, z } from "alepha";
 import { $command } from "alepha/command";
 import { $logger, ConsoleColorProvider } from "alepha/logger";
 import { FileSystemProvider } from "alepha/system";
@@ -12,14 +12,14 @@ import { FileSystemProvider } from "alepha/system";
 const i18nOptions = $atom({
 	name: "alepha.cli.i18n.options",
 	description: "i18n unused-key check configuration",
-	schema: t.optional(t.object({
+	schema: z.object({
 		/**
 		* Directories (relative to the project root) to scan both for
 		* `$dictionary(...)` declarations and for translation key usage.
 		*
 		* @default ["src"]
 		*/
-		scan: t.optional(t.array(t.text())),
+		scan: z.array(z.text()).optional(),
 		/**
 		* Key prefixes that are constructed at runtime (e.g. via template
 		* literals like `` tr(`archive.type.${kind}`) ``). Every key
@@ -31,7 +31,7 @@ const i18nOptions = $atom({
 		*
 		* @default []
 		*/
-		dynamicPrefixes: t.optional(t.array(t.text())),
+		dynamicPrefixes: z.array(z.text()).optional(),
 		/**
 		* Additional path substrings (matched against the full file
 		* path) that should be excluded from the scan, on top of the
@@ -40,8 +40,8 @@ const i18nOptions = $atom({
 		*
 		* @default []
 		*/
-		exclude: t.optional(t.array(t.text()))
-	}))
+		exclude: z.array(z.text()).optional()
+	}).optional()
 });
 //#endregion
 //#region ../../src/cli/i18n/services/I18nCheckService.ts
@@ -80,17 +80,31 @@ const KEY_DECLARATION_RE = /"([\w-]+(?:\.[\w-]+)+)"\s*:/g;
 * dictionary tucked away in an unusual location.
 */
 const DICTIONARY_MARKER = "$dictionary";
+/**
+* Captures the module specifier of a lazily-imported dictionary, i.e. the
+* `"./fr.ts"` in `$dictionary({ lazy: () => import("./fr.ts") })`. Apps
+* commonly split each language into its own file so a session only ships the
+* active locale — those key files carry no `$dictionary` marker, so without
+* this the keys would be invisible to the check.
+*
+* `[^{}]*?` keeps the match inside the `$dictionary` call's own object literal
+* (it stops at the first brace), so unrelated lazy imports in the same file —
+* e.g. a sibling `$page({ lazy: () => import("./Page.tsx") })` or a
+* `$dictionary` whose `lazy` returns an inline `({ default: {…} })` object —
+* are never mistaken for dictionary key files.
+*/
+const DICTIONARY_LAZY_IMPORT_RE = /\$dictionary\s*\(\s*\{[^{}]*?import\s*\(\s*["']([^"']+)["']/g;
 var I18nCheckService = class {
 	fs = $inject(FileSystemProvider);
 	/**
 	* Find unused translation keys.
 	*
 	* Discovery is fully static: we walk `scan` dirs, identify files
-	* that import `$dictionary` (matched via the literal substring),
-	* extract every `"a.b.c": ...` property key declared in them, then
-	* grep the remaining source files for a quoted-literal occurrence
-	* of each key. Anything matching a `dynamicPrefixes` entry is
-	* exempted.
+	* that import `$dictionary` (matched via the literal substring) plus
+	* any per-language files they lazily `import(...)`, extract every
+	* `"a.b.c": ...` property key declared across them, then grep the
+	* remaining source files for a quoted-literal occurrence of each key.
+	* Anything matching a `dynamicPrefixes` entry is exempted.
 	*/
 	async check(options) {
 		const { root, scan, dynamicPrefixes, exclude } = options;
@@ -111,18 +125,26 @@ var I18nCheckService = class {
 				allFiles.push(abs);
 			}
 		}
-		const dictionaryFiles = [];
-		const allKeys = /* @__PURE__ */ new Set();
 		const fileContents = /* @__PURE__ */ new Map();
-		for (const file of allFiles) {
-			const text = (await this.fs.readFile(file)).toString("utf8");
-			fileContents.set(file, text);
+		for (const file of allFiles) fileContents.set(file, (await this.fs.readFile(file)).toString("utf8"));
+		const dictionarySet = /* @__PURE__ */ new Set();
+		for (const [file, text] of fileContents) {
 			if (!text.includes(DICTIONARY_MARKER)) continue;
+			dictionarySet.add(file);
+			for (const m of text.matchAll(DICTIONARY_LAZY_IMPORT_RE)) {
+				const target = this.resolveImport(file, m[1], fileContents);
+				if (target) dictionarySet.add(target);
+			}
+		}
+		const dictionaryFiles = [];
+		const allKeys = /* @__PURE__ */ new Set();
+		for (const file of dictionarySet) {
+			const text = fileContents.get(file);
+			if (!text) continue;
 			const before = allKeys.size;
 			for (const m of text.matchAll(KEY_DECLARATION_RE)) allKeys.add(m[1]);
 			if (allKeys.size > before) dictionaryFiles.push(file);
 		}
-		const dictionarySet = new Set(dictionaryFiles);
 		const corpusParts = [];
 		let scannedFiles = 0;
 		for (const [file, text] of fileContents) {
@@ -149,6 +171,18 @@ var I18nCheckService = class {
 			unused: unused.sort()
 		};
 	}
+	/**
+	* Resolve a relative `import("…")` specifier from `fromFile` to an absolute
+	* path that was actually scanned. Returns `undefined` for bare/package
+	* specifiers or targets outside the scan set. Extensionless specifiers are
+	* probed against each supported source extension.
+	*/
+	resolveImport(fromFile, spec, files) {
+		if (!spec.startsWith(".")) return void 0;
+		const base = this.fs.join(fromFile, "..", spec);
+		if (files.has(base)) return base;
+		for (const ext of SCAN_EXTS) if (files.has(base + ext)) return base + ext;
+	}
 };
 //#endregion
 //#region ../../src/cli/i18n/commands/I18nCommand.ts

package/dist/cli/i18n/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/cli/i18n/atoms/i18nOptions.ts","../../../src/cli/i18n/services/I18nCheckService.ts","../../../src/cli/i18n/commands/I18nCommand.ts","../../../src/cli/i18n/index.ts"],"sourcesContent":["import { $atom, type Static, t } from \"alepha\";\n\n/**\n * i18n CLI configuration atom.\n *\n * Filled from the `i18n` plugin in `alepha.config.ts`.\n * Read by `I18nCommand` to drive `alepha i18n check`.\n */\nexport const i18nOptions = $atom({\n  name: \"alepha.cli.i18n.options\",\n  description: \"i18n unused-key check configuration\",\n  schema: t.optional(\n    t.object({\n      /**\n       * Directories (relative to the project root) to scan both for\n       * `$dictionary(...)` declarations and for translation key usage.\n       *\n       * @default [\"src\"]\n       */\n      scan: t.optional(t.array(t.text())),\n\n      /**\n       * Key prefixes that are constructed at runtime (e.g. via template\n       * literals like `` tr(`archive.type.${kind}`) ``). Every key\n       * starting with one of these prefixes is exempted from the\n       * unused check.\n       *\n       * Keep this list short and audit it when a feature is removed —\n       * a stale prefix here means dead keys can hide.\n       *\n       * @default []\n       */\n      dynamicPrefixes: t.optional(t.array(t.text())),\n\n      /**\n       * Additional path substrings (matched against the full file\n       * path) that should be excluded from the scan, on top of the\n       * defaults (`node_modules`, `dist`, `__tests__`, `.spec.*`,\n       * `.test.*`, `.alepha`).\n       *\n       * @default []\n       */\n      exclude: t.optional(t.array(t.text())),\n    }),\n  ),\n});\n\n/**\n * Type for i18n options.\n */\nexport type I18nOptions = Static<typeof i18nOptions.schema>;\n","import { $inject } from \"alepha\";\nimport { FileSystemProvider } from \"alepha/system\";\n\n/**\n * File extensions considered when scanning for dictionaries / usage.\n */\nconst SCAN_EXTS = [\".ts\", \".tsx\", \".mts\", \".cts\"];\n\n/**\n * Built-in path substrings that are always excluded from scanning.\n */\nconst DEFAULT_EXCLUDES = [\n  \"/node_modules/\",\n  \"/dist/\",\n  \"/__tests__/\",\n  \"/.alepha/\",\n  \".spec.ts\",\n  \".spec.tsx\",\n  \".test.ts\",\n  \".test.tsx\",\n];\n\n/**\n * Matches a quoted dotted property key on the left-hand side of a\n * dictionary entry: `\"some.dotted.key\":`. The \"at least one dot\"\n * requirement rules out unrelated quoted strings (e.g. JSON literals\n * inside helper text).\n */\nconst KEY_DECLARATION_RE = /\"([\\w-]+(?:\\.[\\w-]+)+)\"\\s*:/g;\n\n/**\n * Heuristic for spotting files that declare a dictionary. Conservative\n * by design — we'd rather scan a few unrelated files than miss a\n * dictionary tucked away in an unusual location.\n */\nconst DICTIONARY_MARKER = \"$dictionary\";\n\nexport interface I18nCheckOptions {\n  root: string;\n  scan: string[];\n  dynamicPrefixes: string[];\n  exclude: string[];\n}\n\nexport interface I18nCheckResult {\n  /** Total number of keys discovered across all dictionary files. */\n  totalKeys: number;\n  /** Number of keys exempted via `dynamicPrefixes`. */\n  exemptKeys: number;\n  /** Number of source files scanned for references. */\n  scannedFiles: number;\n  /** Dictionary files that contributed keys. */\n  dictionaryFiles: string[];\n  /** Keys that have no quoted-literal reference anywhere in the scan. */\n  unused: string[];\n}\n\nexport class I18nCheckService {\n  protected readonly fs = $inject(FileSystemProvider);\n\n  /**\n   * Find unused translation keys.\n   *\n   * Discovery is fully static: we walk `scan` dirs, identify files\n   * that import `$dictionary` (matched via the literal substring),\n   * extract every `\"a.b.c\": ...` property key declared in them, then\n   * grep the remaining source files for a quoted-literal occurrence\n   * of each key. Anything matching a `dynamicPrefixes` entry is\n   * exempted.\n   */\n  async check(options: I18nCheckOptions): Promise<I18nCheckResult> {\n    const { root, scan, dynamicPrefixes, exclude } = options;\n    const excludes = [...DEFAULT_EXCLUDES, ...exclude];\n\n    const allFiles: string[] = [];\n    for (const dir of scan) {\n      const absDir = this.fs.join(root, dir);\n      let entries: string[];\n      try {\n        entries = await this.fs.ls(absDir, { recursive: true });\n      } catch {\n        // Missing scan dir is silently skipped — config carries\n        // optional paths (e.g. .vendor/**) that may not exist locally.\n        continue;\n      }\n      for (const rel of entries) {\n        const abs = this.fs.join(absDir, rel);\n        if (!SCAN_EXTS.some((ext) => abs.endsWith(ext))) continue;\n        if (excludes.some((sub) => abs.includes(sub))) continue;\n        allFiles.push(abs);\n      }\n    }\n\n    const dictionaryFiles: string[] = [];\n    const allKeys = new Set<string>();\n    const fileContents = new Map<string, string>();\n\n    for (const file of allFiles) {\n      const text = (await this.fs.readFile(file)).toString(\"utf8\");\n      fileContents.set(file, text);\n      if (!text.includes(DICTIONARY_MARKER)) continue;\n      const before = allKeys.size;\n      for (const m of text.matchAll(KEY_DECLARATION_RE)) {\n        allKeys.add(m[1]);\n      }\n      if (allKeys.size > before) dictionaryFiles.push(file);\n    }\n\n    // Concatenate every non-dictionary file into one corpus so each\n    // key is tested with a single regex run rather than O(files × keys).\n    const dictionarySet = new Set(dictionaryFiles);\n    const corpusParts: string[] = [];\n    let scannedFiles = 0;\n    for (const [file, text] of fileContents) {\n      if (dictionarySet.has(file)) continue;\n      corpusParts.push(text);\n      scannedFiles++;\n    }\n    const corpus = corpusParts.join(\"\\n\");\n\n    let exemptKeys = 0;\n    const unused: string[] = [];\n    for (const key of allKeys) {\n      if (dynamicPrefixes.some((p) => key.startsWith(p))) {\n        exemptKeys++;\n        continue;\n      }\n      const literal = key.replace(/[.\\\\]/g, (c) => `\\\\${c}`);\n      // Key must appear as a quoted string literal — `\"...\"`, `'...'`,\n      // or `` `...` ``. Quotes on both sides rule out accidental\n      // substring hits in longer keys.\n      const re = new RegExp(`[\"'\\`]${literal}[\"'\\`]`);\n      if (!re.test(corpus)) unused.push(key);\n    }\n\n    return {\n      totalKeys: allKeys.size,\n      exemptKeys,\n      scannedFiles,\n      dictionaryFiles,\n      unused: unused.sort(),\n    };\n  }\n}\n","import { $inject, $state } from \"alepha\";\nimport { $command } from \"alepha/command\";\nimport { $logger, ConsoleColorProvider } from \"alepha/logger\";\nimport { i18nOptions } from \"../atoms/i18nOptions.ts\";\nimport { I18nCheckService } from \"../services/I18nCheckService.ts\";\n\nexport class I18nCommand {\n  protected readonly log = $logger();\n  protected readonly options = $state(i18nOptions);\n  protected readonly checkService = $inject(I18nCheckService);\n  protected readonly color = $inject(ConsoleColorProvider);\n\n  protected resolveOptions() {\n    return {\n      scan: this.options?.scan ?? [\"src\"],\n      dynamicPrefixes: this.options?.dynamicPrefixes ?? [],\n      exclude: this.options?.exclude ?? [],\n    };\n  }\n\n  protected readonly check = $command({\n    name: \"check\",\n    description: \"Report translation keys with no quoted-literal reference\",\n    handler: async ({ root }) => {\n      const opts = this.resolveOptions();\n      const c = this.color;\n\n      const result = await this.checkService.check({ root, ...opts });\n\n      if (result.totalKeys === 0) {\n        process.stdout.write(\n          `\\n${c.set(\"ORANGE\", \"warn\")} No translation keys found. ` +\n            `Did the dictionary location change? ` +\n            `Searched: ${opts.scan.join(\", \")}\\n\\n`,\n        );\n        process.exit(2);\n      }\n\n      process.stdout.write(\n        `\\nChecked ${c.set(\"CYAN\", String(result.totalKeys))} keys across ` +\n          `${c.set(\"CYAN\", String(result.scannedFiles))} files ` +\n          `(${result.dictionaryFiles.length} dictionary ` +\n          `${result.dictionaryFiles.length === 1 ? \"file\" : \"files\"}).\\n`,\n      );\n      if (result.exemptKeys > 0) {\n        process.stdout.write(\n          `  exempt (dynamic prefixes): ${result.exemptKeys}\\n`,\n        );\n      }\n\n      if (result.unused.length === 0) {\n        process.stdout.write(\n          `\\n${c.set(\"GREEN\", \"✓\")} All translations are referenced.\\n\\n`,\n        );\n        return;\n      }\n\n      process.stdout.write(\n        `\\n${c.set(\"RED\", \"✗\")} Unused translations (${result.unused.length}):\\n`,\n      );\n      for (const k of result.unused) {\n        process.stdout.write(`  ${c.set(\"DIM\", \"-\")} ${k}\\n`);\n      }\n      process.stdout.write(\n        `\\nEither delete the key from its dictionary, or add its prefix to ` +\n          `${c.set(\"CYAN\", \"dynamicPrefixes\")} in alepha.config.ts ` +\n          `if it's constructed at runtime.\\n\\n`,\n      );\n      process.exit(1);\n    },\n  });\n\n  public readonly i18n = $command({\n    name: \"i18n\",\n    description: \"Internationalization tooling\",\n    children: [this.check],\n    handler: async ({ help }) => {\n      help();\n    },\n  });\n}\n","import { $context, $module } from \"alepha\";\nimport { type I18nOptions, i18nOptions } from \"./atoms/i18nOptions.ts\";\nimport { I18nCommand } from \"./commands/I18nCommand.ts\";\nimport { I18nCheckService } from \"./services/I18nCheckService.ts\";\n\n// ---------------------------------------------------------------------------\n\n/**\n * CLI plugin for finding unused translation keys.\n *\n * Statically scans the project for `$dictionary(...)` calls, extracts\n * every declared key, and reports the ones that have no quoted-literal\n * reference anywhere else in the source tree. Designed to be wired\n * into `yarn v` (or any verify pipeline) so dead i18n entries can't\n * pile up unnoticed when a feature is removed.\n *\n * Commands:\n * - `alepha i18n check` — report unused translation keys\n *\n * Configuration in `alepha.config.ts`:\n *\n * ```typescript\n * import { i18n } from \"alepha/cli/i18n\";\n *\n * export default defineConfig({\n *   plugins: [\n *     i18n({\n *       scan: [\"src\", \".vendor/@alepha/ui\"],\n *       dynamicPrefixes: [\"archive.type.\", \"petitions.filter.\"],\n *     }),\n *   ],\n * });\n * ```\n */\nexport const AlephaCliI18nPlugin = $module({\n  name: \"alepha.cli.plugins.i18n\",\n  atoms: [i18nOptions],\n  services: [I18nCommand, I18nCheckService],\n});\n\nexport const i18n = (options: I18nOptions = {}) => {\n  return () => {\n    const { alepha } = $context();\n    alepha.with(AlephaCliI18nPlugin).set(i18nOptions, options);\n  };\n};\n\n// ---------------------------------------------------------------------------\n\nexport * from \"./atoms/i18nOptions.ts\";\nexport * from \"./commands/I18nCommand.ts\";\nexport * from \"./services/I18nCheckService.ts\";\n"],"mappings":";;;;;;;;;;;AAQA,MAAa,cAAc,MAAM;CAC/B,MAAM;CACN,aAAa;CACb,QAAQ,EAAE,SACR,EAAE,OAAO;;;;;;;EAOP,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;;;;;;;;;;;;EAalC,iBAAiB,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;;;;;;;;;EAU7C,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;CACvC,CAAC,CACH;AACF,CAAC;;;;;;ACvCD,MAAM,YAAY;CAAC;CAAO;CAAQ;CAAQ;AAAM;;;;AAKhD,MAAM,mBAAmB;CACvB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;AAQA,MAAM,qBAAqB;;;;;;AAO3B,MAAM,oBAAoB;AAsB1B,IAAa,mBAAb,MAA8B;CAC5B,KAAwB,QAAQ,kBAAkB;;;;;;;;;;;CAYlD,MAAM,MAAM,SAAqD;EAC/D,MAAM,EAAE,MAAM,MAAM,iBAAiB,YAAY;EACjD,MAAM,WAAW,CAAC,GAAG,kBAAkB,GAAG,OAAO;EAEjD,MAAM,WAAqB,CAAC;EAC5B,KAAK,MAAM,OAAO,MAAM;GACtB,MAAM,SAAS,KAAK,GAAG,KAAK,MAAM,GAAG;GACrC,IAAI;GACJ,IAAI;IACF,UAAU,MAAM,KAAK,GAAG,GAAG,QAAQ,EAAE,WAAW,KAAK,CAAC;GACxD,QAAQ;IAGN;GACF;GACA,KAAK,MAAM,OAAO,SAAS;IACzB,MAAM,MAAM,KAAK,GAAG,KAAK,QAAQ,GAAG;IACpC,IAAI,CAAC,UAAU,MAAM,QAAQ,IAAI,SAAS,GAAG,CAAC,GAAG;IACjD,IAAI,SAAS,MAAM,QAAQ,IAAI,SAAS,GAAG,CAAC,GAAG;IAC/C,SAAS,KAAK,GAAG;GACnB;EACF;EAEA,MAAM,kBAA4B,CAAC;EACnC,MAAM,0BAAU,IAAI,IAAY;EAChC,MAAM,+BAAe,IAAI,IAAoB;EAE7C,KAAK,MAAM,QAAQ,UAAU;GAC3B,MAAM,QAAQ,MAAM,KAAK,GAAG,SAAS,IAAI,GAAG,SAAS,MAAM;GAC3D,aAAa,IAAI,MAAM,IAAI;GAC3B,IAAI,CAAC,KAAK,SAAS,iBAAiB,GAAG;GACvC,MAAM,SAAS,QAAQ;GACvB,KAAK,MAAM,KAAK,KAAK,SAAS,kBAAkB,GAC9C,QAAQ,IAAI,EAAE,EAAE;GAElB,IAAI,QAAQ,OAAO,QAAQ,gBAAgB,KAAK,IAAI;EACtD;EAIA,MAAM,gBAAgB,IAAI,IAAI,eAAe;EAC7C,MAAM,cAAwB,CAAC;EAC/B,IAAI,eAAe;EACnB,KAAK,MAAM,CAAC,MAAM,SAAS,cAAc;GACvC,IAAI,cAAc,IAAI,IAAI,GAAG;GAC7B,YAAY,KAAK,IAAI;GACrB;EACF;EACA,MAAM,SAAS,YAAY,KAAK,IAAI;EAEpC,IAAI,aAAa;EACjB,MAAM,SAAmB,CAAC;EAC1B,KAAK,MAAM,OAAO,SAAS;GACzB,IAAI,gBAAgB,MAAM,MAAM,IAAI,WAAW,CAAC,CAAC,GAAG;IAClD;IACA;GACF;GACA,MAAM,UAAU,IAAI,QAAQ,WAAW,MAAM,KAAK,GAAG;GAKrD,IAAI,CAAC,IADU,OAAO,SAAS,QAAQ,OACjC,EAAE,KAAK,MAAM,GAAG,OAAO,KAAK,GAAG;EACvC;EAEA,OAAO;GACL,WAAW,QAAQ;GACnB;GACA;GACA;GACA,QAAQ,OAAO,KAAK;EACtB;CACF;AACF;;;ACzIA,IAAa,cAAb,MAAyB;CACvB,MAAyB,QAAQ;CACjC,UAA6B,OAAO,WAAW;CAC/C,eAAkC,QAAQ,gBAAgB;CAC1D,QAA2B,QAAQ,oBAAoB;CAEvD,iBAA2B;EACzB,OAAO;GACL,MAAM,KAAK,SAAS,QAAQ,CAAC,KAAK;GAClC,iBAAiB,KAAK,SAAS,mBAAmB,CAAC;GACnD,SAAS,KAAK,SAAS,WAAW,CAAC;EACrC;CACF;CAEA,QAA2B,SAAS;EAClC,MAAM;EACN,aAAa;EACb,SAAS,OAAO,EAAE,WAAW;GAC3B,MAAM,OAAO,KAAK,eAAe;GACjC,MAAM,IAAI,KAAK;GAEf,MAAM,SAAS,MAAM,KAAK,aAAa,MAAM;IAAE;IAAM,GAAG;GAAK,CAAC;GAE9D,IAAI,OAAO,cAAc,GAAG;IAC1B,QAAQ,OAAO,MACb,KAAK,EAAE,IAAI,UAAU,MAAM,EAAE,4EAEd,KAAK,KAAK,KAAK,IAAI,EAAE,KACtC;IACA,QAAQ,KAAK,CAAC;GAChB;GAEA,QAAQ,OAAO,MACb,aAAa,EAAE,IAAI,QAAQ,OAAO,OAAO,SAAS,CAAC,EAAE,eAChD,EAAE,IAAI,QAAQ,OAAO,OAAO,YAAY,CAAC,EAAE,UAC1C,OAAO,gBAAgB,OAAO,cAC/B,OAAO,gBAAgB,WAAW,IAAI,SAAS,QAAQ,KAC9D;GACA,IAAI,OAAO,aAAa,GACtB,QAAQ,OAAO,MACb,gCAAgC,OAAO,WAAW,GACpD;GAGF,IAAI,OAAO,OAAO,WAAW,GAAG;IAC9B,QAAQ,OAAO,MACb,KAAK,EAAE,IAAI,SAAS,GAAG,EAAE,sCAC3B;IACA;GACF;GAEA,QAAQ,OAAO,MACb,KAAK,EAAE,IAAI,OAAO,GAAG,EAAE,wBAAwB,OAAO,OAAO,OAAO,KACtE;GACA,KAAK,MAAM,KAAK,OAAO,QACrB,QAAQ,OAAO,MAAM,KAAK,EAAE,IAAI,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG;GAEtD,QAAQ,OAAO,MACb,qEACK,EAAE,IAAI,QAAQ,iBAAiB,EAAE,yDAExC;GACA,QAAQ,KAAK,CAAC;EAChB;CACF,CAAC;CAED,OAAuB,SAAS;EAC9B,MAAM;EACN,aAAa;EACb,UAAU,CAAC,KAAK,KAAK;EACrB,SAAS,OAAO,EAAE,WAAW;GAC3B,KAAK;EACP;CACF,CAAC;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC9CA,MAAa,sBAAsB,QAAQ;CACzC,MAAM;CACN,OAAO,CAAC,WAAW;CACnB,UAAU,CAAC,aAAa,gBAAgB;AAC1C,CAAC;AAED,MAAa,QAAQ,UAAuB,CAAC,MAAM;CACjD,aAAa;EACX,MAAM,EAAE,WAAW,SAAS;EAC5B,OAAO,KAAK,mBAAmB,EAAE,IAAI,aAAa,OAAO;CAC3D;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/cli/i18n/atoms/i18nOptions.ts","../../../src/cli/i18n/services/I18nCheckService.ts","../../../src/cli/i18n/commands/I18nCommand.ts","../../../src/cli/i18n/index.ts"],"sourcesContent":["import { $atom, type Static, z } from \"alepha\";\n\n/**\n * i18n CLI configuration atom.\n *\n * Filled from the `i18n` plugin in `alepha.config.ts`.\n * Read by `I18nCommand` to drive `alepha i18n check`.\n */\nexport const i18nOptions = $atom({\n  name: \"alepha.cli.i18n.options\",\n  description: \"i18n unused-key check configuration\",\n  schema: z\n    .object({\n      /**\n       * Directories (relative to the project root) to scan both for\n       * `$dictionary(...)` declarations and for translation key usage.\n       *\n       * @default [\"src\"]\n       */\n      scan: z.array(z.text()).optional(),\n\n      /**\n       * Key prefixes that are constructed at runtime (e.g. via template\n       * literals like `` tr(`archive.type.${kind}`) ``). Every key\n       * starting with one of these prefixes is exempted from the\n       * unused check.\n       *\n       * Keep this list short and audit it when a feature is removed —\n       * a stale prefix here means dead keys can hide.\n       *\n       * @default []\n       */\n      dynamicPrefixes: z.array(z.text()).optional(),\n\n      /**\n       * Additional path substrings (matched against the full file\n       * path) that should be excluded from the scan, on top of the\n       * defaults (`node_modules`, `dist`, `__tests__`, `.spec.*`,\n       * `.test.*`, `.alepha`).\n       *\n       * @default []\n       */\n      exclude: z.array(z.text()).optional(),\n    })\n    .optional(),\n});\n\n/**\n * Type for i18n options.\n */\nexport type I18nOptions = Static<typeof i18nOptions.schema>;\n","import { $inject } from \"alepha\";\nimport { FileSystemProvider } from \"alepha/system\";\n\n/**\n * File extensions considered when scanning for dictionaries / usage.\n */\nconst SCAN_EXTS = [\".ts\", \".tsx\", \".mts\", \".cts\"];\n\n/**\n * Built-in path substrings that are always excluded from scanning.\n */\nconst DEFAULT_EXCLUDES = [\n  \"/node_modules/\",\n  \"/dist/\",\n  \"/__tests__/\",\n  \"/.alepha/\",\n  \".spec.ts\",\n  \".spec.tsx\",\n  \".test.ts\",\n  \".test.tsx\",\n];\n\n/**\n * Matches a quoted dotted property key on the left-hand side of a\n * dictionary entry: `\"some.dotted.key\":`. The \"at least one dot\"\n * requirement rules out unrelated quoted strings (e.g. JSON literals\n * inside helper text).\n */\nconst KEY_DECLARATION_RE = /\"([\\w-]+(?:\\.[\\w-]+)+)\"\\s*:/g;\n\n/**\n * Heuristic for spotting files that declare a dictionary. Conservative\n * by design — we'd rather scan a few unrelated files than miss a\n * dictionary tucked away in an unusual location.\n */\nconst DICTIONARY_MARKER = \"$dictionary\";\n\n/**\n * Captures the module specifier of a lazily-imported dictionary, i.e. the\n * `\"./fr.ts\"` in `$dictionary({ lazy: () => import(\"./fr.ts\") })`. Apps\n * commonly split each language into its own file so a session only ships the\n * active locale — those key files carry no `$dictionary` marker, so without\n * this the keys would be invisible to the check.\n *\n * `[^{}]*?` keeps the match inside the `$dictionary` call's own object literal\n * (it stops at the first brace), so unrelated lazy imports in the same file —\n * e.g. a sibling `$page({ lazy: () => import(\"./Page.tsx\") })` or a\n * `$dictionary` whose `lazy` returns an inline `({ default: {…} })` object —\n * are never mistaken for dictionary key files.\n */\nconst DICTIONARY_LAZY_IMPORT_RE =\n  /\\$dictionary\\s*\\(\\s*\\{[^{}]*?import\\s*\\(\\s*[\"']([^\"']+)[\"']/g;\n\nexport interface I18nCheckOptions {\n  root: string;\n  scan: string[];\n  dynamicPrefixes: string[];\n  exclude: string[];\n}\n\nexport interface I18nCheckResult {\n  /** Total number of keys discovered across all dictionary files. */\n  totalKeys: number;\n  /** Number of keys exempted via `dynamicPrefixes`. */\n  exemptKeys: number;\n  /** Number of source files scanned for references. */\n  scannedFiles: number;\n  /** Dictionary files that contributed keys. */\n  dictionaryFiles: string[];\n  /** Keys that have no quoted-literal reference anywhere in the scan. */\n  unused: string[];\n}\n\nexport class I18nCheckService {\n  protected readonly fs = $inject(FileSystemProvider);\n\n  /**\n   * Find unused translation keys.\n   *\n   * Discovery is fully static: we walk `scan` dirs, identify files\n   * that import `$dictionary` (matched via the literal substring) plus\n   * any per-language files they lazily `import(...)`, extract every\n   * `\"a.b.c\": ...` property key declared across them, then grep the\n   * remaining source files for a quoted-literal occurrence of each key.\n   * Anything matching a `dynamicPrefixes` entry is exempted.\n   */\n  async check(options: I18nCheckOptions): Promise<I18nCheckResult> {\n    const { root, scan, dynamicPrefixes, exclude } = options;\n    const excludes = [...DEFAULT_EXCLUDES, ...exclude];\n\n    const allFiles: string[] = [];\n    for (const dir of scan) {\n      const absDir = this.fs.join(root, dir);\n      let entries: string[];\n      try {\n        entries = await this.fs.ls(absDir, { recursive: true });\n      } catch {\n        // Missing scan dir is silently skipped — config carries\n        // optional paths (e.g. .vendor/**) that may not exist locally.\n        continue;\n      }\n      for (const rel of entries) {\n        const abs = this.fs.join(absDir, rel);\n        if (!SCAN_EXTS.some((ext) => abs.endsWith(ext))) continue;\n        if (excludes.some((sub) => abs.includes(sub))) continue;\n        allFiles.push(abs);\n      }\n    }\n\n    const fileContents = new Map<string, string>();\n    for (const file of allFiles) {\n      fileContents.set(file, (await this.fs.readFile(file)).toString(\"utf8\"));\n    }\n\n    // A file is a dictionary if it declares `$dictionary` OR it is the target\n    // of a `$dictionary({ lazy: () => import(\"…\") })` (the split per-language\n    // key files, which carry no marker of their own). Resolving the lazy\n    // targets first lets their keys be extracted below and keeps them out of\n    // the usage corpus (their `\"key\": \"value\"` lines aren't references).\n    const dictionarySet = new Set<string>();\n    for (const [file, text] of fileContents) {\n      if (!text.includes(DICTIONARY_MARKER)) continue;\n      dictionarySet.add(file);\n      for (const m of text.matchAll(DICTIONARY_LAZY_IMPORT_RE)) {\n        const target = this.resolveImport(file, m[1], fileContents);\n        if (target) dictionarySet.add(target);\n      }\n    }\n\n    const dictionaryFiles: string[] = [];\n    const allKeys = new Set<string>();\n    for (const file of dictionarySet) {\n      const text = fileContents.get(file);\n      if (!text) continue;\n      const before = allKeys.size;\n      for (const m of text.matchAll(KEY_DECLARATION_RE)) {\n        allKeys.add(m[1]);\n      }\n      if (allKeys.size > before) dictionaryFiles.push(file);\n    }\n\n    // Concatenate every non-dictionary file into one corpus so each\n    // key is tested with a single regex run rather than O(files × keys).\n    const corpusParts: string[] = [];\n    let scannedFiles = 0;\n    for (const [file, text] of fileContents) {\n      if (dictionarySet.has(file)) continue;\n      corpusParts.push(text);\n      scannedFiles++;\n    }\n    const corpus = corpusParts.join(\"\\n\");\n\n    let exemptKeys = 0;\n    const unused: string[] = [];\n    for (const key of allKeys) {\n      if (dynamicPrefixes.some((p) => key.startsWith(p))) {\n        exemptKeys++;\n        continue;\n      }\n      const literal = key.replace(/[.\\\\]/g, (c) => `\\\\${c}`);\n      // Key must appear as a quoted string literal — `\"...\"`, `'...'`,\n      // or `` `...` ``. Quotes on both sides rule out accidental\n      // substring hits in longer keys.\n      const re = new RegExp(`[\"'\\`]${literal}[\"'\\`]`);\n      if (!re.test(corpus)) unused.push(key);\n    }\n\n    return {\n      totalKeys: allKeys.size,\n      exemptKeys,\n      scannedFiles,\n      dictionaryFiles,\n      unused: unused.sort(),\n    };\n  }\n\n  /**\n   * Resolve a relative `import(\"…\")` specifier from `fromFile` to an absolute\n   * path that was actually scanned. Returns `undefined` for bare/package\n   * specifiers or targets outside the scan set. Extensionless specifiers are\n   * probed against each supported source extension.\n   */\n  protected resolveImport(\n    fromFile: string,\n    spec: string,\n    files: Map<string, string>,\n  ): string | undefined {\n    if (!spec.startsWith(\".\")) return undefined;\n    // `join(file, \"..\", spec)` drops the filename then applies the relative\n    // specifier — i.e. resolves against `fromFile`'s directory.\n    const base = this.fs.join(fromFile, \"..\", spec);\n    if (files.has(base)) return base;\n    for (const ext of SCAN_EXTS) {\n      if (files.has(base + ext)) return base + ext;\n    }\n    return undefined;\n  }\n}\n","import { $inject, $state } from \"alepha\";\nimport { $command } from \"alepha/command\";\nimport { $logger, ConsoleColorProvider } from \"alepha/logger\";\nimport { i18nOptions } from \"../atoms/i18nOptions.ts\";\nimport { I18nCheckService } from \"../services/I18nCheckService.ts\";\n\nexport class I18nCommand {\n  protected readonly log = $logger();\n  protected readonly options = $state(i18nOptions);\n  protected readonly checkService = $inject(I18nCheckService);\n  protected readonly color = $inject(ConsoleColorProvider);\n\n  protected resolveOptions() {\n    return {\n      scan: this.options?.scan ?? [\"src\"],\n      dynamicPrefixes: this.options?.dynamicPrefixes ?? [],\n      exclude: this.options?.exclude ?? [],\n    };\n  }\n\n  protected readonly check = $command({\n    name: \"check\",\n    description: \"Report translation keys with no quoted-literal reference\",\n    handler: async ({ root }) => {\n      const opts = this.resolveOptions();\n      const c = this.color;\n\n      const result = await this.checkService.check({ root, ...opts });\n\n      if (result.totalKeys === 0) {\n        process.stdout.write(\n          `\\n${c.set(\"ORANGE\", \"warn\")} No translation keys found. ` +\n            `Did the dictionary location change? ` +\n            `Searched: ${opts.scan.join(\", \")}\\n\\n`,\n        );\n        process.exit(2);\n      }\n\n      process.stdout.write(\n        `\\nChecked ${c.set(\"CYAN\", String(result.totalKeys))} keys across ` +\n          `${c.set(\"CYAN\", String(result.scannedFiles))} files ` +\n          `(${result.dictionaryFiles.length} dictionary ` +\n          `${result.dictionaryFiles.length === 1 ? \"file\" : \"files\"}).\\n`,\n      );\n      if (result.exemptKeys > 0) {\n        process.stdout.write(\n          `  exempt (dynamic prefixes): ${result.exemptKeys}\\n`,\n        );\n      }\n\n      if (result.unused.length === 0) {\n        process.stdout.write(\n          `\\n${c.set(\"GREEN\", \"✓\")} All translations are referenced.\\n\\n`,\n        );\n        return;\n      }\n\n      process.stdout.write(\n        `\\n${c.set(\"RED\", \"✗\")} Unused translations (${result.unused.length}):\\n`,\n      );\n      for (const k of result.unused) {\n        process.stdout.write(`  ${c.set(\"DIM\", \"-\")} ${k}\\n`);\n      }\n      process.stdout.write(\n        `\\nEither delete the key from its dictionary, or add its prefix to ` +\n          `${c.set(\"CYAN\", \"dynamicPrefixes\")} in alepha.config.ts ` +\n          `if it's constructed at runtime.\\n\\n`,\n      );\n      process.exit(1);\n    },\n  });\n\n  public readonly i18n = $command({\n    name: \"i18n\",\n    description: \"Internationalization tooling\",\n    children: [this.check],\n    handler: async ({ help }) => {\n      help();\n    },\n  });\n}\n","import { $context, $module } from \"alepha\";\nimport { type I18nOptions, i18nOptions } from \"./atoms/i18nOptions.ts\";\nimport { I18nCommand } from \"./commands/I18nCommand.ts\";\nimport { I18nCheckService } from \"./services/I18nCheckService.ts\";\n\n// ---------------------------------------------------------------------------\n\n/**\n * CLI plugin for finding unused translation keys.\n *\n * Statically scans the project for `$dictionary(...)` calls, extracts\n * every declared key, and reports the ones that have no quoted-literal\n * reference anywhere else in the source tree. Designed to be wired\n * into `yarn v` (or any verify pipeline) so dead i18n entries can't\n * pile up unnoticed when a feature is removed.\n *\n * Commands:\n * - `alepha i18n check` — report unused translation keys\n *\n * Configuration in `alepha.config.ts`:\n *\n * ```typescript\n * import { i18n } from \"alepha/cli/i18n\";\n *\n * export default defineConfig({\n *   plugins: [\n *     i18n({\n *       scan: [\"src\", \".vendor/@alepha/ui\"],\n *       dynamicPrefixes: [\"archive.type.\", \"petitions.filter.\"],\n *     }),\n *   ],\n * });\n * ```\n */\nexport const AlephaCliI18nPlugin = $module({\n  name: \"alepha.cli.plugins.i18n\",\n  atoms: [i18nOptions],\n  services: [I18nCommand, I18nCheckService],\n});\n\nexport const i18n = (options: I18nOptions = {}) => {\n  return () => {\n    const { alepha } = $context();\n    alepha.with(AlephaCliI18nPlugin).set(i18nOptions, options);\n  };\n};\n\n// ---------------------------------------------------------------------------\n\nexport * from \"./atoms/i18nOptions.ts\";\nexport * from \"./commands/I18nCommand.ts\";\nexport * from \"./services/I18nCheckService.ts\";\n"],"mappings":"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"}