@cube-dev/ui-kit 0.145.4 → 0.146.0

package/dist/i18n/createFormatter.d.ts

@@ -0,0 +1,59 @@
+
+//#region src/i18n/createFormatter.d.ts
+/**
+ * A value acceptable to the date/time formatters. Named `FormatDateInput` (not
+ * `DateInput`) to avoid clashing with the exported `DateInput` DatePicker field.
+ */
+type FormatDateInput = Date | number | string;
+interface RelativeTimeOptions {
+  /** Reference point the value is compared against. Defaults to `Date.now()`. */
+  now?: FormatDateInput;
+  /** Passed to `Intl.RelativeTimeFormat`. Defaults to `'auto'` ("yesterday"). */
+  numeric?: Intl.RelativeTimeFormatNumeric;
+  /** Passed to `Intl.RelativeTimeFormat`. Defaults to `'long'`. */
+  style?: Intl.RelativeTimeFormatStyle;
+}
+interface CurrencyOptions extends Intl.NumberFormatOptions {
+  /** ISO 4217 currency code. Defaults to `'USD'`. */
+  currency?: string;
+}
+interface BytesOptions {
+  /** How the unit label is displayed. Defaults to `'short'` ("MB"). */
+  unitDisplay?: Intl.NumberFormatOptions['unitDisplay'];
+  /** Max fraction digits. Defaults to `1`. */
+  maximumFractionDigits?: number;
+  /** Min fraction digits. Defaults to `0`. */
+  minimumFractionDigits?: number;
+}
+/** The bundle of locale-bound formatting helpers. */
+interface Formatter {
+  /** The BCP-47 locale every helper below formats for. */
+  locale: string;
+  /** Date only, defaults to `{ dateStyle: 'medium' }` ("Jan 15, 2024"). */
+  formatDate: (value: FormatDateInput, options?: Intl.DateTimeFormatOptions) => string;
+  /** Time only, defaults to `{ timeStyle: 'short' }` ("2:30 PM"). */
+  formatTime: (value: FormatDateInput, options?: Intl.DateTimeFormatOptions) => string;
+  /** Date + time, defaults to `{ dateStyle: 'medium', timeStyle: 'short' }`. */
+  formatDateTime: (value: FormatDateInput, options?: Intl.DateTimeFormatOptions) => string;
+  /** Relative time via `Intl.RelativeTimeFormat` ("5 minutes ago"). */
+  formatRelativeTime: (value: FormatDateInput, options?: RelativeTimeOptions) => string;
+  /** A number via `Intl.NumberFormat`. */
+  formatNumber: (value: number, options?: Intl.NumberFormatOptions) => string;
+  /** A currency amount, defaults to USD. */
+  formatCurrency: (value: number, options?: CurrencyOptions) => string;
+  /** A percentage. Input is a fraction: `0.5` → "50%". */
+  formatPercent: (value: number, options?: Intl.NumberFormatOptions) => string;
+  /** A byte count with a localized, auto-scaled unit ("1.5 MB"). Decimal (1000-based). */
+  formatBytes: (value: number, options?: BytesOptions) => string;
+  /** A list via `Intl.ListFormat` ("A, B, and C"). */
+  formatList: (items: Iterable<string>, options?: Intl.ListFormatOptions) => string;
+}
+/**
+ * Builds a bundle of formatting helpers bound to `locale`. Used by both
+ * `useFormatter()` (locale from React Aria context) and the pure top-level
+ * helpers (locale from the module mirror). All `Intl.*` instances are memoized.
+ */
+declare function createFormatter(locale: string): Formatter;
+//#endregion
+export { BytesOptions, CurrencyOptions, FormatDateInput, Formatter, RelativeTimeOptions, createFormatter };
+//# sourceMappingURL=createFormatter.d.ts.map

package/dist/i18n/createFormatter.js

