ts-intl-astro 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aaakul
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja-JP.md

@@ -0,0 +1,121 @@
+# ts-intl-astro
+
+[English](./README.md) | [简体中文](./README.zh-Hans.md) | [日本語](./README.ja-JP.md)
+
+[`ts-intl`](https://github.com/aaakul/ts-intl) をベースにした、軽量・ゼロ設定・厳格な型安全性を備えた Astro 向け国際化（i18n）インテグレーションです。Astro において `next-intl` に近い開発体験を提供します。
+
+## インストール
+
+```bash
+pnpm add ts-intl-astro
+# または
+npm install ts-intl-astro
+# または
+yarn add ts-intl-astro
+```
+
+## クイック設定
+
+### i18n インスタンスの初期化
+
+プロジェクト内に `src/i18n/index.ts` を作成します：
+
+```ts
+import { createAstroI18n } from "ts-intl-astro";
+import enUS from "./messages/en-US";
+import zhHans from "./messages/zh-Hans";
+
+export const {
+  useTranslations,
+  useLocale,
+  useFormatter,
+  languages,
+  defaultLanguage,
+} = createAstroI18n({
+  defaultLanguage: "en-US",
+  messages: {
+    "en-US": enUS,
+    "zh-Hans": zhHans,
+  },
+});
+
+export type SupportedLanguage = (typeof languages)[number];
+```
+
+### Astro インテグレーションの登録
+
+`astro.config.mjs` に `tsIntl` インテグレーションを追加します：
+
+```js
+import { defineConfig } from "astro/config";
+import tsIntl from "ts-intl-astro";
+
+export default defineConfig({
+  integrations: [tsIntl()],
+});
+```
+
+## 使い方
+
+### コンポーネント内での利用
+
+任意の Astro コンポーネント内で、`useTranslations` と `useLocale` を直接呼び出します。
+
+```astro
+---
+import { useTranslations, useLocale } from "@/i18n";
+
+const t = useTranslations("hero");
+const currentLang = useLocale();
+---
+
+<section>
+  <h1>{t("title")}</h1>
+  <p>{t("badge")}</p>
+  <a href={`/${currentLang}/docs`}>{t("getStarted")}</a>
+</section>
+```
+
+### ルートセグメントとページ設定（Route Segments）
+
+動的ルートディレクトリ構造（例：`src/pages/[lang]/index.astro` や `src/pages/[locale]/about.astro`）を用いて多言語ページを管理します。
+
+静的サイト生成（SSG）では、エクスポートされた `languages` と組み合わせて `getStaticPaths` を設定します：
+
+```astro
+---
+// src/pages/[lang]/index.astro
+import { languages, useTranslations, useLocale } from "@/i18n";
+
+export function getStaticPaths() {
+  return languages.map((lang) => ({ params: { lang } }));
+}
+
+const t = useTranslations("hero");
+const lang = useLocale();
+---
+
+<section>
+  <h1>{t("title")}</h1>
+  <a href={`/${lang}/docs`}>{t("getStarted")}</a>
+</section>
+```
+
+> **ルートセグメントに関する説明**：
+>
+> - `ts-intl-astro` は、デフォルトで `[lang]` および `[locale]` 動的ルートセグメントを自動認識します。
+> - ミドルウェアがページ実行前にルートセグメントから言語を自動抽出し、コンテキストに書き込みます。ページ内の任意の子コンポーネントから直接 `useTranslations()` / `useLocale()` で現在の言語を取得できるため、`lang` 属性を手動でバケツリレー（Props Drilling）する必要はありません。
+> - カスタムパラメータ名（例：`[localeCode]`）を使用する場合は、`createAstroI18n({ paramNames: ["localeCode"] })` で設定できます。
+
+## よく使う API
+
+| API                               | 説明                                                       | 例                                             |
+| :-------------------------------- | :--------------------------------------------------------- | :--------------------------------------------- |
+| `useTranslations(namespace?)`     | 現在の言語にバインドされた翻訳関数を取得します             | `const t = useTranslations("common")`          |
+| `useTranslations(ns, { locale })` | 現在のコンポーネントの言語を明示的に上書きします           | `useTranslations("hero", { locale: "ja-JP" })` |
+| `useLocale()`                     | 現在のリクエストコンテキストの言語識別子文字列を取得します | `const lang = useLocale()`                     |
+| `useFormatter()`                  | 現在の言語の `Intl` フォーマッターを取得します             | `const fmt = useFormatter()`                   |
+
+## ライセンス
+
+[MIT](./LICENSE)

package/README.md

@@ -0,0 +1,121 @@
+# ts-intl-astro
+
+[English](./README.md) | [简体中文](./README.zh-Hans.md) | [日本語](./README.ja-JP.md)
+
+A lightweight, zero-config, strictly type-safe Astro integration for internationalization (i18n), powered by [`ts-intl`](https://github.com/aaakul/ts-intl). Delivers a developer experience similar to `next-intl` in Astro.
+
+## Installation
+
+```bash
+pnpm add ts-intl-astro
+# or
+npm install ts-intl-astro
+# or
+yarn add ts-intl-astro
+```
+
+## Quick Setup
+
+### Initialize the i18n Instance
+
+Create `src/i18n/index.ts` in your project:
+
+```ts
+import { createAstroI18n } from "ts-intl-astro";
+import enUS from "./messages/en-US";
+import zhHans from "./messages/zh-Hans";
+
+export const {
+  useTranslations,
+  useLocale,
+  useFormatter,
+  languages,
+  defaultLanguage,
+} = createAstroI18n({
+  defaultLanguage: "en-US",
+  messages: {
+    "en-US": enUS,
+    "zh-Hans": zhHans,
+  },
+});
+
+export type SupportedLanguage = (typeof languages)[number];
+```
+
+### Register the Astro Integration
+
+Add the `tsIntl` integration to `astro.config.mjs`:
+
+```js
+import { defineConfig } from "astro/config";
+import tsIntl from "ts-intl-astro";
+
+export default defineConfig({
+  integrations: [tsIntl()],
+});
+```
+
+## Usage
+
+### In Components
+
+In any Astro component, call `useTranslations` and `useLocale` directly.
+
+```astro
+---
+import { useTranslations, useLocale } from "@/i18n";
+
+const t = useTranslations("hero");
+const currentLang = useLocale();
+---
+
+<section>
+  <h1>{t("title")}</h1>
+  <p>{t("badge")}</p>
+  <a href={`/${currentLang}/docs`}>{t("getStarted")}</a>
+</section>
+```
+
+### Route Segments and Page Configuration (Route Segments)
+
+Manage multilingual pages using dynamic route directory structures (e.g. `src/pages/[lang]/index.astro` or `src/pages/[locale]/about.astro`).
+
+For Static Site Generation (SSG), configure `getStaticPaths` with the exported `languages`:
+
+```astro
+---
+// src/pages/[lang]/index.astro
+import { languages, useTranslations, useLocale } from "@/i18n";
+
+export function getStaticPaths() {
+  return languages.map((lang) => ({ params: { lang } }));
+}
+
+const t = useTranslations("hero");
+const lang = useLocale();
+---
+
+<section>
+  <h1>{t("title")}</h1>
+  <a href={`/${lang}/docs`}>{t("getStarted")}</a>
+</section>
+```
+
+> **Route Segments Note**:
+>
+> - `ts-intl-astro` automatically recognizes `[lang]` and `[locale]` dynamic route segments by default.
+> - The middleware automatically extracts the locale from the route segment before page execution and writes it into the context. Any child components within the page can directly access the current locale via `useTranslations()` / `useLocale()`, with no need to drill the `lang` prop down manually.
+> - If you use custom parameter names (e.g. `[localeCode]`), configure them via `createAstroI18n({ paramNames: ["localeCode"] })`.
+
+## Common APIs
+
+| API                               | Description                                              | Example                                        |
+| :-------------------------------- | :------------------------------------------------------- | :--------------------------------------------- |
+| `useTranslations(namespace?)`     | Get the translation function bound to the active locale  | `const t = useTranslations("common")`          |
+| `useTranslations(ns, { locale })` | Explicitly override the locale for the current component | `useTranslations("hero", { locale: "ja-JP" })` |
+| `useLocale()`                     | Get the locale string from the current request context   | `const lang = useLocale()`                     |
+| `useFormatter()`                  | Get the `Intl` formatter for the current locale          | `const fmt = useFormatter()`                   |
+
+## License
+
+[MIT](./LICENSE)

package/README.zh-Hans.md

@@ -0,0 +1,121 @@
+# ts-intl-astro
+
+[English](./README.md) | [简体中文](./README.zh-Hans.md) | [日本語](./README.ja-JP.md)
+
+轻量、零配置、严格类型安全的国际化（i18n） Astro 集成，基于 [`ts-intl`](https://github.com/aaakul/ts-intl)。在 Astro 中提供与 `next-intl` 相似的使用体验。
+
+## 安装
+
+```bash
+pnpm add ts-intl-astro
+# 或
+npm install ts-intl-astro
+# 或
+yarn add ts-intl-astro
+```
+
+## 快速配置
+
+### 初始化 i18n 实例
+
+在项目中创建 `src/i18n/index.ts`：
+
+```ts
+import { createAstroI18n } from "ts-intl-astro";
+import enUS from "./messages/en-US";
+import zhHans from "./messages/zh-Hans";
+
+export const {
+  useTranslations,
+  useLocale,
+  useFormatter,
+  languages,
+  defaultLanguage,
+} = createAstroI18n({
+  defaultLanguage: "en-US",
+  messages: {
+    "en-US": enUS,
+    "zh-Hans": zhHans,
+  },
+});
+
+export type SupportedLanguage = (typeof languages)[number];
+```
+
+### 注册 Astro 集成
+
+在 `astro.config.mjs` 中添加 `tsIntl` 集成：
+
+```js
+import { defineConfig } from "astro/config";
+import tsIntl from "ts-intl-astro";
+
+export default defineConfig({
+  integrations: [tsIntl()],
+});
+```
+
+## 使用
+
+### 组件内使用
+
+在任何 Astro 组件中，直接调用 `useTranslations` 与 `useLocale`。
+
+```astro
+---
+import { useTranslations, useLocale } from "@/i18n";
+
+const t = useTranslations("hero");
+const currentLang = useLocale();
+---
+
+<section>
+  <h1>{t("title")}</h1>
+  <p>{t("badge")}</p>
+  <a href={`/${currentLang}/docs`}>{t("getStarted")}</a>
+</section>
+```
+
+### 路由段与页面配置（Route Segments）
+
+通过动态路由目录结构管理多语言页面（如 `src/pages/[lang]/index.astro` 或 `src/pages/[locale]/about.astro`）。
+
+在静态生成（SSG）中，配合导出的 `languages` 配置 `getStaticPaths`：
+
+```astro
+---
+// src/pages/[lang]/index.astro
+import { languages, useTranslations, useLocale} from "@/i18n";
+
+export function getStaticPaths() {
+  return languages.map((lang) => ({ params: { lang } }));
+}
+
+const t = useTranslations("hero");
+const lang = useLocale();
+---
+
+<section>
+  <h1>{t("title")}</h1>
+  <a href={`/${lang}/docs`}>{t("getStarted")}</a>
+</section>
+```
+
+> **路由段说明**：
+>
+> - `ts-intl-astro` 默认自动识别 `[lang]` 与 `[locale]` 动态路由段。
+> - 中间件会在页面执行前自动提取路由段中的语言并写入上下文，页面内部的任意子组件均可直接通过 `useTranslations()` / `useLocale()` 获取当前语言，无需手动逐层传递 `lang` 属性。
+> - 若使用自定义参数名（如 `[localeCode]`），可在 `createAstroI18n({ paramNames: ["localeCode"] })` 中配置。
+
+## 常用 API
+
+| API                               | 说明                               | 示例                                           |
+| :-------------------------------- | :--------------------------------- | :--------------------------------------------- |
+| `useTranslations(namespace?)`     | 获取当前语言绑定的翻译函数         | `const t = useTranslations("common")`          |
+| `useTranslations(ns, { locale })` | 显式覆盖当前组件的语言             | `useTranslations("hero", { locale: "ja-JP" })` |
+| `useLocale()`                     | 获取当前请求上下文的语言标识字符串 | `const lang = useLocale()`                     |
+| `useFormatter()`                  | 获取当前语言的 `Intl` 格式化器     | `const fmt = useFormatter()`                   |
+
+## 开源协议
+
+[MIT](./LICENSE)

package/dist/chunk-25H6BZD6.cjs

@@ -0,0 +1,105 @@
+'use strict';
+
+var async_hooks = require('async_hooks');
+
+// src/context.ts
+var STORAGE_KEY = /* @__PURE__ */ Symbol.for("ts-intl-astro/storage");
+var FALLBACK_LANG_KEY = /* @__PURE__ */ Symbol.for("ts-intl-astro/fallbackLang");
+var g = globalThis;
+var i18nStorage = g[STORAGE_KEY] || (g[STORAGE_KEY] = new async_hooks.AsyncLocalStorage());
+function setGlobalFallbackLanguage(lang) {
+  g[FALLBACK_LANG_KEY] = lang;
+}
+function getGlobalFallbackLanguage() {
+  return g[FALLBACK_LANG_KEY] || "en";
+}
+function getActiveLocale(fallback) {
+  const store = i18nStorage.getStore();
+  if (store?.locale) {
+    return store.locale;
+  }
+  return fallback || getGlobalFallbackLanguage();
+}
+function runWithLocale(locale, fn) {
+  return i18nStorage.run({ locale }, fn);
+}
+
+// src/resolver.ts
+function resolveRequestLocale(context, options) {
+  const {
+    supportedLanguages,
+    defaultLanguage,
+    paramNames = ["lang", "locale"]
+  } = options;
+  if (context.currentLocale && supportedLanguages.includes(context.currentLocale)) {
+    return context.currentLocale;
+  }
+  if (context.params) {
+    for (const name of paramNames) {
+      const paramVal = context.params[name];
+      if (paramVal && supportedLanguages.includes(paramVal)) {
+        return paramVal;
+      }
+    }
+  }
+  if (context.url && context.url.pathname) {
+    const segments = context.url.pathname.split("/").filter(Boolean);
+    for (const segment of segments) {
+      if (supportedLanguages.includes(segment)) {
+        return segment;
+      }
+    }
+  }
+  return defaultLanguage;
+}
+
+// src/middleware.ts
+var OPTIONS_KEY = /* @__PURE__ */ Symbol.for("ts-intl-astro/middlewareOptions");
+var SAFE_LOCALE_PATTERN = /^[a-zA-Z0-9_-]{2,16}$/;
+var g2 = globalThis;
+function setGlobalMiddlewareOptions(options) {
+  g2[OPTIONS_KEY] = options;
+}
+function getGlobalMiddlewareOptions() {
+  return g2[OPTIONS_KEY];
+}
+function createI18nMiddleware(options) {
+  return async (context, next) => {
+    const locale = resolveRequestLocale(context, options);
+    if (!context.locals) {
+      context.locals = {};
+    }
+    context.locals.locale = locale;
+    context.locals.lang = locale;
+    return runWithLocale(locale, () => next());
+  };
+}
+var onRequest = async (context, next) => {
+  const options = getGlobalMiddlewareOptions();
+  let locale;
+  if (options) {
+    locale = resolveRequestLocale(context, options);
+  } else {
+    const candidate = context.currentLocale || context.params?.lang || context.params?.locale;
+    const fallback = getGlobalFallbackLanguage();
+    locale = candidate && SAFE_LOCALE_PATTERN.test(candidate) ? candidate : fallback;
+  }
+  if (!context.locals) {
+    context.locals = {};
+  }
+  context.locals.locale = locale;
+  context.locals.lang = locale;
+  return runWithLocale(locale, () => next());
+};
+
+exports.createI18nMiddleware = createI18nMiddleware;
+exports.getActiveLocale = getActiveLocale;
+exports.getGlobalMiddlewareOptions = getGlobalMiddlewareOptions;
+exports.i18nStorage = i18nStorage;
+exports.onRequest = onRequest;
+exports.resolveRequestLocale = resolveRequestLocale;
+exports.runWithLocale = runWithLocale;
+exports.setGlobalFallbackLanguage = setGlobalFallbackLanguage;
+exports.setGlobalMiddlewareOptions = setGlobalMiddlewareOptions;
+//# sourceMappingURL=chunk-25H6BZD6.cjs.map
+//# sourceMappingURL=chunk-25H6BZD6.cjs.map

package/dist/chunk-25H6BZD6.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts","../src/resolver.ts","../src/middleware.ts"],"names":["AsyncLocalStorage","g"],"mappings":"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","file":"chunk-25H6BZD6.cjs","sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { I18nContextStore } from \"./types\";\n\nconst STORAGE_KEY = Symbol.for(\"ts-intl-astro/storage\");\nconst FALLBACK_LANG_KEY = Symbol.for(\"ts-intl-astro/fallbackLang\");\n\ntype GlobalThisWithStorage = typeof globalThis & {\n  [STORAGE_KEY]?: AsyncLocalStorage<I18nContextStore>;\n  [FALLBACK_LANG_KEY]?: string;\n};\n\nconst g = globalThis as GlobalThisWithStorage;\n\nexport const i18nStorage: AsyncLocalStorage<I18nContextStore> =\n  g[STORAGE_KEY] ||\n  (g[STORAGE_KEY] = new AsyncLocalStorage<I18nContextStore>());\n\n/**\n * Sets a global fallback language when no active context is found.\n */\nexport function setGlobalFallbackLanguage(lang: string): void {\n  g[FALLBACK_LANG_KEY] = lang;\n}\n\nexport function getGlobalFallbackLanguage(): string {\n  return g[FALLBACK_LANG_KEY] || \"en\";\n}\n\n/**\n * Gets the current active locale from AsyncLocalStorage.\n * Falls back to globalFallbackLanguage if no context has been established.\n */\nexport function getActiveLocale(fallback?: string): string {\n  const store = i18nStorage.getStore();\n  if (store?.locale) {\n    return store.locale;\n  }\n  return fallback || getGlobalFallbackLanguage();\n}\n\n/**\n * Executes a callback within an isolated i18n context for the specified locale.\n */\nexport function runWithLocale<T>(locale: string, fn: () => T): T {\n  return i18nStorage.run({ locale }, fn);\n}\n","import type { AstroCompatibleContext } from \"./types\";\n\nexport interface ResolveLocaleOptions {\n  supportedLanguages: readonly string[];\n  defaultLanguage: string;\n  paramNames?: string[];\n}\n\n/**\n * Resolves the request locale from context.currentLocale, route params, or URL path segments.\n */\nexport function resolveRequestLocale(\n  context: AstroCompatibleContext,\n  options: ResolveLocaleOptions,\n): string {\n  const {\n    supportedLanguages,\n    defaultLanguage,\n    paramNames = [\"lang\", \"locale\"],\n  } = options;\n\n  if (\n    context.currentLocale &&\n    supportedLanguages.includes(context.currentLocale)\n  ) {\n    return context.currentLocale;\n  }\n\n  if (context.params) {\n    for (const name of paramNames) {\n      const paramVal = context.params[name];\n      if (paramVal && supportedLanguages.includes(paramVal)) {\n        return paramVal;\n      }\n    }\n  }\n\n  if (context.url && context.url.pathname) {\n    const segments = context.url.pathname.split(\"/\").filter(Boolean);\n    for (const segment of segments) {\n      if (supportedLanguages.includes(segment)) {\n        return segment;\n      }\n    }\n  }\n\n  return defaultLanguage;\n}\n","import { getGlobalFallbackLanguage, runWithLocale } from \"./context\";\nimport { resolveRequestLocale, type ResolveLocaleOptions } from \"./resolver\";\nimport type {\n  AstroCompatibleContext,\n  AstroMiddlewareFn,\n  AstroMiddlewareNext,\n} from \"./types\";\n\nconst OPTIONS_KEY = Symbol.for(\"ts-intl-astro/middlewareOptions\");\nconst SAFE_LOCALE_PATTERN = /^[a-zA-Z0-9_-]{2,16}$/;\n\ntype GlobalThisWithOptions = typeof globalThis & {\n  [OPTIONS_KEY]?: ResolveLocaleOptions;\n};\n\nconst g = globalThis as GlobalThisWithOptions;\n\n/**\n * Registers global options for the standalone middleware entry point.\n */\nexport function setGlobalMiddlewareOptions(\n  options: ResolveLocaleOptions,\n): void {\n  g[OPTIONS_KEY] = options;\n}\n\nexport function getGlobalMiddlewareOptions(): ResolveLocaleOptions | undefined {\n  return g[OPTIONS_KEY];\n}\n\n/**\n * Factory that creates an Astro-compatible middleware function.\n */\nexport function createI18nMiddleware(\n  options: ResolveLocaleOptions,\n): AstroMiddlewareFn {\n  return async (\n    context: AstroCompatibleContext,\n    next: AstroMiddlewareNext,\n  ): Promise<Response> => {\n    const locale = resolveRequestLocale(context, options);\n\n    if (!context.locals) {\n      context.locals = {};\n    }\n    context.locals.locale = locale;\n    context.locals.lang = locale;\n\n    return runWithLocale(locale, () => next());\n  };\n}\n\n/**\n * Standalone Astro middleware handler.\n * Uses options registered via setGlobalMiddlewareOptions or defaults.\n */\nexport const onRequest: AstroMiddlewareFn = async (\n  context: AstroCompatibleContext,\n  next: AstroMiddlewareNext,\n): Promise<Response> => {\n  const options = getGlobalMiddlewareOptions();\n  let locale: string;\n\n  if (options) {\n    locale = resolveRequestLocale(context, options);\n  } else {\n    const candidate =\n      context.currentLocale || context.params?.lang || context.params?.locale;\n    const fallback = getGlobalFallbackLanguage();\n    locale =\n      candidate && SAFE_LOCALE_PATTERN.test(candidate) ? candidate : fallback;\n  }\n\n  if (!context.locals) {\n    context.locals = {};\n  }\n  context.locals.locale = locale;\n  context.locals.lang = locale;\n\n  return runWithLocale(locale, () => next());\n};\n"]}

package/dist/chunk-YRAJZM57.js

@@ -0,0 +1,95 @@
+import { AsyncLocalStorage } from 'async_hooks';
+
+// src/context.ts
+var STORAGE_KEY = /* @__PURE__ */ Symbol.for("ts-intl-astro/storage");
+var FALLBACK_LANG_KEY = /* @__PURE__ */ Symbol.for("ts-intl-astro/fallbackLang");
+var g = globalThis;
+var i18nStorage = g[STORAGE_KEY] || (g[STORAGE_KEY] = new AsyncLocalStorage());
+function setGlobalFallbackLanguage(lang) {
+  g[FALLBACK_LANG_KEY] = lang;
+}
+function getGlobalFallbackLanguage() {
+  return g[FALLBACK_LANG_KEY] || "en";
+}
+function getActiveLocale(fallback) {
+  const store = i18nStorage.getStore();
+  if (store?.locale) {
+    return store.locale;
+  }
+  return fallback || getGlobalFallbackLanguage();
+}
+function runWithLocale(locale, fn) {
+  return i18nStorage.run({ locale }, fn);
+}
+
+// src/resolver.ts
+function resolveRequestLocale(context, options) {
+  const {
+    supportedLanguages,
+    defaultLanguage,
+    paramNames = ["lang", "locale"]
+  } = options;
+  if (context.currentLocale && supportedLanguages.includes(context.currentLocale)) {
+    return context.currentLocale;
+  }
+  if (context.params) {
+    for (const name of paramNames) {
+      const paramVal = context.params[name];
+      if (paramVal && supportedLanguages.includes(paramVal)) {
+        return paramVal;
+      }
+    }
+  }
+  if (context.url && context.url.pathname) {
+    const segments = context.url.pathname.split("/").filter(Boolean);
+    for (const segment of segments) {
+      if (supportedLanguages.includes(segment)) {
+        return segment;
+      }
+    }
+  }
+  return defaultLanguage;
+}
+
+// src/middleware.ts
+var OPTIONS_KEY = /* @__PURE__ */ Symbol.for("ts-intl-astro/middlewareOptions");
+var SAFE_LOCALE_PATTERN = /^[a-zA-Z0-9_-]{2,16}$/;
+var g2 = globalThis;
+function setGlobalMiddlewareOptions(options) {
+  g2[OPTIONS_KEY] = options;
+}
+function getGlobalMiddlewareOptions() {
+  return g2[OPTIONS_KEY];
+}
+function createI18nMiddleware(options) {
+  return async (context, next) => {
+    const locale = resolveRequestLocale(context, options);
+    if (!context.locals) {
+      context.locals = {};
+    }
+    context.locals.locale = locale;
+    context.locals.lang = locale;
+    return runWithLocale(locale, () => next());
+  };
+}
+var onRequest = async (context, next) => {
+  const options = getGlobalMiddlewareOptions();
+  let locale;
+  if (options) {
+    locale = resolveRequestLocale(context, options);
+  } else {
+    const candidate = context.currentLocale || context.params?.lang || context.params?.locale;
+    const fallback = getGlobalFallbackLanguage();
+    locale = candidate && SAFE_LOCALE_PATTERN.test(candidate) ? candidate : fallback;
+  }
+  if (!context.locals) {
+    context.locals = {};
+  }
+  context.locals.locale = locale;
+  context.locals.lang = locale;
+  return runWithLocale(locale, () => next());
+};
+
+export { createI18nMiddleware, getActiveLocale, getGlobalMiddlewareOptions, i18nStorage, onRequest, resolveRequestLocale, runWithLocale, setGlobalFallbackLanguage, setGlobalMiddlewareOptions };
+//# sourceMappingURL=chunk-YRAJZM57.js.map
+//# sourceMappingURL=chunk-YRAJZM57.js.map

package/dist/chunk-YRAJZM57.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts","../src/resolver.ts","../src/middleware.ts"],"names":["g"],"mappings":"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","file":"chunk-YRAJZM57.js","sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { I18nContextStore } from \"./types\";\n\nconst STORAGE_KEY = Symbol.for(\"ts-intl-astro/storage\");\nconst FALLBACK_LANG_KEY = Symbol.for(\"ts-intl-astro/fallbackLang\");\n\ntype GlobalThisWithStorage = typeof globalThis & {\n  [STORAGE_KEY]?: AsyncLocalStorage<I18nContextStore>;\n  [FALLBACK_LANG_KEY]?: string;\n};\n\nconst g = globalThis as GlobalThisWithStorage;\n\nexport const i18nStorage: AsyncLocalStorage<I18nContextStore> =\n  g[STORAGE_KEY] ||\n  (g[STORAGE_KEY] = new AsyncLocalStorage<I18nContextStore>());\n\n/**\n * Sets a global fallback language when no active context is found.\n */\nexport function setGlobalFallbackLanguage(lang: string): void {\n  g[FALLBACK_LANG_KEY] = lang;\n}\n\nexport function getGlobalFallbackLanguage(): string {\n  return g[FALLBACK_LANG_KEY] || \"en\";\n}\n\n/**\n * Gets the current active locale from AsyncLocalStorage.\n * Falls back to globalFallbackLanguage if no context has been established.\n */\nexport function getActiveLocale(fallback?: string): string {\n  const store = i18nStorage.getStore();\n  if (store?.locale) {\n    return store.locale;\n  }\n  return fallback || getGlobalFallbackLanguage();\n}\n\n/**\n * Executes a callback within an isolated i18n context for the specified locale.\n */\nexport function runWithLocale<T>(locale: string, fn: () => T): T {\n  return i18nStorage.run({ locale }, fn);\n}\n","import type { AstroCompatibleContext } from \"./types\";\n\nexport interface ResolveLocaleOptions {\n  supportedLanguages: readonly string[];\n  defaultLanguage: string;\n  paramNames?: string[];\n}\n\n/**\n * Resolves the request locale from context.currentLocale, route params, or URL path segments.\n */\nexport function resolveRequestLocale(\n  context: AstroCompatibleContext,\n  options: ResolveLocaleOptions,\n): string {\n  const {\n    supportedLanguages,\n    defaultLanguage,\n    paramNames = [\"lang\", \"locale\"],\n  } = options;\n\n  if (\n    context.currentLocale &&\n    supportedLanguages.includes(context.currentLocale)\n  ) {\n    return context.currentLocale;\n  }\n\n  if (context.params) {\n    for (const name of paramNames) {\n      const paramVal = context.params[name];\n      if (paramVal && supportedLanguages.includes(paramVal)) {\n        return paramVal;\n      }\n    }\n  }\n\n  if (context.url && context.url.pathname) {\n    const segments = context.url.pathname.split(\"/\").filter(Boolean);\n    for (const segment of segments) {\n      if (supportedLanguages.includes(segment)) {\n        return segment;\n      }\n    }\n  }\n\n  return defaultLanguage;\n}\n","import { getGlobalFallbackLanguage, runWithLocale } from \"./context\";\nimport { resolveRequestLocale, type ResolveLocaleOptions } from \"./resolver\";\nimport type {\n  AstroCompatibleContext,\n  AstroMiddlewareFn,\n  AstroMiddlewareNext,\n} from \"./types\";\n\nconst OPTIONS_KEY = Symbol.for(\"ts-intl-astro/middlewareOptions\");\nconst SAFE_LOCALE_PATTERN = /^[a-zA-Z0-9_-]{2,16}$/;\n\ntype GlobalThisWithOptions = typeof globalThis & {\n  [OPTIONS_KEY]?: ResolveLocaleOptions;\n};\n\nconst g = globalThis as GlobalThisWithOptions;\n\n/**\n * Registers global options for the standalone middleware entry point.\n */\nexport function setGlobalMiddlewareOptions(\n  options: ResolveLocaleOptions,\n): void {\n  g[OPTIONS_KEY] = options;\n}\n\nexport function getGlobalMiddlewareOptions(): ResolveLocaleOptions | undefined {\n  return g[OPTIONS_KEY];\n}\n\n/**\n * Factory that creates an Astro-compatible middleware function.\n */\nexport function createI18nMiddleware(\n  options: ResolveLocaleOptions,\n): AstroMiddlewareFn {\n  return async (\n    context: AstroCompatibleContext,\n    next: AstroMiddlewareNext,\n  ): Promise<Response> => {\n    const locale = resolveRequestLocale(context, options);\n\n    if (!context.locals) {\n      context.locals = {};\n    }\n    context.locals.locale = locale;\n    context.locals.lang = locale;\n\n    return runWithLocale(locale, () => next());\n  };\n}\n\n/**\n * Standalone Astro middleware handler.\n * Uses options registered via setGlobalMiddlewareOptions or defaults.\n */\nexport const onRequest: AstroMiddlewareFn = async (\n  context: AstroCompatibleContext,\n  next: AstroMiddlewareNext,\n): Promise<Response> => {\n  const options = getGlobalMiddlewareOptions();\n  let locale: string;\n\n  if (options) {\n    locale = resolveRequestLocale(context, options);\n  } else {\n    const candidate =\n      context.currentLocale || context.params?.lang || context.params?.locale;\n    const fallback = getGlobalFallbackLanguage();\n    locale =\n      candidate && SAFE_LOCALE_PATTERN.test(candidate) ? candidate : fallback;\n  }\n\n  if (!context.locals) {\n    context.locals = {};\n  }\n  context.locals.locale = locale;\n  context.locals.lang = locale;\n\n  return runWithLocale(locale, () => next());\n};\n"]}

