@pantho075/locale 0.1.1 → 0.1.2

package/README.md

@@ -17,6 +17,8 @@ export function Example() {
 }
 ```
 
+The example above uses the package's built-in sample bundles (`en`, `bn`, `ne`). For real apps you'll want to use your own data — see [Using your own translations](#using-your-own-translations) below.
+
 ## Install
 
 ```bash
@@ -53,28 +55,57 @@ const { title, home } = getTranslation("en");
 console.log(title, home.header, home.footer);
 ```
 
-### Adding your own keys
+## Using your own translations
 
-Edit `src/locales/en.ts` (and `bn.ts`, `ne.ts`) in this package, or fork it. Each file is just a plain object exported as default:
+The package ships with three sample locales for demo purposes. To use your own translation data, call `setLocales(...)` once at app startup with a map of language code → bundle. After that, `getTranslation` and `useTranslation` return your data.
 
 ```ts
-// src/locales/en.ts
-const data = {
-  title: "Welcome",
-  home: {
-    header: "Hello",
-    footer: "Goodbye",
-  },
-  greeting: "Hi there",
-};
+// src/translations.ts
+import { setLocales } from "@pantho075/locale";
+import en from "./locales/en";
+import bn from "./locales/bn";
 
-export default data;
+setLocales({ en, bn });
 ```
 
+Then anywhere in your app:
+
+```ts
+import { useTranslation } from "@pantho075/locale";
+
+function Greeting({ lang }: { lang: string }) {
+  const t = useTranslation<typeof en>(lang);
+  return <h1>{t.title}</h1>;
+}
+```
+
+### Semantics
+
+- **`setLocales` replaces the entire map** — it does not merge. If you call `setLocales({ en })`, the previous `bn`/`ne` entries are gone and will return `{}`. Pass every locale you want available.
+- **One-shot setup.** Call `setLocales` at app startup. Calling it later does not invalidate previously memoized `useTranslation` results — if you need to swap locales at runtime, hold `lang` in reactive state and let React re-run the hook.
+- **Missing languages return `{}`** (the same frozen empty object every time — safe to compare with `===`).
+- **Missing keys return `undefined`** — standard JS object semantics. No proxy wrapping.
+
 ### Adding a new locale
 
-1. Create `src/locales/<code>.ts` that exports the locale object as default.
-2. Import it in `src/getTranslation.ts` and add it to the `locales` map.
+You don't need to touch this package's source. Just add a file in your app and register it via `setLocales`:
+
+```ts
+// src/locales/ja.ts
+export default {
+  title: "こんにちは",
+  home: { header: "ヘッダー", footer: "フッター" },
+};
+```
+
+```ts
+// src/translations.ts
+import { setLocales } from "@pantho075/locale";
+import en from "./locales/en";
+import ja from "./locales/ja";
+
+setLocales({ en, ja });
+```
 
 ## API
 
@@ -104,15 +135,17 @@ const { title } = useTranslation("en"); // string | undefined
 const en = useTranslation<English>("en"); // typed
 ```
 
+### `setLocales<T>(locales: Record<string, T>): void`
+
+Replaces the package's internal locale registry. Call once at app startup to swap in your own bundles. See [Using your own translations](#using-your-own-translations).
+
 ### `TranslationData`
 
 The default return type — `Record<string, unknown>`. Most consumers will constrain this with their own interface via the generic.
 
 ## Why no JSON files?
 
-Because the package ships its own locale data, it doesn't need to scan the consumer's filesystem, doesn't need a bundler alias, and doesn't need `resolveJsonModule`. The data is just regular TypeScript that gets tree-shaken and bundled like any other code.
-
-If you want to override locales from your own app, you can fork the package and build your own locale map.
+Translation data is just regular TypeScript that gets tree-shaken and bundled like any other code. `setLocales` lets your app own its own locale files without forking the package or shipping JSON.
 
 ## License
 

package/dist/index.cjs

