@omnitron-dev/prism 0.1.3 → 0.3.0

package/dist/utils/format-date.d.ts

@@ -0,0 +1,240 @@
+/**
+ * Date Formatting Utilities
+ *
+ * Locale-aware date formatting utilities using Intl.DateTimeFormat.
+ * For more complex formatting, consider using dayjs or date-fns.
+ *
+ * @module utils/format-date
+ */
+export type DateInput = Date | string | number | null | undefined;
+export interface FormatDateOptions extends Intl.DateTimeFormatOptions {
+    /** Locale for formatting (default: 'en-US') */
+    locale?: string;
+}
+/**
+ * Format a date with locale-aware formatting.
+ *
+ * @example
+ * ```ts
+ * fDate(new Date())
+ * // => "Jan 15, 2025"
+ *
+ * fDate(new Date(), { locale: 'ru-RU' })
+ * // => "15 янв. 2025 г."
+ *
+ * fDate('2025-01-15')
+ * // => "Jan 15, 2025"
+ * ```
+ */
+export declare function fDate(date: DateInput, options?: FormatDateOptions): string;
+/**
+ * Format a date with time.
+ *
+ * @example
+ * ```ts
+ * fDateTime(new Date())
+ * // => "Jan 15, 2025, 2:30 PM"
+ *
+ * fDateTime(new Date(), { hour12: false })
+ * // => "Jan 15, 2025, 14:30"
+ * ```
+ */
+export declare function fDateTime(date: DateInput, options?: FormatDateOptions): string;
+/**
+ * Format time only.
+ *
+ * @example
+ * ```ts
+ * fTime(new Date())
+ * // => "2:30 PM"
+ *
+ * fTime(new Date(), { hour12: false })
+ * // => "14:30"
+ *
+ * fTime(new Date(), { second: 'numeric' })
+ * // => "2:30:45 PM"
+ * ```
+ */
+export declare function fTime(date: DateInput, options?: FormatDateOptions): string;
+/**
+ * Format a date as ISO string (YYYY-MM-DD).
+ *
+ * @example
+ * ```ts
+ * fDateISO(new Date())
+ * // => "2025-01-15"
+ * ```
+ */
+export declare function fDateISO(date: DateInput): string;
+/**
+ * Format a timestamp as relative time (e.g., "2 hours ago").
+ *
+ * @example
+ * ```ts
+ * fRelativeTime(new Date(Date.now() - 3600000))
+ * // => "1 hour ago"
+ *
+ * fRelativeTime(new Date(Date.now() + 86400000))
+ * // => "in 1 day"
+ *
+ * fRelativeTime(new Date(Date.now() - 86400000 * 7))
+ * // => "1 week ago"
+ * ```
+ */
+export declare function fRelativeTime(date: DateInput, options?: {
+    locale?: string;
+}): string;
+/**
+ * Format a duration in milliseconds to human-readable string.
+ *
+ * @example
+ * ```ts
+ * fDuration(3661000)
+ * // => "1h 1m 1s"
+ *
+ * fDuration(90000)
+ * // => "1m 30s"
+ *
+ * fDuration(1000)
+ * // => "1s"
+ * ```
+ */
+export declare function fDuration(ms: number | null | undefined): string;
+/**
+ * Check if a date is today.
+ *
+ * @example
+ * ```ts
+ * isToday(new Date())
+ * // => true
+ *
+ * isToday(new Date('2020-01-01'))
+ * // => false
+ * ```
+ */
+export declare function isToday(date: DateInput): boolean;
+/**
+ * Check if a date is yesterday.
+ */
+export declare function isYesterday(date: DateInput): boolean;
+/**
+ * Check if a date is within the current week.
+ */
+export declare function isThisWeek(date: DateInput): boolean;
+/**
+ * Check if a date is in the past.
+ */
+export declare function isPast(date: DateInput): boolean;
+/**
+ * Check if a date is in the future.
+ */
+export declare function isFuture(date: DateInput): boolean;
+/**
+ * Get the difference between two dates in days.
+ */
+export declare function diffInDays(date1: DateInput, date2: DateInput): number;
+/**
+ * Generate an array of dates between start and end.
+ *
+ * @param startDate - Start date
+ * @param endDate - End date
+ * @param interval - Interval in milliseconds (default: 1 day)
+ * @returns Array of Date objects
+ *
+ * @example
+ * ```ts
+ * const dates = getDates(
+ *   new Date('2025-01-01'),
+ *   new Date('2025-01-07')
+ * );
+ * // => [Date(Jan 1), Date(Jan 2), ..., Date(Jan 7)]
+ *
+ * // With custom interval (every 2 days)
+ * const dates = getDates(
+ *   new Date('2025-01-01'),
+ *   new Date('2025-01-07'),
+ *   DAY_MS * 2
+ * );
+ * // => [Date(Jan 1), Date(Jan 3), Date(Jan 5), Date(Jan 7)]
+ * ```
+ */
+export declare function getDates(startDate: DateInput, endDate: DateInput, interval?: number): Date[];
+/**
+ * Duration preset for getPastDates.
+ */
+export type DateDurationPreset = 'week' | 'month' | 'quarter' | 'year';
+/**
+ * Get an array of dates for past duration.
+ *
+ * @param duration - Duration preset or number of days
+ * @returns Array of Date objects from past to present
+ *
+ * @example
+ * ```ts
+ * // Last 7 days
+ * const weekDates = getPastDates('week');
+ *
+ * // Last 30 days
+ * const monthDates = getPastDates('month');
+ *
+ * // Last 90 days
+ * const quarterDates = getPastDates('quarter');
+ *
+ * // Last 365 days
+ * const yearDates = getPastDates('year');
+ *
+ * // Custom: last 14 days
+ * const customDates = getPastDates(14);
+ * ```
+ */
+export declare function getPastDates(duration: DateDurationPreset | number): Date[];
+/**
+ * Get an array of dates for future duration.
+ *
+ * @param duration - Duration preset or number of days
+ * @returns Array of Date objects from present to future
+ *
+ * @example
+ * ```ts
+ * // Next 7 days
+ * const weekDates = getFutureDates('week');
+ *
+ * // Next 30 days
+ * const monthDates = getFutureDates('month');
+ *
+ * // Custom: next 14 days
+ * const customDates = getFutureDates(14);
+ * ```
+ */
+export declare function getFutureDates(duration: DateDurationPreset | number): Date[];
+/**
+ * Get start of day (midnight) for a date.
+ *
+ * @param date - Input date
+ * @returns Date set to 00:00:00.000
+ */
+export declare function startOfDay(date: DateInput): Date | null;
+/**
+ * Get end of day (23:59:59.999) for a date.
+ *
+ * @param date - Input date
+ * @returns Date set to 23:59:59.999
+ */
+export declare function endOfDay(date: DateInput): Date | null;
+/**
+ * Add days to a date.
+ *
+ * @param date - Input date
+ * @param days - Number of days to add (can be negative)
+ * @returns New date with days added
+ */
+export declare function addDays(date: DateInput, days: number): Date | null;
+/**
+ * Add months to a date.
+ *
+ * @param date - Input date
+ * @param months - Number of months to add (can be negative)
+ * @returns New date with months added
+ */
+export declare function addMonths(date: DateInput, months: number): Date | null;
+//# sourceMappingURL=format-date.d.ts.map

