@omnitron-dev/prism 0.2.0 → 0.3.0

package/dist/forms/schema-utils.d.ts

@@ -0,0 +1,286 @@
+/**
+ * Schema Utilities
+ *
+ * Pre-built Zod schema helpers for common form field validations.
+ * Designed to work seamlessly with React Hook Form + Zod resolver.
+ *
+ * Features:
+ * - Type-safe schema builders
+ * - Customizable error messages with i18n support
+ * - Common field validations (email, phone, date, file, etc.)
+ * - Nullable input handling
+ * - Slider range validation
+ * - Rich text editor validation
+ *
+ * @module @omnitron-dev/prism/forms
+ */
+import * as z from 'zod';
+/**
+ * Common error message configuration.
+ */
+export interface SchemaErrorMessages {
+    /** Error message when field is required but empty */
+    required?: string;
+    /** Error message when field format is invalid */
+    invalid?: string;
+}
+/**
+ * Options for file validation.
+ */
+export interface FileSchemaOptions extends SchemaErrorMessages {
+    /** Maximum file size in bytes */
+    maxSize?: number;
+    /** Allowed MIME types */
+    accept?: string[];
+}
+/**
+ * Options for slider range validation.
+ */
+export interface SliderRangeOptions extends SchemaErrorMessages {
+    /** Minimum value */
+    min: number;
+    /** Maximum value */
+    max: number;
+}
+/**
+ * Pre-built Zod schema helpers for common form validations.
+ *
+ * @example
+ * ```tsx
+ * import { z } from 'zod';
+ * import { schemaUtils } from '@omnitron-dev/prism/forms';
+ *
+ * // Define form schema
+ * const UserSchema = z.object({
+ *   email: schemaUtils.email(),
+ *   phone: schemaUtils.phone(),
+ *   birthDate: schemaUtils.date(),
+ *   avatar: schemaUtils.file(),
+ *   agreeToTerms: schemaUtils.boolean({ error: 'You must accept the terms' }),
+ *   bio: schemaUtils.editor(),
+ * });
+ *
+ * // With custom error messages
+ * const CustomSchema = z.object({
+ *   email: schemaUtils.email({
+ *     required: 'Please enter your email',
+ *     invalid: 'That email doesn\'t look right',
+ *   }),
+ * });
+ * ```
+ */
+export declare const schemaUtils: {
+    /**
+     * Email validation schema.
+     * Validates format and provides clear error messages.
+     *
+     * @example
+     * ```tsx
+     * const schema = z.object({
+     *   email: schemaUtils.email(),
+     * });
+     * ```
+     */
+    email: (errors?: SchemaErrorMessages) => z.ZodString;
+    /**
+     * Phone number validation schema.
+     * Basic validation with optional custom validator.
+     *
+     * @example
+     * ```tsx
+     * const schema = z.object({
+     *   phone: schemaUtils.phone({
+     *     isValid: (val) => /^\+?[1-9]\d{1,14}$/.test(val),
+     *   }),
+     * });
+     * ```
+     */
+    phone: (options?: SchemaErrorMessages & {
+        isValid?: (val: string) => boolean;
+    }) => z.ZodString;
+    /**
+     * Date validation schema.
+     * Works with Date objects, timestamps, and ISO strings.
+     * Compatible with date pickers.
+     *
+     * @example
+     * ```tsx
+     * const schema = z.object({
+     *   birthDate: schemaUtils.date(),
+     *   appointmentTime: schemaUtils.date({ required: 'Please select a time' }),
+     * });
+     * ```
+     */
+    date: (errors?: SchemaErrorMessages) => z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate, z.ZodNull]>;
+    /**
+     * Optional date schema (nullable).
+     * For date fields that aren't required.
+     */
+    dateOptional: (errors?: SchemaErrorMessages) => z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodDate, z.ZodNull]>>;
+    /**
+     * Rich text editor validation schema.
+     * Treats empty paragraphs as empty content.
+     *
+     * @example
+     * ```tsx
+     * const schema = z.object({
+     *   description: schemaUtils.editor(),
+     * });
+     * ```
+     */
+    editor: (error?: string) => z.ZodString;
+    /**
+     * Boolean validation schema.
+     * For checkboxes/switches that must be true (e.g., terms acceptance).
+     *
+     * @example
+     * ```tsx
+     * const schema = z.object({
+     *   agreeToTerms: schemaUtils.boolean({ error: 'You must accept the terms' }),
+     * });
+     * ```
+     */
+    boolean: (options?: {
+        error?: string;
+    }) => z.ZodBoolean;
+    /**
+     * Optional boolean schema.
+     * For optional checkboxes.
+     */
+    booleanOptional: () => z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Nullable input wrapper.
+     * Wraps any schema to handle null values as required errors.
+     *
+     * @example
+     * ```tsx
+     * const schema = z.object({
+     *   country: schemaUtils.nullableInput(
+     *     z.string().min(1),
+     *     { error: 'Please select a country' }
+     *   ),
+     * });
+     * ```
+     */
+    nullableInput: <T extends z.ZodTypeAny>(schema: T, options?: {
+        error?: string;
+    }) => z.ZodNullable<T> & z.ZodType<z.infer<T> & {}, z.core.input<T> | null, z.core.$ZodTypeInternals<z.infer<T> & {}, z.core.input<T> | null>>;
+    /**
+     * Single file upload validation.
+     * Supports File objects and URL strings (for existing files).
+     *
+     * @example
+     * ```tsx
+     * const schema = z.object({
+     *   avatar: schemaUtils.file(),
+     *   document: schemaUtils.file({
+     *     maxSize: 5 * 1024 * 1024, // 5MB
+     *     accept: ['application/pdf'],
+     *   }),
+     * });
+     * ```
+     */
+    file: (options?: FileSchemaOptions) => z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodString, z.ZodNull]>;
+    /**
+     * Optional single file upload.
+     */
+    fileOptional: (options?: Omit<FileSchemaOptions, 'required'>) => z.ZodNullable<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodString, z.ZodNull]>>;
+    /**
+     * Multiple file upload validation.
+     *
+     * @example
+     * ```tsx
+     * const schema = z.object({
+     *   images: schemaUtils.files({ minFiles: 1, error: 'Upload at least one image' }),
+     * });
+     * ```
+     */
+    files: (options?: {
+        error?: string;
+        minFiles?: number;
+    }) => z.ZodArray<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodString]>>;
+    /**
+     * Slider range validation.
+     * For dual-thumb sliders with [min, max] value.
+     *
+     * @example
+     * ```tsx
+     * const schema = z.object({
+     *   priceRange: schemaUtils.sliderRange({ min: 0, max: 1000 }),
+     * });
+     * ```
+     */
+    sliderRange: (options: SliderRangeOptions) => z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    /**
+     * URL validation schema.
+     */
+    url: (errors?: SchemaErrorMessages) => z.ZodString;
+    /**
+     * Optional URL schema.
+     */
+    urlOptional: (errors?: SchemaErrorMessages) => z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    /**
+     * Password validation with strength requirements.
+     */
+    password: (options?: {
+        minLength?: number;
+        requireUppercase?: boolean;
+        requireLowercase?: boolean;
+        requireNumber?: boolean;
+        requireSpecial?: boolean;
+        error?: string;
+    }) => z.ZodString;
+    /**
+     * Confirmation field (e.g., confirm password).
+     * Use with z.object().refine() for cross-field validation.
+     */
+    confirm: (fieldName: string, error?: string) => {
+        message: string;
+        path: string[];
+    };
+};
+/**
+ * Test schema validation with multiple values.
+ * Useful for development and debugging.
+ *
+ * @example
+ * ```ts
+ * testSchema(schemaUtils.email(), [
+ *   'valid@email.com',
+ *   'invalid-email',
+ *   '',
+ *   null,
+ * ]);
+ * ```
+ */
+/**
+ * Test results from schema validation.
+ */
+export interface SchemaTestResult {
+    value: unknown;
+    success: boolean;
+    data?: unknown;
+    errors?: string[];
+}
+/**
+ * Test a schema against multiple values.
+ * Returns structured results instead of logging to console.
+ * Use testSchemaDebug for console output during development.
+ */
+export declare function testSchema<T extends z.ZodTypeAny>(schema: T, values: unknown[]): SchemaTestResult[];
+/**
+ * Test a schema with console output (development only).
+ * This function does nothing in production builds.
+ *
+ * @example
+ * ```ts
+ * testSchemaDebug(schemaUtils.email(), [
+ *   'valid@email.com',
+ *   'invalid-email',
+ *   '',
+ *   null,
+ * ]);
+ * ```
+ */
+export declare function testSchemaDebug<T extends z.ZodTypeAny>(schema: T, values: unknown[]): void;
+//# sourceMappingURL=schema-utils.d.ts.map

