react-scoped-i18n 0.0.3 → 0.0.5

package/dist/cjs/createI18nContext/util/cache.d.ts

@@ -0,0 +1,2 @@
+import LRUCache from "lru-cache";
+export declare function potentiallyWarnInvalidCacheState<K extends Intl.NumberFormatOptions | Intl.DateTimeFormatOptions, V extends Intl.NumberFormat | Intl.DateTimeFormat>(value: number | Date, cache: LRUCache<K, V>, options: K): void;

package/dist/cjs/createI18nContext/util/cache.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.potentiallyWarnInvalidCacheState = potentiallyWarnInvalidCacheState;
+const env_1 = require("../../env");
+function potentiallyWarnInvalidCacheState(value, cache, options) {
+    if (!env_1.IS_DEV) {
+        return;
+    }
+    const cachedKeys = Array.from(cache.keys());
+    const isEquivalent = cachedKeys.some((key) => shallowEqual(key, options));
+    if (isEquivalent) {
+        console.warn(`[i18n] ⚠️ Formatting ${value} with options ${JSON.stringify(options)} is not cached, but it should be. This is because you are recreating the options object on every render. To fix this, memoize the options object or define it outside of the component.`);
+    }
+}
+function shallowEqual(a, b) {
+    const aKeys = Object.keys(a);
+    const bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length) {
+        return false;
+    }
+    return aKeys.every((key) => a[key] === b[key]);
+}

package/dist/cjs/env/index.d.ts

@@ -0,0 +1 @@
+export declare const IS_DEV: boolean;

package/dist/cjs/env/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IS_DEV = void 0;
+const rawNodeEnv = process.env.NODE_ENV;
+exports.IS_DEV = typeof __DEV__ !== `undefined` ? __DEV__ : rawNodeEnv === `development`;

package/dist/cjs/env.js

@@ -1,9 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IS_DEV = void 0;
-const rawNodeEnv = typeof process !== `undefined` &&
-    process.env &&
-    typeof process.env.NODE_ENV === `string`
-    ? process.env.NODE_ENV
-    : undefined;
+const rawNodeEnv = process.env.NODE_ENV;
 exports.IS_DEV = typeof __DEV__ !== `undefined` ? __DEV__ : rawNodeEnv === `development`;

package/dist/cjs/vendor/lru-cache.d.ts

@@ -0,0 +1,2 @@
+import * as LRU from "lru-cache";
+export declare const LRUCache: typeof LRU;

package/dist/cjs/vendor/lru-cache.js

@@ -0,0 +1,38 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LRUCache = void 0;
+const LRU = __importStar(require("lru-cache"));
+exports.LRUCache = LRU.LRUCache ?? LRU.default ?? LRU;

package/dist/esm/createI18nContext/api/createFormat.d.ts

