@omnitron-dev/prism 0.2.0 → 0.3.0

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

@@ -0,0 +1,96 @@
+/**
+ * Accessibility Utilities
+ *
+ * WCAG 2.1 compliant accessibility components and utilities.
+ *
+ * @module core/accessibility
+ */
+export { SkipLink } from './skip-link.js';
+export type { SkipLinkProps } from './skip-link.js';
+/**
+ * Generate ID for accessibility references.
+ */
+export declare function generateAriaId(prefix: string): string;
+/**
+ * Combine multiple aria-describedby values.
+ */
+export declare function combineAriaDescribedBy(...ids: (string | undefined)[]): string | undefined;
+/**
+ * Screen reader only styles (visually hidden but accessible).
+ */
+export 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.
+ */
+export declare const focusVisibleStyles: (theme: {
+    palette: {
+        primary: {
+            main: string;
+        };
+    };
+}) => {
+    '&:focus-visible': {
+        outline: string;
+        outlineOffset: number;
+    };
+};
+/**
+ * Handle keyboard navigation for list items.
+ */
+export declare function handleListKeyDown(event: React.KeyboardEvent, options: {
+    items: HTMLElement[];
+    currentIndex: number;
+    onSelect?: (index: number) => void;
+    orientation?: 'vertical' | 'horizontal';
+}): void;
+/**
+ * Standard ARIA landmark labels.
+ */
+export 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.
+ */
+export interface AriaExpandedProps {
+    'aria-expanded': boolean;
+    'aria-controls'?: string;
+}
+/**
+ * Get aria-expanded props.
+ */
+export declare function getAriaExpanded(expanded: boolean, controlsId?: string): AriaExpandedProps;
+/**
+ * Announce message to screen readers.
+ */
+export declare function announceToScreenReader(message: string, priority?: 'polite' | 'assertive'): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/accessibility/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMpD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,GAAG,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,GAAG,SAAS,CAGzF;AAED;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB,QAAQ,EAAE,UAAU;IACpB,KAAK;IACL,MAAM;IACN,OAAO;IACP,MAAM;IACN,QAAQ;IACR,IAAI;IACJ,UAAU,EAAE,QAAQ;IACpB,MAAM;CACP,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,UAAW;IAAE,OAAO,EAAE;QAAE,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE;IAClF,iBAAiB;QACf,OAAO;QACP,aAAa;;CAEf,CAAC;AAMH;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,CAAC,aAAa,EAC1B,OAAO,EAAE;IACP,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;CACzC,GACA,IAAI,CAqCN;AAMD;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB,sBAAsB;aACtB,OAAO,EAAE,iBAAiB;IAC1B,2BAA2B;aAC3B,YAAY,EAAE,sBAAsB;IACpC,aAAa;aACb,MAAM,EAAE,QAAQ;IAChB,mBAAmB;aACnB,IAAI,EAAE,cAAc;IACpB,aAAa;aACb,MAAM,EAAE,QAAQ;IAChB,aAAa;aACb,MAAM,EAAE,QAAQ;IAChB,cAAc;aACd,OAAO,EAAE,SAAS;IAClB,4BAA4B;aAC5B,UAAU,EAAE,uBAAuB;IACnC,gBAAgB;aAChB,QAAQ,EAAE,WAAW;IACrB,eAAe;aACf,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAKzF;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAQ,GAAG,WAAsB,GAAG,IAAI,CAczG"}

