@pulsetechnologies/i18n 0.1.0

package/README.md

@@ -0,0 +1,42 @@
+# @pulsetechnologies/i18n
+
+The shared language layer for every Pulse product (PulseWork epic **ENG-1**, this is **ENG-2**).
+
+- **18 languages**: `en es zh-Hans zh-Hant hi ar fr pt-BR ru bn ja de id ur vi ko fil ht` (Arabic and Urdu are right-to-left).
+- **Choosing the language**: `pickLocale({ user, cookie, workspace, browser })` goes in that order, then falls back to English. The `pulse_lang` cookie covers all of `.pulsetechnologies.ai`, so a choice made in one product carries over to the others.
+- **Matching**: `matchLocale` maps real-world tags to the languages we offer: `zh-TW` → `zh-Hant`, `pt-PT` → `pt-BR`, `es-MX` → `es`, `tl` → `fil`.
+- **Formatting**: `createFormatters(locale, { timeZone })` covers numbers, percent, `money(minor, currency)` for Pulse's minor-unit amounts, dates, times, relative times and lists. Haitian Creole borrows French formats because CLDR has no data for it.
+- **i18next**: `createI18n({ resources, locale })` sets up English fallback, no catalog bleed between `zh-Hans` and `zh-Hant`, React-safe interpolation, and an optional `en-XA` pseudo-locale for catching text that was never extracted.
+- **Catalog check**: `missingKeys(en, target, locale)` is plural-aware per language. Arabic needs six plural forms, Japanese one, and Spanish needs `_many`. Without it, Spanish users see English for counts in the millions. ENG-4 runs it in CI.
+- **React**: `<LanguagePicker persist={saveToProfile} />` is an accessible native `<select>` that shows each language in its own script. It keeps `<html lang dir>` in step, writes the cookie and calls `persist` (the ENG-3 profile save). `<LanguageSelect>` and `useLanguage()` are the lower-level pieces.
+
+```tsx
+import { createI18n, pickLocale } from "@pulsetechnologies/i18n";
+import { LanguagePicker } from "@pulsetechnologies/i18n/react";
+import { I18nextProvider, initReactI18next } from "react-i18next";
+
+const { locale } = pickLocale({ user: me?.language, cookie: document.cookie, workspace: org.language, browser: navigator.languages });
+const i18n = await createI18n({ resources, locale, use: [initReactI18next], pseudo: import.meta.env.DEV });
+// <I18nextProvider i18n={i18n}> … <LanguagePicker persist={(c) => api.patch("/me", { language: c })} />
+```
+
+The core entry has no DOM or React dependency, so it runs on servers (for emails and invoices) and in React Native. The React entry is for the web; React Native gets its own picker in ENG-19.
+
+## Develop
+
+```bash
+npm ci
+npm test          # vitest (the picker tests use jsdom)
+npm run demo      # http://localhost:5480, a sample invoice in 5 languages + pseudo
+```
+
+## Release
+
+The package is published publicly to npm as `@pulsetechnologies/i18n`. To release:
+
+1. Bump `version` in `package.json` and merge.
+2. Publish a GitHub release tagged `v<version>`.
+
+The Publish workflow checks that the tag matches `package.json`, runs typecheck, tests and build (`prepublishOnly`), and publishes through **npm trusted publishing (OIDC)**, so no npm token is stored anywhere. npm is retiring token publishing (2FA-bypass tokens stop publishing directly around January 2027).
+
+The very first version (0.1.0) is published by hand, because npm only lets a trusted publisher be configured on a package that already exists. After that, set up npmjs.com → the package → Settings → Trusted publishing → GitHub Actions: `pulsetechnologies-ai` / `pulse-i18n` / `publish.yml`. Then set Publishing access to "Require two-factor authentication and disallow tokens".

package/dist/catalog.d.ts

@@ -0,0 +1,20 @@
+/** Nested catalog → flat "a.b.c" keys holding strings. */
+export declare function flattenCatalog(catalog: unknown, prefix?: string): Map<string, string>;
+/**
+ * The plural forms a language needs: Arabic has six, Japanese one, English
+ * two, Spanish three ("many" is for millions). Built the way i18next builds
+ * its own rules, from the bare code, so the check asks for exactly the keys
+ * i18next will look up.
+ */
+export declare const pluralCategoriesOf: (locale: string) => Intl.LDMLPluralRule[];
+/**
+ * Keys the English catalog has that a translation lacks — the check CI runs
+ * so nothing ships half-translated. Plurals are compared by what each language
+ * needs: English "item_one"/"item_other" requires all six forms in Arabic and
+ * only "item_other" in Japanese. Also lists keys the translation has that
+ * English no longer does (stale).
+ */
+export declare function missingKeys(source: unknown, target: unknown, targetLocale: string): {
+    missing: string[];
+    stale: string[];
+};

package/dist/catalog.js

