@verbumia/react-i18next 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Verbumia
+
+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/README.md

@@ -0,0 +1,244 @@
+# @verbumia/react-i18next
+
+[![MIT licensed](https://img.shields.io/npm/l/@verbumia/react-i18next.svg)](./LICENSE)
+
+The React SDK for [Verbumia](https://verbumia.ca). Resolve translations from
+the Verbumia CDN, fall back gracefully when a key is missing, and stream those
+missing keys back to your dashboard in real time so the team can fill them
+without redeploying.
+
+```bash
+npm install @verbumia/react-i18next
+```
+
+- ✦ Zero-config CDN fetch (Bunny.net edge)
+- ✦ Built-in missing-key handler with first-paint anti-spam gate
+- ✦ Pluggable transport for Storybook / inspectors
+- ✦ < 10 KB ESM (gzipped much smaller), tree-shakeable
+- ✦ Plain `t()` + `<Trans>` semantics — drop-in for most i18next codebases
+
+---
+
+## Quickstart
+
+```tsx
+import { VerbumiaProvider, useTranslation } from "@verbumia/react-i18next";
+
+export function App() {
+  return (
+    <VerbumiaProvider
+      token={import.meta.env.VITE_VERBUMIA_TOKEN}
+      projectUuid={import.meta.env.VITE_VERBUMIA_PROJECT}
+      defaultLocale="fr"
+      fallbackLng="en"
+      namespaces={["common"]}
+    >
+      <Hello />
+    </VerbumiaProvider>
+  );
+}
+
+function Hello() {
+  const { t, i18n } = useTranslation("common");
+  if (!i18n.ready) return <span>Loading…</span>;
+  return <h1>{t("hello.title", { name: "Marc", defaultValue: "Hello {{name}}" })}</h1>;
+}
+```
+
+The token is the API key minted in **Org Settings → API Keys**. For the
+browser SDK use a **project-scoped** key with the `missing:write` scope and
+nothing else — that key only sees missing-key writes for one project, which
+is the safest exposure profile.
+
+---
+
+## API surface
+
+### `VerbumiaProvider`
+
+```ts
+interface VerbumiaConfig {
+  token: string;                  // vrb_live_<prefix>.<secret>
+  projectUuid: string;
+  defaultLocale: string;          // BCP-47 (e.g. "fr", "fr-CA")
+  fallbackLng?: string;           // resolved before reporting a key as missing
+  namespaces?: string[];          // default ['common']
+  apiBase?: string;               // default 'https://api.verbumia.ca'
+  cdnBase?: string;               // default 'https://cdn.verbumia.ca'
+  transport?: (batch: MissingKeyEvent[]) => void | Promise<void>;
+  missingHandler?: 'send' | 'log' | 'off';   // default 'send'
+  flushIntervalMs?: number;       // default 5000
+  flushBatchSize?: number;        // default 50
+  missingEventsBufferSize?: number; // default 200
+}
+```
+
+### `useTranslation(defaultNamespace?)`
+
+Returns `{ t, i18n }`.
+
+```ts
+type TranslationFunction = (
+  key: string,                                  // "ns:key.path" or "key.path"
+  options?: Record<string, unknown> & { defaultValue?: string }
+) => string;
+
+interface I18nInstance {
+  ready: boolean;
+  locale: string;
+  setLocale(next: string): Promise<void>;
+  missingEvents: MissingKeyEvent[];             // newest first, capped buffer
+  flushMissing(): Promise<void>;                // force-flush the pending batch
+}
+```
+
+### `<Trans>`
+
+Inline translation with JSX slots:
+
+```tsx
+<Trans
+  i18nKey="cta.terms"
+  defaults="I accept the <0>terms</0> and <1>privacy policy</1>"
+  components={[<a href="/terms" />, <a href="/privacy" />]}
+/>
+```
+
+The `<0>...</0>` slots are 0-indexed into `components`. The bundle string
+should follow the same shape so that translators see `I accept the <0>terms</0>...`
+and the SDK swaps the elements at render time.
+
+---
+
+## Missing-key flow
+
+1. The user navigates a page that calls `t("hello.title")`.
+2. The bundle for `(locale, namespace)` was already fetched but doesn't
+   contain `hello.title`. (`i18n.ready === true` and the bundle for that
+   tuple is in the "attempted" set — this is the **gate**.)
+3. The SDK enqueues a `MissingKeyEvent`, dedups it within the instance, and
+   pushes it into the `missingEvents` ring buffer.
+4. Every `flushIntervalMs` (default 5s) — or sooner if the batch hits
+   `flushBatchSize` (default 50) — the SDK flushes the pending batch via
+   the transport.
+
+```ts
+interface MissingKeyEvent {
+  key: string;
+  namespace: string;
+  language_code: string;
+  source_value?: string;
+  sdk_meta?: Record<string, unknown>;  // SDK adds {lib, ver, url} automatically
+}
+```
+
+### Why the gate matters
+
+Without the gate, every `t("…")` call between mount and bundle resolution
+would report a "missing" key — which is a lie (the bundle just hadn't
+arrived yet). The first-paint flood would poison your dashboard. The SDK
+holds reports until both:
+
+- `i18n.ready === true` (initial bundles loaded), AND
+- the specific `(locale, namespace)` bundle was actually fetched.
+
+You can see the gate in action with `i18n.missingEvents` — it stays empty
+until the network round-trip completes.
+
+---
+
+## Custom transport
+
+Replace the default POST with anything — Storybook mock, in-app inspector,
+Cypress capture:
+
+```tsx
+<VerbumiaProvider
+  {...config}
+  transport={(batch) => {
+    window.parent.postMessage({ type: "verbumia:missing", batch }, "*");
+  }}
+>
+  ...
+</VerbumiaProvider>
+```
+
+The default delivery path is also exported if you need to wrap it:
+
+```ts
+import { defaultTransport, logTransport } from "@verbumia/react-i18next";
+```
+
+---
+
+## Recipes
+
+### Next.js (App Router)
+
+Wrap the SDK in a Client Component and feed it env vars from `.env.local`:
+
+```tsx
+// app/(verbumia)/i18n-client.tsx
+"use client";
+import { VerbumiaProvider } from "@verbumia/react-i18next";
+
+export function I18nClient({ children }: { children: React.ReactNode }) {
+  return (
+    <VerbumiaProvider
+      token={process.env.NEXT_PUBLIC_VERBUMIA_TOKEN!}
+      projectUuid={process.env.NEXT_PUBLIC_VERBUMIA_PROJECT!}
+      defaultLocale="fr"
+      fallbackLng="en"
+    >
+      {children}
+    </VerbumiaProvider>
+  );
+}
+```
+
+The provider reads the bundle via the public CDN — no server-side state to
+hydrate. SSR pre-renders the `defaultValue` and the client smoothly
+upgrades after `i18n.ready` flips.
+
+### Storybook
+
+```ts
+// .storybook/preview.tsx
+import { VerbumiaProvider } from "@verbumia/react-i18next";
+
+export const decorators = [
+  (Story) => (
+    <VerbumiaProvider
+      token="vrb_live_storybook.fake"
+      projectUuid="storybook"
+      defaultLocale="fr"
+      missingHandler="log"
+      transport={(batch) => action("missing-keys")(batch)}
+    >
+      <Story />
+    </VerbumiaProvider>
+  ),
+];
+```
+
+### Cypress
+
+```ts
+cy.intercept("POST", "**/v1/missing", (req) => {
+  cy.task("captureMissing", req.body);
+  req.reply({ accepted: req.body.events.length, rejected: 0, items: [] });
+});
+```
+
+---
+
+## Versioning
+
+Semver. V1.x will keep the public API stable. Internal changes (bundle
+fetcher, dedup heuristics) may shift in patch releases.
+
+Breaking changes pre-V1 are flagged in [CONTRACT.md](./CONTRACT.md).
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/index.cjs

@@ -0,0 +1,364 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Trans: () => Trans,
+  VerbumiaProvider: () => VerbumiaProvider,
+  defaultTransport: () => defaultTransport,
+  logTransport: () => logTransport,
+  useTranslation: () => useTranslation
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/provider.tsx
+var import_react = require("react");
+
+// src/transport.ts
+var SDK_LIB = "@verbumia/react-i18next";
+var SDK_VER = "0.1.0";
+function defaultTransport(opts) {
+  return async (batch) => {
+    if (!batch.length) return;
+    const body = {
+      project_uuid: opts.projectUuid,
+      events: batch.map((e) => ({
+        key: e.key,
+        namespace: e.namespace,
+        language_code: e.language_code,
+        source_value: e.source_value,
+        sdk_meta: {
+          lib: SDK_LIB,
+          ver: SDK_VER,
+          ...typeof window !== "undefined" ? { url: window.location?.href } : {},
+          ...e.sdk_meta ?? {}
+        }
+      }))
+    };
+    try {
+      await fetch(`${opts.apiBase.replace(/\/+$/, "")}/v1/missing`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `ApiKey ${opts.token}`
+        },
+        body: JSON.stringify(body),
+        // SDKs are best-effort; never block the render path
+        keepalive: true
+      });
+    } catch {
+    }
+  };
+}
+var logTransport = (batch) => {
+  for (const e of batch) {
+    console.warn("[verbumia] missing key", e);
+  }
+};
+
+// src/i18n.ts
+var DEFAULT_API_BASE = "https://api.verbumia.ca";
+var DEFAULT_CDN_BASE = "https://cdn.verbumia.ca";
+var DEFAULT_FLUSH_MS = 5e3;
+var DEFAULT_BATCH = 50;
+var DEFAULT_BUFFER = 200;
+function resolve(bundle, key) {
+  if (!bundle) return void 0;
+  const parts = key.split(".");
+  let cur = bundle;
+  for (const p of parts) {
+    if (cur && typeof cur === "object" && p in cur) {
+      cur = cur[p];
+    } else {
+      return void 0;
+    }
+  }
+  return typeof cur === "string" ? cur : void 0;
+}
+function interpolate(template, options) {
+  if (!options) return template;
+  return template.replace(/\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g, (_m, name) => {
+    const v = options[name];
+    return v == null ? "" : String(v);
+  });
+}
+var VerbumiaI18n = class {
+  ready = false;
+  locale;
+  fallbackLng;
+  missingEvents = [];
+  _bundles = /* @__PURE__ */ new Map();
+  // `${locale}/${ns}` -> tree
+  _attempted = /* @__PURE__ */ new Set();
+  // `${locale}/${ns}` keys we've fetched
+  _config;
+  _transport;
+  _pending = [];
+  _seen = /* @__PURE__ */ new Set();
+  // dedup `${locale}/${ns}/${key}` per-flush
+  _timer = null;
+  _listeners = /* @__PURE__ */ new Set();
+  constructor(config) {
+    this.locale = config.defaultLocale;
+    this.fallbackLng = config.fallbackLng;
+    this._config = {
+      apiBase: config.apiBase ?? DEFAULT_API_BASE,
+      cdnBase: config.cdnBase ?? DEFAULT_CDN_BASE,
+      missingHandler: config.missingHandler ?? "send",
+      token: config.token,
+      projectUuid: config.projectUuid,
+      namespaces: config.namespaces?.length ? config.namespaces : ["common"],
+      flushIntervalMs: config.flushIntervalMs ?? DEFAULT_FLUSH_MS,
+      flushBatchSize: config.flushBatchSize ?? DEFAULT_BATCH,
+      missingEventsBufferSize: config.missingEventsBufferSize ?? DEFAULT_BUFFER
+    };
+    this._transport = config.transport ?? (this._config.missingHandler === "log" ? logTransport : defaultTransport({
+      apiBase: this._config.apiBase,
+      token: this._config.token,
+      projectUuid: this._config.projectUuid
+    }));
+  }
+  // ---- React subscription ----
+  subscribe = (listener) => {
+    this._listeners.add(listener);
+    return () => this._listeners.delete(listener);
+  };
+  _notify() {
+    for (const l of this._listeners) l();
+  }
+  // ---- Lifecycle ----
+  /** Loads the configured namespaces for the active locale + fallback. */
+  async start(fetchImpl = fetch) {
+    const targets = /* @__PURE__ */ new Set([this.locale]);
+    if (this.fallbackLng) targets.add(this.fallbackLng);
+    await Promise.all(
+      [...targets].flatMap(
+        (loc) => this._config.namespaces.map((ns) => this._loadBundle(loc, ns, fetchImpl))
+      )
+    );
+    this.ready = true;
+    this._startTimer();
+    this._notify();
+  }
+  setLocale = async (next) => {
+    if (next === this.locale) return;
+    this.locale = next;
+    this.ready = false;
+    this._notify();
+    await Promise.all(
+      this._config.namespaces.map((ns) => this._loadBundle(next, ns))
+    );
+    this.ready = true;
+    this._notify();
+  };
+  stop() {
+    if (this._timer) {
+      clearInterval(this._timer);
+      this._timer = null;
+    }
+  }
+  // ---- Translation ----
+  t = (key, options) => {
+    const namespace = this._splitNamespace(key);
+    const bareKey = namespace.bareKey;
+    const ns = namespace.ns;
+    const fromActive = resolve(this._bundles.get(`${this.locale}/${ns}`), bareKey);
+    if (fromActive != null) return interpolate(fromActive, options);
+    if (this.fallbackLng && this.fallbackLng !== this.locale) {
+      const fb = resolve(this._bundles.get(`${this.fallbackLng}/${ns}`), bareKey);
+      if (fb != null) return interpolate(fb, options);
+    }
+    if (this.ready && this._attempted.has(`${this.locale}/${ns}`)) {
+      this._reportMissing({
+        key: bareKey,
+        namespace: ns,
+        language_code: this.locale,
+        source_value: typeof options?.defaultValue === "string" ? options.defaultValue : void 0
+      });
+    }
+    const defaultValue = options?.defaultValue;
+    if (typeof defaultValue === "string") {
+      return interpolate(defaultValue, options);
+    }
+    return key;
+  };
+  flushMissing = async () => {
+    if (!this._pending.length) return;
+    const batch = this._pending.slice(0);
+    this._pending = [];
+    if (this._config.missingHandler === "off") return;
+    try {
+      await this._transport(batch);
+    } catch {
+    }
+  };
+  // ---- Internals ----
+  _splitNamespace(key) {
+    const idx = key.indexOf(":");
+    if (idx > 0) {
+      return { ns: key.slice(0, idx), bareKey: key.slice(idx + 1) };
+    }
+    return { ns: this._config.namespaces[0], bareKey: key };
+  }
+  async _loadBundle(locale, ns, fetchImpl = fetch) {
+    const url = `${this._config.cdnBase.replace(/\/+$/, "")}/p/${this._config.projectUuid}/latest/${locale}/${ns}.json`;
+    try {
+      const r = await fetchImpl(url, { method: "GET", credentials: "omit" });
+      if (r.ok) {
+        const data = await r.json();
+        this._bundles.set(`${locale}/${ns}`, data);
+      } else {
+        this._bundles.set(`${locale}/${ns}`, {});
+      }
+    } catch {
+      this._bundles.set(`${locale}/${ns}`, {});
+    } finally {
+      this._attempted.add(`${locale}/${ns}`);
+    }
+  }
+  _startTimer() {
+    if (this._config.missingHandler === "off") return;
+    if (typeof setInterval !== "function") return;
+    this._timer = setInterval(() => {
+      void this.flushMissing();
+    }, this._config.flushIntervalMs);
+  }
+  _reportMissing(event) {
+    if (this._config.missingHandler === "off") return;
+    const dedupKey = `${event.language_code}/${event.namespace}/${event.key}`;
+    if (this._seen.has(dedupKey)) return;
+    this._seen.add(dedupKey);
+    this.missingEvents = [event, ...this.missingEvents].slice(
+      0,
+      this._config.missingEventsBufferSize
+    );
+    this._pending.push(event);
+    if (this._pending.length >= this._config.flushBatchSize) {
+      void this.flushMissing();
+    }
+    this._notify();
+  }
+};
+
+// src/provider.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var VerbumiaContext = (0, import_react.createContext)(null);
+function VerbumiaProvider({
+  children,
+  ...config
+}) {
+  const i18n = (0, import_react.useMemo)(() => new VerbumiaI18n(config), []);
+  (0, import_react.useEffect)(() => {
+    void i18n.start();
+    return () => i18n.stop();
+  }, [i18n]);
+  const value = (0, import_react.useMemo)(() => ({ i18n }), [i18n]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(VerbumiaContext.Provider, { value, children });
+}
+function useI18n() {
+  const ctx = (0, import_react.useContext)(VerbumiaContext);
+  if (!ctx) {
+    throw new Error("useTranslation/Trans must be used inside <VerbumiaProvider>");
+  }
+  return ctx.i18n;
+}
+function useI18nSnapshot() {
+  const i18n = useI18n();
+  return (0, import_react.useSyncExternalStore)(
+    i18n.subscribe,
+    () => ({
+      ready: i18n.ready,
+      locale: i18n.locale,
+      setLocale: i18n.setLocale,
+      missingEvents: i18n.missingEvents,
+      flushMissing: i18n.flushMissing
+    }),
+    () => ({
+      ready: false,
+      locale: i18n.locale,
+      setLocale: i18n.setLocale,
+      missingEvents: [],
+      flushMissing: i18n.flushMissing
+    })
+  );
+}
+
+// src/hooks.ts
+var import_react2 = require("react");
+function useTranslation(defaultNamespace) {
+  const i18n = useI18n();
+  const snapshot = useI18nSnapshot();
+  const t = (0, import_react2.useMemo)(() => {
+    return (key, options) => {
+      const fullKey = defaultNamespace && !key.includes(":") ? `${defaultNamespace}:${key}` : key;
+      return i18n.t(fullKey, options);
+    };
+  }, [i18n, defaultNamespace]);
+  return { t, i18n: snapshot };
+}
+
+// src/trans.tsx
+var import_react3 = require("react");
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function Trans({
+  i18nKey,
+  defaults,
+  values,
+  components,
+  namespace
+}) {
+  const { t } = useTranslation(namespace);
+  const raw = t(i18nKey, { ...values ?? {}, defaultValue: defaults ?? i18nKey });
+  if (!components || !components.length) return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children: raw });
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children: splitOnComponents(raw, components) });
+}
+function splitOnComponents(text, components) {
+  const out = [];
+  const re = /<(\d+)>(.*?)<\/\1>/g;
+  let lastIndex = 0;
+  let m;
+  while ((m = re.exec(text)) !== null) {
+    if (m.index > lastIndex) out.push(text.slice(lastIndex, m.index));
+    const idx = Number(m[1]);
+    const inner = m[2];
+    const node = components[idx];
+    if ((0, import_react3.isValidElement)(node)) {
+      out.push(
+        (0, import_react3.cloneElement)(node, { key: `t-${m.index}` }, ...import_react3.Children.toArray(inner ?? ""))
+      );
+    } else if (node !== void 0) {
+      out.push(node);
+    } else {
+      out.push(inner ?? "");
+    }
+    lastIndex = re.lastIndex;
+  }
+  if (lastIndex < text.length) out.push(text.slice(lastIndex));
+  return out;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Trans,
+  VerbumiaProvider,
+  defaultTransport,
+  logTransport,
+  useTranslation
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/provider.tsx","../src/transport.ts","../src/i18n.ts","../src/hooks.ts","../src/trans.tsx"],"sourcesContent":["export { VerbumiaProvider } from \"./provider\";\nexport { useTranslation } from \"./hooks\";\nexport { Trans } from \"./trans\";\nexport type {\n  I18nInstance,\n  Locale,\n  MissingHandlerMode,\n  MissingKeyEvent,\n  Namespace,\n  TranslationFunction,\n  TranslationOptions,\n  Transport,\n  VerbumiaConfig,\n} from \"./types\";\nexport { defaultTransport, logTransport } from \"./transport\";\n","import {\n  createContext,\n  useContext,\n  useEffect,\n  useMemo,\n  useSyncExternalStore,\n  type ReactNode,\n} from \"react\";\nimport { VerbumiaI18n } from \"./i18n\";\nimport type { I18nInstance, VerbumiaConfig } from \"./types\";\n\ninterface VerbumiaContextValue {\n  i18n: VerbumiaI18n;\n}\n\nconst VerbumiaContext = createContext<VerbumiaContextValue | null>(null);\n\nexport interface VerbumiaProviderProps extends VerbumiaConfig {\n  children: ReactNode;\n}\n\nexport function VerbumiaProvider({\n  children,\n  ...config\n}: VerbumiaProviderProps) {\n  // Stable instance for the lifetime of the provider mount.\n  const i18n = useMemo(() => new VerbumiaI18n(config), []); // eslint-disable-line react-hooks/exhaustive-deps\n\n  useEffect(() => {\n    void i18n.start();\n    return () => i18n.stop();\n  }, [i18n]);\n\n  const value = useMemo<VerbumiaContextValue>(() => ({ i18n }), [i18n]);\n  return (\n    <VerbumiaContext.Provider value={value}>{children}</VerbumiaContext.Provider>\n  );\n}\n\n/** Internal — used by useTranslation + Trans. */\nexport function useI18n(): VerbumiaI18n {\n  const ctx = useContext(VerbumiaContext);\n  if (!ctx) {\n    throw new Error(\"useTranslation/Trans must be used inside <VerbumiaProvider>\");\n  }\n  return ctx.i18n;\n}\n\n/** Subscribes to the i18n store and returns a snapshot the React tree can render. */\nexport function useI18nSnapshot(): I18nInstance {\n  const i18n = useI18n();\n  return useSyncExternalStore(\n    i18n.subscribe,\n    () => ({\n      ready: i18n.ready,\n      locale: i18n.locale,\n      setLocale: i18n.setLocale,\n      missingEvents: i18n.missingEvents,\n      flushMissing: i18n.flushMissing,\n    }),\n    () => ({\n      ready: false,\n      locale: i18n.locale,\n      setLocale: i18n.setLocale,\n      missingEvents: [],\n      flushMissing: i18n.flushMissing,\n    })\n  );\n}\n","import type { MissingKeyEvent, Transport } from \"./types\";\n\nconst SDK_LIB = \"@verbumia/react-i18next\";\nconst SDK_VER = \"0.1.0\";\n\n/** Default transport: POST to `${apiBase}/v1/missing` with the API key. */\nexport function defaultTransport(opts: {\n  apiBase: string;\n  token: string;\n  projectUuid: string;\n}): Transport {\n  return async (batch) => {\n    if (!batch.length) return;\n    const body = {\n      project_uuid: opts.projectUuid,\n      events: batch.map((e) => ({\n        key: e.key,\n        namespace: e.namespace,\n        language_code: e.language_code,\n        source_value: e.source_value,\n        sdk_meta: {\n          lib: SDK_LIB,\n          ver: SDK_VER,\n          ...(typeof window !== \"undefined\"\n            ? { url: window.location?.href }\n            : {}),\n          ...(e.sdk_meta ?? {}),\n        },\n      })),\n    };\n    try {\n      await fetch(`${opts.apiBase.replace(/\\/+$/, \"\")}/v1/missing`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `ApiKey ${opts.token}`,\n        },\n        body: JSON.stringify(body),\n        // SDKs are best-effort; never block the render path\n        keepalive: true,\n      });\n    } catch {\n      // swallow — missing-key reporting must never break the host app\n    }\n  };\n}\n\n/** Logs each event to console.warn — handy for dev. */\nexport const logTransport: Transport = (batch: MissingKeyEvent[]) => {\n  for (const e of batch) {\n    // eslint-disable-next-line no-console\n    console.warn(\"[verbumia] missing key\", e);\n  }\n};\n","import type {\n  I18nInstance,\n  Locale,\n  MissingKeyEvent,\n  Namespace,\n  Transport,\n  VerbumiaConfig,\n} from \"./types\";\nimport { defaultTransport, logTransport } from \"./transport\";\n\nconst DEFAULT_API_BASE = \"https://api.verbumia.ca\";\nconst DEFAULT_CDN_BASE = \"https://cdn.verbumia.ca\";\nconst DEFAULT_FLUSH_MS = 5_000;\nconst DEFAULT_BATCH = 50;\nconst DEFAULT_BUFFER = 200;\n\ntype Bundle = Record<string, unknown>;\ntype Listener = () => void;\n\n/** Resolve a dotted key against a deeply-nested bundle. */\nfunction resolve(bundle: Bundle | undefined, key: string): string | undefined {\n  if (!bundle) return undefined;\n  const parts = key.split(\".\");\n  let cur: unknown = bundle;\n  for (const p of parts) {\n    if (cur && typeof cur === \"object\" && p in (cur as Record<string, unknown>)) {\n      cur = (cur as Record<string, unknown>)[p];\n    } else {\n      return undefined;\n    }\n  }\n  return typeof cur === \"string\" ? cur : undefined;\n}\n\n/** Cheap interpolation: replaces `{{name}}` with `options[name]`. */\nfunction interpolate(template: string, options?: Record<string, unknown>): string {\n  if (!options) return template;\n  return template.replace(/\\{\\{\\s*([a-zA-Z0-9_]+)\\s*\\}\\}/g, (_m, name) => {\n    const v = options[name];\n    return v == null ? \"\" : String(v);\n  });\n}\n\n/** A single ready-state + bundle store + missing-key buffer wrapped behind\n *  a tiny pub-sub so React can subscribe via useSyncExternalStore. */\nexport class VerbumiaI18n implements I18nInstance {\n  ready = false;\n  locale: Locale;\n  fallbackLng: Locale | undefined;\n  missingEvents: MissingKeyEvent[] = [];\n\n  private _bundles = new Map<string, Bundle>(); // `${locale}/${ns}` -> tree\n  private _attempted = new Set<string>(); // `${locale}/${ns}` keys we've fetched\n  private _config: Required<\n    Pick<VerbumiaConfig, \"apiBase\" | \"cdnBase\" | \"missingHandler\">\n  > & {\n    token: string;\n    projectUuid: string;\n    namespaces: string[];\n    flushIntervalMs: number;\n    flushBatchSize: number;\n    missingEventsBufferSize: number;\n  };\n\n  private _transport: Transport;\n  private _pending: MissingKeyEvent[] = [];\n  private _seen = new Set<string>(); // dedup `${locale}/${ns}/${key}` per-flush\n  private _timer: ReturnType<typeof setInterval> | null = null;\n  private _listeners = new Set<Listener>();\n\n  constructor(config: VerbumiaConfig) {\n    this.locale = config.defaultLocale;\n    this.fallbackLng = config.fallbackLng;\n    this._config = {\n      apiBase: config.apiBase ?? DEFAULT_API_BASE,\n      cdnBase: config.cdnBase ?? DEFAULT_CDN_BASE,\n      missingHandler: config.missingHandler ?? \"send\",\n      token: config.token,\n      projectUuid: config.projectUuid,\n      namespaces: config.namespaces?.length ? config.namespaces : [\"common\"],\n      flushIntervalMs: config.flushIntervalMs ?? DEFAULT_FLUSH_MS,\n      flushBatchSize: config.flushBatchSize ?? DEFAULT_BATCH,\n      missingEventsBufferSize:\n        config.missingEventsBufferSize ?? DEFAULT_BUFFER,\n    };\n\n    this._transport =\n      config.transport ??\n      (this._config.missingHandler === \"log\"\n        ? logTransport\n        : defaultTransport({\n            apiBase: this._config.apiBase,\n            token: this._config.token,\n            projectUuid: this._config.projectUuid,\n          }));\n  }\n\n  // ---- React subscription ----\n\n  subscribe = (listener: Listener): (() => void) => {\n    this._listeners.add(listener);\n    return () => this._listeners.delete(listener) as unknown as void;\n  };\n\n  private _notify(): void {\n    for (const l of this._listeners) l();\n  }\n\n  // ---- Lifecycle ----\n\n  /** Loads the configured namespaces for the active locale + fallback. */\n  async start(fetchImpl: typeof fetch = fetch): Promise<void> {\n    const targets = new Set<string>([this.locale]);\n    if (this.fallbackLng) targets.add(this.fallbackLng);\n    await Promise.all(\n      [...targets].flatMap((loc) =>\n        this._config.namespaces.map((ns) => this._loadBundle(loc, ns, fetchImpl))\n      )\n    );\n    this.ready = true;\n    this._startTimer();\n    this._notify();\n  }\n\n  setLocale = async (next: Locale): Promise<void> => {\n    if (next === this.locale) return;\n    this.locale = next;\n    this.ready = false;\n    this._notify();\n    await Promise.all(\n      this._config.namespaces.map((ns) => this._loadBundle(next, ns))\n    );\n    this.ready = true;\n    this._notify();\n  };\n\n  stop(): void {\n    if (this._timer) {\n      clearInterval(this._timer);\n      this._timer = null;\n    }\n  }\n\n  // ---- Translation ----\n\n  t = (key: string, options?: Record<string, unknown> & { defaultValue?: string }): string => {\n    const namespace = this._splitNamespace(key);\n    const bareKey = namespace.bareKey;\n    const ns = namespace.ns;\n\n    const fromActive = resolve(this._bundles.get(`${this.locale}/${ns}`), bareKey);\n    if (fromActive != null) return interpolate(fromActive, options);\n\n    if (this.fallbackLng && this.fallbackLng !== this.locale) {\n      const fb = resolve(this._bundles.get(`${this.fallbackLng}/${ns}`), bareKey);\n      if (fb != null) return interpolate(fb, options);\n    }\n\n    // Missing path — only report once we've actually fetched the bundle for\n    // this (locale, ns), otherwise the first paint floods the dashboard.\n    if (this.ready && this._attempted.has(`${this.locale}/${ns}`)) {\n      this._reportMissing({\n        key: bareKey,\n        namespace: ns,\n        language_code: this.locale,\n        source_value: typeof options?.defaultValue === \"string\" ? options.defaultValue : undefined,\n      });\n    }\n    const defaultValue = options?.defaultValue;\n    if (typeof defaultValue === \"string\") {\n      return interpolate(defaultValue, options);\n    }\n    return key;\n  };\n\n  flushMissing = async (): Promise<void> => {\n    if (!this._pending.length) return;\n    const batch = this._pending.slice(0);\n    this._pending = [];\n    if (this._config.missingHandler === \"off\") return;\n    try {\n      await this._transport(batch);\n    } catch {\n      // best-effort\n    }\n  };\n\n  // ---- Internals ----\n\n  private _splitNamespace(key: string): { ns: Namespace; bareKey: string } {\n    // i18next convention: \"ns:key\"\n    const idx = key.indexOf(\":\");\n    if (idx > 0) {\n      return { ns: key.slice(0, idx), bareKey: key.slice(idx + 1) };\n    }\n    return { ns: this._config.namespaces[0]!, bareKey: key };\n  }\n\n  private async _loadBundle(\n    locale: Locale,\n    ns: Namespace,\n    fetchImpl: typeof fetch = fetch\n  ): Promise<void> {\n    const url = `${this._config.cdnBase.replace(/\\/+$/, \"\")}/p/${this._config.projectUuid}/latest/${locale}/${ns}.json`;\n    try {\n      const r = await fetchImpl(url, { method: \"GET\", credentials: \"omit\" });\n      if (r.ok) {\n        const data = (await r.json()) as Bundle;\n        this._bundles.set(`${locale}/${ns}`, data);\n      } else {\n        // 404 = no published bundle yet — empty bundle is fine, missing keys flow handles it.\n        this._bundles.set(`${locale}/${ns}`, {});\n      }\n    } catch {\n      this._bundles.set(`${locale}/${ns}`, {});\n    } finally {\n      this._attempted.add(`${locale}/${ns}`);\n    }\n  }\n\n  private _startTimer(): void {\n    if (this._config.missingHandler === \"off\") return;\n    if (typeof setInterval !== \"function\") return;\n    this._timer = setInterval(() => {\n      void this.flushMissing();\n    }, this._config.flushIntervalMs);\n  }\n\n  private _reportMissing(event: MissingKeyEvent): void {\n    if (this._config.missingHandler === \"off\") return;\n    const dedupKey = `${event.language_code}/${event.namespace}/${event.key}`;\n    if (this._seen.has(dedupKey)) return;\n    this._seen.add(dedupKey);\n\n    // Push to ring buffer (capped) for in-app inspectors.\n    this.missingEvents = [event, ...this.missingEvents].slice(\n      0,\n      this._config.missingEventsBufferSize\n    );\n    this._pending.push(event);\n    if (this._pending.length >= this._config.flushBatchSize) {\n      void this.flushMissing();\n    }\n    this._notify();\n  }\n}\n","import { useMemo } from \"react\";\nimport { useI18n, useI18nSnapshot } from \"./provider\";\nimport type { I18nInstance, TranslationFunction } from \"./types\";\n\nexport interface UseTranslationResult {\n  t: TranslationFunction;\n  i18n: I18nInstance;\n}\n\n/** React hook — returns `{ t, i18n }`. Optional `defaultNamespace` lets you\n *  drop the `ns:` prefix on every call. */\nexport function useTranslation(defaultNamespace?: string): UseTranslationResult {\n  const i18n = useI18n();\n  const snapshot = useI18nSnapshot();\n  const t = useMemo<TranslationFunction>(() => {\n    return (key, options) => {\n      const fullKey =\n        defaultNamespace && !key.includes(\":\") ? `${defaultNamespace}:${key}` : key;\n      return i18n.t(fullKey, options);\n    };\n  }, [i18n, defaultNamespace]);\n  return { t, i18n: snapshot };\n}\n","import { Children, cloneElement, isValidElement, type ReactNode } from \"react\";\nimport { useTranslation } from \"./hooks\";\n\nexport interface TransProps {\n  /** The translation key (optionally `ns:key`). */\n  i18nKey: string;\n  /** Default value if the key is missing — used as the fallback string. */\n  defaults?: string;\n  /** Variables interpolated into `{{var}}` placeholders. */\n  values?: Record<string, unknown>;\n  /** JSX components mapped by 0-based numeric index — `<0>bold</0>` etc. */\n  components?: ReactNode[];\n  /** Optional namespace shortcut. */\n  namespace?: string;\n}\n\n/** Bare-bones Trans component: resolves the key, interpolates values, and\n *  swaps `<0>...</0>` placeholders into the supplied React components.\n *  Keeps the surface minimal — full Trans semantics (nested keys, plural\n *  trees, gender) land in V1.1. */\nexport function Trans({\n  i18nKey,\n  defaults,\n  values,\n  components,\n  namespace,\n}: TransProps) {\n  const { t } = useTranslation(namespace);\n  const raw = t(i18nKey, { ...(values ?? {}), defaultValue: defaults ?? i18nKey });\n  if (!components || !components.length) return <>{raw}</>;\n  return <>{splitOnComponents(raw, components)}</>;\n}\n\nfunction splitOnComponents(text: string, components: ReactNode[]): ReactNode[] {\n  const out: ReactNode[] = [];\n  // Match <N>...</N> where N is a 0-based index into `components`.\n  const re = /<(\\d+)>(.*?)<\\/\\1>/g;\n  let lastIndex = 0;\n  let m: RegExpExecArray | null;\n  while ((m = re.exec(text)) !== null) {\n    if (m.index > lastIndex) out.push(text.slice(lastIndex, m.index));\n    const idx = Number(m[1]);\n    const inner = m[2];\n    const node = components[idx];\n    if (isValidElement(node)) {\n      out.push(\n        cloneElement(node, { key: `t-${m.index}` }, ...Children.toArray(inner ?? \"\"))\n      );\n    } else if (node !== undefined) {\n      out.push(node);\n    } else {\n      out.push(inner ?? \"\");\n    }\n    lastIndex = re.lastIndex;\n  }\n  if (lastIndex < text.length) out.push(text.slice(lastIndex));\n  return out;\n}\n"],"mappings":"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","names":["import_react","import_react","import_jsx_runtime"]}

