@kamod-ch/otok-i18n 3.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kamod
+
+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.md

@@ -0,0 +1,163 @@
+# @kamod-ch/otok-i18n
+
+Full i18n integration for [Otok](https://github.com/kamod-ch/otok): routing, SSR, islands, metadata, and the plugin API.
+
+## Install
+
+```bash
+pnpm add @kamod-ch/otok-i18n hono @kamod-ch/otok
+pnpm add preact   # for islands / client hooks
+```
+
+## Quick start (plugin API)
+
+```ts
+// otok.config.ts
+import { defineConfig } from "@kamod-ch/otok";
+import i18n from "@kamod-ch/otok-i18n";
+
+export default defineConfig({
+  plugins: [
+    i18n({
+      locales: ["de", "en", "fr"],
+      defaultLocale: "de",
+      routing: "prefix-except-default",
+      fallbackLocale: "en",
+      messages: {
+        de: () => import("./locales/de.json"),
+        en: () => import("./locales/en.json"),
+        fr: () => import("./locales/fr.json"),
+      },
+    }),
+  ],
+});
+```
+
+The plugin registers app-level middleware automatically (`configureApp`). No manual `_middleware.ts` required unless you need custom ordering.
+
+## Routing modes
+
+| Mode | Example URLs |
+|------|----------------|
+| `prefix` | `/de/products`, `/en/products` |
+| `prefix-except-default` | `/products` (de), `/en/products` |
+| `domain` | `example.ch`, `example.fr` (via `domains` map) |
+| `none` | No locale in URL — cookie / `Accept-Language` only |
+
+## Locale resolution priority
+
+1. **URL** — path prefix or domain (depending on `routing`)
+2. **Cookie** — `locale` (configurable via `cookieName`)
+3. **`Accept-Language`**
+4. **`defaultLocale`**
+
+Unknown locale prefixes (e.g. `/xx/about`) redirect once to the canonical path when `redirectUnknownLocale` is true (default).
+
+## Server: loaders and `t()`
+
+```ts
+import { defineLoader, serializeI18n } from "@kamod-ch/otok-i18n/loader";
+import { i18nHead } from "@kamod-ch/otok-i18n";
+
+export const loader = defineLoader(({ i18n, hono }) => ({
+  title: i18n.t("dashboard.welcome"),
+  i18n: serializeI18n(hono), // active locale only — safe for hydration
+}));
+
+export const head = ({ data }) =>
+  i18nHead({
+    locale: data.i18n.locale,
+    locales: ["de", "en", "fr"],
+    defaultLocale: "de",
+    origin: "https://example.com",
+    pathname: "/dashboard",
+    extra: { title: data.title },
+  });
+```
+
+## Islands: `useI18n()` / `useTranslation()`
+
+```tsx
+import { I18nProvider, useI18n } from "@kamod-ch/otok-i18n/client";
+
+export function Welcome({ itemCount }: { itemCount: number }) {
+  const { t, locale, formatCurrency } = useI18n();
+  return (
+    <>
+      <h1>{t("dashboard.welcome")}</h1>
+      <p>{t("items", { count: itemCount })}</p>
+      <p>{formatCurrency(29, "CHF")}</p>
+    </>
+  );
+}
+
+// In route: pass loader payload
+<I18nProvider {...data.i18n}>
+  <Welcome itemCount={3} />
+</I18nProvider>
+```
+
+SSR and hydration use the same `serializeI18n()` payload — only the active locale messages are sent to the client.
+
+## Features
+
+- Lazy message loading per locale (dynamic `import()`)
+- Fallback locale for missing keys
+- Pluralization via `Intl.PluralRules` (`items.one`, `items.other`, + `{count}`)
+- Safe `{variable}` interpolation (HTML-escaped)
+- `formatDate`, `formatTime`, `formatNumber`, `formatPercent`, `formatCurrency` via `Intl`
+- Dev warnings for missing keys; production-safe fallbacks
+- `LocaleSwitcher` component (`@kamod-ch/otok-i18n/switcher`)
+- Localized sitemap helpers (`@kamod-ch/otok-i18n/sitemap`)
+- RTL direction hint via `useI18n().direction`
+- Typed keys: `TranslationKey<typeof messages>`, `FlattenKeys<…>`
+
+## Route helpers
+
+```ts
+import { localizePath, switchLocalePath, createLinkHelper } from "@kamod-ch/otok-i18n/routes";
+
+localizePath("/products", "en", { defaultLocale: "de", routing: "prefix-except-default" });
+// → "/en/products"
+
+switchLocalePath("/en/products", "fr", ["de", "en", "fr"], { defaultLocale: "de" });
+// → "/fr/products"
+```
+
+## Legacy flat-catalog API
+
+Still supported for apps without the plugin:
+
+```ts
+import { createI18nMiddleware, toRouteMiddleware } from "@kamod-ch/otok-i18n/middleware";
+
+// File-based _middleware.ts — export default:
+export default createI18nMiddleware(i18nConfig);
+
+// Programmatic route middleware arrays:
+middleware: [toRouteMiddleware(createI18nMiddleware(i18nConfig))];
+```
+
+## Exports
+
+| Subpath | Purpose |
+|---------|---------|
+| `@kamod-ch/otok-i18n` | Plugin factory + core API |
+| `@kamod-ch/otok-i18n/middleware` | Middleware, `readI18n`, `toRouteMiddleware` |
+| `@kamod-ch/otok-i18n/loader` | `defineLoader`, `serializeI18n` |
+| `@kamod-ch/otok-i18n/client` | `I18nProvider`, `useI18n`, `useTranslation` |
+| `@kamod-ch/otok-i18n/routes` | Path / link helpers |
+| `@kamod-ch/otok-i18n/sitemap` | Localized sitemap XML |
+| `@kamod-ch/otok-i18n/switcher` | `LocaleSwitcher` component |
+
+## Example
+
+See [`examples/i18n-trilingual`](../../examples/i18n-trilingual) for a complete DE / EN / FR app.
+
+## Related packages
+
+| Package | Purpose |
+|---------|---------|
+| `@kamod-ch/otok-auth` | Sessions, CSRF |
+| `@kamod-ch/otok-validation` | Standard Schema validation |
+| `@kamod-ch/otok-flash` | Flash messages |

package/dist/catalog.d.ts

@@ -0,0 +1,17 @@
+import type { FlatMessages, TranslateValues, Translator } from "./types.js";
+export type { FlatMessages, TranslateValues, Translator } from "./types.js";
+export type MessageCatalog<Locales extends string = string> = Record<Locales, FlatMessages>;
+export interface CreateTranslatorOptions {
+    warnMissingKeys?: boolean;
+    onMissingKey?: (key: string, locale: string) => void;
+}
+declare function resolveMessage(messages: FlatMessages, fallbackMessages: FlatMessages, locale: string, key: string, values?: TranslateValues, explicitFallback?: string): string | undefined;
+export declare function createTranslator(messages: FlatMessages, locale: string, fallbackLocale: string, fallbackMessages?: FlatMessages, options?: CreateTranslatorOptions): Translator;
+/** Extract typed keys from a flat message object. */
+export type TranslationKey<M extends FlatMessages> = Extract<keyof M, string>;
+/** Flatten nested object keys into dot notation for typed catalogs. */
+export type FlattenKeys<T, Prefix extends string = ""> = T extends string ? Prefix extends "" ? never : Prefix : {
+    [K in keyof T & string]: T[K] extends string ? Prefix extends "" ? K : `${Prefix}.${K}` : FlattenKeys<T[K], Prefix extends "" ? K : `${Prefix}.${K}`>;
+}[keyof T & string];
+export { resolveMessage };
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5E,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,MAAM,cAAc,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAE5F,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AAED,iBAAS,cAAc,CACrB,QAAQ,EAAE,YAAY,EACtB,gBAAgB,EAAE,YAAY,EAC9B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,eAAe,EACxB,gBAAgB,CAAC,EAAE,MAAM,GACxB,MAAM,GAAG,SAAS,CAkBpB;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,gBAAgB,GAAE,YAAiB,EACnC,OAAO,GAAE,uBAA4B,GACpC,UAAU,CAkBZ;AAED,qDAAqD;AACrD,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAE9E,uEAAuE;AACvE,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,MAAM,SAAS,MAAM,GAAG,EAAE,IAAI,CAAC,SAAS,MAAM,GACrE,MAAM,SAAS,EAAE,GAAG,KAAK,GAAG,MAAM,GAClC;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACxC,MAAM,SAAS,EAAE,GACf,CAAC,GACD,GAAG,MAAM,IAAI,CAAC,EAAE,GAClB,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,SAAS,EAAE,GAAG,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC;CAChE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/catalog.js

@@ -0,0 +1,39 @@
+import { interpolate } from "./interpolate.js";
+import { extractCount, pickPluralMessage } from "./plural.js";
+function resolveMessage(messages, fallbackMessages, locale, key, values, explicitFallback) {
+    const count = extractCount(values);
+    if (count != null) {
+        const plural = pickPluralMessage(messages, key, locale, count) ??
+            pickPluralMessage(fallbackMessages, key, locale, count);
+        if (plural != null)
+            return interpolate(plural, { ...values, count });
+    }
+    const primary = messages[key];
+    if (primary != null && primary !== "")
+        return interpolate(primary, values);
+    const secondary = fallbackMessages[key];
+    if (secondary != null && secondary !== "")
+        return interpolate(secondary, values);
+    if (explicitFallback != null && explicitFallback !== "")
+        return explicitFallback;
+    return undefined;
+}
+export function createTranslator(messages, locale, fallbackLocale, fallbackMessages = {}, options = {}) {
+    const warn = options.warnMissingKeys ?? process.env.NODE_ENV !== "production";
+    const warned = new Set();
+    return (key, values, explicitFallback) => {
+        const resolved = resolveMessage(messages, fallbackMessages, locale, key, values, explicitFallback);
+        if (resolved != null)
+            return resolved;
+        if (warn && !warned.has(key)) {
+            warned.add(key);
+            options.onMissingKey?.(key, locale);
+            if (process.env.NODE_ENV !== "production") {
+                console.warn(`[otok-i18n] missing key "${key}" for locale "${locale}"`);
+            }
+        }
+        return explicitFallback ?? key;
+    };
+}
+export { resolveMessage };
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAY9D,SAAS,cAAc,CACrB,QAAsB,EACtB,gBAA8B,EAC9B,MAAc,EACd,GAAW,EACX,MAAwB,EACxB,gBAAyB;IAEzB,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEnC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,MAAM,MAAM,GACV,iBAAiB,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC;YAC/C,iBAAiB,CAAC,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC1D,IAAI,MAAM,IAAI,IAAI;YAAE,OAAO,WAAW,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAE3E,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,SAAS,IAAI,IAAI,IAAI,SAAS,KAAK,EAAE;QAAE,OAAO,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAEjF,IAAI,gBAAgB,IAAI,IAAI,IAAI,gBAAgB,KAAK,EAAE;QAAE,OAAO,gBAAgB,CAAC;IACjF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAsB,EACtB,MAAc,EACd,cAAsB,EACtB,mBAAiC,EAAE,EACnC,UAAmC,EAAE;IAErC,MAAM,IAAI,GAAG,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;IAC9E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,OAAO,CAAC,GAAW,EAAE,MAAwB,EAAE,gBAAyB,EAAE,EAAE;QAC1E,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;QACnG,IAAI,QAAQ,IAAI,IAAI;YAAE,OAAO,QAAQ,CAAC;QAEtC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,OAAO,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACpC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;gBAC1C,OAAO,CAAC,IAAI,CAAC,4BAA4B,GAAG,iBAAiB,MAAM,GAAG,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,OAAO,gBAAgB,IAAI,GAAG,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC;AAgBD,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,41 @@
+import type { ComponentChildren } from "preact";
+import { type FlatMessages, type Translator } from "./catalog.js";
+import type { Formatters } from "./types.js";
+import type { I18nClientPayload, RoutingMode } from "./types.js";
+export type I18nProviderProps = I18nClientPayload & {
+    children?: ComponentChildren;
+};
+export interface I18nHookValue {
+    locale: string;
+    defaultLocale: string;
+    fallbackLocale: string;
+    routing: RoutingMode;
+    t: Translator;
+    formatters: Formatters;
+    formatDate: Formatters["formatDate"];
+    formatTime: Formatters["formatTime"];
+    formatNumber: Formatters["formatNumber"];
+    formatPercent: Formatters["formatPercent"];
+    formatCurrency: Formatters["formatCurrency"];
+    direction: "ltr" | "rtl";
+}
+/**
+ * Provides `t()`, formatters, and locale for island / client trees.
+ * Pass `i18n.toClientPayload()` from the loader — only the active locale is serialized.
+ */
+export declare function I18nProvider({ locale, defaultLocale, fallbackLocale, messages, routing, children, }: I18nProviderProps): import("preact").JSX.Element;
+/** Legacy alias — accepts flat catalog shape. */
+export declare function I18nProviderFromCatalog({ locale, defaultLocale, catalog, children, }: {
+    locale: string;
+    defaultLocale: string;
+    catalog: Record<string, FlatMessages>;
+    children: ComponentChildren;
+}): import("preact").JSX.Element;
+export declare function useI18n(): I18nHookValue;
+/** Alias for `useI18n`. */
+export declare const useTranslation: typeof useI18n;
+/** Returns the translation function; outside a provider, returns `fallback ?? key`. */
+export declare function useT(): Translator;
+export declare function useLocale(): string | null;
+export type { FlatMessages, I18nClientPayload, Translator } from "./types.js";
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAoB,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAEpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG;IAClD,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,CAAC,EAAE,UAAU,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;IACrC,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;IACrC,YAAY,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IACzC,aAAa,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC;IAC3C,cAAc,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC7C,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;CAC1B;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,aAAa,EACb,cAA8B,EAC9B,QAAQ,EACR,OAAiC,EACjC,QAAQ,GACT,EAAE,iBAAiB,gCAoBnB;AAED,iDAAiD;AACjD,wBAAgB,uBAAuB,CAAC,EACtC,MAAM,EACN,aAAa,EACb,OAAO,EACP,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,QAAQ,EAAE,iBAAiB,CAAC;CAC7B,gCAaA;AAED,wBAAgB,OAAO,IAAI,aAAa,CAqBvC;AAED,2BAA2B;AAC3B,eAAO,MAAM,cAAc,gBAAU,CAAC;AAEtC,uFAAuF;AACvF,wBAAgB,IAAI,IAAI,UAAU,CAEjC;AAED,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzC;AAED,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/client.js

@@ -0,0 +1,67 @@
+import { jsx as _jsx } from "preact/jsx-runtime";
+import { createContext } from "preact";
+import { useContext, useMemo } from "preact/hooks";
+import { createTranslator } from "./catalog.js";
+import { createFormatters, localeDirection } from "./format.js";
+const I18nContext = createContext(null);
+/**
+ * Provides `t()`, formatters, and locale for island / client trees.
+ * Pass `i18n.toClientPayload()` from the loader — only the active locale is serialized.
+ */
+export function I18nProvider({ locale, defaultLocale, fallbackLocale = defaultLocale, messages, routing = "prefix-except-default", children, }) {
+    const value = useMemo(() => {
+        const formatters = createFormatters(locale);
+        return {
+            locale,
+            defaultLocale,
+            fallbackLocale,
+            routing,
+            t: createTranslator(messages, locale, fallbackLocale, {}, { warnMissingKeys: false }),
+            formatters,
+            formatDate: formatters.formatDate,
+            formatTime: formatters.formatTime,
+            formatNumber: formatters.formatNumber,
+            formatPercent: formatters.formatPercent,
+            formatCurrency: formatters.formatCurrency,
+            direction: localeDirection(locale),
+        };
+    }, [locale, defaultLocale, fallbackLocale, messages, routing]);
+    return _jsx(I18nContext.Provider, { value: value, children: children });
+}
+/** Legacy alias — accepts flat catalog shape. */
+export function I18nProviderFromCatalog({ locale, defaultLocale, catalog, children, }) {
+    const messages = catalog[locale] ?? {};
+    return (_jsx(I18nProvider, { locale: locale, defaultLocale: defaultLocale, fallbackLocale: defaultLocale, messages: messages, routing: "prefix-except-default", children: children }));
+}
+export function useI18n() {
+    const ctx = useContext(I18nContext);
+    if (!ctx) {
+        const noop = (key, _values, fallback) => fallback ?? key;
+        const formatters = createFormatters("en");
+        return {
+            locale: "en",
+            defaultLocale: "en",
+            fallbackLocale: "en",
+            routing: "none",
+            t: noop,
+            formatters,
+            formatDate: formatters.formatDate,
+            formatTime: formatters.formatTime,
+            formatNumber: formatters.formatNumber,
+            formatPercent: formatters.formatPercent,
+            formatCurrency: formatters.formatCurrency,
+            direction: "ltr",
+        };
+    }
+    return ctx;
+}
+/** Alias for `useI18n`. */
+export const useTranslation = useI18n;
+/** Returns the translation function; outside a provider, returns `fallback ?? key`. */
+export function useT() {
+    return useI18n().t;
+}
+export function useLocale() {
+    return useContext(I18nContext)?.locale ?? null;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"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"}

package/dist/format.d.ts

@@ -0,0 +1,5 @@
+import type { Formatters } from "./types.js";
+export declare function createFormatters(locale: string): Formatters;
+/** BCP 47 direction hint for RTL preparation. */
+export declare function localeDirection(locale: string): "ltr" | "rtl";
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAoB3D;AAED,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAa7D"}

package/dist/format.js

@@ -0,0 +1,39 @@
+export function createFormatters(locale) {
+    return {
+        formatDate(value, options) {
+            const date = value instanceof Date ? value : new Date(value);
+            return new Intl.DateTimeFormat(locale, options).format(date);
+        },
+        formatTime(value, options) {
+            const date = value instanceof Date ? value : new Date(value);
+            return new Intl.DateTimeFormat(locale, { ...options, timeStyle: options?.timeStyle ?? "medium" }).format(date);
+        },
+        formatNumber(value, options) {
+            return new Intl.NumberFormat(locale, options).format(value);
+        },
+        formatPercent(value, options) {
+            return new Intl.NumberFormat(locale, { ...options, style: "percent" }).format(value);
+        },
+        formatCurrency(value, currency, options) {
+            return new Intl.NumberFormat(locale, { ...options, style: "currency", currency }).format(value);
+        },
+    };
+}
+/** BCP 47 direction hint for RTL preparation. */
+export function localeDirection(locale) {
+    try {
+        const localeObj = new Intl.Locale(locale);
+        if ("textInfo" in localeObj && localeObj.textInfo && typeof localeObj.textInfo === "object") {
+            const direction = localeObj.textInfo.direction;
+            if (direction === "rtl")
+                return "rtl";
+        }
+    }
+    catch {
+        // Intl.Locale may not support textInfo in all runtimes
+    }
+    const rtlPrefixes = ["ar", "he", "fa", "ur", "yi"];
+    const primary = locale.split("-")[0]?.toLowerCase();
+    return rtlPrefixes.includes(primary ?? "") ? "rtl" : "ltr";
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO;QACL,UAAU,CAAC,KAAK,EAAE,OAAO;YACvB,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;YAC7D,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC;QACD,UAAU,CAAC,KAAK,EAAE,OAAO;YACvB,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;YAC7D,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjH,CAAC;QACD,YAAY,CAAC,KAAK,EAAE,OAAO;YACzB,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC;QACD,aAAa,CAAC,KAAK,EAAE,OAAO;YAC1B,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvF,CAAC;QACD,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO;YACrC,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClG,CAAC;KACF,CAAC;AACJ,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,UAAU,IAAI,SAAS,IAAI,SAAS,CAAC,QAAQ,IAAI,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC5F,MAAM,SAAS,GAAI,SAAS,CAAC,QAAmC,CAAC,SAAS,CAAC;YAC3E,IAAI,SAAS,KAAK,KAAK;gBAAE,OAAO,KAAK,CAAC;QACxC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;IACzD,CAAC;IACD,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IACpD,OAAO,WAAW,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7D,CAAC"}

package/dist/head.d.ts

@@ -0,0 +1,18 @@
+import type { OtokHead } from "@kamod-ch/otok/server";
+import type { RoutingMode } from "./types.js";
+export interface I18nHeadOptions {
+    locale: string;
+    locales: readonly string[];
+    defaultLocale: string;
+    routing?: RoutingMode;
+    /** Absolute site origin, e.g. `https://example.com` */
+    origin?: string;
+    /** Canonical pathname without locale prefix */
+    pathname?: string;
+    extra?: OtokHead;
+}
+/** Merge `lang` and optional hreflang / canonical links into an Otok head result. */
+export declare function i18nHead(options: I18nHeadOptions): OtokHead;
+/** @deprecated Pass an options object for hreflang support. */
+export declare function i18nHead(locale: string, extra?: OtokHead): OtokHead;
+//# sourceMappingURL=head.d.ts.map

package/dist/head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../src/head.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,uBAAuB,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,qFAAqF;AACrF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC;AAC7D,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC"}

package/dist/head.js

@@ -0,0 +1,33 @@
+import { localizePath } from "./routes.js";
+export function i18nHead(localeOrOptions, extra = {}) {
+    if (typeof localeOrOptions === "string") {
+        return { ...extra, lang: localeOrOptions };
+    }
+    const { locale, locales, defaultLocale, routing = "prefix-except-default", origin, pathname = "/", extra: headExtra = {}, } = localeOrOptions;
+    const links = [...(headExtra.links ?? [])];
+    if (origin) {
+        const canonicalHref = `${origin.replace(/\/$/, "")}${localizePath(pathname, locale, { defaultLocale, routing })}`;
+        if (!links.some((l) => l.rel === "canonical")) {
+            links.push({ rel: "canonical", href: canonicalHref });
+        }
+        for (const altLocale of locales) {
+            const href = `${origin.replace(/\/$/, "")}${localizePath(pathname, altLocale, { defaultLocale, routing })}`;
+            links.push({
+                rel: "alternate",
+                href,
+                hreflang: altLocale,
+            });
+        }
+        links.push({
+            rel: "alternate",
+            href: `${origin.replace(/\/$/, "")}${localizePath(pathname, defaultLocale, { defaultLocale, routing })}`,
+            hreflang: "x-default",
+        });
+    }
+    return {
+        ...headExtra,
+        lang: locale,
+        links,
+    };
+}
+//# sourceMappingURL=head.js.map

package/dist/head.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.js","sourceRoot":"","sources":["../src/head.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmB3C,MAAM,UAAU,QAAQ,CACtB,eAAyC,EACzC,QAAkB,EAAE;IAEpB,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,EACJ,MAAM,EACN,OAAO,EACP,aAAa,EACb,OAAO,GAAG,uBAAuB,EACjC,MAAM,EACN,QAAQ,GAAG,GAAG,EACd,KAAK,EAAE,SAAS,GAAG,EAAE,GACtB,GAAG,eAAe,CAAC;IAEpB,MAAM,KAAK,GAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IAE3D,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,aAAa,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAClH,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,WAAW,CAAC,EAAE,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YAC5G,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,WAAW;gBAChB,IAAI;gBACJ,QAAQ,EAAE,SAAS;aACpB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,IAAI,CAAC;YACT,GAAG,EAAE,WAAW;YAChB,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE;YACxG,QAAQ,EAAE,WAAW;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,GAAG,SAAS;QACZ,IAAI,EAAE,MAAM;QACZ,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/i18n.d.ts

@@ -0,0 +1,24 @@
+import { type MessageCatalog } from "./catalog.js";
+import type { FlatMessages, I18nConfig, I18nContext, I18nPluginOptions, ResolveLocaleInput, RoutingMode } from "./types.js";
+import { type ResolveLocaleOptions } from "./locale.js";
+export interface CreateI18nOptions {
+    locale: string;
+    source: import("./types.js").LocaleSource;
+    routing: RoutingMode;
+    defaultLocale: string;
+    fallbackLocale: string;
+    messages: FlatMessages;
+    fallbackMessages?: FlatMessages;
+    warnMissingKeys?: boolean;
+}
+export declare function buildI18nContext(options: CreateI18nOptions): I18nContext;
+/** Create i18n context from a static catalog (legacy API). */
+export declare function createI18n<Catalog extends MessageCatalog>(config: I18nConfig<Catalog>, input?: Pick<ResolveLocaleOptions, "param" | "cookie" | "acceptLanguage"> & {
+    domain?: string;
+}): I18nContext;
+/** Create i18n context with lazy-loaded messages (plugin API). */
+export declare function createI18nAsync(config: Pick<I18nPluginOptions, "locales" | "defaultLocale" | "fallbackLocale" | "messages" | "routing" | "domains"> & {
+    warnMissingKeys?: boolean;
+}, input: ResolveLocaleInput, namespaces?: string[]): Promise<I18nContext>;
+export type { I18nConfig, I18nContext };
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAIrE,OAAO,KAAK,EACV,YAAY,EAEZ,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAoC,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE1F,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,YAAY,EAAE,YAAY,CAAC;IAC1C,OAAO,EAAE,WAAW,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,gBAAgB,CAAC,EAAE,YAAY,CAAC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,WAAW,CAgCxE;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,OAAO,SAAS,cAAc,EACvD,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAC3B,KAAK,GAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,QAAQ,GAAG,gBAAgB,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAClG,WAAW,CA6Bb;AAED,kEAAkE;AAClE,wBAAsB,eAAe,CACnC,MAAM,EAAE,IAAI,CACV,iBAAiB,EACjB,SAAS,GAAG,eAAe,GAAG,gBAAgB,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CACpF,GAAG;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,EACjC,KAAK,EAAE,kBAAkB,EACzB,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,WAAW,CAAC,CAyBtB;AAED,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}

package/dist/i18n.js

@@ -0,0 +1,76 @@
+import { createTranslator } from "./catalog.js";
+import { createFormatters } from "./format.js";
+import { getCachedMessages } from "./messages.js";
+import { resolveLocale, resolveLocaleFull } from "./locale.js";
+export function buildI18nContext(options) {
+    const { locale, source, routing, defaultLocale, fallbackLocale, messages, fallbackMessages = {}, warnMissingKeys, } = options;
+    const formatters = createFormatters(locale);
+    const toClientPayload = () => ({
+        locale,
+        defaultLocale,
+        fallbackLocale,
+        messages,
+        routing,
+    });
+    return {
+        locale,
+        defaultLocale,
+        fallbackLocale,
+        source,
+        routing,
+        t: createTranslator(messages, locale, fallbackLocale, fallbackMessages, { warnMissingKeys }),
+        formatters,
+        toClientPayload,
+    };
+}
+/** Create i18n context from a static catalog (legacy API). */
+export function createI18n(config, input = {}) {
+    const routing = config.routing ?? "prefix-except-default";
+    const fallbackLocale = (config.fallbackLocale ?? config.defaultLocale);
+    const { locale, source } = resolveLocale({
+        param: input.param,
+        domain: input.domain,
+        cookie: input.cookie,
+        acceptLanguage: input.acceptLanguage,
+        locales: config.locales,
+        defaultLocale: config.defaultLocale,
+    });
+    const resolvedLocale = (config.locales.includes(locale)
+        ? locale
+        : config.defaultLocale);
+    const messages = config.catalog[resolvedLocale] ?? {};
+    const fallbackMessages = config.catalog[fallbackLocale] ?? {};
+    return buildI18nContext({
+        locale: resolvedLocale,
+        source,
+        routing,
+        defaultLocale: config.defaultLocale,
+        fallbackLocale,
+        messages,
+        fallbackMessages,
+    });
+}
+/** Create i18n context with lazy-loaded messages (plugin API). */
+export async function createI18nAsync(config, input, namespaces) {
+    const routing = config.routing ?? "prefix-except-default";
+    const fallbackLocale = config.fallbackLocale ?? config.defaultLocale;
+    const resolved = resolveLocaleFull(input);
+    const locale = config.locales.includes(resolved.locale) ? resolved.locale : config.defaultLocale;
+    const loader = config.messages[locale];
+    const fallbackLoader = config.messages[fallbackLocale];
+    const messages = loader ? await getCachedMessages(locale, loader, namespaces) : {};
+    const fallbackMessages = fallbackLoader
+        ? await getCachedMessages(fallbackLocale, fallbackLoader, namespaces)
+        : {};
+    return buildI18nContext({
+        locale,
+        source: resolved.source,
+        routing,
+        defaultLocale: config.defaultLocale,
+        fallbackLocale,
+        messages,
+        fallbackMessages,
+        warnMissingKeys: config.warnMissingKeys,
+    });
+}
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { createTranslator, type FlattenKeys, type MessageCatalog, type TranslationKey, } from "./catalog.js";
+export type { Translator } from "./types.js";
+export { i18nHead, type I18nHeadOptions } from "./head.js";
+export { buildI18nContext, createI18n, createI18nAsync, type I18nConfig, type I18nContext, } from "./i18n.js";
+export { interpolate } from "./interpolate.js";
+export { defineLoader, defineAction, serializeI18n } from "./loader.js";
+export { DEFAULT_COOKIE_NAME, DEFAULT_PARAM_KEY, looksLikeLocaleSegment, matchLocale, normalizeLocale, parseAcceptLanguage, resolveLocale, resolveLocaleFromDomain, resolveLocaleFull, stripLocaleFromPath, type LocaleSource, type ResolveLocaleOptions, type ResolvedLocale, } from "./locale.js";
+export { clearMessageCache, getCachedMessages, loadLocaleMessages } from "./messages.js";
+export { extractCount, pickPluralMessage, resolvePluralKey } from "./plural.js";
+export { createI18nMiddleware, createI18nPluginMiddleware, configureI18nApp, readI18n, toRouteMiddleware, clearMessageCache as clearI18nMessageCache, } from "./middleware.js";
+export { createFormatters, localeDirection } from "./format.js";
+export { default } from "./plugin.js";
+export { configureI18nApp as configureI18nPluginApp } from "./plugin.js";
+export { createLinkHelper, localizePath, localizeRouteSegment, stripLocaleParam, switchLocalePath, withLocaleParam, type LocalizePathOptions, } from "./routes.js";
+export { clearI18nRuntime, getI18nRuntime, normalizePluginOptions, registerI18nRuntime, tryGetI18nRuntime, type I18nRuntime, type NormalizedI18nOptions, } from "./registry.js";
+export { createLocalizedSitemapEntries, renderSitemapXml, type CreateSitemapOptions, type LocalizedSitemapEntry, type SitemapAlternate, } from "./sitemap.js";
+export type { FlatMessages, Formatters, I18nClientPayload, I18nPluginOptions, LocalizedRouteNames, MessageLoader, MessageValue, NamespaceLoader, ResolveLocaleInput, ResolvedLocaleResult, RoutingMode, TranslateValues, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,gBAAgB,EAChB,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,IAAI,qBAAqB,GAC3C,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,gBAAgB,IAAI,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,qBAAqB,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC"}