@codeleap/web 6.3.0 → 7.0.0

package/dist/components/Touchable/index.d.ts

@@ -1,13 +1,17 @@
 import { ElementType } from 'react';
 import { TouchableProps } from './types';
-import { AnyRecord, IJSX, StyledComponentProps } from '@codeleap/styles';
 export * from './styles';
 export * from './types';
-export declare const Touchable: {
-    (touchableProps: TouchableProps): import("@emotion/react/jsx-runtime").JSX.Element;
-    styleRegistryName: string;
-    elements: string[];
-    rootElement: string;
-    withVariantTypes<S extends AnyRecord>(styles: S): <T extends ElementType = "button">(props: StyledComponentProps<TouchableProps<T>, typeof styles>) => IJSX;
-    defaultProps: Partial<TouchableProps>;
-};
+/**
+ * Click wrapper that normalises keyboard Enter presses as clicks, debounces
+ * repeated presses, propagates analytics events, and applies disabled state.
+ * Uses: `useStylesFor`, `WebStyleRegistry`
+ */
+export declare function Touchable<T extends ElementType>(touchableProps: TouchableProps<T>): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare namespace Touchable {
+    var styleRegistryName: string;
+    var elements: string[];
+    var rootElement: string;
+    var defaultProps: Partial<TouchableProps>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/components/Touchable/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Touchable/index.tsx"],"names":[],"mappings":"AAEA,OAAc,EAAiB,WAAW,EAAkB,MAAM,OAAO,CAAA;AAGzE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAMxC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AAEvB;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,WAAW,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,oDA2FjF;yBA3Fe,SAAS"}

package/dist/components/Touchable/styles.d.ts

@@ -1,3 +1,4 @@
 export type TouchableState = 'disabled';
 export type TouchableParts = 'wrapper';
 export type TouchableComposition = TouchableParts | `${TouchableParts}:${TouchableState}`;
+//# sourceMappingURL=styles.d.ts.map

package/dist/components/Touchable/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/components/Touchable/styles.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,UAAU,CAAA;AACvC,MAAM,MAAM,cAAc,GAAG,SAAS,CAAA;AACtC,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,GAAG,cAAc,IAAI,cAAc,EAAE,CAAA"}

package/dist/components/Touchable/types.d.ts

@@ -1,20 +1,31 @@
 import { AnyFunction } from '@codeleap/types';
 import { ComponentPropsWithRef, ElementType, ReactNode } from 'react';
 import { TouchableComposition } from './styles';
-import { AnyRecord, StyledProp } from '@codeleap/styles';
+import { AnyRecord, ICSS, StyleProp } from '@codeleap/styles';
+export interface TouchableStyleDef {
+    __internal: Record<TouchableComposition, ICSS>;
+}
+/**
+ * Props for the `Touchable` component.
+ *
+ * `debugName` is required to support analytics and test-id attribution.
+ */
 export type TouchableProps<T extends ElementType = 'button'> = Omit<ComponentPropsWithRef<T>, 'style'> & {
     component?: ElementType<AnyRecord>;
     disabled?: boolean;
+    /** When false, `stopPropagation` is called on every click event. Defaults to `true`. */
     propagate?: boolean;
     onPress?: AnyFunction;
     debugName: string;
     debugComponent?: string;
-    style?: StyledProp<TouchableComposition>;
+    style?: StyleProp<TouchableComposition, keyof TouchableStyleDef>;
+    /** Milliseconds to suppress repeated presses after the first; ignored when falsy. */
     debounce?: number;
+    /** When true, the debounce lock is active from mount and released after `debounce` ms. */
     leadingDebounce?: boolean;
-    setPressed?: (pressed: boolean) => void;
     analyticsEnabled?: boolean;
     analyticsName?: string;
     analyticsData?: Record<string, any>;
     children?: ReactNode;
 };
+//# sourceMappingURL=types.d.ts.map

package/dist/components/Touchable/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/Touchable/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAG7D,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAA;CAC/C;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,WAAW,GAAG,QAAQ,IAAI,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG;IACvG,SAAS,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wFAAwF;IACxF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC,oBAAoB,EAAE,MAAM,iBAAiB,CAAC,CAAA;IAChE,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0FAA0F;IAC1F,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACnC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAErB,CAAA"}

package/dist/components/View/index.d.ts

@@ -1,13 +1,17 @@
 import { ElementType } from 'react';
 import { ViewProps } from './types';
-import { AnyRecord, IJSX, StyledComponentProps } from '@codeleap/styles';
 export * from './styles';
 export * from './types';
-export declare const View: {
-    (viewProps: ViewProps): import("@emotion/react/jsx-runtime").JSX.Element;
-    styleRegistryName: string;
-    elements: string[];
-    rootElement: string;
-    withVariantTypes<S extends AnyRecord>(styles: S): <T extends ElementType = "div">(props: StyledComponentProps<ViewProps<T>, typeof styles>) => IJSX;
-    defaultProps: Partial<ViewProps>;
-};
+/**
+ * Generic layout wrapper that renders any DOM element with responsive styling,
+ * hover callbacks, and optional Framer Motion animation.
+ * Uses: `useStylesFor`, `WebStyleRegistry`
+ */
+export declare function View<T extends ElementType>(viewProps: ViewProps<T>): import("@emotion/react/jsx-runtime").JSX.Element;
+export declare namespace View {
+    var styleRegistryName: string;
+    var elements: string[];
+    var rootElement: string;
+    var defaultProps: Partial<ViewProps>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/components/View/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/View/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAMnC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AAEvB;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,oDA+ClE;yBA/Ce,IAAI"}

package/dist/components/View/styles.d.ts

@@ -1 +1,2 @@
 export type ViewComposition = 'wrapper';
+//# sourceMappingURL=styles.d.ts.map

package/dist/components/View/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/components/View/styles.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,SAAS,CAAA"}

package/dist/components/View/types.d.ts

@@ -1,7 +1,16 @@
 import { TargetAndTransition, MotionProps } from 'motion/react';
-import { AnyRecord, StyledProp } from '@codeleap/styles';
+import { AnyRecord, StyleProp } from '@codeleap/styles';
 import { ViewComposition } from './styles';
 import { ComponentPropsWithRef, ElementType } from 'react';
+export interface ViewStyleDef {
+}
+/**
+ * Props for the `View` component.
+ *
+ * Merges native element props with Framer Motion target values; use `animated`
+ * to opt in to Motion rendering and `animatedProps` to pass motion-specific
+ * configuration.
+ */
 export type ViewProps<T extends ElementType = 'div'> = Omit<ComponentPropsWithRef<T>, 'style' | 'children'> & Omit<TargetAndTransition, 'style' | 'children'> & {
     component?: ElementType<AnyRecord>;
     debugName?: string;
@@ -9,9 +18,13 @@ export type ViewProps<T extends ElementType = 'div'> = Omit<ComponentPropsWithRe
     not?: any;
     up?: any;
     down?: any;
+    /** Called with `true` on mouseenter, `false` on mouseleave. */
     onHover?: (isMouseOverElement: boolean) => void;
+    /** When true, renders a `motion.*` element instead of a plain DOM element. */
     animated?: boolean;
+    /** Framer Motion props applied on top of the native element props; only used when `animated` is true. */
     animatedProps?: Partial<MotionProps>;
-    style?: StyledProp<ViewComposition>;
+    style?: StyleProp<ViewComposition, keyof ViewStyleDef>;
     children?: React.ReactNode;
 };
+//# sourceMappingURL=types.d.ts.map

package/dist/components/View/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/View/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAE1D,MAAM,WAAW,YAAY;CAAG;AAEhC;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,WAAW,GAAG,KAAK,IACjD,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC,GACpD,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,UAAU,CAAC,GAC/C;IACE,SAAS,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAA;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,EAAE,CAAC,EAAE,GAAG,CAAA;IACR,GAAG,CAAC,EAAE,GAAG,CAAA;IACT,EAAE,CAAC,EAAE,GAAG,CAAA;IACR,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAAC,kBAAkB,EAAE,OAAO,KAAK,IAAI,CAAA;IAC/C,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,yGAAyG;IACzG,aAAa,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IACpC,KAAK,CAAC,EAAE,SAAS,CAAC,eAAe,EAAE,MAAM,YAAY,CAAC,CAAA;IACtD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B,CAAA"}

package/dist/components/components.d.ts

@@ -7,7 +7,6 @@ export * from './List';
 export * from './ActivityIndicator';
 export * from './Button';
 export * from './Modal';
-export * from './ActionIcon';
 export * from './Checkbox';
 export * from './Collapse';
 export * from './Drawer';
@@ -20,16 +19,16 @@ export * from './FileInput';
 export * from './Slider';
 export * from './List';
 export * from './LoadingOverlay';
-export * from './InputBase';
 export * from './Switch';
 export * from './NumberIncrement';
 export * from './SearchInput';
 export * from './Tooltip';
-export * from './SegmentedControl';
+export * from './Field';
 export * from './Carousel';
 export * from './EmptyPlaceholder';
 export * from './Badge';
 export * from './CropPicker';
+export * from './Calendar';
 export * from './DatePicker';
 export * from './Dropzone';
 export * from './Progress';
@@ -40,4 +39,4 @@ export * from './PaginationButtons';
 export * from './SectionFilters';
 export * from './PaginationIndicator';
 export * from './Carousel';
-export * from './VirtualList';
+//# sourceMappingURL=components.d.ts.map

package/dist/components/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/components/components.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AACtB,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,qBAAqB,CAAA;AACnC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,kBAAkB,CAAA;AAChC,cAAc,UAAU,CAAA;AACxB,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,OAAO,CAAA;AACrB,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,YAAY,CAAA"}

package/dist/index.d.ts

@@ -2,3 +2,4 @@ export * from './components/components';
 export * from './types';
 export * from './lib';
 export * from './lib/WebStyleRegistry';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA;AACvC,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA;AACrB,cAAc,wBAAwB,CAAA"}

package/dist/lib/ListMasonry.d.ts

@@ -17,3 +17,4 @@ export type ListMasonryProps<T> = MasonryProps<T> & {
 export declare function MasonryComponent<Item>(props: ListMasonryProps<Item>): JSX.Element;
 export declare function ListMasonry<Item>(props: ListMasonryProps<Item>): import("@emotion/react/jsx-runtime").JSX.Element;
 export {};
+//# sourceMappingURL=ListMasonry.d.ts.map

package/dist/lib/ListMasonry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListMasonry.d.ts","sourceRoot":"","sources":["../../src/lib/ListMasonry.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,EAML,YAAY,EACZ,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAgBhB,KAAK,oBAAoB,GAAG;IAC1B,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,MAAM,oBAAoB;;;;CAkC1D,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAA;AAEzD,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG;IAClD,mBAAmB,EAAE,MAAM,CAAA;IAC3B,eAAe,EAAE,OAAO,CAAA;CACzB,CAAA;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,eA0CnE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,oDAa9D"}

package/dist/lib/ThemeVariables.d.ts

@@ -0,0 +1,10 @@
+type ThemeVariablesTheme = {
+    getCssVariables: (schemeName?: string) => Record<string, string>;
+    alternateColors?: Record<string, any>;
+};
+export declare const ThemeVariables: ({ theme }: {
+    theme: ThemeVariablesTheme;
+}) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const ColorSchemeFoucScript: () => import("@emotion/react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ThemeVariables.d.ts.map

package/dist/lib/ThemeVariables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeVariables.d.ts","sourceRoot":"","sources":["../../src/lib/ThemeVariables.tsx"],"names":[],"mappings":"AAGA,KAAK,mBAAmB,GAAG;IACzB,eAAe,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CACtC,CAAA;AAKD,eAAO,MAAM,cAAc,GAAI,WAAW;IAAE,KAAK,EAAE,mBAAmB,CAAA;CAAE,qDAoBvE,CAAA;AAID,eAAO,MAAM,qBAAqB,wDAEjC,CAAA"}

package/dist/lib/WebStyleRegistry.d.ts

@@ -1,7 +1,28 @@
 import { AnyStyledComponent, CodeleapStyleRegistry, ICSS } from '@codeleap/styles';
+/**
+ * Singleton style registry for the web platform.
+ *
+ * Extends `CodeleapStyleRegistry` with localStorage-backed style persistence
+ * and a variant-element map that tracks which HTML element tag should be used
+ * for each component variant.
+ *
+ * Only one instance exists per JS runtime. The first `new WebStyleRegistry()`
+ * call creates the instance; subsequent calls return the same object. Components
+ * register themselves via the static `WebStyleRegistry.registerComponent()` —
+ * call this at module level so registrations survive before the registry is
+ * instantiated (they are replayed on construction).
+ *
+ * Access the live singleton via `WebStyleRegistry.current`.
+ */
 export declare class WebStyleRegistry extends CodeleapStyleRegistry {
+    variantElements: Record<string, Record<string, string>>;
     constructor();
+    /** Registers the HTML element tag to render for each variant of a component (e.g. `{ h1: 'h1', p: 'p' }`). */
+    registerVariantElements(componentName: string, elements: Record<string, string>): void;
+    /** Returns the element tag registered for the given component variant, or `undefined` if none was registered. */
+    variantElementFor(componentName: string, variantName: string): string | undefined;
     createStyle(css: ICSS): ICSS;
     static get current(): WebStyleRegistry;
     static registerComponent(component: AnyStyledComponent): void;
 }
+//# sourceMappingURL=WebStyleRegistry.d.ts.map

package/dist/lib/WebStyleRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebStyleRegistry.d.ts","sourceRoot":"","sources":["../../src/lib/WebStyleRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,IAAI,EAAkB,MAAM,kBAAkB,CAAA;AAqBlG;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAiB,SAAQ,qBAAqB;IACzD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAK;;IAgB5D,8GAA8G;IAC9G,uBAAuB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAI/E,iHAAiH;IACjH,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIjF,WAAW,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI;IAI5B,MAAM,KAAK,OAAO,qBAEjB;IAED,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,kBAAkB;CAMvD"}

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

@@ -17,3 +17,7 @@ export * from './useKeydown';
 export * from './useRefresh';
 export * from './useFileInput';
 export * from './useStylesFor';
+export * from './useAsyncSelect';
+export * from './useListFocus';
+export * from './usePopoverDismiss';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAEhC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA"}

package/dist/lib/hooks/useAnimatedStyle.d.ts

@@ -7,5 +7,13 @@ type UseAnimatedStyleReturn = {
     initial: boolean;
     transition: Transition | undefined;
 };
+/**
+ * Drives a Framer Motion `animate` prop from a reactive updater function.
+ *
+ * The transition from the initial call is captured once and held stable; only
+ * the animated target re-evaluates on dependency changes. Returns `initial: false`
+ * so Motion skips the mount animation and begins from the current state.
+ */
 export declare const useAnimatedStyle: (updater: () => UpdaterReturn, deps: Array<any>) => UseAnimatedStyleReturn;
 export {};
+//# sourceMappingURL=useAnimatedStyle.d.ts.map

package/dist/lib/hooks/useAnimatedStyle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnimatedStyle.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useAnimatedStyle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9D,KAAK,aAAa,GAAG,mBAAmB,GAAG;IACzC,UAAU,CAAC,EAAE,UAAU,CAAA;CACxB,CAAA;AAED,KAAK,sBAAsB,GAAG;IAC5B,OAAO,EAAE,mBAAmB,CAAA;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,UAAU,GAAG,SAAS,CAAA;CACnC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,aAAa,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC,KAAG,sBAiBjF,CAAA"}

package/dist/lib/hooks/useAnimatedVariantStyles.d.ts

@@ -6,5 +6,12 @@ type UseAnimatedVariantStylesConfig<T extends Record<string | number | symbol, a
     updater: (states: SelectProperties<T, K>) => TargetAndTransition;
     dependencies?: any[];
 };
+/**
+ * Derives a Framer Motion animation target from a component's variant styles,
+ * animating only the properties listed in `animatedProperties` while keeping the
+ * rest static (via `useStaticAnimationStyles`). Re-evaluates the `updater` whenever
+ * `dependencies` change.
+ */
 export declare function useAnimatedVariantStyles<T extends Record<string | number | symbol, any>, K extends keyof T>(config: UseAnimatedVariantStylesConfig<T, K>): TargetAndTransition;
 export {};
+//# sourceMappingURL=useAnimatedVariantStyles.d.ts.map

package/dist/lib/hooks/useAnimatedVariantStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnimatedVariantStyles.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useAnimatedVariantStyles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAI9C,KAAK,8BAA8B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI;IACxG,aAAa,EAAE,CAAC,CAAA;IAChB,kBAAkB,EAAE,CAAC,EAAE,CAAA;IACvB,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,mBAAmB,CAAA;IAChE,YAAY,CAAC,EAAE,GAAG,EAAE,CAAA;CACrB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,8BAA8B,CAAC,CAAC,EAAE,CAAC,CAAC,uBAgBxJ"}

package/dist/lib/hooks/useAsyncSelect.d.ts

@@ -0,0 +1,71 @@
+import React from 'react';
+import { type UseQueryOptions, type UseQueryResult } from '@tanstack/react-query';
+import { type ICSS } from '@codeleap/styles';
+/** Shape that `load` must resolve to in `useAsyncSelect`. */
+export type AsyncSelectLoadResult<TOption> = {
+    data: any;
+    results: TOption[];
+};
+/** Options for `useAsyncSelect`. */
+export type UseAsyncSelectOptions<TOption extends {
+    label: string;
+    value: any;
+}, TQuery = string> = {
+    queryKey?: readonly unknown[];
+    load: (query: TQuery) => Promise<AsyncSelectLoadResult<TOption>>;
+    /**
+     * Controls when load() is triggered. Defaults to non-empty/non-null check.
+     * Pass `() => true` to load on mount with an empty query.
+     */
+    isSearchValid?: (query: TQuery) => boolean;
+    renderError?: (error: unknown, style: ICSS) => React.ReactNode;
+    renderNoResults?: (query: TQuery, style: ICSS) => React.ReactNode;
+    renderLoading?: (style: ICSS) => React.ReactNode;
+    queryOptions?: Omit<UseQueryOptions<AsyncSelectLoadResult<TOption>, Error>, 'queryKey' | 'queryFn' | 'enabled'>;
+};
+type SelectCompatibleProps<TOption extends {
+    label: string;
+    value: any;
+}> = {
+    options: TOption[];
+    renderEmpty: (props: {
+        style: ICSS;
+    }) => React.ReactNode;
+};
+type AsyncSelectState<TOption extends {
+    label: string;
+    value: any;
+}, TQuery> = {
+    query: (q: TQuery) => void;
+    searchQuery: TQuery;
+    data: any;
+    isLoading: boolean;
+    error: unknown;
+    queryResult: UseQueryResult<AsyncSelectLoadResult<TOption>, Error>;
+};
+/**
+ * Tuple returned by `useAsyncSelect`.
+ * Index 0 contains the props to spread onto a `Select` component;
+ * index 1 exposes the raw query state and the underlying `useQuery` result.
+ */
+export type UseAsyncSelectReturn<TOption extends {
+    label: string;
+    value: any;
+}, TQuery> = [SelectCompatibleProps<TOption>, AsyncSelectState<TOption, TQuery>];
+/**
+ * Wraps TanStack Query to power a search-driven async Select component.
+ *
+ * Returns a `[selectProps, state]` tuple. Spread the first element onto a
+ * `Select` component; use the second to drive the search query and inspect
+ * loading / error state.
+ *
+ * The query is gated by `isSearchValid` (defaults to non-empty/non-null).
+ * Pass `isSearchValid: () => true` to fetch on mount with an empty query.
+ * Requires a TanStack Query `QueryClientProvider` in the tree.
+ */
+export declare function useAsyncSelect<TOption extends {
+    label: string;
+    value: any;
+}, TQuery = string>(opts: UseAsyncSelectOptions<TOption, TQuery>): UseAsyncSelectReturn<TOption, TQuery>;
+export {};
+//# sourceMappingURL=useAsyncSelect.d.ts.map

package/dist/lib/hooks/useAsyncSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncSelect.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useAsyncSelect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAA;AAC3D,OAAO,EAAY,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3F,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAE5C,6DAA6D;AAC7D,MAAM,MAAM,qBAAqB,CAAC,OAAO,IAAI;IAC3C,IAAI,EAAE,GAAG,CAAA;IACT,OAAO,EAAE,OAAO,EAAE,CAAA;CACnB,CAAA;AAED,oCAAoC;AACpC,MAAM,MAAM,qBAAqB,CAC/B,OAAO,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,EAC7C,MAAM,GAAG,MAAM,IACb;IACF,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IAC7B,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAA;IAChE;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IAC1C,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,KAAK,CAAC,SAAS,CAAA;IAC9D,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,KAAK,KAAK,CAAC,SAAS,CAAA;IACjE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,KAAK,CAAC,SAAS,CAAA;IAChD,YAAY,CAAC,EAAE,IAAI,CACjB,eAAe,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,EACtD,UAAU,GAAG,SAAS,GAAG,SAAS,CACnC,CAAA;CACF,CAAA;AAED,KAAK,qBAAqB,CAAC,OAAO,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,IAAI;IAC1E,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,WAAW,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,IAAI,CAAA;KAAE,KAAK,KAAK,CAAC,SAAS,CAAA;CACzD,CAAA;AAED,KAAK,gBAAgB,CAAC,OAAO,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,EAAE,MAAM,IAAI;IAC7E,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,GAAG,CAAA;IACT,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,EAAE,cAAc,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAA;CACnE,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,CAC9B,OAAO,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,EAC7C,MAAM,IACJ,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;AAEvE;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,OAAO,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,EAC7C,MAAM,GAAG,MAAM,EAEf,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,GAC3C,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAsDvC"}

package/dist/lib/hooks/useBreakpointMatch.d.ts

@@ -1,2 +1,14 @@
 import { Breakpoint } from '@codeleap/styles';
+/**
+ * Returns the value mapped to the currently active breakpoint.
+ *
+ * Reads breakpoint definitions from the active `themeStore` theme and attaches
+ * `matchMedia` listeners to track viewport changes reactively. The lookup walks
+ * up from the current breakpoint until it finds a key present in `values`, so
+ * you can omit smaller breakpoints and let them fall back to the next larger one.
+ *
+ * Must be rendered in a browser context; SSR always resolves to the fallback
+ * value (the largest defined key in `values`).
+ */
 export declare function useBreakpointMatch<T = string>(values: Partial<Record<Breakpoint, T>>): T;
+//# sourceMappingURL=useBreakpointMatch.d.ts.map

package/dist/lib/hooks/useBreakpointMatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBreakpointMatch.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useBreakpointMatch.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAkF1E;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CA2CxF"}

package/dist/lib/hooks/useClick.d.ts

@@ -1,5 +1,12 @@
 import React from 'react';
 type HandlerClickOutside = (clickedOutside: boolean) => void;
 type UseClickOutsideElementReturn = React.MutableRefObject<any>;
+/**
+ * Attaches a global `click` listener and calls `handler` with `true` when the
+ * user clicks outside the returned ref's element, or `false` when they click
+ * inside it. Pass additional `elements` refs to treat those nodes as "inside"
+ * as well — the handler fires `false` if any of them contains the click target.
+ */
 export declare function useClickOutsideElement(handler: HandlerClickOutside, elements?: Array<React.MutableRefObject<any>>): UseClickOutsideElementReturn;
 export {};
+//# sourceMappingURL=useClick.d.ts.map

package/dist/lib/hooks/useClick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClick.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useClick.ts"],"names":[],"mappings":"AACA,OAAO,KAAyC,MAAM,OAAO,CAAA;AAE7D,KAAK,mBAAmB,GAAG,CAAC,cAAc,EAAE,OAAO,KAAK,IAAI,CAAA;AAE5D,KAAK,4BAA4B,GAAG,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAA;AAE/D;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,GAAE,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAQ,GAClD,4BAA4B,CAiC9B"}

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

@@ -1 +1,10 @@
-export declare function useClickOutside<T extends HTMLElement = any>(handler: () => void, events?: string[] | null, nodes?: HTMLElement[]): import("react").RefObject<T>;
+/**
+ * Calls `handler` when a pointer event fires outside the returned ref's element.
+ *
+ * Listens for `mousedown` and `touchstart` by default; pass `events` to
+ * override. Supply `nodes` to bypass the ref entirely and check a fixed set of
+ * elements instead — useful when the trigger lives outside the component tree.
+ * Elements with `data-ignore-outside-clicks` are always ignored.
+ */
+export declare function useClickOutside<T extends HTMLElement = any>(handler: () => void, events?: string[] | null, nodes?: HTMLElement[]): import("react").RefObject<T | null>;
+//# sourceMappingURL=useClickOutside.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useClickOutside.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useClickOutside.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,GAAG,EACzD,OAAO,EAAE,MAAM,IAAI,EACnB,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EACxB,KAAK,CAAC,EAAE,WAAW,EAAE,uCAuBtB"}

package/dist/lib/hooks/useFileInput.d.ts

@@ -1,5 +1,11 @@
 import { FileInputRef } from '../../components/FileInput/types';
+/**
+ * Provides an imperative ref and `openFilePicker` helper for a `FileInput`
+ * component. Attach the returned `ref` to `<FileInput ref={ref} />` and call
+ * `openFilePicker()` from a button or any other trigger.
+ */
 export declare const useFileInput: () => {
-    openFilePicker: () => Promise<import("@codeleap/types").WebInputFile[]>;
-    ref: import("react").RefObject<FileInputRef>;
+    openFilePicker: () => Promise<import("@codeleap/types").WebInputFile[]> | undefined;
+    ref: import("react").RefObject<FileInputRef | null>;
 };
+//# sourceMappingURL=useFileInput.d.ts.map

package/dist/lib/hooks/useFileInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileInput.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useFileInput.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAE/D;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;CAWxB,CAAA"}

package/dist/lib/hooks/useIsomorphicEffect.d.ts

@@ -1,2 +1,7 @@
 import { useEffect } from 'react';
+/**
+ * `useLayoutEffect` in the browser; `useEffect` on the server.
+ * Avoids the React SSR warning about `useLayoutEffect` in non-browser environments.
+ */
 export declare const useIsomorphicEffect: typeof useEffect;
+//# sourceMappingURL=useIsomorphicEffect.d.ts.map

package/dist/lib/hooks/useIsomorphicEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsomorphicEffect.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useIsomorphicEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAmB,MAAM,OAAO,CAAA;AAElD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,kBAAgE,CAAA"}

package/dist/lib/hooks/useKeydown.d.ts

@@ -1,3 +1,4 @@
+/** Convenience key descriptors available as `useKeydown.keys`. */
 export declare const keydownDefaultKeyOptions: {
     ArrowLeft: string;
     ArrowRight: string;
@@ -9,6 +10,13 @@ export declare const keydownDefaultKeyOptions: {
         code: string;
     };
 };
+/**
+ * Adds a `keydown` listener on `document` for a single key.
+ *
+ * `expectedKey` can be a shorthand from `useKeydown.keys` (e.g. `'Enter'`) or
+ * an explicit `{ key, code }` object. The listener is re-registered whenever
+ * `deps` change.
+ */
 export declare function useKeydown(expectedKey: keyof typeof useKeydown.keys | {
     key: string;
     code: string;
@@ -37,3 +45,4 @@ export declare namespace useKeydown {
         };
     };
 }
+//# sourceMappingURL=useKeydown.d.ts.map

package/dist/lib/hooks/useKeydown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeydown.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useKeydown.ts"],"names":[],"mappings":"AAGA,kEAAkE;AAClE,eAAO,MAAM,wBAAwB;;;;;;;;;;CAUpC,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,OAAO,UAAU,CAAC,IAAI,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACzE,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,EACvC,IAAI,GAAE,KAAK,CAAC,GAAG,CAAM,EACrB,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,QAmB5C;yBAvBe,UAAU"}

package/dist/lib/hooks/useListFocus.d.ts

@@ -0,0 +1,19 @@
+import { type RefObject } from 'react';
+/** Determines which option receives focus when `ListFocusHandle.focus` is called. */
+export type ListFocusStrategy = 'first' | 'last' | 'selected';
+export interface ListFocusHandle {
+    focus(strategy?: ListFocusStrategy): void;
+}
+/**
+ * Creates a stable imperative focus handle for a ListBox DOM ref and returns it.
+ *
+ * The handle queries [role="option"] elements directly. When the chosen item
+ * receives DOM focus, react-aria's own useSelectableItem onFocus handler calls
+ * manager.setFocusedKey(key), so internal keyboard-navigation state stays in
+ * sync without needing access to ListStateContext.
+ *
+ * Pass the same listBoxRef to <ListBox ref={...}>.
+ * Pass externalRef to also expose the handle to a consumer-provided ref.
+ */
+export declare function useListFocus(listBoxRef: RefObject<HTMLElement | null>, externalRef?: RefObject<ListFocusHandle | null>): ListFocusHandle;
+//# sourceMappingURL=useListFocus.d.ts.map

package/dist/lib/hooks/useListFocus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListFocus.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useListFocus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAE1D,qFAAqF;AACrF,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAA;AAE7D,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAC1C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACzC,WAAW,CAAC,EAAE,SAAS,CAAC,eAAe,GAAG,IAAI,CAAC,GAC9C,eAAe,CAmCjB"}

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

@@ -1 +1,9 @@
+/**
+ * Subscribes to a CSS media query string and returns whether it currently matches.
+ *
+ * Falls back to a static check via `isMediaQuery` on SSR or when `matchMedia` is
+ * unavailable. The query string may include the `@media screen and ` prefix —
+ * it is stripped internally before passing to `window.matchMedia`.
+ */
 export declare function useMediaQuery(query: string): boolean;
+//# sourceMappingURL=useMediaQuery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useMediaQuery.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useMediaQuery.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,WAkB1C"}

package/dist/lib/hooks/usePageExitBlocker.d.ts

@@ -1 +1,12 @@
+/**
+ * Blocks the user from leaving the current page without confirmation.
+ *
+ * Intercepts both browser tab-close / reload (`beforeunload`) and in-app
+ * navigation via `@reach/router`'s `globalHistory`. When a PUSH or POP
+ * navigation is detected, a `window.confirm` dialog is shown; `handler` is
+ * called with `true` if the user confirmed, `false` if they cancelled.
+ *
+ * Requires `@reach/router` to be present in the application.
+ */
 export declare const usePageExitBlocker: (handler: (willLeavePage: boolean) => void, deps?: Array<any>, message?: string) => void;
+//# sourceMappingURL=usePageExitBlocker.d.ts.map

package/dist/lib/hooks/usePageExitBlocker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageExitBlocker.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/usePageExitBlocker.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,CAAC,aAAa,EAAE,OAAO,KAAK,IAAI,EACzC,OAAM,KAAK,CAAC,GAAG,CAAM,EACrB,gBAA2C,SAqC5C,CAAA"}

package/dist/lib/hooks/usePagination.d.ts

@@ -1,3 +1,4 @@
+/** Parameters accepted by `usePagination`. */
 export type PaginationParams = {
     initialPage?: number;
     page?: number;
@@ -11,13 +12,27 @@ export type PaginationParams = {
     isMobile?: boolean;
     abbreviationSymbol?: any;
 };
+/**
+ * Manages pagination state and computes the visible page range for a
+ * `PaginationButtons` component.
+ *
+ * Supports controlled (`page` + `onChangePage`) and uncontrolled modes. When
+ * `shouldAbbreviate` is true (default) and `total` exceeds
+ * `abbreviationMinimumAmount`, the range collapses middle pages into
+ * `abbreviationSymbol` entries. Mobile mode reduces the boundary count and
+ * forces abbreviation.
+ *
+ * Arrow buttons at positions `0` and `total + 1` are reserved for the
+ * previous/next controls and are not selectable as page numbers.
+ */
 export declare function usePagination(props: PaginationParams): {
     range: (string | number)[];
     page: number;
-    setPage: (pageNumber: number) => number;
+    setPage: (pageNumber: number) => number | null | undefined;
     status: string;
-    next: () => number;
-    previous: () => number;
-    first: () => number;
-    last: () => number;
+    next: () => number | null | undefined;
+    previous: () => number | null | undefined;
+    first: () => number | null | undefined;
+    last: () => number | null | undefined;
 };
+//# sourceMappingURL=usePagination.d.ts.map

package/dist/lib/hooks/usePagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePagination.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/usePagination.ts"],"names":[],"mappings":"AAGA,8CAA8C;AAC9C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,kBAAkB,CAAC,EAAE,GAAG,CAAA;CACzB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,gBAAgB;;;0BAiCtB,MAAM;;;;;;EAyEpC"}