package/dist/index.d.cts

@@ -0,0 +1,99 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+type Locale = string;
+type Namespace = string;
+interface MissingKeyEvent {
+    key: string;
+    namespace: Namespace;
+    language_code: Locale;
+    source_value?: string;
+    sdk_meta?: Record<string, unknown>;
+}
+type MissingHandlerMode = "send" | "log" | "off";
+type Transport = (batch: MissingKeyEvent[]) => void | Promise<void>;
+interface VerbumiaConfig {
+    /** API key — format `vrb_live_<prefix>.<secret>` with `missing:write` scope. */
+    token: string;
+    /** Project UUID this provider is bound to. */
+    projectUuid: string;
+    /** Namespaces to preload on mount. Defaults to `['common']`. */
+    namespaces?: Namespace[];
+    /** Initial locale (BCP-47). */
+    defaultLocale: Locale;
+    /** Fallback locale used when a key is missing in `defaultLocale`. */
+    fallbackLng?: Locale;
+    /** Override the API base. Defaults to `https://api.verbumia.ca`. */
+    apiBase?: string;
+    /** Override the CDN base. Defaults to `https://cdn.verbumia.ca`. */
+    cdnBase?: string;
+    /**
+     * Optional override for missing-key delivery (in-app inspector,
+     * Storybook, Cypress mocks). When set, replaces the default POST.
+     */
+    transport?: Transport;
+    /** `send` (default) | `log` | `off` */
+    missingHandler?: MissingHandlerMode;
+    /** Flush cadence for the missing-key batch. Default 5_000ms. */
+    flushIntervalMs?: number;
+    /** Max events per batch before forcing a flush. Default 50. */
+    flushBatchSize?: number;
+    /** Optional ring buffer cap for `i18n.missingEvents`. Default 200. */
+    missingEventsBufferSize?: number;
+}
+interface I18nInstance {
+    /** True once the initial namespace bundles loaded for the active locale. */
+    ready: boolean;
+    locale: Locale;
+    setLocale: (l: Locale) => Promise<void>;
+    /** Recently captured missing-key events (most recent first). */
+    missingEvents: MissingKeyEvent[];
+    /** Force-flush the missing-key batch now. */
+    flushMissing: () => Promise<void>;
+}
+type TranslationOptions = Record<string, unknown> & {
+    defaultValue?: string;
+};
+type TranslationFunction = (key: string, options?: TranslationOptions) => string;
+
+interface VerbumiaProviderProps extends VerbumiaConfig {
+    children: ReactNode;
+}
+declare function VerbumiaProvider({ children, ...config }: VerbumiaProviderProps): react_jsx_runtime.JSX.Element;
+
+interface UseTranslationResult {
+    t: TranslationFunction;
+    i18n: I18nInstance;
+}
+/** React hook — returns `{ t, i18n }`. Optional `defaultNamespace` lets you
+ *  drop the `ns:` prefix on every call. */
+declare function useTranslation(defaultNamespace?: string): UseTranslationResult;
+
+interface TransProps {
+    /** The translation key (optionally `ns:key`). */
+    i18nKey: string;
+    /** Default value if the key is missing — used as the fallback string. */
+    defaults?: string;
+    /** Variables interpolated into `{{var}}` placeholders. */
+    values?: Record<string, unknown>;
+    /** JSX components mapped by 0-based numeric index — `<0>bold</0>` etc. */
+    components?: ReactNode[];
+    /** Optional namespace shortcut. */
+    namespace?: string;
+}
+/** Bare-bones Trans component: resolves the key, interpolates values, and
+ *  swaps `<0>...</0>` placeholders into the supplied React components.
+ *  Keeps the surface minimal — full Trans semantics (nested keys, plural
+ *  trees, gender) land in V1.1. */
+declare function Trans({ i18nKey, defaults, values, components, namespace, }: TransProps): react_jsx_runtime.JSX.Element;
+
+/** Default transport: POST to `${apiBase}/v1/missing` with the API key. */
+declare function defaultTransport(opts: {
+    apiBase: string;
+    token: string;
+    projectUuid: string;
+}): Transport;
+/** Logs each event to console.warn — handy for dev. */
+declare const logTransport: Transport;
+
+export { type I18nInstance, type Locale, type MissingHandlerMode, type MissingKeyEvent, type Namespace, Trans, type TranslationFunction, type TranslationOptions, type Transport, type VerbumiaConfig, VerbumiaProvider, defaultTransport, logTransport, useTranslation };