@@ -0,0 +1,50 @@
+const PLURAL = /_(zero|one|two|few|many|other)$/;
+/** Nested catalog → flat "a.b.c" keys holding strings. */
+export function flattenCatalog(catalog, prefix = "") {
+    const out = new Map();
+    if (catalog && typeof catalog === "object" && !Array.isArray(catalog)) {
+        for (const [k, v] of Object.entries(catalog)) {
+            const key = prefix ? `${prefix}.${k}` : k;
+            if (typeof v === "string")
+                out.set(key, v);
+            else
+                for (const [kk, vv] of flattenCatalog(v, key))
+                    out.set(kk, vv);
+        }
+    }
+    return out;
+}
+/**
+ * The plural forms a language needs: Arabic has six, Japanese one, English
+ * two, Spanish three ("many" is for millions). Built the way i18next builds
+ * its own rules, from the bare code, so the check asks for exactly the keys
+ * i18next will look up.
+ */
+export const pluralCategoriesOf = (locale) => new Intl.PluralRules(locale).resolvedOptions().pluralCategories;
+/**
+ * Keys the English catalog has that a translation lacks — the check CI runs
+ * so nothing ships half-translated. Plurals are compared by what each language
+ * needs: English "item_one"/"item_other" requires all six forms in Arabic and
+ * only "item_other" in Japanese. Also lists keys the translation has that
+ * English no longer does (stale).
+ */
+export function missingKeys(source, target, targetLocale) {
+    const src = flattenCatalog(source);
+    const tgt = flattenCatalog(target);
+    const need = pluralCategoriesOf(targetLocale);
+    const expected = new Set();
+    for (const key of src.keys()) {
+        const m = PLURAL.exec(key);
+        if (!m)
+            expected.add(key);
+        else
+            for (const cat of need)
+                expected.add(key.slice(0, m.index) + "_" + cat);
+    }
+    // A translation may carry an optional "_zero" (i18next uses it for count 0) even where CLDR has none.
+    const pluralBases = new Set([...src.keys()].filter((k) => PLURAL.test(k)).map((k) => k.replace(PLURAL, "")));
+    const missing = [...expected].filter((k) => !tgt.get(k)?.trim());
+    const stale = [...tgt.keys()].filter((k) => !expected.has(k) && !(k.endsWith("_zero") && pluralBases.has(k.slice(0, -5))));
+    return { missing: missing.sort(), stale: stale.sort() };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,iCAAiC,CAAC;AAIjD,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,MAAM,GAAG,EAAE;IAC1D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAkB,CAAC,EAAE,CAAC;YACxD,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;;gBACtC,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC;oBAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAc,EAAyB,EAAE,CAC1E,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,CAAC,gBAAyC,CAAC;AAE3F;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,MAAe,EAAE,MAAe,EAAE,YAAoB;IAChF,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;;YACrB,KAAK,MAAM,GAAG,IAAI,IAAI;gBAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;IAC/E,CAAC;IACD,sGAAsG;IACtG,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7G,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3H,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;AAC1D,CAAC"}

package/dist/format.d.ts

@@ -0,0 +1,28 @@
+export interface FormatterOptions {
+    /** IANA zone to show times in — the viewer's own, never a hard-coded one. */
+    timeZone?: string;
+}
+/**
+ * Locale-aware formatting built on Intl. Formatter objects are expensive to
+ * construct, so each shape is built once per `createFormatters` call.
+ */
+export declare function createFormatters(locale: string, opts?: FormatterOptions): {
+    locale: string;
+    number: (n: number, o?: Intl.NumberFormatOptions) => string;
+    percent: (ratio: number, maximumFractionDigits?: number) => string;
+    /** An amount in major units (12.5 → "$12.50"). */
+    currency: (amount: number, currency: string) => string;
+    /**
+     * An amount in minor units, as Pulse stores money (1250 USD → "$12.50";
+     * 1250 JPY → "¥1,250" because yen has no minor unit).
+     */
+    money: (minor: number, currency: string) => string;
+    date: (d: Date | string | number, style?: "short" | "medium" | "long" | "full") => string;
+    time: (d: Date | string | number) => string;
+    dateTime: (d: Date | string | number) => string;
+    /** "3 days ago", "in 2 hours" — `value` is negative for the past. */
+    relative: (value: number, unit: Intl.RelativeTimeFormatUnit) => string;
+    /** "A, B and C" with the language's own conjunction. */
+    list: (items: readonly string[], type?: "conjunction" | "disjunction") => string;
+};
+export type Formatters = ReturnType<typeof createFormatters>;

package/dist/format.js

@@ -0,0 +1,41 @@
+import { intlLocalesOf } from "./locales.js";
+/**
+ * Locale-aware formatting built on Intl. Formatter objects are expensive to
+ * construct, so each shape is built once per `createFormatters` call.
+ */
+export function createFormatters(locale, opts = {}) {
+    const locales = intlLocalesOf(locale);
+    const cache = new Map();
+    const memo = (key, make) => {
+        let f = cache.get(key);
+        if (!f)
+            cache.set(key, (f = make()));
+        return f;
+    };
+    const tz = opts.timeZone ? { timeZone: opts.timeZone } : {};
+    const toDate = (d) => (d instanceof Date ? d : new Date(d));
+    const currencyFormat = (currency) => memo(`c:${currency}`, () => new Intl.NumberFormat(locales, { style: "currency", currency }));
+    return {
+        locale,
+        number: (n, o) => memo(`n:${JSON.stringify(o ?? {})}`, () => new Intl.NumberFormat(locales, o)).format(n),
+        percent: (ratio, maximumFractionDigits = 0) => memo(`p:${maximumFractionDigits}`, () => new Intl.NumberFormat(locales, { style: "percent", maximumFractionDigits })).format(ratio),
+        /** An amount in major units (12.5 → "$12.50"). */
+        currency: (amount, currency) => currencyFormat(currency).format(amount),
+        /**
+         * An amount in minor units, as Pulse stores money (1250 USD → "$12.50";
+         * 1250 JPY → "¥1,250" because yen has no minor unit).
+         */
+        money: (minor, currency) => {
+            const f = currencyFormat(currency);
+            return f.format(minor / 10 ** (f.resolvedOptions().maximumFractionDigits ?? 2));
+        },
+        date: (d, style = "medium") => memo(`d:${style}`, () => new Intl.DateTimeFormat(locales, { dateStyle: style, ...tz })).format(toDate(d)),
+        time: (d) => memo("t", () => new Intl.DateTimeFormat(locales, { timeStyle: "short", ...tz })).format(toDate(d)),
+        dateTime: (d) => memo("dt", () => new Intl.DateTimeFormat(locales, { dateStyle: "medium", timeStyle: "short", ...tz })).format(toDate(d)),
+        /** "3 days ago", "in 2 hours" — `value` is negative for the past. */
+        relative: (value, unit) => memo("r", () => new Intl.RelativeTimeFormat(locales, { numeric: "auto" })).format(value, unit),
+        /** "A, B and C" with the language's own conjunction. */
+        list: (items, type = "conjunction") => memo(`l:${type}`, () => new Intl.ListFormat(locales, { type })).format(items),
+    };
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}

package/dist/i18n.d.ts

@@ -0,0 +1,28 @@
+import { type i18n as I18n, type InitOptions, type Resource } from "i18next";
+import { PSEUDO_LOCALE, type LocaleCode } from "./locales.js";
+export interface CreateI18nOptions {
+    /** Catalogs by locale then namespace: `{ en: { common: {...} }, es: {...} }`. English is required. */
+    resources: Resource;
+    /** Starting language, usually from `pickLocale`. */
+    locale: LocaleCode | typeof PSEUDO_LOCALE;
+    defaultNS?: string;
+    /** Offer the en-XA pseudo-locale (dev / staging / CI only). */
+    pseudo?: boolean;
+    /**
+     * Called for a key found in no catalog at all, English included. A key that
+     * only lacks a translation falls back to English silently; `missingKeys` is
+     * the check for those (CI).
+     */
+    onMissingKey?: (locale: string, namespace: string, key: string) => void;
+    /** Extra i18next options — plugins such as `initReactI18next` go through `use`. */
+    init?: Partial<InitOptions>;
+    use?: Parameters<I18n["use"]>[0][];
+}
+/**
+ * A ready i18next instance with the Pulse defaults: our 18 locales, English
+ * fallback, no HTML escaping (React escapes), and the pseudo-locale when asked.
+ * Each call returns a fresh instance, so tests and SSR requests don't share one.
+ */
+export declare function createI18n(opts: CreateI18nOptions): Promise<I18n>;
+/** Set `<html lang dir>` so screen readers, fonts, hyphenation and RTL layout follow the language. */
+export declare function applyDocumentLocale(locale: string, doc?: Document | undefined): void;

package/dist/i18n.js

@@ -0,0 +1,48 @@
+import i18next from "i18next";
+import { dirOf, LOCALE_CODES, PSEUDO_LOCALE, SOURCE_LOCALE } from "./locales.js";
+import { pseudoizeCatalog } from "./pseudo.js";
+/**
+ * A ready i18next instance with the Pulse defaults: our 18 locales, English
+ * fallback, no HTML escaping (React escapes), and the pseudo-locale when asked.
+ * Each call returns a fresh instance, so tests and SSR requests don't share one.
+ */
+export async function createI18n(opts) {
+    if (!opts.resources[SOURCE_LOCALE])
+        throw new Error("createI18n: English (en) catalogs are required");
+    const resources = { ...opts.resources };
+    const supported = [...LOCALE_CODES];
+    if (opts.pseudo) {
+        resources[PSEUDO_LOCALE] = pseudoizeCatalog(opts.resources[SOURCE_LOCALE]);
+        supported.push(PSEUDO_LOCALE);
+    }
+    const instance = i18next.createInstance();
+    for (const plugin of opts.use ?? [])
+        instance.use(plugin);
+    await instance.init({
+        resources,
+        lng: supported.includes(opts.locale) ? opts.locale : SOURCE_LOCALE,
+        fallbackLng: SOURCE_LOCALE,
+        supportedLngs: supported,
+        // "zh-Hans" must not quietly load "zh", and "pt-BR" must not load "pt".
+        load: "currentOnly",
+        nonExplicitSupportedLngs: false,
+        defaultNS: opts.defaultNS ?? "common",
+        ns: Object.keys(opts.resources[SOURCE_LOCALE]),
+        interpolation: { escapeValue: false },
+        returnNull: false,
+        saveMissing: Boolean(opts.onMissingKey),
+        missingKeyHandler: opts.onMissingKey
+            ? (_saveTo, ns, key) => opts.onMissingKey(instance.language, ns, key)
+            : undefined,
+        ...opts.init,
+    });
+    return instance;
+}
+/** Set `<html lang dir>` so screen readers, fonts, hyphenation and RTL layout follow the language. */
+export function applyDocumentLocale(locale, doc = globalThis.document) {
+    if (!doc?.documentElement)
+        return;
+    doc.documentElement.lang = locale;
+    doc.documentElement.dir = dirOf(locale);
+}
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,OAA+D,MAAM,SAAS,CAAC;AACtF,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AAClG,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAqB/C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAuB;IACtD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACtG,MAAM,SAAS,GAAa,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAClD,MAAM,SAAS,GAAa,CAAC,GAAG,YAAY,CAAC,CAAC;IAC9C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,SAAS,CAAC,aAAa,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;QAC3E,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAC1C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,EAAE;QAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,QAAQ,CAAC,IAAI,CAAC;QAClB,SAAS;QACT,GAAG,EAAE,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa;QAClE,WAAW,EAAE,aAAa;QAC1B,aAAa,EAAE,SAAS;QACxB,wEAAwE;QACxE,IAAI,EAAE,aAAa;QACnB,wBAAwB,EAAE,KAAK;QAC/B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,QAAQ;QACrC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAE,CAAC;QAC/C,aAAa,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;QACrC,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;QACvC,iBAAiB,EAAE,IAAI,CAAC,YAAY;YAClC,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,YAAa,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,GAAG,CAAC;YACtE,CAAC,CAAC,SAAS;QACb,GAAG,IAAI,CAAC,IAAI;KACb,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,MAA4B,UAAU,CAAC,QAAQ;IACjG,IAAI,CAAC,GAAG,EAAE,eAAe;QAAE,OAAO;IAClC,GAAG,CAAC,eAAe,CAAC,IAAI,GAAG,MAAM,CAAC;IAClC,GAAG,CAAC,eAAe,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./locales.js";
+export * from "./match.js";
+export * from "./preference.js";
+export * from "./format.js";
+export * from "./pseudo.js";
+export * from "./i18n.js";
+export * from "./catalog.js";

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from "./locales.js";
+export * from "./match.js";
+export * from "./preference.js";
+export * from "./format.js";
+export * from "./pseudo.js";
+export * from "./i18n.js";
+export * from "./catalog.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}

package/dist/locales.d.ts

@@ -0,0 +1,133 @@
+/**
+ * The languages every Pulse product offers (ENG-1). English is the source
+ * language; every other catalog is translated from it.
+ *
+ * `code` is the BCP 47 tag used for catalogs, the cookie and the `lang`
+ * attribute. `intl` lists the locales handed to the Intl formatters: a
+ * language CLDR has no data for (Haitian Creole) names a close neighbour so
+ * dates and numbers don't silently come out in US English.
+ */
+export declare const LOCALES: readonly [{
+    readonly code: "en";
+    readonly english: "English";
+    readonly native: "English";
+    readonly dir: "ltr";
+    readonly intl: readonly ["en"];
+}, {
+    readonly code: "es";
+    readonly english: "Spanish";
+    readonly native: "Español";
+    readonly dir: "ltr";
+    readonly intl: readonly ["es"];
+}, {
+    readonly code: "zh-Hans";
+    readonly english: "Chinese (Simplified)";
+    readonly native: "简体中文";
+    readonly dir: "ltr";
+    readonly intl: readonly ["zh-Hans"];
+}, {
+    readonly code: "zh-Hant";
+    readonly english: "Chinese (Traditional)";
+    readonly native: "繁體中文";
+    readonly dir: "ltr";
+    readonly intl: readonly ["zh-Hant"];
+}, {
+    readonly code: "hi";
+    readonly english: "Hindi";
+    readonly native: "हिन्दी";
+    readonly dir: "ltr";
+    readonly intl: readonly ["hi"];
+}, {
+    readonly code: "ar";
+    readonly english: "Arabic";
+    readonly native: "العربية";
+    readonly dir: "rtl";
+    readonly intl: readonly ["ar"];
+}, {
+    readonly code: "fr";
+    readonly english: "French";
+    readonly native: "Français";
+    readonly dir: "ltr";
+    readonly intl: readonly ["fr"];
+}, {
+    readonly code: "pt-BR";
+    readonly english: "Portuguese (Brazil)";
+    readonly native: "Português (Brasil)";
+    readonly dir: "ltr";
+    readonly intl: readonly ["pt-BR"];
+}, {
+    readonly code: "ru";
+    readonly english: "Russian";
+    readonly native: "Русский";
+    readonly dir: "ltr";
+    readonly intl: readonly ["ru"];
+}, {
+    readonly code: "bn";
+    readonly english: "Bengali";
+    readonly native: "বাংলা";
+    readonly dir: "ltr";
+    readonly intl: readonly ["bn"];
+}, {
+    readonly code: "ja";
+    readonly english: "Japanese";
+    readonly native: "日本語";
+    readonly dir: "ltr";
+    readonly intl: readonly ["ja"];
+}, {
+    readonly code: "de";
+    readonly english: "German";
+    readonly native: "Deutsch";
+    readonly dir: "ltr";
+    readonly intl: readonly ["de"];
+}, {
+    readonly code: "id";
+    readonly english: "Indonesian";
+    readonly native: "Bahasa Indonesia";
+    readonly dir: "ltr";
+    readonly intl: readonly ["id"];
+}, {
+    readonly code: "ur";
+    readonly english: "Urdu";
+    readonly native: "اردو";
+    readonly dir: "rtl";
+    readonly intl: readonly ["ur"];
+}, {
+    readonly code: "vi";
+    readonly english: "Vietnamese";
+    readonly native: "Tiếng Việt";
+    readonly dir: "ltr";
+    readonly intl: readonly ["vi"];
+}, {
+    readonly code: "ko";
+    readonly english: "Korean";
+    readonly native: "한국어";
+    readonly dir: "ltr";
+    readonly intl: readonly ["ko"];
+}, {
+    readonly code: "fil";
+    readonly english: "Tagalog";
+    readonly native: "Tagalog";
+    readonly dir: "ltr";
+    readonly intl: readonly ["fil"];
+}, {
+    readonly code: "ht";
+    readonly english: "Haitian Creole";
+    readonly native: "Kreyòl ayisyen";
+    readonly dir: "ltr";
+    readonly intl: readonly ["ht", "fr-HT"];
+}];
+export type LocaleCode = (typeof LOCALES)[number]["code"];
+export type LocaleInfo = (typeof LOCALES)[number];
+export declare const SOURCE_LOCALE: LocaleCode;
+export declare const LOCALE_CODES: readonly LocaleCode[];
+/**
+ * Pseudo-locale for testing: English run through `pseudoize`, so any text
+ * still showing as plain English was never extracted. Never offered to users
+ * unless a product turns it on.
+ */
+export declare const PSEUDO_LOCALE = "en-XA";
+export declare const isLocaleCode: (x: unknown) => x is LocaleCode;
+export declare function localeInfo(code: LocaleCode): LocaleInfo;
+export declare const dirOf: (code: string) => "ltr" | "rtl";
+/** Locales for the Intl formatters (see the note on `intl` above). */
+export declare const intlLocalesOf: (code: string) => string[];

package/dist/locales.js

@@ -0,0 +1,47 @@
+/**
+ * The languages every Pulse product offers (ENG-1). English is the source
+ * language; every other catalog is translated from it.
+ *
+ * `code` is the BCP 47 tag used for catalogs, the cookie and the `lang`
+ * attribute. `intl` lists the locales handed to the Intl formatters: a
+ * language CLDR has no data for (Haitian Creole) names a close neighbour so
+ * dates and numbers don't silently come out in US English.
+ */
+export const LOCALES = [
+    { code: "en", english: "English", native: "English", dir: "ltr", intl: ["en"] },
+    { code: "es", english: "Spanish", native: "Español", dir: "ltr", intl: ["es"] },
+    { code: "zh-Hans", english: "Chinese (Simplified)", native: "简体中文", dir: "ltr", intl: ["zh-Hans"] },
+    { code: "zh-Hant", english: "Chinese (Traditional)", native: "繁體中文", dir: "ltr", intl: ["zh-Hant"] },
+    { code: "hi", english: "Hindi", native: "हिन्दी", dir: "ltr", intl: ["hi"] },
+    { code: "ar", english: "Arabic", native: "العربية", dir: "rtl", intl: ["ar"] },
+    { code: "fr", english: "French", native: "Français", dir: "ltr", intl: ["fr"] },
+    { code: "pt-BR", english: "Portuguese (Brazil)", native: "Português (Brasil)", dir: "ltr", intl: ["pt-BR"] },
+    { code: "ru", english: "Russian", native: "Русский", dir: "ltr", intl: ["ru"] },
+    { code: "bn", english: "Bengali", native: "বাংলা", dir: "ltr", intl: ["bn"] },
+    { code: "ja", english: "Japanese", native: "日本語", dir: "ltr", intl: ["ja"] },
+    { code: "de", english: "German", native: "Deutsch", dir: "ltr", intl: ["de"] },
+    { code: "id", english: "Indonesian", native: "Bahasa Indonesia", dir: "ltr", intl: ["id"] },
+    { code: "ur", english: "Urdu", native: "اردو", dir: "rtl", intl: ["ur"] },
+    { code: "vi", english: "Vietnamese", native: "Tiếng Việt", dir: "ltr", intl: ["vi"] },
+    { code: "ko", english: "Korean", native: "한국어", dir: "ltr", intl: ["ko"] },
+    // "tl" (Tagalog) canonicalises to "fil" in Intl; matching accepts both.
+    { code: "fil", english: "Tagalog", native: "Tagalog", dir: "ltr", intl: ["fil"] },
+    { code: "ht", english: "Haitian Creole", native: "Kreyòl ayisyen", dir: "ltr", intl: ["ht", "fr-HT"] },
+];
+export const SOURCE_LOCALE = "en";
+export const LOCALE_CODES = LOCALES.map((l) => l.code);
+/**
+ * Pseudo-locale for testing: English run through `pseudoize`, so any text
+ * still showing as plain English was never extracted. Never offered to users
+ * unless a product turns it on.
+ */
+export const PSEUDO_LOCALE = "en-XA";
+const byCode = new Map(LOCALES.map((l) => [l.code, l]));
+export const isLocaleCode = (x) => typeof x === "string" && byCode.has(x);
+export function localeInfo(code) {
+    return byCode.get(code);
+}
+export const dirOf = (code) => byCode.get(code)?.dir ?? "ltr";
+/** Locales for the Intl formatters (see the note on `intl` above). */
+export const intlLocalesOf = (code) => [...(byCode.get(code)?.intl ?? (code === PSEUDO_LOCALE ? ["en"] : [code])), "en"];
+//# sourceMappingURL=locales.js.map

package/dist/locales.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locales.js","sourceRoot":"","sources":["../src/locales.ts"],"names":[],"mappings":"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"}

package/dist/match.d.ts

@@ -0,0 +1,17 @@
+import { type LocaleCode } from "./locales.js";
+/**
+ * The supported locale a single language tag should get, or null.
+ *   exact code (any case)       → that code
+ *   zh-TW / zh-HK / zh-MO       → zh-Hant (by script); other zh → zh-Hans
+ *   pt, pt-PT                   → pt-BR (the only Portuguese we offer)
+ *   es-MX, en-GB, fr-CA, …      → the base language when we offer it
+ */
+export declare function matchLocale(tag: string | null | undefined): LocaleCode | null;
+/** The first tag, in order of preference, that we support. */
+export declare function resolveLocale(tags: Iterable<string | null | undefined>): LocaleCode | null;
+/**
+ * An Accept-Language header as tags, most preferred first. Entries with q=0
+ * ("not this one") and the "*" wildcard are dropped; equal weights keep the
+ * order they were sent in.
+ */
+export declare function parseAcceptLanguage(header: string | null | undefined): string[];

package/dist/match.js

@@ -0,0 +1,60 @@
+import { LOCALE_CODES } from "./locales.js";
+const lowerToCode = new Map(LOCALE_CODES.map((c) => [c.toLowerCase(), c]));
+/**
+ * The supported locale a single language tag should get, or null.
+ *   exact code (any case)       → that code
+ *   zh-TW / zh-HK / zh-MO       → zh-Hant (by script); other zh → zh-Hans
+ *   pt, pt-PT                   → pt-BR (the only Portuguese we offer)
+ *   es-MX, en-GB, fr-CA, …      → the base language when we offer it
+ */
+export function matchLocale(tag) {
+    if (!tag)
+        return null;
+    let canonical;
+    let loc;
+    try {
+        canonical = Intl.getCanonicalLocales(tag.trim().replace(/_/g, "-"))[0];
+        loc = new Intl.Locale(canonical);
+    }
+    catch {
+        return null; // not a language tag at all
+    }
+    const exact = lowerToCode.get(canonical.toLowerCase());
+    if (exact)
+        return exact;
+    if (loc.language === "zh")
+        return loc.maximize().script === "Hant" ? "zh-Hant" : "zh-Hans";
+    if (loc.language === "pt")
+        return "pt-BR";
+    return lowerToCode.get(loc.language) ?? null;
+}
+/** The first tag, in order of preference, that we support. */
+export function resolveLocale(tags) {
+    for (const t of tags) {
+        const m = matchLocale(t);
+        if (m)
+            return m;
+    }
+    return null;
+}
+/**
+ * An Accept-Language header as tags, most preferred first. Entries with q=0
+ * ("not this one") and the "*" wildcard are dropped; equal weights keep the
+ * order they were sent in.
+ */
+export function parseAcceptLanguage(header) {
+    if (!header)
+        return [];
+    return header
+        .split(",")
+        .map((part) => {
+        const [tag, ...params] = part.trim().split(";");
+        const qParam = params.map((p) => p.trim()).find((p) => p.startsWith("q="));
+        const q = qParam ? Number(qParam.slice(2)) : 1;
+        return { tag: tag.trim(), q: Number.isFinite(q) ? q : 0 };
+    })
+        .filter((x) => x.tag && x.tag !== "*" && x.q > 0)
+        .sort((a, b) => b.q - a.q) // stable: ties keep the order they were sent in
+        .map((x) => x.tag);
+}
+//# sourceMappingURL=match.js.map

package/dist/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../src/match.ts"],"names":[],"mappings":"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"}

package/dist/preference.d.ts

@@ -0,0 +1,35 @@
+import { type LocaleCode } from "./locales.js";
+/** One cookie for the whole fleet, so a choice made in one product carries to the others. */
+export declare const LANG_COOKIE = "pulse_lang";
+/**
+ * Where the cookie should live: shared across every *.pulsetechnologies.ai
+ * product, or host-only anywhere else (partner white-label domains, localhost).
+ */
+export declare function cookieDomainFor(hostname: string): string | undefined;
+/** The language in a Cookie header / `document.cookie`, if it's one we support. */
+export declare function readLangCookie(cookieHeader: string | null | undefined): LocaleCode | null;
+/** A Set-Cookie / `document.cookie` string that remembers the language for a year. */
+export declare function langCookie(code: LocaleCode, opts: {
+    hostname: string;
+    secure?: boolean;
+    maxAgeDays?: number;
+}): string;
+export type LocaleSource = "user" | "cookie" | "workspace" | "browser" | "default";
+export interface LocaleInputs {
+    /** The signed-in user's saved choice (ENG-3: stored on the Pulse SSO profile). */
+    user?: string | null;
+    /** The `pulse_lang` cookie value, or the whole Cookie header. */
+    cookie?: string | null;
+    /** The workspace / tenant default set by an admin. */
+    workspace?: string | null;
+    /** `navigator.languages`, or an Accept-Language header. */
+    browser?: readonly string[] | string | null;
+}
+/**
+ * Which language to show, in order: the user's own choice, the cookie from
+ * any Pulse product, the workspace default, the browser, then English.
+ */
+export declare function pickLocale(inputs: LocaleInputs): {
+    locale: LocaleCode;
+    source: LocaleSource;
+};

package/dist/preference.js

@@ -0,0 +1,63 @@
+import { isLocaleCode, SOURCE_LOCALE } from "./locales.js";
+import { parseAcceptLanguage, resolveLocale } from "./match.js";
+/** One cookie for the whole fleet, so a choice made in one product carries to the others. */
+export const LANG_COOKIE = "pulse_lang";
+const FLEET_DOMAIN = "pulsetechnologies.ai";
+/**
+ * Where the cookie should live: shared across every *.pulsetechnologies.ai
+ * product, or host-only anywhere else (partner white-label domains, localhost).
+ */
+export function cookieDomainFor(hostname) {
+    const h = hostname.toLowerCase();
+    return h === FLEET_DOMAIN || h.endsWith(`.${FLEET_DOMAIN}`) ? `.${FLEET_DOMAIN}` : undefined;
+}
+/** The language in a Cookie header / `document.cookie`, if it's one we support. */
+export function readLangCookie(cookieHeader) {
+    for (const part of (cookieHeader ?? "").split(";")) {
+        const eq = part.indexOf("=");
+        if (eq < 0 || part.slice(0, eq).trim() !== LANG_COOKIE)
+            continue;
+        let value;
+        try {
+            value = decodeURIComponent(part.slice(eq + 1).trim());
+        }
+        catch {
+            return null;
+        }
+        return isLocaleCode(value) ? value : null;
+    }
+    return null;
+}
+/** A Set-Cookie / `document.cookie` string that remembers the language for a year. */
+export function langCookie(code, opts) {
+    const domain = cookieDomainFor(opts.hostname);
+    return [
+        `${LANG_COOKIE}=${encodeURIComponent(code)}`,
+        "Path=/",
+        `Max-Age=${Math.round((opts.maxAgeDays ?? 365) * 86_400)}`,
+        "SameSite=Lax",
+        ...(domain ? [`Domain=${domain}`] : []),
+        ...(opts.secure === false ? [] : ["Secure"]),
+    ].join("; ");
+}
+/**
+ * Which language to show, in order: the user's own choice, the cookie from
+ * any Pulse product, the workspace default, the browser, then English.
+ */
+export function pickLocale(inputs) {
+    const cookie = inputs.cookie?.includes("=") ? readLangCookie(inputs.cookie) : inputs.cookie;
+    const browser = typeof inputs.browser === "string" ? parseAcceptLanguage(inputs.browser) : (inputs.browser ?? []);
+    const steps = [
+        ["user", [inputs.user]],
+        ["cookie", [cookie]],
+        ["workspace", [inputs.workspace]],
+        ["browser", browser],
+    ];
+    for (const [source, tags] of steps) {
+        const locale = resolveLocale(tags);
+        if (locale)
+            return { locale, source };
+    }
+    return { locale: SOURCE_LOCALE, source: "default" };
+}
+//# sourceMappingURL=preference.js.map

package/dist/preference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preference.js","sourceRoot":"","sources":["../src/preference.ts"],"names":[],"mappings":"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"}

package/dist/pseudo.d.ts

@@ -0,0 +1,3 @@
+export declare function pseudoize(text: string): string;
+/** A whole catalog (nested objects of strings) run through `pseudoize`. */
+export declare function pseudoizeCatalog<T>(catalog: T): T;

package/dist/pseudo.js

@@ -0,0 +1,43 @@
+/**
+ * Pseudo-translation: "Save changes" → "[Šåvé çĥåñĝéš ·····]". Anything on
+ * screen that still reads as plain English was never extracted, and the
+ * padding (~40%, what German and Russian typically need) shows where layouts
+ * will clip. Placeholders, nesting and markup are left intact so the result
+ * still interpolates.
+ */
+const ACCENTED = {
+    a: "å", b: "ƀ", c: "ç", d: "ð", e: "é", f: "ƒ", g: "ĝ", h: "ĥ", i: "î", j: "ĵ", k: "ķ", l: "ļ", m: "ɱ",
+    n: "ñ", o: "ö", p: "þ", q: "ǫ", r: "ŕ", s: "š", t: "ţ", u: "û", v: "ṽ", w: "ŵ", x: "ẋ", y: "ý", z: "ž",
+    A: "Å", B: "Ɓ", C: "Ç", D: "Ð", E: "É", F: "Ƒ", G: "Ĝ", H: "Ĥ", I: "Î", J: "Ĵ", K: "Ķ", L: "Ļ", M: "Ṁ",
+    N: "Ñ", O: "Ö", P: "Þ", Q: "Ǫ", R: "Ŕ", S: "Š", T: "Ţ", U: "Û", V: "Ṽ", W: "Ŵ", X: "Ẋ", Y: "Ý", Z: "Ž",
+};
+/** {{name}}, {{count, number}}, $t(other.key), <b>, </0>, <br/> */
+const KEEP = /(\{\{[^}]*\}\}|\$t\([^)]*\)|<\/?[a-zA-Z0-9]+\s*\/?>)/;
+export function pseudoize(text) {
+    let letters = 0;
+    const body = text
+        .split(KEEP)
+        .map((part, i) => {
+        if (i % 2 === 1)
+            return part; // a kept token
+        return part.replace(/[a-zA-Z]/g, (ch) => {
+            letters++;
+            return ACCENTED[ch] ?? ch;
+        });
+    })
+        .join("");
+    const pad = letters ? " " + "·".repeat(Math.max(1, Math.round(letters * 0.4))) : "";
+    return `[${body}${pad}]`;
+}
+/** A whole catalog (nested objects of strings) run through `pseudoize`. */
+export function pseudoizeCatalog(catalog) {
+    if (typeof catalog === "string")
+        return pseudoize(catalog);
+    if (Array.isArray(catalog))
+        return catalog.map((v) => pseudoizeCatalog(v));
+    if (catalog && typeof catalog === "object") {
+        return Object.fromEntries(Object.entries(catalog).map(([k, v]) => [k, pseudoizeCatalog(v)]));
+    }
+    return catalog;
+}
+//# sourceMappingURL=pseudo.js.map

