@rimelight/i18n 0.0.7 → 0.0.9

package/dist/hono.d.mts

@@ -0,0 +1,8 @@
+//#region src/hono.d.ts
+/**
+ * Hono middleware for Rimelight i18n. Handles locale routing, redirection, currentLocale store
+ * updates, and Cloudflare KV binding setup.
+ */
+declare function i18n(): (c: any, next: any) => Promise<any>;
+//#endregion
+export { i18n };

package/dist/hono.mjs

@@ -0,0 +1,80 @@
+import { n as currentLocale } from "./runtime-Civir_tv.mjs";
+import { d as setKVBinding } from "./src-D09inETW.mjs";
+import { env } from "cloudflare:workers";
+import { defaultLocale, locales, prefixDefaultLocale } from "virtual:rimelight-i18n-config";
+//#region src/hono.ts
+const SUPPORTED_LOCALES = new Set(locales);
+const DEFAULT_LOCALE = defaultLocale;
+function getPreferredLocale(acceptLanguage) {
+	if (!acceptLanguage) return DEFAULT_LOCALE;
+	const parsed = acceptLanguage.split(",").map((lang) => {
+		const parts = lang.split(";");
+		const code = (parts[0] ?? "").trim().toLowerCase();
+		const base = code.split("-")[0] ?? "";
+		let q = 1;
+		const qualityPart = parts[1];
+		if (qualityPart) {
+			const qMatch = qualityPart.match(/q=([0-9.]+)/);
+			if (qMatch) q = parseFloat(qMatch[1] ?? "1");
+		}
+		return {
+			code,
+			base,
+			q
+		};
+	}).toSorted((a, b) => b.q - a.q);
+	for (const item of parsed) {
+		if (SUPPORTED_LOCALES.has(item.code)) return item.code;
+		const base = item.base;
+		if (SUPPORTED_LOCALES.has(base)) return base;
+	}
+	return DEFAULT_LOCALE;
+}
+/**
+* Hono middleware for Rimelight i18n. Handles locale routing, redirection, currentLocale store
+* updates, and Cloudflare KV binding setup.
+*/
+function i18n() {
+	return async (c, next) => {
+		try {
+			const kv = Reflect.get(env, "TRANSLATIONS_KV") || c.env?.TRANSLATIONS_KV;
+			if (kv) setKVBinding(kv);
+		} catch {}
+		const url = new URL(c.req.url);
+		const pathname = url.pathname;
+		if (c.req.method !== "GET" && c.req.method !== "HEAD") {
+			const paramLocale = c.req.param("locale");
+			const firstSegment = pathname.split("/").find(Boolean);
+			const activeLocale = (paramLocale && SUPPORTED_LOCALES.has(paramLocale) ? paramLocale : null) || (firstSegment && SUPPORTED_LOCALES.has(firstSegment) ? firstSegment : null) || DEFAULT_LOCALE;
+			currentLocale.set(activeLocale);
+			return next();
+		}
+		if (pathname.startsWith("/api") || pathname.startsWith("/_") || pathname.includes(".")) return next();
+		const firstSegment = pathname.split("/").find(Boolean);
+		const firstIsLocale = firstSegment !== void 0 && SUPPORTED_LOCALES.has(firstSegment);
+		if (prefixDefaultLocale) {
+			const paramLocale = c.req.param("locale");
+			const activeLocale = (paramLocale && SUPPORTED_LOCALES.has(paramLocale) ? paramLocale : null) || (firstIsLocale ? firstSegment : null) || DEFAULT_LOCALE;
+			currentLocale.set(activeLocale);
+			if (firstIsLocale) return next();
+			const locale = getPreferredLocale(c.req.header("accept-language") || null);
+			currentLocale.set(locale);
+			const targetPath = `/${locale}${pathname}${url.search}`;
+			return c.redirect(targetPath, 302);
+		} else {
+			if (firstIsLocale) {
+				if (firstSegment === DEFAULT_LOCALE) {
+					const rest = pathname.slice(DEFAULT_LOCALE.length + 1) || "/";
+					currentLocale.set(DEFAULT_LOCALE);
+					return c.redirect(`${rest}${url.search}`, 302);
+				}
+				currentLocale.set(firstSegment);
+				return next();
+			}
+			currentLocale.set(DEFAULT_LOCALE);
+			return next();
+		}
+	};
+}
+//#endregion
+export { i18n };

package/dist/index.d.mts

@@ -1,39 +1,39 @@
-import { ComponentsJSON, KVNamespaceBinding } from "./types.mjs";
-import { clearCache, currentLocale, getFormatterInstance, getI18nInstance, t, useFormat } from "@rimelight/i18n:runtime";
-import { TranslationLoader, Translations } from "@nanostores/i18n";
+import { i as KVNamespaceBinding, n as CustomTranslations, o as NestedTranslationKeys, s as TranslationKey, t as ComponentsJSON } from "./types-BKUPwH-e.mjs";
+import { a as getFormatterInstance, c as initializeI18n, d as useI18n, f as useI18nAsync, i as currentLocale, o as getI18nInstance, r as clearCache, s as getPluralCategory, u as useFormat } from "./runtime-Bc8I8sA4.mjs";
+import { i as i18n, n as RimelightI18nPlugins, t as RimelightI18nOptions } from "./plugin-CFEm0e4U.mjs";
+import { TranslationLoader } from "@nanostores/i18n";
 //#region src/index.d.ts
-interface ComponentMessages {
-  [key: string]: string;
-}
-declare function useI18n(componentName: string): ComponentMessages;
-declare function useI18n<Body extends Translations>(componentName: string, baseTranslations: Body): ComponentMessages & Body;
-declare function useI18n(astro: {
-  currentLocale?: string | undefined;
-  params?: Record<string, any>;
-} | undefined | null, componentName: string): ComponentMessages;
-declare function useI18n<Body extends Translations>(astro: {
-  currentLocale?: string | undefined;
-  params?: Record<string, any>;
-} | undefined | null, componentName: string, baseTranslations: Body): ComponentMessages & Body;
-declare function useI18nAsync(componentName: string): Promise<Record<string, string>>;
-declare function useI18nAsync<Body extends Translations>(componentName: string, baseTranslations: Body): Promise<Record<string, string> & Body>;
-declare function useI18nAsync(astro: {
-  currentLocale?: string | undefined;
-  params?: Record<string, any>;
-} | undefined | null, componentName: string): Promise<Record<string, string>>;
-declare function useI18nAsync<Body extends Translations>(astro: {
-  currentLocale?: string | undefined;
-  params?: Record<string, any>;
-} | undefined | null, componentName: string, baseTranslations: Body): Promise<Record<string, string> & Body>;
+declare let locales: string[];
+declare let defaultLocale: string;
+declare let prefixDefaultLocale: boolean;
+/**
+ * Translates a single string key using dot-notation (e.g. `t("page_home.section_hero_title")`).
+ * When augmented via CustomTranslations, keys are strictly type-checked and autocompleted.
+ */
+declare function t<K extends string = TranslationKey>(key: K | TranslationKey, params?: Record<string, any>): string;
 declare function getLocale(): string;
+/**
+ * Returns a standard BCP 47 / RFC 5646 language tag suitable for HTML `<html lang="...">`. Maps
+ * 2-letter codes like 'en' to 'en-US', 'pt' to 'pt-BR', 'es' to 'es-ES', etc.
+ */
+declare function getHtmlLang(): string;
+/**
+ * Returns an OpenGraph-compliant locale tag (e.g. 'en_US', 'pt_BR', 'es_ES').
+ */
+declare function getOgLocale(): string;
 declare function getRelativeLocaleUrl(path: string): string;
 declare function getRelativeLocaleUrl(locale: string, path: string): string;
