@omnitron-dev/prism 0.2.0 → 0.3.0

package/dist/hooks/use-client-rect.d.ts

@@ -0,0 +1,67 @@
+/**
+ * useClientRect Hook
+ *
+ * Gets bounding client rect and scroll dimensions of a DOM element.
+ * SSR-safe with automatic updates on resize/scroll.
+ *
+ * @module @omnitron-dev/prism/hooks
+ */
+import { type RefObject } from 'react';
+/**
+ * Scroll element dimensions.
+ */
+export interface ScrollElValue {
+    /** Scrollable width */
+    scrollWidth: number;
+    /** Scrollable height */
+    scrollHeight: number;
+}
+/**
+ * DOMRect values (SSR-safe).
+ */
+export interface DOMRectValue {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Return type for useClientRect hook.
+ */
+export interface UseClientRectReturn<T extends HTMLElement = HTMLElement> extends DOMRectValue, ScrollElValue {
+    /** Ref to attach to the target element */
+    elementRef: RefObject<T | null>;
+    /** Force update measurements */
+    update: () => void;
+}
+/**
+ * useClientRect - Hook to get bounding rect and scroll dimensions.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage - auto-creates ref
+ * const { elementRef, width, height, top, left } = useClientRect();
+ *
+ * return (
+ *   <div ref={elementRef}>
+ *     Width: {width}, Height: {height}
+ *   </div>
+ * );
+ *
+ * // With existing ref
+ * const myRef = useRef<HTMLDivElement>(null);
+ * const { width, scrollWidth } = useClientRect(myRef);
+ *
+ * // Listen to scroll events
+ * const { y, scrollHeight } = useClientRect(ref, 'scroll');
+ *
+ * // Calculate scroll progress
+ * const progress = y / (scrollHeight - height);
+ * ```
+ */
+export declare function useClientRect<T extends HTMLElement = HTMLElement>(inputRef?: RefObject<T | null>, eventType?: 'scroll' | 'resize'): UseClientRectReturn<T>;
+//# sourceMappingURL=use-client-rect.d.ts.map

package/dist/hooks/use-client-rect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-client-rect.d.ts","sourceRoot":"","sources":["../../src/hooks/use-client-rect.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EAA4C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,CAAE,SAAQ,YAAY,EAAE,aAAa;IAC3G,0CAA0C;IAC1C,UAAU,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAChC,gCAAgC;IAChC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC/D,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,EAC9B,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAC9B,mBAAmB,CAAC,CAAC,CAAC,CAiExB"}

package/dist/hooks/use-config-from-query.d.ts

@@ -0,0 +1,98 @@
+import type { ThemePreset, ThemeMode, ThemeDirection, ComponentDensity } from '../types/theme.js';
+/**
+ * Configuration values that can be controlled via URL params.
+ */
+export interface UrlConfigValues {
+    /** Theme preset */
+    preset?: ThemePreset;
+    /** Light/dark/system mode */
+    mode?: ThemeMode;
+    /** Primary color (hex) */
+    primary?: string;
+    /** Text direction */
+    direction?: ThemeDirection;
+    /** Component density */
+    density?: ComponentDensity;
+    /** Contrast mode */
+    contrast?: 'default' | 'high';
+}
+/**
+ * Options for useConfigFromQuery hook.
+ */
+export interface UseConfigFromQueryOptions {
+    /** Query parameter names mapping (default: 'preset', 'mode', 'primary', etc.) */
+    paramNames?: {
+        preset?: string;
+        mode?: string;
+        primary?: string;
+        direction?: string;
+        density?: string;
+        contrast?: string;
+    };
+    /** Callback when config changes from URL */
+    onConfigChange?: (config: UrlConfigValues) => void;
+    /** Enable two-way sync (updates URL when config changes) */
+    syncToUrl?: boolean;
+}
+/**
+ * Return type for useConfigFromQuery hook.
+ */
+export interface UseConfigFromQueryReturn {
+    /** Parsed config values from URL */
+    configFromUrl: UrlConfigValues;
+    /** Update URL with new config values */
+    updateUrl: (values: Partial<UrlConfigValues>) => void;
+    /** Clear all config from URL */
+    clearUrl: () => void;
+    /** Generate URL with config values */
+    generateUrl: (values: Partial<UrlConfigValues>, baseUrl?: string) => string;
+    /** Check if URL has any config params */
+    hasUrlConfig: boolean;
+}
+/**
+ * Hook to sync theme configuration with URL query parameters.
+ *
+ * Enables shareable configuration links for demos, previews, and design reviews.
+ *
+ * @param options - Hook options
+ * @returns Object with URL config parsing and manipulation utilities
+ *
+ * @example
+ * ```tsx
+ * import { useConfigFromQuery } from '@omnitron-dev/prism/hooks';
+ *
+ * function ThemeSettings() {
+ *   const {
+ *     configFromUrl,
+ *     updateUrl,
+ *     generateUrl,
+ *     hasUrlConfig,
+ *   } = useConfigFromQuery({
+ *     onConfigChange: (config) => {
+ *       // Apply config to your theme context
+ *       if (config.preset) setPreset(config.preset);
+ *       if (config.mode) setMode(config.mode);
+ *       if (config.primary) setPrimaryColor(config.primary);
+ *     },
+ *   });
+ *
+ *   // Generate shareable link
+ *   const shareUrl = generateUrl({
+ *     preset: currentPreset,
+ *     mode: currentMode,
+ *     primary: currentPrimary,
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {hasUrlConfig && <Alert>Using config from URL</Alert>}
+ *       <Button onClick={() => navigator.clipboard.writeText(shareUrl)}>
+ *         Copy Share Link
+ *       </Button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useConfigFromQuery(options?: UseConfigFromQueryOptions): UseConfigFromQueryReturn;
+//# sourceMappingURL=use-config-from-query.d.ts.map

package/dist/hooks/use-config-from-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-config-from-query.d.ts","sourceRoot":"","sources":["../../src/hooks/use-config-from-query.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAOlG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,wBAAwB;IACxB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,oBAAoB;IACpB,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,iFAAiF;IACjF,UAAU,CAAC,EAAE;QACX,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,4CAA4C;IAC5C,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IACnD,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,oCAAoC;IACpC,aAAa,EAAE,eAAe,CAAC;IAC/B,wCAAwC;IACxC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;IACtD,gCAAgC;IAChC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,sCAAsC;IACtC,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5E,yCAAyC;IACzC,YAAY,EAAE,OAAO,CAAC;CACvB;AAqDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,wBAAwB,CAqLpG"}

package/dist/hooks/use-cookies.d.ts

@@ -0,0 +1,62 @@
+import type { CookieOptions } from '../utils/cookies.js';
+/**
+ * Options for useCookies hook.
+ */
+export interface UseCookiesOptions extends CookieOptions {
+    /**
+     * If true, initializes the cookie with the initial value if not set.
+     * @default true
+     */
+    initializeWithValue?: boolean;
+}
+/**
+ * Return type for useCookies hook.
+ */
+export interface UseCookiesReturn<T> {
+    /** Current state value */
+    state: T;
+    /** Reset state to initial value and remove cookie */
+    resetState: (defaultState?: T) => void;
+    /** Update the entire state or merge partial state (for objects) */
+    setState: (updateState: T | Partial<T>) => void;
+    /** Update a specific field in an object state */
+    setField: <K extends keyof T>(name: K, updateValue: T[K]) => void;
+}
+/**
+ * Hook to manage state with cookies.
+ *
+ * Automatically syncs state with cookies and supports:
+ * - Primitive values (string, number, boolean)
+ * - Object values with partial updates
+ * - Type-safe field updates
+ *
+ * @template T - Type of the state value
+ * @param key - Cookie name
+ * @param initialState - Initial state value
+ * @param options - Cookie options
+ * @returns State and update functions
+ *
+ * @example
+ * ```tsx
+ * // Primitive value
+ * const { state, setState, resetState } = useCookies('theme', 'light');
+ *
+ * // Object value with partial updates
+ * const { state, setState, setField, resetState } = useCookies('user', {
+ *   name: '',
+ *   age: 0,
+ *   preferences: { notifications: true },
+ * });
+ *
+ * // Update single field
+ * setField('name', 'John');
+ *
+ * // Partial update
+ * setState({ age: 25 });
+ *
+ * // Reset to initial value
+ * resetState();
+ * ```
+ */
+export declare function useCookies<T>(key: string, initialState: T, options?: UseCookiesOptions): UseCookiesReturn<T>;
+//# sourceMappingURL=use-cookies.d.ts.map

package/dist/hooks/use-cookies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-cookies.d.ts","sourceRoot":"","sources":["../../src/hooks/use-cookies.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,0BAA0B;IAC1B,KAAK,EAAE,CAAC,CAAC;IACT,qDAAqD;IACrD,UAAU,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IACvC,mEAAmE;IACnE,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAChD,iDAAiD;IACjD,QAAQ,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACnE;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAAC,CAAC,CAAC,CA6E5G"}

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

@@ -0,0 +1,47 @@
+/**
+ * Return type for useCountdownDate hook.
+ */
+export type UseCountdownDateReturn = {
+    /** Formatted days (with leading zero) */
+    days: string;
+    /** Formatted hours (with leading zero) */
+    hours: string;
+    /** Formatted minutes (with leading zero) */
+    minutes: string;
+    /** Formatted seconds (with leading zero) */
+    seconds: string;
+};
+/**
+ * Custom hook to create a countdown timer to a target date.
+ *
+ * @param targetDate - The target date to count down to
+ * @param placeholder - The placeholder value to display before the countdown starts (default: '- -')
+ *
+ * @returns An object containing the current countdown values in days, hours, minutes, and seconds
+ *
+ * @example
+ * ```tsx
+ * function SaleCountdown() {
+ *   const { days, hours, minutes, seconds } = useCountdownDate(
+ *     new Date('2024-12-31T23:59:59')
+ *   );
+ *
+ *   return (
+ *     <div>
+ *       <span>{days}d</span>
+ *       <span>{hours}h</span>
+ *       <span>{minutes}m</span>
+ *       <span>{seconds}s</span>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With custom placeholder
+ * const countdown = useCountdownDate(launchDate, '--');
+ * ```
+ */
+export declare function useCountdownDate(targetDate: Date, placeholder?: string): UseCountdownDateReturn;
+//# sourceMappingURL=use-countdown-date.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-countdown-date.d.ts","sourceRoot":"","sources":["../../src/hooks/use-countdown-date.ts"],"names":[],"mappings":"AAmBA;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AA2CF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,IAAI,EAAE,WAAW,SAAQ,GAAG,sBAAsB,CA4D9F"}

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

@@ -0,0 +1,83 @@
+/**
+ * useCountdownSeconds Hook
+ *
+ * Simple countdown timer in seconds. Ideal for OTP resend timers,
+ * session timeouts, and other time-limited operations.
+ *
+ * @module @omnitron-dev/prism/hooks
+ */
+import type { Dispatch, SetStateAction } from 'react';
+/**
+ * Return type for useCountdownSeconds hook.
+ */
+export interface UseCountdownSecondsReturn {
+    /** Current countdown value in seconds */
+    value: number;
+    /** Start the countdown */
+    start: () => void;
+    /** Reset countdown to initial value and stop */
+    reset: () => void;
+    /** Whether countdown is currently active */
+    isCounting: boolean;
+    /** Manually set the countdown value */
+    setValue: Dispatch<SetStateAction<number>>;
+}
+/**
+ * Hook to create a simple countdown timer in seconds.
+ *
+ * Perfect for:
+ * - OTP resend timers
+ * - Session timeout warnings
+ * - Rate limiting UI feedback
+ * - Game timers
+ *
+ * @param initialSeconds - Initial countdown value in seconds
+ * @returns Countdown state and control functions
+ *
+ * @example
+ * ```tsx
+ * // OTP resend timer
+ * function OTPForm() {
+ *   const { value, start, reset, isCounting } = useCountdownSeconds(60);
+ *
+ *   const handleResend = async () => {
+ *     await resendOTP();
+ *     reset();
+ *     start();
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <input placeholder="Enter OTP" />
+ *       <button onClick={handleResend} disabled={isCounting}>
+ *         {isCounting ? `Resend in ${value}s` : 'Resend OTP'}
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Session timeout warning
+ * function SessionWarning() {
+ *   const { value, start, isCounting } = useCountdownSeconds(30);
+ *
+ *   useEffect(() => {
+ *     if (showWarning) start();
+ *   }, [showWarning]);
+ *
+ *   useEffect(() => {
+ *     if (value === 0) logout();
+ *   }, [value]);
+ *
+ *   return isCounting && (
+ *     <Alert severity="warning">
+ *       Session expires in {value} seconds
+ *     </Alert>
+ *   );
+ * }
+ * ```
+ */
+export declare function useCountdownSeconds(initialSeconds: number): UseCountdownSecondsReturn;
+//# sourceMappingURL=use-countdown-seconds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-countdown-seconds.d.ts","sourceRoot":"","sources":["../../src/hooks/use-countdown-seconds.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAOtD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,gDAAgD;IAChD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,4CAA4C;IAC5C,UAAU,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;CAC5C;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,yBAAyB,CAgDrF"}

package/dist/hooks/use-double-click.d.ts

@@ -0,0 +1,67 @@
+/**
+ * useDoubleClick Hook
+ *
+ * Differentiates between single and double click events.
+ * Single click is delayed to ensure it's not a double click.
+ *
+ * @module @omnitron-dev/prism/hooks
+ */
+import type { MouseEvent, SyntheticEvent } from 'react';
+/**
+ * Props for useDoubleClick hook.
+ */
+export interface UseDoubleClickProps {
+    /**
+     * Timeout in milliseconds to differentiate between single and double clicks.
+     * @default 250
+     */
+    timeout?: number;
+    /** Handler for single click (optional) */
+    click?: (event: SyntheticEvent) => void;
+    /** Handler for double click (required) */
+    doubleClick: (event: SyntheticEvent) => void;
+}
+/**
+ * Return type - a click handler function.
+ */
+export type UseDoubleClickReturn = (event: MouseEvent<HTMLElement>) => void;
+/**
+ * Hook to handle single and double click events on an element.
+ *
+ * Uses event.detail to detect click count:
+ * - detail === 1: single click (delayed by timeout)
+ * - detail === 2: double click (immediate)
+ *
+ * The single click handler is called after a timeout, but only if
+ * no second click occurs within that time.
+ *
+ * @param props - Hook configuration
+ * @returns Click handler function to attach to element
+ *
+ * @example
+ * ```tsx
+ * function FileItem({ file }) {
+ *   const handleClick = useDoubleClick({
+ *     click: () => selectFile(file),
+ *     doubleClick: () => openFile(file),
+ *     timeout: 300,
+ *   });
+ *
+ *   return (
+ *     <div onClick={handleClick}>
+ *       {file.name}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Double-click only (no single click handler)
+ * const handleClick = useDoubleClick({
+ *   doubleClick: () => console.log('Double clicked!'),
+ * });
+ * ```
+ */
+export declare function useDoubleClick({ click, doubleClick, timeout }: UseDoubleClickProps): UseDoubleClickReturn;
+//# sourceMappingURL=use-double-click.d.ts.map

package/dist/hooks/use-double-click.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-double-click.d.ts","sourceRoot":"","sources":["../../src/hooks/use-double-click.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAOxD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACxC,0CAA0C;IAC1C,WAAW,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;AAM5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAa,EAAE,EAAE,mBAAmB,GAAG,oBAAoB,CAuC/G"}

package/dist/hooks/use-focus-trap.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Options for useFocusTrap hook.
+ */
+export interface UseFocusTrapOptions {
+    /**
+     * Whether the focus trap is active.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Whether to auto-focus the first focusable element when enabled.
+     * @default true
+     */
+    autoFocus?: boolean;
+    /**
+     * Whether to restore focus to the previously focused element when disabled.
+     * @default true
+     */
+    restoreFocus?: boolean;
+    /**
+     * Selector for focusable elements.
+     * @default FOCUSABLE_SELECTOR
+     */
+    focusableSelector?: string;
+}
+/**
+ * Return type for useFocusTrap hook.
+ */
+export interface UseFocusTrapReturn<T extends HTMLElement = HTMLElement> {
+    /**
+     * Ref to attach to the container element.
+     */
+    ref: React.RefCallback<T>;
+    /**
+     * Focus the first focusable element.
+     */
+    focusFirst: () => void;
+    /**
+     * Focus the last focusable element.
+     */
+    focusLast: () => void;
+}
+/**
+ * Trap focus within a container element.
+ *
+ * @param options - Hook options
+ * @returns Ref and focus control functions
+ *
+ * @example
+ * ```tsx
+ * function Modal({ open, onClose, children }) {
+ *   const { ref } = useFocusTrap({ enabled: open });
+ *
+ *   if (!open) return null;
+ *
+ *   return (
+ *     <div ref={ref} role="dialog" aria-modal="true">
+ *       {children}
+ *       <button onClick={onClose}>Close</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useFocusTrap<T extends HTMLElement = HTMLElement>(options?: UseFocusTrapOptions): UseFocusTrapReturn<T>;
+//# sourceMappingURL=use-focus-trap.d.ts.map

package/dist/hooks/use-focus-trap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-focus-trap.d.ts","sourceRoot":"","sources":["../../src/hooks/use-focus-trap.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACrE;;OAEG;IACH,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC1B;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB;;OAEG;IACH,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAuBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC9D,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CAAC,CAAC,CAAC,CA+FvB"}

package/dist/hooks/use-image-dimensions.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Image dimensions result.
+ */
+export interface ImageDimensions {
+    /** Natural width of the image in pixels */
+    width: number;
+    /** Natural height of the image in pixels */
+    height: number;
+    /** Aspect ratio (width / height) */
+    aspectRatio: number;
+}
+/**
+ * Return type for useImageDimensions hook.
+ */
+export interface UseImageDimensionsReturn {
+    /** Image dimensions (null if not loaded or error) */
+    dimensions: ImageDimensions | null;
+    /** Loading state */
+    loading: boolean;
+    /** Error if image failed to load */
+    error: Error | null;
+    /** Manually retry loading the image */
+    retry: () => void;
+}
+/**
+ * Options for useImageDimensions hook.
+ */
+export interface UseImageDimensionsOptions {
+    /** Cross-origin setting for image loading */
+    crossOrigin?: 'anonymous' | 'use-credentials';
+    /** Timeout in milliseconds (default: 10000) */
+    timeout?: number;
+    /** Whether to start loading immediately (default: true) */
+    immediate?: boolean;
+}
+/**
+ * useImageDimensions - Detects image dimensions from a URL.
+ *
+ * Loads an image in memory to get its natural width and height.
+ *
+ * @example
+ * ```tsx
+ * function ImagePreview({ src }: { src: string }) {
+ *   const { dimensions, loading, error } = useImageDimensions(src);
+ *
+ *   if (loading) return <CircularProgress />;
+ *   if (error) return <Alert severity="error">Failed to load image</Alert>;
+ *   if (!dimensions) return null;
+ *
+ *   return (
+ *     <Box>
+ *       <Typography>
+ *         {dimensions.width} x {dimensions.height}
+ *       </Typography>
+ *       <Typography>
+ *         Aspect ratio: {dimensions.aspectRatio.toFixed(2)}
+ *       </Typography>
+ *       <img
+ *         src={src}
+ *         alt="preview"
+ *         style={{ maxWidth: '100%', aspectRatio: dimensions.aspectRatio }}
+ *       />
+ *     </Box>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With manual control
+ * function LazyImage({ src }: { src: string }) {
+ *   const { dimensions, loading, retry } = useImageDimensions(src, {
+ *     immediate: false,
+ *   });
+ *
+ *   return (
+ *     <Box>
+ *       {!dimensions && !loading && (
+ *         <Button onClick={retry}>Load dimensions</Button>
+ *       )}
+ *       {loading && <CircularProgress />}
+ *       {dimensions && (
+ *         <Typography>{dimensions.width} x {dimensions.height}</Typography>
+ *       )}
+ *     </Box>
+ *   );
+ * }
+ * ```
+ *
+ * @param src - Image URL to load
+ * @param options - Hook options
+ * @returns Dimensions, loading state, error, and retry function
+ */
+export declare function useImageDimensions(src: string | null | undefined, options?: UseImageDimensionsOptions): UseImageDimensionsReturn;
+/**
+ * Get dimensions of multiple images.
+ *
+ * @example
+ * ```tsx
+ * // MUI v9 unified the Grid component — the `<Grid item>` shorthand
+ * // from v1 is gone; size is expressed via `size={{ xs, sm, md, ... }}`.
+ * function Gallery({ urls }: { urls: string[] }) {
+ *   const results = useMultipleImageDimensions(urls);
+ *
+ *   return (
+ *     <Grid container>
+ *       {results.map((result, i) => (
+ *         <Grid key={urls[i]} size={{ xs: 12, sm: 6, md: 4 }}>
+ *           {result.loading && <Skeleton />}
+ *           {result.dimensions && (
+ *             <img
+ *               src={urls[i]}
+ *               style={{ aspectRatio: result.dimensions.aspectRatio }}
+ *             />
+ *           )}
+ *         </Grid>
+ *       ))}
+ *     </Grid>
+ *   );
+ * }
+ * ```
+ */
+export declare function useMultipleImageDimensions(urls: (string | null | undefined)[], options?: UseImageDimensionsOptions): UseImageDimensionsReturn[];
+//# sourceMappingURL=use-image-dimensions.d.ts.map

package/dist/hooks/use-image-dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-image-dimensions.d.ts","sourceRoot":"","sources":["../../src/hooks/use-image-dimensions.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,qDAAqD;IACrD,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,uCAAuC;IACvC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,6CAA6C;IAC7C,WAAW,CAAC,EAAE,WAAW,GAAG,iBAAiB,CAAC;IAC9C,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,OAAO,GAAE,yBAA8B,GACtC,wBAAwB,CA4F1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,EACnC,OAAO,GAAE,yBAA8B,GACtC,wBAAwB,EAAE,CAuH5B"}