@vocoder/core 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vocoder
+
+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,209 @@
+# @vocoder/core
+
+Shared primitives for the Vocoder i18n SDK.
+
+## Installation
+
+```bash
+npm install @vocoder/core
+```
+
+## When to use this package directly
+
+Most users should install `@vocoder/react` instead — it re-exports everything from this package along with the React components and hooks.
+
+Use `@vocoder/core` directly only when you are:
+
+- Building a custom framework integration that does not use React
+- Writing tooling (extractors, validators, migration scripts) that needs hash generation or ICU formatting without a React dependency
+- Implementing a custom runtime that needs cookie utilities or locale matching
+
+---
+
+## API Reference
+
+### `generateMessageHash(text, context?, formality?)`
+
+Generates a stable 7-character base-36 message ID from source text. Produces the same output in Node.js and browsers. Used by the extractor at build time and the runtime in the browser — both always produce the same key for the same input.
+
+```ts
+import { generateMessageHash } from "@vocoder/core";
+
+// Deterministic — same input always produces the same hash
+generateMessageHash("Hello, world!");         // "3k2m9q1"
+
+// Context disambiguates identical strings with different meanings
+generateMessageHash("Save", "button label");  // different hash
+generateMessageHash("Save", "dialog title");  // different hash
+
+// Formality produces separate keys for register variants
+generateMessageHash("Welcome back", undefined, "formal");   // hash A
+generateMessageHash("Welcome back", undefined, "informal"); // hash B
+generateMessageHash("Welcome back", undefined, "auto");     // same as no formality
+```
+
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `text` | `string` | yes | Source message text |
+| `context` | `string` | no | Disambiguation string for identical text with different meanings |
+| `formality` | `string` | no | `"formal"` or `"informal"` produce distinct hashes; `"auto"` and `undefined` hash identically |
+
+Returns a 7-character `string` (base-36, zero-padded). Collision probability is approximately 0.002% across 10,000 strings.
+
+---
+
+### `formatICU(text, values, locale?)`
+
+Formats an ICU MessageFormat string with interpolated values. Returns the raw `text` unchanged if parsing or formatting throws — the caller always receives a string, never an exception.
+
+```ts
+import { formatICU } from "@vocoder/core";
+
+// Plural
+formatICU(
+  "{count, plural, one {# item} other {# items}}",
+  { count: 1 },
+  "en"
+); // "1 item"
+
+formatICU(
+  "{count, plural, one {# item} other {# items}}",
+  { count: 5 },
+  "en"
+); // "5 items"
+
+// Select
+formatICU(
+  "{gender, select, male {He agreed} female {She agreed} other {They agreed}}",
+  { gender: "female" },
+  "en"
+); // "She agreed"
+
+// Simple interpolation
+formatICU("Hello, {name}!", { name: "Maria" }, "es"); // "Hello, Maria!"
+```
+
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `text` | `string` | yes | ICU MessageFormat string |
+| `values` | `Record<string, any>` | yes | Interpolation values keyed by placeholder name |
+| `locale` | `string` | no | BCP 47 locale tag; defaults to `"en"` |
+
+Returns a `string`. Parsed results are cached by `"locale:text"` key.
+
+---
+
+### `rewriteSelectordinalInICU(icu, ordinalForms, values)`
+
+Rewrites any embedded `selectordinal` nodes in an ICU string using a locale's `ordinalForms` data before passing the string to `formatICU`. This is required when a `selectordinal` appears inside a larger sentence rather than as the sole top-level element, because translation providers store incorrect ordinal branches in those cases.
+
+```ts
+import { rewriteSelectordinalInICU, formatICU } from "@vocoder/core";
+
+const rewritten = rewriteSelectordinalInICU(
+  "Congrats on your {year, selectordinal, one {#st} two {#nd} few {#rd} other {#th}} anniversary!",
+  ordinalForms, // from locale bundle
+  { year: 3 }
+);
+const result = formatICU(rewritten, { year: 3 }, "en");
+// "Congrats on your 3rd anniversary!"
+```
+
+Returns `icu` unchanged when the string contains no `"selectordinal"` substring (fast path) or when parsing throws.
+
+This function is called automatically by `@vocoder/react` when rendering ordinals. See the `@vocoder/react` docs for usage via `ordinal()` and the `<T>` component.
+
+---
+
+### `formatValue(value, format, locale, options?)`
+
+Formats a number or date value using `Intl.NumberFormat` or `Intl.DateTimeFormat`. Formatters are cached internally.
+
+```ts
+import { formatValue } from "@vocoder/core";
+
+formatValue(1234567.89, "number",   "de");                         // "1.234.567,89"
+formatValue(0.175,      "percent",  "en");                         // "17.5%"
+formatValue(9876543,    "compact",  "en");                         // "9.9M"
+formatValue(42.6,       "integer",  "fr");                         // "43"
+formatValue(49.99,      "currency", "en", { currency: "USD" });    // "$49.99"
+formatValue(new Date(), "date",     "ja", { dateStyle: "long" });  // "2026年5月9日"
+formatValue(new Date(), "time",     "en");                         // "3:04 PM"
+formatValue(new Date(), "datetime", "en", { dateStyle: "short", timeStyle: "short" }); // "5/9/26, 3:04 PM"
+```
+
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `value` | `string \| number \| Date` | yes | The value to format |
+| `format` | `FormatMode` | yes | One of the format modes listed below |
+| `locale` | `string` | yes | BCP 47 locale tag |
+| `options` | `FormatValueOptions` | no | Additional formatting options |
+
+**Format modes:**
+
+| Mode | Input type | Description |
+|---|---|---|
+| `"number"` | number | Locale-aware decimal formatting |
+| `"integer"` | number | Rounded to zero decimal places |
+| `"percent"` | number | Multiplies by 100 and appends percent sign |
+| `"compact"` | number | Abbreviated notation (1.2M, 3.4K) |
+| `"currency"` | number | Currency symbol and formatting; requires `options.currency` |
+| `"date"` | Date / string / number | Date portion only |
+| `"time"` | Date / string / number | Time portion only |
+| `"datetime"` | Date / string / number | Date and time |
+
+**`FormatValueOptions`:**
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `currency` | `string` | — | ISO 4217 currency code (e.g. `"USD"`); required when `format` is `"currency"` |
+| `dateStyle` | `"full" \| "long" \| "medium" \| "short"` | `"medium"` | Date display style |
+| `timeStyle` | `"full" \| "long" \| "medium" \| "short"` | `"short"` | Time display style |
+
+---
+
+### `getCookie(name, cookieString?)` / `getBestMatchingLocale(...)` / `setCookie(...)`
+
+Cookie utilities and locale negotiation used by the Vocoder provider for locale detection and persistence.
+
+```ts
+import { getCookie, setBestMatchingLocale, setCookie, getBestMatchingLocale } from "@vocoder/core";
+
+// Read a cookie (browser or server)
+const locale = getCookie("vocoder_locale");                        // browser
+const locale = getCookie("vocoder_locale", req.headers.cookie);   // server
+
+// Write a cookie (browser only)
+setCookie("vocoder_locale", "fr", { maxAge: 31536000, path: "/" });
+
+// Negotiate the best supported locale from a preferred value
+getBestMatchingLocale("en-US", ["en", "fr", "de"], "en"); // "en"
+getBestMatchingLocale("pt-BR", ["pt", "en"],       "en"); // "pt"
+getBestMatchingLocale("zh",    ["en", "fr"],        "en"); // "en" (fallback)
+```
+
+**`getCookie(name, cookieString?)`** — Reads a cookie by name. When `cookieString` is omitted it reads from `document.cookie` in the browser. Returns `null` when the cookie is absent or the environment is not a browser and no string was provided.
+
+**`setCookie(name, value, options?)`** — Writes a cookie to `document.cookie`. No-ops in non-browser environments. Defaults: `maxAge` 1 year, `path` `/`, `sameSite` `"Lax"`, `secure` based on current protocol.
+
+**`getBestMatchingLocale(preferredLocale, supportedLocales, fallback)`** — Returns the closest supported locale for a given preference. Tries exact match first, then language-only match (`"en-US"` → `"en"`), then any regional variant of the same language, then the fallback.
+
+---
+
+## Types
+
+| Type | Description |
+|---|---|
+| `TranslationsMap` | Nested map of `locale → key → translated string` |
+| `OrdinalSuffixes` | CLDR plural-category suffixes (`zero`, `one`, `two`, `few`, `many`, `other`) for suffix-based ordinals |
+| `OrdinalForms` | Discriminated union: `{ type: "suffix"; suffixes: OrdinalSuffixes }` or `{ type: "word"; words: Record<string, Record<number, string>> }` |
+| `LocaleInfo` | Metadata for a single locale: `nativeName`, optional `dir` (`"rtl"`), `currencyCode`, and `ordinalForms` |
+| `LocalesMap` | Map of locale code → `LocaleInfo` |
+| `FormatMode` | Union of valid format mode strings for `formatValue` |
+| `TOptions` | Options for `<T>` and `t()`: `context`, `formality`, and `id` |
+| `VocoderTranslationData` | Canonical translation bundle shape: `config` (source locale, target locales, locale metadata) + `translations` map + `updatedAt` |
+| `FormatValueOptions` | Options for `formatValue`: `currency`, `dateStyle`, `timeStyle` |
+
+---
+
+Most users should install `@vocoder/react` which re-exports everything from this package.

package/dist/index.d.mts

