nuxt-i18n-micro 3.30.2 → 4.0.0

package/dist/runtime/utils/storage.d.ts

@@ -3,41 +3,53 @@ export interface LoadOptions {
     apiBaseUrl: string;
     baseURL: string;
     apiBaseClientHost?: string;
-    apiBaseServerHost?: string;
     dateBuild?: string | number;
     routesLocaleLinks?: Record<string, string>;
-}
-export interface LoadResult {
-    data: Record<string, unknown>;
-    cacheKey: string;
+    /** A page's file needs its root, so the two start together. A delta from a host still finds its root without it. */
+    rootDelta?: boolean;
+    /**
+     * Server only: the Nitro loader of this request (`event.context.i18n.load`), called directly. It reads a host too, named at
+     * build time or in the environment, so a render has one source. `null` is a host's "no such file", as a 404 is for a browser.
+     */
+    serverLoad?: (locale: string, routeName: string) => Promise<Record<string, unknown> | null>;
 }
 declare class TranslationStorage {
     private cc;
+    /** Roots on their way: every page of a first burst waits for one request. */
+    private readonly rootLoads;
+    /** The mark of each root held, to tell a delta made against another one. */
+    private readonly rootMarks;
     constructor();
     /**
-     * Configure cache limits. Call once from plugin with config values.
+     * Configure cache limits: the plugin's config values, on every request on the server, where this copy is process-wide.
      */
     configure(options: CacheControlOptions): void;
     /**
-     * Freeze a shallow copy before it enters the cache so a consumer cannot mutate
-     * what other callers will read. Nested values are shared on purpose — cheap, and
-     * no caller mutates a chunk in place.
+     * On the server the cache is shared by every request, so its root is frozen, once, in place: nested values are shared
+     * on purpose, and no caller mutates a chunk. A browser fetched this object for itself and has one reader: nothing to guard.
      */
-    private freezeChunk;
-    private getCacheKey;
+    private shared;
     private fetchTranslations;
-    /** Seed cache without fetching (e.g. `serverTranslationPreload` for index). */
-    seed(locale: string, routeName: string | undefined, data: Record<string, unknown>): void;
     /**
-     * Synchronous cache check and retrieval.
-     * Returns data if cached (and not expired), otherwise null.
+     * A chunk, or `null` when the host has no file for it: a 404, a server loader's `null`, or a static host's SPA shell
+     * in a page's place. Anything else is a failed load, and the next try can work. A `null` body is one of those: a
+     * dictionary it is not, and read as "no file" on the root it would be kept as an empty one until a reload.
      */
-    getFromCache(locale: string, routeName?: string): LoadResult | null;
+    private fetchChunk;
+    private request;
+    /** The URL the browser fetches a chunk from: what SSR preloads for the first page. */
+    clientUrl(locale: string, routeName: string | undefined, options: LoadOptions): string;
+    /** The cached chunk (not expired), or null. */
+    getFromCache(locale: string, routeName?: string): Record<string, unknown> | null;
+    /** Load a chunk, with caching. */
+    load(locale: string, routeName: string | undefined, options: LoadOptions): Promise<Record<string, unknown>>;
+    private loadRoot;
     /**
-     * Load translations (with caching).
-     * Returns data, cache key, and JSON for injection (server only).
+     * A delta on the root it was made against. A root held since an older deploy lacks what moved into it, so a stale tab
+     * asks for the delta's: `?v=` of the mark, a URL no cache holds. One try, whatever comes: a CDN mid-deploy may have
+     * neither side new yet, and the root it gives is still the best text there is. Both arrive before anything is shown.
      */
-    load(locale: string, routeName: string | undefined, options: LoadOptions): Promise<LoadResult>;
+    private layered;
     /**
      * Clear cache and metadata.
      */

package/dist/runtime/utils/storage.js

@@ -1,95 +1,146 @@
+import { joinURL, withQuery } from "ufo";
 import { translationCacheKey } from "@i18n-micro/core/helpers";
-import { STORAGE_CC_KEY } from "@i18n-micro/hmr/cache-keys";
+import { STORAGE_CC_KEY } from "./cache-keys.js";
+import { takeRootMark } from "./translation-entry.js";
 import { CacheControl } from "@i18n-micro/utils/cache-control";
+import { mergeOverRoot, PREMERGED_ROOT_PAGE } from "@i18n-micro/utils/merge-source";
 import { buildTranslationPayloadFetchRequest } from "@i18n-micro/utils/payload-url";
+const NO_ROOT = Object.freeze({});
+const NO_FILE = Object.freeze({});
+class ChunkCache extends CacheControl {
+  /** A response requested before a clear may predate the edit the clear is for. */
+  clears = 0;
+  clear() {
+    this.clears++;
+    super.clear();
+  }
+}
 function getStorageCacheControl() {
   const g = globalThis;
   if (!g[STORAGE_CC_KEY]) {
-    g[STORAGE_CC_KEY] = new CacheControl();
+    g[STORAGE_CC_KEY] = new ChunkCache();
   }
   return g[STORAGE_CC_KEY];
 }
 class TranslationStorage {
   cc;
+  /** Roots on their way: every page of a first burst waits for one request. */
+  rootLoads = /* @__PURE__ */ new Map();
+  /** The mark of each root held, to tell a delta made against another one. */
+  rootMarks = /* @__PURE__ */ new Map();
   constructor() {
     this.cc = getStorageCacheControl();
   }
   /**
-   * Configure cache limits. Call once from plugin with config values.
+   * Configure cache limits: the plugin's config values, on every request on the server, where this copy is process-wide.
    */
   configure(options) {
     this.cc.configure(options);
   }
-  // ==========================================================================
-  // HELPERS
-  // ==========================================================================
   /**
-   * Freeze a shallow copy before it enters the cache so a consumer cannot mutate
-   * what other callers will read. Nested values are shared on purpose — cheap, and
-   * no caller mutates a chunk in place.
+   * On the server the cache is shared by every request, so its root is frozen, once, in place: nested values are shared
+   * on purpose, and no caller mutates a chunk. A browser fetched this object for itself and has one reader: nothing to guard.
    */
-  freezeChunk(data) {
-    return Object.freeze({ ...data });
-  }
-  getCacheKey(locale, routeName) {
-    return translationCacheKey(locale, routeName);
+  shared(data) {
+    return import.meta.server ? Object.freeze(data) : data;
   }
-  // ==========================================================================
-  // FETCH LOADER
-  // ==========================================================================
   async fetchTranslations(locale, routeName, options) {
-    const request = buildTranslationPayloadFetchRequest({
+    if (import.meta.server && options.serverLoad) return await options.serverLoad(locale, routeName ?? "");
+    const request = this.request(locale, routeName, options, import.meta.server);
+    return await $fetch(request.path, {
+      baseURL: request.baseURL,
+      params: request.params,
+      // after a clear a browser's copy may be what the clear is for: `max-age` would answer with it
+      cache: import.meta.client && this.cc.clears ? "no-cache" : void 0
+    });
+  }
+  /**
+   * A chunk, or `null` when the host has no file for it: a 404, a server loader's `null`, or a static host's SPA shell
+   * in a page's place. Anything else is a failed load, and the next try can work. A `null` body is one of those: a
+   * dictionary it is not, and read as "no file" on the root it would be kept as an empty one until a reload.
+   */
+  async fetchChunk(locale, routeName, options) {
+    const data = await this.fetchTranslations(locale, routeName, options).catch((error) => {
+      if (error.status === 404) return NO_FILE;
+      throw error;
+    });
+    if (data === NO_FILE || data === null && import.meta.server && options.serverLoad) return null;
+    if (data !== null && typeof data === "object" && !Array.isArray(data)) return data;
+    if (routeName !== PREMERGED_ROOT_PAGE) return null;
+    throw new TypeError(`[i18n] Invalid translation payload: ${translationCacheKey(locale, routeName)}`);
+  }
+  request(locale, routeName, options, isServer) {
+    return buildTranslationPayloadFetchRequest({
       apiBaseUrl: options.apiBaseUrl,
       routeName,
       locale,
-      isServer: import.meta.server,
+      isServer,
       baseURL: options.baseURL,
       apiBaseClientHost: options.apiBaseClientHost,
-      apiBaseServerHost: options.apiBaseServerHost ?? (import.meta.server ? process.env.NUXT_I18N_APP_BASE_SERVER_HOST : void 0),
       dateBuild: options.dateBuild,
       routesLocaleLinks: options.routesLocaleLinks
     });
-    return await $fetch(request.path, {
-      baseURL: request.baseURL,
-      params: request.params
-    });
   }
-  /** Seed cache without fetching (e.g. `serverTranslationPreload` for index). */
-  seed(locale, routeName, data) {
-    const cacheKey = this.getCacheKey(locale, routeName);
-    this.cc.set(cacheKey, this.freezeChunk(data));
+  /** The URL the browser fetches a chunk from: what SSR preloads for the first page. */
+  clientUrl(locale, routeName, options) {
+    const request = this.request(locale, routeName, options, false);
+    return withQuery(joinURL(request.baseURL, request.path), request.params ?? {});
   }
-  // ==========================================================================
-  // PUBLIC API
-  // ==========================================================================
-  /**
-   * Synchronous cache check and retrieval.
-   * Returns data if cached (and not expired), otherwise null.
-   */
+  /** The cached chunk (not expired), or null. */
   getFromCache(locale, routeName) {
-    const cacheKey = this.getCacheKey(locale, routeName);
-    const cached = this.cc.get(cacheKey);
-    if (cached) {
-      return { data: cached, cacheKey };
+    return this.cc.get(translationCacheKey(locale, routeName)) ?? null;
+  }
+  /** Load a chunk, with caching. */
+  async load(locale, routeName, options) {
+    const direct = import.meta.server && Boolean(options.serverLoad);
+    const cached = direct ? null : this.getFromCache(locale, routeName);
+    if (cached) return cached;
+    const clears = this.cc.clears;
+    const page = routeName !== PREMERGED_ROOT_PAGE;
+    const root = page && options.rootDelta && !direct ? this.loadRoot(locale, options) : void 0;
+    root?.catch(() => {
+    });
+    const file = await this.fetchChunk(locale, routeName, options);
+    const mark = file ? takeRootMark(file) : void 0;
+    const layers = file && mark && page ? await this.layered(locale, mark, file, root, options) : null;
+    const data = layers ? layers.data : file;
+    if (clears !== this.cc.clears) return this.load(locale, routeName, options);
+    if (!page) this.rootMarks.set(locale, mark);
+    if (data === null && routeName === PREMERGED_ROOT_PAGE) {
+      if (import.meta.server && import.meta.prerender) throw new Error("[i18n] The host has no dictionary for this page");
+      return NO_ROOT;
     }
-    return null;
+    if (data === null) return this.load(locale, PREMERGED_ROOT_PAGE, options);
+    if (!direct && !layers?.partial) this.cc.set(translationCacheKey(locale, routeName), this.shared(data));
+    return data;
+  }
+  loadRoot(locale, options) {
+    const pending = this.rootLoads.get(locale);
+    if (pending) return pending;
+    const load = this.load(locale, PREMERGED_ROOT_PAGE, options).finally(() => this.rootLoads.delete(locale));
+    this.rootLoads.set(locale, load);
+    return load;
   }
   /**
-   * Load translations (with caching).
-   * Returns data, cache key, and JSON for injection (server only).
+   * A delta on the root it was made against. A root held since an older deploy lacks what moved into it, so a stale tab
+   * asks for the delta's: `?v=` of the mark, a URL no cache holds. One try, whatever comes: a CDN mid-deploy may have
+   * neither side new yet, and the root it gives is still the best text there is. Both arrive before anything is shown.
    */
-  async load(locale, routeName, options) {
-    const cached = this.getFromCache(locale, routeName);
-    if (cached) return cached;
-    const cacheKey = this.getCacheKey(locale, routeName);
-    const data = await this.fetchTranslations(locale, routeName, options);
-    this.cc.set(cacheKey, this.freezeChunk(data));
-    return { data: this.cc.get(cacheKey), cacheKey };
+  async layered(locale, mark, delta, started, options) {
+    let root = await (started ?? this.loadRoot(locale, options));
+    const held = this.rootMarks.get(locale);
+    if (held && held !== mark) {
+      this.cc.delete(translationCacheKey(locale, PREMERGED_ROOT_PAGE));
+      root = await this.load(locale, PREMERGED_ROOT_PAGE, { ...options, dateBuild: mark });
+    }
+    return { data: mergeOverRoot(root, delta), partial: root === NO_ROOT };
   }
   /**
    * Clear cache and metadata.
    */
   clear() {
+    this.rootLoads.clear();
+    this.rootMarks.clear();
     this.cc.clear();
   }
 }

package/dist/runtime/utils/translation-entry.d.ts

@@ -0,0 +1,6 @@
+import type { Translations } from '@i18n-micro/types';
+import type { ServerTranslationCacheEntry } from '../server/internal/server-translation-cache.js';
+/** `json` on demand: where the public dir answers `/_locales` the string would only hold memory (a chunk's size, per cached entry). */
+export declare function toEntry(data: Translations): ServerTranslationCacheEntry;
+/** The root mark of a file just read, taken off it: nothing above the loader sees one. `undefined`: a whole chunk. */
+export declare function takeRootMark(file: Record<string, unknown>): string | undefined;

package/dist/runtime/utils/translation-entry.js

@@ -0,0 +1,16 @@
+import { PREMERGED_ROOT_MARK } from "@i18n-micro/utils/merge-source";
+export function toEntry(data) {
+  let json;
+  return {
+    // every request reads this tree: its root is frozen, once, in place
+    data: Object.freeze(data),
+    get json() {
+      return json ??= JSON.stringify(data).replaceAll("<", "\\u003c");
+    }
+  };
+}
+export function takeRootMark(file) {
+  const mark = file[PREMERGED_ROOT_MARK];
+  delete file[PREMERGED_ROOT_MARK];
+  return typeof mark === "string" ? mark : void 0;
+}

package/dist/types.d.mts

@@ -1,15 +1,13 @@
-import type { ModuleHooks } from './module.mjs'
+import type { ModuleRuntimeHooks } from './module.mjs'
 
-declare module '@nuxt/schema' {
-  interface NuxtHooks extends ModuleHooks {}
+declare module '#app' {
+  interface RuntimeNuxtHooks extends ModuleRuntimeHooks {}
 }
 
 export { type Getter, type GlobalLocaleRoutes, type Locale, type LocaleCode, type ModuleOptions, type PluralFunc, type Strategies } from '@i18n-micro/types'
 
 export { type PluginsInjections } from '../dist/runtime/plugins/01.plugin.js'
 
-export { type TranslationPayloadMode, type resolveTranslationPayloadMode, type resolveTranslationPayloadOptions, type resolveTranslationPayloadPublicDir, type resolveTranslationPayloadPublicRel, type shouldCopyTranslationPayloadsToPublic, type shouldRegisterNitroServerAssets } from '@i18n-micro/utils/payload-config'
-
 export { default } from './module.mjs'
 
-export { type ModuleHooks } from './module.mjs'
+export { type ModuleRuntimeHooks, type TranslationPayloadMode } from './module.mjs'

package/internals.d.mts

@@ -1,3 +1,5 @@
+import type { Getter, Params } from '@i18n-micro/types'
+
 declare module '#build/i18n.plural.mjs' {
   export function plural(key: string, count: number, params: Params, locale: string, getter: Getter): string | null
 }
@@ -17,6 +19,8 @@ interface I18nPrivateConfig {
   customRegexMatcher?: string
   routesLocaleLinks?: Record<string, string>
   serverTranslationPreload?: boolean
+  cacheStorage?: string
+  cacheStorageBuild?: string
   /** Absolute buildDir payload dir for Node fs reads in dev/prerender. */
   payloadFsDir: string
   /** Relative dir under Nitro `public/` for prod payload files. */
@@ -63,8 +67,8 @@ export interface I18nStrategyInstance {
   getRedirect(currentPath: string, targetLocale: string): string | null
   getLocaleFromPath(path: string): string | null
   resolveLocaleFromPath(path: string): string | null
-  localeRoute(targetLocale: string, routeOrPath: I18nStrategyResolvedRoute | string, currentRoute?: I18nStrategyResolvedRoute): I18nStrategyResolvedRoute | string
-  switchLocaleRoute(fromLocale: string, toLocale: string, route: I18nStrategyResolvedRoute, options?: { i18nRouteParams?: Record<string, Record<string, unknown>> }): I18nStrategyResolvedRoute | string
+  localeRoute(targetLocale: string, routeOrPath: I18nStrategyResolvedRoute | string): I18nStrategyResolvedRoute | string
+  switchLocaleRoute(toLocale: string, route: I18nStrategyResolvedRoute, options?: { i18nRouteParams?: Record<string, Record<string, unknown>>, named?: boolean }): I18nStrategyResolvedRoute | string
   getCanonicalPath(route: I18nStrategyResolvedRoute, targetLocale: string): string | null
   setRouter(router: I18nStrategyRouterLike): void
   getCurrentLocale(route: I18nStrategyResolvedRoute, getDefaultLocale?: () => string | null | undefined): string
@@ -87,6 +91,7 @@ interface I18nStrategyRouterLike {
 }
 
 declare module '#build/i18n.strategy.mjs' {
+  export const domains: boolean
   /** Создаёт инстанс стратегии: контекст (build-time) уже в файле, при импорте передаётся только router. */
   export function createI18nStrategy(router: I18nStrategyRouterLike): I18nStrategyInstance
   export function getI18nConfig(): unknown
@@ -98,10 +103,12 @@ declare module '#i18n-internal/config' {
 }
 
 declare module '#i18n-internal/strategy' {
+  export const domains: boolean
   export function getI18nConfig(): unknown
   export function createI18nStrategy(router: I18nStrategyRouterLike): I18nStrategyInstance
 }
 
 declare module '#i18n-internal/payload-source' {
+  export const embeddedPayloads: boolean
   export function readPayload(relPath: string): Promise<Record<string, unknown>>
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-i18n-micro",
-  "version": "3.30.2",
+  "version": "4.0.0",
   "description": "Fast, lightweight i18n for Nuxt with strategy-based routing and minimal overhead.",
   "keywords": [
     "i18n",
@@ -24,13 +24,10 @@
     "email": "Virus191288@gmail.com",
     "url": "https://s00d.github.io/"
   },
-  "repository": "s00d/nuxt-i18n-micro",
-  "workspaces": [
-    "client",
-    "docs",
-    "packages/**",
-    "test/fixtures/**/*"
-  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/s00d/nuxt-i18n-micro.git"
+  },
   "files": [
     "dist",
     "internals.d.mts"
@@ -74,53 +71,58 @@
   },
   "dependencies": {
     "@nuxt/devtools-kit": "^3.4.2",
-    "@nuxt/kit": "^3.18.1 || ^4.5.2",
-    "@vue/compiler-sfc": "^3.5.43",
+    "@nuxt/kit": "^3.18.0 || ^4.0.0",
+    "@vue/compiler-sfc": "^3.5.44",
     "chokidar": "^5.0.0",
     "globby": "^16.2.4",
     "h3": "^1.15.11",
     "sirv": "^3.0.2",
     "ufo": "^1.6.4",
-    "unplugin": "^1.16.1 || ^2.0.0 || ^3.4.0",
-    "@i18n-micro/core": "^1.3.22",
-    "@i18n-micro/path-strategy": "^1.3.22",
-    "@i18n-micro/hmr": "^1.0.20",
-    "@i18n-micro/route-strategy": "^1.1.30",
-    "@i18n-micro/test-utils": "^1.2.19",
-    "@i18n-micro/types": "^1.2.18",
-    "@i18n-micro/utils": "^1.0.27"
+    "@i18n-micro/path-strategy": "^2.0.0",
+    "@i18n-micro/route-strategy": "^2.0.0",
+    "@i18n-micro/types": "^2.0.0",
+    "@i18n-micro/utils": "^2.0.0",
+    "@i18n-micro/core": "^2.0.0"
   },
   "devDependencies": {
     "@nuxt/devtools": "^3.4.2",
     "@nuxt/devtools-ui-kit": "^3.4.2",
     "@nuxt/module-builder": "^1.0.3",
-    "@nuxt/schema": "^3.18.1 || ^4.5.2",
-    "@nuxt/test-utils": "^4.3.2",
-    "@playwright/test": "^1.63.0",
+    "@nuxt/schema": "^3.18.0 || ^4.0.0",
+    "@nuxt/test-utils": "^4.3.4",
+    "@playwright/test": "^1.64.1",
+    "@stryker-mutator/core": "^10.1.1",
+    "@stryker-mutator/vitest-runner": "^10.1.1",
     "@types/node": "^22.19.0",
-    "@untestutils/nuxt": "^0.7.1",
-    "@untestutils/perf": "^0.7.1",
+    "@untestutils/nuxt": "^0.8.1",
+    "@untestutils/perf": "^0.8.1",
     "@vue/devtools-api": "^8.1.5",
     "changelogen": "^0.6.2",
-    "oxfmt": "^0.70.0",
-    "oxlint": "^1.85.0",
+    "fast-check": "^4.10.2",
+    "oxfmt": "^0.76.0",
+    "oxlint": "^1.90.0",
     "typescript": "6.0.3",
-    "untestutils": "^0.7.1",
-    "vitest": "^5.0.2",
-    "vue-tsc": "^3.3.11"
+    "untestutils": "^0.8.1",
+    "vitest": "^5.1.0",
+    "vue-tsc": "^3.3.14"
   },
   "peerDependencies": {
     "@vue/devtools-api": "^8.1.5",
-    "vue-router": "^4.6.3 || ^5.0.0"
+    "vue-router": "^4.5.1 || ^5.0.0"
   },
   "peerDependenciesMeta": {
     "@vue/devtools-api": {
       "optional": true
     }
   },
-  "optionalDependencies": {
-    "@rollup/rollup-linux-x64-gnu": "^4.63.5",
-    "@rollup/rollup-win32-x64-msvc": "^4.63.5"
+  "engines": {
+    "node": ">=20"
+  },
+  "devEngines": {
+    "packageManager": {
+      "name": "pnpm",
+      "onFail": "warn"
+    }
   },
   "stackblitz": {
     "startCommand": "pnpm install && pnpm --filter \"./packages/*\" run build && pnpm run dev:prepare && pnpm run dev",
@@ -129,70 +131,67 @@
     }
   },
   "scripts": {
-    "preinstall": "node -e \"const{existsSync}=require('fs');if(!existsSync('pnpm-workspace.yaml'))process.exit(0);const ua=process.env.npm_config_user_agent||'';if(!ua.includes('pnpm')){console.error('This repo requires pnpm (npm/yarn corrupt the TypeScript hoist). Use: pnpm install');process.exit(1)}\"",
     "dev": "nuxi dev playground",
     "dev:build": "nuxi build playground",
-    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxi prepare playground",
     "dev:generate": "nuxi generate playground",
-    "release": "pnpm run release:check && pnpm run release:patch",
-    "release:check": "pnpm run format && pnpm run lint && pnpm run typecheck && pnpm run check:versions -- --npm && pnpm run release:source && pnpm run compare:published && pnpm run test",
-    "release:auth": "pnpm -C scripts cli ensure-npm-auth",
-    "release:source": "pnpm -C scripts cli ensure-release-source",
-    "release:patch": "pnpm run release:auth && pnpm run prepack && pnpm -C scripts cli release --bump patch && pnpm publish -r && git push --follow-tags",
-    "release:minor": "pnpm run release:auth && pnpm run prepack && pnpm -C scripts cli release --bump minor && pnpm publish -r && git push --follow-tags",
-    "release:major": "pnpm run release:auth && pnpm run prepack && pnpm -C scripts cli release --bump major && pnpm publish -r && git push --follow-tags",
-    "lint": "oxlint src packages test client playground scripts/src build.config.ts",
-    "lint:fix": "oxlint src packages test client playground scripts/src build.config.ts --fix",
-    "format": "oxfmt --write src packages test client playground scripts/src build.config.ts",
-    "format:check": "oxfmt --check src packages test client playground scripts/src build.config.ts",
+    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxi prepare playground",
+    "bench": "node playground/bench/matrix.mjs",
+    "client:build": "nuxi generate client",
+    "client:dev": "nuxi dev client --port 3300",
+    "build:packages": "pnpm --filter \"./packages/*\" run build",
+    "lint": "oxlint src packages test client playground scripts/src build.config.ts docs/app docs/server docs/nuxt.config.ts docs/content.config.ts docs/redirects.ts docs/preview.mjs",
+    "lint:fix": "oxlint src packages test client playground scripts/src build.config.ts docs/app docs/server docs/nuxt.config.ts docs/content.config.ts docs/redirects.ts docs/preview.mjs --fix",
+    "format": "oxfmt --write src packages test client playground scripts/src build.config.ts docs/app docs/server docs/nuxt.config.ts docs/content.config.ts docs/redirects.ts docs/preview.mjs",
+    "format:check": "oxfmt --check src packages test client playground scripts/src build.config.ts docs/app docs/server docs/nuxt.config.ts docs/content.config.ts docs/redirects.ts docs/preview.mjs",
+    "typecheck": "pnpm run typecheck:root && pnpm run typecheck:playground && pnpm run typecheck:scripts && pnpm run typecheck:packages && pnpm run typecheck:package-playgrounds",
+    "typecheck:root": "vue-tsc --noEmit -p tsconfig.nuxt.json",
+    "typecheck:playground": "vue-tsc --noEmit -p playground/tsconfig.json",
+    "typecheck:scripts": "pnpm -C scripts typecheck",
+    "typecheck:packages": "pnpm --filter \"./packages/**\" --filter \"!./packages/*/playground\" run typecheck",
+    "typecheck:package-playgrounds": "pnpm --filter \"./packages/*/playground\" run typecheck",
     "test": "vitest run",
+    "test:watch": "vitest watch --config vitest.unit.config.ts",
     "test:unit": "vitest run --config vitest.unit.config.ts",
+    "test:unit:types": "vitest run --config vitest.unit.config.ts --typecheck.only",
     "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:strategies": "vitest run --config vitest.integration.config.ts test/strategies-",
     "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "test:e2e:browsers": "rc=0; for b in chromium firefox webkit; do echo \"== $b\"; E2E_BROWSER=$b vitest run --config vitest.e2e.config.ts || rc=1; done; exit $rc",
     "test:packages": "vitest run --config vitest.packages.config.ts",
+    "test:dist:packages": "pnpm --filter \"./packages/*\" run --if-present test:dist",
+    "test:presets": "pnpm -C scripts cli preset-smoke --preset all",
     "test:performance": "pnpm -C scripts cli performance",
-    "test:strategies": "vitest run --config vitest.integration.config.ts test/strategies-",
-    "test:watch": "vitest watch --config vitest.unit.config.ts",
-    "test:types": "pnpm run typecheck",
-    "typecheck:root": "vue-tsc --noEmit -p tsconfig.nuxt.json",
-    "typecheck:playground": "vue-tsc --noEmit -p playground/tsconfig.json",
-    "typecheck:scripts": "pnpm -C scripts typecheck",
-    "typecheck:packages": "pnpm --filter \"./packages/**\" --filter \"!./packages/*/playground\" run typecheck",
-    "typecheck:package-playgrounds": "pnpm --filter \"./packages/*/playground\" run typecheck",
-    "typecheck": "pnpm run typecheck:root && pnpm run typecheck:playground && pnpm run typecheck:scripts && pnpm run typecheck:packages && pnpm run typecheck:package-playgrounds",
-    "build:packages": "pnpm --filter \"./packages/*\" run build",
-    "client:build": "nuxi generate client",
-    "client:prepare": "nuxi client:prepare client",
-    "client:dev": "nuxi dev client --port 3300",
-    "clean": "find . \\( -name 'node_modules' -o -name '.nuxt' -o -name '.output' -o -name 'dist' \\) -type d -prune -exec rm -rf '{}' + && find . \\( -name 'pnpm-lock.yaml' -o -name 'package-lock.json' \\) -type f -exec rm -f '{}' +",
-    "clean:test": "rm -rf test/.fixture-builds test/.untestutils && find test/fixtures -type d \\( -name '.nuxt' -o -name '.output-shared' -o -name '.nuxt-test' -o -name 'test-results' \\) -prune -exec rm -rf '{}' + 2>/dev/null || true",
-    "check:versions": "pnpm -C scripts cli check-versions",
-    "verify:packages": "pnpm -C scripts cli verify-packages",
-    "verify:packages:publint": "pnpm -C scripts cli verify-packages --publint",
-    "compare:published": "pnpm -C scripts cli compare-published",
-    "test:dist:packages": "pnpm --filter \"@i18n-micro/core\" --filter \"@i18n-micro/utils\" --filter \"@i18n-micro/hmr\" --filter \"@i18n-micro/vue\" --filter \"@i18n-micro/path-strategy\" --filter \"@i18n-micro/route-strategy\" --filter \"@i18n-micro/devtools-ui\" --filter \"@i18n-micro/astro\" run test:dist",
-    "typecheck:nuxt": "nuxt typecheck --no-emit",
+    "test:mutation": "stryker run stryker.config.mjs",
+    "test:fuzz": "pnpm -C scripts cli http-fuzz",
     "docs:dev": "pnpm --filter @i18n-micro/docs dev",
-    "docs:build": "pnpm --filter @i18n-micro/docs build",
-    "docs:serve": "pnpm --filter @i18n-micro/docs preview",
     "docs:clean-dev": "pnpm --filter @i18n-micro/docs clean-dev",
+    "docs:build": "pnpm --filter @i18n-micro/docs build",
     "docs:preview": "pnpm --filter @i18n-micro/docs preview",
-    "smoke:pack": "pnpm -C scripts cli smoke-pack",
-    "smoke:verify": "pnpm -C scripts cli smoke-verify",
-    "smoke:browser": "pnpm -C scripts cli smoke-browser",
-    "test:presets": "pnpm -C scripts cli preset-smoke --preset all",
-    "test:presets:vercel": "pnpm -C scripts cli preset-smoke --preset vercel",
-    "test:presets:cloudflare": "pnpm -C scripts cli preset-smoke --preset cloudflare_pages",
-    "test:presets:netlify": "pnpm -C scripts cli preset-smoke --preset netlify",
+    "docs:generate": "pnpm -C scripts cli docs-generate",
+    "docs:generate:check": "pnpm -C scripts cli docs-generate --check",
+    "api:surface": "pnpm -C scripts cli api-surface",
+    "api:surface:update": "pnpm -C scripts cli api-surface --update",
     "audit:deps": "pnpm -C scripts cli deps-audit",
     "audit:docs": "pnpm -C scripts cli docs-audit",
     "audit:fixtures": "pnpm -C scripts cli fixtures-audit",
-    "api:surface": "pnpm -C scripts cli api-surface",
-    "api:surface:update": "pnpm -C scripts cli api-surface --update",
     "budget:payload": "pnpm -C scripts cli payload-budget",
     "budget:payload:update": "pnpm -C scripts cli payload-budget --update",
+    "clean": "find . -path ./.claude -prune -o \\( -name 'node_modules' -o -name '.nuxt' -o -name '.output' -o -name 'dist' \\) -type d -prune -exec rm -rf '{}' +",
+    "clean:test": "rm -rf test/.fixture-builds test/.untestutils && find test/fixtures -type d \\( -name '.nuxt' -o -name '.output-shared' -o -name '.nuxt-test' -o -name 'test-results' \\) -prune -exec rm -rf '{}' + 2>/dev/null || true",
+    "check:versions": "pnpm -C scripts cli check-versions",
+    "verify:packages": "pnpm -C scripts cli verify-packages",
+    "verify:packages:publint": "pnpm -C scripts cli verify-packages --publint",
+    "compare:published": "pnpm -C scripts cli compare-published",
+    "check:consumer": "pnpm -C scripts cli consumer-types",
+    "check:oldest": "pnpm -C scripts cli oldest-versions",
     "preflight": "pnpm -C scripts cli preflight",
-    "docs:generate": "pnpm -C scripts cli docs-generate",
-    "docs:generate:check": "pnpm -C scripts cli docs-generate --check"
+    "bump": "pnpm -C scripts cli bump",
+    "release:check": "pnpm -C scripts cli publish --check-only",
+    "release:auth": "pnpm -C scripts cli ensure-npm-auth",
+    "release:source": "pnpm -C scripts cli ensure-release-source",
+    "release:patch": "pnpm -C scripts cli publish --bump patch",
+    "release:minor": "pnpm -C scripts cli publish --bump minor",
+    "release:major": "pnpm -C scripts cli publish --bump major",
+    "release:packages": "pnpm -C scripts cli publish"
   }
 }