package/dist/index.cjs

@@ -0,0 +1,123 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var chunk25H6BZD6_cjs = require('./chunk-25H6BZD6.cjs');
+var tsIntl = require('@aaakul/ts-intl');
+
+function createAstroI18n(config) {
+  const core = tsIntl.createI18n(config);
+  chunk25H6BZD6_cjs.setGlobalFallbackLanguage(config.defaultLanguage);
+  const resolverOptions = {
+    supportedLanguages: core.languages,
+    defaultLanguage: core.defaultLanguage,
+    paramNames: config.paramNames
+  };
+  chunk25H6BZD6_cjs.setGlobalMiddlewareOptions(resolverOptions);
+  const i18nMiddleware = chunk25H6BZD6_cjs.createI18nMiddleware(resolverOptions);
+  function useTranslations(arg1, arg2) {
+    let namespace;
+    let options;
+    if (typeof arg1 === "string") {
+      namespace = arg1;
+      options = arg2;
+    } else if (typeof arg1 === "object" && arg1 !== null) {
+      options = arg1;
+    }
+    const activeLocale = options?.locale || chunk25H6BZD6_cjs.getActiveLocale(config.defaultLanguage);
+    return core.getTranslations(activeLocale, namespace);
+  }
+  function useLocale() {
+    return chunk25H6BZD6_cjs.getActiveLocale(config.defaultLanguage);
+  }
+  function useFormatter(options) {
+    const activeLocale = options?.locale || chunk25H6BZD6_cjs.getActiveLocale(config.defaultLanguage);
+    return core.getFormatter(activeLocale);
+  }
+  return {
+    languages: core.languages,
+    defaultLanguage: core.defaultLanguage,
+    isSupportedLanguage: core.isSupportedLanguage,
+    useTranslations,
+    useLocale,
+    useFormatter,
+    i18nMiddleware,
+    getTranslations: core.getTranslations,
+    getFormatter: core.getFormatter
+  };
+}
+
+// src/integration.ts
+function tsIntlAstro(options = {}) {
+  const middlewareEntrypoint = options.middlewareEntrypoint || "ts-intl-astro/middleware";
+  return {
+    name: "ts-intl-astro",
+    hooks: {
+      "astro:config:setup": (params) => {
+        const { addMiddleware, logger } = params;
+        if (typeof addMiddleware === "function") {
+          addMiddleware({
+            entrypoint: middlewareEntrypoint,
+            order: "pre"
+          });
+        } else if (logger && typeof logger.warn === "function") {
+          logger.warn(
+            "Current Astro version does not support `addMiddleware`. Please export `onRequest = i18nMiddleware` in `src/middleware.ts` manually."
+          );
+        }
+      }
+    }
+  };
+}
+var integration_default = tsIntlAstro;
+
+Object.defineProperty(exports, "createI18nMiddleware", {
+  enumerable: true,
+  get: function () { return chunk25H6BZD6_cjs.createI18nMiddleware; }
+});
+Object.defineProperty(exports, "getActiveLocale", {
+  enumerable: true,
+  get: function () { return chunk25H6BZD6_cjs.getActiveLocale; }
+});
+Object.defineProperty(exports, "i18nStorage", {
+  enumerable: true,
+  get: function () { return chunk25H6BZD6_cjs.i18nStorage; }
+});
+Object.defineProperty(exports, "onRequest", {
+  enumerable: true,
+  get: function () { return chunk25H6BZD6_cjs.onRequest; }
+});
+Object.defineProperty(exports, "resolveRequestLocale", {
+  enumerable: true,
+  get: function () { return chunk25H6BZD6_cjs.resolveRequestLocale; }
+});
+Object.defineProperty(exports, "runWithLocale", {
+  enumerable: true,
+  get: function () { return chunk25H6BZD6_cjs.runWithLocale; }
+});
+Object.defineProperty(exports, "setGlobalFallbackLanguage", {
+  enumerable: true,
+  get: function () { return chunk25H6BZD6_cjs.setGlobalFallbackLanguage; }
+});
+Object.defineProperty(exports, "setGlobalMiddlewareOptions", {
+  enumerable: true,
+  get: function () { return chunk25H6BZD6_cjs.setGlobalMiddlewareOptions; }
+});
+Object.defineProperty(exports, "I18nError", {
+  enumerable: true,
+  get: function () { return tsIntl.I18nError; }
+});
+Object.defineProperty(exports, "I18nErrorCode", {
+  enumerable: true,
+  get: function () { return tsIntl.I18nErrorCode; }
+});
+Object.defineProperty(exports, "createI18n", {
+  enumerable: true,
+  get: function () { return tsIntl.createI18n; }
+});
+exports.createAstroI18n = createAstroI18n;
+exports.default = integration_default;
+exports.tsIntl = tsIntlAstro;
+exports.tsIntlAstro = tsIntlAstro;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/factory.ts","../src/integration.ts"],"names":["createI18n","setGlobalFallbackLanguage","setGlobalMiddlewareOptions","createI18nMiddleware","getActiveLocale"],"mappings":";;;;;;;AA0BO,SAAS,gBAId,MAAA,EACiD;AAIjD,EAAA,MAAM,IAAA,GAAOA,kBAAW,MAAM,CAAA;AAE9B,EAAAC,2CAAA,CAA0B,OAAO,eAAe,CAAA;AAEhD,EAAA,MAAM,eAAA,GAAkB;AAAA,IACtB,oBAAoB,IAAA,CAAK,SAAA;AAAA,IACzB,iBAAiB,IAAA,CAAK,eAAA;AAAA,IACtB,YAAY,MAAA,CAAO;AAAA,GACrB;AAEA,EAAAC,4CAAA,CAA2B,eAAe,CAAA;AAE1C,EAAA,MAAM,cAAA,GAAiBC,uCAAqB,eAAe,CAAA;AAS3D,EAAA,SAAS,eAAA,CAAgB,MAAY,IAAA,EAAiB;AACpD,IAAA,IAAI,SAAA;AACJ,IAAA,IAAI,OAAA;AAEJ,IAAA,IAAI,OAAO,SAAS,QAAA,EAAU;AAC5B,MAAA,SAAA,GAAY,IAAA;AACZ,MAAA,OAAA,GAAU,IAAA;AAAA,IACZ,CAAA,MAAA,IAAW,OAAO,IAAA,KAAS,QAAA,IAAY,SAAS,IAAA,EAAM;AACpD,MAAA,OAAA,GAAU,IAAA;AAAA,IACZ;AAEA,IAAA,MAAM,YAAA,GACJ,OAAA,EAAS,MAAA,IAAUC,iCAAA,CAAgB,OAAO,eAAe,CAAA;AAC3D,IAAA,OAAQ,IAAA,CAAK,eAAA,CAAwB,YAAA,EAAc,SAAS,CAAA;AAAA,EAC9D;AAEA,EAAA,SAAS,SAAA,GAA+B;AACtC,IAAA,OAAOA,iCAAA,CAAgB,OAAO,eAAe,CAAA;AAAA,EAC/C;AAEA,EAAA,SAAS,aAAa,OAAA,EAAqD;AACzE,IAAA,MAAM,YAAA,GACJ,OAAA,EAAS,MAAA,IAAUA,iCAAA,CAAgB,OAAO,eAAe,CAAA;AAC3D,IAAA,OAAO,IAAA,CAAK,aAAa,YAAY,CAAA;AAAA,EACvC;AAEA,EAAA,OAAO;AAAA,IACL,WAAW,IAAA,CAAK,SAAA;AAAA,IAChB,iBAAiB,IAAA,CAAK,eAAA;AAAA,IACtB,qBAAqB,IAAA,CAAK,mBAAA;AAAA,IAC1B,eAAA;AAAA,IACA,SAAA;AAAA,IACA,YAAA;AAAA,IACA,cAAA;AAAA,IACA,iBAAiB,IAAA,CAAK,eAAA;AAAA,IACtB,cAAc,IAAA,CAAK;AAAA,GACrB;AACF;;;AC/EO,SAAS,WAAA,CAAY,OAAA,GAAoC,EAAC,EAG/D;AACA,EAAA,MAAM,oBAAA,GACJ,QAAQ,oBAAA,IAAwB,0BAAA;AAElC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,eAAA;AAAA,IACN,KAAA,EAAO;AAAA,MACL,oBAAA,EAAsB,CAAC,MAAA,KAAgB;AACrC,QAAA,MAAM,EAAE,aAAA,EAAe,MAAA,EAAO,GAAI,MAAA;AAElC,QAAA,IAAI,OAAO,kBAAkB,UAAA,EAAY;AACvC,UAAA,aAAA,CAAc;AAAA,YACZ,UAAA,EAAY,oBAAA;AAAA,YACZ,KAAA,EAAO;AAAA,WACR,CAAA;AAAA,QACH,CAAA,MAAA,IAAW,MAAA,IAAU,OAAO,MAAA,CAAO,SAAS,UAAA,EAAY;AACtD,UAAA,MAAA,CAAO,IAAA;AAAA,YACL;AAAA,WAEF;AAAA,QACF;AAAA,MACF;AAAA;AACF,GACF;AACF;AAEA,IAAO,mBAAA,GAAQ","file":"index.cjs","sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport {\n  createI18n,\n  type I18nConfig,\n  type NamespaceKeys,\n  type ValueAtPath,\n  type Translator,\n  type FlatTranslator,\n} from \"@aaakul/ts-intl\";\nimport { getActiveLocale, setGlobalFallbackLanguage } from \"./context\";\nimport { createI18nMiddleware, setGlobalMiddlewareOptions } from \"./middleware\";\nimport type { AstroI18nInstance, UseTranslationsOptions } from \"./types\";\n\nexport interface CreateAstroI18nOptions<\n  TDefaultLanguage extends string,\n  TLanguages extends Record<TDefaultLanguage, Record<string, any>>,\n> extends I18nConfig<TDefaultLanguage, TLanguages> {\n  /**\n   * Route parameter names to search for locale (default: ['lang', 'locale']).\n   */\n  paramNames?: string[];\n}\n\n/**\n * Creates a ts-intl instance configured for Astro, providing context-aware helpers and middleware.\n */\nexport function createAstroI18n<\n  TDefaultLanguage extends string,\n  TLanguages extends Record<TDefaultLanguage, Record<string, any>>,\n>(\n  config: CreateAstroI18nOptions<TDefaultLanguage, TLanguages>,\n): AstroI18nInstance<TDefaultLanguage, TLanguages> {\n  type TBase = TLanguages[TDefaultLanguage];\n  type SupportedLanguage = keyof TLanguages & string;\n\n  const core = createI18n(config);\n\n  setGlobalFallbackLanguage(config.defaultLanguage);\n\n  const resolverOptions = {\n    supportedLanguages: core.languages,\n    defaultLanguage: core.defaultLanguage,\n    paramNames: config.paramNames,\n  };\n\n  setGlobalMiddlewareOptions(resolverOptions);\n\n  const i18nMiddleware = createI18nMiddleware(resolverOptions);\n\n  function useTranslations<N extends NamespaceKeys<TBase>>(\n    namespace: N,\n    options?: UseTranslationsOptions<SupportedLanguage>,\n  ): Translator<ValueAtPath<TBase, N>>;\n  function useTranslations(\n    options?: UseTranslationsOptions<SupportedLanguage>,\n  ): FlatTranslator<TBase>;\n  function useTranslations(arg1?: any, arg2?: any): any {\n    let namespace: string | undefined;\n    let options: UseTranslationsOptions<SupportedLanguage> | undefined;\n\n    if (typeof arg1 === \"string\") {\n      namespace = arg1;\n      options = arg2;\n    } else if (typeof arg1 === \"object\" && arg1 !== null) {\n      options = arg1;\n    }\n\n    const activeLocale =\n      options?.locale || getActiveLocale(config.defaultLanguage);\n    return (core.getTranslations as any)(activeLocale, namespace);\n  }\n\n  function useLocale(): SupportedLanguage {\n    return getActiveLocale(config.defaultLanguage) as SupportedLanguage;\n  }\n\n  function useFormatter(options?: UseTranslationsOptions<SupportedLanguage>) {\n    const activeLocale =\n      options?.locale || getActiveLocale(config.defaultLanguage);\n    return core.getFormatter(activeLocale);\n  }\n\n  return {\n    languages: core.languages,\n    defaultLanguage: core.defaultLanguage,\n    isSupportedLanguage: core.isSupportedLanguage,\n    useTranslations: useTranslations as any,\n    useLocale,\n    useFormatter,\n    i18nMiddleware,\n    getTranslations: core.getTranslations as any,\n    getFormatter: core.getFormatter,\n  };\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\n\nexport interface TsIntlIntegrationOptions {\n  /**\n   * Custom middleware entrypoint if a custom middleware file is provided.\n   * Defaults to 'ts-intl-astro/middleware'.\n   */\n  middlewareEntrypoint?: string;\n}\n\n/**\n * Astro integration for ts-intl.\n * Injects pre-middleware into the Astro rendering pipeline.\n */\nexport function tsIntlAstro(options: TsIntlIntegrationOptions = {}): {\n  name: string;\n  hooks: Record<string, any>;\n} {\n  const middlewareEntrypoint =\n    options.middlewareEntrypoint || \"ts-intl-astro/middleware\";\n\n  return {\n    name: \"ts-intl-astro\",\n    hooks: {\n      \"astro:config:setup\": (params: any) => {\n        const { addMiddleware, logger } = params;\n\n        if (typeof addMiddleware === \"function\") {\n          addMiddleware({\n            entrypoint: middlewareEntrypoint,\n            order: \"pre\",\n          });\n        } else if (logger && typeof logger.warn === \"function\") {\n          logger.warn(\n            \"Current Astro version does not support `addMiddleware`. \" +\n              \"Please export `onRequest = i18nMiddleware` in `src/middleware.ts` manually.\",\n          );\n        }\n      },\n    },\n  };\n}\n\nexport default tsIntlAstro;\n"]}