@@ -39,6 +39,9 @@ var locales = {
   bn: bn_default,
   ne: ne_default
 };
+function setLocales(next) {
+  locales = next;
+}
 function getTranslation(lang) {
   return locales[lang] ?? EMPTY;
 }
@@ -47,6 +50,7 @@ function useTranslation(lang) {
 }
 
 exports.getTranslation = getTranslation;
+exports.setLocales = setLocales;
 exports.useTranslation = useTranslation;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/locales/bn.ts","../src/locales/en.ts","../src/locales/ne.ts","../src/getTranslation.ts","../src/useTranslation.ts"],"names":["data","useMemo"],"mappings":";;;;;AAAA,IAAM,IAAA,GAAO;AAAA,EACX,KAAA,EAAO,4CAAA;AAAA,EACP,IAAA,EAAM;AAAA,IACJ,MAAA,EAAQ,gCAAA;AAAA,IACR,MAAA,EAAQ;AAAA;AAEZ,CAAA;AAEA,IAAO,UAAA,GAAQ,IAAA;;;ACRf,IAAMA,KAAAA,GAAO;AAAA,EACX,KAAA,EAAO,WAAA;AAAA,EACP,IAAA,EAAM;AAAA,IACJ,MAAA,EAAQ,gBAAA;AAAA,IACR,MAAA,EAAQ;AAAA;AAEZ,CAAA;AAEA,IAAO,UAAA,GAAQA,KAAAA;;;ACRf,IAAMA,KAAAA,GAAO;AAAA,EACX,KAAA,EAAO,WAAA;AAAA,EACP,IAAA,EAAM;AAAA,IACJ,MAAA,EAAQ,gBAAA;AAAA,IACR,MAAA,EAAQ;AAAA;AAEZ,CAAA;AAEA,IAAO,UAAA,GAAQA,KAAAA;;;ACFf,IAAM,KAAA,GAAyB,MAAA,CAAO,MAAA,CAAO,EAAE,CAAA;AAQ/C,IAAM,OAAA,GAA2C;AAAA,EAC/C,EAAA,EAAA,UAAA;AAAA,EACA,EAAA,EAAA,UAAA;AAAA,EACA,EAAA,EAAA;AACF,CAAA;AASO,SAAS,eACd,IAAA,EACG;AACH,EAAA,OAAQ,OAAA,CAAQ,IAAI,CAAA,IAAK,KAAA;AAC3B;ACpBO,SAAS,eACd,IAAA,EACG;AACH,EAAA,OAAOC,cAAQ,MAAM,cAAA,CAAkB,IAAI,CAAA,EAAG,CAAC,IAAI,CAAC,CAAA;AACtD","file":"index.cjs","sourcesContent":["const data = {\n  title: \"শিরোনাম\",\n  home: {\n    header: \"হেডার\",\n    footer: \"ফুটার\",\n  },\n};\n\nexport default data;\n","const data = {\n  title: \"the title\",\n  home: {\n    header: \"this is header\",\n    footer: \"this is footer\",\n  },\n};\n\nexport default data;\n","const data = {\n  title: \"the title\",\n  home: {\n    header: \"this is header\",\n    footer: \"this is footer\",\n  },\n};\n\nexport default data;\n","import bn from \"./locales/bn\";\nimport en from \"./locales/en\";\nimport ne from \"./locales/ne\";\nimport type { TranslationData } from \"./types\";\n\n/** Shared empty fallback for unknown languages. Frozen so it can't be mutated. */\nconst EMPTY: TranslationData = Object.freeze({});\n\n/**\n * Locale registry. Adding a new language means:\n *   1. drop a `src/locales/<code>.ts` that exports the locale object as default\n *   2. import it here\n *   3. add it to this map\n */\nconst locales: Record<string, TranslationData> = {\n  en,\n  bn,\n  ne,\n};\n\n/**\n * Returns the translation bundle for the given language code.\n * Unknown / undefined / empty values fall back to a stable empty object.\n *\n * Framework-agnostic: works in React, Next.js server components, Vue,\n * Svelte, or vanilla Node scripts.\n */\nexport function getTranslation<T extends object = TranslationData>(\n  lang: string,\n): T {\n  return (locales[lang] ?? EMPTY) as T;\n}\n","import { useMemo } from \"react\";\nimport { getTranslation } from \"./getTranslation\";\nimport type { TranslationData } from \"./types\";\n\n/**\n * React hook: returns the translation bundle for the given language.\n *\n * Memoized on `lang`, so the same language produces a stable object\n * reference across re-renders. Switching language swaps the reference\n * (and any consumers destructuring top-level keys will re-render).\n */\nexport function useTranslation<T extends object = TranslationData>(\n  lang: string,\n): T {\n  return useMemo(() => getTranslation<T>(lang), [lang]);\n}\n"]}
