@astryxdesign/core 0.7.7-canary.550ff21 → 0.7.7-canary.58c5b8a

package/src/i18n/generated-english/InfoTip/InfoTip.generated.ts

@@ -0,0 +1,13 @@
+// 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/InfoTip/InfoTip.tsx.
+ * Do not edit by hand. Run `pnpm generate:i18n-runtime` instead.
+ */
+
+const english: Readonly<Record<string, string>> = {
+  "@astryx.infoTip.label": "More information"
+};
+
+export default english;

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

@@ -8,6 +8,7 @@
 
 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.label": "Search",
   "@astryx.powersearch.placeholder": "Search…",

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

@@ -0,0 +1,43 @@
+// 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.done": "Done",
+  "@astryx.powersearch.sheet.editableFiltersClearedWithCount": "Editable filters removed. {resultCount}",
+  "@astryx.powersearch.sheet.fieldOperator": "{field} {operator}",
+  "@astryx.powersearch.sheet.filterUnavailable": "This filter is no longer available",
+  "@astryx.powersearch.sheet.filtersClearedWithCount": "All filters removed. {resultCount}",
+  "@astryx.powersearch.sheet.filtersTitle": "Filters",
+  "@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.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/Tokenizer/TokenizerBottomSheet.generated.ts

@@ -7,6 +7,7 @@
  */
 
 const english: Readonly<Record<string, string>> = {
+  "@astryx.alertDialog.cancel": "Cancel",
   "@astryx.textInput.clearLabel": "Clear {label}",
   "@astryx.tokenizer.add": "Add",
   "@astryx.tokenizer.addValue": "Add {value}",
@@ -16,11 +17,16 @@ const english: Readonly<Record<string, string>> = {
   "@astryx.tokenizer.clearAllTitle": "Clear all selected items?",
   "@astryx.tokenizer.clearSelection": "Clear selection",
   "@astryx.tokenizer.create": "Create \"{value}\"",
-  "@astryx.tokenizer.done": "Done",
+  "@astryx.tokenizer.discardChanges": "Discard changes",
+  "@astryx.tokenizer.discardChangesDescription": "Your changes to {label} haven't been saved.",
+  "@astryx.tokenizer.discardChangesTitle": "Discard changes?",
+  "@astryx.tokenizer.keepEditing": "Keep editing",
   "@astryx.tokenizer.noResultsDescription": "Try a different search.",
   "@astryx.tokenizer.nothingToClear": "Nothing selected",
+  "@astryx.tokenizer.save": "Save",
   "@astryx.tokenizer.search": "Search {label}",
   "@astryx.tokenizer.searchPlaceholder": "Search…",
+  "@astryx.tokenizer.selectionLimit": "Select up to {count, plural, one {# item} other {# items}}",
   "@astryx.tokenizer.tokenAdded": "Added {label}",
   "@astryx.tokenizer.tokenRemoved": "Removed {label}",
   "@astryx.typeahead.emptySearchResults": "No results found",

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

@@ -78,6 +78,47 @@ 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.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.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.powersearch.sheet.filtersClearedWithCount':
+    'All filters removed. {resultCount}',
+  '@astryx.powersearch.sheet.editableFiltersClearedWithCount':
+    'Editable filters removed. {resultCount}',
   '@astryx.alertDialog.cancel': 'Cancel',
   '@astryx.appShell.mobileNavigation': 'Mobile navigation',
   '@astryx.appShell.skipToContent': 'Skip to content',
@@ -315,6 +356,7 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
   '@astryx.powersearch.label': 'Search',
   '@astryx.powersearch.placeholder': 'Search…',
   '@astryx.powersearch.allFiltersRemoved': 'All filters removed',
+  '@astryx.powersearch.editableFiltersRemoved': 'Editable filters removed',
   '@astryx.resizable.collapsed': 'Collapsed',
   '@astryx.resizable.handle.label': 'Resize handle',
   '@astryx.selector.placeholder': 'Select…',
@@ -632,6 +674,7 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
   '@astryx.comments.loading': 'Loading comments',
   '@astryx.comments.olderFailed': "Earlier comments couldn't load",
   '@astryx.comments.postFailed': "Your comment couldn't be posted.",
+  '@astryx.infoTip.label': 'More information',
 };
 
 export default runtimeCatalog;

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

@@ -80,6 +80,48 @@ 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.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.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.powersearch.sheet.filtersClearedWithCount':
+    '⟦Àłł ƒíłţéřš řéɱóṽéð. {resultCount}⟧',
+  '@astryx.powersearch.sheet.editableFiltersClearedWithCount':
+    '⟦Éðíţàƀłé ƒíłţéřš řéɱóṽéð. {resultCount}⟧',
   '@astryx.alertDialog.cancel': '⟦Çàñçéł⟧',
   '@astryx.appShell.mobileNavigation': '⟦Ṁóƀíłé ñàṽíĝàţíóñ⟧',
   '@astryx.appShell.skipToContent': '⟦Šķíþ ţó çóñţéñţ⟧',
@@ -322,6 +364,7 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
   '@astryx.powersearch.label': '⟦Šéàřçĥ⟧',
   '@astryx.powersearch.placeholder': '⟦Šéàřçĥ…⟧',
   '@astryx.powersearch.allFiltersRemoved': '⟦Àłł ƒíłţéřš řéɱóṽéð⟧',
+  '@astryx.powersearch.editableFiltersRemoved': '⟦Éðíţàƀłé ƒíłţéřš řéɱóṽéð⟧',
   '@astryx.resizable.collapsed': '⟦Çółłàþšéð⟧',
   '@astryx.resizable.handle.label': '⟦Řéšížé ĥàñðłé⟧',
   '@astryx.selector.placeholder': '⟦Šéłéçţ…⟧',
@@ -643,6 +686,7 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
   '@astryx.comments.loading': '⟦Łóàðíñĝ çóɱɱéñţš⟧',
   '@astryx.comments.olderFailed': "⟦Éàřłíéř çóɱɱéñţš çóúłðñ'ţ łóàð⟧",
   '@astryx.comments.postFailed': "⟦Ýóúř çóɱɱéñţ çóúłðñ'ţ ƀé þóšţéð.⟧",
+  '@astryx.infoTip.label': '⟦Ṁóřé íñƒóřɱàţíóñ⟧',
 };
 
 export default runtimeCatalog;