@@ -1,7 +1,7 @@
 export declare const createFormat: <const Languages extends readonly string[]>({ currentLanguage, }: {
     currentLanguage: Languages[number];
 }) => {
-    number: (value: number, options?: Intl.NumberFormatOptions) => string;
+    number: (value: number, options?: Omit<Intl.NumberFormatOptions, `style`>) => string;
     date: (value: Date | number, options?: Intl.DateTimeFormatOptions) => string;
     time: (value: Date | number, options?: Intl.DateTimeFormatOptions) => string;
     currency: (value: number, currency: string, options?: Omit<Intl.NumberFormatOptions, `style` | `currency`>) => string;

package/dist/esm/createI18nContext/api/createFormat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createFormat.d.ts","sourceRoot":"","sources":["../../../../src/createI18nContext/api/createFormat.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,GAAI,KAAK,CAAC,SAAS,SAAS,SAAS,MAAM,EAAE,EAAE,sBAErE;IACD,eAAe,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CACpC;oBAgBmB,MAAM,YAAY,IAAI,CAAC,mBAAmB;kBAQ5C,IAAI,GAAG,MAAM,YAAY,IAAI,CAAC,qBAAqB;kBAQnD,IAAI,GAAG,MAAM,YAAY,IAAI,CAAC,qBAAqB;sBAWxD,MAAM,YACH,MAAM,YACN,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,UAAU,CAAC;wBAUvD,MAAM,YACH,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC;CAYtD,CAAC"}
+{"version":3,"file":"createFormat.d.ts","sourceRoot":"","sources":["../../../../src/createI18nContext/api/createFormat.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY,GAAI,KAAK,CAAC,SAAS,SAAS,SAAS,MAAM,EAAE,EAAE,sBAErE;IACD,eAAe,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CACpC;oBAiBY,MAAM,YACH,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC;kBAwBrC,IAAI,GAAG,MAAM,YAAY,IAAI,CAAC,qBAAqB;kBAuBnD,IAAI,GAAG,MAAM,YAAY,IAAI,CAAC,qBAAqB;sBA0BxD,MAAM,YACH,MAAM,YACN,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,UAAU,CAAC;wBAoCvD,MAAM,YACH,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC;CA8BtD,CAAC"}

package/dist/esm/createI18nContext/api/createFormat.js

@@ -1,3 +1,6 @@
+import LRUCache from "lru-cache";
+import { LRU_CACHE_MAX_SIZE } from "../const";
+import { potentiallyWarnInvalidCacheState } from "../util/cache";
 export const createFormat = ({ currentLanguage, }) => {
     const defaultNumberFormatter = new Intl.NumberFormat(currentLanguage);
     const defaultDateFormatter = new Intl.DateTimeFormat(currentLanguage);
@@ -11,26 +14,68 @@ export const createFormat = ({ currentLanguage, }) => {
     });
     return {
         number: (value, options) => {
-            if (options) {
-                return new Intl.NumberFormat(currentLanguage, options).format(value);
+            if (!options) {
+                return defaultNumberFormatter.format(value);
+            }
+            if (!caches.number.has(options)) {
+                potentiallyWarnInvalidCacheState(value, caches.number, options);
+                caches.number.set(options, new Intl.NumberFormat(currentLanguage, options));
+            }
+            const cachedFormatter = caches.number.get(options);
+            if (cachedFormatter) {
+                return cachedFormatter.format(value);
             }
-            return defaultNumberFormatter.format(value);
+            return new Intl.NumberFormat(currentLanguage, options).format(value);
         },
         date: (value, options) => {
-            if (options) {
-                return new Intl.DateTimeFormat(currentLanguage, options).format(value);
+            if (!options) {
+                return defaultDateFormatter.format(value);
+            }
+            if (!caches.date.has(options)) {
+                potentiallyWarnInvalidCacheState(value, caches.date, options);
+                caches.date.set(options, new Intl.DateTimeFormat(currentLanguage, options));
+            }
+            const cachedFormatter = caches.date.get(options);
+            if (cachedFormatter) {
+                return cachedFormatter.format(value);
             }
-            return defaultDateFormatter.format(value);
+            return new Intl.DateTimeFormat(currentLanguage, options).format(value);
         },
         time: (value, options) => {
-            if (options) {
-                return new Intl.DateTimeFormat(currentLanguage, {
-                    ...options,
-                }).format(value);
+            if (!options) {
+                return defaultTimeFormatter.format(value);
+            }
+            if (!caches.time.has(options)) {
+                potentiallyWarnInvalidCacheState(value, caches.time, options);
+                caches.time.set(options, new Intl.DateTimeFormat(currentLanguage, options));
             }
-            return defaultTimeFormatter.format(value);
+            const cachedFormatter = caches.time.get(options);
+            if (cachedFormatter) {
+                return cachedFormatter.format(value);
+            }
+            return new Intl.DateTimeFormat(currentLanguage, {
+                ...options,
+            }).format(value);
         },
         currency: (value, currency, options) => {
+            if (options) {
+                const cacheKey = {
+                    ...options,
+                    currency,
+                };
+                if (!caches.currency.has(cacheKey)) {
+                    potentiallyWarnInvalidCacheState(value, caches.currency, cacheKey);
+                    caches.currency.set(cacheKey, new Intl.NumberFormat(currentLanguage, {
+                        style: `currency`,
+                        currency,
+                        ...options,
+                    }));
+                }
+                const cachedFormatter = caches.currency.get(cacheKey);
+                if (cachedFormatter) {
+                    return cachedFormatter.format(value);
+                }
+            }
             return new Intl.NumberFormat(currentLanguage, {
                 style: `currency`,
                 currency,
@@ -38,13 +83,41 @@ export const createFormat = ({ currentLanguage, }) => {
             }).format(value);
         },
         percentage: (value, options) => {
-            if (options) {
-                return new Intl.NumberFormat(currentLanguage, {
+            if (!options) {
+                return defaultPercentageFormatter.format(value);
+            }
+            if (!caches.percentage.has(options)) {
+                potentiallyWarnInvalidCacheState(value, caches.number, options);
+                caches.percentage.set(options, new Intl.NumberFormat(currentLanguage, {
                     style: `percent`,
                     ...options,
-                }).format(value);
+                }));
             }
-            return defaultPercentageFormatter.format(value);
+            const cachedFormatter = caches.percentage.get(options);
+            if (cachedFormatter) {
+                return cachedFormatter.format(value);
+            }
+            return new Intl.NumberFormat(currentLanguage, {
+                style: `percent`,
+                ...options,
+            }).format(value);
         },
     };
 };
+const caches = {
+    number: new LRUCache({
+        max: LRU_CACHE_MAX_SIZE,
+    }),
+    date: new LRUCache({
+        max: LRU_CACHE_MAX_SIZE,
+    }),
+    time: new LRUCache({
+        max: LRU_CACHE_MAX_SIZE,
+    }),
+    currency: new LRUCache({
+        max: LRU_CACHE_MAX_SIZE,
+    }),
+    percentage: new LRUCache({
+        max: LRU_CACHE_MAX_SIZE,
+    }),
+};

package/dist/esm/createI18nContext/api/createFormat.test.js

@@ -1,5 +1,8 @@
 import { createFormat } from "./createFormat";
 describe(`createFormat`, () => {
+    const numberFormatOptions = {
+        minimumFractionDigits: 4,
+    };
     const format = createFormat({
         currentLanguage: `en-US`,
     });
@@ -7,12 +10,11 @@ describe(`createFormat`, () => {
         const formattedNumber = format.number(1234567.89);
         expect(formattedNumber).toBe(`1,234,567.89`);
     });
-    it(`number formatter returns a formatted value with options`, () => {
-        const formattedNumber = format.number(0.1234, {
-            style: `percent`,
-            minimumFractionDigits: 2,
-        });
-        expect(formattedNumber).toBe(`12.34%`);
+    it(`number formatter returns a formatted value with options (with caching enabled)`, () => {
+        const formattedNumber1 = format.number(1234567.89, numberFormatOptions);
+        const formattedNumber2 = format.number(1234567.89, numberFormatOptions);
+        expect(formattedNumber1).toBe(`1,234,567.8900`);
+        expect(formattedNumber2).toBe(`1,234,567.8900`);
     });
     it(`date formatter returns a formatted value`, () => {
         const date = new Date(`2024-01-01T12:00:00Z`);
@@ -53,12 +55,10 @@ describe(`createFormat`, () => {
         expect(formattedCurrency).toBe(`€1,234.6`);
     });
     it(`percentage formatter returns a formatted value`, () => {
-        const formattedPercentage = format.percentage(0.1234);
-        expect(formattedPercentage).toBe(`12%`);
-    });
-    it(`percentage formatter returns a formatted value `, () => {
-        const formattedPercentage = format.percentage(0.1234);
-        expect(formattedPercentage).toBe(`12%`);
+        const formattedPercentage1 = format.percentage(0.1234);
+        const formattedPercentage2 = format.percentage(0.1267);
+        expect(formattedPercentage1).toBe(`12%`);
+        expect(formattedPercentage2).toBe(`13%`);
     });
     it(`percentage formatter returns a formatted value with options`, () => {
         const formattedPercentage = format.percentage(0.1234, {
@@ -66,4 +66,33 @@ describe(`createFormat`, () => {
         });
         expect(formattedPercentage).toBe(`12.34%`);
     });
+    it(`Error: Number options are not cached`, () => {
+        const warnSpy = jest.spyOn(console, `warn`);
+        const formattedNumber1 = format.number(1234567.89, {
+            minimumFractionDigits: 5,
+        });
+        const formattedNumber2 = format.number(1234567.89, {
+            minimumFractionDigits: 5,
+        });
+        expect(formattedNumber1).toBe(`1,234,567.89000`);
+        expect(formattedNumber2).toBe(`1,234,567.89000`);
+        expect(warnSpy).toHaveBeenCalledWith(`[i18n] ⚠️ Formatting 1234567.89 with options {"minimumFractionDigits":5} is not cached, but it should be. This is because you are recreating the options object on every render. To fix this, memoize the options object or define it outside of the component.`);
+    });
+    it(`Error: Date options are not cached`, () => {
+        const warnSpy = jest.spyOn(console, `warn`);
+        const date = new Date(`2026-02-03T12:00:00Z`);
+        const formattedDate1 = format.date(date, {
+            year: `numeric`,
+            month: `long`,
+            day: `numeric`,
+        });
+        const formattedDate2 = format.date(date, {
+            year: `numeric`,
+            month: `long`,
+            day: `numeric`,
+        });
+        expect(formattedDate1).toBe(`February 3, 2026`);
+        expect(formattedDate2).toBe(`February 3, 2026`);
+        expect(warnSpy).toHaveBeenCalledWith(`[i18n] ⚠️ Formatting Tue Feb 03 2026 13:00:00 GMT+0100 (Central European Standard Time) with options {"year":"numeric","month":"long","day":"numeric"} is not cached, but it should be. This is because you are recreating the options object on every render. To fix this, memoize the options object or define it outside of the component.`);
+    });
 });

package/dist/esm/createI18nContext/api/createUseI18n.d.ts

@@ -11,7 +11,7 @@ export declare const createUseI18n: <const Languages extends readonly string[],
     setCurrentLanguage: import("react").Dispatch<import("react").SetStateAction<Languages[number]>>;
     currentLanguage: Languages[number];
     format: {
-        number: (value: number, options?: Intl.NumberFormatOptions) => string;
+        number: (value: number, options?: Omit<Intl.NumberFormatOptions, `style`>) => string;
         date: (value: Date | number, options?: Intl.DateTimeFormatOptions) => string;
         time: (value: Date | number, options?: Intl.DateTimeFormatOptions) => string;
         currency: (value: number, currency: string, options?: Omit<Intl.NumberFormatOptions, `style` | `currency`>) => string;

package/dist/esm/createI18nContext/api/createUseI18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createUseI18n.d.ts","sourceRoot":"","sources":["../../../../src/createI18nContext/api/createUseI18n.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAuB,MAAM,OAAO,CAAC;AAMrD,eAAO,MAAM,aAAa,GACxB,KAAK,CAAC,SAAS,SAAS,SAAS,MAAM,EAAE,EACzC,KAAK,CAAC,OAAO,SAAS,MAAM,CAC1B,MAAM,EACN,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAC1C,EACD,wDAKC;IACD,WAAW,EAAE,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAChE,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/B,gBAAgB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;;;;;;;;;;;;;CAmDA,CAAC"}
+{"version":3,"file":"createUseI18n.d.ts","sourceRoot":"","sources":["../../../../src/createI18nContext/api/createUseI18n.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAuB,MAAM,OAAO,CAAC;AAMrD,eAAO,MAAM,aAAa,GACxB,KAAK,CAAC,SAAS,SAAS,SAAS,MAAM,EAAE,EACzC,KAAK,CAAC,OAAO,SAAS,MAAM,CAC1B,MAAM,EACN,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAC1C,EACD,wDAKC;IACD,WAAW,EAAE,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAChE,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/B,gBAAgB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;;;;;;;;;;;;;CAqDA,CAAC"}

package/dist/esm/createI18nContext/api/createUseI18n.js

@@ -27,7 +27,9 @@ export const createUseI18n = ({ I18nContext, languages, fallbackLanguage, common
             });
         }, [currentLanguage]);
         const format = useMemo(() => {
-            return createFormat({ currentLanguage });
+            return createFormat({
+                currentLanguage,
+            });
         }, [currentLanguage]);
         const _commons = useMemo(() => {
             return createCommons({

package/dist/esm/createI18nContext/api/createUseI18n.test.js

@@ -14,9 +14,11 @@ describe(`createUseI18n`, () => {
             .mockImplementation(() => { });
         try {
             useI18n();
+            // eslint-disable-next-line unused-imports/no-unused-vars
         }
         catch (e) {
-            expect(consoleErrorSpy).toHaveBeenCalled(); // eslint-disable-line unused-imports/no-unused-vars
+            // eslint-disable-line unused-imports/no-unused-vars
+            expect(consoleErrorSpy).toHaveBeenCalled();
         }
         consoleErrorSpy.mockRestore();
     });

package/dist/esm/createI18nContext/api/useCreateFormat.d.ts

@@ -0,0 +1,10 @@
+export declare const useCreateFormat: <const Languages extends readonly string[]>({ currentLanguage, }: {
+    currentLanguage: Languages[number];
+}) => {
+    number: (value: number, options?: Intl.NumberFormatOptions) => string;
+    date: (value: Date | number, options?: Intl.DateTimeFormatOptions) => string;
+    time: (value: Date | number, options?: Intl.DateTimeFormatOptions) => string;
+    currency: (value: number, currency: string, options?: Omit<Intl.NumberFormatOptions, `style` | `currency`>) => string;
+    percentage: (value: number, options?: Omit<Intl.NumberFormatOptions, `style`>) => string;
+};
+//# sourceMappingURL=useCreateFormat.d.ts.map

package/dist/esm/createI18nContext/api/useCreateFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateFormat.d.ts","sourceRoot":"","sources":["../../../../src/createI18nContext/api/useCreateFormat.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,GAAI,KAAK,CAAC,SAAS,SAAS,SAAS,MAAM,EAAE,EAAE,sBAExE;IACD,eAAe,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CACpC;oBAyBmB,MAAM,YAAY,IAAI,CAAC,mBAAmB;kBAQ5C,IAAI,GAAG,MAAM,YAAY,IAAI,CAAC,qBAAqB;kBAQnD,IAAI,GAAG,MAAM,YAAY,IAAI,CAAC,qBAAqB;sBAWxD,MAAM,YACH,MAAM,YACN,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,UAAU,CAAC;wBAUvD,MAAM,YACH,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC;CAYtD,CAAC"}

package/dist/esm/createI18nContext/api/useCreateFormat.js

@@ -0,0 +1,58 @@
+import { useMemo } from "react";
+export const useCreateFormat = ({ currentLanguage, }) => {
+    const defaultNumberFormatter = new Intl.NumberFormat(currentLanguage);
+    const defaultDateFormatter = new Intl.DateTimeFormat(currentLanguage);
+    const defaultTimeFormatter = new Intl.DateTimeFormat(currentLanguage, {
+        hour: `numeric`,
+        minute: `numeric`,
+        second: `numeric`,
+    });
+    const defaultPercentageFormatter = new Intl.NumberFormat(currentLanguage, {
+        style: `percent`,
+    });
+    const defaultCurrencyFormatter = useMemo(() => {
+        return new Intl.NumberFormat(currentLanguage, {
+            style: `currency`,
+            currency: `USD`,
+        });
+    }, [currentLanguage]);
+    console.log(defaultCurrencyFormatter.resolvedOptions().currency);
+    return {
+        number: (value, options) => {
+            if (options) {
+                return new Intl.NumberFormat(currentLanguage, options).format(value);
+            }
+            return defaultNumberFormatter.format(value);
+        },
+        date: (value, options) => {
+            if (options) {
+                return new Intl.DateTimeFormat(currentLanguage, options).format(value);
+            }
+            return defaultDateFormatter.format(value);
+        },
+        time: (value, options) => {
+            if (options) {
+                return new Intl.DateTimeFormat(currentLanguage, {
+                    ...options,
+                }).format(value);
+            }
+            return defaultTimeFormatter.format(value);
+        },
+        currency: (value, currency, options) => {
+            return new Intl.NumberFormat(currentLanguage, {
+                style: `currency`,
+                currency,
+                ...options,
+            }).format(value);
+        },
+        percentage: (value, options) => {
+            if (options) {
+                return new Intl.NumberFormat(currentLanguage, {
+                    style: `percent`,
+                    ...options,
+                }).format(value);
+            }
+            return defaultPercentageFormatter.format(value);
+        },
+    };
+};

package/dist/esm/createI18nContext/api/useCreateFormat.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useCreateFormat.test.d.ts.map

package/dist/esm/createI18nContext/api/useCreateFormat.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateFormat.test.d.ts","sourceRoot":"","sources":["../../../../src/createI18nContext/api/useCreateFormat.test.ts"],"names":[],"mappings":""}

package/dist/esm/createI18nContext/api/useCreateFormat.test.js

@@ -0,0 +1,67 @@
+import { useCreateFormat } from "./useCreateFormat";
+describe(`createFormat`, () => {
+    const format = useCreateFormat({
+        currentLanguage: `en-US`,
+    });
+    it(`number formatter returns a formatted value`, () => {
+        const formattedNumber = format.number(1234567.89);
+        expect(formattedNumber).toBe(`1,234,567.89`);
+    });
+    it(`number formatter returns a formatted value with options`, () => {
+        const formattedNumber = format.number(0.1234, {
+            style: `percent`,
+            minimumFractionDigits: 2,
+        });
+        expect(formattedNumber).toBe(`12.34%`);
+    });
+    it(`date formatter returns a formatted value`, () => {
+        const date = new Date(`2024-01-01T12:00:00Z`);
+        const formattedDate = format.date(date);
+        expect(formattedDate).toBe(`1/1/2024`);
+    });
+    it(`date formatter returns a formatted value with options`, () => {
+        const date = new Date(`1999-01-01T12:00:00Z`);
+        const formattedDate = format.date(date, {
+            year: `numeric`,
+            month: `long`,
+            day: `numeric`,
+        });
+        expect(formattedDate).toBe(`January 1, 1999`);
+    });
+    it(`time formatter returns a formatted value`, () => {
+        const date = new Date(`1912-06-23T02:15:00`);
+        const formattedTime = format.time(date);
+        expect(formattedTime).toBe(`2:15:00 AM`);
+    });
+    it(`time formatter returns a formatted value with options`, () => {
+        const date = new Date(`2000-12-31T23:45:30`);
+        const formattedTime = format.time(date, {
+            hour12: false,
+            hour: `2-digit`,
+            minute: `2-digit`,
+        });
+        expect(formattedTime).toBe(`23:45`);
+    });
+    it(`currency formatter returns a formatted value`, () => {
+        const formattedCurrency = format.currency(1234.567, `USD`);
+        expect(formattedCurrency).toBe(`$1,234.57`);
+    });
+    it(`currency formatter returns a formatted value with options`, () => {
+        const formattedCurrency = format.currency(1234.567, `EUR`, {
+            maximumFractionDigits: 1,
+        });
+        expect(formattedCurrency).toBe(`€1,234.6`);
+    });
+    it(`percentage formatter returns a formatted value`, () => {
+        const formattedPercentage1 = format.percentage(0.1234);
+        const formattedPercentage2 = format.percentage(0.1267);
+        expect(formattedPercentage1).toBe(`12%`);
+        expect(formattedPercentage2).toBe(`13%`);
+    });
+    it(`percentage formatter returns a formatted value with options`, () => {
+        const formattedPercentage = format.percentage(0.1234, {
+            minimumFractionDigits: 2,
+        });
+        expect(formattedPercentage).toBe(`12.34%`);
+    });
+});

package/dist/esm/createI18nContext/const/index.d.ts

@@ -1,2 +1,3 @@
 export declare const MISSING_TRANSLATION = "[MISSING TRANSLATION]";
+export declare const LRU_CACHE_MAX_SIZE = 500;
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/createI18nContext/const/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/createI18nContext/const/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/createI18nContext/const/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D,eAAO,MAAM,kBAAkB,MAAM,CAAC"}

package/dist/esm/createI18nContext/const/index.js

@@ -1 +1,2 @@
 export const MISSING_TRANSLATION = `[MISSING TRANSLATION]`;
+export const LRU_CACHE_MAX_SIZE = 500;

package/dist/esm/createI18nContext/index.d.ts

@@ -17,7 +17,7 @@ export declare function createI18nContext<Languages extends readonly string[], C
         setCurrentLanguage: import("react").Dispatch<import("react").SetStateAction<Languages[number]>>;
         currentLanguage: Languages[number];
         format: {
-            number: (value: number, options?: Intl.NumberFormatOptions) => string;
+            number: (value: number, options?: Omit<Intl.NumberFormatOptions, `style`>) => string;
             date: (value: Date | number, options?: Intl.DateTimeFormatOptions) => string;
             time: (value: Date | number, options?: Intl.DateTimeFormatOptions) => string;
             currency: (value: number, currency: string, options?: Omit<Intl.NumberFormatOptions, `style` | `currency`>) => string;

package/dist/esm/createI18nContext/util/cache.d.ts

@@ -0,0 +1,3 @@
+import LRUCache from "lru-cache";
+export declare function potentiallyWarnInvalidCacheState<K extends Intl.NumberFormatOptions | Intl.DateTimeFormatOptions, V extends Intl.NumberFormat | Intl.DateTimeFormat>(value: number | Date, cache: LRUCache<K, V>, options: K): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/esm/createI18nContext/util/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../src/createI18nContext/util/cache.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,WAAW,CAAC;AAEjC,wBAAgB,gCAAgC,CAC9C,CAAC,SAAS,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,qBAAqB,EAC/D,CAAC,SAAS,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,cAAc,EACjD,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,QAcxD"}

package/dist/esm/createI18nContext/util/cache.js

@@ -0,0 +1,19 @@
+import { IS_DEV } from "../../env";
+export function potentiallyWarnInvalidCacheState(value, cache, options) {
+    if (!IS_DEV) {
+        return;
+    }
+    const cachedKeys = Array.from(cache.keys());
+    const isEquivalent = cachedKeys.some((key) => shallowEqual(key, options));
+    if (isEquivalent) {
+        console.warn(`[i18n] ⚠️ Formatting ${value} with options ${JSON.stringify(options)} is not cached, but it should be. This is because you are recreating the options object on every render. To fix this, memoize the options object or define it outside of the component.`);
+    }
+}
+function shallowEqual(a, b) {
+    const aKeys = Object.keys(a);
+    const bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length) {
+        return false;
+    }
+    return aKeys.every((key) => a[key] === b[key]);
+}

package/dist/esm/env/index.d.ts

@@ -0,0 +1,2 @@
+export declare const IS_DEV: boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/env/index.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM,SACsD,CAAC"}

package/dist/esm/env/index.js

@@ -0,0 +1,2 @@
+const rawNodeEnv = process.env.NODE_ENV;
+export const IS_DEV = typeof __DEV__ !== `undefined` ? __DEV__ : rawNodeEnv === `development`;

package/dist/esm/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/env.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,MAAM,SACsD,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/env.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,MAAM,SACsD,CAAC"}

package/dist/esm/env.js

@@ -1,6 +1,2 @@
-const rawNodeEnv = typeof process !== `undefined` &&
-    process.env &&
-    typeof process.env.NODE_ENV === `string`
-    ? process.env.NODE_ENV
-    : undefined;
+const rawNodeEnv = process.env.NODE_ENV;
 export const IS_DEV = typeof __DEV__ !== `undefined` ? __DEV__ : rawNodeEnv === `development`;

package/dist/esm/vendor/lru-cache.d.ts

@@ -0,0 +1,3 @@
+import * as LRU from "lru-cache";
+export declare const LRUCache: typeof LRU;
+//# sourceMappingURL=lru-cache.d.ts.map

package/dist/esm/vendor/lru-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru-cache.d.ts","sourceRoot":"","sources":["../../../src/vendor/lru-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AAEjC,eAAO,MAAM,QAAQ,EAAE,OAAO,GACwB,CAAC"}

package/dist/esm/vendor/lru-cache.js

@@ -0,0 +1,2 @@
+import * as LRU from "lru-cache";
+export const LRUCache = LRU.LRUCache ?? LRU.default ?? LRU;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-scoped-i18n",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "A scoped internationalization (i18n) library for React applications",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -8,7 +8,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/akocan98/react-scoped-i18n"
+    "url": "git+https://github.com/akocan98/react-scoped-i18n.git"
   },
   "bugs": "https://github.com/akocan98/react-scoped-i18n/issues",
   "keywords": [
@@ -55,6 +55,7 @@
   "devDependencies": {
     "@testing-library/react": "^16.3.1",
     "@types/jest": "^30.0.0",
+    "@types/lru-cache": "^5.1.1",
     "@types/node": "^25.0.3",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
@@ -73,5 +74,8 @@
     "react-dom": "^19.2.0",
     "ts-jest": "^29.4.5",
     "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "lru-cache": "^5.1.1"
   }
 }