@case-framework/ui-localization 0.2.0

package/dist/index.d.mts

@@ -0,0 +1,25 @@
+//#region src/index.d.ts
+type LocalizationPrimitive = string | number | boolean | null | undefined;
+type LocalizationValues = Record<string, LocalizationPrimitive>;
+interface LocalizationMessages {
+  [key: string]: string | LocalizationMessages;
+}
+type LocalizationCatalog = Record<string, LocalizationMessages>;
+type LocalizationTranslate = (key: string, values?: LocalizationValues) => string;
+declare const normalizeLocalizationLocale: (locale: string) => string;
+declare const mergeLocalizationCatalogs: (defaults: LocalizationCatalog, ...sources: Array<LocalizationCatalog | undefined>) => LocalizationCatalog;
+declare const createLocalizationTranslator: ({
+  fallbackLocale,
+  locale,
+  localizations,
+  onMissing
+}: {
+  fallbackLocale: string;
+  locale: string;
+  localizations: LocalizationCatalog;
+  onMissing?: (key: string, locale: string) => void;
+}) => LocalizationTranslate;
+declare const createNamespacedLocalizationTranslator: (translate: LocalizationTranslate, namespace?: string) => LocalizationTranslate;
+//#endregion
+export { LocalizationCatalog, LocalizationMessages, LocalizationPrimitive, LocalizationTranslate, LocalizationValues, createLocalizationTranslator, createNamespacedLocalizationTranslator, mergeLocalizationCatalogs, normalizeLocalizationLocale };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";KAAY,qBAAA;AAAA,KAEA,kBAAA,GAAqB,MAAA,SAAe,qBAAA;AAAA,UAE/B,oBAAA;EAAA,CACd,GAAA,oBAAuB,oBAAA;AAAA;AAAA,KAGd,mBAAA,GAAsB,MAAA,SAAe,oBAAA;AAAA,KAErC,qBAAA,IAAyB,GAAA,UAAa,MAAA,GAAS,kBAAA;AAAA,cA0C9C,2BAAA,GAA+B,MAAA;AAAA,cAG/B,yBAAA,GACX,QAAA,EAAU,mBAAA,KACP,OAAA,EAAS,KAAA,CAAM,mBAAA,kBACjB,mBAAA;AAAA,cA2DU,4BAAA;EAAgC,cAAA;EAAA,MAAA;EAAA,aAAA;EAAA;AAAA;EAM3C,cAAA;EACA,MAAA;EACA,aAAA,EAAe,mBAAA;EACf,SAAA,IAAa,GAAA,UAAa,MAAA;AAAA,MACxB,qBAAA;AAAA,cAYS,sCAAA,GACX,SAAA,EAAW,qBAAA,EACX,SAAA,cACC,qBAAA"}

package/dist/index.mjs

