@ubean/i18n 0.2.2 → 0.3.0

package/dist/index.js

@@ -1,447 +1,4 @@
-//#region src/index.ts
-const I18N_STATE_KEY = "__ubean_i18n_state__";
-function getI18nState() {
-	const g = globalThis;
-	if (!g[I18N_STATE_KEY]) g[I18N_STATE_KEY] = {
-		registeredLocales: /* @__PURE__ */ new Map(),
-		messageCache: /* @__PURE__ */ new Map(),
-		currentLocale: "en",
-		fallbackLocale: "en",
-		localeListeners: /* @__PURE__ */ new Set(),
-		missingKeyHandlers: /* @__PURE__ */ new Set(),
-		missingKeyWarned: /* @__PURE__ */ new Set(),
-		i18nConfig: {
-			defaultLocale: "en",
-			strategy: "prefix_except_default",
-			locales: []
-		}
-	};
-	return g[I18N_STATE_KEY];
-}
-function notifyLocaleChange(locale) {
-	for (const fn of getI18nState().localeListeners) fn(locale);
-}
-function addLocaleListener(callback) {
-	getI18nState().localeListeners.add(callback);
-	return () => getI18nState().localeListeners.delete(callback);
-}
-function addMissingKeyHandler(handler) {
-	getI18nState().missingKeyHandlers.add(handler);
-	return () => getI18nState().missingKeyHandlers.delete(handler);
-}
-function notifyMissingKey(locale, key) {
-	const state = getI18nState();
-	const cacheKey = `${locale}:${key}`;
-	if (!state.missingKeyWarned.has(cacheKey)) {
-		state.missingKeyWarned.add(cacheKey);
-		for (const fn of state.missingKeyHandlers) fn(locale, key);
-		if (typeof process !== "undefined" && process.env && process.env.NODE_ENV === "development") console.warn(`[i18n] Missing key "${key}" for locale "${locale}"`);
-	}
-}
-function invalidateCache(locale) {
-	getI18nState().messageCache.delete(locale);
-}
-function deepMerge(target, source) {
-	const result = { ...target };
-	for (const key of Object.keys(source)) {
-		const sourceVal = source[key];
-		const targetVal = result[key];
-		if (sourceVal && typeof sourceVal === "object" && !Array.isArray(sourceVal) && targetVal && typeof targetVal === "object" && !Array.isArray(targetVal)) result[key] = deepMerge(targetVal, sourceVal);
-		else result[key] = sourceVal;
-	}
-	return result;
-}
-function flattenMessages(messages, prefix = "") {
-	const result = {};
-	for (const [key, value] of Object.entries(messages)) {
-		const fullKey = prefix ? `${prefix}.${key}` : key;
-		if (typeof value === "string") result[fullKey] = value;
-		else if (value && typeof value === "object") Object.assign(result, flattenMessages(value, fullKey));
-	}
-	return result;
-}
-function getFlatMessages(locale) {
-	const state = getI18nState();
-	const cached = state.messageCache.get(locale);
-	if (cached) return cached;
-	const localeData = state.registeredLocales.get(locale);
-	if (!localeData) return {};
-	const flat = flattenMessages(localeData.messages);
-	state.messageCache.set(locale, flat);
-	return flat;
-}
-function getPluralCategory(count, locale) {
-	try {
-		return new Intl.PluralRules(locale).select(count);
-	} catch {
-		return count === 0 ? "zero" : count === 1 ? "one" : "other";
-	}
-}
-function selectPlural(template, count, locale) {
-	const parts = template.split("|").map((p) => p.trim());
-	if (parts.length === 1) return template;
-	for (const part of parts) {
-		const eqMatch = part.match(/^=(\d+)\s*/);
-		if (eqMatch) {
-			if (parseInt(eqMatch[1], 10) === count) return part.replace(/^=\d+\s*/, "");
-		}
-	}
-	const explicitCategories = [];
-	const plainParts = [];
-	for (const part of parts) {
-		if (/^=\d+\s*/.test(part)) continue;
-		const catMatch = part.match(/^(\w+):\s*/);
-		if (catMatch) explicitCategories.push({
-			cat: catMatch[1],
-			text: part.replace(/^\w+:\s*/, "")
-		});
-		else plainParts.push(part);
-	}
-	for (const { cat, text } of explicitCategories) {
-		if (cat === "zero" && count === 0) return text;
-		if (cat === "one" && count === 1) return text;
-		if (cat === getPluralCategory(count, locale)) return text;
-	}
-	if (plainParts.length === 2) return count === 1 ? plainParts[0] : plainParts[1];
-	if (plainParts.length >= 3) {
-		if (count === 0) return plainParts[0];
-		if (count === 1) return plainParts[1];
-		return plainParts[plainParts.length - 1];
-	}
-	if (plainParts.length === 1) return plainParts[0];
-	const category = getPluralCategory(count, locale);
-	const categoryIndex = [
-		"zero",
-		"one",
-		"two",
-		"few",
-		"many",
-		"other"
-	].indexOf(category);
-	if (categoryIndex >= 0 && categoryIndex < parts.length) return parts[categoryIndex];
-	return parts[parts.length - 1];
-}
-function resolveLinkedMessages(template, flat, visited = /* @__PURE__ */ new Set()) {
-	return template.replace(/@(?::([\w.]+)|{([\w.]+)})/g, (_match, colonKey, braceKey) => {
-		const key = colonKey || braceKey;
-		if (!key || visited.has(key)) return _match;
-		visited.add(key);
-		const linked = flat[key];
-		if (linked === void 0) return _match;
-		const resolved = resolveLinkedMessages(linked, flat, visited);
-		visited.delete(key);
-		return resolved;
-	});
-}
-function interpolate(template, params, locale, flat) {
-	let result = template;
-	if (flat) result = resolveLinkedMessages(result, flat);
-	if (params && typeof params.count === "number") result = selectPlural(result, params.count, locale || "en");
-	if (params) result = result.replace(/\{(\w+)\}/g, (_, key) => {
-		const val = params[key];
-		return val !== void 0 ? String(val) : `{${key}}`;
-	});
-	return result;
-}
-function getMessage(locale, key, params) {
-	const flat = getFlatMessages(locale);
-	const msg = flat[key];
-	if (msg === void 0) return void 0;
-	return interpolate(msg, params, locale, flat);
-}
-function defineLocale(definition) {
-	const state = getI18nState();
-	const locale = {
-		code: definition.code,
-		messages: definition.messages,
-		name: definition.name,
-		dir: definition.dir || "ltr",
-		isDefault: definition.isDefault
-	};
-	state.registeredLocales.set(definition.code, locale);
-	invalidateCache(definition.code);
-	if (definition.isDefault || state.registeredLocales.size === 1) {
-		state.fallbackLocale = definition.code;
-		if (!state.currentLocale || state.currentLocale === "en") state.currentLocale = definition.code;
-	}
-	return definition;
-}
-function setI18nConfig(config) {
-	const state = getI18nState();
-	state.i18nConfig = {
-		...state.i18nConfig,
-		...config
-	};
-	if (config.defaultLocale) state.fallbackLocale = config.defaultLocale;
-}
-function getI18nConfig() {
-	const state = getI18nState();
-	return {
-		...state.i18nConfig,
-		locales: Array.from(state.registeredLocales.keys())
-	};
-}
-function getDefaultLocale() {
-	const state = getI18nState();
-	for (const [code, loc] of state.registeredLocales) if (loc.isDefault) return code;
-	return state.i18nConfig.defaultLocale;
-}
-function localizePath(path, locale) {
-	const state = getI18nState();
-	const targetLocale = locale || state.currentLocale;
-	const defaultLocale = getDefaultLocale();
-	const strategy = state.i18nConfig.strategy;
-	const cleanPath = path.replace(/^\/+/, "/").replace(/\/+$/, "") || "/";
-	if (strategy === "no_prefix") return cleanPath;
-	const pathParts = cleanPath.split("/").filter(Boolean);
-	const firstSegment = pathParts[0] || "";
-	const isLocalePrefix = state.registeredLocales.has(firstSegment);
-	let pathWithoutPrefix = cleanPath;
-	if (isLocalePrefix) {
-		const rest = pathParts.slice(1).join("/");
-		pathWithoutPrefix = rest ? `/${rest}` : "/";
-	}
-	if ((strategy === "prefix_except_default" || strategy === "prefix_and_default") && targetLocale === defaultLocale) return pathWithoutPrefix;
-	return `/${targetLocale}${pathWithoutPrefix === "/" ? "" : pathWithoutPrefix}`;
-}
-function switchLocalePath(newLocale, currentPath) {
-	const _global = globalThis;
-	return localizePath(currentPath || (typeof _global.window !== "undefined" ? _global.window.location.pathname : "/"), newLocale);
-}
-function extractLocaleFromPath(path) {
-	const state = getI18nState();
-	const pathParts = path.split("/").filter(Boolean);
-	const firstSegment = pathParts[0] || "";
-	if (state.registeredLocales.has(firstSegment)) {
-		const rest = pathParts.slice(1).join("/");
-		return {
-			locale: firstSegment,
-			pathWithoutLocale: rest ? `/${rest}` : "/"
-		};
-	}
-	return {
-		locale: null,
-		pathWithoutLocale: path
-	};
-}
-function useI18n() {
-	return {
-		get locale() {
-			return getI18nState().currentLocale;
-		},
-		get fallbackLocale() {
-			return getI18nState().fallbackLocale;
-		},
-		get availableLocales() {
-			return Array.from(getI18nState().registeredLocales.keys());
-		},
-		t(key, params) {
-			const state = getI18nState();
-			let message = getMessage(state.currentLocale, key, params);
-			if (message === void 0 && state.currentLocale !== state.fallbackLocale) message = getMessage(state.fallbackLocale, key, params);
-			if (message === void 0) {
-				notifyMissingKey(state.currentLocale, key);
-				return key;
-			}
-			return message;
-		},
-		d(value, style = "short", options) {
-			try {
-				const date = value instanceof Date ? value : new Date(value);
-				if (isNaN(date.getTime())) throw new Error("Invalid date");
-				return new Intl.DateTimeFormat(getI18nState().currentLocale, {
-					dateStyle: style,
-					...options
-				}).format(date);
-			} catch {
-				const date = value instanceof Date ? value : new Date(value);
-				if (isNaN(date.getTime())) return String(value);
-				return date.toISOString().split("T")[0];
-			}
-		},
-		n(value, style = "decimal", options) {
-			try {
-				return new Intl.NumberFormat(getI18nState().currentLocale, {
-					style,
-					...options
-				}).format(value);
-			} catch {
-				return String(value);
-			}
-		},
-		c(value, currency, options) {
-			try {
-				return new Intl.NumberFormat(getI18nState().currentLocale, {
-					style: "currency",
-					currency,
-					...options
-				}).format(value);
-			} catch {
-				return `${currency} ${value}`;
-			}
-		},
-		relativeTime(value, unit, options) {
-			try {
-				return new Intl.RelativeTimeFormat(getI18nState().currentLocale, options).format(value, unit);
-			} catch {
-				return `${value >= 0 ? "in " : ""}${Math.abs(value)} ${unit}${value === 1 ? "" : "s"}${value < 0 ? " ago" : ""}`;
-			}
-		},
-		list(items, style = "conjunction", options) {
-			try {
-				return new Intl.ListFormat(getI18nState().currentLocale, {
-					type: style,
-					...options
-				}).format(items);
-			} catch {
-				return items.join(", ");
-			}
-		},
-		setLocale(locale) {
-			const state = getI18nState();
-			if (state.registeredLocales.has(locale) && locale !== state.currentLocale) {
-				state.currentLocale = locale;
-				notifyLocaleChange(locale);
-			}
-		},
-		getLocale() {
-			return getI18nState().currentLocale;
-		},
-		addLocale(code, messages, options) {
-			const state = getI18nState();
-			const existing = state.registeredLocales.get(code);
-			if (existing) {
-				existing.messages = deepMerge(existing.messages, messages);
-				if (options?.name) existing.name = options.name;
-				if (options?.dir) existing.dir = options.dir;
-			} else state.registeredLocales.set(code, {
-				code,
-				messages,
-				name: options?.name,
-				dir: options?.dir || "ltr"
-			});
-			invalidateCache(code);
-			state.missingKeyWarned = /* @__PURE__ */ new Set();
-		},
-		mergeLocale(code, messages) {
-			const state = getI18nState();
-			const existing = state.registeredLocales.get(code);
-			if (existing) existing.messages = deepMerge(existing.messages, messages);
-			else state.registeredLocales.set(code, {
-				code,
-				messages,
-				dir: "ltr"
-			});
-			invalidateCache(code);
-			state.missingKeyWarned = /* @__PURE__ */ new Set();
-		},
-		detectLocale(acceptLanguage) {
-			const state = getI18nState();
-			if (!acceptLanguage) return state.fallbackLocale;
-			const requested = acceptLanguage.split(",").map((lang) => {
-				const [code, q = "q=1.0"] = lang.trim().split(";");
-				const quality = parseFloat(q.replace("q=", "")) || 0;
-				return {
-					code: code.trim().toLowerCase(),
-					quality
-				};
-			}).sort((a, b) => b.quality - a.quality);
-			for (const { code } of requested) for (const registered of state.registeredLocales.keys()) if (code === registered.toLowerCase() || code.startsWith(`${registered.toLowerCase()}-`)) return registered;
-			return state.fallbackLocale;
-		},
-		onLocaleChange: addLocaleListener,
-		onMissingKey: addMissingKeyHandler,
-		getLocaleDir(locale) {
-			const state = getI18nState();
-			const code = locale || state.currentLocale;
-			return state.registeredLocales.get(code)?.dir || "ltr";
-		},
-		getLocaleName(locale) {
-			const state = getI18nState();
-			const code = locale || state.currentLocale;
-			return state.registeredLocales.get(code)?.name;
-		}
-	};
-}
-function t(key, params) {
-	return useI18n().t(key, params);
-}
-function setLocale(locale) {
-	useI18n().setLocale(locale);
-}
-function getLocale() {
-	return useI18n().getLocale();
-}
-function getRegisteredLocales() {
-	return Array.from(getI18nState().registeredLocales.keys());
-}
-/**
-* Returns metadata for all registered locales (without messages).
-* Used by SSR to serialize the full locale list so the client can
-* register all available locales during hydration — preventing
-* `availableLocales` hydration mismatches.
-*/
-function getRegisteredLocalesMeta() {
-	const state = getI18nState();
-	return Array.from(state.registeredLocales.values()).map((loc) => ({
-		code: loc.code,
-		name: loc.name,
-		dir: loc.dir,
-		isDefault: loc.isDefault
-	}));
-}
-function getLocaleMessages(locale) {
-	const state = getI18nState();
-	const code = locale || state.currentLocale;
-	return state.registeredLocales.get(code)?.messages;
-}
-function clearLocales() {
-	const state = getI18nState();
-	state.registeredLocales.clear();
-	state.localeListeners.clear();
-	state.missingKeyHandlers.clear();
-	state.messageCache.clear();
-	state.missingKeyWarned = /* @__PURE__ */ new Set();
-	state.currentLocale = "en";
-	state.fallbackLocale = "en";
-}
-function onLocaleChange(callback) {
-	return useI18n().onLocaleChange(callback);
-}
-function getLocaleDir(locale) {
-	return useI18n().getLocaleDir(locale);
-}
-function getLocaleName(locale) {
-	return useI18n().getLocaleName(locale);
-}
-function detectLocale(acceptLanguage) {
-	return useI18n().detectLocale(acceptLanguage);
-}
-function addLocale(code, messages, options) {
-	useI18n().addLocale(code, messages, options);
-}
-function mergeLocale(code, messages) {
-	useI18n().mergeLocale(code, messages);
-}
-function detectBrowserLocale() {
-	const i18n = useI18n();
-	if (typeof navigator !== "undefined" && navigator.language) return i18n.detectLocale(navigator.language);
-	return getI18nState().fallbackLocale;
-}
-function formatDate(value, style, options) {
-	return useI18n().d(value, style, options);
-}
-function formatNumber(value, style, options) {
-	return useI18n().n(value, style, options);
-}
-function formatCurrency(value, currency, options) {
-	return useI18n().c(value, currency, options);
-}
-function formatRelativeTime(value, unit, options) {
-	return useI18n().relativeTime(value, unit, options);
-}
-function formatList(items, style, options) {
-	return useI18n().list(items, style, options);
-}
-//#endregion
-export { addLocale, clearLocales, defineLocale, detectBrowserLocale, detectLocale, extractLocaleFromPath, formatCurrency, formatDate, formatList, formatNumber, formatRelativeTime, getDefaultLocale, getI18nConfig, getLocale, getLocaleDir, getLocaleMessages, getLocaleName, getRegisteredLocales, getRegisteredLocalesMeta, localizePath, mergeLocale, onLocaleChange, setI18nConfig, setLocale, switchLocalePath, t, useI18n };
+import { a as extractLocaleFromPath, c as switchLocalePath, i as compileLocalePaths, l as toVueRouterLocalePath, n as parseLocaleCookie, o as getVueLocaleParam, r as serializeLocaleCookie, s as localizePath, t as detectLocaleFromAcceptLanguage } from "./detect-BIURd4aL.js";
+import { C as t, S as setLocaleMeta, _ as n, a as d, b as setFallbackLocale, c as getI18nScope, d as getLocaleMeta, f as getLocaleName, g as mergeLocaleMessages, h as listLocaleCodes, i as createRequestContext, l as getLocaleDir, m as getRequestLocale, n as getPathWithoutLocale, o as ensureLocaleMessages, p as getRegisteredLocalesMeta, r as getRequestLocale$1, s as getFallbackLocale, t as createI18nMiddleware, u as getLocaleMessages, v as registerLocaleLoader, x as setLocaleMessages, y as runWithI18n } from "./routing-D4Y0l8jV.js";
+import { t as buildLocaleHead } from "./head-BzEFwnlD.js";
+export { buildLocaleHead, compileLocalePaths, createI18nMiddleware, createRequestContext, d, detectLocaleFromAcceptLanguage, ensureLocaleMessages, extractLocaleFromPath, getRequestLocale as getAlsLocale, getFallbackLocale, getI18nScope, getLocaleDir, getLocaleMessages, getLocaleMeta, getLocaleName, getPathWithoutLocale, getRegisteredLocalesMeta, getRequestLocale$1 as getRequestLocale, getVueLocaleParam, listLocaleCodes, localizePath, mergeLocaleMessages, n, parseLocaleCookie, registerLocaleLoader, runWithI18n, serializeLocaleCookie, setFallbackLocale, setLocaleMessages, setLocaleMeta, switchLocalePath, t, toVueRouterLocalePath };