-declare function setKVBinding(kv: KVNamespaceBinding): void;
-declare function createTranslationLoader(translations: Record<string, ComponentsJSON>): TranslationLoader;
+declare function getRelativeLocaleUrlList(path?: string): string[];
+interface LanguageAlternate {
+  hreflang: string;
+  href: string;
+}
 /**
- * Returns the plural category (e.g. 'one', 'few', 'many', 'other') for a given number and locale
- * using the native browser Intl.PluralRules API.
+ * Generates an array of hreflang alternates for SEO tags (<link rel="alternate" hreflang="...">).
+ * Automatically includes all supported locales and 'x-default'.
  */
-declare function getPluralCategory(count: number, locale?: string): Intl.LDMLPluralRule;
+declare function getLanguageAlternates(pathname: string, siteUrl?: string): LanguageAlternate[];
+declare function setKVBinding(kv: KVNamespaceBinding): void;
+declare function createTranslationLoader(translations: Record<string, ComponentsJSON>): TranslationLoader;
 //#endregion
-export { ComponentMessages, clearCache, createTranslationLoader, currentLocale, getFormatterInstance, getI18nInstance, getLocale, getPluralCategory, getRelativeLocaleUrl, setKVBinding, t, useFormat, useI18n, useI18nAsync };
+export { type CustomTranslations, LanguageAlternate, type NestedTranslationKeys, type RimelightI18nOptions, type RimelightI18nPlugins, type TranslationKey, clearCache, createTranslationLoader, currentLocale, defaultLocale, getFormatterInstance, getHtmlLang, getI18nInstance, getLanguageAlternates, getLocale, getOgLocale, getPluralCategory, getRelativeLocaleUrl, getRelativeLocaleUrlList, i18n, i18n as rimelightI18n, initializeI18n, locales, prefixDefaultLocale, setKVBinding, t, useFormat, useI18n, useI18nAsync };

package/dist/index.mjs

@@ -1,63 +1,4 @@
-import { clearCache, currentLocale, getFormatterInstance, getI18nInstance, t, useFormat, useI18n as useI18n$1, useI18nAsync as useI18nAsync$1 } from "@rimelight/i18n:runtime";
-import { getRelativeLocaleUrl as getRelativeLocaleUrl$1 } from "astro:i18n";
-//#region src/index.ts
-function useI18n(arg1, arg2, arg3) {
-	if (typeof arg1 === "string") return useI18n$1(arg1, arg2);
-	else {
-		const locale = arg1?.currentLocale || arg1?.params?.locale;
-		if (locale) currentLocale.set(locale);
-		return useI18n$1(arg2, arg3);
-	}
-}
-function useI18nAsync(arg1, arg2, arg3) {
-	if (typeof arg1 === "string") return useI18nAsync$1(arg1, arg2);
-	else {
-		const locale = arg1?.currentLocale || arg1?.params?.locale;
-		if (locale) currentLocale.set(locale);
-		return useI18nAsync$1(arg2, arg3);
-	}
-}
-function getLocale() {
-	return currentLocale.get() || "en";
-}
-function getRelativeLocaleUrl(arg1, arg2) {
-	if (arg2 !== void 0) return getRelativeLocaleUrl$1(arg1, arg2);
-	else {
-		const locale = getLocale();
-		return getRelativeLocaleUrl$1(locale, arg1);
-	}
-}
-let kvBinding = null;
-function setKVBinding(kv) {
-	kvBinding = kv;
-}
-function createTranslationLoader(translations) {
-	return async (locale, components) => {
-		const localeTranslations = translations[locale] || {};
-		if (!components || !Array.isArray(components) || components.length === 0) return localeTranslations;
-		const activeKv = kvBinding;
-		if (activeKv) try {
-			const results = await Promise.all(components.map(async (name) => {
-				const key = `locale:${locale}:${name}`;
-				const data = await activeKv.get(key, "json");
-				if (data == null) return { [name]: localeTranslations[name] ?? {} };
-				return { [name]: data };
-			}));
-			return Object.assign({}, ...results);
-		} catch {}
-		const results = await Promise.all(components.map(async (name) => {
-			const data = localeTranslations[name];
-			return { [name]: data ?? {} };
-		}));
-		return Object.assign({}, ...results);
-	};
-}
-/**
-* Returns the plural category (e.g. 'one', 'few', 'many', 'other') for a given number and locale
-* using the native browser Intl.PluralRules API.
-*/
-function getPluralCategory(count, locale = "en") {
-	return new Intl.PluralRules(locale).select(count);
-}
-//#endregion
-export { clearCache, createTranslationLoader, currentLocale, getFormatterInstance, getI18nInstance, getLocale, getPluralCategory, getRelativeLocaleUrl, setKVBinding, t, useFormat, useI18n, useI18nAsync };
+import { a as getPluralCategory, c as useFormat, i as getI18nInstance, l as useI18n, n as currentLocale, o as initializeI18n, r as getFormatterInstance, t as clearCache, u as useI18nAsync } from "./runtime-Civir_tv.mjs";
+import { t as i18n } from "./plugin-nQl4lZKv.mjs";
+import { a as getLocale, c as getRelativeLocaleUrlList, d as setKVBinding, f as t, i as getLanguageAlternates, l as locales, n as defaultLocale, o as getOgLocale, r as getHtmlLang, s as getRelativeLocaleUrl, t as createTranslationLoader, u as prefixDefaultLocale } from "./src-D09inETW.mjs";
+export { clearCache, createTranslationLoader, currentLocale, defaultLocale, getFormatterInstance, getHtmlLang, getI18nInstance, getLanguageAlternates, getLocale, getOgLocale, getPluralCategory, getRelativeLocaleUrl, getRelativeLocaleUrlList, i18n, i18n as rimelightI18n, initializeI18n, locales, prefixDefaultLocale, setKVBinding, t, useFormat, useI18n, useI18nAsync };

package/dist/plugin-CFEm0e4U.d.mts

@@ -0,0 +1,39 @@
+//#region src/plugin.d.ts
+interface RimelightI18nOptions {
+  /**
+   * List of supported locale codes (e.g. `["en", "pt"]`).
+   */
+  locales?: string[];
+  /**
+   * The default locale code (e.g. `"en"`).
+   */
+  defaultLocale?: string;
+  /**
+   * Whether to prefix the default locale in URLs.
+   *
+   * - `true` (default): all locales are prefixed — `/en/about`, `/pt/about`
+   * - `false`: the default locale has no prefix — `/about`, `/pt/about`
+   */
+  prefixDefaultLocale?: boolean;
+  validateExtraction?: boolean;
+  translations?: Record<string, Record<string, any>>;
+  kvBinding?: string;
+  translationLoader?: string;
+}
+interface RimelightI18nVitePlugin {
+  name: string;
+  enforce?: "pre" | "post";
+  resolveId?: (id: string) => string | null | undefined;
+  load?: (id: string) => string | null | undefined;
+  config?: (config: any) => any;
+  closeBundle?: () => Promise<void> | void;
+  [key: string]: any;
+}
+type RimelightI18nPlugins = RimelightI18nVitePlugin[];
+/**
+ * Pure Vite plugin for Rimelight i18n. Provides virtual modules `@rimelight/i18n:runtime` and
+ * `virtual:rimelight-i18n-config`.
+ */
+declare function i18n(options?: RimelightI18nOptions): RimelightI18nPlugins;
+//#endregion
+export { i18n as i, RimelightI18nPlugins as n, RimelightI18nVitePlugin as r, RimelightI18nOptions as t };

package/dist/plugin-nQl4lZKv.mjs

