@omnitron-dev/prism 0.2.0 → 0.3.1

package/dist/core/index.d.ts

@@ -1,469 +1,37 @@
-import * as react from 'react';
-import { ReactNode, ComponentType, FC } from 'react';
-import { b as PrismConfig, P as PartialPrismConfig } from '../config-Pct0n_Kq.js';
-import { k as PrismTheme, o as ThemeMode, q as ThemePreset, n as ThemeDirection } from '../theme-B4Q3Bg5o.js';
-import { a as NavLayout, N as NavColor } from '../settings-CAC0qFjS.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';
-import { SxProps, Theme } from '@mui/material';
-export { useMediaQuery } from '@mui/material';
-import '../registry-DQcIzW2s.js';
-import '@mui/material/styles';
-import 'zustand';
-
 /**
- * Settings state managed by Prism.
- * @deprecated Use useSettingsStore from '@omnitron-dev/prism/state' for full settings access.
- * This interface is maintained for backwards compatibility with PrismContext.
- */
-interface PrismSettingsState {
-    /** Current theme mode */
-    mode: ThemeMode;
-    /** Current theme preset */
-    preset: ThemePreset;
-    /** Text direction */
-    direction: ThemeDirection;
-    /** Sidebar collapsed state */
-    sidebarCollapsed: boolean;
-    /** Settings drawer open */
-    settingsDrawerOpen: boolean;
-    /** Primary color override */
-    primaryColor: string | null;
-    /** High contrast mode */
-    contrast: 'default' | 'high';
-    /** Base font size (12-20) */
-    fontSize: number;
-    /** Selected font family */
-    fontFamily: string;
-    /** Navigation layout */
-    navLayout: NavLayout;
-    /** Navigation color mode */
-    navColor: NavColor;
-}
-/**
- * Prism context value.
- */
-interface PrismContextValue {
-    /** Current configuration */
-    config: PrismConfig;
-    /** Current theme */
-    theme: PrismTheme;
-    /** Settings state */
-    settings: PrismSettingsState;
-    /** Set theme mode */
-    setMode: (mode: ThemeMode) => void;
-    /** Toggle between light/dark */
-    toggleMode: () => void;
-    /** Set theme preset */
-    setPreset: (preset: ThemePreset) => void;
-    /** Set text direction */
-    setDirection: (direction: ThemeDirection) => void;
-    /** Toggle sidebar */
-    toggleSidebar: () => void;
-    /** Set sidebar collapsed */
-    setSidebarCollapsed: (collapsed: boolean) => void;
-    /** Open settings drawer */
-    openSettingsDrawer: () => void;
-    /** Close settings drawer */
-    closeSettingsDrawer: () => void;
-    /** Toggle settings drawer */
-    toggleSettingsDrawer: () => void;
-    /** Reset all settings to defaults */
-    resetSettings: () => void;
-}
-/**
- * Prism context.
- */
-declare const PrismContext: react.Context<PrismContextValue | null>;
-/**
- * Hook to access Prism context.
- *
- * @returns Prism context value
- * @throws If used outside PrismProvider
- *
- * @example
- * ```tsx
- * function MyComponent() {
- *   const { theme, setMode, toggleSidebar } = usePrismContext();
- *
- *   return (
- *     <Button onClick={() => setMode('dark')}>
- *       Switch to Dark Mode
- *     </Button>
- *   );
- * }
- * ```
- */
-declare function usePrismContext(): PrismContextValue;
-
-/**
- * Prism Provider
- *
- * Root provider for the Prism design system.
- * Uses useSettingsStore (Zustand) as the single source of truth for settings.
- *
- * @module @omnitron-dev/prism/core/provider
- */
-
-/**
- * Props for PrismProvider.
- */
-interface PrismProviderProps {
-    /** Child components */
-    children: ReactNode;
-    /** Configuration overrides */
-    config?: PartialPrismConfig;
-    /** Default settings (overrides defaults but not persisted values) */
-    defaultSettings?: Partial<PrismSettingsState>;
-    /** Disable CSS baseline */
-    disableCssBaseline?: boolean;
-    /** Custom theme overrides */
-    themeOverrides?: Record<string, unknown>;
-    /**
-     * Locale code passed to MUI's `LocalizationProvider` as
-     * `adapterLocale` — e.g. `'ru'`, `'en'`. Must be a locale already
-     * registered with dayjs (e.g. `import 'dayjs/locale/ru'`).
-     * Switches calendar month/weekday labels and date masks.
-     * If omitted, MUI falls back to dayjs's global locale (English).
-     */
-    dateAdapterLocale?: string;
-    /**
-     * Override for MUI x-date-pickers' built-in strings
-     * (e.g. ARIA labels, toolbar text). Passed straight through to
-     * `LocalizationProvider.localeText`. Typically pulled from
-     * `@mui/x-date-pickers/locales` (e.g. `ruRU.components.MuiLocalizationProvider.defaultProps.localeText`).
-     */
-    dateLocaleText?: Record<string, unknown>;
-}
-/**
- * PrismProvider - Root provider for Prism design system.
- *
- * Provides theme, settings, and configuration to all child components.
- * Uses Zustand's useSettingsStore as the single source of truth for settings.
- *
- * @example
- * ```tsx
- * import { PrismProvider } from '@omnitron-dev/prism';
- *
- * function App() {
- *   return (
- *     <PrismProvider
- *       config={{
- *         theme: { preset: 'luxury', mode: 'dark' },
- *         features: { darkMode: true, rtl: true },
- *       }}
- *     >
- *       <YourApp />
- *     </PrismProvider>
- *   );
- * }
- * ```
- */
-declare function PrismProvider({ children, config: configOverrides, defaultSettings, disableCssBaseline, themeOverrides, dateAdapterLocale, dateLocaleText, }: PrismProviderProps): ReactNode;
-
-/**
- * Provider Stack Utilities
- *
- * Composable provider pattern for building flexible provider hierarchies.
- *
- * @module @omnitron-dev/prism/core/provider-stack
- */
-
-/**
- * A provider component with its props.
- */
-type ProviderEntry<P = Record<string, unknown>> = [ComponentType<P & {
-    children: ReactNode;
-}>, P];
-/**
- * A provider that takes only children.
- */
-type SimpleProvider = ComponentType<{
-    children: ReactNode;
-}>;
-/**
- * Provider entry that can be a simple component or a tuple with props.
- */
-type ProviderConfig = SimpleProvider | ProviderEntry;
-/**
- * Options for createProviderStack.
- */
-interface ProviderStackOptions {
-    /** Display name for debugging */
-    displayName?: string;
-}
-/**
- * Compose multiple providers into a single component.
- * Providers are applied from left to right (first provider wraps outermost).
- *
- * @param providers - Array of providers to compose
- * @returns A single component that renders all providers
- *
- * @example
- * ```tsx
- * const AppProviders = composeProviders([
- *   ThemeProvider,
- *   [AuthProvider, { client: authClient }],
- *   [QueryProvider, { client: queryClient }],
- *   ToastProvider,
- * ]);
- *
- * function App() {
- *   return (
- *     <AppProviders>
- *       <YourApp />
- *     </AppProviders>
- *   );
- * }
- * ```
- */
-declare function composeProviders(providers: ProviderConfig[]): FC<{
-    children: ReactNode;
-}>;
-/**
- * Create a provider stack factory for building customizable provider hierarchies.
- *
- * @param baseProviders - Base providers that are always included
- * @param options - Configuration options
- * @returns A factory function for creating provider components
- *
- * @example
- * ```tsx
- * // Define base stack
- * const createAppProviders = createProviderStack([
- *   ThemeProvider,
- *   [I18nProvider, { locale: 'en' }],
- * ]);
- *
- * // Create with additional providers
- * const AppProviders = createAppProviders({
- *   prepend: [ErrorBoundaryProvider],
- *   append: [ToastProvider, NotificationProvider],
- * });
- *
- * // Or use without modifications
- * const SimpleProviders = createAppProviders();
- * ```
- */
-declare function createProviderStack(baseProviders: ProviderConfig[], options?: ProviderStackOptions): (config?: {
-    prepend?: ProviderConfig[];
-    append?: ProviderConfig[];
-    replace?: ProviderConfig[];
-}) => FC<{
-    children: ReactNode;
-}>;
-/**
- * Props for ProviderStack component.
- */
-interface ProviderStackProps {
-    /** Provider configurations */
-    providers: ProviderConfig[];
-    /** Child components */
-    children: ReactNode;
-}
-/**
- * ProviderStack - Declarative provider composition component.
- *
- * @example
- * ```tsx
- * function App() {
- *   const providers = useMemo(() => [
- *     ThemeProvider,
- *     [AuthProvider, { client }],
- *     ToastProvider,
- *   ], [client]);
- *
- *   return (
- *     <ProviderStack providers={providers}>
- *       <YourApp />
- *     </ProviderStack>
- *   );
- * }
- * ```
- */
-declare function ProviderStack({ providers, children }: ProviderStackProps): ReactNode;
-/**
- * Create a provider component with bound props.
- * Useful for creating reusable provider configurations.
- *
- * @param Provider - The provider component
- * @param props - Props to bind to the provider
- * @returns A new component with bound props
- *
- * @example
- * ```tsx
- * const BoundQueryProvider = withProviderProps(QueryClientProvider, {
- *   client: queryClient,
- * });
- *
- * // Use like a simple provider
- * <BoundQueryProvider>
- *   <App />
- * </BoundQueryProvider>
- * ```
- */
-declare function withProviderProps<P extends object>(Provider: ComponentType<P & {
-    children: ReactNode;
-}>, props: P): SimpleProvider;
-/**
- * Create a conditional provider that only renders when condition is true.
- *
- * @param Provider - The provider component
- * @param condition - Whether to render the provider
- * @returns A provider that renders conditionally
- *
- * @example
- * ```tsx
- * const providers = [
- *   ThemeProvider,
- *   conditionalProvider(DevToolsProvider, process.env.NODE_ENV === 'development'),
- *   AuthProvider,
- * ];
- * ```
- */
-declare function conditionalProvider<P extends {
-    children: ReactNode;
-}>(Provider: ComponentType<P>, condition: boolean, props?: Omit<P, 'children'>): ProviderConfig | null;
-/**
- * Filter out null/undefined providers from a provider array.
- *
- * @param providers - Array of providers that may contain nulls
- * @returns Filtered array of valid providers
- *
- * @example
- * ```tsx
- * const providers = filterProviders([
- *   ThemeProvider,
- *   conditionalProvider(DevToolsProvider, isDev),
- *   conditionalProvider(MockProvider, isMocking),
- *   AuthProvider,
- * ]);
- * ```
- */
-declare function filterProviders(providers: (ProviderConfig | null | undefined)[]): ProviderConfig[];
-
-/**
- * Skip Link Component
- *
- * Provides keyboard users a way to skip navigation and jump to main content.
- *
- * @module @omnitron-dev/prism/core/accessibility/skip-link
- */
-
-/**
- * Props for SkipLink component.
- */
-interface SkipLinkProps {
-    /** Target element ID to skip to */
-    href: string;
-    /** Link content (typically "Skip to main content") */
-    children: ReactNode;
-    /** MUI sx prop */
-    sx?: SxProps<Theme>;
-}
-/**
- * Skip link that is visually hidden until focused.
- * Allows keyboard users to skip navigation and jump to main content.
- *
- * @example
- * ```tsx
- * <SkipLink href="#main-content">Skip to main content</SkipLink>
- * ```
- */
-declare function SkipLink({ href, children, sx }: SkipLinkProps): ReactNode;
-
-/**
- * Accessibility Utilities
- *
- * WCAG 2.1 compliant accessibility components and utilities.
- *
- * @module @omnitron-dev/prism/core/accessibility
- */
-
-/**
- * Generate ID for accessibility references.
- */
-declare function generateAriaId(prefix: string): string;
-/**
- * Combine multiple aria-describedby values.
- */
-declare function combineAriaDescribedBy(...ids: (string | undefined)[]): string | undefined;
-/**
- * Screen reader only styles (visually hidden but accessible).
- */
-declare const srOnly: {
-    position: "absolute";
-    width: string;
-    height: string;
-    padding: number;
-    margin: string;
-    overflow: string;
-    clip: string;
-    whiteSpace: "nowrap";
-    border: number;
-};
-/**
- * Focus visible styles for keyboard navigation.
- */
-declare const focusVisibleStyles: (theme: {
-    palette: {
-        primary: {
-            main: string;
-        };
-    };
-}) => {
-    '&:focus-visible': {
-        outline: string;
-        outlineOffset: number;
-    };
-};
-/**
- * Handle keyboard navigation for list items.
- */
-declare function handleListKeyDown(event: React.KeyboardEvent, options: {
-    items: HTMLElement[];
-    currentIndex: number;
-    onSelect?: (index: number) => void;
-    orientation?: 'vertical' | 'horizontal';
-}): void;
-/**
- * Standard ARIA landmark labels.
- */
-declare const ARIA_LABELS: {
-    /** Main navigation */
-    readonly mainNav: "Main navigation";
-    /** Secondary navigation */
-    readonly secondaryNav: "Secondary navigation";
-    /** Search */
-    readonly search: "Search";
-    /** Main content */
-    readonly main: "Main content";
-    /** Header */
-    readonly header: "Header";
-    /** Footer */
-    readonly footer: "Footer";
-    /** Sidebar */
-    readonly sidebar: "Sidebar";
-    /** Breadcrumb navigation */
-    readonly breadcrumb: "Breadcrumb navigation";
-    /** User menu */
-    readonly userMenu: "User menu";
-    /** Settings */
-    readonly settings: "Settings";
-};
-/**
- * Common ARIA expanded patterns.
- */
-interface AriaExpandedProps {
-    'aria-expanded': boolean;
-    'aria-controls'?: string;
-}
-/**
- * Get aria-expanded props.
- */
-declare function getAriaExpanded(expanded: boolean, controlsId?: string): AriaExpandedProps;
-/**
- * Announce message to screen readers.
- */
-declare function announceToScreenReader(message: string, priority?: 'polite' | 'assertive'): void;
-
-export { ARIA_LABELS, type AriaExpandedProps, PrismContext, PrismProvider, type PrismProviderProps, type ProviderConfig, type ProviderEntry, ProviderStack, type ProviderStackOptions, type ProviderStackProps, type SimpleProvider, SkipLink, type SkipLinkProps, announceToScreenReader, combineAriaDescribedBy, composeProviders, conditionalProvider, createProviderStack, filterProviders, focusVisibleStyles, generateAriaId, getAriaExpanded, handleListKeyDown, srOnly, usePrismContext, withProviderProps };
+ * Prism Core Module
+ *
+ * Core providers, hooks, and utilities for the Prism design system.
+ *
+ * @module @omnitron-dev/prism/core
+ */
+export { PrismProvider } from './provider.js';
+export type { PrismProviderProps, PrismThemeOverrides, PrismThemeOverrideContext } from './provider.js';
+export { composeProviders, createProviderStack, ProviderStack, withProviderProps, conditionalProvider, filterProviders, } from './provider-stack.js';
+export type { ProviderEntry, SimpleProvider, ProviderConfig, ProviderStackOptions, ProviderStackProps, } from './provider-stack.js';
+export { PrismContext, usePrismContext } from './context.js';
+export { useBoolean } from './hooks/use-boolean.js';
+export { useSetState } from './hooks/use-set-state.js';
+export type { SetState, UseSetStateReturn } from './hooks/use-set-state.js';
+export { useMultiSelect } from './hooks/use-multi-select.js';
+export type { UseMultiSelectOptions, UseMultiSelectReturn } from './hooks/use-multi-select.js';
+export { useLocalStorage } from './hooks/use-local-storage.js';
+export { useCopyToClipboard } from './hooks/use-copy-to-clipboard.js';
+export type { CopyState, UseCopyToClipboardReturn, UseCopyToClipboardOptions } from './hooks/use-copy-to-clipboard.js';
+export { useDebounce, useDebounceCallback } from './hooks/use-debounce.js';
+export { useCountdown } from './hooks/use-countdown.js';
+export type { CountdownState, CountdownControls, UseCountdownReturn, UseCountdownOptions, } from './hooks/use-countdown.js';
+export { useBreakpoints } from './hooks/use-breakpoints.js';
+export { useMediaQuery } from './hooks/use-media-query.js';
+export { useIsClient } from './hooks/use-is-client.js';
+export { useMounted } from './hooks/use-mounted.js';
+export type { UseMountedReturn } from './hooks/use-mounted.js';
+export { usePrevious } from './hooks/use-previous.js';
+export { useEventListener } from './hooks/use-event-listener.js';
+export { useClickOutside } from './hooks/use-click-outside.js';
+export { useInterval } from './hooks/use-interval.js';
+export { useTimeout } from './hooks/use-timeout.js';
+export type { UseTimeoutReturn } from './hooks/use-timeout.js';
+export { SkipLink, generateAriaId, combineAriaDescribedBy, srOnly, focusVisibleStyles, handleListKeyDown, ARIA_LABELS, getAriaExpanded, announceToScreenReader, } from './accessibility/index.js';
+export type { SkipLinkProps, AriaExpandedProps } from './accessibility/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAGxG,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAG/F,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,YAAY,EAAE,SAAS,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAGvH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/D,OAAO,EACL,QAAQ,EACR,cAAc,EACd,sBAAsB,EACtB,MAAM,EACN,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/core/index.js

