@sehv-oss/i18n 1.0.0

package/LICENSE

@@ -0,0 +1,7 @@
+ISC License
+
+Copyright 2026 sehv-oss
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# @sehv-oss/i18n
+
+Core i18n library for JavaScript.
+
+## Installation
+
+```bash
+# npm
+npm install @sehv-oss/i18n
+
+# yarn
+yarn add @sehv-oss/i18n
+
+# pnpm
+pnpm add @sehv-oss/i18n
+```
+
+## Usage
+
+### Basic
+
+```typescript
+import { createI18n } from '@sehv-oss/i18n';
+
+const i18n = createI18n({
+  locale: 'en',
+  fallbackLocale: 'en',
+  messages: {
+    en: {
+      greeting: 'Hello, {$name}!',
+      items: `.match {$count :number}
+one {{You have {$count} item}}
+*   {{You have {$count} items}}`,
+    },
+  },
+});
+
+i18n.translate('greeting', { name: 'World' });
+// → "Hello, World!"
+
+i18n.translate('items', { count: 5 });
+// → "You have 5 items"
+```
+
+### Formatters
+
+```typescript
+i18n.formatNumber(1234.56);
+// → "1,234.56"
+
+i18n.formatCurrency(99.9, 'USD');
+// → "$99.90"
+
+i18n.formatDate(new Date(), { dateStyle: 'long' });
+// → "January 27, 2026"
+
+i18n.formatList(['apple', 'banana', 'orange']);
+// → "apple, banana, and orange"
+
+i18n.formatRelativeTime(-2, 'days');
+// → "2 days ago"
+```
+
+### Lazy Loading
+
+```typescript
+await i18n.loadMessagesAsync('/locales/en.json');
+```
+
+### Custom Loader
+
+```typescript
+import { createI18n, type ILoader } from '@sehv-oss/i18n';
+import YAML from 'yaml';
+
+const yamlLoader: ILoader = {
+  extensions: ['.yaml', '.yml'],
+  parse(content) {
+    return YAML.parse(content);
+  },
+};
+
+const i18n = createI18n({
+  locale: 'en',
+  loaders: [yamlLoader],
+});
+
+await i18n.loadMessagesAsync('/locales/en.yaml');
+```
+
+## API
+
+### `createI18n(config)`
+
+Creates an i18n instance.
+
+### Methods
+
+| Method                                      | Description                 |
+| ------------------------------------------- | --------------------------- |
+| `translate(key, values?)`                   | Translate a message key     |
+| `formatNumber(value, options?)`             | Format a number             |
+| `formatCurrency(value, currency, options?)` | Format currency             |
+| `formatDate(value, options?)`               | Format a date               |
+| `formatList(values, options?)`              | Format a list               |
+| `formatRelativeTime(value, unit, options?)` | Format relative time        |
+| `loadMessages(locale, messages)`            | Load messages synchronously |
+| `loadMessagesAsync(url)`                    | Load messages via fetch     |
+| `setLocale(locale)`                         | Change current locale       |
+| `getLocales()`                              | Get available locales       |
+| `onLocaleChange(listener)`                  | Subscribe to locale changes |
+
+## License
+
+ISC

package/dist/formatters/formatters.d.mts

