@astroscope/i18n 1.0.1 → 1.0.2

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/integration/integration.ts","../src/server/middleware.ts","../src/server/locale.ts"],"mappings":";;;;;;;;;;;;;;AAE8C;iBAWtB,eAAA,CAAgB,OAAA,GAAS,WAAA,GAAmB,gBAAgB;;;KCPxE,qBAAA;EACV,MAAA,GAAS,GAAA,EAAK,UAAA;;;;;ADL8B;;;;;;;;AAWsC;;;;ACPpF;;;;;EAuBE,OAAA,GAAU,cAAA,OAAqB,OAAA,EAAS,UAAA;AAAA;;;;;;;;;;AAAU;AAwBpD;;;;AAA8D;AA0F9D;;;;iBA1FgB,yBAAA,IAA6B,iBAAiB;;;;AA0FyB;;;;ACzIvF;;;;AAA6C;;;;;;;;iBDyI7B,oBAAA,CAAqB,OAAA,EAAS,qBAAA,GAAwB,iBAAiB;;;;;;;iBCzIvE,YAAA,CAAa,OAAgB,EAAP,OAAO"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/integration/integration.ts","../src/server/middleware.ts","../src/server/locale.ts"],"mappings":";;;;;;;;;;;;;;AAE8C;iBAWtB,eAAA,CAAgB,OAAA,GAAS,WAAA,GAAmB,gBAAgB;;;KCNxE,qBAAA;EACV,MAAA,GAAS,GAAA,EAAK,UAAA;;;;;ADN8B;;;;;;;;AAWsC;;;;ACNpF;;;;;EAuBE,OAAA,GAAU,cAAA,OAAqB,OAAA,EAAS,UAAA;AAAA;;;;;;;;;;AAAU;AAmGpD;;;;AAA8D;AAkC9D;;;;iBAlCgB,yBAAA,IAA6B,iBAAiB;;;;AAkCyB;;;;AC7JvF;;;;AAA6C;;;;;;;;iBD6J7B,oBAAA,CAAqB,OAAA,EAAS,qBAAA,GAAwB,iBAAiB;;;;;;;iBC7JvE,YAAA,CAAa,OAAgB,EAAP,OAAO"}

package/dist/index.js

@@ -1,6 +1,7 @@
 import { t as i18nVitePlugin } from "./vite-plugin-CXUN45oF.js";
 import { n as runWithContext, r as i18n } from "./context-DLfoS-uR.js";
 import { RECOMMENDED_EXCLUDES, shouldExclude } from "@astroscope/node/excludes";