package/src/index.ts

@@ -71,6 +71,7 @@ export * from './SelectableCard';
 export * from './Selector';
 export * from './MultiSelector';
 export * from './Icon';
+export * from './InfoTip';
 export * from './Indicator';
 export * from './InputGroup';
 export * from './Item';
@@ -172,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/SheetConfirmation.tsx

@@ -0,0 +1,101 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file SheetConfirmation.tsx
+ * @input Dialog, Layout, Heading, Text, Button; caller-owned copy
+ * @output SheetConfirmation — the confirmation a touch sheet opens over
+ *   itself for Clear all and for discarding a changed draft
+ * @position Core-internal, shared by the Tokenizer sheet and the PowerSearch
+ *   sheets; not a public export
+ *
+ * AlertDialog fixes its purpose to form and its safe action to ghost. A touch
+ * sheet's confirmation allows scrim dismissal. Its two full-width large
+ * actions are stacked and separated: the destructive action first in reading
+ * order, the safe action focused first. The alert-dialog theme target stays.
+ */
+
+import {useId} from 'react';
+import * as stylex from '@stylexjs/stylex';
+import {Button} from '../Button/Button';
+import {Dialog} from '../Dialog/Dialog';
+import {Heading} from '../Heading/Heading';
+import {Layout} from '../Layout/Layout';
+import {LayoutContent} from '../Layout/LayoutContent';
+import {LayoutFooter} from '../Layout/LayoutFooter';
+import {Stack} from '../Stack/Stack';
+import {Text} from '../Text/Text';
+import {themeProps} from '../utils/themeProps';
+
+export interface SheetConfirmationProps {
+  isOpen: boolean;
+  onOpenChange: (isOpen: boolean) => void;
+  title: string;
+  description: string;
+  cancelLabel: string;
+  actionLabel: string;
+  onAction: () => void;
+}
+
+const styles = stylex.create({
+  action: {width: '100%'},
+});
+
+export function SheetConfirmation({
+  isOpen,
+  onOpenChange,
+  title,
+  description,
+  cancelLabel,
+  actionLabel,
+  onAction,
+}: SheetConfirmationProps) {
+  const titleId = useId();
+  const descriptionId = useId();
+  return (
+    <Dialog
+      {...themeProps('alert-dialog')}
+      isOpen={isOpen}
+      onOpenChange={onOpenChange}
+      purpose="info"
+      role="alertdialog"
+      aria-labelledby={titleId}
+      aria-describedby={descriptionId}
+      width={400}>
+      <Layout
+        content={
+          <LayoutContent>
+            <Heading level={2} id={titleId}>
+              {title}
+            </Heading>
+            <Text type="body" color="secondary" id={descriptionId}>
+              {description}
+            </Text>
+          </LayoutContent>
+        }
+        footer={
+          <LayoutFooter>
+            <Stack direction="vertical" gap={4} hAlign="stretch">
+              <Button
+                label={actionLabel}
+                variant="destructive"
+                size="lg"
+                onClick={onAction}
+                xstyle={styles.action}
+              />
+              <Button
+                label={cancelLabel}
+                variant="secondary"
+                size="lg"
+                onClick={() => onOpenChange(false)}
+                data-autofocus
+                xstyle={styles.action}
+              />
+            </Stack>
+          </LayoutFooter>
+        }
+      />
+    </Dialog>
+  );
+}