@@ -1,9 +1,12 @@
-export { PrismContext, PrismProvider, ProviderStack, composeProviders, conditionalProvider, createProviderStack, filterProviders, useBreakpoints, useClickOutside, useCopyToClipboard, useCountdown, useDebounce, useDebounceCallback, useEventListener, useInterval, useIsClient, useLocalStorage, useMuiMediaQuery as useMediaQuery, useMounted, useMultiSelect, usePrevious, usePrismContext, useSetState, useTimeout, withProviderProps } from '../chunk-XXP3ZGU6.js';
-import '../chunk-MEFT6XPH.js';
-export { ARIA_LABELS, SkipLink, announceToScreenReader, combineAriaDescribedBy, focusVisibleStyles, generateAriaId, getAriaExpanded, handleListKeyDown, srOnly } from '../chunk-JDTC2SBY.js';
-export { useBoolean } from '../chunk-HO2GKTWJ.js';
-import '../chunk-XWL6J6IO.js';
-import '../chunk-DDY7TLUI.js';
-import '../chunk-77KIJLPP.js';
+export { PrismContext, PrismProvider, ProviderStack, composeProviders, conditionalProvider, createProviderStack, filterProviders, useBreakpoints, useClickOutside, useCopyToClipboard, useCountdown, useDebounce, useDebounceCallback, useEventListener, useInterval, useIsClient, useLocalStorage, useMuiMediaQuery as useMediaQuery, useMounted, useMultiSelect, usePrevious, usePrismContext, useSetState, useTimeout, withProviderProps } from '../chunk-OKTLA23Q.js';
+import '../chunk-YSIG2XYH.js';
+import '../chunk-KQ67XB6T.js';
+import '../chunk-75FQ5IW3.js';
+export { ARIA_LABELS, SkipLink, announceToScreenReader, combineAriaDescribedBy, focusVisibleStyles, generateAriaId, getAriaExpanded, handleListKeyDown, srOnly } from '../chunk-AD4W7HYC.js';
+import '../chunk-XIXSSI3B.js';
+import '../chunk-HOXFSQUV.js';
+export { useBoolean } from '../chunk-BRDWQVRT.js';
+import '../chunk-PGHEP4JD.js';
+import '../chunk-BJE2AKD4.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map