@astryxdesign/core 0.7.6 → 0.7.7-canary.1d04d40

package/dist/Layer/layerClickBoundary.js

@@ -6,7 +6,7 @@
  * @file layerClickBoundary.ts
  * @input React pointer, mouse, touch and click events on a layer root
  * @output Exports layerClickBoundary, the props every layer content root
- *   spreads, including the layer-root mark
+ *   spreads, including the layer-root mark; also stopInReactTree
  * @position Internal to Layer; used by useLayer's renderers and the Dialog,
  *   Drawer, Lightbox, MobileNav, BottomSheetPanel and ToastViewport roots.
  *   Not exported from the package.
@@ -30,7 +30,7 @@ const returnTrue = () => true;
  * React's dispatch asks `isPropagationStopped()` before each further
  * listener; the native event is left alone.
  */
-function stopInReactTree(event) {
+export function stopInReactTree(event) {
   event.isPropagationStopped = returnTrue;
 }
 

package/dist/Layer/usePressPin.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @file usePressPin.ts
+ * @input A hover layer's trigger, open state, show and hide, and its
+ *   `triggerBehavior` and `touchTrigger` options
+ * @output usePressPin, the press toggle that pins a hover layer open;
+ *   isPressPinTrigger; stopPressPinClick; the LayerTriggerBehavior type
+ * @position Core-internal: one call per hover layer, useTooltip's. It owns
+ *   the layer's touch trigger, so the host makes no second touch-trigger call.
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/Tooltip/useTooltip.tsx
+ * - /packages/core/src/Layer/usePressPin.test.tsx
+ */
+import { type MouseEvent as ReactMouseEvent, type RefObject } from 'react';
+import { type LayerTouchTrigger, type UseTouchTriggerReturn } from './useTouchTrigger.js';
+/**
+ * How the trigger opens the layer. `adaptive`, the default, previews it on
+ * hover and focus, and a tap opens it unless the trigger acts. While
+ * `touchTrigger` remains, it decides those taps. `hover` previews it on hover
+ * and focus, and no touch or pen tap opens it. `toggle` pins it on every
+ * press of a button trigger.
+ */
+export type LayerTriggerBehavior = 'adaptive' | 'hover' | 'toggle';
+/**
+ * The layer component's wrapper handler. It stops a press that pinned or
+ * closed the layer in the React tree only, after the trigger's own handlers.
+ * No clickable row, card, or container around the trigger then receives it,
+ * and document and window listeners still do. An anchored trigger has no
+ * wrapper, so a plain `onClick` element around it still receives the press.
+ */
+export declare function stopPressPinClick(event: ReactMouseEvent): void;
+/** Whether presses on this element can pin a layer: a button, by role. */
+export declare function isPressPinTrigger(element: Element): boolean;
+export interface UsePressPinOptions {
+    /** The layer's `triggerBehavior`. */
+    triggerBehavior: LayerTriggerBehavior;
+    /** Whether the layer's triggers are live at all. */
+    isEnabled: boolean;
+    /** The controlled open value, or `undefined` when uncontrolled. */
+    isOpen: boolean | undefined;
+    /** Whether the layer shows now. */
+    isLayerOpen: boolean;
+    /** The layer surface's element id. */
+    layerId: string;
+    /** The component its development warning names. */
+    component: string;
+    /** Shows the layer now, with no delay. */
+    show: () => void;
+    /** Hides the layer now. */
+    hide: () => void;
+    /** Reports a controlled layer's toggled value without changing it. */
+    report: (isOpen: boolean) => void;
+    /** The layer's `label`: a press that pins the layer says it once, in place of its text. */
+    label?: string;
+    /** The layer's `touchTrigger`, which decides taps only under `adaptive`. */
+    touchTrigger: LayerTouchTrigger;
+    /** The host's trigger element, which the touch trigger reads. */
+    triggerRef: RefObject<HTMLElement | null>;
+}
+export interface UsePressPinReturn {
+    /** Whether presses on this trigger pin the layer: toggle mode and a button. */
+    isToggleTrigger: (element: HTMLElement | null) => boolean;
+    /**
+     * Whether a press holds the layer open now: a pin on a wired trigger while
+     * the layer shows, or a controlled layer's open value. The host's hover and
+     * focus hides ask it.
+     */
+    isHeldOpen: () => boolean;
+    /** Wires the trigger element, or unwires it with `null`. */
+    attach: (element: HTMLElement | null) => void;
+    /** Drops the pin: Escape, or a hide that came from elsewhere. */
+    unpin: () => void;
+    /**
+     * While pinned, focus moving onto an element outside the trigger and the
+     * layer closes it. Returns whether the pin decided. The pin calls it for its
+     * trigger, and a host calls it for the layer's own content.
+     */
+    handleFocusLeave: (event: FocusEvent) => boolean;
+    /**
+     * Whether the layer shows pinned on a wired trigger. The host then announces
+     * its rendered text, unless the layer has a `label`.
+     */
+    isPinShown: boolean;
+    /** The layer's touch trigger (useTouchTriggerInternal), wired to the pin. */
+    touch: Pick<UseTouchTriggerReturn, 'isTouchPointerRef' | 'isTouchInteraction' | 'handlePointerEnter' | 'handlePointerDown' | 'clearTapOpen'>;
+}
+/**
+ * Pins a hover layer open on a press of a button trigger, under
+ * `triggerBehavior="toggle"`. The same press closes it, and so do Escape, a
+ * press or scroll outside, and focus that leaves the trigger and the layer.
+ * The press stops at the trigger. A trigger that is not a button gets a
+ * development warning and keeps tap-only opening.
+ */
+export declare function usePressPin(options: UsePressPinOptions): UsePressPinReturn;
+//# sourceMappingURL=usePressPin.d.ts.map

package/dist/Layer/usePressPin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePressPin.d.ts","sourceRoot":"","sources":["../../src/Layer/usePressPin.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAKL,KAAK,UAAU,IAAI,eAAe,EAClC,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAE3B;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAKnE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAI9D;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAM3D;AAED,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,eAAe,EAAE,oBAAoB,CAAC;IACtC,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,mCAAmC;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,sEAAsE;IACtE,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAClC,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,YAAY,EAAE,iBAAiB,CAAC;IAChC,iEAAiE;IACjE,UAAU,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,eAAe,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,OAAO,CAAC;IAC1D;;;;OAIG;IACH,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,4DAA4D;IAC5D,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9C,iEAAiE;IACjE,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;IACjD;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,KAAK,EAAE,IAAI,CACT,qBAAqB,EACnB,mBAAmB,GACnB,oBAAoB,GACpB,oBAAoB,GACpB,mBAAmB,GACnB,cAAc,CACjB,CAAC;CACH;AAwBD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAgU1E"}

package/dist/Layer/usePressPin.js

@@ -0,0 +1,335 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file usePressPin.ts
+ * @input A hover layer's trigger, open state, show and hide, and its
+ *   `triggerBehavior` and `touchTrigger` options
+ * @output usePressPin, the press toggle that pins a hover layer open;
+ *   isPressPinTrigger; stopPressPinClick; the LayerTriggerBehavior type
+ * @position Core-internal: one call per hover layer, useTooltip's. It owns
+ *   the layer's touch trigger, so the host makes no second touch-trigger call.
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/Tooltip/useTooltip.tsx
+ * - /packages/core/src/Layer/usePressPin.test.tsx
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { useAnnounce } from "../hooks/useAnnounce.js";
+import { useDevWarning } from "../hooks/useDevWarning.js";
+import { stopInReactTree } from "./layerClickBoundary.js";
+import { useTouchTriggerInternal } from "./useTouchTrigger.js";
+
+/**
+ * How the trigger opens the layer. `adaptive`, the default, previews it on
+ * hover and focus, and a tap opens it unless the trigger acts. While
+ * `touchTrigger` remains, it decides those taps. `hover` previews it on hover
+ * and focus, and no touch or pen tap opens it. `toggle` pins it on every
+ * press of a button trigger.
+ */
+
+/** The clicks a press pin answered, so the wrapper can stop them (`stopPressPinClick`). */
+const pressPinClicks = new WeakSet();
+
+/**
+ * The layer component's wrapper handler. It stops a press that pinned or
+ * closed the layer in the React tree only, after the trigger's own handlers.
+ * No clickable row, card, or container around the trigger then receives it,
+ * and document and window listeners still do. An anchored trigger has no
+ * wrapper, so a plain `onClick` element around it still receives the press.
+ */
+export function stopPressPinClick(event) {
+  if (pressPinClicks.has(event.nativeEvent)) {
+    stopInReactTree(event);
+  }
+}
+
+/** Whether presses on this element can pin a layer: a button, by role. */
+export function isPressPinTrigger(element) {
+  const role = element.getAttribute('role');
+  if (role != null && role !== '') {
+    return role === 'button';
+  }
+  return element.tagName === 'BUTTON';
+}
+function restoreAttribute(element, name, value) {
+  if (value == null) {
+    element.removeAttribute(name);
+  } else {
+    element.setAttribute(name, value);
+  }
+}
+function writeAttribute(element, name, value) {
+  if (element.getAttribute(name) !== value) {
+    restoreAttribute(element, name, value);
+  }
+}
+
+/**
+ * Pins a hover layer open on a press of a button trigger, under
+ * `triggerBehavior="toggle"`. The same press closes it, and so do Escape, a
+ * press or scroll outside, and focus that leaves the trigger and the layer.
+ * The press stops at the trigger. A trigger that is not a button gets a
+ * development warning and keeps tap-only opening.
+ */
+export function usePressPin(options) {
+  const {
+    triggerBehavior,
+    isOpen,
+    isLayerOpen,
+    layerId
+  } = options;
+  const isToggleMode = triggerBehavior === 'toggle';
+
+  // DOM listeners read the latest options and announcer through refs. The
+  // announcer is the layer's own: inside a modal, the modal's region.
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  const announce = useAnnounce();
+  const announceRef = useRef(announce);
+  announceRef.current = announce;
+  const isPinnedRef = useRef(false);
+  const [isPinned, setIsPinnedState] = useState(false);
+  const setPinned = useCallback(next => {
+    isPinnedRef.current = next;
+    setIsPinnedState(next);
+  }, []);
+
+  // Refs hold the wired trigger and last offered element for a later rewire.
+  const triggerRef = useRef(null);
+  const offeredRef = useRef(null);
+  // A primitive: re-attaching the same trigger renders nothing.
+  const [offeredKind, setOfferedKind] = useState('none');
+  // The trigger's own aria-expanded and aria-controls, restored on unwiring.
+  const ownStateRef = useRef(null);
+
+  // The touch trigger's outside dismissal (a press or scroll outside) closes
+  // a pinned layer through the pin, so the pin drops with it.
+  const hideFromTouch = useCallback(() => {
+    const current = optionsRef.current;
+    if (current.triggerBehavior === 'toggle' && triggerRef.current != null) {
+      if (current.isOpen !== undefined) {
+        current.report(false);
+        return;
+      }
+      if (isPinnedRef.current) {
+        setPinned(false);
+      }
+    }
+    current.hide();
+  }, [setPinned]);
+  const {
+    isTouchPointerRef,
+    isTouchInteraction,
+    handlePointerEnter,
+    handlePointerDown,
+    clearTapOpen,
+    armOutsideDismiss
+  } = useTouchTriggerInternal({
+    touchTrigger: isToggleMode ? 'tap' : triggerBehavior === 'hover' ? 'none' : options.touchTrigger,
+    isEnabled: options.isEnabled,
+    isControlled: isOpen !== undefined,
+    isOpen: isLayerOpen,
+    layerId,
+    triggerRef: options.triggerRef,
+    show: options.show,
+    hide: hideFromTouch
+  });
+  const isToggleTrigger = useCallback(element => optionsRef.current.triggerBehavior === 'toggle' && element != null && isPressPinTrigger(element), []);
+  const close = useCallback(() => {
+    const current = optionsRef.current;
+    clearTapOpen();
+    if (current.isOpen !== undefined) {
+      current.report(false);
+      return;
+    }
+    setPinned(false);
+    current.hide();
+  }, [setPinned, clearTapOpen]);
+  const announceName = useCallback(() => {
+    const current = optionsRef.current;
+    const name = current.label?.trim() ?? '';
+    if (name !== '') {
+      announceRef.current(name, 'polite');
+    }
+  }, []);
+  const toggle = useCallback(() => {
+    const current = optionsRef.current;
+    if (current.isOpen !== undefined) {
+      if (!current.isOpen) {
+        armOutsideDismiss();
+        announceName();
+      } else {
+        clearTapOpen();
+      }
+      current.report(!current.isOpen);
+      return;
+    }
+    // A pin counts only while its layer shows; a closed layer pins again.
+    if (isPinnedRef.current && current.isLayerOpen) {
+      setPinned(false);
+      clearTapOpen();
+      current.hide();
+    } else {
+      setPinned(true);
+      current.show();
+      armOutsideDismiss();
+      announceName();
+    }
+  }, [setPinned, announceName, armOutsideDismiss, clearTapOpen]);
+
+  // Enter or Space presses a non-native button, which gets no click from the
+  // browser. A same-task click from its own key handler is that press.
+  const keyPressedRef = useRef(false);
+  const handlePress = useCallback(event => {
+    const current = optionsRef.current;
+    if (!current.isEnabled || current.triggerBehavior !== 'toggle') {
+      return;
+    }
+    // The press stops at its trigger: no label control, link, or submit.
+    event.preventDefault();
+    pressPinClicks.add(event);
+    if (keyPressedRef.current && event.detail === 0) {
+      return;
+    }
+    toggle();
+  }, [toggle]);
+  const handleKeyDown = useCallback(event => {
+    const current = optionsRef.current;
+    if (!current.isEnabled || current.triggerBehavior !== 'toggle' || event.repeat || event.isComposing || event.key !== 'Enter' && event.key !== ' ') {
+      return;
+    }
+    event.preventDefault();
+    keyPressedRef.current = true;
+    setTimeout(() => {
+      keyPressedRef.current = false;
+    }, 0);
+    toggle();
+  }, [toggle]);
+  const isHeldOpen = useCallback(() => {
+    const current = optionsRef.current;
+    if (current.triggerBehavior !== 'toggle' || triggerRef.current == null) {
+      return false;
+    }
+    return current.isOpen !== undefined ? current.isOpen && current.isLayerOpen : isPinnedRef.current && current.isLayerOpen;
+  }, []);
+  const handleFocusLeave = useCallback(event => {
+    if (!isHeldOpen()) {
+      return false;
+    }
+    const next = event.relatedTarget;
+    const trigger = triggerRef.current;
+    // Focus that leaves for no element is a press's to decide. The trigger
+    // can sit in another document, so the check uses its own window.
+    const view = trigger?.ownerDocument.defaultView;
+    if (view == null || !(next instanceof view.Node)) {
+      return true;
+    }
+    const surface = trigger?.ownerDocument.getElementById(optionsRef.current.layerId) ?? null;
+    if (trigger?.contains(next) === true || surface?.contains(next) === true) {
+      return true;
+    }
+    close();
+    return true;
+  }, [isHeldOpen, close]);
+  const unwire = useCallback(() => {
+    const previous = triggerRef.current;
+    if (previous == null) {
+      return;
+    }
+    previous.removeEventListener('click', handlePress);
+    previous.removeEventListener('keydown', handleKeyDown);
+    previous.removeEventListener('focusout', handleFocusLeave);
+    const own = ownStateRef.current;
+    if (own != null) {
+      restoreAttribute(previous, 'aria-expanded', own.expanded);
+      restoreAttribute(previous, 'aria-controls', own.controls);
+    }
+    ownStateRef.current = null;
+    triggerRef.current = null;
+  }, [handlePress, handleKeyDown, handleFocusLeave]);
+
+  // The element and mode last settled; the same pair again does nothing.
+  const settledRef = useRef(null);
+  const wire = useCallback(element => {
+    const current = optionsRef.current;
+    const settled = settledRef.current;
+    if (settled != null && settled.element === element && settled.mode === current.triggerBehavior) {
+      return;
+    }
+    settledRef.current = {
+      element,
+      mode: current.triggerBehavior
+    };
+    unwire();
+    if (element == null || current.triggerBehavior !== 'toggle') {
+      return;
+    }
+    if (!isPressPinTrigger(element)) {
+      return;
+    }
+    element.addEventListener('click', handlePress);
+    if (element.tagName !== 'BUTTON') {
+      element.addEventListener('keydown', handleKeyDown);
+    }
+    // Its own focus-leave listener: `focusTrigger="never"` attaches none.
+    element.addEventListener('focusout', handleFocusLeave);
+    ownStateRef.current = {
+      expanded: element.getAttribute('aria-expanded'),
+      controls: element.getAttribute('aria-controls')
+    };
+    triggerRef.current = element;
+  }, [unwire, handlePress, handleKeyDown, handleFocusLeave]);
+  const attach = useCallback(element => {
+    offeredRef.current = element;
+    // Hosts detach and re-attach within one commit, so a detach is not kept.
+    if (element != null) {
+      setOfferedKind(isPressPinTrigger(element) ? 'button' : 'other');
+    }
+    wire(element);
+  }, [wire]);
+  const isWired = isToggleMode && offeredKind === 'button';
+  useDevWarning(options.component, '`triggerBehavior="toggle"` pins only a button trigger (a <button> or role="button"); this trigger keeps tap-only opening.', isToggleMode && offeredKind === 'other');
+
+  // A later `triggerBehavior` change rewires here; the ref does not rerun.
+  useEffect(() => {
+    wire(offeredRef.current);
+  }, [triggerBehavior, wire]);
+  const unpin = useCallback(() => {
+    if (isPinnedRef.current) {
+      setPinned(false);
+    }
+  }, [setPinned]);
+
+  // Each path that hides a pinned layer drops the pin itself, so a layer that
+  // does not show is never reported expanded.
+  const isExpanded = (isOpen !== undefined ? isOpen : isPinned) && isLayerOpen;
+
+  // The trigger's aria-expanded and aria-controls follow the pin. No deps: a
+  // host can swap the trigger on any commit; equal values are not rewritten.
+  useEffect(() => {
+    const trigger = triggerRef.current;
+    if (!isToggleMode || !isWired || trigger == null) {
+      return;
+    }
+    writeAttribute(trigger, 'aria-expanded', isExpanded ? 'true' : 'false');
+    writeAttribute(trigger, 'aria-controls', isLayerOpen ? layerId : null);
+  });
+  const isPinShown = isToggleMode && isWired && isExpanded;
+  return {
+    isToggleTrigger,
+    isHeldOpen,
+    attach,
+    unpin,
+    handleFocusLeave,
+    isPinShown,
+    touch: {
+      isTouchPointerRef,
+      isTouchInteraction,
+      handlePointerEnter,
+      handlePointerDown,
+      clearTapOpen
+    }
+  };
+}

package/dist/Layer/useTouchTrigger.d.ts

@@ -3,7 +3,8 @@
  * @input Touch trigger mode, layer open state, trigger ref, show/hide callbacks
  * @output Exports useTouchTrigger hook, isActionTrigger, LayerTouchTrigger type,
  *   tapLandsOnDisabledControl, TOUCH_POINTER_TYPES and useTapStop (internal:
- *   not re-exported from index)
+ *   not re-exported from index). Also useTouchTriggerInternal, with the
+ *   outside dismissal's arm for the press pin (Core-internal).
  * @position Layer hook; shared touch behavior for useTooltip and useHoverCard
  *
  * SYNC: When modified, update:
@@ -137,6 +138,20 @@ export interface UseTouchTriggerReturn {
     /** Forget a tap-open. Call from every other close path (Escape, controlled). */
     clearTapOpen: () => void;
 }
+/**
+ * useTouchTrigger's return plus the outside dismissal's arm, for Core's own
+ * press pin (usePressPin). Not exported from the Layer entry point.
+ *
+ * @internal
+ */
+export interface UseTouchTriggerInternalReturn extends UseTouchTriggerReturn {
+    /**
+     * Arms the outside dismissal a tap-open gets: a press that lifts outside
+     * the trigger and the layer, or a scroll that starts there, hides it. A
+     * press pin arms it too.
+     */
+    armOutsideDismiss: () => void;
+}
 /**
  * Touch behavior shared by the hover layers.
  *
@@ -155,4 +170,11 @@ export interface UseTouchTriggerReturn {
  * ```
  */
 export declare function useTouchTrigger(options: UseTouchTriggerOptions): UseTouchTriggerReturn;
+/**
+ * useTouchTrigger, plus the outside dismissal's arm that a press pin uses to
+ * close on a press or scroll outside.
+ *
+ * @internal
+ */
+export declare function useTouchTriggerInternal(options: UseTouchTriggerOptions): UseTouchTriggerInternalReturn;
 //# sourceMappingURL=useTouchTrigger.d.ts.map

