@react-md/core 1.0.0-next.16 → 1.0.0-next.17

package/dist/draggable/useDraggable.js.map

@@ -1 +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 * @since 6.0.0\n */\nexport type DraggableTouchEventHandlers<E extends HTMLElement> = Pick<\n  HTMLAttributes<E>,\n  \"onTouchStart\" | \"onTouchMove\"\n>;\n\n/**\n * @since 6.0.0\n */\nexport type DraggableMouseEventHandlers<E extends HTMLElement> = Pick<\n  HTMLAttributes<E>,\n  \"onMouseDown\" | \"onMouseUp\" | \"onMouseMove\"\n>;\n\n/**\n * @since 6.0.0\n */\nexport type DraggableKeyboardEventHandlers<E extends HTMLElement> = Pick<\n  HTMLAttributes<E>,\n  \"onKeyDown\"\n>;\n\n/**\n * @since 6.0.0\n */\nexport type DraggableEventHandlers<E extends HTMLElement> =\n  DraggableTouchEventHandlers<E> &\n    DraggableMouseEventHandlers<E> &\n    DraggableKeyboardEventHandlers<E>;\n\n/**\n * @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 * @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 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 * @since 6.0.0\n */\nexport interface UncontrolledDraggableOptions {\n  value?: never;\n  setValue?: never;\n  dragging?: never;\n  setDragging?: never;\n}\n\n/**\n * @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 * @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 * @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 * @since 6.0.0\n */\nexport type DraggableStateOptions =\n  | UncontrolledDraggableOptions\n  | ControlledValueDraggableOptions\n  | ControlledDraggingDraggableOptions\n  | FullyControlledDraggableOptions;\n\n/**\n * @since 6.0.0\n */\nexport type DraggableOptions<E extends HTMLElement = HTMLElement> =\n  BaseDraggableOptions<E> & DraggableStateOptions;\n\n/**\n * @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 * @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  if (\n    prevRange.current.min !== min ||\n    prevRange.current.max !== max ||\n    prevRange.current.step !== step\n  ) {\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  }\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        // don't 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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BACA1B;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"}
+{"version":3,"sources":["../../src/draggable/useDraggable.ts"],"sourcesContent":["\"use client\";\nimport { cnb } from \"cnbuilder\";\nimport {\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n  type HTMLAttributes,\n  type Ref,\n  type RefCallback,\n} from \"react\";\nimport { useUserInteractionMode } from \"../interaction/UserInteractionModeProvider.js\";\nimport { useScrollLock } from \"../scroll/useScrollLock.js\";\nimport {\n  type NonNullRef,\n  type UseStateInitializer,\n  type 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 * @since 6.0.0\n */\nexport type DraggableTouchEventHandlers<E extends HTMLElement> = Pick<\n  HTMLAttributes<E>,\n  \"onTouchStart\" | \"onTouchMove\"\n>;\n\n/**\n * @since 6.0.0\n */\nexport type DraggableMouseEventHandlers<E extends HTMLElement> = Pick<\n  HTMLAttributes<E>,\n  \"onMouseDown\" | \"onMouseUp\" | \"onMouseMove\"\n>;\n\n/**\n * @since 6.0.0\n */\nexport type DraggableKeyboardEventHandlers<E extends HTMLElement> = Pick<\n  HTMLAttributes<E>,\n  \"onKeyDown\"\n>;\n\n/**\n * @since 6.0.0\n */\nexport type DraggableEventHandlers<E extends HTMLElement> =\n  DraggableTouchEventHandlers<E> &\n    DraggableMouseEventHandlers<E> &\n    DraggableKeyboardEventHandlers<E>;\n\n/**\n * @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 * @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 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 * @since 6.0.0\n */\nexport interface UncontrolledDraggableOptions {\n  value?: never;\n  setValue?: never;\n  dragging?: never;\n  setDragging?: never;\n}\n\n/**\n * @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 * @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 * @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 * @since 6.0.0\n */\nexport type DraggableStateOptions =\n  | UncontrolledDraggableOptions\n  | ControlledValueDraggableOptions\n  | ControlledDraggingDraggableOptions\n  | FullyControlledDraggableOptions;\n\n/**\n * @since 6.0.0\n */\nexport type DraggableOptions<E extends HTMLElement = HTMLElement> =\n  BaseDraggableOptions<E> & DraggableStateOptions;\n\n/**\n * @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 * @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  if (\n    prevRange.current.min !== min ||\n    prevRange.current.max !== max ||\n    prevRange.current.step !== step\n  ) {\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  }\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        // don't 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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;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/draggable/utils.d.ts

@@ -49,9 +49,9 @@ interface UpdateDragPositionOptions extends Omit<RelativeDragPositionOptions, "c
     nodeRef: RefObject<HTMLElement>;
     focus?: boolean;
     isDragStart: boolean;
-    setValue(value: number): void;
-    setDragging(dragging: boolean): void;
-    setDragPercentage(value: number): void;
+    setValue: (value: number) => void;
+    setDragging: (dragging: boolean) => void;
+    setDragPercentage: (value: number) => void;
     withinOffsetParent: boolean;
 }
 /**

package/dist/draggable/utils.js.map

@@ -1 +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 * @since 6.0.0\n */\nexport interface DeserializeDraggableValueOptions {\n  min: number;\n  max: number;\n  item: string;\n}\n\n/**\n * @internal\n * @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":"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"}
+{"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 * @since 6.0.0\n */\nexport interface DeserializeDraggableValueOptions {\n  min: number;\n  max: number;\n  item: string;\n}\n\n/**\n * @internal\n * @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":"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"}

package/dist/expansion-panel/ExpansionPanel.d.ts

@@ -20,7 +20,7 @@ export interface ExpansionPanelProps extends CardProps {
      * A function that should toggle the {@link expanded} state. This should
      * generally be provided by the `useExpansionPanels` hook.
      */
-    onExpandClick(): void;
+    onExpandClick: () => void;
     /**
      * Set this to `true` to prevent the panel from toggling the {@link expanded}
      * state. This should generally be provided by the `useExpansionPanels` hook.

package/dist/expansion-panel/ExpansionPanel.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/expansion-panel/ExpansionPanel.tsx"],"sourcesContent":["\"use client\";\nimport { forwardRef, type CSSProperties, type ReactNode } from \"react\";\nimport { Card, type CardProps } from \"../card/Card.js\";\nimport { CardContent, type CardContentProps } from \"../card/CardContent.js\";\nimport { useCollapseTransition } from \"../transition/useCollapseTransition.js\";\nimport { type PropsWithRef } from \"../types.js\";\nimport { useEnsuredId } from \"../useEnsuredId.js\";\nimport {\n  ExpansionPanelHeader,\n  type ExpansionPanelHeaderProps,\n} from \"./ExpansionPanelHeader.js\";\nimport { expansionPanel } from \"./expansionPanelStyles.js\";\n\n/**\n * @since 6.0.0 The `disableSecondaryColor` convenience prop was removed in\n * favor of the new `contentProps` object.\n * @since 6.0.0 The `disableParagraphMargin` prop was removed since it no longer\n * exists on the `CardContent` component.\n * @since 6.0.0 Removed the `marginTop` prop since it is no longer needed.\n */\nexport interface ExpansionPanelProps extends CardProps {\n  /**\n   * Set this to `true` if the {@link children} should be visible. This should\n   * generally be provided by the `useExpansionPanels` hook.\n   */\n  expanded: boolean;\n\n  /**\n   * A function that should toggle the {@link expanded} state. This should\n   * generally be provided by the `useExpansionPanels` hook.\n   */\n  onExpandClick(): void;\n\n  /**\n   * Set this to `true` to prevent the panel from toggling the {@link expanded}\n   * state. This should generally be provided by the `useExpansionPanels` hook.\n   *\n   * @defaultValue `false`\n   */\n  disabled?: boolean;\n\n  /**\n   * @defaultValue `true`\n   * @see {@link CardProps.fullWidth}\n   */\n  fullWidth?: boolean;\n\n  /**\n   * This can be used to implement a custom header implementation, but it\n   * probably shouldn't be needed.\n   *\n   * @since 6.0.0 This was renamed from `customHeader`\n   * @see {@link headerProps}\n   */\n  header?: ReactNode;\n\n  /**\n   * This can be used to apply additional props to the header element.\n   *\n   * Note: You can override the `style` and `className` using\n   * {@link headerStyle} and {@link headerClassName} instead for convenience.\n   *\n   * @example\n   * ```tsx\n   * <ExpansionPanel\n   *   {...props}\n   *   headerProps={{\n   *     style: {\n   *       // custom inline style\n   *     },\n   *     className: \"come-class-name\",\n   *     icon: <MyCustomIcon />,\n   *     iconRotatorProps: {\n   *       className: \"another-custom-class-name\",\n   *     },\n   *   }}\n   * />\n   * ```\n   */\n  headerProps?: Omit<\n    ExpansionPanelHeaderProps,\n    \"id\" | \"aria-disabled\" | \"onClick\" | \"expanded\"\n  >;\n\n  /**\n   * Convenience prop to apply custom style to the `ExpansionPanelHeader`\n   * component.\n   */\n  headerStyle?: CSSProperties;\n\n  /**\n   * Convenience prop to apply custom class name to the `ExpansionPanelHeader`\n   * component.\n   */\n  headerClassName?: string;\n\n  /**\n   * Content to display within the header of the expansion panel that toggles\n   * the expanded state. This should generally contain some accessible text\n   * describing the expansion panel's content.\n   *\n   * @since 6.0.0 This was renamed from `header`\n   */\n  headerChildren?: ReactNode;\n\n  /**\n   * This can be used to apply additional props to the `CardContent` component\n   * if needed.\n   *\n   * Note: `disableSecondaryColor` and `disableLastChildPadding` default to\n   * `true` in this implementation.\n   *\n   * @example\n   * ```tsx\n   * contentProps={{\n   *   style: {},\n   *   className: \"some-class-name\",\n   *   disablePadding: true,\n   *   disableSecondaryColor: false,\n   *   disableLastChildPadding: false,\n   *   // whatever else\n   * }}\n   * ```\n   *\n   * @see {@link contentStyle}\n   * @see {@link contentClassName}\n   * @see {@link disableContentPadding}\n   */\n  contentProps?: PropsWithRef<Omit<CardContentProps, \"role\">, HTMLDivElement>;\n\n  /**\n   * Convenience prop to apply custom style to the `CardContent` component.\n   */\n  contentStyle?: CSSProperties;\n\n  /**\n   * Convenience prop to apply custom class name to the `CardContent` component.\n   */\n  contentClassName?: string;\n\n  /**\n   * Set to `true` to disable the collapse transition for the card content\n   * whenever the {@link expanded} state changes.\n   *\n   * @defaultValue `false`\n   */\n  disableTransition?: boolean;\n\n  /**\n   * @defaultValue `false`\n   * @see {@link CardContentProps.disablePadding}\n   */\n  disableContentPadding?: boolean;\n\n  /**\n   * Set this to `true` to unmount the {@link children} when the\n   * {@link expanded} state is `false`.\n   *\n   * @defaultValue `false`\n   * @since 6.0.0 Renamed from `persistent` to match the\n   * `useCollapseTransition` naming convention.\n   */\n  temporary?: boolean;\n}\n\n/**\n * **Client Component**\n *\n * @see `useExpansionPanels` for examples.\n * @since 6.0.0 The content will be persistent and invisible using `display: none`\n * instead of unmounting and also animate the `margin-top` style.\n */\nexport const ExpansionPanel = forwardRef<\n  HTMLHeadingElement,\n  ExpansionPanelProps\n>(function ExpansionPanel(props, ref) {\n  const {\n    id: propId,\n    className,\n    contentProps,\n    contentStyle,\n    contentClassName,\n    header: propHeader,\n    headerProps,\n    headerStyle,\n    headerClassName,\n    headerChildren,\n    children,\n    expanded,\n    onExpandClick,\n    disabled = false,\n    fullWidth = true,\n    temporary = false,\n    disableTransition = false,\n    disableContentPadding = false,\n    ...remaining\n  } = props;\n\n  const id = useEnsuredId(propId, \"expansion-panel\");\n  const { elementProps, rendered } = useCollapseTransition({\n    nodeRef: contentProps?.ref,\n    style: contentStyle,\n    className: contentClassName,\n    timeout: disableTransition ? 0 : undefined,\n    temporary,\n    transitionIn: expanded,\n  });\n\n  let header = propHeader;\n  if (typeof header === \"undefined\") {\n    header = (\n      <ExpansionPanelHeader\n        style={headerStyle}\n        className={headerClassName}\n        disableTransition={disableTransition}\n        {...headerProps}\n        aria-disabled={disabled || undefined}\n        id={id}\n        onClick={onExpandClick}\n        expanded={expanded}\n      >\n        {headerChildren}\n      </ExpansionPanelHeader>\n    );\n  }\n\n  return (\n    <Card\n      {...remaining}\n      id={`${id}-container`}\n      ref={ref}\n      fullWidth={fullWidth}\n      className={expansionPanel({\n        expanded,\n        disableTransition,\n        className,\n      })}\n    >\n      {header}\n      {rendered && (\n        <CardContent\n          id={`${id}-content`}\n          aria-labelledby={id}\n          disablePadding={disableContentPadding}\n          disableSecondaryColor\n          disableLastChildPadding\n          {...contentProps}\n          {...elementProps}\n          role=\"region\"\n        >\n          {children}\n        </CardContent>\n      )}\n    </Card>\n  );\n});\n"],"names":["forwardRef","Card","CardContent","useCollapseTransition","useEnsuredId","ExpansionPanelHeader","expansionPanel","ExpansionPanel","props","ref","id","propId","className","contentProps","contentStyle","contentClassName","header","propHeader","headerProps","headerStyle","headerClassName","headerChildren","children","expanded","onExpandClick","disabled","fullWidth","temporary","disableTransition","disableContentPadding","remaining","elementProps","rendered","nodeRef","style","timeout","undefined","transitionIn","aria-disabled","onClick","aria-labelledby","disablePadding","disableSecondaryColor","disableLastChildPadding","role"],"mappings":"AAAA;;AACA,SAASA,UAAU,QAA4C,QAAQ;AACvE,SAASC,IAAI,QAAwB,kBAAkB;AACvD,SAASC,WAAW,QAA+B,yBAAyB;AAC5E,SAASC,qBAAqB,QAAQ,yCAAyC;AAE/E,SAASC,YAAY,QAAQ,qBAAqB;AAClD,SACEC,oBAAoB,QAEf,4BAA4B;AACnC,SAASC,cAAc,QAAQ,4BAA4B;AA0J3D;;;;;;CAMC,GACD,OAAO,MAAMC,+BAAiBP,WAG5B,SAASO,eAAeC,KAAK,EAAEC,GAAG;IAClC,MAAM,EACJC,IAAIC,MAAM,EACVC,SAAS,EACTC,YAAY,EACZC,YAAY,EACZC,gBAAgB,EAChBC,QAAQC,UAAU,EAClBC,WAAW,EACXC,WAAW,EACXC,eAAe,EACfC,cAAc,EACdC,QAAQ,EACRC,QAAQ,EACRC,aAAa,EACbC,WAAW,KAAK,EAChBC,YAAY,IAAI,EAChBC,YAAY,KAAK,EACjBC,oBAAoB,KAAK,EACzBC,wBAAwB,KAAK,EAC7B,GAAGC,WACJ,GAAGtB;IAEJ,MAAME,KAAKN,aAAaO,QAAQ;IAChC,MAAM,EAAEoB,YAAY,EAAEC,QAAQ,EAAE,GAAG7B,sBAAsB;QACvD8B,SAASpB,cAAcJ;QACvByB,OAAOpB;QACPF,WAAWG;QACXoB,SAASP,oBAAoB,IAAIQ;QACjCT;QACAU,cAAcd;IAChB;IAEA,IAAIP,SAASC;IACb,IAAI,OAAOD,WAAW,aAAa;QACjCA,uBACE,KAACX;YACC6B,OAAOf;YACPP,WAAWQ;YACXQ,mBAAmBA;YAClB,GAAGV,WAAW;YACfoB,iBAAeb,YAAYW;YAC3B1B,IAAIA;YACJ6B,SAASf;YACTD,UAAUA;sBAETF;;IAGP;IAEA,qBACE,MAACpB;QACE,GAAG6B,SAAS;QACbpB,IAAI,CAAC,EAAEA,GAAG,UAAU,CAAC;QACrBD,KAAKA;QACLiB,WAAWA;QACXd,WAAWN,eAAe;YACxBiB;YACAK;YACAhB;QACF;;YAECI;YACAgB,0BACC,KAAC9B;gBACCQ,IAAI,CAAC,EAAEA,GAAG,QAAQ,CAAC;gBACnB8B,mBAAiB9B;gBACjB+B,gBAAgBZ;gBAChBa,qBAAqB;gBACrBC,uBAAuB;gBACtB,GAAG9B,YAAY;gBACf,GAAGkB,YAAY;gBAChBa,MAAK;0BAEJtB;;;;AAKX,GAAG"}
+{"version":3,"sources":["../../src/expansion-panel/ExpansionPanel.tsx"],"sourcesContent":["\"use client\";\nimport { forwardRef, type CSSProperties, type ReactNode } from \"react\";\nimport { Card, type CardProps } from \"../card/Card.js\";\nimport { CardContent, type CardContentProps } from \"../card/CardContent.js\";\nimport { useCollapseTransition } from \"../transition/useCollapseTransition.js\";\nimport { type PropsWithRef } from \"../types.js\";\nimport { useEnsuredId } from \"../useEnsuredId.js\";\nimport {\n  ExpansionPanelHeader,\n  type ExpansionPanelHeaderProps,\n} from \"./ExpansionPanelHeader.js\";\nimport { expansionPanel } from \"./expansionPanelStyles.js\";\n\n/**\n * @since 6.0.0 The `disableSecondaryColor` convenience prop was removed in\n * favor of the new `contentProps` object.\n * @since 6.0.0 The `disableParagraphMargin` prop was removed since it no longer\n * exists on the `CardContent` component.\n * @since 6.0.0 Removed the `marginTop` prop since it is no longer needed.\n */\nexport interface ExpansionPanelProps extends CardProps {\n  /**\n   * Set this to `true` if the {@link children} should be visible. This should\n   * generally be provided by the `useExpansionPanels` hook.\n   */\n  expanded: boolean;\n\n  /**\n   * A function that should toggle the {@link expanded} state. This should\n   * generally be provided by the `useExpansionPanels` hook.\n   */\n  onExpandClick: () => void;\n\n  /**\n   * Set this to `true` to prevent the panel from toggling the {@link expanded}\n   * state. This should generally be provided by the `useExpansionPanels` hook.\n   *\n   * @defaultValue `false`\n   */\n  disabled?: boolean;\n\n  /**\n   * @defaultValue `true`\n   * @see {@link CardProps.fullWidth}\n   */\n  fullWidth?: boolean;\n\n  /**\n   * This can be used to implement a custom header implementation, but it\n   * probably shouldn't be needed.\n   *\n   * @since 6.0.0 This was renamed from `customHeader`\n   * @see {@link headerProps}\n   */\n  header?: ReactNode;\n\n  /**\n   * This can be used to apply additional props to the header element.\n   *\n   * Note: You can override the `style` and `className` using\n   * {@link headerStyle} and {@link headerClassName} instead for convenience.\n   *\n   * @example\n   * ```tsx\n   * <ExpansionPanel\n   *   {...props}\n   *   headerProps={{\n   *     style: {\n   *       // custom inline style\n   *     },\n   *     className: \"come-class-name\",\n   *     icon: <MyCustomIcon />,\n   *     iconRotatorProps: {\n   *       className: \"another-custom-class-name\",\n   *     },\n   *   }}\n   * />\n   * ```\n   */\n  headerProps?: Omit<\n    ExpansionPanelHeaderProps,\n    \"id\" | \"aria-disabled\" | \"onClick\" | \"expanded\"\n  >;\n\n  /**\n   * Convenience prop to apply custom style to the `ExpansionPanelHeader`\n   * component.\n   */\n  headerStyle?: CSSProperties;\n\n  /**\n   * Convenience prop to apply custom class name to the `ExpansionPanelHeader`\n   * component.\n   */\n  headerClassName?: string;\n\n  /**\n   * Content to display within the header of the expansion panel that toggles\n   * the expanded state. This should generally contain some accessible text\n   * describing the expansion panel's content.\n   *\n   * @since 6.0.0 This was renamed from `header`\n   */\n  headerChildren?: ReactNode;\n\n  /**\n   * This can be used to apply additional props to the `CardContent` component\n   * if needed.\n   *\n   * Note: `disableSecondaryColor` and `disableLastChildPadding` default to\n   * `true` in this implementation.\n   *\n   * @example\n   * ```tsx\n   * contentProps={{\n   *   style: {},\n   *   className: \"some-class-name\",\n   *   disablePadding: true,\n   *   disableSecondaryColor: false,\n   *   disableLastChildPadding: false,\n   *   // whatever else\n   * }}\n   * ```\n   *\n   * @see {@link contentStyle}\n   * @see {@link contentClassName}\n   * @see {@link disableContentPadding}\n   */\n  contentProps?: PropsWithRef<Omit<CardContentProps, \"role\">, HTMLDivElement>;\n\n  /**\n   * Convenience prop to apply custom style to the `CardContent` component.\n   */\n  contentStyle?: CSSProperties;\n\n  /**\n   * Convenience prop to apply custom class name to the `CardContent` component.\n   */\n  contentClassName?: string;\n\n  /**\n   * Set to `true` to disable the collapse transition for the card content\n   * whenever the {@link expanded} state changes.\n   *\n   * @defaultValue `false`\n   */\n  disableTransition?: boolean;\n\n  /**\n   * @defaultValue `false`\n   * @see {@link CardContentProps.disablePadding}\n   */\n  disableContentPadding?: boolean;\n\n  /**\n   * Set this to `true` to unmount the {@link children} when the\n   * {@link expanded} state is `false`.\n   *\n   * @defaultValue `false`\n   * @since 6.0.0 Renamed from `persistent` to match the\n   * `useCollapseTransition` naming convention.\n   */\n  temporary?: boolean;\n}\n\n/**\n * **Client Component**\n *\n * @see `useExpansionPanels` for examples.\n * @since 6.0.0 The content will be persistent and invisible using `display: none`\n * instead of unmounting and also animate the `margin-top` style.\n */\nexport const ExpansionPanel = forwardRef<\n  HTMLHeadingElement,\n  ExpansionPanelProps\n>(function ExpansionPanel(props, ref) {\n  const {\n    id: propId,\n    className,\n    contentProps,\n    contentStyle,\n    contentClassName,\n    header: propHeader,\n    headerProps,\n    headerStyle,\n    headerClassName,\n    headerChildren,\n    children,\n    expanded,\n    onExpandClick,\n    disabled = false,\n    fullWidth = true,\n    temporary = false,\n    disableTransition = false,\n    disableContentPadding = false,\n    ...remaining\n  } = props;\n\n  const id = useEnsuredId(propId, \"expansion-panel\");\n  const { elementProps, rendered } = useCollapseTransition({\n    nodeRef: contentProps?.ref,\n    style: contentStyle,\n    className: contentClassName,\n    timeout: disableTransition ? 0 : undefined,\n    temporary,\n    transitionIn: expanded,\n  });\n\n  let header = propHeader;\n  if (typeof header === \"undefined\") {\n    header = (\n      <ExpansionPanelHeader\n        style={headerStyle}\n        className={headerClassName}\n        disableTransition={disableTransition}\n        {...headerProps}\n        aria-disabled={disabled || undefined}\n        id={id}\n        onClick={onExpandClick}\n        expanded={expanded}\n      >\n        {headerChildren}\n      </ExpansionPanelHeader>\n    );\n  }\n\n  return (\n    <Card\n      {...remaining}\n      id={`${id}-container`}\n      ref={ref}\n      fullWidth={fullWidth}\n      className={expansionPanel({\n        expanded,\n        disableTransition,\n        className,\n      })}\n    >\n      {header}\n      {rendered && (\n        <CardContent\n          id={`${id}-content`}\n          aria-labelledby={id}\n          disablePadding={disableContentPadding}\n          disableSecondaryColor\n          disableLastChildPadding\n          {...contentProps}\n          {...elementProps}\n          role=\"region\"\n        >\n          {children}\n        </CardContent>\n      )}\n    </Card>\n  );\n});\n"],"names":["forwardRef","Card","CardContent","useCollapseTransition","useEnsuredId","ExpansionPanelHeader","expansionPanel","ExpansionPanel","props","ref","id","propId","className","contentProps","contentStyle","contentClassName","header","propHeader","headerProps","headerStyle","headerClassName","headerChildren","children","expanded","onExpandClick","disabled","fullWidth","temporary","disableTransition","disableContentPadding","remaining","elementProps","rendered","nodeRef","style","timeout","undefined","transitionIn","aria-disabled","onClick","aria-labelledby","disablePadding","disableSecondaryColor","disableLastChildPadding","role"],"mappings":"AAAA;;AACA,SAASA,UAAU,QAA4C,QAAQ;AACvE,SAASC,IAAI,QAAwB,kBAAkB;AACvD,SAASC,WAAW,QAA+B,yBAAyB;AAC5E,SAASC,qBAAqB,QAAQ,yCAAyC;AAE/E,SAASC,YAAY,QAAQ,qBAAqB;AAClD,SACEC,oBAAoB,QAEf,4BAA4B;AACnC,SAASC,cAAc,QAAQ,4BAA4B;AA0J3D;;;;;;CAMC,GACD,OAAO,MAAMC,+BAAiBP,WAG5B,SAASO,eAAeC,KAAK,EAAEC,GAAG;IAClC,MAAM,EACJC,IAAIC,MAAM,EACVC,SAAS,EACTC,YAAY,EACZC,YAAY,EACZC,gBAAgB,EAChBC,QAAQC,UAAU,EAClBC,WAAW,EACXC,WAAW,EACXC,eAAe,EACfC,cAAc,EACdC,QAAQ,EACRC,QAAQ,EACRC,aAAa,EACbC,WAAW,KAAK,EAChBC,YAAY,IAAI,EAChBC,YAAY,KAAK,EACjBC,oBAAoB,KAAK,EACzBC,wBAAwB,KAAK,EAC7B,GAAGC,WACJ,GAAGtB;IAEJ,MAAME,KAAKN,aAAaO,QAAQ;IAChC,MAAM,EAAEoB,YAAY,EAAEC,QAAQ,EAAE,GAAG7B,sBAAsB;QACvD8B,SAASpB,cAAcJ;QACvByB,OAAOpB;QACPF,WAAWG;QACXoB,SAASP,oBAAoB,IAAIQ;QACjCT;QACAU,cAAcd;IAChB;IAEA,IAAIP,SAASC;IACb,IAAI,OAAOD,WAAW,aAAa;QACjCA,uBACE,KAACX;YACC6B,OAAOf;YACPP,WAAWQ;YACXQ,mBAAmBA;YAClB,GAAGV,WAAW;YACfoB,iBAAeb,YAAYW;YAC3B1B,IAAIA;YACJ6B,SAASf;YACTD,UAAUA;sBAETF;;IAGP;IAEA,qBACE,MAACpB;QACE,GAAG6B,SAAS;QACbpB,IAAI,GAAGA,GAAG,UAAU,CAAC;QACrBD,KAAKA;QACLiB,WAAWA;QACXd,WAAWN,eAAe;YACxBiB;YACAK;YACAhB;QACF;;YAECI;YACAgB,0BACC,KAAC9B;gBACCQ,IAAI,GAAGA,GAAG,QAAQ,CAAC;gBACnB8B,mBAAiB9B;gBACjB+B,gBAAgBZ;gBAChBa,qBAAqB;gBACrBC,uBAAuB;gBACtB,GAAG9B,YAAY;gBACf,GAAGkB,YAAY;gBAChBa,MAAK;0BAEJtB;;;;AAKX,GAAG"}