+{"version":3,"sources":["../src/locales/bn.ts","../src/locales/en.ts","../src/locales/ne.ts","../src/getTranslation.ts","../src/useTranslation.ts"],"names":["data","useMemo"],"mappings":";;;;;AAAA,IAAM,IAAA,GAAO;AAAA,EACX,KAAA,EAAO,4CAAA;AAAA,EACP,IAAA,EAAM;AAAA,IACJ,MAAA,EAAQ,gCAAA;AAAA,IACR,MAAA,EAAQ;AAAA;AAEZ,CAAA;AAEA,IAAO,UAAA,GAAQ,IAAA;;;ACRf,IAAMA,KAAAA,GAAO;AAAA,EACX,KAAA,EAAO,WAAA;AAAA,EACP,IAAA,EAAM;AAAA,IACJ,MAAA,EAAQ,gBAAA;AAAA,IACR,MAAA,EAAQ;AAAA;AAEZ,CAAA;AAEA,IAAO,UAAA,GAAQA,KAAAA;;;ACRf,IAAMA,KAAAA,GAAO;AAAA,EACX,KAAA,EAAO,WAAA;AAAA,EACP,IAAA,EAAM;AAAA,IACJ,MAAA,EAAQ,gBAAA;AAAA,IACR,MAAA,EAAQ;AAAA;AAEZ,CAAA;AAEA,IAAO,UAAA,GAAQA,KAAAA;;;ACFf,IAAM,KAAA,GAAyB,MAAA,CAAO,MAAA,CAAO,EAAE,CAAA;AAY/C,IAAI,OAAA,GAA2C;AAAA,EAC7C,EAAA,EAAA,UAAA;AAAA,EACA,EAAA,EAAA,UAAA;AAAA,EACA,EAAA,EAAA;AACF,CAAA;AAuBO,SAAS,WACd,IAAA,EACM;AACN,EAAA,OAAA,GAAU,IAAA;AACZ;AASO,SAAS,eACd,IAAA,EACG;AACH,EAAA,OAAQ,OAAA,CAAQ,IAAI,CAAA,IAAK,KAAA;AAC3B;ACnDO,SAAS,eACd,IAAA,EACG;AACH,EAAA,OAAOC,cAAQ,MAAM,cAAA,CAAkB,IAAI,CAAA,EAAG,CAAC,IAAI,CAAC,CAAA;AACtD","file":"index.cjs","sourcesContent":["const data = {\n  title: \"শিরোনাম\",\n  home: {\n    header: \"হেডার\",\n    footer: \"ফুটার\",\n  },\n};\n\nexport default data;\n","const data = {\n  title: \"the title\",\n  home: {\n    header: \"this is header\",\n    footer: \"this is footer\",\n  },\n};\n\nexport default data;\n","const data = {\n  title: \"the title\",\n  home: {\n    header: \"this is header\",\n    footer: \"this is footer\",\n  },\n};\n\nexport default data;\n","import bn from \"./locales/bn\";\nimport en from \"./locales/en\";\nimport ne from \"./locales/ne\";\nimport type { TranslationData } from \"./types\";\n\n/** Shared empty fallback for unknown languages. Frozen so it can't be mutated. */\nconst EMPTY: TranslationData = Object.freeze({});\n\n/**\n * Locale registry. Adding a new language means:\n *   1. drop a `src/locales/<code>.ts` that exports the locale object as default\n *   2. import it here\n *   3. add it to this map\n *\n * These entries are the default sample bundles. Consumers that need to\n * translate their own data should call `setLocales(...)` once at app\n * startup to replace the entire map — see the README.\n */\nlet locales: Record<string, TranslationData> = {\n  en,\n  bn,\n  ne,\n};\n\n/**\n * Replace the package's locale registry with the consumer's bundles.\n *\n * The new map **replaces** the existing entries wholesale — it does\n * not merge. Pass every locale you want available; anything missing\n * from `next` will fall back to the empty bundle.\n *\n * This is intended as one-shot app startup configuration. It does\n * not invalidate previously memoized `useTranslation` results — if a\n * consumer swaps locales at runtime, they should pass `lang` as\n * reactive state so React re-runs the hook.\n *\n * @example\n * ```ts\n * import { setLocales } from \"@pantho075/locale\";\n * import { en } from \"./locales/en\";\n * import { bn } from \"./locales/bn\";\n *\n * setLocales({ en, bn });\n * ```\n */\nexport function setLocales<T extends object = TranslationData>(\n  next: Record<string, T>,\n): void {\n  locales = next as unknown as Record<string, TranslationData>;\n}\n\n/**\n * Returns the translation bundle for the given language code.\n * Unknown / undefined / empty values fall back to a stable empty object.\n *\n * Framework-agnostic: works in React, Next.js server components, Vue,\n * Svelte, or vanilla Node scripts.\n */\nexport function getTranslation<T extends object = TranslationData>(\n  lang: string,\n): T {\n  return (locales[lang] ?? EMPTY) as T;\n}\n","import { useMemo } from \"react\";\nimport { getTranslation } from \"./getTranslation\";\nimport type { TranslationData } from \"./types\";\n\n/**\n * React hook: returns the translation bundle for the given language.\n *\n * Memoized on `lang`, so the same language produces a stable object\n * reference across re-renders. Switching language swaps the reference\n * (and any consumers destructuring top-level keys will re-render).\n */\nexport function useTranslation<T extends object = TranslationData>(\n  lang: string,\n): T {\n  return useMemo(() => getTranslation<T>(lang), [lang]);\n}\n"]}

