@astryxdesign/core 0.7.7 → 0.7.8-canary.0588a13

package/src/hooks/useScrollLock.ts

@@ -4,46 +4,45 @@
 
 /**
  * @file useScrollLock.ts
- * @input Uses React useEffect
- * @output Exports useScrollLock hook for locking body scroll
- * @position Core hook; used by Dialog to prevent background scrolling
- *
- * Locks body scroll when active by pinning the body with position:fixed.
- * This is needed because overscroll-behavior:contain doesn't work on iOS Safari.
+ * @input React useEffect, rootScrollStyles, gestures/pageHold with the pan
+ *   decision, and the scrollbar gutter hold
+ * @output useScrollLock, which locks page scroll behind a modal
+ * @position Core hook; used by Dialog, BottomSheet, Drawer, Lightbox and
+ *   MobileNav
  *
  * SYNC: When modified, update:
  * - /packages/core/src/hooks/index.ts
  * - /packages/core/src/hooks/scrollbarGutter.ts
+ * - /packages/core/src/hooks/rootScrollStyles.ts
+ * - /packages/core/src/gestures/pageHold.ts (holdPageScroll)
+ * - /packages/core/src/hooks/useScrollLockImports.test.ts
  */
 
 import {useEffect} from 'react';
+import {claimRootScrollStyle, reportScrollLock} from './rootScrollStyles';
+import {holdPageScroll} from '../gestures/pageHold';
+import {isPageZoomedIn, isPanAbsorbedBeforePage} from './scrollLockTouchGuard';
 import {holdScrollbarGutter, type ScrollbarGutterHold} from './scrollbarGutter';
 
