@codeleap/web 6.2.3 → 6.8.0

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

@@ -1,2 +1,14 @@
 import { AnyFunction } from '@codeleap/types';
+/**
+ * Conditionally attaches a `popstate` listener while `dependence` is `true`.
+ *
+ * When `dependence` becomes `true`, pushes the current URL onto the history
+ * stack so the browser back button triggers `popstate` rather than navigating
+ * away. When `dependence` becomes `false` (or the component unmounts), the
+ * listener is removed.
+ *
+ * Useful for keeping overlays (modals, drawers) dismissable via the browser
+ * back button.
+ */
 export declare const usePopState: (dependence: boolean, handler: AnyFunction) => void;
+//# sourceMappingURL=usePopState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePopState.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/usePopState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAI7C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,YAAY,OAAO,EAAE,SAAS,WAAW,SAiBpE,CAAA"}

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

@@ -0,0 +1,20 @@
+import { type RefObject } from 'react';
+/**
+ * Restores outside-click dismissal for a Popover rendered with isNonModal=true.
+ *
+ * react-aria's usePopover sets isDismissable=!isNonModal, which disables its own
+ * useInteractOutside listener. This hook adds an equivalent pointerdown capture
+ * listener directly on the document.
+ *
+ * The trigger element is excluded so its own press handler can handle the toggle.
+ * The blur-based close (shouldCloseOnBlur=true in useOverlay) still handles the
+ * case where focus is inside the popover and moves elsewhere, so this hook only
+ * needs to cover the unfocused-popover scenario.
+ */
+export declare function usePopoverDismiss({ popoverRef, triggerRef, isOpen, onClose, }: {
+    popoverRef: RefObject<Element | null>;
+    triggerRef: RefObject<Element | null>;
+    isOpen: boolean;
+    onClose: () => void;
+}): void;
+//# sourceMappingURL=usePopoverDismiss.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePopoverDismiss.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/usePopoverDismiss.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAEzD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,UAAU,EACV,UAAU,EACV,MAAM,EACN,OAAO,GACR,EAAE;IACD,UAAU,EAAE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IACrC,UAAU,EAAE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IACrC,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,QAiBA"}

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

@@ -5,9 +5,19 @@ type UseRefreshOptions = {
     debounce: number;
     enabled: boolean;
 };