package/dist/forms/schema-utils.d.ts.map

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

package/dist/hooks/index.d.ts

@@ -1,8 +1,38 @@
-import '../theme-B4Q3Bg5o.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 { A as AsyncState, B as BreakpointChecks, a as Breakpoints, 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, 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';
-export { U as UsePopoverReturn, u as usePopover } from '../popover-Dmw7SJLR.js';
-import '@mui/material/styles';
-import 'react';
-import '@mui/material/Popover';
+/**
+ * Prism Hooks
+ *
+ * Comprehensive React hooks for common patterns.
+ * Combines core hooks with additional utility hooks.
+ *
+ * @module @omnitron-dev/prism/hooks
+ */
+export { useBoolean, useSetState, useMultiSelect, useLocalStorage, useCopyToClipboard, useDebounce, useDebounceCallback, useCountdown, useBreakpoints, useMediaQuery, useIsClient, useMounted, usePrevious, useEventListener, useClickOutside, useInterval, useTimeout, } from '../core/index.js';
+export type { SetState, UseSetStateReturn, UseMultiSelectOptions, UseMultiSelectReturn, CopyState, UseCopyToClipboardReturn, UseCopyToClipboardOptions, CountdownState, CountdownControls, UseCountdownReturn, UseCountdownOptions, UseMountedReturn, UseTimeoutReturn, } from '../core/index.js';
+export { useAsync, useAsyncFn, type AsyncState, type UseAsyncReturn, type UseAsyncOptions, type UseAsyncFnReturn, } from './use-async.js';
+export { useScrollPosition, useScrollToTop, useScrollLock, type ScrollPosition, type UseScrollPositionOptions, } from './use-scroll-position.js';
+export { useWindowSize, useResponsiveQuery, useBreakpoint, useBreakpointChecks, type WindowSize, type Breakpoints, type UseWindowSizeOptions, type UseResponsiveQueryReturn, type BreakpointChecks, } from './use-window-size.js';
+export { useClientRect, type UseClientRectReturn, type DOMRectValue, type ScrollElValue } from './use-client-rect.js';
+export { usePopoverHover, type UsePopoverHoverReturn } from './use-popover-hover.js';
+export { usePopover, type UsePopoverReturn } from '../components/popover/index.js';
+export { useCookies, type UseCookiesOptions, type UseCookiesReturn } from './use-cookies.js';
+export { useDoubleClick, type UseDoubleClickProps, type UseDoubleClickReturn } from './use-double-click.js';
+export { useBackToTop, type UseBackToTopReturn } from './use-back-to-top.js';
+export { useCountdownSeconds, type UseCountdownSecondsReturn } from './use-countdown-seconds.js';
+export { useCountdownDate, type UseCountdownDateReturn } from './use-countdown-date.js';
+export { useScrollOffsetTop, type UseScrollOffsetTopReturn } from './use-scroll-offset-top.js';
+export { useConfigFromQuery, type UrlConfigValues, type UseConfigFromQueryOptions, type UseConfigFromQueryReturn, } from './use-config-from-query.js';
+export { useImageDimensions, useMultipleImageDimensions, type ImageDimensions, type UseImageDimensionsReturn, type UseImageDimensionsOptions, } from './use-image-dimensions.js';
+export { usePasswordVisibility, type UsePasswordVisibilityReturn, type UsePasswordVisibilityOptions, } from './use-password-visibility.js';
+export { useThrottle, useThrottleCallback, type UseThrottleOptions } from './use-throttle.js';
+export { useOnlineStatus, type UseOnlineStatusReturn } from './use-online-status.js';
+export { useIntersectionObserver, type UseIntersectionObserverOptions, type UseIntersectionObserverReturn, } from './use-intersection-observer.js';
+export { useKeyboardShortcut, useEscapeKey, useEnterKey, type KeyboardShortcut, type UseKeyboardShortcutOptions, } from './use-keyboard-shortcut.js';
+export { useFocusTrap, type UseFocusTrapOptions, type UseFocusTrapReturn } from './use-focus-trap.js';
+export { useUpdateEffect, useUpdateLayoutEffect } from './use-update-effect.js';
+export { useIsomorphicLayoutEffect } from './use-isomorphic-layout-effect.js';
+export { useSessionStorage, type UseSessionStorageReturn, type UseSessionStorageOptions, } from './use-session-storage.js';
+export { useArray, type UseArrayReturn } from './use-array.js';
+export { useMutation, type MutationState, type UseMutationOptions, type UseMutationReturn } from './use-mutation.js';
+export { useLazyQuery, type LazyQueryState, type UseLazyQueryOptions, type UseLazyQueryReturn, } from './use-lazy-query.js';
+export { useInfiniteScroll, type PageInfo, type InfinitePage, type InfiniteScrollState, type UseInfiniteScrollOptions, type UseInfiniteScrollReturn, type InfiniteFetchFn, } from './use-infinite-scroll.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/hooks/index.js