package/dist/paths-CJVBLGJS.d.ts

@@ -0,0 +1,59 @@
+//#region src/types.d.ts
+type I18nRoutingStrategy = 'prefix' | 'prefix_except_default' | 'prefix_and_default' | 'no_prefix';
+interface LocaleRoutingConfig {
+  defaultLocale: string;
+  locales: string[];
+  strategy: I18nRoutingStrategy;
+}
+interface HonoLocalePath {
+  path: string;
+  locale: string;
+  isDefault: boolean;
+}
+interface CompiledLocalePath {
+  /** vue-router path, may contain `:locale(zh)?` */
+  vuePath: string;
+  /** Concrete Hono mount paths */
+  hono: HonoLocalePath[];
+}
+interface I18nDetectOptions {
+  cookieName: string;
+  redirectOn: 'root' | 'all';
+  alwaysRedirect: boolean;
+}
+interface I18nMiddlewareOptions {
+  defaultLocale: string;
+  locales: string[];
+  strategy: I18nRoutingStrategy;
+  detectBrowserLanguage?: false | Partial<I18nDetectOptions>;
+  loadMessages?: (locale: string, fallback: string) => Promise<void>;
+}
+interface I18nLocaleMeta {
+  code: string;
+  language?: string;
+  name?: string;
+  dir?: 'ltr' | 'rtl';
+  isDefault?: boolean;
+}
+//#endregion
+//#region src/paths.d.ts
+/**
+ * vue-router locale param segment for the given strategy.
+ *
+ * - `prefix_except_default`: `:locale(zh)?` (default unprefixed; `/en/about` 不匹配)
+ * - `prefix`: `:locale(en|zh)` (required)
+ * - `prefix_and_default`: `:locale(en|zh)?` (`/about` 与 `/en/about` 都匹配)
+ * - `no_prefix`: empty
+ */
+declare function getVueLocaleParam(cfg: LocaleRoutingConfig): string;
+/** Apply a vue-router locale param to a page path (`/` / `/about` / catch-all). */
+declare function toVueRouterLocalePath(pagePath: string, localeParam: string): string;
+declare function extractLocaleFromPath(path: string, localeCodes: string[]): {
+  locale: string | null;
+  pathWithoutLocale: string;
+};
+declare function localizePath(path: string, locale: string, cfg: LocaleRoutingConfig): string;
+declare function switchLocalePath(locale: string, currentPath: string, cfg: LocaleRoutingConfig): string;
+declare function compileLocalePaths(pagePath: string, cfg: LocaleRoutingConfig): CompiledLocalePath;
+//#endregion
+export { switchLocalePath as a, HonoLocalePath as c, I18nRoutingStrategy as d, LocaleRoutingConfig as f, localizePath as i, I18nLocaleMeta as l, extractLocaleFromPath as n, toVueRouterLocalePath as o, getVueLocaleParam as r, CompiledLocalePath as s, compileLocalePaths as t, I18nMiddlewareOptions as u };