+import { overrideRequestRoute } from "@astroscope/node/log";
 //#region src/integration/integration.ts
 const CLIENT_DIRECTIVES = [
 	"load-x",
@@ -57,6 +58,45 @@ ${CLIENT_DIRECTIVES.map((d) => {
 //#endregion
 //#region src/server/middleware.ts
 const I18N_ENDPOINT_PREFIX = "/_i18n/";
+const I18N_ENDPOINT_ROUTE = "/_i18n/[locale]/[chunk]";
+/**
+* Serve a translation chunk. Returns `undefined` when the path isn't a chunk
+* request, and the caller passes it on to astro.
+*/
+function createChunkResponse(pathname) {
+	if (!pathname.startsWith(I18N_ENDPOINT_PREFIX)) return;
+	if (!i18n.isConfigured()) {
+		console.warn(`[@astroscope/i18n] not configured, passing through: ${pathname}`);
+		return;
+	}
+	const path = pathname.slice(7);
+	const slashIdx = path.indexOf("/");
+	if (slashIdx === -1) return;
+	const locale = path.slice(0, slashIdx);
+	if (!i18n.getConfig().locales.includes(locale)) return new Response("/* unknown locale */", {
+		status: 404,
+		headers: { "Content-Type": "application/javascript" }
+	});
+	const rest = path.slice(slashIdx + 1);
+	if (!rest.endsWith(".js")) return;
+	const withoutJs = rest.slice(0, -3);
+	const lastDotIdx = withoutJs.lastIndexOf(".");
+	if (lastDotIdx === -1) return;
+	const chunkName = withoutJs.slice(0, lastDotIdx);
+	const body = i18n.getChunkBody(locale, chunkName);
+	if (!body) return new Response(`/* chunk not found: ${chunkName} */`, {
+		status: 404,
+		headers: { "Content-Type": "application/javascript" }
+	});
+	return new Response(body, {
+		status: 200,
+		headers: {
+			"Content-Type": "text/javascript; charset=utf-8",
+			"Content-Length": String(body.byteLength),
+			"Cache-Control": "public, max-age=31536000, immutable"
+		}
+	});
+}
 /**
 * Create the i18n chunk middleware that serves translation chunks at `/_i18n/` endpoints.
 *
@@ -78,39 +118,10 @@ const I18N_ENDPOINT_PREFIX = "/_i18n/";
 */
 function createI18nChunkMiddleware() {
 	return (ctx, next) => {
-		const { pathname } = ctx.url;
-		if (!pathname.startsWith(I18N_ENDPOINT_PREFIX)) return next();
-		if (!i18n.isConfigured()) {
-			console.warn(`[@astroscope/i18n] not configured, passing through: ${pathname}`);
-			return next();
-		}
-		const path = pathname.slice(7);
-		const slashIdx = path.indexOf("/");
-		if (slashIdx === -1) return next();
-		const locale = path.slice(0, slashIdx);
-		if (!i18n.getConfig().locales.includes(locale)) return new Response("/* unknown locale */", {
-			status: 404,
-			headers: { "Content-Type": "application/javascript" }
-		});
-		const rest = path.slice(slashIdx + 1);
-		if (!rest.endsWith(".js")) return next();
-		const withoutJs = rest.slice(0, -3);
-		const lastDotIdx = withoutJs.lastIndexOf(".");
-		if (lastDotIdx === -1) return next();
-		const chunkName = withoutJs.slice(0, lastDotIdx);
-		const body = i18n.getChunkBody(locale, chunkName);
-		if (!body) return new Response(`/* chunk not found: ${chunkName} */`, {
-			status: 404,
-			headers: { "Content-Type": "application/javascript" }
-		});
-		return new Response(body, {
-			status: 200,
-			headers: {
-				"Content-Type": "text/javascript; charset=utf-8",
-				"Content-Length": String(body.byteLength),
-				"Cache-Control": "public, max-age=31536000, immutable"
-			}
-		});
+		const response = createChunkResponse(ctx.url.pathname);
+		if (!response) return next();
+		overrideRequestRoute(I18N_ENDPOINT_ROUTE);
+		return response;
 	};
 }
 /**

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/integration/integration.ts","../src/server/middleware.ts","../src/server/locale.ts"],"sourcesContent":["import type { AstroIntegration } from 'astro';\nimport { i18nVitePlugin } from '../extraction/vite-plugin.js';\nimport type { I18nOptions } from './types.js';\n\nconst CLIENT_DIRECTIVES = ['load-x', 'idle-x', 'visible-x', 'media-x', 'only-x'] as const;\n\n/**\n * Astro integration for i18n with automatic per-chunk translation loading.\n *\n * Registers:\n * - Client directives (`client:load-x`, `client:idle-x`, `client:visible-x`, `client:media-x`, `client:only-x`)\n * - Vite plugin for translation key extraction\n */\nexport default function i18nIntegration(options: I18nOptions = {}): AstroIntegration {\n  const { consistency = 'error' } = options;\n\n  return {\n    name: '@astroscope/i18n',\n    hooks: {\n      'astro:config:setup': ({ addClientDirective, updateConfig, logger }) => {\n        for (const directive of CLIENT_DIRECTIVES) {\n          const base = directive.replace('-x', '');\n          addClientDirective({\n            name: directive,\n            entrypoint: `@astroscope/i18n/client-directives/${base}.js`,\n          });\n        }\n\n        updateConfig({\n          vite: {\n            plugins: [i18nVitePlugin({ logger, consistency })],\n          },\n        });\n      },\n      'astro:config:done': ({ injectTypes }) => {\n        // inject client directive types for LSP support\n        const typeMap: Record<string, string> = {\n          load: 'boolean',\n          idle: 'boolean',\n          visible: 'boolean | string',\n          media: 'string',\n          only: 'string',\n        };\n\n        const attributes = CLIENT_DIRECTIVES.map((d) => {\n          const base = d.replace('-x', '');\n          return `    'client:${d}'?: ${typeMap[base]};`;\n        }).join('\\n');\n\n        injectTypes({\n          filename: 'client-directives.d.ts',\n          content: `// generated by @astroscope/i18n\ndeclare namespace astroHTML.JSX {\n  interface AstroBuiltinAttributes {\n${attributes}\n  }\n}`,\n        });\n      },\n    },\n  };\n}\n","import { type ExcludePattern, RECOMMENDED_EXCLUDES, shouldExclude } from '@astroscope/node/excludes';\nimport type { APIContext, MiddlewareHandler } from 'astro';\nimport { runWithContext } from './context.js';\nimport { i18n } from './i18n.js';\nimport type { I18nContext } from './types.js';\n\nexport type I18nMiddlewareOptions = {\n  locale: (ctx: APIContext) => string;\n  /**\n   * Patterns to exclude from locale context setup.\n   * Defaults to RECOMMENDED_EXCLUDES if not provided.\n   *\n   * @example\n   * ```ts\n   * import { RECOMMENDED_EXCLUDES } from '@astroscope/node/excludes';\n   *\n   * // extend defaults\n   * createI18nMiddleware({\n   *   locale: (ctx) => ctx.locals.session?.locale ?? 'en',\n   *   exclude: [...RECOMMENDED_EXCLUDES, { exact: '/health' }],\n   * })\n   *\n   * // disable excludes entirely\n   * createI18nMiddleware({\n   *   locale: (ctx) => ctx.locals.session?.locale ?? 'en',\n   *   exclude: [],\n   * })\n   * ```\n   */\n  exclude?: ExcludePattern[] | ((context: APIContext) => boolean) | undefined;\n};\n\nconst I18N_ENDPOINT_PREFIX = '/_i18n/';\n\n/**\n * Create the i18n chunk middleware that serves translation chunks at `/_i18n/` endpoints.\n *\n * Place this early in your middleware sequence (before session/auth)\n * to avoid unnecessary overhead for static translation requests.\n *\n * @example\n * ```typescript\n * // src/middleware.ts\n * import { sequence } from 'astro:middleware';\n * import { createI18nChunkMiddleware, createI18nMiddleware } from '@astroscope/i18n';\n *\n * export const onRequest = sequence(\n *   createI18nChunkMiddleware(),  // early: serves /_i18n/ chunks\n *   sessionMiddleware,\n *   createI18nMiddleware({ locale: (ctx) => ... }),  // after session\n * );\n * ```\n */\nexport function createI18nChunkMiddleware(): MiddlewareHandler {\n  return (ctx, next) => {\n    const { pathname } = ctx.url;\n\n    if (!pathname.startsWith(I18N_ENDPOINT_PREFIX)) {\n      return next();\n    }\n\n    if (!i18n.isConfigured()) {\n      console.warn(`[@astroscope/i18n] not configured, passing through: ${pathname}`);\n\n      return next();\n    }\n\n    const path = pathname.slice(I18N_ENDPOINT_PREFIX.length);\n\n    // attempt to parse as efficient as possible\n    // expected path format: {locale}/{chunkName}.{hash}.js\n    // avoiding regex or split for performance\n    const slashIdx = path.indexOf('/');\n\n    if (slashIdx === -1) {\n      return next();\n    }\n\n    const locale = path.slice(0, slashIdx);\n\n    // validate locale against configured locales to prevent arbitrary locale injection\n    const config = i18n.getConfig();\n\n    if (!config.locales.includes(locale)) {\n      return new Response('/* unknown locale */', {\n        status: 404,\n        headers: { 'Content-Type': 'application/javascript' },\n      });\n    }\n\n    const rest = path.slice(slashIdx + 1);\n\n    if (!rest.endsWith('.js')) {\n      return next();\n    }\n\n    const withoutJs = rest.slice(0, -3);\n    const lastDotIdx = withoutJs.lastIndexOf('.');\n\n    if (lastDotIdx === -1) {\n      return next();\n    }\n\n    const chunkName = withoutJs.slice(0, lastDotIdx);\n    const body = i18n.getChunkBody(locale, chunkName);\n\n    if (!body) {\n      return new Response(`/* chunk not found: ${chunkName} */`, {\n        status: 404,\n        headers: { 'Content-Type': 'application/javascript' },\n      });\n    }\n\n    return new Response(body as BodyInit, {\n      status: 200,\n      headers: {\n        'Content-Type': 'text/javascript; charset=utf-8',\n        'Content-Length': String(body.byteLength),\n        'Cache-Control': 'public, max-age=31536000, immutable',\n      },\n    });\n  };\n}\n\n/**\n * Create the i18n locale middleware.\n *\n * Sets up the request context with locale and translations for use by\n * `t()` and `<I18nScript />`. Place this after session middleware if\n * your locale detection depends on session/cookies.\n *\n * @example\n * ```typescript\n * import { createI18nMiddleware, detectLocale, i18n } from '@astroscope/i18n';\n *\n * export const i18nMiddleware = createI18nMiddleware({\n *   locale: (ctx) =>\n *     ctx.cookies.get('locale')?.value ??\n *     detectLocale(ctx.request) ??\n *     i18n.getConfig().defaultLocale,\n * });\n * ```\n */\nexport function createI18nMiddleware(options: I18nMiddlewareOptions): MiddlewareHandler {\n  return (ctx, next) => {\n    if (shouldExclude(ctx, options.exclude ?? RECOMMENDED_EXCLUDES)) {\n      return next();\n    }\n\n    if (!i18n.isConfigured()) {\n      console.warn(`[@astroscope/i18n] not configured, passing through: ${ctx.url.pathname}`);\n\n      return next();\n    }\n\n    const locale = options.locale(ctx);\n\n    const context: I18nContext = {\n      locale,\n      translations: i18n.getCompiledTranslations(locale),\n      rawTranslations: i18n.getTranslations(locale),\n      fallback: i18n.getConfig().fallback,\n    };\n\n    return runWithContext(context, () => next());\n  };\n}\n","import { i18n } from './i18n.js';\n\n/**\n * Detect locale from Accept-Language header.\n * Returns best match from configured locales, or undefined if none match.\n */\nexport function detectLocale(request: Request): string | undefined {\n  if (!i18n.isConfigured()) return undefined;\n\n  const { locales } = i18n.getConfig();\n  const acceptLanguage = request.headers.get('accept-language');\n\n  if (!acceptLanguage) return undefined;\n\n  const preferred = acceptLanguage\n    .split(',')\n    .map((part) => {\n      // optional whitespace around `;` is legal per rfc 9110\n      const [lang, q = 'q=1'] = part.split(';').map((s) => s.trim());\n      const baseLang = lang?.split('-')[0]?.toLowerCase();\n\n      return {\n        lang: baseLang,\n        q: parseFloat(q.replace('q=', '')),\n      };\n    })\n    .filter((p): p is { lang: string; q: number } => !!p.lang)\n    .sort((a, b) => b.q - a.q);\n\n  for (const { lang } of preferred) {\n    if (locales.includes(lang)) {\n      return lang;\n    }\n  }\n\n  return undefined;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/integration/integration.ts","../src/server/middleware.ts","../src/server/locale.ts"],"sourcesContent":["import type { AstroIntegration } from 'astro';\nimport { i18nVitePlugin } from '../extraction/vite-plugin.js';\nimport type { I18nOptions } from './types.js';\n\nconst CLIENT_DIRECTIVES = ['load-x', 'idle-x', 'visible-x', 'media-x', 'only-x'] as const;\n\n/**\n * Astro integration for i18n with automatic per-chunk translation loading.\n *\n * Registers:\n * - Client directives (`client:load-x`, `client:idle-x`, `client:visible-x`, `client:media-x`, `client:only-x`)\n * - Vite plugin for translation key extraction\n */\nexport default function i18nIntegration(options: I18nOptions = {}): AstroIntegration {\n  const { consistency = 'error' } = options;\n\n  return {\n    name: '@astroscope/i18n',\n    hooks: {\n      'astro:config:setup': ({ addClientDirective, updateConfig, logger }) => {\n        for (const directive of CLIENT_DIRECTIVES) {\n          const base = directive.replace('-x', '');\n          addClientDirective({\n            name: directive,\n            entrypoint: `@astroscope/i18n/client-directives/${base}.js`,\n          });\n        }\n\n        updateConfig({\n          vite: {\n            plugins: [i18nVitePlugin({ logger, consistency })],\n          },\n        });\n      },\n      'astro:config:done': ({ injectTypes }) => {\n        // inject client directive types for LSP support\n        const typeMap: Record<string, string> = {\n          load: 'boolean',\n          idle: 'boolean',\n          visible: 'boolean | string',\n          media: 'string',\n          only: 'string',\n        };\n\n        const attributes = CLIENT_DIRECTIVES.map((d) => {\n          const base = d.replace('-x', '');\n          return `    'client:${d}'?: ${typeMap[base]};`;\n        }).join('\\n');\n\n        injectTypes({\n          filename: 'client-directives.d.ts',\n          content: `// generated by @astroscope/i18n\ndeclare namespace astroHTML.JSX {\n  interface AstroBuiltinAttributes {\n${attributes}\n  }\n}`,\n        });\n      },\n    },\n  };\n}\n","import { type ExcludePattern, RECOMMENDED_EXCLUDES, shouldExclude } from '@astroscope/node/excludes';\nimport { overrideRequestRoute } from '@astroscope/node/log';\nimport type { APIContext, MiddlewareHandler } from 'astro';\nimport { runWithContext } from './context.js';\nimport { i18n } from './i18n.js';\nimport type { I18nContext } from './types.js';\n\nexport type I18nMiddlewareOptions = {\n  locale: (ctx: APIContext) => string;\n  /**\n   * Patterns to exclude from locale context setup.\n   * Defaults to RECOMMENDED_EXCLUDES if not provided.\n   *\n   * @example\n   * ```ts\n   * import { RECOMMENDED_EXCLUDES } from '@astroscope/node/excludes';\n   *\n   * // extend defaults\n   * createI18nMiddleware({\n   *   locale: (ctx) => ctx.locals.session?.locale ?? 'en',\n   *   exclude: [...RECOMMENDED_EXCLUDES, { exact: '/health' }],\n   * })\n   *\n   * // disable excludes entirely\n   * createI18nMiddleware({\n   *   locale: (ctx) => ctx.locals.session?.locale ?? 'en',\n   *   exclude: [],\n   * })\n   * ```\n   */\n  exclude?: ExcludePattern[] | ((context: APIContext) => boolean) | undefined;\n};\n\nconst I18N_ENDPOINT_PREFIX = '/_i18n/';\n\n// astro has no route behind the chunk endpoint, so requests would otherwise be\n// logged and measured under whatever routing matched — typically `/404`\nconst I18N_ENDPOINT_ROUTE = '/_i18n/[locale]/[chunk]';\n\n/**\n * Serve a translation chunk. Returns `undefined` when the path isn't a chunk\n * request, and the caller passes it on to astro.\n */\nfunction createChunkResponse(pathname: string): Response | undefined {\n  if (!pathname.startsWith(I18N_ENDPOINT_PREFIX)) {\n    return undefined;\n  }\n\n  if (!i18n.isConfigured()) {\n    console.warn(`[@astroscope/i18n] not configured, passing through: ${pathname}`);\n\n    return undefined;\n  }\n\n  const path = pathname.slice(I18N_ENDPOINT_PREFIX.length);\n\n  // attempt to parse as efficient as possible\n  // expected path format: {locale}/{chunkName}.{hash}.js\n  // avoiding regex or split for performance\n  const slashIdx = path.indexOf('/');\n\n  if (slashIdx === -1) {\n    return undefined;\n  }\n\n  const locale = path.slice(0, slashIdx);\n\n  // validate locale against configured locales to prevent arbitrary locale injection\n  const config = i18n.getConfig();\n\n  if (!config.locales.includes(locale)) {\n    return new Response('/* unknown locale */', {\n      status: 404,\n      headers: { 'Content-Type': 'application/javascript' },\n    });\n  }\n\n  const rest = path.slice(slashIdx + 1);\n\n  if (!rest.endsWith('.js')) {\n    return undefined;\n  }\n\n  const withoutJs = rest.slice(0, -3);\n  const lastDotIdx = withoutJs.lastIndexOf('.');\n\n  if (lastDotIdx === -1) {\n    return undefined;\n  }\n\n  const chunkName = withoutJs.slice(0, lastDotIdx);\n  const body = i18n.getChunkBody(locale, chunkName);\n\n  if (!body) {\n    return new Response(`/* chunk not found: ${chunkName} */`, {\n      status: 404,\n      headers: { 'Content-Type': 'application/javascript' },\n    });\n  }\n\n  return new Response(body as BodyInit, {\n    status: 200,\n    headers: {\n      'Content-Type': 'text/javascript; charset=utf-8',\n      'Content-Length': String(body.byteLength),\n      'Cache-Control': 'public, max-age=31536000, immutable',\n    },\n  });\n}\n\n/**\n * Create the i18n chunk middleware that serves translation chunks at `/_i18n/` endpoints.\n *\n * Place this early in your middleware sequence (before session/auth)\n * to avoid unnecessary overhead for static translation requests.\n *\n * @example\n * ```typescript\n * // src/middleware.ts\n * import { sequence } from 'astro:middleware';\n * import { createI18nChunkMiddleware, createI18nMiddleware } from '@astroscope/i18n';\n *\n * export const onRequest = sequence(\n *   createI18nChunkMiddleware(),  // early: serves /_i18n/ chunks\n *   sessionMiddleware,\n *   createI18nMiddleware({ locale: (ctx) => ... }),  // after session\n * );\n * ```\n */\nexport function createI18nChunkMiddleware(): MiddlewareHandler {\n  return (ctx, next) => {\n    const response = createChunkResponse(ctx.url.pathname);\n\n    if (!response) {\n      return next();\n    }\n\n    // this middleware, not astro's routing, is what serves the request\n    overrideRequestRoute(I18N_ENDPOINT_ROUTE);\n\n    return response;\n  };\n}\n\n/**\n * Create the i18n locale middleware.\n *\n * Sets up the request context with locale and translations for use by\n * `t()` and `<I18nScript />`. Place this after session middleware if\n * your locale detection depends on session/cookies.\n *\n * @example\n * ```typescript\n * import { createI18nMiddleware, detectLocale, i18n } from '@astroscope/i18n';\n *\n * export const i18nMiddleware = createI18nMiddleware({\n *   locale: (ctx) =>\n *     ctx.cookies.get('locale')?.value ??\n *     detectLocale(ctx.request) ??\n *     i18n.getConfig().defaultLocale,\n * });\n * ```\n */\nexport function createI18nMiddleware(options: I18nMiddlewareOptions): MiddlewareHandler {\n  return (ctx, next) => {\n    if (shouldExclude(ctx, options.exclude ?? RECOMMENDED_EXCLUDES)) {\n      return next();\n    }\n\n    if (!i18n.isConfigured()) {\n      console.warn(`[@astroscope/i18n] not configured, passing through: ${ctx.url.pathname}`);\n\n      return next();\n    }\n\n    const locale = options.locale(ctx);\n\n    const context: I18nContext = {\n      locale,\n      translations: i18n.getCompiledTranslations(locale),\n      rawTranslations: i18n.getTranslations(locale),\n      fallback: i18n.getConfig().fallback,\n    };\n\n    return runWithContext(context, () => next());\n  };\n}\n","import { i18n } from './i18n.js';\n\n/**\n * Detect locale from Accept-Language header.\n * Returns best match from configured locales, or undefined if none match.\n */\nexport function detectLocale(request: Request): string | undefined {\n  if (!i18n.isConfigured()) return undefined;\n\n  const { locales } = i18n.getConfig();\n  const acceptLanguage = request.headers.get('accept-language');\n\n  if (!acceptLanguage) return undefined;\n\n  const preferred = acceptLanguage\n    .split(',')\n    .map((part) => {\n      // optional whitespace around `;` is legal per rfc 9110\n      const [lang, q = 'q=1'] = part.split(';').map((s) => s.trim());\n      const baseLang = lang?.split('-')[0]?.toLowerCase();\n\n      return {\n        lang: baseLang,\n        q: parseFloat(q.replace('q=', '')),\n      };\n    })\n    .filter((p): p is { lang: string; q: number } => !!p.lang)\n    .sort((a, b) => b.q - a.q);\n\n  for (const { lang } of preferred) {\n    if (locales.includes(lang)) {\n      return lang;\n    }\n  }\n\n  return undefined;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astroscope/i18n",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "i18n for Astro + React islands — MessageFormat 2, automatic tree-shaking, parallel loading, any translation source",
   "type": "module",
   "main": "./dist/index.js",
@@ -95,12 +95,12 @@
     "tsdown": "^0.22.3",
     "typescript": "^6.0.3",
     "vite": "^8.1.0",
-    "@astroscope/node": "^1.2.1"
+    "@astroscope/node": "^1.3.0"
   },
   "peerDependencies": {
     "astro": "^7.0.0",
     "vite": "^8.0.0",
-    "@astroscope/node": "^1.2.1"
+    "@astroscope/node": "^1.3.0"
   },
   "scripts": {
     "build": "tsdown 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 --no-fixed-extension --deps.never-bundle astro --deps.never-bundle astro/client/load.js --deps.never-bundle astro/client/idle.js --deps.never-bundle astro/client/visible.js --deps.never-bundle astro/client/media.js --deps.never-bundle astro/client/only.js --deps.never-bundle virtual:@astroscope/i18n/manifest --deps.never-bundle @babel/core",