@astroscope/i18n 0.6.1 → 1.0.0

package/README.md

@@ -31,7 +31,7 @@ i18n for Astro + React islands — automatic tree-shaking, parallel loading, any
 ## Installation
 
 ```bash
-npm install @astroscope/i18n @astroscope/boot @astroscope/excludes
+npm install @astroscope/i18n @astroscope/node
 ```
 
 ## Usage
@@ -41,12 +41,13 @@ npm install @astroscope/i18n @astroscope/boot @astroscope/excludes
 ```ts
 // astro.config.ts
 import { defineConfig } from 'astro/config';
-import boot from '@astroscope/boot';
+import node from '@astroscope/node';
 import i18n from '@astroscope/i18n';
 
 export default defineConfig({
+  output: 'server',
+  adapter: node(),
   integrations: [
-    boot(),
     i18n(),
   ],
 });
@@ -119,7 +120,7 @@ By default, `RECOMMENDED_EXCLUDES` (static assets like `/_astro/`) are excluded
 ```ts
 import { sequence } from 'astro:middleware';
 import { createI18nChunkMiddleware, createI18nMiddleware, i18n } from '@astroscope/i18n';
-import { RECOMMENDED_EXCLUDES } from '@astroscope/excludes';
+import { RECOMMENDED_EXCLUDES } from '@astroscope/node/excludes';
 
 export const onRequest = sequence(
   createI18nChunkMiddleware(),

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { a as TranslationMeta, r as RawTranslations } from "./types-C98CcjtN.js"
 import { n as ExtractedKey, r as ExtractionManifest } from "./types-BfyoJsoB.js";
 import { n as I18nOptions } from "./types-Bo4jMK8g.js";
 import { n as i18n, r as FallbackBehavior, t as I18nConfig } from "./i18n-DzmH9JmE.js";
-import { ExcludePattern } from "@astroscope/excludes";
+import { ExcludePattern } from "@astroscope/node/excludes";
 import { APIContext, AstroIntegration, MiddlewareHandler } from "astro";
 
 //#region src/integration/integration.d.ts
@@ -24,7 +24,7 @@ type I18nMiddlewareOptions = {
    *
    * @example
    * ```ts
-   * import { RECOMMENDED_EXCLUDES } from '@astroscope/excludes';
+   * import { RECOMMENDED_EXCLUDES } from '@astroscope/node/excludes';
    *
    * // extend defaults
    * createI18nMiddleware({

package/dist/index.js

@@ -1,6 +1,6 @@
 import { t as i18nVitePlugin } from "./vite-plugin-DVUlcvEH.js";
 import { n as runWithContext, r as i18n } from "./context-DT91WgEO.js";
-import { RECOMMENDED_EXCLUDES, shouldExclude } from "@astroscope/excludes";
+import { RECOMMENDED_EXCLUDES, shouldExclude } from "@astroscope/node/excludes";
 //#region src/integration/integration.ts
 const CLIENT_DIRECTIVES = [
 	"load-x",

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/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/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  const config = i18n.getConfig();\n\n  if (!config) return undefined;\n\n  const { locales } = config;\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      const [lang, q = 'q=1'] = part.trim().split(';');\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 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  const config = i18n.getConfig();\n\n  if (!config) return undefined;\n\n  const { locales } = config;\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      const [lang, q = 'q=1'] = part.trim().split(';');\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": "0.6.1",
+  "version": "1.0.0",
   "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/excludes": "^0.4.0"
+    "@astroscope/node": "^1.0.0"
   },
   "peerDependencies": {
     "astro": "^7.0.0",
     "vite": "^8.0.0",
-    "@astroscope/excludes": "^0.4.0"
+    "@astroscope/node": "^1.0.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",