@@ -0,0 +1,42 @@
+//#region src/formatters/currency.d.ts
+type FormatCurrencyOptions = Omit<Intl.NumberFormatOptions, 'style'> & {
+  locale?: string;
+};
+declare class FormatCurrency {
+  static format(value: number, currency: string, locale: string, options?: FormatCurrencyOptions): string;
+}
+//#endregion
+//#region src/formatters/date.d.ts
+type FormatDateOptions = Intl.DateTimeFormatOptions & {
+  locale?: string;
+};
+declare class FormatDate {
+  static format(value: Date | number, locale: string, options?: FormatDateOptions): string;
+}
+//#endregion
+//#region src/formatters/list.d.ts
+type FormatListOptions = Intl.ListFormatOptions & {
+  locale?: string;
+};
+declare class FormatList {
+  static format(values: string[], locale: string, options?: FormatListOptions): string;
+}
+//#endregion
+//#region src/formatters/number.d.ts
+type FormatNumberOptions = Intl.NumberFormatOptions & {
+  locale?: string;
+};
+declare class FormatNumber {
+  static format(value: number, locale: string, options?: FormatNumberOptions): string;
+}
+//#endregion
+//#region src/formatters/relative-time.d.ts
+type FormatRelativeTimeUnit = 'year' | 'years' | 'quarter' | 'quarters' | 'month' | 'months' | 'week' | 'weeks' | 'day' | 'days' | 'hour' | 'hours' | 'minute' | 'minutes' | 'second' | 'seconds';
+type FormatRelativeTimeOptions = Intl.RelativeTimeFormatOptions & {
+  locale?: string;
+};
+declare class FormatRelativeTime {
+  static format(value: number, unit: FormatRelativeTimeUnit, locale: string, options?: FormatRelativeTimeOptions): string;
+}
+//#endregion
+export { FormatCurrency, FormatCurrencyOptions, FormatDate, FormatDateOptions, FormatList, FormatListOptions, FormatNumber, FormatNumberOptions, FormatRelativeTime, FormatRelativeTimeOptions, FormatRelativeTimeUnit };

package/dist/formatters/formatters.mjs

@@ -0,0 +1 @@
+import{a as e,i as t,n,r,t as i}from"../formatters-Bvs6JDy4.mjs";export{e as FormatCurrency,t as FormatDate,r as FormatList,n as FormatNumber,i as FormatRelativeTime};

package/dist/formatters-Bvs6JDy4.mjs

@@ -0,0 +1 @@
+var e=class{cache=new Map;constructor(e){this.Formatter=e}get(e,t){let n=this.buildKey(e,t),r=this.cache.get(n);return r||(r=new this.Formatter(e,t),this.cache.set(n,r)),r}clear(){this.cache.clear()}buildKey(e,t){return t?`${e}:${JSON.stringify(t)}`:e}};const t=new e(Intl.NumberFormat);var n=class{static format(e,n,r,i){let{locale:a,...o}=i??{};return t.get(r,{...o,style:`currency`,currency:n}).format(e)}};const r=new e(Intl.DateTimeFormat);var i=class{static format(e,t,n){let{locale:i,...a}=n??{};return r.get(t,a).format(e)}};const a=new e(Intl.ListFormat);var o=class{static format(e,t,n){let{locale:r,...i}=n??{};return a.get(t,i).format(e)}};const s=new e(Intl.NumberFormat);var c=class{static format(e,t,n){let{locale:r,...i}=n??{};return s.get(t,i).format(e)}};const l=new e(Intl.RelativeTimeFormat),u={year:`year`,years:`year`,quarter:`quarter`,quarters:`quarter`,month:`month`,months:`month`,week:`week`,weeks:`week`,day:`day`,days:`day`,hour:`hour`,hours:`hour`,minute:`minute`,minutes:`minute`,second:`second`,seconds:`second`};var d=class{static format(e,t,n,r){let{locale:i,...a}=r??{},o=l.get(n,a),s=u[t];return o.format(e,s)}};export{n as a,i,c as n,o as r,d as t};

package/dist/i18n.d.mts