package/dist/pseudo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pseudo.js","sourceRoot":"","sources":["../src/pseudo.ts"],"names":[],"mappings":"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"}

package/dist/react/index.d.ts

@@ -0,0 +1,44 @@
+import { type CSSProperties } from "react";
+import { PSEUDO_LOCALE, type LocaleCode } from "../locales.js";
+export interface LanguageSelectProps {
+    value: string;
+    onChange: (code: LocaleCode | typeof PSEUDO_LOCALE) => void;
+    /** Limit or reorder the list; defaults to all 18. */
+    locales?: readonly LocaleCode[];
+    /** Also list the en-XA pseudo-locale (dev / staging only). */
+    pseudo?: boolean;
+    /** Accessible name. Kept bilingual by default so it's findable in any language. */
+    label?: string;
+    id?: string;
+    className?: string;
+    style?: CSSProperties;
+    disabled?: boolean;
+}
+/**
+ * The language dropdown. A native <select>, so it's keyboard- and
+ * screen-reader-friendly on every platform and takes each product's own
+ * styling via className. Each language is shown in its own script ("Español",
+ * "العربية"), which is what a reader who can't read the current language
+ * looks for.
+ */
+export declare function LanguageSelect({ value, onChange, locales, pseudo, label, id, className, style, disabled }: LanguageSelectProps): import("react").JSX.Element;
+export interface UseLanguageOptions {
+    /**
+     * Save the choice beyond this browser — e.g. to the Pulse SSO profile (ENG-3).
+     * Errors are reported to `onPersistError` and never undo the switch.
+     */
+    persist?: (code: LocaleCode) => void | Promise<void>;
+    onPersistError?: (err: unknown) => void;
+}
+/**
+ * The active language, and a setter that switches the UI, keeps <html lang dir>
+ * in step, writes the fleet-wide `pulse_lang` cookie and calls `persist`.
+ * Needs an i18next instance provided through react-i18next.
+ */
+export declare function useLanguage(opts?: UseLanguageOptions): {
+    locale: string;
+    setLocale: (code: LocaleCode | typeof PSEUDO_LOCALE) => Promise<void>;
+};
+export type LanguagePickerProps = Omit<LanguageSelectProps, "value" | "onChange"> & UseLanguageOptions;
+/** Drop-in picker: `<LanguagePicker persist={saveToProfile} />` inside an I18nextProvider. */
+export declare function LanguagePicker({ persist, onPersistError, ...select }: LanguagePickerProps): import("react").JSX.Element;