package/dist/index.d.cts

@@ -0,0 +1,51 @@
+import { I18nConfig } from '@aaakul/ts-intl';
+export { FlatTranslator, Formats, Formatter, I18nConfig, I18nError, I18nErrorCode, Translator, createI18n } from '@aaakul/ts-intl';
+import { A as AstroI18nInstance, I as I18nContextStore } from './middleware-BgHN1Pu6.cjs';
+export { a as AstroCompatibleContext, b as AstroMiddlewareFn, c as AstroMiddlewareNext, R as ResolveLocaleOptions, U as UseTranslationsOptions, d as createI18nMiddleware, o as onRequest, r as resolveRequestLocale, s as setGlobalMiddlewareOptions } from './middleware-BgHN1Pu6.cjs';
+import { AsyncLocalStorage } from 'node:async_hooks';
+
+interface CreateAstroI18nOptions<TDefaultLanguage extends string, TLanguages extends Record<TDefaultLanguage, Record<string, any>>> extends I18nConfig<TDefaultLanguage, TLanguages> {
+    /**
+     * Route parameter names to search for locale (default: ['lang', 'locale']).
+     */
+    paramNames?: string[];
+}
+/**
+ * Creates a ts-intl instance configured for Astro, providing context-aware helpers and middleware.
+ */
+declare function createAstroI18n<TDefaultLanguage extends string, TLanguages extends Record<TDefaultLanguage, Record<string, any>>>(config: CreateAstroI18nOptions<TDefaultLanguage, TLanguages>): AstroI18nInstance<TDefaultLanguage, TLanguages>;
+
+interface TsIntlIntegrationOptions {
+    /**
+     * Custom middleware entrypoint if a custom middleware file is provided.
+     * Defaults to 'ts-intl-astro/middleware'.
+     */
+    middlewareEntrypoint?: string;
+}
+/**
+ * Astro integration for ts-intl.
+ * Injects pre-middleware into the Astro rendering pipeline.
+ */
+declare function tsIntlAstro(options?: TsIntlIntegrationOptions): {
+    name: string;
+    hooks: Record<string, any>;
+};
+
+declare const i18nStorage: AsyncLocalStorage<I18nContextStore>;
+/**
+ * Sets a global fallback language when no active context is found.
+ */
+declare function setGlobalFallbackLanguage(lang: string): void;
+/**
+ * Gets the current active locale from AsyncLocalStorage.
+ * Falls back to globalFallbackLanguage if no context has been established.
+ */
+declare function getActiveLocale(fallback?: string): string;
+/**
+ * Executes a callback within an isolated i18n context for the specified locale.
+ */
+declare function runWithLocale<T>(locale: string, fn: () => T): T;
+
+// @ts-ignore
+export = tsIntlAstro;
+export { AstroI18nInstance, type CreateAstroI18nOptions, I18nContextStore, type TsIntlIntegrationOptions, createAstroI18n, getActiveLocale, i18nStorage, runWithLocale, setGlobalFallbackLanguage, tsIntlAstro as tsIntl, tsIntlAstro };

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+import { I18nConfig } from '@aaakul/ts-intl';
+export { FlatTranslator, Formats, Formatter, I18nConfig, I18nError, I18nErrorCode, Translator, createI18n } from '@aaakul/ts-intl';
+import { A as AstroI18nInstance, I as I18nContextStore } from './middleware-BgHN1Pu6.js';
+export { a as AstroCompatibleContext, b as AstroMiddlewareFn, c as AstroMiddlewareNext, R as ResolveLocaleOptions, U as UseTranslationsOptions, d as createI18nMiddleware, o as onRequest, r as resolveRequestLocale, s as setGlobalMiddlewareOptions } from './middleware-BgHN1Pu6.js';
+import { AsyncLocalStorage } from 'node:async_hooks';
+
+interface CreateAstroI18nOptions<TDefaultLanguage extends string, TLanguages extends Record<TDefaultLanguage, Record<string, any>>> extends I18nConfig<TDefaultLanguage, TLanguages> {
+    /**
+     * Route parameter names to search for locale (default: ['lang', 'locale']).
+     */
+    paramNames?: string[];
+}
+/**
+ * Creates a ts-intl instance configured for Astro, providing context-aware helpers and middleware.
+ */
+declare function createAstroI18n<TDefaultLanguage extends string, TLanguages extends Record<TDefaultLanguage, Record<string, any>>>(config: CreateAstroI18nOptions<TDefaultLanguage, TLanguages>): AstroI18nInstance<TDefaultLanguage, TLanguages>;
+
+interface TsIntlIntegrationOptions {
+    /**
+     * Custom middleware entrypoint if a custom middleware file is provided.
+     * Defaults to 'ts-intl-astro/middleware'.
+     */
+    middlewareEntrypoint?: string;
+}
+/**
+ * Astro integration for ts-intl.
+ * Injects pre-middleware into the Astro rendering pipeline.
+ */
+declare function tsIntlAstro(options?: TsIntlIntegrationOptions): {
+    name: string;
+    hooks: Record<string, any>;
+};
+
+declare const i18nStorage: AsyncLocalStorage<I18nContextStore>;
+/**
+ * Sets a global fallback language when no active context is found.
+ */
+declare function setGlobalFallbackLanguage(lang: string): void;
+/**
+ * Gets the current active locale from AsyncLocalStorage.
+ * Falls back to globalFallbackLanguage if no context has been established.
+ */
+declare function getActiveLocale(fallback?: string): string;
+/**
+ * Executes a callback within an isolated i18n context for the specified locale.
+ */
+declare function runWithLocale<T>(locale: string, fn: () => T): T;
+
+export { AstroI18nInstance, type CreateAstroI18nOptions, I18nContextStore, type TsIntlIntegrationOptions, createAstroI18n, tsIntlAstro as default, getActiveLocale, i18nStorage, runWithLocale, setGlobalFallbackLanguage, tsIntlAstro as tsIntl, tsIntlAstro };

