@astryxdesign/core 0.7.8-canary.36cde5e → 0.7.8-canary.4934ffc

package/dist/PowerSearch/PowerSearch.d.ts

@@ -4,8 +4,8 @@
  *   useAdaptivePresentation, and PowerSearchBottomSheet (lazy)
  * @output Structured filter bar with token-based filter management
  * @position Main component; forwards DOM ref and exposes tokenizer control via
- *   handleRef. The experimental `presentation` option swaps the tokenizer
- *   field and editor popover for one trigger that opens PowerSearchBottomSheet.
+ *   handleRef. The `presentation` prop swaps the tokenizer field and editor
+ *   popover for one trigger that opens PowerSearchBottomSheet.
  *
  * SYNC: When modified, update:
  * - /packages/core/src/PowerSearch/index.ts
@@ -17,6 +17,7 @@ import type { BaseProps } from '../BaseProps.js';
 import { type TokenizerOverflowBehavior } from '../Tokenizer/index.js';
 import type { IconType } from '../Icon/index.js';
 import type { InputStatus } from '../Field/index.js';
+import { type AdaptivePresentation } from '../hooks/useAdaptivePresentation.js';
 import type { PowerSearchConfig, PowerSearchFilter, PowerSearchChangeType, PowerSearchHandle, PowerSearchComponents } from './types.js';
 import type { FieldStatusPlacement } from '../Field/fieldStatusPlacement.js';
 export type PowerSearchSize = 'sm' | 'md' | 'lg';
@@ -122,36 +123,31 @@ export interface PowerSearchProps extends Omit<BaseProps<HTMLElement>, 'onChange
      */
     components?: PowerSearchComponents;
     /**
-     * Experimental options, outside the stable compatibility promise: anything
-     * in this object may change or be removed in a patch release. Omit it for
-     * the stable behavior.
-     * @experimental
+     * How the field presents filter editing.
+     * - `'popover'`: the tokenizer field with its typeahead and the editor
+     *   popover, on every device.
+     * - `'bottom-sheet'`: the whole field is one trigger showing display-only
+     *   filter tokens; it opens a stack of sheets. Filters lists the filters
+     *   as rows that edit or remove one, with Add filter, Done, and Clear
+     *   all, which asks first and keeps read-only filters. Add filter opens
+     *   above it with the fields (or the content search with inline
+     *   suggestions), and a value step opens above that, stages operator →
+     *   value, and confirms from its footer. Dismissing a step reveals the
+     *   one beneath. Suited to compact touch screens, where the editor
+     *   popover competes with the software keyboard.
+     * - `'adaptive'`: the bottom sheet on compact coarse-pointer screens,
+     *   otherwise the popover — the same resolution Selector uses. The server
+     *   render and the hydrating render are the popover.
+     *
+     * In the sheet presentation `menuWidth` and `tokenOverflowBehavior` have
+     * no surface to act on and warn in development. Pass `'popover'` to keep
+     * the tokenizer field and the editor popover on every device.
+     * @default 'adaptive'
      */
-    experimental?: {
-        /**
-         * How the field presents filter editing.
-         * - `'popover'`: the tokenizer field with its typeahead and the editor
-         *   popover — the stable behavior.
-         * - `'bottom-sheet'`: the whole field is one trigger showing display-only
-         *   filter tokens; it opens a stack of sheets. Filters lists the filters
-         *   as rows that edit or remove one, with Add filter, Done, and Clear
-         *   all, which asks first and keeps read-only filters. Add filter opens
-         *   above it with the fields (or the content search with inline
-         *   suggestions), and a value step opens above that, stages operator →
-         *   value, and confirms from its footer. Dismissing a step reveals the
-         *   one beneath. Suited to compact touch screens, where the editor
-         *   popover competes with the software keyboard.
-         * - `'adaptive'`: the bottom sheet on compact coarse-pointer screens,
-         *   otherwise the popover — the same resolution Selector uses.
-         *
-         * In the sheet presentation `menuWidth` and `tokenOverflowBehavior` have
-         * no surface to act on and warn in development.
-         * @experimental
-         * @default 'popover'
-         */
-        presentation?: 'popover' | 'bottom-sheet' | 'adaptive';
-    };
+    presentation?: PowerSearchPresentation;
 }
+/** How PowerSearch presents filter editing; see `PowerSearchProps.presentation`. */
+export type PowerSearchPresentation = AdaptivePresentation;
 /**
  * Structured filter bar where each token represents a filter (field + operator + value).
  *
@@ -218,7 +214,7 @@ export interface PowerSearchProps extends Omit<BaseProps<HTMLElement>, 'onChange
  * };
  * ```
  */