@@ -0,0 +1,55 @@
+import fs from "node:fs";
+import path from "node:path";
+//#region src/plugin.ts
+/**
+* Pure Vite plugin for Rimelight i18n. Provides virtual modules `@rimelight/i18n:runtime` and
+* `virtual:rimelight-i18n-config`.
+*/
+function i18n(options) {
+	const translations = options?.translations;
+	const kvBinding = options?.kvBinding ?? "TRANSLATIONS_KV";
+	const locales = options?.locales ?? ["en"];
+	const defaultLocale = options?.defaultLocale ?? "en";
+	const prefixDefaultLocale = options?.prefixDefaultLocale ?? true;
+	const normalisedTranslations = {};
+	if (translations) for (const [locale, val] of Object.entries(translations)) normalisedTranslations[locale] = val;
+	return [{
+		name: "vite-plugin-rimelight-i18n-config",
+		resolveId(id) {
+			if (id === "virtual:rimelight-i18n-config") return "\0" + id;
+			return null;
+		},
+		load(id) {
+			if (id === "\0virtual:rimelight-i18n-config") return `
+            export const locales = ${JSON.stringify(locales)};
+            export const defaultLocale = ${JSON.stringify(defaultLocale)};
+            export const prefixDefaultLocale = ${JSON.stringify(prefixDefaultLocale)};
+            export const translations = ${JSON.stringify(normalisedTranslations)};
+          `;
+			return null;
+		},
+		async closeBundle() {
+			if (!translations) return;
+			const seedData = { keys: [] };
+			for (const [locale, localeData] of Object.entries(translations)) for (const [component, componentData] of Object.entries(localeData)) seedData.keys.push({
+				key: `locale:${locale}:${component}`,
+				value: JSON.stringify(componentData)
+			});
+			const outDir = process.env.WRANGLER_OUT_DIR ?? "dist";
+			const seedFile = path.join(outDir, "_translations-seed.json");
+			try {
+				fs.mkdirSync(path.dirname(seedFile), { recursive: true });
+				fs.writeFileSync(seedFile, JSON.stringify(seedData, null, 2));
+				if (process.env.WRANGLER_SEED_KV === "true" || process.env.CI === "true") {
+					const { execSync } = await import("node:child_process");
+					execSync(`npx wrangler kv:bulk put --binding "${kvBinding}" "${seedFile}"`, {
+						stdio: "pipe",
+						timeout: 3e4
+					});
+				}
+			} catch {}
+		}
+	}];
+}
+//#endregion
+export { i18n as t };

package/dist/plugin.d.mts

@@ -0,0 +1,2 @@
+import { i as i18n, n as RimelightI18nPlugins, r as RimelightI18nVitePlugin, t as RimelightI18nOptions } from "./plugin-CFEm0e4U.mjs";
+export { RimelightI18nOptions, RimelightI18nPlugins, RimelightI18nVitePlugin, i18n, i18n as rimelightI18n };

package/dist/plugin.mjs

@@ -0,0 +1,2 @@
+import { t as i18n } from "./plugin-nQl4lZKv.mjs";
+export { i18n, i18n as rimelightI18n };

package/dist/runtime-Bc8I8sA4.d.mts

@@ -0,0 +1,72 @@
+import { Components, I18n, TranslationLoader, Translations, formatter } from "@nanostores/i18n";
+//#region src/runtime.d.ts
+/**
+ * A reactive store containing the current locale code. Set by middleware on each request, or
+ * manually via `currentLocale.set(locale)`.
+ */
+declare const currentLocale: import("nanostores").PreinitializedWritableAtom<string> & object;
+type I18nInstance = I18n;
+type FormatterInstance = ReturnType<typeof formatter>;
+interface InitializeI18nOptions {
+  /**
+   * The default locale code (e.g. 'en').
+   */
+  defaultLocale: string;
+  /**
+   * Pre-loaded translations keyed by locale then component.
+   */
+  translations: Record<string, Components>;
+  /**
+   * Optional dynamic loader called when a locale is not in cache.
+   */
+  get?: TranslationLoader;
+}
+/**
+ * Initializes the i18n system. Must be called once before any other i18n functions are used (the
+ * integration virtual module does this automatically).
+ */
+declare function initializeI18n(options: InitializeI18nOptions): void;
+/**
+ * Returns the underlying nanostores/i18n instance. Throws if not initialized.
+ */
+declare function getI18nInstance(): I18nInstance;
+/**
+ * Returns the formatter instance. Throws if not initialized.
+ */
+declare function getFormatterInstance(): FormatterInstance;
+/**
+ * Returns a Formatter object for the current locale with methods for formatting numbers, dates, and
+ * relative times using the native Intl API.
+ */
+declare function useFormat(): ReturnType<FormatterInstance["get"]>;
+/**
+ * Returns the translated strings for a component in the current locale. Falls back to defaultLocale
+ * loaded translations or `baseTranslations` if provided.
+ */
+interface ComponentMessages {
+  [key: string]: string;
+}
+declare function useI18n(componentName: string): ComponentMessages;
+declare function useI18n<Body extends Translations>(componentName: string, baseTranslations: Body): ComponentMessages & Body;
+/**
+ * Async version of useI18n that waits for translations to finish loading.
+ */
+declare function useI18nAsync(componentName: string): Promise<ComponentMessages>;
+declare function useI18nAsync<Body extends Translations>(componentName: string, baseTranslations: Body): Promise<ComponentMessages & Body>;
+/**
+ * Translates a single string key using dot-notation (e.g. `t("page_home.section_hero_title")`).
+ */
+declare function t(key: string, params?: Record<string, any>): string;
+/**
+ * Returns the plural category (e.g. 'one', 'few', 'many', 'other') for a given number and locale
+ * using the native browser Intl.PluralRules API.
+ */
+declare function getPluralCategory(count: number, locale?: string): Intl.LDMLPluralRule;
+/**
+ * Clears the translation cache.
+ *
+ * @param locale - If provided, clears only that locale's cache. Otherwise clears all.
+ */
+declare function clearCache(locale?: string): void;
+//#endregion
+export { getFormatterInstance as a, initializeI18n as c, useI18n as d, useI18nAsync as f, currentLocale as i, t as l, InitializeI18nOptions as n, getI18nInstance as o, clearCache as r, getPluralCategory as s, ComponentMessages as t, useFormat as u };

package/dist/runtime-Civir_tv.mjs