package/dist/Layer/useTouchTrigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTouchTrigger.d.ts","sourceRoot":"","sources":["../../src/Layer/useTouchTrigger.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAIL,KAAK,UAAU,IAAI,eAAe,EAClC,KAAK,YAAY,IAAI,iBAAiB,EACtC,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AASf;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,aAA4B,CAAC;AAE7D,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG;IAC1C,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAC3D,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CACpD,CAAC;AACF,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG;IAC9C,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAC3D,WAAW,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CACxD,CAAC;AAwCF;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CA8B7D;AAiBD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAUlE;AAeD,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,YAAY,EAAE,iBAAiB,CAAC;IAEhC,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAC;IAEhB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAEhB,oDAAoD;IACpD,UAAU,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAE1C,uDAAuD;IACvD,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB,mCAAmC;IACnC,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,iBAAiB,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAEtC;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,OAAO,CAAC;IAElC;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAElD;;;;;;OAMG;IACH,iBAAiB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IAEpD,gFAAgF;IAChF,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CA4MvB"}
+{"version":3,"file":"useTouchTrigger.d.ts","sourceRoot":"","sources":["../../src/Layer/useTouchTrigger.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAIL,KAAK,UAAU,IAAI,eAAe,EAClC,KAAK,YAAY,IAAI,iBAAiB,EACtC,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AASf;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,aAA4B,CAAC;AAE7D,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG;IAC1C,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAC3D,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CACpD,CAAC;AACF,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG;IAC9C,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAC3D,WAAW,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CACxD,CAAC;AAwCF;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CA8B7D;AAiBD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAUlE;AAeD,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,YAAY,EAAE,iBAAiB,CAAC;IAEhC,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAC;IAEhB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAEhB,oDAAoD;IACpD,UAAU,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAE1C,uDAAuD;IACvD,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB,mCAAmC;IACnC,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,iBAAiB,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAEtC;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,OAAO,CAAC;IAElC;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAElD;;;;;;OAMG;IACH,iBAAiB,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IAEpD,gFAAgF;IAChF,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,6BAA8B,SAAQ,qBAAqB;IAC1E;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CASvB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,sBAAsB,GAC9B,6BAA6B,CA6M/B"}

package/dist/Layer/useTouchTrigger.js

@@ -7,7 +7,8 @@
  * @input Touch trigger mode, layer open state, trigger ref, show/hide callbacks
  * @output Exports useTouchTrigger hook, isActionTrigger, LayerTouchTrigger type,
  *   tapLandsOnDisabledControl, TOUCH_POINTER_TYPES and useTapStop (internal:
- *   not re-exported from index)
+ *   not re-exported from index). Also useTouchTriggerInternal, with the
+ *   outside dismissal's arm for the press pin (Core-internal).
  * @position Layer hook; shared touch behavior for useTooltip and useHoverCard
  *
  * SYNC: When modified, update:
@@ -176,6 +177,14 @@ function isEditable(element) {
   const attribute = element.getAttribute('contenteditable');
   return attribute != null && attribute !== 'false';
 }
+
+/**
+ * useTouchTrigger's return plus the outside dismissal's arm, for Core's own
+ * press pin (usePressPin). Not exported from the Layer entry point.
+ *
+ * @internal
+ */
+
 /**
  * Touch behavior shared by the hover layers.
  *
@@ -194,6 +203,23 @@ function isEditable(element) {
  * ```
  */
 export function useTouchTrigger(options) {
+  const touch = useTouchTriggerInternal(options);
+  return {
+    isTouchPointerRef: touch.isTouchPointerRef,
+    isTouchInteraction: touch.isTouchInteraction,
+    handlePointerEnter: touch.handlePointerEnter,
+    handlePointerDown: touch.handlePointerDown,
+    clearTapOpen: touch.clearTapOpen
+  };
+}
+
+/**
+ * useTouchTrigger, plus the outside dismissal's arm that a press pin uses to
+ * close on a press or scroll outside.
+ *
+ * @internal
+ */
+export function useTouchTriggerInternal(options) {
   const {
     touchTrigger,
     isEnabled,
@@ -358,6 +384,7 @@ export function useTouchTrigger(options) {
     isTouchInteraction,
     handlePointerEnter,
     handlePointerDown,
-    clearTapOpen: disarmOutsideDismiss
+    clearTapOpen: disarmOutsideDismiss,
+    armOutsideDismiss
   };
 }

package/dist/Link/Link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../src/Link/Link.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAc5C,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,SAAS,CAAC;AAoH/C,MAAM,WAAW,SAAU,SAAQ,SAAS,CAC1C,iBAAiB,GAAG,iBAAiB,CACtC;IACC,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,CAAC;IACvD;;;;;OAKG;IACH,EAAE,CAAC,EAAE,iBAAiB,CAAC;IACvB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,2BAA2B,CAAC;IACnD;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,CAAC;IACzE;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,EACnB,EAAE,EACF,KAAK,EACL,IAAI,EACJ,YAAoB,EACpB,UAAkB,EAClB,cAAsB,EACtB,WAAW,EAAE,oBAAoB,EACjC,MAAM,EAAE,eAAe,EACvB,OAAO,EACP,OAAO,EACP,YAAoB,EACpB,IAAa,EACb,IAAI,EACJ,MAAM,EACN,KAAgB,EAChB,OAAkB,EAClB,QAAY,EACZ,QAAQ,EACR,GAAG,EAAE,YAAY,EACjB,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,EACH,GAAG,KAAK,EACT,EAAE,SAAS,+BA8JX;yBAvLe,IAAI"}
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../src/Link/Link.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAc5C,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,SAAS,CAAC;AAuH/C,MAAM,WAAW,SAAU,SAAQ,SAAS,CAC1C,iBAAiB,GAAG,iBAAiB,CACtC;IACC,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,CAAC;IACvD;;;;;OAKG;IACH,EAAE,CAAC,EAAE,iBAAiB,CAAC;IACvB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,2BAA2B,CAAC;IACnD;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,CAAC;IACzE;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,EACnB,EAAE,EACF,KAAK,EACL,IAAI,EACJ,YAAoB,EACpB,UAAkB,EAClB,cAAsB,EACtB,WAAW,EAAE,oBAAoB,EACjC,MAAM,EAAE,eAAe,EACvB,OAAO,EACP,OAAO,EACP,YAAoB,EACpB,IAAa,EACb,IAAI,EACJ,MAAM,EACN,KAAgB,EAChB,OAAkB,EAClB,QAAY,EACZ,QAAQ,EACR,GAAG,EAAE,YAAY,EACjB,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,EACH,GAAG,KAAK,EACT,EAAE,SAAS,+BA8JX;yBAvLe,IAAI"}

package/dist/Link/Link.js

@@ -64,6 +64,7 @@ const styles = {
     kWkggS: "xjbqb8w",
     ksu8eU: "xng3xce",
     kmVPX3: "x1717udv",
+    k9WMMc: "x16tdsg8",
     kfzvcC: "x67bb7w",
     kVAEAm: "x1n2onr6",
     $$css: true

package/dist/ProgressBar/ProgressBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProgressBar.d.ts","sourceRoot":"","sources":["../../src/ProgressBar/ProgressBar.tsx"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAG5C,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,SAAS,CAAC;AAUnD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,qBAAqB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAiB,SAAQ,SAAS,CAAC,cAAc,CAAC;IACjE,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1D;;;OAGG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACvC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAqSD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAS,EACT,GAAS,EACT,KAAK,EACL,aAAqB,EACrB,aAAqB,EACrB,gBAA0C,EAC1C,OAAkB,EAClB,eAAuB,EACvB,UAAkB,EAClB,KAAK,EACL,MAAM,EACN,SAAS,EACT,KAAK,EACL,aAAa,EAAE,UAAU,EACzB,GAAG,EACH,GAAG,IAAI,EACR,EAAE,gBAAgB,+BA8JlB;yBA/Ke,WAAW"}
+{"version":3,"file":"ProgressBar.d.ts","sourceRoot":"","sources":["../../src/ProgressBar/ProgressBar.tsx"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAG5C,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,SAAS,CAAC;AAWnD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,qBAAqB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAiB,SAAQ,SAAS,CAAC,cAAc,CAAC;IACjE,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1D;;;OAGG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACvC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA6VD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAS,EACT,GAAS,EACT,KAAK,EACL,aAAqB,EACrB,aAAqB,EACrB,gBAA0C,EAC1C,OAAkB,EAClB,eAAuB,EACvB,UAAkB,EAClB,KAAK,EACL,MAAM,EACN,SAAS,EACT,KAAK,EACL,aAAa,EAAE,UAAU,EACzB,GAAG,EACH,GAAG,IAAI,EACR,EAAE,gBAAgB,+BA4KlB;yBA7Le,WAAW"}