package/dist/index.js

@@ -0,0 +1,74 @@
+import { setGlobalFallbackLanguage, setGlobalMiddlewareOptions, createI18nMiddleware, getActiveLocale } from './chunk-YRAJZM57.js';
+export { createI18nMiddleware, getActiveLocale, i18nStorage, onRequest, resolveRequestLocale, runWithLocale, setGlobalFallbackLanguage, setGlobalMiddlewareOptions } from './chunk-YRAJZM57.js';
+import { createI18n } from '@aaakul/ts-intl';
+export { I18nError, I18nErrorCode, createI18n } from '@aaakul/ts-intl';
+
+function createAstroI18n(config) {
+  const core = createI18n(config);
+  setGlobalFallbackLanguage(config.defaultLanguage);
+  const resolverOptions = {
+    supportedLanguages: core.languages,
+    defaultLanguage: core.defaultLanguage,
+    paramNames: config.paramNames
+  };
+  setGlobalMiddlewareOptions(resolverOptions);
+  const i18nMiddleware = createI18nMiddleware(resolverOptions);
+  function useTranslations(arg1, arg2) {
+    let namespace;
+    let options;
+    if (typeof arg1 === "string") {
+      namespace = arg1;
+      options = arg2;
+    } else if (typeof arg1 === "object" && arg1 !== null) {
+      options = arg1;
+    }
+    const activeLocale = options?.locale || getActiveLocale(config.defaultLanguage);
+    return core.getTranslations(activeLocale, namespace);
+  }
+  function useLocale() {
+    return getActiveLocale(config.defaultLanguage);
+  }
+  function useFormatter(options) {
+    const activeLocale = options?.locale || getActiveLocale(config.defaultLanguage);
+    return core.getFormatter(activeLocale);
+  }
+  return {
+    languages: core.languages,
+    defaultLanguage: core.defaultLanguage,
+    isSupportedLanguage: core.isSupportedLanguage,
+    useTranslations,
+    useLocale,
+    useFormatter,
+    i18nMiddleware,
+    getTranslations: core.getTranslations,
+    getFormatter: core.getFormatter
+  };
+}
+
+// src/integration.ts
+function tsIntlAstro(options = {}) {
+  const middlewareEntrypoint = options.middlewareEntrypoint || "ts-intl-astro/middleware";
+  return {
+    name: "ts-intl-astro",
+    hooks: {
+      "astro:config:setup": (params) => {
+        const { addMiddleware, logger } = params;
+        if (typeof addMiddleware === "function") {
+          addMiddleware({
+            entrypoint: middlewareEntrypoint,
+            order: "pre"
+          });
+        } else if (logger && typeof logger.warn === "function") {
+          logger.warn(
+            "Current Astro version does not support `addMiddleware`. Please export `onRequest = i18nMiddleware` in `src/middleware.ts` manually."
+          );
+        }
+      }
+    }
+  };
+}
+var integration_default = tsIntlAstro;
+
+export { createAstroI18n, integration_default as default, tsIntlAstro as tsIntl, tsIntlAstro };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/factory.ts","../src/integration.ts"],"names":[],"mappings":";;;;;AA0BO,SAAS,gBAId,MAAA,EACiD;AAIjD,EAAA,MAAM,IAAA,GAAO,WAAW,MAAM,CAAA;AAE9B,EAAA,yBAAA,CAA0B,OAAO,eAAe,CAAA;AAEhD,EAAA,MAAM,eAAA,GAAkB;AAAA,IACtB,oBAAoB,IAAA,CAAK,SAAA;AAAA,IACzB,iBAAiB,IAAA,CAAK,eAAA;AAAA,IACtB,YAAY,MAAA,CAAO;AAAA,GACrB;AAEA,EAAA,0BAAA,CAA2B,eAAe,CAAA;AAE1C,EAAA,MAAM,cAAA,GAAiB,qBAAqB,eAAe,CAAA;AAS3D,EAAA,SAAS,eAAA,CAAgB,MAAY,IAAA,EAAiB;AACpD,IAAA,IAAI,SAAA;AACJ,IAAA,IAAI,OAAA;AAEJ,IAAA,IAAI,OAAO,SAAS,QAAA,EAAU;AAC5B,MAAA,SAAA,GAAY,IAAA;AACZ,MAAA,OAAA,GAAU,IAAA;AAAA,IACZ,CAAA,MAAA,IAAW,OAAO,IAAA,KAAS,QAAA,IAAY,SAAS,IAAA,EAAM;AACpD,MAAA,OAAA,GAAU,IAAA;AAAA,IACZ;AAEA,IAAA,MAAM,YAAA,GACJ,OAAA,EAAS,MAAA,IAAU,eAAA,CAAgB,OAAO,eAAe,CAAA;AAC3D,IAAA,OAAQ,IAAA,CAAK,eAAA,CAAwB,YAAA,EAAc,SAAS,CAAA;AAAA,EAC9D;AAEA,EAAA,SAAS,SAAA,GAA+B;AACtC,IAAA,OAAO,eAAA,CAAgB,OAAO,eAAe,CAAA;AAAA,EAC/C;AAEA,EAAA,SAAS,aAAa,OAAA,EAAqD;AACzE,IAAA,MAAM,YAAA,GACJ,OAAA,EAAS,MAAA,IAAU,eAAA,CAAgB,OAAO,eAAe,CAAA;AAC3D,IAAA,OAAO,IAAA,CAAK,aAAa,YAAY,CAAA;AAAA,EACvC;AAEA,EAAA,OAAO;AAAA,IACL,WAAW,IAAA,CAAK,SAAA;AAAA,IAChB,iBAAiB,IAAA,CAAK,eAAA;AAAA,IACtB,qBAAqB,IAAA,CAAK,mBAAA;AAAA,IAC1B,eAAA;AAAA,IACA,SAAA;AAAA,IACA,YAAA;AAAA,IACA,cAAA;AAAA,IACA,iBAAiB,IAAA,CAAK,eAAA;AAAA,IACtB,cAAc,IAAA,CAAK;AAAA,GACrB;AACF;;;AC/EO,SAAS,WAAA,CAAY,OAAA,GAAoC,EAAC,EAG/D;AACA,EAAA,MAAM,oBAAA,GACJ,QAAQ,oBAAA,IAAwB,0BAAA;AAElC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,eAAA;AAAA,IACN,KAAA,EAAO;AAAA,MACL,oBAAA,EAAsB,CAAC,MAAA,KAAgB;AACrC,QAAA,MAAM,EAAE,aAAA,EAAe,MAAA,EAAO,GAAI,MAAA;AAElC,QAAA,IAAI,OAAO,kBAAkB,UAAA,EAAY;AACvC,UAAA,aAAA,CAAc;AAAA,YACZ,UAAA,EAAY,oBAAA;AAAA,YACZ,KAAA,EAAO;AAAA,WACR,CAAA;AAAA,QACH,CAAA,MAAA,IAAW,MAAA,IAAU,OAAO,MAAA,CAAO,SAAS,UAAA,EAAY;AACtD,UAAA,MAAA,CAAO,IAAA;AAAA,YACL;AAAA,WAEF;AAAA,QACF;AAAA,MACF;AAAA;AACF,GACF;AACF;AAEA,IAAO,mBAAA,GAAQ","file":"index.js","sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport {\n  createI18n,\n  type I18nConfig,\n  type NamespaceKeys,\n  type ValueAtPath,\n  type Translator,\n  type FlatTranslator,\n} from \"@aaakul/ts-intl\";\nimport { getActiveLocale, setGlobalFallbackLanguage } from \"./context\";\nimport { createI18nMiddleware, setGlobalMiddlewareOptions } from \"./middleware\";\nimport type { AstroI18nInstance, UseTranslationsOptions } from \"./types\";\n\nexport interface CreateAstroI18nOptions<\n  TDefaultLanguage extends string,\n  TLanguages extends Record<TDefaultLanguage, Record<string, any>>,\n> extends I18nConfig<TDefaultLanguage, TLanguages> {\n  /**\n   * Route parameter names to search for locale (default: ['lang', 'locale']).\n   */\n  paramNames?: string[];\n}\n\n/**\n * Creates a ts-intl instance configured for Astro, providing context-aware helpers and middleware.\n */\nexport function createAstroI18n<\n  TDefaultLanguage extends string,\n  TLanguages extends Record<TDefaultLanguage, Record<string, any>>,\n>(\n  config: CreateAstroI18nOptions<TDefaultLanguage, TLanguages>,\n): AstroI18nInstance<TDefaultLanguage, TLanguages> {\n  type TBase = TLanguages[TDefaultLanguage];\n  type SupportedLanguage = keyof TLanguages & string;\n\n  const core = createI18n(config);\n\n  setGlobalFallbackLanguage(config.defaultLanguage);\n\n  const resolverOptions = {\n    supportedLanguages: core.languages,\n    defaultLanguage: core.defaultLanguage,\n    paramNames: config.paramNames,\n  };\n\n  setGlobalMiddlewareOptions(resolverOptions);\n\n  const i18nMiddleware = createI18nMiddleware(resolverOptions);\n\n  function useTranslations<N extends NamespaceKeys<TBase>>(\n    namespace: N,\n    options?: UseTranslationsOptions<SupportedLanguage>,\n  ): Translator<ValueAtPath<TBase, N>>;\n  function useTranslations(\n    options?: UseTranslationsOptions<SupportedLanguage>,\n  ): FlatTranslator<TBase>;\n  function useTranslations(arg1?: any, arg2?: any): any {\n    let namespace: string | undefined;\n    let options: UseTranslationsOptions<SupportedLanguage> | undefined;\n\n    if (typeof arg1 === \"string\") {\n      namespace = arg1;\n      options = arg2;\n    } else if (typeof arg1 === \"object\" && arg1 !== null) {\n      options = arg1;\n    }\n\n    const activeLocale =\n      options?.locale || getActiveLocale(config.defaultLanguage);\n    return (core.getTranslations as any)(activeLocale, namespace);\n  }\n\n  function useLocale(): SupportedLanguage {\n    return getActiveLocale(config.defaultLanguage) as SupportedLanguage;\n  }\n\n  function useFormatter(options?: UseTranslationsOptions<SupportedLanguage>) {\n    const activeLocale =\n      options?.locale || getActiveLocale(config.defaultLanguage);\n    return core.getFormatter(activeLocale);\n  }\n\n  return {\n    languages: core.languages,\n    defaultLanguage: core.defaultLanguage,\n    isSupportedLanguage: core.isSupportedLanguage,\n    useTranslations: useTranslations as any,\n    useLocale,\n    useFormatter,\n    i18nMiddleware,\n    getTranslations: core.getTranslations as any,\n    getFormatter: core.getFormatter,\n  };\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\n\nexport interface TsIntlIntegrationOptions {\n  /**\n   * Custom middleware entrypoint if a custom middleware file is provided.\n   * Defaults to 'ts-intl-astro/middleware'.\n   */\n  middlewareEntrypoint?: string;\n}\n\n/**\n * Astro integration for ts-intl.\n * Injects pre-middleware into the Astro rendering pipeline.\n */\nexport function tsIntlAstro(options: TsIntlIntegrationOptions = {}): {\n  name: string;\n  hooks: Record<string, any>;\n} {\n  const middlewareEntrypoint =\n    options.middlewareEntrypoint || \"ts-intl-astro/middleware\";\n\n  return {\n    name: \"ts-intl-astro\",\n    hooks: {\n      \"astro:config:setup\": (params: any) => {\n        const { addMiddleware, logger } = params;\n\n        if (typeof addMiddleware === \"function\") {\n          addMiddleware({\n            entrypoint: middlewareEntrypoint,\n            order: \"pre\",\n          });\n        } else if (logger && typeof logger.warn === \"function\") {\n          logger.warn(\n            \"Current Astro version does not support `addMiddleware`. \" +\n              \"Please export `onRequest = i18nMiddleware` in `src/middleware.ts` manually.\",\n          );\n        }\n      },\n    },\n  };\n}\n\nexport default tsIntlAstro;\n"]}