@@ -1,11 +1,10 @@
-export { useArray, useAsync, useAsyncFn, useBackToTop, useBreakpoint, useBreakpointChecks, useClientRect, useConfigFromQuery, useCookies, useCountdownDate, useCountdownSeconds, useDoubleClick, useEnterKey, useEscapeKey, useFocusTrap, useImageDimensions, useInfiniteScroll, useIntersectionObserver, useIsomorphicLayoutEffect, useKeyboardShortcut, useLazyQuery, useMultipleImageDimensions, useMutation, useOnlineStatus, usePasswordVisibility, usePopoverHover, useResponsiveQuery, useScrollLock, useScrollOffsetTop, useScrollPosition, useScrollToTop, useSessionStorage, useThrottle, useThrottleCallback, useUpdateEffect, useUpdateLayoutEffect, useWindowSize } from '../chunk-IZOIO7PA.js';
-export { usePopover } from '../chunk-2FYNRDXR.js';
-export { useBreakpoints, useClickOutside, useCopyToClipboard, useCountdown, useDebounce, useDebounceCallback, useEventListener, useInterval, useIsClient, useLocalStorage, useMuiMediaQuery as useMediaQuery, useMounted, useMultiSelect, usePrevious, useSetState, useTimeout } from '../chunk-XXP3ZGU6.js';
-import '../chunk-MEFT6XPH.js';
-import '../chunk-JDTC2SBY.js';
-export { useBoolean } from '../chunk-HO2GKTWJ.js';
-import '../chunk-XWL6J6IO.js';
-import '../chunk-DDY7TLUI.js';
-import '../chunk-77KIJLPP.js';
+export { useArray, useAsync, useAsyncFn, useBackToTop, useBreakpoint, useBreakpointChecks, useClientRect, useConfigFromQuery, useCookies, useCountdownDate, useCountdownSeconds, useDoubleClick, useEnterKey, useEscapeKey, useFocusTrap, useImageDimensions, useInfiniteScroll, useIntersectionObserver, useIsomorphicLayoutEffect, useKeyboardShortcut, useLazyQuery, useMultipleImageDimensions, useMutation, useOnlineStatus, usePasswordVisibility, usePopoverHover, useResponsiveQuery, useScrollLock, useScrollOffsetTop, useScrollPosition, useScrollToTop, useSessionStorage, useThrottle, useThrottleCallback, useUpdateEffect, useUpdateLayoutEffect, useWindowSize } from '../chunk-S6SEGBX6.js';
+export { usePopover } from '../chunk-DRFNMZLG.js';
+export { useBreakpoints, useClickOutside, useCopyToClipboard, useCountdown, useDebounce, useDebounceCallback, useEventListener, useInterval, useIsClient, useLocalStorage, useMuiMediaQuery as useMediaQuery, useMounted, useMultiSelect, usePrevious, useSetState, useTimeout } from '../chunk-BZOL7GMU.js';
+import '../chunk-ZTATTUH7.js';
+import '../chunk-AD4W7HYC.js';
+export { useBoolean } from '../chunk-BRDWQVRT.js';
+import '../chunk-YSIG2XYH.js';
+import '../chunk-XIXSSI3B.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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

