@nextop-os/ui-i18n-runtime 0.0.3

package/README.md

@@ -0,0 +1,8 @@
+# @nextop-os/ui-i18n-runtime
+
+Host-agnostic i18n runtime helpers for shared Nextop frontend packages.
+
+This package is published to npm as `@nextop-os/ui-i18n-runtime`.
+
+Use it to compose reusable locale resources into one application-level runtime,
+then scope that runtime for shared package surfaces when needed.

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+type I18nPrimitive = string | number | boolean | null | undefined;
+type I18nParams = Record<string, I18nPrimitive>;
+type I18nDictionary = {
+    readonly [key: string]: string | I18nDictionary;
+};
+interface LocaleObjectI18nModuleManifest {
+    exportMode: "locale-object";
+    fileByLocale: Record<string, string>;
+    name: string;
+}
+interface ScopedLocaleObjectsI18nModuleManifest {
+    exportMode: "scoped-locale-objects";
+    localeObjectByLocale: Record<string, string>;
+    name: string;
+    namespace: string;
+    sourceRoot: string;
+}
+type I18nModuleManifest = LocaleObjectI18nModuleManifest | ScopedLocaleObjectsI18nModuleManifest;
+declare function createLocaleObjectI18nModuleManifest(input: {
+    fileByLocale: Record<string, string>;
+    name: string;
+}): LocaleObjectI18nModuleManifest;
+declare function createScopedLocaleObjectsI18nModuleManifest(input: {
+    localeObjectByLocale: Record<string, string>;
+    name: string;
+    namespace: string;
+    sourceRoot: string;
+}): ScopedLocaleObjectsI18nModuleManifest;
+interface I18nRuntime<TKey extends string = string> {
+    has(key: TKey): boolean;
+    t(key: TKey, params?: I18nParams): string;
+    tFirst(keys: readonly TKey[], params?: I18nParams): string;
+}
+declare function createI18nRuntime<TKey extends string = string>(input: {
+    dictionaries: readonly I18nDictionary[];
+}): I18nRuntime<TKey>;
+declare function createScopedI18nRuntime<TKey extends string = string>(runtime: I18nRuntime<string>, namespace: string): I18nRuntime<TKey>;
+
+export { type I18nDictionary, type I18nModuleManifest, type I18nParams, type I18nPrimitive, type I18nRuntime, type LocaleObjectI18nModuleManifest, type ScopedLocaleObjectsI18nModuleManifest, createI18nRuntime, createLocaleObjectI18nModuleManifest, createScopedI18nRuntime, createScopedLocaleObjectsI18nModuleManifest };

package/dist/index.js