package/dist/index.d.ts

@@ -0,0 +1,99 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+type Locale = string;
+type Namespace = string;
+interface MissingKeyEvent {
+    key: string;
+    namespace: Namespace;
+    language_code: Locale;
+    source_value?: string;
+    sdk_meta?: Record<string, unknown>;
+}
+type MissingHandlerMode = "send" | "log" | "off";
+type Transport = (batch: MissingKeyEvent[]) => void | Promise<void>;
+interface VerbumiaConfig {
+    /** API key — format `vrb_live_<prefix>.<secret>` with `missing:write` scope. */
+    token: string;
+    /** Project UUID this provider is bound to. */
+    projectUuid: string;
+    /** Namespaces to preload on mount. Defaults to `['common']`. */
+    namespaces?: Namespace[];
+    /** Initial locale (BCP-47). */
+    defaultLocale: Locale;
+    /** Fallback locale used when a key is missing in `defaultLocale`. */
+    fallbackLng?: Locale;
+    /** Override the API base. Defaults to `https://api.verbumia.ca`. */
+    apiBase?: string;
+    /** Override the CDN base. Defaults to `https://cdn.verbumia.ca`. */
+    cdnBase?: string;
+    /**
+     * Optional override for missing-key delivery (in-app inspector,
+     * Storybook, Cypress mocks). When set, replaces the default POST.
+     */
+    transport?: Transport;
+    /** `send` (default) | `log` | `off` */
+    missingHandler?: MissingHandlerMode;
+    /** Flush cadence for the missing-key batch. Default 5_000ms. */
+    flushIntervalMs?: number;
+    /** Max events per batch before forcing a flush. Default 50. */
+    flushBatchSize?: number;
+    /** Optional ring buffer cap for `i18n.missingEvents`. Default 200. */
+    missingEventsBufferSize?: number;
+}
+interface I18nInstance {
+    /** True once the initial namespace bundles loaded for the active locale. */
+    ready: boolean;
+    locale: Locale;
+    setLocale: (l: Locale) => Promise<void>;
+    /** Recently captured missing-key events (most recent first). */
+    missingEvents: MissingKeyEvent[];
+    /** Force-flush the missing-key batch now. */
+    flushMissing: () => Promise<void>;
+}
+type TranslationOptions = Record<string, unknown> & {
+    defaultValue?: string;
+};
+type TranslationFunction = (key: string, options?: TranslationOptions) => string;
+
+interface VerbumiaProviderProps extends VerbumiaConfig {
+    children: ReactNode;
+}
+declare function VerbumiaProvider({ children, ...config }: VerbumiaProviderProps): react_jsx_runtime.JSX.Element;
+
+interface UseTranslationResult {
+    t: TranslationFunction;
+    i18n: I18nInstance;
+}
+/** React hook — returns `{ t, i18n }`. Optional `defaultNamespace` lets you
+ *  drop the `ns:` prefix on every call. */
+declare function useTranslation(defaultNamespace?: string): UseTranslationResult;
+
+interface TransProps {
+    /** The translation key (optionally `ns:key`). */
+    i18nKey: string;
+    /** Default value if the key is missing — used as the fallback string. */
+    defaults?: string;
+    /** Variables interpolated into `{{var}}` placeholders. */
+    values?: Record<string, unknown>;
+    /** JSX components mapped by 0-based numeric index — `<0>bold</0>` etc. */
+    components?: ReactNode[];
+    /** Optional namespace shortcut. */
+    namespace?: string;
+}
+/** Bare-bones Trans component: resolves the key, interpolates values, and
+ *  swaps `<0>...</0>` placeholders into the supplied React components.
+ *  Keeps the surface minimal — full Trans semantics (nested keys, plural
+ *  trees, gender) land in V1.1. */
+declare function Trans({ i18nKey, defaults, values, components, namespace, }: TransProps): react_jsx_runtime.JSX.Element;
+
+/** Default transport: POST to `${apiBase}/v1/missing` with the API key. */
+declare function defaultTransport(opts: {
+    apiBase: string;
+    token: string;
+    projectUuid: string;
+}): Transport;
+/** Logs each event to console.warn — handy for dev. */
+declare const logTransport: Transport;
+
+export { type I18nInstance, type Locale, type MissingHandlerMode, type MissingKeyEvent, type Namespace, Trans, type TranslationFunction, type TranslationOptions, type Transport, type VerbumiaConfig, VerbumiaProvider, defaultTransport, logTransport, useTranslation };