@@ -0,0 +1,126 @@
+/**
+ * Return type for useArray hook.
+ */
+export interface UseArrayReturn<T> {
+    /** Current array value */
+    value: T[];
+    /** Set array to new value */
+    setValue: React.Dispatch<React.SetStateAction<T[]>>;
+    /** Add item to end of array */
+    push: (item: T) => void;
+    /** Add items to end of array */
+    pushMany: (items: T[]) => void;
+    /** Remove first occurrence of item (by reference or predicate) */
+    remove: (itemOrPredicate: T | ((item: T) => boolean)) => void;
+    /** Remove item at index */
+    removeAt: (index: number) => void;
+    /** Remove items matching predicate */
+    removeWhere: (predicate: (item: T) => boolean) => void;
+    /** Update item at index */
+    updateAt: (index: number, item: T) => void;
+    /** Update item at index with partial data (merge) */
+    updateAtPartial: (index: number, partial: Partial<T>) => void;
+    /** Update items matching predicate */
+    updateWhere: (predicate: (item: T) => boolean, update: T | ((item: T) => T)) => void;
+    /** Insert item at index */
+    insertAt: (index: number, item: T) => void;
+    /** Move item from one index to another */
+    move: (fromIndex: number, toIndex: number) => void;
+    /** Swap items at two indices */
+    swap: (indexA: number, indexB: number) => void;
+    /** Clear all items */
+    clear: () => void;
+    /** Reset to initial value */
+    reset: () => void;
+    /** Reverse array in place */
+    reverse: () => void;
+    /** Sort array */
+    sort: (compareFn?: (a: T, b: T) => number) => void;
+    /** Filter array (returns new array, does not modify state) */
+    filter: (predicate: (item: T) => boolean) => T[];
+    /** Find item (returns item, does not modify state) */
+    find: (predicate: (item: T) => boolean) => T | undefined;
+    /** Find item index (returns index, does not modify state) */
+    findIndex: (predicate: (item: T) => boolean) => number;
+    /** Check if array includes item */
+    includes: (item: T) => boolean;
+    /** Get array length */
+    length: number;
+    /** Check if array is empty */
+    isEmpty: boolean;
+    /** Get first item */
+    first: T | undefined;
+    /** Get last item */
+    last: T | undefined;
+}
+/**
+ * Hook for managing array state with CRUD operations.
+ *
+ * @param initialValue - Initial array value
+ * @returns Array value and manipulation methods
+ *
+ * @example
+ * ```tsx
+ * function TodoList() {
+ *   const todos = useArray<{ id: number; text: string; done: boolean }>([]);
+ *
+ *   const addTodo = (text: string) => {
+ *     todos.push({ id: Date.now(), text, done: false });
+ *   };
+ *
+ *   const toggleTodo = (id: number) => {
+ *     todos.updateWhere(
+ *       (todo) => todo.id === id,
+ *       (todo) => ({ ...todo, done: !todo.done })
+ *     );
+ *   };
+ *
+ *   return (
+ *     <ul>
+ *       {todos.value.map((todo) => (
+ *         <li key={todo.id} onClick={() => toggleTodo(todo.id)}>
+ *           {todo.text} {todo.done && '✓'}
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Drag and drop reordering
+ * function SortableList() {
+ *   const items = useArray(['A', 'B', 'C', 'D']);
+ *
+ *   const handleDragEnd = (fromIndex: number, toIndex: number) => {
+ *     items.move(fromIndex, toIndex);
+ *   };
+ *
+ *   return <DraggableList items={items.value} onReorder={handleDragEnd} />;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With type-safe updates
+ * interface User {
+ *   id: number;
+ *   name: string;
+ *   email: string;
+ * }
+ *
+ * function UserList() {
+ *   const users = useArray<User>([
+ *     { id: 1, name: 'Alice', email: 'alice@example.com' },
+ *   ]);
+ *
+ *   // Partial update (type-safe)
+ *   users.updateAtPartial(0, { email: 'alice@newdomain.com' });
+ *
+ *   return <div>{users.value.map(u => u.name).join(', ')}</div>;
+ * }
+ * ```
+ */
+export declare function useArray<T>(initialValue?: T[]): UseArrayReturn<T>;
+//# sourceMappingURL=use-array.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-array.d.ts","sourceRoot":"","sources":["../../src/hooks/use-array.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,0BAA0B;IAC1B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,6BAA6B;IAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpD,+BAA+B;IAC/B,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IACxB,gCAAgC;IAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAC/B,kEAAkE;IAClE,MAAM,EAAE,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,KAAK,IAAI,CAAC;IAC9D,2BAA2B;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,sCAAsC;IACtC,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,KAAK,IAAI,CAAC;IACvD,2BAA2B;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC3C,qDAAqD;IACrD,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC9D,sCAAsC;IACtC,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC;IACrF,2BAA2B;IAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC3C,0CAA0C;IAC1C,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,gCAAgC;IAChC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,sBAAsB;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,iBAAiB;IACjB,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,KAAK,IAAI,CAAC;IACnD,8DAA8D;IAC9D,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,KAAK,CAAC,EAAE,CAAC;IACjD,sDAAsD;IACtD,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,KAAK,CAAC,GAAG,SAAS,CAAC;IACzD,6DAA6D;IAC7D,SAAS,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,KAAK,MAAM,CAAC;IACvD,mCAAmC;IACnC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IAC/B,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IACrB,oBAAoB;IACpB,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,YAAY,GAAE,CAAC,EAAO,GAAG,cAAc,CAAC,CAAC,CAAC,CAuKrE"}

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