package/dist/middleware-BgHN1Pu6.d.cts

@@ -0,0 +1,83 @@
+import { NamespaceKeys, Translator, ValueAtPath, FlatTranslator, Formatter } from '@aaakul/ts-intl';
+
+/**
+ * Minimal interface to decouple from specific Astro versions (compatible with Astro 3.x, 4.x, 5.x).
+ */
+interface AstroCompatibleContext {
+    url: URL;
+    params?: Record<string, string | undefined>;
+    currentLocale?: string | undefined;
+    preferredLocale?: string | undefined;
+    locals?: Record<string, any>;
+    [key: string]: any;
+}
+type AstroMiddlewareNext = () => Promise<Response>;
+type AstroMiddlewareFn = (context: AstroCompatibleContext, next: AstroMiddlewareNext) => Promise<Response>;
+interface I18nContextStore {
+    locale: string;
+}
+interface UseTranslationsOptions<TLang extends string = string> {
+    locale?: TLang | (string & {});
+}
+interface AstroI18nInstance<TDefaultLanguage extends string, TLanguages extends Record<TDefaultLanguage, Record<string, any>>> {
+    languages: readonly (keyof TLanguages & string)[];
+    defaultLanguage: TDefaultLanguage;
+    isSupportedLanguage: (lang: string) => lang is keyof TLanguages & string;
+    /**
+     * Returns a translator bound to the current rendering context or specified locale.
+     */
+    useTranslations: {
+        <N extends NamespaceKeys<TLanguages[TDefaultLanguage]>>(namespace: N, options?: UseTranslationsOptions<keyof TLanguages & string>): Translator<ValueAtPath<TLanguages[TDefaultLanguage], N>>;
+        (options?: UseTranslationsOptions<keyof TLanguages & string>): FlatTranslator<TLanguages[TDefaultLanguage]>;
+    };
+    /**
+     * Returns the active locale in the current rendering context.
+     */
+    useLocale: () => keyof TLanguages & string;
+    /**
+     * Returns the cached Intl formatter bound to the active or specified locale.
+     */
+    useFormatter: (options?: UseTranslationsOptions<keyof TLanguages & string>) => Formatter;
+    /**
+     * Pre-configured Astro middleware for this i18n instance.
+     */
+    i18nMiddleware: AstroMiddlewareFn;
+    /**
+     * Translation accessor for a specified language.
+     */
+    getTranslations: {
+        <N extends NamespaceKeys<TLanguages[TDefaultLanguage]>>(lang: (keyof TLanguages & string) | (string & {}), namespace: N): Translator<ValueAtPath<TLanguages[TDefaultLanguage], N>>;
+        (lang: (keyof TLanguages & string) | (string & {})): FlatTranslator<TLanguages[TDefaultLanguage]>;
+    };
+    /**
+     * Formatter accessor for a specified language.
+     */
+    getFormatter: (lang?: (keyof TLanguages & string) | (string & {})) => Formatter;
+}
+
+interface ResolveLocaleOptions {
+    supportedLanguages: readonly string[];
+    defaultLanguage: string;
+    paramNames?: string[];
+}
+/**
+ * Resolves the request locale from context.currentLocale, route params, or URL path segments.
+ */
+declare function resolveRequestLocale(context: AstroCompatibleContext, options: ResolveLocaleOptions): string;
+
+/**
+ * Registers global options for the standalone middleware entry point.
+ */
+declare function setGlobalMiddlewareOptions(options: ResolveLocaleOptions): void;
+declare function getGlobalMiddlewareOptions(): ResolveLocaleOptions | undefined;
+/**
+ * Factory that creates an Astro-compatible middleware function.
+ */
+declare function createI18nMiddleware(options: ResolveLocaleOptions): AstroMiddlewareFn;
+/**
+ * Standalone Astro middleware handler.
+ * Uses options registered via setGlobalMiddlewareOptions or defaults.
+ */
+declare const onRequest: AstroMiddlewareFn;
+
+export { type AstroI18nInstance as A, type I18nContextStore as I, type ResolveLocaleOptions as R, type UseTranslationsOptions as U, type AstroCompatibleContext as a, type AstroMiddlewareFn as b, type AstroMiddlewareNext as c, createI18nMiddleware as d, getGlobalMiddlewareOptions as g, onRequest as o, resolveRequestLocale as r, setGlobalMiddlewareOptions as s };

