locl-js 1.0.0 → 1.0.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Sztrida Sámuel
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Sztrida Sámuel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.mts

@@ -49,7 +49,7 @@ declare const defaultFormatters: {
      * @param {string} [args[1]="..."] - The suffix to append if the string is truncated.
      * @returns The truncated string.
      */
-    truncate: (val: any, args: string[]) => string;
+    truncate: (val: any, args?: string[]) => string;
     /**
      * Formats a number using `Intl.NumberFormat`.
      * @param val - The value to format.
@@ -58,7 +58,7 @@ declare const defaultFormatters: {
      * @param {string} [args[1]] - The style of formatting to use (e.g., "decimal", "percent").
      * @returns The formatted number.
      */
-    number: (val: any, args: string[]) => string;
+    number: (val: any, args?: string[]) => string;
     /**
      * Formats a number as a currency string using `Intl.NumberFormat`.
      * @param val - The value to format.
@@ -67,7 +67,7 @@ declare const defaultFormatters: {
      * @param {string} [args[1]] - The locale to use.
      * @returns The formatted currency string.
      */
-    currency: (val: any, args: string[]) => string;
+    currency: (val: any, args?: string[]) => string;
     /**
      * Formats a date using `Intl.DateTimeFormat`.
      * @param val - The value to format.
@@ -76,7 +76,7 @@ declare const defaultFormatters: {
      * @param {string} [args[1]] - The date style to use (e.g., "short", "long").
      * @returns The formatted date string.
      */
-    date: (val: any, args: string[]) => string;
+    date: (val: any, args?: string[]) => string;
     /**
      * Formats a date as a relative time string (e.g., "2 hours ago").
      * @param val - The value to format.
@@ -84,7 +84,7 @@ declare const defaultFormatters: {
      * @param {string} [args[0]] - The locale to use.
      * @returns The relative time string.
      */
-    relativeDate: (val: any, args: string[]) => string;
+    relativeDate: (val: any, args?: string[]) => string;
     /**
      * Converts a value to a JSON string.
      * @param val - The value to format.
@@ -99,7 +99,7 @@ declare const defaultFormatters: {
      * @param {string} [args[1]="No"] - The string to return for a falsy value.
      * @returns "Yes" or "No".
      */
-    yesNo: (val: any, args?: [string, string]) => string;
+    yesNo: (val: any, args?: string[]) => string;
     /**
      * Converts a boolean value to a "true" or "false" string.
      * @param val - The value to format.
@@ -108,7 +108,7 @@ declare const defaultFormatters: {
      * @param {string} [args[1]="false"] - The string to return for a falsy value.
      * @returns "true" or "false".
      */
-    boolean: (val: any, args?: [string, string]) => string;
+    boolean: (val: any, args?: string[]) => string;
     /**
      * Pads the start of a string with another string.
      * @param val - The value to format.
@@ -117,7 +117,7 @@ declare const defaultFormatters: {
      * @param {string} [args[1]=" "] - The string to pad with.
      * @returns The padded string.
      */
-    padStart: (val: any, args: string[]) => string;
+    padStart: (val: any, args?: string[]) => string;
     /**
      * Pads the end of a string with another string.
      * @param val - The value to format.
@@ -126,16 +126,16 @@ declare const defaultFormatters: {
      * @param {string} [args[1]=" "] - The string to pad with.
      * @returns The padded string.
      */
-    padEnd: (val: any, args: string[]) => string;
+    padEnd: (val: any, args?: string[]) => string;
 };
 
