@jobber/components 9.4.0 → 9.5.0

package/dist/useButton-es.js

@@ -1,1071 +0,0 @@
-import * as React from 'react';
-import { a as useRefWithInit, E as EMPTY_OBJECT, f as formatErrorMessage, m as mergeProps, d as makeEventPreventable } from './useRenderElement-es.js';
-import { a as isShadowRoot, i as isHTMLElement } from './floating-ui.utils.dom-es.js';
-import * as ReactDOM from 'react-dom';
-
-let set;
-if (process.env.NODE_ENV !== 'production') {
-  set = new Set();
-}
-function error(...messages) {
-  if (process.env.NODE_ENV !== 'production') {
-    const messageKey = messages.join(' ');
-    if (!set.has(messageKey)) {
-      set.add(messageKey);
-      console.error(`Base UI: ${messageKey}`);
-    }
-  }
-}
-
-function useControlled({
-  controlled,
-  default: defaultProp,
-  name,
-  state = 'value'
-}) {
-  // isControlled is ignored in the hook dependency lists as it should never change.
-  const {
-    current: isControlled
-  } = React.useRef(controlled !== undefined);
-  const [valueState, setValue] = React.useState(defaultProp);
-  const value = isControlled ? controlled : valueState;
-  if (process.env.NODE_ENV !== 'production') {
-    React.useEffect(() => {
-      if (isControlled !== (controlled !== undefined)) {
-        error([`A component is changing the ${isControlled ? '' : 'un'}controlled ${state} state of ${name} to be ${isControlled ? 'un' : ''}controlled.`, 'Elements should not switch from uncontrolled to controlled (or vice versa).', `Decide between using a controlled or uncontrolled ${name} ` + 'element for the lifetime of the component.', "The nature of the state is determined during the first render. It's considered controlled if the value is not `undefined`.", 'More info: https://fb.me/react-controlled-components'].join('\n'));
-      }
-    }, [state, name, controlled]);
-    const {
-      current: defaultValue
-    } = React.useRef(defaultProp);
-    React.useEffect(() => {
-      if (!isControlled && serializeToDevModeString(defaultValue) !== serializeToDevModeString(defaultProp)) {
-        error([`A component is changing the default ${state} state of an uncontrolled ${name} after being initialized. ` + `To suppress this warning opt to use a controlled ${name}.`].join('\n'));
-      }
-    }, [defaultProp]);
-  }
-  const setValueIfUncontrolled = React.useCallback(newValue => {
-    if (!isControlled) {
-      setValue(newValue);
-    }
-  }, []);
-  return [value, setValueIfUncontrolled];
-}
-function serializeToDevModeString(input) {
-  let nextId = 0;
-  const seen = new WeakMap();
-  try {
-    const result = JSON.stringify(input, function replacer(key, value) {
-      if (key === '_owner' && this != null && typeof this === 'object' && '$$typeof' in this) {
-        return undefined;
-      }
-      if (typeof value === 'bigint') {
-        return `__bigint__:${value}`;
-      }
-      if (value !== null && typeof value === 'object') {
-        const id = seen.get(value);
-        if (id !== undefined) {
-          return `__object__:${id}`;
-        }
-        seen.set(value, nextId);
-        nextId += 1;
-      }
-      return value;
-    });
-    return result ?? `__top__:${typeof input}`;
-  } catch {
-    return '__unserializable__';
-  }
-}
-
-const noop = () => {};
-const useIsoLayoutEffect = typeof document !== 'undefined' ? React.useLayoutEffect : noop;
-
-/**
- * A clone of the React namespace for reading APIs that may be missing in older
- * supported React versions. Bundlers can rewrite direct `React.someNewApi`
- * reads into named imports, which breaks React 17. Reading from this cloned
- * object keeps those lookups optional.
- *
- * @see https://github.com/mui/material-ui/issues/41190#issuecomment-2040873379
- */
-const SafeReact = {
-  ...React
-};
-
-const useInsertionEffect = SafeReact.useInsertionEffect;
-const useSafeInsertionEffect =
-// React 17 doesn't have useInsertionEffect.
-useInsertionEffect &&
-// Preact replaces useInsertionEffect with useLayoutEffect and fires too late.
-useInsertionEffect !== SafeReact.useLayoutEffect ? useInsertionEffect : fn => fn();
-/**
- * Stabilizes the function passed so it's always the same between renders.
- *
- * The function becomes non-reactive to any values it captures.
- * It can safely be passed as a dependency of `React.useMemo` and `React.useEffect` without re-triggering them if its captured values change.
- *
- * The function must only be called inside effects and event handlers, never during render (which throws an error).
- *
- * This hook is a more permissive version of React 19.2's `React.useEffectEvent` in that it can be passed through contexts and called in event handler props, not just effects.
- */
-function useStableCallback(callback) {
-  const stable = useRefWithInit(createStableCallback).current;
-  stable.next = callback;
-  useSafeInsertionEffect(stable.effect);
-  return stable.trampoline;
-}
-function createStableCallback() {
-  const stable = {
-    next: undefined,
-    callback: assertNotCalled,
-    trampoline: (...args) => stable.callback?.(...args),
-    effect: () => {
-      stable.callback = stable.next;
-    }
-  };
-  return stable;
-}
-function assertNotCalled() {
-  if (process.env.NODE_ENV !== 'production') {
-    // TODO: fix mui/no-guarded-throw
-    // eslint-disable-next-line mui/no-guarded-throw
-    throw /* minify-error-disabled */new Error('Base UI: Cannot call an event handler while rendering.');
-  }
-}
-
-/**
- * Untracks the provided value by turning it into a ref to remove its reactivity.
- *
- * Used to access the passed value inside `React.useEffect` without causing the effect to re-run when the value changes.
- */
-function useValueAsRef(value) {
-  const latest = useRefWithInit(createLatestRef, value).current;
-  latest.next = value;
-
-  // eslint-disable-next-line react-hooks/exhaustive-deps
-  useIsoLayoutEffect(latest.effect);
-  return latest;
-}
-function createLatestRef(value) {
-  const latest = {
-    current: value,
-    next: value,
-    effect: () => {
-      latest.current = latest.next;
-    }
-  };
-  return latest;
-}
-
-const visuallyHiddenBase = {
-  clipPath: 'inset(50%)',
-  overflow: 'hidden',
-  whiteSpace: 'nowrap',
-  border: 0,
-  padding: 0,
-  width: 1,
-  height: 1,
-  margin: -1
-};
-const visuallyHidden = {
-  ...visuallyHiddenBase,
-  position: 'fixed',
-  top: 0,
-  left: 0
-};
-const visuallyHiddenInput = {
-  ...visuallyHiddenBase,
-  position: 'absolute'
-};
-
-function ownerDocument(node) {
-  return node?.ownerDocument || document;
-}
-
-/**
- * Adds an event listener and returns a cleanup function to remove it.
- */
-
-function addEventListener(target, type, listener, options) {
-  target.addEventListener(type, listener, options);
-  return () => {
-    target.removeEventListener(type, listener, options);
-  };
-}
-
-const EMPTY$2 = [];
-
-/**
- * A React.useEffect equivalent that runs once, when the component is mounted.
- */
-function useOnMount(fn) {
-  // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler -- no need to put `fn` in the dependency array
-  /* eslint-disable react-hooks/exhaustive-deps */
-  React.useEffect(fn, EMPTY$2);
-  /* eslint-enable react-hooks/exhaustive-deps */
-}
-
-/** Unlike `setTimeout`, rAF doesn't guarantee a positive integer return value, so we can't have
- * a monomorphic `uint` type with `0` meaning empty.
- * See warning note at:
- * https://developer.mozilla.org/en-US/docs/Web/API/Window/requestAnimationFrame#return_value */
-const EMPTY$1 = null;
-let LAST_RAF = globalThis.requestAnimationFrame;
-class Scheduler {
-  /* This implementation uses an array as a backing data-structure for frame callbacks.
-   * It allows `O(1)` callback cancelling by inserting a `null` in the array, though it
-   * never calls the native `cancelAnimationFrame` if there are no frames left. This can
-   * be much more efficient if there is a call pattern that alterns as
-   * "request-cancel-request-cancel-…".
-   * But in the case of "request-request-…-cancel-cancel-…", it leaves the final animation
-   * frame to run anyway. We turn that frame into a `O(1)` no-op via `callbacksCount`. */
-
-  callbacks = [];
-  callbacksCount = 0;
-  nextId = 1;
-  startId = 1;
-  isScheduled = false;
-  tick = timestamp => {
-    this.isScheduled = false;
-    const currentCallbacks = this.callbacks;
-    const currentCallbacksCount = this.callbacksCount;
-
-    // Update these before iterating, callbacks could call `requestAnimationFrame` again.
-    this.callbacks = [];
-    this.callbacksCount = 0;
-    this.startId = this.nextId;
-    if (currentCallbacksCount > 0) {
-      for (let i = 0; i < currentCallbacks.length; i += 1) {
-        currentCallbacks[i]?.(timestamp);
-      }
-    }
-  };
-  request(fn) {
-    const id = this.nextId;
-    this.nextId += 1;
-    this.callbacks.push(fn);
-    this.callbacksCount += 1;
-
-    /* In a test environment with fake timers, a fake `requestAnimationFrame` can be called
-     * but there's no guarantee that the animation frame will actually run before the fake
-     * timers are teared, which leaves `isScheduled` set, but won't run our `tick()`. */
-    const didRAFChange = process.env.NODE_ENV !== 'production' && LAST_RAF !== requestAnimationFrame && (LAST_RAF = requestAnimationFrame, true);
-    if (!this.isScheduled || didRAFChange) {
-      requestAnimationFrame(this.tick);
-      this.isScheduled = true;
-    }
-    return id;
-  }
-  cancel(id) {
-    const index = id - this.startId;
-    if (index < 0 || index >= this.callbacks.length) {
-      return;
-    }
-    this.callbacks[index] = null;
-    this.callbacksCount -= 1;
-  }
-}
-const scheduler = new Scheduler();
-class AnimationFrame {
-  static create() {
-    return new AnimationFrame();
-  }
-  static request(fn) {
-    return scheduler.request(fn);
-  }
-  static cancel(id) {
-    return scheduler.cancel(id);
-  }
-  currentId = EMPTY$1;
-
-  /**
-   * Executes `fn` after `delay`, clearing any previously scheduled call.
-   */
-  request(fn) {
-    this.cancel();
-    this.currentId = scheduler.request(() => {
-      this.currentId = EMPTY$1;
-      fn();
-    });
-  }
-  cancel = () => {
-    if (this.currentId !== EMPTY$1) {
-      scheduler.cancel(this.currentId);
-      this.currentId = EMPTY$1;
-    }
-  };
-  disposeEffect = () => {
-    return this.cancel;
-  };
-}
-
-/**
- * A `requestAnimationFrame` with automatic cleanup and guard.
- */
-function useAnimationFrame() {
-  const timeout = useRefWithInit(AnimationFrame.create).current;
-  useOnMount(timeout.disposeEffect);
-  return timeout;
-}
-
-const EMPTY = 0;
-class Timeout {
-  static create() {
-    return new Timeout();
-  }
-  currentId = EMPTY;
-
-  /**
-   * Executes `fn` after `delay`, clearing any previously scheduled call.
-   */
-  start(delay, fn) {
-    this.clear();
-    this.currentId = setTimeout(() => {
-      this.currentId = EMPTY;
-      fn();
-    }, delay); /* Node.js types are enabled in development */
-  }
-  isStarted() {
-    return this.currentId !== EMPTY;
-  }
-  clear = () => {
-    if (this.currentId !== EMPTY) {
-      clearTimeout(this.currentId);
-      this.currentId = EMPTY;
-    }
-  };
-  disposeEffect = () => {
-    return this.clear;
-  };
-}
-
-/**
- * A `setTimeout` with automatic cleanup and guard.
- */
-function useTimeout() {
-  const timeout = useRefWithInit(Timeout.create).current;
-  useOnMount(timeout.disposeEffect);
-  return timeout;
-}
-
-/**
- * Reads `navigator.userAgent` / `navigator.platform` (legacy but universally
- * supported) into a normalized shape. In development, prefers the modern
- * `navigator.userAgentData` API on Chromium to avoid DevTools warnings about
- * the deprecated reads; that branch is dead-code-eliminated in production
- * builds to keep the bundle small.
- *
- * Returns empty/zero values when `navigator` is undefined (SSR), so every
- * derived flag safely evaluates to `false`.
- */
-function readRawData() {
-  if (typeof navigator === 'undefined') {
-    return {
-      userAgent: '',
-      platform: '',
-      maxTouchPoints: 0
-    };
-  }
-  if (process.env.NODE_ENV !== 'production') {
-    const uaData = navigator.userAgentData;
-    if (uaData && Array.isArray(uaData.brands)) {
-      return {
-        userAgent: uaData.brands.map(({
-          brand,
-          version
-        }) => `${brand}/${version}`).join(' '),
-        platform: uaData.platform ?? navigator.platform ?? '',
-        maxTouchPoints: navigator.maxTouchPoints ?? 0
-      };
-    }
-  }
-  return {
-    userAgent: navigator.userAgent,
-    platform: navigator.platform ?? '',
-    maxTouchPoints: navigator.maxTouchPoints ?? 0
-  };
-}
-const {
-  userAgent,
-  platform,
-  maxTouchPoints
-} = readRawData();
-const lowerUserAgent = userAgent.toLowerCase();
-const lowerPlatform = platform.toLowerCase();
-
-// iPadOS 13+ reports `MacIntel` for `navigator.platform`; disambiguated via
-// `maxTouchPoints` so iPad is classified as iOS, not macOS.
-// https://github.com/mui/base-ui/issues/1309
-/** iPhone, iPad (including iPadOS 13+ reporting as macOS), iPod. */
-const ios = /^i(os$|p)/.test(lowerPlatform) || lowerPlatform === 'macintel' && maxTouchPoints > 1;
-
-/** Android phones, tablets, and embedded Android browsers. */
-const ANDROID_STRING = 'android';
-const android = lowerPlatform === ANDROID_STRING || lowerUserAgent.includes(ANDROID_STRING);
-
-/** macOS desktop. Excludes iPadOS, which reports as `MacIntel`. */
-const mac = !ios && lowerPlatform.startsWith('mac');
-
-/** Windows desktop. */
-lowerPlatform.startsWith('win');
-
-/** Any Apple OS (`mac || ios`). */
-const apple = mac || ios;
-
-/** Running in jsdom or HappyDOM (used by unit tests). */
-const jsdom = /jsdom|happydom/.test(lowerUserAgent);
-
-function stopEvent(event) {
-  event.preventDefault();
-  event.stopPropagation();
-}
-function isReactEvent(event) {
-  return 'nativeEvent' in event;
-}
-
-// License: https://github.com/adobe/react-spectrum/blob/main/packages/@react-aria/utils/src/isVirtualEvent.ts
-function isVirtualClick(event) {
-  if (event.pointerType === '' && event.isTrusted) {
-    return true;
-  }
-  if (android && event.pointerType) {
-    return event.type === 'click' && event.buttons === 1;
-  }
-  return event.detail === 0 && !event.pointerType;
-}
-function isVirtualPointerEvent(event) {
-  if (jsdom) {
-    return false;
-  }
-  return !android && event.width === 0 && event.height === 0 || android && event.width === 1 && event.height === 1 && event.pressure === 0 && event.detail === 0 && event.pointerType === 'mouse' ||
-  // iOS VoiceOver returns 0.333• for width/height.
-  event.width < 1 && event.height < 1 && event.pressure === 0 && event.detail === 0 && event.pointerType === 'touch';
-}
-function isMouseLikePointerType(pointerType, strict) {
-  // On some Linux machines with Chromium, mouse inputs return a `pointerType`
-  // of "pen": https://github.com/floating-ui/floating-ui/issues/2015
-  const values = ['mouse', 'pen'];
-  if (!strict) {
-    values.push('', undefined);
-  }
-  return values.includes(pointerType);
-}
-function isClickLikeEvent(event) {
-  const type = event.type;
-  return type === 'click' || type === 'mousedown' || type === 'keydown' || type === 'keyup';
-}
-
-function activeElement(doc) {
-  let element = doc.activeElement;
-  while (element?.shadowRoot?.activeElement != null) {
-    element = element.shadowRoot.activeElement;
-  }
-  return element;
-}
-function contains(parent, child) {
-  if (!parent || !child) {
-    return false;
-  }
-  const rootNode = child.getRootNode?.();
-
-  // First, attempt with the faster native method.
-  if (parent.contains(child)) {
-    return true;
-  }
-
-  // Then fall back to traversing out of shadow roots when needed.
-  if (rootNode && isShadowRoot(rootNode)) {
-    let next = child;
-    while (next) {
-      if (parent === next) {
-        return true;
-      }
-      next = next.parentNode || next.host;
-    }
-  }
-  return false;
-}
-function getTarget(event) {
-  if ('composedPath' in event) {
-    return event.composedPath()[0];
-  }
-
-  // TS assumes `composedPath()` always exists, but older browsers without
-  // shadow DOM support still fall back to `target`.
-  return event.target;
-}
-
-const none = 'none';
-const triggerPress = 'trigger-press';
-const triggerHover = 'trigger-hover';
-const triggerFocus = 'trigger-focus';
-const outsidePress = 'outside-press';
-const itemPress = 'item-press';
-const closePress = 'close-press';
-const clearPress = 'clear-press';
-const chipRemovePress = 'chip-remove-press';
-const incrementPress = 'increment-press';
-const decrementPress = 'decrement-press';
-const inputChange = 'input-change';
-const inputClear = 'input-clear';
-const inputBlur = 'input-blur';
-const inputPaste = 'input-paste';
-const inputPress = 'input-press';
-const focusOut = 'focus-out';
-const escapeKey = 'escape-key';
-const closeWatcher = 'close-watcher';
-const listNavigation = 'list-navigation';
-const keyboard = 'keyboard';
-const pointer = 'pointer';
-const wheel = 'wheel';
-const scrub = 'scrub';
-const cancelOpen = 'cancel-open';
-const siblingOpen = 'sibling-open';
-const imperativeAction = 'imperative-action';
-const swipe = 'swipe';
-const windowResize = 'window-resize';
-
-/**
- * Maps a change `reason` string to the corresponding native event type.
- */
-
-/**
- * Details of custom change events emitted by Base UI components.
- */
-
-/**
- * Details of custom generic events emitted by Base UI components.
- */
-
-/**
- * Creates a Base UI event details object with the given reason and utilities
- * for preventing Base UI's internal event handling.
- */
-function createChangeEventDetails(reason, event, trigger, customProperties) {
-  let canceled = false;
-  let allowPropagation = false;
-  const custom = customProperties ?? EMPTY_OBJECT;
-  const details = {
-    reason,
-    event: event ?? new Event('base-ui'),
-    cancel() {
-      canceled = true;
-    },
-    allowPropagation() {
-      allowPropagation = true;
-    },
-    get isCanceled() {
-      return canceled;
-    },
-    get isPropagationAllowed() {
-      return allowPropagation;
-    },
-    trigger,
-    ...custom
-  };
-  return details;
-}
-function createGenericEventDetails(reason, event, customProperties) {
-  const custom = customProperties ?? EMPTY_OBJECT;
-  const details = {
-    reason,
-    event: event ?? new Event('base-ui'),
-    ...custom
-  };
-  return details;
-}
-
-let globalId = 0;
-
-// TODO React 17: Remove `useGlobalId` once React 17 support is removed
-function useGlobalId(idOverride, prefix = 'mui') {
-  const [defaultId, setDefaultId] = React.useState(idOverride);
-  const id = idOverride || defaultId;
-  React.useEffect(() => {
-    if (defaultId == null) {
-      // Fallback to this default id when possible.
-      // Use the incrementing value for client-side rendering only.
-      // We can't use it server-side.
-      // If you want to use random values please consider the Birthday Problem: https://en.wikipedia.org/wiki/Birthday_problem
-      globalId += 1;
-      setDefaultId(`${prefix}-${globalId}`);
-    }
-  }, [defaultId, prefix]);
-  return id;
-}
-const maybeReactUseId = SafeReact.useId;
-
-/**
- *
- * @example <div id={useId()} />
- * @param idOverride
- * @returns {string}
- */
-function useId(idOverride, prefix) {
-  // React.useId() is only available from React 17.0.0.
-  if (maybeReactUseId !== undefined) {
-    const reactId = maybeReactUseId();
-    return idOverride ?? (prefix ? `${prefix}-${reactId}` : reactId);
-  }
-
-  // TODO: uncomment once we enable eslint-plugin-react-compiler // eslint-disable-next-line react-compiler/react-compiler
-  // eslint-disable-next-line react-hooks/rules-of-hooks -- `React.useId` is invariant at runtime.
-  return useGlobalId(idOverride, prefix);
-}
-
-/**
- * If the provided argument is a ref object, returns its `current` value.
- * Otherwise, returns the argument itself.
- */
-function resolveRef(maybeRef) {
-  if (maybeRef == null) {
-    return maybeRef;
-  }
-  return 'current' in maybeRef ? maybeRef.current : maybeRef;
-}
-
-/**
- * Provides a status string for CSS animations.
- * @param open - a boolean that determines if the element is open.
- * @param enableIdleState - a boolean that enables the `'idle'` state between `'starting'` and `'ending'`
- */
-function useTransitionStatus(open, enableIdleState = false, deferEndingState = false) {
-  const [transitionStatus, setTransitionStatus] = React.useState(open && enableIdleState ? 'idle' : undefined);
-  const [mounted, setMounted] = React.useState(open);
-  if (open && !mounted) {
-    setMounted(true);
-    setTransitionStatus('starting');
-  }
-  if (!open && mounted && transitionStatus !== 'ending' && !deferEndingState) {
-    setTransitionStatus('ending');
-  }
-  if (!open && !mounted && transitionStatus === 'ending') {
-    setTransitionStatus(undefined);
-  }
-  useIsoLayoutEffect(() => {
-    if (!open && mounted && transitionStatus !== 'ending' && deferEndingState) {
-      const frame = AnimationFrame.request(() => {
-        setTransitionStatus('ending');
-      });
-      return () => {
-        AnimationFrame.cancel(frame);
-      };
-    }
-    return undefined;
-  }, [open, mounted, transitionStatus, deferEndingState]);
-  useIsoLayoutEffect(() => {
-    if (!open || enableIdleState) {
-      return undefined;
-    }
-    const frame = AnimationFrame.request(() => {
-      // Avoid `flushSync` here due to Firefox.
-      // See https://github.com/mui/base-ui/pull/3424
-      setTransitionStatus(undefined);
-    });
-    return () => {
-      AnimationFrame.cancel(frame);
-    };
-  }, [enableIdleState, open]);
-  useIsoLayoutEffect(() => {
-    if (!open || !enableIdleState) {
-      return undefined;
-    }
-    if (open && mounted && transitionStatus !== 'idle') {
-      setTransitionStatus('starting');
-    }
-    const frame = AnimationFrame.request(() => {
-      setTransitionStatus('idle');
-    });
-    return () => {
-      AnimationFrame.cancel(frame);
-    };
-  }, [enableIdleState, open, mounted, transitionStatus]);
-  return {
-    mounted,
-    setMounted,
-    transitionStatus
-  };
-}
-
-let TransitionStatusDataAttributes = /*#__PURE__*/function (TransitionStatusDataAttributes) {
-  /**
-   * Present when the component is animating in.
-   */
-  TransitionStatusDataAttributes["startingStyle"] = "data-starting-style";
-  /**
-   * Present when the component is animating out.
-   */
-  TransitionStatusDataAttributes["endingStyle"] = "data-ending-style";
-  return TransitionStatusDataAttributes;
-}({});
-const STARTING_HOOK = {
-  [TransitionStatusDataAttributes.startingStyle]: ''
-};
-const ENDING_HOOK = {
-  [TransitionStatusDataAttributes.endingStyle]: ''
-};
-const transitionStatusMapping = {
-  transitionStatus(value) {
-    if (value === 'starting') {
-      return STARTING_HOOK;
-    }
-    if (value === 'ending') {
-      return ENDING_HOOK;
-    }
-    return null;
-  }
-};
-
-/**
- * Executes a function once all animations have finished on the provided element.
- * @param elementOrRef - The element to watch for animations.
- * @param waitForStartingStyleRemoved - Whether to wait for [data-starting-style] to be removed before checking for animations.
- * @param treatAbortedAsFinished - Whether to treat aborted animations as finished. If `false`, and there are aborted animations,
- *   the function will check again if any new animations have started and wait for them to finish.
- * @returns A function that takes a callback to execute once all animations have finished, and an optional AbortSignal to abort the callback
- */
-function useAnimationsFinished(elementOrRef, waitForStartingStyleRemoved = false, treatAbortedAsFinished = true) {
-  const frame = useAnimationFrame();
-  return useStableCallback((fnToExecute,
-  /**
-   * An optional [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) that
-   * can be used to abort `fnToExecute` before all the animations have finished.
-   * @default null
-   */
-  signal = null) => {
-    frame.cancel();
-    const element = resolveRef(elementOrRef);
-    if (element == null) {
-      return;
-    }
-    const resolvedElement = element;
-    const done = () => {
-      // Synchronously flush the unmounting of the component so that the browser doesn't
-      // paint: https://github.com/mui/base-ui/issues/979
-      ReactDOM.flushSync(fnToExecute);
-    };
-    if (typeof resolvedElement.getAnimations !== 'function' || globalThis.BASE_UI_ANIMATIONS_DISABLED) {
-      fnToExecute();
-      return;
-    }
-    function exec() {
-      Promise.all(resolvedElement.getAnimations().map(animation => animation.finished)).then(() => {
-        if (!signal?.aborted) {
-          done();
-        }
-      }).catch(() => {
-        if (treatAbortedAsFinished) {
-          if (!signal?.aborted) {
-            done();
-          }
-          return;
-        }
-        const currentAnimations = resolvedElement.getAnimations();
-        if (!signal?.aborted && currentAnimations.length > 0 && currentAnimations.some(animation => animation.pending || animation.playState !== 'finished')) {
-          // Sometimes animations can be aborted because a property they depend on changes while the animation plays.
-          // In such cases, we need to re-check if any new animations have started.
-          exec();
-        }
-      });
-    }
-    if (waitForStartingStyleRemoved) {
-      const startingStyleAttribute = TransitionStatusDataAttributes.startingStyle;
-
-      // If `[data-starting-style]` isn't present, fall back to waiting one more frame
-      // to give "open" animations a chance to be registered.
-      if (!resolvedElement.hasAttribute(startingStyleAttribute)) {
-        frame.request(exec);
-        return;
-      }
-
-      // Wait for `[data-starting-style]` to have been removed.
-      const attributeObserver = new MutationObserver(() => {
-        if (!resolvedElement.hasAttribute(startingStyleAttribute)) {
-          attributeObserver.disconnect();
-          exec();
-        }
-      });
-      attributeObserver.observe(resolvedElement, {
-        attributes: true,
-        attributeFilter: [startingStyleAttribute]
-      });
-      signal?.addEventListener('abort', () => attributeObserver.disconnect(), {
-        once: true
-      });
-      return;
-    }
-    frame.request(exec);
-  });
-}
-
-/**
- * Calls the provided function when the CSS open/close animation or transition completes.
- */
-function useOpenChangeComplete(parameters) {
-  const {
-    enabled = true,
-    open,
-    ref,
-    onComplete: onCompleteParam
-  } = parameters;
-  const onComplete = useStableCallback(onCompleteParam);
-  const runOnceAnimationsFinish = useAnimationsFinished(ref, open, false);
-  React.useEffect(() => {
-    if (!enabled) {
-      return undefined;
-    }
-    const abortController = new AbortController();
-    runOnceAnimationsFinish(onComplete, abortController.signal);
-    return () => {
-      abortController.abort();
-    };
-  }, [enabled, open, onComplete, runOnceAnimationsFinish]);
-}
-
-/**
- * Wraps `useId` and prefixes generated `id`s with `base-ui-`
- * @param {string | undefined} idOverride overrides the generated id when provided
- * @returns {string | undefined}
- */
-function useBaseUiId(idOverride) {
-  return useId(idOverride, 'base-ui');
-}
-
-function useValueChanged(value, onChange) {
-  const valueRef = React.useRef(value);
-  const onChangeCallback = useStableCallback(onChange);
-  useIsoLayoutEffect(() => {
-    if (valueRef.current === value) {
-      return;
-    }
-    onChangeCallback(valueRef.current);
-  }, [value, onChangeCallback]);
-  useIsoLayoutEffect(() => {
-    valueRef.current = value;
-  }, [value]);
-}
-
-const CompositeRootContext = /*#__PURE__*/React.createContext(undefined);
-if (process.env.NODE_ENV !== "production") CompositeRootContext.displayName = "CompositeRootContext";
-function useCompositeRootContext(optional = false) {
-  const context = React.useContext(CompositeRootContext);
-  if (context === undefined && !optional) {
-    throw new Error(process.env.NODE_ENV !== "production" ? 'Base UI: CompositeRootContext is missing. Composite parts must be placed within <Composite.Root>.' : formatErrorMessage(16));
-  }
-  return context;
-}
-
-function useFocusableWhenDisabled(parameters) {
-  const {
-    focusableWhenDisabled,
-    disabled,
-    composite = false,
-    tabIndex: tabIndexProp = 0,
-    isNativeButton
-  } = parameters;
-  const isFocusableComposite = composite && focusableWhenDisabled !== false;
-  const isNonFocusableComposite = composite && focusableWhenDisabled === false;
-
-  // we can't explicitly assign `undefined` to any of these props because it
-  // would otherwise prevent subsequently merged props from setting them
-  const props = React.useMemo(() => {
-    const additionalProps = {
-      // allow Tabbing away from focusableWhenDisabled elements
-      onKeyDown(event) {
-        if (disabled && focusableWhenDisabled && event.key !== 'Tab') {
-          event.preventDefault();
-        }
-      }
-    };
-    if (!composite) {
-      additionalProps.tabIndex = tabIndexProp;
-      if (!isNativeButton && disabled) {
-        additionalProps.tabIndex = focusableWhenDisabled ? tabIndexProp : -1;
-      }
-    }
-    if (isNativeButton && (focusableWhenDisabled || isFocusableComposite) || !isNativeButton && disabled) {
-      additionalProps['aria-disabled'] = disabled;
-    }
-    if (isNativeButton && (!focusableWhenDisabled || isNonFocusableComposite)) {
-      additionalProps.disabled = disabled;
-    }
-    return additionalProps;
-  }, [composite, disabled, focusableWhenDisabled, isFocusableComposite, isNonFocusableComposite, isNativeButton, tabIndexProp]);
-  return {
-    props
-  };
-}
-
-function useButton(parameters = {}) {
-  const {
-    disabled = false,
-    focusableWhenDisabled,
-    tabIndex = 0,
-    native: isNativeButton = true,
-    composite: compositeProp
-  } = parameters;
-  const elementRef = React.useRef(null);
-  const compositeRootContext = useCompositeRootContext(true);
-  const isCompositeItem = compositeProp ?? compositeRootContext !== undefined;
-  const {
-    props: focusableWhenDisabledProps
-  } = useFocusableWhenDisabled({
-    focusableWhenDisabled,
-    disabled,
-    composite: isCompositeItem,
-    tabIndex,
-    isNativeButton
-  });
-  if (process.env.NODE_ENV !== 'production') {
-    // eslint-disable-next-line react-hooks/rules-of-hooks
-    React.useEffect(() => {
-      if (!elementRef.current) {
-        return;
-      }
-      const isButtonTag = isButtonElement(elementRef.current);
-      if (isNativeButton) {
-        if (!isButtonTag) {
-          const ownerStackMessage = SafeReact.captureOwnerStack?.() || '';
-          const message = 'A component that acts as a button expected a native <button> because the ' + '`nativeButton` prop is true. Rendering a non-<button> removes native button ' + 'semantics, which can impact forms and accessibility. Use a real <button> in the ' + '`render` prop, or set `nativeButton` to `false`.';
-          error(`${message}${ownerStackMessage}`);
-        }
-      } else if (isButtonTag) {
-        const ownerStackMessage = SafeReact.captureOwnerStack?.() || '';
-        const message = 'A component that acts as a button expected a non-<button> because the `nativeButton` ' + 'prop is false. Rendering a <button> keeps native behavior while Base UI applies ' + 'non-native attributes and handlers, which can add unintended extra attributes (such ' + 'as `role` or `aria-disabled`). Use a non-<button> in the `render` prop, or set ' + '`nativeButton` to `true`.';
-        error(`${message}${ownerStackMessage}`);
-      }
-    }, [isNativeButton]);
-  }
-
-  // handles a disabled composite button rendering another button, e.g.
-  // <Toolbar.Button disabled render={<Menu.Trigger />} />
-  // the `disabled` prop needs to pass through 2 `useButton`s then finally
-  // delete the `disabled` attribute from DOM
-  const updateDisabled = React.useCallback(() => {
-    const element = elementRef.current;
-    if (!isButtonElement(element)) {
-      return;
-    }
-    if (isCompositeItem && disabled && focusableWhenDisabledProps.disabled === undefined && element.disabled) {
-      element.disabled = false;
-    }
-  }, [disabled, focusableWhenDisabledProps.disabled, isCompositeItem]);
-  useIsoLayoutEffect(updateDisabled, [updateDisabled]);
-  const getButtonProps = React.useCallback((externalProps = {}) => {
-    const {
-      onClick: externalOnClick,
-      onMouseDown: externalOnMouseDown,
-      onKeyUp: externalOnKeyUp,
-      onKeyDown: externalOnKeyDown,
-      onPointerDown: externalOnPointerDown,
-      ...otherExternalProps
-    } = externalProps;
-    return mergeProps({
-      onClick(event) {
-        if (disabled) {
-          event.preventDefault();
-          return;
-        }
-        externalOnClick?.(event);
-      },
-      onMouseDown(event) {
-        if (!disabled) {
-          externalOnMouseDown?.(event);
-        }
-      },
-      onKeyDown(event) {
-        if (disabled) {
-          return;
-        }
-        makeEventPreventable(event);
-        externalOnKeyDown?.(event);
-        if (event.baseUIHandlerPrevented) {
-          return;
-        }
-        const isCurrentTarget = event.target === event.currentTarget;
-        const currentTarget = event.currentTarget;
-        const isButton = isButtonElement(currentTarget);
-        const isLink = !isNativeButton && isValidLinkElement(currentTarget);
-        const shouldClick = isCurrentTarget && (isNativeButton ? isButton : !isLink);
-        const isEnterKey = event.key === 'Enter';
-        const isSpaceKey = event.key === ' ';
-        const role = currentTarget.getAttribute('role');
-        const isTextNavigationRole = role?.startsWith('menuitem') || role === 'option' || role === 'gridcell';
-        if (isCurrentTarget && isCompositeItem && isSpaceKey) {
-          if (event.defaultPrevented && isTextNavigationRole) {
-            return;
-          }
-          event.preventDefault();
-          if (isLink || isNativeButton && isButton) {
-            currentTarget.click();
-            event.preventBaseUIHandler();
-          } else if (shouldClick) {
-            externalOnClick?.(event);
-            event.preventBaseUIHandler();
-          }
-          return;
-        }
-
-        // Keyboard accessibility for native and non-native elements.
-        if (shouldClick) {
-          if (!isNativeButton && (isSpaceKey || isEnterKey)) {
-            event.preventDefault();
-          }
-          if (!isNativeButton && isEnterKey) {
-            externalOnClick?.(event);
-          }
-        }
-      },
-      onKeyUp(event) {
-        if (disabled) {
-          return;
-        }
-
-        // calling preventDefault in keyUp on a <button> will not dispatch a click event if Space is pressed
-        // https://codesandbox.io/p/sandbox/button-keyup-preventdefault-dn7f0
-        makeEventPreventable(event);
-        externalOnKeyUp?.(event);
-        if (event.target === event.currentTarget && isNativeButton && isCompositeItem && isButtonElement(event.currentTarget) && event.key === ' ') {
-          event.preventDefault();
-          return;
-        }
-        if (event.baseUIHandlerPrevented) {
-          return;
-        }
-
-        // Keyboard accessibility for non interactive elements
-        if (event.target === event.currentTarget && !isNativeButton && !isCompositeItem && event.key === ' ') {
-          externalOnClick?.(event);
-        }
-      },
-      onPointerDown(event) {
-        if (disabled) {
-          event.preventDefault();
-          return;
-        }
-        externalOnPointerDown?.(event);
-      }
-    }, isNativeButton ? {
-      type: 'button'
-    } : {
-      role: 'button'
-    }, focusableWhenDisabledProps, otherExternalProps);
-  }, [disabled, focusableWhenDisabledProps, isCompositeItem, isNativeButton]);
-  const buttonRef = useStableCallback(element => {
-    elementRef.current = element;
-    updateDisabled();
-  });
-  return {
-    getButtonProps,
-    buttonRef
-  };
-}
-function isButtonElement(elem) {
-  return isHTMLElement(elem) && elem.tagName === 'BUTTON';
-}
-function isValidLinkElement(elem) {
-  return Boolean(elem?.tagName === 'A' && elem?.href);
-}
-
-export { triggerHover as $, ios as A, addEventListener as B, none as C, visuallyHiddenInput as D, visuallyHidden as E, inputChange as F, inputClear as G, inputBlur as H, inputPaste as I, createGenericEventDetails as J, wheel as K, useOnMount as L, incrementPress as M, decrementPress as N, useValueChanged as O, keyboard as P, outsidePress as Q, cancelOpen as R, SafeReact as S, Timeout as T, windowResize as U, itemPress as V, isMouseLikePointerType as W, triggerFocus as X, mac as Y, triggerPress as Z, escapeKey as _, useIsoLayoutEffect as a, useAnimationsFinished as a0, siblingOpen as a1, useCompositeRootContext as a2, android as a3, closeWatcher as a4, TransitionStatusDataAttributes as a5, swipe as a6, inputPress as a7, clearPress as a8, chipRemovePress as a9, lowerUserAgent as aa, apple as ab, resolveRef as ac, isReactEvent as ad, isClickLikeEvent as ae, AnimationFrame as af, pointer as ag, scrub as ah, useStableCallback as b, useButton as c, createChangeEventDetails as d, closePress as e, useOpenChangeComplete as f, getTarget as g, useTimeout as h, imperativeAction as i, error as j, useTransitionStatus as k, useId as l, useValueAsRef as m, useAnimationFrame as n, ownerDocument as o, activeElement as p, contains as q, listNavigation as r, stopEvent as s, transitionStatusMapping as t, useBaseUiId as u, focusOut as v, isVirtualClick as w, isVirtualPointerEvent as x, jsdom as y, useControlled as z };