@orion-ds/react 4.6.5 → 4.7.0

package/dist/examples/LandingPage.example.d 4.ts

@@ -0,0 +1,47 @@
+/**
+ * Landing Page Example
+ *
+ * For a complete, full-featured landing page example with pre-built sections
+ * (Hero, Features, Pricing, Testimonials, FAQ, CTA, Footer), see @orion-ds/blocks.
+ *
+ * @example Using @orion-ds/blocks
+ * ```tsx
+ * // Install: npm install @orion-ds/blocks
+ * import { LandingPageTemplate } from '@orion-ds/blocks/templates';
+ *
+ * function App() {
+ *   return <LandingPageTemplate />;
+ * }
+ * ```
+ *
+ * @example Using free components (this package)
+ * ```tsx
+ * import { Section, Container } from '@orion/react/sections';
+ * import { Button, Navbar } from '@orion/react';
+ *
+ * function LandingPage() {
+ *   return (
+ *     <>
+ *       <Navbar />
+ *       <Section>
+ *         <Container>
+ *           <h1>Welcome to Orion</h1>
+ *           <p>Build faster with the AI-first design system</p>
+ *           <Button variant="primary">Get Started</Button>
+ *         </Container>
+ *       </Section>
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @module examples
+ */
+/**
+ * Simple landing page example using free Orion components
+ *
+ * For a full-featured landing page with pre-built sections and templates,
+ * install @orion-ds/blocks: `npm install @orion-ds/blocks`
+ */
+export declare function LandingPageExample(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=LandingPage.example.d.ts.map

package/dist/examples/LandingPage.example.d.ts 4.map

@@ -0,0 +1 @@
+{"version":3,"file":"LandingPage.example.d.ts","sourceRoot":"","sources":["../../src/examples/LandingPage.example.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAOH;;;;;GAKG;AACH,wBAAgB,kBAAkB,4CA6FjC"}

package/dist/examples/index.d 4.ts

@@ -0,0 +1,22 @@
+/**
+ * @orion/react Examples
+ *
+ * Complete, copy-paste ready examples demonstrating how to use
+ * Orion components and sections together.
+ *
+ * @example
+ * ```tsx
+ * import { LandingPageExample } from '@orion/react';
+ *
+ * // Use directly for testing
+ * function App() {
+ *   return <LandingPageExample />;
+ * }
+ *
+ * // Or study the source code to build your own
+ * ```
+ *
+ * @module examples
+ */
+export { LandingPageExample } from './LandingPage.example';
+//# sourceMappingURL=index.d.ts.map

package/dist/examples/index.d.ts 4.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/examples/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * Orion React Hooks
+ *
+ * A collection of utility hooks for building React applications.
+ */
+export { useTheme } from './useTheme';
+export type { UseThemeOptions, UseThemeReturn } from './useTheme';
+export { useMediaQuery, useIsMobile, useIsTablet, useIsDesktop, usePrefersDarkMode, usePrefersReducedMotion, } from './useMediaQuery';
+export { useClickOutside, useClickOutsideMultiple } from './useClickOutside';
+export { useDisclosure } from './useDisclosure';
+export type { UseDisclosureOptions, UseDisclosureReturn, } from './useDisclosure';
+export { useDebounce, useDebouncedCallback } from './useDebounce';
+export type { UseDebouncedCallbackOptions } from './useDebounce';
+export { useLocalStorage, useSessionStorage } from './useLocalStorage';
+export type { UseLocalStorageOptions } from './useLocalStorage';
+export { useCopyToClipboard, useCopy } from './useCopyToClipboard';
+export type { UseCopyToClipboardOptions, UseCopyToClipboardReturn, } from './useCopyToClipboard';
+export { useKeyboard, useKeyboardShortcuts } from './useKeyboard';
+export type { KeyModifiers, UseKeyboardOptions, KeyboardShortcuts, } from './useKeyboard';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGlE,OAAO,EACL,aAAa,EACb,WAAW,EACX,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGhE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACnE,YAAY,EACV,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,eAAe,CAAC"}

package/dist/hooks/useClickOutside.d 4.ts

@@ -0,0 +1,19 @@
+import { RefObject } from 'react';
+
+/**
+ * Hook to detect clicks outside of a referenced element
+ *
+ * @param ref - React ref to the element to monitor
+ * @param handler - Callback function when click outside is detected
+ * @param enabled - Whether the hook is active (default: true)
+ */
+export declare function useClickOutside<T extends HTMLElement = HTMLElement>(ref: RefObject<T | null>, handler: (event: MouseEvent | TouchEvent) => void, enabled?: boolean): void;
+/**
+ * Hook to detect clicks outside of multiple elements
+ *
+ * @param refs - Array of React refs to monitor
+ * @param handler - Callback function when click outside all refs is detected
+ * @param enabled - Whether the hook is active (default: true)
+ */
+export declare function useClickOutsideMultiple<T extends HTMLElement = HTMLElement>(refs: RefObject<T | null>[], handler: (event: MouseEvent | TouchEvent) => void, enabled?: boolean): void;
+//# sourceMappingURL=useClickOutside.d.ts.map

package/dist/hooks/useClickOutside.d.ts 4.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClickOutside.d.ts","sourceRoot":"","sources":["../../src/hooks/useClickOutside.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACjE,GAAG,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,EACxB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,KAAK,IAAI,EACjD,OAAO,GAAE,OAAc,GACtB,IAAI,CA0BN;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACzE,IAAI,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,EAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,KAAK,IAAI,EACjD,OAAO,GAAE,OAAc,GACtB,IAAI,CA2BN"}

package/dist/hooks/useCopyToClipboard.d 4.ts

@@ -0,0 +1,72 @@
+/**
+ * useCopyToClipboard Hook
+ *
+ * Provides a function to copy text to clipboard with status tracking.
+ *
+ * @example
+ * ```tsx
+ * const { copy, copied, error } = useCopyToClipboard();
+ *
+ * return (
+ *   <Button onClick={() => copy('Hello!')}>
+ *     {copied ? 'Copied!' : 'Copy'}
+ *   </Button>
+ * );
+ * ```
+ */
+/**
+ * Options for useCopyToClipboard hook
+ */
+export interface UseCopyToClipboardOptions {
+    /**
+     * Duration in ms to show "copied" state
+     * @default 2000
+     */
+    copiedDuration?: number;
+    /**
+     * Callback when copy succeeds
+     */
+    onSuccess?: (text: string) => void;
+    /**
+     * Callback when copy fails
+     */
+    onError?: (error: Error) => void;
+}
+/**
+ * Return type for useCopyToClipboard hook
+ */
+export interface UseCopyToClipboardReturn {
+    /**
+     * Function to copy text to clipboard
+     */
+    copy: (text: string) => Promise<boolean>;
+    /**
+     * Whether text was recently copied
+     */
+    copied: boolean;
+    /**
+     * The last copied text
+     */
+    copiedText: string | null;
+    /**
+     * Any error that occurred
+     */
+    error: Error | null;
+    /**
+     * Reset the copied state
+     */
+    reset: () => void;
+}
+/**
+ * Hook to copy text to clipboard
+ *
+ * @param options - Configuration options
+ * @returns Copy function and status
+ */
+export declare function useCopyToClipboard(options?: UseCopyToClipboardOptions): UseCopyToClipboardReturn;
+/**
+ * Simplified hook that just returns the copy function
+ * For simple use cases where you don't need status tracking
+ */
+export declare function useCopy(): (text: string) => Promise<boolean>;
+//# sourceMappingURL=useCopyToClipboard.d.ts.map

package/dist/hooks/useCopyToClipboard.d.ts 4.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopyToClipboard.d.ts","sourceRoot":"","sources":["../../src/hooks/useCopyToClipboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnC;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzC;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,yBAA8B,GACtC,wBAAwB,CA2E1B;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAG5D"}

package/dist/hooks/useDebounce.d 4.ts

@@ -0,0 +1,58 @@
+/**
+ * useDebounce Hook
+ *
+ * Debounces a value, updating only after a specified delay.
+ *
+ * @example
+ * ```tsx
+ * const [search, setSearch] = useState('');
+ * const debouncedSearch = useDebounce(search, 300);
+ *
+ * useEffect(() => {
+ *   // Only runs 300ms after user stops typing
+ *   fetchResults(debouncedSearch);
+ * }, [debouncedSearch]);
+ * ```
+ */
+/**
+ * Hook to debounce a value
+ *
+ * @param value - Value to debounce
+ * @param delay - Debounce delay in milliseconds
+ * @returns Debounced value
+ */
+export declare function useDebounce<T>(value: T, delay: number): T;
+/**
+ * Options for useDebouncedCallback
+ */
+export interface UseDebouncedCallbackOptions {
+    /**
+     * Whether to call immediately on the leading edge
+     * @default false
+     */
+    leading?: boolean;
+    /**
+     * Whether to call on the trailing edge
+     * @default true
+     */
+    trailing?: boolean;
+    /**
+     * Maximum time to wait before forcing invocation
+     */
+    maxWait?: number;
+}
+/**
+ * Hook to create a debounced callback function
+ *
+ * @param callback - Function to debounce
+ * @param delay - Debounce delay in milliseconds
+ * @param options - Additional options
+ * @returns Debounced callback and control functions
+ */
+export declare function useDebouncedCallback<T extends (...args: unknown[]) => unknown>(callback: T, delay: number, options?: UseDebouncedCallbackOptions): {
+    callback: (...args: Parameters<T>) => void;
+    cancel: () => void;
+    flush: () => void;
+    isPending: () => boolean;
+};
+//# sourceMappingURL=useDebounce.d.ts.map

package/dist/hooks/useDebounce.d.ts 4.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.d.ts","sourceRoot":"","sources":["../../src/hooks/useDebounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAczD;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAC5E,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,2BAAgC,GACxC;IACD,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC3C,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B,CAmFA"}

package/dist/hooks/useDisclosure.d 4.ts

@@ -0,0 +1,86 @@
+/**
+ * useDisclosure Hook
+ *
+ * Manages open/close state for modals, drawers, dropdowns, etc.
+ *
+ * @example
+ * ```tsx
+ * // Orion convention (preferred)
+ * const { isOpen, open, close, toggle } = useDisclosure();
+ *
+ * // MUI/Chakra/Radix convention (also works)
+ * const { isOpen, onOpen, onClose, toggle } = useDisclosure();
+ *
+ * return (
+ *   <>
+ *     <Button onClick={toggle}>Toggle Modal</Button>
+ *     <Modal open={isOpen} onClose={close}>
+ *       Content
+ *     </Modal>
+ *   </>
+ * );
+ * ```
+ */
+/**
+ * Options for useDisclosure hook
+ */
+export interface UseDisclosureOptions {
+    /**
+     * Initial open state
+     * @default false
+     */
+    defaultOpen?: boolean;
+    /**
+     * Callback when state changes to open
+     */
+    onOpen?: () => void;
+    /**
+     * Callback when state changes to closed
+     */
+    onClose?: () => void;
+    /**
+     * Callback when state changes (open or close)
+     */
+    onChange?: (isOpen: boolean) => void;
+}
+/**
+ * Return type for useDisclosure hook
+ */
+export interface UseDisclosureReturn {
+    /**
+     * Whether the disclosure is open
+     */
+    isOpen: boolean;
+    /**
+     * Open the disclosure
+     */
+    open: () => void;
+    /**
+     * Close the disclosure
+     */
+    close: () => void;
+    /**
+     * Alias for `open` - familiar for devs from MUI/Chakra/Radix
+     */
+    onOpen: () => void;
+    /**
+     * Alias for `close` - familiar for devs from MUI/Chakra/Radix
+     */
+    onClose: () => void;
+    /**
+     * Toggle the disclosure
+     */
+    toggle: () => void;
+    /**
+     * Set the disclosure state directly
+     */
+    setIsOpen: (value: boolean) => void;
+}
+/**
+ * Hook for managing open/close state
+ *
+ * @param options - Configuration options
+ * @returns Disclosure state and control functions
+ */
+export declare function useDisclosure(options?: UseDisclosureOptions): UseDisclosureReturn;
+//# sourceMappingURL=useDisclosure.d.ts.map

package/dist/hooks/useDisclosure.d.ts 4.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDisclosure.d.ts","sourceRoot":"","sources":["../../src/hooks/useDisclosure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CAoDrB"}

package/dist/hooks/useKeyboard.d 4.ts

@@ -0,0 +1,101 @@
+/**
+ * useKeyboard Hook
+ *
+ * Handles keyboard shortcuts and key events.
+ *
+ * @example
+ * ```tsx
+ * // Single key
+ * useKeyboard('Escape', () => closeModal());
+ *
+ * // With modifiers
+ * useKeyboard('k', () => openSearch(), { meta: true });
+ * useKeyboard('s', () => save(), { ctrl: true });
+ *
+ * // Multiple keys
+ * useKeyboardShortcuts({
+ *   'Escape': () => closeModal(),
+ *   'Meta+k': () => openSearch(),
+ *   'Ctrl+s': () => save(),
+ * });
+ * ```
+ */
+/**
+ * Key modifier options
+ */
+export interface KeyModifiers {
+    /**
+     * Require Ctrl key
+     * @default false
+     */
+    ctrl?: boolean;
+    /**
+     * Require Alt/Option key
+     * @default false
+     */
+    alt?: boolean;
+    /**
+     * Require Shift key
+     * @default false
+     */
+    shift?: boolean;
+    /**
+     * Require Meta/Cmd key (Mac) or Windows key
+     * @default false
+     */
+    meta?: boolean;
+}
+/**
+ * Options for useKeyboard hook
+ */
+export interface UseKeyboardOptions extends KeyModifiers {
+    /**
+     * Whether the handler is enabled
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Event type to listen for
+     * @default 'keydown'
+     */
+    event?: "keydown" | "keyup" | "keypress";
+    /**
+     * Whether to prevent default browser behavior
+     * @default true
+     */
+    preventDefault?: boolean;
+    /**
+     * Whether to stop event propagation
+     * @default false
+     */
+    stopPropagation?: boolean;
+    /**
+     * Target element (default: document)
+     */
+    target?: HTMLElement | null;
+    /**
+     * Only trigger if target element is focused
+     * @default false
+     */
+    targetOnly?: boolean;
+}
+/**
+ * Hook to handle a single keyboard shortcut
+ *
+ * @param key - Key to listen for (e.g., 'Escape', 'Enter', 'k')
+ * @param handler - Callback when key is pressed
+ * @param options - Additional options
+ */
+export declare function useKeyboard(key: string, handler: (event: KeyboardEvent) => void, options?: UseKeyboardOptions): void;
+/**
+ * Shortcut definition with handler
+ */
+export type KeyboardShortcuts = Record<string, () => void>;
+/**
+ * Hook to handle multiple keyboard shortcuts
+ *
+ * @param shortcuts - Object mapping shortcut strings to handlers
+ * @param options - Common options for all shortcuts
+ */
+export declare function useKeyboardShortcuts(shortcuts: KeyboardShortcuts, options?: Omit<UseKeyboardOptions, keyof KeyModifiers>): void;
+//# sourceMappingURL=useKeyboard.d.ts.map

package/dist/hooks/useKeyboard.d.ts 4.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboard.d.ts","sourceRoot":"","sources":["../../src/hooks/useKeyboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IAEzC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAE5B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,EACvC,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CAqFN;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;AA0C3D;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,YAAY,CAAM,GACzD,IAAI,CAkEN"}

package/dist/hooks/useLocalStorage.d 4.ts

@@ -0,0 +1,48 @@
+/**
+ * useLocalStorage Hook
+ *
+ * Syncs state with localStorage for persistence across sessions.
+ *
+ * @example
+ * ```tsx
+ * const [theme, setTheme] = useLocalStorage('theme', 'light');
+ * const [user, setUser] = useLocalStorage<User | null>('user', null);
+ *
+ * // Value persists across page refreshes
+ * setTheme('dark');
+ * ```
+ */
+/**
+ * Options for useLocalStorage hook
+ */
+export interface UseLocalStorageOptions<T> {
+    /**
+     * Custom serializer function
+     * @default JSON.stringify
+     */
+    serializer?: (value: T) => string;
+    /**
+     * Custom deserializer function
+     * @default JSON.parse
+     */
+    deserializer?: (value: string) => T;
+    /**
+     * Whether to sync across tabs
+     * @default true
+     */
+    syncAcrossTabs?: boolean;
+}
+/**
+ * Hook to sync state with localStorage
+ *
+ * @param key - localStorage key
+ * @param initialValue - Initial value if key doesn't exist
+ * @param options - Additional options
+ * @returns [value, setValue, removeValue]
+ */
+export declare function useLocalStorage<T>(key: string, initialValue: T, options?: UseLocalStorageOptions<T>): [T, (value: T | ((prev: T) => T)) => void, () => void];
+/**
+ * Hook to sync state with sessionStorage (similar to useLocalStorage)
+ */
+export declare function useSessionStorage<T>(key: string, initialValue: T, options?: Omit<UseLocalStorageOptions<T>, "syncAcrossTabs">): [T, (value: T | ((prev: T) => T)) => void, () => void];
+//# sourceMappingURL=useLocalStorage.d.ts.map

package/dist/hooks/useLocalStorage.d.ts 4.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalStorage.d.ts","sourceRoot":"","sources":["../../src/hooks/useLocalStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IAElC;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC;IAEpC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,EACf,OAAO,GAAE,sBAAsB,CAAC,CAAC,CAAM,GACtC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,MAAM,IAAI,CAAC,CAkHxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,EACf,OAAO,GAAE,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAM,GAC9D,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,MAAM,IAAI,CAAC,CAwDxD"}

package/dist/hooks/useMediaQuery.d 4.ts

@@ -0,0 +1,43 @@
+/**
+ * useMediaQuery Hook
+ *
+ * Detects if a media query matches the current viewport.
+ *
+ * @example
+ * ```tsx
+ * const isMobile = useMediaQuery('(max-width: 768px)');
+ * const isDark = useMediaQuery('(prefers-color-scheme: dark)');
+ * const prefersReducedMotion = useMediaQuery('(prefers-reduced-motion: reduce)');
+ * ```
+ */
+/**
+ * Hook to detect if a media query matches
+ *
+ * @param query - CSS media query string
+ * @returns Whether the media query matches
+ */
+export declare function useMediaQuery(query: string): boolean;
+/**
+ * Preset breakpoint hooks based on Orion Design System
+ */
+/**
+ * Returns true if viewport is mobile (< 640px)
+ */
+export declare function useIsMobile(): boolean;
+/**
+ * Returns true if viewport is tablet (640px - 1023px)
+ */
+export declare function useIsTablet(): boolean;
+/**
+ * Returns true if viewport is desktop (>= 1024px)
+ */
+export declare function useIsDesktop(): boolean;
+/**
+ * Returns true if user prefers dark color scheme
+ */
+export declare function usePrefersDarkMode(): boolean;
+/**
+ * Returns true if user prefers reduced motion
+ */
+export declare function usePrefersReducedMotion(): boolean;
+//# sourceMappingURL=useMediaQuery.d.ts.map

package/dist/hooks/useMediaQuery.d.ts 4.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMediaQuery.d.ts","sourceRoot":"","sources":["../../src/hooks/useMediaQuery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAoCpD;AAED;;GAEG;AAEH;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD"}

package/dist/hooks/useTheme.d 4.ts

@@ -0,0 +1,73 @@
+/**
+ * useTheme Hook
+ *
+ * React hook for managing theme and brand state in Orion Design System.
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const { theme, brand, setTheme, setBrand } = useTheme();
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={() => setTheme('dark')}>
+ *         Switch to {theme === 'light' ? 'dark' : 'light'} mode
+ *       </button>
+ *       <button onClick={() => setBrand('red')}>
+ *         Switch to Red brand
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export type Theme = "light" | "dark";
+export type Brand = "orion" | "red" | "deepblue" | "orange" | "ember" | "lemon";
+export interface UseThemeOptions {
+    /**
+     * Default theme to use
+     * @default 'light'
+     */
+    defaultTheme?: Theme;
+    /**
+     * Default brand to use
+     * @default 'orion'
+     */
+    defaultBrand?: Brand;
+    /**
+     * Store theme preference in localStorage
+     * @default true
+     */
+    storageEnabled?: boolean;
+    /**
+     * localStorage key for theme
+     * @default 'orion-theme'
+     */
+    storageKey?: string;
+    /**
+     * localStorage key for brand
+     * @default 'orion-brand'
+     */
+    brandStorageKey?: string;
+}
+export interface UseThemeReturn {
+    /** Current theme */
+    theme: Theme;
+    /** Current brand */
+    brand: Brand;
+    /** Set theme */
+    setTheme: (theme: Theme) => void;
+    /** Set brand */
+    setBrand: (brand: Brand) => void;
+    /** Toggle between light and dark themes */
+    toggleTheme: () => void;
+    /** Check if current theme is dark */
+    isDark: boolean;
+    /** Check if current theme is light */
+    isLight: boolean;
+}
+/**
+ * Hook for managing theme and brand state
+ */
+export declare function useTheme(options?: UseThemeOptions): UseThemeReturn;
+//# sourceMappingURL=useTheme.d.ts.map

package/dist/hooks/useTheme.d.ts 4.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme.d.ts","sourceRoot":"","sources":["../../src/hooks/useTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AACrC,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAahF,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,KAAK,EAAE,KAAK,CAAC;IAEb,oBAAoB;IACpB,KAAK,EAAE,KAAK,CAAC;IAEb,gBAAgB;IAChB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC,gBAAgB;IAChB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC,2CAA2C;IAC3C,WAAW,EAAE,MAAM,IAAI,CAAC;IAExB,qCAAqC;IACrC,MAAM,EAAE,OAAO,CAAC;IAEhB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,cAAc,CAuHtE"}