package/dist/middleware-BgHN1Pu6.d.ts

@@ -0,0 +1,83 @@
+import { NamespaceKeys, Translator, ValueAtPath, FlatTranslator, Formatter } from '@aaakul/ts-intl';
+
+/**
+ * Minimal interface to decouple from specific Astro versions (compatible with Astro 3.x, 4.x, 5.x).
+ */
+interface AstroCompatibleContext {
+    url: URL;
+    params?: Record<string, string | undefined>;
+    currentLocale?: string | undefined;
+    preferredLocale?: string | undefined;
+    locals?: Record<string, any>;
+    [key: string]: any;
+}
+type AstroMiddlewareNext = () => Promise<Response>;
+type AstroMiddlewareFn = (context: AstroCompatibleContext, next: AstroMiddlewareNext) => Promise<Response>;
+interface I18nContextStore {
+    locale: string;
+}
+interface UseTranslationsOptions<TLang extends string = string> {
+    locale?: TLang | (string & {});
+}
+interface AstroI18nInstance<TDefaultLanguage extends string, TLanguages extends Record<TDefaultLanguage, Record<string, any>>> {
+    languages: readonly (keyof TLanguages & string)[];
+    defaultLanguage: TDefaultLanguage;
+    isSupportedLanguage: (lang: string) => lang is keyof TLanguages & string;
+    /**
+     * Returns a translator bound to the current rendering context or specified locale.
+     */
+    useTranslations: {
+        <N extends NamespaceKeys<TLanguages[TDefaultLanguage]>>(namespace: N, options?: UseTranslationsOptions<keyof TLanguages & string>): Translator<ValueAtPath<TLanguages[TDefaultLanguage], N>>;
+        (options?: UseTranslationsOptions<keyof TLanguages & string>): FlatTranslator<TLanguages[TDefaultLanguage]>;
+    };
+    /**
+     * Returns the active locale in the current rendering context.
+     */
+    useLocale: () => keyof TLanguages & string;
+    /**
+     * Returns the cached Intl formatter bound to the active or specified locale.
+     */
+    useFormatter: (options?: UseTranslationsOptions<keyof TLanguages & string>) => Formatter;
+    /**
+     * Pre-configured Astro middleware for this i18n instance.
+     */
+    i18nMiddleware: AstroMiddlewareFn;
+    /**
+     * Translation accessor for a specified language.
+     */
+    getTranslations: {
+        <N extends NamespaceKeys<TLanguages[TDefaultLanguage]>>(lang: (keyof TLanguages & string) | (string & {}), namespace: N): Translator<ValueAtPath<TLanguages[TDefaultLanguage], N>>;
+        (lang: (keyof TLanguages & string) | (string & {})): FlatTranslator<TLanguages[TDefaultLanguage]>;
+    };
+    /**
+     * Formatter accessor for a specified language.
+     */
+    getFormatter: (lang?: (keyof TLanguages & string) | (string & {})) => Formatter;
+}
+
+interface ResolveLocaleOptions {
+    supportedLanguages: readonly string[];
+    defaultLanguage: string;
+    paramNames?: string[];
+}
+/**
+ * Resolves the request locale from context.currentLocale, route params, or URL path segments.
+ */
+declare function resolveRequestLocale(context: AstroCompatibleContext, options: ResolveLocaleOptions): string;
+
+/**
+ * Registers global options for the standalone middleware entry point.
+ */
+declare function setGlobalMiddlewareOptions(options: ResolveLocaleOptions): void;
+declare function getGlobalMiddlewareOptions(): ResolveLocaleOptions | undefined;
+/**
+ * Factory that creates an Astro-compatible middleware function.
+ */
+declare function createI18nMiddleware(options: ResolveLocaleOptions): AstroMiddlewareFn;
+/**
+ * Standalone Astro middleware handler.
+ * Uses options registered via setGlobalMiddlewareOptions or defaults.
+ */
+declare const onRequest: AstroMiddlewareFn;
+
+export { type AstroI18nInstance as A, type I18nContextStore as I, type ResolveLocaleOptions as R, type UseTranslationsOptions as U, type AstroCompatibleContext as a, type AstroMiddlewareFn as b, type AstroMiddlewareNext as c, createI18nMiddleware as d, getGlobalMiddlewareOptions as g, onRequest as o, resolveRequestLocale as r, setGlobalMiddlewareOptions as s };