package/dist/index.d.cts

@@ -4,6 +4,28 @@
  */
 type TranslationData = Record<string, unknown>;
 
+/**
+ * Replace the package's locale registry with the consumer's bundles.
+ *
+ * The new map **replaces** the existing entries wholesale — it does
+ * not merge. Pass every locale you want available; anything missing
+ * from `next` will fall back to the empty bundle.
+ *
+ * This is intended as one-shot app startup configuration. It does
+ * not invalidate previously memoized `useTranslation` results — if a
+ * consumer swaps locales at runtime, they should pass `lang` as
+ * reactive state so React re-runs the hook.
+ *
+ * @example
+ * ```ts
+ * import { setLocales } from "@pantho075/locale";
+ * import { en } from "./locales/en";
+ * import { bn } from "./locales/bn";
+ *
+ * setLocales({ en, bn });
+ * ```
+ */
+declare function setLocales<T extends object = TranslationData>(next: Record<string, T>): void;
 /**
  * Returns the translation bundle for the given language code.
  * Unknown / undefined / empty values fall back to a stable empty object.
@@ -22,4 +44,4 @@ declare function getTranslation<T extends object = TranslationData>(lang: string
  */
 declare function useTranslation<T extends object = TranslationData>(lang: string): T;
 
-export { type TranslationData, getTranslation, useTranslation };
+export { type TranslationData, getTranslation, setLocales, useTranslation };

package/dist/index.d.ts

@@ -4,6 +4,28 @@
  */
 type TranslationData = Record<string, unknown>;
 