package/dist/react/index.js

@@ -0,0 +1,59 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect } from "react";
+import { useTranslation } from "react-i18next";
+import { applyDocumentLocale } from "../i18n.js";
+import { isLocaleCode, LOCALES, PSEUDO_LOCALE, SOURCE_LOCALE } from "../locales.js";
+import { langCookie } from "../preference.js";
+/**
+ * The language dropdown. A native <select>, so it's keyboard- and
+ * screen-reader-friendly on every platform and takes each product's own
+ * styling via className. Each language is shown in its own script ("Español",
+ * "العربية"), which is what a reader who can't read the current language
+ * looks for.
+ */
+export function LanguageSelect({ value, onChange, locales, pseudo, label = "Language", id, className, style, disabled }) {
+    const shown = locales ? LOCALES.filter((l) => locales.includes(l.code)) : LOCALES;
+    return (_jsxs("select", { id: id, className: className, style: style, disabled: disabled, "aria-label": label, value: value, onChange: (e) => {
+            const v = e.target.value;
+            if (isLocaleCode(v) || (pseudo && v === PSEUDO_LOCALE))
+                onChange(v);
+        }, children: [shown.map((l) => (_jsx("option", { value: l.code, lang: l.code, dir: l.dir, title: l.english, children: l.native }, l.code))), pseudo ? _jsx("option", { value: PSEUDO_LOCALE, lang: "en", title: "Pseudo-locale (testing)", children: "[\u00DE\u0161\u00E9\u00FB\u00F0\u00F6]" }) : null] }));
+}
+/**
+ * The active language, and a setter that switches the UI, keeps <html lang dir>
+ * in step, writes the fleet-wide `pulse_lang` cookie and calls `persist`.
+ * Needs an i18next instance provided through react-i18next.
+ */
+export function useLanguage(opts = {}) {
+    const { i18n } = useTranslation();
+    // The language the user chose, even where its catalog is still thin and
+    // strings fall back to English — the picker must not snap back to English.
+    const locale = i18n.language ?? SOURCE_LOCALE;
+    const { persist, onPersistError } = opts;
+    useEffect(() => {
+        applyDocumentLocale(locale);
+    }, [locale]);
+    const setLocale = useCallback(async (code) => {
+        await i18n.changeLanguage(code);
+        if (!isLocaleCode(code))
+            return; // the pseudo-locale is never remembered
+        if (typeof document !== "undefined" && typeof location !== "undefined") {
+            document.cookie = langCookie(code, { hostname: location.hostname, secure: location.protocol === "https:" });
+        }
+        if (persist) {
+            try {
+                await persist(code);
+            }
+            catch (err) {
+                onPersistError?.(err);
+            }
+        }
+    }, [i18n, persist, onPersistError]);
+    return { locale, setLocale };
+}
+/** Drop-in picker: `<LanguagePicker persist={saveToProfile} />` inside an I18nextProvider. */
+export function LanguagePicker({ persist, onPersistError, ...select }) {
+    const { locale, setLocale } = useLanguage({ persist, onPersistError });
+    return _jsx(LanguageSelect, { ...select, value: locale, onChange: (c) => void setLocale(c) });
+}
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@pulsetechnologies/i18n",
+  "version": "0.1.0",
+  "description": "Shared language list, detection, formatting and language picker for every Pulse product.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pulsetechnologies-ai/pulse-i18n.git"
+  },
+  "homepage": "https://pulsetechnologies.ai",
+  "keywords": [
+    "i18n",
+    "locale",
+    "pulse"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "demo": "vite --config demo/vite.config.ts",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "i18next": ">=25",
+    "react": ">=18",
+    "react-i18next": ">=15"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-i18next": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitejs/plugin-react": "^6.1.1",
+    "i18next": "^26.4.2",
+    "jsdom": "^30.1.1",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "react-i18next": "^17.0.15",
+    "typescript": "^5.9.3",
+    "vite": "^8.3.1",
+    "vitest": "^5.0.3"
+  }
+}