@echojs-ecosystem/i18n 0.1.0

package/README.md

@@ -0,0 +1,69 @@
+<div align="center">
+
+# @echojs-ecosystem/i18n
+
+**Signal-native internationalization with typed message keys and Intl helpers.**
+
+[![npm](https://img.shields.io/npm/v/@echojs-ecosystem/i18n)](https://www.npmjs.com/package/@echojs-ecosystem/i18n)
+[![docs](https://img.shields.io/badge/docs-echojs.dev-blue)](https://echojs.dev/docs/packages/i18n)
+
+</div>
+
+---
+
+Lightweight i18n for EchoJS. **Locale is a signal** — `t()` inside `computed` / `effect` re-runs when the locale changes. Works in browser, SSR, and Node.js.
+
+## Features
+
+- **Typed keys** — `TranslationKey` inferred from your JSON locale files
+- **Eager + lazy locales** — inline object or dynamic `import()`
+- **Interpolation & plural** — `{name}`, `{count}` in messages
+- **Intl helpers** — `number`, `currency`, `date`, `relativeTime`
+- **Framework-agnostic** — no hooks, no VDOM
+
+## Install
+
+```bash
+npm install @echojs-ecosystem/i18n @echojs-ecosystem/reactivity
+```
+
+## Quick start
+
+```ts
+import { createI18n } from "@echojs-ecosystem/i18n";
+import ru from "./locales/ru.json";
+
+const i18n = createI18n({
+  defaultLocale: "ru",
+  fallbackLocale: "en",
+  locales: {
+    ru,
+    en: () => import("./locales/en.json"),
+  },
+});
+
+i18n.t("common.save"); // typed key
+i18n.t("greeting", { name: "Vova" });
+i18n.t("items", { count: 5 }); // plural
+
+await i18n.setLocale("en");
+i18n.$locale.value(); // reactive
+```
+
+## API
+
+| Export | Description |
+|--------|-------------|
+| `createI18n` | Factory |
+| `i18n.t(key, params?)` | Translate |
+| `i18n.setLocale` / `i18n.loadLocale` | Switch & lazy-load |
+| `i18n.number` / `currency` / `date` / `relativeTime` | Intl formatting |
+| `TranslationKey` | Type helper for nested keys |
+
+## Provider (apps)
+
+Use `createI18nProvider` with [`@echojs-ecosystem/framework`](https://www.npmjs.com/package/@echojs-ecosystem/framework) to inject `i18n` into views.
+
+## Documentation
+
+[echojs.dev/docs/packages/i18n](https://echojs.dev/docs/packages/i18n)

package/dist/index.d.ts

@@ -0,0 +1,127 @@
+import { Signal } from '@echojs-ecosystem/reactivity';
+
+type PluralShape = Partial<Record<"one" | "few" | "many" | "other", string>>;
+type IsPluralLeaf<T> = T extends PluralShape ? keyof T extends keyof PluralMessages | undefined ? true : false : false;
+/** Leaf values addressable by `t("a.b.c")`. */
+type IsMessageLeaf<T> = T extends string ? true : IsPluralLeaf<T>;
+/**
+ * Dot-separated paths to translatable leaves in a nested message tree.
+ *
+ * @example
+ * type Keys = TranslationKey<{ common: { save: string } }>; // "common.save"
+ */
+type TranslationKey<T, Prefix extends string = ""> = IsMessageLeaf<T> extends true ? Prefix extends "" ? never : Prefix : T extends Record<string, unknown> ? {
+    [K in keyof T & string]: TranslationKey<T[K], Prefix extends "" ? K : `${Prefix}.${K}`>;
+}[keyof T & string] : never;
+
+/** Nested message tree (string leaves and optional plural buckets). */
+type MessageSchema = Record<string, unknown>;
+type Messages = MessageSchema;
+type LocaleMessages = Record<string, Messages>;
+type MissingKeyStrategy = "key" | "empty";
+type LocaleModuleResult<T extends MessageSchema = MessageSchema> = T | {
+    default: T;
+};
+/** Dynamic import of a locale module (e.g. `() => import("./en.json")`). */
+type LocaleImporter<T extends MessageSchema = MessageSchema> = () => Promise<LocaleModuleResult<T>>;
+/** Eager messages object or lazy module import. */
+type LocaleSource<T extends MessageSchema = MessageSchema> = T | LocaleImporter<T>;
+type LocalesMap<TLocale extends string, TMessages extends MessageSchema> = Record<TLocale, LocaleSource<TMessages>>;
+/** Any `locales` map accepted by `createI18n` (used for inference). */
+type AnyLocalesMap = Record<string, LocaleSource<MessageSchema>>;
+/** Message schema from eager entries in `locales` (e.g. `typeof ru`). */
+type InferMessagesFromLocalesMap<TLocales extends AnyLocalesMap> = Extract<TLocales[keyof TLocales], MessageSchema> extends infer E ? E extends MessageSchema ? E : MessageSchema : MessageSchema;
+type InferLocaleFromLocalesMap<TLocales extends AnyLocalesMap> = keyof TLocales & string;
+type CreateI18nOptions<TLocales extends AnyLocalesMap> = {
+    /**
+     * Required unless browser options are set (`storageKey`, `navigatorRules`, or `documentTitleKey`).
+     * Then the initial locale is detected automatically.
+     */
+    defaultLocale?: InferLocaleFromLocalesMap<TLocales>;
+    fallbackLocale: InferLocaleFromLocalesMap<TLocales>;
+    locales: TLocales;
+    missingKeyStrategy?: MissingKeyStrategy;
+    /** Persist / restore locale in `localStorage`. Enables auto-detect when set. */
+    storageKey?: string;
+    navigatorRules?: ReadonlyArray<{
+        prefix: string;
+        locale: InferLocaleFromLocalesMap<TLocales>;
+    }>;
+    /** Sync `document.documentElement.lang` (default `true` when browser options are used). */
+    syncDocument?: boolean;
+    documentTitleKey?: TranslationKey<InferMessagesFromLocalesMap<TLocales>>;
+};
+/** @deprecated Prefer `CreateI18nOptions` with inferred `locales` */
+type CreateI18nOptionsLegacy<TLocale extends string, TMessages extends MessageSchema> = {
+    defaultLocale: TLocale;
+    fallbackLocale: TLocale;
+    locales: LocalesMap<TLocale, TMessages>;
+    missingKeyStrategy?: MissingKeyStrategy;
+};
+type I18n<TLocale extends string = string, TMessages extends MessageSchema = MessageSchema> = {
+    /** Locale ids declared in `createI18n({ locales })`. */
+    readonly supportedLocales: readonly TLocale[];
+    locale(): TLocale;
+    setLocale(locale: TLocale): Promise<void>;
+    fallbackLocale(): TLocale;
+    t(key: TranslationKey<TMessages>, params?: Record<string, unknown>): string;
+    exists(key: TranslationKey<TMessages>): boolean;
+    addMessages(locale: TLocale, messages: Partial<TMessages> | Messages): void;
+    removeLocale(locale: TLocale): void;
+    loadLocale(locale: TLocale): Promise<void>;
+    number(value: number, options?: Intl.NumberFormatOptions): string;
+    currency(value: number, currency: string, options?: Intl.NumberFormatOptions): string;
+    date(value: Date, options?: Intl.DateTimeFormatOptions): string;
+    relativeTime(value: number, unit: Intl.RelativeTimeFormatUnit): string;
+    readonly $locale: Signal<TLocale>;
+    readonly $pending: Signal<boolean>;
+    readonly $error: Signal<unknown | null>;
+    /**
+     * Detect locale, sync document/storage, register effects.
+     * Lazy locale chunks load in the background — does not block app mount.
+     */
+    start(): Promise<void>;
+};
+/** @deprecated Use `CreateI18nOptions` */
+type I18nOptions<TLocale extends string = string, TMessages extends MessageSchema = MessageSchema> = CreateI18nOptionsLegacy<TLocale, TMessages>;
+/** Plural message buckets keyed by Intl plural category. */
+type PluralMessages = Partial<Record<"one" | "few" | "many" | "other", string>>;
+/** @deprecated Use `LocaleImporter` */
+type LocaleLoader<T extends MessageSchema = MessageSchema> = LocaleImporter<T>;
+/** @deprecated Use `LocaleModuleResult` */
+type LocaleLoaderResult<T extends MessageSchema = MessageSchema> = LocaleModuleResult<T>;
+/** @deprecated Use `LocalesMap` */
+type LocaleLoaders<TLocale extends string = string, TMessages extends MessageSchema = MessageSchema> = LocalesMap<TLocale, TMessages>;
+
+declare function createI18n<const TLocales extends AnyLocalesMap>(options: CreateI18nOptions<TLocales>): I18n<InferLocaleFromLocalesMap<TLocales>, InferMessagesFromLocalesMap<TLocales>>;
+
+/** Echo app provider with the active {@link I18n} instance. */
+type EchoI18nProvider<TLocale extends string = string, TMessages extends Messages = Messages> = {
+    name: "i18n";
+    readonly i18n: I18n<TLocale, TMessages>;
+    setup: () => void | Promise<void>;
+};
+/**
+ * Creates i18n and an Echo app provider (`setup` runs {@link I18n.start}).
+ *
+ * ```ts
+ * export const i18nProvider = createI18nProvider({ locales: { en, ru } });
+ * app.use(i18nProvider);
+ * i18nProvider.i18n.t("key");
+ * ```
+ */
+declare function createI18nProvider<const TLocales extends AnyLocalesMap>(options: CreateI18nOptions<TLocales>): EchoI18nProvider<InferLocaleFromLocalesMap<TLocales>, InferMessagesFromLocalesMap<TLocales>>;
+
+type DetectLocaleOptions<TLocale extends string> = {
+    supported: readonly TLocale[];
+    fallback: TLocale;
+    storageKey?: string;
+    /** e.g. `{ prefix: "ru", locale: "ru" }` when `navigator.language` matches. */
+    navigatorRules?: ReadonlyArray<{
+        prefix: string;
+        locale: TLocale;
+    }>;
+};
+declare const detectLocale: <TLocale extends string>(options: DetectLocaleOptions<TLocale>) => TLocale;
+
+export { type AnyLocalesMap, type CreateI18nOptions, type CreateI18nOptionsLegacy, type EchoI18nProvider, type I18n, type I18nOptions, type InferLocaleFromLocalesMap, type InferMessagesFromLocalesMap, type LocaleImporter, type LocaleLoader, type LocaleLoaderResult, type LocaleLoaders, type LocaleMessages, type LocaleModuleResult, type LocaleSource, type LocalesMap, type MessageSchema, type Messages, type MissingKeyStrategy, type PluralMessages, type TranslationKey, createI18n, createI18nProvider, detectLocale };

package/dist/index.js

@@ -0,0 +1,363 @@
+import { effect, signal } from '@echojs-ecosystem/reactivity';
+
+// src/core/messages.ts
+var isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var deepMerge = (target, source) => {
+  const result = { ...target };
+  for (const key of Object.keys(source)) {
+    const sourceValue = source[key];
+    const targetValue = result[key];
+    if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {
+      result[key] = deepMerge(targetValue, sourceValue);
+    } else {
+      result[key] = sourceValue;
+    }
+  }
+  return result;
+};
+var cloneLocaleMessages = (messages) => {
+  const clone = {};
+  for (const locale of Object.keys(messages)) {
+    const localeMessages = messages[locale];
+    if (localeMessages !== void 0) {
+      clone[locale] = deepMerge({}, localeMessages);
+    }
+  }
+  return clone;
+};
+var ensureLocaleBucket = (store, locale) => {
+  const existing = store[locale];
+  if (existing !== void 0) {
+    return existing;
+  }
+  const bucket = {};
+  store[locale] = bucket;
+  return bucket;
+};
+
+// src/core/path.ts
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var getMessageByPath = (messages, path) => {
+  if (!messages || path.length === 0) {
+    return void 0;
+  }
+  const segments = path.split(".");
+  let current = messages;
+  for (const segment of segments) {
+    if (!isRecord(current) || !(segment in current)) {
+      return void 0;
+    }
+    current = current[segment];
+  }
+  return current;
+};
+
+// src/core/fallback.ts
+var resolveMessageValue = (store, locale, fallbackLocale, key) => {
+  const primary = getMessageByPath(store[locale], key);
+  if (primary !== void 0) {
+    return primary;
+  }
+  if (locale === fallbackLocale) {
+    return void 0;
+  }
+  return getMessageByPath(store[fallbackLocale], key);
+};
+var hasMessage = (store, locale, fallbackLocale, key) => resolveMessageValue(store, locale, fallbackLocale, key) !== void 0;
+
+// src/core/formatter.ts
+var formatNumber = (locale, value, options) => new Intl.NumberFormat(locale, options).format(value);
+var formatCurrency = (locale, value, currency, options) => new Intl.NumberFormat(locale, {
+  ...options,
+  style: "currency",
+  currency
+}).format(value);
+var formatDate = (locale, value, options) => new Intl.DateTimeFormat(locale, options).format(value);
+var formatRelativeTime = (locale, value, unit) => new Intl.RelativeTimeFormat(locale).format(value, unit);
+
+// src/core/locale-source.ts
+var isLocaleImporter = (source) => typeof source === "function";
+var hasDefaultExport = (result) => typeof result === "object" && result !== null && "default" in result && result.default !== void 0 && typeof result.default === "object" && result.default !== null && !Array.isArray(result.default);
+var resolveLocaleModule = async (source) => {
+  if (!isLocaleImporter(source)) {
+    return source;
+  }
+  const result = await source();
+  if (hasDefaultExport(result)) {
+    return result.default;
+  }
+  return result;
+};
+var resolveLocaleModuleSync = (source) => isLocaleImporter(source) ? void 0 : source;
+
+// src/plugin/detect-locale.ts
+var detectLocale = (options) => {
+  const { supported, fallback, storageKey, navigatorRules } = options;
+  const isSupported = (value) => supported.includes(value);
+  if (storageKey && typeof localStorage !== "undefined") {
+    const stored = localStorage.getItem(storageKey);
+    if (stored && isSupported(stored)) {
+      return stored;
+    }
+  }
+  if (navigatorRules?.length && typeof navigator !== "undefined") {
+    const lang = navigator.language.toLowerCase();
+    for (const rule of navigatorRules) {
+      if (lang.startsWith(rule.prefix)) {
+        return rule.locale;
+      }
+    }
+  }
+  return fallback;
+};
+var createLocaleState = (initialLocale, fallbackLocale) => ({
+  $locale: signal(initialLocale),
+  $pending: signal(false),
+  $error: signal(null),
+  fallbackLocale
+});
+
+// src/core/interpolation.ts
+var PLACEHOLDER_PATTERN = /\{([^{}]+)\}/g;
+var interpolate = (template, params) => {
+  if (!params) {
+    return template;
+  }
+  return template.replace(PLACEHOLDER_PATTERN, (match, rawKey) => {
+    const key = rawKey.trim();
+    if (!(key in params)) {
+      return match;
+    }
+    const value = params[key];
+    if (value === null || value === void 0) {
+      return match;
+    }
+    return String(value);
+  });
+};
+
+// src/core/plural.ts
+var PLURAL_CATEGORIES = ["one", "few", "many", "other"];
+var isPluralMessages = (value) => {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return false;
+  }
+  const record = value;
+  return PLURAL_CATEGORIES.some((category) => typeof record[category] === "string");
+};
+var pickPluralTemplate = (messages, category) => {
+  const direct = category in messages ? messages[category] : void 0;
+  if (typeof direct === "string") {
+    return direct;
+  }
+  if (category !== "other" && typeof messages.other === "string") {
+    return messages.other;
+  }
+  for (const fallbackCategory of PLURAL_CATEGORIES) {
+    const template = messages[fallbackCategory];
+    if (typeof template === "string") {
+      return template;
+    }
+  }
+  return void 0;
+};
+var resolvePluralMessage = (value, locale, params) => {
+  if (!isPluralMessages(value)) {
+    return void 0;
+  }
+  const count = params?.count;
+  if (typeof count !== "number" || !Number.isFinite(count)) {
+    return void 0;
+  }
+  const rules = new Intl.PluralRules(locale);
+  const category = rules.select(count);
+  const template = pickPluralTemplate(value, category);
+  if (template === void 0) {
+    return void 0;
+  }
+  return interpolate(template, { ...params, count });
+};
+
+// src/core/translator.ts
+var formatMissingKey = (key, strategy) => strategy === "empty" ? "" : key;
+var createTranslator = (context) => {
+  const translate = (key, params) => {
+    const locale = context.getLocale();
+    const resolved = resolveMessageValue(
+      context.messages,
+      locale,
+      context.fallbackLocale,
+      key
+    );
+    if (resolved === void 0) {
+      return formatMissingKey(key, context.missingKeyStrategy);
+    }
+    const plural = resolvePluralMessage(resolved, locale, params);
+    if (plural !== void 0) {
+      return plural;
+    }
+    if (typeof resolved === "string") {
+      return interpolate(resolved, params);
+    }
+    return formatMissingKey(key, context.missingKeyStrategy);
+  };
+  return { translate };
+};
+
+// src/create-i18n.ts
+var registerEagerLocales = (locales, messageStore, loadedLocales) => {
+  for (const locale of Object.keys(locales)) {
+    const source = locales[locale];
+    if (source === void 0) {
+      continue;
+    }
+    const eager = resolveLocaleModuleSync(source);
+    if (eager !== void 0) {
+      messageStore[locale] = deepMerge({}, eager);
+      loadedLocales.add(locale);
+    }
+  }
+};
+var hasBrowserOptions = (options) => options.storageKey !== void 0 || options.navigatorRules !== void 0 || options.documentTitleKey !== void 0;
+function createI18n(options) {
+  const {
+    defaultLocale: defaultLocaleOption,
+    fallbackLocale,
+    locales,
+    missingKeyStrategy = "key",
+    storageKey,
+    navigatorRules,
+    syncDocument = true,
+    documentTitleKey
+  } = options;
+  const browser = hasBrowserOptions(options);
+  const supportedLocales = Object.keys(locales);
+  const resolveDetectedLocale = () => detectLocale({
+    supported: supportedLocales,
+    fallback: fallbackLocale,
+    storageKey,
+    navigatorRules
+  });
+  const defaultLocale = defaultLocaleOption ?? (browser ? resolveDetectedLocale() : void 0);
+  if (defaultLocale === void 0) {
+    throw new Error(
+      "createI18n: `defaultLocale` is required when browser options are not set"
+    );
+  }
+  if (!supportedLocales.includes(defaultLocale)) {
+    throw new RangeError(
+      `createI18n: defaultLocale "${String(defaultLocale)}" is not listed in locales`
+    );
+  }
+  if (!supportedLocales.includes(fallbackLocale)) {
+    throw new RangeError(
+      `createI18n: fallbackLocale "${String(fallbackLocale)}" is not listed in locales`
+    );
+  }
+  const state = createLocaleState(defaultLocale, fallbackLocale);
+  const messageStore = cloneLocaleMessages({});
+  const loadedLocales = /* @__PURE__ */ new Set();
+  registerEagerLocales(locales, messageStore, loadedLocales);
+  const { translate } = createTranslator({
+    getLocale: () => state.$locale.value(),
+    fallbackLocale,
+    messages: messageStore,
+    missingKeyStrategy
+  });
+  const addMessages = (locale, messages) => {
+    const bucket = ensureLocaleBucket(messageStore, locale);
+    messageStore[locale] = deepMerge(bucket, messages);
+    loadedLocales.add(locale);
+  };
+  const loadLocale = async (locale) => {
+    if (loadedLocales.has(locale)) {
+      return;
+    }
+    const source = locales[locale];
+    if (!source) {
+      return;
+    }
+    if (!isLocaleImporter(source)) {
+      addMessages(locale, resolveLocaleModuleSync(source));
+      return;
+    }
+    state.$pending.set(true);
+    state.$error.set(null);
+    try {
+      const messages = await resolveLocaleModule(source);
+      addMessages(locale, messages);
+    } catch (error) {
+      state.$error.set(error);
+      throw error;
+    } finally {
+      state.$pending.set(false);
+    }
+  };
+  const setLocale = async (locale) => {
+    const source = locales[locale];
+    if (!loadedLocales.has(locale) && source !== void 0 && isLocaleImporter(source)) {
+      await loadLocale(locale);
+    }
+    state.$locale.set(locale);
+  };
+  const start = () => {
+    if (!browser) {
+      return Promise.resolve();
+    }
+    const locale = resolveDetectedLocale();
+    state.$locale.set(locale);
+    effect(() => {
+      const current = state.$locale.value();
+      if (typeof document !== "undefined" && syncDocument) {
+        document.documentElement.lang = current;
+        if (documentTitleKey) {
+          document.title = translate(documentTitleKey);
+        }
+      }
+      if (storageKey && typeof localStorage !== "undefined") {
+        localStorage.setItem(storageKey, current);
+      }
+    });
+    const source = locales[locale];
+    if (!loadedLocales.has(locale) && source !== void 0 && isLocaleImporter(source)) {
+      void loadLocale(locale);
+    }
+    return Promise.resolve();
+  };
+  return {
+    supportedLocales,
+    locale: () => state.$locale.peek(),
+    setLocale,
+    start,
+    fallbackLocale: () => fallbackLocale,
+    t: translate,
+    exists: (key) => hasMessage(messageStore, state.$locale.peek(), fallbackLocale, key),
+    addMessages,
+    removeLocale: (locale) => {
+      delete messageStore[locale];
+      loadedLocales.delete(locale);
+    },
+    loadLocale,
+    number: (value, formatOptions) => formatNumber(state.$locale.value(), value, formatOptions),
+    currency: (value, currencyCode, formatOptions) => formatCurrency(state.$locale.value(), value, currencyCode, formatOptions),
+    date: (value, formatOptions) => formatDate(state.$locale.value(), value, formatOptions),
+    relativeTime: (value, unit) => formatRelativeTime(state.$locale.value(), value, unit),
+    $locale: state.$locale,
+    $pending: state.$pending,
+    $error: state.$error
+  };
+}
+
+// src/plugin/i18n-provider.ts
+function createI18nProvider(options) {
+  const i18n = createI18n(options);
+  return {
+    name: "i18n",
+    i18n,
+    setup: () => i18n.start()
+  };
+}
+
+export { createI18n, createI18nProvider, detectLocale };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/messages.ts","../src/core/path.ts","../src/core/fallback.ts","../src/core/formatter.ts","../src/core/locale-source.ts","../src/plugin/detect-locale.ts","../src/core/locale.ts","../src/core/interpolation.ts","../src/core/plural.ts","../src/core/translator.ts","../src/create-i18n.ts","../src/plugin/i18n-provider.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { LocaleMessages, Messages } from \"../types\";\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nexport const deepMerge = (\n  target: Messages,\n  source: Messages,\n): Messages => {\n  const result: Messages = { ...target };\n\n  for (const key of Object.keys(source)) {\n    const sourceValue = source[key];\n    const targetValue = result[key];\n\n    if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {\n      result[key] = deepMerge(targetValue, sourceValue);\n    } else {\n      result[key] = sourceValue;\n    }\n  }\n\n  return result;\n};\n\nexport const cloneLocaleMessages = (\n  messages: LocaleMessages,\n): LocaleMessages => {\n  const clone: LocaleMessages = {};\n\n  for (const locale of Object.keys(messages)) {\n    const localeMessages = messages[locale];\n    if (localeMessages !== undefined) {\n      clone[locale] = deepMerge({}, localeMessages);\n    }\n  }\n\n  return clone;\n};\n\nexport const ensureLocaleBucket = (\n  store: LocaleMessages,\n  locale: string,\n): Messages => {\n  const existing = store[locale];\n  if (existing !== undefined) {\n    return existing;\n  }\n\n  const bucket: Messages = {};\n  store[locale] = bucket;\n  return bucket;\n};\n","import type { Messages } from \"../types\";\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\n/**\n * Resolves a dot-separated path against nested message objects.\n */\nexport const getMessageByPath = (\n  messages: Messages | undefined,\n  path: string,\n): unknown => {\n  if (!messages || path.length === 0) {\n    return undefined;\n  }\n\n  const segments = path.split(\".\");\n  let current: unknown = messages;\n\n  for (const segment of segments) {\n    if (!isRecord(current) || !(segment in current)) {\n      return undefined;\n    }\n    current = current[segment];\n  }\n\n  return current;\n};\n","import { getMessageByPath } from \"./path\";\nimport type { LocaleMessages } from \"../types\";\n\nexport const resolveMessageValue = (\n  store: LocaleMessages,\n  locale: string,\n  fallbackLocale: string,\n  key: string,\n): unknown => {\n  const primary = getMessageByPath(store[locale], key);\n  if (primary !== undefined) {\n    return primary;\n  }\n\n  if (locale === fallbackLocale) {\n    return undefined;\n  }\n\n  return getMessageByPath(store[fallbackLocale], key);\n};\n\nexport const hasMessage = (\n  store: LocaleMessages,\n  locale: string,\n  fallbackLocale: string,\n  key: string,\n): boolean => resolveMessageValue(store, locale, fallbackLocale, key) !== undefined;\n","export const formatNumber = (\n  locale: string,\n  value: number,\n  options?: Intl.NumberFormatOptions,\n): string => new Intl.NumberFormat(locale, options).format(value);\n\nexport const formatCurrency = (\n  locale: string,\n  value: number,\n  currency: string,\n  options?: Intl.NumberFormatOptions,\n): string =>\n  new Intl.NumberFormat(locale, {\n    ...options,\n    style: \"currency\",\n    currency,\n  }).format(value);\n\nexport const formatDate = (\n  locale: string,\n  value: Date,\n  options?: Intl.DateTimeFormatOptions,\n): string => new Intl.DateTimeFormat(locale, options).format(value);\n\nexport const formatRelativeTime = (\n  locale: string,\n  value: number,\n  unit: Intl.RelativeTimeFormatUnit,\n): string => new Intl.RelativeTimeFormat(locale).format(value, unit);\n","import type { LocaleImporter, LocaleModuleResult, LocaleSource, Messages } from \"../types\";\n\nexport const isLocaleImporter = <T extends Messages>(\n  source: LocaleSource<T>,\n): source is LocaleImporter<T> => typeof source === \"function\";\n\nconst hasDefaultExport = <T extends Messages>(\n  result: LocaleModuleResult<T>,\n): result is { default: T } =>\n  typeof result === \"object\" &&\n  result !== null &&\n  \"default\" in result &&\n  result.default !== undefined &&\n  typeof result.default === \"object\" &&\n  result.default !== null &&\n  !Array.isArray(result.default);\n\nexport const resolveLocaleModule = async <T extends Messages>(\n  source: LocaleSource<T>,\n): Promise<T> => {\n  if (!isLocaleImporter(source)) {\n    return source;\n  }\n\n  const result = await source();\n  if (hasDefaultExport(result)) {\n    return result.default;\n  }\n\n  return result;\n};\n\nexport const resolveLocaleModuleSync = <T extends Messages>(\n  source: LocaleSource<T>,\n): T | undefined => (isLocaleImporter(source) ? undefined : source);\n","export type DetectLocaleOptions<TLocale extends string> = {\n  supported: readonly TLocale[];\n  fallback: TLocale;\n  storageKey?: string;\n  /** e.g. `{ prefix: \"ru\", locale: \"ru\" }` when `navigator.language` matches. */\n  navigatorRules?: ReadonlyArray<{ prefix: string; locale: TLocale }>;\n};\n\nexport const detectLocale = <TLocale extends string>(\n  options: DetectLocaleOptions<TLocale>,\n): TLocale => {\n  const { supported, fallback, storageKey, navigatorRules } = options;\n  const isSupported = (value: string): value is TLocale =>\n    (supported as readonly string[]).includes(value);\n\n  if (storageKey && typeof localStorage !== \"undefined\") {\n    const stored = localStorage.getItem(storageKey);\n    if (stored && isSupported(stored)) {\n      return stored;\n    }\n  }\n\n  if (navigatorRules?.length && typeof navigator !== \"undefined\") {\n    const lang = navigator.language.toLowerCase();\n    for (const rule of navigatorRules) {\n      if (lang.startsWith(rule.prefix)) {\n        return rule.locale;\n      }\n    }\n  }\n\n  return fallback;\n};\n","import { signal } from \"@echojs-ecosystem/reactivity\";\nimport type { Signal } from \"@echojs-ecosystem/reactivity\";\n\nexport type LocaleState<TLocale extends string = string> = {\n  readonly $locale: Signal<TLocale>;\n  readonly $pending: Signal<boolean>;\n  readonly $error: Signal<unknown | null>;\n  readonly fallbackLocale: TLocale;\n};\n\nexport const createLocaleState = <TLocale extends string>(\n  initialLocale: TLocale,\n  fallbackLocale: TLocale,\n): LocaleState<TLocale> => ({\n  $locale: signal(initialLocale),\n  $pending: signal(false),\n  $error: signal<unknown | null>(null),\n  fallbackLocale,\n});\n","const PLACEHOLDER_PATTERN = /\\{([^{}]+)\\}/g;\n\nexport const interpolate = (\n  template: string,\n  params: Record<string, unknown> | undefined,\n): string => {\n  if (!params) {\n    return template;\n  }\n\n  return template.replace(PLACEHOLDER_PATTERN, (match, rawKey: string) => {\n    const key = rawKey.trim();\n    if (!(key in params)) {\n      return match;\n    }\n\n    const value = params[key];\n    if (value === null || value === undefined) {\n      return match;\n    }\n\n    return String(value);\n  });\n};\n","import { interpolate } from \"./interpolation\";\nimport type { PluralMessages } from \"../types\";\n\nconst PLURAL_CATEGORIES = [\"one\", \"few\", \"many\", \"other\"] as const;\n\nconst isPluralMessages = (value: unknown): value is PluralMessages => {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return false;\n  }\n\n  const record = value as Record<string, unknown>;\n  return PLURAL_CATEGORIES.some((category) => typeof record[category] === \"string\");\n};\n\nconst pickPluralTemplate = (\n  messages: PluralMessages,\n  category: Intl.LDMLPluralRule,\n): string | undefined => {\n  const direct =\n    category in messages\n      ? messages[category as keyof PluralMessages]\n      : undefined;\n  if (typeof direct === \"string\") {\n    return direct;\n  }\n\n  if (category !== \"other\" && typeof messages.other === \"string\") {\n    return messages.other;\n  }\n\n  for (const fallbackCategory of PLURAL_CATEGORIES) {\n    const template = messages[fallbackCategory];\n    if (typeof template === \"string\") {\n      return template;\n    }\n  }\n\n  return undefined;\n};\n\nexport const resolvePluralMessage = (\n  value: unknown,\n  locale: string,\n  params: Record<string, unknown> | undefined,\n): string | undefined => {\n  if (!isPluralMessages(value)) {\n    return undefined;\n  }\n\n  const count = params?.count;\n  if (typeof count !== \"number\" || !Number.isFinite(count)) {\n    return undefined;\n  }\n\n  const rules = new Intl.PluralRules(locale);\n  const category = rules.select(count);\n  const template = pickPluralTemplate(value, category);\n\n  if (template === undefined) {\n    return undefined;\n  }\n\n  return interpolate(template, { ...params, count });\n};\n","import { resolveMessageValue } from \"./fallback\";\nimport { interpolate } from \"./interpolation\";\nimport { resolvePluralMessage } from \"./plural\";\nimport type { LocaleMessages, MissingKeyStrategy } from \"../types\";\n\nexport type TranslateContext = {\n  getLocale: () => string;\n  fallbackLocale: string;\n  messages: LocaleMessages;\n  missingKeyStrategy: MissingKeyStrategy;\n};\n\nconst formatMissingKey = (\n  key: string,\n  strategy: MissingKeyStrategy,\n): string => (strategy === \"empty\" ? \"\" : key);\n\nexport const createTranslator = (context: TranslateContext) => {\n  const translate = (\n    key: string,\n    params?: Record<string, unknown>,\n  ): string => {\n    const locale = context.getLocale();\n    const resolved = resolveMessageValue(\n      context.messages,\n      locale,\n      context.fallbackLocale,\n      key,\n    );\n\n    if (resolved === undefined) {\n      return formatMissingKey(key, context.missingKeyStrategy);\n    }\n\n    const plural = resolvePluralMessage(resolved, locale, params);\n    if (plural !== undefined) {\n      return plural;\n    }\n\n    if (typeof resolved === \"string\") {\n      return interpolate(resolved, params);\n    }\n\n    return formatMissingKey(key, context.missingKeyStrategy);\n  };\n\n  return { translate };\n};\n","import {\n  cloneLocaleMessages,\n  deepMerge,\n  ensureLocaleBucket,\n} from \"./core/messages\";\nimport { hasMessage } from \"./core/fallback\";\nimport {\n  formatCurrency,\n  formatDate,\n  formatNumber,\n  formatRelativeTime,\n} from \"./core/formatter\";\nimport {\n  isLocaleImporter,\n  resolveLocaleModule,\n  resolveLocaleModuleSync,\n} from \"./core/locale-source\";\nimport { detectLocale } from \"./plugin/detect-locale\";\nimport { effect } from \"@echojs-ecosystem/reactivity\";\nimport { createLocaleState } from \"./core/locale\";\nimport { createTranslator } from \"./core/translator\";\nimport type {\n  AnyLocalesMap,\n  CreateI18nOptions,\n  I18n,\n  InferLocaleFromLocalesMap,\n  InferMessagesFromLocalesMap,\n  Messages,\n} from \"./types\";\n\nconst registerEagerLocales = (\n  locales: AnyLocalesMap,\n  messageStore: Record<string, Messages>,\n  loadedLocales: Set<string>,\n): void => {\n  for (const locale of Object.keys(locales)) {\n    const source = locales[locale];\n    if (source === undefined) {\n      continue;\n    }\n    const eager = resolveLocaleModuleSync(source);\n    if (eager !== undefined) {\n      messageStore[locale] = deepMerge({}, eager);\n      loadedLocales.add(locale);\n    }\n  }\n};\n\nconst hasBrowserOptions = <TLocales extends AnyLocalesMap>(\n  options: CreateI18nOptions<TLocales>,\n): boolean =>\n  options.storageKey !== undefined ||\n  options.navigatorRules !== undefined ||\n  options.documentTitleKey !== undefined;\n\nexport function createI18n<const TLocales extends AnyLocalesMap>(\n  options: CreateI18nOptions<TLocales>,\n): I18n<InferLocaleFromLocalesMap<TLocales>, InferMessagesFromLocalesMap<TLocales>> {\n  type TLocale = InferLocaleFromLocalesMap<TLocales>;\n  type TMessages = InferMessagesFromLocalesMap<TLocales>;\n\n  const {\n    defaultLocale: defaultLocaleOption,\n    fallbackLocale,\n    locales,\n    missingKeyStrategy = \"key\",\n    storageKey,\n    navigatorRules,\n    syncDocument = true,\n    documentTitleKey,\n  } = options;\n\n  const browser = hasBrowserOptions(options);\n  const supportedLocales = Object.keys(locales) as TLocale[];\n\n  const resolveDetectedLocale = (): TLocale =>\n    detectLocale({\n      supported: supportedLocales,\n      fallback: fallbackLocale as TLocale,\n      storageKey,\n      navigatorRules,\n    });\n\n  const defaultLocale = (defaultLocaleOption ?? (browser ? resolveDetectedLocale() : undefined)) as\n    | TLocale\n    | undefined;\n\n  if (defaultLocale === undefined) {\n    throw new Error(\n      \"createI18n: `defaultLocale` is required when browser options are not set\",\n    );\n  }\n\n  if (!supportedLocales.includes(defaultLocale as TLocale)) {\n    throw new RangeError(\n      `createI18n: defaultLocale \"${String(defaultLocale)}\" is not listed in locales`,\n    );\n  }\n\n  if (!supportedLocales.includes(fallbackLocale as TLocale)) {\n    throw new RangeError(\n      `createI18n: fallbackLocale \"${String(fallbackLocale)}\" is not listed in locales`,\n    );\n  }\n\n  const state = createLocaleState(defaultLocale as TLocale, fallbackLocale as TLocale);\n  const messageStore = cloneLocaleMessages({});\n  const loadedLocales = new Set<string>();\n\n  registerEagerLocales(locales, messageStore, loadedLocales);\n\n  const { translate } = createTranslator({\n    getLocale: () => state.$locale.value(),\n    fallbackLocale: fallbackLocale as TLocale,\n    messages: messageStore,\n    missingKeyStrategy,\n  });\n\n  const addMessages = (locale: TLocale, messages: Messages): void => {\n    const bucket = ensureLocaleBucket(messageStore, locale);\n    messageStore[locale] = deepMerge(bucket, messages);\n    loadedLocales.add(locale);\n  };\n\n  const loadLocale = async (locale: TLocale): Promise<void> => {\n    if (loadedLocales.has(locale)) {\n      return;\n    }\n\n    const source = locales[locale];\n    if (!source) {\n      return;\n    }\n\n    if (!isLocaleImporter(source)) {\n      addMessages(locale, resolveLocaleModuleSync(source)!);\n      return;\n    }\n\n    state.$pending.set(true);\n    state.$error.set(null);\n\n    try {\n      const messages = await resolveLocaleModule(source);\n      addMessages(locale, messages);\n    } catch (error: unknown) {\n      state.$error.set(error);\n      throw error;\n    } finally {\n      state.$pending.set(false);\n    }\n  };\n\n  const setLocale = async (locale: TLocale): Promise<void> => {\n    const source = locales[locale];\n    if (!loadedLocales.has(locale) && source !== undefined && isLocaleImporter(source)) {\n      await loadLocale(locale);\n    }\n\n    state.$locale.set(locale);\n  };\n\n  const start = (): Promise<void> => {\n    if (!browser) {\n      return Promise.resolve();\n    }\n\n    const locale = resolveDetectedLocale();\n    state.$locale.set(locale);\n\n    effect(() => {\n      const current = state.$locale.value();\n      if (typeof document !== \"undefined\" && syncDocument) {\n        document.documentElement.lang = current;\n        if (documentTitleKey) {\n          document.title = translate(documentTitleKey);\n        }\n      }\n      if (storageKey && typeof localStorage !== \"undefined\") {\n        localStorage.setItem(storageKey, current);\n      }\n    });\n\n    const source = locales[locale];\n    if (\n      !loadedLocales.has(locale) &&\n      source !== undefined &&\n      isLocaleImporter(source)\n    ) {\n      void loadLocale(locale);\n    }\n\n    return Promise.resolve();\n  };\n\n  return {\n    supportedLocales,\n\n    locale: (): TLocale => state.$locale.peek() as TLocale,\n    setLocale,\n    start,\n\n    fallbackLocale: (): TLocale => fallbackLocale as TLocale,\n\n    t: translate,\n\n    exists: (key) =>\n      hasMessage(messageStore, state.$locale.peek(), fallbackLocale as TLocale, key),\n\n    addMessages,\n\n    removeLocale: (locale: TLocale) => {\n      delete messageStore[locale];\n      loadedLocales.delete(locale);\n    },\n\n    loadLocale,\n\n    number: (value, formatOptions) =>\n      formatNumber(state.$locale.value(), value, formatOptions),\n\n    currency: (value, currencyCode, formatOptions) =>\n      formatCurrency(state.$locale.value(), value, currencyCode, formatOptions),\n\n    date: (value, formatOptions) =>\n      formatDate(state.$locale.value(), value, formatOptions),\n\n    relativeTime: (value, unit) =>\n      formatRelativeTime(state.$locale.value(), value, unit),\n\n    $locale: state.$locale,\n    $pending: state.$pending,\n    $error: state.$error,\n  };\n}\n","import { createI18n } from \"../create-i18n\";\nimport type {\n  AnyLocalesMap,\n  CreateI18nOptions,\n  I18n,\n  InferLocaleFromLocalesMap,\n  InferMessagesFromLocalesMap,\n  Messages,\n} from \"../types\";\n\n/** Echo app provider with the active {@link I18n} instance. */\nexport type EchoI18nProvider<\n  TLocale extends string = string,\n  TMessages extends Messages = Messages,\n> = {\n  name: \"i18n\";\n  readonly i18n: I18n<TLocale, TMessages>;\n  setup: () => void | Promise<void>;\n};\n\n/**\n * Creates i18n and an Echo app provider (`setup` runs {@link I18n.start}).\n *\n * ```ts\n * export const i18nProvider = createI18nProvider({ locales: { en, ru } });\n * app.use(i18nProvider);\n * i18nProvider.i18n.t(\"key\");\n * ```\n */\nexport function createI18nProvider<const TLocales extends AnyLocalesMap>(\n  options: CreateI18nOptions<TLocales>,\n): EchoI18nProvider<\n  InferLocaleFromLocalesMap<TLocales>,\n  InferMessagesFromLocalesMap<TLocales>\n> {\n  const i18n = createI18n(options);\n  return {\n    name: \"i18n\",\n    i18n,\n    setup: () => i18n.start(),\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@echojs-ecosystem/i18n",
+  "version": "0.1.0",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsup",
+    "check-types": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.typing.json --noEmit",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.typing.json --noEmit",
+    "test:types": "tsc -p tsconfig.typing.json --noEmit",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint . --fix",
+    "format": "oxfmt --check .",
+    "format:fix": "oxfmt .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@echojs-ecosystem/reactivity": "workspace:*"
+  },
+  "devDependencies": {
+    "@echojs-ecosystem/oxc-config": "workspace:*",
+    "typescript": "5.9.2",
+    "vitest": "^4.1.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/echojs-ecosystem/echojs-core.git",
+    "directory": "packages/i18n"
+  }
+}