package/src/internal/sheetDraft.ts

@@ -0,0 +1,80 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+/**
+ * @file sheetDraft.ts
+ * @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
+ *
+ * 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
+ * dismissal asks before discarding only while the draft differs from the
+ * selection at open, as a set: a row unchecked and checked again is no change.
+ */
+
+interface SheetDraftItem {
+  id: string | number;
+}
+
+/** An edit of a sheet's draft, and the shape Save reports. */
+export type SheetDraftChange<T> = {
+  item: T;
+  type: 'add' | 'create' | 'remove';
+};
+
+/** Whether two selections hold the same items, in any order. */
+export function hasSameSelection<T extends SheetDraftItem>(
+  a: ReadonlyArray<T>,
+  b: ReadonlyArray<T>,
+): boolean {
+  if (a.length !== b.length) {
+    return false;
+  }
+  const ids = new Set(a.map(item => item.id));
+  return b.every(item => ids.has(item.id));
+}
+
+/**
+ * The change Save reports for a draft that differs from the selection at
+ * open, or `null` when nothing differs. The last edit names it when it still
+ * holds: its item is in the draft and was not selected at open, or was
+ * selected at open and is gone. Otherwise, after a removal, a `remove` names
+ * an item that is gone; otherwise an `add` (`create` when the last edit
+ * created that item) names an item that is new; otherwise a `remove` names
+ * an item that is gone.
+ */
+export function nameSheetDraftChange<T extends SheetDraftItem>(
+  valueAtOpen: ReadonlyArray<T>,
+  draftValue: ReadonlyArray<T>,
+  lastDraftChange: SheetDraftChange<T> | null,
+): SheetDraftChange<T> | null {
+  const wasSelected = (id: T['id']) => valueAtOpen.some(item => item.id === id);
+  const isSelected = (id: T['id']) => draftValue.some(item => item.id === id);
+  const added = draftValue.find(item => !wasSelected(item.id));
+  const removed = valueAtOpen.find(item => !isSelected(item.id));
+  const lastChangeIsNet =
+    lastDraftChange != null &&
+    (lastDraftChange.type === 'remove'
+      ? wasSelected(lastDraftChange.item.id) &&
+        !isSelected(lastDraftChange.item.id)
+      : isSelected(lastDraftChange.item.id) &&
+        !wasSelected(lastDraftChange.item.id));
+  if (lastChangeIsNet) {
+    return lastDraftChange;
+  }
+  if (lastDraftChange?.type === 'remove' && removed != null) {
+    return {item: removed, type: 'remove'};
+  }
+  if (added != null) {
+    const type: SheetDraftChange<T>['type'] =
+      lastDraftChange?.item.id === added.id && lastDraftChange.type === 'create'
+        ? 'create'
+        : 'add';
+    return {item: added, type};
+  }
+  if (removed != null) {
+    return {item: removed, type: 'remove'};
+  }
+  return null;
+}