-export declare const useRefresh: (onRefresh: () => any, options: UseRefreshOptions) => {
+/**
+ * Implements a pull-to-refresh pattern for web scroll containers.
+ *
+ * Monitors the window `scroll` event and fires `onRefresh` when the container
+ * has been scrolled above `threshold` (percentage) twice in quick succession.
+ * After `onRefresh` resolves, the refresh state is reset after 2.5 s. Set
+ * `enabled: false` to disable the listener entirely (e.g. while a request is
+ * already in flight). Attach `scrollableRef` to the scrollable container element.
+ */
+export declare const useRefresh: (onRefresh: () => null, options: UseRefreshOptions) => {
     refresh: boolean;
-    scrollableRef: React.RefObject<any>;
+    scrollableRef: React.RefObject<null>;
     refresher: (_onRefresh: AnyFunction) => Promise<void>;
 };
 export {};
+//# sourceMappingURL=useRefresh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRefresh.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useRefresh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAG7C,KAAK,iBAAiB,GAAG;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAeH;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GAAI,qBAAsB,EAAE,SAAS,iBAAiB;;;4BAYpB,WAAW;CAmDnE,CAAA"}

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

@@ -1 +1,7 @@
-export declare function useScrollEffect(effect: (passed: boolean, current: number) => any, breakpoint: number, extraDependencies?: any[]): void;
+/**
+ * Calls `effect` on every window scroll event, passing whether `window.scrollY`
+ * has passed `breakpoint` and the current scroll position. The listener is
+ * re-registered when `breakpoint` or any `extraDependencies` change.
+ */
+export declare function useScrollEffect(effect: (passed: boolean, current: number) => any, breakpoint: number, extraDependencies?: never[]): void;
+//# sourceMappingURL=useScrollEffect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollEffect.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useScrollEffect.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,GAAG,EACjD,UAAU,EAAE,MAAM,EAClB,iBAAiB,UAAK,QAavB"}

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

@@ -1,7 +1,21 @@
+/**
+ * Tuple returned by `useSearchParams`:
+ * `[params, setParams, reset, rawURLSearchParams]`.
+ */
 export type UseSearchParamsReturn<T> = [
     T,
     React.Dispatch<React.SetStateAction<T>>,
     () => void,
     URLSearchParams
 ];
+/**
+ * Syncs a typed record of string params with the URL query string via
+ * `window.history.replaceState`. On mount, reads the current URL params and
+ * merges them with `initial` defaults (initial values are only applied when the
+ * URL param is absent or empty). Call `reset()` to restore `initial`.
+ *
+ * Not a router integration — changes do not trigger a navigation event, and the
+ * hook does not react to external URL changes after mount.
+ */
 export declare function useSearchParams<T extends Record<string, string> = Record<string, string>>(initial?: T): UseSearchParamsReturn<T>;
+//# sourceMappingURL=useSearchParams.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSearchParams.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useSearchParams.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;IACrC,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,IAAI;IACV,eAAe;CAChB,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzD,OAAO,CAAC,EAAE,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAyCvC"}

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

@@ -1,2 +1,9 @@
 import { SelectProperties } from '../../types';
+/**
+ * Captures a frozen snapshot of the selected `keys` from `obj` on the first
+ * render and never updates it. Used by `useAnimatedVariantStyles` to keep the
+ * non-animated style values stable across re-renders so Framer Motion does not
+ * re-create animation targets unnecessarily.
+ */
 export declare function useStaticAnimationStyles<T extends Record<string | number | symbol, any>, K extends keyof T>(obj: T, keys: K[]): SelectProperties<T, K>;
+//# sourceMappingURL=useStaticAnimationStyles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStaticAnimationStyles.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useStaticAnimationStyles.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9C;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GASnG,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAChD"}

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

@@ -1,2 +1,12 @@
-import { StyleProp } from '@codeleap/styles';
-export declare const useStylesFor: <T = unknown>(componentName: string, style: StyleProp<T, string>) => T;
+import { ComponentContext, ICSS, StyleProp } from '@codeleap/styles';
+/**
+ * Resolves a component's style parts from `WebStyleRegistry` and re-evaluates
+ * whenever the `style` prop or `context` changes.
+ *
+ * Must be called inside a component that has a `WebStyleRegistry` instance
+ * available (created once per app via `new WebStyleRegistry()`). Pass the
+ * component's registered name as `componentName` — it must match the name used
+ * in `WebStyleRegistry.registerComponent`.
+ */
+export declare const useStylesFor: <C extends string>(componentName: string, style: StyleProp<C, string>, context?: ComponentContext) => Record<C, ICSS>;
+//# sourceMappingURL=useStylesFor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStylesFor.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useStylesFor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAoB,MAAM,kBAAkB,CAAA;AAKtF;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,EAAE,eAAe,MAAM,EAAE,OAAO,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,UAAU,gBAAgB,KAAG,MAAM,CAAC,CAAC,EAAE,IAAI,CA8B7I,CAAA"}

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

@@ -0,0 +1,19 @@
+/**
+ * Tracks hover and pressed interaction states for a `Touchable`-like element
+ * using pointer events. Uses `setPointerCapture` / `releasePointerCapture` so
+ * that `isPressed` stays accurate even when the pointer leaves the element
+ * while held down. Both states are forced to `false` when `disabled` is `true`.
+ */
+export declare function useTouchableInteraction(disabled?: boolean): {
+    eventHandlers: {
+        onPointerEnter: () => void;
+        onPointerLeave: () => void;
+        onPointerDown: (e: any) => void;
+        onPointerUp: (e: any) => void;
+        onPointerCancel: () => void;
+    };
+    isHovering: boolean;
+    isPressed: boolean;
+};
+export type TouchableInteractionHandler = ReturnType<typeof useTouchableInteraction>;
+//# sourceMappingURL=useTouchableEvents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useTouchableEvents.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useTouchableEvents.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,UAAQ;;;;;;;;;;EA8BvD;AAED,MAAM,MAAM,2BAA2B,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA"}

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

@@ -3,5 +3,11 @@ type UseWindowFocusOptions = {
     onFocus?: AnyFunction;
     onBlur?: AnyFunction;
 };
+/**
+ * Returns `true` when the browser window has focus, `false` when it is blurred.
+ * Calls `options.onFocus` and `options.onBlur` side-effect callbacks as needed.
+ * The listeners are re-registered when `deps` change.
+ */
 export declare const useWindowFocus: (options?: UseWindowFocusOptions, deps?: Array<any>) => boolean;
 export {};
+//# sourceMappingURL=useWindowFocus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useWindowFocus.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useWindowFocus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,iBAAiB,CAAA;AAGzD,KAAK,qBAAqB,GAAG;IAC3B,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,UAAS,qBAA0B,EAAE,OAAM,KAAK,CAAC,GAAG,CAAM,KAAG,OAwB3F,CAAA"}

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

@@ -1 +1,8 @@
-export declare function useWindowSize(): any[];
+/**
+ * Returns `[innerWidth, innerHeight]` and keeps the value in sync with window
+ * resize events. When `live` is `false` (default), resize updates are debounced
+ * by 300 ms to avoid flooding renders. Pass `live: true` for immediate updates.
+ * SSR returns `[1920, 1080]` as a placeholder.
+ */
+export declare function useWindowSize(live?: boolean): number[];
+//# sourceMappingURL=useWindowSize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useWindowSize.d.ts","sourceRoot":"","sources":["../../../src/lib/hooks/useWindowSize.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,UAAM,YAyBvC"}

package/dist/lib/index.d.ts

@@ -3,3 +3,5 @@ export * from './tools';
 export * from './utils';
 export * from './ListMasonry';
 export * from './WebStyleRegistry';
+export * from './ThemeVariables';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA"}

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

@@ -1,3 +1,4 @@
 export * from './localStorage';
 export * from './mediaQuery';
 export * from './modal';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA"}

package/dist/lib/tools/localStorage.d.ts

@@ -1,3 +1,4 @@
+/** Callback signature for `LocalStorage.listen`. Receives the key, the raw `StorageEvent`, and the parsed new value. */
 export type LocalStorageHandler<T> = (key: T, event: StorageEvent, value: any) => void;
 export type Key<T> = keyof T;
 type UseLocalStorageOptions = {
@@ -6,6 +7,17 @@ type UseLocalStorageOptions = {
     getItemValueOnMount?: boolean;
     parseValueOnGet?: boolean;
 };
+/**
+ * Type-safe wrapper around `window.localStorage`.
+ *
+ * Instantiate with a key map (`{ tokenKey: 'auth_token', ... }`) so all reads
+ * and writes are validated against the map's keys at compile time. Values are
+ * automatically JSON-serialised on write and JSON-parsed on read; strings are
+ * stored as-is. Returns safe no-ops when called server-side.
+ *
+ * Use `use()` to get a React state pair that stays in sync with storage across
+ * tabs via the `storage` event.
+ */
 export declare class LocalStorage<T extends Record<string, string>> {
     storageKeys: T;
     private storageListeners;
@@ -26,3 +38,4 @@ export declare class LocalStorage<T extends Record<string, string>> {
     listen(key: Key<T>, handler: LocalStorageHandler<Key<T>>): () => void;
 }
 export {};
+//# sourceMappingURL=localStorage.d.ts.map

package/dist/lib/tools/localStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localStorage.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/localStorage.ts"],"names":[],"mappings":"AAGA,wHAAwH;AACxH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAA;AACtF,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAA;AAE5B,KAAK,sBAAsB,GAAG;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED;;;;;;;;;;GAUG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACjD,WAAW,EAAE,CAAC,CAAA;IAErB,OAAO,CAAC,gBAAgB,CAAwC;gBAEpD,IAAI,EAAE,CAAC;IAIZ,eAAe,IAAI,OAAO;IAa1B,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM;IAIzC,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,cAAc;IAUf,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,MAAM;IAS5C,OAAO,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,UAAU,UAAO,GAAG,CAAC,GAAG,IAAI;IAa7D,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI;IAM7B,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,MAAM;IAQxC,KAAK,IAAI,IAAI;IAKb,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI;IAMnD,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI;IAMjC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAc7C,GAAG,CAAC,CAAC,GAAG,GAAG,EAChB,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EACX,YAAY,GAAE,GAAU,EACxB,OAAO,GAAE,sBAA2B,GACnC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC;IAmDlC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAiBhE"}

package/dist/lib/tools/mediaQuery.d.ts

@@ -3,10 +3,17 @@ type MediaQueryCallback = (event: {
     media: string;
 }) => void;
 /**
- * Older versions of Safari (shipped withCatalina and before) do not support addEventListener on matchMedia
- * https://stackoverflow.com/questions/56466261/matchmedia-addlistener-marked-as-deprecated-addeventlistener-equivalent
- * */
+ * Attaches a `change` listener to a `MediaQueryList` with a fallback to the
+ * deprecated `addListener` API for Safari ≤ Catalina. Returns a cleanup
+ * function that removes the listener.
+ */
 export declare function attachMediaListener(query: MediaQueryList, callback: MediaQueryCallback): () => void;
+/** Strips the `@media screen and ` prefix so the string can be passed to `window.matchMedia`. */
 export declare function getMediaQuery(query: string): string;
+/**
+ * Evaluates a media query string synchronously via `window.matchMedia`. Returns
+ * `initialValue` on the server or in environments without `matchMedia`.
+ */
 export declare function isMediaQuery(query: string, initialValue?: boolean): boolean;
 export {};
+//# sourceMappingURL=mediaQuery.d.ts.map

package/dist/lib/tools/mediaQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaQuery.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/mediaQuery.ts"],"names":[],"mappings":"AAAA,KAAK,kBAAkB,GAAG,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAA;AAE9E;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,kBAAkB,cAQtF;AAED,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,UAG1C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,UAAQ,WAQ/D"}

package/dist/lib/tools/modal.d.ts

@@ -2,5 +2,17 @@ export declare const modalsState: import("@codeleap/store").GlobalState<{
     currentModal: string | null;
     indexes: Record<string, number>;
 }>;
+/**
+ * Updates the stacking-order index for a modal in `modalsState`.
+ * When a modal becomes invisible its index is reset to `99`; when it becomes
+ * visible its index is set above the current highest-indexed modal.
+ */
 export declare function modalInferIndexes(visible: boolean, id: string): void;
+/**
+ * Locks or unlocks `document.documentElement` body scroll when a modal opens
+ * or closes. Tracks which modal holds the scroll lock in `modalsState` so
+ * multiple modals do not release each other's lock prematurely. A no-op when a
+ * different modal already owns the lock.
+ */
 export declare function modalScrollLock(to: boolean, modalIdentifier: string): void;
+//# sourceMappingURL=modal.d.ts.map

package/dist/lib/tools/modal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/modal.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW;kBAA+B,MAAM,GAAG,IAAI;aAAW,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;EAAwC,CAAA;AAE7I;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,QAkB7D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,QAyBnE"}

package/dist/lib/utils/attributes.d.ts

@@ -0,0 +1,15 @@
+type Attrs = Record<string, string | number | boolean>;
+type CamelToKebabCase<T extends string, First extends boolean = true> = T extends `${infer Head}${infer Tail}` ? Head extends Lowercase<Head> ? `${Head}${CamelToKebabCase<Tail, false>}` : `${First extends true ? "" : "-"}${Lowercase<Head>}${CamelToKebabCase<Tail, false>}` : "";
+/** Maps a record of attributes to their `data-kebab-cased` HTML counterparts. */
+export type DataAttrs<T extends Attrs> = {
+    [key in keyof T as `data-${CamelToKebabCase<key & string>}`]: T[key];
+};
+/**
+ * Converts a record (or array of records) of camelCase attributes into
+ * `data-kebab-case` HTML attribute pairs. `null` / `undefined` values are
+ * omitted. Multiple records are merged left-to-right; keys are sorted for
+ * stable output.
+ */
+export declare function toDataAttrs<T extends Attrs>(value: T | Array<T>): DataAttrs<T>;
+export {};
+//# sourceMappingURL=attributes.d.ts.map

package/dist/lib/utils/attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/attributes.ts"],"names":[],"mappings":"AAEA,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAC,MAAM,GAAC,OAAO,CAAC,CAAA;AAElD,KAAK,gBAAgB,CAEnB,CAAC,SAAS,MAAM,EAEhB,KAAK,SAAS,OAAO,GAAG,IAAI,IAE1B,CAAC,SAAS,GAAG,MAAM,IAAI,GAAG,MAAM,IAAI,EAAE,GAEtC,IAAI,SAAS,SAAS,CAAC,IAAI,CAAC,GAE1B,GAAG,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAEzC,GAAG,KAAK,SAAS,IAAI,GAAG,EAAE,GAAG,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAEtF,EAAE,CAAC;AAEP,iFAAiF;AACjF,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,KAAK,IAAI;KACtC,GAAG,IAAI,MAAM,CAAC,IAAI,QAAQ,gBAAgB,CAAC,GAAG,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC;CACrE,CAAA;AAQD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAcI,SAAS,CAAC,CAAC,CAAC,CAC/E"}

package/dist/lib/utils/cache.d.ts

@@ -1,2 +1,5 @@
-export declare const createCodeleapWebCache: () => import("@emotion/cache").EmotionCache;
-export declare const codeleapWebCache: import("@emotion/cache").EmotionCache;
+/** Creates a new Emotion cache scoped to the `codeleap-web` key. */
+export declare const createCodeleapWebCache: () => import("@emotion/utils").EmotionCache;
+/** Shared Emotion cache instance for the web package. Pass to `CacheProvider` for SSR style extraction. */
+export declare const codeleapWebCache: import("@emotion/utils").EmotionCache;
+//# sourceMappingURL=cache.d.ts.map

package/dist/lib/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/cache.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,6CAIlC,CAAA;AAED,2GAA2G;AAC3G,eAAO,MAAM,gBAAgB,uCAA2B,CAAA"}

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

@@ -2,3 +2,5 @@ export * from './pollyfils/scroll';
 export * from './stopPropagation';
 export * from './test';
 export * from './cache';
+export * from './attributes';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA"}

package/dist/lib/utils/pollyfils/scroll.d.ts

@@ -1 +1,8 @@
+/**
+ * Smooth-scrolls the page to the element matching `elemSelector`. Uses the
+ * native `scroll-behavior: smooth` CSS property when supported; falls back to a
+ * JS easing animation (easeInOutQuad, 600 ms) for IE / Edge / older Safari.
+ * `padOffsets[0]` adds a top offset to the final scroll position.
+ */
 export declare const scrollToElem: (elemSelector: any, padOffsets?: number[]) => void;
+//# sourceMappingURL=scroll.d.ts.map

package/dist/lib/utils/pollyfils/scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/pollyfils/scroll.ts"],"names":[],"mappings":"AAgDA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,iBAAY,EAAE,qBAAmB,SAgB7D,CAAA"}

package/dist/lib/utils/stopPropagation.d.ts

@@ -1 +1,7 @@
+/**
+ * Calls `stopPropagation`, `preventDefault`, and `stopImmediatePropagation` on
+ * an event, swallowing any individual failures. Handles both native DOM events
+ * and React synthetic events via `nativeEvent`.
+ */
 export declare function stopPropagation(event: any): void;
+//# sourceMappingURL=stopPropagation.d.ts.map

package/dist/lib/utils/stopPropagation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stopPropagation.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/stopPropagation.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,QAYzC"}

package/dist/lib/utils/test.d.ts

@@ -1 +1,7 @@
+/**
+ * Derives a normalised test identifier from component props. Checks
+ * `testId`, `data-testid`, `id`, and `debugName` in that order; spaces are
+ * replaced with underscores and the result is lowercased.
+ */
 export declare const getTestId: (props: Record<string, any>) => any;
+//# sourceMappingURL=test.d.ts.map

package/dist/lib/utils/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/test.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QAQnD,CAAA"}

package/dist/types/index.d.ts

@@ -1 +1,2 @@
 export * from './utility';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}

package/dist/types/utility.d.ts

@@ -1,9 +1,18 @@
 import { ICSS } from '@codeleap/styles';
 import React, { JSX } from 'react';
+/** A partial record mapping component part names to `ICSS` style objects. Used as the `style` prop type for components with named parts. */
 export type StylesOf<C extends string> = Partial<Record<C, ICSS>>;
 type WithChildren<T> = T & {
     children?: React.ReactNode;
 };
+/**
+ * Explicit map of HTML element names to their prop types.
+ *
+ * Using `ComponentPropsWithoutRef<T>` collapses to `any` when the type is
+ * imported across package boundaries, and an open-ended element map causes a
+ * TypeScript heap-out-of-memory error at build time. This fixed list avoids
+ * both issues while covering the elements used in the component library.
+ */
 export type ElementMap = {
     'select': WithChildren<JSX.IntrinsicElements['select']>;
     'input': WithChildren<JSX.IntrinsicElements['input']>;
@@ -25,15 +34,25 @@ export type ElementMap = {
     'ol': WithChildren<JSX.IntrinsicElements['ol']>;
     'aside': WithChildren<JSX.IntrinsicElements['aside']>;
 };
+/** Union of the HTML element tag names explicitly tracked in `ElementMap`. */
 export type NativeHTMLElement = keyof ElementMap;
+/** Props for a specific HTML element tag, sourced from `ElementMap`. */
 export type HTMLProps<T extends NativeHTMLElement> = ElementMap[T];
+/** A React function component that accepts `defaultProps`. */
 export type ComponentWithDefaultProps<P> = ((props: P) => React.ReactElement) & {
     defaultProps?: Partial<P>;
 };
+/** Minimum common props accepted by all library components. `debugName` is used by `getTestId` to derive a test identifier. */
 export type ComponentCommonProps = {
     debugName?: string;
 };
+/**
+ * Picks a subset of keys `K` from `T`, returning a record where every picked
+ * key maps to the value type of `T[K]`. Used by animation utilities to
+ * extract the animatable style properties from a variant style object.
+ */
 export type SelectProperties<T extends Record<string | number | symbol, any>, K extends keyof T> = {
     [P in K]: T[K];
 };
 export {};
+//# sourceMappingURL=utility.d.ts.map

package/dist/types/utility.d.ts.map

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

package/package.json

@@ -1,7 +1,20 @@
 {
   "name": "@codeleap/web",
-  "version": "6.2.3",
+  "version": "6.8.0",
   "main": "src/index.ts",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
   "repository": {
     "url": "https://github.com/codeleap-uk/internal-libs-monorepo.git",
     "type": "git",
@@ -9,22 +22,23 @@
   },
   "license": "UNLICENSED",
   "devDependencies": {
-    "@codeleap/config": "6.2.3",
-    "@codeleap/hooks": "6.2.3",
-    "@codeleap/i18n": "6.2.3",
-    "@codeleap/logger": "6.2.3",
-    "@codeleap/query": "6.2.3",
-    "@codeleap/types": "6.2.3",
-    "@codeleap/utils": "6.2.3",
-    "@codeleap/store": "6.2.3"
+    "@codeleap/config": "6.8.0",
+    "@codeleap/form": "6.8.0",
+    "@codeleap/hooks": "6.8.0",
+    "@codeleap/logger": "6.8.0",
+    "@codeleap/query": "6.8.0",
+    "@codeleap/styles": "6.8.0",
+    "@codeleap/types": "6.8.0",
+    "@codeleap/utils": "6.8.0",
+    "@codeleap/store": "6.8.0",
+    "@tanstack/react-query": "5.100.9"
   },
   "scripts": {
-    "build": "tsc --build",
+    "build": "tsc --build tsconfig.build.json",
     "lint": "eslint -c  .eslintrc.js --fix \"./src/**/*.{ts,tsx,js,jsx}\""
   },
   "dependencies": {
     "@fastify/deepmerge": "3.1.0",
-    "@radix-ui/react-progress": "1.1.7",
     "@radix-ui/react-slider": "1.3.6",
     "@radix-ui/react-tooltip": "1.2.8",
     "@tiptap/pm": "^3.7.0",
@@ -35,10 +49,9 @@
     "imask": "^7.6.1",
     "masonic": "4.1.0",
     "motion": "12.23.24",
-    "react-circular-progressbar": "2.2.0",
     "react-colorful": "5.6.1",
     "react-datepicker": "8.7.0",
-    "react-dropzone": "^14.2.3",
+    "react-dropzone": "15.0.0",
     "react-image-crop": "^10.1.8",
     "react-imask": "^7.6.1",
     "react-number-format": "^5.4.2",
@@ -47,19 +60,20 @@
     "uuid": "13.0.0"
   },
   "peerDependencies": {
-    "@codeleap/types": "6.2.3",
-    "@codeleap/utils": "6.2.3",
-    "@codeleap/hooks": "6.2.3",
-    "@codeleap/i18n": "6.2.3",
-    "@codeleap/query": "6.2.3",
-    "@codeleap/logger": "6.2.3",
-    "@codeleap/styles": "6.2.3",
-    "@codeleap/store": "6.2.3",
+    "@codeleap/types": "6.8.0",
+    "@codeleap/utils": "6.8.0",
+    "@codeleap/hooks": "6.8.0",
+    "@codeleap/query": "6.8.0",
+    "@codeleap/logger": "6.8.0",
+    "@codeleap/styles": "6.8.0",
+    "@codeleap/store": "6.8.0",
     "@emotion/react": "11.14.0",
     "@reach/router": "^1.3.4",
     "dayjs": "1.11.18",
     "react": "19.1.0",
     "react-dom": "19.1.0",
-    "typescript": "5.5.2"
+    "typescript": "6.0.3",
+    "react-aria-components": "*",
+    "@react-stately/data": "*"
   }
-}
+}

package/src/components/ActivityIndicator/index.tsx

@@ -9,6 +9,11 @@ import { AnyRecord, IJSX, StyledComponentProps, StyledComponentWithProps } from
 export * from './styles'
 export * from './types'
 
+/**
+ * Loading spinner whose visual appearance is delegated entirely to style
+ * composition; ships no built-in spinner markup.
+ * Uses: `useStylesFor`, `WebStyleRegistry`
+ */
 export const ActivityIndicator = (props: ActivityIndicatorProps) => {
   const {
     style,
@@ -21,18 +26,11 @@ export const ActivityIndicator = (props: ActivityIndicatorProps) => {
   }
 
   const styles = useStylesFor(ActivityIndicator.styleRegistryName, style)
-
-  const _size = React.useMemo(() => {
-    return TypeGuards.isNumber(size) ? {
-      width: size,
-      height: size,
-    } : null
-  }, [size])
-
+ 
   return (
     <Component
       {...rest}
-      style={[styles.wrapper, _size]}
+      css={styles.wrapper}
     />
   )
 }
@@ -41,9 +39,7 @@ ActivityIndicator.styleRegistryName = 'ActivityIndicator'
 ActivityIndicator.elements = ['wrapper']
 ActivityIndicator.rootElement = 'wrapper'
 
-ActivityIndicator.withVariantTypes = <S extends AnyRecord>(styles: S) => {
-  return ActivityIndicator as (props: StyledComponentProps<ActivityIndicatorProps, typeof styles>) => IJSX
-}
+  
 
 ActivityIndicator.defaultProps = {
   component: View,

package/src/components/ActivityIndicator/types.ts

@@ -1,12 +1,22 @@
 import React from 'react'
-import { StyledProp } from '@codeleap/styles'
+import { StyleProp, StyledProp, ICSS } from '@codeleap/styles'
 import { ComponentCommonProps } from '../../types'
 import { ActivityIndicatorComposition } from './styles'
 
+export interface ActivityIndicatorStyleDef {}
+
+/** Props for the `ActivityIndicator` component. */
 export type ActivityIndicatorProps =
   ComponentCommonProps &
   {
-    style?: StyledProp<ActivityIndicatorComposition>
+    style?: StyleProp<ActivityIndicatorComposition, keyof ActivityIndicatorStyleDef>
+    /**
+     * Custom component to render as the spinner; defaults to `View`.
+     * Visual appearance is entirely determined by style composition — no
+     * built-in spinner markup is rendered.
+     */
     component?: React.ComponentType<Omit<ActivityIndicatorProps & { ref?: React.Ref<HTMLDivElement> }, 'component'>>
     size?: number
+    className?: string
+    css?: ICSS
   }