@@ -0,0 +1,78 @@
+//#region src/index.ts
+const isPlainObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const cloneMessages = (messages) => {
+	const clone = {};
+	for (const [key, value] of Object.entries(messages)) clone[key] = isPlainObject(value) ? cloneMessages(value) : value;
+	return clone;
+};
+const mergeMessages = (base, override) => {
+	const result = cloneMessages(base);
+	for (const [key, overrideValue] of Object.entries(override)) {
+		const baseValue = result[key];
+		if (isPlainObject(baseValue) && isPlainObject(overrideValue)) {
+			result[key] = mergeMessages(baseValue, overrideValue);
+			continue;
+		}
+		result[key] = isPlainObject(overrideValue) ? cloneMessages(overrideValue) : overrideValue;
+	}
+	return result;
+};
+const normalizeLocalizationLocale = (locale) => locale.trim().replaceAll("_", "-").toLowerCase();
+const mergeLocalizationCatalogs = (defaults, ...sources) => {
+	const merged = {};
+	for (const source of [defaults, ...sources]) {
+		if (!source) continue;
+		for (const [locale, messages] of Object.entries(source)) {
+			const normalizedLocale = normalizeLocalizationLocale(locale);
+			if (!normalizedLocale) continue;
+			const existingMessages = merged[normalizedLocale];
+			merged[normalizedLocale] = existingMessages ? mergeMessages(existingMessages, messages) : cloneMessages(messages);
+		}
+	}
+	return merged;
+};
+const resolveLocaleCandidates = (locale, fallbackLocale) => {
+	const normalizedFallbackLocale = normalizeLocalizationLocale(fallbackLocale) || normalizeLocalizationLocale("en");
+	const normalizedLocale = normalizeLocalizationLocale(locale) || normalizedFallbackLocale;
+	return Array.from(new Set([
+		normalizedLocale,
+		normalizedLocale.split("-")[0],
+		normalizedFallbackLocale,
+		normalizedFallbackLocale.split("-")[0]
+	]));
+};
+const getNestedMessage = (messages, path) => {
+	if (!messages) return void 0;
+	let current = messages;
+	for (const segment of path.split(".")) {
+		if (!isPlainObject(current) || !(segment in current)) return void 0;
+		current = current[segment];
+	}
+	return typeof current === "string" ? current : void 0;
+};
+const interpolateMessage = (message, values) => {
+	if (!values) return message;
+	return message.replace(/\{([a-zA-Z0-9_]+)\}/g, (_match, token) => {
+		const value = values[token];
+		return value === void 0 || value === null ? `{${token}}` : String(value);
+	});
+};
+const createLocalizationTranslator = ({ fallbackLocale, locale, localizations, onMissing }) => {
+	return (key, values) => {
+		for (const localeCandidate of resolveLocaleCandidates(locale, fallbackLocale)) {
+			const localizedMessage = getNestedMessage(localizations[localeCandidate], key);
+			if (localizedMessage !== void 0) return interpolateMessage(localizedMessage, values);
+		}
+		onMissing?.(key, locale);
+		return key;
+	};
+};
+const createNamespacedLocalizationTranslator = (translate, namespace) => {
+	const normalizedNamespace = namespace?.trim();
+	if (!normalizedNamespace) return translate;
+	return (key, values) => translate(`${normalizedNamespace}.${key}`, values);
+};
+//#endregion
+export { createLocalizationTranslator, createNamespacedLocalizationTranslator, mergeLocalizationCatalogs, normalizeLocalizationLocale };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["export type LocalizationPrimitive = string | number | boolean | null | undefined;\n\nexport type LocalizationValues = Record<string, LocalizationPrimitive>;\n\nexport interface LocalizationMessages {\n  [key: string]: string | LocalizationMessages;\n}\n\nexport type LocalizationCatalog = Record<string, LocalizationMessages>;\n\nexport type LocalizationTranslate = (key: string, values?: LocalizationValues) => string;\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  value !== null && typeof value === \"object\" && !Array.isArray(value);\n\nconst cloneMessages = (messages: LocalizationMessages): LocalizationMessages => {\n  const clone: LocalizationMessages = {};\n\n  for (const [key, value] of Object.entries(messages)) {\n    clone[key] = isPlainObject(value)\n      ? cloneMessages(value as LocalizationMessages)\n      : (value as string);\n  }\n\n  return clone;\n};\n\nconst mergeMessages = (\n  base: LocalizationMessages,\n  override: LocalizationMessages,\n): LocalizationMessages => {\n  const result = cloneMessages(base);\n\n  for (const [key, overrideValue] of Object.entries(override)) {\n    const baseValue = result[key];\n\n    if (isPlainObject(baseValue) && isPlainObject(overrideValue)) {\n      result[key] = mergeMessages(\n        baseValue as LocalizationMessages,\n        overrideValue as LocalizationMessages,\n      );\n      continue;\n    }\n\n    result[key] = isPlainObject(overrideValue)\n      ? cloneMessages(overrideValue as LocalizationMessages)\n      : (overrideValue as string);\n  }\n\n  return result;\n};\n\nexport const normalizeLocalizationLocale = (locale: string): string =>\n  locale.trim().replaceAll(\"_\", \"-\").toLowerCase();\n\nexport const mergeLocalizationCatalogs = (\n  defaults: LocalizationCatalog,\n  ...sources: Array<LocalizationCatalog | undefined>\n): LocalizationCatalog => {\n  const merged: LocalizationCatalog = {};\n\n  for (const source of [defaults, ...sources]) {\n    if (!source) continue;\n\n    for (const [locale, messages] of Object.entries(source)) {\n      const normalizedLocale = normalizeLocalizationLocale(locale);\n      if (!normalizedLocale) continue;\n\n      const existingMessages = merged[normalizedLocale];\n      merged[normalizedLocale] = existingMessages\n        ? mergeMessages(existingMessages, messages)\n        : cloneMessages(messages);\n    }\n  }\n\n  return merged;\n};\n\nconst resolveLocaleCandidates = (locale: string, fallbackLocale: string): string[] => {\n  const normalizedFallbackLocale =\n    normalizeLocalizationLocale(fallbackLocale) || normalizeLocalizationLocale(\"en\");\n  const normalizedLocale = normalizeLocalizationLocale(locale) || normalizedFallbackLocale;\n\n  return Array.from(\n    new Set([\n      normalizedLocale,\n      normalizedLocale.split(\"-\")[0],\n      normalizedFallbackLocale,\n      normalizedFallbackLocale.split(\"-\")[0],\n    ]),\n  );\n};\n\nconst getNestedMessage = (\n  messages: LocalizationMessages | undefined,\n  path: string,\n): string | undefined => {\n  if (!messages) return undefined;\n\n  let current: string | LocalizationMessages | undefined = messages;\n  for (const segment of path.split(\".\")) {\n    if (!isPlainObject(current) || !(segment in current)) return undefined;\n    current = current[segment] as string | LocalizationMessages;\n  }\n\n  return typeof current === \"string\" ? current : undefined;\n};\n\nconst interpolateMessage = (message: string, values?: LocalizationValues): string => {\n  if (!values) return message;\n\n  return message.replace(/\\{([a-zA-Z0-9_]+)\\}/g, (_match, token: string) => {\n    const value = values[token];\n    return value === undefined || value === null ? `{${token}}` : String(value);\n  });\n};\n\nexport const createLocalizationTranslator = ({\n  fallbackLocale,\n  locale,\n  localizations,\n  onMissing,\n}: {\n  fallbackLocale: string;\n  locale: string;\n  localizations: LocalizationCatalog;\n  onMissing?: (key: string, locale: string) => void;\n}): LocalizationTranslate => {\n  return (key, values) => {\n    for (const localeCandidate of resolveLocaleCandidates(locale, fallbackLocale)) {\n      const localizedMessage = getNestedMessage(localizations[localeCandidate], key);\n      if (localizedMessage !== undefined) return interpolateMessage(localizedMessage, values);\n    }\n\n    onMissing?.(key, locale);\n    return key;\n  };\n};\n\nexport const createNamespacedLocalizationTranslator = (\n  translate: LocalizationTranslate,\n  namespace?: string,\n): LocalizationTranslate => {\n  const normalizedNamespace = namespace?.trim();\n  if (!normalizedNamespace) return translate;\n\n  return (key, values) => translate(`${normalizedNamespace}.${key}`, values);\n};\n"],"mappings":";AAYA,MAAM,iBAAiB,UACrB,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,MAAM;AAEtE,MAAM,iBAAiB,aAAyD;CAC9E,MAAM,QAA8B,EAAE;AAEtC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,CACjD,OAAM,OAAO,cAAc,MAAM,GAC7B,cAAc,MAA8B,GAC3C;AAGP,QAAO;;AAGT,MAAM,iBACJ,MACA,aACyB;CACzB,MAAM,SAAS,cAAc,KAAK;AAElC,MAAK,MAAM,CAAC,KAAK,kBAAkB,OAAO,QAAQ,SAAS,EAAE;EAC3D,MAAM,YAAY,OAAO;AAEzB,MAAI,cAAc,UAAU,IAAI,cAAc,cAAc,EAAE;AAC5D,UAAO,OAAO,cACZ,WACA,cACD;AACD;;AAGF,SAAO,OAAO,cAAc,cAAc,GACtC,cAAc,cAAsC,GACnD;;AAGP,QAAO;;AAGT,MAAa,+BAA+B,WAC1C,OAAO,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC,aAAa;AAElD,MAAa,6BACX,UACA,GAAG,YACqB;CACxB,MAAM,SAA8B,EAAE;AAEtC,MAAK,MAAM,UAAU,CAAC,UAAU,GAAG,QAAQ,EAAE;AAC3C,MAAI,CAAC,OAAQ;AAEb,OAAK,MAAM,CAAC,QAAQ,aAAa,OAAO,QAAQ,OAAO,EAAE;GACvD,MAAM,mBAAmB,4BAA4B,OAAO;AAC5D,OAAI,CAAC,iBAAkB;GAEvB,MAAM,mBAAmB,OAAO;AAChC,UAAO,oBAAoB,mBACvB,cAAc,kBAAkB,SAAS,GACzC,cAAc,SAAS;;;AAI/B,QAAO;;AAGT,MAAM,2BAA2B,QAAgB,mBAAqC;CACpF,MAAM,2BACJ,4BAA4B,eAAe,IAAI,4BAA4B,KAAK;CAClF,MAAM,mBAAmB,4BAA4B,OAAO,IAAI;AAEhE,QAAO,MAAM,KACX,IAAI,IAAI;EACN;EACA,iBAAiB,MAAM,IAAI,CAAC;EAC5B;EACA,yBAAyB,MAAM,IAAI,CAAC;EACrC,CAAC,CACH;;AAGH,MAAM,oBACJ,UACA,SACuB;AACvB,KAAI,CAAC,SAAU,QAAO,KAAA;CAEtB,IAAI,UAAqD;AACzD,MAAK,MAAM,WAAW,KAAK,MAAM,IAAI,EAAE;AACrC,MAAI,CAAC,cAAc,QAAQ,IAAI,EAAE,WAAW,SAAU,QAAO,KAAA;AAC7D,YAAU,QAAQ;;AAGpB,QAAO,OAAO,YAAY,WAAW,UAAU,KAAA;;AAGjD,MAAM,sBAAsB,SAAiB,WAAwC;AACnF,KAAI,CAAC,OAAQ,QAAO;AAEpB,QAAO,QAAQ,QAAQ,yBAAyB,QAAQ,UAAkB;EACxE,MAAM,QAAQ,OAAO;AACrB,SAAO,UAAU,KAAA,KAAa,UAAU,OAAO,IAAI,MAAM,KAAK,OAAO,MAAM;GAC3E;;AAGJ,MAAa,gCAAgC,EAC3C,gBACA,QACA,eACA,gBAM2B;AAC3B,SAAQ,KAAK,WAAW;AACtB,OAAK,MAAM,mBAAmB,wBAAwB,QAAQ,eAAe,EAAE;GAC7E,MAAM,mBAAmB,iBAAiB,cAAc,kBAAkB,IAAI;AAC9E,OAAI,qBAAqB,KAAA,EAAW,QAAO,mBAAmB,kBAAkB,OAAO;;AAGzF,cAAY,KAAK,OAAO;AACxB,SAAO;;;AAIX,MAAa,0CACX,WACA,cAC0B;CAC1B,MAAM,sBAAsB,WAAW,MAAM;AAC7C,KAAI,CAAC,oBAAqB,QAAO;AAEjC,SAAQ,KAAK,WAAW,UAAU,GAAG,oBAAoB,GAAG,OAAO,OAAO"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@case-framework/ui-localization",
+  "version": "0.2.0",
+  "description": "Shared UI localization primitives for CASE Framework packages.",
+  "license": "ISC",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "devDependencies": {
+    "@jest/globals": "30.3.0",
+    "@types/jest": "30.0.0",
+    "jest": "30.3.0",
+    "ts-jest": "29.4.9",
+    "tsdown": "0.21.10",
+    "typescript": "6.0.3"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "jest --config jest.config.cjs --runInBand",
+    "check": "pnpm typecheck && pnpm build && pnpm test"
+  }
+}