-export declare function PowerSearch({ config: configProp, filters, onChange, label: labelFromProps, isLabelHidden, placeholder: placeholderFromProps, hasAutoFocus, hasClear, isReadOnly, isDisabled, disabledMessage, startIcon, onFocus, onBlur, status, statusVariant, menuWidth, maxTokenLength, maxOperatorMenuItems, maxSearchResults, popoverSaveButtonLabel: popoverSaveButtonLabelFromProps, timezoneID, tokenOverflowBehavior, endContent, resultCount, ref, handleRef, size: sizeProp, 'data-testid': testId, xstyle, className, style, components: componentOverrides, experimental, }: PowerSearchProps): React.JSX.Element;
+export declare function PowerSearch({ config: configProp, filters, onChange, label: labelFromProps, isLabelHidden, placeholder: placeholderFromProps, hasAutoFocus, hasClear, isReadOnly, isDisabled, disabledMessage, startIcon, onFocus, onBlur, status, statusVariant, menuWidth, maxTokenLength, maxOperatorMenuItems, maxSearchResults, popoverSaveButtonLabel: popoverSaveButtonLabelFromProps, timezoneID, tokenOverflowBehavior, endContent, resultCount, ref, handleRef, size: sizeProp, 'data-testid': testId, xstyle, className, style, components: componentOverrides, presentation, }: PowerSearchProps): React.JSX.Element;
 export declare namespace PowerSearch {
     var displayName: string;
 }

package/dist/PowerSearch/PowerSearch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PowerSearch.d.ts","sourceRoot":"","sources":["../../src/PowerSearch/PowerSearch.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"PowerSearch.d.ts","sourceRoot":"","sources":["../../src/PowerSearch/PowerSearch.tsx"],"names":[],"mappings":"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"}

package/dist/PowerSearch/PowerSearch.js

@@ -8,8 +8,8 @@
  *   useAdaptivePresentation, and PowerSearchBottomSheet (lazy)
  * @output Structured filter bar with token-based filter management
  * @position Main component; forwards DOM ref and exposes tokenizer control via
- *   handleRef. The experimental `presentation` option swaps the tokenizer
- *   field and editor popover for one trigger that opens PowerSearchBottomSheet.
+ *   handleRef. The `presentation` prop swaps the tokenizer field and editor
+ *   popover for one trigger that opens PowerSearchBottomSheet.
  *
  * SYNC: When modified, update:
  * - /packages/core/src/PowerSearch/index.ts