package/src/internal/touch-sheet.ts

@@ -0,0 +1,21 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+/**
+ * @file touch-sheet.ts
+ * @input The touch sheets' shared confirmation, search-drag dismissal and
+ *   draft rules
+ * @output `@astryxdesign/core/internal/touch-sheet`: SheetConfirmation,
+ *   useDismissSearchOnTouchDrag, hasSameSelection and nameSheetDraftChange,
+ *   re-exported by name for Lab's sheets
+ * @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 {SheetConfirmation} from './SheetConfirmation';
+export type {SheetConfirmationProps} from './SheetConfirmation';
+export {useDismissSearchOnTouchDrag} from './useDismissSearchOnTouchDrag';
+export {hasSameSelection, nameSheetDraftChange} from './sheetDraft';
+export type {SheetDraftChange} from './sheetDraft';

package/src/internal/useDismissSearchOnTouchDrag.ts

@@ -0,0 +1,69 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file useDismissSearchOnTouchDrag.ts
+ * @input Caller-owned search inputs, a focus target, and touch events from a
+ *   separate results list
+ * @output useDismissSearchOnTouchDrag — touch handlers for the results list
+ * @position Core-internal, shared by the touch sheets; not a public export
+ *
+ * A direct vertical touch drag on the results moves focus off a focused
+ * search input. The on-screen keyboard then leaves and the rows come into
+ * view; the query stays. Focus goes to the caller's target (the sheet's
+ * panel), never to the page body behind an open modal. Scroll events are not
+ * observed: filtering can clamp scrollTop and fire scroll while someone is
+ * typing. Small moves, taps and multi-touch gestures leave focus alone.
+ */
+
+import {useRef, type TouchEvent} from 'react';
+
+const DRAG_THRESHOLD_PX = 8;
+
+type SearchInput = HTMLInputElement | null | undefined;
+
+export function useDismissSearchOnTouchDrag(
+  getSearchInputs: () => ReadonlyArray<SearchInput>,
+  getFocusTarget?: () => HTMLElement | null | undefined,
+) {
+  const startYRef = useRef<number | null>(null);
+  const reset = () => {
+    startYRef.current = null;
+  };
+
+  return {
+    onTouchStart: (event: TouchEvent<HTMLElement>) => {
+      startYRef.current =
+        event.touches.length === 1 ? event.touches[0].clientY : null;
+    },
+    onTouchMove: (event: TouchEvent<HTMLElement>) => {
+      if (event.touches.length !== 1) {
+        reset();
+        return;
+      }
+      const startY = startYRef.current;
+      if (
+        startY == null ||
+        Math.abs(event.touches[0].clientY - startY) < DRAG_THRESHOLD_PX
+      ) {
+        return;
+      }
+      reset();
+      const focusedSearch = getSearchInputs().find(
+        input => input != null && input === document.activeElement,
+      );
+      if (focusedSearch == null) {
+        return;
+      }
+      const target = getFocusTarget?.();
+      if (target != null) {
+        target.focus({preventScroll: true});
+      } else {
+        focusedSearch.blur();
+      }
+    },
+    onTouchEnd: reset,
+    onTouchCancel: reset,
+  };
+}