@@ -0,0 +1,183 @@
+import { createI18n, formatter, translationsLoading } from "@nanostores/i18n";
+import { atom } from "nanostores";
+//#region src/runtime.ts
+/**
+* A reactive store containing the current locale code. Set by middleware on each request, or
+* manually via `currentLocale.set(locale)`.
+*/
+const currentLocale = atom("");
+let i18nInstance;
+let formatterInstance;
+let baseLocaleDefault = "en";
+let rawTranslationsDict = {};
+function throwNotInitialized() {
+	throw new Error("i18n not initialized. Call initializeI18n first.");
+}
+/**
+* Wraps a TranslationLoader so that the returned object is guaranteed to contain a key for every
+* requested component.
+*
+* The nanostores i18n library uses the keys of the object returned from `get` to clear its internal
+* "requested" set. If a requested component is missing from the result (e.g. because the backend
+* has no translations for it in the given locale yet), the internal loading atom is never set back
+* to `false`, which causes useI18nAsync / translationsLoading to hang forever.
+*
+* This wrapper normalises the loader output so missing components are filled in with empty
+* translation objects, falling back to the base translations defined at the call site.
+*/
+function wrapLoader(loader) {
+	return async (code, components) => {
+		const raw = await loader(code, components);
+		const normalised = Array.isArray(raw) ? Object.assign({}, ...raw) : { ...raw };
+		for (const component of components) if (!(component in normalised)) normalised[component] = {};
+		return normalised;
+	};
+}
+/**
+* Initializes the i18n system. Must be called once before any other i18n functions are used (the
+* integration virtual module does this automatically).
+*/
+function initializeI18n(options) {
+	const { defaultLocale, translations, get } = options;
+	baseLocaleDefault = defaultLocale;
+	rawTranslationsDict = translations || {};
+	if (!i18nInstance) {
+		currentLocale.set(defaultLocale);
+		const formattedCache = {};
+		for (const [locale, components] of Object.entries(translations)) {
+			formattedCache[locale] = {};
+			for (const [compName, compBody] of Object.entries(components)) {
+				let bodyObj = {};
+				if (isStringRecord(compBody)) bodyObj = compBody;
+				else if (isStoreWithGet(compBody)) {
+					const res = compBody.get();
+					if (isStringRecord(res)) bodyObj = res;
+				}
+				formattedCache[locale][compName] = atom(bodyObj);
+			}
+		}
+		i18nInstance = createI18n(currentLocale, {
+			baseLocale: defaultLocale,
+			get: wrapLoader(get ?? (async () => ({}))),
+			cache: formattedCache,
+			isSSR: true
+		});
+	}
+	formatterInstance = formatter(currentLocale);
+}
+/**
+* Returns the underlying nanostores/i18n instance. Throws if not initialized.
+*/
+function getI18nInstance() {
+	if (!i18nInstance) throwNotInitialized();
+	return i18nInstance;
+}
+/**
+* Returns the formatter instance. Throws if not initialized.
+*/
+function getFormatterInstance() {
+	if (!formatterInstance) throwNotInitialized();
+	return formatterInstance;
+}
+/**
+* Returns a Formatter object for the current locale with methods for formatting numbers, dates, and
+* relative times using the native Intl API.
+*/
+function useFormat() {
+	return getFormatterInstance().get();
+}
+function isStoreWithGet(obj) {
+	if (typeof obj !== "object" || obj === null) return false;
+	return typeof Reflect.get(obj, "get") === "function";
+}
+function isStringRecord(obj) {
+	return typeof obj === "object" && obj !== null;
+}
+function getCachedComponent(locale, componentName) {
+	const normalizedLocale = locale.toLowerCase();
+	const candidates = [
+		locale,
+		normalizedLocale,
+		normalizedLocale.split("-")[0] ?? normalizedLocale,
+		baseLocaleDefault
+	];
+	for (const code of candidates) {
+		const rawComp = rawTranslationsDict[code]?.[componentName];
+		if (isStoreWithGet(rawComp)) {
+			const res = rawComp.get();
+			if (isStringRecord(res)) return res;
+		} else if (isStringRecord(rawComp)) return rawComp;
+	}
+	if (!i18nInstance) return void 0;
+	for (const code of candidates) {
+		const rawComp = i18nInstance.cache[code]?.[componentName];
+		if (isStoreWithGet(rawComp)) {
+			const res = rawComp.get();
+			if (isStringRecord(res)) return res;
+		} else if (isStringRecord(rawComp)) return rawComp;
+	}
+}
+function useI18n(componentName, baseTranslations) {
+	const i18n = getI18nInstance();
+	const activeLocale = currentLocale.get() || baseLocaleDefault;
+	const fallbackDict = isStringRecord(baseTranslations) ? baseTranslations : {};
+	const baseDict = getCachedComponent(activeLocale, componentName) ?? getCachedComponent(baseLocaleDefault, componentName) ?? fallbackDict;
+	const targetObj = i18n(componentName, baseDict).get();
+	return new Proxy(targetObj, { get(target, prop) {
+		if (typeof prop === "symbol" || prop in Object.prototype) {
+			const val = Reflect.get(target, prop);
+			return typeof val === "string" ? val : "";
+		}
+		return target[prop] ?? baseDict[prop] ?? prop;
+	} });
+}
+async function useI18nAsync(componentName, baseTranslations) {
+	const i18n = getI18nInstance();
+	const cachedActive = getCachedComponent(currentLocale.get() || baseLocaleDefault, componentName);
+	const cachedDefault = getCachedComponent(baseLocaleDefault, componentName);
+	let baseDict = cachedActive ?? cachedDefault ?? {};
+	if (!cachedActive && !cachedDefault && isStringRecord(baseTranslations)) baseDict = baseTranslations;
+	const store = i18n(componentName, baseDict);
+	const unsubscribe = store.listen(() => {});
+	await translationsLoading(i18n);
+	unsubscribe();
+	return store.get();
+}
+/**
+* Translates a single string key using dot-notation (e.g. `t("page_home.section_hero_title")`).
+*/
+function t(key, params) {
+	const dotIndex = key.indexOf(".");
+	if (dotIndex === -1) return key;
+	const componentName = key.slice(0, dotIndex);
+	const keyName = key.slice(dotIndex + 1);
+	const activeLocale = currentLocale.get() || baseLocaleDefault;
+	let value = (getCachedComponent(activeLocale, componentName) ?? getCachedComponent(baseLocaleDefault, componentName) ?? {})[keyName] ?? key;
+	if (params && typeof params.count === "number" && typeof value === "object" && value !== null) {
+		const pluralCategory = getPluralCategory(params.count, activeLocale);
+		value = value[pluralCategory] ?? value.other ?? key;
+	}
+	if (typeof value === "function") return value(params);
+	if (params && typeof value === "string") return value.replace(/\{(\w+)\}/g, (_, k) => String(params[k] ?? `{${k}}`));
+	return typeof value === "string" ? value : String(value);
+}
+/**
+* Returns the plural category (e.g. 'one', 'few', 'many', 'other') for a given number and locale
+* using the native browser Intl.PluralRules API.
+*/
+function getPluralCategory(count, locale = "en") {
+	return new Intl.PluralRules(locale).select(count);
+}
+/**
+* Clears the translation cache.
+*
+* @param locale - If provided, clears only that locale's cache. Otherwise clears all.
+*/
+function clearCache(locale) {
+	if (!i18nInstance) throwNotInitialized();
+	const cache = i18nInstance.cache;
+	if (locale) cache[locale] = {};
+	else for (const key in cache) cache[key] = {};
+}
+//#endregion
+export { getPluralCategory as a, useFormat as c, getI18nInstance as i, useI18n as l, currentLocale as n, initializeI18n as o, getFormatterInstance as r, t as s, clearCache as t, useI18nAsync as u };

package/dist/runtime.d.mts