package/dist/core/accessibility/skip-link.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Skip Link Component
+ *
+ * Provides keyboard users a way to skip navigation and jump to main content.
+ *
+ * @module core/accessibility/skip-link
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme } from '@mui/material';
+/**
+ * Props for SkipLink component.
+ */
+export 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>
+ * ```
+ */
+export declare function SkipLink({ href, children, sx }: SkipLinkProps): ReactNode;
+//# sourceMappingURL=skip-link.d.ts.map

package/dist/core/accessibility/skip-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skip-link.d.ts","sourceRoot":"","sources":["../../../src/core/accessibility/skip-link.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,QAAQ,EAAE,SAAS,CAAC;IACpB,kBAAkB;IAClB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,aAAa,GAAG,SAAS,CAgCzE"}

package/dist/core/context.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Prism Context
+ *
+ * Global context for Prism configuration and state.
+ *
+ * @module core/context
+ */
+import type { PrismConfig } from '../types/config.js';
+import type { PrismTheme, ThemeMode, ThemePreset, ThemeDirection } from '../types/theme.js';
+import type { NavLayout, NavColor } from '../state/stores/settings.js';
+/**
+ * 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export declare const PrismContext: import("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>
+ *   );
+ * }
+ * ```
+ */
+export declare function usePrismContext(): PrismContextValue;
+/**
+ * Default settings state.
+ */
+export declare const defaultSettingsState: PrismSettingsState;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,2BAA2B;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,qBAAqB;IACrB,SAAS,EAAE,cAAc,CAAC;IAC1B,8BAA8B;IAC9B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,2BAA2B;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,6BAA6B;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;IAC7B,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,SAAS,EAAE,SAAS,CAAC;IACrB,4BAA4B;IAC5B,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,oBAAoB;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,qBAAqB;IACrB,QAAQ,EAAE,kBAAkB,CAAC;IAG7B,qBAAqB;IACrB,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACnC,gCAAgC;IAChC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,uBAAuB;IACvB,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACzC,yBAAyB;IACzB,YAAY,EAAE,CAAC,SAAS,EAAE,cAAc,KAAK,IAAI,CAAC;IAGlD,qBAAqB;IACrB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,4BAA4B;IAC5B,mBAAmB,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD,2BAA2B;IAC3B,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,4BAA4B;IAC5B,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC,6BAA6B;IAC7B,oBAAoB,EAAE,MAAM,IAAI,CAAC;IAGjC,qCAAqC;IACrC,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,mDAAgD,CAAC;AAI1E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAQnD;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,kBAYlC,CAAC"}

package/dist/core/hooks/use-boolean.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Return type for useBoolean hook.
+ */
+export interface UseBooleanReturn {
+    /** Current boolean value */
+    value: boolean;
+    /** Set value to true */
+    onTrue: () => void;
+    /** Set value to false */
+    onFalse: () => void;
+    /** Toggle the value */
+    onToggle: () => void;
+    /** Set to specific value */
+    setValue: (value: boolean) => void;
+}
+/**
+ * Hook for managing boolean state with convenient toggle methods.
+ *
+ * @param defaultValue - Initial boolean value (default: false)
+ * @returns Boolean state and control methods
+ *
+ * @example
+ * ```tsx
+ * function Modal() {
+ *   const dialog = useBoolean();
+ *
+ *   return (
+ *     <>
+ *       <Button onClick={dialog.onTrue}>Open</Button>
+ *       <Dialog open={dialog.value} onClose={dialog.onFalse}>
+ *         <DialogContent>...</DialogContent>
+ *       </Dialog>
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * function Sidebar() {
+ *   const { value: isCollapsed, onToggle } = useBoolean(false);
+ *
+ *   return (
+ *     <nav style={{ width: isCollapsed ? 64 : 240 }}>
+ *       <IconButton onClick={onToggle}>
+ *         {isCollapsed ? <MenuIcon /> : <CloseIcon />}
+ *       </IconButton>
+ *     </nav>
+ *   );
+ * }
+ * ```
+ */
+export declare function useBoolean(defaultValue?: boolean): UseBooleanReturn;
+//# sourceMappingURL=use-boolean.d.ts.map

package/dist/core/hooks/use-boolean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-boolean.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/use-boolean.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,wBAAwB;IACxB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,yBAAyB;IACzB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,4BAA4B;IAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,UAAU,CAAC,YAAY,UAAQ,GAAG,gBAAgB,CAyBjE"}

package/dist/core/hooks/use-breakpoints.d.ts