package/dist/expansion-panel/_expansion-panel.scss

@@ -72,7 +72,6 @@ $box-shadow-overlay-bottom: -6px !default;
         @if button.$disable-unstyled-utility-class {
           @include button.unstyled;
         }
-        @include utils.auto-rtl(text-align, left);
 
         align-items: center;
         color: inherit;
@@ -81,6 +80,7 @@ $box-shadow-overlay-bottom: -6px !default;
         justify-content: space-between;
         letter-spacing: inherit;
         padding: $padding;
+        text-align: left;
         width: 100%;
 
         &[aria-disabled="true"] {
@@ -101,6 +101,10 @@ $box-shadow-overlay-bottom: -6px !default;
             }
           }
         }
+
+        @include utils.rtl {
+          text-align: right;
+        }
       }
     }
   }

package/dist/expansion-panel/useExpansionPanels.js

@@ -1,6 +1,6 @@
 "use client";
-import { useState } from "react";
 import { useEnsuredId } from "../useEnsuredId.js";
+import { useReadonlySet } from "../useReadonlySet.js";
 /**
  * Use this hook to control the expanded state for a group of `ExpansionPanel`.
  *
@@ -80,16 +80,18 @@ import { useEnsuredId } from "../useEnsuredId.js";
     const { baseId: propBaseId, multiple = false, preventAllCollapsed = false, disableTransition = false, defaultExpandedIds, defaultExpandedIndex, disableContentPadding = false } = options;
     const baseId = useEnsuredId(propBaseId, "expansion-panel");
     const createId = (index)=>`${baseId}-${index + 1}`;
-    const [expandedIds, setExpandedIds] = useState(()=>{
-        if (typeof defaultExpandedIds === "undefined") {
-            const initialList = [];
-            if (typeof defaultExpandedIndex === "number" || preventAllCollapsed) {
-                initialList.push(createId(defaultExpandedIndex ?? 0));
+    const { value: expandedIds, setValue: setExpandedIds, toggleValue } = useReadonlySet({
+        toggleType: multiple ? "multiple" : "single",
+        defaultValue: ()=>{
+            if (typeof defaultExpandedIds === "undefined") {
+                const initialList = [];
+                if (typeof defaultExpandedIndex === "number" || preventAllCollapsed) {
+                    initialList.push(createId(defaultExpandedIndex ?? 0));
+                }
+                return new Set(initialList);
             }
-            return new Set(initialList);
+            return typeof defaultExpandedIds === "function" ? defaultExpandedIds() : defaultExpandedIds;
         }
-        const ids = typeof defaultExpandedIds === "function" ? defaultExpandedIds() : defaultExpandedIds;
-        return new Set(ids);
     });
     return {
         expandedIds,
@@ -113,21 +115,7 @@ import { useEnsuredId } from "../useEnsuredId.js";
                     if (disabled) {
                         return;
                     }
-                    setExpandedIds((prevIds)=>{
-                        const expanded = prevIds.has(panelId);
-                        if (!multiple) {
-                            return new Set(expanded ? [] : [
-                                panelId
-                            ]);
-                        }
-                        const nextIds = new Set(prevIds);
-                        if (expanded) {
-                            nextIds.delete(panelId);
-                        } else {
-                            nextIds.add(panelId);
-                        }
-                        return nextIds;
-                    });
+                    toggleValue(panelId);
                 },
                 disableTransition,
                 disableContentPadding

package/dist/expansion-panel/useExpansionPanels.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/expansion-panel/useExpansionPanels.ts"],"sourcesContent":["\"use client\";\nimport { useState } from \"react\";\nimport type { UseStateInitializer, UseStateSetter } from \"../types.js\";\nimport { useEnsuredId } from \"../useEnsuredId.js\";\nimport type { ExpansionPanelProps } from \"./ExpansionPanel.js\";\n\n/** @since 6.0.0 */\nexport interface ExpansionPanelHookOptions {\n  /**\n   * An optional id to prefix each panel with.\n   *\n   * @defaultValue `\"expansion-panel-\" + useId()`\n   */\n  baseId?: string;\n\n  /**\n   * Set this to `true` if multiple panels can be open at the same time.\n   *\n   * @defaultValue `false`\n   */\n  multiple?: boolean;\n\n  /**\n   * Set this to `true` to enforce that at least one panel must always be\n   * expanded.\n   *\n   * @defaultValue `false`\n   */\n  preventAllCollapsed?: boolean;\n\n  /**\n   * This is a convenience option to disable the expansion transition for all\n   * panels.\n   *\n   * @defaultValue `false`\n   */\n  disableTransition?: boolean;\n\n  /**\n   * @defaultValue `preventAllCollapsed ? [\"expansion-panel-\" + useId() + \"-1\"] : []`\n   */\n  defaultExpandedIds?: UseStateInitializer<string[]>;\n\n  /**\n   * This can only be used if the {@link defaultExpandedIds} was not provided\n   * and using index based panels.\n   *\n   * @example\n   * ```tsx\n   * const { getPanelProps } = useExpansionPanels({\n   *   defaultExpandedIndex: 2,\n   * });\n   *\n   * return (\n   *   <ExpansionPanel {...getPanelProps(0)} />\n   *   <ExpansionPanel {...getPanelProps(1)} />\n   *   // expanded on first render\n   *   <ExpansionPanel {...getPanelProps(2)} />\n   *   <ExpansionPanel {...getPanelProps(3)} />\n   * );\n   * ```\n   */\n  defaultExpandedIndex?: number;\n\n  /**\n   * @defaultValue `false`\n   */\n  disableContentPadding?: boolean;\n}\n\n/** @since 6.0.0 */\nexport type ProvidedExpansionPanelProps = Pick<\n  Required<ExpansionPanelProps>,\n  | \"disabled\"\n  | \"expanded\"\n  | \"onExpandClick\"\n  | \"disableTransition\"\n  | \"disableContentPadding\"\n> & { id?: string };\n\n/**\n * @param indexOrPanelId - This should either be a DOM id to use for the panel\n * or the panel's index.\n * @returns Props to pass to an `ExpansionPanel` for it to work correctly.\n * @since 6.0.0\n */\nexport type GetExpansionPanelProps = (\n  indexOrPanelId: string | number\n) => ProvidedExpansionPanelProps;\n\n/** @since 6.0.0 */\nexport interface ExpansionPanelImplementation {\n  /**\n   * The current set of expanded panel ids if you need this for some reason.\n   */\n  expandedIds: ReadonlySet<string>;\n\n  /**\n   * This can be used to manually control which panels are expanded if the\n   * default behavior does not work for your use case.\n   */\n  setExpandedIds: UseStateSetter<ReadonlySet<string>>;\n\n  /**\n   * @example Index Based Panels\n   * ```tsx\n   * <ExpansionPanel {...getPanelProps(0)} />\n   * <ExpansionPanel {...getPanelProps(1)} />\n   * <ExpansionPanel {...getPanelProps(2)} />\n   * ```\n   *\n   * @example Custom Panel Ids\n   * ```tsx\n   * <ExpansionPanel {...getPanelProps(\"address-panel\")} />\n   * <ExpansionPanel {...getPanelProps(\"billing-panel\")} />\n   * <ExpansionPanel {...getPanelProps(\"confirmation-panel\")} />\n   * ```\n   */\n  getPanelProps: GetExpansionPanelProps;\n}\n\n/**\n * Use this hook to control the expanded state for a group of `ExpansionPanel`.\n *\n * @example Index Based Panels\n * ```tsx\n * import {\n *   ExpansionList,\n *   ExpansionPanel,\n *   useExpansionPanels,\n * } from \"@react-md/core\";\n * import { type ReactElement } from \"react\";\n *\n * function Example(): ReactElement {\n *   const { getPanelProps } = useExpansionPanels();\n *\n *   return (\n *     <ExpansionList>\n *       <ExpansionPanel {...getPanelProps(0)} headerChildren=\"Panel 1\">\n *         Panel 1 Contents\n *       </ExpansionPanel>\n *       <ExpansionPanel {...getPanelProps(1)} headerChildren=\"Panel 2\">\n *         Panel 2 Contents\n *       </ExpansionPanel>\n *       <ExpansionPanel {...getPanelProps(2)} headerChildren=\"Panel 3\">\n *         Panel 3 Contents\n *       </ExpansionPanel>\n *     </ExpansionList>\n *   );\n * }\n * ```\n *\n * @example Custom Panel Ids and Expand All Panels by Default\n * ```tsx\n * import {\n *   ExpansionList,\n *   ExpansionPanel,\n *   useExpansionPanels,\n * } from \"@react-md/core\";\n * import { type ReactElement } from \"react\";\n *\n * import { BillingAddress } from \"./BillingAddress\";\n * import { BillingInformation } from \"./BillingInformation\";\n * import { PersonalInformation } from \"./PersonalInformation\";\n *\n * const panel1Id = \"personal-information-panel\";\n * const panel2Id = \"billing-information-panel\";\n * const panel3Id = \"billing-address-panel\";\n *\n * function Example(): ReactElement {\n *   const { getPanelProps } = useExpansionPanels({\n *     multiple: true,\n *     defaultExpandedIds: () => [panel1Id, panel2Id, panel3Id],\n *   });\n *\n *   return (\n *     <ExpansionList>\n *       <ExpansionPanel {...getPanelProps(panel1Id)} headerChildren=\"Personal Information\">\n *         <PersonalInformation />\n *       </ExpansionPanel>\n *       <ExpansionPanel {...getPanelProps(panel2Id)} headerChildren=\"Billing Information\">\n *         <BillingInformation />\n *       </ExpansionPanel>\n *       <ExpansionPanel {...getPanelProps(panel3Id)} headerChildren=\"Billing Address\">\n *         <BillingAddress />\n *       </ExpansionPanel>\n *     </ExpansionList>\n *   );\n * }\n * ```\n *\n *\n * @since 6.0.0 The hook was renamed from `usePanels` to `useExpansionPanels`,\n * the API changed to return `getPanelProps` instead of a generated list of\n * panel props based on the provided `count`, and the hook no longer supports\n * having all panels expanded by default.\n */\nexport function useExpansionPanels(\n  options: ExpansionPanelHookOptions = {}\n): ExpansionPanelImplementation {\n  const {\n    baseId: propBaseId,\n    multiple = false,\n    preventAllCollapsed = false,\n    disableTransition = false,\n    defaultExpandedIds,\n    defaultExpandedIndex,\n    disableContentPadding = false,\n  } = options;\n\n  const baseId = useEnsuredId(propBaseId, \"expansion-panel\");\n  const createId = (index: number): string => `${baseId}-${index + 1}`;\n  const [expandedIds, setExpandedIds] = useState<ReadonlySet<string>>(() => {\n    if (typeof defaultExpandedIds === \"undefined\") {\n      const initialList: string[] = [];\n      if (typeof defaultExpandedIndex === \"number\" || preventAllCollapsed) {\n        initialList.push(createId(defaultExpandedIndex ?? 0));\n      }\n\n      return new Set(initialList);\n    }\n\n    const ids =\n      typeof defaultExpandedIds === \"function\"\n        ? defaultExpandedIds()\n        : defaultExpandedIds;\n    return new Set(ids);\n  });\n\n  return {\n    expandedIds,\n    setExpandedIds,\n    getPanelProps(indexOrPanelId) {\n      let id: string | undefined;\n      let panelId: string;\n      if (typeof indexOrPanelId === \"number\") {\n        id = createId(indexOrPanelId);\n        panelId = id;\n      } else {\n        panelId = indexOrPanelId;\n      }\n\n      const expanded = expandedIds.has(panelId);\n      const disabled =\n        expanded && preventAllCollapsed && expandedIds.size === 1;\n      return {\n        id,\n        disabled,\n        expanded,\n        onExpandClick() {\n          if (disabled) {\n            return;\n          }\n\n          setExpandedIds((prevIds) => {\n            const expanded = prevIds.has(panelId);\n            if (!multiple) {\n              return new Set(expanded ? [] : [panelId]);\n            }\n\n            const nextIds = new Set(prevIds);\n            if (expanded) {\n              nextIds.delete(panelId);\n            } else {\n              nextIds.add(panelId);\n            }\n\n            return nextIds;\n          });\n        },\n        disableTransition,\n        disableContentPadding,\n      };\n    },\n  };\n}\n"],"names":["useState","useEnsuredId","useExpansionPanels","options","baseId","propBaseId","multiple","preventAllCollapsed","disableTransition","defaultExpandedIds","defaultExpandedIndex","disableContentPadding","createId","index","expandedIds","setExpandedIds","initialList","push","Set","ids","getPanelProps","indexOrPanelId","id","panelId","expanded","has","disabled","size","onExpandClick","prevIds","nextIds","delete","add"],"mappings":"AAAA;AACA,SAASA,QAAQ,QAAQ,QAAQ;AAEjC,SAASC,YAAY,QAAQ,qBAAqB;AAsHlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2EC,GACD,OAAO,SAASC,mBACdC,UAAqC,CAAC,CAAC;IAEvC,MAAM,EACJC,QAAQC,UAAU,EAClBC,WAAW,KAAK,EAChBC,sBAAsB,KAAK,EAC3BC,oBAAoB,KAAK,EACzBC,kBAAkB,EAClBC,oBAAoB,EACpBC,wBAAwB,KAAK,EAC9B,GAAGR;IAEJ,MAAMC,SAASH,aAAaI,YAAY;IACxC,MAAMO,WAAW,CAACC,QAA0B,CAAC,EAAET,OAAO,CAAC,EAAES,QAAQ,EAAE,CAAC;IACpE,MAAM,CAACC,aAAaC,eAAe,GAAGf,SAA8B;QAClE,IAAI,OAAOS,uBAAuB,aAAa;YAC7C,MAAMO,cAAwB,EAAE;YAChC,IAAI,OAAON,yBAAyB,YAAYH,qBAAqB;gBACnES,YAAYC,IAAI,CAACL,SAASF,wBAAwB;YACpD;YAEA,OAAO,IAAIQ,IAAIF;QACjB;QAEA,MAAMG,MACJ,OAAOV,uBAAuB,aAC1BA,uBACAA;QACN,OAAO,IAAIS,IAAIC;IACjB;IAEA,OAAO;QACLL;QACAC;QACAK,eAAcC,cAAc;YAC1B,IAAIC;YACJ,IAAIC;YACJ,IAAI,OAAOF,mBAAmB,UAAU;gBACtCC,KAAKV,SAASS;gBACdE,UAAUD;YACZ,OAAO;gBACLC,UAAUF;YACZ;YAEA,MAAMG,WAAWV,YAAYW,GAAG,CAACF;YACjC,MAAMG,WACJF,YAAYjB,uBAAuBO,YAAYa,IAAI,KAAK;YAC1D,OAAO;gBACLL;gBACAI;gBACAF;gBACAI;oBACE,IAAIF,UAAU;wBACZ;oBACF;oBAEAX,eAAe,CAACc;wBACd,MAAML,WAAWK,QAAQJ,GAAG,CAACF;wBAC7B,IAAI,CAACjB,UAAU;4BACb,OAAO,IAAIY,IAAIM,WAAW,EAAE,GAAG;gCAACD;6BAAQ;wBAC1C;wBAEA,MAAMO,UAAU,IAAIZ,IAAIW;wBACxB,IAAIL,UAAU;4BACZM,QAAQC,MAAM,CAACR;wBACjB,OAAO;4BACLO,QAAQE,GAAG,CAACT;wBACd;wBAEA,OAAOO;oBACT;gBACF;gBACAtB;gBACAG;YACF;QACF;IACF;AACF"}
+{"version":3,"sources":["../../src/expansion-panel/useExpansionPanels.ts"],"sourcesContent":["\"use client\";\nimport type { UseStateInitializer, UseStateSetter } from \"../types.js\";\nimport { useEnsuredId } from \"../useEnsuredId.js\";\nimport { useReadonlySet } from \"../useReadonlySet.js\";\nimport type { ExpansionPanelProps } from \"./ExpansionPanel.js\";\n\n/** @since 6.0.0 */\nexport interface ExpansionPanelHookOptions {\n  /**\n   * An optional id to prefix each panel with.\n   *\n   * @defaultValue `\"expansion-panel-\" + useId()`\n   */\n  baseId?: string;\n\n  /**\n   * Set this to `true` if multiple panels can be open at the same time.\n   *\n   * @defaultValue `false`\n   */\n  multiple?: boolean;\n\n  /**\n   * Set this to `true` to enforce that at least one panel must always be\n   * expanded.\n   *\n   * @defaultValue `false`\n   */\n  preventAllCollapsed?: boolean;\n\n  /**\n   * This is a convenience option to disable the expansion transition for all\n   * panels.\n   *\n   * @defaultValue `false`\n   */\n  disableTransition?: boolean;\n\n  /**\n   * @defaultValue `preventAllCollapsed ? [\"expansion-panel-\" + useId() + \"-1\"] : []`\n   */\n  defaultExpandedIds?: UseStateInitializer<string[]>;\n\n  /**\n   * This can only be used if the {@link defaultExpandedIds} was not provided\n   * and using index based panels.\n   *\n   * @example\n   * ```tsx\n   * const { getPanelProps } = useExpansionPanels({\n   *   defaultExpandedIndex: 2,\n   * });\n   *\n   * return (\n   *   <ExpansionPanel {...getPanelProps(0)} />\n   *   <ExpansionPanel {...getPanelProps(1)} />\n   *   // expanded on first render\n   *   <ExpansionPanel {...getPanelProps(2)} />\n   *   <ExpansionPanel {...getPanelProps(3)} />\n   * );\n   * ```\n   */\n  defaultExpandedIndex?: number;\n\n  /**\n   * @defaultValue `false`\n   */\n  disableContentPadding?: boolean;\n}\n\n/** @since 6.0.0 */\nexport type ProvidedExpansionPanelProps = Pick<\n  Required<ExpansionPanelProps>,\n  | \"disabled\"\n  | \"expanded\"\n  | \"onExpandClick\"\n  | \"disableTransition\"\n  | \"disableContentPadding\"\n> & { id?: string };\n\n/**\n * @param indexOrPanelId - This should either be a DOM id to use for the panel\n * or the panel's index.\n * @returns Props to pass to an `ExpansionPanel` for it to work correctly.\n * @since 6.0.0\n */\nexport type GetExpansionPanelProps = (\n  indexOrPanelId: string | number\n) => ProvidedExpansionPanelProps;\n\n/** @since 6.0.0 */\nexport interface ExpansionPanelImplementation {\n  /**\n   * The current set of expanded panel ids if you need this for some reason.\n   */\n  expandedIds: ReadonlySet<string>;\n\n  /**\n   * This can be used to manually control which panels are expanded if the\n   * default behavior does not work for your use case.\n   */\n  setExpandedIds: UseStateSetter<ReadonlySet<string>>;\n\n  /**\n   * @example Index Based Panels\n   * ```tsx\n   * <ExpansionPanel {...getPanelProps(0)} />\n   * <ExpansionPanel {...getPanelProps(1)} />\n   * <ExpansionPanel {...getPanelProps(2)} />\n   * ```\n   *\n   * @example Custom Panel Ids\n   * ```tsx\n   * <ExpansionPanel {...getPanelProps(\"address-panel\")} />\n   * <ExpansionPanel {...getPanelProps(\"billing-panel\")} />\n   * <ExpansionPanel {...getPanelProps(\"confirmation-panel\")} />\n   * ```\n   */\n  getPanelProps: GetExpansionPanelProps;\n}\n\n/**\n * Use this hook to control the expanded state for a group of `ExpansionPanel`.\n *\n * @example Index Based Panels\n * ```tsx\n * import {\n *   ExpansionList,\n *   ExpansionPanel,\n *   useExpansionPanels,\n * } from \"@react-md/core\";\n * import { type ReactElement } from \"react\";\n *\n * function Example(): ReactElement {\n *   const { getPanelProps } = useExpansionPanels();\n *\n *   return (\n *     <ExpansionList>\n *       <ExpansionPanel {...getPanelProps(0)} headerChildren=\"Panel 1\">\n *         Panel 1 Contents\n *       </ExpansionPanel>\n *       <ExpansionPanel {...getPanelProps(1)} headerChildren=\"Panel 2\">\n *         Panel 2 Contents\n *       </ExpansionPanel>\n *       <ExpansionPanel {...getPanelProps(2)} headerChildren=\"Panel 3\">\n *         Panel 3 Contents\n *       </ExpansionPanel>\n *     </ExpansionList>\n *   );\n * }\n * ```\n *\n * @example Custom Panel Ids and Expand All Panels by Default\n * ```tsx\n * import {\n *   ExpansionList,\n *   ExpansionPanel,\n *   useExpansionPanels,\n * } from \"@react-md/core\";\n * import { type ReactElement } from \"react\";\n *\n * import { BillingAddress } from \"./BillingAddress\";\n * import { BillingInformation } from \"./BillingInformation\";\n * import { PersonalInformation } from \"./PersonalInformation\";\n *\n * const panel1Id = \"personal-information-panel\";\n * const panel2Id = \"billing-information-panel\";\n * const panel3Id = \"billing-address-panel\";\n *\n * function Example(): ReactElement {\n *   const { getPanelProps } = useExpansionPanels({\n *     multiple: true,\n *     defaultExpandedIds: () => [panel1Id, panel2Id, panel3Id],\n *   });\n *\n *   return (\n *     <ExpansionList>\n *       <ExpansionPanel {...getPanelProps(panel1Id)} headerChildren=\"Personal Information\">\n *         <PersonalInformation />\n *       </ExpansionPanel>\n *       <ExpansionPanel {...getPanelProps(panel2Id)} headerChildren=\"Billing Information\">\n *         <BillingInformation />\n *       </ExpansionPanel>\n *       <ExpansionPanel {...getPanelProps(panel3Id)} headerChildren=\"Billing Address\">\n *         <BillingAddress />\n *       </ExpansionPanel>\n *     </ExpansionList>\n *   );\n * }\n * ```\n *\n *\n * @since 6.0.0 The hook was renamed from `usePanels` to `useExpansionPanels`,\n * the API changed to return `getPanelProps` instead of a generated list of\n * panel props based on the provided `count`, and the hook no longer supports\n * having all panels expanded by default.\n */\nexport function useExpansionPanels(\n  options: ExpansionPanelHookOptions = {}\n): ExpansionPanelImplementation {\n  const {\n    baseId: propBaseId,\n    multiple = false,\n    preventAllCollapsed = false,\n    disableTransition = false,\n    defaultExpandedIds,\n    defaultExpandedIndex,\n    disableContentPadding = false,\n  } = options;\n\n  const baseId = useEnsuredId(propBaseId, \"expansion-panel\");\n  const createId = (index: number): string => `${baseId}-${index + 1}`;\n  const {\n    value: expandedIds,\n    setValue: setExpandedIds,\n    toggleValue,\n  } = useReadonlySet({\n    toggleType: multiple ? \"multiple\" : \"single\",\n    defaultValue: () => {\n      if (typeof defaultExpandedIds === \"undefined\") {\n        const initialList: string[] = [];\n        if (typeof defaultExpandedIndex === \"number\" || preventAllCollapsed) {\n          initialList.push(createId(defaultExpandedIndex ?? 0));\n        }\n\n        return new Set(initialList);\n      }\n\n      return typeof defaultExpandedIds === \"function\"\n        ? defaultExpandedIds()\n        : defaultExpandedIds;\n    },\n  });\n\n  return {\n    expandedIds,\n    setExpandedIds,\n    getPanelProps(indexOrPanelId) {\n      let id: string | undefined;\n      let panelId: string;\n      if (typeof indexOrPanelId === \"number\") {\n        id = createId(indexOrPanelId);\n        panelId = id;\n      } else {\n        panelId = indexOrPanelId;\n      }\n\n      const expanded = expandedIds.has(panelId);\n      const disabled =\n        expanded && preventAllCollapsed && expandedIds.size === 1;\n      return {\n        id,\n        disabled,\n        expanded,\n        onExpandClick() {\n          if (disabled) {\n            return;\n          }\n\n          toggleValue(panelId);\n        },\n        disableTransition,\n        disableContentPadding,\n      };\n    },\n  };\n}\n"],"names":["useEnsuredId","useReadonlySet","useExpansionPanels","options","baseId","propBaseId","multiple","preventAllCollapsed","disableTransition","defaultExpandedIds","defaultExpandedIndex","disableContentPadding","createId","index","value","expandedIds","setValue","setExpandedIds","toggleValue","toggleType","defaultValue","initialList","push","Set","getPanelProps","indexOrPanelId","id","panelId","expanded","has","disabled","size","onExpandClick"],"mappings":"AAAA;AAEA,SAASA,YAAY,QAAQ,qBAAqB;AAClD,SAASC,cAAc,QAAQ,uBAAuB;AAsHtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2EC,GACD,OAAO,SAASC,mBACdC,UAAqC,CAAC,CAAC;IAEvC,MAAM,EACJC,QAAQC,UAAU,EAClBC,WAAW,KAAK,EAChBC,sBAAsB,KAAK,EAC3BC,oBAAoB,KAAK,EACzBC,kBAAkB,EAClBC,oBAAoB,EACpBC,wBAAwB,KAAK,EAC9B,GAAGR;IAEJ,MAAMC,SAASJ,aAAaK,YAAY;IACxC,MAAMO,WAAW,CAACC,QAA0B,GAAGT,OAAO,CAAC,EAAES,QAAQ,GAAG;IACpE,MAAM,EACJC,OAAOC,WAAW,EAClBC,UAAUC,cAAc,EACxBC,WAAW,EACZ,GAAGjB,eAAe;QACjBkB,YAAYb,WAAW,aAAa;QACpCc,cAAc;YACZ,IAAI,OAAOX,uBAAuB,aAAa;gBAC7C,MAAMY,cAAwB,EAAE;gBAChC,IAAI,OAAOX,yBAAyB,YAAYH,qBAAqB;oBACnEc,YAAYC,IAAI,CAACV,SAASF,wBAAwB;gBACpD;gBAEA,OAAO,IAAIa,IAAIF;YACjB;YAEA,OAAO,OAAOZ,uBAAuB,aACjCA,uBACAA;QACN;IACF;IAEA,OAAO;QACLM;QACAE;QACAO,eAAcC,cAAc;YAC1B,IAAIC;YACJ,IAAIC;YACJ,IAAI,OAAOF,mBAAmB,UAAU;gBACtCC,KAAKd,SAASa;gBACdE,UAAUD;YACZ,OAAO;gBACLC,UAAUF;YACZ;YAEA,MAAMG,WAAWb,YAAYc,GAAG,CAACF;YACjC,MAAMG,WACJF,YAAYrB,uBAAuBQ,YAAYgB,IAAI,KAAK;YAC1D,OAAO;gBACLL;gBACAI;gBACAF;gBACAI;oBACE,IAAIF,UAAU;wBACZ;oBACF;oBAEAZ,YAAYS;gBACd;gBACAnB;gBACAG;YACF;QACF;IACF;AACF"}