package/dist/utils/format-date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-date.d.ts","sourceRoot":"","sources":["../../src/utils/format-date.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAElE,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,qBAAqB;IACnE,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0BD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAY9E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAclF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAW9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAKhD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAqCxF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAgB/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAUhD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAYpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAcnD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAK/C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAKjD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAQrE;AASD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,GAAE,MAAe,GAAG,IAAI,EAAE,CAUpG;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,EAAE,CAc1E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,EAAE,CAc5E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAOvD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAOrD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAOlE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAOtE"}

package/dist/utils/format-number.d.ts

@@ -0,0 +1,245 @@
+/**
+ * Number Formatting Utilities
+ *
+ * Locale-aware number formatting utilities.
+ *
+ * @module utils/format-number
+ */
+export interface FormatNumberOptions extends Intl.NumberFormatOptions {
+    /** Locale for formatting (default: 'en-US') */
+    locale?: string;
+}
+export interface FormatCurrencyOptions extends FormatNumberOptions {
+    /** Currency code (default: 'USD') */
+    currency?: string;
+}
+/**
+ * Format a number with locale-aware formatting.
+ *
+ * @example
+ * ```ts
+ * fNumber(1234567.89)
+ * // => "1,234,567.89"
+ *
+ * fNumber(1234567.89, { locale: 'de-DE' })
+ * // => "1.234.567,89"
+ *
+ * fNumber(0.1234, { style: 'percent' })
+ * // => "12%"
+ * ```
+ */
+export declare function fNumber(value: number | string | null | undefined, options?: FormatNumberOptions): string;
+/**
+ * Format a number as currency.
+ *
+ * @example
+ * ```ts
+ * fCurrency(1234.56)
+ * // => "$1,234.56"
+ *
+ * fCurrency(1234.56, { currency: 'EUR', locale: 'de-DE' })
+ * // => "1.234,56 €"
+ *
+ * fCurrency(1234.56, { currency: 'JPY' })
+ * // => "¥1,235" (JPY has no decimal places)
+ * ```
+ */
+export declare function fCurrency(value: number | string | null | undefined, options?: FormatCurrencyOptions): string;
+/**
+ * Format a number as a percentage.
+ *
+ * @example
+ * ```ts
+ * fPercent(0.1234)
+ * // => "12.34%"
+ *
+ * fPercent(0.1234, { maximumFractionDigits: 0 })
+ * // => "12%"
+ *
+ * fPercent(1.5)
+ * // => "150%"
+ * ```
+ */
+export declare function fPercent(value: number | string | null | undefined, options?: FormatNumberOptions): string;
+/**
+ * Shorten a large number with K, M, B suffixes.
+ *
+ * @example
+ * ```ts
+ * fShortenNumber(1234)
+ * // => "1.23K"
+ *
+ * fShortenNumber(1234567)
+ * // => "1.23M"
+ *
+ * fShortenNumber(1234567890)
+ * // => "1.23B"
+ *
+ * fShortenNumber(1234567890000)
+ * // => "1.23T"
+ * ```
+ */
+export declare function fShortenNumber(value: number | string | null | undefined, decimals?: number): string;
+/**
+ * Format bytes to human-readable size.
+ *
+ * @example
+ * ```ts
+ * fBytes(1024)
+ * // => "1 KB"
+ *
+ * fBytes(1048576)
+ * // => "1 MB"
+ *
+ * fBytes(1073741824)
+ * // => "1 GB"
+ * ```
+ */
+export declare function fBytes(bytes: number | string | null | undefined, decimals?: number): string;
+/**
+ * Format number with ordinal suffix (1st, 2nd, 3rd, etc.)
+ *
+ * @example
+ * ```ts
+ * fOrdinal(1)
+ * // => "1st"
+ *
+ * fOrdinal(22)
+ * // => "22nd"
+ *
+ * fOrdinal(33)
+ * // => "33rd"
+ *
+ * fOrdinal(44)
+ * // => "44th"
+ * ```
+ */
+export declare function fOrdinal(value: number | null | undefined): string;
+/**
+ * Format a number with decimal places.
+ *
+ * @example
+ * ```ts
+ * fDecimal(1234.5678)
+ * // => "1234.57"
+ *
+ * fDecimal(1234.5678, 4)
+ * // => "1234.5678"
+ *
+ * fDecimal(1234)
+ * // => "1234.00"
+ * ```
+ */
+export declare function fDecimal(value: number | string | null | undefined, decimals?: number): string;
+/**
+ * Calculate percentage of a value relative to a total.
+ *
+ * @param value - The part value
+ * @param total - The total value
+ * @param decimals - Decimal places (default: 0)
+ * @returns Percentage number (0-100)
+ *
+ * @example
+ * ```ts
+ * getPercentage(25, 100)
+ * // => 25
+ *
+ * getPercentage(1, 3)
+ * // => 33
+ *
+ * getPercentage(1, 3, 2)
+ * // => 33.33
+ *
+ * getPercentage(50, 200)
+ * // => 25
+ * ```
+ */
+export declare function getPercentage(value: number, total: number, decimals?: number): number;
+/**
+ * Calculate percentage change between two values.
+ *
+ * @param current - Current value
+ * @param previous - Previous value
+ * @param decimals - Decimal places (default: 0)
+ * @returns Percentage change (positive = increase, negative = decrease)
+ *
+ * @example
+ * ```ts
+ * calculatePercentageChange(150, 100)
+ * // => 50 (50% increase)
+ *
+ * calculatePercentageChange(50, 100)
+ * // => -50 (50% decrease)
+ *
+ * calculatePercentageChange(100, 100)
+ * // => 0 (no change)
+ *
+ * calculatePercentageChange(120, 100, 1)
+ * // => 20.0
+ * ```
+ */
+export declare function calculatePercentageChange(current: number, previous: number, decimals?: number): number;
+/**
+ * Get currency symbol for a currency code.
+ *
+ * @param currencyCode - ISO 4217 currency code (e.g., 'USD', 'EUR')
+ * @param locale - Locale for formatting (default: 'en-US')
+ * @returns Currency symbol (e.g., '$', '€', '¥')
+ *
+ * @example
+ * ```ts
+ * getCurrencySymbol('USD')
+ * // => "$"
+ *
+ * getCurrencySymbol('EUR')
+ * // => "€"
+ *
+ * getCurrencySymbol('JPY')
+ * // => "¥"
+ *
+ * getCurrencySymbol('GBP')
+ * // => "£"
+ * ```
+ */
+export declare function getCurrencySymbol(currencyCode: string, locale?: string): string;
+/**
+ * Format a number with +/- sign prefix.
+ *
+ * @param value - Number to format
+ * @param options - Formatting options
+ * @returns Formatted string with sign
+ *
+ * @example
+ * ```ts
+ * fNumberWithSign(25)
+ * // => "+25"
+ *
+ * fNumberWithSign(-25)
+ * // => "-25"
+ *
+ * fNumberWithSign(0)
+ * // => "0"
+ *
+ * fNumberWithSign(25.5, { maximumFractionDigits: 1 })
+ * // => "+25.5"
+ * ```
+ */
+export declare function fNumberWithSign(value: number | string | null | undefined, options?: FormatNumberOptions): string;
+/**
+ * Format a number as compact notation (1K, 1M, 1B).
+ * Uses Intl.NumberFormat with compact notation.
+ *
+ * @example
+ * ```ts
+ * fCompact(1234)
+ * // => "1.2K"
+ *
+ * fCompact(1234567)
+ * // => "1.2M"
+ *
+ * fCompact(1234567890)
+ * // => "1.2B"
+ * ```
+ */
+export declare function fCompact(value: number | string | null | undefined, options?: FormatNumberOptions): string;
+//# sourceMappingURL=format-number.d.ts.map

