@astryxdesign/core 0.1.5 → 0.1.6-canary.02f2602

package/dist/hooks/useKeyboardHint.js

@@ -25,7 +25,7 @@ import { useLayer } from "../Layer/useLayer.js";
 // ---------------------------------------------------------------------------
 // Types
 // ---------------------------------------------------------------------------
-import { jsxDEV as _jsxDEV } from "react/jsx-dev-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // ---------------------------------------------------------------------------
 // Styles
 // ---------------------------------------------------------------------------
@@ -187,23 +187,23 @@ export function useKeyboardHint(options = {}) {
 
   // --- Render the hint element ---
 
-  const arrowContent = /*#__PURE__*/_jsxDEV("span", {
+  const arrowContent = /*#__PURE__*/_jsx("span", {
     ...{
       className: "x3nfvp2 x6s0dn4 xzye2dw"
     },
-    children: ARROW_HINT_KEYS[orientation].map(key => /*#__PURE__*/_jsxDEV(Kbd, {
+    children: ARROW_HINT_KEYS[orientation].map(key => /*#__PURE__*/_jsx(Kbd, {
       keys: key
-    }, key, false))
-  }, void 0, false);
-  const hintElement = layer.render(/*#__PURE__*/_jsxDEV("span", {
+    }, key))
+  });
+  const hintElement = layer.render(/*#__PURE__*/_jsxs("span", {
     "aria-hidden": "true",
-    children: [arrowContent, /*#__PURE__*/_jsxDEV("span", {
+    children: [arrowContent, /*#__PURE__*/_jsx("span", {
       ...{
         className: "x11g1kdw"
       },
       children: "to navigate"
-    }, void 0, false)]
-  }, void 0, true), {
+    })]
+  }), {
     placement: 'below',
     alignment: 'start',
     xstyle: styles.hint,

package/dist/i18n/InternationalizationContext.d.ts

@@ -0,0 +1,12 @@
+import type { Locale, MessagesByLocale, Overrides } from './types';
+export interface InternationalizationContextValue {
+    locale: Locale;
+    messages: MessagesByLocale;
+    overrides?: Overrides;
+}
+/**
+ * Default value falls through to the shipped en catalog in resolve().
+ * A consumer that doesn't render a provider still gets English defaults.
+ */
+export declare const InternationalizationContext: import("react").Context<InternationalizationContextValue>;
+//# sourceMappingURL=InternationalizationContext.d.ts.map

package/dist/i18n/InternationalizationContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InternationalizationContext.d.ts","sourceRoot":"","sources":["../../src/i18n/InternationalizationContext.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAC,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAC,MAAM,SAAS,CAAC;AAEjE,MAAM,WAAW,gCAAgC;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,2DAIpC,CAAC"}

package/dist/i18n/InternationalizationContext.js

@@ -0,0 +1,29 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file InternationalizationContext.ts
+ * @input React createContext, i18n types
+ * @output Exports InternationalizationContext and InternationalizationContextValue
+ * @position Context definition for client-side locale + messages
+ *
+ * Separated from InternationalizationProvider.tsx so components can consume
+ * the context without pulling in the full provider implementation.
+ * Follows the LinkContext.ts / ThemeContext.ts pattern.
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/core/src/i18n/InternationalizationProvider.tsx
+ * - /packages/core/src/i18n/t.client.ts
+ * - /packages/core/src/i18n/index.ts
+ */
+import { createContext } from 'react';
+/**
+ * Default value falls through to the shipped en catalog in resolve().
+ * A consumer that doesn't render a provider still gets English defaults.
+ */
+export const InternationalizationContext = /*#__PURE__*/createContext({
+  locale: 'en',
+  messages: {}
+});
+InternationalizationContext.displayName = 'InternationalizationContext';

package/dist/i18n/InternationalizationProvider.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @file InternationalizationProvider.tsx
+ * @input React, InternationalizationContext, i18n types
+ * @output Exports InternationalizationProvider component and props type
+ * @position Provider component for astryx i18n locale + messages
+ *
+ * Wraps a subtree with a locale and (optional) additional message catalogs +
+ * overrides. Astryx components inside the subtree resolve their strings via
+ * this context. If a consumer never renders a provider, astryx components
+ * still work — they use the shipped en catalog directly.
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/core/src/i18n/InternationalizationContext.ts
+ * - /packages/core/src/i18n/index.ts
+ * - /packages/core/src/i18n/InternationalizationProvider.doc.mjs
+ */
+import { type ReactNode } from 'react';
+import type { Locale, MessagesByLocale, Overrides } from './types';
+export interface InternationalizationProviderProps {
+    /**
+     * BCP 47 language tag. Examples: `'en'`, `'pt'`, `'pt-BR'`, `'zh-Hans'`.
+     *
+     * Regional tags are respected — resolving a message walks the tag from
+     * most-specific to least-specific (`pt-BR` → `pt`), then falls back to
+     * the shipped `en` catalog.
+     */
+    locale: Locale;
+    /**
+     * Additional shipped catalogs to make available for the selected locale.
+     * `en` is bundled with astryx and never needs to be listed here.
+     *
+     * @example
+     * ```
+     * import {fr} from '@astryxdesign/core/locales/fr.json';
+     * <InternationalizationProvider locale="fr" messages={{fr}}>
+     * ```
+     */
+    messages?: MessagesByLocale;
+    /**
+     * Sparse per-locale overrides applied on top of shipped defaults.
+     * Only the keys you want to override need to be listed.
+     *
+     * @example
+     * ```
+     * <InternationalizationProvider
+     *   locale="fr"
+     *   overrides={{fr: {'@astryx.pagination.next': 'Suivant'}}}
+     * >
+     * ```
+     */
+    overrides?: Overrides;
+    children: ReactNode;
+}
+/**
+ * Provides locale + additional messages + overrides to all astryx
+ * components in the subtree.
+ */
+export declare function InternationalizationProvider({ locale, messages, overrides, children, }: InternationalizationProviderProps): import("react").JSX.Element;
+export declare namespace InternationalizationProvider {
+    var displayName: string;
+}
+//# sourceMappingURL=InternationalizationProvider.d.ts.map

package/dist/i18n/InternationalizationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InternationalizationProvider.d.ts","sourceRoot":"","sources":["../../src/i18n/InternationalizationProvider.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAU,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAE9C,OAAO,KAAK,EAAC,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAC,MAAM,SAAS,CAAC;AAEjE,MAAM,WAAW,iCAAiC;IAChD;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,EAAE,iCAAiC,+BAUnC;yBAfe,4BAA4B"}

package/dist/i18n/InternationalizationProvider.js

@@ -0,0 +1,44 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file InternationalizationProvider.tsx
+ * @input React, InternationalizationContext, i18n types
+ * @output Exports InternationalizationProvider component and props type
+ * @position Provider component for astryx i18n locale + messages
+ *
+ * Wraps a subtree with a locale and (optional) additional message catalogs +
+ * overrides. Astryx components inside the subtree resolve their strings via
+ * this context. If a consumer never renders a provider, astryx components
+ * still work — they use the shipped en catalog directly.
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/core/src/i18n/InternationalizationContext.ts
+ * - /packages/core/src/i18n/index.ts
+ * - /packages/core/src/i18n/InternationalizationProvider.doc.mjs
+ */
+import { useMemo } from 'react';
+import { InternationalizationContext } from "./InternationalizationContext.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Provides locale + additional messages + overrides to all astryx
+ * components in the subtree.
+ */
+export function InternationalizationProvider({
+  locale,
+  messages,
+  overrides,
+  children
+}) {
+  const value = useMemo(() => ({
+    locale,
+    messages: messages ?? {},
+    overrides
+  }), [locale, messages, overrides]);
+  return /*#__PURE__*/_jsx(InternationalizationContext, {
+    value: value,
+    children: children
+  });
+}
+InternationalizationProvider.displayName = 'InternationalizationProvider';

package/dist/i18n/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @file index.ts
+ * @input Imports from InternationalizationProvider, InternationalizationContext,
+ *   useTranslator, translator, types
+ * @output Public surface for the i18n subpackage
+ * @position Component entry point; re-exported by /packages/core/src/index.ts
+ *
+ * The public API is deliberately small:
+ *   - InternationalizationProvider — provider component
+ *   - useTranslator               — hook returning a translator function
+ *   - Translator                  — interface for consumer-injected runtimes
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/core/src/index.ts
+ */
+export { InternationalizationProvider } from './InternationalizationProvider';
+export type { InternationalizationProviderProps } from './InternationalizationProvider';
+export { InternationalizationContext } from './InternationalizationContext';
+export type { InternationalizationContextValue } from './InternationalizationContext';
+export { useTranslator } from './useTranslator';
+export type { TranslatorFn } from './useTranslator';
+export type { Translator } from './translator';
+export type { Locale, Catalog, MessageEntry, MessagesByLocale, Overrides, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAC;AAC5E,YAAY,EAAC,iCAAiC,EAAC,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAC,2BAA2B,EAAC,MAAM,+BAA+B,CAAC;AAC1E,YAAY,EAAC,gCAAgC,EAAC,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAC7C,YAAY,EACV,MAAM,EACN,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,SAAS,GACV,MAAM,SAAS,CAAC"}

package/dist/i18n/index.js

@@ -0,0 +1,21 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file index.ts
+ * @input Imports from InternationalizationProvider, InternationalizationContext,
+ *   useTranslator, translator, types
+ * @output Public surface for the i18n subpackage
+ * @position Component entry point; re-exported by /packages/core/src/index.ts
+ *
+ * The public API is deliberately small:
+ *   - InternationalizationProvider — provider component
+ *   - useTranslator               — hook returning a translator function
+ *   - Translator                  — interface for consumer-injected runtimes
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/core/src/index.ts
+ */
+
+export { InternationalizationProvider } from "./InternationalizationProvider.js";
+export { InternationalizationContext } from "./InternationalizationContext.js";
+export { useTranslator } from "./useTranslator.js";

package/dist/i18n/resolve.d.ts

@@ -0,0 +1,22 @@
+import type { Locale, MessagesByLocale, Overrides } from './types';
+/**
+ * Walk a BCP 47 tag from most-specific to least-specific.
+ * Input is canonicalized via `Intl.Locale.baseName` so `pt-br` and `PT-BR`
+ * both produce `['pt-BR', 'pt']`.
+ *
+ * Examples:
+ *   'pt-BR'      → ['pt-BR', 'pt']
+ *   'zh-Hans-CN' → ['zh-Hans-CN', 'zh-Hans', 'zh']
+ *   'en'         → ['en']
+ *
+ * `en` is intentionally NOT appended here — the caller falls back to the
+ * shipped en catalog separately as the final source-of-truth.
+ */
+export declare function resolveLocaleChain(locale: Locale): Locale[];
+export declare function resolve(key: string, values: Record<string, unknown> | undefined, locale: Locale, messages: MessagesByLocale, overrides: Overrides | undefined): string;
+/**
+ * Reset internal caches. Test-only.
+ * @internal
+ */
+export declare function __resetForTests(): void;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/i18n/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/i18n/resolve.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAU,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAC,MAAM,SAAS,CAAC;AAuB1E;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAc3D;AAuDD,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,SAAS,GAAG,SAAS,GAC/B,MAAM,CAsBR;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC"}

package/dist/i18n/resolve.js

@@ -0,0 +1,141 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file resolve.ts
+ * @input Key + values + locale + catalog + overrides
+ * @output Formatted message string
+ * @position Shared lookup + ICU formatting core, used by useTranslator().
+ *
+ * Lookup order:
+ *   1. Per-locale override for the exact locale
+ *   2. Per-locale override for a parent locale (pt-BR → pt)
+ *   3. Shipped catalog entry for the exact locale
+ *   4. Shipped catalog entry for a parent locale (pt-BR → pt)
+ *   5. Shipped en catalog (the source of truth, always present)
+ *   6. The key itself (dev-visible fallback, warns once)
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/core/src/i18n/useTranslator.ts
+ * - /packages/core/src/i18n/__tests__/resolve.test.ts
+ */
+
+import IntlMessageFormat from 'intl-messageformat';
+import enSource from '../../locales/en.json' with { type: 'json' };
+const EN_CATALOG = enSource;
+
+/**
+ * Cache of parsed ICU MessageFormat objects keyed by `${locale}::${message}`.
+ * IntlMessageFormat parsing is non-trivial; caching avoids reparsing on every
+ * render. The cache is unbounded in principle but bounded in practice by the
+ * static set of astryx keys.
+ */
+const formatterCache = new Map();
+function getFormatter(message, locale) {
+  const cacheKey = `${locale}::${message}`;
+  let f = formatterCache.get(cacheKey);
+  if (f === undefined) {
+    f = new IntlMessageFormat(message, locale);
+    formatterCache.set(cacheKey, f);
+  }
+  return f;
+}
+
+/**
+ * Walk a BCP 47 tag from most-specific to least-specific.
+ * Input is canonicalized via `Intl.Locale.baseName` so `pt-br` and `PT-BR`
+ * both produce `['pt-BR', 'pt']`.
+ *
+ * Examples:
+ *   'pt-BR'      → ['pt-BR', 'pt']
+ *   'zh-Hans-CN' → ['zh-Hans-CN', 'zh-Hans', 'zh']
+ *   'en'         → ['en']
+ *
+ * `en` is intentionally NOT appended here — the caller falls back to the
+ * shipped en catalog separately as the final source-of-truth.
+ */
+export function resolveLocaleChain(locale) {
+  let canonical;
+  try {
+    canonical = new Intl.Locale(locale).baseName;
+  } catch {
+    // Malformed input — fall back to the raw string so callers still get a chain.
+    canonical = locale;
+  }
+  const parts = canonical.split('-');
+  const chain = [];
+  for (let i = parts.length; i > 0; i--) {
+    chain.push(parts.slice(0, i).join('-'));
+  }
+  return chain;
+}
+
+/**
+ * Missing-key warn-once tracking. Fires ONLY when a key is missing from
+ * every source including the shipped `en` catalog — that's a real bug
+ * (typo, stale catalog, deleted key). Fallback to `en` from a non-en
+ * locale is expected and silent, matching the FormatJS / i18next default
+ * of not spamming the console when a translation simply hasn't been
+ * written yet.
+ */
+const warnedMissing = new Set();
+function warnOnce(bucket, key, message) {
+  if (!bucket.has(key)) {
+    bucket.add(key);
+    console.warn(message);
+  }
+}
+function lookup(key, locale, messages, overrides) {
+  const chain = resolveLocaleChain(locale);
+
+  // 1 + 2. Overrides (most specific to least specific in the chain)
+  if (overrides !== undefined) {
+    for (const tag of chain) {
+      const value = overrides[tag]?.[key];
+      if (value !== undefined) {
+        return value;
+      }
+    }
+  }
+
+  // 3 + 4. Shipped catalogs (most specific to least specific)
+  for (const tag of chain) {
+    const entry = messages[tag]?.[key];
+    if (entry !== undefined) {
+      return entry.defaultMessage;
+    }
+  }
+
+  // 5. Shipped en catalog — always present
+  const enEntry = EN_CATALOG[key];
+  if (enEntry !== undefined) {
+    return enEntry.defaultMessage;
+  }
+
+  // 6. Nothing found
+  return null;
+}
+export function resolve(key, values, locale, messages, overrides) {
+  const result = lookup(key, locale, messages, overrides);
+  if (result === null) {
+    warnOnce(warnedMissing, `${locale}::${key}`, `[astryx-i18n] missing key: ${key} (locale: ${locale})`);
+    return key;
+  }
+  if (values === undefined) {
+    // Static string — skip the parser entirely for the common case
+    return result;
+  }
+  const formatted = getFormatter(result, locale).format(values);
+  // IntlMessageFormat.format returns string | (string | React elements) — we
+  // only ever pass string values so it will be a string; assert for the type
+  // system.
+  return formatted;
+}
+
+/**
+ * Reset internal caches. Test-only.
+ * @internal
+ */
+export function __resetForTests() {
+  formatterCache.clear();
+  warnedMissing.clear();
+}

package/dist/i18n/translator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @file translator.ts
+ * @input Translator interface for consumer i18n runtime injection
+ * @output Type surface for pluggable translators
+ * @position Public API for i18n adapter integration
+ *
+ * Consumers who already run an i18n runtime (react-intl, Lingui, i18next, etc.)
+ * can inject their own Translator instead of using the default provider. The
+ * interface is deliberately small so any real i18n library can satisfy it in a
+ * few lines.
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/core/src/i18n/index.ts
+ */
+/**
+ * A Translator formats ICU MessageFormat strings for a given locale.
+ * Consumers can supply their own to reuse their existing i18n runtime.
+ */
+export interface Translator {
+    /**
+     * Format an ICU MessageFormat message with values in the given locale.
+     */
+    format(message: string, values?: Record<string, unknown>, locale?: string): string;
+}
+//# sourceMappingURL=translator.d.ts.map

package/dist/i18n/translator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translator.d.ts","sourceRoot":"","sources":["../../src/i18n/translator.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAAC;CACX"}

package/dist/i18n/translator.js

@@ -0,0 +1 @@
+export {};

package/dist/i18n/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @file types.ts
+ * @input None
+ * @output Shared types for the i18n subpackage
+ * @position Type-only module; used across client + server t() implementations
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/core/src/i18n/InternationalizationContext.ts
+ * - /packages/core/src/i18n/InternationalizationProvider.tsx
+ * - /packages/core/src/i18n/serverStore.ts
+ * - /packages/core/src/i18n/resolve.ts
+ */
+/**
+ * A BCP 47 language tag. Examples: `'en'`, `'pt'`, `'pt-BR'`, `'zh-Hans'`.
+ *
+ * Regional tags are meaningful — `pt-BR` and `pt` are different catalogs.
+ * When resolving a message, the runtime walks the tag from most-specific
+ * to least-specific and falls back to `en` if nothing matches
+ * (see `resolveLocaleChain` in `resolve.ts`).
+ */
+export type Locale = string;
+/**
+ * A single entry in a translation catalog. The `defaultMessage` is an ICU
+ * MessageFormat string; `description` is optional context for translators
+ * (surfaced by Crowdin's `react_intl` file type parser).
+ */
+export interface MessageEntry {
+    defaultMessage: string;
+    description?: string;
+}
+/**
+ * A translation catalog — a map of stable message keys to entries.
+ * Astryx's own keys are namespaced under `@astryx.<component>.<name>`.
+ */
+export type Catalog = Record<string, MessageEntry>;
+/**
+ * A map of BCP 47 tags to catalogs. Passed as `messages` on
+ * `<InternationalizationProvider>`.
+ */
+export type MessagesByLocale = Record<Locale, Catalog>;
+/**
+ * Sparse per-locale overrides applied on top of the shipped defaults.
+ * Only the keys the consumer cares to override need to be listed.
+ * Overrides are locale-keyed so a runtime locale swap picks up the right ones.
+ */
+export type Overrides = Partial<Record<Locale, Record<string, string>>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/i18n/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/i18n/types.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC"}

package/dist/i18n/types.js

@@ -0,0 +1 @@
+export {};

package/dist/i18n/useTranslator.d.ts

@@ -0,0 +1,15 @@
+export type TranslatorFn = (key: string, values?: Record<string, unknown>) => string;
+/**
+ * Returns a translator function bound to the current provider's locale.
+ * Safe to call from event handlers and effects.
+ *
+ * @example
+ * ```
+ * function MyComponent() {
+ *   const translate = useTranslator();
+ *   const onClick = () => announce(translate('@astryx.pagination.pageAnnounce', {current: 1}));
+ * }
+ * ```
+ */
+export declare function useTranslator(): TranslatorFn;
+//# sourceMappingURL=useTranslator.d.ts.map

package/dist/i18n/useTranslator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranslator.d.ts","sourceRoot":"","sources":["../../src/i18n/useTranslator.ts"],"names":[],"mappings":"AAyBA,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,MAAM,CAAC;AAEZ;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAO5C"}

package/dist/i18n/useTranslator.js

@@ -0,0 +1,39 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file useTranslator.ts
+ * @input InternationalizationContext (via use())
+ * @output Exports useTranslator hook returning a stable translator function
+ * @position Client-side hook for translating outside of render (event handlers,
+ *   effects, non-component code) while still resolving against the current
+ *   provider's locale.
+ *
+ * Prefer `t()` for translations at the callsite during render. When you need
+ * to translate inside an event handler or effect, capture a translator during
+ * render via useTranslator() and call it later.
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/core/src/i18n/index.ts
+ * - /packages/core/src/i18n/t.client.ts
+ */
+import { use, useCallback } from 'react';
+import { InternationalizationContext } from "./InternationalizationContext.js";
+import { resolve } from "./resolve.js";
+/**
+ * Returns a translator function bound to the current provider's locale.
+ * Safe to call from event handlers and effects.
+ *
+ * @example
+ * ```
+ * function MyComponent() {
+ *   const translate = useTranslator();
+ *   const onClick = () => announce(translate('@astryx.pagination.pageAnnounce', {current: 1}));
+ * }
+ * ```
+ */
+export function useTranslator() {
+  const ctx = use(InternationalizationContext);
+  return useCallback((key, values) => resolve(key, values, ctx.locale, ctx.messages, ctx.overrides), [ctx.locale, ctx.messages, ctx.overrides]);
+}

package/dist/index.d.ts

@@ -108,5 +108,6 @@ export * from './OverflowList';
 export * from './hooks';
 export * from './utils';
 export * from './theme';
+export * from './i18n';
 export type { ComponentDoc, SingleComponentDoc, MultiComponentDoc, PropDoc, ComponentEntry, ThemingTarget, ComponentVar, DerivedVar, TranslationDoc, GroupDoc, ReferenceDoc, ReferenceSection, ContentBlock, TokenPreviewType, } from './docs-types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -144,4 +144,7 @@ export * from "./utils/index.js";
 // Theme
 export * from "./theme/index.js";
 
+// Internationalization
+export * from "./i18n/index.js";
+
 // Doc types — for external library authors writing .doc.mjs files

package/dist/theme/MediaTheme.js

@@ -37,7 +37,7 @@ import * as stylex from '@stylexjs/stylex';
 import "./tokens.stylex.js";
 import { colorVars } from "./tokens.stylex.js";
 import { dataAttr } from "../naming.js";
-import { jsxDEV as _jsxDEV } from "react/jsx-dev-runtime";
+import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * Inverted surface theming context.
  *
@@ -49,12 +49,12 @@ export function MediaTheme({
   mode,
   children
 }) {
-  return /*#__PURE__*/_jsxDEV("div", {
+  return /*#__PURE__*/_jsx("div", {
     [dataAttr('media')]: mode,
     ...{
       className: "xjp7ctv x1tgivj0"
     },
     children: children
-  }, void 0, false);
+  });
 }
 MediaTheme.displayName = 'MediaTheme';