@astroscope/i18n 0.4.5 → 0.5.0

package/README.md

@@ -6,24 +6,24 @@ i18n for Astro + React islands — automatic tree-shaking, parallel loading, any
 
 ## Why this library?
 
-**SSR-first** — The only i18n solution built specifically for SSR + islands architecture. Works seamlessly with Astro's partial hydration model where most i18n libraries fail.
+**SSR-first** — Built for Astro's SSR + islands architecture, where client-only i18n libraries have no server story.
 
-**Automatic tree-shaking** — Only translations actually used by each component are delivered to the browser. No manual chunk splitting, no configuration. It just works.
+**Automatic tree-shaking** — Only the translations each component actually uses are delivered to the browser. No manual chunk splitting or configuration.
 
-**Parallel loading** — Translations load alongside component hydration via custom `client:*-x` directives. No waiting for translations before rendering.
+**Parallel loading** — Translations load alongside component hydration via custom `client:*-x` directives, so hydration doesn't wait on a separate translation fetch.
 
-**Unified API** — Same `t()` function works identically in Astro templates and React islands.
+**Unified API** — The same `t()` function works in Astro templates and React islands.
 
-**Any translation source** — Fetch translations from any provider: JSON files, database, headless CMS, TMS, or custom API. All of them will be optimized and chunked automatically.
+**Any translation source** — Fetch translations from any provider: JSON files, database, headless CMS, TMS, or custom API. All are chunked and optimized the same way.
 
-**Production optimized** — Fallback strings are stripped from production bundles via Babel, reducing bundle size while keeping fallbacks available via the manifest.
+**Production optimized** — Fallback strings are stripped from production bundles via Babel and kept available through the manifest.
 
 ## Features
 
 - **Per-chunk translation loading** — each island gets only its translations
 - **Unicode MessageFormat 2** (MF2) support via `messageformat` v4
 - **Built-in formatters** — `:number`, `:integer`, `:percent`, `:currency`, `:date`, `:time`, `:datetime`, `:unit`
-- **Babel-based extraction** — robust AST parsing, source maps, production stripping
+- **Babel-based extraction** — AST parsing, source maps, production stripping
 - **Manifest fallbacks** — missing translations automatically use extracted fallbacks
 - **Full TypeScript support**
 - **Tiny client runtime** — ~8KB gzipped for translations
@@ -58,17 +58,17 @@ The integration checks for translation key consistency — when the same key is
 
 ```ts
 i18n({
-  consistency: 'warn',  // 'warn' (default) | 'error' | 'off'
+  consistency: 'error',  // 'error' (default) | 'warn' | 'off'
 })
 ```
 
-- **`'warn'`** — Log a warning but continue (default)
-- **`'error'`** — Fail the build
+- **`'error'`** — Fail the build (default)
+- **`'warn'`** — Log a warning but continue
 - **`'off'`** — Disable consistency checking
 
 ### 2. Configure i18n in your boot file
 
-**VERY IMPORTANT:** `i18n.configure` must be awaited during boot before handling any requests!
+> **Note:** `i18n.configure` must be awaited during boot, before any requests are handled.
 
 ```ts
 // src/boot.ts

package/dist/extraction/index.d.ts

@@ -1,5 +1,5 @@
-import { a as ExtractionManifest } from '../types-moTgocy7.js';
-export { C as ChunkManifest, E as ExtractedKey } from '../types-moTgocy7.js';
+import { E as ExtractionManifest } from '../types-ChMT6Vbd.js';
+export { C as ChunkManifest, a as ExtractedKey } from '../types-ChMT6Vbd.js';
 import { AstroIntegrationLogger } from 'astro';
 import { Plugin } from 'vite';
 import { C as ConsistencyCheckLevel } from '../types-B_8vAmvv.js';

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

@@ -1,4 +1,4 @@
-import { a as ExtractionManifest } from './types-moTgocy7.js';
+import { E as ExtractionManifest } from './types-ChMT6Vbd.js';
 import { T as TranslationMeta, C as CompiledTranslations, R as RawTranslations } from './types-DNRFj1XA.js';
 
 /**

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 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-BmK1MjH7.js';
+export { F as FallbackBehavior, I as I18nConfig, i as i18n } from './i18n-B--L7OQk.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';
+export { a as ExtractedKey, E as ExtractionManifest } from './types-ChMT6Vbd.js';
 
 /**
  * Astro integration for i18n with automatic per-chunk translation loading.

package/dist/internal.d.ts

@@ -1,7 +1,7 @@
-import { a as I18nContext } from './i18n-BmK1MjH7.js';
-export { i as i18n } from './i18n-BmK1MjH7.js';
+import { a as I18nContext } from './i18n-B--L7OQk.js';
+export { i as i18n } from './i18n-B--L7OQk.js';
 export { I as I18nClientState } from './types-DNRFj1XA.js';
-import './types-moTgocy7.js';
+import './types-ChMT6Vbd.js';
 
 /**
  * Get the current i18n context

package/dist/{types-moTgocy7.d.ts → types-ChMT6Vbd.d.ts}

@@ -27,4 +27,4 @@ type ExtractionManifest = {
     imports: ImportsManifest;
 };
 
-export type { ChunkManifest as C, ExtractedKey as E, ExtractionManifest as a };
+export type { ChunkManifest as C, ExtractionManifest as E, ExtractedKey as a };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astroscope/i18n",
-  "version": "0.4.5",
+  "version": "0.5.0",
   "description": "i18n for Astro + React islands — MessageFormat 2, automatic tree-shaking, parallel loading, any translation source",
   "type": "module",
   "main": "./dist/index.js",
@@ -82,7 +82,7 @@
   },
   "homepage": "https://github.com/entwico/astroscope/tree/main/packages/i18n#readme",
   "dependencies": {
-    "@astrojs/compiler": "^3.0.1",
+    "@astrojs/compiler": "^4.0.0",
     "@babel/core": "^7.29.0",
     "@babel/preset-typescript": "^7.28.5",
     "messageformat": "^4.0.0",
@@ -91,10 +91,11 @@
   "devDependencies": {
     "@babel/types": "^7.29.0",
     "@types/babel__core": "^7.20.5",
-    "astro": "^6.1.8",
+    "astro": "^6.2.2",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "vite": "^7.0.0"
+    "vite": "^7.0.0",
+    "@astroscope/excludes": "^0.3.2"
   },
   "peerDependencies": {
     "astro": "^6.0.0",
@@ -103,7 +104,7 @@
   "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",
+    "lint": "eslint src --cache",
     "lint:fix": "eslint src --fix"
   }
 }