@@ -1,71 +1,2 @@
-import { Components, I18n, TranslationLoader, Translations, formatter } from "@nanostores/i18n";
-//#region src/runtime.d.ts
-/**
- * A reactive store containing the current locale code. Set by middleware on each request, or
- * manually via `currentLocale.set(locale)`.
- */
-declare const currentLocale: import("nanostores").PreinitializedWritableAtom<string> & object;
-type I18nInstance = I18n;
-type FormatterInstance = ReturnType<typeof formatter>;
-interface InitializeI18nOptions {
-  /**
-   * The default locale code (e.g. 'en').
-   */
-  defaultLocale: string;
-  /**
-   * Pre-loaded translations keyed by locale then component.
-   */
-  translations: Record<string, Components>;
-  /**
-   * Optional dynamic loader called when a locale is not in cache.
-   */
-  get?: TranslationLoader;
-}
-/**
- * Initializes the i18n system. Must be called once before any other i18n functions are used (the
- * integration virtual module does this automatically).
- */
-declare function initializeI18n(options: InitializeI18nOptions): void;
-/**
- * Returns the underlying nanostores/i18n instance. Throws if not initialized.
- */
-declare function getI18nInstance(): I18nInstance;
-/**
- * Returns the formatter instance. Throws if not initialized.
- */
-declare function getFormatterInstance(): FormatterInstance;
-/**
- * Returns a Formatter object for the current locale with methods for formatting numbers, dates, and
- * relative times using the native Intl API.
- */
-declare function useFormat(): ReturnType<FormatterInstance["get"]>;
-/**
- * Returns the translated strings for a component in the current locale. Falls back to defaultLocale
- * loaded translations or `baseTranslations` if provided.
- */
-interface ComponentMessages {
-  [key: string]: string;
-}
-declare function useI18n(componentName: string): ComponentMessages;
-declare function useI18n<Body extends Translations>(componentName: string, baseTranslations: Body): ComponentMessages & Body;
-/**
- * Async version of useI18n that waits for translations to finish loading.
- */
-declare function useI18nAsync(componentName: string): Promise<ComponentMessages>;
-declare function useI18nAsync<Body extends Translations>(componentName: string, baseTranslations: Body): Promise<ComponentMessages & Body>;
-/**
- * Translates a single string key using dot-notation (e.g. `t("page_home.section_hero_title")`).
- */
-declare function t(key: string, params?: Record<string, any>): string;
-declare function t(astro: {
-  currentLocale?: string | undefined;
-  params?: Record<string, any>;
-} | undefined | null, key: string, params?: Record<string, any>): string;
-/**
- * Clears the translation cache.
- *
- * @param locale - If provided, clears only that locale's cache. Otherwise clears all.
- */
-declare function clearCache(locale?: string): void;
-//#endregion
-export { ComponentMessages, InitializeI18nOptions, clearCache, currentLocale, getFormatterInstance, getI18nInstance, initializeI18n, t, useFormat, useI18n, useI18nAsync };
+import { a as getFormatterInstance, c as initializeI18n, d as useI18n, f as useI18nAsync, i as currentLocale, l as t, n as InitializeI18nOptions, o as getI18nInstance, r as clearCache, s as getPluralCategory, t as ComponentMessages, u as useFormat } from "./runtime-Bc8I8sA4.mjs";
+export { ComponentMessages, InitializeI18nOptions, clearCache, currentLocale, getFormatterInstance, getI18nInstance, getPluralCategory, initializeI18n, t, useFormat, useI18n, useI18nAsync };

package/dist/runtime.mjs

@@ -1,179 +1,2 @@
-import { createI18n, formatter, translationsLoading } from "@nanostores/i18n";
-import { atom } from "nanostores";
-//#region src/runtime.ts
-/**
-* A reactive store containing the current locale code. Set by middleware on each request, or
-* manually via `currentLocale.set(locale)`.
-*/
-const currentLocale = atom("");
-let i18nInstance;
-let formatterInstance;
-let baseLocaleDefault = "en";
-let rawTranslationsDict = {};
-function throwNotInitialized() {
-	throw new Error("i18n not initialized. Call initializeI18n first.");
-}
-/**
-* Wraps a TranslationLoader so that the returned object is guaranteed to contain a key for every
-* requested component.
-*
-* The nanostores i18n library uses the keys of the object returned from `get` to clear its internal
-* "requested" set. If a requested component is missing from the result (e.g. because the backend
-* has no translations for it in the given locale yet), the internal loading atom is never set back
-* to `false`, which causes useI18nAsync / translationsLoading to hang forever.
-*
-* This wrapper normalises the loader output so missing components are filled in with empty
-* translation objects, falling back to the base translations defined at the call site.
-*/
-function wrapLoader(loader) {
-	return async (code, components) => {
-		const raw = await loader(code, components);
-		const normalised = Array.isArray(raw) ? Object.assign({}, ...raw) : { ...raw };
-		for (const component of components) if (!(component in normalised)) normalised[component] = {};
-		return normalised;
-	};
-}
-/**
-* Initializes the i18n system. Must be called once before any other i18n functions are used (the
-* integration virtual module does this automatically).
-*/
-function initializeI18n(options) {
-	const { defaultLocale, translations, get } = options;
-	baseLocaleDefault = defaultLocale;
-	rawTranslationsDict = translations || {};
-	if (!i18nInstance) {
-		currentLocale.set(defaultLocale);
-		const formattedCache = {};
-		for (const [locale, components] of Object.entries(translations)) {
-			formattedCache[locale] = {};
-			for (const [compName, compBody] of Object.entries(components)) {
-				let bodyObj = {};
-				if (isStringRecord(compBody)) bodyObj = compBody;
-				else if (isStoreWithGet(compBody)) {
-					const res = compBody.get();
-					if (isStringRecord(res)) bodyObj = res;
-				}
-				formattedCache[locale][compName] = atom(bodyObj);
-			}
-		}
-		i18nInstance = createI18n(currentLocale, {
-			baseLocale: defaultLocale,
-			get: wrapLoader(get ?? (async () => ({}))),
-			cache: formattedCache,
-			isSSR: true
-		});
-	}
-	formatterInstance = formatter(currentLocale);
-}
-/**
-* Returns the underlying nanostores/i18n instance. Throws if not initialized.
-*/
-function getI18nInstance() {
-	if (!i18nInstance) throwNotInitialized();
-	return i18nInstance;
-}
-/**
-* Returns the formatter instance. Throws if not initialized.
-*/
-function getFormatterInstance() {
-	if (!formatterInstance) throwNotInitialized();
-	return formatterInstance;
-}
-/**
-* Returns a Formatter object for the current locale with methods for formatting numbers, dates, and
-* relative times using the native Intl API.
-*/
-function useFormat() {
-	return getFormatterInstance().get();
-}
-function isStoreWithGet(obj) {
-	if (typeof obj !== "object" || obj === null) return false;
-	return typeof Reflect.get(obj, "get") === "function";
-}
-function isStringRecord(obj) {
-	return typeof obj === "object" && obj !== null;
-}
-function getCachedComponent(locale, componentName) {
-	const normalizedLocale = locale.toLowerCase();
-	const candidates = [
-		locale,
-		normalizedLocale,
-		normalizedLocale.split("-")[0] ?? normalizedLocale,
-		baseLocaleDefault
-	];
-	for (const code of candidates) {
-		const rawComp = rawTranslationsDict[code]?.[componentName];
-		if (isStoreWithGet(rawComp)) {
-			const res = rawComp.get();
-			if (isStringRecord(res)) return res;
-		} else if (isStringRecord(rawComp)) return rawComp;
-	}
-	if (!i18nInstance) return void 0;
-	for (const code of candidates) {
-		const rawComp = i18nInstance.cache[code]?.[componentName];
-		if (isStoreWithGet(rawComp)) {
-			const res = rawComp.get();
-			if (isStringRecord(res)) return res;
-		} else if (isStringRecord(rawComp)) return rawComp;
-	}
-}
-function useI18n(componentName, baseTranslations) {
-	const i18n = getI18nInstance();
-	const activeLocale = currentLocale.get() || baseLocaleDefault;
-	const fallbackDict = isStringRecord(baseTranslations) ? baseTranslations : {};
-	const baseDict = getCachedComponent(activeLocale, componentName) ?? getCachedComponent(baseLocaleDefault, componentName) ?? fallbackDict;
-	const targetObj = i18n(componentName, baseDict).get();
-	return new Proxy(targetObj, { get(target, prop) {
-		if (typeof prop === "symbol" || prop in Object.prototype) {
-			const val = Reflect.get(target, prop);
-			return typeof val === "string" ? val : "";
-		}
-		return target[prop] ?? baseDict[prop] ?? prop;
-	} });
-}
-async function useI18nAsync(componentName, baseTranslations) {
-	const i18n = getI18nInstance();
-	const cachedActive = getCachedComponent(currentLocale.get() || baseLocaleDefault, componentName);
-	const cachedDefault = getCachedComponent(baseLocaleDefault, componentName);
-	let baseDict = cachedActive ?? cachedDefault ?? {};
-	if (!cachedActive && !cachedDefault && isStringRecord(baseTranslations)) baseDict = baseTranslations;
-	const store = i18n(componentName, baseDict);
-	const unsubscribe = store.listen(() => {});
-	await translationsLoading(i18n);
-	unsubscribe();
-	return store.get();
-}
-function t(arg1, arg2, arg3) {
-	let key;
-	let params;
-	if (typeof arg1 === "string") {
-		key = arg1;
-		params = arg2;
-	} else {
-		const locale = arg1?.currentLocale || arg1?.params?.locale;
-		if (locale) currentLocale.set(locale);
-		key = arg2;
-		params = arg3;
-	}
-	const dotIndex = key.indexOf(".");
-	if (dotIndex === -1) return key;
-	const componentName = key.slice(0, dotIndex);
-	const keyName = key.slice(dotIndex + 1);
-	const value = (getCachedComponent(currentLocale.get() || baseLocaleDefault, componentName) ?? getCachedComponent(baseLocaleDefault, componentName) ?? {})[keyName] ?? key;
-	if (typeof value === "function") return value(params);
-	if (params && typeof value === "string") return value.replace(/\{(\w+)\}/g, (_, k) => String(params[k] ?? `{${k}}`));
-	return value;
-}
-/**
-* Clears the translation cache.
-*
-* @param locale - If provided, clears only that locale's cache. Otherwise clears all.
-*/
-function clearCache(locale) {
-	if (!i18nInstance) throwNotInitialized();
-	const cache = i18nInstance.cache;
-	if (locale) cache[locale] = {};
-	else for (const key in cache) cache[key] = {};
-}
-//#endregion
-export { clearCache, currentLocale, getFormatterInstance, getI18nInstance, initializeI18n, t, useFormat, useI18n, useI18nAsync };
+import { a as getPluralCategory, c as useFormat, i as getI18nInstance, l as useI18n, n as currentLocale, o as initializeI18n, r as getFormatterInstance, s as t, t as clearCache, u as useI18nAsync } from "./runtime-Civir_tv.mjs";
+export { clearCache, currentLocale, getFormatterInstance, getI18nInstance, getPluralCategory, initializeI18n, t, useFormat, useI18n, useI18nAsync };