@@ -0,0 +1,124 @@
+declare function getCookie(name: string, cookieString?: string): string | null;
+declare function setCookie(name: string, value: string, options?: {
+    maxAge?: number;
+    path?: string;
+    domain?: string;
+    sameSite?: "Strict" | "Lax" | "None";
+    secure?: boolean;
+}): void;
+/**
+ * Find the best matching locale from available options.
+ * Handles language codes and regional variants (e.g., 'en-US' -> 'en').
+ */
+declare function getBestMatchingLocale(preferredLocale: string, supportedLocales: string[], fallback: string): string;
+
+interface TranslationsMap {
+    [locale: string]: {
+        [key: string]: string;
+    };
+}
+interface OrdinalSuffixes {
+    zero?: string;
+    one?: string;
+    two?: string;
+    few?: string;
+    many?: string;
+    other: string;
+}
+/**
+ * Discriminated union for locale ordinal data in the translation bundle.
+ *
+ * - `suffix`: Ordinals formed by number + suffix (e.g. "1st", "1er", "1.").
+ *   The `#` placeholder is replaced with the rank at runtime.
+ * - `word`: Ordinals are full words (Arabic, Hebrew). Gender-keyed maps from rank → word.
+ *   Ranks not present in the map fall back to String(value).
+ */
+type OrdinalForms = {
+    type: "suffix";
+    suffixes: OrdinalSuffixes;
+} | {
+    type: "word";
+    words: Record<string, Record<number, string>>;
+};
+interface LocaleInfo {
+    nativeName: string;
+    dir?: "rtl";
+    currencyCode?: string;
+    ordinalForms?: OrdinalForms;
+}
+interface LocalesMap {
+    [localeCode: string]: LocaleInfo;
+}
+type FormatMode = "number" | "integer" | "percent" | "compact" | "currency" | "date" | "time" | "datetime";
+interface TOptions {
+    /** Context string for disambiguation (same text, different meaning). */
+    context?: string;
+    /** Formality level for translation. */
+    formality?: "formal" | "informal" | "auto";
+    /** Stable translation key. When provided, used as lookup key instead of hashing the message text. */
+    id?: string;
+}
+/**
+ * Canonical translation bundle format shared by the build plugin and CLI.
+ * Both read and write this shape — keeps cache files identical regardless of
+ * which tool produced them.
+ *
+ * translations: locale → sourceKey (hash) → translated text
+ * config.locales: locale metadata snapshot for the runtime
+ */
+interface VocoderTranslationData {
+    config: {
+        sourceLocale: string;
+        targetLocales: string[];
+        locales: Record<string, LocaleInfo>;
+    };
+    translations: Record<string, Record<string, string>>;
+    updatedAt: string | null;
+}
+
+interface FormatValueOptions {
+    currency?: string;
+    dateStyle?: "full" | "long" | "medium" | "short";
+    timeStyle?: "full" | "long" | "medium" | "short";
+}
+declare function formatValue(value: string | number | Date, format: FormatMode, locale: string, options?: FormatValueOptions): string;
+
+/**
+ * FNV-1a 32-bit hash for generating stable message IDs from source text.
+ *
+ * Works identically in Node.js and browsers (no platform APIs).
+ * Used by the extractor (build time) and the React runtime (browser) — both
+ * always produce the same key for the same source text.
+ *
+ * Output: 7 base-36 chars (~2.2 billion values).
+ * Collision probability ≈ 0.002% for 10K strings (birthday problem).
+ * Add `context` to disambiguate identical strings with different meanings.
+ * Add `formality` ("formal" | "informal") to produce separate keys for
+ * register variants — "neutral", "auto", and undefined hash identically.
+ *
+ * Separators: \x04 (ASCII EOT) for context, \x05 (ASCII ENQ) for formality.
+ */
+declare function generateMessageHash(text: string, context?: string, formality?: string): string;
+
+/**
+ * Format an ICU MessageFormat string with the given values and locale.
+ * Returns the raw `text` unchanged if parsing or formatting throws — the
+ * caller always gets a string, never an exception.
+ */
+declare function formatICU(text: string, values: Record<string, any>, locale?: string): string;
+/**
+ * Rewrite any embedded `selectordinal` nodes in an ICU string using
+ * `ordinalForms` from the locale bundle, before passing the string to
+ * `formatICU`.
+ *
+ * Returns `icu` unchanged when:
+ * - the string contains no "selectordinal" substring (fast path — most strings)
+ * - parsing throws (safe fallback to whatever formatICU receives)
+ *
+ * @param icu - Translated ICU string (may contain garbage ordinal branches from provider)
+ * @param ordinalForms - Locale's ordinalForms from the compiled bundle
+ * @param values - Runtime interpolation values (needed for word-based rank lookup)
+ */
+declare function rewriteSelectordinalInICU(icu: string, ordinalForms: OrdinalForms, values: Record<string, any>): string;
+
+export { type FormatMode, type FormatValueOptions, type LocaleInfo, type LocalesMap, type OrdinalForms, type OrdinalSuffixes, type TOptions, type TranslationsMap, type VocoderTranslationData, formatICU, formatValue, generateMessageHash, getBestMatchingLocale, getCookie, rewriteSelectordinalInICU, setCookie };

package/dist/index.d.ts

@@ -0,0 +1,124 @@
+declare function getCookie(name: string, cookieString?: string): string | null;
+declare function setCookie(name: string, value: string, options?: {
+    maxAge?: number;
+    path?: string;
+    domain?: string;
+    sameSite?: "Strict" | "Lax" | "None";
+    secure?: boolean;
+}): void;
+/**
+ * Find the best matching locale from available options.
+ * Handles language codes and regional variants (e.g., 'en-US' -> 'en').
+ */
+declare function getBestMatchingLocale(preferredLocale: string, supportedLocales: string[], fallback: string): string;
+
+interface TranslationsMap {
+    [locale: string]: {
+        [key: string]: string;
+    };
+}
+interface OrdinalSuffixes {
+    zero?: string;
+    one?: string;
+    two?: string;
+    few?: string;
+    many?: string;
+    other: string;
+}
+/**
+ * Discriminated union for locale ordinal data in the translation bundle.
+ *
+ * - `suffix`: Ordinals formed by number + suffix (e.g. "1st", "1er", "1.").
+ *   The `#` placeholder is replaced with the rank at runtime.
+ * - `word`: Ordinals are full words (Arabic, Hebrew). Gender-keyed maps from rank → word.
+ *   Ranks not present in the map fall back to String(value).
+ */
+type OrdinalForms = {
+    type: "suffix";
+    suffixes: OrdinalSuffixes;
+} | {
+    type: "word";
+    words: Record<string, Record<number, string>>;
+};
+interface LocaleInfo {
+    nativeName: string;
+    dir?: "rtl";
+    currencyCode?: string;
+    ordinalForms?: OrdinalForms;
+}
+interface LocalesMap {
+    [localeCode: string]: LocaleInfo;
+}
+type FormatMode = "number" | "integer" | "percent" | "compact" | "currency" | "date" | "time" | "datetime";
+interface TOptions {
+    /** Context string for disambiguation (same text, different meaning). */
+    context?: string;
+    /** Formality level for translation. */
+    formality?: "formal" | "informal" | "auto";
+    /** Stable translation key. When provided, used as lookup key instead of hashing the message text. */
+    id?: string;
+}
+/**
+ * Canonical translation bundle format shared by the build plugin and CLI.
+ * Both read and write this shape — keeps cache files identical regardless of
+ * which tool produced them.
+ *
+ * translations: locale → sourceKey (hash) → translated text
+ * config.locales: locale metadata snapshot for the runtime
+ */
+interface VocoderTranslationData {
+    config: {
+        sourceLocale: string;
+        targetLocales: string[];
+        locales: Record<string, LocaleInfo>;
+    };
+    translations: Record<string, Record<string, string>>;
+    updatedAt: string | null;
+}
+
+interface FormatValueOptions {
+    currency?: string;
+    dateStyle?: "full" | "long" | "medium" | "short";
+    timeStyle?: "full" | "long" | "medium" | "short";
+}
+declare function formatValue(value: string | number | Date, format: FormatMode, locale: string, options?: FormatValueOptions): string;
+
+/**
+ * FNV-1a 32-bit hash for generating stable message IDs from source text.
+ *
+ * Works identically in Node.js and browsers (no platform APIs).
+ * Used by the extractor (build time) and the React runtime (browser) — both
+ * always produce the same key for the same source text.
+ *
+ * Output: 7 base-36 chars (~2.2 billion values).
+ * Collision probability ≈ 0.002% for 10K strings (birthday problem).
+ * Add `context` to disambiguate identical strings with different meanings.
+ * Add `formality` ("formal" | "informal") to produce separate keys for
+ * register variants — "neutral", "auto", and undefined hash identically.
+ *
+ * Separators: \x04 (ASCII EOT) for context, \x05 (ASCII ENQ) for formality.
+ */
+declare function generateMessageHash(text: string, context?: string, formality?: string): string;
+
+/**
+ * Format an ICU MessageFormat string with the given values and locale.
+ * Returns the raw `text` unchanged if parsing or formatting throws — the
+ * caller always gets a string, never an exception.
+ */
+declare function formatICU(text: string, values: Record<string, any>, locale?: string): string;
+/**
+ * Rewrite any embedded `selectordinal` nodes in an ICU string using
+ * `ordinalForms` from the locale bundle, before passing the string to
+ * `formatICU`.
+ *
+ * Returns `icu` unchanged when:
+ * - the string contains no "selectordinal" substring (fast path — most strings)
+ * - parsing throws (safe fallback to whatever formatICU receives)
+ *
+ * @param icu - Translated ICU string (may contain garbage ordinal branches from provider)
+ * @param ordinalForms - Locale's ordinalForms from the compiled bundle
+ * @param values - Runtime interpolation values (needed for word-based rank lookup)
+ */
+declare function rewriteSelectordinalInICU(icu: string, ordinalForms: OrdinalForms, values: Record<string, any>): string;
+
+export { type FormatMode, type FormatValueOptions, type LocaleInfo, type LocalesMap, type OrdinalForms, type OrdinalSuffixes, type TOptions, type TranslationsMap, type VocoderTranslationData, formatICU, formatValue, generateMessageHash, getBestMatchingLocale, getCookie, rewriteSelectordinalInICU, setCookie };

package/dist/index.js