@@ -0,0 +1,148 @@
+/** @license MIT | @cube-dev/ui-kit v0.146.0 | Cube Dev Team */
+//#region src/i18n/createFormatter.ts
+const cache = /* @__PURE__ */ new Map();
+function getIntl(kind, Ctor, locale, options) {
+	const key = `${locale}|${kind}|${options ? JSON.stringify(options) : ""}`;
+	let instance = cache.get(key);
+	if (!instance) {
+		instance = new Ctor(locale, options);
+		cache.set(key, instance);
+	}
+	return instance;
+}
+function toDate(value) {
+	const date = value instanceof Date ? value : new Date(value);
+	return Number.isNaN(date.getTime()) ? null : date;
+}
+const BYTE_UNITS = [
+	"byte",
+	"kilobyte",
+	"megabyte",
+	"gigabyte",
+	"terabyte",
+	"petabyte"
+];
+const RELATIVE_DIVISIONS = [
+	{
+		amount: 60,
+		unit: "second"
+	},
+	{
+		amount: 60,
+		unit: "minute"
+	},
+	{
+		amount: 24,
+		unit: "hour"
+	},
+	{
+		amount: 7,
+		unit: "day"
+	},
+	{
+		amount: 4.34524,
+		unit: "week"
+	},
+	{
+		amount: 12,
+		unit: "month"
+	},
+	{
+		amount: Number.POSITIVE_INFINITY,
+		unit: "year"
+	}
+];
+/**
+* Builds a bundle of formatting helpers bound to `locale`. Used by both
+* `useFormatter()` (locale from React Aria context) and the pure top-level
+* helpers (locale from the module mirror). All `Intl.*` instances are memoized.
+*/
+function createFormatter(locale) {
+	const formatDate = (value, options) => {
+		const date = toDate(value);
+		if (!date) return "";
+		return getIntl("date", Intl.DateTimeFormat, locale, {
+			dateStyle: "medium",
+			...options
+		}).format(date);
+	};
+	const formatTime = (value, options) => {
+		const date = toDate(value);
+		if (!date) return "";
+		return getIntl("date", Intl.DateTimeFormat, locale, {
+			timeStyle: "short",
+			...options
+		}).format(date);
+	};
+	const formatDateTime = (value, options) => {
+		const date = toDate(value);
+		if (!date) return "";
+		return getIntl("date", Intl.DateTimeFormat, locale, {
+			dateStyle: "medium",
+			timeStyle: "short",
+			...options
+		}).format(date);
+	};
+	const formatRelativeTime = (value, options) => {
+		const date = toDate(value);
+		if (!date) return "";
+		const now = options?.now != null ? toDate(options.now) : /* @__PURE__ */ new Date();
+		if (!now) return "";
+		const rtf = getIntl("relative", Intl.RelativeTimeFormat, locale, {
+			numeric: options?.numeric ?? "auto",
+			style: options?.style ?? "long"
+		});
+		let duration = (date.getTime() - now.getTime()) / 1e3;
+		for (const division of RELATIVE_DIVISIONS) {
+			if (Math.abs(duration) < division.amount) return rtf.format(Math.round(duration), division.unit);
+			duration /= division.amount;
+		}
+		return rtf.format(Math.round(duration), "year");
+	};
+	const formatNumber = (value, options) => getIntl("number", Intl.NumberFormat, locale, options).format(value);
+	const formatCurrency = (value, options) => {
+		const { currency = "USD", ...rest } = options ?? {};
+		return getIntl("number", Intl.NumberFormat, locale, {
+			style: "currency",
+			currency,
+			...rest
+		}).format(value);
+	};
+	const formatPercent = (value, options) => getIntl("number", Intl.NumberFormat, locale, {
+		style: "percent",
+		...options
+	}).format(value);
+	const formatBytes = (value, options) => {
+		const sign = value < 0 ? -1 : 1;
+		let bytes = Math.abs(value);
+		let unitIndex = 0;
+		while (bytes >= 1e3 && unitIndex < BYTE_UNITS.length - 1) {
+			bytes /= 1e3;
+			unitIndex++;
+		}
+		return getIntl("number", Intl.NumberFormat, locale, {
+			style: "unit",
+			unit: BYTE_UNITS[unitIndex],
+			unitDisplay: options?.unitDisplay ?? "short",
+			minimumFractionDigits: options?.minimumFractionDigits ?? 0,
+			maximumFractionDigits: options?.maximumFractionDigits ?? (unitIndex === 0 ? 0 : 1)
+		}).format(sign * bytes);
+	};
+	const formatList = (items, options) => getIntl("list", Intl.ListFormat, locale, options).format(items);
+	return {
+		locale,
+		formatDate,
+		formatTime,
+		formatDateTime,
+		formatRelativeTime,
+		formatNumber,
+		formatCurrency,
+		formatPercent,
+		formatBytes,
+		formatList
+	};
+}
+
+//#endregion
+export { createFormatter };
+//# sourceMappingURL=createFormatter.js.map