+/**
+ * Replace the package's locale registry with the consumer's bundles.
+ *
+ * The new map **replaces** the existing entries wholesale — it does
+ * not merge. Pass every locale you want available; anything missing
+ * from `next` will fall back to the empty bundle.
+ *
+ * This is intended as one-shot app startup configuration. It does
+ * not invalidate previously memoized `useTranslation` results — if a
+ * consumer swaps locales at runtime, they should pass `lang` as
+ * reactive state so React re-runs the hook.
+ *
+ * @example
+ * ```ts
+ * import { setLocales } from "@pantho075/locale";
+ * import { en } from "./locales/en";
+ * import { bn } from "./locales/bn";
+ *
+ * setLocales({ en, bn });
+ * ```
+ */
+declare function setLocales<T extends object = TranslationData>(next: Record<string, T>): void;
 /**
  * Returns the translation bundle for the given language code.
  * Unknown / undefined / empty values fall back to a stable empty object.
@@ -22,4 +44,4 @@ declare function getTranslation<T extends object = TranslationData>(lang: string
  */
 declare function useTranslation<T extends object = TranslationData>(lang: string): T;
 
-export { type TranslationData, getTranslation, useTranslation };
+export { type TranslationData, getTranslation, setLocales, useTranslation };

package/dist/index.js

@@ -37,6 +37,9 @@ var locales = {
   bn: bn_default,
   ne: ne_default
 };
+function setLocales(next) {
+  locales = next;
+}
 function getTranslation(lang) {
   return locales[lang] ?? EMPTY;
 }
@@ -44,6 +47,6 @@ function useTranslation(lang) {
   return useMemo(() => getTranslation(lang), [lang]);
 }
 