package/dist/utils/format-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-number.d.ts","sourceRoot":"","sources":["../../src/utils/format-number.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,mBAAmB;IACnE,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAc5G;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAkBhH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAmB7G;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CA2BtG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAgB9F;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAYjE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAYhG;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAIxF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAIzG;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,GAAE,MAAgB,GAAG,MAAM,CASxF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAepH;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAmB7G"}

package/dist/utils/i18n-text.d.ts

@@ -0,0 +1,68 @@
+/**
+ * i18n-text — generic locale resolution for bilingual / multilingual
+ * JSONB payloads stored on backend DTOs.
+ *
+ * Design goals:
+ *
+ *  - Zero hard-coded locale strings. Caller passes the viewer locale
+ *    and (optionally) a fallback order; the helper does the rest.
+ *    Adding a new locale to the platform is just config, not a code
+ *    edit in every consumer.
+ *  - Locale-agnostic API so it can serve marketplace categories,
+ *    achievement titles, payments coin names, future post translations
+ *    — anywhere a `{ [lang]: string }` bag is stored.
+ *  - O(1) in the happy path (direct map access) with a deterministic
+ *    fallback walk.
+ *
+ * @module utils/i18n-text
+ */
+/** A bag of language-keyed strings. Keys are RFC 5646 language codes
+ * (or just `'en'`, `'ru'` for simple two-locale platforms). */
+export type I18nText = Record<string, string | undefined>;
+/** Object shape that carries both a localised bag and a legacy
+ * scalar field as final fallback — the canonical wire format for
+ * categories, achievements etc. */
+export interface I18nResolvable {
+    /** Bilingual / multilingual bag. */
+    nameI18n?: I18nText | null;
+    /** Last-resort legacy fallback. The backend keeps this populated
+     * even after migrating to JSONB so single-locale consumers keep
+     * working without an immediate refactor. */
+    name?: string | null;
+}
+/**
+ * Resolve a `{ nameI18n, name }` object to the viewer-preferred
+ * locale, walking through optional fallbacks before bottoming out
+ * on the legacy scalar.
+ *
+ * @example
+ * ```ts
+ * const label = resolveI18n(category, 'ru', ['en']);
+ * // → category.nameI18n.ru
+ * //   ?? category.nameI18n.en
+ * //   ?? category.name
+ * //   ?? ''
+ * ```
+ *
+ * @param obj      The resolvable record (e.g. a category DTO).
+ * @param lang     Viewer's preferred language code.
+ * @param fallback Ordered list of secondary languages to try before
+ *                 the legacy scalar. Defaults to `['en']`.
+ * @param field    Override the I18nText key (defaults to `nameI18n`)
+ *                 + the legacy scalar key (defaults to `name`).
+ *                 Useful for `descriptionI18n` / `description`.
+ */
+export declare function resolveI18n(obj: object | null | undefined, lang: string, fallback?: readonly string[], field?: {
+    bag?: string;
+    scalar?: string;
+}): string;
+/**
+ * Build a stable searchable haystack from an i18n object — all
+ * known translations concatenated lower-case so a single `.includes`
+ * check matches against any locale.
+ *
+ * Useful inside `Autocomplete.filterOptions` to make EN-only users
+ * find RU-only entries.
+ */
+export declare function i18nHaystack(bag: object | null | undefined, extra?: readonly string[]): string;
+//# sourceMappingURL=i18n-text.d.ts.map