package/dist/i18n/createFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFormatter.js","names":[],"sources":["../../src/i18n/createFormatter.ts"],"sourcesContent":["/**\n * A value acceptable to the date/time formatters. Named `FormatDateInput` (not\n * `DateInput`) to avoid clashing with the exported `DateInput` DatePicker field.\n */\nexport type FormatDateInput = Date | number | string;\n\nexport interface RelativeTimeOptions {\n  /** Reference point the value is compared against. Defaults to `Date.now()`. */\n  now?: FormatDateInput;\n  /** Passed to `Intl.RelativeTimeFormat`. Defaults to `'auto'` (\"yesterday\"). */\n  numeric?: Intl.RelativeTimeFormatNumeric;\n  /** Passed to `Intl.RelativeTimeFormat`. Defaults to `'long'`. */\n  style?: Intl.RelativeTimeFormatStyle;\n}\n\nexport interface CurrencyOptions extends Intl.NumberFormatOptions {\n  /** ISO 4217 currency code. Defaults to `'USD'`. */\n  currency?: string;\n}\n\nexport interface BytesOptions {\n  /** How the unit label is displayed. Defaults to `'short'` (\"MB\"). */\n  unitDisplay?: Intl.NumberFormatOptions['unitDisplay'];\n  /** Max fraction digits. Defaults to `1`. */\n  maximumFractionDigits?: number;\n  /** Min fraction digits. Defaults to `0`. */\n  minimumFractionDigits?: number;\n}\n\n/** The bundle of locale-bound formatting helpers. */\nexport interface Formatter {\n  /** The BCP-47 locale every helper below formats for. */\n  locale: string;\n  /** Date only, defaults to `{ dateStyle: 'medium' }` (\"Jan 15, 2024\"). */\n  formatDate: (\n    value: FormatDateInput,\n    options?: Intl.DateTimeFormatOptions,\n  ) => string;\n  /** Time only, defaults to `{ timeStyle: 'short' }` (\"2:30 PM\"). */\n  formatTime: (\n    value: FormatDateInput,\n    options?: Intl.DateTimeFormatOptions,\n  ) => string;\n  /** Date + time, defaults to `{ dateStyle: 'medium', timeStyle: 'short' }`. */\n  formatDateTime: (\n    value: FormatDateInput,\n    options?: Intl.DateTimeFormatOptions,\n  ) => string;\n  /** Relative time via `Intl.RelativeTimeFormat` (\"5 minutes ago\"). */\n  formatRelativeTime: (\n    value: FormatDateInput,\n    options?: RelativeTimeOptions,\n  ) => string;\n  /** A number via `Intl.NumberFormat`. */\n  formatNumber: (value: number, options?: Intl.NumberFormatOptions) => string;\n  /** A currency amount, defaults to USD. */\n  formatCurrency: (value: number, options?: CurrencyOptions) => string;\n  /** A percentage. Input is a fraction: `0.5` → \"50%\". */\n  formatPercent: (value: number, options?: Intl.NumberFormatOptions) => string;\n  /** A byte count with a localized, auto-scaled unit (\"1.5 MB\"). Decimal (1000-based). */\n  formatBytes: (value: number, options?: BytesOptions) => string;\n  /** A list via `Intl.ListFormat` (\"A, B, and C\"). */\n  formatList: (\n    items: Iterable<string>,\n    options?: Intl.ListFormatOptions,\n  ) => string;\n}\n\ntype IntlCtor =\n  | typeof Intl.DateTimeFormat\n  | typeof Intl.NumberFormat\n  | typeof Intl.RelativeTimeFormat\n  | typeof Intl.ListFormat;\n\n// `Intl.*` constructors are expensive, so instances are memoized by\n// locale + kind + options. Shared by both the hook and the pure helpers.\nconst cache = new Map<string, unknown>();\n\nfunction getIntl<T>(\n  kind: string,\n  Ctor: IntlCtor,\n  locale: string,\n  options: object | undefined,\n): T {\n  const key = `${locale}|${kind}|${options ? JSON.stringify(options) : ''}`;\n  let instance = cache.get(key);\n\n  if (!instance) {\n    instance = new (Ctor as new (locale: string, options?: object) => unknown)(\n      locale,\n      options,\n    );\n    cache.set(key, instance);\n  }\n\n  return instance as T;\n}\n\nfunction toDate(value: FormatDateInput): Date | null {\n  const date =\n    value instanceof Date ? value : new Date(value as string | number);\n\n  return Number.isNaN(date.getTime()) ? null : date;\n}\n\n// Decimal (1000-based) byte units. `Intl` localizes the unit label itself, so we\n// only pick which one fits the magnitude.\nconst BYTE_UNITS = [\n  'byte',\n  'kilobyte',\n  'megabyte',\n  'gigabyte',\n  'terabyte',\n  'petabyte',\n] as const;\n\n// Largest-fitting-unit thresholds for relative time. Each `amount` is how many\n// of the current unit make up the next one.\nconst RELATIVE_DIVISIONS: {\n  amount: number;\n  unit: Intl.RelativeTimeFormatUnit;\n}[] = [\n  { amount: 60, unit: 'second' },\n  { amount: 60, unit: 'minute' },\n  { amount: 24, unit: 'hour' },\n  { amount: 7, unit: 'day' },\n  { amount: 4.34524, unit: 'week' },\n  { amount: 12, unit: 'month' },\n  { amount: Number.POSITIVE_INFINITY, unit: 'year' },\n];\n\n/**\n * Builds a bundle of formatting helpers bound to `locale`. Used by both\n * `useFormatter()` (locale from React Aria context) and the pure top-level\n * helpers (locale from the module mirror). All `Intl.*` instances are memoized.\n */\nexport function createFormatter(locale: string): Formatter {\n  const formatDate: Formatter['formatDate'] = (value, options) => {\n    const date = toDate(value);\n    if (!date) return '';\n\n    return getIntl<Intl.DateTimeFormat>('date', Intl.DateTimeFormat, locale, {\n      dateStyle: 'medium',\n      ...options,\n    }).format(date);\n  };\n\n  const formatTime: Formatter['formatTime'] = (value, options) => {\n    const date = toDate(value);\n    if (!date) return '';\n\n    return getIntl<Intl.DateTimeFormat>('date', Intl.DateTimeFormat, locale, {\n      timeStyle: 'short',\n      ...options,\n    }).format(date);\n  };\n\n  const formatDateTime: Formatter['formatDateTime'] = (value, options) => {\n    const date = toDate(value);\n    if (!date) return '';\n\n    return getIntl<Intl.DateTimeFormat>('date', Intl.DateTimeFormat, locale, {\n      dateStyle: 'medium',\n      timeStyle: 'short',\n      ...options,\n    }).format(date);\n  };\n\n  const formatRelativeTime: Formatter['formatRelativeTime'] = (\n    value,\n    options,\n  ) => {\n    const date = toDate(value);\n    if (!date) return '';\n\n    const now = options?.now != null ? toDate(options.now) : new Date();\n    if (!now) return '';\n\n    const rtf = getIntl<Intl.RelativeTimeFormat>(\n      'relative',\n      Intl.RelativeTimeFormat,\n      locale,\n      {\n        numeric: options?.numeric ?? 'auto',\n        style: options?.style ?? 'long',\n      },\n    );\n\n    let duration = (date.getTime() - now.getTime()) / 1000;\n\n    for (const division of RELATIVE_DIVISIONS) {\n      if (Math.abs(duration) < division.amount) {\n        return rtf.format(Math.round(duration), division.unit);\n      }\n      duration /= division.amount;\n    }\n\n    return rtf.format(Math.round(duration), 'year');\n  };\n\n  const formatNumber: Formatter['formatNumber'] = (value, options) =>\n    getIntl<Intl.NumberFormat>(\n      'number',\n      Intl.NumberFormat,\n      locale,\n      options,\n    ).format(value);\n\n  const formatCurrency: Formatter['formatCurrency'] = (value, options) => {\n    const { currency = 'USD', ...rest } = options ?? {};\n\n    return getIntl<Intl.NumberFormat>('number', Intl.NumberFormat, locale, {\n      style: 'currency',\n      currency,\n      ...rest,\n    }).format(value);\n  };\n\n  const formatPercent: Formatter['formatPercent'] = (value, options) =>\n    getIntl<Intl.NumberFormat>('number', Intl.NumberFormat, locale, {\n      style: 'percent',\n      ...options,\n    }).format(value);\n\n  const formatBytes: Formatter['formatBytes'] = (value, options) => {\n    const sign = value < 0 ? -1 : 1;\n    let bytes = Math.abs(value);\n    let unitIndex = 0;\n\n    while (bytes >= 1000 && unitIndex < BYTE_UNITS.length - 1) {\n      bytes /= 1000;\n      unitIndex++;\n    }\n\n    return getIntl<Intl.NumberFormat>('number', Intl.NumberFormat, locale, {\n      style: 'unit',\n      unit: BYTE_UNITS[unitIndex],\n      unitDisplay: options?.unitDisplay ?? 'short',\n      // Bytes (the base unit) are integers; scaled units get 1 fraction digit.\n      minimumFractionDigits: options?.minimumFractionDigits ?? 0,\n      maximumFractionDigits:\n        options?.maximumFractionDigits ?? (unitIndex === 0 ? 0 : 1),\n    }).format(sign * bytes);\n  };\n\n  const formatList: Formatter['formatList'] = (items, options) =>\n    getIntl<Intl.ListFormat>('list', Intl.ListFormat, locale, options).format(\n      items,\n    );\n\n  return {\n    locale,\n    formatDate,\n    formatTime,\n    formatDateTime,\n    formatRelativeTime,\n    formatNumber,\n    formatCurrency,\n    formatPercent,\n    formatBytes,\n    formatList,\n  };\n}\n"],"mappings":"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"}