@@ -181,6 +181,8 @@ function PowerSearchTokenValue({
 // Types
 // =============================================================================
 
+/** How PowerSearch presents filter editing; see `PowerSearchProps.presentation`. */
+
 // =============================================================================
 // State
 // =============================================================================
@@ -297,7 +299,7 @@ export function PowerSearch({
   className,
   style,
   components: componentOverrides,
-  experimental
+  presentation = 'adaptive'
 }) {
   const size = useSize(sizeProp, 'md');
   const config = useInternalConfig(configProp);
@@ -308,12 +310,6 @@ export function PowerSearch({
   const placeholder = placeholderFromProps ?? t('@astryx.powersearch.placeholder');
   const popoverSaveButtonLabel = popoverSaveButtonLabelFromProps ?? t('@astryx.powersearch.editor.apply');
   const tokenizerRef = useRef(null);
-
-  // Experimental presentation. `adaptive`
-  // resolves through the policy the selection controls share; an open flow
-  // keeps its presentation until it closes, so a resolution change mid-task
-  // cannot pull the surface out from under the person.
-  const presentation = experimental?.presentation ?? 'popover';
   const resolvedPresentation = useAdaptivePresentation(presentation);
   const [isSheetOpen, setIsSheetOpen] = useState(false);
   // Latched for the flow's lifetime: the flow stays presented after it closes
@@ -387,8 +383,8 @@ export function PowerSearch({
       setIsSheetOpen(false);
     }
   }
-  useDevWarning('PowerSearch', '`menuWidth` has no surface in the bottom-sheet presentation: the sheet flow has no typeahead popover to size. Scope it to the popover presentation or leave it out.', isSheetPresentation && menuWidth != null);
-  useDevWarning('PowerSearch', '`tokenOverflowBehavior` has no surface in the bottom-sheet presentation: the trigger wraps its display-only tokens. Scope it to the popover presentation or leave it out.', isSheetPresentation && tokenOverflowBehavior != null);
+  useDevWarning('PowerSearch', '`menuWidth` has no surface in the bottom-sheet presentation: the sheet flow has no typeahead popover to size. Pass `presentation="popover"` to keep the popover on every device, or leave it out.', isSheetPresentation && menuWidth != null);
+  useDevWarning('PowerSearch', '`tokenOverflowBehavior` has no surface in the bottom-sheet presentation: the trigger wraps its display-only tokens. Pass `presentation="popover"` to keep the tokenizer field on every device, or leave it out.', isSheetPresentation && tokenOverflowBehavior != null);
   const [popoverState, setPopoverStateRaw] = useState({
     type: 'idle'
   });

package/dist/PowerSearch/PowerSearchBottomSheet.d.ts

@@ -6,7 +6,7 @@
  *   RadioList, Text, TextInput, PowerSearchValueEditor, the internal sheet
  *   confirmation and search-drag owners, i18n
  * @output Exports PowerSearchBottomSheet — the touch surface of
- *   `PowerSearch experimental.presentation="bottom-sheet"`: a Filters sheet
+ *   `PowerSearch presentation="bottom-sheet"`: a Filters sheet
  *   with editable rows and trailing remove actions, Add filter in its fixed
  *   header and Clear all / Done in its fixed footer, an Add filter sheet with
  *   grouped field rows or the content search with inline suggestions, and a

package/dist/PowerSearch/PowerSearchBottomSheet.js

@@ -10,7 +10,7 @@
  *   RadioList, Text, TextInput, PowerSearchValueEditor, the internal sheet
  *   confirmation and search-drag owners, i18n
  * @output Exports PowerSearchBottomSheet — the touch surface of
- *   `PowerSearch experimental.presentation="bottom-sheet"`: a Filters sheet
+ *   `PowerSearch presentation="bottom-sheet"`: a Filters sheet
  *   with editable rows and trailing remove actions, Add filter in its fixed
  *   header and Clear all / Done in its fixed footer, an Add filter sheet with
  *   grouped field rows or the content search with inline suggestions, and a

package/dist/PowerSearch/index.d.ts

@@ -7,7 +7,7 @@
  * SYNC: When adding new PowerSearch files, update exports here
  */
 export { PowerSearch } from './PowerSearch.js';
-export type { PowerSearchProps, PowerSearchSize } from './PowerSearch.js';
+export type { PowerSearchPresentation, PowerSearchProps, PowerSearchSize, } from './PowerSearch.js';
 export { PowerSearchToken } from './PowerSearchToken.js';
 export { PowerSearchFilterEditor } from './PowerSearchFilterEditor.js';
 export { resolveOperatorLabel } from './resolveOperatorLabel.js';

package/dist/PowerSearch/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/PowerSearch/index.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,YAAY,EAAC,gBAAgB,EAAE,eAAe,EAAC,MAAM,eAAe,CAAC;AAErE,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAC,uBAAuB,EAAC,MAAM,2BAA2B,CAAC;AAElE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAC,eAAe,EAAE,SAAS,EAAC,MAAM,wBAAwB,CAAC;AAEvE,YAAY,EAEV,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAG9B,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EAGnB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAGjB,iBAAiB,EACjB,aAAa,EAGb,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EAGjB,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/PowerSearch/index.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,YAAY,EACV,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAC,uBAAuB,EAAC,MAAM,2BAA2B,CAAC;AAElE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAC,eAAe,EAAE,SAAS,EAAC,MAAM,wBAAwB,CAAC;AAEvE,YAAY,EAEV,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAG9B,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EAGnB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAGjB,iBAAiB,EACjB,aAAa,EAGb,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EAGjB,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,SAAS,CAAC"}

package/dist/Tokenizer/TokenizerBottomSheet.js

@@ -419,11 +419,9 @@ function TokenizerSheetContent({
   // `action` is declared on `SearchableItem` for the grid-adopting hosts; the
   // sheet rows have not adopted it, so a row renders the item without the
   // control and says so (`spec:AST-058` FR9), as the inline panel does.
-  useEffect(() => {
-    if (results.some(item => item.action != null)) {
-      warnOnce('tokenizer-sheet:item-action', 'Tokenizer', 'A result carries `action`, which the bottom-sheet rows do not render ' + 'yet; the item is shown without it.');
-    }
-  }, [results]);
+  if (results.some(item => item.action != null)) {
+    warnOnce('tokenizer-sheet:item-action', 'Tokenizer', 'A result carries `action`, which the bottom-sheet rows do not render ' + 'yet; the item is shown without it.');
+  }
 
   // The pending Spinner below stays named, as the inline field's does
   // (`family:input-fields` FR7), but is not a live region; the sheet announces

package/dist/hooks/scrollLockTouchGuard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrollLockTouchGuard.d.ts","sourceRoot":"","sources":["../../src/hooks/scrollLockTouchGuard.ts"],"names":[],"mappings":"AAqHA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAErD;AAWD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,OAAO,CAqCT"}
+{"version":3,"file":"scrollLockTouchGuard.d.ts","sourceRoot":"","sources":["../../src/hooks/scrollLockTouchGuard.ts"],"names":[],"mappings":"AAoFA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAErD;AAWD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,OAAO,CAqCT"}

package/dist/hooks/scrollLockTouchGuard.js

@@ -5,7 +5,7 @@
 /**
  * @file scrollLockTouchGuard.ts
  * @input The node under a finger and the pan's direction, while a scroll lock
- *   holds the page
+ *   holds the page; the native-scroll probe's edge test (gestures/nativeScroll)
  * @output isPanAbsorbedBeforePage and isPageZoomedIn, for the page hold
  * @position Internal hook utility; gestures/pageHold calls it for
  *   useScrollLock.
@@ -18,41 +18,24 @@
 // The walk follows flat-tree parents. It ends at a top-layer or fixed-position
 // element, whose containing block is the viewport, so its untaken pans go to
 // the page.
+import { canElementScroll } from "../gestures/nativeScroll.js";
 import { parentAcrossShadow } from "../utils/flatTree.js";
-import { isRtlElement } from "./isRtlElement.js";
-const SCROLLABLE = new Set(['auto', 'scroll']);
-
-/** Overflow at or below this many px is a box that fits, not a scroller. */
-const EDGE_TOLERANCE = 1;
-function canMoveY(element, dy, range) {
-  // A finger moving down drags the content down: scrollTop decreases.
-  return dy > 0 ? element.scrollTop > EDGE_TOLERANCE - 0.5 : element.scrollTop < range - EDGE_TOLERANCE + 0.5;
-}
-function canMoveX(element, dx, range, isRtl) {
-  const min = isRtl ? -range : 0;
-  const max = isRtl ? 0 : range;
-  // A finger moving right drags the content right: scrollLeft decreases.
-  return dx > 0 ? element.scrollLeft > min + EDGE_TOLERANCE - 0.5 : element.scrollLeft < max - EDGE_TOLERANCE + 0.5;
-}
 
 /**
  * Whether `element` itself takes a pan. It does when it can still scroll that
  * way, or when its `overscroll-behavior` contains the overscroll at its edge.
  */
 function takesPan(element, style, isVertical, dx, dy) {
-  if (!SCROLLABLE.has(isVertical ? style.overflowY : style.overflowX)) {
-    return false;
+  const x = isVertical ? 0 : dx;
+  const y = isVertical ? dy : 0;
+  if (canElementScroll(element, x, y)) {
+    return true;
   }
-  const range = isVertical ? element.scrollHeight - element.clientHeight : element.scrollWidth - element.clientWidth;
-  // Content that fits has nothing to scroll. The pan goes on to the next
-  // scroller in the chain, and at last to the page.
-  if (range <= EDGE_TOLERANCE) {
+  // A scroller at its edge can still move the other way. A box that does not
+  // scroll, or whose content fits, cannot. Its pan goes on along the chain.
+  if (!canElementScroll(element, -x, -y)) {
     return false;
   }
-  const canMove = isVertical ? canMoveY(element, dy, range) : canMoveX(element, dx, range, isRtlElement(element));
-  if (canMove) {
-    return true;
-  }
   const behavior = isVertical ? style.overscrollBehaviorY : style.overscrollBehaviorX;
   return behavior === 'contain' || behavior === 'none';
 }

package/dist/hooks/useScrollLock.d.ts

@@ -1,8 +1,9 @@
 /**
  * Locks page scroll while `isLocked` is true.
  *
- * The page keeps its scroll offset, so nothing jumps on lock or unlock. Where
- * the primary pointer is coarse (phones and tablets), the lock cancels a
+ * The page keeps its scroll offset, so nothing jumps on lock or unlock. iOS
+ * Safari scrolls an `overflow: hidden` page under a finger. So where the
+ * primary pointer is coarse (phones and tablets), the lock cancels a
  * one-finger pan that would reach the page.
  * Pans that a scroller in the overlay takes, and two-finger zoom, go through.
  * The gutter of a classic scrollbar stays open, so the page does not shift

package/dist/hooks/useScrollLock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useScrollLock.d.ts","sourceRoot":"","sources":["../../src/hooks/useScrollLock.ts"],"names":[],"mappings":"AAwCA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAkDrD"}
+{"version":3,"file":"useScrollLock.d.ts","sourceRoot":"","sources":["../../src/hooks/useScrollLock.ts"],"names":[],"mappings":"AAmCA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAkDrD"}

package/dist/hooks/useScrollLock.js

@@ -22,20 +22,15 @@ import { claimRootScrollStyle, reportScrollLock } from "./rootScrollStyles.js";
 import { holdPageScroll } from "../gestures/pageHold.js";
 import { isPageZoomedIn, isPanAbsorbedBeforePage } from "./scrollLockTouchGuard.js";
 import { holdScrollbarGutter } from "./scrollbarGutter.js";
-
-// iOS Safari scrolls an `overflow: hidden` page under a finger.
-// So the lock also cancels each one-finger pan that would reach the page. The
-// scroll offset never changes, so unlock restores nothing, and iOS Safari's
-// toolbar keeps its state.
-
 let lockCount = 0;
 let activeLock = null;
 
 /**
  * Locks page scroll while `isLocked` is true.
  *
- * The page keeps its scroll offset, so nothing jumps on lock or unlock. Where
- * the primary pointer is coarse (phones and tablets), the lock cancels a
+ * The page keeps its scroll offset, so nothing jumps on lock or unlock. iOS
+ * Safari scrolls an `overflow: hidden` page under a finger. So where the
+ * primary pointer is coarse (phones and tablets), the lock cancels a
  * one-finger pan that would reach the page.
  * Pans that a scroller in the overlay takes, and two-finger zoom, go through.
  * The gutter of a classic scrollbar stays open, so the page does not shift

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astryxdesign/core",
-  "version": "0.7.8-canary.36cde5e",
+  "version": "0.7.8-canary.4934ffc",
   "displayName": "Astryx Core",
   "description": "The component library. Accessible, themeable React components with built-in spacing, dark mode, and StyleX styling.",
   "author": "Meta Open Source",
@@ -870,9 +870,9 @@
     "react-dom": ">=19.0.0"
   },
   "devDependencies": {
-    "@astryxdesign/a11y-spec": "0.7.8-canary.36cde5e",
-    "@astryxdesign/cli": "0.7.8-canary.36cde5e",
-    "@astryxdesign/interaction-harness": "0.7.8-canary.36cde5e",
+    "@astryxdesign/a11y-spec": "0.7.8-canary.4934ffc",
+    "@astryxdesign/cli": "0.7.8-canary.4934ffc",
+    "@astryxdesign/interaction-harness": "0.7.8-canary.4934ffc",
     "@babel/cli": "^7.29.7",
     "@babel/core": "^7.29.7",
     "@babel/preset-react": "^7.29.7",

package/src/Icon/Icon.doc.mjs

@@ -78,7 +78,7 @@ export const docs = {
     },
     {
       name: 'color',
-      type: "'primary' | 'secondary' | 'tertiary' | 'disabled' | 'accent' | 'info' | 'success' | 'error' | 'warning' | 'inherit'",
+      type: "'primary' | 'secondary' | 'tertiary' | 'disabled' | 'accent' | 'info' | 'success' | 'error' | 'warning' | 'inherit' | 'blue' | 'red' | 'green' | 'gray' | 'cyan' | 'teal' | 'yellow' | 'orange' | 'pink' | 'purple'",
       description:
         'Color variant mapped to Astryx icon color tokens. Semantic values (primary through warning) follow the role, and inherit uses the surrounding text color. On the web, Icon also accepts the palette values blue, red, green, gray, cyan, teal, yellow, orange, pink, and purple, which pick a non-semantic hue.',
       default: "'inherit'",
@@ -233,7 +233,7 @@ export const docsZh = {
     },
     {
       name: 'color',
-      type: "'primary' | 'secondary' | 'tertiary' | 'disabled' | 'accent' | 'info' | 'success' | 'error' | 'warning' | 'inherit'",
+      type: "'primary' | 'secondary' | 'tertiary' | 'disabled' | 'accent' | 'info' | 'success' | 'error' | 'warning' | 'inherit' | 'blue' | 'red' | 'green' | 'gray' | 'cyan' | 'teal' | 'yellow' | 'orange' | 'pink' | 'purple'",
       description:
         '映射到 Astryx 图标颜色令牌的颜色变体。语义值（primary 到 warning）跟随角色，inherit 使用周围文字的颜色。在 Web 上，Icon 还接受调色板值 blue、red、green、gray、cyan、teal、yellow、orange、pink 和 purple，它们选择非语义色相。',
       default: "'inherit'",

package/src/PowerSearch/PowerSearch.doc.mjs

@@ -208,22 +208,22 @@ export const docs = {
         'StyleX styles for layout customization. Must be a stylex.create() value.',
     },
     {
-      name: 'experimental',
-      type: "{presentation?: 'popover' | 'bottom-sheet' | 'adaptive'}",
-      stability: 'experimental',
+      name: 'presentation',
+      type: "'popover' | 'bottom-sheet' | 'adaptive'",
       description:
-        "Experimental options: anything in this object may change or be removed in a patch release, and omitting it keeps the stable behavior. presentation (default 'popover') chooses how the field presents filter editing. popover is the tokenizer field with its typeahead and the editor popover. bottom-sheet makes the whole field one trigger showing display-only filter tokens: it opens a Filters sheet listing the filters as rows that edit or remove a filter, with Add filter, Done, and Clear all (which asks first and keeps read-only filters); an Add filter sheet with the fields (or the content search with inline suggestions) opens above it, and a value step that stages operator → value and confirms from its footer opens above that. Dismissing a step reveals the one beneath. List values edit through the Tokenizer's own sheet. adaptive uses the bottom sheet on compact touch screens and the popover otherwise, resolved the same way Selector resolves it. In the sheet presentation menuWidth and tokenOverflowBehavior have no surface to act on and warn in development.",
+        'How the field presents filter editing. adaptive (the default) uses the bottom sheet on compact touch screens and the popover otherwise, resolved the same way Selector resolves it; the server render and the hydrating render are the popover. popover is the tokenizer field with its typeahead and the editor popover on every device. bottom-sheet makes the whole field, on every device, one trigger showing display-only filter tokens: it opens a Filters sheet listing the filters as rows that edit or remove a filter, with Add filter, Done, and Clear all (which asks first and keeps read-only filters); an Add filter sheet with the fields (or the content search with inline suggestions) opens above it, and a value step that stages operator → value and confirms from its footer opens above that. Dismissing a step reveals the one beneath. List values edit through the Tokenizer\'s own sheet. In the sheet presentation menuWidth and tokenOverflowBehavior have no surface to act on and warn in development. Pass presentation="popover" to keep the tokenizer field and the editor popover on every device.',
+      default: "'adaptive'",
     },
   ],
   examples: [
     {
-      label: 'Touch sheet on compact screens (experimental)',
+      label: 'Keep the popover on every device',
       code: `const [filters, setFilters] = useState([]);
 <PowerSearch
   config={config}
   filters={filters}
   onChange={next => setFilters(next)}
-  experimental={{presentation: 'adaptive'}}
+  presentation="popover"
 />`,
     },
   ],
@@ -481,11 +481,11 @@ export const docsZh = {
       description: '用于布局自定义的 StyleX 样式。必须是 stylex.create() 值。',
     },
     {
-      name: 'experimental',
-      type: "{presentation?: 'popover' | 'bottom-sheet' | 'adaptive'}",
-      stability: 'experimental',
+      name: 'presentation',
+      type: "'popover' | 'bottom-sheet' | 'adaptive'",
       description:
-        "实验性选项：此对象中的任何内容都可能在补丁版本中更改或移除；省略它即保持稳定行为。presentation（默认 'popover'）决定字段如何呈现筛选编辑：popover 为带有预输入和编辑弹出层的标记字段；bottom-sheet 将整个字段变为一个显示只读筛选标记的触发按钮——点按后打开列出筛选项的「筛选」面板，每行可编辑或移除筛选（含添加筛选、完成、全部清除；全部清除会先确认，并保留只读筛选）；列出字段（或带内联建议的内容搜索）的「添加筛选」面板在其上方打开，按运算符 → 值暂存并在底部确认的取值步骤再在其上方打开。关闭某一步会露出下方的那一步。列表值通过 Tokenizer 自身的面板编辑。adaptive 在紧凑触摸屏上使用底部面板，其他情况使用 popover，解析方式与 Selector 相同。在底部面板呈现中，menuWidth 和 tokenOverflowBehavior 没有作用对象，并会在开发环境中发出警告。",
+        '字段如何呈现筛选编辑。adaptive（默认）在紧凑触摸屏上使用底部面板，其他情况使用 popover，解析方式与 Selector 相同；服务端渲染和水合期间的渲染均为 popover。popover 在所有设备上为带有预输入和编辑弹出层的标记字段。bottom-sheet 在所有设备上将整个字段变为一个显示只读筛选标记的触发按钮——点按后打开列出筛选项的「筛选」面板，每行可编辑或移除筛选（含添加筛选、完成、全部清除；全部清除会先确认，并保留只读筛选）；列出字段（或带内联建议的内容搜索）的「添加筛选」面板在其上方打开，按运算符 → 值暂存并在底部确认的取值步骤再在其上方打开。关闭某一步会露出下方的那一步。列表值通过 Tokenizer 自身的面板编辑。在底部面板呈现中，menuWidth 和 tokenOverflowBehavior 没有作用对象，并会在开发环境中发出警告。传入 presentation="popover" 可在所有设备上保留标记字段和编辑弹出层。',
+      default: "'adaptive'",
     },
   ],
   usage: {
@@ -582,7 +582,7 @@ export const docsDense = {
     size: 'Search input+token size.',
     xstyle:
       'StyleX styles for layout customization. Must be stylex.create() value.',
-    experimental:
-      "Experimental; may change in a patch. presentation: 'popover' (default, tokenizer field + editor popover) | 'bottom-sheet' (one trigger with display-only tokens + stacked Filters / Add filter / value sheets; rows remove inline; Clear all confirms, keeps read-only; list values via Tokenizer's sheet) | 'adaptive' (sheet on compact touch, else popover).",
+    presentation:
+      "'adaptive' (default: sheet on compact touch, else popover; SSR/hydration render popover) | 'popover' (tokenizer field + editor popover, every device) | 'bottom-sheet' (one trigger with display-only tokens + stacked Filters / Add filter / value sheets; rows remove inline; Clear all confirms, keeps read-only; list values via Tokenizer's sheet). Sheet: menuWidth/tokenOverflowBehavior inert (dev warning). presentation=\"popover\" keeps the popover on every device.",
   },
 };

package/src/PowerSearch/PowerSearch.tsx

@@ -8,8 +8,8 @@
  *   useAdaptivePresentation, and PowerSearchBottomSheet (lazy)
  * @output Structured filter bar with token-based filter management
  * @position Main component; forwards DOM ref and exposes tokenizer control via
- *   handleRef. The experimental `presentation` option swaps the tokenizer
- *   field and editor popover for one trigger that opens PowerSearchBottomSheet.
+ *   handleRef. The `presentation` prop swaps the tokenizer field and editor
+ *   popover for one trigger that opens PowerSearchBottomSheet.
  *
  * SYNC: When modified, update:
  * - /packages/core/src/PowerSearch/index.ts
@@ -58,7 +58,10 @@ import {usePopover} from '../Popover/usePopover';
 import {useTooltip} from '../Tooltip/useTooltip';
 import {layerViewportInset} from '../Layer/layerViewportInset.stylex';
 import {useAnnounce} from '../hooks/useAnnounce';
-import {useAdaptivePresentation} from '../hooks/useAdaptivePresentation';
+import {
+  type AdaptivePresentation,
+  useAdaptivePresentation,
+} from '../hooks/useAdaptivePresentation';
 import {useDevWarning} from '../hooks/useDevWarning';
 import {useIsHydrating} from '../hooks/useIsHydrating';
 import {
@@ -416,39 +419,34 @@ export interface PowerSearchProps extends Omit<
    * Keys are operator value types (e.g. 'string', 'enum', 'date_absolute').
    */
   components?: PowerSearchComponents;
-
   /**
-   * Experimental options, outside the stable compatibility promise: anything
-   * in this object may change or be removed in a patch release. Omit it for
-   * the stable behavior.
-   * @experimental
+   * How the field presents filter editing.
+   * - `'popover'`: the tokenizer field with its typeahead and the editor
+   *   popover, on every device.
+   * - `'bottom-sheet'`: the whole field is one trigger showing display-only
+   *   filter tokens; it opens a stack of sheets. Filters lists the filters
+   *   as rows that edit or remove one, with Add filter, Done, and Clear
+   *   all, which asks first and keeps read-only filters. Add filter opens
+   *   above it with the fields (or the content search with inline
+   *   suggestions), and a value step opens above that, stages operator →
+   *   value, and confirms from its footer. Dismissing a step reveals the
+   *   one beneath. Suited to compact touch screens, where the editor
+   *   popover competes with the software keyboard.
+   * - `'adaptive'`: the bottom sheet on compact coarse-pointer screens,
+   *   otherwise the popover — the same resolution Selector uses. The server
+   *   render and the hydrating render are the popover.
+   *
+   * In the sheet presentation `menuWidth` and `tokenOverflowBehavior` have
+   * no surface to act on and warn in development. Pass `'popover'` to keep
+   * the tokenizer field and the editor popover on every device.
+   * @default 'adaptive'
    */
-  experimental?: {
-    /**
-     * How the field presents filter editing.
-     * - `'popover'`: the tokenizer field with its typeahead and the editor
-     *   popover — the stable behavior.
-     * - `'bottom-sheet'`: the whole field is one trigger showing display-only
-     *   filter tokens; it opens a stack of sheets. Filters lists the filters
-     *   as rows that edit or remove one, with Add filter, Done, and Clear
-     *   all, which asks first and keeps read-only filters. Add filter opens
-     *   above it with the fields (or the content search with inline
-     *   suggestions), and a value step opens above that, stages operator →
-     *   value, and confirms from its footer. Dismissing a step reveals the
-     *   one beneath. Suited to compact touch screens, where the editor
-     *   popover competes with the software keyboard.
-     * - `'adaptive'`: the bottom sheet on compact coarse-pointer screens,
-     *   otherwise the popover — the same resolution Selector uses.
-     *
-     * In the sheet presentation `menuWidth` and `tokenOverflowBehavior` have
-     * no surface to act on and warn in development.
-     * @experimental
-     * @default 'popover'
-     */
-    presentation?: 'popover' | 'bottom-sheet' | 'adaptive';
-  };
+  presentation?: PowerSearchPresentation;
 }
 
+/** How PowerSearch presents filter editing; see `PowerSearchProps.presentation`. */
+export type PowerSearchPresentation = AdaptivePresentation;
+
 // =============================================================================
 // State
 // =============================================================================
@@ -583,7 +581,7 @@ export function PowerSearch({
   className,
   style,
   components: componentOverrides,
-  experimental,
+  presentation = 'adaptive',
 }: PowerSearchProps) {
   const size = useSize(sizeProp, 'md');
   const config = useInternalConfig(configProp);
@@ -597,11 +595,6 @@ export function PowerSearch({
     popoverSaveButtonLabelFromProps ?? t('@astryx.powersearch.editor.apply');
   const tokenizerRef = useRef<TokenizerHandle>(null);
 
-  // Experimental presentation. `adaptive`
-  // resolves through the policy the selection controls share; an open flow
-  // keeps its presentation until it closes, so a resolution change mid-task
-  // cannot pull the surface out from under the person.
-  const presentation = experimental?.presentation ?? 'popover';
   const resolvedPresentation = useAdaptivePresentation(presentation);
   const [isSheetOpen, setIsSheetOpen] = useState(false);
   // Latched for the flow's lifetime: the flow stays presented after it closes
@@ -687,12 +680,12 @@ export function PowerSearch({
   }
   useDevWarning(
     'PowerSearch',
-    '`menuWidth` has no surface in the bottom-sheet presentation: the sheet flow has no typeahead popover to size. Scope it to the popover presentation or leave it out.',
+    '`menuWidth` has no surface in the bottom-sheet presentation: the sheet flow has no typeahead popover to size. Pass `presentation="popover"` to keep the popover on every device, or leave it out.',
     isSheetPresentation && menuWidth != null,
   );
   useDevWarning(
     'PowerSearch',
-    '`tokenOverflowBehavior` has no surface in the bottom-sheet presentation: the trigger wraps its display-only tokens. Scope it to the popover presentation or leave it out.',
+    '`tokenOverflowBehavior` has no surface in the bottom-sheet presentation: the trigger wraps its display-only tokens. Pass `presentation="popover"` to keep the tokenizer field on every device, or leave it out.',
     isSheetPresentation && tokenOverflowBehavior != null,
   );
 

package/src/PowerSearch/PowerSearchBottomSheet.tsx

@@ -10,7 +10,7 @@
  *   RadioList, Text, TextInput, PowerSearchValueEditor, the internal sheet
  *   confirmation and search-drag owners, i18n
  * @output Exports PowerSearchBottomSheet — the touch surface of
- *   `PowerSearch experimental.presentation="bottom-sheet"`: a Filters sheet
+ *   `PowerSearch presentation="bottom-sheet"`: a Filters sheet
  *   with editable rows and trailing remove actions, Add filter in its fixed
  *   header and Clear all / Done in its fixed footer, an Add filter sheet with
  *   grouped field rows or the content search with inline suggestions, and a

package/src/PowerSearch/index.ts

@@ -12,7 +12,11 @@
  */
 
 export {PowerSearch} from './PowerSearch';
-export type {PowerSearchProps, PowerSearchSize} from './PowerSearch';
+export type {
+  PowerSearchPresentation,
+  PowerSearchProps,
+  PowerSearchSize,
+} from './PowerSearch';
 
 export {PowerSearchToken} from './PowerSearchToken';
 export {PowerSearchFilterEditor} from './PowerSearchFilterEditor';

package/src/Tokenizer/TokenizerBottomSheet.tsx

@@ -614,16 +614,14 @@ function TokenizerSheetContent<T extends SearchableItem>({
   // `action` is declared on `SearchableItem` for the grid-adopting hosts; the
   // sheet rows have not adopted it, so a row renders the item without the
   // control and says so (`spec:AST-058` FR9), as the inline panel does.
-  useEffect(() => {
-    if (results.some(item => item.action != null)) {
-      warnOnce(
-        'tokenizer-sheet:item-action',
-        'Tokenizer',
-        'A result carries `action`, which the bottom-sheet rows do not render ' +
-          'yet; the item is shown without it.',
-      );
-    }
-  }, [results]);
+  if (results.some(item => item.action != null)) {
+    warnOnce(
+      'tokenizer-sheet:item-action',
+      'Tokenizer',
+      'A result carries `action`, which the bottom-sheet rows do not render ' +
+        'yet; the item is shown without it.',
+    );
+  }
 
   // The pending Spinner below stays named, as the inline field's does
   // (`family:input-fields` FR7), but is not a live region; the sheet announces

package/src/hooks/scrollLockTouchGuard.ts

@@ -5,7 +5,7 @@
 /**
  * @file scrollLockTouchGuard.ts
  * @input The node under a finger and the pan's direction, while a scroll lock
- *   holds the page
+ *   holds the page; the native-scroll probe's edge test (gestures/nativeScroll)
  * @output isPanAbsorbedBeforePage and isPageZoomedIn, for the page hold
  * @position Internal hook utility; gestures/pageHold calls it for
  *   useScrollLock.
@@ -19,34 +19,8 @@
 // element, whose containing block is the viewport, so its untaken pans go to
 // the page.
 
+import {canElementScroll} from '../gestures/nativeScroll';
 import {parentAcrossShadow} from '../utils/flatTree';
-import {isRtlElement} from './isRtlElement';
-
-const SCROLLABLE = new Set(['auto', 'scroll']);
-
-/** Overflow at or below this many px is a box that fits, not a scroller. */
-const EDGE_TOLERANCE = 1;
-
-function canMoveY(element: Element, dy: number, range: number): boolean {
-  // A finger moving down drags the content down: scrollTop decreases.
-  return dy > 0
-    ? element.scrollTop > EDGE_TOLERANCE - 0.5
-    : element.scrollTop < range - EDGE_TOLERANCE + 0.5;
-}
-
-function canMoveX(
-  element: Element,
-  dx: number,
-  range: number,
-  isRtl: boolean,
-): boolean {
-  const min = isRtl ? -range : 0;
-  const max = isRtl ? 0 : range;
-  // A finger moving right drags the content right: scrollLeft decreases.
-  return dx > 0
-    ? element.scrollLeft > min + EDGE_TOLERANCE - 0.5
-    : element.scrollLeft < max - EDGE_TOLERANCE + 0.5;
-}
 
 /**
  * Whether `element` itself takes a pan. It does when it can still scroll that
@@ -59,23 +33,16 @@ function takesPan(
   dx: number,
   dy: number,
 ): boolean {
-  if (!SCROLLABLE.has(isVertical ? style.overflowY : style.overflowX)) {
-    return false;
+  const x = isVertical ? 0 : dx;
+  const y = isVertical ? dy : 0;
+  if (canElementScroll(element, x, y)) {
+    return true;
   }
-  const range = isVertical
-    ? element.scrollHeight - element.clientHeight
-    : element.scrollWidth - element.clientWidth;
-  // Content that fits has nothing to scroll. The pan goes on to the next
-  // scroller in the chain, and at last to the page.
-  if (range <= EDGE_TOLERANCE) {
+  // A scroller at its edge can still move the other way. A box that does not
+  // scroll, or whose content fits, cannot. Its pan goes on along the chain.
+  if (!canElementScroll(element, -x, -y)) {
     return false;
   }
-  const canMove = isVertical
-    ? canMoveY(element, dy, range)
-    : canMoveX(element, dx, range, isRtlElement(element as HTMLElement));
-  if (canMove) {
-    return true;
-  }
   const behavior = isVertical
     ? style.overscrollBehaviorY
     : style.overscrollBehaviorX;

package/src/hooks/useScrollLock.ts

@@ -24,11 +24,6 @@ import {holdPageScroll} from '../gestures/pageHold';
 import {isPageZoomedIn, isPanAbsorbedBeforePage} from './scrollLockTouchGuard';
 import {holdScrollbarGutter, type ScrollbarGutterHold} from './scrollbarGutter';
 
-// iOS Safari scrolls an `overflow: hidden` page under a finger.
-// So the lock also cancels each one-finger pan that would reach the page. The
-// scroll offset never changes, so unlock restores nothing, and iOS Safari's
-// toolbar keeps its state.
-
 interface ActiveLock {
   releaseRootStyle: () => void;
   releasePageHold: () => void;
@@ -41,8 +36,9 @@ let activeLock: ActiveLock | null = null;
 /**
  * Locks page scroll while `isLocked` is true.
  *
- * The page keeps its scroll offset, so nothing jumps on lock or unlock. Where
- * the primary pointer is coarse (phones and tablets), the lock cancels a
+ * The page keeps its scroll offset, so nothing jumps on lock or unlock. iOS
+ * Safari scrolls an `overflow: hidden` page under a finger. So where the
+ * primary pointer is coarse (phones and tablets), the lock cancels a
  * one-finger pan that would reach the page.
  * Pans that a scroller in the overlay takes, and two-finger zoom, go through.
  * The gutter of a classic scrollbar stays open, so the page does not shift