@xxanderwp/translate-module 1.0.4 → 1.0.5

package/dist/index.d.ts

@@ -114,12 +114,12 @@ export declare class LanguageCore<T extends Record<string, Record<string, string
      * @param args - Zero or more values to interpolate into the translated string.
      *   Each value is coerced to a string and replaces the matching `{n}` token.
      *
-     * @returns The translated (and interpolated) string, or `null` if the resolved translation is an empty string.
+     * @returns The translated (and interpolated) string, or the key itself if the translation is missing.
      *
      * @example
      * lc.translate("greeting", "Alice");       // "Hello, Alice!"
      * lc.translate("score", "Alice", 42);      // "Alice scored 42 points."
      */
-    translate<K extends keyof T[LangKey]>(key: K, ...args: (string | number)[]): string | null;
+    translate<K extends keyof T[LangKey]>(key: K, ...args: (string | number)[]): string;
 }
 export default LanguageCore;

package/dist/index.js

@@ -149,7 +149,7 @@ class LanguageCore {
      * @param args - Zero or more values to interpolate into the translated string.
      *   Each value is coerced to a string and replaces the matching `{n}` token.
      *
-     * @returns The translated (and interpolated) string, or `null` if the resolved translation is an empty string.
+     * @returns The translated (and interpolated) string, or the key itself if the translation is missing.
      *
      * @example
      * lc.translate("greeting", "Alice");       // "Hello, Alice!"
@@ -161,7 +161,7 @@ class LanguageCore {
         args.forEach((arg, index) => {
             res = res.replace(new RegExp(`\\{${index}\\}`, "g"), String(arg));
         });
-        return res || null;
+        return res || String(key);
     }
 }
 exports.LanguageCore = LanguageCore;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xxanderwp/translate-module",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "",
   "main": "dist/index.js",
   "directories": {