package/dist/src-D09inETW.mjs

@@ -0,0 +1,121 @@
+import { n as currentLocale, o as initializeI18n, s as t$1 } from "./runtime-Civir_tv.mjs";
+//#region src/index.ts
+let locales = ["en"];
+let defaultLocale = "en";
+let prefixDefaultLocale = true;
+let translations = {};
+try {
+	const cfg = await import("virtual:rimelight-i18n-config");
+	if (cfg) {
+		if (cfg.locales) locales = cfg.locales;
+		if (cfg.defaultLocale) defaultLocale = cfg.defaultLocale;
+		if (cfg.prefixDefaultLocale !== void 0) prefixDefaultLocale = cfg.prefixDefaultLocale;
+		if (cfg.translations) translations = cfg.translations;
+	}
+} catch {}
+if (translations && Object.keys(translations).length > 0) initializeI18n({
+	defaultLocale: defaultLocale || "en",
+	translations
+});
+/**
+* Translates a single string key using dot-notation (e.g. `t("page_home.section_hero_title")`).
+* When augmented via CustomTranslations, keys are strictly type-checked and autocompleted.
+*/
+function t(key, params) {
+	return t$1(key, params);
+}
+function getLocale() {
+	return currentLocale.get() || defaultLocale || "en";
+}
+/**
+* Returns a standard BCP 47 / RFC 5646 language tag suitable for HTML `<html lang="...">`. Maps
+* 2-letter codes like 'en' to 'en-US', 'pt' to 'pt-BR', 'es' to 'es-ES', etc.
+*/
+function getHtmlLang() {
+	const loc = getLocale();
+	return {
+		en: "en-US",
+		pt: "pt-BR",
+		es: "es-ES"
+	}[loc] || loc;
+}
+/**
+* Returns an OpenGraph-compliant locale tag (e.g. 'en_US', 'pt_BR', 'es_ES').
+*/
+function getOgLocale() {
+	const loc = getLocale();
+	return {
+		en: "en_US",
+		pt: "pt_BR",
+		es: "es_ES"
+	}[loc] || `${loc}_${loc.toUpperCase()}`;
+}
+function getRelativeLocaleUrl(arg1, arg2) {
+	let targetLocale;
+	let targetPath;
+	if (arg2 !== void 0) {
+		targetLocale = arg1;
+		targetPath = arg2;
+	} else {
+		targetLocale = getLocale();
+		targetPath = arg1;
+	}
+	if (/^(?:[a-z]+:|\/\/|#)/i.test(targetPath) || targetPath.startsWith("mailto:") || targetPath.startsWith("tel:")) return targetPath;
+	const [pathWithoutQueryAndHash, queryAndHash] = (() => {
+		const match = targetPath.match(/^([^?#]*)([?#].*)?$/);
+		return [match?.[1] ?? "", match?.[2] ?? ""];
+	})();
+	const rawCleanPath = pathWithoutQueryAndHash.replace(/^\/+/, "");
+	const segments = rawCleanPath ? rawCleanPath.split("/") : [];
+	if (segments.length > 0 && locales.includes(segments[0])) segments.shift();
+	const cleanPath = segments.join("/");
+	const prefix = prefixDefaultLocale || targetLocale !== defaultLocale ? `/${targetLocale}` : "";
+	if (!cleanPath) return `${prefix ? `${prefix}/` : "/"}${queryAndHash}`;
+	return `${`${prefix}/${cleanPath}${pathWithoutQueryAndHash.endsWith("/") ? "/" : ""}`}${queryAndHash}`;
+}
+function getRelativeLocaleUrlList(path = "/") {
+	return locales.map((locale) => getRelativeLocaleUrl(locale, path));
+}
+/**
+* Generates an array of hreflang alternates for SEO tags (<link rel="alternate" hreflang="...">).
+* Automatically includes all supported locales and 'x-default'.
+*/
+function getLanguageAlternates(pathname, siteUrl = "") {
+	const normalizedSiteUrl = siteUrl.replace(/\/+$/, "");
+	const alternates = locales.map((loc) => ({
+		hreflang: loc,
+		href: `${normalizedSiteUrl}${getRelativeLocaleUrl(loc, pathname)}`
+	}));
+	alternates.push({
+		hreflang: "x-default",
+		href: `${normalizedSiteUrl}${getRelativeLocaleUrl(defaultLocale, pathname)}`
+	});
+	return alternates;
+}
+let kvBinding = null;
+function setKVBinding(kv) {
+	kvBinding = kv;
+}
+function createTranslationLoader(translations) {
+	return async (locale, components) => {
+		const localeTranslations = translations[locale] || {};
+		if (!components || !Array.isArray(components) || components.length === 0) return localeTranslations;
+		const activeKv = kvBinding;
+		if (activeKv) try {
+			const results = await Promise.all(components.map(async (name) => {
+				const key = `locale:${locale}:${name}`;
+				const data = await activeKv.get(key, "json");
+				if (data == null) return { [name]: localeTranslations[name] ?? {} };
+				return { [name]: data };
+			}));
+			return Object.assign({}, ...results);
+		} catch {}
+		const results = await Promise.all(components.map(async (name) => {
+			const data = localeTranslations[name];
+			return { [name]: data ?? {} };
+		}));
+		return Object.assign({}, ...results);
+	};
+}
+//#endregion
+export { getLocale as a, getRelativeLocaleUrlList as c, setKVBinding as d, t as f, getLanguageAlternates as i, locales as l, defaultLocale as n, getOgLocale as o, getHtmlLang as r, getRelativeLocaleUrl as s, createTranslationLoader as t, prefixDefaultLocale as u };

package/dist/types-BKUPwH-e.d.mts

@@ -0,0 +1,32 @@
+import { ComponentsJSON } from "@nanostores/i18n";
+//#region src/types.d.ts
+interface FlattenedTranslations {
+  [key: string]: string;
+}
+interface LocaleFile {
+  [component: string]: {
+    [key: string]: string;
+  };
+}
+interface KVNamespaceBinding {
+  get(key: string, type: "json"): Promise<Record<string, string> | null>;
+  put(key: string, value: string): Promise<void>;
+}
+/**
+ * Derives dot-notated nested translation keys (e.g. "page_home.section_hero_title") from a
+ * translation schema type.
+ */
+type NestedTranslationKeys<T> = T extends object ? { [K in keyof T & (string | number)]: T[K] extends object ? `${K}.${NestedTranslationKeys<T[K]>}` : `${K}`; }[keyof T & (string | number)] : never;
+/**
+ * Augmented interface for app-level strongly typed translation keys. Applications can declare:
+ *
+ * ```ts
+ * declare module "@rimelight/i18n" {
+ *   interface CustomTranslations extends typeof import("./translations/en.json") {}
+ * }
+ * ```
+ */
+interface CustomTranslations {}
+type TranslationKey = [keyof CustomTranslations] extends [never] ? string : NestedTranslationKeys<CustomTranslations>;
+//#endregion
+export { LocaleFile as a, KVNamespaceBinding as i, CustomTranslations as n, NestedTranslationKeys as o, FlattenedTranslations as r, TranslationKey as s, ComponentsJSON as t };

package/dist/types.d.mts

@@ -1,16 +1,2 @@
-import { ComponentsJSON } from "@nanostores/i18n";
-//#region src/types.d.ts
-interface FlattenedTranslations {
-  [key: string]: string;
-}
-interface LocaleFile {
-  [component: string]: {
-    [key: string]: string;
-  };
-}
-interface KVNamespaceBinding {
-  get(key: string, type: "json"): Promise<Record<string, string> | null>;
-  put(key: string, value: string): Promise<void>;
-}
-//#endregion
-export { type ComponentsJSON, FlattenedTranslations, KVNamespaceBinding, LocaleFile };
+import { a as LocaleFile, i as KVNamespaceBinding, n as CustomTranslations, o as NestedTranslationKeys, r as FlattenedTranslations, s as TranslationKey, t as ComponentsJSON } from "./types-BKUPwH-e.mjs";
+export { type ComponentsJSON, CustomTranslations, FlattenedTranslations, KVNamespaceBinding, LocaleFile, NestedTranslationKeys, TranslationKey };

package/dist/utils.d.mts

@@ -1,7 +1,12 @@
-import { ComponentsJSON, FlattenedTranslations } from "./types.mjs";
+import { r as FlattenedTranslations, t as ComponentsJSON } from "./types-BKUPwH-e.mjs";
 //#region src/utils.d.ts
 declare function flatten(obj: ComponentsJSON): FlattenedTranslations;
 declare function unflatten(flat: FlattenedTranslations): ComponentsJSON;
 declare function extractKeys(source: ComponentsJSON): string[];
+/**
+ * Compares a target translation dictionary against a base/source translation dictionary, returning
+ * any missing component keys.
+ */
+declare function findMissingKeys(base: Record<string, Record<string, any>>, target: Record<string, Record<string, any>>): string[];
 //#endregion
-export { extractKeys, flatten, unflatten };
+export { extractKeys, findMissingKeys, flatten, unflatten };

package/dist/utils.mjs

@@ -24,5 +24,20 @@ function extractKeys(source) {
 	for (const [component, translations] of Object.entries(source)) if (translations && typeof translations === "object") for (const key of Object.keys(translations)) keys.push(`${component}.${key}`);
 	return keys;
 }
+/**
+* Compares a target translation dictionary against a base/source translation dictionary, returning
+* any missing component keys.
+*/
+function findMissingKeys(base, target) {
+	const missing = [];
+	for (const [component, keys] of Object.entries(base)) {
+		if (!target[component] || typeof target[component] !== "object") {
+			missing.push(component);
+			continue;
+		}
+		for (const key of Object.keys(keys)) if (target[component][key] === void 0) missing.push(`${component}.${key}`);
+	}
+	return missing;
+}
 //#endregion
-export { extractKeys, flatten, unflatten };
+export { extractKeys, findMissingKeys, flatten, unflatten };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rimelight/i18n",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "private": false,
   "description": "Rimelight Entertainment's Internationalization Package",
   "homepage": "https://rimelight.com/docs",
@@ -24,13 +24,13 @@
       "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs"
     },
-    "./integration": {
-      "types": "./dist/integration.d.mts",
-      "import": "./dist/integration.mjs"
+    "./plugin": {
+      "types": "./dist/plugin.d.mts",
+      "import": "./dist/plugin.mjs"
     },
-    "./middleware": {
-      "types": "./dist/middleware.d.mts",
-      "import": "./dist/middleware.mjs"
+    "./hono": {
+      "types": "./dist/hono.d.mts",
+      "import": "./dist/hono.mjs"
     },
     "./runtime": {
       "types": "./dist/runtime.d.mts",
@@ -54,17 +54,8 @@
   },
   "devDependencies": {
     "@rimelight/config": "0.0.4",
-    "astro": "7.3.1",
     "typescript": "6.0.3"
   },
-  "peerDependencies": {
-    "astro": ">=7.0.0"
-  },
-  "peerDependenciesMeta": {
-    "astro": {
-      "optional": true
-    }
-  },
   "engines": {
     "node": ">=26.7.0"
   },

package/dist/integration.d.mts

@@ -1,11 +0,0 @@
-import { AstroIntegration } from "astro";
-//#region src/integration.d.ts
-interface RimelightI18nOptions {
-  validateExtraction?: boolean;
-  translations?: Record<string, Record<string, any>>;
-  kvBinding?: string;
-  translationLoader?: string;
-}
-declare function rimelightI18n(options?: RimelightI18nOptions): AstroIntegration[];
-//#endregion
-export { RimelightI18nOptions, rimelightI18n };

package/dist/integration.mjs

@@ -1,122 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-//#region src/integration.ts
-function rimelightI18n(options) {
-	const validateExtraction = options?.validateExtraction ?? true;
-	const translations = options?.translations;
-	const kvBinding = options?.kvBinding ?? "TRANSLATIONS_KV";
-	const translationLoader = options?.translationLoader;
-	const normalisedTranslations = {};
-	if (translations) for (const [locale, val] of Object.entries(translations)) normalisedTranslations[locale] = val;
-	const VIRTUAL_MODULE_ID = "@rimelight/i18n:runtime";
-	const RESOLVED_VIRTUAL_MODULE_ID = "\0" + VIRTUAL_MODULE_ID;
-	const runtimeSpecifier = "@rimelight/i18n/runtime";
-	const loaderImport = translationLoader ? `import translationLoader from ${JSON.stringify(translationLoader)};` : "";
-	const loaderOption = translationLoader ? ", get: translationLoader" : "";
-	return [{
-		name: "@rimelight/i18n",
-		hooks: {
-			"astro:config:setup": ({ config, addMiddleware, updateConfig, logger }) => {
-				const locales = config.i18n?.locales ?? ["en"];
-				const defaultLocale = config.i18n?.defaultLocale ?? "en";
-				const virtualModuleContent = `\
-import { initializeI18n, useFormat, useI18n, useI18nAsync, t,
-         currentLocale, getI18nInstance, getFormatterInstance, clearCache }
-  from ${JSON.stringify(runtimeSpecifier)};
-${loaderImport}
-
-initializeI18n({
-  defaultLocale: ${JSON.stringify(defaultLocale)},
-  translations: ${JSON.stringify(normalisedTranslations)}${loaderOption}
-});
-
-export { useFormat, useI18n, useI18nAsync, t, currentLocale,
-         getI18nInstance, getFormatterInstance, clearCache };
-`;
-				addMiddleware({
-					entrypoint: "@rimelight/i18n/middleware",
-					order: "pre"
-				});
-				updateConfig({ vite: {
-					ssr: { noExternal: ["@rimelight/i18n"] },
-					plugins: [{
-						name: "vite-plugin-rimelight-i18n-runtime",
-						resolveId(id) {
-							if (id === VIRTUAL_MODULE_ID) return RESOLVED_VIRTUAL_MODULE_ID;
-							return null;
-						},
-						load(id) {
-							if (id === RESOLVED_VIRTUAL_MODULE_ID) return virtualModuleContent;
-							return null;
-						}
-					}, {
-						name: "vite-plugin-rimelight-i18n-config",
-						resolveId(id) {
-							if (id === "virtual:rimelight-i18n-config") return "\0" + id;
-							return null;
-						},
-						load(id) {
-							if (id === "\0virtual:rimelight-i18n-config") return `
-                      export const locales = ${JSON.stringify(locales)};
-                      export const defaultLocale = ${JSON.stringify(defaultLocale)};
-                    `;
-							return null;
-						}
-					}]
-				} });
-				if (validateExtraction) logger.info("i18n extraction validation active");
-			},
-			"astro:config:done": ({ injectTypes }) => {
-				injectTypes({
-					filename: "rimelight-i18n.d.ts",
-					content: `\
-declare module "@rimelight/i18n:runtime" {
-  import type { Translations } from '@nanostores/i18n';
-  export type { InitializeI18nOptions } from '@rimelight/i18n/runtime';
-  export const currentLocale: import('nanostores').PreinitializedWritableAtom<string> & object;
-  export declare function initializeI18n(options: import('@rimelight/i18n/runtime').InitializeI18nOptions): void;
-  export declare function useFormat(): import('@nanostores/i18n').Formatter;
-  export type ComponentMessages = Record<string, string>;
-  export declare function useI18n(componentName: string): ComponentMessages;
-  export declare function useI18n<Body extends Translations>(componentName: string, baseTranslations: Body): ComponentMessages & Body;
-  export declare function useI18nAsync(componentName: string): Promise<Record<string, string>>;
-  export declare function useI18nAsync<Body extends Translations>(componentName: string, baseTranslations: Body): Promise<Record<string, string> & Body>;
-  export declare function t(key: string, params?: Record<string, any>): string;
-  export declare function t(astro: { currentLocale?: string | undefined; params?: Record<string, any> } | undefined | null, key: string, params?: Record<string, any>): string;
-  export declare function getLocale(): string;
-  export declare function getI18nInstance(): ReturnType<typeof import('@nanostores/i18n').createI18n>;
-  export declare function getFormatterInstance(): ReturnType<typeof import('@nanostores/i18n').formatter>;
-  export declare function clearCache(locale?: string): void;
-}
-`
-				});
-			},
-			"astro:build:done": async ({ logger }) => {
-				if (translations) {
-					const seedData = { keys: [] };
-					for (const [locale, localeData] of Object.entries(translations)) for (const [component, componentData] of Object.entries(localeData)) seedData.keys.push({
-						key: `locale:${locale}:${component}`,
-						value: JSON.stringify(componentData)
-					});
-					const outDir = process.env.WRANGLER_OUT_DIR ?? "dist";
-					const seedFile = path.join(outDir, "_translations-seed.json");
-					fs.mkdirSync(path.dirname(seedFile), { recursive: true });
-					fs.writeFileSync(seedFile, JSON.stringify(seedData, null, 2));
-					logger.info(`translations seed file written to ${seedFile}`);
-					if (process.env.WRANGLER_SEED_KV === "true" || process.env.CI === "true") try {
-						const { execSync } = await import("node:child_process");
-						execSync(`npx wrangler kv:bulk put --binding "${kvBinding}" "${seedFile}"`, {
-							stdio: "pipe",
-							timeout: 3e4
-						});
-						logger.info(`KV "${kvBinding}" seeded with translations`);
-					} catch {
-						logger.warn(`could not seed KV automatically — run "npx wrangler kv:bulk put --binding "${kvBinding}" "${seedFile}"" to seed translations into KV`);
-					}
-				} else logger.info("i18n build complete (no translations to seed)");
-			}
-		}
-	}];
-}
-//#endregion
-export { rimelightI18n };

package/dist/middleware.d.mts

@@ -1,7 +0,0 @@
-//#region src/middleware/routing.d.ts
-declare const i18n: (context: any, next: any) => Promise<any>;
-//#endregion
-//#region src/middleware.d.ts
-declare const onRequest: (_context: unknown, next: () => Promise<Response>) => Promise<Response>;
-//#endregion
-export { i18n, onRequest };

package/dist/middleware.mjs

@@ -1,56 +0,0 @@
-import { setKVBinding } from "./index.mjs";
-import { currentLocale } from "./runtime.mjs";
-import { env } from "cloudflare:workers";
-import { defaultLocale, locales } from "virtual:rimelight-i18n-config";
-//#region src/middleware/routing.ts
-const SUPPORTED_LOCALES = new Set(locales);
-const DEFAULT_LOCALE = defaultLocale;
-function getPreferredLocale(acceptLanguage) {
-	if (!acceptLanguage) return DEFAULT_LOCALE;
-	const parsed = acceptLanguage.split(",").map((lang) => {
-		const parts = lang.split(";");
-		const code = (parts[0] ?? "").trim().toLowerCase();
-		const base = code.split("-")[0] ?? "";
-		let q = 1;
-		const qualityPart = parts[1];
-		if (qualityPart) {
-			const qMatch = qualityPart.match(/q=([0-9.]+)/);
-			if (qMatch) q = parseFloat(qMatch[1] ?? "1");
-		}
-		return {
-			code,
-			base,
-			q
-		};
-	}).toSorted((a, b) => b.q - a.q);
-	for (const item of parsed) {
-		if (SUPPORTED_LOCALES.has(item.code)) return item.code;
-		const base = item.base;
-		if (SUPPORTED_LOCALES.has(base)) return base;
-	}
-	return DEFAULT_LOCALE;
-}
-const i18n = async (context, next) => {
-	const url = new URL(context.request.url);
-	const pathname = url.pathname;
-	const paramLocale = context.params?.locale;
-	const firstSegment = pathname.split("/").find(Boolean);
-	const activeLocale = (paramLocale && SUPPORTED_LOCALES.has(paramLocale) ? paramLocale : null) || (firstSegment && SUPPORTED_LOCALES.has(firstSegment) ? firstSegment : null) || context.currentLocale || DEFAULT_LOCALE;
-	currentLocale.set(activeLocale);
-	if (context.request.method !== "GET" && context.request.method !== "HEAD") return next();
-	if (pathname.startsWith("/api") || pathname.startsWith("/_") || pathname.includes(".")) return next();
-	if (firstSegment && SUPPORTED_LOCALES.has(firstSegment)) return next();
-	const locale = getPreferredLocale(context.request.headers.get("accept-language"));
-	currentLocale.set(locale);
-	const targetPath = `/${locale}${pathname}${url.search}`;
-	return context.redirect(targetPath, 302);
-};
-//#endregion
-//#region src/middleware.ts
-const onRequest = async (_context, next) => {
-	const kv = Reflect.get(env, "TRANSLATIONS_KV");
-	if (kv) setKVBinding(kv);
-	return next();
-};
-//#endregion
-export { i18n, onRequest };