@@ -0,0 +1,88 @@
+/**
+ * Async state.
+ */
+export interface AsyncState<T> {
+    /** Data result */
+    data: T | null;
+    /** Loading state */
+    loading: boolean;
+    /** Error state */
+    error: Error | null;
+}
+/**
+ * Return type for useAsync hook.
+ */
+export interface UseAsyncReturn<T, Args extends unknown[]> extends AsyncState<T> {
+    /** Execute the async function */
+    execute: (...args: Args) => Promise<T>;
+    /** Reset state */
+    reset: () => void;
+    /** Set data manually */
+    setData: (data: T | null) => void;
+    /** Set error manually */
+    setError: (error: Error | null) => void;
+}
+/**
+ * Options for useAsync hook.
+ */
+export interface UseAsyncOptions<T> {
+    /** Initial data */
+    initialData?: T | null;
+    /** Auto-execute on mount */
+    immediate?: boolean;
+    /** On success callback */
+    onSuccess?: (data: T) => void;
+    /** On error callback */
+    onError?: (error: Error) => void;
+}
+/**
+ * useAsync - Hook for managing async operations.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * const { data, loading, error, execute } = useAsync(fetchUser);
+ *
+ * // Auto-execute on mount
+ * const { data, loading } = useAsync(fetchUsers, { immediate: true });
+ *
+ * // With callbacks
+ * const { execute } = useAsync(createUser, {
+ *   onSuccess: (user) => toast.success(`Created ${user.name}`),
+ *   onError: (err) => toast.error(err.message),
+ * });
+ *
+ * // In a component
+ * const handleSubmit = async () => {
+ *   const result = await execute(formData);
+ *   if (result) navigate('/success');
+ * };
+ * ```
+ */
+export declare function useAsync<T, Args extends unknown[] = []>(asyncFn: (...args: Args) => Promise<T>, options?: UseAsyncOptions<T>): UseAsyncReturn<T, Args>;
+/**
+ * Return type for useAsyncFn hook (simpler version).
+ */
+export interface UseAsyncFnReturn<T, Args extends unknown[]> {
+    /** Execute the async function */
+    execute: (...args: Args) => Promise<T | undefined>;
+    /** Loading state */
+    loading: boolean;
+    /** Error state */
+    error: Error | null;
+}
+/**
+ * useAsyncFn - Simpler hook for async functions without data tracking.
+ *
+ * @example
+ * ```tsx
+ * const { execute, loading, error } = useAsyncFn(deleteUser);
+ *
+ * const handleDelete = async (id: string) => {
+ *   await execute(id);
+ *   refetch(); // Trigger parent refresh
+ * };
+ * ```
+ */
+export declare function useAsyncFn<T, Args extends unknown[] = []>(asyncFn: (...args: Args) => Promise<T>): UseAsyncFnReturn<T, Args>;
+//# sourceMappingURL=use-async.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-async.d.ts","sourceRoot":"","sources":["../../src/hooks/use-async.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,kBAAkB;IAClB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IAC9E,iCAAiC;IACjC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IACvC,kBAAkB;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,wBAAwB;IACxB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;IAClC,yBAAyB;IACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,mBAAmB;IACnB,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACvB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,wBAAwB;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,GAAG,EAAE,EACrD,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EACtC,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM,GAC/B,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,CA6FzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE;IACzD,iCAAiC;IACjC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACnD,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,GAAG,EAAE,EACvD,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GACrC,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,CAoC3B"}

