@astryxdesign/core 0.7.7-canary.fc68123 → 0.7.7

package/src/Toast/ToastViewport.tsx

@@ -21,7 +21,6 @@ import {
   useMemo,
   useRef,
   useState,
-  useSyncExternalStore,
 } from 'react';
 import type {ReactNode} from 'react';
 import {createPortal} from 'react-dom';
@@ -29,11 +28,6 @@ import * as stylex from '@stylexjs/stylex';
 import {spacingVars, durationVars, easeVars} from '../theme/tokens.stylex';
 import {mergeProps} from '../utils';
 import {getNodeText} from '../utils/getNodeText';
-import {
-  moveFocusLeftBehind,
-  noteFocusWithin,
-  type FocusWithin,
-} from '../utils/focusReturn';
 import {INTERACTIVE_SELECTORS} from '../hooks/useClickableContainer';
 import {useAnnounce} from '../hooks/useAnnounce';
 import {layerTextReset} from '../Layer/layerTextReset.stylex';
@@ -230,8 +224,6 @@ interface ToastRowProps {
   isReversed: boolean;
   onExited: (id: string) => void;
   onDismiss: (id: string, reason: ToastDismissReason) => void;
-  /** Whether the card carries its own live region (see ToastViewport). */
-  isLiveRegion: boolean;
 }
 
 /**
@@ -254,7 +246,6 @@ function ToastRow({
   isReversed,
   onExited,
   onDismiss,
-  isLiveRegion,
 }: ToastRowProps) {
   const o = entry.options;
   const type = o.type ?? 'info';
@@ -305,8 +296,6 @@ function ToastRow({
           gestureDirection={isReversed ? -1 : 1}
           onDismiss={reason => onDismiss(entry.id, reason)}
           renderContent={o.renderContent}
-          timerKey={entry.id}
-          isLiveRegion={isLiveRegion}
         />
       </div>
     </div>
@@ -314,9 +303,6 @@ function ToastRow({
 }
 ToastRow.displayName = 'ToastRow';
 
-const hasActiveModalOutlet = (): boolean => getActiveModalOutlet() != null;
-const hasNoModalOutlet = (): boolean => false;
-
 /**
  * Container that renders and manages toast notifications. Place at the root
  * of your app to enable useToast(). Toasts stack with enter/exit
@@ -377,13 +363,6 @@ export function ToastViewport({
   // The next toast id that should receive focus once the dismissed toast has
   // unmounted, or 'restore' to fall back to the previously-focused element.
   const pendingFocusRef = useRef<string | 'restore' | null>(null);
-  // The id of a toast whose overwrite updated a row that held focus. If the
-  // update removed the focused control, the commit hands focus off.
-  const overwriteFocusRef = useRef<{id: string; note: FocusWithin} | null>(
-    null,
-  );
-  // Where focus was inside a toast whose dismissal hands focus off.
-  const dismissFocusNoteRef = useRef<FocusWithin | null>(null);
 
   // Collect a focusable control within a toast node, if any.
   // Reuses the canonical INTERACTIVE_SELECTORS list (native controls plus
@@ -413,9 +392,13 @@ export function ToastViewport({
     [],
   );
 
-  // Announce toasts through the persistent singleton live regions. They are
-  // mounted empty and only mutated afterwards, which screen readers announce
-  // (see useAnnounce.ts). The announcement happens in addToast — the imperative
+  // Announce toasts through the persistent singleton live regions. Each
+  // <Toast> also renders its own role="status"/"alert" region, but that region
+  // is "born with content" — mounted together with its text — which many
+  // screen readers do not announce (see useAnnounce.ts); the singleton regions
+  // are mounted empty and only mutated afterwards, so they are what actually
+  // guarantees the announcement (the per-toast markup is kept for browse-mode
+  // discoverability). The announcement happens in addToast — the imperative
   // dispatch path invoked once per useToast() call from an event handler,
   // never from render — so each toast is announced exactly once by
   // construction, independent of the React render lifecycle (StrictMode
@@ -423,16 +406,6 @@ export function ToastViewport({
   // re-renders never re-announce). It is client-only (addToast never runs
   // during SSR), so it is SSR-safe.
   const announce = useAnnounce();
-  // An open native modal hides the body-level channel above from assistive
-  // technology, so while the viewport is hosted in one, each card announces
-  // itself through its own live region instead. Outside a modal the cards
-  // carry none, so a card updated in place is announced once.
-  const hasModalOutlet = useSyncExternalStore(
-    subscribeModalOutlets,
-    hasActiveModalOutlet,
-    hasNoModalOutlet,
-  );
-  const isModalHosted = isTopLayer && hasModalOutlet;
 
   const addToast = useCallback(
     (entry: ToastEntry) => {
@@ -468,29 +441,9 @@ export function ToastViewport({
       if (overwritten && renderedToastsRef.current.includes(overwritten)) {
         replacedRef.current.set(overwritten.id, overwritten);
       }
-      // An overwrite of a toast that is not leaving keeps its row, so the card
-      // updates in place and focus inside it stays. A leaving namesake
-      // is replaced by a new row, which enters again.
-      const keepsRow =
-        overwritten != null && !exitingIdsRef.current.has(overwritten.id);
-      const placed: ToastEntry = keepsRow
-        ? {...entry, rowKey: overwritten.rowKey ?? overwritten.id}
-        : entry;
-      if (keepsRow) {
-        // If the update removes the focused control, the commit hands focus
-        // off as a dismissal does.
-        const note = noteFocusWithin(
-          viewportRef.current?.querySelector<HTMLElement>(
-            `[data-toast-id="${overwritten.id}"]`,
-          ),
-        );
-        if (note != null) {
-          overwriteFocusRef.current = {id: placed.id, note};
-        }
-      }
       const projected = overwritten
-        ? committed.map(t => (t === overwritten ? placed : t))
-        : [...committed, placed];
+        ? committed.map(t => (t === overwritten ? entry : t))
+        : [...committed, entry];
       // `maxVisible={0}` shows every toast (FR7): nothing leaves the window.
       const firstVisible = maxVisible > 0 ? projected.length - maxVisible : 0;
       const cutIds = new Set(
@@ -517,7 +470,7 @@ export function ToastViewport({
           }
         }
       }
-      pending.set(entry.id, placed);
+      pending.set(entry.id, entry);
       // An overwrite swaps a new entry, with a new id, into the replaced
       // toast's place, so the old row leaves the DOM without ever being
       // dismissed. Its settled id is dropped by the prune below, which covers
@@ -529,8 +482,8 @@ export function ToastViewport({
         // overwrite into an append. An ignored collision already returned.
         const kept = prev.filter(t => !cutIds.has(t.id));
         return overwritten && kept.includes(overwritten)
-          ? kept.map(t => (t === overwritten ? placed : t))
-          : [...kept, placed];
+          ? kept.map(t => (t === overwritten ? entry : t))
+          : [...kept, entry];
       });
     },
     [announce, maxVisible],
@@ -559,23 +512,14 @@ export function ToastViewport({
     // focused before the user entered the viewport) rather than <body>.
     const el = viewportRef.current;
     const active = document.activeElement;
-    // A toast an overwrite replaced in place no longer owns its row: the
-    // replacement does, so dismissing the replaced toast leaves the row, and
-    // focus in it, to the replacement.
-    const rowKey = entry.rowKey ?? entry.id;
-    const isReplacedInPlace =
-      !toastsRef.current.some(t => t.id === id) &&
-      toastsRef.current.some(t => t.rowKey === rowKey);
-    const dismissedNode = isReplacedInPlace
-      ? null
-      : (el?.querySelector<HTMLElement>(`[data-toast-id="${id}"]`) ?? null);
+    const dismissedNode =
+      el?.querySelector<HTMLElement>(`[data-toast-id="${id}"]`) ?? null;
     if (
       dismissedNode &&
       active instanceof Node &&
       dismissedNode.contains(active)
     ) {
       focusHandoffIdRef.current = id;
-      dismissFocusNoteRef.current = noteFocusWithin(dismissedNode);
       // Pick the toast to receive focus while the DOM is still intact: the
       // nearest one after it, then before it, that shows once it is gone
       // (FR10), else restore. The list may already run ahead of the render
@@ -643,41 +587,6 @@ export function ToastViewport({
     setToasts(prev => prev.filter(t => t.id !== id));
   }, []);
 
-  // Moves focus to a control in the target toast, else in another toast that
-  // shows (newest first), else back to the element focused before focus
-  // entered the viewport, so a handoff never drops focus to <body>.
-  const handOffFocus = useCallback(
-    (note: FocusWithin | null, targetId: string | null) => {
-      const el = viewportRef.current;
-      const rowFor = (id: string) =>
-        el?.querySelector<HTMLElement>(`[data-toast-id="${id}"]`) ?? null;
-      const shownIds = toastsRef.current
-        .slice(maxVisibleRef.current > 0 ? -maxVisibleRef.current : 0)
-        .map(t => t.id)
-        .reverse();
-      const candidates =
-        targetId == null
-          ? []
-          : [targetId, ...shownIds.filter(id => id !== targetId)];
-      let target: HTMLElement | null = null;
-      for (const id of candidates) {
-        target = getFocusable(rowFor(id));
-        if (target != null) {
-          break;
-        }
-      }
-      const prev = prevFocusRef.current;
-      const isReturning = target == null && prev != null && prev.isConnected;
-      if (target == null) {
-        target = isReturning ? prev : el;
-      }
-      if (moveFocusLeftBehind(note, target) && isReturning) {
-        prevFocusRef.current = null;
-      }
-    },
-    [getFocusable],
-  );
-
   // After a dismissed toast unmounts, hand focus off so it never falls to
   // <body>. Runs in a layout effect once the toast list no longer contains
   // the dismissed toast.
@@ -693,21 +602,27 @@ export function ToastViewport({
     }
     focusHandoffIdRef.current = null;
     pendingFocusRef.current = null;
-    const note = dismissFocusNoteRef.current;
-    dismissFocusNoteRef.current = null;
-    handOffFocus(note, target === 'restore' ? null : target);
-  }, [toasts, handOffFocus]);
-
-  // After an overwrite updated a row that held focus: focus stays on the same
-  // control, or, if the update removed it, moves as a dismissal hands it off.
-  useLayoutEffect(() => {
-    const overwrite = overwriteFocusRef.current;
-    if (overwrite == null) {
-      return;
+    const el = viewportRef.current;
+    if (target !== 'restore' && el) {
+      const nextNode = el.querySelector<HTMLElement>(
+        `[data-toast-id="${target}"]`,
+      );
+      const focusable = getFocusable(nextNode) ?? nextNode;
+      if (focusable) {
+        focusable.focus();
+        return;
+      }
+    }
+    // No remaining toast to receive focus — restore the previously-focused
+    // element if it's still connected, else fall back to the container.
+    const prev = prevFocusRef.current;
+    prevFocusRef.current = null;
+    if (prev && prev.isConnected) {
+      prev.focus();
+    } else if (el) {
+      el.focus();
     }
-    overwriteFocusRef.current = null;
-    handOffFocus(overwrite.note, overwrite.id);
-  }, [toasts, handOffFocus]);
+  }, [toasts, getFocusable]);
 
   const findByUniqueID = useCallback((uid: string) => {
     return toastsRef.current.find(t => t.options.uniqueID === uid);
@@ -915,13 +830,12 @@ export function ToastViewport({
       <LayerContentBoundary>
         {visibleToasts.map(entry => (
           <ToastRow
-            key={entry.rowKey ?? entry.id}
+            key={entry.id}
             entry={entry}
             isExiting={exitingIds.has(entry.id)}
             isReversed={isReversed}
             onExited={handleExited}
             onDismiss={removeToast}
-            isLiveRegion={isModalHosted}
           />
         ))}
       </LayerContentBoundary>

package/src/Toast/types.ts

@@ -38,10 +38,9 @@ export interface ToastOptions {
   /**
    * Replaces the content of this toast's card with your own layout.
    *
-   * Astryx keeps the card and its auto-hide behavior (inside a
-   * `ToastViewport` the viewport announces the toast, and while a modal hosts
-   * the viewport the card announces itself), then hands the
-   * renderer this toast's content, resolved settings and `dismiss` callback. The renderer owns every control inside its layout; call
+   * Astryx keeps the card, live-region role and auto-hide behavior, then hands
+   * the renderer this toast's content, resolved settings and `dismiss`
+   * callback. The renderer owns every control inside its layout; call
    * `dismiss` from the control that should close the toast. Astryx does not
    * inject a fallback control into custom content.
    *
@@ -101,9 +100,4 @@ export interface ToastEntry {
   id: string;
   options: ToastOptions;
   createdAt: number;
-  /**
-   * The row's identity in the stack. A uniqueID overwrite keeps the replaced
-   * toast's, so the card updates in place and focus inside it stays.
-   */
-  rowKey?: string;
 }