package/dist/utils/i18n-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-text.d.ts","sourceRoot":"","sources":["../../src/utils/i18n-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;+DAC+D;AAC/D,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE1D;;mCAEmC;AACnC,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B;;gDAE4C;IAC5C,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,SAAS,MAAM,EAAW,EACpC,KAAK,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5C,MAAM,CAoBR;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,KAAK,GAAE,SAAS,MAAM,EAAO,GAC5B,MAAM,CAKR"}

package/dist/utils/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Prism Utilities
+ *
+ * Common utility functions for formatting, string manipulation,
+ * class name handling, refs, URLs, and number input handling.
+ *
+ * @module utils
+ */
+export { cn, mergeClasses, type ClassValue, type StateProps } from './cn.js';
+export { createClasses, createClassesObject, createComponentClasses, setClassPrefix, getClassPrefix, DEFAULT_CLASS_PREFIX, } from './create-classes.js';
+export { mergeRefs, setRef, hasRefValue, type MergeableRef } from './refs.js';
+export { fNumber, fCurrency, fPercent, fShortenNumber, fBytes, fOrdinal, fDecimal, fNumberWithSign, fCompact, getPercentage, calculatePercentageChange, getCurrencySymbol, type FormatNumberOptions, type FormatCurrencyOptions, } from './format-number.js';
+export { parseNumber, clampNumber, roundToDecimals, transformOnChange, transformOnBlur, transformForDisplay, createNumberInputHandlers, type TransformNumberOptions, } from './transform-number.js';
+export { fDate, fDateTime, fTime, fDateISO, fRelativeTime, fDuration, isToday, isYesterday, isThisWeek, isPast, isFuture, diffInDays, getDates, getPastDates, getFutureDates, startOfDay, endOfDay, addDays, addMonths, type DateInput, type FormatDateOptions, type DateDurationPreset, } from './format-date.js';
+export { truncate, getInitials, capitalize, titleCase, kebabCase, camelCase, snakeCase, highlightText, escapeRegExp, containsIgnoreCase, isBlank, isEmail, isUrl, randomString, uuid, slugify, } from './string.js';
+export { safeReturnUrl, isActiveLink, isExternalUrl, isExternalLink, isEqualPath, buildUrl, parseQueryParams, getQueryParam, hasParams, removeParams, removeLastSlash, type SafeReturnUrlOptions, } from './url.js';
+export { getCookie, setCookie, removeCookie, cookiesAvailable, type CookieOptions } from './cookies.js';
+export { localStorageAvailable, sessionStorageAvailable, getStorage, setStorage, removeStorage, clearStorage, getStorageKeys, getStorageSize, setStorageWithExpiry, getStorageWithExpiry, type StorageOptions, type StorageWithExpiryOptions, } from './storage.js';
+export { setFont, remToPx, pxToRem, responsiveFontSize } from './font.js';
+export { hasKeys, omit, pick, deepClone, isEmpty } from './object.js';
+export { noRtlFlip, isRtlDirection, getDirectionalProperty } from './rtl.js';
+export { AsyncLock, AsyncLockTimeoutError, createAsyncLock, createTokenRefreshLock, withLock, locked, type AsyncLockOptions, type AsyncLockResult, type AsyncLockState, } from './async-lock.js';
+export { classifyHttpError, isNetworkError, isRetryableError, getErrorSeverity, createErrorTranslator, DEFAULT_ERROR_MESSAGES, extractErrorContext, withRetry, isChunkLoadError, isSessionExpiredError, createErrorRecoveryHandler, type ErrorCode, type ErrorSeverity, type ErrorContext, type TranslatedError, type TranslateFn, type ErrorMessages, type RetryConfig, } from './errors.js';
+export { createFetchClient, createTokenRefreshInterceptor, createJsonApiClient, type FetchRequestInit, type RequestContext, type ResponseContext, type ErrorContext as FetchErrorContext, type RequestInterceptor, type ResponseInterceptor, type ErrorInterceptor, type FetchInterceptorConfig, type TokenRefreshConfig, type FetchClient, } from './fetch-interceptor.js';
+export { jwtDecode, jwtDecodePayload, isTokenExpired, isValidToken, getTokenTimeLeft, getTokenExpirationDate, getTokenClaim, getTokenSubject, tokenHasRole, tokenHasPermission, type JwtStandardClaims, type JwtPayload, type JwtValidationOptions, type JwtDecodeResult, } from './jwt.js';
+export { resolveTemplateVariables } from './template-resolver.js';
+export { resolveI18n, i18nHaystack, type I18nText, type I18nResolvable, } from './i18n-text.js';
+export { toast } from './toast.js';
+export { formatCoinAmount, formatCoinAmountList, getCoinDecimals, getCoinWireDecimals, COIN_DISPLAY_DECIMALS, COIN_WIRE_DECIMALS, type FormatCoinAmountOptions, type DecimalRounding, formatDecimalString, sumDecimalStrings, subtractDecimalStrings, toScaledInteger, fromScaledInteger, } from './format-crypto.js';
+//# sourceMappingURL=index.d.ts.map

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

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