-interface ScrollLockSnapshot {
-  scrollX: number;
-  scrollY: number;
-  overflow: string;
-  position: string;
-  top: string;
-  left: string;
-  right: string;
+interface ActiveLock {
+  releaseRootStyle: () => void;
+  releasePageHold: () => void;
   gutter: ScrollbarGutterHold;
 }
 
 let lockCount = 0;
-let originalBodyState: ScrollLockSnapshot | null = null;
+let activeLock: ActiveLock | null = null;
 
 /**
- * Locks body scroll when `isLocked` is true.
- *
- * Pins the body with `position: fixed` to prevent background scrolling,
- * which is necessary for iOS Safari where `overscroll-behavior: contain`
- * does not prevent body scroll behind modals. Restores scroll position
- * on unlock.
+ * Locks page scroll while `isLocked` is true.
  *
- * Pinning also hides the document's scrollbar, so the gutter that scrollbar
- * occupied is held open for the duration of the lock — without it the page
- * reflows sideways by ~15px the moment an overlay opens.
+ * 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
+ * sideways.
  *
  * @example
  * ```
@@ -51,59 +50,53 @@ let originalBodyState: ScrollLockSnapshot | null = null;
  * ```
  */
 export function useScrollLock(isLocked: boolean): void {
+  // Syncs the document's scroll lock with `isLocked`. A count of holders keeps
+  // the page locked until the last one releases.
   useEffect(() => {
     if (!isLocked) {
       return;
     }
 
-    const {body} = document;
-
     if (lockCount === 0) {
-      const scrollX = window.scrollX;
-      const scrollY = window.scrollY;
-
-      // Taken before the pinning styles below hide the scrollbar.
-      const gutter = holdScrollbarGutter(body);
-
-      originalBodyState = {
-        scrollX,
-        scrollY,
-        overflow: body.style.overflow,
-        position: body.style.position,
-        top: body.style.top,
-        left: body.style.left,
-        right: body.style.right,
-        gutter,
-      };
-
-      body.style.overflow = 'hidden';
-      body.style.position = 'fixed';
-      body.style.top = `-${scrollY}px`;
-      body.style.left = '0';
-      body.style.right = '0';
-
+      // The hold measures before the lock writes a style, so the lock forces no
+      // layout of its own. `settle` writes the gutter with the styles below.
+      const gutter = holdScrollbarGutter(document.documentElement);
+      // `overscroll-behavior-y: none` also keeps the browser's own
+      // pull-to-refresh (Chrome on Android) from reloading the page behind
+      // the overlay.
+      const releaseRootStyle = claimRootScrollStyle({
+        overflow: 'hidden',
+        overscrollBehaviorY: 'none',
+      });
+      // The hold asks the gesture host only if one exists, so the lock does
+      // not bring the host into every overlay's import.
+      const releasePageHold = holdPageScroll(
+        document,
+        // A drag on a pinch-zoomed page pans the zoomed view: it goes
+        // through, so a zoomed-in reader can move around the overlay.
+        (origin, dx, dy) =>
+          !isPageZoomedIn(document) && !isPanAbsorbedBeforePage(origin, dx, dy),
+      );
       gutter.settle();
+      activeLock = {releaseRootStyle, releasePageHold, gutter};
     }
 
     lockCount += 1;
+    reportScrollLock(1);
 
     return () => {
       lockCount -= 1;
+      reportScrollLock(-1);
 
-      if (lockCount !== 0 || originalBodyState == null) {
+      if (lockCount !== 0 || activeLock == null) {
         return;
       }
 
-      const state = originalBodyState;
-      originalBodyState = null;
-
-      body.style.overflow = state.overflow;
-      body.style.position = state.position;
-      body.style.top = state.top;
-      body.style.left = state.left;
-      body.style.right = state.right;
-      state.gutter.release();
-      window.scrollTo(state.scrollX, state.scrollY);
+      const lock = activeLock;
+      activeLock = null;
+      lock.releasePageHold();
+      lock.releaseRootStyle();
+      lock.gutter.release();
     };
   }, [isLocked]);
 }

package/src/hooks/useScrollableArea.ts

@@ -216,6 +216,8 @@ export function useScrollableArea({
   const getComposedViewportRef = useStableComposedRef(viewportRef);
   const getComposedContentRef = useStableComposedRef(contentRef);
 
+  // Syncs the scroll geometry with the viewport and content nodes. It measures
+  // them, then follows resize, scroll, transition and font events.
   useIsomorphicLayoutEffect(() => {
     if (viewport == null || content == null) {
       return;
@@ -430,6 +432,8 @@ export function useScrollableArea({
   // commit. A loss waits for the next frame.
   const previousOverflowRef = useRef<LogicalOverflowGeometry>(INITIAL_OVERFLOW);
   const previousMappingRef = useRef<LogicalAxisMapping>(INITIAL_MAPPING);
+  // Measures the layout again when overflow starts or the writing-mode mapping
+  // changes. A new scrollbar gutter changes the geometry.
   useIsomorphicLayoutEffect(() => {
     const previous = previousOverflowRef.current;
     const hasGainedOverflow =

package/src/hooks/useStreamingText.ts

@@ -178,6 +178,8 @@ export function useStreamingText(
     '(prefers-reduced-motion: reduce)',
   );
 
+  // Syncs the revealed text with an animation-frame clock while the text
+  // streams.
   useEffect(() => {
     if (!isStreaming || speed === 'instant' || prefersReducedMotion) {
       return;

package/src/i18n/generated-english/PowerSearch/PowerSearchBottomSheet.generated.ts

@@ -0,0 +1,46 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @generated by scripts/generate-i18n-runtime.mjs from packages/core/locales/en.json,
+ * holding the English for the catalog keys named in packages/core/src/PowerSearch/PowerSearchBottomSheet.tsx.
+ * Do not edit by hand. Run `pnpm generate:i18n-runtime` instead.
+ */
+
+const english: Readonly<Record<string, string>> = {
+  "@astryx.powersearch.allFiltersRemoved": "All filters removed",
+  "@astryx.powersearch.editableFiltersRemoved": "Editable filters removed",
+  "@astryx.powersearch.editor.apply": "Apply",
+  "@astryx.powersearch.editor.cancel": "Cancel",
+  "@astryx.powersearch.editor.operator": "Operator",
+  "@astryx.powersearch.sheet.addFilter": "Add filter",
+  "@astryx.powersearch.sheet.clearAll": "Clear all",
+  "@astryx.powersearch.sheet.clearAllCancel": "Keep filters",
+  "@astryx.powersearch.sheet.clearAllConfirm": "Clear filters",
+  "@astryx.powersearch.sheet.clearAllDescription": "This removes all editable filters from this search.",
+  "@astryx.powersearch.sheet.clearAllTitle": "Clear all filters?",
+  "@astryx.powersearch.sheet.discardConfirm": "Discard changes",
+  "@astryx.powersearch.sheet.discardDescription": "Your changes to the filters haven't been applied.",
+  "@astryx.powersearch.sheet.discardTitle": "Discard changes?",
+  "@astryx.powersearch.sheet.done": "Done",
+  "@astryx.powersearch.sheet.fieldOperator": "{field} {operator}",
+  "@astryx.powersearch.sheet.filterUnavailable": "This filter is no longer available",
+  "@astryx.powersearch.sheet.filtersTitle": "Filters",
+  "@astryx.powersearch.sheet.keepEditing": "Keep editing",
+  "@astryx.powersearch.sheet.labelValue": "{label} {value}",
+  "@astryx.powersearch.sheet.noFilters": "No filters applied",
+  "@astryx.powersearch.sheet.noFiltersDescription": "Add a filter to narrow your results and find what you need faster.",
+  "@astryx.powersearch.sheet.noFiltersInDraft": "No filters",
+  "@astryx.powersearch.sheet.noMatchingFields": "No filters match your search",
+  "@astryx.powersearch.sheet.noResults": "No results found",
+  "@astryx.powersearch.sheet.removeFilter": "Remove {field} filter",
+  "@astryx.powersearch.sheet.search": "Search",
+  "@astryx.powersearch.sheet.searchFields": "Search filters",
+  "@astryx.powersearch.sheet.searchFieldsPlaceholder": "Search filters…",
+  "@astryx.powersearch.sheet.searchResults": "Search results",
+  "@astryx.powersearch.sheet.tryDifferentSearch": "Try a different search.",
+  "@astryx.powersearch.sheet.ungroupedFields": "General",
+  "@astryx.tokenizer.tokenAdded": "Added {label}",
+  "@astryx.tokenizer.tokenRemoved": "Removed {label}"
+};
+
+export default english;

package/src/i18n/generated-english/PowerSearch/PowerSearchValueEditor.generated.ts

@@ -7,6 +7,12 @@
  */
 
 const english: Readonly<Record<string, string>> = {
+  "@astryx.powersearch.sheet.relativeDaysAgo": "{count, number} {count, plural, one {day} other {days}} ago",
+  "@astryx.powersearch.sheet.relativeDaysFromNow": "{count, number} {count, plural, one {day} other {days}} from now",
+  "@astryx.powersearch.sheet.relativeMonthsAgo": "{count, number} {count, plural, one {month} other {months}} ago",
+  "@astryx.powersearch.sheet.relativeMonthsFromNow": "{count, number} {count, plural, one {month} other {months}} from now",
+  "@astryx.powersearch.sheet.relativeWeeksAgo": "{count, number} {count, plural, one {week} other {weeks}} ago",
+  "@astryx.powersearch.sheet.relativeWeeksFromNow": "{count, number} {count, plural, one {week} other {weeks}} from now",
   "@astryx.powersearch.valueEditor.addValuesPlaceholder": "Add values…",
   "@astryx.powersearch.valueEditor.date": "Date",
   "@astryx.powersearch.valueEditor.dateRange": "date range",

package/src/i18n/generated-english/PowerSearch/formatTokenValue.generated.ts

@@ -0,0 +1,15 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @generated by scripts/generate-i18n-runtime.mjs from packages/core/locales/en.json,
+ * holding the English for the catalog keys named in packages/core/src/PowerSearch/formatTokenValue.ts.
+ * Do not edit by hand. Run `pnpm generate:i18n-runtime` instead.
+ */
+
+const english: Readonly<Record<string, string>> = {
+  "@astryx.powersearch.valueEditor.dateRange": "date range",
+  "@astryx.powersearch.valueEditor.filtersCount": "{count, number} {count, plural, one {filter} other {filters}}",
+  "@astryx.powersearch.valueEditor.itemsCount": "{count, number} {count, plural, one {item} other {items}}"
+};
+
+export default english;

package/src/i18n/generated-english/Resizable/createResizable.generated.ts

@@ -0,0 +1,14 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @generated by scripts/generate-i18n-runtime.mjs from packages/core/locales/en.json,
+ * holding the English for the catalog keys named in packages/core/src/Resizable/createResizable.ts.
+ * Do not edit by hand. Run `pnpm generate:i18n-runtime` instead.
+ */
+
+const english: Readonly<Record<string, string>> = {
+  "@astryx.resizable.collapsed": "Collapsed",
+  "@astryx.resizable.handle.label": "Resize handle"
+};
+
+export default english;

package/src/i18n/generated-english/Table/plugins/rowExpansion/useTableRowExpansion.generated.ts

@@ -8,8 +8,10 @@
 
 const english: Readonly<Record<string, string>> = {
   "@astryx.tableRowExpansion.collapseRow": "Collapse row",
+  "@astryx.tableRowExpansion.collapseRowNamed": "Collapse {label}",
   "@astryx.tableRowExpansion.columnHeader": "Row expansion",
-  "@astryx.tableRowExpansion.expandRow": "Expand row"
+  "@astryx.tableRowExpansion.expandRow": "Expand row",
+  "@astryx.tableRowExpansion.expandRowNamed": "Expand {label}"
 };
 
 export default english;

package/src/i18n/generated-english/Table/plugins/tree/useTableTreeData.generated.ts

@@ -9,8 +9,10 @@
 const english: Readonly<Record<string, string>> = {
   "@astryx.tableTree.collapseAllRows": "Collapse all rows",
   "@astryx.tableTree.collapseRow": "Collapse row",
+  "@astryx.tableTree.collapseRowNamed": "Collapse {label}",
   "@astryx.tableTree.expandAllRows": "Expand all rows",
-  "@astryx.tableTree.expandRow": "Expand row"
+  "@astryx.tableTree.expandRow": "Expand row",
+  "@astryx.tableTree.expandRowNamed": "Expand {label}"
 };
 
 export default english;

package/src/i18n/generated-english/TimeInput/TimeWheels.generated.ts

@@ -0,0 +1,18 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @generated by scripts/generate-i18n-runtime.mjs from packages/core/locales/en.json,
+ * holding the English for the catalog keys named in packages/core/src/TimeInput/TimeWheels.tsx.
+ * Do not edit by hand. Run `pnpm generate:i18n-runtime` instead.
+ */
+
+const english: Readonly<Record<string, string>> = {
+  "@astryx.dateTimeInput.hourWheel": "Hour",
+  "@astryx.dateTimeInput.meridiemAM": "AM",
+  "@astryx.dateTimeInput.meridiemPM": "PM",
+  "@astryx.dateTimeInput.meridiemWheel": "AM/PM",
+  "@astryx.dateTimeInput.minuteWheel": "Minute",
+  "@astryx.dateTimeInput.secondWheel": "Second"
+};
+
+export default english;

package/src/i18n/generated-locales/en.generated.ts

@@ -78,6 +78,49 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
     '{count, number} {count, plural, one {filter} other {filters}}',
   '@astryx.powersearch.resultCount':
     '{count, number} {count, plural, one {result} other {results}}',
+  '@astryx.powersearch.sheet.filtersTitle': 'Filters',
+  '@astryx.powersearch.sheet.addFilter': 'Add filter',
+  '@astryx.powersearch.sheet.noFilters': 'No filters applied',
+  '@astryx.powersearch.sheet.noFiltersInDraft': 'No filters',
+  '@astryx.powersearch.sheet.noFiltersDescription':
+    'Add a filter to narrow your results and find what you need faster.',
+  '@astryx.powersearch.sheet.clearAll': 'Clear all',
+  '@astryx.powersearch.sheet.clearAllTitle': 'Clear all filters?',
+  '@astryx.powersearch.sheet.clearAllDescription':
+    'This removes all editable filters from this search.',
+  '@astryx.powersearch.sheet.clearAllConfirm': 'Clear filters',
+  '@astryx.powersearch.sheet.clearAllCancel': 'Keep filters',
+  '@astryx.powersearch.sheet.done': 'Done',
+  '@astryx.powersearch.sheet.discardTitle': 'Discard changes?',
+  '@astryx.powersearch.sheet.discardDescription':
+    "Your changes to the filters haven't been applied.",
+  '@astryx.powersearch.sheet.keepEditing': 'Keep editing',
+  '@astryx.powersearch.sheet.discardConfirm': 'Discard changes',
+  '@astryx.powersearch.sheet.search': 'Search',
+  '@astryx.powersearch.sheet.searchResults': 'Search results',
+  '@astryx.powersearch.sheet.searchFields': 'Search filters',
+  '@astryx.powersearch.sheet.searchFieldsPlaceholder': 'Search filters…',
+  '@astryx.powersearch.sheet.ungroupedFields': 'General',
+  '@astryx.powersearch.sheet.noMatchingFields': 'No filters match your search',
+  '@astryx.powersearch.sheet.tryDifferentSearch': 'Try a different search.',
+  '@astryx.powersearch.sheet.noResults': 'No results found',
+  '@astryx.powersearch.sheet.filterUnavailable':
+    'This filter is no longer available',
+  '@astryx.powersearch.sheet.removeFilter': 'Remove {field} filter',
+  '@astryx.powersearch.sheet.relativeDaysAgo':
+    '{count, number} {count, plural, one {day} other {days}} ago',
+  '@astryx.powersearch.sheet.relativeDaysFromNow':
+    '{count, number} {count, plural, one {day} other {days}} from now',
+  '@astryx.powersearch.sheet.relativeWeeksAgo':
+    '{count, number} {count, plural, one {week} other {weeks}} ago',
+  '@astryx.powersearch.sheet.relativeWeeksFromNow':
+    '{count, number} {count, plural, one {week} other {weeks}} from now',
+  '@astryx.powersearch.sheet.relativeMonthsAgo':
+    '{count, number} {count, plural, one {month} other {months}} ago',
+  '@astryx.powersearch.sheet.relativeMonthsFromNow':
+    '{count, number} {count, plural, one {month} other {months}} from now',
+  '@astryx.powersearch.sheet.fieldOperator': '{field} {operator}',
+  '@astryx.powersearch.sheet.labelValue': '{label} {value}',
   '@astryx.alertDialog.cancel': 'Cancel',
   '@astryx.appShell.mobileNavigation': 'Mobile navigation',
   '@astryx.appShell.skipToContent': 'Skip to content',
@@ -413,7 +456,9 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
   '@astryx.tableGroupedRows.expandGroup': 'Expand group {groupKey}',
   '@astryx.tableGroupedRows.collapseGroup': 'Collapse group {groupKey}',
   '@astryx.tableRowExpansion.collapseRow': 'Collapse row',
+  '@astryx.tableRowExpansion.collapseRowNamed': 'Collapse {label}',
   '@astryx.tableRowExpansion.expandRow': 'Expand row',
+  '@astryx.tableRowExpansion.expandRowNamed': 'Expand {label}',
   '@astryx.tableRowExpansion.columnHeader': 'Row expansion',
   '@astryx.tableRowExpansion.collapseAllRows': 'Collapse all rows',
   '@astryx.tableRowExpansion.expandAllRows': 'Expand all rows',
@@ -429,7 +474,9 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
   '@astryx.step.status.error': 'error',
   '@astryx.switch.loading': 'Loading',
   '@astryx.tableTree.collapseRow': 'Collapse row',
+  '@astryx.tableTree.collapseRowNamed': 'Collapse {label}',
   '@astryx.tableTree.expandRow': 'Expand row',
+  '@astryx.tableTree.expandRowNamed': 'Expand {label}',
   '@astryx.tableTree.collapseAllRows': 'Collapse all rows',
   '@astryx.tableTree.expandAllRows': 'Expand all rows',
   '@astryx.textArea.counter': '{count, number}/{limit, number}',

package/src/i18n/generated-locales/pseudo.generated.ts

@@ -80,6 +80,50 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
     '⟦{count, number} {count, plural, one {filter} other {filters}}⟧',
   '@astryx.powersearch.resultCount':
     '⟦{count, number} {count, plural, one {result} other {results}}⟧',
+  '@astryx.powersearch.sheet.filtersTitle': '⟦Ƒíłţéřš⟧',
+  '@astryx.powersearch.sheet.addFilter': '⟦Àðð ƒíłţéř⟧',
+  '@astryx.powersearch.sheet.noFilters': '⟦Ñó ƒíłţéřš àþþłíéð⟧',
+  '@astryx.powersearch.sheet.noFiltersInDraft': '⟦Ñó ƒíłţéřš⟧',
+  '@astryx.powersearch.sheet.noFiltersDescription':
+    '⟦Àðð à ƒíłţéř ţó ñàřřóŵ ýóúř řéšúłţš àñð ƒíñð ŵĥàţ ýóú ñééð ƒàšţéř.⟧',
+  '@astryx.powersearch.sheet.clearAll': '⟦Çłéàř àłł⟧',
+  '@astryx.powersearch.sheet.clearAllTitle': '⟦Çłéàř àłł ƒíłţéřš?⟧',
+  '@astryx.powersearch.sheet.clearAllDescription':
+    '⟦Ţĥíš řéɱóṽéš àłł éðíţàƀłé ƒíłţéřš ƒřóɱ ţĥíš šéàřçĥ.⟧',
+  '@astryx.powersearch.sheet.clearAllConfirm': '⟦Çłéàř ƒíłţéřš⟧',
+  '@astryx.powersearch.sheet.clearAllCancel': '⟦Ķééþ ƒíłţéřš⟧',
+  '@astryx.powersearch.sheet.done': '⟦Ðóñé⟧',
+  '@astryx.powersearch.sheet.discardTitle': '⟦Ðíšçàřð çĥàñĝéš?⟧',
+  '@astryx.powersearch.sheet.discardDescription':
+    "⟦Ýóúř çĥàñĝéš ţó ţĥé ƒíłţéřš ĥàṽéñ'ţ ƀééñ àþþłíéð.⟧",
+  '@astryx.powersearch.sheet.keepEditing': '⟦Ķééþ éðíţíñĝ⟧',
+  '@astryx.powersearch.sheet.discardConfirm': '⟦Ðíšçàřð çĥàñĝéš⟧',
+  '@astryx.powersearch.sheet.search': '⟦Šéàřçĥ⟧',
+  '@astryx.powersearch.sheet.searchResults': '⟦Šéàřçĥ řéšúłţš⟧',
+  '@astryx.powersearch.sheet.searchFields': '⟦Šéàřçĥ ƒíłţéřš⟧',
+  '@astryx.powersearch.sheet.searchFieldsPlaceholder': '⟦Šéàřçĥ ƒíłţéřš…⟧',
+  '@astryx.powersearch.sheet.ungroupedFields': '⟦Ĝéñéřàł⟧',
+  '@astryx.powersearch.sheet.noMatchingFields':
+    '⟦Ñó ƒíłţéřš ɱàţçĥ ýóúř šéàřçĥ⟧',
+  '@astryx.powersearch.sheet.tryDifferentSearch': '⟦Ţřý à ð탃éřéñţ šéàřçĥ.⟧',
+  '@astryx.powersearch.sheet.noResults': '⟦Ñó řéšúłţš ƒóúñð⟧',
+  '@astryx.powersearch.sheet.filterUnavailable':
+    '⟦Ţĥíš ƒíłţéř íš ñó łóñĝéř àṽàíłàƀłé⟧',
+  '@astryx.powersearch.sheet.removeFilter': '⟦Řéɱóṽé {field} ƒíłţéř⟧',
+  '@astryx.powersearch.sheet.relativeDaysAgo':
+    '⟦{count, number} {count, plural, one {day} other {days}} àĝó⟧',
+  '@astryx.powersearch.sheet.relativeDaysFromNow':
+    '⟦{count, number} {count, plural, one {day} other {days}} ƒřóɱ ñóŵ⟧',
+  '@astryx.powersearch.sheet.relativeWeeksAgo':
+    '⟦{count, number} {count, plural, one {week} other {weeks}} àĝó⟧',
+  '@astryx.powersearch.sheet.relativeWeeksFromNow':
+    '⟦{count, number} {count, plural, one {week} other {weeks}} ƒřóɱ ñóŵ⟧',
+  '@astryx.powersearch.sheet.relativeMonthsAgo':
+    '⟦{count, number} {count, plural, one {month} other {months}} àĝó⟧',
+  '@astryx.powersearch.sheet.relativeMonthsFromNow':
+    '⟦{count, number} {count, plural, one {month} other {months}} ƒřóɱ ñóŵ⟧',
+  '@astryx.powersearch.sheet.fieldOperator': '⟦{field} {operator}⟧',
+  '@astryx.powersearch.sheet.labelValue': '⟦{label} {value}⟧',
   '@astryx.alertDialog.cancel': '⟦Çàñçéł⟧',
   '@astryx.appShell.mobileNavigation': '⟦Ṁóƀíłé ñàṽíĝàţíóñ⟧',
   '@astryx.appShell.skipToContent': '⟦Šķíþ ţó çóñţéñţ⟧',
@@ -422,7 +466,9 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
   '@astryx.tableGroupedRows.expandGroup': '⟦Éẋþàñð ĝřóúþ {groupKey}⟧',
   '@astryx.tableGroupedRows.collapseGroup': '⟦Çółłàþšé ĝřóúþ {groupKey}⟧',
   '@astryx.tableRowExpansion.collapseRow': '⟦Çółłàþšé řóŵ⟧',
+  '@astryx.tableRowExpansion.collapseRowNamed': '⟦Çółłàþšé {label}⟧',
   '@astryx.tableRowExpansion.expandRow': '⟦Éẋþàñð řóŵ⟧',
+  '@astryx.tableRowExpansion.expandRowNamed': '⟦Éẋþàñð {label}⟧',
   '@astryx.tableRowExpansion.columnHeader': '⟦Řóŵ éẋþàñšíóñ⟧',
   '@astryx.tableRowExpansion.collapseAllRows': '⟦Çółłàþšé àłł řóŵš⟧',
   '@astryx.tableRowExpansion.expandAllRows': '⟦Éẋþàñð àłł řóŵš⟧',
@@ -438,7 +484,9 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
   '@astryx.step.status.error': '⟦éřřóř⟧',
   '@astryx.switch.loading': '⟦Łóàðíñĝ⟧',
   '@astryx.tableTree.collapseRow': '⟦Çółłàþšé řóŵ⟧',
+  '@astryx.tableTree.collapseRowNamed': '⟦Çółłàþšé {label}⟧',
   '@astryx.tableTree.expandRow': '⟦Éẋþàñð řóŵ⟧',
+  '@astryx.tableTree.expandRowNamed': '⟦Éẋþàñð {label}⟧',
   '@astryx.tableTree.collapseAllRows': '⟦Çółłàþšé àłł řóŵš⟧',
   '@astryx.tableTree.expandAllRows': '⟦Éẋþàñð àłł řóŵš⟧',
   '@astryx.textArea.counter': '⟦{count, number}/{limit, number}⟧',

package/src/index.ts

@@ -173,6 +173,19 @@ export * from './Outline';
 // Overflow list
 export * from './OverflowList';
 
+// Animating one element: from the package root only, since one API has one
+// entry. Its hook ships from './hooks'.
+export {
+  createAnimator,
+  type Animator,
+  type AnimatorAnimateOptions,
+  type AnimatorChannel,
+  type AnimatorDecayVelocity,
+  type AnimatorHandle,
+  type AnimatorSnapshot,
+  type AnimatorValues,
+} from './animator/createAnimator';
+
 // Hooks
 export * from './hooks';
 

package/src/internal/indicatorPress.stylex.ts

@@ -0,0 +1,24 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file indicatorPress.stylex.ts
+ * @input Uses StyleX
+ * @output Exports `indicatorPressScope`, the marker of a first-party
+ *   indicator that paints its own press
+ * @position Internal entry for Astryx's own replacement indicators;
+ *   CheckboxInput reads it
+ */
+
+import * as stylex from '@stylexjs/stylex';
+
+/**
+ * Marks a first-party replacement indicator that paints its own press, for
+ * a shape that CheckboxInput's rounded-square press layer would tint past,
+ * such as a circle. CheckboxInput leaves that layer off over an indicator
+ * with this marker.
+ *
+ * @internal Not public API: the touch press reaches the indicator through a
+ * private property.
+ */
+export const indicatorPressScope: ReturnType<typeof stylex.defineMarker> =
+  stylex.defineMarker();

package/src/internal/selectable-card.ts

@@ -0,0 +1,21 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+/**
+ * @file selectable-card.ts
+ * @input SelectableCard's internal input context, the Field input styling
+ *   rule and the aria id joiner
+ * @output `@astryxdesign/core/internal/selectable-card`:
+ *   SelectableCardInputContext, useFieldInputStyling and joinAriaIDs,
+ *   re-exported by name
+ *   for Lab's SelectableCardGroup
+ * @position An internal entry reserved for Astryx's own packages:
+ *   undocumented, outside the public API and its compatibility promise,
+ *   versioned in lockstep with Core, and allowed only in Core and Lab by the
+ *   `@astryx/no-core-internal-import` lint rule. Core components import the
+ *   same modules by relative path. Named re-exports only.
+ *
+ * SYNC: When modified, update scripts/sync-exports.js.
+ */
+export {SelectableCardInputContext} from '../SelectableCard/selectableCardInput';
+export type {SelectableCardInput} from '../SelectableCard/selectableCardInput';
+export {useFieldInputStyling} from '../Field/fieldParts';
+export {joinAriaIDs} from '../utils/inputAria';

package/src/internal/sheetDraft.ts

@@ -4,8 +4,8 @@
  * @input A sheet's selection at open, its draft, and the last edit made
  * @output SheetDraftChange, hasSameSelection, nameSheetDraftChange — the
  *   rules a touch sheet's Save and dismissal share
- * @position Core-internal, shared by the Tokenizer sheet and the Lab sheets
- *   through `internal/touch-sheet`; not a public export
+ * @position Core-internal. The Tokenizer sheet uses it, and PowerSearch's
+ *   list-value step renders that sheet. Not a public export.
  *
  * A touch sheet edits a draft and reports it once, on Save, with one change:
  * the last edit that still holds, else the nearest net add or remove. A