@rimelight/i18n 0.0.7 → 0.0.8

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 { currentLocale } from "./runtime.mjs";
+import { setKVBinding } from "./index.mjs";
+import { defaultLocale, locales, prefixDefaultLocale } from "virtual:rimelight-i18n-config";
+import { env } from "cloudflare:workers";
+//#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,37 @@
-import { ComponentsJSON, KVNamespaceBinding } from "./types.mjs";
-import { clearCache, currentLocale, getFormatterInstance, getI18nInstance, t, useFormat } from "@rimelight/i18n:runtime";
-import { TranslationLoader, Translations } from "@nanostores/i18n";
+import { ComponentsJSON, CustomTranslations, KVNamespaceBinding, NestedTranslationKeys, TranslationKey } from "./types.mjs";
+import { clearCache, currentLocale, getFormatterInstance, getI18nInstance, getPluralCategory, initializeI18n, useFormat, useI18n, useI18nAsync } from "./runtime.mjs";
+import { RimelightI18nOptions, RimelightI18nPlugins, i18n } from "./plugin.mjs";
+import { TranslationLoader } from "@nanostores/i18n";
+import { defaultLocale, locales, prefixDefaultLocale } from "virtual:rimelight-i18n-config";
 //#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>;
+/**
+ * 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,31 +1,85 @@
-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";
+import { clearCache, currentLocale, getFormatterInstance, getI18nInstance, getPluralCategory, initializeI18n, t as t$1, useFormat, useI18n, useI18nAsync } from "./runtime.mjs";
+import { i18n } from "./plugin.mjs";
+import { defaultLocale, locales, prefixDefaultLocale, translations } from "virtual:rimelight-i18n-config";
 //#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);
-	}
+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() || "en";
+	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) {
-	if (arg2 !== void 0) return getRelativeLocaleUrl$1(arg1, arg2);
-	else {
-		const locale = getLocale();
-		return getRelativeLocaleUrl$1(locale, arg1);
+	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) {
@@ -52,12 +106,5 @@ function createTranslationLoader(translations) {
 		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 };
+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.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 { RimelightI18nOptions, RimelightI18nPlugins, RimelightI18nVitePlugin, i18n, i18n as rimelightI18n };

package/dist/plugin.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, i18n as rimelightI18n };

package/dist/runtime.d.mts

@@ -57,10 +57,11 @@ declare function useI18nAsync<Body extends Translations>(componentName: string,
  * 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;
+/**
+ * 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.
  *
@@ -68,4 +69,4 @@ declare function t(astro: {
  */
 declare function clearCache(locale?: string): void;
 //#endregion
-export { ComponentMessages, InitializeI18nOptions, clearCache, currentLocale, getFormatterInstance, getI18nInstance, initializeI18n, t, useFormat, useI18n, useI18nAsync };
+export { ComponentMessages, InitializeI18nOptions, clearCache, currentLocale, getFormatterInstance, getI18nInstance, getPluralCategory, initializeI18n, t, useFormat, useI18n, useI18nAsync };

package/dist/runtime.mjs

@@ -143,26 +143,30 @@ async function useI18nAsync(componentName, baseTranslations) {
 	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;
-	}
+/**
+* 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 value = (getCachedComponent(currentLocale.get() || baseLocaleDefault, componentName) ?? getCachedComponent(baseLocaleDefault, componentName) ?? {})[keyName] ?? key;
+	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 value;
+	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.
@@ -176,4 +180,4 @@ function clearCache(locale) {
 	else for (const key in cache) cache[key] = {};
 }
 //#endregion
-export { clearCache, currentLocale, getFormatterInstance, getI18nInstance, initializeI18n, t, useFormat, useI18n, useI18nAsync };
+export { clearCache, currentLocale, getFormatterInstance, getI18nInstance, getPluralCategory, initializeI18n, t, useFormat, useI18n, useI18nAsync };

package/dist/types.d.mts

@@ -12,5 +12,21 @@ 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 { type ComponentsJSON, FlattenedTranslations, KVNamespaceBinding, LocaleFile };
+export { type ComponentsJSON, CustomTranslations, FlattenedTranslations, KVNamespaceBinding, LocaleFile, NestedTranslationKeys, TranslationKey };

package/dist/utils.d.mts

@@ -3,5 +3,10 @@ import { ComponentsJSON, FlattenedTranslations } from "./types.mjs";
 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.8",
   "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 };