@nckdv/translation-core 0.1.0

package/dist/index.cjs

@@ -0,0 +1,33 @@
+'use strict';
+
+// src/interpolate.ts
+var PLACEHOLDER = /\{(\w+)\}/g;
+function interpolate(template, values) {
+  if (!values) return template;
+  return template.replace(PLACEHOLDER, (match, token) => {
+    const value = values[token];
+    return value === void 0 ? match : String(value);
+  });
+}
+
+// src/translator.ts
+function createTranslator(options) {
+  const {
+    language,
+    messages,
+    fallback = {},
+    onMissingKey = (key) => key
+  } = options;
+  return function t(key, values) {
+    const template = messages[key] ?? fallback[key];
+    if (template === void 0) {
+      return onMissingKey(key, language);
+    }
+    return interpolate(template, values);
+  };
+}
+
+exports.createTranslator = createTranslator;
+exports.interpolate = interpolate;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/interpolate.ts","../src/translator.ts"],"names":[],"mappings":";;;AAEA,IAAM,WAAA,GAAc,YAAA;AASb,SAAS,WAAA,CACd,UACA,MAAA,EACQ;AACR,EAAA,IAAI,CAAC,QAAQ,OAAO,QAAA;AAEpB,EAAA,OAAO,QAAA,CAAS,OAAA,CAAQ,WAAA,EAAa,CAAC,OAAO,KAAA,KAAkB;AAC7D,IAAA,MAAM,KAAA,GAAQ,OAAO,KAAK,CAAA;AAC1B,IAAA,OAAO,KAAA,KAAU,MAAA,GAAY,KAAA,GAAQ,MAAA,CAAO,KAAK,CAAA;AAAA,EACnD,CAAC,CAAA;AACH;;;ACNO,SAAS,iBAAiB,OAAA,EAAyC;AACxE,EAAA,MAAM;AAAA,IACJ,QAAA;AAAA,IACA,QAAA;AAAA,IACA,WAAW,EAAC;AAAA,IACZ,YAAA,GAAe,CAAC,GAAA,KAAQ;AAAA,GAC1B,GAAI,OAAA;AAEJ,EAAA,OAAO,SAAS,CAAA,CAAE,GAAA,EAAK,MAAA,EAAQ;AAC7B,IAAA,MAAM,QAAA,GAAW,QAAA,CAAS,GAAG,CAAA,IAAK,SAAS,GAAG,CAAA;AAE9C,IAAA,IAAI,aAAa,MAAA,EAAW;AAC1B,MAAA,OAAO,YAAA,CAAa,KAAK,QAAQ,CAAA;AAAA,IACnC;AAEA,IAAA,OAAO,WAAA,CAAY,UAAU,MAAM,CAAA;AAAA,EACrC,CAAA;AACF","file":"index.cjs","sourcesContent":["import type { InterpolationValues } from \"./types.js\";\n\nconst PLACEHOLDER = /\\{(\\w+)\\}/g;\n\n/**\n * Replaces `{name}` placeholders in `template` with values from `values`.\n * Unknown placeholders are left untouched so they surface during development.\n *\n * @example\n * interpolate(\"Hello {name}\", { name: \"World\" }) // \"Hello World\"\n */\nexport function interpolate(\n  template: string,\n  values?: InterpolationValues,\n): string {\n  if (!values) return template;\n\n  return template.replace(PLACEHOLDER, (match, token: string) => {\n    const value = values[token];\n    return value === undefined ? match : String(value);\n  });\n}\n","import { interpolate } from \"./interpolate.js\";\nimport type { TranslateFn, TranslatorOptions } from \"./types.js\";\n\n/**\n * Creates a `t()` function bound to a language and its message map.\n *\n * Lookup order for a key:\n *   1. `messages` (active language)\n *   2. `fallback` (default language), if provided\n *   3. `onMissingKey` result (defaults to the key itself)\n *\n * The engine is deliberately framework-agnostic and does no I/O — callers\n * supply already-loaded messages. This keeps the SDK boundary clean so the\n * same engine works on the server, in the browser, and in any framework.\n */\nexport function createTranslator(options: TranslatorOptions): TranslateFn {\n  const {\n    language,\n    messages,\n    fallback = {},\n    onMissingKey = (key) => key,\n  } = options;\n\n  return function t(key, values) {\n    const template = messages[key] ?? fallback[key];\n\n    if (template === undefined) {\n      return onMissingKey(key, language);\n    }\n\n    return interpolate(template, values);\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,52 @@
+/** A single translated string, e.g. "Willkommen". */
+type TranslationValue = string;
+/**
+ * A flat map of translation keys to their translated values for one language.
+ * Keys are dot-namespaced by convention, e.g. "home.title".
+ */
+type TranslationMap = Record<string, TranslationValue>;
+/** Values injected into `{placeholder}` slots during interpolation. */
+type InterpolationValues = Record<string, string | number>;
+interface TranslatorOptions {
+    /** The active language code, e.g. "de". */
+    language: string;
+    /** Translations for the active language. */
+    messages: TranslationMap;
+    /**
+     * Optional fallback translations, consulted when a key is missing from
+     * `messages`. Typically the default language (e.g. English).
+     */
+    fallback?: TranslationMap;
+    /**
+     * Called when a key is found in neither `messages` nor `fallback`.
+     * Defaults to returning the key itself.
+     */
+    onMissingKey?: (key: string, language: string) => string;
+}
+/** Looks up and interpolates a translation by key. */
+type TranslateFn = (key: string, values?: InterpolationValues) => string;
+
+/**
+ * Creates a `t()` function bound to a language and its message map.
+ *
+ * Lookup order for a key:
+ *   1. `messages` (active language)
+ *   2. `fallback` (default language), if provided
+ *   3. `onMissingKey` result (defaults to the key itself)
+ *
+ * The engine is deliberately framework-agnostic and does no I/O — callers
+ * supply already-loaded messages. This keeps the SDK boundary clean so the
+ * same engine works on the server, in the browser, and in any framework.
+ */
+declare function createTranslator(options: TranslatorOptions): TranslateFn;
+
+/**
+ * Replaces `{name}` placeholders in `template` with values from `values`.
+ * Unknown placeholders are left untouched so they surface during development.
+ *
+ * @example
+ * interpolate("Hello {name}", { name: "World" }) // "Hello World"
+ */
+declare function interpolate(template: string, values?: InterpolationValues): string;
+
+export { type InterpolationValues, type TranslateFn, type TranslationMap, type TranslationValue, type TranslatorOptions, createTranslator, interpolate };

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+/** A single translated string, e.g. "Willkommen". */
+type TranslationValue = string;
+/**
+ * A flat map of translation keys to their translated values for one language.
+ * Keys are dot-namespaced by convention, e.g. "home.title".
+ */
+type TranslationMap = Record<string, TranslationValue>;
+/** Values injected into `{placeholder}` slots during interpolation. */
+type InterpolationValues = Record<string, string | number>;
+interface TranslatorOptions {
+    /** The active language code, e.g. "de". */
+    language: string;
+    /** Translations for the active language. */
+    messages: TranslationMap;
+    /**
+     * Optional fallback translations, consulted when a key is missing from
+     * `messages`. Typically the default language (e.g. English).
+     */
+    fallback?: TranslationMap;
+    /**
+     * Called when a key is found in neither `messages` nor `fallback`.
+     * Defaults to returning the key itself.
+     */
+    onMissingKey?: (key: string, language: string) => string;
+}
+/** Looks up and interpolates a translation by key. */
+type TranslateFn = (key: string, values?: InterpolationValues) => string;
+
+/**
+ * Creates a `t()` function bound to a language and its message map.
+ *
+ * Lookup order for a key:
+ *   1. `messages` (active language)
+ *   2. `fallback` (default language), if provided
+ *   3. `onMissingKey` result (defaults to the key itself)
+ *
+ * The engine is deliberately framework-agnostic and does no I/O — callers
+ * supply already-loaded messages. This keeps the SDK boundary clean so the
+ * same engine works on the server, in the browser, and in any framework.
+ */
+declare function createTranslator(options: TranslatorOptions): TranslateFn;
+
+/**
+ * Replaces `{name}` placeholders in `template` with values from `values`.
+ * Unknown placeholders are left untouched so they surface during development.
+ *
+ * @example
+ * interpolate("Hello {name}", { name: "World" }) // "Hello World"
+ */
+declare function interpolate(template: string, values?: InterpolationValues): string;
+
+export { type InterpolationValues, type TranslateFn, type TranslationMap, type TranslationValue, type TranslatorOptions, createTranslator, interpolate };

