@react-md/core 1.0.0-next.2 → 1.0.0-next.4

package/dist/src/draggable/useDraggable.js

@@ -0,0 +1,434 @@
+"use client";
+import { cnb } from "cnbuilder";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useUserInteractionMode } from "../interaction/UserInteractionModeProvider.js";
+import { useScrollLock } from "../scroll/useScrollLock.js";
+import { useDir } from "../typography/WritingDirectionProvider.js";
+import { useEnsuredRef } from "../useEnsuredRef.js";
+import { useEnsuredState } from "../useEnsuredState.js";
+import { useHtmlClassName } from "../useHtmlClassName.js";
+import { getPercentage } from "../utils/getPercentage.js";
+import { getRangeDefaultValue } from "../utils/getRangeDefaultValue.js";
+import { getRangeSteps } from "../utils/getRangeSteps.js";
+import { nearest } from "../utils/nearest.js";
+import { withinRange } from "../utils/withinRange.js";
+import { isMouseDragStartEvent, isTouchDragStartEvent, updateDragPosition } from "./utils.js";
+const noop = ()=>{
+// do nothing
+};
+/**
+ * This is most likely an internal only hook that provides the functionality for
+ * dragging an element through mouse, touch, and keyboard events. The main use
+ * cases so far for this hook are:
+ * - window splitters
+ * - sliders
+ *
+ * @remarks \@since 6.0.0
+ */ export function useDraggable(options) {
+    const { ref: propRef, min, max, rangeMin = min, rangeMax = max, step = 1, reversed = false, vertical = false, onKeyDown = noop, onMouseUp = noop, onMouseDown = noop, onMouseMove = noop, onTouchStart = noop, onTouchMove = noop, dragging: propDragging, setDragging: propSetDragging, value: propValue, setValue: propSetValue, defaultValue, withinOffsetParent = false, disabled = false, disableDraggingClassName = false, disableDraggingCursorClassName = disableDraggingClassName } = options;
+    const [nodeRef, ref] = useEnsuredRef(propRef);
+    const isTouch = useUserInteractionMode() === "touch";
+    const draggingRef = useRef(false);
+    const [dragPercentage, setDragPercentage] = useState(min);
+    const [value, setValue] = useEnsuredState({
+        value: propValue,
+        setValue: propSetValue,
+        defaultValue: getRangeDefaultValue({
+            min,
+            max,
+            step: 1,
+            defaultValue
+        })
+    });
+    const [dragging, setDragging] = useEnsuredState({
+        value: propDragging,
+        setValue: propSetDragging,
+        defaultValue: false
+    });
+    const isRTL = useDir().dir === "rtl";
+    const percentage = dragging && withinOffsetParent ? dragPercentage : getPercentage({
+        min,
+        max,
+        value
+    });
+    const maximum = useCallback(()=>{
+        setValue(max);
+    }, [
+        max,
+        setValue
+    ]);
+    const minimum = useCallback(()=>{
+        setValue(min);
+    }, [
+        min,
+        setValue
+    ]);
+    const increment = useCallback(()=>{
+        setValue((prevValue)=>withinRange({
+                min,
+                max,
+                value: prevValue + step
+            }));
+    }, [
+        max,
+        min,
+        setValue,
+        step
+    ]);
+    const decrement = useCallback(()=>{
+        setValue((prevValue)=>withinRange({
+                min,
+                max,
+                value: prevValue - step
+            }));
+    }, [
+        max,
+        min,
+        setValue,
+        step
+    ]);
+    const draggingClassName = dragging && !disableDraggingClassName;
+    useHtmlClassName(cnb(draggingClassName && "rmd-dragging"));
+    useHtmlClassName(cnb(!disableDraggingCursorClassName && draggingClassName && `rmd-dragging--${vertical ? "v" : "h"}`));
+    const draggedOnce = useRef(false);
+    useEffect(()=>{
+        if (!dragging) {
+            return;
+        }
+        draggedOnce.current = true;
+        const updatePosition = (event)=>{
+            if (!event.cancelable) {
+                return;
+            }
+            event.preventDefault();
+            event.stopPropagation();
+            updateDragPosition({
+                event,
+                nodeRef,
+                min,
+                max,
+                step,
+                rangeMin,
+                rangeMax,
+                isRTL,
+                isDragStart: false,
+                reversed,
+                vertical,
+                setValue,
+                setDragging,
+                setDragPercentage,
+                withinOffsetParent
+            });
+        };
+        const stopDragging = (event)=>{
+            updatePosition(event);
+            draggingRef.current = false;
+            setDragging(false);
+        };
+        const updateKey = isTouch ? "touchmove" : "mousemove";
+        const stopKey = isTouch ? "touchend" : "mouseup";
+        const passive = isTouch ? {
+            passive: false
+        } : undefined;
+        window.addEventListener(updateKey, updatePosition, passive);
+        window.addEventListener(stopKey, stopDragging);
+        return ()=>{
+            window.removeEventListener(updateKey, updatePosition);
+            window.removeEventListener(stopKey, stopDragging);
+        };
+    }, [
+        dragging,
+        isRTL,
+        isTouch,
+        max,
+        min,
+        nodeRef,
+        rangeMax,
+        rangeMin,
+        reversed,
+        setDragging,
+        setValue,
+        step,
+        vertical,
+        withinOffsetParent
+    ]);
+    const prevRange = useRef({
+        min,
+        max,
+        step
+    });
+    useEffect(()=>{
+        if (prevRange.current.min === min && prevRange.current.max === max && prevRange.current.step === step) {
+            return;
+        }
+        // ensure that if the `min`, `max`, or `step` value changes that the value
+        // is updated as well. Without this, there will be a runtime error if the
+        // value is not within the new range.
+        prevRange.current = {
+            min,
+            max,
+            step
+        };
+        setValue((prevValue)=>nearest({
+                min,
+                max,
+                steps: getRangeSteps({
+                    min,
+                    max,
+                    step
+                }),
+                value: prevValue
+            }));
+    }, [
+        max,
+        min,
+        setValue,
+        step
+    ]);
+    const mouseEventHandlers = {
+        onMouseDown: useCallback((event)=>{
+            onMouseDown(event);
+            if (disabled || isTouch || !isMouseDragStartEvent(event)) {
+                return;
+            }
+            // dont' allow text to be selected
+            event.preventDefault();
+            updateDragPosition({
+                isDragStart: true,
+                event,
+                nodeRef,
+                min,
+                max,
+                step,
+                rangeMin,
+                rangeMax,
+                isRTL,
+                reversed,
+                vertical,
+                setValue,
+                setDragging,
+                setDragPercentage,
+                withinOffsetParent
+            });
+            // don't set dragging immediately so that click events can still happen
+            draggingRef.current = true;
+        }, [
+            disabled,
+            isRTL,
+            isTouch,
+            max,
+            min,
+            nodeRef,
+            onMouseDown,
+            rangeMax,
+            rangeMin,
+            reversed,
+            setDragging,
+            setValue,
+            step,
+            vertical,
+            withinOffsetParent
+        ]),
+        onMouseMove: useCallback((event)=>{
+            onMouseMove(event);
+            if (disabled || isTouch || !draggingRef.current || dragging) {
+                return;
+            }
+            updateDragPosition({
+                isDragStart: true,
+                event,
+                nodeRef,
+                min,
+                max,
+                step,
+                rangeMin,
+                rangeMax,
+                isRTL,
+                reversed,
+                vertical,
+                setValue,
+                setDragging,
+                setDragPercentage,
+                withinOffsetParent
+            });
+            setDragging(true);
+        }, [
+            disabled,
+            dragging,
+            isRTL,
+            isTouch,
+            max,
+            min,
+            nodeRef,
+            onMouseMove,
+            rangeMax,
+            rangeMin,
+            reversed,
+            setDragging,
+            setValue,
+            step,
+            vertical,
+            withinOffsetParent
+        ]),
+        onMouseUp: useCallback((event)=>{
+            onMouseUp(event);
+            if (disabled || isTouch) {
+                return;
+            }
+            draggingRef.current = false;
+        }, [
+            disabled,
+            isTouch,
+            onMouseUp
+        ])
+    };
+    const keyboardEventHandlers = {
+        onKeyDown: useCallback((event)=>{
+            onKeyDown(event);
+            if (disabled) {
+                return;
+            }
+            const decrementKey = vertical ? "ArrowUp" : "ArrowLeft";
+            const incrementKey = vertical ? "ArrowDown" : "ArrowRight";
+            switch(event.key){
+                case decrementKey:
+                    event.preventDefault();
+                    decrement();
+                    break;
+                case incrementKey:
+                    event.preventDefault();
+                    increment();
+                    break;
+                case "Home":
+                    event.preventDefault();
+                    minimum();
+                    break;
+                case "End":
+                    event.preventDefault();
+                    maximum();
+                    break;
+            }
+        }, [
+            decrement,
+            disabled,
+            increment,
+            maximum,
+            minimum,
+            onKeyDown,
+            vertical
+        ])
+    };
+    // touch devices are a bit weird and cause issues since the "start" event is
+    // also used for scrolling. If the user quickly grabs the draggable element
+    // and drags vertically, most of the time it will try to scroll instead of
+    // dragging the element. The workaround is to being the drag events
+    // immediately on touchstart and disable scroll behavior for the page.
+    //
+    // There are also some issues with calling `event.preventDefault()` within
+    // touch events even while `{ passive: false } is manually set, so need to
+    // also attach a touchmove event.
+    useScrollLock(isTouch && dragging);
+    const touchEventHandlers = {
+        onTouchStart: useCallback((event)=>{
+            onTouchStart(event);
+            if (disabled || !isTouchDragStartEvent(event)) {
+                return;
+            }
+            draggingRef.current = true;
+            updateDragPosition({
+                isDragStart: true,
+                event,
+                nodeRef,
+                min,
+                max,
+                step,
+                rangeMin,
+                rangeMax,
+                isRTL,
+                reversed,
+                vertical,
+                setValue,
+                setDragging,
+                setDragPercentage,
+                withinOffsetParent
+            });
+        }, [
+            disabled,
+            isRTL,
+            max,
+            min,
+            nodeRef,
+            onTouchStart,
+            rangeMax,
+            rangeMin,
+            reversed,
+            setDragging,
+            setValue,
+            step,
+            vertical,
+            withinOffsetParent
+        ]),
+        onTouchMove: useCallback((event)=>{
+            onTouchMove(event);
+            if (disabled || !draggingRef.current || !event.cancelable) {
+                return;
+            }
+            // prevent the document's touchmove event from also firing
+            event.stopPropagation();
+            updateDragPosition({
+                isDragStart: true,
+                event,
+                nodeRef,
+                min,
+                max,
+                step,
+                rangeMin,
+                rangeMax,
+                isRTL,
+                reversed,
+                vertical,
+                setValue,
+                setDragging,
+                setDragPercentage,
+                withinOffsetParent
+            });
+        }, [
+            disabled,
+            isRTL,
+            max,
+            min,
+            nodeRef,
+            onTouchMove,
+            rangeMax,
+            rangeMin,
+            reversed,
+            setDragging,
+            setValue,
+            step,
+            vertical,
+            withinOffsetParent
+        ])
+    };
+    return {
+        ...touchEventHandlers,
+        ...mouseEventHandlers,
+        ...keyboardEventHandlers,
+        value,
+        setValue,
+        dragging,
+        setDragging,
+        maximum,
+        minimum,
+        increment,
+        decrement,
+        draggedOnce,
+        draggableRef: ref,
+        percentage,
+        dragPercentage,
+        touchEventHandlers,
+        mouseEventHandlers,
+        keyboardEventHandlers
+    };
+}
+
+//# sourceMappingURL=useDraggable.js.map