@@ -0,0 +1,87 @@
+import type { Breakpoint } from '@mui/material/styles';
+/**
+ * Breakpoint values in pixels.
+ */
+export interface BreakpointValues {
+    xs: number;
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+}
+/**
+ * Breakpoint state.
+ */
+export interface BreakpointState {
+    /** Current breakpoint name */
+    current: Breakpoint;
+    /** Is extra-small screen (< sm) */
+    isXs: boolean;
+    /** Is small screen (>= sm, < md) */
+    isSm: boolean;
+    /** Is medium screen (>= md, < lg) */
+    isMd: boolean;
+    /** Is large screen (>= lg, < xl) */
+    isLg: boolean;
+    /** Is extra-large screen (>= xl) */
+    isXl: boolean;
+    /** Is mobile (< md) */
+    isMobile: boolean;
+    /** Is tablet (>= md, < lg) */
+    isTablet: boolean;
+    /** Is desktop (>= lg) */
+    isDesktop: boolean;
+}
+/**
+ * Return type for useBreakpoints hook.
+ */
+export interface UseBreakpointsReturn extends BreakpointState {
+    /** Check if viewport is >= breakpoint */
+    up: (breakpoint: Breakpoint) => boolean;
+    /** Check if viewport is < breakpoint */
+    down: (breakpoint: Breakpoint) => boolean;
+    /** Check if viewport is exactly at breakpoint range */
+    only: (breakpoint: Breakpoint) => boolean;
+    /** Check if viewport is between two breakpoints */
+    between: (start: Breakpoint, end: Breakpoint) => boolean;
+    /** Breakpoint values in pixels */
+    values: BreakpointValues;
+}
+/**
+ * Hook for responsive breakpoint detection.
+ *
+ * @returns Breakpoint state and helper functions
+ *
+ * @example
+ * ```tsx
+ * function ResponsiveLayout() {
+ *   const { isMobile, isDesktop, up, current } = useBreakpoints();
+ *
+ *   return (
+ *     <Box>
+ *       {isMobile && <MobileNav />}
+ *       {isDesktop && <DesktopSidebar />}
+ *       <Typography>Current: {current}</Typography>
+ *       {up('md') && <AdvancedFeatures />}
+ *     </Box>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * function DataGrid() {
+ *   const { between, only } = useBreakpoints();
+ *
+ *   const columns = useMemo(() => {
+ *     if (only('xs')) return 1;
+ *     if (between('sm', 'md')) return 2;
+ *     return 3;
+ *   }, [only, between]);
+ *
+ *   return <Grid columns={columns}>...</Grid>;
+ * }
+ * ```
+ */
+export declare function useBreakpoints(): UseBreakpointsReturn;
+//# sourceMappingURL=use-breakpoints.d.ts.map

package/dist/core/hooks/use-breakpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-breakpoints.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/use-breakpoints.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,OAAO,EAAE,UAAU,CAAC;IACpB,mCAAmC;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,oCAAoC;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,qCAAqC;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,oCAAoC;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,oCAAoC;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,uBAAuB;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,yBAAyB;IACzB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,yCAAyC;IACzC,EAAE,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC;IACxC,wCAAwC;IACxC,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC;IAC1C,uDAAuD;IACvD,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC;IAC1C,mDAAmD;IACnD,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC;IACzD,kCAAkC;IAClC,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,CAsIrD"}

package/dist/core/hooks/use-click-outside.d.ts