@@ -0,0 +1,48 @@
+import { FormatCurrency, FormatCurrencyOptions, FormatDate, FormatDateOptions, FormatList, FormatListOptions, FormatNumber, FormatNumberOptions, FormatRelativeTime, FormatRelativeTimeOptions, FormatRelativeTimeUnit } from "./formatters/formatters.mjs";
+
+//#region src/messages/messages.d.ts
+type Messages = Record<string, string>;
+//#endregion
+//#region src/loaders/loader.interface.d.ts
+interface ILoader {
+  extensions: string[];
+  parse(content: string): Messages;
+}
+//#endregion
+//#region src/i18n.d.ts
+type I18nConfig = {
+  locale: string;
+  fallbackLocale?: string;
+  messages?: Record<string, Messages>;
+  loaders?: ILoader[];
+};
+declare class I18nInstance {
+  private locale;
+  private fallbackLocale;
+  private messagesManager;
+  private messageCache;
+  private loaders;
+  private mf2ParserByLocale;
+  private localeChangeListeners;
+  constructor(config: I18nConfig);
+  getLocale(): string;
+  setLocale(locale: string): void;
+  onLocaleChange(listener: (locale: string) => void): () => void;
+  getFallbackLocale(): string | undefined;
+  getLocales(): string[];
+  translate(key: string, values?: Record<string, unknown>): string;
+  formatNumber(value: number, options?: FormatNumberOptions): string;
+  formatCurrency(value: number, currency: string, options?: FormatCurrencyOptions): string;
+  formatDate(value: Date | number, options?: FormatDateOptions): string;
+  formatList(values: string[], options?: FormatListOptions): string;
+  formatRelativeTime(value: number, unit: FormatRelativeTimeUnit, options?: FormatRelativeTimeOptions): string;
+  loadMessages(locale: string, messages: Messages): void;
+  loadMessagesAsync(url: string): Promise<void>;
+  private getParser;
+  private findLoader;
+  private getExtension;
+  private extractLocaleFromUrl;
+}
+declare function createI18n(config: I18nConfig): I18nInstance;
+//#endregion
+export { FormatCurrency, FormatCurrencyOptions, FormatDate, FormatDateOptions, FormatList, FormatListOptions, FormatNumber, FormatNumberOptions, FormatRelativeTime, FormatRelativeTimeOptions, FormatRelativeTimeUnit, I18nConfig, I18nInstance, ILoader, createI18n };

package/dist/i18n.mjs