package/dist/middleware.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+var chunk25H6BZD6_cjs = require('./chunk-25H6BZD6.cjs');
+
+
+
+Object.defineProperty(exports, "createI18nMiddleware", {
+  enumerable: true,
+  get: function () { return chunk25H6BZD6_cjs.createI18nMiddleware; }
+});
+Object.defineProperty(exports, "getGlobalMiddlewareOptions", {
+  enumerable: true,
+  get: function () { return chunk25H6BZD6_cjs.getGlobalMiddlewareOptions; }
+});
+Object.defineProperty(exports, "onRequest", {
+  enumerable: true,
+  get: function () { return chunk25H6BZD6_cjs.onRequest; }
+});
+Object.defineProperty(exports, "setGlobalMiddlewareOptions", {
+  enumerable: true,
+  get: function () { return chunk25H6BZD6_cjs.setGlobalMiddlewareOptions; }
+});
+//# sourceMappingURL=middleware.cjs.map
+//# sourceMappingURL=middleware.cjs.map

package/dist/middleware.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"middleware.cjs"}

package/dist/middleware.d.cts

@@ -0,0 +1,2 @@
+export { d as createI18nMiddleware, g as getGlobalMiddlewareOptions, o as onRequest, s as setGlobalMiddlewareOptions } from './middleware-BgHN1Pu6.cjs';
+import '@aaakul/ts-intl';