@@ -0,0 +1,98 @@
+// src/index.ts
+function createLocaleObjectI18nModuleManifest(input) {
+  return {
+    exportMode: "locale-object",
+    fileByLocale: input.fileByLocale,
+    name: input.name
+  };
+}
+function createScopedLocaleObjectsI18nModuleManifest(input) {
+  return {
+    exportMode: "scoped-locale-objects",
+    localeObjectByLocale: input.localeObjectByLocale,
+    name: input.name,
+    namespace: input.namespace,
+    sourceRoot: input.sourceRoot
+  };
+}
+function createI18nRuntime(input) {
+  return {
+    has(key) {
+      return resolveI18nValue(input.dictionaries, key) !== null;
+    },
+    t(key, params) {
+      const resolved = resolveI18nValue(input.dictionaries, key);
+      if (resolved === null) {
+        return key;
+      }
+      return interpolateI18nTemplate(resolved, params);
+    },
+    tFirst(keys, params) {
+      for (const key of keys) {
+        const resolved = resolveI18nValue(input.dictionaries, key);
+        if (resolved !== null) {
+          return interpolateI18nTemplate(resolved, params);
+        }
+      }
+      return keys[0] ?? "";
+    }
+  };
+}
+function createScopedI18nRuntime(runtime, namespace) {
+  return {
+    has(key) {
+      return runtime.has(joinI18nKey(namespace, key));
+    },
+    t(key, params) {
+      return runtime.t(joinI18nKey(namespace, key), params);
+    },
+    tFirst(keys, params) {
+      return runtime.tFirst(
+        keys.map((key) => joinI18nKey(namespace, key)),
+        params
+      );
+    }
+  };
+}
+function joinI18nKey(namespace, key) {
+  return `${namespace}.${key}`;
+}
+function resolveI18nValue(dictionaries, key) {
+  for (const dictionary of dictionaries) {
+    const resolved = resolveDictionaryValue(dictionary, key);
+    if (resolved !== null) {
+      return resolved;
+    }
+  }
+  return null;
+}
+function resolveDictionaryValue(dictionary, key) {
+  const segments = key.split(".");
+  let current = dictionary;
+  for (const segment of segments) {
+    if (typeof current === "string" || !current) {
+      return null;
+    }
+    current = current[segment];
+  }
+  return typeof current === "string" ? current : null;
+}
+function interpolateI18nTemplate(template, params) {
+  if (!params) {
+    return template;
+  }
+  return template.replace(
+    /\{\{\s*([\w.]+)\s*\}\}/g,
+    (_match, key) => {
+      const value = params[key];
+      return value === null || value === void 0 ? "" : String(value);
+    }
+  );
+}
+export {
+  createI18nRuntime,
+  createLocaleObjectI18nModuleManifest,
+  createScopedI18nRuntime,
+  createScopedLocaleObjectsI18nModuleManifest
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type I18nPrimitive = string | number | boolean | null | undefined;\n\nexport type I18nParams = Record<string, I18nPrimitive>;\n\nexport type I18nDictionary = {\n  readonly [key: string]: string | I18nDictionary;\n};\n\nexport interface LocaleObjectI18nModuleManifest {\n  exportMode: \"locale-object\";\n  fileByLocale: Record<string, string>;\n  name: string;\n}\n\nexport interface ScopedLocaleObjectsI18nModuleManifest {\n  exportMode: \"scoped-locale-objects\";\n  localeObjectByLocale: Record<string, string>;\n  name: string;\n  namespace: string;\n  sourceRoot: string;\n}\n\nexport type I18nModuleManifest =\n  | LocaleObjectI18nModuleManifest\n  | ScopedLocaleObjectsI18nModuleManifest;\n\nexport function createLocaleObjectI18nModuleManifest(input: {\n  fileByLocale: Record<string, string>;\n  name: string;\n}): LocaleObjectI18nModuleManifest {\n  return {\n    exportMode: \"locale-object\",\n    fileByLocale: input.fileByLocale,\n    name: input.name\n  };\n}\n\nexport function createScopedLocaleObjectsI18nModuleManifest(input: {\n  localeObjectByLocale: Record<string, string>;\n  name: string;\n  namespace: string;\n  sourceRoot: string;\n}): ScopedLocaleObjectsI18nModuleManifest {\n  return {\n    exportMode: \"scoped-locale-objects\",\n    localeObjectByLocale: input.localeObjectByLocale,\n    name: input.name,\n    namespace: input.namespace,\n    sourceRoot: input.sourceRoot\n  };\n}\n\nexport interface I18nRuntime<TKey extends string = string> {\n  has(key: TKey): boolean;\n  t(key: TKey, params?: I18nParams): string;\n  tFirst(keys: readonly TKey[], params?: I18nParams): string;\n}\n\nexport function createI18nRuntime<TKey extends string = string>(input: {\n  dictionaries: readonly I18nDictionary[];\n}): I18nRuntime<TKey> {\n  return {\n    has(key) {\n      return resolveI18nValue(input.dictionaries, key) !== null;\n    },\n    t(key, params) {\n      const resolved = resolveI18nValue(input.dictionaries, key);\n      if (resolved === null) {\n        return key;\n      }\n\n      return interpolateI18nTemplate(resolved, params);\n    },\n    tFirst(keys, params) {\n      for (const key of keys) {\n        const resolved = resolveI18nValue(input.dictionaries, key);\n        if (resolved !== null) {\n          return interpolateI18nTemplate(resolved, params);\n        }\n      }\n\n      return keys[0] ?? \"\";\n    }\n  };\n}\n\nexport function createScopedI18nRuntime<TKey extends string = string>(\n  runtime: I18nRuntime<string>,\n  namespace: string\n): I18nRuntime<TKey> {\n  return {\n    has(key) {\n      return runtime.has(joinI18nKey(namespace, key));\n    },\n    t(key, params) {\n      return runtime.t(joinI18nKey(namespace, key), params);\n    },\n    tFirst(keys, params) {\n      return runtime.tFirst(\n        keys.map((key) => joinI18nKey(namespace, key)),\n        params\n      );\n    }\n  };\n}\n\nfunction joinI18nKey(namespace: string, key: string): string {\n  return `${namespace}.${key}`;\n}\n\nfunction resolveI18nValue(\n  dictionaries: readonly I18nDictionary[],\n  key: string\n): string | null {\n  for (const dictionary of dictionaries) {\n    const resolved = resolveDictionaryValue(dictionary, key);\n    if (resolved !== null) {\n      return resolved;\n    }\n  }\n\n  return null;\n}\n\nfunction resolveDictionaryValue(\n  dictionary: I18nDictionary,\n  key: string\n): string | null {\n  const segments = key.split(\".\");\n  let current: string | I18nDictionary | undefined = dictionary;\n\n  for (const segment of segments) {\n    if (typeof current === \"string\" || !current) {\n      return null;\n    }\n    current = current[segment];\n  }\n\n  return typeof current === \"string\" ? current : null;\n}\n\nfunction interpolateI18nTemplate(\n  template: string,\n  params: I18nParams | undefined\n): string {\n  if (!params) {\n    return template;\n  }\n\n  return template.replace(\n    /\\{\\{\\s*([\\w.]+)\\s*\\}\\}/g,\n    (_match: string, key: string) => {\n      const value = params[key];\n      return value === null || value === undefined ? \"\" : String(value);\n    }\n  );\n}\n"],"mappings":";AA0BO,SAAS,qCAAqC,OAGlB;AACjC,SAAO;AAAA,IACL,YAAY;AAAA,IACZ,cAAc,MAAM;AAAA,IACpB,MAAM,MAAM;AAAA,EACd;AACF;AAEO,SAAS,4CAA4C,OAKlB;AACxC,SAAO;AAAA,IACL,YAAY;AAAA,IACZ,sBAAsB,MAAM;AAAA,IAC5B,MAAM,MAAM;AAAA,IACZ,WAAW,MAAM;AAAA,IACjB,YAAY,MAAM;AAAA,EACpB;AACF;AAQO,SAAS,kBAAgD,OAE1C;AACpB,SAAO;AAAA,IACL,IAAI,KAAK;AACP,aAAO,iBAAiB,MAAM,cAAc,GAAG,MAAM;AAAA,IACvD;AAAA,IACA,EAAE,KAAK,QAAQ;AACb,YAAM,WAAW,iBAAiB,MAAM,cAAc,GAAG;AACzD,UAAI,aAAa,MAAM;AACrB,eAAO;AAAA,MACT;AAEA,aAAO,wBAAwB,UAAU,MAAM;AAAA,IACjD;AAAA,IACA,OAAO,MAAM,QAAQ;AACnB,iBAAW,OAAO,MAAM;AACtB,cAAM,WAAW,iBAAiB,MAAM,cAAc,GAAG;AACzD,YAAI,aAAa,MAAM;AACrB,iBAAO,wBAAwB,UAAU,MAAM;AAAA,QACjD;AAAA,MACF;AAEA,aAAO,KAAK,CAAC,KAAK;AAAA,IACpB;AAAA,EACF;AACF;AAEO,SAAS,wBACd,SACA,WACmB;AACnB,SAAO;AAAA,IACL,IAAI,KAAK;AACP,aAAO,QAAQ,IAAI,YAAY,WAAW,GAAG,CAAC;AAAA,IAChD;AAAA,IACA,EAAE,KAAK,QAAQ;AACb,aAAO,QAAQ,EAAE,YAAY,WAAW,GAAG,GAAG,MAAM;AAAA,IACtD;AAAA,IACA,OAAO,MAAM,QAAQ;AACnB,aAAO,QAAQ;AAAA,QACb,KAAK,IAAI,CAAC,QAAQ,YAAY,WAAW,GAAG,CAAC;AAAA,QAC7C;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,YAAY,WAAmB,KAAqB;AAC3D,SAAO,GAAG,SAAS,IAAI,GAAG;AAC5B;AAEA,SAAS,iBACP,cACA,KACe;AACf,aAAW,cAAc,cAAc;AACrC,UAAM,WAAW,uBAAuB,YAAY,GAAG;AACvD,QAAI,aAAa,MAAM;AACrB,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,uBACP,YACA,KACe;AACf,QAAM,WAAW,IAAI,MAAM,GAAG;AAC9B,MAAI,UAA+C;AAEnD,aAAW,WAAW,UAAU;AAC9B,QAAI,OAAO,YAAY,YAAY,CAAC,SAAS;AAC3C,aAAO;AAAA,IACT;AACA,cAAU,QAAQ,OAAO;AAAA,EAC3B;AAEA,SAAO,OAAO,YAAY,WAAW,UAAU;AACjD;AAEA,SAAS,wBACP,UACA,QACQ;AACR,MAAI,CAAC,QAAQ;AACX,WAAO;AAAA,EACT;AAEA,SAAO,SAAS;AAAA,IACd;AAAA,IACA,CAAC,QAAgB,QAAgB;AAC/B,YAAM,QAAQ,OAAO,GAAG;AACxB,aAAO,UAAU,QAAQ,UAAU,SAAY,KAAK,OAAO,KAAK;AAAA,IAClE;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@nextop-os/ui-i18n-runtime",
+  "version": "0.0.3",
+  "private": false,
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nextop-os/nextop.git",
+    "directory": "packages/ui/i18n-runtime"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "@nextop-os/config-tsconfig": "0.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
+}