package/dist/src/draggable/useDraggable.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/draggable/useDraggable.ts"],"sourcesContent":["\"use client\";\nimport { cnb } from \"cnbuilder\";\nimport type { HTMLAttributes, Ref, RefCallback } from \"react\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useUserInteractionMode } from \"../interaction/UserInteractionModeProvider.js\";\nimport { useScrollLock } from \"../scroll/useScrollLock.js\";\nimport type {\n  NonNullRef,\n  UseStateInitializer,\n  UseStateSetter,\n} from \"../types.js\";\nimport { useDir } from \"../typography/WritingDirectionProvider.js\";\nimport { useEnsuredRef } from \"../useEnsuredRef.js\";\nimport { useEnsuredState } from \"../useEnsuredState.js\";\nimport { useHtmlClassName } from \"../useHtmlClassName.js\";\nimport { getPercentage } from \"../utils/getPercentage.js\";\nimport { getRangeDefaultValue } from \"../utils/getRangeDefaultValue.js\";\nimport { getRangeSteps } from \"../utils/getRangeSteps.js\";\nimport { nearest } from \"../utils/nearest.js\";\nimport { withinRange } from \"../utils/withinRange.js\";\nimport {\n  isMouseDragStartEvent,\n  isTouchDragStartEvent,\n  updateDragPosition,\n} from \"./utils.js\";\n\nconst noop = (): void => {\n  // do nothing\n};\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport type DraggableTouchEventHandlers<E extends HTMLElement> = Pick<\n  HTMLAttributes<E>,\n  \"onTouchStart\" | \"onTouchMove\"\n>;\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport type DraggableMouseEventHandlers<E extends HTMLElement> = Pick<\n  HTMLAttributes<E>,\n  \"onMouseDown\" | \"onMouseUp\" | \"onMouseMove\"\n>;\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport type DraggableKeyboardEventHandlers<E extends HTMLElement> = Pick<\n  HTMLAttributes<E>,\n  \"onKeyDown\"\n>;\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport type DraggableEventHandlers<E extends HTMLElement> =\n  DraggableTouchEventHandlers<E> &\n    DraggableMouseEventHandlers<E> &\n    DraggableKeyboardEventHandlers<E>;\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface ControllableDraggableStateOptions {\n  value?: number;\n  setValue?: UseStateSetter<number>;\n  defaultValue?: UseStateInitializer<number>;\n  dragging?: boolean;\n  setDragging?: UseStateSetter<boolean>;\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface BaseDraggableOptions<E extends HTMLElement>\n  extends DraggableEventHandlers<E>,\n    ControllableDraggableStateOptions {\n  /**\n   * An optional ref to merge with the returned\n   * {@link DraggableImplementation.draggableRef}.\n   */\n  ref?: Ref<E>;\n\n  /**\n   * The minimum number of pixels allowed for the draggable element. This must\n   * be a number greater than or equal to 0.\n   *\n   * When {@link withinOffsetParent} is set to `true`, this is the minimum value\n   * allowed instead of pixels.\n   */\n  min: number;\n\n  /**\n   * The maximum number of pixels allowed for the draggable element. This must\n   * be a number greater than the {@link min} and usually a number less than the\n   * viewport size.\n   *\n   * When {@link withinOffsetParent} is set to `true`, this is the maximum value\n   * allowed instead of pixels.\n   */\n  max: number;\n\n  /**\n   * The amount to increment or decrement the value with arrow keys.\n   *\n   * @defaultValue `1`\n   */\n  step?: number;\n\n  /**\n   * This was added to support range sliders where there are two (or more)\n   * draggable elements within the same container element and their values\n   * cannot pass each other. Without these overrides, the range would keep\n   * changing as the other values change, so the drag percentage would be\n   * incorrect.\n   *\n   * @example\n   * Range Slider\n   * ```ts\n   * const min = 0;\n   * const max = 100;\n   * const minValue = 3;\n   * const maxValue = 80;\n   *\n   * const minValueDraggable = useDraggable({\n   *   min,\n   *   max,\n   *   rangeMax: maxValue,\n   * });\n   * const maxValueDraggable = useDraggable({\n   *   min,\n   *   max,\n   *   rangeMin: minValue,\n   * });\n   * ```\n   *\n   * @defaultValue `min`\n   */\n  rangeMin?: number;\n\n  /**\n   * @see {@link rangeMin} for an explanation of this option.\n   * @defaultValue `max`\n   */\n  rangeMax?: number;\n\n  /**\n   * Set this to `true` to enable dragging vertically instead of horizontally.\n   *\n   * @defaultValue `false`\n   */\n  vertical?: boolean;\n\n  /**\n   * The default drag behavior is to increase the value when:\n   *\n   * - dragging `\"right\"` and the writing direction is `\"ltr\"`\n   * - dragging `\"left\"` and the writing direction is `\"rtl\"`\n   * - dragging `\"upwards\"`\n   *\n   * When this is set to `true`, the value when increase when:\n   *\n   * - dragging `\"left\"` and the writing direction is `\"ltr\"`\n   * - dragging `\"right\"` and the writing direction is `\"rtl\"`\n   * - dragging `\"downwards\"`\n   *\n   * @defaultValue `false`\n   */\n  reversed?: boolean;\n\n  /**\n   * Set this to `true` to disable all drag behavior. This will still call any\n   * of the provided {@link DraggableEventHandlers}.\n   *\n   * @defaultValue `false`\n   */\n  disabled?: boolean;\n\n  /**\n   * Set this to `true` if the dragging calculations should be to the\n   * `draggableRef.current.offsetParent` instead of the entire window. The main\n   * use case for this is sliders.\n   *\n   * @defaultValue `false`\n   */\n  withinOffsetParent?: boolean;\n\n  /**\n   * Set this to `true` to prevent the `document.documentElement` from gaining\n   * the `.rmd-dragging` class names while dragging.\n   *\n   * This should normally remain as `false` to improve performance and prevent\n   * other mouse events from firing while dragging.\n   *\n   * @defaultValue `false`\n   */\n  disableDraggingClassName?: boolean;\n\n  /**\n   * Set this to `true` to prevent the vertical or horizontal cursor from\n   * appearing while dragging.\n   *\n   * @defaultValue `false`\n   */\n  disableDraggingCursorClassName?: boolean;\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface UncontrolledDraggableOptions {\n  value?: never;\n  setValue?: never;\n  dragging?: never;\n  setDragging?: never;\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface ControlledValueDraggableOptions {\n  value: number;\n  setValue: UseStateSetter<number>;\n  defaultValue?: never;\n  dragging?: never;\n  setDragging?: never;\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface ControlledDraggingDraggableOptions {\n  value?: never;\n  setValue?: never;\n  defaultValue?: never;\n  dragging: boolean;\n  setDragging: UseStateSetter<boolean>;\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface FullyControlledDraggableOptions {\n  value: number;\n  setValue: UseStateSetter<number>;\n  dragging: boolean;\n  setDragging: UseStateSetter<boolean>;\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport type DraggableStateOptions =\n  | UncontrolledDraggableOptions\n  | ControlledValueDraggableOptions\n  | ControlledDraggingDraggableOptions\n  | FullyControlledDraggableOptions;\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport type DraggableOptions<E extends HTMLElement = HTMLElement> =\n  BaseDraggableOptions<E> & DraggableStateOptions;\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface DraggableImplementation<E extends HTMLElement = HTMLElement>\n  extends Required<DraggableEventHandlers<E>> {\n  mouseEventHandlers: Required<DraggableMouseEventHandlers<E>>;\n  touchEventHandlers: Required<DraggableTouchEventHandlers<E>>;\n  keyboardEventHandlers: Required<DraggableKeyboardEventHandlers<E>>;\n\n  /**\n   * Set the {@link value} to {@link DraggableOptions.min}.\n   */\n  minimum(): void;\n\n  /**\n   * Set the {@link value} to {@link DraggableOptions.max}.\n   */\n  maximum(): void;\n\n  /**\n   * Increment the {@link value} by {@link DraggableOptions.step}.\n   */\n  increment(): void;\n\n  /**\n   * Decrement the {@link value} by {@link DraggableOptions.step}.\n   */\n  decrement(): void;\n\n  /**\n   * THe current percentage the `value` is within the range.\n   *\n   * ```ts\n   * const percentage =\n   *   dragging && withinOffsetParent\n   *     ? : dragPercentage\n   *     : getPercentage({ min, max, value });\n   * ```\n   */\n  percentage: number;\n\n  /**\n   * A ref that **Must** be passed to the element that should be draggable.\n   */\n  draggableRef: RefCallback<E>;\n\n  /**\n   * This value will only update while dragging with a mouse or touch and should\n   * be used for the positioning styles while dragging.\n   *\n   * Note: The {@Link percentage} will use this value while dragging.\n   */\n  dragPercentage: number;\n\n  /**\n   * Flag to determine if the user has dragged at least once. Used internally\n   * for manually persisting the value into local storage once the user has\n   * stopped dragging.\n   */\n  draggedOnce: NonNullRef<boolean>;\n\n  value: number;\n  setValue: UseStateSetter<number>;\n  dragging: boolean;\n  setDragging: UseStateSetter<boolean>;\n}\n\n/**\n * This is most likely an internal only hook that provides the functionality for\n * dragging an element through mouse, touch, and keyboard events. The main use\n * cases so far for this hook are:\n * - window splitters\n * - sliders\n *\n * @remarks \\@since 6.0.0\n */\nexport function useDraggable<E extends HTMLElement>(\n  options: DraggableOptions<E>\n): DraggableImplementation<E> {\n  const {\n    ref: propRef,\n    min,\n    max,\n    rangeMin = min,\n    rangeMax = max,\n    step = 1,\n    reversed = false,\n    vertical = false,\n    onKeyDown = noop,\n    onMouseUp = noop,\n    onMouseDown = noop,\n    onMouseMove = noop,\n    onTouchStart = noop,\n    onTouchMove = noop,\n    dragging: propDragging,\n    setDragging: propSetDragging,\n    value: propValue,\n    setValue: propSetValue,\n    defaultValue,\n    withinOffsetParent = false,\n    disabled = false,\n    disableDraggingClassName = false,\n    disableDraggingCursorClassName = disableDraggingClassName,\n  } = options;\n\n  const [nodeRef, ref] = useEnsuredRef(propRef);\n  const isTouch = useUserInteractionMode() === \"touch\";\n  const draggingRef = useRef(false);\n  const [dragPercentage, setDragPercentage] = useState(min);\n  const [value, setValue] = useEnsuredState({\n    value: propValue,\n    setValue: propSetValue,\n    defaultValue: getRangeDefaultValue({\n      min,\n      max,\n      step: 1,\n      defaultValue,\n    }),\n  });\n  const [dragging, setDragging] = useEnsuredState({\n    value: propDragging,\n    setValue: propSetDragging,\n    defaultValue: false,\n  });\n\n  const isRTL = useDir().dir === \"rtl\";\n  const percentage =\n    dragging && withinOffsetParent\n      ? dragPercentage\n      : getPercentage({ min, max, value });\n  const maximum = useCallback(() => {\n    setValue(max);\n  }, [max, setValue]);\n  const minimum = useCallback(() => {\n    setValue(min);\n  }, [min, setValue]);\n  const increment = useCallback(() => {\n    setValue((prevValue) => withinRange({ min, max, value: prevValue + step }));\n  }, [max, min, setValue, step]);\n  const decrement = useCallback(() => {\n    setValue((prevValue) => withinRange({ min, max, value: prevValue - step }));\n  }, [max, min, setValue, step]);\n\n  const draggingClassName = dragging && !disableDraggingClassName;\n  useHtmlClassName(cnb(draggingClassName && \"rmd-dragging\"));\n  useHtmlClassName(\n    cnb(\n      !disableDraggingCursorClassName &&\n        draggingClassName &&\n        `rmd-dragging--${vertical ? \"v\" : \"h\"}`\n    )\n  );\n\n  const draggedOnce = useRef(false);\n  useEffect(() => {\n    if (!dragging) {\n      return;\n    }\n\n    draggedOnce.current = true;\n    const updatePosition = (event: MouseEvent | TouchEvent): void => {\n      if (!event.cancelable) {\n        return;\n      }\n\n      event.preventDefault();\n      event.stopPropagation();\n\n      updateDragPosition({\n        event,\n        nodeRef,\n        min,\n        max,\n        step,\n        rangeMin,\n        rangeMax,\n        isRTL,\n        isDragStart: false,\n        reversed,\n        vertical,\n        setValue,\n        setDragging,\n        setDragPercentage,\n        withinOffsetParent,\n      });\n    };\n\n    const stopDragging = (event: MouseEvent | TouchEvent): void => {\n      updatePosition(event);\n      draggingRef.current = false;\n      setDragging(false);\n    };\n\n    const updateKey = isTouch ? \"touchmove\" : \"mousemove\";\n    const stopKey = isTouch ? \"touchend\" : \"mouseup\";\n    const passive = isTouch ? { passive: false } : undefined;\n\n    window.addEventListener(updateKey, updatePosition, passive);\n    window.addEventListener(stopKey, stopDragging);\n    return () => {\n      window.removeEventListener(updateKey, updatePosition);\n      window.removeEventListener(stopKey, stopDragging);\n    };\n  }, [\n    dragging,\n    isRTL,\n    isTouch,\n    max,\n    min,\n    nodeRef,\n    rangeMax,\n    rangeMin,\n    reversed,\n    setDragging,\n    setValue,\n    step,\n    vertical,\n    withinOffsetParent,\n  ]);\n\n  const prevRange = useRef({ min, max, step });\n  useEffect(() => {\n    if (\n      prevRange.current.min === min &&\n      prevRange.current.max === max &&\n      prevRange.current.step === step\n    ) {\n      return;\n    }\n\n    // ensure that if the `min`, `max`, or `step` value changes that the value\n    // is updated as well. Without this, there will be a runtime error if the\n    // value is not within the new range.\n    prevRange.current = { min, max, step };\n    setValue((prevValue) =>\n      nearest({\n        min,\n        max,\n        steps: getRangeSteps({ min, max, step }),\n        value: prevValue,\n      })\n    );\n  }, [max, min, setValue, step]);\n\n  const mouseEventHandlers: Required<DraggableMouseEventHandlers<E>> = {\n    onMouseDown: useCallback(\n      (event) => {\n        onMouseDown(event);\n        if (disabled || isTouch || !isMouseDragStartEvent(event)) {\n          return;\n        }\n\n        // dont' allow text to be selected\n        event.preventDefault();\n        updateDragPosition({\n          isDragStart: true,\n          event,\n          nodeRef,\n          min,\n          max,\n          step,\n          rangeMin,\n          rangeMax,\n          isRTL,\n          reversed,\n          vertical,\n          setValue,\n          setDragging,\n          setDragPercentage,\n          withinOffsetParent,\n        });\n\n        // don't set dragging immediately so that click events can still happen\n        draggingRef.current = true;\n      },\n      [\n        disabled,\n        isRTL,\n        isTouch,\n        max,\n        min,\n        nodeRef,\n        onMouseDown,\n        rangeMax,\n        rangeMin,\n        reversed,\n        setDragging,\n        setValue,\n        step,\n        vertical,\n        withinOffsetParent,\n      ]\n    ),\n    onMouseMove: useCallback(\n      (event) => {\n        onMouseMove(event);\n        if (disabled || isTouch || !draggingRef.current || dragging) {\n          return;\n        }\n\n        updateDragPosition({\n          isDragStart: true,\n          event,\n          nodeRef,\n          min,\n          max,\n          step,\n          rangeMin,\n          rangeMax,\n          isRTL,\n          reversed,\n          vertical,\n          setValue,\n          setDragging,\n          setDragPercentage,\n          withinOffsetParent,\n        });\n        setDragging(true);\n      },\n      [\n        disabled,\n        dragging,\n        isRTL,\n        isTouch,\n        max,\n        min,\n        nodeRef,\n        onMouseMove,\n        rangeMax,\n        rangeMin,\n        reversed,\n        setDragging,\n        setValue,\n        step,\n        vertical,\n        withinOffsetParent,\n      ]\n    ),\n    onMouseUp: useCallback(\n      (event) => {\n        onMouseUp(event);\n        if (disabled || isTouch) {\n          return;\n        }\n\n        draggingRef.current = false;\n      },\n      [disabled, isTouch, onMouseUp]\n    ),\n  };\n  const keyboardEventHandlers: Required<DraggableKeyboardEventHandlers<E>> = {\n    onKeyDown: useCallback(\n      (event) => {\n        onKeyDown(event);\n        if (disabled) {\n          return;\n        }\n\n        const decrementKey = vertical ? \"ArrowUp\" : \"ArrowLeft\";\n        const incrementKey = vertical ? \"ArrowDown\" : \"ArrowRight\";\n\n        switch (event.key) {\n          case decrementKey:\n            event.preventDefault();\n            decrement();\n            break;\n          case incrementKey:\n            event.preventDefault();\n            increment();\n            break;\n          case \"Home\":\n            event.preventDefault();\n            minimum();\n            break;\n          case \"End\":\n            event.preventDefault();\n            maximum();\n            break;\n        }\n      },\n      [decrement, disabled, increment, maximum, minimum, onKeyDown, vertical]\n    ),\n  };\n\n  // touch devices are a bit weird and cause issues since the \"start\" event is\n  // also used for scrolling. If the user quickly grabs the draggable element\n  // and drags vertically, most of the time it will try to scroll instead of\n  // dragging the element. The workaround is to being the drag events\n  // immediately on touchstart and disable scroll behavior for the page.\n  //\n  // There are also some issues with calling `event.preventDefault()` within\n  // touch events even while `{ passive: false } is manually set, so need to\n  // also attach a touchmove event.\n  useScrollLock(isTouch && dragging);\n  const touchEventHandlers: Required<DraggableTouchEventHandlers<E>> = {\n    onTouchStart: useCallback(\n      (event) => {\n        onTouchStart(event);\n        if (disabled || !isTouchDragStartEvent(event)) {\n          return;\n        }\n\n        draggingRef.current = true;\n        updateDragPosition({\n          isDragStart: true,\n          event,\n          nodeRef,\n          min,\n          max,\n          step,\n          rangeMin,\n          rangeMax,\n          isRTL,\n          reversed,\n          vertical,\n          setValue,\n          setDragging,\n          setDragPercentage,\n          withinOffsetParent,\n        });\n      },\n      [\n        disabled,\n        isRTL,\n        max,\n        min,\n        nodeRef,\n        onTouchStart,\n        rangeMax,\n        rangeMin,\n        reversed,\n        setDragging,\n        setValue,\n        step,\n        vertical,\n        withinOffsetParent,\n      ]\n    ),\n    onTouchMove: useCallback(\n      (event) => {\n        onTouchMove(event);\n        if (disabled || !draggingRef.current || !event.cancelable) {\n          return;\n        }\n\n        // prevent the document's touchmove event from also firing\n        event.stopPropagation();\n        updateDragPosition({\n          isDragStart: true,\n          event,\n          nodeRef,\n          min,\n          max,\n          step,\n          rangeMin,\n          rangeMax,\n          isRTL,\n          reversed,\n          vertical,\n          setValue,\n          setDragging,\n          setDragPercentage,\n          withinOffsetParent,\n        });\n      },\n      [\n        disabled,\n        isRTL,\n        max,\n        min,\n        nodeRef,\n        onTouchMove,\n        rangeMax,\n        rangeMin,\n        reversed,\n        setDragging,\n        setValue,\n        step,\n        vertical,\n        withinOffsetParent,\n      ]\n    ),\n  };\n\n  return {\n    ...touchEventHandlers,\n    ...mouseEventHandlers,\n    ...keyboardEventHandlers,\n    value,\n    setValue,\n    dragging,\n    setDragging,\n    maximum,\n    minimum,\n    increment,\n    decrement,\n    draggedOnce,\n    draggableRef: ref,\n    percentage,\n    dragPercentage,\n    touchEventHandlers,\n    mouseEventHandlers,\n    keyboardEventHandlers,\n  };\n}\n"],"names":["cnb","useCallback","useEffect","useRef","useState","useUserInteractionMode","useScrollLock","useDir","useEnsuredRef","useEnsuredState","useHtmlClassName","getPercentage","getRangeDefaultValue","getRangeSteps","nearest","withinRange","isMouseDragStartEvent","isTouchDragStartEvent","updateDragPosition","noop","useDraggable","options","ref","propRef","min","max","rangeMin","rangeMax","step","reversed","vertical","onKeyDown","onMouseUp","onMouseDown","onMouseMove","onTouchStart","onTouchMove","dragging","propDragging","setDragging","propSetDragging","value","propValue","setValue","propSetValue","defaultValue","withinOffsetParent","disabled","disableDraggingClassName","disableDraggingCursorClassName","nodeRef","isTouch","draggingRef","dragPercentage","setDragPercentage","isRTL","dir","percentage","maximum","minimum","increment","prevValue","decrement","draggingClassName","draggedOnce","current","updatePosition","event","cancelable","preventDefault","stopPropagation","isDragStart","stopDragging","updateKey","stopKey","passive","undefined","window","addEventListener","removeEventListener","prevRange","steps","mouseEventHandlers","keyboardEventHandlers","decrementKey","incrementKey","key","touchEventHandlers","draggableRef"],"mappings":"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AAO,GAAG;YACtB/C,mBAAmB;gBACjBqD,aAAa;gBACbJ;gBACAjB;gBACA1B;gBACAC;gBACAG;gBACAF;gBACAC;gBACA4B;gBACA1B;gBACAC;gBACAa;gBACAJ;gBACAe;gBACAR;YACF;QACF,GACA;YACEC;YACAQ;YACA9B;YACAD;YACA0B;YACAf;YACAR;YACAD;YACAG;YACAU;YACAI;YACAf;YACAE;YACAgB;SACD;QAEHV,aAAanC,YACX,CAACkE;YACC/B,YAAY+B;YACZ,IAAIpB,YAAY,CAACK,YAAYa,OAAO,IAAI,CAACE,MAAMC,UAAU,EAAE;gBACzD;YACF;YAEA,0DAA0D;YAC1DD,MAAMG,eAAe;YACrBpD,mBAAmB;gBACjBqD,aAAa;gBACbJ;gBACAjB;gBACA1B;gBACAC;gBACAG;gBACAF;gBACAC;gBACA4B;gBACA1B;gBACAC;gBACAa;gBACAJ;gBACAe;gBACAR;YACF;QACF,GACA;YACEC;YACAQ;YACA9B;YACAD;YACA0B;YACAd;YACAT;YACAD;YACAG;YACAU;YACAI;YACAf;YACAE;YACAgB;SACD;IAEL;IAEA,OAAO;QACL,GAAGyC,kBAAkB;QACrB,GAAGL,kBAAkB;QACrB,GAAGC,qBAAqB;QACxB1C;QACAE;QACAN;QACAE;QACAmB;QACAC;QACAC;QACAE;QACAE;QACAwB,cAAclE;QACdmC;QACAJ;QACAkC;QACAL;QACAC;IACF;AACF"}