package/src/Tooltip/useTooltip.doc.mjs

@@ -110,18 +110,6 @@ export const docs = {
       description:
         'Render function for the anchor-positioned tooltip content. The positioning opt-out is excluded: the tooltip always derives its position from placement/alignment.',
     },
-    {
-      name: 'show',
-      type: '() => void',
-      description:
-        'Opens the tooltip now and keeps it open until hide(), Escape, a press outside, or focus leaving its trigger. Its text is announced once, and onShow fires. Under a controlled isOpen it only calls onShow. Does nothing while isEnabled is false.',
-    },
-    {
-      name: 'hide',
-      type: '() => void',
-      description:
-        'Closes the tooltip now, and onHide fires. Under a controlled isOpen it only calls onHide.',
-    },
   ],
   usage: {
     description:
@@ -137,11 +125,6 @@ export const docs = {
         description:
           'Prefer the Tooltip component for standard wrapping; use the hook when the trigger is not a simple child.',
       },
-      {
-        guidance: true,
-        description:
-          'For a toggle-style trigger, have your own button call show() and hide() on each press. Give it aria-describedby and aria-controls set to describedBy, and aria-expanded (true while show() holds the tooltip, false after hide() or onHide), and keep its own accessible name. For an info icon, use InfoTip instead.',
-      },
       {
         guidance: false,
         description:
@@ -184,8 +167,6 @@ export const docsDense = {
     anchorId: 'CSS anchor name.',
     describedBy: 'ID for aria-describedby.',
     renderTooltip: 'renders anchor-positioned tooltip content.',
-    show: 'opens + holds until hide()/Escape/outside press/focus leave; announces once; onShow. Controlled: onShow only. No-op when disabled.',
-    hide: 'closes; onHide. Controlled: onHide only.',
   },
   usage: {
     description:
@@ -201,11 +182,6 @@ export const docsDense = {
         description:
           'Prefer Tooltip for standard wrapping; use hook when trigger is not simple child.',
       },
-      {
-        guidance: true,
-        description:
-          'Toggle-style trigger: own button calls show()/hide() per press, sets aria-describedby + aria-controls={describedBy}, aria-expanded (true while held), keeps its own name. Info icon: use InfoTip.',
-      },
       {
         guidance: false,
         description:

package/src/Tooltip/useTooltip.tsx

@@ -5,8 +5,7 @@
 /**
  * @file useTooltip.tsx
  * @input Uses useLayer, usePressPin, React hooks
- * @output Exports useTooltip hook with stable trigger refs for hover/focus/tap tooltips
- *   and imperative show() and hide() for an app-built toggle trigger,
+ * @output Exports useTooltip hook with stable trigger refs for hover/focus/tap tooltips,
  *   and the module-only useTooltipWithTriggerBehavior that InfoTip's press-to-pin uses
  * @position Layer hook; builds on useLayer for tooltip behavior
  *
@@ -18,11 +17,9 @@ import {
   useCallback,
   useEffect,
   useRef,
-  useState,
   type ReactNode,
   type RefCallback,
 } from 'react';
-import {createTriggerFocusGate} from '../utils/triggerFocus';
 import * as stylex from '@stylexjs/stylex';
 import {
   useLayerInternal,
@@ -219,25 +216,29 @@ export interface TooltipReturn {
     children: ReactNode,
     props?: Omit<ContextRenderProps, 'positioning'>,
   ) => ReactNode;
+}
 
-  /**
-   * Opens the tooltip now and keeps it open until `hide()`, Escape, a press
-   * outside, or focus leaving its trigger, as a pinned tooltip does. Its text
-   * is announced once. Reports through `onShow`. Under a controlled `isOpen`,
-   * it calls `onShow` and does not change `isOpen`. Does nothing while
-   * `isEnabled` is false.
-   *
-   * Use `show()` and `hide()` to build a toggle-style trigger: your own button
-   * calls them, sets `aria-describedby` and `aria-controls` to `describedBy`
-   * and `aria-expanded` (true while shown), and keeps its own accessible name.
-   */
-  show: () => void;
-
-  /**
-   * Closes the tooltip now. Reports through `onHide`. Under a controlled
-   * `isOpen`, it calls `onHide` and does not change `isOpen`.
-   */
-  hide: () => void;
+/**
+ * Check if an element is naturally focusable
+ */
+function isFocusable(element: HTMLElement): boolean {
+  // Elements with explicit tabindex
+  if (element.hasAttribute('tabindex')) {
+    return element.tabIndex >= 0;
+  }
+
+  // Naturally focusable elements
+  const focusableTags = ['A', 'BUTTON', 'INPUT', 'SELECT', 'TEXTAREA'];
+  if (focusableTags.includes(element.tagName)) {
+    return !(element as HTMLButtonElement).disabled;
+  }
+
+  // Elements with contenteditable
+  if (element.isContentEditable) {
+    return true;
+  }
+
+  return false;
 }
 
 /**
@@ -374,9 +375,6 @@ export function useTooltipWithTriggerBehavior(
     isHeldOpen: isPressHeldOpen,
     attach: attachPressPin,
     unpin: unpinPress,
-    hold: holdPress,
-    release: releasePress,
-    isAppHeld,
     isPinShown,
     touch: {
       isTouchPointerRef,
@@ -487,13 +485,32 @@ export function useTooltipWithTriggerBehavior(
     [isTouchPointerRef, layerId, scheduleHide],
   );
 
-  // Under `auto`, whether focus counts is decided when it arrives, and a
-  // focus that counted still hides on blur (utils/triggerFocus.ts).
-  const [focusGate] = useState(createTriggerFocusGate);
+  // Under `auto`, whether focus counts is decided when it arrives, not when
+  // the listeners attach: a roving-tabindex member that was `tabindex="-1"`
+  // then can be the tab stop now. A trigger that receives focus is focusable
+  // by definition; focus inside it counts only while the trigger is
+  // focusable too, so a plain wrapper still ignores its children's focus.
+  const isFocusForTrigger = useCallback(
+    (e: Event): boolean => {
+      if (focusTrigger === 'always') {
+        return true;
+      }
+      const triggerEl = e.currentTarget as HTMLElement | null;
+      return (
+        triggerEl != null && (e.target === triggerEl || isFocusable(triggerEl))
+      );
+    },
+    [focusTrigger],
+  );
+
+  // Whether the trigger's current focus counted when it arrived, so its blur
+  // hides the tooltip even if the trigger has since left the tab order.
+  const focusCountedRef = useRef(false);
 
   const handleFocusIn = useCallback(
     (e: Event) => {
-      if (!focusGate.focusIn(e, focusTrigger) || !isEnabled) {
+      focusCountedRef.current = isFocusForTrigger(e);
+      if (!isEnabled || !focusCountedRef.current) {
         return;
       }
       // A tap focuses the trigger it activates, and `:focus-visible` does not
@@ -514,9 +531,8 @@ export function useTooltipWithTriggerBehavior(
       showLayer();
     },
     [
-      focusGate,
-      focusTrigger,
       isEnabled,
+      isFocusForTrigger,
       isTouchInteraction,
       clearTimeouts,
       showLayer,
@@ -528,12 +544,13 @@ export function useTooltipWithTriggerBehavior(
   // which a held tooltip skips.
   const handleFocusOut = useCallback(
     (e: Event) => {
-      if (!focusGate.focusOut(e, focusTrigger)) {
+      if (!focusCountedRef.current && !isFocusForTrigger(e)) {
         return;
       }
+      focusCountedRef.current = false;
       scheduleHide();
     },
-    [focusGate, focusTrigger, scheduleHide],
+    [isFocusForTrigger, scheduleHide],
   );
 
   // Pressing the trigger hides its own tooltip: once the control is activated
@@ -545,10 +562,9 @@ export function useTooltipWithTriggerBehavior(
   // tooltip at all), so the touch path answers it first.
   const handlePointerDown = useCallback(
     (event: PointerEvent) => {
-      // A toggle trigger's press pins or closes through its click. The app's
-      // hide() closes a held tooltip. Neither path hides here or waits for a
-      // tap verdict.
-      if (isToggleTrigger(triggerRef.current) || isAppHeld()) {
+      // A press on a toggle trigger pins or closes through its click. It
+      // neither hides the preview here nor waits for a tap verdict.
+      if (isToggleTrigger(triggerRef.current)) {
         return;
       }
       if (handleTouchPointerDown(event)) {
@@ -560,14 +576,7 @@ export function useTooltipWithTriggerBehavior(
       clearTimeouts();
       hideLayer();
     },
-    [
-      isToggleTrigger,
-      isAppHeld,
-      handleTouchPointerDown,
-      isOpen,
-      clearTimeouts,
-      hideLayer,
-    ],
+    [isToggleTrigger, handleTouchPointerDown, isOpen, clearTimeouts, hideLayer],
   );
 
   // Interaction ref that handles event listeners only
@@ -600,7 +609,7 @@ export function useTooltipWithTriggerBehavior(
         el.addEventListener('pointerdown', handlePointerDown);
 
         // Focus listeners unless focus never opens the tooltip; `auto` decides
-        // per event (utils/triggerFocus.ts).
+        // per event (isFocusForTrigger).
         if (focusTrigger !== 'never') {
           el.addEventListener('focusin', handleFocusIn);
           el.addEventListener('focusout', handleFocusOut);
@@ -656,11 +665,9 @@ export function useTooltipWithTriggerBehavior(
       showLayer();
     } else {
       clearTimeouts();
-      // A pin or app hold ends when the consumer closes the tooltip.
-      unpinPress();
       hideLayer();
     }
-  }, [isOpen, clearTimeouts, showLayer, hideLayer, unpinPress]);
+  }, [isOpen, clearTimeouts, showLayer, hideLayer]);
 
   // Dismiss on Escape (WCAG 1.4.13 — dismissible) through the shared layer
   // stack. A visible tip is the top-most layer, so it takes the press and
@@ -756,16 +763,6 @@ export function useTooltipWithTriggerBehavior(
     ],
   );
 
-  const show = useCallback(() => {
-    clearTimeouts();
-    holdPress();
-  }, [clearTimeouts, holdPress]);
-
-  const hide = useCallback(() => {
-    clearTimeouts();
-    releasePress();
-  }, [clearTimeouts, releasePress]);
-
   return {
     ref,
     positionRef: layerRef,
@@ -773,7 +770,5 @@ export function useTooltipWithTriggerBehavior(
     anchorId: layerAnchorId,
     describedBy: layerId,
     renderTooltip,
-    show,
-    hide,
   };
 }

package/src/Typeahead/TypeaheadItem.doc.mjs

@@ -43,8 +43,7 @@ export const docs = {
     {
       name: 'group',
       type: 'string',
-      description:
-        'This prop has no effect. Set `item.auxiliaryData.group` on search-source items to group results in Typeahead or BaseTypeahead.',
+      description: 'Group label for grouping items visually.',
     },
   ],
 };
@@ -80,8 +79,7 @@ export const docsZh = {
     {
       name: 'group',
       type: 'string',
-      description:
-        '此属性不影响渲染。要在 Typeahead 或 BaseTypeahead 中分组，请在搜索源返回的结果项上设置 `item.auxiliaryData.group`。',
+      description: '用于视觉分组的分组标签。',
     },
   ],
 };
@@ -96,7 +94,6 @@ export const docsDense = {
     icon: 'Icon/avatar before label.',
     description: 'Text below label.',
     isDisabled: 'Visually disabled.',
-    group:
-      'No effect. Group results via `item.auxiliaryData.group` in the search source.',
+    group: 'Group label for visual grouping.',
   },
 };

package/src/Typeahead/TypeaheadItem.tsx

@@ -54,8 +54,7 @@ export interface TypeaheadItemProps<
   isDisabled?: boolean;
 
   /**
-   * This prop has no effect. Set `item.auxiliaryData.group` on search-source
-   * items to group results in Typeahead or BaseTypeahead.
+   * Group label for grouping items visually.
    */
   group?: string;
 }

package/src/gestures/PressTracker.ts

@@ -47,8 +47,7 @@
  */
 
 import {UIKIT_CONTROL, UIKIT_PAN, UIKIT_PRESS} from '../motion/uikit/gestures';
-// Importing the whole table bundles its curves into each press-tracking control.
-import {press as pressClocks} from '../motion/uikit/timing';
+import {timing} from '../motion/uikit/timing';
 import {travel} from './geometry';
 import type {GestureRecognizer, SelectionLock} from './GestureRecognizer';
 import type {TapGestureRecognizer} from './TapGestureRecognizer';
@@ -155,7 +154,7 @@ export const PRESS_PROFILES = {
     // The shared press styles release every surface on the deselect clock
     // until a control runs its own release (UIButton's 250 ms), so a
     // painter's `fading` never outlasts the fade it shows.
-    releaseMs: pressClocks.highlightOutMs,
+    releaseMs: timing.press.highlightOutMs,
   },
   /**
    * A table or collection cell: inside a scroll view it highlights after the
@@ -166,7 +165,7 @@ export const PRESS_PROFILES = {
     highlightDelay: 'inScrollers',
     cancelTravel: UIKIT_PAN.hysteresis.value,
     quickTapFlash: 0,
-    releaseMs: pressClocks.highlightOutMs,
+    releaseMs: timing.press.highlightOutMs,
   },
 } as const satisfies Record<string, PressProfile>;
 

package/src/gestures/README.md

@@ -96,10 +96,6 @@ Once a drag has claimed its finger, a second finger never breaks it.
 | `PinchGestureRecognizer`         | `UIPinchGestureRecognizer`         | continuous | `scale` (settable, to re-base it), `velocity` in scale per second, `focalPoint()`                                                                                                                                  |
 | `ScreenEdgePanGestureRecognizer` | `UIScreenEdgePanGestureRecognizer` | continuous | `edges`: `leading` / `trailing`, resolved against the view's writing direction; attached to an edge zone the view lies within; fails as soon as the touch lands outside every requested edge band; a finger's only |
 
-Each recognizer reports what it is in `kind` (`'tap'`, `'longPress'`,
-`'pan'`, `'screenEdgePan'`, `'swipe'`, `'pinch'`): code tells the family apart by it, never by `instanceof`
-(`architecture:react-component-runtime` INV13).
-
 A recognizer created with `claimsTouches: false` is a watcher (a tab bar
 that minimizes while the page scrolls): it never claims, so its element gets
 only passive listeners and a scroll never waits for it; it prevents no other
@@ -178,9 +174,7 @@ innerPan.requireToFail(edgePan);
 ## Touches in the view: `createPressTracker`
 
 A pressable control's view-level touch handling, with `UIControl`
-semantics, built by `createPressTracker(options)`: a factory, as
-`architecture:react-component-runtime` INV13 asks of the touch modules outside
-the recognizer family (`VelocityTracker` is still a class, its one listed gap):
+semantics:
 
 - `touchDown`, `touchDragInside` / `touchDragOutside`, `touchDragEnter` /
   `touchDragExit`, `touchUpInside` / `touchUpOutside`, `touchCancel`.