@@ -0,0 +1,2 @@
+import{a as e,i as t,n,r,t as i}from"./formatters-Bvs6JDy4.mjs";var a=class{cache=new Map;maxSize;constructor(e=1e3){this.maxSize=e}get(e){return this.cache.get(e)}set(e,t){if(this.cache.size>=this.maxSize){let e=this.cache.keys().next().value;e&&this.cache.delete(e)}this.cache.set(e,t)}has(e){return this.cache.has(e)}clear(){this.cache.clear()}},o=class{extensions=[`.json`];parse(e){try{let t=JSON.parse(e);if(!this.isValidMessages(t))throw Error(`Invalid messages format!`);return t}catch(e){throw e instanceof SyntaxError?Error(`Failed to parse JSON: ${e.message}.`):e}}isValidMessages(e){return typeof e!=`object`||!e||Array.isArray(e)?!1:Object.values(e).every(e=>typeof e==`string`)}},s=class{messages=new Map;get(e){return this.messages.get(e)}set(e,t){this.messages.set(e,t)}has(e){return this.messages.has(e)}getLocales(){return Array.from(this.messages.keys())}getMessage(e,t){let n=this.get(e);if(n)return n[t]}},c=class{pluralRules;constructor(e){this.pluralRules=new Intl.PluralRules(e)}parse(e,t={}){let n=e.trim();return n.startsWith(`.match`)?this.parseMatch(n,t):this.interpolate(n,t)}parseMatch(e,t){let n=this.parseMatchSyntax(e);if(!n.selectors?.length||!n.variants?.length)return e;let r=this.selectVariant(n.selectors,n.variants,t);return this.interpolate(r,t)}parseMatchSyntax(e){let t=e.split(`
+`).map(e=>e.trim()).filter(Boolean);if(t.length===0||!t[0]?.startsWith(`.match`))return{type:`simple`,pattern:e};let n=t[0];return{type:`match`,selectors:this.parseSelectors(n),variants:this.parseVariants(t.slice(1))}}parseSelectors(e){let t=[],n=/\{\s*\$(\w+)(?:\s+:(\w+))?\s*\}/g,r;for(;(r=n.exec(e))!==null;){let[,e,n]=r;e&&t.push({variable:e,function:n})}return t}parseVariants(e){let t=[],n=/^([\w\s*]+)\s*\{\{(.+?)\}\}$/;for(let r of e){let e=n.exec(r);if(!e)continue;let[,i,a]=e;if(!i||!a)continue;let o=i.trim().split(/\s+/),s=a.trim();t.push({keys:o,pattern:s})}return t}selectVariant(e,t,n){let r=e.map(e=>{let t=n[e.variable];return e.function===`number`&&typeof t==`number`?this.pluralRules.select(t):String(t??`*`)});for(let e of t)if(this.matchesVariant(e.keys,r))return e.pattern;return t.find(e=>e.keys.every(e=>e===`*`))?.pattern??``}matchesVariant(e,t){return e.length===t.length?e.every((e,n)=>e===`*`||e===t[n]):!1}interpolate(e,t){return e.replace(/\{\s*\$(\w+)\s*\}/g,(e,n)=>{let r=t[n];return r===void 0?`{$${n}}`:String(r)})}},l=class{locale;fallbackLocale;messagesManager;messageCache;loaders;mf2ParserByLocale;localeChangeListeners=new Set;constructor(e){let{locale:t,fallbackLocale:n,loaders:r,messages:i}=e;this.locale=t,this.fallbackLocale=n,this.messagesManager=new s,this.messageCache=new a,this.mf2ParserByLocale=new Map,this.loaders=[new o,...r??[]],i&&Object.entries(i).forEach(([e,t])=>{this.messagesManager.set(e,t)})}getLocale(){return this.locale}setLocale(e){this.locale=e,this.messageCache.clear(),this.localeChangeListeners.forEach(t=>t(e))}onLocaleChange(e){return this.localeChangeListeners.add(e),()=>{this.localeChangeListeners.delete(e)}}getFallbackLocale(){return this.fallbackLocale}getLocales(){return this.messagesManager.getLocales()}translate(e,t){let n=`${this.locale}:${e}:${JSON.stringify(t??{})}`;if(this.messageCache.has(n))return this.messageCache.get(n);let r=this.messagesManager.getMessage(this.locale,e);if(!r&&this.fallbackLocale&&(r=this.messagesManager.getMessage(this.fallbackLocale,e)),!r)return e;let i=this.getParser(this.locale).parse(r,t);return this.messageCache.set(n,i),i}formatNumber(e,t){let r=t?.locale??this.locale;return n.format(e,r,t)}formatCurrency(t,n,r){let i=r?.locale??this.locale;return e.format(t,n,i,r)}formatDate(e,n){let r=n?.locale??this.locale;return t.format(e,r,n)}formatList(e,t){let n=t?.locale??this.locale;return r.format(e,n,t)}formatRelativeTime(e,t,n){let r=n?.locale??this.locale;return i.format(e,t,r,n)}loadMessages(e,t){this.messagesManager.set(e,t),this.messageCache.clear()}async loadMessagesAsync(e){let t=await fetch(e);if(!t.ok)throw Error(`Failed to load messages from ${e}: ${t.statusText}.`);let n=await t.text(),r=this.findLoader(e);if(!r)throw Error(`No loader found for ${e}.`);let i=r.parse(n),a=this.extractLocaleFromUrl(e);this.loadMessages(a,i)}getParser(e){let t=this.mf2ParserByLocale.get(e);return t||(t=new c(e),this.mf2ParserByLocale.set(e,t)),t}findLoader(e){let t=this.getExtension(e);return this.loaders.find(e=>e.extensions.includes(t))}getExtension(e){return e.match(/\.[^.]+$/)?.[0]??``}extractLocaleFromUrl(e){let t=(e.split(`/`).pop()??``).replace(/\.[^.]+$/,``);try{let[e]=Intl.getCanonicalLocales(t);return e??this.locale}catch{return this.locale}}};function u(e){return new l(e)}export{e as FormatCurrency,t as FormatDate,r as FormatList,n as FormatNumber,i as FormatRelativeTime,l as I18nInstance,u as createI18n};

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@sehv-oss/i18n",
+  "version": "1.0.0",
+  "description": "Modern i18n library for JavaScript. Web standards based, runs everywhere.",
+  "type": "module",
+  "files": [
+    "./dist"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/i18n.d.ts",
+      "import": "./dist/i18n.mjs"
+    },
+    "./formatters": {
+      "types": "./dist/formatters/formatters.d.ts",
+      "import": "./dist/formatters/formatters.mjs"
+    }
+  },
+  "keywords": [
+    "i18n",
+    "l10n",
+    "internationalization",
+    "localization",
+    "intl",
+    "message format",
+    "translation"
+  ],
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sehv-oss/i18n.git",
+    "directory": "packages/core"
+  },
+  "engines": {
+    "node": ">=22 <25"
+  },
+  "scripts": {
+    "build": "tsdown"
+  }
+}