package/dist/i18n/index.d.ts

@@ -0,0 +1,18 @@
+
+import { UIKIT_I18N_NAMESPACE, UIKitResources, createUIKitI18n, getI18n } from "./instance.js";
+import "./useI18n.js";
+import { I18nProvider, I18nProviderProps } from "./I18nProvider.js";
+import { BytesOptions, CurrencyOptions, FormatDateInput, Formatter, RelativeTimeOptions, createFormatter } from "./createFormatter.js";
+import { useFormatter } from "./useFormatter.js";
+import { LOCALE_LABELS, SUPPORTED_LOCALES, SupportedLocale, isSupportedLocale } from "./locales.js";
+
+//#region src/i18n/index.d.ts
+/**
+ * Register (or override) the UI Kit translation bundle for a locale. Use this
+ * to add languages beyond the ones the UI Kit ships, or to override individual
+ * strings. Applied to the shared instance so it takes effect immediately.
+ */
+declare function addUIKitLocale(locale: string, resources: Partial<UIKitResources>): void;
+//#endregion
+export { addUIKitLocale };
+//# sourceMappingURL=index.d.ts.map

package/dist/i18n/index.js

@@ -0,0 +1,21 @@
+/** @license MIT | @cube-dev/ui-kit v0.146.0 | Cube Dev Team */
+import { LOCALE_LABELS, SUPPORTED_LOCALES, isSupportedLocale } from "./locales.js";
+import { UIKIT_I18N_NAMESPACE, createUIKitI18n, getI18n } from "./instance.js";
+import { useI18n } from "./useI18n.js";
+import { I18nProvider } from "./I18nProvider.js";
+import { createFormatter } from "./createFormatter.js";
+import { useFormatter } from "./useFormatter.js";
+
+//#region src/i18n/index.ts
+/**
+* Register (or override) the UI Kit translation bundle for a locale. Use this
+* to add languages beyond the ones the UI Kit ships, or to override individual
+* strings. Applied to the shared instance so it takes effect immediately.
+*/
+function addUIKitLocale(locale, resources) {
+	getI18n().addResourceBundle(locale, UIKIT_I18N_NAMESPACE, resources, true, true);
+}
+
+//#endregion
+export { addUIKitLocale };
+//# sourceMappingURL=index.js.map