@@ -0,0 +1,357 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  formatICU: () => formatICU,
+  formatValue: () => formatValue,
+  generateMessageHash: () => generateMessageHash,
+  getBestMatchingLocale: () => getBestMatchingLocale,
+  getCookie: () => getCookie,
+  rewriteSelectordinalInICU: () => rewriteSelectordinalInICU,
+  setCookie: () => setCookie
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/cookies.ts
+function getCookie(name, cookieString) {
+  var _a;
+  const cookies = cookieString || (typeof document !== "undefined" ? document.cookie : "");
+  if (!cookies) {
+    return null;
+  }
+  const value = (_a = cookies.split("; ").find((row) => row.startsWith(`${name}=`))) == null ? void 0 : _a.split("=")[1];
+  return value ? decodeURIComponent(value) : null;
+}
+function setCookie(name, value, options = {}) {
+  if (typeof document === "undefined") {
+    return;
+  }
+  const {
+    maxAge = 365 * 24 * 60 * 60,
+    path = "/",
+    sameSite = "Lax",
+    secure = typeof window !== "undefined" && window.location.protocol === "https:"
+  } = options;
+  let cookieString = `${name}=${encodeURIComponent(value)}`;
+  if (maxAge) {
+    cookieString += `; Max-Age=${maxAge}`;
+  }
+  if (path) {
+    cookieString += `; Path=${path}`;
+  }
+  if (options.domain) {
+    cookieString += `; Domain=${options.domain}`;
+  }
+  if (sameSite) {
+    cookieString += `; SameSite=${sameSite}`;
+  }
+  if (secure) {
+    cookieString += "; Secure";
+  }
+  document.cookie = cookieString;
+}
+function getBestMatchingLocale(preferredLocale, supportedLocales, fallback) {
+  if (supportedLocales.includes(preferredLocale)) {
+    return preferredLocale;
+  }
+  const languageCode = preferredLocale.split("-")[0];
+  if (languageCode && supportedLocales.includes(languageCode)) {
+    return languageCode;
+  }
+  const similarLocale = supportedLocales.find(
+    (locale) => locale.startsWith(`${languageCode}-`)
+  );
+  if (similarLocale) {
+    return similarLocale;
+  }
+  return fallback;
+}
+
+// src/format-value.ts
+var nfCache = /* @__PURE__ */ new Map();
+var dtfCache = /* @__PURE__ */ new Map();
+function getNF(locale, options) {
+  var _a, _b, _c, _d;
+  const key = `${locale}:${(_a = options.style) != null ? _a : ""}:${(_b = options.currency) != null ? _b : ""}:${(_c = options.notation) != null ? _c : ""}:${(_d = options.maximumFractionDigits) != null ? _d : ""}`;
+  let fmt = nfCache.get(key);
+  if (!fmt) {
+    fmt = new Intl.NumberFormat(locale, options);
+    nfCache.set(key, fmt);
+  }
+  return fmt;
+}
+function getDTF(locale, options) {
+  var _a, _b;
+  const key = `${locale}:${(_a = options.dateStyle) != null ? _a : ""}:${(_b = options.timeStyle) != null ? _b : ""}`;
+  let fmt = dtfCache.get(key);
+  if (!fmt) {
+    fmt = new Intl.DateTimeFormat(locale, options);
+    dtfCache.set(key, fmt);
+  }
+  return fmt;
+}
+function formatValue(value, format, locale, options = {}) {
+  const { currency, dateStyle = "medium", timeStyle = "short" } = options;
+  const num = Number(value);
+  const date = value instanceof Date ? value : new Date(value);
+  switch (format) {
+    case "number":
+      return getNF(locale, {}).format(num);
+    case "integer":
+      return getNF(locale, { maximumFractionDigits: 0 }).format(num);
+    case "percent":
+      return getNF(locale, { style: "percent" }).format(num);
+    case "compact":
+      return getNF(locale, { notation: "compact" }).format(num);
+    case "currency": {
+      if (!currency) {
+        if (process.env.NODE_ENV === "development") {
+          console.warn('[vocoder] format="currency" requires a currency prop');
+        }
+        return String(value);
+      }
+      return getNF(locale, { style: "currency", currency }).format(num);
+    }
+    case "date":
+      return getDTF(locale, { dateStyle }).format(date);
+    case "time":
+      return getDTF(locale, { timeStyle }).format(date);
+    case "datetime":
+      return getDTF(locale, { dateStyle, timeStyle }).format(date);
+    default:
+      return String(value);
+  }
+}
+
+// src/hash.ts
+function generateMessageHash(text, context, formality) {
+  let input = context ? `${text}${context}` : text;
+  if (formality === "formal" || formality === "informal") {
+    input += `${formality}`;
+  }
+  let h = 2166136261 >>> 0;
+  for (let i = 0; i < input.length; i++) {
+    h = Math.imul(h ^ input.charCodeAt(i), 16777619) >>> 0;
+  }
+  return h.toString(36).padStart(7, "0");
+}
+
+// src/icu.ts
+var import_intl_messageformat = __toESM(require("intl-messageformat"));
+var import_icu_messageformat_parser = require("@formatjs/icu-messageformat-parser");
+var imfCache = /* @__PURE__ */ new Map();
+function getIMF(text, locale) {
+  const key = `${locale}:${text}`;
+  let msg = imfCache.get(key);
+  if (!msg) {
+    msg = new import_intl_messageformat.default(text, locale, void 0, { ignoreTag: true });
+    imfCache.set(key, msg);
+  }
+  return msg;
+}
+function formatICU(text, values, locale = "en") {
+  try {
+    const result = getIMF(text, locale.toLowerCase()).format(values);
+    return typeof result === "string" ? result : result.join("");
+  } catch (error) {
+    if (process.env.NODE_ENV !== "production") {
+      console.error(
+        `[vocoder] ICU formatting error for locale "${locale}":`,
+        error,
+        "\n  ICU:",
+        text,
+        "\n  values:",
+        values
+      );
+    }
+    return text;
+  }
+}
+var CLDR_ORDINAL_ORDER = [
+  "zero",
+  "one",
+  "two",
+  "few",
+  "many",
+  "other"
+];
+function printICU(elements) {
+  return elements.map(printElement).join("");
+}
+function printElement(el) {
+  var _a, _b, _c;
+  switch (el.type) {
+    case import_icu_messageformat_parser.TYPE.literal:
+      return el.value;
+    case import_icu_messageformat_parser.TYPE.argument:
+      return `{${el.value}}`;
+    case import_icu_messageformat_parser.TYPE.pound:
+      return "#";
+    case import_icu_messageformat_parser.TYPE.number: {
+      if (!el.style) return `{${el.value}, number}`;
+      const style = typeof el.style === "string" ? el.style : `::${(_a = el.style.parsedOptions) != null ? _a : ""}`;
+      return `{${el.value}, number, ${style}}`;
+    }
+    case import_icu_messageformat_parser.TYPE.date: {
+      if (!el.style) return `{${el.value}, date}`;
+      const style = typeof el.style === "string" ? el.style : `::${(_b = el.style.parsedOptions) != null ? _b : ""}`;
+      return `{${el.value}, date, ${style}}`;
+    }
+    case import_icu_messageformat_parser.TYPE.time: {
+      if (!el.style) return `{${el.value}, time}`;
+      const style = typeof el.style === "string" ? el.style : `::${(_c = el.style.parsedOptions) != null ? _c : ""}`;
+      return `{${el.value}, time, ${style}}`;
+    }
+    case import_icu_messageformat_parser.TYPE.select: {
+      const options = Object.entries(
+        el.options
+      ).map(([k, v]) => `${k} {${printICU(v.value)}}`).join(" ");
+      return `{${el.value}, select, ${options}}`;
+    }
+    case import_icu_messageformat_parser.TYPE.plural: {
+      const pluralEl = el;
+      const pluralType = pluralEl.pluralType === "ordinal" ? "selectordinal" : "plural";
+      const offset = pluralEl.offset !== 0 ? `offset:${pluralEl.offset} ` : "";
+      const options = Object.entries(pluralEl.options).map(([k, v]) => `${k} {${printICU(v.value)}}`).join(" ");
+      return `{${pluralEl.value}, ${pluralType}, ${offset}${options}}`;
+    }
+    case import_icu_messageformat_parser.TYPE.tag: {
+      const children = printICU(el.children);
+      return `<${el.value}>${children}</${el.value}>`;
+    }
+    default:
+      return "";
+  }
+}
+function rewriteElements(elements, forms, values) {
+  return elements.flatMap((el) => {
+    if ((0, import_icu_messageformat_parser.isPluralElement)(el) && el.pluralType === "ordinal") {
+      return [rewriteSelectordinalElement(el, forms, values)];
+    }
+    if ((0, import_icu_messageformat_parser.isSelectElement)(el)) {
+      const options = {};
+      for (const [key, opt] of Object.entries(
+        el.options
+      )) {
+        options[key] = { value: rewriteElements(opt.value, forms, values) };
+      }
+      return [__spreadProps(__spreadValues({}, el), { options })];
+    }
+    if ((0, import_icu_messageformat_parser.isPluralElement)(el)) {
+      const options = {};
+      for (const [key, opt] of Object.entries(el.options)) {
+        options[key] = { value: rewriteElements(opt.value, forms, values) };
+      }
+      return [__spreadProps(__spreadValues({}, el), { options })];
+    }
+    if ((0, import_icu_messageformat_parser.isTagElement)(el)) {
+      return [
+        __spreadProps(__spreadValues({}, el), {
+          children: rewriteElements(
+            el.children,
+            forms,
+            values
+          )
+        })
+      ];
+    }
+    return [el];
+  });
+}
+function rewriteSelectordinalElement(el, forms, values) {
+  var _a;
+  if (forms.type === "suffix") {
+    const newOptions = {};
+    for (const cat of CLDR_ORDINAL_ORDER) {
+      const pattern = forms.suffixes[cat];
+      if (pattern === void 0) continue;
+      const poundIdx = pattern.indexOf("#");
+      const parts = [];
+      if (poundIdx === -1) {
+        parts.push({ type: import_icu_messageformat_parser.TYPE.literal, value: pattern });
+      } else {
+        if (poundIdx > 0)
+          parts.push({
+            type: import_icu_messageformat_parser.TYPE.literal,
+            value: pattern.slice(0, poundIdx)
+          });
+        parts.push({ type: import_icu_messageformat_parser.TYPE.pound });
+        if (poundIdx < pattern.length - 1)
+          parts.push({
+            type: import_icu_messageformat_parser.TYPE.literal,
+            value: pattern.slice(poundIdx + 1)
+          });
+      }
+      newOptions[cat] = { value: parts };
+    }
+    return __spreadProps(__spreadValues({}, el), { options: newOptions });
+  }
+  if (forms.type === "word") {
+    const rank = values[el.value];
+    if (typeof rank === "number") {
+      const genderMap = (_a = forms.words["masculine"]) != null ? _a : Object.values(forms.words)[0];
+      const word = genderMap == null ? void 0 : genderMap[rank];
+      return {
+        type: import_icu_messageformat_parser.TYPE.literal,
+        value: word != null ? word : String(rank)
+      };
+    }
+  }
+  return el;
+}
+function rewriteSelectordinalInICU(icu, ordinalForms, values) {
+  if (!icu.includes("selectordinal")) return icu;
+  try {
+    const ast = (0, import_icu_messageformat_parser.parse)(icu, { captureLocation: false });
+    const rewritten = rewriteElements(ast, ordinalForms, values);
+    return printICU(rewritten);
+  } catch (e) {
+    return icu;
+  }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/cookies.ts","../src/format-value.ts","../src/hash.ts","../src/icu.ts"],"sourcesContent":["export { getCookie, getBestMatchingLocale, setCookie } from \"./cookies\";\nexport { formatValue } from \"./format-value\";\nexport type { FormatValueOptions } from \"./format-value\";\nexport { generateMessageHash } from \"./hash\";\nexport { formatICU, rewriteSelectordinalInICU } from \"./icu\";\nexport type {\n\tFormatMode,\n\tLocaleInfo,\n\tLocalesMap,\n\tOrdinalForms,\n\tOrdinalSuffixes,\n\tTOptions,\n\tTranslationsMap,\n\tVocoderTranslationData,\n} from \"./types\";\n","export function getCookie(name: string, cookieString?: string): string | null {\n\tconst cookies =\n\t\tcookieString || (typeof document !== \"undefined\" ? document.cookie : \"\");\n\n\tif (!cookies) {\n\t\treturn null;\n\t}\n\n\tconst value = cookies\n\t\t.split(\"; \")\n\t\t.find((row: string) => row.startsWith(`${name}=`))\n\t\t?.split(\"=\")[1];\n\n\treturn value ? decodeURIComponent(value) : null;\n}\n\nexport function setCookie(\n\tname: string,\n\tvalue: string,\n\toptions: {\n\t\tmaxAge?: number;\n\t\tpath?: string;\n\t\tdomain?: string;\n\t\tsameSite?: \"Strict\" | \"Lax\" | \"None\";\n\t\tsecure?: boolean;\n\t} = {},\n): void {\n\tif (typeof document === \"undefined\") {\n\t\treturn;\n\t}\n\n\tconst {\n\t\tmaxAge = 365 * 24 * 60 * 60,\n\t\tpath = \"/\",\n\t\tsameSite = \"Lax\",\n\t\tsecure = typeof window !== \"undefined\" &&\n\t\t\twindow.location.protocol === \"https:\",\n\t} = options;\n\n\tlet cookieString = `${name}=${encodeURIComponent(value)}`;\n\n\tif (maxAge) {\n\t\tcookieString += `; Max-Age=${maxAge}`;\n\t}\n\n\tif (path) {\n\t\tcookieString += `; Path=${path}`;\n\t}\n\n\tif (options.domain) {\n\t\tcookieString += `; Domain=${options.domain}`;\n\t}\n\n\tif (sameSite) {\n\t\tcookieString += `; SameSite=${sameSite}`;\n\t}\n\n\tif (secure) {\n\t\tcookieString += \"; Secure\";\n\t}\n\n\tdocument.cookie = cookieString;\n}\n\n/**\n * Find the best matching locale from available options.\n * Handles language codes and regional variants (e.g., 'en-US' -> 'en').\n */\nexport function getBestMatchingLocale(\n\tpreferredLocale: string,\n\tsupportedLocales: string[],\n\tfallback: string,\n): string {\n\tif (supportedLocales.includes(preferredLocale)) {\n\t\treturn preferredLocale;\n\t}\n\n\tconst languageCode = preferredLocale.split(\"-\")[0];\n\tif (languageCode && supportedLocales.includes(languageCode)) {\n\t\treturn languageCode;\n\t}\n\n\tconst similarLocale = supportedLocales.find((locale: string) =>\n\t\tlocale.startsWith(`${languageCode}-`),\n\t);\n\tif (similarLocale) {\n\t\treturn similarLocale;\n\t}\n\n\treturn fallback;\n}\n","import type { FormatMode } from \"./types\";\n\nexport interface FormatValueOptions {\n\tcurrency?: string;\n\tdateStyle?: \"full\" | \"long\" | \"medium\" | \"short\";\n\ttimeStyle?: \"full\" | \"long\" | \"medium\" | \"short\";\n}\n\nconst nfCache = new Map<string, Intl.NumberFormat>();\nconst dtfCache = new Map<string, Intl.DateTimeFormat>();\n\nfunction getNF(locale: string, options: Intl.NumberFormatOptions): Intl.NumberFormat {\n\tconst key = `${locale}:${options.style ?? \"\"}:${options.currency ?? \"\"}:${options.notation ?? \"\"}:${options.maximumFractionDigits ?? \"\"}`;\n\tlet fmt = nfCache.get(key);\n\tif (!fmt) {\n\t\tfmt = new Intl.NumberFormat(locale, options);\n\t\tnfCache.set(key, fmt);\n\t}\n\treturn fmt;\n}\n\nfunction getDTF(locale: string, options: Intl.DateTimeFormatOptions): Intl.DateTimeFormat {\n\tconst key = `${locale}:${options.dateStyle ?? \"\"}:${options.timeStyle ?? \"\"}`;\n\tlet fmt = dtfCache.get(key);\n\tif (!fmt) {\n\t\tfmt = new Intl.DateTimeFormat(locale, options);\n\t\tdtfCache.set(key, fmt);\n\t}\n\treturn fmt;\n}\n\nexport function formatValue(\n\tvalue: string | number | Date,\n\tformat: FormatMode,\n\tlocale: string,\n\toptions: FormatValueOptions = {},\n): string {\n\tconst { currency, dateStyle = \"medium\", timeStyle = \"short\" } = options;\n\tconst num = Number(value);\n\tconst date = value instanceof Date ? value : new Date(value as string | number);\n\n\tswitch (format) {\n\t\tcase \"number\":\n\t\t\treturn getNF(locale, {}).format(num);\n\t\tcase \"integer\":\n\t\t\treturn getNF(locale, { maximumFractionDigits: 0 }).format(num);\n\t\tcase \"percent\":\n\t\t\treturn getNF(locale, { style: \"percent\" }).format(num);\n\t\tcase \"compact\":\n\t\t\treturn getNF(locale, { notation: \"compact\" }).format(num);\n\t\tcase \"currency\": {\n\t\t\tif (!currency) {\n\t\t\t\tif (process.env.NODE_ENV === \"development\") {\n\t\t\t\t\tconsole.warn('[vocoder] format=\"currency\" requires a currency prop');\n\t\t\t\t}\n\t\t\t\treturn String(value);\n\t\t\t}\n\t\t\treturn getNF(locale, { style: \"currency\", currency }).format(num);\n\t\t}\n\t\tcase \"date\":\n\t\t\treturn getDTF(locale, { dateStyle }).format(date);\n\t\tcase \"time\":\n\t\t\treturn getDTF(locale, { timeStyle }).format(date);\n\t\tcase \"datetime\":\n\t\t\treturn getDTF(locale, { dateStyle, timeStyle }).format(date);\n\t\tdefault:\n\t\t\treturn String(value);\n\t}\n}\n","/**\n * FNV-1a 32-bit hash for generating stable message IDs from source text.\n *\n * Works identically in Node.js and browsers (no platform APIs).\n * Used by the extractor (build time) and the React runtime (browser) — both\n * always produce the same key for the same source text.\n *\n * Output: 7 base-36 chars (~2.2 billion values).\n * Collision probability ≈ 0.002% for 10K strings (birthday problem).\n * Add `context` to disambiguate identical strings with different meanings.\n * Add `formality` (\"formal\" | \"informal\") to produce separate keys for\n * register variants — \"neutral\", \"auto\", and undefined hash identically.\n *\n * Separators: \\x04 (ASCII EOT) for context, \\x05 (ASCII ENQ) for formality.\n */\nexport function generateMessageHash(\n\ttext: string,\n\tcontext?: string,\n\tformality?: string,\n): string {\n\tlet input = context ? `${text}\\x04${context}` : text;\n\tif (formality === \"formal\" || formality === \"informal\") {\n\t\tinput += `\\x05${formality}`;\n\t}\n\tlet h = 2166136261 >>> 0;\n\tfor (let i = 0; i < input.length; i++) {\n\t\th = Math.imul(h ^ input.charCodeAt(i), 16777619) >>> 0;\n\t}\n\treturn h.toString(36).padStart(7, \"0\");\n}\n","import IntlMessageFormat from \"intl-messageformat\";\nimport {\n\tisPluralElement,\n\tisSelectElement,\n\tisTagElement,\n\tparse,\n\tTYPE,\n} from \"@formatjs/icu-messageformat-parser\";\nimport type {\n\tLiteralElement,\n\tMessageFormatElement,\n\tPluralElement,\n} from \"@formatjs/icu-messageformat-parser\";\nimport type { OrdinalForms } from \"./types\";\n\n// ---------------------------------------------------------------------------\n// IntlMessageFormat cache — keyed by \"locale:text\"\n// ---------------------------------------------------------------------------\n\nconst imfCache = new Map<string, IntlMessageFormat>();\n\nfunction getIMF(text: string, locale: string): IntlMessageFormat {\n\tconst key = `${locale}:${text}`;\n\tlet msg = imfCache.get(key);\n\tif (!msg) {\n\t\t// ignoreTag: true — component placeholders (<c0>, <c1>) are handled\n\t\t// by formatElements, not by IMF. IMF handles only ICU primitives.\n\t\tmsg = new IntlMessageFormat(text, locale, undefined, { ignoreTag: true });\n\t\timfCache.set(key, msg);\n\t}\n\treturn msg;\n}\n\n/**\n * Format an ICU MessageFormat string with the given values and locale.\n * Returns the raw `text` unchanged if parsing or formatting throws — the\n * caller always gets a string, never an exception.\n */\nexport function formatICU(\n\ttext: string,\n\tvalues: Record<string, any>,\n\tlocale: string = \"en\",\n): string {\n\ttry {\n\t\tconst result = getIMF(text, locale.toLowerCase()).format(values);\n\t\treturn typeof result === \"string\" ? result : (result as unknown[]).join(\"\");\n\t} catch (error) {\n\t\tif (process.env.NODE_ENV !== \"production\") {\n\t\t\tconsole.error(\n\t\t\t\t`[vocoder] ICU formatting error for locale \"${locale}\":`,\n\t\t\t\terror,\n\t\t\t\t\"\\n  ICU:\", text,\n\t\t\t\t\"\\n  values:\", values,\n\t\t\t);\n\t\t}\n\t\treturn text;\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Embedded selectordinal rewriting — Bug 1 fix\n//\n// The translation pipeline's ordinal DB fast path (tryBuildOrdinalFromDB)\n// only applies when a selectordinal is the SOLE top-level element in the\n// ICU string. When it appears embedded inside a larger sentence (e.g.\n// \"Congrats! your {year, selectordinal, ...} anniversary!\"), the pipeline\n// falls through to the translation provider, which stores garbage branches\n// (e.g. \"1el\", \"1th\", \"1الـ\") in the DB.\n//\n// This function fixes the stored translation at render time by rewriting\n// any selectordinal nodes using the locale's ordinalForms data.\n// ---------------------------------------------------------------------------\n\nconst CLDR_ORDINAL_ORDER = [\n\t\"zero\",\n\t\"one\",\n\t\"two\",\n\t\"few\",\n\t\"many\",\n\t\"other\",\n] as const;\n\nfunction printICU(elements: MessageFormatElement[]): string {\n\treturn elements.map(printElement).join(\"\");\n}\n\nfunction printElement(el: MessageFormatElement): string {\n\tswitch (el.type) {\n\t\tcase TYPE.literal:\n\t\t\treturn (el as LiteralElement).value;\n\t\tcase TYPE.argument:\n\t\t\treturn `{${el.value}}`;\n\t\tcase TYPE.pound:\n\t\t\treturn \"#\";\n\t\tcase TYPE.number: {\n\t\t\tif (!el.style) return `{${el.value}, number}`;\n\t\t\tconst style =\n\t\t\t\ttypeof el.style === \"string\"\n\t\t\t\t\t? el.style\n\t\t\t\t\t: `::${(el.style as Record<string, any>).parsedOptions ?? \"\"}`;\n\t\t\treturn `{${el.value}, number, ${style}}`;\n\t\t}\n\t\tcase TYPE.date: {\n\t\t\tif (!el.style) return `{${el.value}, date}`;\n\t\t\tconst style =\n\t\t\t\ttypeof el.style === \"string\"\n\t\t\t\t\t? el.style\n\t\t\t\t\t: `::${(el.style as Record<string, any>).parsedOptions ?? \"\"}`;\n\t\t\treturn `{${el.value}, date, ${style}}`;\n\t\t}\n\t\tcase TYPE.time: {\n\t\t\tif (!el.style) return `{${el.value}, time}`;\n\t\t\tconst style =\n\t\t\t\ttypeof el.style === \"string\"\n\t\t\t\t\t? el.style\n\t\t\t\t\t: `::${(el.style as Record<string, any>).parsedOptions ?? \"\"}`;\n\t\t\treturn `{${el.value}, time, ${style}}`;\n\t\t}\n\t\tcase TYPE.select: {\n\t\t\tconst options = Object.entries(\n\t\t\t\t(el as Record<string, any>).options as Record<\n\t\t\t\t\tstring,\n\t\t\t\t\t{ value: MessageFormatElement[] }\n\t\t\t\t>,\n\t\t\t)\n\t\t\t\t.map(([k, v]) => `${k} {${printICU(v.value)}}`)\n\t\t\t\t.join(\" \");\n\t\t\treturn `{${el.value}, select, ${options}}`;\n\t\t}\n\t\tcase TYPE.plural: {\n\t\t\tconst pluralEl = el as PluralElement;\n\t\t\tconst pluralType =\n\t\t\t\tpluralEl.pluralType === \"ordinal\" ? \"selectordinal\" : \"plural\";\n\t\t\tconst offset =\n\t\t\t\tpluralEl.offset !== 0 ? `offset:${pluralEl.offset} ` : \"\";\n\t\t\tconst options = Object.entries(pluralEl.options)\n\t\t\t\t.map(([k, v]) => `${k} {${printICU(v.value)}}`)\n\t\t\t\t.join(\" \");\n\t\t\treturn `{${pluralEl.value}, ${pluralType}, ${offset}${options}}`;\n\t\t}\n\t\tcase TYPE.tag: {\n\t\t\tconst children = printICU((el as Record<string, any>).children as MessageFormatElement[]);\n\t\t\treturn `<${el.value}>${children}</${el.value}>`;\n\t\t}\n\t\tdefault:\n\t\t\treturn \"\";\n\t}\n}\n\nfunction rewriteElements(\n\telements: MessageFormatElement[],\n\tforms: OrdinalForms,\n\tvalues: Record<string, any>,\n): MessageFormatElement[] {\n\treturn elements.flatMap((el) => {\n\t\tif (isPluralElement(el) && el.pluralType === \"ordinal\") {\n\t\t\treturn [rewriteSelectordinalElement(el, forms, values)];\n\t\t}\n\t\tif (isSelectElement(el)) {\n\t\t\tconst options: Record<string, { value: MessageFormatElement[] }> = {};\n\t\t\tfor (const [key, opt] of Object.entries(\n\t\t\t\tel.options as Record<string, { value: MessageFormatElement[] }>,\n\t\t\t)) {\n\t\t\t\toptions[key] = { value: rewriteElements(opt.value, forms, values) };\n\t\t\t}\n\t\t\treturn [{ ...el, options } as MessageFormatElement];\n\t\t}\n\t\tif (isPluralElement(el)) {\n\t\t\tconst options: Record<string, { value: MessageFormatElement[] }> = {};\n\t\t\tfor (const [key, opt] of Object.entries(el.options)) {\n\t\t\t\toptions[key] = { value: rewriteElements(opt.value, forms, values) };\n\t\t\t}\n\t\t\treturn [{ ...el, options } as MessageFormatElement];\n\t\t}\n\t\tif (isTagElement(el)) {\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\t...el,\n\t\t\t\t\tchildren: rewriteElements(\n\t\t\t\t\t\t(el as Record<string, any>).children as MessageFormatElement[],\n\t\t\t\t\t\tforms,\n\t\t\t\t\t\tvalues,\n\t\t\t\t\t),\n\t\t\t\t} as MessageFormatElement,\n\t\t\t];\n\t\t}\n\t\treturn [el];\n\t});\n}\n\nfunction rewriteSelectordinalElement(\n\tel: PluralElement,\n\tforms: OrdinalForms,\n\tvalues: Record<string, any>,\n): MessageFormatElement {\n\tif (forms.type === \"suffix\") {\n\t\tconst newOptions: Record<string, { value: MessageFormatElement[] }> = {};\n\t\tfor (const cat of CLDR_ORDINAL_ORDER) {\n\t\t\tconst pattern = forms.suffixes[cat];\n\t\t\tif (pattern === undefined) continue;\n\t\t\tconst poundIdx = pattern.indexOf(\"#\");\n\t\t\tconst parts: MessageFormatElement[] = [];\n\t\t\tif (poundIdx === -1) {\n\t\t\t\tparts.push({ type: TYPE.literal, value: pattern } as LiteralElement);\n\t\t\t} else {\n\t\t\t\tif (poundIdx > 0)\n\t\t\t\t\tparts.push({\n\t\t\t\t\t\ttype: TYPE.literal,\n\t\t\t\t\t\tvalue: pattern.slice(0, poundIdx),\n\t\t\t\t\t} as LiteralElement);\n\t\t\t\tparts.push({ type: TYPE.pound });\n\t\t\t\tif (poundIdx < pattern.length - 1)\n\t\t\t\t\tparts.push({\n\t\t\t\t\t\ttype: TYPE.literal,\n\t\t\t\t\t\tvalue: pattern.slice(poundIdx + 1),\n\t\t\t\t\t} as LiteralElement);\n\t\t\t}\n\t\t\tnewOptions[cat] = { value: parts };\n\t\t}\n\t\treturn { ...el, options: newOptions };\n\t}\n\n\tif (forms.type === \"word\") {\n\t\tconst rank = values[el.value];\n\t\tif (typeof rank === \"number\") {\n\t\t\tconst genderMap =\n\t\t\t\tforms.words[\"masculine\"] ?? Object.values(forms.words)[0];\n\t\t\tconst word = genderMap?.[rank];\n\t\t\treturn {\n\t\t\t\ttype: TYPE.literal,\n\t\t\t\tvalue: word ?? String(rank),\n\t\t\t} as LiteralElement;\n\t\t}\n\t}\n\n\treturn el;\n}\n\n/**\n * Rewrite any embedded `selectordinal` nodes in an ICU string using\n * `ordinalForms` from the locale bundle, before passing the string to\n * `formatICU`.\n *\n * Returns `icu` unchanged when:\n * - the string contains no \"selectordinal\" substring (fast path — most strings)\n * - parsing throws (safe fallback to whatever formatICU receives)\n *\n * @param icu - Translated ICU string (may contain garbage ordinal branches from provider)\n * @param ordinalForms - Locale's ordinalForms from the compiled bundle\n * @param values - Runtime interpolation values (needed for word-based rank lookup)\n */\nexport function rewriteSelectordinalInICU(\n\ticu: string,\n\tordinalForms: OrdinalForms,\n\tvalues: Record<string, any>,\n): string {\n\tif (!icu.includes(\"selectordinal\")) return icu;\n\n\ttry {\n\t\tconst ast = parse(icu, { captureLocation: false });\n\t\tconst rewritten = rewriteElements(ast, ordinalForms, values);\n\t\treturn printICU(rewritten);\n\t} catch {\n\t\treturn icu;\n\t}\n}\n"],"mappings":"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","names":["IntlMessageFormat"]}

