@murumets-ee/i18n 0.3.0

package/dist/index.d.mts

@@ -0,0 +1,79 @@
+//#region src/loader.d.ts
+/**
+ * Factory for creating message loader functions.
+ *
+ * Eliminates the per-package boilerplate of switching on locale,
+ * catching import errors, and falling back to a default locale.
+ *
+ * @example
+ * ```ts
+ * // ticketing/src/i18n.ts
+ * import { createMessageLoader } from '@murumets-ee/i18n'
+ *
+ * export const getTicketingMessages = createMessageLoader(
+ *   (locale) => import(`./messages/${locale}.json`).then(m => m.default),
+ * )
+ * ```
+ */
+declare function createMessageLoader(importFn: (locale: string) => Promise<Record<string, unknown>>, options?: {
+  fallbackLocale?: string;
+}): (locale: string) => Promise<Record<string, unknown>>;
+//#endregion
+//#region src/merge.d.ts
+/**
+ * Deep-merge multiple message catalogs.
+ *
+ * Unlike `{ ...a, ...b }`, this recursively merges nested objects so
+ * that namespaced catalogs from different packages don't clobber each
+ * other's keys.
+ *
+ * @example
+ * ```ts
+ * const merged = mergeMessages(
+ *   { Common: { save: 'Save' } },
+ *   { Ticketing: { status: { open: 'Open' } } },
+ *   { Common: { cancel: 'Cancel' } },  // merges into Common, doesn't overwrite
+ * )
+ * // → { Common: { save: 'Save', cancel: 'Cancel' }, Ticketing: { status: { open: 'Open' } } }
+ * ```
+ */
+declare function mergeMessages(...catalogs: Record<string, unknown>[]): Record<string, unknown>;
+//#endregion
+//#region src/options.d.ts
+/**
+ * Build the i18n key for a select field option.
+ *
+ * Convention: `{Namespace}.{field}.{value}`
+ *
+ * @example
+ * ```ts
+ * optionKey('Ticketing', 'status', '0_open')
+ * // → 'Ticketing.status.0_open'
+ * ```
+ */
+declare function optionKey(namespace: string, field: string, value: string): string;
+/**
+ * Strip the numeric sort prefix from a select value.
+ *
+ * Values like `'0_open'`, `'2_high'` become `'open'`, `'high'`.
+ * Values without a prefix are returned as-is.
+ *
+ * Useful as a display fallback when translations aren't available.
+ *
+ * @example
+ * ```ts
+ * stripPrefix('0_open')   // → 'open'
+ * stripPrefix('hello')    // → 'hello'
+ * stripPrefix('3_urgent') // → 'urgent'
+ * ```
+ */
+declare function stripPrefix(value: string): string;
+//#endregion
+//#region src/types.d.ts
+/** Nested message catalog — string leaves, object branches. */
+type MessageCatalog = {
+  [key: string]: string | MessageCatalog;
+};
+//#endregion
+export { type MessageCatalog, createMessageLoader, mergeMessages, optionKey, stripPrefix };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/loader.ts","../src/merge.ts","../src/options.ts","../src/types.ts"],"mappings":";;AAgBA;;;;;;;;;;;;;;;iBAAgB,mBAAA,CACd,QAAA,GAAW,MAAA,aAAmB,OAAA,CAAQ,MAAA,oBACtC,OAAA;EAAY,cAAA;AAAA,KACV,MAAA,aAAmB,OAAA,CAAQ,MAAA;;;;AAH/B;;;;;;;;;;;;;;;;iBCCgB,aAAA,CAAA,GACX,QAAA,EAAU,MAAA,sBACZ,MAAA;;;;ADHH;;;;;;;;;;iBELgB,SAAA,CAAU,SAAA,UAAmB,KAAA,UAAe,KAAA;;;;;;;;;;;;;ADM5D;;;iBCagB,WAAA,CAAY,KAAA;;;;KC7BhB,cAAA;EAAA,CACT,GAAA,oBAAuB,cAAA;AAAA"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+function e(e,t){let n=t?.fallbackLocale??`en`;return async t=>{try{return await e(t)}catch{if(t!==n)try{return await e(n)}catch{return{}}return{}}}}function t(...e){let n={};for(let r of e)for(let[e,i]of Object.entries(r)){let r=n[e];typeof r==`object`&&r&&!Array.isArray(r)&&typeof i==`object`&&i&&!Array.isArray(i)?n[e]=t(r,i):n[e]=i}return n}function n(e,t,n){return`${e}.${t}.${n}`}function r(e){return e.replace(/^\d+_/,``)}export{e as createMessageLoader,t as mergeMessages,n as optionKey,r as stripPrefix};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/loader.ts","../src/merge.ts","../src/options.ts"],"sourcesContent":["/**\n * Factory for creating message loader functions.\n *\n * Eliminates the per-package boilerplate of switching on locale,\n * catching import errors, and falling back to a default locale.\n *\n * @example\n * ```ts\n * // ticketing/src/i18n.ts\n * import { createMessageLoader } from '@murumets-ee/i18n'\n *\n * export const getTicketingMessages = createMessageLoader(\n *   (locale) => import(`./messages/${locale}.json`).then(m => m.default),\n * )\n * ```\n */\nexport function createMessageLoader(\n  importFn: (locale: string) => Promise<Record<string, unknown>>,\n  options?: { fallbackLocale?: string },\n): (locale: string) => Promise<Record<string, unknown>> {\n  const fallback = options?.fallbackLocale ?? 'en'\n\n  return async (locale: string): Promise<Record<string, unknown>> => {\n    try {\n      return await importFn(locale)\n    } catch {\n      // Locale not found — fall back\n      if (locale !== fallback) {\n        try {\n          return await importFn(fallback)\n        } catch {\n          return {}\n        }\n      }\n      return {}\n    }\n  }\n}\n","/**\n * Deep-merge multiple message catalogs.\n *\n * Unlike `{ ...a, ...b }`, this recursively merges nested objects so\n * that namespaced catalogs from different packages don't clobber each\n * other's keys.\n *\n * @example\n * ```ts\n * const merged = mergeMessages(\n *   { Common: { save: 'Save' } },\n *   { Ticketing: { status: { open: 'Open' } } },\n *   { Common: { cancel: 'Cancel' } },  // merges into Common, doesn't overwrite\n * )\n * // → { Common: { save: 'Save', cancel: 'Cancel' }, Ticketing: { status: { open: 'Open' } } }\n * ```\n */\nexport function mergeMessages(\n  ...catalogs: Record<string, unknown>[]\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {}\n\n  for (const catalog of catalogs) {\n    for (const [key, value] of Object.entries(catalog)) {\n      const existing = result[key]\n      if (\n        existing != null &&\n        typeof existing === 'object' &&\n        !Array.isArray(existing) &&\n        value != null &&\n        typeof value === 'object' &&\n        !Array.isArray(value)\n      ) {\n        // Both are objects — recurse\n        result[key] = mergeMessages(\n          existing as Record<string, unknown>,\n          value as Record<string, unknown>,\n        )\n      } else {\n        // Leaf or new key — last catalog wins\n        result[key] = value\n      }\n    }\n  }\n\n  return result\n}\n","/**\n * Build the i18n key for a select field option.\n *\n * Convention: `{Namespace}.{field}.{value}`\n *\n * @example\n * ```ts\n * optionKey('Ticketing', 'status', '0_open')\n * // → 'Ticketing.status.0_open'\n * ```\n */\nexport function optionKey(namespace: string, field: string, value: string): string {\n  return `${namespace}.${field}.${value}`\n}\n\n/**\n * Strip the numeric sort prefix from a select value.\n *\n * Values like `'0_open'`, `'2_high'` become `'open'`, `'high'`.\n * Values without a prefix are returned as-is.\n *\n * Useful as a display fallback when translations aren't available.\n *\n * @example\n * ```ts\n * stripPrefix('0_open')   // → 'open'\n * stripPrefix('hello')    // → 'hello'\n * stripPrefix('3_urgent') // → 'urgent'\n * ```\n */\nexport function stripPrefix(value: string): string {\n  return value.replace(/^\\d+_/, '')\n}\n"],"mappings":"AAgBA,SAAgB,EACd,EACA,EACsD,CACtD,IAAM,EAAW,GAAS,gBAAkB,KAE5C,OAAO,KAAO,IAAqD,CACjE,GAAI,CACF,OAAO,MAAM,EAAS,EAAO,MACvB,CAEN,GAAI,IAAW,EACb,GAAI,CACF,OAAO,MAAM,EAAS,EAAS,MACzB,CACN,MAAO,EAAE,CAGb,MAAO,EAAE,GCjBf,SAAgB,EACd,GAAG,EACsB,CACzB,IAAM,EAAkC,EAAE,CAE1C,IAAK,IAAM,KAAW,EACpB,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,EAAQ,CAAE,CAClD,IAAM,EAAW,EAAO,GAGtB,OAAO,GAAa,UADpB,GAEA,CAAC,MAAM,QAAQ,EAAS,EAExB,OAAO,GAAU,UADjB,GAEA,CAAC,MAAM,QAAQ,EAAM,CAGrB,EAAO,GAAO,EACZ,EACA,EACD,CAGD,EAAO,GAAO,EAKpB,OAAO,EClCT,SAAgB,EAAU,EAAmB,EAAe,EAAuB,CACjF,MAAO,GAAG,EAAU,GAAG,EAAM,GAAG,IAkBlC,SAAgB,EAAY,EAAuB,CACjD,OAAO,EAAM,QAAQ,QAAS,GAAG"}