package/dist/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/i18n/index.ts"],"sourcesContent":["import { getI18n, UIKIT_I18N_NAMESPACE } from './instance';\n\nimport type { UIKitResources } from './instance';\n\nexport { createUIKitI18n, getI18n, UIKIT_I18N_NAMESPACE } from './instance';\nexport type { UIKitResources } from './instance';\n// Internal hook — used by UI Kit components to read their own strings. Not part\n// of the public barrel (`src/index.ts`); hosts use the re-exported\n// `useTranslation` for their own strings.\nexport { useI18n } from './useI18n';\nexport { I18nProvider } from './I18nProvider';\nexport type { I18nProviderProps } from './I18nProvider';\nexport { createFormatter } from './createFormatter';\nexport type {\n  Formatter,\n  FormatDateInput,\n  RelativeTimeOptions,\n  CurrencyOptions,\n  BytesOptions,\n} from './createFormatter';\nexport { useFormatter } from './useFormatter';\nexport { SUPPORTED_LOCALES, LOCALE_LABELS, isSupportedLocale } from './locales';\nexport type { SupportedLocale } from './locales';\n\n/**\n * Register (or override) the UI Kit translation bundle for a locale. Use this\n * to add languages beyond the ones the UI Kit ships, or to override individual\n * strings. Applied to the shared instance so it takes effect immediately.\n */\nexport function addUIKitLocale(\n  locale: string,\n  resources: Partial<UIKitResources>,\n): void {\n  getI18n().addResourceBundle(\n    locale,\n    UIKIT_I18N_NAMESPACE,\n    resources,\n    true,\n    true,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;AA6BA,SAAgB,eACd,QACA,WACM;AACN,UAAS,CAAC,kBACR,QACA,sBACA,WACA,MACA,KACD"}

package/dist/i18n/instance.d.ts

@@ -0,0 +1,22 @@
+
+import { __json_default_export } from "./locales/en-US/uikit.json.js";
+import { i18n } from "i18next";
+
+//#region src/i18n/instance.d.ts
+/** The dedicated namespace all UI Kit strings live under. */
+declare const UIKIT_I18N_NAMESPACE = "uikit";
+/** Shape of the UI Kit translation bundle (the `en-US` source of truth). */
+type UIKitResources = typeof __json_default_export;
+/**
+ * Creates an isolated, synchronously initialized UI Kit i18next instance.
+ *
+ * Create one per server request and pass it to `<Root i18n={instance}>` (or
+ * `<I18nProvider i18n={instance}>`). Its language can then be changed without
+ * racing with another request rendered by the same server process.
+ */
+declare function createUIKitI18n(locale?: string): i18n;
+/** Returns the shared UI Kit i18next instance. */
+declare function getI18n(): i18n;
+//#endregion
+export { UIKIT_I18N_NAMESPACE, UIKitResources, createUIKitI18n, getI18n };
+//# sourceMappingURL=instance.d.ts.map

package/dist/i18n/instance.js

@@ -0,0 +1,78 @@
+/** @license MIT | @cube-dev/ui-kit v0.146.0 | Cube Dev Team */
+import { SUPPORTED_LOCALES } from "./locales.js";
+import uikit_default from "./locales/de-DE/uikit.js";
+import uikit_default$1 from "./locales/en-US/uikit.js";
+import uikit_default$2 from "./locales/es-ES/uikit.js";
+import uikit_default$3 from "./locales/es-MX/uikit.js";
+import uikit_default$4 from "./locales/fr-FR/uikit.js";
+import uikit_default$5 from "./locales/it-IT/uikit.js";
+import uikit_default$6 from "./locales/ja-JP/uikit.js";
+import uikit_default$7 from "./locales/nb-NO/uikit.js";
+import uikit_default$8 from "./locales/pt-BR/uikit.js";
+import uikit_default$9 from "./locales/pt-PT/uikit.js";
+import uikit_default$10 from "./locales/sv-SE/uikit.js";
+import uikit_default$11 from "./locales/vi-VN/uikit.js";
+import i18next from "i18next";
+import { initReactI18next } from "react-i18next";
+
+//#region src/i18n/instance.ts
+/** The dedicated namespace all UI Kit strings live under. */
+const UIKIT_I18N_NAMESPACE = "uikit";
+const BUNDLES = {
+	"en-US": uikit_default$1,
+	"de-DE": uikit_default,
+	"es-ES": uikit_default$2,
+	"es-MX": uikit_default$3,
+	"fr-FR": uikit_default$4,
+	"it-IT": uikit_default$5,
+	"ja-JP": uikit_default$6,
+	"nb-NO": uikit_default$7,
+	"pt-BR": uikit_default$8,
+	"pt-PT": uikit_default$9,
+	"sv-SE": uikit_default$10,
+	"vi-VN": uikit_default$11
+};
+const DEFAULT_OPTIONS = {
+	resources: Object.fromEntries(SUPPORTED_LOCALES.map((locale) => [locale, { [UIKIT_I18N_NAMESPACE]: BUNDLES[locale] }])),
+	lng: "en-US",
+	fallbackLng: "en-US",
+	load: "currentOnly",
+	defaultNS: UIKIT_I18N_NAMESPACE,
+	ns: [UIKIT_I18N_NAMESPACE],
+	interpolation: { escapeValue: false },
+	returnNull: false,
+	returnEmptyString: true,
+	initAsync: false,
+	react: { useSuspense: false },
+	enableSelector: true
+};
+/**
+* Creates an isolated, synchronously initialized UI Kit i18next instance.
+*
+* Create one per server request and pass it to `<Root i18n={instance}>` (or
+* `<I18nProvider i18n={instance}>`). Its language can then be changed without
+* racing with another request rendered by the same server process.
+*/
+function createUIKitI18n(locale = "en-US") {
+	const isolatedInstance = i18next.createInstance();
+	isolatedInstance.init({
+		...DEFAULT_OPTIONS,
+		lng: locale
+	});
+	return isolatedInstance;
+}
+/**
+* The browser-friendly default instance. Existing hosts can continue to drive
+* it through `getI18n()`. Concurrent server renders must use a request-local
+* instance from `createUIKitI18n()` instead.
+*/
+const instance = i18next.createInstance();
+instance.use(initReactI18next).init(DEFAULT_OPTIONS);
+/** Returns the shared UI Kit i18next instance. */
+function getI18n() {
+	return instance;
+}
+
+//#endregion
+export { UIKIT_I18N_NAMESPACE, createUIKitI18n, getI18n };
+//# sourceMappingURL=instance.js.map