package/dist/index.js

@@ -0,0 +1,339 @@
+// src/provider.tsx
+import {
+  createContext,
+  useContext,
+  useEffect,
+  useMemo,
+  useSyncExternalStore
+} from "react";
+
+// src/transport.ts
+var SDK_LIB = "@verbumia/react-i18next";
+var SDK_VER = "0.1.0";
+function defaultTransport(opts) {
+  return async (batch) => {
+    if (!batch.length) return;
+    const body = {
+      project_uuid: opts.projectUuid,
+      events: batch.map((e) => ({
+        key: e.key,
+        namespace: e.namespace,
+        language_code: e.language_code,
+        source_value: e.source_value,
+        sdk_meta: {
+          lib: SDK_LIB,
+          ver: SDK_VER,
+          ...typeof window !== "undefined" ? { url: window.location?.href } : {},
+          ...e.sdk_meta ?? {}
+        }
+      }))
+    };
+    try {
+      await fetch(`${opts.apiBase.replace(/\/+$/, "")}/v1/missing`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `ApiKey ${opts.token}`
+        },
+        body: JSON.stringify(body),
+        // SDKs are best-effort; never block the render path
+        keepalive: true
+      });
+    } catch {
+    }
+  };
+}
+var logTransport = (batch) => {
+  for (const e of batch) {
+    console.warn("[verbumia] missing key", e);
+  }
+};
+
+// src/i18n.ts
+var DEFAULT_API_BASE = "https://api.verbumia.ca";
+var DEFAULT_CDN_BASE = "https://cdn.verbumia.ca";
+var DEFAULT_FLUSH_MS = 5e3;
+var DEFAULT_BATCH = 50;
+var DEFAULT_BUFFER = 200;
+function resolve(bundle, key) {
+  if (!bundle) return void 0;
+  const parts = key.split(".");
+  let cur = bundle;
+  for (const p of parts) {
+    if (cur && typeof cur === "object" && p in cur) {
+      cur = cur[p];
+    } else {
+      return void 0;
+    }
+  }
+  return typeof cur === "string" ? cur : void 0;
+}
+function interpolate(template, options) {
+  if (!options) return template;
+  return template.replace(/\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g, (_m, name) => {
+    const v = options[name];
+    return v == null ? "" : String(v);
+  });
+}
+var VerbumiaI18n = class {
+  ready = false;
+  locale;
+  fallbackLng;
+  missingEvents = [];
+  _bundles = /* @__PURE__ */ new Map();
+  // `${locale}/${ns}` -> tree
+  _attempted = /* @__PURE__ */ new Set();
+  // `${locale}/${ns}` keys we've fetched
+  _config;
+  _transport;
+  _pending = [];
+  _seen = /* @__PURE__ */ new Set();
+  // dedup `${locale}/${ns}/${key}` per-flush
+  _timer = null;
+  _listeners = /* @__PURE__ */ new Set();
+  constructor(config) {
+    this.locale = config.defaultLocale;
+    this.fallbackLng = config.fallbackLng;
+    this._config = {
+      apiBase: config.apiBase ?? DEFAULT_API_BASE,
+      cdnBase: config.cdnBase ?? DEFAULT_CDN_BASE,
+      missingHandler: config.missingHandler ?? "send",
+      token: config.token,
+      projectUuid: config.projectUuid,
+      namespaces: config.namespaces?.length ? config.namespaces : ["common"],
+      flushIntervalMs: config.flushIntervalMs ?? DEFAULT_FLUSH_MS,
+      flushBatchSize: config.flushBatchSize ?? DEFAULT_BATCH,
+      missingEventsBufferSize: config.missingEventsBufferSize ?? DEFAULT_BUFFER
+    };
+    this._transport = config.transport ?? (this._config.missingHandler === "log" ? logTransport : defaultTransport({
+      apiBase: this._config.apiBase,
+      token: this._config.token,
+      projectUuid: this._config.projectUuid
+    }));
+  }
+  // ---- React subscription ----
+  subscribe = (listener) => {
+    this._listeners.add(listener);
+    return () => this._listeners.delete(listener);
+  };
+  _notify() {
+    for (const l of this._listeners) l();
+  }
+  // ---- Lifecycle ----
+  /** Loads the configured namespaces for the active locale + fallback. */
+  async start(fetchImpl = fetch) {
+    const targets = /* @__PURE__ */ new Set([this.locale]);
+    if (this.fallbackLng) targets.add(this.fallbackLng);
+    await Promise.all(
+      [...targets].flatMap(
+        (loc) => this._config.namespaces.map((ns) => this._loadBundle(loc, ns, fetchImpl))
+      )
+    );
+    this.ready = true;
+    this._startTimer();
+    this._notify();
+  }
+  setLocale = async (next) => {
+    if (next === this.locale) return;
+    this.locale = next;
+    this.ready = false;
+    this._notify();
+    await Promise.all(
+      this._config.namespaces.map((ns) => this._loadBundle(next, ns))
+    );
+    this.ready = true;
+    this._notify();
+  };
+  stop() {
+    if (this._timer) {
+      clearInterval(this._timer);
+      this._timer = null;
+    }
+  }
+  // ---- Translation ----
+  t = (key, options) => {
+    const namespace = this._splitNamespace(key);
+    const bareKey = namespace.bareKey;
+    const ns = namespace.ns;
+    const fromActive = resolve(this._bundles.get(`${this.locale}/${ns}`), bareKey);
+    if (fromActive != null) return interpolate(fromActive, options);
+    if (this.fallbackLng && this.fallbackLng !== this.locale) {
+      const fb = resolve(this._bundles.get(`${this.fallbackLng}/${ns}`), bareKey);
+      if (fb != null) return interpolate(fb, options);
+    }
+    if (this.ready && this._attempted.has(`${this.locale}/${ns}`)) {
+      this._reportMissing({
+        key: bareKey,
+        namespace: ns,
+        language_code: this.locale,
+        source_value: typeof options?.defaultValue === "string" ? options.defaultValue : void 0
+      });
+    }
+    const defaultValue = options?.defaultValue;
+    if (typeof defaultValue === "string") {
+      return interpolate(defaultValue, options);
+    }
+    return key;
+  };
+  flushMissing = async () => {
+    if (!this._pending.length) return;
+    const batch = this._pending.slice(0);
+    this._pending = [];
+    if (this._config.missingHandler === "off") return;
+    try {
+      await this._transport(batch);
+    } catch {
+    }
+  };
+  // ---- Internals ----
+  _splitNamespace(key) {
+    const idx = key.indexOf(":");
+    if (idx > 0) {
+      return { ns: key.slice(0, idx), bareKey: key.slice(idx + 1) };
+    }
+    return { ns: this._config.namespaces[0], bareKey: key };
+  }
+  async _loadBundle(locale, ns, fetchImpl = fetch) {
+    const url = `${this._config.cdnBase.replace(/\/+$/, "")}/p/${this._config.projectUuid}/latest/${locale}/${ns}.json`;
+    try {
+      const r = await fetchImpl(url, { method: "GET", credentials: "omit" });
+      if (r.ok) {
+        const data = await r.json();
+        this._bundles.set(`${locale}/${ns}`, data);
+      } else {
+        this._bundles.set(`${locale}/${ns}`, {});
+      }
+    } catch {
+      this._bundles.set(`${locale}/${ns}`, {});
+    } finally {
+      this._attempted.add(`${locale}/${ns}`);
+    }
+  }
+  _startTimer() {
+    if (this._config.missingHandler === "off") return;
+    if (typeof setInterval !== "function") return;
+    this._timer = setInterval(() => {
+      void this.flushMissing();
+    }, this._config.flushIntervalMs);
+  }
+  _reportMissing(event) {
+    if (this._config.missingHandler === "off") return;
+    const dedupKey = `${event.language_code}/${event.namespace}/${event.key}`;
+    if (this._seen.has(dedupKey)) return;
+    this._seen.add(dedupKey);
+    this.missingEvents = [event, ...this.missingEvents].slice(
+      0,
+      this._config.missingEventsBufferSize
+    );
+    this._pending.push(event);
+    if (this._pending.length >= this._config.flushBatchSize) {
+      void this.flushMissing();
+    }
+    this._notify();
+  }
+};
+
+// src/provider.tsx
+import { jsx } from "react/jsx-runtime";
+var VerbumiaContext = createContext(null);
+function VerbumiaProvider({
+  children,
+  ...config
+}) {
+  const i18n = useMemo(() => new VerbumiaI18n(config), []);
+  useEffect(() => {
+    void i18n.start();
+    return () => i18n.stop();
+  }, [i18n]);
+  const value = useMemo(() => ({ i18n }), [i18n]);
+  return /* @__PURE__ */ jsx(VerbumiaContext.Provider, { value, children });
+}
+function useI18n() {
+  const ctx = useContext(VerbumiaContext);
+  if (!ctx) {
+    throw new Error("useTranslation/Trans must be used inside <VerbumiaProvider>");
+  }
+  return ctx.i18n;
+}
+function useI18nSnapshot() {
+  const i18n = useI18n();
+  return useSyncExternalStore(
+    i18n.subscribe,
+    () => ({
+      ready: i18n.ready,
+      locale: i18n.locale,
+      setLocale: i18n.setLocale,
+      missingEvents: i18n.missingEvents,
+      flushMissing: i18n.flushMissing
+    }),
+    () => ({
+      ready: false,
+      locale: i18n.locale,
+      setLocale: i18n.setLocale,
+      missingEvents: [],
+      flushMissing: i18n.flushMissing
+    })
+  );
+}
+
+// src/hooks.ts
+import { useMemo as useMemo2 } from "react";
+function useTranslation(defaultNamespace) {
+  const i18n = useI18n();
+  const snapshot = useI18nSnapshot();
+  const t = useMemo2(() => {
+    return (key, options) => {
+      const fullKey = defaultNamespace && !key.includes(":") ? `${defaultNamespace}:${key}` : key;
+      return i18n.t(fullKey, options);
+    };
+  }, [i18n, defaultNamespace]);
+  return { t, i18n: snapshot };
+}
+
+// src/trans.tsx
+import { Children, cloneElement, isValidElement } from "react";
+import { Fragment, jsx as jsx2 } from "react/jsx-runtime";
+function Trans({
+  i18nKey,
+  defaults,
+  values,
+  components,
+  namespace
+}) {
+  const { t } = useTranslation(namespace);
+  const raw = t(i18nKey, { ...values ?? {}, defaultValue: defaults ?? i18nKey });
+  if (!components || !components.length) return /* @__PURE__ */ jsx2(Fragment, { children: raw });
+  return /* @__PURE__ */ jsx2(Fragment, { children: splitOnComponents(raw, components) });
+}
+function splitOnComponents(text, components) {
+  const out = [];
+  const re = /<(\d+)>(.*?)<\/\1>/g;
+  let lastIndex = 0;
+  let m;
+  while ((m = re.exec(text)) !== null) {
+    if (m.index > lastIndex) out.push(text.slice(lastIndex, m.index));
+    const idx = Number(m[1]);
+    const inner = m[2];
+    const node = components[idx];
+    if (isValidElement(node)) {
+      out.push(
+        cloneElement(node, { key: `t-${m.index}` }, ...Children.toArray(inner ?? ""))
+      );
+    } else if (node !== void 0) {
+      out.push(node);
+    } else {
+      out.push(inner ?? "");
+    }
+    lastIndex = re.lastIndex;
+  }
+  if (lastIndex < text.length) out.push(text.slice(lastIndex));
+  return out;
+}
+export {
+  Trans,
+  VerbumiaProvider,
+  defaultTransport,
+  logTransport,
+  useTranslation
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/provider.tsx","../src/transport.ts","../src/i18n.ts","../src/hooks.ts","../src/trans.tsx"],"sourcesContent":["import {\n  createContext,\n  useContext,\n  useEffect,\n  useMemo,\n  useSyncExternalStore,\n  type ReactNode,\n} from \"react\";\nimport { VerbumiaI18n } from \"./i18n\";\nimport type { I18nInstance, VerbumiaConfig } from \"./types\";\n\ninterface VerbumiaContextValue {\n  i18n: VerbumiaI18n;\n}\n\nconst VerbumiaContext = createContext<VerbumiaContextValue | null>(null);\n\nexport interface VerbumiaProviderProps extends VerbumiaConfig {\n  children: ReactNode;\n}\n\nexport function VerbumiaProvider({\n  children,\n  ...config\n}: VerbumiaProviderProps) {\n  // Stable instance for the lifetime of the provider mount.\n  const i18n = useMemo(() => new VerbumiaI18n(config), []); // eslint-disable-line react-hooks/exhaustive-deps\n\n  useEffect(() => {\n    void i18n.start();\n    return () => i18n.stop();\n  }, [i18n]);\n\n  const value = useMemo<VerbumiaContextValue>(() => ({ i18n }), [i18n]);\n  return (\n    <VerbumiaContext.Provider value={value}>{children}</VerbumiaContext.Provider>\n  );\n}\n\n/** Internal — used by useTranslation + Trans. */\nexport function useI18n(): VerbumiaI18n {\n  const ctx = useContext(VerbumiaContext);\n  if (!ctx) {\n    throw new Error(\"useTranslation/Trans must be used inside <VerbumiaProvider>\");\n  }\n  return ctx.i18n;\n}\n\n/** Subscribes to the i18n store and returns a snapshot the React tree can render. */\nexport function useI18nSnapshot(): I18nInstance {\n  const i18n = useI18n();\n  return useSyncExternalStore(\n    i18n.subscribe,\n    () => ({\n      ready: i18n.ready,\n      locale: i18n.locale,\n      setLocale: i18n.setLocale,\n      missingEvents: i18n.missingEvents,\n      flushMissing: i18n.flushMissing,\n    }),\n    () => ({\n      ready: false,\n      locale: i18n.locale,\n      setLocale: i18n.setLocale,\n      missingEvents: [],\n      flushMissing: i18n.flushMissing,\n    })\n  );\n}\n","import type { MissingKeyEvent, Transport } from \"./types\";\n\nconst SDK_LIB = \"@verbumia/react-i18next\";\nconst SDK_VER = \"0.1.0\";\n\n/** Default transport: POST to `${apiBase}/v1/missing` with the API key. */\nexport function defaultTransport(opts: {\n  apiBase: string;\n  token: string;\n  projectUuid: string;\n}): Transport {\n  return async (batch) => {\n    if (!batch.length) return;\n    const body = {\n      project_uuid: opts.projectUuid,\n      events: batch.map((e) => ({\n        key: e.key,\n        namespace: e.namespace,\n        language_code: e.language_code,\n        source_value: e.source_value,\n        sdk_meta: {\n          lib: SDK_LIB,\n          ver: SDK_VER,\n          ...(typeof window !== \"undefined\"\n            ? { url: window.location?.href }\n            : {}),\n          ...(e.sdk_meta ?? {}),\n        },\n      })),\n    };\n    try {\n      await fetch(`${opts.apiBase.replace(/\\/+$/, \"\")}/v1/missing`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `ApiKey ${opts.token}`,\n        },\n        body: JSON.stringify(body),\n        // SDKs are best-effort; never block the render path\n        keepalive: true,\n      });\n    } catch {\n      // swallow — missing-key reporting must never break the host app\n    }\n  };\n}\n\n/** Logs each event to console.warn — handy for dev. */\nexport const logTransport: Transport = (batch: MissingKeyEvent[]) => {\n  for (const e of batch) {\n    // eslint-disable-next-line no-console\n    console.warn(\"[verbumia] missing key\", e);\n  }\n};\n","import type {\n  I18nInstance,\n  Locale,\n  MissingKeyEvent,\n  Namespace,\n  Transport,\n  VerbumiaConfig,\n} from \"./types\";\nimport { defaultTransport, logTransport } from \"./transport\";\n\nconst DEFAULT_API_BASE = \"https://api.verbumia.ca\";\nconst DEFAULT_CDN_BASE = \"https://cdn.verbumia.ca\";\nconst DEFAULT_FLUSH_MS = 5_000;\nconst DEFAULT_BATCH = 50;\nconst DEFAULT_BUFFER = 200;\n\ntype Bundle = Record<string, unknown>;\ntype Listener = () => void;\n\n/** Resolve a dotted key against a deeply-nested bundle. */\nfunction resolve(bundle: Bundle | undefined, key: string): string | undefined {\n  if (!bundle) return undefined;\n  const parts = key.split(\".\");\n  let cur: unknown = bundle;\n  for (const p of parts) {\n    if (cur && typeof cur === \"object\" && p in (cur as Record<string, unknown>)) {\n      cur = (cur as Record<string, unknown>)[p];\n    } else {\n      return undefined;\n    }\n  }\n  return typeof cur === \"string\" ? cur : undefined;\n}\n\n/** Cheap interpolation: replaces `{{name}}` with `options[name]`. */\nfunction interpolate(template: string, options?: Record<string, unknown>): string {\n  if (!options) return template;\n  return template.replace(/\\{\\{\\s*([a-zA-Z0-9_]+)\\s*\\}\\}/g, (_m, name) => {\n    const v = options[name];\n    return v == null ? \"\" : String(v);\n  });\n}\n\n/** A single ready-state + bundle store + missing-key buffer wrapped behind\n *  a tiny pub-sub so React can subscribe via useSyncExternalStore. */\nexport class VerbumiaI18n implements I18nInstance {\n  ready = false;\n  locale: Locale;\n  fallbackLng: Locale | undefined;\n  missingEvents: MissingKeyEvent[] = [];\n\n  private _bundles = new Map<string, Bundle>(); // `${locale}/${ns}` -> tree\n  private _attempted = new Set<string>(); // `${locale}/${ns}` keys we've fetched\n  private _config: Required<\n    Pick<VerbumiaConfig, \"apiBase\" | \"cdnBase\" | \"missingHandler\">\n  > & {\n    token: string;\n    projectUuid: string;\n    namespaces: string[];\n    flushIntervalMs: number;\n    flushBatchSize: number;\n    missingEventsBufferSize: number;\n  };\n\n  private _transport: Transport;\n  private _pending: MissingKeyEvent[] = [];\n  private _seen = new Set<string>(); // dedup `${locale}/${ns}/${key}` per-flush\n  private _timer: ReturnType<typeof setInterval> | null = null;\n  private _listeners = new Set<Listener>();\n\n  constructor(config: VerbumiaConfig) {\n    this.locale = config.defaultLocale;\n    this.fallbackLng = config.fallbackLng;\n    this._config = {\n      apiBase: config.apiBase ?? DEFAULT_API_BASE,\n      cdnBase: config.cdnBase ?? DEFAULT_CDN_BASE,\n      missingHandler: config.missingHandler ?? \"send\",\n      token: config.token,\n      projectUuid: config.projectUuid,\n      namespaces: config.namespaces?.length ? config.namespaces : [\"common\"],\n      flushIntervalMs: config.flushIntervalMs ?? DEFAULT_FLUSH_MS,\n      flushBatchSize: config.flushBatchSize ?? DEFAULT_BATCH,\n      missingEventsBufferSize:\n        config.missingEventsBufferSize ?? DEFAULT_BUFFER,\n    };\n\n    this._transport =\n      config.transport ??\n      (this._config.missingHandler === \"log\"\n        ? logTransport\n        : defaultTransport({\n            apiBase: this._config.apiBase,\n            token: this._config.token,\n            projectUuid: this._config.projectUuid,\n          }));\n  }\n\n  // ---- React subscription ----\n\n  subscribe = (listener: Listener): (() => void) => {\n    this._listeners.add(listener);\n    return () => this._listeners.delete(listener) as unknown as void;\n  };\n\n  private _notify(): void {\n    for (const l of this._listeners) l();\n  }\n\n  // ---- Lifecycle ----\n\n  /** Loads the configured namespaces for the active locale + fallback. */\n  async start(fetchImpl: typeof fetch = fetch): Promise<void> {\n    const targets = new Set<string>([this.locale]);\n    if (this.fallbackLng) targets.add(this.fallbackLng);\n    await Promise.all(\n      [...targets].flatMap((loc) =>\n        this._config.namespaces.map((ns) => this._loadBundle(loc, ns, fetchImpl))\n      )\n    );\n    this.ready = true;\n    this._startTimer();\n    this._notify();\n  }\n\n  setLocale = async (next: Locale): Promise<void> => {\n    if (next === this.locale) return;\n    this.locale = next;\n    this.ready = false;\n    this._notify();\n    await Promise.all(\n      this._config.namespaces.map((ns) => this._loadBundle(next, ns))\n    );\n    this.ready = true;\n    this._notify();\n  };\n\n  stop(): void {\n    if (this._timer) {\n      clearInterval(this._timer);\n      this._timer = null;\n    }\n  }\n\n  // ---- Translation ----\n\n  t = (key: string, options?: Record<string, unknown> & { defaultValue?: string }): string => {\n    const namespace = this._splitNamespace(key);\n    const bareKey = namespace.bareKey;\n    const ns = namespace.ns;\n\n    const fromActive = resolve(this._bundles.get(`${this.locale}/${ns}`), bareKey);\n    if (fromActive != null) return interpolate(fromActive, options);\n\n    if (this.fallbackLng && this.fallbackLng !== this.locale) {\n      const fb = resolve(this._bundles.get(`${this.fallbackLng}/${ns}`), bareKey);\n      if (fb != null) return interpolate(fb, options);\n    }\n\n    // Missing path — only report once we've actually fetched the bundle for\n    // this (locale, ns), otherwise the first paint floods the dashboard.\n    if (this.ready && this._attempted.has(`${this.locale}/${ns}`)) {\n      this._reportMissing({\n        key: bareKey,\n        namespace: ns,\n        language_code: this.locale,\n        source_value: typeof options?.defaultValue === \"string\" ? options.defaultValue : undefined,\n      });\n    }\n    const defaultValue = options?.defaultValue;\n    if (typeof defaultValue === \"string\") {\n      return interpolate(defaultValue, options);\n    }\n    return key;\n  };\n\n  flushMissing = async (): Promise<void> => {\n    if (!this._pending.length) return;\n    const batch = this._pending.slice(0);\n    this._pending = [];\n    if (this._config.missingHandler === \"off\") return;\n    try {\n      await this._transport(batch);\n    } catch {\n      // best-effort\n    }\n  };\n\n  // ---- Internals ----\n\n  private _splitNamespace(key: string): { ns: Namespace; bareKey: string } {\n    // i18next convention: \"ns:key\"\n    const idx = key.indexOf(\":\");\n    if (idx > 0) {\n      return { ns: key.slice(0, idx), bareKey: key.slice(idx + 1) };\n    }\n    return { ns: this._config.namespaces[0]!, bareKey: key };\n  }\n\n  private async _loadBundle(\n    locale: Locale,\n    ns: Namespace,\n    fetchImpl: typeof fetch = fetch\n  ): Promise<void> {\n    const url = `${this._config.cdnBase.replace(/\\/+$/, \"\")}/p/${this._config.projectUuid}/latest/${locale}/${ns}.json`;\n    try {\n      const r = await fetchImpl(url, { method: \"GET\", credentials: \"omit\" });\n      if (r.ok) {\n        const data = (await r.json()) as Bundle;\n        this._bundles.set(`${locale}/${ns}`, data);\n      } else {\n        // 404 = no published bundle yet — empty bundle is fine, missing keys flow handles it.\n        this._bundles.set(`${locale}/${ns}`, {});\n      }\n    } catch {\n      this._bundles.set(`${locale}/${ns}`, {});\n    } finally {\n      this._attempted.add(`${locale}/${ns}`);\n    }\n  }\n\n  private _startTimer(): void {\n    if (this._config.missingHandler === \"off\") return;\n    if (typeof setInterval !== \"function\") return;\n    this._timer = setInterval(() => {\n      void this.flushMissing();\n    }, this._config.flushIntervalMs);\n  }\n\n  private _reportMissing(event: MissingKeyEvent): void {\n    if (this._config.missingHandler === \"off\") return;\n    const dedupKey = `${event.language_code}/${event.namespace}/${event.key}`;\n    if (this._seen.has(dedupKey)) return;\n    this._seen.add(dedupKey);\n\n    // Push to ring buffer (capped) for in-app inspectors.\n    this.missingEvents = [event, ...this.missingEvents].slice(\n      0,\n      this._config.missingEventsBufferSize\n    );\n    this._pending.push(event);\n    if (this._pending.length >= this._config.flushBatchSize) {\n      void this.flushMissing();\n    }\n    this._notify();\n  }\n}\n","import { useMemo } from \"react\";\nimport { useI18n, useI18nSnapshot } from \"./provider\";\nimport type { I18nInstance, TranslationFunction } from \"./types\";\n\nexport interface UseTranslationResult {\n  t: TranslationFunction;\n  i18n: I18nInstance;\n}\n\n/** React hook — returns `{ t, i18n }`. Optional `defaultNamespace` lets you\n *  drop the `ns:` prefix on every call. */\nexport function useTranslation(defaultNamespace?: string): UseTranslationResult {\n  const i18n = useI18n();\n  const snapshot = useI18nSnapshot();\n  const t = useMemo<TranslationFunction>(() => {\n    return (key, options) => {\n      const fullKey =\n        defaultNamespace && !key.includes(\":\") ? `${defaultNamespace}:${key}` : key;\n      return i18n.t(fullKey, options);\n    };\n  }, [i18n, defaultNamespace]);\n  return { t, i18n: snapshot };\n}\n","import { Children, cloneElement, isValidElement, type ReactNode } from \"react\";\nimport { useTranslation } from \"./hooks\";\n\nexport interface TransProps {\n  /** The translation key (optionally `ns:key`). */\n  i18nKey: string;\n  /** Default value if the key is missing — used as the fallback string. */\n  defaults?: string;\n  /** Variables interpolated into `{{var}}` placeholders. */\n  values?: Record<string, unknown>;\n  /** JSX components mapped by 0-based numeric index — `<0>bold</0>` etc. */\n  components?: ReactNode[];\n  /** Optional namespace shortcut. */\n  namespace?: string;\n}\n\n/** Bare-bones Trans component: resolves the key, interpolates values, and\n *  swaps `<0>...</0>` placeholders into the supplied React components.\n *  Keeps the surface minimal — full Trans semantics (nested keys, plural\n *  trees, gender) land in V1.1. */\nexport function Trans({\n  i18nKey,\n  defaults,\n  values,\n  components,\n  namespace,\n}: TransProps) {\n  const { t } = useTranslation(namespace);\n  const raw = t(i18nKey, { ...(values ?? {}), defaultValue: defaults ?? i18nKey });\n  if (!components || !components.length) return <>{raw}</>;\n  return <>{splitOnComponents(raw, components)}</>;\n}\n\nfunction splitOnComponents(text: string, components: ReactNode[]): ReactNode[] {\n  const out: ReactNode[] = [];\n  // Match <N>...</N> where N is a 0-based index into `components`.\n  const re = /<(\\d+)>(.*?)<\\/\\1>/g;\n  let lastIndex = 0;\n  let m: RegExpExecArray | null;\n  while ((m = re.exec(text)) !== null) {\n    if (m.index > lastIndex) out.push(text.slice(lastIndex, m.index));\n    const idx = Number(m[1]);\n    const inner = m[2];\n    const node = components[idx];\n    if (isValidElement(node)) {\n      out.push(\n        cloneElement(node, { key: `t-${m.index}` }, ...Children.toArray(inner ?? \"\"))\n      );\n    } else if (node !== undefined) {\n      out.push(node);\n    } else {\n      out.push(inner ?? \"\");\n    }\n    lastIndex = re.lastIndex;\n  }\n  if (lastIndex < text.length) out.push(text.slice(lastIndex));\n  return out;\n}\n"],"mappings":"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","names":["useMemo","useMemo","jsx"]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@verbumia/react-i18next",
+  "version": "0.1.0",
+  "description": "React SDK for Verbumia — translations + realtime missing-key handler.",
+  "license": "MIT",
+  "homepage": "https://verbumia.ca",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/verbumia/verbumia-react-i18next.git"
+  },
+  "keywords": ["i18n", "translations", "react", "i18next", "verbumia"],
+  "author": "Verbumia",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "happy-dom": "^15.0.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm typecheck && pnpm test && pnpm build",
+    "pack:dry-run": "pnpm pack --dry-run"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "provenance": true
+  }
+}