package/dist/src/draggable/utils.js

@@ -0,0 +1,130 @@
+import { getClientPosition } from "../utils/getClientPosition.js";
+import { getRangeSteps } from "../utils/getRangeSteps.js";
+import { nearest } from "../utils/nearest.js";
+import { withinRange } from "../utils/withinRange.js";
+/**
+ * @internal
+ */ export const isMouseDragStartEvent = (event)=>event.button === 0 && !event.altKey && !event.metaKey && !event.ctrlKey && !event.shiftKey;
+/**
+ * @internal
+ */ export const isTouchDragStartEvent = (event)=>event.changedTouches.length === 1;
+/**
+ * @internal
+ */ export const getDragPosition = (options)=>{
+    const { isRTL, reversed, vertical, container } = options;
+    const clientPosition = getClientPosition(options);
+    const { left, right, top } = container.getBoundingClientRect();
+    if (vertical) {
+        if (reversed) {
+            return window.innerHeight - clientPosition;
+        }
+        // added `Math.max` since the `top` will be a negative number if rendered
+        // within a portal element like a dialog/sheet
+        return clientPosition - Math.max(0, top);
+    }
+    if (reversed ? !isRTL : isRTL) {
+        return right - clientPosition;
+    }
+    return clientPosition - left;
+};
+/**
+ * @internal
+ */ export const getRelativeDragPosition = (options)=>{
+    const { min, max, rangeMin, rangeMax, step, isRTL, vertical, container } = options;
+    const { height, width, left, top } = container.getBoundingClientRect();
+    const containerSize = vertical ? height : width;
+    const containerPosition = vertical ? top + height : left;
+    const clientPosition = getClientPosition(options);
+    const position = vertical ? containerPosition - clientPosition : clientPosition - containerPosition;
+    const distanceDragged = Math.min(Math.max(0, position), containerSize);
+    let dragPercentage = distanceDragged / containerSize;
+    if (isRTL && !vertical) {
+        dragPercentage = 1 - dragPercentage;
+    }
+    const range = rangeMax - rangeMin;
+    const steps = getRangeSteps({
+        min: rangeMin,
+        max: rangeMax,
+        step
+    });
+    const value = dragPercentage * range + rangeMin;
+    const nextValue = nearest({
+        min,
+        max,
+        steps,
+        range,
+        value
+    });
+    return {
+        value: nextValue,
+        dragPercentage
+    };
+};
+/**
+ * @internal
+ */ export const updateDragPosition = (options)=>{
+    const { event, nodeRef, min, max, step, rangeMin, rangeMax, isRTL, reversed, vertical, isDragStart, setValue, setDragging, setDragPercentage, withinOffsetParent } = options;
+    const element = nodeRef.current;
+    if (!element) {
+        return;
+    }
+    if (isDragStart) {
+        // need to focus so that Chromium based browsers allow drag events. this
+        // really appeared while trying to create a DnD tree
+        element.focus({
+            preventScroll: true
+        });
+        if (!withinOffsetParent && !("changedTouches" in event)) {
+            return;
+        }
+        // unlike the other flow, start dragging immediately so that you can trigger
+        // a mousedown or touchstart event on the container element and drag until
+        // the user lets go
+        setDragging(true);
+    }
+    // firefox defaults to `document.body` while chrome will return `null`
+    const container = element.offsetParent || document.body;
+    if (!withinOffsetParent) {
+        const dragPosition = getDragPosition({
+            event,
+            isRTL,
+            reversed,
+            vertical,
+            container
+        });
+        const nextValue = withinRange({
+            min,
+            max,
+            value: dragPosition
+        });
+        setValue(nextValue);
+        return;
+    }
+    const { value, dragPercentage } = getRelativeDragPosition({
+        min,
+        max,
+        rangeMin,
+        rangeMax,
+        step,
+        event,
+        isRTL,
+        reversed,
+        vertical,
+        container
+    });
+    setValue(value);
+    setDragPercentage(dragPercentage);
+};
+/**
+ * @internal
+ * @remarks \@since 6.0.0
+ */ export function deserializeDraggableValue(options) {
+    const { item, min, max } = options;
+    const value = parseFloat(item);
+    if (Number.isNaN(item)) {
+        return min;
+    }
+    return Math.max(min, Math.min(max, value));
+}
+
+//# sourceMappingURL=utils.js.map