package/dist/index.mjs

@@ -0,0 +1,333 @@
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+
+// src/cookies.ts
+function getCookie(name, cookieString) {
+  var _a;
+  const cookies = cookieString || (typeof document !== "undefined" ? document.cookie : "");
+  if (!cookies) {
+    return null;
+  }
+  const value = (_a = cookies.split("; ").find((row) => row.startsWith(`${name}=`))) == null ? void 0 : _a.split("=")[1];
+  return value ? decodeURIComponent(value) : null;
+}
+function setCookie(name, value, options = {}) {
+  if (typeof document === "undefined") {
+    return;
+  }
+  const {
+    maxAge = 365 * 24 * 60 * 60,
+    path = "/",
+    sameSite = "Lax",
+    secure = typeof window !== "undefined" && window.location.protocol === "https:"
+  } = options;
+  let cookieString = `${name}=${encodeURIComponent(value)}`;
+  if (maxAge) {
+    cookieString += `; Max-Age=${maxAge}`;
+  }
+  if (path) {
+    cookieString += `; Path=${path}`;
+  }
+  if (options.domain) {
+    cookieString += `; Domain=${options.domain}`;
+  }
+  if (sameSite) {
+    cookieString += `; SameSite=${sameSite}`;
+  }
+  if (secure) {
+    cookieString += "; Secure";
+  }
+  document.cookie = cookieString;
+}
+function getBestMatchingLocale(preferredLocale, supportedLocales, fallback) {
+  if (supportedLocales.includes(preferredLocale)) {
+    return preferredLocale;
+  }
+  const languageCode = preferredLocale.split("-")[0];
+  if (languageCode && supportedLocales.includes(languageCode)) {
+    return languageCode;
+  }
+  const similarLocale = supportedLocales.find(
+    (locale) => locale.startsWith(`${languageCode}-`)
+  );
+  if (similarLocale) {
+    return similarLocale;
+  }
+  return fallback;
+}
+
+// src/format-value.ts
+var nfCache = /* @__PURE__ */ new Map();
+var dtfCache = /* @__PURE__ */ new Map();
+function getNF(locale, options) {
+  var _a, _b, _c, _d;
+  const key = `${locale}:${(_a = options.style) != null ? _a : ""}:${(_b = options.currency) != null ? _b : ""}:${(_c = options.notation) != null ? _c : ""}:${(_d = options.maximumFractionDigits) != null ? _d : ""}`;
+  let fmt = nfCache.get(key);
+  if (!fmt) {
+    fmt = new Intl.NumberFormat(locale, options);
+    nfCache.set(key, fmt);
+  }
+  return fmt;
+}
+function getDTF(locale, options) {
+  var _a, _b;
+  const key = `${locale}:${(_a = options.dateStyle) != null ? _a : ""}:${(_b = options.timeStyle) != null ? _b : ""}`;
+  let fmt = dtfCache.get(key);
+  if (!fmt) {
+    fmt = new Intl.DateTimeFormat(locale, options);
+    dtfCache.set(key, fmt);
+  }
+  return fmt;
+}
+function formatValue(value, format, locale, options = {}) {
+  const { currency, dateStyle = "medium", timeStyle = "short" } = options;
+  const num = Number(value);
+  const date = value instanceof Date ? value : new Date(value);
+  switch (format) {
+    case "number":
+      return getNF(locale, {}).format(num);
+    case "integer":
+      return getNF(locale, { maximumFractionDigits: 0 }).format(num);
+    case "percent":
+      return getNF(locale, { style: "percent" }).format(num);
+    case "compact":
+      return getNF(locale, { notation: "compact" }).format(num);
+    case "currency": {
+      if (!currency) {
+        if (process.env.NODE_ENV === "development") {
+          console.warn('[vocoder] format="currency" requires a currency prop');
+        }
+        return String(value);
+      }
+      return getNF(locale, { style: "currency", currency }).format(num);
+    }
+    case "date":
+      return getDTF(locale, { dateStyle }).format(date);
+    case "time":
+      return getDTF(locale, { timeStyle }).format(date);
+    case "datetime":
+      return getDTF(locale, { dateStyle, timeStyle }).format(date);
+    default:
+      return String(value);
+  }
+}
+
+// src/hash.ts
+function generateMessageHash(text, context, formality) {
+  let input = context ? `${text}${context}` : text;
+  if (formality === "formal" || formality === "informal") {
+    input += `${formality}`;
+  }
+  let h = 2166136261 >>> 0;
+  for (let i = 0; i < input.length; i++) {
+    h = Math.imul(h ^ input.charCodeAt(i), 16777619) >>> 0;
+  }
+  return h.toString(36).padStart(7, "0");
+}
+
+// src/icu.ts
+import IntlMessageFormat from "intl-messageformat";
+import {
+  isPluralElement,
+  isSelectElement,
+  isTagElement,
+  parse,
+  TYPE
+} from "@formatjs/icu-messageformat-parser";
+var imfCache = /* @__PURE__ */ new Map();
+function getIMF(text, locale) {
+  const key = `${locale}:${text}`;
+  let msg = imfCache.get(key);
+  if (!msg) {
+    msg = new IntlMessageFormat(text, locale, void 0, { ignoreTag: true });
+    imfCache.set(key, msg);
+  }
+  return msg;
+}
+function formatICU(text, values, locale = "en") {
+  try {
+    const result = getIMF(text, locale.toLowerCase()).format(values);
+    return typeof result === "string" ? result : result.join("");
+  } catch (error) {
+    if (process.env.NODE_ENV !== "production") {
+      console.error(
+        `[vocoder] ICU formatting error for locale "${locale}":`,
+        error,
+        "\n  ICU:",
+        text,
+        "\n  values:",
+        values
+      );
+    }
+    return text;
+  }
+}
+var CLDR_ORDINAL_ORDER = [
+  "zero",
+  "one",
+  "two",
+  "few",
+  "many",
+  "other"
+];
+function printICU(elements) {
+  return elements.map(printElement).join("");
+}
+function printElement(el) {
+  var _a, _b, _c;
+  switch (el.type) {
+    case TYPE.literal:
+      return el.value;
+    case TYPE.argument:
+      return `{${el.value}}`;
+    case TYPE.pound:
+      return "#";
+    case TYPE.number: {
+      if (!el.style) return `{${el.value}, number}`;
+      const style = typeof el.style === "string" ? el.style : `::${(_a = el.style.parsedOptions) != null ? _a : ""}`;
+      return `{${el.value}, number, ${style}}`;
+    }
+    case TYPE.date: {
+      if (!el.style) return `{${el.value}, date}`;
+      const style = typeof el.style === "string" ? el.style : `::${(_b = el.style.parsedOptions) != null ? _b : ""}`;
+      return `{${el.value}, date, ${style}}`;
+    }
+    case TYPE.time: {
+      if (!el.style) return `{${el.value}, time}`;
+      const style = typeof el.style === "string" ? el.style : `::${(_c = el.style.parsedOptions) != null ? _c : ""}`;
+      return `{${el.value}, time, ${style}}`;
+    }
+    case TYPE.select: {
+      const options = Object.entries(
+        el.options
+      ).map(([k, v]) => `${k} {${printICU(v.value)}}`).join(" ");
+      return `{${el.value}, select, ${options}}`;
+    }
+    case TYPE.plural: {
+      const pluralEl = el;
+      const pluralType = pluralEl.pluralType === "ordinal" ? "selectordinal" : "plural";
+      const offset = pluralEl.offset !== 0 ? `offset:${pluralEl.offset} ` : "";
+      const options = Object.entries(pluralEl.options).map(([k, v]) => `${k} {${printICU(v.value)}}`).join(" ");
+      return `{${pluralEl.value}, ${pluralType}, ${offset}${options}}`;
+    }
+    case TYPE.tag: {
+      const children = printICU(el.children);
+      return `<${el.value}>${children}</${el.value}>`;
+    }
+    default:
+      return "";
+  }
+}
+function rewriteElements(elements, forms, values) {
+  return elements.flatMap((el) => {
+    if (isPluralElement(el) && el.pluralType === "ordinal") {
+      return [rewriteSelectordinalElement(el, forms, values)];
+    }
+    if (isSelectElement(el)) {
+      const options = {};
+      for (const [key, opt] of Object.entries(
+        el.options
+      )) {
+        options[key] = { value: rewriteElements(opt.value, forms, values) };
+      }
+      return [__spreadProps(__spreadValues({}, el), { options })];
+    }
+    if (isPluralElement(el)) {
+      const options = {};
+      for (const [key, opt] of Object.entries(el.options)) {
+        options[key] = { value: rewriteElements(opt.value, forms, values) };
+      }
+      return [__spreadProps(__spreadValues({}, el), { options })];
+    }
+    if (isTagElement(el)) {
+      return [
+        __spreadProps(__spreadValues({}, el), {
+          children: rewriteElements(
+            el.children,
+            forms,
+            values
+          )
+        })
+      ];
+    }
+    return [el];
+  });
+}
+function rewriteSelectordinalElement(el, forms, values) {
+  var _a;
+  if (forms.type === "suffix") {
+    const newOptions = {};
+    for (const cat of CLDR_ORDINAL_ORDER) {
+      const pattern = forms.suffixes[cat];
+      if (pattern === void 0) continue;
+      const poundIdx = pattern.indexOf("#");
+      const parts = [];
+      if (poundIdx === -1) {
+        parts.push({ type: TYPE.literal, value: pattern });
+      } else {
+        if (poundIdx > 0)
+          parts.push({
+            type: TYPE.literal,
+            value: pattern.slice(0, poundIdx)
+          });
+        parts.push({ type: TYPE.pound });
+        if (poundIdx < pattern.length - 1)
+          parts.push({
+            type: TYPE.literal,
+            value: pattern.slice(poundIdx + 1)
+          });
+      }
+      newOptions[cat] = { value: parts };
+    }
+    return __spreadProps(__spreadValues({}, el), { options: newOptions });
+  }
+  if (forms.type === "word") {
+    const rank = values[el.value];
+    if (typeof rank === "number") {
+      const genderMap = (_a = forms.words["masculine"]) != null ? _a : Object.values(forms.words)[0];
+      const word = genderMap == null ? void 0 : genderMap[rank];
+      return {
+        type: TYPE.literal,
+        value: word != null ? word : String(rank)
+      };
+    }
+  }
+  return el;
+}
+function rewriteSelectordinalInICU(icu, ordinalForms, values) {
+  if (!icu.includes("selectordinal")) return icu;
+  try {
+    const ast = parse(icu, { captureLocation: false });
+    const rewritten = rewriteElements(ast, ordinalForms, values);
+    return printICU(rewritten);
+  } catch (e) {
+    return icu;
+  }
+}
+export {
+  formatICU,
+  formatValue,
+  generateMessageHash,
+  getBestMatchingLocale,
+  getCookie,
+  rewriteSelectordinalInICU,
+  setCookie
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cookies.ts","../src/format-value.ts","../src/hash.ts","../src/icu.ts"],"sourcesContent":["export function getCookie(name: string, cookieString?: string): string | null {\n\tconst cookies =\n\t\tcookieString || (typeof document !== \"undefined\" ? document.cookie : \"\");\n\n\tif (!cookies) {\n\t\treturn null;\n\t}\n\n\tconst value = cookies\n\t\t.split(\"; \")\n\t\t.find((row: string) => row.startsWith(`${name}=`))\n\t\t?.split(\"=\")[1];\n\n\treturn value ? decodeURIComponent(value) : null;\n}\n\nexport function setCookie(\n\tname: string,\n\tvalue: string,\n\toptions: {\n\t\tmaxAge?: number;\n\t\tpath?: string;\n\t\tdomain?: string;\n\t\tsameSite?: \"Strict\" | \"Lax\" | \"None\";\n\t\tsecure?: boolean;\n\t} = {},\n): void {\n\tif (typeof document === \"undefined\") {\n\t\treturn;\n\t}\n\n\tconst {\n\t\tmaxAge = 365 * 24 * 60 * 60,\n\t\tpath = \"/\",\n\t\tsameSite = \"Lax\",\n\t\tsecure = typeof window !== \"undefined\" &&\n\t\t\twindow.location.protocol === \"https:\",\n\t} = options;\n\n\tlet cookieString = `${name}=${encodeURIComponent(value)}`;\n\n\tif (maxAge) {\n\t\tcookieString += `; Max-Age=${maxAge}`;\n\t}\n\n\tif (path) {\n\t\tcookieString += `; Path=${path}`;\n\t}\n\n\tif (options.domain) {\n\t\tcookieString += `; Domain=${options.domain}`;\n\t}\n\n\tif (sameSite) {\n\t\tcookieString += `; SameSite=${sameSite}`;\n\t}\n\n\tif (secure) {\n\t\tcookieString += \"; Secure\";\n\t}\n\n\tdocument.cookie = cookieString;\n}\n\n/**\n * Find the best matching locale from available options.\n * Handles language codes and regional variants (e.g., 'en-US' -> 'en').\n */\nexport function getBestMatchingLocale(\n\tpreferredLocale: string,\n\tsupportedLocales: string[],\n\tfallback: string,\n): string {\n\tif (supportedLocales.includes(preferredLocale)) {\n\t\treturn preferredLocale;\n\t}\n\n\tconst languageCode = preferredLocale.split(\"-\")[0];\n\tif (languageCode && supportedLocales.includes(languageCode)) {\n\t\treturn languageCode;\n\t}\n\n\tconst similarLocale = supportedLocales.find((locale: string) =>\n\t\tlocale.startsWith(`${languageCode}-`),\n\t);\n\tif (similarLocale) {\n\t\treturn similarLocale;\n\t}\n\n\treturn fallback;\n}\n","import type { FormatMode } from \"./types\";\n\nexport interface FormatValueOptions {\n\tcurrency?: string;\n\tdateStyle?: \"full\" | \"long\" | \"medium\" | \"short\";\n\ttimeStyle?: \"full\" | \"long\" | \"medium\" | \"short\";\n}\n\nconst nfCache = new Map<string, Intl.NumberFormat>();\nconst dtfCache = new Map<string, Intl.DateTimeFormat>();\n\nfunction getNF(locale: string, options: Intl.NumberFormatOptions): Intl.NumberFormat {\n\tconst key = `${locale}:${options.style ?? \"\"}:${options.currency ?? \"\"}:${options.notation ?? \"\"}:${options.maximumFractionDigits ?? \"\"}`;\n\tlet fmt = nfCache.get(key);\n\tif (!fmt) {\n\t\tfmt = new Intl.NumberFormat(locale, options);\n\t\tnfCache.set(key, fmt);\n\t}\n\treturn fmt;\n}\n\nfunction getDTF(locale: string, options: Intl.DateTimeFormatOptions): Intl.DateTimeFormat {\n\tconst key = `${locale}:${options.dateStyle ?? \"\"}:${options.timeStyle ?? \"\"}`;\n\tlet fmt = dtfCache.get(key);\n\tif (!fmt) {\n\t\tfmt = new Intl.DateTimeFormat(locale, options);\n\t\tdtfCache.set(key, fmt);\n\t}\n\treturn fmt;\n}\n\nexport function formatValue(\n\tvalue: string | number | Date,\n\tformat: FormatMode,\n\tlocale: string,\n\toptions: FormatValueOptions = {},\n): string {\n\tconst { currency, dateStyle = \"medium\", timeStyle = \"short\" } = options;\n\tconst num = Number(value);\n\tconst date = value instanceof Date ? value : new Date(value as string | number);\n\n\tswitch (format) {\n\t\tcase \"number\":\n\t\t\treturn getNF(locale, {}).format(num);\n\t\tcase \"integer\":\n\t\t\treturn getNF(locale, { maximumFractionDigits: 0 }).format(num);\n\t\tcase \"percent\":\n\t\t\treturn getNF(locale, { style: \"percent\" }).format(num);\n\t\tcase \"compact\":\n\t\t\treturn getNF(locale, { notation: \"compact\" }).format(num);\n\t\tcase \"currency\": {\n\t\t\tif (!currency) {\n\t\t\t\tif (process.env.NODE_ENV === \"development\") {\n\t\t\t\t\tconsole.warn('[vocoder] format=\"currency\" requires a currency prop');\n\t\t\t\t}\n\t\t\t\treturn String(value);\n\t\t\t}\n\t\t\treturn getNF(locale, { style: \"currency\", currency }).format(num);\n\t\t}\n\t\tcase \"date\":\n\t\t\treturn getDTF(locale, { dateStyle }).format(date);\n\t\tcase \"time\":\n\t\t\treturn getDTF(locale, { timeStyle }).format(date);\n\t\tcase \"datetime\":\n\t\t\treturn getDTF(locale, { dateStyle, timeStyle }).format(date);\n\t\tdefault:\n\t\t\treturn String(value);\n\t}\n}\n","/**\n * FNV-1a 32-bit hash for generating stable message IDs from source text.\n *\n * Works identically in Node.js and browsers (no platform APIs).\n * Used by the extractor (build time) and the React runtime (browser) — both\n * always produce the same key for the same source text.\n *\n * Output: 7 base-36 chars (~2.2 billion values).\n * Collision probability ≈ 0.002% for 10K strings (birthday problem).\n * Add `context` to disambiguate identical strings with different meanings.\n * Add `formality` (\"formal\" | \"informal\") to produce separate keys for\n * register variants — \"neutral\", \"auto\", and undefined hash identically.\n *\n * Separators: \\x04 (ASCII EOT) for context, \\x05 (ASCII ENQ) for formality.\n */\nexport function generateMessageHash(\n\ttext: string,\n\tcontext?: string,\n\tformality?: string,\n): string {\n\tlet input = context ? `${text}\\x04${context}` : text;\n\tif (formality === \"formal\" || formality === \"informal\") {\n\t\tinput += `\\x05${formality}`;\n\t}\n\tlet h = 2166136261 >>> 0;\n\tfor (let i = 0; i < input.length; i++) {\n\t\th = Math.imul(h ^ input.charCodeAt(i), 16777619) >>> 0;\n\t}\n\treturn h.toString(36).padStart(7, \"0\");\n}\n","import IntlMessageFormat from \"intl-messageformat\";\nimport {\n\tisPluralElement,\n\tisSelectElement,\n\tisTagElement,\n\tparse,\n\tTYPE,\n} from \"@formatjs/icu-messageformat-parser\";\nimport type {\n\tLiteralElement,\n\tMessageFormatElement,\n\tPluralElement,\n} from \"@formatjs/icu-messageformat-parser\";\nimport type { OrdinalForms } from \"./types\";\n\n// ---------------------------------------------------------------------------\n// IntlMessageFormat cache — keyed by \"locale:text\"\n// ---------------------------------------------------------------------------\n\nconst imfCache = new Map<string, IntlMessageFormat>();\n\nfunction getIMF(text: string, locale: string): IntlMessageFormat {\n\tconst key = `${locale}:${text}`;\n\tlet msg = imfCache.get(key);\n\tif (!msg) {\n\t\t// ignoreTag: true — component placeholders (<c0>, <c1>) are handled\n\t\t// by formatElements, not by IMF. IMF handles only ICU primitives.\n\t\tmsg = new IntlMessageFormat(text, locale, undefined, { ignoreTag: true });\n\t\timfCache.set(key, msg);\n\t}\n\treturn msg;\n}\n\n/**\n * Format an ICU MessageFormat string with the given values and locale.\n * Returns the raw `text` unchanged if parsing or formatting throws — the\n * caller always gets a string, never an exception.\n */\nexport function formatICU(\n\ttext: string,\n\tvalues: Record<string, any>,\n\tlocale: string = \"en\",\n): string {\n\ttry {\n\t\tconst result = getIMF(text, locale.toLowerCase()).format(values);\n\t\treturn typeof result === \"string\" ? result : (result as unknown[]).join(\"\");\n\t} catch (error) {\n\t\tif (process.env.NODE_ENV !== \"production\") {\n\t\t\tconsole.error(\n\t\t\t\t`[vocoder] ICU formatting error for locale \"${locale}\":`,\n\t\t\t\terror,\n\t\t\t\t\"\\n  ICU:\", text,\n\t\t\t\t\"\\n  values:\", values,\n\t\t\t);\n\t\t}\n\t\treturn text;\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Embedded selectordinal rewriting — Bug 1 fix\n//\n// The translation pipeline's ordinal DB fast path (tryBuildOrdinalFromDB)\n// only applies when a selectordinal is the SOLE top-level element in the\n// ICU string. When it appears embedded inside a larger sentence (e.g.\n// \"Congrats! your {year, selectordinal, ...} anniversary!\"), the pipeline\n// falls through to the translation provider, which stores garbage branches\n// (e.g. \"1el\", \"1th\", \"1الـ\") in the DB.\n//\n// This function fixes the stored translation at render time by rewriting\n// any selectordinal nodes using the locale's ordinalForms data.\n// ---------------------------------------------------------------------------\n\nconst CLDR_ORDINAL_ORDER = [\n\t\"zero\",\n\t\"one\",\n\t\"two\",\n\t\"few\",\n\t\"many\",\n\t\"other\",\n] as const;\n\nfunction printICU(elements: MessageFormatElement[]): string {\n\treturn elements.map(printElement).join(\"\");\n}\n\nfunction printElement(el: MessageFormatElement): string {\n\tswitch (el.type) {\n\t\tcase TYPE.literal:\n\t\t\treturn (el as LiteralElement).value;\n\t\tcase TYPE.argument:\n\t\t\treturn `{${el.value}}`;\n\t\tcase TYPE.pound:\n\t\t\treturn \"#\";\n\t\tcase TYPE.number: {\n\t\t\tif (!el.style) return `{${el.value}, number}`;\n\t\t\tconst style =\n\t\t\t\ttypeof el.style === \"string\"\n\t\t\t\t\t? el.style\n\t\t\t\t\t: `::${(el.style as Record<string, any>).parsedOptions ?? \"\"}`;\n\t\t\treturn `{${el.value}, number, ${style}}`;\n\t\t}\n\t\tcase TYPE.date: {\n\t\t\tif (!el.style) return `{${el.value}, date}`;\n\t\t\tconst style =\n\t\t\t\ttypeof el.style === \"string\"\n\t\t\t\t\t? el.style\n\t\t\t\t\t: `::${(el.style as Record<string, any>).parsedOptions ?? \"\"}`;\n\t\t\treturn `{${el.value}, date, ${style}}`;\n\t\t}\n\t\tcase TYPE.time: {\n\t\t\tif (!el.style) return `{${el.value}, time}`;\n\t\t\tconst style =\n\t\t\t\ttypeof el.style === \"string\"\n\t\t\t\t\t? el.style\n\t\t\t\t\t: `::${(el.style as Record<string, any>).parsedOptions ?? \"\"}`;\n\t\t\treturn `{${el.value}, time, ${style}}`;\n\t\t}\n\t\tcase TYPE.select: {\n\t\t\tconst options = Object.entries(\n\t\t\t\t(el as Record<string, any>).options as Record<\n\t\t\t\t\tstring,\n\t\t\t\t\t{ value: MessageFormatElement[] }\n\t\t\t\t>,\n\t\t\t)\n\t\t\t\t.map(([k, v]) => `${k} {${printICU(v.value)}}`)\n\t\t\t\t.join(\" \");\n\t\t\treturn `{${el.value}, select, ${options}}`;\n\t\t}\n\t\tcase TYPE.plural: {\n\t\t\tconst pluralEl = el as PluralElement;\n\t\t\tconst pluralType =\n\t\t\t\tpluralEl.pluralType === \"ordinal\" ? \"selectordinal\" : \"plural\";\n\t\t\tconst offset =\n\t\t\t\tpluralEl.offset !== 0 ? `offset:${pluralEl.offset} ` : \"\";\n\t\t\tconst options = Object.entries(pluralEl.options)\n\t\t\t\t.map(([k, v]) => `${k} {${printICU(v.value)}}`)\n\t\t\t\t.join(\" \");\n\t\t\treturn `{${pluralEl.value}, ${pluralType}, ${offset}${options}}`;\n\t\t}\n\t\tcase TYPE.tag: {\n\t\t\tconst children = printICU((el as Record<string, any>).children as MessageFormatElement[]);\n\t\t\treturn `<${el.value}>${children}</${el.value}>`;\n\t\t}\n\t\tdefault:\n\t\t\treturn \"\";\n\t}\n}\n\nfunction rewriteElements(\n\telements: MessageFormatElement[],\n\tforms: OrdinalForms,\n\tvalues: Record<string, any>,\n): MessageFormatElement[] {\n\treturn elements.flatMap((el) => {\n\t\tif (isPluralElement(el) && el.pluralType === \"ordinal\") {\n\t\t\treturn [rewriteSelectordinalElement(el, forms, values)];\n\t\t}\n\t\tif (isSelectElement(el)) {\n\t\t\tconst options: Record<string, { value: MessageFormatElement[] }> = {};\n\t\t\tfor (const [key, opt] of Object.entries(\n\t\t\t\tel.options as Record<string, { value: MessageFormatElement[] }>,\n\t\t\t)) {\n\t\t\t\toptions[key] = { value: rewriteElements(opt.value, forms, values) };\n\t\t\t}\n\t\t\treturn [{ ...el, options } as MessageFormatElement];\n\t\t}\n\t\tif (isPluralElement(el)) {\n\t\t\tconst options: Record<string, { value: MessageFormatElement[] }> = {};\n\t\t\tfor (const [key, opt] of Object.entries(el.options)) {\n\t\t\t\toptions[key] = { value: rewriteElements(opt.value, forms, values) };\n\t\t\t}\n\t\t\treturn [{ ...el, options } as MessageFormatElement];\n\t\t}\n\t\tif (isTagElement(el)) {\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\t...el,\n\t\t\t\t\tchildren: rewriteElements(\n\t\t\t\t\t\t(el as Record<string, any>).children as MessageFormatElement[],\n\t\t\t\t\t\tforms,\n\t\t\t\t\t\tvalues,\n\t\t\t\t\t),\n\t\t\t\t} as MessageFormatElement,\n\t\t\t];\n\t\t}\n\t\treturn [el];\n\t});\n}\n\nfunction rewriteSelectordinalElement(\n\tel: PluralElement,\n\tforms: OrdinalForms,\n\tvalues: Record<string, any>,\n): MessageFormatElement {\n\tif (forms.type === \"suffix\") {\n\t\tconst newOptions: Record<string, { value: MessageFormatElement[] }> = {};\n\t\tfor (const cat of CLDR_ORDINAL_ORDER) {\n\t\t\tconst pattern = forms.suffixes[cat];\n\t\t\tif (pattern === undefined) continue;\n\t\t\tconst poundIdx = pattern.indexOf(\"#\");\n\t\t\tconst parts: MessageFormatElement[] = [];\n\t\t\tif (poundIdx === -1) {\n\t\t\t\tparts.push({ type: TYPE.literal, value: pattern } as LiteralElement);\n\t\t\t} else {\n\t\t\t\tif (poundIdx > 0)\n\t\t\t\t\tparts.push({\n\t\t\t\t\t\ttype: TYPE.literal,\n\t\t\t\t\t\tvalue: pattern.slice(0, poundIdx),\n\t\t\t\t\t} as LiteralElement);\n\t\t\t\tparts.push({ type: TYPE.pound });\n\t\t\t\tif (poundIdx < pattern.length - 1)\n\t\t\t\t\tparts.push({\n\t\t\t\t\t\ttype: TYPE.literal,\n\t\t\t\t\t\tvalue: pattern.slice(poundIdx + 1),\n\t\t\t\t\t} as LiteralElement);\n\t\t\t}\n\t\t\tnewOptions[cat] = { value: parts };\n\t\t}\n\t\treturn { ...el, options: newOptions };\n\t}\n\n\tif (forms.type === \"word\") {\n\t\tconst rank = values[el.value];\n\t\tif (typeof rank === \"number\") {\n\t\t\tconst genderMap =\n\t\t\t\tforms.words[\"masculine\"] ?? Object.values(forms.words)[0];\n\t\t\tconst word = genderMap?.[rank];\n\t\t\treturn {\n\t\t\t\ttype: TYPE.literal,\n\t\t\t\tvalue: word ?? String(rank),\n\t\t\t} as LiteralElement;\n\t\t}\n\t}\n\n\treturn el;\n}\n\n/**\n * Rewrite any embedded `selectordinal` nodes in an ICU string using\n * `ordinalForms` from the locale bundle, before passing the string to\n * `formatICU`.\n *\n * Returns `icu` unchanged when:\n * - the string contains no \"selectordinal\" substring (fast path — most strings)\n * - parsing throws (safe fallback to whatever formatICU receives)\n *\n * @param icu - Translated ICU string (may contain garbage ordinal branches from provider)\n * @param ordinalForms - Locale's ordinalForms from the compiled bundle\n * @param values - Runtime interpolation values (needed for word-based rank lookup)\n */\nexport function rewriteSelectordinalInICU(\n\ticu: string,\n\tordinalForms: OrdinalForms,\n\tvalues: Record<string, any>,\n): string {\n\tif (!icu.includes(\"selectordinal\")) return icu;\n\n\ttry {\n\t\tconst ast = parse(icu, { captureLocation: false });\n\t\tconst rewritten = rewriteElements(ast, ordinalForms, values);\n\t\treturn printICU(rewritten);\n\t} catch {\n\t\treturn icu;\n\t}\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@vocoder/core",
+  "version": "0.2.0",
+  "description": "Shared primitives for the Vocoder i18n SDK — hash, ICU formatting, locale utilities, and types",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vocoder/vocoder-sdk.git",
+    "directory": "packages/core"
+  },
+  "keywords": [
+    "i18n",
+    "internationalization",
+    "translation",
+    "icu",
+    "messageformat",
+    "vocoder"
+  ],
+  "author": "Vocoder <admin@vocoder.app>",
+  "license": "MIT",
+  "homepage": "https://github.com/vocoder/vocoder-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/vocoder/vocoder-sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@formatjs/icu-messageformat-parser": "^2.11.4",
+    "intl-messageformat": "^11.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.9",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch --no-dts --clean=false",
+    "test": "vitest run",
+    "test:watch": "vitest --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}