package/dist/hooks/use-back-to-top.d.ts

@@ -0,0 +1,57 @@
+/**
+ * useBackToTop Hook
+ *
+ * Manages visibility of a "Back to Top" button based on scroll position.
+ * Supports both percentage-based and pixel-based visibility thresholds.
+ *
+ * @module @omnitron-dev/prism/hooks
+ */
+import type { Dispatch, SetStateAction } from 'react';
+/**
+ * Return type for useBackToTop hook.
+ */
+export interface UseBackToTopReturn {
+    /** Whether the "Back to Top" button should be visible */
+    isVisible: boolean;
+    /** Function to scroll smoothly to top */
+    onBackToTop: () => void;
+    /** Manual visibility control */
+    setIsVisible: Dispatch<SetStateAction<boolean>>;
+}
+/**
+ * Hook to manage the visibility of a "Back to Top" button based on scroll position.
+ *
+ * Two modes are supported:
+ * - **Percentage mode**: Button becomes visible when scrolled past N% of the page.
+ *   Pass a string like '90%' as the threshold.
+ * - **Pixel mode**: Button becomes visible when within N pixels of the bottom.
+ *   Pass a number like 80 as the threshold.
+ *
+ * @param threshold - Visibility threshold
+ *   - String with '%' (e.g., '90%'): Show when scroll progress >= this percentage
+ *   - Number (e.g., 80): Show when within this many pixels from bottom
+ * @param debounce - Whether to debounce the scroll handler (100ms)
+ * @returns Visibility state and scroll control functions
+ *
+ * @example
+ * ```tsx
+ * // Show when scrolled 90% down the page
+ * const { isVisible, onBackToTop } = useBackToTop('90%');
+ *
+ * // Show when within 80px of the bottom
+ * const { isVisible, onBackToTop } = useBackToTop(80);
+ *
+ * // With debouncing for better performance
+ * const { isVisible, onBackToTop } = useBackToTop('85%', true);
+ *
+ * return (
+ *   <Fade in={isVisible}>
+ *     <Fab onClick={onBackToTop} sx={{ position: 'fixed', bottom: 16, right: 16 }}>
+ *       <KeyboardArrowUpIcon />
+ *     </Fab>
+ *   </Fade>
+ * );
+ * ```
+ */
+export declare function useBackToTop(threshold?: string | number, debounce?: boolean): UseBackToTopReturn;
+//# sourceMappingURL=use-back-to-top.d.ts.map

package/dist/hooks/use-back-to-top.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-back-to-top.d.ts","sourceRoot":"","sources":["../../src/hooks/use-back-to-top.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAOtD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,gCAAgC;IAChC,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;CACjD;AAwCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,YAAY,CAAC,SAAS,GAAE,MAAM,GAAG,MAAc,EAAE,QAAQ,GAAE,OAAe,GAAG,kBAAkB,CA2D9G"}