@alfadocs/ui-kit-debug 0.69.0 → 0.71.0

package/dist/hooks/use-scroll-overflow.d.ts

@@ -0,0 +1,36 @@
+import { type RefObject } from 'react';
+export interface UseScrollOverflowReturn<T extends HTMLElement> {
+    /** Attach to the horizontally-scrollable element (the `overflow-x-auto` box). */
+    ref: RefObject<T | null>;
+    /** Content is hidden past the inline-START edge (scrolled away from the start). */
+    canScrollStart: boolean;
+    /** Content is hidden past the inline-END edge (more to reveal toward the end). */
+    canScrollEnd: boolean;
+    /**
+     * Scroll by ~one viewport toward the inline start (`-1`) or end (`+1`),
+     * smoothly unless the user prefers reduced motion. Direction-agnostic: works
+     * in both LTR and RTL.
+     */
+    scrollByPage: (direction: -1 | 1) => void;
+}
+/**
+ * Reports whether a horizontally-scrollable element has hidden content at its
+ * inline-start / inline-end edges, and exposes a paged scroll action — the
+ * plumbing behind a scroll strip's edge affordances (fade + chevron buttons).
+ *
+ * Direction-agnostic: distance-from-start is read as `Math.abs(scrollLeft)`,
+ * which is correct in both LTR (`0…max`) and modern RTL (`0…-max`), so the two
+ * edges are reported on the right logical side without branching. `scrollByPage`
+ * flips its physical sign from the element's computed `direction`.
+ *
+ * Re-measures on element resize AND on content-size change (a tab added past the
+ * fold widens the content without changing the container) by observing both the
+ * scroll box and its first child. `enabled` switches measurement off — e.g. when
+ * the host collapses the strip into a menu and there is nothing to scroll.
+ *
+ * Because the scrolled content stays in the DOM and is reachable by keyboard
+ * (focus scrolls it into view), the affordance this drives is a sighted-pointer
+ * convenience; assistive tech is unaffected.
+ */
+export declare function useScrollOverflow<T extends HTMLElement>(enabled?: boolean): UseScrollOverflowReturn<T>;
+//# sourceMappingURL=use-scroll-overflow.d.ts.map

package/dist/hooks/use-scroll-overflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-scroll-overflow.d.ts","sourceRoot":"","sources":["../../src/hooks/use-scroll-overflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGtE,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,WAAW;IAC5D,iFAAiF;IACjF,GAAG,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,mFAAmF;IACnF,cAAc,EAAE,OAAO,CAAC;IACxB,kFAAkF;IAClF,YAAY,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,YAAY,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,WAAW,EACrD,OAAO,UAAO,GACb,uBAAuB,CAAC,CAAC,CAAC,CA+D5B"}