package/dist/i18n/instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","names":["enUS","deDE","esES","esMX","frFR","itIT","jaJP","nbNO","ptBR","ptPT","svSE","viVN"],"sources":["../../src/i18n/instance.ts"],"sourcesContent":["import i18next from 'i18next';\nimport { initReactI18next } from 'react-i18next';\n\nimport { SUPPORTED_LOCALES } from './locales';\nimport deDE from './locales/de-DE/uikit.json';\nimport enUS from './locales/en-US/uikit.json';\nimport esES from './locales/es-ES/uikit.json';\nimport esMX from './locales/es-MX/uikit.json';\nimport frFR from './locales/fr-FR/uikit.json';\nimport itIT from './locales/it-IT/uikit.json';\nimport jaJP from './locales/ja-JP/uikit.json';\nimport nbNO from './locales/nb-NO/uikit.json';\nimport ptBR from './locales/pt-BR/uikit.json';\nimport ptPT from './locales/pt-PT/uikit.json';\nimport svSE from './locales/sv-SE/uikit.json';\nimport viVN from './locales/vi-VN/uikit.json';\n\nimport type { i18n as I18nInstance, InitOptions } from 'i18next';\n\n/** The dedicated namespace all UI Kit strings live under. */\nexport const UIKIT_I18N_NAMESPACE = 'uikit';\n\n/** Shape of the UI Kit translation bundle (the `en-US` source of truth). */\nexport type UIKitResources = typeof enUS;\n\nconst BUNDLES: Record<(typeof SUPPORTED_LOCALES)[number], UIKitResources> = {\n  'en-US': enUS,\n  'de-DE': deDE,\n  'es-ES': esES,\n  'es-MX': esMX,\n  'fr-FR': frFR,\n  'it-IT': itIT,\n  'ja-JP': jaJP,\n  'nb-NO': nbNO,\n  'pt-BR': ptBR,\n  'pt-PT': ptPT,\n  'sv-SE': svSE,\n  'vi-VN': viVN,\n};\n\n// Every locale is tiny (~40 keys), so all are registered eagerly at init —\n// no code-splitting/loader machinery is needed.\nconst resources = Object.fromEntries(\n  SUPPORTED_LOCALES.map((locale) => [\n    locale,\n    { [UIKIT_I18N_NAMESPACE]: BUNDLES[locale] },\n  ]),\n);\n\nconst DEFAULT_OPTIONS: InitOptions = {\n  resources,\n  lng: 'en-US',\n  fallbackLng: 'en-US',\n  // Full BCP-47 codes only — don't let i18next strip `es-ES` to a bare `es`\n  // bundle (which we don't ship); an unmatched code falls back to `en-US`.\n  load: 'currentOnly',\n  defaultNS: UIKIT_I18N_NAMESPACE,\n  ns: [UIKIT_I18N_NAMESPACE],\n  interpolation: { escapeValue: false },\n  returnNull: false,\n  returnEmptyString: true,\n  // All resources are bundled synchronously at init, so the instance is ready\n  // immediately — disable Suspense so components (and unit tests / SSR) render\n  // translated text on the first pass without a Suspense boundary.\n  initAsync: false,\n  react: { useSuspense: false },\n  // Proxy-based selector API (`t($ => $.a.b)`). UI Kit components use plain\n  // string keys, but Cube Cloud drives this same instance with the selector\n  // form, so enabling it here preserves that contract once Cloud consumes the\n  // exported instance.\n  enableSelector: true,\n};\n\n/**\n * Creates an isolated, synchronously initialized UI Kit i18next instance.\n *\n * Create one per server request and pass it to `<Root i18n={instance}>` (or\n * `<I18nProvider i18n={instance}>`). Its language can then be changed without\n * racing with another request rendered by the same server process.\n */\nexport function createUIKitI18n(locale = 'en-US'): I18nInstance {\n  const isolatedInstance = i18next.createInstance();\n\n  void isolatedInstance.init({\n    ...DEFAULT_OPTIONS,\n    lng: locale,\n  });\n\n  return isolatedInstance;\n}\n\n/**\n * The browser-friendly default instance. Existing hosts can continue to drive\n * it through `getI18n()`. Concurrent server renders must use a request-local\n * instance from `createUIKitI18n()` instead.\n */\nconst instance: I18nInstance = i18next.createInstance();\n\nvoid instance.use(initReactI18next).init(DEFAULT_OPTIONS);\n\n/** Returns the shared UI Kit i18next instance. */\nexport function getI18n(): I18nInstance {\n  return instance;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAoBA,MAAa,uBAAuB;AAKpC,MAAM,UAAsE;CAC1E,SAASA;CACT,SAASC;CACT,SAASC;CACT,SAASC;CACT,SAASC;CACT,SAASC;CACT,SAASC;CACT,SAASC;CACT,SAASC;CACT,SAASC;CACT,SAASC;CACT,SAASC;CACV;AAWD,MAAM,kBAA+B;CACnC,WARgB,OAAO,YACvB,kBAAkB,KAAK,WAAW,CAChC,QACA,GAAG,uBAAuB,QAAQ,SAAS,CAC5C,CAAC,CACH;CAIC,KAAK;CACL,aAAa;CAGb,MAAM;CACN,WAAW;CACX,IAAI,CAAC,qBAAqB;CAC1B,eAAe,EAAE,aAAa,OAAO;CACrC,YAAY;CACZ,mBAAmB;CAInB,WAAW;CACX,OAAO,EAAE,aAAa,OAAO;CAK7B,gBAAgB;CACjB;;;;;;;;AASD,SAAgB,gBAAgB,SAAS,SAAuB;CAC9D,MAAM,mBAAmB,QAAQ,gBAAgB;AAEjD,CAAK,iBAAiB,KAAK;EACzB,GAAG;EACH,KAAK;EACN,CAAC;AAEF,QAAO;;;;;;;AAQT,MAAM,WAAyB,QAAQ,gBAAgB;AAElD,SAAS,IAAI,iBAAiB,CAAC,KAAK,gBAAgB;;AAGzD,SAAgB,UAAwB;AACtC,QAAO"}