package/dist/src/draggable/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/draggable/utils.ts"],"sourcesContent":["import { type MouseEvent, type RefObject, type TouchEvent } from \"react\";\nimport {\n  getClientPosition,\n  type ClientPositionEvent,\n  type ClientPositionOptions,\n} from \"../utils/getClientPosition.js\";\nimport { getRangeSteps } from \"../utils/getRangeSteps.js\";\nimport { nearest } from \"../utils/nearest.js\";\nimport { withinRange } from \"../utils/withinRange.js\";\n\n/**\n * @internal\n */\nexport const isMouseDragStartEvent = (event: MouseEvent): boolean =>\n  event.button === 0 &&\n  !event.altKey &&\n  !event.metaKey &&\n  !event.ctrlKey &&\n  !event.shiftKey;\n\n/**\n * @internal\n */\nexport const isTouchDragStartEvent = (event: TouchEvent): boolean =>\n  event.changedTouches.length === 1;\n\n/**\n * @internal\n */\ninterface DragPositionOptions extends ClientPositionOptions {\n  isRTL: boolean;\n  reversed: boolean;\n  container: Element;\n}\n\n/**\n * @internal\n */\nexport const getDragPosition = (options: DragPositionOptions): number => {\n  const { isRTL, reversed, vertical, container } = options;\n\n  const clientPosition = getClientPosition(options);\n  const { left, right, top } = container.getBoundingClientRect();\n  if (vertical) {\n    if (reversed) {\n      return window.innerHeight - clientPosition;\n    }\n\n    // added `Math.max` since the `top` will be a negative number if rendered\n    // within a portal element like a dialog/sheet\n    return clientPosition - Math.max(0, top);\n  }\n\n  if (reversed ? !isRTL : isRTL) {\n    return right - clientPosition;\n  }\n\n  return clientPosition - left;\n};\n\n/**\n * @internal\n */\ninterface RelativeDragPositionOptions extends DragPositionOptions {\n  min: number;\n  max: number;\n  step: number;\n  rangeMin: number;\n  rangeMax: number;\n}\n\n/**\n * @internal\n */\ninterface RelativeDragPosition {\n  value: number;\n  dragPercentage: number;\n}\n\n/**\n * @internal\n */\nexport const getRelativeDragPosition = (\n  options: RelativeDragPositionOptions\n): RelativeDragPosition => {\n  const { min, max, rangeMin, rangeMax, step, isRTL, vertical, container } =\n    options;\n\n  const { height, width, left, top } = container.getBoundingClientRect();\n  const containerSize = vertical ? height : width;\n  const containerPosition = vertical ? top + height : left;\n  const clientPosition = getClientPosition(options);\n\n  const position = vertical\n    ? containerPosition - clientPosition\n    : clientPosition - containerPosition;\n  const distanceDragged = Math.min(Math.max(0, position), containerSize);\n  let dragPercentage = distanceDragged / containerSize;\n  if (isRTL && !vertical) {\n    dragPercentage = 1 - dragPercentage;\n  }\n\n  const range = rangeMax - rangeMin;\n  const steps = getRangeSteps({ min: rangeMin, max: rangeMax, step });\n  const value = dragPercentage * range + rangeMin;\n  const nextValue = nearest({\n    min,\n    max,\n    steps,\n    range,\n    value,\n  });\n\n  return {\n    value: nextValue,\n    dragPercentage,\n  };\n};\n\n/**\n * @internal\n */\ninterface UpdateDragPositionOptions\n  extends Omit<RelativeDragPositionOptions, \"container\"> {\n  event: ClientPositionEvent;\n  nodeRef: RefObject<HTMLElement>;\n  focus?: boolean;\n  isDragStart: boolean;\n  setValue(value: number): void;\n  setDragging(dragging: boolean): void;\n  setDragPercentage(value: number): void;\n  withinOffsetParent: boolean;\n}\n\n/**\n * @internal\n */\nexport const updateDragPosition = (\n  options: UpdateDragPositionOptions\n): void => {\n  const {\n    event,\n    nodeRef,\n    min,\n    max,\n    step,\n    rangeMin,\n    rangeMax,\n    isRTL,\n    reversed,\n    vertical,\n    isDragStart,\n    setValue,\n    setDragging,\n    setDragPercentage,\n    withinOffsetParent,\n  } = options;\n\n  const element = nodeRef.current;\n  if (!element) {\n    return;\n  }\n\n  if (isDragStart) {\n    // need to focus so that Chromium based browsers allow drag events. this\n    // really appeared while trying to create a DnD tree\n    element.focus({ preventScroll: true });\n\n    if (!withinOffsetParent && !(\"changedTouches\" in event)) {\n      return;\n    }\n\n    // unlike the other flow, start dragging immediately so that you can trigger\n    // a mousedown or touchstart event on the container element and drag until\n    // the user lets go\n    setDragging(true);\n  }\n\n  // firefox defaults to `document.body` while chrome will return `null`\n  const container = element.offsetParent || document.body;\n  if (!withinOffsetParent) {\n    const dragPosition = getDragPosition({\n      event,\n      isRTL,\n      reversed,\n      vertical,\n      container,\n    });\n    const nextValue = withinRange({\n      min,\n      max,\n      value: dragPosition,\n    });\n    setValue(nextValue);\n\n    return;\n  }\n\n  const { value, dragPercentage } = getRelativeDragPosition({\n    min,\n    max,\n    rangeMin,\n    rangeMax,\n    step,\n    event,\n    isRTL,\n    reversed,\n    vertical,\n    container,\n  });\n\n  setValue(value);\n  setDragPercentage(dragPercentage);\n};\n\n/**\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport interface DeserializeDraggableValueOptions {\n  min: number;\n  max: number;\n  item: string;\n}\n\n/**\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport function deserializeDraggableValue(\n  options: DeserializeDraggableValueOptions\n): number {\n  const { item, min, max } = options;\n\n  const value = parseFloat(item);\n  if (Number.isNaN(item)) {\n    return min;\n  }\n\n  return Math.max(min, Math.min(max, value));\n}\n"],"names":["getClientPosition","getRangeSteps","nearest","withinRange","isMouseDragStartEvent","event","button","altKey","metaKey","ctrlKey","shiftKey","isTouchDragStartEvent","changedTouches","length","getDragPosition","options","isRTL","reversed","vertical","container","clientPosition","left","right","top","getBoundingClientRect","window","innerHeight","Math","max","getRelativeDragPosition","min","rangeMin","rangeMax","step","height","width","containerSize","containerPosition","position","distanceDragged","dragPercentage","range","steps","value","nextValue","updateDragPosition","nodeRef","isDragStart","setValue","setDragging","setDragPercentage","withinOffsetParent","element","current","focus","preventScroll","offsetParent","document","body","dragPosition","deserializeDraggableValue","item","parseFloat","Number","isNaN"],"mappings":"AACA,SACEA,iBAAiB,QAGZ,gCAAgC;AACvC,SAASC,aAAa,QAAQ,4BAA4B;AAC1D,SAASC,OAAO,QAAQ,sBAAsB;AAC9C,SAASC,WAAW,QAAQ,0BAA0B;AAEtD;;CAEC,GACD,OAAO,MAAMC,wBAAwB,CAACC,QACpCA,MAAMC,MAAM,KAAK,KACjB,CAACD,MAAME,MAAM,IACb,CAACF,MAAMG,OAAO,IACd,CAACH,MAAMI,OAAO,IACd,CAACJ,MAAMK,QAAQ,CAAC;AAElB;;CAEC,GACD,OAAO,MAAMC,wBAAwB,CAACN,QACpCA,MAAMO,cAAc,CAACC,MAAM,KAAK,EAAE;AAWpC;;CAEC,GACD,OAAO,MAAMC,kBAAkB,CAACC;IAC9B,MAAM,EAAEC,KAAK,EAAEC,QAAQ,EAAEC,QAAQ,EAAEC,SAAS,EAAE,GAAGJ;IAEjD,MAAMK,iBAAiBpB,kBAAkBe;IACzC,MAAM,EAAEM,IAAI,EAAEC,KAAK,EAAEC,GAAG,EAAE,GAAGJ,UAAUK,qBAAqB;IAC5D,IAAIN,UAAU;QACZ,IAAID,UAAU;YACZ,OAAOQ,OAAOC,WAAW,GAAGN;QAC9B;QAEA,yEAAyE;QACzE,8CAA8C;QAC9C,OAAOA,iBAAiBO,KAAKC,GAAG,CAAC,GAAGL;IACtC;IAEA,IAAIN,WAAW,CAACD,QAAQA,OAAO;QAC7B,OAAOM,QAAQF;IACjB;IAEA,OAAOA,iBAAiBC;AAC1B,EAAE;AAqBF;;CAEC,GACD,OAAO,MAAMQ,0BAA0B,CACrCd;IAEA,MAAM,EAAEe,GAAG,EAAEF,GAAG,EAAEG,QAAQ,EAAEC,QAAQ,EAAEC,IAAI,EAAEjB,KAAK,EAAEE,QAAQ,EAAEC,SAAS,EAAE,GACtEJ;IAEF,MAAM,EAAEmB,MAAM,EAAEC,KAAK,EAAEd,IAAI,EAAEE,GAAG,EAAE,GAAGJ,UAAUK,qBAAqB;IACpE,MAAMY,gBAAgBlB,WAAWgB,SAASC;IAC1C,MAAME,oBAAoBnB,WAAWK,MAAMW,SAASb;IACpD,MAAMD,iBAAiBpB,kBAAkBe;IAEzC,MAAMuB,WAAWpB,WACbmB,oBAAoBjB,iBACpBA,iBAAiBiB;IACrB,MAAME,kBAAkBZ,KAAKG,GAAG,CAACH,KAAKC,GAAG,CAAC,GAAGU,WAAWF;IACxD,IAAII,iBAAiBD,kBAAkBH;IACvC,IAAIpB,SAAS,CAACE,UAAU;QACtBsB,iBAAiB,IAAIA;IACvB;IAEA,MAAMC,QAAQT,WAAWD;IACzB,MAAMW,QAAQzC,cAAc;QAAE6B,KAAKC;QAAUH,KAAKI;QAAUC;IAAK;IACjE,MAAMU,QAAQH,iBAAiBC,QAAQV;IACvC,MAAMa,YAAY1C,QAAQ;QACxB4B;QACAF;QACAc;QACAD;QACAE;IACF;IAEA,OAAO;QACLA,OAAOC;QACPJ;IACF;AACF,EAAE;AAiBF;;CAEC,GACD,OAAO,MAAMK,qBAAqB,CAChC9B;IAEA,MAAM,EACJV,KAAK,EACLyC,OAAO,EACPhB,GAAG,EACHF,GAAG,EACHK,IAAI,EACJF,QAAQ,EACRC,QAAQ,EACRhB,KAAK,EACLC,QAAQ,EACRC,QAAQ,EACR6B,WAAW,EACXC,QAAQ,EACRC,WAAW,EACXC,iBAAiB,EACjBC,kBAAkB,EACnB,GAAGpC;IAEJ,MAAMqC,UAAUN,QAAQO,OAAO;IAC/B,IAAI,CAACD,SAAS;QACZ;IACF;IAEA,IAAIL,aAAa;QACf,wEAAwE;QACxE,oDAAoD;QACpDK,QAAQE,KAAK,CAAC;YAAEC,eAAe;QAAK;QAEpC,IAAI,CAACJ,sBAAsB,CAAE,CAAA,oBAAoB9C,KAAI,GAAI;YACvD;QACF;QAEA,4EAA4E;QAC5E,0EAA0E;QAC1E,mBAAmB;QACnB4C,YAAY;IACd;IAEA,sEAAsE;IACtE,MAAM9B,YAAYiC,QAAQI,YAAY,IAAIC,SAASC,IAAI;IACvD,IAAI,CAACP,oBAAoB;QACvB,MAAMQ,eAAe7C,gBAAgB;YACnCT;YACAW;YACAC;YACAC;YACAC;QACF;QACA,MAAMyB,YAAYzC,YAAY;YAC5B2B;YACAF;YACAe,OAAOgB;QACT;QACAX,SAASJ;QAET;IACF;IAEA,MAAM,EAAED,KAAK,EAAEH,cAAc,EAAE,GAAGX,wBAAwB;QACxDC;QACAF;QACAG;QACAC;QACAC;QACA5B;QACAW;QACAC;QACAC;QACAC;IACF;IAEA6B,SAASL;IACTO,kBAAkBV;AACpB,EAAE;AAYF;;;CAGC,GACD,OAAO,SAASoB,0BACd7C,OAAyC;IAEzC,MAAM,EAAE8C,IAAI,EAAE/B,GAAG,EAAEF,GAAG,EAAE,GAAGb;IAE3B,MAAM4B,QAAQmB,WAAWD;IACzB,IAAIE,OAAOC,KAAK,CAACH,OAAO;QACtB,OAAO/B;IACT;IAEA,OAAOH,KAAKC,GAAG,CAACE,KAAKH,KAAKG,GAAG,CAACF,KAAKe;AACrC"}

