@iqauth/sdk 2.3.0 → 2.5.0

package/dist/locales.d.ts

@@ -0,0 +1,53 @@
+import { I as IQAuthLocaleBundle, a as IQAuthLocaleOverride, b as IQAuthLocaleKey } from './types-6bNdxesb.js';
+
+declare const enUS: IQAuthLocaleBundle;
+
+declare const frFR: IQAuthLocaleBundle;
+
+declare const esES: IQAuthLocaleBundle;
+
+declare const deDE: IQAuthLocaleBundle;
+
+declare const jaJP: IQAuthLocaleBundle;
+
+declare const ptBR: IQAuthLocaleBundle;
+
+/**
+ * Public entry point for `@iqauth/sdk/locales`.
+ *
+ * Exports the strict bundle type, the default `enUS` bundle, the five other
+ * shipped locales, the `t()` resolver, and helpers for error-code mapping
+ * and Accept-Language negotiation.
+ */
+
+/** Bundles indexed by their canonical BCP-47 tag. */
+declare const builtInLocales: Record<string, IQAuthLocaleBundle>;
+/**
+ * Default bundle used when a key is missing from a contributor-supplied
+ * partial override, or when no `localization` prop is passed at all.
+ */
+declare const defaultBundle: IQAuthLocaleBundle;
+/**
+ * Resolve a localized string from a bundle. Substitutes `{name}` placeholders
+ * with values from `vars`. If the key is missing from the bundle (which
+ * should never happen when contributors supply a fully typed bundle, but can
+ * happen with a `Partial<IQAuthLocaleBundle>` override), the default `enUS`
+ * value is used as a graceful fallback.
+ */
+declare function t(bundle: IQAuthLocaleBundle | IQAuthLocaleOverride | undefined | null, key: IQAuthLocaleKey, vars?: Record<string, string | number>): string;
+/**
+ * Merge a partial override on top of the default bundle so callers always
+ * receive a fully populated `IQAuthLocaleBundle`. Used internally by
+ * `<IQAuthProvider localization={...}>`.
+ */
+declare function resolveBundle(override?: IQAuthLocaleBundle | IQAuthLocaleOverride | null): IQAuthLocaleBundle;
+declare function localizeErrorCode(bundle: IQAuthLocaleBundle | IQAuthLocaleOverride | undefined | null, code: string | undefined | null, vars?: Record<string, string | number>): string;
+/**
+ * Negotiate the best matching locale tag from a comma-separated
+ * `Accept-Language` header (or `navigator.language` value), preferring exact
+ * matches and falling back to the language subtag (e.g. `fr-CA` -> `fr-FR`).
+ * Returns `"en-US"` when no candidate matches a built-in locale.
+ */
+declare function negotiateLocale(acceptLanguage: string | null | undefined, available?: string[]): string;
+
+export { IQAuthLocaleBundle, IQAuthLocaleKey, IQAuthLocaleOverride, builtInLocales, deDE, defaultBundle, enUS, esES, frFR, jaJP, localizeErrorCode, negotiateLocale, ptBR, resolveBundle, t };