@pantho075/locale 0.1.0 → 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,60 +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 `const data = { ... }` wrapped in `withNullTopLevel`:
+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
-import { withNullTopLevel } from "../normalize";
-
-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 withNullTopLevel(data);
+setLocales({ en, bn });
 ```
 
-### Adding a new locale
-
-1. Create `src/locales/<code>.ts` that exports `withNullTopLevel(...)`.
-2. Import it in `src/getTranslation.ts` and add it to the `locales` map.
+Then anywhere in your app:
 
-## Missing-value semantics
+```ts
+import { useTranslation } from "@pantho075/locale";
 
-This is important — read it.
+function Greeting({ lang }: { lang: string }) {
+  const t = useTranslation<typeof en>(lang);
+  return <h1>{t.title}</h1>;
+}
+```
 
-| Situation                                | Returned value                              |
-| ---------------------------------------- | ------------------------------------------- |
-| Top-level key is **absent** from source  | `null` (Proxy returns null on miss)         |
-| Nested key is **absent** from source     | `undefined` (standard JS)                   |
-| Key is present with value `null`         | `null`                                      |
-| Key is present with a string/object/etc. | that value                                  |
+### Semantics
 
-So:
+- **`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.
 
-- `useTranslation('en').totallyMissing` → `null`
-- `useTranslation('en').home.missing` → `undefined`
-- `useTranslation('en').home.footer` (where `home.footer` isn't in source) → `undefined`
+### Adding a new locale
 
-If you need `null` for a missing nested key, write it explicitly in the source:
+You don't need to touch this package's source. Just add a file in your app and register it via `setLocales`:
 
 ```ts
-const data = {
-  home: {
-    header: "Hello",
-    footer: null, // explicit null, not "missing"
-  },
+// src/locales/ja.ts
+export default {
+  title: "こんにちは",
+  home: { header: "ヘッダー", footer: "フッター" },
 };
 ```
 
-The Proxy only wraps the **top level**. Nested objects are returned by reference, so they keep standard JS behavior — missing nested keys read as `undefined` and you can iterate them with `Object.keys()` etc.
+```ts
+// src/translations.ts
+import { setLocales } from "@pantho075/locale";
+import en from "./locales/en";
+import ja from "./locales/ja";
+
+setLocales({ en, ja });
+```
 
 ## API
 
@@ -132,19 +131,21 @@ React hook wrapping `getTranslation`. Memoized on `lang` — same language retur
 ```ts
 import { useTranslation } from "@pantho075/locale";
 
-const { title } = useTranslation("en"); // string | null
+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 or import the `normalize` helper directly 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

@@ -2,18 +2,6 @@
 
 var react = require('react');
 
-// src/normalize.ts
-function withNullTopLevel(data4) {
-  return new Proxy(data4, {
-    get(target, prop, receiver) {
-      if (typeof prop === "string" && !(prop in target)) {
-        return null;
-      }
-      return Reflect.get(target, prop, receiver);
-    }
-  });
-}
-
 // src/locales/bn.ts
 var data = {
   title: "\u09B6\u09BF\u09B0\u09CB\u09A8\u09BE\u09AE",
@@ -22,7 +10,7 @@ var data = {
     footer: "\u09AB\u09C1\u099F\u09BE\u09B0"
   }
 };
-var bn_default = withNullTopLevel(data);
+var bn_default = data;
 
 // src/locales/en.ts
 var data2 = {
@@ -32,7 +20,7 @@ var data2 = {
     footer: "this is footer"
   }
 };
-var en_default = withNullTopLevel(data2);
+var en_default = data2;
 
 // src/locales/ne.ts
 var data3 = {
@@ -42,7 +30,7 @@ var data3 = {
     footer: "this is footer"
   }
 };
-var ne_default = withNullTopLevel(data3);
+var ne_default = data3;
 
 // src/getTranslation.ts
 var EMPTY = Object.freeze({});
@@ -51,6 +39,9 @@ var locales = {
   bn: bn_default,
   ne: ne_default
 };
+function setLocales(next) {
+  locales = next;
+}
 function getTranslation(lang) {
   return locales[lang] ?? EMPTY;
 }
@@ -59,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/normalize.ts","../src/locales/bn.ts","../src/locales/en.ts","../src/locales/ne.ts","../src/getTranslation.ts","../src/useTranslation.ts"],"names":["data","useMemo"],"mappings":";;;;;AAUO,SAAS,iBAA4CA,KAAAA,EAAY;AACtE,EAAA,OAAO,IAAI,MAAMA,KAAAA,EAAM;AAAA,IACrB,GAAA,CAAI,MAAA,EAAQ,IAAA,EAAM,QAAA,EAAU;AAC1B,MAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,EAAE,QAAQ,MAAA,CAAA,EAAS;AACjD,QAAA,OAAO,IAAA;AAAA,MACT;AACA,MAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,MAAA,EAAQ,IAAA,EAAM,QAAQ,CAAA;AAAA,IAC3C;AAAA,GACD,CAAA;AACH;;;ACjBA,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,iBAAiB,IAAI,CAAA;;;ACRpC,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,GAAQ,iBAAiBA,KAAI,CAAA;;;ACRpC,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,GAAQ,iBAAiBA,KAAI,CAAA;;;ACJpC,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":["import type { TranslationData } from \"./types\";\n\n/**\n * Wrap a translation bundle in a Proxy that returns `null` for any\n * missing top-level key, while leaving nested objects untouched so\n * missing nested keys still resolve to `undefined` (standard JS\n * semantics).\n *\n * Explicit `null` values in the source are preserved.\n */\nexport function withNullTopLevel<T extends TranslationData>(data: T): T {\n  return new Proxy(data, {\n    get(target, prop, receiver) {\n      if (typeof prop === \"string\" && !(prop in target)) {\n        return null;\n      }\n      return Reflect.get(target, prop, receiver);\n    },\n  }) as T;\n}\n","import { withNullTopLevel } from \"../normalize\";\n\nconst data = {\n  title: \"শিরোনাম\",\n  home: {\n    header: \"হেডার\",\n    footer: \"ফুটার\",\n  },\n};\n\nexport default withNullTopLevel(data);\n","import { withNullTopLevel } from \"../normalize\";\n\nconst data = {\n  title: \"the title\",\n  home: {\n    header: \"this is header\",\n    footer: \"this is footer\",\n  },\n};\n\nexport default withNullTopLevel(data);\n","import { withNullTopLevel } from \"../normalize\";\n\nconst data = {\n  title: \"the title\",\n  home: {\n    header: \"this is header\",\n    footer: \"this is footer\",\n  },\n};\n\nexport default withNullTopLevel(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 `normalizeTopLevel(data)`\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

@@ -1,17 +1,5 @@
 import { useMemo } from 'react';
 
-// src/normalize.ts
-function withNullTopLevel(data4) {
-  return new Proxy(data4, {
-    get(target, prop, receiver) {
-      if (typeof prop === "string" && !(prop in target)) {
-        return null;
-      }
-      return Reflect.get(target, prop, receiver);
-    }
-  });
-}
-
 // src/locales/bn.ts
 var data = {
   title: "\u09B6\u09BF\u09B0\u09CB\u09A8\u09BE\u09AE",
@@ -20,7 +8,7 @@ var data = {
     footer: "\u09AB\u09C1\u099F\u09BE\u09B0"
   }
 };
-var bn_default = withNullTopLevel(data);
+var bn_default = data;
 
 // src/locales/en.ts
 var data2 = {
@@ -30,7 +18,7 @@ var data2 = {
     footer: "this is footer"
   }
 };
-var en_default = withNullTopLevel(data2);
+var en_default = data2;
 
 // src/locales/ne.ts
 var data3 = {
@@ -40,7 +28,7 @@ var data3 = {
     footer: "this is footer"
   }
 };
-var ne_default = withNullTopLevel(data3);
+var ne_default = data3;
 
 // src/getTranslation.ts
 var EMPTY = Object.freeze({});
@@ -49,6 +37,9 @@ var locales = {
   bn: bn_default,
   ne: ne_default
 };
+function setLocales(next) {
+  locales = next;
+}
 function getTranslation(lang) {
   return locales[lang] ?? EMPTY;
 }
@@ -56,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/normalize.ts","../src/locales/bn.ts","../src/locales/en.ts","../src/locales/ne.ts","../src/getTranslation.ts","../src/useTranslation.ts"],"names":["data"],"mappings":";;;AAUO,SAAS,iBAA4CA,KAAAA,EAAY;AACtE,EAAA,OAAO,IAAI,MAAMA,KAAAA,EAAM;AAAA,IACrB,GAAA,CAAI,MAAA,EAAQ,IAAA,EAAM,QAAA,EAAU;AAC1B,MAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,EAAE,QAAQ,MAAA,CAAA,EAAS;AACjD,QAAA,OAAO,IAAA;AAAA,MACT;AACA,MAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,MAAA,EAAQ,IAAA,EAAM,QAAQ,CAAA;AAAA,IAC3C;AAAA,GACD,CAAA;AACH;;;ACjBA,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,iBAAiB,IAAI,CAAA;;;ACRpC,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,GAAQ,iBAAiBA,KAAI,CAAA;;;ACRpC,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,GAAQ,iBAAiBA,KAAI,CAAA;;;ACJpC,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":["import type { TranslationData } from \"./types\";\n\n/**\n * Wrap a translation bundle in a Proxy that returns `null` for any\n * missing top-level key, while leaving nested objects untouched so\n * missing nested keys still resolve to `undefined` (standard JS\n * semantics).\n *\n * Explicit `null` values in the source are preserved.\n */\nexport function withNullTopLevel<T extends TranslationData>(data: T): T {\n  return new Proxy(data, {\n    get(target, prop, receiver) {\n      if (typeof prop === \"string\" && !(prop in target)) {\n        return null;\n      }\n      return Reflect.get(target, prop, receiver);\n    },\n  }) as T;\n}\n","import { withNullTopLevel } from \"../normalize\";\n\nconst data = {\n  title: \"শিরোনাম\",\n  home: {\n    header: \"হেডার\",\n    footer: \"ফুটার\",\n  },\n};\n\nexport default withNullTopLevel(data);\n","import { withNullTopLevel } from \"../normalize\";\n\nconst data = {\n  title: \"the title\",\n  home: {\n    header: \"this is header\",\n    footer: \"this is footer\",\n  },\n};\n\nexport default withNullTopLevel(data);\n","import { withNullTopLevel } from \"../normalize\";\n\nconst data = {\n  title: \"the title\",\n  home: {\n    header: \"this is header\",\n    footer: \"this is footer\",\n  },\n};\n\nexport default withNullTopLevel(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 `normalizeTopLevel(data)`\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.0",
+  "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,