@astroscope/i18n 0.3.3 → 0.4.0

package/README.md

@@ -421,6 +421,23 @@ For `:currency` and `:unit`, the required option (`currency` or `unit`) can be:
 - `'throw'` — Throw an error
 - `(key, meta) => string` — Custom function
 
+## ESLint Plugin
+
+Use [`@astroscope/eslint-plugin-i18n`](../eslint-plugin-i18n) to enforce correct `t()` usage, catch build-time extraction issues, and ensure i18n-aware hydration directives.
+
+```bash
+npm install -D @astroscope/eslint-plugin-i18n
+```
+
+```js
+// eslint.config.js
+import i18n from '@astroscope/eslint-plugin-i18n';
+
+export default [
+  i18n.configs.recommended,
+];
+```
+
 ## License
 
 MIT

package/dist/chunk-FYKC3DAZ.js

@@ -0,0 +1,36 @@
+// src/extraction/manifest.ts
+import path from "path";
+var I18N_MANIFEST_GLOBAL_KEY = "__astroscope_i18n_manifest__";
+function getGlobalState() {
+  const g = globalThis;
+  if (!g[I18N_MANIFEST_GLOBAL_KEY]) {
+    g[I18N_MANIFEST_GLOBAL_KEY] = {
+      extractedKeys: [],
+      chunkManifest: {},
+      importsManifest: {},
+      projectRoot: "",
+      version: 0
+    };
+  }
+  return g[I18N_MANIFEST_GLOBAL_KEY];
+}
+function getManifest() {
+  const state = getGlobalState();
+  const keys = state.extractedKeys.map((key) => ({
+    ...key,
+    // make file paths relative to project root for better readability
+    // and avoiding leaking absolute paths from dev or ci environments
+    files: key.files.map((fileLocation) => {
+      const [filePath, line] = fileLocation.split(":");
+      if (!filePath) return fileLocation;
+      const relativePath = state.projectRoot ? path.relative(state.projectRoot, filePath) : filePath;
+      return line ? `${relativePath}:${line}` : relativePath;
+    })
+  }));
+  return { keys, chunks: state.chunkManifest, imports: state.importsManifest };
+}
+
+export {
+  getGlobalState,
+  getManifest
+};

package/dist/{chunk-Z3LDPCYD.js → chunk-IJXSX5DY.js}

@@ -1,41 +1,14 @@
+import {
+  getGlobalState,
+  getManifest
+} from "./chunk-FYKC3DAZ.js";
 import {
   chunkIdToName
 } from "./chunk-4A5BKHFN.js";
 
-// src/extraction/manifest.ts
-import path from "path";
-var I18N_MANIFEST_GLOBAL_KEY = "__astroscope_i18n_manifest__";
-function getGlobalState() {
-  const g = globalThis;
-  if (!g[I18N_MANIFEST_GLOBAL_KEY]) {
-    g[I18N_MANIFEST_GLOBAL_KEY] = {
-      extractedKeys: [],
-      chunkManifest: {},
-      importsManifest: {},
-      projectRoot: ""
-    };
-  }
-  return g[I18N_MANIFEST_GLOBAL_KEY];
-}
-function getManifest() {
-  const state = getGlobalState();
-  const keys = state.extractedKeys.map((key) => ({
-    ...key,
-    // make file paths relative to project root for better readability
-    // and avoiding leaking absolute paths from dev or ci environments
-    files: key.files.map((fileLocation) => {
-      const [filePath, line] = fileLocation.split(":");
-      if (!filePath) return fileLocation;
-      const relativePath = state.projectRoot ? path.relative(state.projectRoot, filePath) : filePath;
-      return line ? `${relativePath}:${line}` : relativePath;
-    })
-  }));
-  return { keys, chunks: state.chunkManifest, imports: state.importsManifest };
-}
-
 // src/extraction/vite-plugin.ts
 import fs2 from "fs";
-import path2 from "path";
+import path from "path";
 import MagicString from "magic-string";
 
 // src/extraction/extract.ts