package/dist/middleware.d.ts

@@ -0,0 +1,2 @@
+export { d as createI18nMiddleware, g as getGlobalMiddlewareOptions, o as onRequest, s as setGlobalMiddlewareOptions } from './middleware-BgHN1Pu6.js';
+import '@aaakul/ts-intl';

package/dist/middleware.js

@@ -0,0 +1,3 @@
+export { createI18nMiddleware, getGlobalMiddlewareOptions, onRequest, setGlobalMiddlewareOptions } from './chunk-YRAJZM57.js';
+//# sourceMappingURL=middleware.js.map
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"middleware.js"}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "ts-intl-astro",
+  "version": "1.0.0",
+  "description": "A lightweight, type-safe Astro integration for internationalization (i18n). Delivers a developer experience inspired by `next-intl`. ",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aaakul/ts-intl.git"
+  },
+  "homepage": "https://ts-intl.pages.dev/en-US/docs/astro-integration",
+  "bugs": {
+    "url": "https://github.com/aaakul/ts-intl/issues"
+  },
+  "keywords": [
+    "astro-integration",
+    "astro-component",
+    "withastro",
+    "astro",
+    "i18n",
+    "internationalization",
+    "localization",
+    "ts-intl",
+    "typescript"
+  ],
+  "license": "MIT",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./middleware": {
+      "import": {
+        "types": "./dist/middleware.d.ts",
+        "default": "./dist/middleware.js"
+      },
+      "require": {
+        "types": "./dist/middleware.d.cts",
+        "default": "./dist/middleware.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@aaakul/ts-intl": "workspace:*"
+  },
+  "peerDependencies": {
+    "astro": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "astro": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.2",
+    "astro": "^5.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.5.0",
+    "vitest": "^5.0.0"
+  }
+}