@astroscope/i18n 0.1.0 → 0.2.1

package/README.md

@@ -1,5 +1,7 @@
 # @astroscope/i18n
 
+> **Note:** This package is in active development. APIs may change between versions.
+
 i18n for Astro + React islands — automatic tree-shaking, parallel loading, any translation source.
 
 ## Why this library?
@@ -28,7 +30,7 @@ i18n for Astro + React islands — automatic tree-shaking, parallel loading, any
 ## Installation
 
 ```bash
-npm install @astroscope/i18n @astroscope/boot
+npm install @astroscope/i18n @astroscope/boot @astroscope/excludes
 ```
 
 ## Usage
@@ -51,6 +53,8 @@ export default defineConfig({
 
 ### 2. Configure i18n in your boot file
 
+**VERY IMPORTANT:** `i18n.configure` must be awaited during boot before handling any requests!
+
 ```ts
 // src/boot.ts
 import { i18n, type RawTranslations } from '@astroscope/i18n';
@@ -95,6 +99,24 @@ export const onRequest = sequence(
 );
 ```
 
+By default, `RECOMMENDED_EXCLUDES` (static assets like `/_astro/`) are excluded from locale context setup. To customize:
+
+```ts
+import { sequence } from 'astro:middleware';
+import { createI18nChunkMiddleware, createI18nMiddleware, i18n } from '@astroscope/i18n';
+import { RECOMMENDED_EXCLUDES } from '@astroscope/excludes';
+
+export const onRequest = sequence(
+  createI18nChunkMiddleware(),
+  createI18nMiddleware({
+    locale: (ctx) =>
+      ctx.cookies.get('locale')?.value ??
+      i18n.getConfig().defaultLocale,
+    exclude: [...RECOMMENDED_EXCLUDES, { exact: '/health' }],
+  }),
+);
+```
+
 ### 4. Add `<I18nScript />` to your layout
 
 Inject translations into the page for hydrated components:

package/dist/{chunk-FAKBSLNW.js → chunk-7MSGHEST.js}

@@ -4,21 +4,28 @@ import {
 } from "./chunk-4A5BKHFN.js";
 
 // src/client/directives/utils.ts
-async function loadI18nForChunk(el) {
-  const componentUrl = el.getAttribute("component-url");
-  if (!componentUrl) return;
-  const chunkName = componentUrlToChunkName(componentUrl);
-  const i18n = window.__i18n__;
+function prefetchTranslation(chunkName, i18n) {
   const hash = i18n.hashes[chunkName];
   if (hash) {
     const url = buildI18nChunkUrl(i18n.locale, chunkName, hash);
-    await import(
+    import(
       /* @vite-ignore */
       url
     );
   }
 }
+function warmUpI18nForChunk(el) {
+  const componentUrl = el.getAttribute("component-url");
+  if (!componentUrl) return;
+  const chunkName = componentUrlToChunkName(componentUrl);
+  const i18n = window.__i18n__;
+  prefetchTranslation(chunkName, i18n);
+  const deps = i18n.imports[chunkName] ?? [];
+  for (const dep of deps) {
+    prefetchTranslation(dep, i18n);
+  }
+}
 
 export {
-  loadI18nForChunk
+  warmUpI18nForChunk
 };

package/dist/{chunk-JJEDOJBR.js → chunk-EO4FUQXR.js}

@@ -11,6 +11,7 @@ function getGlobalState() {
     g[I18N_MANIFEST_GLOBAL_KEY] = {
       extractedKeys: [],
       chunkManifest: {},
+      importsManifest: {},
       projectRoot: ""
     };
   }
@@ -24,7 +25,7 @@ function getManifest() {
     // and avoiding leaking absolute paths from dev or ci environments
     file: state.projectRoot ? path.relative(state.projectRoot, key.file) : key.file
   }));
-  return { keys, chunks: state.chunkManifest };
+  return { keys, chunks: state.chunkManifest, imports: state.importsManifest };
 }
 
 // src/extraction/vite-plugin.ts
@@ -135,6 +136,10 @@ export function getManifest() { return _getManifest(); }
     generateBundle(_, bundle) {
       const state = getGlobalState();
       state.chunkManifest = {};
+      state.importsManifest = {};
+      const chunksWithI18n = /* @__PURE__ */ new Set();
+      const chunkNameToFileName = /* @__PURE__ */ new Map();
+      const directImports = /* @__PURE__ */ new Map();
       for (const [fileName, chunk] of Object.entries(bundle)) {
         if (chunk.type === "chunk" && chunk.moduleIds) {
           const keys = /* @__PURE__ */ new Set();
@@ -151,24 +156,50 @@ export function getManifest() { return _getManifest(); }
             state.chunkManifest[chunkName] = Array.from(keys);
           }
           if (hasI18nModule) {
-            const loaderCode = `
-/* @astroscope/i18n loader */
-if (typeof window !== 'undefined' && window.__i18n__) {
-  const __i18n__ = window.__i18n__;
-  const __i18n_hash__ = __i18n__.hashes[${JSON.stringify(chunkName)}];
-  if (__i18n_hash__) {
-    await import(\`/_i18n/\${__i18n__.locale}/${chunkName}.\${__i18n_hash__}.js\`);
-  }
-}
-/* end @astroscope/i18n loader */
-`;
-            const s = new MagicString(chunk.code);
-            s.prepend(loaderCode);
-            chunk.code = s.toString();
-            if (chunk.map) {
-              chunk.map = s.generateMap({ hires: true });
-            }
+            chunksWithI18n.add(chunkName);
           }
+          chunkNameToFileName.set(chunkName, fileName);
+          const imports = [];
+          for (const importedFile of chunk.imports) {
+            const baseName = importedFile.replace(/^.*\//, "").replace(/\.js$/, "");
+            const importedChunkName = chunkIdToName(baseName);
+            imports.push(importedChunkName);
+          }
+          directImports.set(chunkName, imports);
+        }
+      }
+      const flattenImports = (chunkName, visited) => {
+        if (visited.has(chunkName)) return [];
+        visited.add(chunkName);
+        const result = /* @__PURE__ */ new Set();
+        const imports = directImports.get(chunkName) ?? [];
+        for (const imported of imports) {
+          if (state.chunkManifest[imported]) {
+            result.add(imported);
+          }
+          for (const descendant of flattenImports(imported, visited)) {
+            result.add(descendant);
+          }
+        }
+        visited.delete(chunkName);
+        return Array.from(result);
+      };
+      for (const chunkName of directImports.keys()) {
+        const flattened = flattenImports(chunkName, /* @__PURE__ */ new Set());
+        if (flattened.length > 0) {
+          state.importsManifest[chunkName] = flattened;
+        }
+      }
+      for (const [fileName, chunk] of Object.entries(bundle)) {
+        if (chunk.type !== "chunk") continue;
+        const chunkName = chunkIdToName(fileName.replace(/\.js$/, ""));
+        if (!chunksWithI18n.has(chunkName)) continue;
+        const loaderCode = `if(typeof window!=='undefined'&&window.__i18n__){const _=window.__i18n__,h=_.hashes[${JSON.stringify(chunkName)}];if(h)await import(\`/_i18n/\${_.locale}/${chunkName}.\${h}.js\`);}`;
+        const s = new MagicString(chunk.code);
+        s.prepend(loaderCode);
+        chunk.code = s.toString();
+        if (chunk.map) {
+          chunk.map = s.generateMap({ hires: true });
         }
       }
       logger.info(`manifest: ${Object.keys(state.chunkManifest).length} chunks, ${extractedKeys.length} keys`);

package/dist/{chunk-QFAAGCP5.js → chunk-RHWEV4L2.js}

@@ -24,6 +24,21 @@ function computeAllChunkHashes(translations, manifest) {
   return hashes;
 }
 
+// src/server/utils.ts
+var LOWERCASE_A = 97;
+function indexToLetter(index) {
+  return String.fromCharCode(LOWERCASE_A + index);
+}
+function generateBB26(index) {
+  let name = "";
+  let remaining = index;
+  do {
+    name = indexToLetter(remaining % 26) + name;
+    remaining = Math.floor(remaining / 26) - 1;
+  } while (remaining >= 0);
+  return name;
+}
+
 // src/server/i18n.ts
 var I18nSingleton = class {
   // normalized user config with defaults applied
@@ -36,6 +51,8 @@ var I18nSingleton = class {
   compiledCache = /* @__PURE__ */ new Map();
   // locale -> chunk name -> content hash (for cache busting)
   hashCache = /* @__PURE__ */ new Map();
+  // locale -> inline script for I18nScript component
+  scriptCache = /* @__PURE__ */ new Map();
   // manifest getter (set by init module, provides live data in dev mode)
   manifestGetter = null;
   async configure(config) {
@@ -88,6 +105,7 @@ var I18nSingleton = class {
     this.mergedCache.delete(locale);
     this.compiledCache.delete(locale);
     this.hashCache.delete(locale);
+    this.scriptCache.delete(locale);
     const { chunks } = this.getManifest();
     if (Object.keys(chunks).length > 0) {
       this.hashCache.set(locale, computeAllChunkHashes(raw, chunks));
@@ -99,7 +117,7 @@ var I18nSingleton = class {
       return cached;
     }
     const raw = this.rawCache.get(locale) ?? {};
-    const manifest = this.manifestGetter?.() ?? { keys: [], chunks: {} };
+    const manifest = this.manifestGetter?.() ?? { keys: [], chunks: {}, imports: {} };
     if (manifest.keys.length === 0) {
       return raw;
     }
@@ -135,6 +153,44 @@ var I18nSingleton = class {
   getHashes(locale) {
     return this.hashCache.get(locale) ?? {};
   }
+  /**
+   * Get the inline script for I18nScript component.
+   * Cached per locale, invalidated when translations change.
+   */
+  getClientScript(locale) {
+    const cached = this.scriptCache.get(locale);
+    if (cached) {
+      return cached;
+    }
+    const script = this.createClientScript(locale);
+    this.scriptCache.set(locale, script);
+    return script;
+  }
+  createClientScript(locale) {
+    const { chunks, imports } = this.getManifest();
+    const hasChunks = Object.keys(chunks).length > 0;
+    if (!hasChunks) {
+      const raw = this.getTranslations(locale);
+      return `window.__i18n__=${JSON.stringify({ locale, hashes: {}, imports: {}, translations: raw })};`;
+    }
+    const hashes = this.getHashes(locale);
+    const allChunks = new Set(Object.keys(hashes));
+    for (const deps of Object.values(imports)) {
+      deps.forEach((d) => allChunks.add(d));
+    }
+    const chunkToVar = /* @__PURE__ */ new Map();
+    let varIndex = 0;
+    for (const chunk of allChunks) {
+      chunkToVar.set(chunk, generateBB26(varIndex++));
+    }
+    const varDecls = [...chunkToVar.entries()].map(([chunk, v]) => `${v}=${JSON.stringify(chunk)}`).join(",");
+    const hashesObj = Object.entries(hashes).map(([chunk, hash]) => `[${chunkToVar.get(chunk)}]:${JSON.stringify(hash)}`).join(",");
+    const importsObj = Object.entries(imports).filter(([chunk]) => chunkToVar.has(chunk)).map(([chunk, deps]) => {
+      const validDeps = deps.filter((d) => chunkToVar.has(d));
+      return validDeps.length > 0 ? `[${chunkToVar.get(chunk)}]:[${validDeps.map((d) => chunkToVar.get(d)).join(",")}]` : null;
+    }).filter(Boolean).join(",");
+    return `(()=>{var ${varDecls};window.__i18n__={locale:${JSON.stringify(locale)},hashes:{${hashesObj}},imports:{${importsObj}},translations:{}};})();`;
+  }
   /**
    * Clear translations for specified locale(s).
    * @param locales - Locale(s) to clear, or all if not specified
@@ -146,6 +202,7 @@ var I18nSingleton = class {
       this.mergedCache.delete(locale);
       this.compiledCache.delete(locale);
       this.hashCache.delete(locale);
+      this.scriptCache.delete(locale);
     }
   }
   resolveLocales(locales) {

package/dist/client/directives/idle.d.ts

@@ -2,8 +2,11 @@ import { ClientDirective } from 'astro';
 
 /**
  * i18n-aware client:idle directive
- * Loads translations in parallel before delegating to Astro's original idle directive
+ *
+ * Based on Astro's idle directive (MIT License)
+ * https://github.com/withastro/astro/blob/main/packages/astro/src/runtime/client/idle.ts
  */
+
 declare const idleDirective: ClientDirective;
 
 export { idleDirective as default };

package/dist/client/directives/idle.js

@@ -1,13 +1,20 @@
 import {
-  loadI18nForChunk
-} from "../../chunk-FAKBSLNW.js";
+  warmUpI18nForChunk
+} from "../../chunk-7MSGHEST.js";
 import "../../chunk-4A5BKHFN.js";
 
 // src/client/directives/idle.ts
-import originalIdle from "astro/client/idle.js";
-var idleDirective = async (load, options, el) => {
-  await loadI18nForChunk(el);
-  return originalIdle(load, options, el);
+var idleDirective = (load, _options, el) => {
+  const cb = async () => {
+    warmUpI18nForChunk(el);
+    const hydrate = await load();
+    await hydrate();
+  };
+  if ("requestIdleCallback" in window) {
+    window.requestIdleCallback(cb);
+  } else {
+    setTimeout(cb, 200);
+  }
 };
 var idle_default = idleDirective;
 export {

package/dist/client/directives/load.d.ts

@@ -2,8 +2,11 @@ import { ClientDirective } from 'astro';
 
 /**
  * i18n-aware client:load directive
- * Loads translations in parallel before delegating to Astro's original load directive
+ *
+ * Based on Astro's load directive (MIT License)
+ * https://github.com/withastro/astro/blob/main/packages/astro/src/runtime/client/load.ts
  */
+
 declare const loadDirective: ClientDirective;
 
 export { loadDirective as default };

package/dist/client/directives/load.js

@@ -1,13 +1,13 @@
 import {
-  loadI18nForChunk
-} from "../../chunk-FAKBSLNW.js";
+  warmUpI18nForChunk
+} from "../../chunk-7MSGHEST.js";
 import "../../chunk-4A5BKHFN.js";
 
 // src/client/directives/load.ts
-import originalLoad from "astro/client/load.js";
-var loadDirective = async (load, options, el) => {
-  await loadI18nForChunk(el);
-  return originalLoad(load, options, el);
+var loadDirective = async (load, _options, el) => {
+  warmUpI18nForChunk(el);
+  const hydrate = await load();
+  await hydrate();
 };
 var load_default = loadDirective;
 export {

package/dist/client/directives/media.d.ts

@@ -2,8 +2,11 @@ import { ClientDirective } from 'astro';
 
 /**
  * i18n-aware client:media directive
- * Loads translations in parallel before delegating to Astro's original media directive
+ *
+ * Based on Astro's media directive (MIT License)
+ * https://github.com/withastro/astro/blob/main/packages/astro/src/runtime/client/media.ts
  */
+
 declare const mediaDirective: ClientDirective;
 
 export { mediaDirective as default };

package/dist/client/directives/media.js

@@ -1,13 +1,23 @@
 import {
-  loadI18nForChunk
-} from "../../chunk-FAKBSLNW.js";
+  warmUpI18nForChunk
+} from "../../chunk-7MSGHEST.js";
 import "../../chunk-4A5BKHFN.js";
 
 // src/client/directives/media.ts
-import originalMedia from "astro/client/media.js";
-var mediaDirective = async (load, options, el) => {
-  await loadI18nForChunk(el);
-  return originalMedia(load, options, el);
+var mediaDirective = (load, options, el) => {
+  const cb = async () => {
+    warmUpI18nForChunk(el);
+    const hydrate = await load();
+    await hydrate();
+  };
+  if (options.value) {
+    const mql = matchMedia(options.value);
+    if (mql.matches) {
+      cb();
+    } else {
+      mql.addEventListener("change", cb, { once: true });
+    }
+  }
 };
 var media_default = mediaDirective;
 export {

package/dist/client/directives/only.d.ts

@@ -2,8 +2,13 @@ import { ClientDirective } from 'astro';
 
 /**
  * i18n-aware client:only directive
- * Loads translations in parallel before delegating to Astro's original only directive
+ *
+ * Based on Astro's load directive (MIT License)
+ * https://github.com/withastro/astro/blob/main/packages/astro/src/runtime/client/load.ts
+ *
+ * client:only works the same as client:load - immediate hydration
  */
+
 declare const onlyDirective: ClientDirective;
 
 export { onlyDirective as default };

package/dist/client/directives/only.js

@@ -1,13 +1,13 @@
 import {
-  loadI18nForChunk
-} from "../../chunk-FAKBSLNW.js";
+  warmUpI18nForChunk
+} from "../../chunk-7MSGHEST.js";
 import "../../chunk-4A5BKHFN.js";
 
 // src/client/directives/only.ts
-import originalOnly from "astro/client/only.js";
-var onlyDirective = async (load, options, el) => {
-  await loadI18nForChunk(el);
-  return originalOnly(load, options, el);
+var onlyDirective = async (load, _options, el) => {
+  warmUpI18nForChunk(el);
+  const hydrate = await load();
+  await hydrate();
 };
 var only_default = onlyDirective;
 export {

package/dist/client/directives/utils.d.ts

@@ -1,10 +1,11 @@
-import '../../types-B_-RxW4A.js';
-import '../../types-Bzp6KxsI.js';
+import '../../types-BeDFfFIL.js';
+import '../../types-DNRFj1XA.js';
 
 /**
- * Load translations for a chunk before hydration
+ * Warm up translation cache for a chunk and all its descendants (fire and forget)
  * Extracts chunk name from astro-island's component-url attribute
+ * Uses flattened imports map from window.__i18n__ to prefetch all nested translations
  */
-declare function loadI18nForChunk(el: HTMLElement): Promise<void>;
+declare function warmUpI18nForChunk(el: HTMLElement): void;
 
-export { loadI18nForChunk };
+export { warmUpI18nForChunk };

package/dist/client/directives/utils.js

@@ -1,7 +1,7 @@
 import {
-  loadI18nForChunk
-} from "../../chunk-FAKBSLNW.js";
+  warmUpI18nForChunk
+} from "../../chunk-7MSGHEST.js";
 import "../../chunk-4A5BKHFN.js";
 export {
-  loadI18nForChunk
+  warmUpI18nForChunk
 };

package/dist/client/directives/visible.d.ts

@@ -2,8 +2,11 @@ import { ClientDirective } from 'astro';
 
 /**
  * i18n-aware client:visible directive
- * Loads translations in parallel before delegating to Astro's original visible directive
+ *
+ * Based on Astro's visible directive (MIT License)
+ * https://github.com/withastro/astro/blob/main/packages/astro/src/runtime/client/visible.ts
  */
+
 declare const visibleDirective: ClientDirective;
 
 export { visibleDirective as default };

package/dist/client/directives/visible.js

@@ -1,13 +1,30 @@
 import {
-  loadI18nForChunk
-} from "../../chunk-FAKBSLNW.js";
+  warmUpI18nForChunk
+} from "../../chunk-7MSGHEST.js";
 import "../../chunk-4A5BKHFN.js";
 
 // src/client/directives/visible.ts
-import originalVisible from "astro/client/visible.js";
-var visibleDirective = async (load, options, el) => {
-  await loadI18nForChunk(el);
-  return originalVisible(load, options, el);
+var visibleDirective = (load, options, el) => {
+  const cb = async () => {
+    warmUpI18nForChunk(el);
+    const hydrate = await load();
+    await hydrate();
+  };
+  const rawOptions = typeof options.value === "object" ? options.value : void 0;
+  const ioOptions = {
+    rootMargin: rawOptions?.rootMargin
+  };
+  const io = new IntersectionObserver((entries) => {
+    for (const entry of entries) {
+      if (!entry.isIntersecting) continue;
+      io.disconnect();
+      cb();
+      break;
+    }
+  }, ioOptions);
+  for (const child of el.children) {
+    io.observe(child);
+  }
 };
 var visible_default = visibleDirective;
 export {

package/dist/client/t.d.ts

@@ -1,5 +1,5 @@
-import { a as TranslateFunction } from '../types-Bzp6KxsI.js';
-import '../types-B_-RxW4A.js';
+import { a as TranslateFunction } from '../types-DNRFj1XA.js';
+import '../types-BeDFfFIL.js';
 
 declare function getLocale(): string;
 /**

package/dist/extraction/index.d.ts

@@ -1,8 +1,8 @@
-import { a as ExtractionManifest } from '../types-8uKCwFda.js';
-export { C as ChunkManifest, E as ExtractedKey } from '../types-8uKCwFda.js';
+import { a as ExtractionManifest } from '../types-DTUho6gi.js';
+export { C as ChunkManifest, E as ExtractedKey } from '../types-DTUho6gi.js';
 import { AstroIntegrationLogger } from 'astro';
 import { Plugin } from 'vite';
-import '../types-Bzp6KxsI.js';
+import '../types-DNRFj1XA.js';
 
 /**
  * Manifest state management for i18n extraction

package/dist/extraction/index.js

@@ -1,7 +1,7 @@
 import {
   getManifest,
   i18nVitePlugin
-} from "../chunk-JJEDOJBR.js";
+} from "../chunk-EO4FUQXR.js";
 import "../chunk-4A5BKHFN.js";
 export {
   getManifest,

package/dist/{i18n-BGfrSNM8.d.ts → i18n-mTHTcD8K.d.ts}

@@ -1,5 +1,5 @@
-import { a as ExtractionManifest } from './types-8uKCwFda.js';
-import { T as TranslationMeta, C as CompiledTranslations, R as RawTranslations } from './types-Bzp6KxsI.js';
+import { a as ExtractionManifest } from './types-DTUho6gi.js';
+import { T as TranslationMeta, C as CompiledTranslations, R as RawTranslations } from './types-DNRFj1XA.js';
 
 /**
  * Fallback behavior when translation is missing
@@ -30,6 +30,7 @@ declare class I18nSingleton {
     private mergedCache;
     private compiledCache;
     private hashCache;
+    private scriptCache;
     private manifestGetter;
     configure(config: I18nConfig): Promise<void>;
     isConfigured(): boolean;
@@ -44,6 +45,12 @@ declare class I18nSingleton {
      */
     getManifest(): ExtractionManifest;
     getHashes(locale: string): Record<string, string>;
+    /**
+     * Get the inline script for I18nScript component.
+     * Cached per locale, invalidated when translations change.
+     */
+    getClientScript(locale: string): string;
+    private createClientScript;
     /**
      * Clear translations for specified locale(s).
      * @param locales - Locale(s) to clear, or all if not specified

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import { AstroIntegration, MiddlewareHandler, APIContext } from 'astro';
-export { F as FallbackBehavior, I as I18nConfig, i as i18n } from './i18n-BGfrSNM8.js';
-export { R as RawTranslations, T as TranslationMeta } from './types-Bzp6KxsI.js';
-export { E as ExtractedKey, a as ExtractionManifest } from './types-8uKCwFda.js';
+export { F as FallbackBehavior, I as I18nConfig, i as i18n } from './i18n-mTHTcD8K.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-DTUho6gi.js';
 
 interface I18nOptions {
 }
@@ -17,6 +18,28 @@ declare function i18nIntegration(_options?: I18nOptions): AstroIntegration;
 
 type I18nMiddlewareOptions = {
     locale: (ctx: APIContext) => string;
+    /**
+     * Patterns to exclude from locale context setup.
+     * Defaults to RECOMMENDED_EXCLUDES if not provided.
+     *
+     * @example
+     * ```ts
+     * import { RECOMMENDED_EXCLUDES } from '@astroscope/excludes';
+     *
+     * // extend defaults
+     * createI18nMiddleware({
+     *   locale: (ctx) => ctx.locals.session?.locale ?? 'en',
+     *   exclude: [...RECOMMENDED_EXCLUDES, { exact: '/health' }],
+     * })
+     *
+     * // disable excludes entirely
+     * createI18nMiddleware({
+     *   locale: (ctx) => ctx.locals.session?.locale ?? 'en',
+     *   exclude: [],
+     * })
+     * ```
+     */
+    exclude?: ExcludePattern[] | ((context: APIContext) => boolean) | undefined;
 };
 /**
  * Create the i18n chunk middleware that serves translation chunks at `/_i18n/` endpoints.

package/dist/index.js

@@ -1,10 +1,10 @@
 import {
   i18nVitePlugin
-} from "./chunk-JJEDOJBR.js";
+} from "./chunk-EO4FUQXR.js";
 import {
   i18n,
   runWithContext
-} from "./chunk-QFAAGCP5.js";
+} from "./chunk-RHWEV4L2.js";
 import "./chunk-KNDYKTHE.js";
 import "./chunk-4A5BKHFN.js";
 
@@ -55,6 +55,7 @@ ${attributes}
 }
 
 // src/server/middleware.ts
+import { RECOMMENDED_EXCLUDES, shouldExclude } from "@astroscope/excludes";
 var I18N_ENDPOINT_PREFIX = "/_i18n/";
 function createI18nChunkMiddleware() {
   return (ctx, next) => {
@@ -111,6 +112,9 @@ function createI18nChunkMiddleware() {
 }
 function createI18nMiddleware(options) {
   return (ctx, next) => {
+    if (shouldExclude(ctx, options.exclude ?? RECOMMENDED_EXCLUDES)) {
+      return next();
+    }
     const locale = options.locale(ctx);
     const context = {
       locale,

package/dist/internal.d.ts

@@ -1,7 +1,7 @@
-import { a as I18nContext } from './i18n-BGfrSNM8.js';
-export { i as i18n } from './i18n-BGfrSNM8.js';
-export { I as I18nClientState } from './types-Bzp6KxsI.js';
-import './types-8uKCwFda.js';
+import { a as I18nContext } from './i18n-mTHTcD8K.js';
+export { i as i18n } from './i18n-mTHTcD8K.js';
+export { I as I18nClientState } from './types-DNRFj1XA.js';
+import './types-DTUho6gi.js';
 
 /**
  * Get the current i18n context