@@ -337,9 +310,9 @@ function i18nVitePlugin(options) {
   const syncGlobalState = () => {
     const state = getGlobalState();
     state.extractedKeys = store.extractedKeys;
+    state.version++;
   };
   let isBuild = false;
-  let isSSR = false;
   let projectRoot = "";
   return {
     name: "@astroscope/i18n/extract",
@@ -348,7 +321,6 @@ function i18nVitePlugin(options) {
       const state = getGlobalState();
       state.projectRoot = config.root;
       isBuild = config.command === "build";
-      isSSR = !!config.build.ssr;
       projectRoot = config.root;
     },
     async configureServer(server) {
@@ -485,9 +457,9 @@ export function getManifest() { return _getManifest(); }
       }
     },
     writeBundle(outputOptions) {
-      if (!isSSR && outputOptions.dir) {
-        const chunksDir = path2.resolve(outputOptions.dir, "..", "server", "chunks");
-        const manifestPath = path2.join(chunksDir, MANIFEST_FILE_NAME);
+      if (this.environment.name === "client" && outputOptions.dir) {
+        const chunksDir = path.resolve(outputOptions.dir, "..", "server", "chunks");
+        const manifestPath = path.join(chunksDir, MANIFEST_FILE_NAME);
         if (fs2.existsSync(chunksDir)) {
           fs2.writeFileSync(manifestPath, JSON.stringify(getManifest()));
         } else {
@@ -499,6 +471,5 @@ export function getManifest() { return _getManifest(); }
 }
 
 export {
-  getManifest,
   i18nVitePlugin
 };

package/dist/{chunk-MSJHXRJB.js → chunk-LXW5WYBS.js}

@@ -1,6 +1,9 @@
 import {
   compileTranslations
 } from "./chunk-33JVAFGQ.js";
+import {
+  getGlobalState
+} from "./chunk-FYKC3DAZ.js";
 
 // src/extraction/hash.ts
 import { createHash } from "crypto";
@@ -57,6 +60,8 @@ var I18nSingleton = class {
   chunkCache = /* @__PURE__ */ new Map();
   // manifest getter (set by init module, provides live data in dev mode)
   manifestGetter = null;
+  // tracks the manifest version to detect when derived caches need invalidation
+  manifestVersion = 0;
   async configure(config) {
     if (!config.locales?.length) {
       throw new Error("i18n.configure(): locales array is required and must not be empty");
@@ -108,12 +113,18 @@ var I18nSingleton = class {
     this.compiledCache.delete(locale);
     this.hashCache.delete(locale);
     this.scriptCache.delete(locale);
+    for (const key of this.chunkCache.keys()) {
+      if (key.startsWith(`${locale}:`)) {
+        this.chunkCache.delete(key);
+      }
+    }
     const { chunks } = this.getManifest();
     if (Object.keys(chunks).length > 0) {
       this.hashCache.set(locale, computeAllChunkHashes(raw, chunks));
     }
   }
   getTranslations(locale) {
+    this.invalidateIfManifestChanged();
     const cached = this.mergedCache.get(locale);
     if (cached) {
       return cached;
@@ -244,6 +255,20 @@ var I18nSingleton = class {
       }
     }
   }
+  /**
+   * invalidate derived caches when the extraction manifest has changed (dev mode HMR)
+   */
+  invalidateIfManifestChanged() {
+    const { version } = getGlobalState();
+    if (version === this.manifestVersion) {
+      return;
+    }
+    this.manifestVersion = version;
+    this.mergedCache.clear();
+    this.compiledCache.clear();
+    this.scriptCache.clear();
+    this.chunkCache.clear();
+  }
   resolveLocales(locales) {
     if (!locales) {
       return this.config?.locales ?? [];

package/dist/client/translate.d.ts

@@ -1,5 +1,5 @@
 import { R as RichComponents } from '../rich-CQUhdwBc.js';
-import { a as TranslateFunction, T as TranslationMeta } from '../types-DNRFj1XA.js';
+import { T as TranslationMeta, a as TranslateFunction } from '../types-DNRFj1XA.js';
 import '../types-BeDFfFIL.js';
 
 declare function getLocale(): string;

package/dist/extraction/index.js

@@ -1,7 +1,9 @@
 import {
-  getManifest,
   i18nVitePlugin
-} from "../chunk-Z3LDPCYD.js";
+} from "../chunk-IJXSX5DY.js";
+import {
+  getManifest
+} from "../chunk-FYKC3DAZ.js";
 import "../chunk-4A5BKHFN.js";
 export {
   getManifest,

package/dist/{i18n-DaLnNvss.d.ts → i18n-BmK1MjH7.d.ts}

@@ -34,6 +34,7 @@ declare class I18nSingleton {
     private scriptCache;
     private chunkCache;
     private manifestGetter;
+    private manifestVersion;
     configure(config: I18nConfig): Promise<void>;
     isConfigured(): boolean;
     getConfig(): NormalizedConfig;
@@ -64,6 +65,10 @@ declare class I18nSingleton {
      * @param locales - Locale(s) to clear, or all if not specified
      */
     clear(locales?: string | string[] | undefined): void;
+    /**
+     * invalidate derived caches when the extraction manifest has changed (dev mode HMR)
+     */
+    private invalidateIfManifestChanged;
     private resolveLocales;
 }
 declare const i18n: I18nSingleton;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { AstroIntegration, MiddlewareHandler, APIContext } from 'astro';
+import { AstroIntegration, APIContext, MiddlewareHandler } from 'astro';
 import { I as I18nOptions } from './types-B_8vAmvv.js';
-export { F as FallbackBehavior, I as I18nConfig, i as i18n } from './i18n-DaLnNvss.js';
+export { F as FallbackBehavior, I as I18nConfig, i as i18n } from './i18n-BmK1MjH7.js';
 import { ExcludePattern } from '@astroscope/excludes';
 export { R as RawTranslations, T as TranslationMeta } from './types-DNRFj1XA.js';
 export { E as ExtractedKey, a as ExtractionManifest } from './types-moTgocy7.js';

package/dist/index.js

@@ -1,11 +1,12 @@
 import {
   i18nVitePlugin
-} from "./chunk-Z3LDPCYD.js";
+} from "./chunk-IJXSX5DY.js";
 import {
   i18n,
   runWithContext
-} from "./chunk-MSJHXRJB.js";
+} from "./chunk-LXW5WYBS.js";
 import "./chunk-33JVAFGQ.js";
+import "./chunk-FYKC3DAZ.js";
 import "./chunk-4A5BKHFN.js";
 
 // src/integration/integration.ts

package/dist/internal.d.ts

@@ -1,5 +1,5 @@
-import { a as I18nContext } from './i18n-DaLnNvss.js';
-export { i as i18n } from './i18n-DaLnNvss.js';
+import { a as I18nContext } from './i18n-BmK1MjH7.js';
+export { i as i18n } from './i18n-BmK1MjH7.js';
 export { I as I18nClientState } from './types-DNRFj1XA.js';
 import './types-moTgocy7.js';
 

package/dist/internal.js

@@ -1,8 +1,9 @@
 import {
   getContext,
   i18n
-} from "./chunk-MSJHXRJB.js";
+} from "./chunk-LXW5WYBS.js";
 import "./chunk-33JVAFGQ.js";
+import "./chunk-FYKC3DAZ.js";
 export {
   getContext,
   i18n

package/dist/server/translate.d.ts

@@ -1,5 +1,5 @@
 import { R as RichComponents } from '../rich-CQUhdwBc.js';
-import { a as TranslateFunction, T as TranslationMeta } from '../types-DNRFj1XA.js';
+import { T as TranslationMeta, a as TranslateFunction } from '../types-DNRFj1XA.js';
 
 /**
  * Get the current locale from request context.

package/dist/server/translate.js

@@ -1,7 +1,7 @@
 import {
   getContext,
   i18n
-} from "../chunk-MSJHXRJB.js";
+} from "../chunk-LXW5WYBS.js";
 import {
   normalizeMeta,
   partsToNodes
@@ -10,6 +10,7 @@ import {
   compileMessage,
   formatMessageToParts
 } from "../chunk-33JVAFGQ.js";
+import "../chunk-FYKC3DAZ.js";
 
 // src/server/translate.ts
 var fallbackCache = /* @__PURE__ */ new Map();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astroscope/i18n",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "i18n for Astro + React islands — MessageFormat 2, automatic tree-shaking, parallel loading, any translation source",
   "type": "module",
   "main": "./dist/index.js",
@@ -84,27 +84,27 @@
   "scripts": {
     "build": "tsup src/index.ts src/internal.ts src/extraction/index.ts src/server/translate.ts src/client/translate.ts src/client/directives/load.ts src/client/directives/idle.ts src/client/directives/visible.ts src/client/directives/media.ts src/client/directives/only.ts src/client/directives/utils.ts --format esm --dts --external astro --external astro/client/load.js --external astro/client/idle.js --external astro/client/visible.js --external astro/client/media.js --external astro/client/only.js --external virtual:@astroscope/i18n/manifest --external @babel/core",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint 'src/**/*.ts'",
-    "lint:fix": "eslint 'src/**/*.ts' --fix"
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix"
   },
   "dependencies": {
-    "@astrojs/compiler": "^2.13.0",
+    "@astrojs/compiler": "^3.0.0",
     "@babel/core": "^7.29.0",
     "@babel/preset-typescript": "^7.28.5",
     "messageformat": "^4.0.0",
-    "glob": "^13.0.1",
+    "glob": "^13.0.6",
     "magic-string": "^0.30.21"
   },
   "devDependencies": {
     "@babel/types": "^7.29.0",
     "@types/babel__core": "^7.20.5",
-    "astro": "^5.17.1",
+    "astro": "^6.0.2",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vite": "^6.4.1"
+    "vite": "^7.3.1"
   },
   "peerDependencies": {
-    "@astroscope/excludes": "^0.2.0",
-    "astro": "^5.0.0"
+    "@astroscope/excludes": "^0.3.0",
+    "astro": "^6.0.0"
   }
 }