-export { getTranslation, useTranslation };
+export { getTranslation, setLocales, useTranslation };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/locales/bn.ts","../src/locales/en.ts","../src/locales/ne.ts","../src/getTranslation.ts","../src/useTranslation.ts"],"names":["data"],"mappings":";;;AAAA,IAAM,IAAA,GAAO;AAAA,EACX,KAAA,EAAO,4CAAA;AAAA,EACP,IAAA,EAAM;AAAA,IACJ,MAAA,EAAQ,gCAAA;AAAA,IACR,MAAA,EAAQ;AAAA;AAEZ,CAAA;AAEA,IAAO,UAAA,GAAQ,IAAA;;;ACRf,IAAMA,KAAAA,GAAO;AAAA,EACX,KAAA,EAAO,WAAA;AAAA,EACP,IAAA,EAAM;AAAA,IACJ,MAAA,EAAQ,gBAAA;AAAA,IACR,MAAA,EAAQ;AAAA;AAEZ,CAAA;AAEA,IAAO,UAAA,GAAQA,KAAAA;;;ACRf,IAAMA,KAAAA,GAAO;AAAA,EACX,KAAA,EAAO,WAAA;AAAA,EACP,IAAA,EAAM;AAAA,IACJ,MAAA,EAAQ,gBAAA;AAAA,IACR,MAAA,EAAQ;AAAA;AAEZ,CAAA;AAEA,IAAO,UAAA,GAAQA,KAAAA;;;ACFf,IAAM,KAAA,GAAyB,MAAA,CAAO,MAAA,CAAO,EAAE,CAAA;AAQ/C,IAAM,OAAA,GAA2C;AAAA,EAC/C,EAAA,EAAA,UAAA;AAAA,EACA,EAAA,EAAA,UAAA;AAAA,EACA,EAAA,EAAA;AACF,CAAA;AASO,SAAS,eACd,IAAA,EACG;AACH,EAAA,OAAQ,OAAA,CAAQ,IAAI,CAAA,IAAK,KAAA;AAC3B;ACpBO,SAAS,eACd,IAAA,EACG;AACH,EAAA,OAAO,QAAQ,MAAM,cAAA,CAAkB,IAAI,CAAA,EAAG,CAAC,IAAI,CAAC,CAAA;AACtD","file":"index.js","sourcesContent":["const data = {\n  title: \"শিরোনাম\",\n  home: {\n    header: \"হেডার\",\n    footer: \"ফুটার\",\n  },\n};\n\nexport default data;\n","const data = {\n  title: \"the title\",\n  home: {\n    header: \"this is header\",\n    footer: \"this is footer\",\n  },\n};\n\nexport default data;\n","const data = {\n  title: \"the title\",\n  home: {\n    header: \"this is header\",\n    footer: \"this is footer\",\n  },\n};\n\nexport default data;\n","import bn from \"./locales/bn\";\nimport en from \"./locales/en\";\nimport ne from \"./locales/ne\";\nimport type { TranslationData } from \"./types\";\n\n/** Shared empty fallback for unknown languages. Frozen so it can't be mutated. */\nconst EMPTY: TranslationData = Object.freeze({});\n\n/**\n * Locale registry. Adding a new language means:\n *   1. drop a `src/locales/<code>.ts` that exports the locale object as default\n *   2. import it here\n *   3. add it to this map\n */\nconst locales: Record<string, TranslationData> = {\n  en,\n  bn,\n  ne,\n};\n\n/**\n * Returns the translation bundle for the given language code.\n * Unknown / undefined / empty values fall back to a stable empty object.\n *\n * Framework-agnostic: works in React, Next.js server components, Vue,\n * Svelte, or vanilla Node scripts.\n */\nexport function getTranslation<T extends object = TranslationData>(\n  lang: string,\n): T {\n  return (locales[lang] ?? EMPTY) as T;\n}\n","import { useMemo } from \"react\";\nimport { getTranslation } from \"./getTranslation\";\nimport type { TranslationData } from \"./types\";\n\n/**\n * React hook: returns the translation bundle for the given language.\n *\n * Memoized on `lang`, so the same language produces a stable object\n * reference across re-renders. Switching language swaps the reference\n * (and any consumers destructuring top-level keys will re-render).\n */\nexport function useTranslation<T extends object = TranslationData>(\n  lang: string,\n): T {\n  return useMemo(() => getTranslation<T>(lang), [lang]);\n}\n"]}
+{"version":3,"sources":["../src/locales/bn.ts","../src/locales/en.ts","../src/locales/ne.ts","../src/getTranslation.ts","../src/useTranslation.ts"],"names":["data"],"mappings":";;;AAAA,IAAM,IAAA,GAAO;AAAA,EACX,KAAA,EAAO,4CAAA;AAAA,EACP,IAAA,EAAM;AAAA,IACJ,MAAA,EAAQ,gCAAA;AAAA,IACR,MAAA,EAAQ;AAAA;AAEZ,CAAA;AAEA,IAAO,UAAA,GAAQ,IAAA;;;ACRf,IAAMA,KAAAA,GAAO;AAAA,EACX,KAAA,EAAO,WAAA;AAAA,EACP,IAAA,EAAM;AAAA,IACJ,MAAA,EAAQ,gBAAA;AAAA,IACR,MAAA,EAAQ;AAAA;AAEZ,CAAA;AAEA,IAAO,UAAA,GAAQA,KAAAA;;;ACRf,IAAMA,KAAAA,GAAO;AAAA,EACX,KAAA,EAAO,WAAA;AAAA,EACP,IAAA,EAAM;AAAA,IACJ,MAAA,EAAQ,gBAAA;AAAA,IACR,MAAA,EAAQ;AAAA;AAEZ,CAAA;AAEA,IAAO,UAAA,GAAQA,KAAAA;;;ACFf,IAAM,KAAA,GAAyB,MAAA,CAAO,MAAA,CAAO,EAAE,CAAA;AAY/C,IAAI,OAAA,GAA2C;AAAA,EAC7C,EAAA,EAAA,UAAA;AAAA,EACA,EAAA,EAAA,UAAA;AAAA,EACA,EAAA,EAAA;AACF,CAAA;AAuBO,SAAS,WACd,IAAA,EACM;AACN,EAAA,OAAA,GAAU,IAAA;AACZ;AASO,SAAS,eACd,IAAA,EACG;AACH,EAAA,OAAQ,OAAA,CAAQ,IAAI,CAAA,IAAK,KAAA;AAC3B;ACnDO,SAAS,eACd,IAAA,EACG;AACH,EAAA,OAAO,QAAQ,MAAM,cAAA,CAAkB,IAAI,CAAA,EAAG,CAAC,IAAI,CAAC,CAAA;AACtD","file":"index.js","sourcesContent":["const data = {\n  title: \"শিরোনাম\",\n  home: {\n    header: \"হেডার\",\n    footer: \"ফুটার\",\n  },\n};\n\nexport default data;\n","const data = {\n  title: \"the title\",\n  home: {\n    header: \"this is header\",\n    footer: \"this is footer\",\n  },\n};\n\nexport default data;\n","const data = {\n  title: \"the title\",\n  home: {\n    header: \"this is header\",\n    footer: \"this is footer\",\n  },\n};\n\nexport default data;\n","import bn from \"./locales/bn\";\nimport en from \"./locales/en\";\nimport ne from \"./locales/ne\";\nimport type { TranslationData } from \"./types\";\n\n/** Shared empty fallback for unknown languages. Frozen so it can't be mutated. */\nconst EMPTY: TranslationData = Object.freeze({});\n\n/**\n * Locale registry. Adding a new language means:\n *   1. drop a `src/locales/<code>.ts` that exports the locale object as default\n *   2. import it here\n *   3. add it to this map\n *\n * These entries are the default sample bundles. Consumers that need to\n * translate their own data should call `setLocales(...)` once at app\n * startup to replace the entire map — see the README.\n */\nlet locales: Record<string, TranslationData> = {\n  en,\n  bn,\n  ne,\n};\n\n/**\n * Replace the package's locale registry with the consumer's bundles.\n *\n * The new map **replaces** the existing entries wholesale — it does\n * not merge. Pass every locale you want available; anything missing\n * from `next` will fall back to the empty bundle.\n *\n * This is intended as one-shot app startup configuration. It does\n * not invalidate previously memoized `useTranslation` results — if a\n * consumer swaps locales at runtime, they should pass `lang` as\n * reactive state so React re-runs the hook.\n *\n * @example\n * ```ts\n * import { setLocales } from \"@pantho075/locale\";\n * import { en } from \"./locales/en\";\n * import { bn } from \"./locales/bn\";\n *\n * setLocales({ en, bn });\n * ```\n */\nexport function setLocales<T extends object = TranslationData>(\n  next: Record<string, T>,\n): void {\n  locales = next as unknown as Record<string, TranslationData>;\n}\n\n/**\n * Returns the translation bundle for the given language code.\n * Unknown / undefined / empty values fall back to a stable empty object.\n *\n * Framework-agnostic: works in React, Next.js server components, Vue,\n * Svelte, or vanilla Node scripts.\n */\nexport function getTranslation<T extends object = TranslationData>(\n  lang: string,\n): T {\n  return (locales[lang] ?? EMPTY) as T;\n}\n","import { useMemo } from \"react\";\nimport { getTranslation } from \"./getTranslation\";\nimport type { TranslationData } from \"./types\";\n\n/**\n * React hook: returns the translation bundle for the given language.\n *\n * Memoized on `lang`, so the same language produces a stable object\n * reference across re-renders. Switching language swaps the reference\n * (and any consumers destructuring top-level keys will re-render).\n */\nexport function useTranslation<T extends object = TranslationData>(\n  lang: string,\n): T {\n  return useMemo(() => getTranslation<T>(lang), [lang]);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pantho075/locale",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Tiny framework-agnostic i18n core. Translation data lives in TS, no JSON files, no provider. Works in React, Next.js, Vue, Svelte, and Node.",
   "type": "module",
   "sideEffects": false,