package/dist/src/expansion-panel/ExpansionList.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/expansion-panel/ExpansionList.tsx"],"sourcesContent":["\"use client\";\nimport { forwardRef, type HTMLAttributes, type ReactNode } from \"react\";\nimport { KeyboardMovementProvider } from \"../movement/useKeyboardMovementProvider.js\";\nimport { useExpansionList } from \"./useExpansionList.js\";\n\n/**\n * @remarks \\@since 6.0.0 No longer requires the `onKeyDown` prop.\n */\nexport interface ExpansionListProps extends HTMLAttributes<HTMLDivElement> {\n  children: ReactNode;\n}\n\n/**\n * **Client Component**\n *\n * This component is only used to implement the keyboard movement behavior for\n * the `ExpansionPanel` components.\n *\n * @see {@link useExpansionList} for a custom implementation example if you do\n * not want to use a `<div>` for this wrapper component.\n * @remarks \\@since 6.0.0 Uses the new keyboard movement API and does not\n * require the `onKeyDOwn` prop to be provided.\n */\nexport const ExpansionList = forwardRef<HTMLDivElement, ExpansionListProps>(\n  function ExpansionList(props, ref) {\n    const { onClick, onFocus, onKeyDown, children, ...remaining } = props;\n\n    const { movementContext, movementProps } = useExpansionList({\n      onClick,\n      onFocus,\n      onKeyDown,\n    });\n\n    return (\n      <KeyboardMovementProvider value={movementContext}>\n        <div {...remaining} {...movementProps} ref={ref}>\n          {children}\n        </div>\n      </KeyboardMovementProvider>\n    );\n  }\n);\n"],"names":["forwardRef","KeyboardMovementProvider","useExpansionList","ExpansionList","props","ref","onClick","onFocus","onKeyDown","children","remaining","movementContext","movementProps","value","div"],"mappings":"AAAA;;AACA,SAASA,UAAU,QAA6C,QAAQ;AACxE,SAASC,wBAAwB,QAAQ,6CAA6C;AACtF,SAASC,gBAAgB,QAAQ,wBAAwB;AASzD;;;;;;;;;;CAUC,GACD,OAAO,MAAMC,8BAAgBH,WAC3B,SAASG,cAAcC,KAAK,EAAEC,GAAG;IAC/B,MAAM,EAAEC,OAAO,EAAEC,OAAO,EAAEC,SAAS,EAAEC,QAAQ,EAAE,GAAGC,WAAW,GAAGN;IAEhE,MAAM,EAAEO,eAAe,EAAEC,aAAa,EAAE,GAAGV,iBAAiB;QAC1DI;QACAC;QACAC;IACF;IAEA,qBACE,KAACP;QAAyBY,OAAOF;kBAC/B,cAAA,KAACG;YAAK,GAAGJ,SAAS;YAAG,GAAGE,aAAa;YAAEP,KAAKA;sBACzCI;;;AAIT,GACA"}