@@ -0,0 +1,26 @@
+import type { RefObject } from 'react';
+/**
+ * Hook to detect clicks outside of an element.
+ *
+ * @template T - Element type (defaults to HTMLElement)
+ * @param {function} handler - Callback when clicked outside
+ * @param {RefObject<T>} [providedRef] - Optional external ref
+ * @returns {RefObject<T>} Ref to attach to the element
+ *
+ * @example
+ * ```tsx
+ * function Dropdown() {
+ *   const [isOpen, setIsOpen] = useState(false);
+ *   const ref = useClickOutside<HTMLDivElement>(() => setIsOpen(false));
+ *
+ *   return (
+ *     <div ref={ref}>
+ *       <button onClick={() => setIsOpen(true)}>Open</button>
+ *       {isOpen && <DropdownMenu />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useClickOutside<T extends HTMLElement = HTMLElement>(handler: (event: MouseEvent | TouchEvent) => void, providedRef?: RefObject<T | null>): RefObject<T | null>;
+//# sourceMappingURL=use-click-outside.d.ts.map

package/dist/core/hooks/use-click-outside.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-click-outside.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/use-click-outside.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACjE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,KAAK,IAAI,EACjD,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,GAChC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CA8BrB"}

package/dist/core/hooks/use-copy-to-clipboard.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Copy state types.
+ */
+export type CopyState = 'idle' | 'success' | 'error';
+/**
+ * Return type for useCopyToClipboard.
+ */
+export interface UseCopyToClipboardReturn {
+    /** Current copy state */
+    state: CopyState;
+    /** Copied text (null if not copied) */
+    copiedText: string | null;
+    /** Copy text to clipboard */
+    copy: (text: string) => Promise<boolean>;
+    /** Reset state to idle */
+    reset: () => void;
+}
+/**
+ * Options for useCopyToClipboard.
+ */
+export interface UseCopyToClipboardOptions {
+    /** Reset to idle after this many ms (default: 2000) */
+    resetTimeout?: number;
+    /** Callback on successful copy */
+    onSuccess?: (text: string) => void;
+    /** Callback on copy error */
+    onError?: (error: Error) => void;
+}
+/**
+ * useCopyToClipboard - Copy text to clipboard with state tracking.
+ *
+ * @example
+ * ```tsx
+ * function CopyButton({ text }: { text: string }) {
+ *   const { state, copy } = useCopyToClipboard();
+ *
+ *   return (
+ *     <Button onClick={() => copy(text)}>
+ *       {state === 'success' ? 'Copied!' : 'Copy'}
+ *     </Button>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With callback
+ * function ShareLink({ url }: { url: string }) {
+ *   const { state, copy } = useCopyToClipboard({
+ *     onSuccess: () => enqueueSnackbar('Link copied!'),
+ *     onError: (err) => enqueueSnackbar(`Failed to copy: ${err.message}`, { variant: 'error' }),
+ *   });
+ *
+ *   return (
+ *     <IconButton onClick={() => copy(url)}>
+ *       {state === 'success' ? <CheckIcon /> : <CopyIcon />}
+ *     </IconButton>
+ *   );
+ * }
+ * ```
+ *
+ * @param options - Hook options
+ * @returns Copy function and state
+ */
+export declare function useCopyToClipboard(options?: UseCopyToClipboardOptions): UseCopyToClipboardReturn;
+//# sourceMappingURL=use-copy-to-clipboard.d.ts.map

package/dist/core/hooks/use-copy-to-clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-copy-to-clipboard.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/use-copy-to-clipboard.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,yBAAyB;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,uCAAuC;IACvC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,6BAA6B;IAC7B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,6BAA6B;IAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,wBAAwB,CAiFpG"}