package/dist/index.js

@@ -0,0 +1,30 @@
+// src/interpolate.ts
+var PLACEHOLDER = /\{(\w+)\}/g;
+function interpolate(template, values) {
+  if (!values) return template;
+  return template.replace(PLACEHOLDER, (match, token) => {
+    const value = values[token];
+    return value === void 0 ? match : String(value);
+  });
+}
+
+// src/translator.ts
+function createTranslator(options) {
+  const {
+    language,
+    messages,
+    fallback = {},
+    onMissingKey = (key) => key
+  } = options;
+  return function t(key, values) {
+    const template = messages[key] ?? fallback[key];
+    if (template === void 0) {
+      return onMissingKey(key, language);
+    }
+    return interpolate(template, values);
+  };
+}
+
+export { createTranslator, interpolate };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/interpolate.ts","../src/translator.ts"],"names":[],"mappings":";AAEA,IAAM,WAAA,GAAc,YAAA;AASb,SAAS,WAAA,CACd,UACA,MAAA,EACQ;AACR,EAAA,IAAI,CAAC,QAAQ,OAAO,QAAA;AAEpB,EAAA,OAAO,QAAA,CAAS,OAAA,CAAQ,WAAA,EAAa,CAAC,OAAO,KAAA,KAAkB;AAC7D,IAAA,MAAM,KAAA,GAAQ,OAAO,KAAK,CAAA;AAC1B,IAAA,OAAO,KAAA,KAAU,MAAA,GAAY,KAAA,GAAQ,MAAA,CAAO,KAAK,CAAA;AAAA,EACnD,CAAC,CAAA;AACH;;;ACNO,SAAS,iBAAiB,OAAA,EAAyC;AACxE,EAAA,MAAM;AAAA,IACJ,QAAA;AAAA,IACA,QAAA;AAAA,IACA,WAAW,EAAC;AAAA,IACZ,YAAA,GAAe,CAAC,GAAA,KAAQ;AAAA,GAC1B,GAAI,OAAA;AAEJ,EAAA,OAAO,SAAS,CAAA,CAAE,GAAA,EAAK,MAAA,EAAQ;AAC7B,IAAA,MAAM,QAAA,GAAW,QAAA,CAAS,GAAG,CAAA,IAAK,SAAS,GAAG,CAAA;AAE9C,IAAA,IAAI,aAAa,MAAA,EAAW;AAC1B,MAAA,OAAO,YAAA,CAAa,KAAK,QAAQ,CAAA;AAAA,IACnC;AAEA,IAAA,OAAO,WAAA,CAAY,UAAU,MAAM,CAAA;AAAA,EACrC,CAAA;AACF","file":"index.js","sourcesContent":["import type { InterpolationValues } from \"./types.js\";\n\nconst PLACEHOLDER = /\\{(\\w+)\\}/g;\n\n/**\n * Replaces `{name}` placeholders in `template` with values from `values`.\n * Unknown placeholders are left untouched so they surface during development.\n *\n * @example\n * interpolate(\"Hello {name}\", { name: \"World\" }) // \"Hello World\"\n */\nexport function interpolate(\n  template: string,\n  values?: InterpolationValues,\n): string {\n  if (!values) return template;\n\n  return template.replace(PLACEHOLDER, (match, token: string) => {\n    const value = values[token];\n    return value === undefined ? match : String(value);\n  });\n}\n","import { interpolate } from \"./interpolate.js\";\nimport type { TranslateFn, TranslatorOptions } from \"./types.js\";\n\n/**\n * Creates a `t()` function bound to a language and its message map.\n *\n * Lookup order for a key:\n *   1. `messages` (active language)\n *   2. `fallback` (default language), if provided\n *   3. `onMissingKey` result (defaults to the key itself)\n *\n * The engine is deliberately framework-agnostic and does no I/O — callers\n * supply already-loaded messages. This keeps the SDK boundary clean so the\n * same engine works on the server, in the browser, and in any framework.\n */\nexport function createTranslator(options: TranslatorOptions): TranslateFn {\n  const {\n    language,\n    messages,\n    fallback = {},\n    onMissingKey = (key) => key,\n  } = options;\n\n  return function t(key, values) {\n    const template = messages[key] ?? fallback[key];\n\n    if (template === undefined) {\n      return onMissingKey(key, language);\n    }\n\n    return interpolate(template, values);\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@nckdv/translation-core",
+  "version": "0.1.0",
+  "description": "Framework-agnostic translation engine: lookup, fallback, interpolation.",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NiklasErath/nck-translation.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/NiklasErath/nck-translation#readme",
+  "keywords": [
+    "i18n",
+    "translation",
+    "internationalization",
+    "localization"
+  ]
+}