package/dist/i18n/locales/de-DE/uikit.js

@@ -0,0 +1,112 @@
+/** @license MIT | @cube-dev/ui-kit v0.146.0 | Cube Dev Team */
+//#region src/i18n/locales/de-DE/uikit.json
+var uikit_default = {
+	alertDialog: {
+		"confirm": "OK",
+		"cancel": "Abbrechen"
+	},
+	dialog: { "dismiss": "Schließen" },
+	dialogForm: {
+		"submit": "Absenden",
+		"cancel": "Abbrechen"
+	},
+	form: {
+		"required": "(erforderlich)",
+		"optional": "(optional)",
+		"internalError": "Interner Fehler"
+	},
+	notifications: {
+		"dismiss": "Schließen",
+		"ariaLabel": "Benachrichtigungen",
+		"empty": "Keine Benachrichtigungen"
+	},
+	relativeTime: {
+		"justNow": "gerade eben",
+		"minAgo": "vor {{count}} Min.",
+		"hoursAgo": "vor {{count}} Std.",
+		"daysAgo": "vor {{count}} T.",
+		"weeksAgo": "vor {{count}} Wo.",
+		"monthsAgo": "vor {{count}} Mon.",
+		"yearsAgo": "vor {{count}} J."
+	},
+	toast: { "hide": "Ausblenden" },
+	listBox: {
+		"selectAll": "Alle auswählen",
+		"noItems": "Keine Einträge"
+	},
+	filterListBox: {
+		"searchPlaceholder": "Suchen...",
+		"noResults": "Keine Ergebnisse gefunden",
+		"noItems": "Keine Einträge",
+		"customValue": "Benutzerdefinierter Wert",
+		"filteredItems": "Gefilterte Einträge"
+	},
+	picker: {
+		"all": "Alle",
+		"pickerAriaLabel": "Auswahl"
+	},
+	comboBox: {
+		"clearValue": "Wert löschen",
+		"showOptions": "Optionen anzeigen"
+	},
+	commandMenu: {
+		"searchPlaceholder": "Befehle suchen...",
+		"empty": "Keine Befehle gefunden"
+	},
+	listBoxPopover: { "options": "Optionen" },
+	datePicker: {
+		"time": "Uhrzeit",
+		"startTime": "Startzeit",
+		"endTime": "Endzeit",
+		"showEndCalendar": "Kalender für das Enddatum anzeigen"
+	},
+	fileInput: {
+		"chooseFile": "Datei auswählen",
+		"noFileSelected": "Keine Datei ausgewählt"
+	},
+	passwordInput: { "toggleMasking": "Maskierung umschalten" },
+	numberInput: {
+		"stepUp": "Erhöhen",
+		"stepDown": "Verringern"
+	},
+	textInputMapper: {
+		"key": "Schlüssel",
+		"value": "Wert",
+		"removeMapping": "Zuordnung entfernen"
+	},
+	copySnippet: {
+		"title": "Codebeispiel",
+		"copyToClipboard": "{{title}} in die Zwischenablage kopieren",
+		"showHiddenParts": "Ausgeblendete Teile anzeigen",
+		"copied": "{{title}} kopiert"
+	},
+	copyPasteBlock: {
+		"copyToClipboard": "{{title}} in die Zwischenablage kopieren",
+		"selectAndPaste": "Auswählen und einfügen",
+		"invalidData": "Ungültige Daten",
+		"copied": "{{title}} kopiert",
+		"defaultTitle": "Text"
+	},
+	tag: { "close": "Schließen" },
+	placeholder: { "contentIsLoading": "Inhalt wird geladen" },
+	loadingAnimation: { "ariaLabel": "Ladeanimation" },
+	layout: {
+		"closePanel": "Panel schließen",
+		"goBack": "Zurück"
+	},
+	tree: { "actions": "Aktionen" },
+	banner: { "hideBanner": "Banner ausblenden" },
+	tabs: {
+		"close": "Schließen",
+		"editTabTitle": "Tab-Titel bearbeiten",
+		"selectTab": "Tab auswählen"
+	},
+	contextMenu: {
+		"openContextMenu": "Kontextmenü öffnen",
+		"contextMenu": "context-menu"
+	}
+};
+
+//#endregion
+export { uikit_default as default };
+//# sourceMappingURL=uikit.js.map