package/dist/core/hooks/use-countdown.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Countdown state.
+ */
+export interface CountdownState {
+    /** Remaining time in seconds */
+    seconds: number;
+    /** Whether countdown is running */
+    isRunning: boolean;
+    /** Whether countdown has finished */
+    isFinished: boolean;
+}
+/**
+ * Countdown controls.
+ */
+export interface CountdownControls {
+    /** Start or resume the countdown */
+    start: () => void;
+    /** Pause the countdown */
+    pause: () => void;
+    /** Reset to initial duration */
+    reset: () => void;
+    /** Set a new duration and reset */
+    setDuration: (seconds: number) => void;
+}
+/**
+ * Return type for useCountdown.
+ */
+export interface UseCountdownReturn extends CountdownState, CountdownControls {
+    /** Formatted time string (MM:SS or HH:MM:SS) */
+    formatted: string;
+    /** Time parts for custom formatting */
+    parts: {
+        hours: number;
+        minutes: number;
+        seconds: number;
+    };
+}
+/**
+ * Options for useCountdown.
+ */
+export interface UseCountdownOptions {
+    /** Initial duration in seconds */
+    duration: number;
+    /** Auto-start countdown (default: false) */
+    autoStart?: boolean;
+    /** Callback when countdown finishes */
+    onComplete?: () => void;
+    /** Callback on each tick */
+    onTick?: (remaining: number) => void;
+    /** Tick interval in ms (default: 1000) */
+    interval?: number;
+}
+/**
+ * useCountdown - Countdown timer hook.
+ *
+ * @example
+ * ```tsx
+ * function OTPTimer() {
+ *   const { formatted, isFinished, reset } = useCountdown({
+ *     duration: 60,
+ *     autoStart: true,
+ *     onComplete: () => console.log('Timer finished!'),
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {isFinished ? (
+ *         <Button onClick={reset}>Resend OTP</Button>
+ *       ) : (
+ *         <Typography>Resend in {formatted}</Typography>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * function QuizTimer() {
+ *   const countdown = useCountdown({
+ *     duration: 300, // 5 minutes
+ *     onTick: (remaining) => {
+ *       if (remaining === 60) {
+ *         showWarning('1 minute remaining!');
+ *       }
+ *     },
+ *     onComplete: () => submitQuiz(),
+ *   });
+ *
+ *   return (
+ *     <Box>
+ *       <Typography variant="h4">{countdown.formatted}</Typography>
+ *       <Button onClick={countdown.start}>Start</Button>
+ *       <Button onClick={countdown.pause}>Pause</Button>
+ *       <Button onClick={countdown.reset}>Reset</Button>
+ *     </Box>
+ *   );
+ * }
+ * ```
+ *
+ * @param options - Countdown options
+ * @returns Countdown state and controls
+ */
+export declare function useCountdown(options: UseCountdownOptions): UseCountdownReturn;
+//# sourceMappingURL=use-countdown.d.ts.map

package/dist/core/hooks/use-countdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-countdown.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/use-countdown.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,mCAAmC;IACnC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc,EAAE,iBAAiB;IAC3E,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAyBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CA8H7E"}

package/dist/core/hooks/use-debounce.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Hook for debouncing a value.
+ *
+ * @param value - Value to debounce
+ * @param delay - Debounce delay in milliseconds (default: 500)
+ * @returns Debounced value
+ *
+ * @example
+ * ```tsx
+ * function SearchInput() {
+ *   const [query, setQuery] = useState('');
+ *   const debouncedQuery = useDebounce(query, 300);
+ *
+ *   useEffect(() => {
+ *     if (debouncedQuery) {
+ *       search(debouncedQuery);
+ *     }
+ *   }, [debouncedQuery]);
+ *
+ *   return (
+ *     <TextField
+ *       value={query}
+ *       onChange={(e) => setQuery(e.target.value)}
+ *       placeholder="Search..."
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export declare function useDebounce<T>(value: T, delay?: number): T;
+/**
+ * Hook for debouncing a callback function.
+ *
+ * @param callback - Function to debounce
+ * @param delay - Debounce delay in milliseconds (default: 500)
+ * @returns Debounced callback and cancel function
+ *
+ * @example
+ * ```tsx
+ * function AutoSave() {
+ *   const [content, setContent] = useState('');
+ *
+ *   const { debouncedCallback: save, cancel } = useDebounceCallback(
+ *     async (text: string) => {
+ *       await api.saveDocument(text);
+ *     },
+ *     1000
+ *   );
+ *
+ *   const handleChange = (e: React.ChangeEvent<HTMLTextAreaElement>) => {
+ *     setContent(e.target.value);
+ *     save(e.target.value);
+ *   };
+ *
+ *   return <textarea value={content} onChange={handleChange} />;
+ * }
+ * ```
+ */
+export declare function useDebounceCallback<T extends (...args: never[]) => unknown>(callback: T, delay?: number): {
+    debouncedCallback: (...args: Parameters<T>) => void;
+    cancel: () => void;
+    flush: () => void;
+};
+//# sourceMappingURL=use-debounce.d.ts.map

package/dist/core/hooks/use-debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-debounce.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/use-debounce.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,SAAM,GAAG,CAAC,CAcvD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EACzE,QAAQ,EAAE,CAAC,EACX,KAAK,SAAM,GACV;IACD,iBAAiB,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACpD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAqDA"}