package/dist/{form → files}/FileInput.d.ts

@@ -1,17 +1,14 @@
 import { type InputHTMLAttributes, type LabelHTMLAttributes, type ReactNode } from "react";
-import { type ButtonClassNameOptions, type ButtonClassNameThemeOptions } from "../button/buttonStyles.js";
+import { type ButtonClassNameThemeOptions } from "../button/buttonStyles.js";
+import { type ComponentWithRippleProps } from "../interaction/types.js";
 import { type PropsWithRef } from "../types.js";
 /** @since 6.0.0 */
-export type FileInputClassNameOptions = ButtonClassNameOptions;
-/** @since 6.0.0 */
-export declare function fileInput(options?: FileInputClassNameOptions): string;
-/** @since 6.0.0 */
 export type FileInputHTMLAttributes = Omit<InputHTMLAttributes<HTMLInputElement>, "type">;
 /**
  * @since 6.0.0 Removed the `disableIconSpacing` prop since it is no
  * longer required.
  */
-export interface FileInputProps extends ButtonClassNameThemeOptions, FileInputHTMLAttributes {
+export interface FileInputProps extends ButtonClassNameThemeOptions, FileInputHTMLAttributes, ComponentWithRippleProps {
     /**
      * This is the label text for icon-only file inputs.
      *

package/dist/{form → files}/FileInput.js

@@ -1,15 +1,11 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { cnb } from "cnbuilder";
 import { forwardRef } from "react";
-import { button } from "../button/buttonStyles.js";
 import { getIcon } from "../icon/iconConfig.js";
 import { useElementInteraction } from "../interaction/useElementInteraction.js";
 import { SrOnly } from "../typography/SrOnly.js";
 import { useEnsuredId } from "../useEnsuredId.js";
-/** @since 6.0.0 */ export function fileInput(options = {}) {
-    return cnb("rmd-file-input", button(options));
-}
+import { fileInput } from "./styles.js";
 /**
  * **Client Component**
  * This might be able to become a server component if I remove the getIcon hook
@@ -59,10 +55,11 @@ import { useEnsuredId } from "../useEnsuredId.js";
  * `responsive`. Also removed the `disableIconSpacing` prop since it is no
  * longer required.
  */ export const FileInput = /*#__PURE__*/ forwardRef(function FileInput(props, ref) {
-    const { id: propId, className, children: propChildren, icon: propIcon, iconAfter = false, srOnlyLabel = "Upload", disableRepeatableFiles = false, labelProps, theme = "primary", themeType = "contained", buttonType = propChildren ? "text" : "icon", disabled = false, iconSize, responsive, multiple = false, ...remaining } = props;
+    const { id: propId, className, children: propChildren, icon: propIcon, iconAfter = false, srOnlyLabel = "Upload", disableRepeatableFiles = false, labelProps, theme = "primary", themeType = "contained", buttonType = propChildren ? "text" : "icon", disabled = false, iconSize, responsive, multiple = false, disableRipple, ...remaining } = props;
     const id = useEnsuredId(propId, "file-input");
     const { pressed, pressedClassName, ripples, handlers } = useElementInteraction({
         ...labelProps,
+        mode: disableRipple ? "none" : undefined,
         onClick (event) {
             labelProps?.onClick?.(event);
             // stop propagation so 2 ripples are not created

package/dist/files/FileInput.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/files/FileInput.tsx"],"sourcesContent":["\"use client\";\nimport {\n  forwardRef,\n  type InputHTMLAttributes,\n  type LabelHTMLAttributes,\n  type ReactNode,\n} from \"react\";\nimport { type ButtonClassNameThemeOptions } from \"../button/buttonStyles.js\";\nimport { getIcon } from \"../icon/iconConfig.js\";\nimport { type ComponentWithRippleProps } from \"../interaction/types.js\";\nimport { useElementInteraction } from \"../interaction/useElementInteraction.js\";\nimport { type PropsWithRef } from \"../types.js\";\nimport { SrOnly } from \"../typography/SrOnly.js\";\nimport { useEnsuredId } from \"../useEnsuredId.js\";\nimport { fileInput } from \"./styles.js\";\n\n/** @since 6.0.0 */\nexport type FileInputHTMLAttributes = Omit<\n  InputHTMLAttributes<HTMLInputElement>,\n  \"type\"\n>;\n\n/**\n * @since 6.0.0 Removed the `disableIconSpacing` prop since it is no\n * longer required.\n */\nexport interface FileInputProps\n  extends ButtonClassNameThemeOptions,\n    FileInputHTMLAttributes,\n    ComponentWithRippleProps {\n  /**\n   * This is the label text for icon-only file inputs.\n   *\n   * @defaultValue `\"Upload\"`\n   */\n  srOnlyLabel?: ReactNode;\n\n  /**\n   * Any additional props to provide to the container `<label>` element since\n   * most props get passed to the `<input type=\"file\">`. So this would be useful\n   * for inline style or click handlers.\n   */\n  labelProps?: PropsWithRef<\n    LabelHTMLAttributes<HTMLLabelElement>,\n    HTMLLabelElement\n  >;\n\n  /**\n   * An optional icon to display for the file input.\n   *\n   * @defaultValue `getIcon(\"upload\")`\n   */\n  icon?: ReactNode;\n\n  /**\n   * Boolean if the icon should appear after the children in the label.\n   *\n   * @defaultValue `false`\n   */\n  iconAfter?: boolean;\n\n  /**\n   * Boolean if the file input should no longer allow the same file to be\n   * selected multiple times and trigger the `onChange` each time it is\n   * selected.\n   *\n   * @defaultValue `false`\n   */\n  disableRepeatableFiles?: boolean;\n\n  /**\n   * Children should generally be provided when the {@link buttonType} is\n   * set to `\"text\"`. This defaults to a screen-reader only accessible text.\n   *\n   * @defaultValue `<SrOnly phoneOnly={responsive}>Upload</SrOnly>`\n   */\n  children?: ReactNode;\n}\n\n/**\n * **Client Component**\n * This might be able to become a server component if I remove the getIcon hook\n *\n * @example Simple Example\n * ```tsx\n * import { FileInput, Form } from \"@react-md/core\";\n * import type { ReactElement } from \"react\";\n *\n * const extensions = [\n *   \"svg\",\n *   \"jpeg\",\n *   \"jpg\",\n *   \"png\",\n *   \"apng\",\n *   \"mkv\",\n *   \"mp4\",\n *   \"mpeg\",\n *   \"mpg\",\n *   \"webm\",\n *   \"mov\",\n * ] as const;\n *\n * const FOUR_HUNDRED_MB = 400 * 1024 * 1024;\n * const maxFiles = 10;\n *\n * function Example(): ReactElement {\n *   const { stats, errors, onChange, clearErrors, reset, remove, accept } =\n *     useFileUpload({\n *       maxFiles,\n *       maxFileSize: FOUR_HUNDRED_MB,\n *       extensions,\n *     });\n *\n *   return (\n *     <Form>\n *       <FileInput accept={accept} multiple={maxFiles > 1} onChange={onChange} />\n *       <Button onClick={reset} disabled={!stats.length}>\n *         Remove all files\n *       </Button>\n *     </Form>\n *   );\n * }\n * ```\n *\n * @since 6.0.0 Added additional support for `iconSize` and\n * `responsive`. Also removed the `disableIconSpacing` prop since it is no\n * longer required.\n */\nexport const FileInput = forwardRef<HTMLInputElement, FileInputProps>(\n  function FileInput(props, ref) {\n    const {\n      id: propId,\n      className,\n      children: propChildren,\n      icon: propIcon,\n      iconAfter = false,\n      srOnlyLabel = \"Upload\",\n      disableRepeatableFiles = false,\n      labelProps,\n      theme = \"primary\",\n      themeType = \"contained\",\n      buttonType = propChildren ? \"text\" : \"icon\",\n      disabled = false,\n      iconSize,\n      responsive,\n      multiple = false,\n      disableRipple,\n      ...remaining\n    } = props;\n    const id = useEnsuredId(propId, \"file-input\");\n    const { pressed, pressedClassName, ripples, handlers } =\n      useElementInteraction({\n        ...labelProps,\n        mode: disableRipple ? \"none\" : undefined,\n        onClick(event) {\n          labelProps?.onClick?.(event);\n\n          // stop propagation so 2 ripples are not created\n          event.stopPropagation();\n        },\n        disabled,\n      });\n\n    const icon = getIcon(\"upload\", propIcon);\n    let children = propChildren;\n    if (\n      typeof propChildren === \"undefined\" &&\n      !props[\"aria-label\"] &&\n      !props[\"aria-labelledby\"]\n    ) {\n      children = <SrOnly phoneOnly={responsive}>{srOnlyLabel}</SrOnly>;\n    }\n\n    return (\n      <label\n        {...labelProps}\n        {...handlers}\n        className={fileInput({\n          theme,\n          themeType,\n          buttonType,\n          disabled,\n          iconSize,\n          pressed,\n          responsive,\n          pressedClassName,\n          className: className || labelProps?.className,\n        })}\n      >\n        {!iconAfter && icon}\n        {children}\n        {iconAfter && icon}\n        <input\n          {...remaining}\n          id={id}\n          ref={ref}\n          value={\n            disableRepeatableFiles || !props.onChange ? remaining.value : \"\"\n          }\n          type=\"file\"\n          className=\"rmd-hidden-input\"\n          disabled={disabled}\n          multiple={multiple}\n        />\n        {ripples}\n      </label>\n    );\n  }\n);\n"],"names":["forwardRef","getIcon","useElementInteraction","SrOnly","useEnsuredId","fileInput","FileInput","props","ref","id","propId","className","children","propChildren","icon","propIcon","iconAfter","srOnlyLabel","disableRepeatableFiles","labelProps","theme","themeType","buttonType","disabled","iconSize","responsive","multiple","disableRipple","remaining","pressed","pressedClassName","ripples","handlers","mode","undefined","onClick","event","stopPropagation","phoneOnly","label","input","value","onChange","type"],"mappings":"AAAA;;AACA,SACEA,UAAU,QAIL,QAAQ;AAEf,SAASC,OAAO,QAAQ,wBAAwB;AAEhD,SAASC,qBAAqB,QAAQ,0CAA0C;AAEhF,SAASC,MAAM,QAAQ,0BAA0B;AACjD,SAASC,YAAY,QAAQ,qBAAqB;AAClD,SAASC,SAAS,QAAQ,cAAc;AAiExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDC,GACD,OAAO,MAAMC,0BAAYN,WACvB,SAASM,UAAUC,KAAK,EAAEC,GAAG;IAC3B,MAAM,EACJC,IAAIC,MAAM,EACVC,SAAS,EACTC,UAAUC,YAAY,EACtBC,MAAMC,QAAQ,EACdC,YAAY,KAAK,EACjBC,cAAc,QAAQ,EACtBC,yBAAyB,KAAK,EAC9BC,UAAU,EACVC,QAAQ,SAAS,EACjBC,YAAY,WAAW,EACvBC,aAAaT,eAAe,SAAS,MAAM,EAC3CU,WAAW,KAAK,EAChBC,QAAQ,EACRC,UAAU,EACVC,WAAW,KAAK,EAChBC,aAAa,EACb,GAAGC,WACJ,GAAGrB;IACJ,MAAME,KAAKL,aAAaM,QAAQ;IAChC,MAAM,EAAEmB,OAAO,EAAEC,gBAAgB,EAAEC,OAAO,EAAEC,QAAQ,EAAE,GACpD9B,sBAAsB;QACpB,GAAGiB,UAAU;QACbc,MAAMN,gBAAgB,SAASO;QAC/BC,SAAQC,KAAK;YACXjB,YAAYgB,UAAUC;YAEtB,gDAAgD;YAChDA,MAAMC,eAAe;QACvB;QACAd;IACF;IAEF,MAAMT,OAAOb,QAAQ,UAAUc;IAC/B,IAAIH,WAAWC;IACf,IACE,OAAOA,iBAAiB,eACxB,CAACN,KAAK,CAAC,aAAa,IACpB,CAACA,KAAK,CAAC,kBAAkB,EACzB;QACAK,yBAAW,KAACT;YAAOmC,WAAWb;sBAAaR;;IAC7C;IAEA,qBACE,MAACsB;QACE,GAAGpB,UAAU;QACb,GAAGa,QAAQ;QACZrB,WAAWN,UAAU;YACnBe;YACAC;YACAC;YACAC;YACAC;YACAK;YACAJ;YACAK;YACAnB,WAAWA,aAAaQ,YAAYR;QACtC;;YAEC,CAACK,aAAaF;YACdF;YACAI,aAAaF;0BACd,KAAC0B;gBACE,GAAGZ,SAAS;gBACbnB,IAAIA;gBACJD,KAAKA;gBACLiC,OACEvB,0BAA0B,CAACX,MAAMmC,QAAQ,GAAGd,UAAUa,KAAK,GAAG;gBAEhEE,MAAK;gBACLhC,WAAU;gBACVY,UAAUA;gBACVG,UAAUA;;YAEXK;;;AAGP,GACA"}

package/dist/files/_files.scss

@@ -0,0 +1,22 @@
+@use "../utils";
+@use "../interaction/interaction";
+
+$disable-everything: false !default;
+
+@mixin styles($disable-layer: false) {
+  @if not $disable-everything {
+    @include utils.optional-layer(files, $disable-layer) {
+      @if utils.$disable-has-selectors or utils.$disable-focus-visible {
+        .rmd-file-input:focus-within::before {
+          @include utils.keyboard-only {
+            @include interaction.focus-styles;
+          }
+        }
+      } @else {
+        .rmd-file-input:has(:focus-visible)::before {
+          @include interaction.focus-styles;
+        }
+      }
+    }
+  }
+}

package/dist/files/styles.d.ts

@@ -0,0 +1,5 @@
+import { type ButtonClassNameOptions } from "../button/buttonStyles.js";
+/** @since 6.0.0 */
+export type FileInputClassNameOptions = ButtonClassNameOptions;
+/** @since 6.0.0 */
+export declare function fileInput(options?: FileInputClassNameOptions): string;

package/dist/files/styles.js

@@ -0,0 +1,7 @@
+import { cnb } from "cnbuilder";
+import { button } from "../button/buttonStyles.js";
+/** @since 6.0.0 */ export function fileInput(options = {}) {
+    return cnb("rmd-file-input", button(options));
+}
+
+//# sourceMappingURL=styles.js.map

package/dist/files/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/files/styles.ts"],"sourcesContent":["import { cnb } from \"cnbuilder\";\nimport { type ButtonClassNameOptions, button } from \"../button/buttonStyles.js\";\n\n/** @since 6.0.0 */\nexport type FileInputClassNameOptions = ButtonClassNameOptions;\n\n/** @since 6.0.0 */\nexport function fileInput(options: FileInputClassNameOptions = {}): string {\n  return cnb(\"rmd-file-input\", button(options));\n}\n"],"names":["cnb","button","fileInput","options"],"mappings":"AAAA,SAASA,GAAG,QAAQ,YAAY;AAChC,SAAsCC,MAAM,QAAQ,4BAA4B;AAKhF,iBAAiB,GACjB,OAAO,SAASC,UAAUC,UAAqC,CAAC,CAAC;IAC/D,OAAOH,IAAI,kBAAkBC,OAAOE;AACtC"}

package/dist/{form → files}/useFileUpload.d.ts

@@ -1,4 +1,5 @@
-import { type FileUploadHandlers, type FileUploadStats, type FileValidationError, type FileValidationOptions, type FilesValidator, type GetFileParser } from "./fileUtils.js";
+import { type FileUploadHandlers, type FileUploadStats, type GetFileParser } from "./utils.js";
+import { type FileValidationError, type FileValidationOptions, type FilesValidator } from "./validation.js";
 /**
  *
  * @typeParam CustomError - An optional error type that gets returned from the
@@ -70,12 +71,12 @@ export interface FileUploadActions {
      * Reset everything related to uploads ensuring that all file readers have
      * been aborted.
      */
-    reset(): void;
+    reset: () => void;
     /**
-     * Removes all the errors that exist in state without cancelling any of the
+     * Removes all the errors that exist in state without canceling any of the
      * uploads already in progress.
      */
-    clearErrors(): void;
+    clearErrors: () => void;
     /**
      * This function is used to cancel pending and uploading files or removing
      * completed files.
@@ -83,7 +84,7 @@ export interface FileUploadActions {
      * @param keyOrKeys - A single or list of {@link BaseFileUploadStats.key} to
      * remove from state.
      */
-    remove(keyOrKeys: string | readonly string[]): void;
+    remove: (keyOrKeys: string | readonly string[]) => void;
 }
 /**
  *
@@ -134,9 +135,6 @@ export interface FileUploadHookReturnValue<E extends HTMLElement = HTMLElement,
  * can also be used to upload the files as an `ArrayBuffer` and then uploaded to
  * a server.
  *
- * Note: If using the `aws-sdk` to upload files directly to S3, **do not use
- * this hook** since it uses its own upload process.
- *
  * @typeParam E - An optional HTMLElement type that is used for the
  * {@link FileUploadHandlers}.
  * @typeParam CustomError - An optional error type that gets returned from the
@@ -145,4 +143,4 @@ export interface FileUploadHookReturnValue<E extends HTMLElement = HTMLElement,
  * @returns the {@link FileUploadHookReturnValue}
  * @since 2.9.0
  */
-export declare function useFileUpload<E extends HTMLElement, CustomError = never>({ maxFiles, extensions, minFileSize, maxFileSize, totalFileSize, concurrency, onDrop: propOnDrop, onChange: propOnChange, validateFiles, getFileParser, isValidFileName, }?: FileUploadOptions<E, CustomError>): Readonly<FileUploadHookReturnValue<E, CustomError>>;
+export declare function useFileUpload<E extends HTMLElement, CustomError = never>(options?: FileUploadOptions<E, CustomError>): Readonly<FileUploadHookReturnValue<E, CustomError>>;

package/dist/{form → files}/useFileUpload.js

@@ -1,7 +1,8 @@
 "use client";
 import { nanoid } from "nanoid";
 import { useCallback, useEffect, useReducer } from "react";
-import { FileAccessError, getFileParser as defaultGetFileParser, isValidFileName as defaultIsValidFileName, validateFiles as defaultValidateFiles } from "./fileUtils.js";
+import { getFileParser as defaultGetFileParser } from "./utils.js";
+import { FileAccessError, isValidFileName as defaultIsValidFileName, validateFiles as defaultValidateFiles } from "./validation.js";
 const noop = ()=>{
 // do nothing
 };
@@ -13,9 +14,6 @@ const noop = ()=>{
  * can also be used to upload the files as an `ArrayBuffer` and then uploaded to
  * a server.
  *
- * Note: If using the `aws-sdk` to upload files directly to S3, **do not use
- * this hook** since it uses its own upload process.
- *
  * @typeParam E - An optional HTMLElement type that is used for the
  * {@link FileUploadHandlers}.
  * @typeParam CustomError - An optional error type that gets returned from the
@@ -23,7 +21,8 @@ const noop = ()=>{
  * @param options - All the {@link FileUploadOptions}
  * @returns the {@link FileUploadHookReturnValue}
  * @since 2.9.0
- */ export function useFileUpload({ maxFiles = -1, extensions = EMPTY_LIST, minFileSize = -1, maxFileSize = -1, totalFileSize = -1, concurrency = -1, onDrop: propOnDrop = noop, onChange: propOnChange = noop, validateFiles = defaultValidateFiles, getFileParser = defaultGetFileParser, isValidFileName = defaultIsValidFileName } = {}) {
+ */ export function useFileUpload(options = {}) {
+    const { maxFiles = -1, extensions = EMPTY_LIST, minFileSize = -1, maxFileSize = -1, totalFileSize = -1, concurrency = -1, onDrop: propOnDrop = noop, onChange: propOnChange = noop, validateFiles = defaultValidateFiles, getFileParser = defaultGetFileParser, isValidFileName = defaultIsValidFileName } = options;
     const [state, dispatch] = useReducer(function reducer(state, action) {
         switch(action.type){
             case "reset":
@@ -291,8 +290,7 @@ const noop = ()=>{
             /* istanbul ignore next */ if (process.env.NODE_ENV !== "production" && ![
                 "readAsText",
                 "readAsDataURL",
-                "readAsArrayBuffer",
-                "readAsBinaryString"
+                "readAsArrayBuffer"
             ].includes(parser)) {
                 throw new Error("Invalid file reader parser");
             }