package/dist/i18n/locales/de-DE/uikit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uikit.js","names":[],"sources":["../../../../src/i18n/locales/de-DE/uikit.json"],"sourcesContent":[""],"mappings":""}

package/dist/i18n/locales/en-US/uikit.js

@@ -0,0 +1,112 @@
+/** @license MIT | @cube-dev/ui-kit v0.146.0 | Cube Dev Team */
+//#region src/i18n/locales/en-US/uikit.json
+var uikit_default = {
+	alertDialog: {
+		"confirm": "Ok",
+		"cancel": "Cancel"
+	},
+	dialog: { "dismiss": "Dismiss" },
+	dialogForm: {
+		"submit": "Submit",
+		"cancel": "Cancel"
+	},
+	form: {
+		"required": "(required)",
+		"optional": "(optional)",
+		"internalError": "Internal error"
+	},
+	notifications: {
+		"dismiss": "Dismiss",
+		"ariaLabel": "Notifications",
+		"empty": "No notifications"
+	},
+	relativeTime: {
+		"justNow": "just now",
+		"minAgo": "{{count}} min ago",
+		"hoursAgo": "{{count}} h ago",
+		"daysAgo": "{{count}} d ago",
+		"weeksAgo": "{{count}} w ago",
+		"monthsAgo": "{{count}} mo ago",
+		"yearsAgo": "{{count}} y ago"
+	},
+	toast: { "hide": "Hide" },
+	listBox: {
+		"selectAll": "Select All",
+		"noItems": "No items"
+	},
+	filterListBox: {
+		"searchPlaceholder": "Search...",
+		"noResults": "No results found",
+		"noItems": "No items",
+		"customValue": "Custom value",
+		"filteredItems": "Filtered items"
+	},
+	picker: {
+		"all": "All",
+		"pickerAriaLabel": "Picker"
+	},
+	comboBox: {
+		"clearValue": "Clear value",
+		"showOptions": "Show options"
+	},
+	commandMenu: {
+		"searchPlaceholder": "Search commands...",
+		"empty": "No commands found"
+	},
+	listBoxPopover: { "options": "Options" },
+	datePicker: {
+		"time": "Time",
+		"startTime": "Start time",
+		"endTime": "End time",
+		"showEndCalendar": "Show calendar for the end date"
+	},
+	fileInput: {
+		"chooseFile": "Choose file",
+		"noFileSelected": "No file selected"
+	},
+	passwordInput: { "toggleMasking": "Toggle masking" },
+	numberInput: {
+		"stepUp": "Step up",
+		"stepDown": "Step down"
+	},
+	textInputMapper: {
+		"key": "Key",
+		"value": "Value",
+		"removeMapping": "Remove mapping"
+	},
+	copySnippet: {
+		"title": "Code example",
+		"copyToClipboard": "Copy {{title}} to clipboard",
+		"showHiddenParts": "Show hidden parts",
+		"copied": "{{title}} copied"
+	},
+	copyPasteBlock: {
+		"copyToClipboard": "Copy {{title}} to clipboard",
+		"selectAndPaste": "Select and paste",
+		"invalidData": "Invalid data",
+		"copied": "{{title}} copied",
+		"defaultTitle": "Text"
+	},
+	tag: { "close": "Close" },
+	placeholder: { "contentIsLoading": "Content is loading" },
+	loadingAnimation: { "ariaLabel": "Loading animation" },
+	layout: {
+		"closePanel": "Close panel",
+		"goBack": "Go back"
+	},
+	tree: { "actions": "Actions" },
+	banner: { "hideBanner": "Hide banner" },
+	tabs: {
+		"close": "Close",
+		"editTabTitle": "Edit tab title",
+		"selectTab": "Select tab"
+	},
+	contextMenu: {
+		"openContextMenu": "Open context menu",
+		"contextMenu": "context-menu"
+	}
+};
+
+//#endregion
+export { uikit_default as default };
+//# sourceMappingURL=uikit.js.map

package/dist/i18n/locales/en-US/uikit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uikit.js","names":[],"sources":["../../../../src/i18n/locales/en-US/uikit.json"],"sourcesContent":[""],"mappings":""}