@omnitron-dev/prism 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -1,2759 +1,20 @@
-export { ActionColors, BackgroundColors, BuildPaletteOptions, COLOR_GROUPS, CreatePrismThemeOptions, PRESET_DISPLAY_NAMES, PRESET_INHERENT_MODE, PRESET_NAMES, SupportedLocale, TextColors, applyPrimaryOverride, arcticPreset, baseColors, basic, blue, buildAction, buildBackground, buildChartColors, buildPalette, buildPaletteColor, buildText, buildVibrant, componentOverrides, createButtonBaseOverrides, createButtonGroupOverrides, createButtonOverrides, createPaletteColorFromScale, createPrismTheme, createShadows, createTypography, cssVarRgba, cssVariables, customScrollbarMixin, darkShadow, darken, defaultDarkPalette, defaultLightPalette, defaultPreset, focusRingMixin, generateColorScale, generateColorScaleWithChannels, generateCssVariables, generatePaletteChannel, generatePaletteColorWithChannels, getContrastRatio, getContrastText, getLuminance, getPreset, getPresetDisplayName, glassMixin, green, grey, hexToHsl, hexToRgb, hexToRgbChannel, hideScrollbarMixin, hslToHex, invertColorScale, isLightColor, lightBlue, lighten, luxuryColors, luxuryError, luxuryInfo, luxuryNeutral, luxuryPreset, luxuryPrimary, luxurySecondary, luxurySuccess, luxuryWarning, mix, mixins, multiLineEllipsisMixin, orange, presetNames, purple, red, rgbToHex, rgba, shadows, textEllipsisMixin, typography } from './theme/index.js';
-export { A as ActionPalette, B as BackgroundPalette, C as ChartPalette, a as ColorGroup, b as ColorScale, c as ColorScaleWithChannels, d as ColorShadeKey, e as CommonColors, f as ComponentDensity, g as ComponentsConfig, h as CssVariablesConfig, G as GreyScale, P as PaletteColor, i as PaletteColorWithChannels, j as PresetPalette, k as PrismTheme, S as SimplePaletteColor, T as TextPalette, l as ThemeConfig, m as ThemeContextValue, n as ThemeDirection, o as ThemeMode, p as ThemePalette, q as ThemePreset, r as ThemePresetDefinition, s as ThemeTypography, V as VibrantPalette } from './theme-B4Q3Bg5o.js';
-export { ARIA_LABELS, AriaExpandedProps, PrismContext, PrismProvider, PrismProviderProps, ProviderConfig, ProviderEntry, ProviderStack, ProviderStackOptions, ProviderStackProps, SimpleProvider, SkipLink, SkipLinkProps, announceToScreenReader, combineAriaDescribedBy, composeProviders, conditionalProvider, createProviderStack, filterProviders, focusVisibleStyles, generateAriaId, getAriaExpanded, handleListKeyDown, srOnly, usePrismContext, withProviderProps } from './core/index.js';
-export { C as CopyState, a as CountdownControls, b as CountdownState, S as SetState, U as UseCopyToClipboardOptions, c as UseCopyToClipboardReturn, d as UseCountdownOptions, e as UseCountdownReturn, f as UseMountedReturn, g as UseMultiSelectOptions, h as UseMultiSelectReturn, i as UseSetStateReturn, j as UseTimeoutReturn, u as useBoolean, k as useBreakpoints, l as useClickOutside, m as useCopyToClipboard, n as useCountdown, o as useDebounce, p as useDebounceCallback, q as useEventListener, r as useInterval, s as useIsClient, t as useLocalStorage, v as useMounted, w as useMultiSelect, x as usePrevious, y as useSetState, z as useTimeout } from './use-timeout-D7U3EAtH.js';
-export { useMediaQuery } from '@mui/material';
-export { Accordion, AccordionItem, AccordionProps, AdminDataTable, AdminDataTableProps, Alert, AlertProps, AlertSeverity, AlertVariant, AmountCell, AmountCellProps, AnimateBorder, AnimateBorderProps, AspectRatio, AutocompleteOption, Avatar, AvatarProps, AvatarShape, AvatarSize, Badge, BadgeColor, BadgeProps, BadgeSize, BadgeVariant, BooleanLabel, BreadcrumbLinkProps, Breadcrumbs, BreadcrumbsProps, BreadcrumbsSlotProps, BreadcrumbsSlots, Card, CardGrid, CardGridProps, CardProps, CardSection, CardSectionProps, CardSkeleton, CardSkeletonProps, CardVariant, Carousel, CarouselArrowProps, CarouselBreakpoint, CarouselDotsProps, CarouselProps, CarouselSlideType, ChangelogEntry, ChangelogTimeline, Chart, ChartLegends, ChartLegendsProps, ChartLoading, ChartLoadingProps, ChartOptions, ChartProps, ChartSeries, ChartType, CircularProgress, CircularProgressProps, ColumnDef, CommandAction, CommandPalette, CommandPaletteProps, ConfirmDialog, ConfirmDialogProps, ContentRenderer, ContentRendererProps, ContentRoot, ContentValue, ContextMenu, ContextMenuProps, CountBadge, CountBadgeProps, CountdownRing, CountdownRingProps, Country, CountryData, CountryOption, CountrySelect, CountrySelectProps, CustomAvatarGroup, CustomAvatarGroupProps, DateRangeInput, DateRangeInputProps, DateRangePicker, DateRangePickerProps, DateRangeValue, DeleteDialog, DeleteDialogProps, DocHeading, DocLayout, DocSectionNav, DocSidebar, DocSidebarItem, Drawer, DrawerAnchor, DrawerProps, DurationPicker, DurationPickerLabels, DurationPickerProps, EditorRenderProps, EditorToolbarConfig, EmptyContent, EmptyContentProps, ErrorBoundary, ErrorBoundaryProps, FallbackProps, Field, FieldAutocomplete, FieldAutocompleteProps, FieldCheckbox, FieldCheckboxProps, FieldCode, FieldCodeProps, FieldCountrySelect, FieldCountrySelectProps, FieldCustomEditor, FieldCustomEditorProps, FieldDatePicker, FieldDatePickerProps, FieldDateTimePicker, FieldDateTimePickerProps, FieldEditor, FieldEditorProps, FieldMultiCheckbox, FieldMultiCheckboxProps, FieldMultiSelect, FieldMultiSelectProps, FieldMultiSwitch, FieldMultiSwitchProps, FieldNumber, FieldNumberProps, FieldPhone, FieldPhoneProps, FieldRadio, FieldRadioProps, FieldRating, FieldRatingProps, FieldSelect, FieldSelectProps, FieldSlider, FieldSliderProps, FieldSwitch, FieldSwitchProps, FieldText, FieldTextProps, FieldTimePicker, FieldTimePickerProps, FieldUpload, FieldUploadAvatar, FieldUploadAvatarProps, FieldUploadBox, FieldUploadBoxProps, FieldUploadProps, FileValue, FilterConfig, FilterOption, FilterToolbar, FilterToolbarProps, FilterType, FilterValues, FlagIcon, FlagIconProps, FlagShape, FormAlert, FormAlertProps, IconProps, Image, ImageProps, ImageWithDefault, InlineAlert, InlineAlertProps, Label, LabelColor, LabelProps, LabelVariant, Lightbox, LightboxProps, LightboxSlide, LightboxThumbnailsProps, LightboxToolbarProps, LinearProgress, LinearProgressProps, LoadingEmptyContent, LoadingScreen, LoadingScreenProps, Markdown, MarkdownProps, MegaMenu, MegaMenuChildItem, MegaMenuChildSection, MegaMenu as MegaMenuHorizontal, MegaMenuItemDataProps, MegaMenuItemOptionsProps, MegaMenuItemProps, MegaMenuItemSlotProps, MegaMenuItemStateProps, MegaMenuListProps, MegaMenuMobile, MegaMenuMoreLink, MegaMenuProps, MegaMenuRenderProps, MegaMenuSlide, MegaMenuSlotProps, MegaMenuSubItemProps, MegaMenuSubListProps, MegaMenuTag, MegaMenuVariant, MegaMenuVertical, Menu, MenuItemDef, MenuItemType, MenuProps, MoreLinksProps, MotionLazy, MotionLazyProps, MultiCheckboxOption, MultiSelectOption, MultiSwitchOption, Nav, NavArrow, NavArrowProps, NavCard, NavCardGrid, NavCardGridProps, NavCardProps, NavCommonProps, NavGroupProps, NavIcon, NavIconProps, NavInfo, NavInfoProps, NavItem, NavItemBase, NavItemBaseProps, NavItemDataProps, NavItemOptionsProps, NavItemProps, NavItemRenderProps, NavItemSlotProps, NavItemStateProps, NavLi, NavLiProps, NavList, NavListProps, NavSection, NavSectionData, NavSectionHorizontal, NavSectionMini, NavSectionProps, NavSection as NavSectionVertical, NavSlotProps, NavSubList, NavSubListProps, NavSubheader, NavSubheaderProps, NavTexts, NavTextsProps, NavUl, NavUlProps, NavVariant, NavigationProgress, NavigationProgressProps, PageContent, PageContentProps, ParsedStackTrace, ProgressBar, ProgressBarProps, ProgressColor, RadioOption, ScrollSpyProvider, ScrollSpySection, ScrollToTop, ScrollToTopProps, Scrollbar, ScrollbarProps, SearchEmptyContent, SearchInput, SearchInputProps, SettingsContextValue, SettingsDrawer, SettingsDrawerProps, SettingsDrawerState, SettingsProvider, SettingsProviderProps, SettingsSection, SimpleAccordion, SimpleAccordionProps, SimpleSnackbar, SimpleSnackbarProps, Skeleton, SkeletonProps, SkeletonVariant, SnackbarContextValue, SnackbarOptions, SnackbarProvider, SnackbarProviderProps, SortOrder, Spinner, SpinnerProps, SplashScreen, SplashScreenProps, StackFrame, StatCard, StatCardProps, StatusChip, StatusChipProps, StatusColor, StatusDot, StatusDotProps, StatusDotStatus, StatusLabel, StepItem, Stepper, StepperActions, StepperActionsProps, StepperProps, SvgColor, SvgColorProps, TabItem, TabPanel, TabPanelProps, Table, TableColumn, TableProps, TableSkeleton, TableSkeletonProps, Tabs, TabsProps, TagCloud, TagCloudItem, TagCloudProps, TipTapDoc, TipTapMark, TipTapNode, TipTapRenderer, TipTapRendererProps, Tooltip, TooltipProps, UploadValue, UseAccordionOptions, UseAccordionReturn, UseCarouselOptions, UseCarouselReturn, UseDateRangePickerReturn, UseLightboxOptions, UseLightboxReturn, UseMenuReturn, UseStepperOptions, UseStepperReturn, UseTableOptions, UseTableReturn, UseTabsOptions, UseTabsReturn, VirtualList, VirtualListProps, animateBorderClasses, carouselClasses, chartClasses, contentClasses, createIconComponent, formatDateString, getErrorLocation, getNavCssVars, htmlToMarkdown, isMarkdownContent, lightboxClasses, megaMenuClasses, megaMenuCssVars, navSectionClasses, navSectionCssVars, parseDateString, parseStackTrace, registerTipTapNode, useAccordion, useCarousel, useChart, useDateRangePicker, useErrorBoundary, useLightbox, useMenu, useScrollSpy, useSettings, useSettingsDrawer, useSnackbar, useStepper, useTable, useTabs } from './components/index.js';
-export { A as ArrowPlacement, C as CustomPopover, a as CustomPopoverProps, P as PopoverArrowProps, U as UsePopoverReturn, u as usePopover } from './popover-Dmw7SJLR.js';
-export { b as Editor, d as EditorProps, g as EditorToolbarItem, a as EditorToolbarItemProps, E as EditorToolbarProps, R as ResolvedToolbar, f as ToolbarConfig, h as ToolbarPreset, i as editorClasses, r as resolveToolbar } from './text-transform-D6MzzF7V.js';
-import { ClassValue } from 'clsx';
-export { ClassValue } from 'clsx';
-import { Ref, RefCallback, MutableRefObject } from 'react';
-export { A as AsyncState, B as BreakpointChecks, a as Breakpoints, C as CookieOptions, D as DOMRectValue, I as ImageDimensions, b as InfiniteFetchFn, c as InfinitePage, d as InfiniteScrollState, K as KeyboardShortcut, L as LazyQueryState, M as MutationState, P as PageInfo, S as ScrollElValue, e as ScrollPosition, U as UrlConfigValues, f as UseArrayReturn, g as UseAsyncFnReturn, h as UseAsyncOptions, i as UseAsyncReturn, j as UseBackToTopReturn, k as UseClientRectReturn, l as UseConfigFromQueryOptions, m as UseConfigFromQueryReturn, n as UseCookiesOptions, o as UseCookiesReturn, p as UseCountdownDateReturn, q as UseCountdownSecondsReturn, r as UseDoubleClickProps, s as UseDoubleClickReturn, t as UseFocusTrapOptions, u as UseFocusTrapReturn, v as UseImageDimensionsOptions, w as UseImageDimensionsReturn, x as UseInfiniteScrollOptions, y as UseInfiniteScrollReturn, z as UseIntersectionObserverOptions, E as UseIntersectionObserverReturn, F as UseKeyboardShortcutOptions, G as UseLazyQueryOptions, H as UseLazyQueryReturn, J as UseMutationOptions, N as UseMutationReturn, O as UseOnlineStatusReturn, Q as UsePasswordVisibilityOptions, R as UsePasswordVisibilityReturn, T as UsePopoverHoverReturn, V as UseResponsiveQueryReturn, W as UseScrollOffsetTopReturn, X as UseScrollPositionOptions, Y as UseSessionStorageOptions, Z as UseSessionStorageReturn, _ as UseThrottleOptions, $ as UseWindowSizeOptions, a0 as WindowSize, a1 as cookiesAvailable, a2 as getCookie, a3 as removeCookie, a4 as setCookie, a5 as useArray, a6 as useAsync, a7 as useAsyncFn, a8 as useBackToTop, a9 as useBreakpoint, aa as useBreakpointChecks, ab as useClientRect, ac as useConfigFromQuery, ad as useCookies, ae as useCountdownDate, af as useCountdownSeconds, ag as useDoubleClick, ah as useEnterKey, ai as useEscapeKey, aj as useFocusTrap, ak as useImageDimensions, al as useInfiniteScroll, am as useIntersectionObserver, an as useIsomorphicLayoutEffect, ao as useKeyboardShortcut, ap as useLazyQuery, aq as useMultipleImageDimensions, ar as useMutation, as as useOnlineStatus, at as usePasswordVisibility, au as usePopoverHover, av as useResponsiveQuery, aw as useScrollLock, ax as useScrollOffsetTop, ay as useScrollPosition, az as useScrollToTop, aA as useSessionStorage, aB as useThrottle, aC as useThrottleCallback, aD as useUpdateEffect, aE as useUpdateLayoutEffect, aF as useWindowSize } from './index-nmJ8Muwg.js';
-import { toast as toast$1 } from 'sonner';
-export { InstallResult, InstallerOptions, PrismInstaller, RegistryManager, RegistryManagerOptions, ResolvedItem, SearchOptions, createInstaller, createRegistryManager, defaultRegistrySchema, registry } from './registry/index.js';
-export { AuthCenteredContent, AuthCenteredContentProps, AuthCenteredLayout, AuthCenteredLayoutProps, AuthLayoutProps, AuthLayoutVariant, AuthSimpleLayout, AuthSimpleLayoutProps, AuthSplitContent, AuthSplitContentProps, AuthSplitIllustration, AuthSplitIllustrationProps, AuthSplitLayout, AuthSplitLayoutProps, DEFAULT_LAYOUT_CSS_VARS, DRAWER_WIDTHS, DashboardContent, DashboardContentProps, DashboardLayout, DashboardLayoutProps, HEADER_HEIGHTS, HeaderSection, HeaderSectionProps, HeaderSlots, HeaderToolbar, HeaderToolbarProps, LAYOUT_CSS_VARS, LayoutConfig, LayoutContext, LayoutContextValue, LayoutGlobalStyles, LayoutGlobalStylesProps, LayoutNavData, LayoutNavItem, LayoutNavSection, LayoutProvider, LayoutProviderProps, LayoutSection, LayoutSectionProps, MainSection, MainSectionProps, MobileSidenav, MobileSidenavProps, NavColorMode, NavigationMenuType, Sidenav, SidenavProps, SidenavVariant, SimpleCompactContent, SimpleCompactContentProps, TopnavVariant, defaultLayoutConfig, getBaseLayoutCssVars, getNavColorCssVars, mergeLayoutCssVars, useLayoutConfig, useLayoutContext, useNavActive, useSidenavVisible, useTopnavVisible } from './layouts/index.js';
-export { B as ButtonVariant, C as CommonComponentProps, a as ComponentColor, b as ComponentSize, D as DataDisplayProps, E as ExtractVariantProps, F as FormFieldProps, I as InputProps, L as LayoutProps, P as PolymorphicComponentProps, S as SelectOption, c as SlotProps, W as WithIconProps } from './components-BCGZ-Rwt.js';
-export { A as AuthContextValue, a as AuthProviderType, b as AuthState, c as AuthUser, B as BlockCategory, d as BlockConfig, e as BlockDefinition, f as BlockDependencies, g as BlockFile, h as BlockFileType, i as BlockNavItem, j as BlockNavSection, C as ComponentDefinition, k as ComponentDependencies, l as ComponentFile, m as ComponentFileType, D as DashboardBlockProps, n as DashboardNavType, o as DataGridProps, F as FormFieldSchema, p as FormFieldType, q as FormSchema, r as FormSectionSchema, G as GridCellParams, s as GridColumn, t as GridFilterItem, u as GridFilterModel, v as GridHeaderParams, w as GridSortModel, I as InstalledBlock, x as InstalledComponent, P as PrismLockfile, R as RegistryConfig, y as RegistrySchema, z as RemoteRegistryConfig, S as SidebarNavVariant, T as ThemeRegistryEntry, E as TopbarNavVariant } from './registry-DQcIzW2s.js';
-export { D as DefineConfigFn, F as FeaturesConfig, P as PartialPrismConfig, a as PathsConfig, b as PrismConfig, c as PrismConfigFile, S as StyleConfig, d as StyleFramework, e as defaultPrismConfig } from './config-Pct0n_Kq.js';
-export { AuthStatus, AuthStoreState, CreateStoreOptions, MigrationFn, StoreSelector, ThemeState, UIState, VersionMigration, VersionedPersistedState, VersionedSettingsConfig, authStore, checkSettingsVersion, clearSettings, createAddFieldMigration, createMigration, createPersistedStore, createPrismStore, createRemoveFieldMigration, createRenameMigration, createSelectors, createSettingsValidator, createTransformMigration, createUIStore, createVersionedPersistOptions, createVersionedStorage, exportSettings, getMigrationInfo, importSettings, runMigrations, themeStore, uiStore, useAuthStore, useThemeStore, useUIStore, validateMigrations } from './state/index.js';
-export { N as NavColor, a as NavLayout, S as SettingsState, b as SettingsValues, g as getDefaultSettings, s as settingsStore, u as useSettingsStore } from './settings-CAC0qFjS.js';
-export { AuthConfig, BackendConfig, BackendConnectionAware, BackendSchema, BackendStatus, CacheConfig, ConnectionAware, ConnectionAwareProps, ConnectionContextValue, DefaultOptions, DefaultsContextValue, DehydratedState, HydrationContextValue, IBackendClient, IMultiBackendClient, Middleware, MiddlewareContext, MultiBackendClientOptions, MultiBackendConnectionAware, MultiBackendProvider, MultiBackendProviderProps, MutationOptions, MutationResult, MutationStatus, NetronError, NetronProvider, NetronProviderProps, NetronReactClient, NetronReactClientConfig, RetryConfig as NetronRetryConfig, QueryKey, QueryOptions, QueryResult, QueryStatus, RequireAllBackends, RequireAnyBackend, RequireBackendConnection, RequireConnection, ServiceMethodHooks, ServiceOptions, SubscriptionOptions, SubscriptionResult, TransportType, TypedServiceProxy, createNetronClient, createServiceHook as createNetronServiceHook, useAllBackendsConnected, useAnyBackendConnected, useBackend, useBackendConnectionState, useBackendMutation, useBackendQuery, useBackendService, useDefaults, useHydration, useMultiBackend, useNetronClient, useNetronClientSafe, useNetronConnection, useMutation as useNetronMutation, useQuery as useNetronQuery, useService as useNetronService, useSubscription as useNetronSubscription } from '@omnitron-dev/netron-react';
-export { AuthenticationClient, ConnectionState, MultiBackendClient, SessionTokenStorage, WebSocketClient, createMultiBackendClient } from '@omnitron-dev/netron-browser';
-export { AuthGuard, AuthGuardProps, AuthProvider, AuthProviderProps, GuestGuard, GuestGuardProps, Hide, AuthContextValue as NetronAuthContextValue, AuthState as NetronAuthState, PermissionGuard, PermissionGuardProps, RoleGuard, RoleGuardProps, Show, User, useAuth, useAuthRequired, useIsAuthenticated, useUser } from '@omnitron-dev/netron-react/auth';
-export { MutationCache, QueryCache, hashQueryKey, matchQueryKey } from '@omnitron-dev/netron-react/cache';
-import '@mui/material/locale';
-import '@mui/material/styles';
-import 'dayjs';
-import 'react/jsx-runtime';
-import '@mui/material/Dialog';
-import '@mui/material/TextField';
-import '@mui/material/Autocomplete';
-import '@mui/material/Box';
-import '@mui/material/Avatar';
-import '@mui/material/AvatarGroup';
-import '@mui/material/Badge';
-import '@mui/material/Card';
-import '@mui/material/LinearProgress';
-import '@mui/material/Alert';
-import '@mui/material/Snackbar';
-import '@mui/material/Table';
-import 'react-hook-form';
-import '@mui/material/Checkbox';
-import '@mui/material/Switch';
-import '@mui/material/FormControl';
-import '@mui/material/Rating';
-import '@mui/material/Slider';
-import '@mui/material/FormGroup';
-import '@mui/material/FormHelperText';
-import '@mui/material/FormLabel';
-import 'react-dropzone';
-import '@mui/material/Skeleton';
-import '@mui/material/CircularProgress';
-import '@mui/material/Tabs';
-import '@mui/material/Accordion';
-import '@mui/material/Tooltip';
-import '@mui/material/Breadcrumbs';
-import '@mui/material/Paper';
-import '@mui/material/Stepper';
-import '@mui/material/ButtonBase';
-import '@mui/material/Link';
-import 'react-markdown';
-import '@emotion/styled';
-import '@mui/system';
-import '@mui/material/Popover';
-import '@tiptap/react';
-import '@tiptap/core';
-import 'class-variance-authority';
-import 'immer';
-import 'zustand';
-import 'zustand/middleware';
-
 /**
- * Class Name Utility
- *
- * Combines clsx for conditional classes with optional Tailwind merge.
- * Inspired by shadcn/ui's cn() utility and minimal-shared's mergeClasses.
- *
- * @module @omnitron-dev/prism/utils/cn
- */
-
-/**
- * Combines class names using clsx.
- *
- * This is a simplified version without tailwind-merge since Prism
- * primarily uses MUI's sx prop for styling. For Tailwind projects,
- * consider adding tailwind-merge.
- *
- * @example
- * ```tsx
- * // Basic usage
- * cn('px-4 py-2', 'bg-blue-500')
- *
- * // Conditional classes
- * cn('base-class', isActive && 'active', isDisabled && 'disabled')
- *
- * // With objects
- * cn('base', { active: isActive, disabled: isDisabled })
- *
- * // With arrays
- * cn(['class1', 'class2'], condition && 'class3')
- * ```
- */
-declare function cn(...inputs: ClassValue[]): string;
-
-/**
- * State props for mergeClasses.
- * Values can be:
- * - boolean: includes key as class name if true
- * - undefined: excluded
- * - [boolean, string]: includes string as class name if boolean is true
- */
-type StateProps = {
-    [key: string]: boolean | undefined | [boolean, string];
-};
-/**
- * Merges class names with state-based class names.
- *
- * This utility provides an alternative API for state-based class toggling,
- * particularly useful when class names differ from state keys.
- *
- * @param className - Base class name(s)
- * @param state - State object with boolean or [boolean, className] values
- * @returns Merged class names string
- *
- * @example
- * ```tsx
- * // Basic state-based merging
- * mergeClasses('item', {
- *   'item--active': isActive,
- *   'item--disabled': isDisabled,
- * });
- * // Output: 'item item--active' (if isActive is true)
- *
- * // With tuple format for different class names
- * mergeClasses('btn', {
- *   primary: [isPrimary, 'btn-primary'],
- *   secondary: [isSecondary, 'btn-secondary'],
- * });
- *
- * // With array of base classes
- * mergeClasses(['nav', 'nav--main'], {
- *   'nav--open': isOpen,
- * });
- * ```
- */
-declare function mergeClasses(className?: string | (string | undefined)[] | null, state?: StateProps): string;
-
-/**
- * Class Name Factory
- *
- * Creates prefixed CSS class names for consistent component styling.
- * Uses a configurable prefix to avoid collisions with other libraries.
- *
- * @module @omnitron-dev/prism/utils/create-classes
- */
-/**
- * Default class prefix for Prism components.
- * Can be overridden via PRISM_CLASS_PREFIX environment variable.
- */
-declare const DEFAULT_CLASS_PREFIX = "prism";
-/**
- * Set the global class prefix for all Prism components.
- *
- * @param prefix - New class prefix to use
- *
- * @example
- * ```ts
- * setClassPrefix('my-app');
- * createClasses('button__root'); // => "my-app__button__root"
- * ```
- */
-declare function setClassPrefix(prefix: string): void;
-/**
- * Get the current class prefix.
- *
- * @returns Current class prefix
- */
-declare function getClassPrefix(): string;
-/**
- * Create a prefixed CSS class name.
- *
- * @param className - Class name suffix (e.g., "button__root")
- * @returns Prefixed class name (e.g., "prism__button__root")
- *
- * @example
- * ```ts
- * createClasses('chart__root')
- * // => "prism__chart__root"
- *
- * createClasses('chart__loading')
- * // => "prism__chart__loading"
- * ```
- */
-declare function createClasses(className: string): string;
-/**
- * Create multiple prefixed CSS class names.
- *
- * @param classNames - Array of class name suffixes
- * @returns Object mapping original names to prefixed names
- *
- * @example
- * ```ts
- * const classes = createClassesObject(['root', 'loading', 'label']);
- * // => { root: "prism__root", loading: "prism__loading", label: "prism__label" }
- * ```
- */
-declare function createClassesObject<T extends string>(classNames: readonly T[]): Record<T, string>;
-/**
- * Create a class name factory for a specific component.
- *
- * @param componentName - Component name (e.g., "chart", "button")
- * @returns Function that creates prefixed class names for that component
- *
- * @example
- * ```ts
- * const chartClass = createComponentClasses('chart');
- * chartClass('root');    // => "prism__chart__root"
- * chartClass('loading'); // => "prism__chart__loading"
- * ```
- */
-declare function createComponentClasses(componentName: string): (suffix: string) => string;
-/**
- * Create a class name object for a specific component with predefined suffixes.
- *
- * @param componentName - Component name (e.g., "chart", "button")
- * @param suffixes - Array of class name suffixes
- * @returns Object mapping suffix names to prefixed class names
- *
- * @example
- * ```ts
- * const chartClasses = createComponentClasses('chart', ['root', 'loading', 'label'] as const);
- * chartClasses.root;    // => "prism__chart__root"
- * chartClasses.loading; // => "prism__chart__loading"
- * ```
- */
-declare function createComponentClasses<T extends string>(componentName: string, suffixes: readonly T[]): Record<T, string>;
-
-/**
- * Ref Utilities
- *
- * Utilities for working with React refs.
- *
- * @module @omnitron-dev/prism/utils/refs
- */
-
-/**
- * Supported ref types for merging.
- */
-type MergeableRef<T> = Ref<T> | RefCallback<T> | MutableRefObject<T> | null | undefined;
-/**
- * Merge multiple refs into a single callback ref.
- * Useful when you need to pass a ref to a component that also needs
- * to be used by a parent component or hook.
- *
- * @example
- * ```tsx
- * const Component = forwardRef((props, ref) => {
- *   const localRef = useRef<HTMLDivElement>(null);
- *   const mergedRef = mergeRefs(ref, localRef);
- *   return <div ref={mergedRef} />;
- * });
- * ```
- *
- * @param refs - Array of refs to merge
- * @returns A callback ref that updates all provided refs
- */
-declare function mergeRefs<T>(...refs: MergeableRef<T>[]): RefCallback<T>;
-/**
- * Create a ref setter that can be used with useImperativeHandle.
- * Useful for exposing a subset of methods from a ref.
- *
- * @example
- * ```tsx
- * const Component = forwardRef<API, Props>((props, ref) => {
- *   const inputRef = useRef<HTMLInputElement>(null);
- *
- *   useImperativeHandle(ref, () => ({
- *     focus: () => inputRef.current?.focus(),
- *     clear: () => { if (inputRef.current) inputRef.current.value = ''; },
- *   }), []);
- *
- *   return <input ref={inputRef} />;
- * });
- * ```
- *
- * @param ref - The ref to set
- * @param value - The value to set
- */
-declare function setRef<T>(ref: MergeableRef<T>, value: T | null): void;
-/**
- * Check if a ref has a current value.
- *
- * @param ref - The ref to check
- * @returns True if the ref has a current value
- */
-declare function hasRefValue<T>(ref: MergeableRef<T>): ref is MutableRefObject<NonNullable<T>>;
-
-/**
- * Number Formatting Utilities
- *
- * Locale-aware number formatting utilities.
- *
- * @module @omnitron-dev/prism/utils/format-number
- */
-interface FormatNumberOptions extends Intl.NumberFormatOptions {
-    /** Locale for formatting (default: 'en-US') */
-    locale?: string;
-}
-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%"
- * ```
- */
-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)
- * ```
- */
-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%"
- * ```
- */
-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"
- * ```
- */
-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"
- * ```
- */
-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"
- * ```
- */
-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"
- * ```
- */
-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
- * ```
- */
-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
- * ```
- */
-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')
- * // => "£"
- * ```
- */
-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"
- * ```
- */
-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"
- * ```
- */
-declare function fCompact(value: number | string | null | undefined, options?: FormatNumberOptions): string;
-
-/**
- * Number Input Transform Utilities
- *
- * Three-phase number input handling for controlled inputs.
- * Allows users to type freely while maintaining valid numeric state.
- *
- * @module @omnitron-dev/prism/utils/transform-number
- */
-/**
- * Options for number transformation.
- */
-interface TransformNumberOptions {
-    /** Minimum allowed value */
-    min?: number;
-    /** Maximum allowed value */
-    max?: number;
-    /** Decimal places to allow */
-    decimals?: number;
-    /** Allow negative numbers */
-    allowNegative?: boolean;
-    /** Default value when input is empty or invalid */
-    defaultValue?: number;
-}
-/**
- * Parse a string to a number, handling edge cases.
- *
- * @param value - String value to parse
- * @param options - Transformation options
- * @returns Parsed number or undefined if invalid
- */
-declare function parseNumber(value: string, options?: TransformNumberOptions): number | undefined;
-/**
- * Clamp a number to min/max bounds.
- *
- * @param value - Value to clamp
- * @param options - Options with min/max
- * @returns Clamped value
- */
-declare function clampNumber(value: number, options?: TransformNumberOptions): number;
-/**
- * Round a number to specified decimal places.
- *
- * @param value - Value to round
- * @param decimals - Number of decimal places
- * @returns Rounded value
- */
-declare function roundToDecimals(value: number, decimals: number): number;
-/**
- * Transform value during onChange (while typing).
- * Allows intermediate states like empty string, single minus, or trailing decimal.
- *
- * @param value - Current input value
- * @param options - Transformation options
- * @returns Transformed string value (may include intermediate states)
- */
-declare function transformOnChange(value: string, options?: TransformNumberOptions): string;
-/**
- * Transform value during onBlur (when input loses focus).
- * Finalizes the value with proper formatting and validation.
- *
- * @param value - Current input value
- * @param options - Transformation options
- * @returns Finalized numeric value
- */
-declare function transformOnBlur(value: string, options?: TransformNumberOptions): number;
-/**
- * Transform a number for display in an input.
- * Converts number back to string representation.
- *
- * @param value - Numeric value
- * @param options - Transformation options
- * @returns String representation for input value
- */
-declare function transformForDisplay(value: number | null | undefined, options?: TransformNumberOptions): string;
-/**
- * Create a complete number input handler.
- * Returns handlers for onChange, onBlur, and value display.
- *
- * @example
- * ```tsx
- * const [price, setPrice] = useState(0);
- * const handlers = createNumberInputHandlers({
- *   value: price,
- *   onChange: setPrice,
- *   min: 0,
- *   decimals: 2,
- * });
- *
- * <TextField
- *   value={handlers.displayValue}
- *   onChange={(e) => handlers.handleChange(e.target.value)}
- *   onBlur={handlers.handleBlur}
- * />
- * ```
- *
- * @param config - Handler configuration
- * @returns Object with handlers and display value
- */
-declare function createNumberInputHandlers(config: {
-    value: number;
-    onChange: (value: number) => void;
-    options?: TransformNumberOptions;
-}): {
-    displayValue: string;
-    handleChange: (value: string) => void;
-    handleBlur: () => void;
-};
-
-/**
- * Date Formatting Utilities
- *
- * Locale-aware date formatting utilities using Intl.DateTimeFormat.
- * For more complex formatting, consider using dayjs or date-fns.
- *
- * @module @omnitron-dev/prism/utils/format-date
- */
-type DateInput = Date | string | number | null | undefined;
-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"
- * ```
- */
-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"
- * ```
- */
-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"
- * ```
- */
-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"
- * ```
- */
-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"
- * ```
- */
-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"
- * ```
- */
-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
- * ```
- */
-declare function isToday(date: DateInput): boolean;
-/**
- * Check if a date is yesterday.
- */
-declare function isYesterday(date: DateInput): boolean;
-/**
- * Check if a date is within the current week.
- */
-declare function isThisWeek(date: DateInput): boolean;
-/**
- * Check if a date is in the past.
- */
-declare function isPast(date: DateInput): boolean;
-/**
- * Check if a date is in the future.
- */
-declare function isFuture(date: DateInput): boolean;
-/**
- * Get the difference between two dates in days.
- */
-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)]
- * ```
- */
-declare function getDates(startDate: DateInput, endDate: DateInput, interval?: number): Date[];
-/**
- * Duration preset for getPastDates.
- */
-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);
- * ```
- */
-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);
- * ```
- */
-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
- */
-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
- */
-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
- */
-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
- */
-declare function addMonths(date: DateInput, months: number): Date | null;
-
-/**
- * String Utilities
- *
- * Common string manipulation utilities.
- *
- * @module @omnitron-dev/prism/utils/string
- */
-/**
- * Truncate text with ellipsis.
- *
- * @example
- * ```ts
- * truncate('Hello, World!', 8)
- * // => "Hello..."
- *
- * truncate('Short', 10)
- * // => "Short"
- *
- * truncate('Hello, World!', 8, '…')
- * // => "Hello, W…"
- * ```
- */
-declare function truncate(text: string | null | undefined, length: number, suffix?: string): string;
-/**
- * Get initials from a name.
- *
- * @example
- * ```ts
- * getInitials('John Doe')
- * // => "JD"
- *
- * getInitials('Alice Bob Charlie')
- * // => "AC"
- *
- * getInitials('SingleName')
- * // => "SI"
- * ```
- */
-declare function getInitials(name: string | null | undefined): string;
-/**
- * Capitalize the first letter of a string.
- *
- * @example
- * ```ts
- * capitalize('hello world')
- * // => "Hello world"
- * ```
- */
-declare function capitalize(text: string | null | undefined): string;
-/**
- * Capitalize the first letter of each word.
- *
- * @example
- * ```ts
- * titleCase('hello world')
- * // => "Hello World"
- *
- * titleCase('the quick brown fox')
- * // => "The Quick Brown Fox"
- * ```
- */
-declare function titleCase(text: string | null | undefined): string;
-/**
- * Convert string to kebab-case.
- *
- * @example
- * ```ts
- * kebabCase('Hello World')
- * // => "hello-world"
- *
- * kebabCase('camelCaseString')
- * // => "camel-case-string"
- * ```
- */
-declare function kebabCase(text: string | null | undefined): string;
-/**
- * Convert string to camelCase.
- *
- * @example
- * ```ts
- * camelCase('Hello World')
- * // => "helloWorld"
- *
- * camelCase('kebab-case-string')
- * // => "kebabCaseString"
- * ```
- */
-declare function camelCase(text: string | null | undefined): string;
-/**
- * Convert string to snake_case.
- *
- * @example
- * ```ts
- * snakeCase('Hello World')
- * // => "hello_world"
- *
- * snakeCase('camelCaseString')
- * // => "camel_case_string"
- * ```
- */
-declare function snakeCase(text: string | null | undefined): string;
-/**
- * Highlight search query in text by wrapping matches in <mark> tags.
- *
- * @example
- * ```ts
- * highlightText('Hello World', 'wor')
- * // => "Hello <mark>Wor</mark>ld"
- *
- * highlightText('Test Case', 'test', '<strong>', '</strong>')
- * // => "<strong>Test</strong> Case"
- * ```
- */
-declare function highlightText(text: string | null | undefined, query: string | null | undefined, openTag?: string, closeTag?: string): string;
-/**
- * Escape special regex characters in a string.
- *
- * @example
- * ```ts
- * escapeRegExp('test.string+with[special]chars')
- * // => "test\\.string\\+with\\[special\\]chars"
- * ```
- */
-declare function escapeRegExp(text: string): string;
-/**
- * Check if a string contains a substring (case-insensitive).
- *
- * @example
- * ```ts
- * containsIgnoreCase('Hello World', 'WORLD')
- * // => true
- *
- * containsIgnoreCase('Hello World', 'foo')
- * // => false
- * ```
- */
-declare function containsIgnoreCase(text: string | null | undefined, search: string | null | undefined): boolean;
-/**
- * Check if a string is empty or whitespace only.
- *
- * @example
- * ```ts
- * isBlank('')
- * // => true
- *
- * isBlank('   ')
- * // => true
- *
- * isBlank('hello')
- * // => false
- * ```
- */
-declare function isBlank(text: string | null | undefined): boolean;
-/**
- * Check if a string is a valid email address (basic check).
- *
- * @example
- * ```ts
- * isEmail('test@example.com')
- * // => true
- *
- * isEmail('invalid')
- * // => false
- * ```
- */
-declare function isEmail(text: string | null | undefined): boolean;
-/**
- * Check if a string is a valid URL (basic check).
- *
- * @example
- * ```ts
- * isUrl('https://example.com')
- * // => true
- *
- * isUrl('not-a-url')
- * // => false
- * ```
- */
-declare function isUrl(text: string | null | undefined): boolean;
-/**
- * Generate a random string of specified length.
- *
- * @example
- * ```ts
- * randomString(8)
- * // => "a3Bx9kPq"
- *
- * randomString(16, 'abc123')
- * // => "a1b3c2a1b3c2a1b3"
- * ```
- */
-declare function randomString(length?: number, chars?: string): string;
-/**
- * Generate a UUID v4.
- *
- * @example
- * ```ts
- * uuid()
- * // => "550e8400-e29b-41d4-a716-446655440000"
- * ```
- */
-declare function uuid(): string;
-/**
- * Generate a slug from text.
- *
- * @example
- * ```ts
- * slugify('Hello World!')
- * // => "hello-world"
- *
- * slugify('This is a Test  String')
- * // => "this-is-a-test-string"
- * ```
- */
-declare function slugify(text: string | null | undefined): string;
-
-/**
- * URL Utilities
- *
- * Safe URL handling, navigation helpers, and link utilities.
- *
- * @module @omnitron-dev/prism/utils/url
- */
-/**
- * Options for safe return URL validation.
- */
-interface SafeReturnUrlOptions {
-    /** Allowed URL schemes (default: ['http:', 'https:']) */
-    allowedSchemes?: string[];
-    /** Allowed hosts (if empty, only relative URLs allowed) */
-    allowedHosts?: string[];
-    /** Whether to allow relative URLs (default: true) */
-    allowRelative?: boolean;
-    /** Default URL if validation fails */
-    fallback?: string;
-}
-/**
- * Validate and sanitize a return URL to prevent open redirect vulnerabilities.
- * Only allows relative paths or URLs to explicitly allowed hosts.
- *
- * @example
- * ```tsx
- * // In a login callback
- * const returnUrl = safeReturnUrl(searchParams.get('redirect'), {
- *   allowedHosts: ['app.example.com'],
- *   fallback: '/dashboard',
- * });
- * router.push(returnUrl);
- * ```
- *
- * @param url - URL to validate
- * @param options - Validation options
- * @returns Safe URL or fallback
- */
-declare function safeReturnUrl(url: string | null | undefined, options?: SafeReturnUrlOptions): string;
-/**
- * Check if a navigation link is currently active.
- *
- * Features:
- * - Removes trailing slashes and query parameters before comparison
- * - Ignores external links (https://...) and hash links (#section)
- * - Supports deep matching for nested routes
- * - Handles query parameter paths correctly
- *
- * @example
- * ```tsx
- * // Basic usage
- * isActiveLink('/dashboard', '/dashboard/user/list');     // true (deep match)
- * isActiveLink('/dashboard', '/dashboard/user/list', false); // false (exact match)
- *
- * // Query parameters
- * isActiveLink('/users', '/users?page=1');                // true
- *
- * // Hash links and external links
- * isActiveLink('/home', '#section');                      // false
- * isActiveLink('/home', 'https://example.com');           // false
- *
- * // Navigation items
- * const navItems = [
- *   { path: '/dashboard', label: 'Dashboard', exact: true },
- *   { path: '/users', label: 'Users' },
- *   { path: '/settings', label: 'Settings' },
- * ];
- *
- * navItems.map(item => (
- *   <NavItem
- *     key={item.path}
- *     active={isActiveLink(location.pathname, item.path, !item.exact)}
- *   >
- *     {item.label}
- *   </NavItem>
- * ));
- * ```
- *
- * @param currentPathname - Current location pathname
- * @param targetPath - The link's target path (can include query parameters)
- * @param deep - Whether to perform deep matching for nested routes (default: true)
- * @returns True if the link is active
- */
-declare function isActiveLink(currentPathname: string, targetPath: string, deep?: boolean): boolean;
-/**
- * Check if a URL is external (different origin).
- *
- * @param url - URL to check
- * @param currentOrigin - Current page origin (default: window.location.origin)
- * @returns True if the URL is external
- */
-declare function isExternalUrl(url: string, currentOrigin?: string): boolean;
-/**
- * Build a URL with query parameters.
- *
- * @example
- * ```tsx
- * const url = buildUrl('/search', {
- *   q: 'hello world',
- *   page: 1,
- *   filter: ['active', 'recent'],
- * });
- * // Returns: '/search?q=hello+world&page=1&filter=active&filter=recent'
- * ```
- *
- * @param base - Base URL path
- * @param params - Query parameters
- * @returns URL with query string
- */
-declare function buildUrl(base: string, params: Record<string, string | number | boolean | (string | number | boolean)[] | null | undefined>): string;
-/**
- * Parse query parameters from a URL string.
- *
- * @param url - URL or query string
- * @returns Parsed parameters
- */
-declare function parseQueryParams(url: string): Record<string, string | string[]>;
-/**
- * Get a single query parameter value.
- *
- * @param url - URL or query string
- * @param key - Parameter key
- * @returns Parameter value or undefined
- */
-declare function getQueryParam(url: string, key: string): string | undefined;
-/**
- * Check if a URL has query parameters.
- *
- * @param url - URL to check
- * @returns True if URL has query parameters
- *
- * @example
- * ```ts
- * hasParams('/search?q=hello'); // true
- * hasParams('/search');         // false
- * ```
- */
-declare function hasParams(url: string): boolean;
-/**
- * Remove query parameters from a URL.
- *
- * @param url - URL to process
- * @returns URL without query parameters
- *
- * @example
- * ```ts
- * removeParams('/search?q=hello'); // '/search'
- * removeParams('/search');         // '/search'
- * ```
- */
-declare function removeParams(url: string): string;
-/**
- * Remove trailing slash from a path.
- *
- * @param pathname - Path to process
- * @returns Path without trailing slash
- *
- * @example
- * ```ts
- * removeLastSlash('/users/');  // '/users'
- * removeLastSlash('/users');   // '/users'
- * removeLastSlash('/');        // '/'
- * ```
- */
-declare function removeLastSlash(pathname: string): string;
-/**
- * Check if a URL is an external link (starts with http:// or https://).
- *
- * @param url - URL to check
- * @returns True if external link
- *
- * @example
- * ```ts
- * isExternalLink('https://example.com'); // true
- * isExternalLink('/about');              // false
- * isExternalLink('#section');            // false
- * ```
- */
-declare function isExternalLink(url: string): boolean;
-/**
- * Compare two paths for equality (ignoring trailing slashes and query params).
- *
- * @param targetUrl - Target URL
- * @param currentUrl - Current URL
- * @param options - Comparison options
- * @returns True if paths are equal
- *
- * @example
- * ```ts
- * isEqualPath('/users/', '/users');          // true
- * isEqualPath('/users?page=1', '/users');    // true
- * isEqualPath('/users', '/users/1', { deep: true }); // false
- * ```
- */
-declare function isEqualPath(targetUrl: string, currentUrl: string, options?: {
-    deep?: boolean;
-}): boolean;
-
-/**
- * LocalStorage Utilities
- *
- * SSR-safe localStorage utilities with JSON serialization support.
- * Inspired by minimal-shared/utils/local-storage pattern.
- *
- * @module @omnitron-dev/prism/utils/storage
- */
-interface StorageOptions {
-    /** Storage to use (default: localStorage) */
-    storage?: Storage;
-    /** Serialize function (default: JSON.stringify) */
-    serialize?: (value: unknown) => string;
-    /** Deserialize function (default: JSON.parse) */
-    deserialize?: (value: string) => unknown;
-}
-/**
- * Check if localStorage is available in the current environment.
- * Handles SSR, private browsing, and quota exceeded scenarios.
- *
- * @example
- * ```ts
- * if (localStorageAvailable()) {
- *   localStorage.setItem('key', 'value');
- * }
- * ```
- */
-declare function localStorageAvailable(): boolean;
-/**
- * Check if sessionStorage is available in the current environment.
- *
- * @example
- * ```ts
- * if (sessionStorageAvailable()) {
- *   sessionStorage.setItem('key', 'value');
- * }
- * ```
- */
-declare function sessionStorageAvailable(): boolean;
-/**
- * Get a value from localStorage with automatic JSON parsing.
- * Returns defaultValue if key doesn't exist, parsing fails, or storage is unavailable.
- *
- * @param key - Storage key
- * @param defaultValue - Value to return if key doesn't exist or parsing fails
- * @param options - Storage options
- * @returns Parsed value or defaultValue
- *
- * @example
- * ```ts
- * // Simple value
- * const count = getStorage('count', 0);
- *
- * // Object value
- * const user = getStorage<User>('user', null);
- *
- * // With sessionStorage
- * const session = getStorage('session', null, {
- *   storage: sessionStorage,
- * });
- * ```
- */
-declare function getStorage<T>(key: string, defaultValue: T, options?: StorageOptions): T;
-/**
- * Set a value in localStorage with automatic JSON serialization.
- * Silently fails if storage is unavailable.
- *
- * @param key - Storage key
- * @param value - Value to store (will be JSON serialized)
- * @param options - Storage options
- * @returns true if successful, false otherwise
- *
- * @example
- * ```ts
- * // Simple value
- * setStorage('count', 42);
- *
- * // Object value
- * setStorage('user', { id: 1, name: 'John' });
- *
- * // With sessionStorage
- * setStorage('session', sessionData, {
- *   storage: sessionStorage,
- * });
- * ```
- */
-declare function setStorage<T>(key: string, value: T, options?: StorageOptions): boolean;
-/**
- * Remove a value from localStorage.
- * Silently fails if storage is unavailable.
- *
- * @param key - Storage key to remove
- * @param options - Storage options
- * @returns true if successful, false otherwise
- *
- * @example
- * ```ts
- * removeStorage('user');
- *
- * // From sessionStorage
- * removeStorage('session', { storage: sessionStorage });
- * ```
- */
-declare function removeStorage(key: string, options?: Pick<StorageOptions, 'storage'>): boolean;
-/**
- * Clear all items from localStorage.
- * Silently fails if storage is unavailable.
- *
- * @param options - Storage options
- * @returns true if successful, false otherwise
- *
- * @example
- * ```ts
- * clearStorage();
- *
- * // Clear sessionStorage
- * clearStorage({ storage: sessionStorage });
- * ```
- */
-declare function clearStorage(options?: Pick<StorageOptions, 'storage'>): boolean;
-/**
- * Get all keys from localStorage.
- *
- * @param options - Storage options
- * @returns Array of storage keys
- *
- * @example
- * ```ts
- * const keys = getStorageKeys();
- * // => ['user', 'settings', 'cart']
- * ```
- */
-declare function getStorageKeys(options?: Pick<StorageOptions, 'storage'>): string[];
-/**
- * Get approximate size of localStorage in bytes.
- *
- * @param options - Storage options
- * @returns Size in bytes
- *
- * @example
- * ```ts
- * const sizeBytes = getStorageSize();
- * console.log(`Using ${sizeBytes} bytes of localStorage`);
- * ```
- */
-declare function getStorageSize(options?: Pick<StorageOptions, 'storage'>): number;
-interface StorageWithExpiryOptions extends StorageOptions {
-    /** Time to live in milliseconds */
-    ttl: number;
-}
-/**
- * Set a value with expiration time.
- *
- * @param key - Storage key
- * @param value - Value to store
- * @param options - Options with TTL in milliseconds
- *
- * @example
- * ```ts
- * // Store for 1 hour
- * setStorageWithExpiry('session', sessionData, {
- *   ttl: 60 * 60 * 1000,
- * });
- *
- * // Store for 24 hours
- * setStorageWithExpiry('cache', cacheData, {
- *   ttl: 24 * 60 * 60 * 1000,
- * });
- * ```
- */
-declare function setStorageWithExpiry<T>(key: string, value: T, options: StorageWithExpiryOptions): boolean;
-/**
- * Get a value that was stored with expiration.
- * Returns defaultValue if expired or not found.
- *
- * @param key - Storage key
- * @param defaultValue - Value to return if expired or not found
- * @param options - Storage options
- *
- * @example
- * ```ts
- * const session = getStorageWithExpiry<Session>('session', null);
- * if (!session) {
- *   // Session expired or doesn't exist
- *   redirectToLogin();
- * }
- * ```
- */
-declare function getStorageWithExpiry<T>(key: string, defaultValue: T, options?: StorageOptions): T;
-
-/**
- * Font Utilities
- *
- * Font family and unit conversion helpers.
- *
- * @module @omnitron-dev/prism/utils
- */
-/**
- * Create a font family string with fallback stack.
- *
- * @param {string} [fontName] - Primary font name
- * @returns {string} Font family with fallbacks
- *
- * @example
- * ```ts
- * setFont('Inter'); // '"Inter", -apple-system, ...'
- * setFont();        // Default system font stack
- * ```
- */
-declare function setFont(fontName?: string): string;
-/**
- * Convert rem to pixels.
- *
- * @param {string | number} value - Rem value (number or string like '1rem')
- * @returns {number} Value in pixels
- *
- * @example
- * ```ts
- * remToPx(1);      // 16
- * remToPx('1rem'); // 16
- * remToPx(1.5);    // 24
- * ```
- */
-declare function remToPx(value: string | number): number;
-/**
- * Convert pixels to rem.
- *
- * @param {string | number} value - Pixel value (number or string like '16px')
- * @returns {string} Value in rem with unit
- *
- * @example
- * ```ts
- * pxToRem(16);      // '1rem'
- * pxToRem('16px');  // '1rem'
- * pxToRem(24);      // '1.5rem'
- * ```
- */
-declare function pxToRem(value: string | number): string;
-/**
- * Create responsive font size based on viewport.
- *
- * @param {number} minSize - Minimum font size in px
- * @param {number} maxSize - Maximum font size in px
- * @param {number} [minWidth=320] - Minimum viewport width in px
- * @param {number} [maxWidth=1200] - Maximum viewport width in px
- * @returns {string} CSS clamp() value
- *
- * @example
- * ```ts
- * responsiveFontSize(14, 18);
- * // 'clamp(0.875rem, 0.7955rem + 0.3977vw, 1.125rem)'
- * ```
- */
-declare function responsiveFontSize(minSize: number, maxSize: number, minWidth?: number, maxWidth?: number): string;
-
-/**
- * Object Utilities
- *
- * Type-safe object manipulation helpers.
- *
- * @module @omnitron-dev/prism/utils
- */
-/**
- * Check if an object has specific keys.
- *
- * Vacuously true when `keys` is empty, in line with `Array.every`
- * — "every key in the empty set is present" matches the standard
- * library and avoids surprising callers that pass a dynamically
- * derived list of required keys.
- *
- * @template T - Object type
- * @template K - Key type
- * @param {T | null | undefined} obj - Object to check
- * @param {K[]} keys - Keys to check for
- * @returns {boolean} True if object has all specified keys
- *
- * @example
- * ```ts
- * const user = { name: 'John', email: 'john@example.com' };
- * hasKeys(user, ['name', 'email']); // true
- * hasKeys(user, ['name', 'age']);   // false
- * hasKeys(null, ['name']);          // false
- * hasKeys(user, []);                // true (vacuous)
- * ```
- */
-declare function hasKeys<T extends object, K extends keyof T>(obj: T | null | undefined, keys: K[]): boolean;
-/**
- * Omit specific keys from an object.
- *
- * @template T - Object type
- * @template K - Keys to omit
- * @param {T} obj - Source object
- * @param {K[]} keys - Keys to omit
- * @returns {Omit<T, K>} New object without specified keys
- *
- * @example
- * ```ts
- * const user = { name: 'John', email: 'john@example.com', password: '...' };
- * omit(user, ['password']); // { name: 'John', email: 'john@example.com' }
- * ```
- */
-declare function omit<T extends object, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
-/**
- * Pick specific keys from an object.
- *
- * @template T - Object type
- * @template K - Keys to pick
- * @param {T} obj - Source object
- * @param {K[]} keys - Keys to pick
- * @returns {Pick<T, K>} New object with only specified keys
- *
- * @example
- * ```ts
- * const user = { name: 'John', email: 'john@example.com', password: '...' };
- * pick(user, ['name', 'email']); // { name: 'John', email: 'john@example.com' }
- * ```
- */
-declare function pick<T extends object, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
-/**
- * Deep clone an object.
- *
- * @template T - Object type
- * @param {T} obj - Object to clone
- * @returns {T} Deep cloned object
- *
- * @example
- * ```ts
- * const original = { a: 1, b: { c: 2 } };
- * const cloned = deepClone(original);
- * cloned.b.c = 3; // original.b.c is still 2
- * ```
- */
-declare function deepClone<T>(obj: T): T;
-/**
- * Check if a value is empty (null, undefined, empty string, empty array, empty object).
- *
- * @param {unknown} value - Value to check
- * @returns {boolean} True if empty
- *
- * @example
- * ```ts
- * isEmpty(null);      // true
- * isEmpty('');        // true
- * isEmpty([]);        // true
- * isEmpty({});        // true
- * isEmpty('hello');   // false
- * isEmpty([1]);       // false
- * ```
- */
-declare function isEmpty(value: unknown): boolean;
-
-/**
- * RTL (Right-to-Left) Utilities
- *
- * Helpers for RTL layout support and CSS transformation control.
- *
- * @module @omnitron-dev/prism/utils
- */
-/**
- * Prevents automatic RTL (right-to-left) flipping of a CSS declaration.
- *
- * Many CSS-in-JS libraries and RTL plugins automatically flip directional
- * CSS properties (like margin-left → margin-right) for RTL layouts.
- * Use this function to prevent that behavior for specific declarations.
- *
- * Appends the `\/* @noflip *\/` comment which is recognized by:
- * - stylis (used by Emotion/styled-components)
- * - rtlcss
- * - cssjanus
- *
- * @param cssValue - A CSS declaration string (e.g., "margin-left: 10px")
- * @returns The same declaration with `\/* @noflip *\/` appended
- *
- * @example
- * ```tsx
- * import { noRtlFlip } from '@omnitron-dev/prism/utils';
- *
- * // In sx prop or styled components
- * const styles = {
- *   // This margin-left will stay as margin-left even in RTL
- *   marginLeft: noRtlFlip('10px'),
- *
- *   // Or for full declarations
- *   transform: noRtlFlip('translateX(100px)'),
- * };
- *
- * // Common use case: icons that shouldn't flip
- * <ChevronIcon sx={{ transform: noRtlFlip('rotate(0deg)') }} />
- *
- * // Progress indicators that fill from left regardless of RTL
- * <ProgressBar sx={{ left: noRtlFlip('0'), right: 'auto' }} />
- * ```
- */
-declare function noRtlFlip(cssValue: unknown): string;
-/**
- * Check if the current document direction is RTL.
- *
- * @returns True if the document direction is RTL
- *
- * @example
- * ```tsx
- * const isRtl = isRtlDirection();
- *
- * // Conditional styling
- * const style = {
- *   marginLeft: isRtl ? '0' : '10px',
- *   marginRight: isRtl ? '10px' : '0',
- * };
- * ```
- */
-declare function isRtlDirection(): boolean;
-/**
- * Get the appropriate directional property name based on RTL state.
- *
- * @param property - Base property name (e.g., 'left', 'marginLeft')
- * @param isRtl - Whether the layout is RTL
- * @returns The appropriate property name
- *
- * @example
- * ```tsx
- * const prop = getDirectionalProperty('left', isRtl);
- * // Returns 'right' if isRtl, 'left' otherwise
- * ```
- */
-declare function getDirectionalProperty(property: 'left' | 'right' | 'marginLeft' | 'marginRight' | 'paddingLeft' | 'paddingRight', isRtl: boolean): string;
-
-/**
- * AsyncLock Utility
- *
- * Prevents race conditions in async operations like token refresh.
- * Ensures only one operation runs at a time, with subsequent calls
- * waiting for and sharing the result of the in-flight operation.
- *
- * @module @omnitron-dev/prism/utils
- */
-/**
- * Options for AsyncLock.
- */
-interface AsyncLockOptions {
-    /** Timeout in milliseconds for the lock acquisition (default: 30000) */
-    timeout?: number;
-    /** Custom error message for timeout */
-    timeoutMessage?: string;
-}
-/**
- * Result from a locked operation.
- */
-interface AsyncLockResult<T> {
-    /** The result value */
-    value: T;
-    /** Whether this call executed the operation (vs waiting for another) */
-    wasExecutor: boolean;
-}
-/**
- * State of the lock.
- */
-type AsyncLockState = 'idle' | 'locked' | 'releasing';
-/**
- * AsyncLock prevents race conditions in concurrent async operations.
- *
- * Use cases:
- * - Token refresh: Multiple API calls fail simultaneously, only one should refresh
- * - Resource initialization: Expensive setup should happen once
- * - Cache population: Prevent thundering herd problem
- *
- * @example
- * ```tsx
- * import { AsyncLock } from '@omnitron-dev/prism/utils';
- *
- * const tokenRefreshLock = new AsyncLock({ timeout: 10000 });
- *
- * async function refreshToken(): Promise<string> {
- *   const { value: newToken } = await tokenRefreshLock.acquire(
- *     'refresh-token',
- *     async () => {
- *       // This only runs once even if called concurrently
- *       const response = await fetch('/auth/refresh', { method: 'POST' });
- *       const data = await response.json();
- *       return data.accessToken;
- *     }
- *   );
- *   return newToken;
- * }
- *
- * // Multiple concurrent calls share the same result
- * const [token1, token2, token3] = await Promise.all([
- *   refreshToken(), // Executes the actual refresh
- *   refreshToken(), // Waits for first to complete
- *   refreshToken(), // Waits for first to complete
- * ]);
- * // token1 === token2 === token3
- * ```
- */
-declare class AsyncLock {
-    private locks;
-    private resolvers;
-    private rejecters;
-    private options;
-    constructor(options?: AsyncLockOptions);
-    /**
-     * Current state of a specific lock.
-     */
-    getState(key: string): AsyncLockState;
-    /**
-     * Check if a specific lock is currently held.
-     */
-    isLocked(key: string): boolean;
-    /**
-     * Get all currently active lock keys.
-     */
-    getActiveLocks(): string[];
-    /**
-     * Acquire the lock and execute the operation.
-     * If the lock is already held, waits for the existing operation.
-     *
-     * @param key - Unique identifier for this lock
-     * @param operation - Async operation to execute
-     * @returns Result with the value and whether this call was the executor
-     */
-    acquire<T>(key: string, operation: () => Promise<T>): Promise<AsyncLockResult<T>>;
-    /**
-     * Try to acquire the lock without waiting.
-     * Returns immediately if lock is held.
-     *
-     * @param key - Unique identifier for this lock
-     * @param operation - Async operation to execute
-     * @returns Result or null if lock was already held
-     */
-    tryAcquire<T>(key: string, operation: () => Promise<T>): Promise<AsyncLockResult<T> | null>;
-    /**
-     * Force release a lock (use with caution).
-     * This will reject all waiters with the provided error.
-     */
-    forceRelease(key: string, error?: Error): void;
-    /**
-     * Clear all locks (use with caution, e.g., on logout).
-     */
-    clearAll(error?: Error): void;
-    /**
-     * Wait for a promise with timeout.
-     */
-    private waitWithTimeout;
-}
-/**
- * Error thrown when lock acquisition times out.
- */
-declare class AsyncLockTimeoutError extends Error {
-    readonly name = "AsyncLockTimeoutError";
-    constructor(message: string);
-}
-/**
- * Create a singleton AsyncLock instance for a specific use case.
- *
- * @example
- * ```tsx
- * import { createAsyncLock } from '@omnitron-dev/prism/utils';
- *
- * // Create a singleton lock for token refresh
- * const tokenLock = createAsyncLock({ timeout: 10000 });
- *
- * // Use in multiple places - same lock instance
- * async function apiCall() {
- *   if (isTokenExpired()) {
- *     await tokenLock.acquire('token', refreshToken);
- *   }
- *   // Make API call...
- * }
- * ```
- */
-declare function createAsyncLock(options?: AsyncLockOptions): AsyncLock;
-/**
- * Create a pre-configured lock for token refresh operations.
- * Uses sensible defaults for auth token refresh scenarios.
- */
-declare function createTokenRefreshLock(): AsyncLock;
-declare function withLock<T>(key: string, operation: () => Promise<T>, options?: AsyncLockOptions): Promise<T>;
-/**
- * Decorator factory for methods that should be locked.
- * Use with class methods to ensure single execution.
- *
- * @example
- * ```tsx
- * import { locked } from '@omnitron-dev/prism/utils';
- *
- * class AuthService {
- *   @locked('refresh')
- *   async refreshToken(): Promise<string> {
- *     // Only one instance runs at a time
- *     return await this.doRefresh();
- *   }
- * }
- * ```
- */
-declare function locked(key: string, options?: AsyncLockOptions): <T extends (...args: unknown[]) => Promise<unknown>>(_target: object, _propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T>;
-
-/**
- * Error Handling Utilities
- *
- * Comprehensive error handling with i18n support, error classification,
- * and retry logic for robust frontend applications.
- *
- * @module @omnitron-dev/prism/utils
- */
-/**
- * Error codes for classification.
- */
-type ErrorCode = 'AUTH_REQUIRED' | 'AUTH_EXPIRED' | 'AUTH_INVALID' | 'AUTH_FORBIDDEN' | 'AUTH_MFA_REQUIRED' | 'AUTH_DEVICE_BLOCKED' | 'NETWORK_ERROR' | 'NETWORK_TIMEOUT' | 'NETWORK_OFFLINE' | 'VALIDATION_ERROR' | 'VALIDATION_REQUIRED' | 'VALIDATION_FORMAT' | 'VALIDATION_RANGE' | 'SERVER_ERROR' | 'SERVER_UNAVAILABLE' | 'SERVER_MAINTENANCE' | 'NOT_FOUND' | 'CONFLICT' | 'RATE_LIMITED' | 'QUOTA_EXCEEDED' | 'UNKNOWN_ERROR' | string;
-/**
- * Severity levels for errors.
- */
-type ErrorSeverity = 'error' | 'warning' | 'info';
-/**
- * Error context for i18n.
- */
-interface ErrorContext$1 {
-    /** Error code for lookup */
-    code: ErrorCode;
-    /** HTTP status code if applicable */
-    status?: number;
-    /** Field name for validation errors */
-    field?: string;
-    /** Additional interpolation values */
-    values?: Record<string, string | number>;
-    /** Original error message (fallback) */
-    message?: string;
-    /** Retry information */
-    retryAfter?: number;
-    /** Severity level */
-    severity?: ErrorSeverity;
-}
-/**
- * Translated error result.
- */
-interface TranslatedError {
-    /** Translated title */
-    title: string;
-    /** Translated message */
-    message: string;
-    /** Error code */
-    code: ErrorCode;
-    /** Severity */
-    severity: ErrorSeverity;
-    /** Action hint (e.g., "Please log in again") */
-    action?: string;
-    /** Retry after seconds */
-    retryAfter?: number;
-    /** Is this a retryable error */
-    canRetry: boolean;
-}
-/**
- * Translation function type.
- */
-type TranslateFn = (key: string, values?: Record<string, string | number>) => string;
-/**
- * Error messages dictionary type.
- */
-interface ErrorMessages {
-    [code: string]: {
-        title: string;
-        message: string;
-        action?: string;
-    };
-}
-/**
- * Default error messages in English.
- * Can be replaced with i18n translations.
- */
-declare const DEFAULT_ERROR_MESSAGES: ErrorMessages;
-/**
- * Classify an error by HTTP status code.
- */
-declare function classifyHttpError(status: number): ErrorCode;
-/**
- * Check if an error is a network error.
- */
-declare function isNetworkError(error: unknown): boolean;
-/**
- * Check if an error is retryable.
- */
-declare function isRetryableError(code: ErrorCode): boolean;
-/**
- * Get severity for an error code.
- */
-declare function getErrorSeverity(code: ErrorCode): ErrorSeverity;
-/**
- * Create an error translator with custom messages or i18n function.
- *
- * @example
- * ```tsx
- * // With custom messages
- * const translate = createErrorTranslator({
- *   messages: {
- *     AUTH_REQUIRED: {
- *       title: 'Необходима авторизация',
- *       message: 'Пожалуйста, войдите в систему.',
- *     },
- *   },
- * });
- *
- * // With i18n library
- * const translate = createErrorTranslator({
- *   t: (key, values) => i18n.t(key, values),
- * });
- *
- * const error = translate({ code: 'AUTH_REQUIRED', status: 401 });
- * // { title: 'Необходима авторизация', message: '...', ... }
- * ```
- */
-declare function createErrorTranslator(options: {
-    messages?: ErrorMessages;
-    t?: TranslateFn;
-    fallbackMessages?: ErrorMessages;
-}): (context: ErrorContext$1) => TranslatedError;
-/**
- * Extract error context from various error types.
- *
- * @example
- * ```tsx
- * try {
- *   await api.call();
- * } catch (error) {
- *   const context = extractErrorContext(error);
- *   const translated = translateError(context);
- *   showNotification(translated);
- * }
- * ```
- */
-declare function extractErrorContext(error: unknown): ErrorContext$1;
-/**
- * Retry configuration.
- */
-interface RetryConfig {
-    /** Maximum number of retries */
-    maxRetries?: number;
-    /** Initial delay in ms */
-    initialDelay?: number;
-    /** Maximum delay in ms */
-    maxDelay?: number;
-    /** Exponential backoff factor */
-    backoffFactor?: number;
-    /** Add jitter to delays */
-    jitter?: boolean;
-    /** Custom retry condition */
-    shouldRetry?: (error: unknown, attempt: number) => boolean;
-    /** Called before each retry */
-    onRetry?: (error: unknown, attempt: number, delay: number) => void;
-}
-/**
- * Execute an async operation with automatic retry.
- *
- * @example
- * ```tsx
- * const result = await withRetry(
- *   () => fetch('/api/data'),
- *   {
- *     maxRetries: 3,
- *     onRetry: (error, attempt, delay) => {
- *       console.log(`Retry ${attempt} after ${delay}ms`);
- *     },
- *   }
- * );
- * ```
- */
-declare function withRetry<T>(operation: () => Promise<T>, config?: RetryConfig): Promise<T>;
-/**
- * Check if error is a chunk load error (code splitting failure).
- */
-declare function isChunkLoadError(error: unknown): boolean;
-/**
- * Check if error is a session expiry error.
- */
-declare function isSessionExpiredError(error: unknown): boolean;
-/**
- * Create a handler for error boundary recovery.
- */
-declare function createErrorRecoveryHandler(options: {
-    onChunkError?: () => void;
-    onSessionExpired?: () => void;
-    onNetworkError?: () => void;
-    onGenericError?: (error: unknown) => void;
-}): (error: unknown) => void;
-
-/**
- * Fetch Interceptor Factory
- *
- * A flexible fetch wrapper with support for request/response interceptors,
- * automatic token refresh, and retry logic.
- *
- * Designed for production applications that need centralized HTTP handling.
- *
- * @module @omnitron-dev/prism/utils
- */
-
-/**
- * Extended request init with additional options.
- */
-interface FetchRequestInit extends RequestInit {
-    /** Skip all interceptors for this request */
-    skipInterceptors?: boolean;
-    /** Skip request interceptors only */
-    skipRequestInterceptors?: boolean;
-    /** Skip response interceptors only */
-    skipResponseInterceptors?: boolean;
-    /** Custom timeout in milliseconds */
-    timeout?: number;
-    /** Enable automatic retry on failure */
-    retry?: boolean | RetryConfig;
-    /** Request metadata for logging/debugging */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Request interceptor context.
- */
-interface RequestContext {
-    url: string;
-    init: FetchRequestInit;
-    /** Original request info (can be string or Request) */
-    input: RequestInfo | URL;
-    /** Request metadata */
-    metadata: Record<string, unknown>;
-}
-/**
- * Response interceptor context.
- */
-interface ResponseContext {
-    response: Response;
-    request: RequestContext;
-    /** Time taken for the request in ms */
-    duration: number;
-}
-/**
- * Error interceptor context.
- */
-interface ErrorContext {
-    error: unknown;
-    request: RequestContext;
-    /** Time taken before error in ms */
-    duration: number;
-    /** Number of retry attempts made */
-    retryCount: number;
-}
-/**
- * Request interceptor function.
- * Can modify the request or return a new one.
- */
-type RequestInterceptor = (ctx: RequestContext) => RequestContext | Promise<RequestContext>;
-/**
- * Response interceptor function.
- * Can modify the response or return a new one.
- */
-type ResponseInterceptor = (ctx: ResponseContext) => Response | Promise<Response>;
-/**
- * Error interceptor function.
- * Can handle the error, retry, or rethrow.
- */
-type ErrorInterceptor = (ctx: ErrorContext) => Response | Promise<Response> | never;
-/**
- * Interceptor configuration.
- */
-interface FetchInterceptorConfig {
-    /** Base URL to prepend to relative paths */
-    baseUrl?: string;
-    /** Default headers for all requests */
-    defaultHeaders?: HeadersInit;
-    /** Default timeout in milliseconds (0 = no timeout) */
-    defaultTimeout?: number;
-    /** Request interceptors (run in order) */
-    requestInterceptors?: RequestInterceptor[];
-    /** Response interceptors (run in order) */
-    responseInterceptors?: ResponseInterceptor[];
-    /** Error interceptors (run in order, first to handle wins) */
-    errorInterceptors?: ErrorInterceptor[];
-    /** Default retry configuration */
-    defaultRetry?: RetryConfig | false;
-    /** Credentials mode for all requests */
-    credentials?: RequestCredentials;
-}
-/**
- * Token refresh handler configuration.
- */
-interface TokenRefreshConfig {
-    /** Check if a response indicates token expiration */
-    isTokenExpired: (response: Response) => boolean;
-    /** Refresh the token (called when token is expired) */
-    refreshToken: () => Promise<string | null>;
-    /** Get the current access token */
-    getAccessToken: () => string | null;
-    /** Called when refresh fails (e.g., redirect to login) */
-    onRefreshFailure?: () => void;
-    /** Maximum number of refresh attempts */
-    maxRefreshAttempts?: number;
-}
-/**
- * Fetch client interface.
- */
-interface FetchClient {
-    /** Make a fetch request */
-    fetch: (input: RequestInfo | URL, init?: FetchRequestInit) => Promise<Response>;
-    /** Add a request interceptor */
-    addRequestInterceptor: (interceptor: RequestInterceptor) => () => void;
-    /** Add a response interceptor */
-    addResponseInterceptor: (interceptor: ResponseInterceptor) => () => void;
-    /** Add an error interceptor */
-    addErrorInterceptor: (interceptor: ErrorInterceptor) => () => void;
-    /** Remove all interceptors */
-    clearInterceptors: () => void;
-    /** Get current configuration */
-    getConfig: () => FetchInterceptorConfig;
-}
-/**
- * Create a fetch client with interceptor support.
- *
- * @example
- * ```tsx
- * // Basic usage
- * const api = createFetchClient({
- *   baseUrl: 'https://api.example.com',
- *   defaultHeaders: { 'Content-Type': 'application/json' },
- *   defaultTimeout: 30000,
- * });
- *
- * // Add auth header interceptor
- * api.addRequestInterceptor(async (ctx) => {
- *   const token = getAccessToken();
- *   if (token) {
- *     ctx.init.headers = {
- *       ...ctx.init.headers,
- *       Authorization: `Bearer ${token}`,
- *     };
- *   }
- *   return ctx;
- * });
- *
- * // Add response logging
- * api.addResponseInterceptor(async (ctx) => {
- *   console.log(`${ctx.request.init.method} ${ctx.request.url} - ${ctx.response.status} (${ctx.duration}ms)`);
- *   return ctx.response;
- * });
- *
- * // Make requests
- * const response = await api.fetch('/users');
- * const data = await response.json();
- * ```
- */
-declare function createFetchClient(config?: FetchInterceptorConfig): FetchClient;
-/**
- * Create a token refresh interceptor that automatically refreshes
- * expired tokens and retries failed requests.
- *
- * Uses AsyncLock to prevent multiple simultaneous refresh attempts.
- *
- * @example
- * ```tsx
- * const api = createFetchClient({ baseUrl: '/api' });
- *
- * const { addToClient } = createTokenRefreshInterceptor({
- *   isTokenExpired: (response) => response.status === 401,
- *   refreshToken: async () => {
- *     const response = await fetch('/auth/refresh', { method: 'POST' });
- *     const data = await response.json();
- *     localStorage.setItem('token', data.accessToken);
- *     return data.accessToken;
- *   },
- *   getAccessToken: () => localStorage.getItem('token'),
- *   onRefreshFailure: () => {
- *     localStorage.removeItem('token');
- *     window.location.href = '/login';
- *   },
- * });
- *
- * addToClient(api);
- * ```
- */
-declare function createTokenRefreshInterceptor(config: TokenRefreshConfig): {
-    addToClient: (client: FetchClient) => void;
-    refreshLock: AsyncLock;
-};
-/**
- * Create a simple JSON API client.
- *
- * @example
- * ```tsx
- * const api = createJsonApiClient({
- *   baseUrl: 'https://api.example.com',
- *   getAuthToken: () => localStorage.getItem('token'),
- * });
- *
- * // GET request
- * const users = await api.get<User[]>('/users');
- *
- * // POST request
- * const newUser = await api.post<User>('/users', { name: 'John' });
- *
- * // DELETE request
- * await api.delete('/users/1');
- * ```
- */
-declare function createJsonApiClient(options: {
-    baseUrl?: string;
-    getAuthToken?: () => string | null;
-    defaultHeaders?: Record<string, string>;
-    timeout?: number;
-}): {
-    client: FetchClient;
-    get: <T>(path: string) => Promise<T | null>;
-    post: <T>(path: string, body?: unknown) => Promise<T | null>;
-    put: <T>(path: string, body?: unknown) => Promise<T | null>;
-    patch: <T>(path: string, body?: unknown) => Promise<T | null>;
-    delete: <T>(path: string) => Promise<T | null>;
-};
-
-/**
- * JWT Utilities
- *
- * Client-side JWT decoding and validation utilities.
- * These utilities do NOT verify signatures - they only decode and check expiration.
- * For signature verification, use server-side libraries.
- *
- * @module @omnitron-dev/prism/utils
- */
-/**
- * Standard JWT claims.
- * @see https://datatracker.ietf.org/doc/html/rfc7519#section-4.1
- */
-interface JwtStandardClaims {
-    /** Issuer */
-    iss?: string;
-    /** Subject */
-    sub?: string;
-    /** Audience */
-    aud?: string | string[];
-    /** Expiration time (Unix timestamp in seconds) */
-    exp?: number;
-    /** Not before (Unix timestamp in seconds) */
-    nbf?: number;
-    /** Issued at (Unix timestamp in seconds) */
-    iat?: number;
-    /** JWT ID */
-    jti?: string;
-}
-/**
- * JWT payload with custom claims.
- * Extends standard claims with any additional properties.
- */
-interface JwtPayload extends JwtStandardClaims {
-    /** User ID (common custom claim) */
-    userId?: string;
-    /** Email (common custom claim) */
-    email?: string;
-    /** Roles (common custom claim) */
-    roles?: string[];
-    /** Permissions (common custom claim) */
-    permissions?: string[];
-    /** Any additional custom claims */
-    [key: string]: unknown;
-}
-/**
- * JWT validation options.
- */
-interface JwtValidationOptions {
-    /** Clock skew tolerance in seconds (default: 60) */
-    clockTolerance?: number;
-    /** Require expiration claim (default: true) */
-    requireExp?: boolean;
-}
-/**
- * JWT decode result.
- */
-interface JwtDecodeResult<T extends JwtPayload = JwtPayload> {
-    /** Decoded header */
-    header: {
-        alg: string;
-        typ?: string;
-        [key: string]: unknown;
-    };
-    /** Decoded payload */
-    payload: T;
-    /** Original signature (base64url encoded, NOT verified) */
-    signature: string;
-}
-/**
- * Decode a JWT token without verifying the signature.
- *
- * ⚠️ WARNING: This function does NOT verify the signature.
- * Only use for client-side display purposes. Never trust decoded
- * data for authorization decisions without server-side verification.
- *
- * @param token - The JWT token string
- * @returns Decoded JWT parts (header, payload, signature)
- * @throws Error if the token is malformed
- *
- * @example
- * ```tsx
- * const token = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...';
- *
- * try {
- *   const { header, payload } = jwtDecode(token);
- *   console.log('Algorithm:', header.alg);
- *   console.log('User ID:', payload.sub);
- *   console.log('Expires:', new Date(payload.exp! * 1000));
- * } catch (error) {
- *   console.error('Invalid token:', error.message);
- * }
- * ```
- */
-declare function jwtDecode<T extends JwtPayload = JwtPayload>(token: string): JwtDecodeResult<T>;
-/**
- * Decode only the payload from a JWT token.
- * Convenience function when you only need the claims.
- *
- * @param token - The JWT token string
- * @returns Decoded payload
- * @throws Error if the token is malformed
- *
- * @example
- * ```tsx
- * const payload = jwtDecodePayload(token);
- * console.log('User:', payload.email);
- * ```
- */
-declare function jwtDecodePayload<T extends JwtPayload = JwtPayload>(token: string): T;
-/**
- * Check if a JWT token is expired.
- *
- * @param token - The JWT token string
- * @param options - Validation options
- * @returns true if the token is expired or invalid, false if still valid
- *
- * @example
- * ```tsx
- * if (isTokenExpired(token)) {
- *   // Redirect to login or refresh token
- *   refreshAccessToken();
- * }
- * ```
- */
-declare function isTokenExpired(token: string, options?: JwtValidationOptions): boolean;
-/**
- * Check if a JWT token is valid (not expired, not before nbf).
- *
- * @param token - The JWT token string
- * @param options - Validation options
- * @returns true if the token is valid, false otherwise
- *
- * @example
- * ```tsx
- * function AuthProvider({ children }) {
- *   const [token] = useLocalStorage('accessToken');
- *
- *   if (!token || !isValidToken(token)) {
- *     return <Navigate to="/login" />;
- *   }
- *
- *   return children;
- * }
- * ```
- */
-declare function isValidToken(token: string, options?: JwtValidationOptions): boolean;
-/**
- * Get time until token expires in seconds.
- * Returns 0 if token is already expired or invalid.
- *
- * @param token - The JWT token string
- * @returns Seconds until expiration, or 0 if expired/invalid
- *
- * @example
- * ```tsx
- * const secondsLeft = getTokenTimeLeft(token);
- *
- * if (secondsLeft < 300) {
- *   // Less than 5 minutes left, refresh proactively
- *   refreshToken();
- * }
- * ```
- */
-declare function getTokenTimeLeft(token: string): number;
-/**
- * Get expiration date from token.
- *
- * @param token - The JWT token string
- * @returns Date object for expiration, or null if no exp claim or invalid token
- *
- * @example
- * ```tsx
- * const expiresAt = getTokenExpirationDate(token);
- * if (expiresAt) {
- *   console.log('Token expires:', expiresAt.toLocaleString());
- * }
- * ```
- */
-declare function getTokenExpirationDate(token: string): Date | null;
-/**
- * Safely get a claim from a token.
- *
- * @param token - The JWT token string
- * @param claim - The claim name to extract
- * @returns The claim value or undefined if not present/invalid
- *
- * @example
- * ```tsx
- * const userId = getTokenClaim(token, 'sub');
- * const roles = getTokenClaim<string[]>(token, 'roles') ?? [];
- * ```
- */
-declare function getTokenClaim<T>(token: string, claim: string): T | undefined;
-/**
- * Get the subject (user identifier) from a token.
- *
- * @param token - The JWT token string
- * @returns The subject claim or undefined
- */
-declare function getTokenSubject(token: string): string | undefined;
-/**
- * Check if token has a specific role.
- *
- * @param token - The JWT token string
- * @param role - The role to check for
- * @param rolesKey - The key in the payload containing roles (default: 'roles')
- * @returns true if the token contains the role
- *
- * @example
- * ```tsx
- * if (tokenHasRole(token, 'admin')) {
- *   // Show admin features
- * }
- * ```
- */
-declare function tokenHasRole(token: string, role: string, rolesKey?: string): boolean;
-/**
- * Check if token has a specific permission.
- *
- * @param token - The JWT token string
- * @param permission - The permission to check for
- * @param permissionsKey - The key in the payload containing permissions (default: 'permissions')
- * @returns true if the token contains the permission
- */
-declare function tokenHasPermission(token: string, permission: string, permissionsKey?: string): boolean;
-
-/**
- * Template variable resolver.
- *
- * Replaces `{{namespace.key}}` patterns in text with values from a context map.
- * Used for injecting dynamic config values into help content at render time.
- *
- * @example
- * resolveTemplateVariables("Fee: {{config.sellerFee}}%", { "config.sellerFee": "5" })
- * // => "Fee: 5%"
- */
-declare function resolveTemplateVariables(text: string, context: Record<string, string | number>): string;
-
-/**
- * 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, paysys 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 @omnitron-dev/prism/utils/i18n-text
- */
-/** A bag of language-keyed strings. Keys are RFC 5646 language codes
- * (or just `'en'`, `'ru'` for simple two-locale platforms). */
-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
- * DAOS categories, achievements etc. */
-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`.
- */
-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.
- */
-declare function i18nHaystack(bag: object | null | undefined, extra?: readonly string[]): string;
-
-/**
- * Toast wrapper with short-window deduplication.
- *
- * Problem: identical toast.error() calls fire twice in dev (React
- * StrictMode double-mounts every effect), and can also fire twice
- * in prod when a parent re-fetches mid-flight or a retry wrapper
- * surfaces the same error path. Sonner has no built-in dedupe, so
- * every duplicate landed as a separate snack-bar.
- *
- * Fix: collapse identical {method, message} calls inside a 1.5 s
- * window. The first call lands; subsequent identical calls within
- * the window are silently dropped. We DON'T forward to sonner's
- * own `id` option because then any later call with a different
- * message but the same id would *replace* the visible toast — we
- * want suppression, not replacement.
- *
- * Drop-in replacement for `import { toast } from 'sonner'`.
- * Same surface: error/success/info/warning + the passthroughs.
- *
- * Lives in prism so every UI app on the platform shares one
- * notification policy instead of each app reinventing it.
- */
-
-declare const toast: typeof toast$1;
-
-/**
- * Canonical BTC / XMR amount formatter.
- *
- * Why this exists
- * ---------------
- * Pre-consolidation the platform had ~8 independent formatters,
- * each shipping its own opinion of precision:
- *
- *   - `org-finances/formatBtc`     → BTC 8, XMR 4
- *   - `org-revenue-card`           → BTC 4, XMR 4
- *   - `orgs-overview/formatBtc`    → tiered 8 → 4 → 2 by magnitude
- *   - `shop-dashboard`             → BTC 4
- *   - `shop-categories`            → BTC 8 with trailing-zero trim
- *   - `finances/hooks`             → BTC 8, XMR 8 (already canonical
- *                                    but isolated from everyone else)
- *   - `pages/finances DEFAULT_ASSETS` → XMR 12 (wire-precision leak)
- *
- * Result: a single dashboard showed BTC 4 in the KPI tile, BTC 8
- * in the Financial Overview tile, and BTC 6 in another corner —
- * three "truths" for the same value. This module is the single
- * source of truth from now on; all call sites import from here.
- *
- * Display vs wire precision
- * -------------------------
- * Wire precision (what the backend stores) is 8 for BTC, 12 for
- * XMR — those are the on-chain atomic units (satoshi, piconero).
- * Display precision is 8 for BOTH coins by platform convention:
- *
- *   - 8 fractional digits is a satoshi-level read for BTC,
- *   - 8 fractional digits for XMR is "good enough" for human eyes
- *     and keeps the column widths symmetric. The last 4 digits of
- *     XMR's wire value are dropped from display only — never from
- *     storage, math, or wire transfers.
- *
- * The platform-wide symmetric formatting was a direct user-facing
- * request: the same coin column should align cleanly whether the
- * row holds BTC or XMR.
- *
- * If you need a *narrower* surface (a dense table, a stat-card
- * subtitle), use `{ trim: true }` to drop trailing zeros while
- * keeping the canonical precision as the cap. Don't bypass this
- * module with an ad-hoc `toFixed(N)` — that's exactly the entropy
- * we just cleaned up.
- */
-/**
- * Canonical display-precision per supported coin. Use this when
- * you need the raw precision number (e.g. populating an input
- * field's `.toFixed(...)` to seed a "max balance" button). For
- * actual rendering of a value, prefer `formatCoinAmount`.
- */
-declare const COIN_DISPLAY_DECIMALS: Readonly<Record<string, number>>;
-interface FormatCoinAmountOptions {
-    /**
-     * Append the uppercase coin symbol (`"0.00012345 BTC"`).
-     * Default `true`. Disable for places where the symbol is
-     * rendered separately (e.g. a chip beside the number).
-     */
-    withSymbol?: boolean;
-    /**
-     * Trim trailing zeros after the decimal point. Useful in dense
-     * tables where `0 BTC` reads cleaner than `0.00000000 BTC`. The
-     * precision cap (8) is still honoured — we just drop tail
-     * zeros up to and including the decimal point. Default `false`.
-     */
-    trim?: boolean;
-    /**
-     * Override precision. ONLY use this for legacy back-compat
-     * (e.g. a screen that genuinely needs to truncate at a non-
-     * standard width). Prefer the default. Negative values clamp
-     * to 0.
-     */
-    precision?: number;
-    /**
-     * Custom symbol override. Defaults to `coin.toUpperCase()`. Set
-     * this if you need a non-standard label (e.g. "₿" for BTC) —
-     * but be aware that mixing symbols across the platform is what
-     * this module was built to prevent.
-     */
-    symbol?: string;
-}
-/**
- * Resolve the canonical display precision for a coin code.
- * Case-insensitive. Unknown codes fall back to 8.
- */
-declare function getCoinDecimals(coin: string): number;
-/**
- * Format a crypto amount for display.
- *
- * Input can be a string (preferred — preserves full precision
- * end-to-end from the RPC wire) or a number. Non-finite / NaN
- * inputs render as the zero-shaped placeholder so the UI never
- * shows `NaN BTC`.
- *
- * @example
- *   formatCoinAmount('0.001', 'BTC')                 // '0.00100000 BTC'
- *   formatCoinAmount('0.001', 'BTC', { trim: true }) // '0.001 BTC'
- *   formatCoinAmount(null, 'XMR')                    // '0.00000000 XMR'
- *   formatCoinAmount('1.23456789', 'BTC', { withSymbol: false }) // '1.23456789'
- */
-declare function formatCoinAmount(value: string | number | null | undefined, coin: string, options?: FormatCoinAmountOptions): string;
-/**
- * Render a multi-coin total map (e.g. revenue across coins)
- * as a single inline string: `"0.00010000 BTC · 0.00000000 XMR"`.
- *
- * Stable ordering by lower-cased coin code so BTC always appears
- * before XMR regardless of object-property iteration quirks.
- */
-declare function formatCoinAmountList(totals: Partial<Record<string, string | number | null | undefined>>, options?: FormatCoinAmountOptions & {
-    separator?: string;
-}): string;
-
-export { AsyncLock, type AsyncLockOptions, type AsyncLockResult, type AsyncLockState, AsyncLockTimeoutError, COIN_DISPLAY_DECIMALS, DEFAULT_CLASS_PREFIX, DEFAULT_ERROR_MESSAGES, type DateDurationPreset, type DateInput, type ErrorCode, type ErrorContext$1 as ErrorContext, type ErrorInterceptor, type ErrorMessages, type ErrorSeverity, type FetchClient, type ErrorContext as FetchErrorContext, type FetchInterceptorConfig, type FetchRequestInit, type FormatCoinAmountOptions, type FormatCurrencyOptions, type FormatDateOptions, type FormatNumberOptions, type I18nResolvable, type I18nText, type JwtDecodeResult, type JwtPayload, type JwtStandardClaims, type JwtValidationOptions, type MergeableRef, type RequestContext, type RequestInterceptor, type ResponseContext, type ResponseInterceptor, type RetryConfig, type SafeReturnUrlOptions, type StateProps, type StorageOptions, type StorageWithExpiryOptions, type TokenRefreshConfig, type TransformNumberOptions, type TranslateFn, type TranslatedError, addDays, addMonths, buildUrl, calculatePercentageChange, camelCase, capitalize, clampNumber, classifyHttpError, clearStorage, cn, containsIgnoreCase, createAsyncLock, createClasses, createClassesObject, createComponentClasses, createErrorRecoveryHandler, createErrorTranslator, createFetchClient, createJsonApiClient, createNumberInputHandlers, createTokenRefreshInterceptor, createTokenRefreshLock, deepClone, diffInDays, endOfDay, escapeRegExp, extractErrorContext, fBytes, fCompact, fCurrency, fDate, fDateISO, fDateTime, fDecimal, fDuration, fNumber, fNumberWithSign, fOrdinal, fPercent, fRelativeTime, fShortenNumber, fTime, formatCoinAmount, formatCoinAmountList, getClassPrefix, getCoinDecimals, getCurrencySymbol, getDates, getDirectionalProperty, getErrorSeverity, getFutureDates, getInitials, getPastDates, getPercentage, getQueryParam, getStorage, getStorageKeys, getStorageSize, getStorageWithExpiry, getTokenClaim, getTokenExpirationDate, getTokenSubject, getTokenTimeLeft, hasKeys, hasParams, hasRefValue, highlightText, i18nHaystack, isActiveLink, isBlank, isChunkLoadError, isEmail, isEmpty, isEqualPath, isExternalLink, isExternalUrl, isFuture, isNetworkError, isPast, isRetryableError, isRtlDirection, isSessionExpiredError, isThisWeek, isToday, isTokenExpired, isUrl, isValidToken, isYesterday, jwtDecode, jwtDecodePayload, kebabCase, localStorageAvailable, locked, mergeClasses, mergeRefs, noRtlFlip, omit, parseNumber, parseQueryParams, pick, pxToRem, randomString, remToPx, removeLastSlash, removeParams, removeStorage, resolveI18n, resolveTemplateVariables, responsiveFontSize, roundToDecimals, safeReturnUrl, sessionStorageAvailable, setClassPrefix, setFont, setRef, setStorage, setStorageWithExpiry, slugify, snakeCase, startOfDay, titleCase, toast, tokenHasPermission, tokenHasRole, transformForDisplay, transformOnBlur, transformOnChange, truncate, uuid, withLock, withRetry };
+ * Prism Design System
+ *
+ * A powerful, production-ready design framework built on MUI.
+ * Combines the best of shadcn/ui's copy-paste model with MUI's robust
+ * component infrastructure.
+ *
+ * @module @omnitron-dev/prism
+ */
+export * from './theme/index.js';
+export * from './core/index.js';
+export * from './components/index.js';
+export * from './utils/index.js';
+export * from './registry/index.js';
+export * from './layouts/index.js';
+export * from './types/index.js';
+export * from './state/index.js';
+export * from './hooks/index.js';
+export * from './netron/index.js';
+//# sourceMappingURL=index.d.ts.map