-type NestedKeyOf<ObjectType extends object> = {
-    [Key in keyof ObjectType & string]: ObjectType[Key] extends any[] ? `${Key}` : ObjectType[Key] extends object ? `${Key}` | `${Key}.${NestedKeyOf<ObjectType[Key]>}` : `${Key}`;
+type NestedKeyOf<ObjectType extends object, Depth extends number = 8, UsedDepth extends any[] = []> = UsedDepth['length'] extends Depth ? never : {
+    [Key in keyof ObjectType & (string | number)]: ObjectType[Key] extends any[] ? `${Key}` : ObjectType[Key] extends object ? `${Key}` | `${Key}.${NestedKeyOf<ObjectType[Key], Depth, [...UsedDepth, any]>}` : `${Key}`;
+}[keyof ObjectType & (string | number)];
+type NestedKeyOfObj<ObjectType extends object, SkipArrays extends boolean = false, Depth extends number = 8, UsedDepth extends any[] = []> = UsedDepth['length'] extends Depth ? never : {
+    [Key in keyof ObjectType & string]: ObjectType[Key] extends Array<any> ? SkipArrays extends true ? never : `${Key}` | `${Key}.${number}` : ObjectType[Key] extends object ? `${Key}` | `${Key}.${NestedKeyOfObj<ObjectType[Key], SkipArrays, Depth, [...UsedDepth, any]>}` : never;
 }[keyof ObjectType & string];
-type NestedKeyOfObj<ObjectType extends object, SkipArrays extends boolean = false> = {
-    [Key in keyof ObjectType & string]: ObjectType[Key] extends Array<any> ? SkipArrays extends true ? never : `${Key}` | `${Key}.${number}` : ObjectType[Key] extends object ? `${Key}` | `${Key}.${NestedKeyOfObj<ObjectType[Key], SkipArrays>}` : never;
-}[keyof ObjectType & string];
-type PathValue<T, P extends string> = P extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? Rest extends string ? PathValue<T[Key], Rest> : never : never : P extends keyof T ? T[P] : never;
+type PathValue<T, P extends string> = P extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? PathValue<T[Key], Rest> : Key extends `${infer N extends number}` ? N extends keyof T ? PathValue<T[N], Rest> : never : never : P extends keyof T ? T[P] : P extends `${infer N extends number}` ? N extends keyof T ? T[N] : never : never;
 type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends ((k: infer I) => void) ? I : never;
 type DeepPick<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? {
     [Key in K]: DeepPick<T[K], Rest>;
@@ -150,7 +150,7 @@ type TranslationObjectFor<S extends Scope<T, Fallback> | Scope<T, Fallback>[] |
 type Translations<S extends ScopeType<T, F>, T extends Record<string, any>, F extends keyof T & string> = TranslationObjectFor<S, T, F>;
 type PluralForms = "zero" | "one" | "two" | "few" | "many" | "other";
 type PluralKeys<S extends ScopeType<T, F>, T extends Record<string, any>, F extends keyof T & string> = ExtractPluralKeys<Translations<S, T, F>>;
-type ExtractPluralKeys<T, Path extends string = "", Depth extends any[] = []> = Depth['length'] extends 32 ? never : T extends object ? {
+type ExtractPluralKeys<T, Path extends string = "", Depth extends any[] = []> = Depth['length'] extends 16 ? never : T extends object ? {
     [K in keyof T & string]: T[K] extends Partial<Record<PluralForms, string>> ? Path extends "" ? K : `${Path}.${K}` : K extends `${infer Base}_one` ? `${Base}_other` extends keyof T ? Path extends "" ? Base : `${Path}.${Base}` : never : T[K] extends object ? ExtractPluralKeys<T[K], Path extends "" ? K : `${Path}.${K}`, [...Depth, 1]> : never;
 }[keyof T & string] : never;
 interface InterpolationOptions {
@@ -173,7 +173,7 @@ type ObjectPlural = {
     [K in RequiredPlural]: string;
 } & Partial<Record<OptionalPlural, string>>;
 type Primitive = string | number | boolean | null | undefined;
-type StrKey<T> = Extract<keyof T, string>;
+type StrKey<T> = Extract<keyof T, string | number>;
 type PluralObjectKeys<T> = {
     [K in StrKey<T>]: T[K] extends object ? Extract<keyof T[K], PluralForms> extends never ? never : K : never;
 }[StrKey<T>];
@@ -249,6 +249,7 @@ declare class LocL<T extends Record<string, any>, Fallback extends keyof T & str
         fallbackLanguage: Fallback;
         formatters?: F;
         useDefaultFormatters?: UseDefaultFormatter;
+        scope?: S;
     });
     /**
      * Creates a new proxy translator instance with a different configuration.
@@ -284,7 +285,7 @@ declare class LocL<T extends Record<string, any>, Fallback extends keyof T & str
      * @returns The translated and formatted string, or the translation object.
      */
     t(): TranslationObjectFor<S, T, Fallback>;
-    t<K extends NestedKeyOf<TranslationObjectFor<S, T, Fallback>>>(key: K, values?: InterpolationOptions, format?: FormatOptions<F, UseDefaultFormatter>): PathValue<TranslationObjectFor<S, T, Fallback>, K> extends string ? string : PathValue<TranslationObjectFor<S, T, Fallback>, K>;
+    t<K extends NestedKeyOf<TranslationObjectFor<S, T, Fallback>>>(key: K, values?: InterpolationOptions, format?: FormatOptions<F, UseDefaultFormatter>): PathValue<TranslationObjectFor<S, T, Fallback>, K>;
     /**
      * Translates a key without strict type checking.
      * This is useful for compatibility with other i18n libraries or dynamic keys.
@@ -371,7 +372,7 @@ declare class LocL<T extends Record<string, any>, Fallback extends keyof T & str
  *
  * @returns A new `LocL` instance configured with the provided options.
  */
-declare function initLocL<T extends Record<string, any>, Fallback extends keyof T & string, S extends ScopeType<T, Fallback> | undefined = undefined, F extends Record<string, Formatter> = {}, UseDefaultFormatter extends boolean = true>(config: LocLConfig<T, Fallback> & {
+declare function initLocL<T extends Record<string, any>, Fallback extends keyof T & string, S extends ScopeType<T, Fallback> = undefined, F extends Record<string, Formatter> = {}, UseDefaultFormatter extends boolean = true>(config: LocLConfig<T, Fallback> & {
     scope?: S;
     formatters?: F;
     useDefaultFormatters?: UseDefaultFormatter;

package/dist/index.d.ts

@@ -49,7 +49,7 @@ declare const defaultFormatters: {
      * @param {string} [args[1]="..."] - The suffix to append if the string is truncated.
      * @returns The truncated string.
      */
-    truncate: (val: any, args: string[]) => string;
+    truncate: (val: any, args?: string[]) => string;
     /**
      * Formats a number using `Intl.NumberFormat`.
      * @param val - The value to format.
@@ -58,7 +58,7 @@ declare const defaultFormatters: {
      * @param {string} [args[1]] - The style of formatting to use (e.g., "decimal", "percent").
      * @returns The formatted number.
      */
-    number: (val: any, args: string[]) => string;
+    number: (val: any, args?: string[]) => string;
     /**
      * Formats a number as a currency string using `Intl.NumberFormat`.
      * @param val - The value to format.
@@ -67,7 +67,7 @@ declare const defaultFormatters: {
      * @param {string} [args[1]] - The locale to use.
      * @returns The formatted currency string.
      */
-    currency: (val: any, args: string[]) => string;
+    currency: (val: any, args?: string[]) => string;
     /**
      * Formats a date using `Intl.DateTimeFormat`.
      * @param val - The value to format.
@@ -76,7 +76,7 @@ declare const defaultFormatters: {
      * @param {string} [args[1]] - The date style to use (e.g., "short", "long").
      * @returns The formatted date string.
      */
-    date: (val: any, args: string[]) => string;
+    date: (val: any, args?: string[]) => string;
     /**
      * Formats a date as a relative time string (e.g., "2 hours ago").
      * @param val - The value to format.
@@ -84,7 +84,7 @@ declare const defaultFormatters: {
      * @param {string} [args[0]] - The locale to use.
      * @returns The relative time string.
      */
-    relativeDate: (val: any, args: string[]) => string;
+    relativeDate: (val: any, args?: string[]) => string;
     /**
      * Converts a value to a JSON string.
      * @param val - The value to format.
@@ -99,7 +99,7 @@ declare const defaultFormatters: {
      * @param {string} [args[1]="No"] - The string to return for a falsy value.
      * @returns "Yes" or "No".
      */
-    yesNo: (val: any, args?: [string, string]) => string;
+    yesNo: (val: any, args?: string[]) => string;
     /**
      * Converts a boolean value to a "true" or "false" string.
      * @param val - The value to format.
@@ -108,7 +108,7 @@ declare const defaultFormatters: {
      * @param {string} [args[1]="false"] - The string to return for a falsy value.
      * @returns "true" or "false".
      */
-    boolean: (val: any, args?: [string, string]) => string;
+    boolean: (val: any, args?: string[]) => string;
     /**
      * Pads the start of a string with another string.
      * @param val - The value to format.
@@ -117,7 +117,7 @@ declare const defaultFormatters: {
      * @param {string} [args[1]=" "] - The string to pad with.
      * @returns The padded string.
      */
-    padStart: (val: any, args: string[]) => string;
+    padStart: (val: any, args?: string[]) => string;
     /**
      * Pads the end of a string with another string.
      * @param val - The value to format.
@@ -126,16 +126,16 @@ declare const defaultFormatters: {
      * @param {string} [args[1]=" "] - The string to pad with.
      * @returns The padded string.
      */
-    padEnd: (val: any, args: string[]) => string;
+    padEnd: (val: any, args?: string[]) => string;
 };
 
-type NestedKeyOf<ObjectType extends object> = {
-    [Key in keyof ObjectType & string]: ObjectType[Key] extends any[] ? `${Key}` : ObjectType[Key] extends object ? `${Key}` | `${Key}.${NestedKeyOf<ObjectType[Key]>}` : `${Key}`;
+type NestedKeyOf<ObjectType extends object, Depth extends number = 8, UsedDepth extends any[] = []> = UsedDepth['length'] extends Depth ? never : {
+    [Key in keyof ObjectType & (string | number)]: ObjectType[Key] extends any[] ? `${Key}` : ObjectType[Key] extends object ? `${Key}` | `${Key}.${NestedKeyOf<ObjectType[Key], Depth, [...UsedDepth, any]>}` : `${Key}`;
+}[keyof ObjectType & (string | number)];
+type NestedKeyOfObj<ObjectType extends object, SkipArrays extends boolean = false, Depth extends number = 8, UsedDepth extends any[] = []> = UsedDepth['length'] extends Depth ? never : {
+    [Key in keyof ObjectType & string]: ObjectType[Key] extends Array<any> ? SkipArrays extends true ? never : `${Key}` | `${Key}.${number}` : ObjectType[Key] extends object ? `${Key}` | `${Key}.${NestedKeyOfObj<ObjectType[Key], SkipArrays, Depth, [...UsedDepth, any]>}` : never;
 }[keyof ObjectType & string];
-type NestedKeyOfObj<ObjectType extends object, SkipArrays extends boolean = false> = {
-    [Key in keyof ObjectType & string]: ObjectType[Key] extends Array<any> ? SkipArrays extends true ? never : `${Key}` | `${Key}.${number}` : ObjectType[Key] extends object ? `${Key}` | `${Key}.${NestedKeyOfObj<ObjectType[Key], SkipArrays>}` : never;
-}[keyof ObjectType & string];
-type PathValue<T, P extends string> = P extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? Rest extends string ? PathValue<T[Key], Rest> : never : never : P extends keyof T ? T[P] : never;
+type PathValue<T, P extends string> = P extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? PathValue<T[Key], Rest> : Key extends `${infer N extends number}` ? N extends keyof T ? PathValue<T[N], Rest> : never : never : P extends keyof T ? T[P] : P extends `${infer N extends number}` ? N extends keyof T ? T[N] : never : never;
 type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends ((k: infer I) => void) ? I : never;
 type DeepPick<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? {
     [Key in K]: DeepPick<T[K], Rest>;
@@ -150,7 +150,7 @@ type TranslationObjectFor<S extends Scope<T, Fallback> | Scope<T, Fallback>[] |
 type Translations<S extends ScopeType<T, F>, T extends Record<string, any>, F extends keyof T & string> = TranslationObjectFor<S, T, F>;
 type PluralForms = "zero" | "one" | "two" | "few" | "many" | "other";
 type PluralKeys<S extends ScopeType<T, F>, T extends Record<string, any>, F extends keyof T & string> = ExtractPluralKeys<Translations<S, T, F>>;
-type ExtractPluralKeys<T, Path extends string = "", Depth extends any[] = []> = Depth['length'] extends 32 ? never : T extends object ? {
+type ExtractPluralKeys<T, Path extends string = "", Depth extends any[] = []> = Depth['length'] extends 16 ? never : T extends object ? {
     [K in keyof T & string]: T[K] extends Partial<Record<PluralForms, string>> ? Path extends "" ? K : `${Path}.${K}` : K extends `${infer Base}_one` ? `${Base}_other` extends keyof T ? Path extends "" ? Base : `${Path}.${Base}` : never : T[K] extends object ? ExtractPluralKeys<T[K], Path extends "" ? K : `${Path}.${K}`, [...Depth, 1]> : never;
 }[keyof T & string] : never;
 interface InterpolationOptions {
@@ -173,7 +173,7 @@ type ObjectPlural = {
     [K in RequiredPlural]: string;
 } & Partial<Record<OptionalPlural, string>>;
 type Primitive = string | number | boolean | null | undefined;
-type StrKey<T> = Extract<keyof T, string>;
+type StrKey<T> = Extract<keyof T, string | number>;
 type PluralObjectKeys<T> = {
     [K in StrKey<T>]: T[K] extends object ? Extract<keyof T[K], PluralForms> extends never ? never : K : never;
 }[StrKey<T>];
@@ -249,6 +249,7 @@ declare class LocL<T extends Record<string, any>, Fallback extends keyof T & str
         fallbackLanguage: Fallback;
         formatters?: F;
         useDefaultFormatters?: UseDefaultFormatter;
+        scope?: S;
     });
     /**
      * Creates a new proxy translator instance with a different configuration.
@@ -284,7 +285,7 @@ declare class LocL<T extends Record<string, any>, Fallback extends keyof T & str
      * @returns The translated and formatted string, or the translation object.
      */
     t(): TranslationObjectFor<S, T, Fallback>;
-    t<K extends NestedKeyOf<TranslationObjectFor<S, T, Fallback>>>(key: K, values?: InterpolationOptions, format?: FormatOptions<F, UseDefaultFormatter>): PathValue<TranslationObjectFor<S, T, Fallback>, K> extends string ? string : PathValue<TranslationObjectFor<S, T, Fallback>, K>;
+    t<K extends NestedKeyOf<TranslationObjectFor<S, T, Fallback>>>(key: K, values?: InterpolationOptions, format?: FormatOptions<F, UseDefaultFormatter>): PathValue<TranslationObjectFor<S, T, Fallback>, K>;
     /**
      * Translates a key without strict type checking.
      * This is useful for compatibility with other i18n libraries or dynamic keys.
@@ -371,7 +372,7 @@ declare class LocL<T extends Record<string, any>, Fallback extends keyof T & str
  *
  * @returns A new `LocL` instance configured with the provided options.
  */
-declare function initLocL<T extends Record<string, any>, Fallback extends keyof T & string, S extends ScopeType<T, Fallback> | undefined = undefined, F extends Record<string, Formatter> = {}, UseDefaultFormatter extends boolean = true>(config: LocLConfig<T, Fallback> & {
+declare function initLocL<T extends Record<string, any>, Fallback extends keyof T & string, S extends ScopeType<T, Fallback> = undefined, F extends Record<string, Formatter> = {}, UseDefaultFormatter extends boolean = true>(config: LocLConfig<T, Fallback> & {
     scope?: S;
     formatters?: F;
     useDefaultFormatters?: UseDefaultFormatter;

package/dist/index.js

@@ -58,7 +58,7 @@ var defaultFormatters = {
    * @param {string} [args[1]="..."] - The suffix to append if the string is truncated.
    * @returns The truncated string.
    */
-  truncate: (val, args) => {
+  truncate: (val, args = []) => {
     const length = parseInt(args[0]) || 10;
     const suffix = args[1] || "...";
     const str = String(val);
@@ -72,7 +72,7 @@ var defaultFormatters = {
    * @param {string} [args[1]] - The style of formatting to use (e.g., "decimal", "percent").
    * @returns The formatted number.
    */
-  number: (val, args) => {
+  number: (val, args = []) => {
     const locales = args[0] || void 0;
     const options = {};
     if (args[1]) options.style = args[1];
@@ -86,7 +86,7 @@ var defaultFormatters = {
    * @param {string} [args[1]] - The locale to use.
    * @returns The formatted currency string.
    */
-  currency: (val, args) => {
+  currency: (val, args = []) => {
     const currency = args[0] || "USD";
     const locales = args[1] || void 0;
     return new Intl.NumberFormat(locales, {
@@ -102,7 +102,7 @@ var defaultFormatters = {
    * @param {string} [args[1]] - The date style to use (e.g., "short", "long").
    * @returns The formatted date string.
    */
-  date: (val, args) => {
+  date: (val, args = []) => {
     const locales = args[0] || void 0;
     const options = {};
     if (args[1]) options.dateStyle = args[1];
@@ -115,7 +115,7 @@ var defaultFormatters = {
    * @param {string} [args[0]] - The locale to use.
    * @returns The relative time string.
    */
-  relativeDate: (val, args) => {
+  relativeDate: (val, args = []) => {
     const locales = args[0] || void 0;
     const options = { numeric: "auto" };
     const rtf = new Intl.RelativeTimeFormat(locales, options);
@@ -139,7 +139,7 @@ var defaultFormatters = {
    * @param {string} [args[1]="No"] - The string to return for a falsy value.
    * @returns "Yes" or "No".
    */
-  yesNo: (val, args) => {
+  yesNo: (val, args = []) => {
     const [yesVal, noVal] = args || [];
     return val ? yesVal || "Yes" : noVal || "No";
   },
@@ -151,7 +151,7 @@ var defaultFormatters = {
    * @param {string} [args[1]="false"] - The string to return for a falsy value.
    * @returns "true" or "false".
    */
-  boolean: (val, args) => {
+  boolean: (val, args = []) => {
     const [trueVal, falseVal] = args || [];
     return val ? trueVal || "true" : falseVal || "false";
   },
@@ -163,7 +163,7 @@ var defaultFormatters = {
    * @param {string} [args[1]=" "] - The string to pad with.
    * @returns The padded string.
    */
-  padStart: (val, args) => {
+  padStart: (val, args = []) => {
     const length = parseInt(args[0]) || 0;
     const fill = args[1] || " ";
     return String(val).padStart(length, fill);
@@ -176,7 +176,7 @@ var defaultFormatters = {
    * @param {string} [args[1]=" "] - The string to pad with.
    * @returns The padded string.
    */
-  padEnd: (val, args) => {
+  padEnd: (val, args = []) => {
     const length = parseInt(args[0]) || 0;
     const fill = args[1] || " ";
     return String(val).padEnd(length, fill);
@@ -226,7 +226,7 @@ var LocL = class _LocL {
     if (this.cache.has(cacheKey)) {
       return this.cache.get(cacheKey);
     }
-    return new Proxy(this, {
+    const result = new Proxy(this, {
       get(target, prop) {
         if (prop === "language") {
           return config.language ?? target.language;
@@ -237,6 +237,8 @@ var LocL = class _LocL {
         return target[prop];
       }
     });
+    this.cache.set(cacheKey, result);
+    return result;
   }
   /**
    * Creates a new `LocL` instance with a different language or scope.

package/dist/index.mjs

@@ -32,7 +32,7 @@ var defaultFormatters = {
    * @param {string} [args[1]="..."] - The suffix to append if the string is truncated.
    * @returns The truncated string.
    */
-  truncate: (val, args) => {
+  truncate: (val, args = []) => {
     const length = parseInt(args[0]) || 10;
     const suffix = args[1] || "...";
     const str = String(val);
@@ -46,7 +46,7 @@ var defaultFormatters = {
    * @param {string} [args[1]] - The style of formatting to use (e.g., "decimal", "percent").
    * @returns The formatted number.
    */
-  number: (val, args) => {
+  number: (val, args = []) => {
     const locales = args[0] || void 0;
     const options = {};
     if (args[1]) options.style = args[1];
@@ -60,7 +60,7 @@ var defaultFormatters = {
    * @param {string} [args[1]] - The locale to use.
    * @returns The formatted currency string.
    */
-  currency: (val, args) => {
+  currency: (val, args = []) => {
     const currency = args[0] || "USD";
     const locales = args[1] || void 0;
     return new Intl.NumberFormat(locales, {
@@ -76,7 +76,7 @@ var defaultFormatters = {
    * @param {string} [args[1]] - The date style to use (e.g., "short", "long").
    * @returns The formatted date string.
    */
-  date: (val, args) => {
+  date: (val, args = []) => {
     const locales = args[0] || void 0;
     const options = {};
     if (args[1]) options.dateStyle = args[1];
@@ -89,7 +89,7 @@ var defaultFormatters = {
    * @param {string} [args[0]] - The locale to use.
    * @returns The relative time string.
    */
-  relativeDate: (val, args) => {
+  relativeDate: (val, args = []) => {
     const locales = args[0] || void 0;
     const options = { numeric: "auto" };
     const rtf = new Intl.RelativeTimeFormat(locales, options);
@@ -113,7 +113,7 @@ var defaultFormatters = {
    * @param {string} [args[1]="No"] - The string to return for a falsy value.
    * @returns "Yes" or "No".
    */
-  yesNo: (val, args) => {
+  yesNo: (val, args = []) => {
     const [yesVal, noVal] = args || [];
     return val ? yesVal || "Yes" : noVal || "No";
   },
@@ -125,7 +125,7 @@ var defaultFormatters = {
    * @param {string} [args[1]="false"] - The string to return for a falsy value.
    * @returns "true" or "false".
    */
-  boolean: (val, args) => {
+  boolean: (val, args = []) => {
     const [trueVal, falseVal] = args || [];
     return val ? trueVal || "true" : falseVal || "false";
   },
@@ -137,7 +137,7 @@ var defaultFormatters = {
    * @param {string} [args[1]=" "] - The string to pad with.
    * @returns The padded string.
    */
-  padStart: (val, args) => {
+  padStart: (val, args = []) => {
     const length = parseInt(args[0]) || 0;
     const fill = args[1] || " ";
     return String(val).padStart(length, fill);
@@ -150,7 +150,7 @@ var defaultFormatters = {
    * @param {string} [args[1]=" "] - The string to pad with.
    * @returns The padded string.
    */
-  padEnd: (val, args) => {
+  padEnd: (val, args = []) => {
     const length = parseInt(args[0]) || 0;
     const fill = args[1] || " ";
     return String(val).padEnd(length, fill);
@@ -200,7 +200,7 @@ var LocL = class _LocL {
     if (this.cache.has(cacheKey)) {
       return this.cache.get(cacheKey);
     }
-    return new Proxy(this, {
+    const result = new Proxy(this, {
       get(target, prop) {
         if (prop === "language") {
           return config.language ?? target.language;
@@ -211,6 +211,8 @@ var LocL = class _LocL {
         return target[prop];
       }
     });
+    this.cache.set(cacheKey, result);
+    return result;
   }
   /**
    * Creates a new `LocL` instance with a different language or scope.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "locl-js",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Modern TypeScript internationalization (i18n) library with type-safety, performance, and backend usability",
   "license": "MIT",
   "author": "Sztrida Sámuel <sztsam@gmail.com>",
@@ -26,11 +26,11 @@
   "devDependencies": {
     "@types/jest": "^30.0.0",
     "@types/node": "^24.5.2",
-    "jest": "^30.1.3",
-    "ts-jest": "^29.4.4",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
     "ts-node": "^10.9.2",
-    "tsup": "^8.5.0",
-    "typescript": "^5.9.2"
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
   },
   "files": [
     "dist"

package/readme.md

@@ -1,5 +1,7 @@
 # LocL.js 🌐
 
+![Coverage](https://img.shields.io/badge/coverage-98%25-brightgreen)
+
 **LocL** is a powerful, lightweight, and fully-featured TypeScript internationalization (i18n) library. It is designed to be flexible, easy to use, and highly extensible, providing a seamless experience for adding multiple languages to your projects. With built-in support for plurals, formatting, and modularization, `LocL` is the perfect tool for developers looking for a modern and robust i18n solution.
 
 It is inspired by libraries like `i18next` and `react-i18next`, but with a focus on type-safety, simplicity, performance and backend usability like discord bot and other apps.
@@ -231,7 +233,7 @@ translator.t("price", { price: 123 }); // "The price is $123.00"
 You can also define your own custom formatters:
 
 ```typescript
-const translator = initTranslator({
+const translator = initLocL({
     resources,
     fallbackLanguage: "en",
     formatters: {