package/dist/messages/en.json

@@ -0,0 +1,22 @@
+{
+  "Common": {
+    "save": "Save",
+    "cancel": "Cancel",
+    "delete": "Delete",
+    "confirm": "Confirm",
+    "close": "Close",
+    "create": "Create",
+    "edit": "Edit",
+    "search": "Search...",
+    "loading": "Loading...",
+    "noResults": "No results found",
+    "required": "Required",
+    "selected": "{count} selected",
+    "items": "{count, plural, one {# item} other {# items}}",
+    "yes": "Yes",
+    "no": "No",
+    "back": "Back",
+    "next": "Next",
+    "previous": "Previous"
+  }
+}

package/dist/messages/et.json

@@ -0,0 +1,22 @@
+{
+  "Common": {
+    "save": "Salvesta",
+    "cancel": "Tühista",
+    "delete": "Kustuta",
+    "confirm": "Kinnita",
+    "close": "Sulge",
+    "create": "Loo",
+    "edit": "Muuda",
+    "search": "Otsi...",
+    "loading": "Laadimine...",
+    "noResults": "Tulemusi ei leitud",
+    "required": "Kohustuslik",
+    "selected": "{count} valitud",
+    "items": "{count, plural, one {# kirje} other {# kirjet}}",
+    "yes": "Jah",
+    "no": "Ei",
+    "back": "Tagasi",
+    "next": "Edasi",
+    "previous": "Eelmine"
+  }
+}

package/dist/messages/ru.json

@@ -0,0 +1,22 @@
+{
+  "Common": {
+    "save": "Сохранить",
+    "cancel": "Отмена",
+    "delete": "Удалить",
+    "confirm": "Подтвердить",
+    "close": "Закрыть",
+    "create": "Создать",
+    "edit": "Редактировать",
+    "search": "Поиск...",
+    "loading": "Загрузка...",
+    "noResults": "Ничего не найдено",
+    "required": "Обязательно",
+    "selected": "{count} выбрано",
+    "items": "{count, plural, one {# элемент} few {# элемента} other {# элементов}}",
+    "yes": "Да",
+    "no": "Нет",
+    "back": "Назад",
+    "next": "Далее",
+    "previous": "Предыдущий"
+  }
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@murumets-ee/i18n",
+  "version": "0.3.0",
+  "license": "Elastic-2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown && cp -r src/messages dist/messages",
+    "dev": "tsdown --watch",
+    "test": "vitest"
+  },
+  "devDependencies": {
+    "tsdown": "^0.21.7",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  }
+}