@onekeyfe/react-native-native-list 6.7.0-alpha.378 → 6.7.0-alpha.383

package/src/NativeList.web.tsx

@@ -37,6 +37,8 @@ import {
   canonicalNativeListAvatarUri,
 } from './web/NativeListWebAvatarCache';
 
+const collapsedExpandedContentStyle = { display: 'none' } as const;
+
 export type { NativeListProps, NativeListRef } from './NativeList.types';
 export type {
   ActionAnchorState,
@@ -93,6 +95,10 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
       listHeader,
       listEmpty,
       listFooter,
+      listExpandedContent,
+      listStructureToggle,
+      listSidecar,
+      sidecarLayout,
       topOverlay: _topOverlay,
       topScrollEdgeEffect: _topScrollEdgeEffect,
       webScrollHost,
@@ -109,6 +115,7 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
       onReorder,
       onEndReached,
       onVisibleRangeChanged,
+      onStructuralTransitionSettled: _onStructuralTransitionSettled,
       onRefresh,
       onScrollToIndexFailed,
       initialScrollIndex,
@@ -132,10 +139,16 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
         }) ?? 0,
       [inputStickyInset]
     );
-    const preparedSnapshot = useMemo(
-      () => containNativeListInput(() => validateSnapshot(inputSnapshot)),
-      [inputSnapshot]
-    );
+    // Freshness is limited to this component invocation; later renders revalidate.
+    let freshlyValidatedSnapshot: NativeListSnapshot | undefined;
+    const preparedSnapshot = useMemo(() => {
+      const prepared = containNativeListInput(() =>
+        validateSnapshot(inputSnapshot)
+      );
+      // eslint-disable-next-line react-hooks/exhaustive-deps -- The value is intentionally render-local.
+      freshlyValidatedSnapshot = prepared;
+      return prepared;
+    }, [inputSnapshot]);
     const snapshot = preparedSnapshot ?? acceptedSnapshotRef.current;
     const fontFamiliesJson = useNativeListFontFamiliesJson();
     const fontFamiliesJsonRef = useRef(fontFamiliesJson);
@@ -143,49 +156,28 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
     const hasEmptySlot = listEmpty !== undefined;
     const hasEmptySlotRef = useRef(hasEmptySlot);
     hasEmptySlotRef.current = hasEmptySlot;
-    const [slotState, setSlotState] = useState(() => ({
-      hasRows: snapshot.rows.length > 0,
-      emptyBottomPadding:
-        !snapshot.rows.length && hasEmptySlot
-          ? snapshot.layout.contentPaddingBottom ??
-            snapshot.layout.contentPadding ??
-            0
-          : 0,
-      padding:
-        snapshot.layout.contentPaddingHorizontal ??
-        snapshot.layout.contentPadding ??
-        0,
-    }));
-    const synchronizeSlots = (next: NativeListSnapshot) => {
-      const hasRows = next.rows.length > 0;
-      const padding =
-        next.layout.contentPaddingHorizontal ?? next.layout.contentPadding ?? 0;
-      const emptyBottomPadding =
-        !hasRows && hasEmptySlotRef.current
-          ? next.layout.contentPaddingBottom ?? next.layout.contentPadding ?? 0
-          : 0;
-      setSlotState((previous) =>
-        previous.hasRows === hasRows &&
-        previous.padding === padding &&
-        previous.emptyBottomPadding === emptyBottomPadding
-          ? previous
-          : { hasRows, padding, emptyBottomPadding }
-      );
-    };
+    const [viewportWidth, setViewportWidth] = useState(0);
+    const [sidecarHeight, setSidecarHeight] = useState(0);
     const normalizeWebSnapshot = (
       next: NativeListSnapshot,
       hasReactEmpty = hasEmptySlotRef.current,
-      hasSlotLayout = useSlotLayoutRef.current
+      hasSlotLayout = useSlotLayoutRef.current,
+      validatedInThisRender = false
     ) => {
       if (hasSlotLayout && next.layout.orientation === 'horizontal')
         throw new Error(
           'Web parent scrolling and container slots support vertical lists only'
         );
       const emptySlot = hasReactEmpty && next.rows.length === 0;
-      const validated = validateSnapshot(
-        emptySlot ? { ...next, emptyState: undefined } : next
-      );
-      return emptySlot
+      const normalized =
+        emptySlot && next.emptyState !== undefined
+          ? { ...next, emptyState: undefined }
+          : next;
+      const validated = validatedInThisRender
+        ? normalized
+        : validateSnapshot(normalized);
+      // Preserve an already normalized fallback's identity across rerenders.
+      return emptySlot && validated.layout.contentPaddingBottom !== 0
         ? {
             ...validated,
             layout: { ...validated.layout, contentPaddingBottom: 0 },
@@ -205,6 +197,9 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
       listHeader !== undefined ||
       listEmpty !== undefined ||
       listFooter !== undefined;
+    useSlotLayoutRef.current ||= listSidecar !== undefined;
+    useSlotLayoutRef.current ||=
+      listExpandedContent !== undefined || listStructureToggle !== undefined;
     const useSlotLayout = useSlotLayoutRef.current;
     const resolvedScrollHost =
       webScrollHost === undefined
@@ -217,11 +212,86 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
     webVirtualizationEnabledRef.current = webVirtualizationEnabled;
     const validatedSnapshot = useMemo(
       () =>
-        containNativeListInput(() =>
-          normalizeWebSnapshot(snapshot, hasEmptySlot, useSlotLayout)
-        ) ?? acceptedSnapshotRef.current,
-      [snapshot, hasEmptySlot, useSlotLayout]
+        containNativeListInput(() => {
+          if ((listSidecar !== undefined) !== (sidecarLayout !== undefined))
+            throw new Error(
+              'listSidecar and sidecarLayout must be supplied together'
+            );
+          if (sidecarLayout) {
+            const { width, gap, maxContentWidth } = sidecarLayout;
+            if (
+              snapshot.layout.kind !== 'linear' ||
+              !Number.isFinite(width) ||
+              width <= 0 ||
+              !Number.isFinite(gap) ||
+              gap < 0 ||
+              !Number.isFinite(maxContentWidth) ||
+              maxContentWidth <= width + gap
+            )
+              throw new Error('Invalid NativeList sidecar layout');
+          }
+          return normalizeWebSnapshot(
+            snapshot,
+            hasEmptySlot,
+            useSlotLayout,
+            preparedSnapshot !== undefined &&
+              preparedSnapshot === freshlyValidatedSnapshot
+          );
+        }) ?? acceptedSnapshotRef.current,
+      // eslint-disable-next-line react-hooks/exhaustive-deps -- Preserve the existing memo dependencies; freshness is render-local.
+      [snapshot, hasEmptySlot, useSlotLayout, listSidecar, sidecarLayout]
     );
+    const [slotState, setSlotState] = useState(() => ({
+      hasRows: validatedSnapshot.rows.length > 0,
+      emptyBottomPadding:
+        !validatedSnapshot.rows.length && hasEmptySlot
+          ? validatedSnapshot.layout.contentPaddingBottom ??
+            validatedSnapshot.layout.contentPadding ??
+            0
+          : 0,
+      padding:
+        validatedSnapshot.layout.contentPaddingHorizontal ??
+        validatedSnapshot.layout.contentPadding ??
+        0,
+      disclosurePresent: validatedSnapshot.disclosure !== undefined,
+      disclosureExpanded: validatedSnapshot.disclosure?.expanded === true,
+      hasExpandedContent: validatedSnapshot.disclosure?.expanded === true,
+      expandedTrailingInset:
+        validatedSnapshot.disclosure?.expandedTrailingInset ?? 0,
+    }));
+    const synchronizeSlots = (next: NativeListSnapshot) => {
+      const hasRows = next.rows.length > 0;
+      const padding =
+        next.layout.contentPaddingHorizontal ?? next.layout.contentPadding ?? 0;
+      const emptyBottomPadding =
+        !hasRows && hasEmptySlotRef.current
+          ? next.layout.contentPaddingBottom ?? next.layout.contentPadding ?? 0
+          : 0;
+      const disclosurePresent = next.disclosure !== undefined;
+      const disclosureExpanded = next.disclosure?.expanded === true;
+      const expandedTrailingInset = next.disclosure?.expandedTrailingInset ?? 0;
+      setSlotState((previous) => {
+        const hasExpandedContent =
+          previous.hasExpandedContent || disclosureExpanded;
+        return previous.hasRows === hasRows &&
+          previous.padding === padding &&
+          previous.emptyBottomPadding === emptyBottomPadding &&
+          previous.disclosurePresent === disclosurePresent &&
+          previous.disclosureExpanded === disclosureExpanded &&
+          previous.hasExpandedContent === hasExpandedContent &&
+          previous.expandedTrailingInset === expandedTrailingInset
+          ? previous
+          : {
+              hasRows,
+              padding,
+              emptyBottomPadding,
+              disclosurePresent,
+              disclosureExpanded,
+              hasExpandedContent,
+              expandedTrailingInset,
+            };
+      });
+    };
     const snapshotRef = useRef(validatedSnapshot);
     const snapshotPropRef = useRef(validatedSnapshot);
     // An imperative snapshot survives host mounting until the snapshot prop changes.
@@ -229,7 +299,7 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
       snapshotPropRef.current = validatedSnapshot;
       snapshotRef.current = validatedSnapshot;
       acceptedSnapshotRef.current = validatedSnapshot;
-      synchronizeSlots(snapshot);
+      synchronizeSlots(validatedSnapshot);
     }
     if (!initializedSnapshot.current) {
       acceptedSnapshotRef.current = validatedSnapshot;
@@ -498,9 +568,19 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
     );
     if (!useSlotLayout) return <View {...viewProps} ref={setHostRef} />;
     const padding = slotState.padding;
+    const footerBandStyle = { paddingHorizontal: padding };
+    const trailingInsetStyle = {
+      height: slotState.disclosureExpanded
+        ? slotState.expandedTrailingInset
+        : 0,
+    };
+    const hasFooterBand =
+      listFooter !== undefined ||
+      listExpandedContent !== undefined ||
+      listStructureToggle !== undefined;
     const content = (
       <View
-        ref={setBoundsRef}
+        ref={sidecarLayout ? undefined : setBoundsRef}
         style={{ position: 'relative', flexShrink: 0, minWidth: 0 }}
       >
         {listHeader !== undefined ? (
@@ -517,14 +597,90 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
             {listEmpty}
           </View>
         ) : null}
-        {listFooter !== undefined ? (
-          <View style={{ paddingHorizontal: padding }}>{listFooter}</View>
+        {hasFooterBand ? (
+          <View testID="native-list-footer-slot" style={footerBandStyle}>
+            {listExpandedContent !== undefined &&
+            slotState.hasExpandedContent ? (
+              <View
+                testID="native-list-expanded-content-slot"
+                aria-hidden={!slotState.disclosureExpanded}
+                pointerEvents={slotState.disclosureExpanded ? 'auto' : 'none'}
+                style={
+                  slotState.disclosureExpanded
+                    ? undefined
+                    : collapsedExpandedContentStyle
+                }
+              >
+                {listExpandedContent}
+              </View>
+            ) : null}
+            {listStructureToggle !== undefined ? (
+              <View
+                testID="native-list-structure-toggle-slot"
+                aria-hidden={!slotState.disclosurePresent}
+                pointerEvents={slotState.disclosurePresent ? 'auto' : 'none'}
+                style={
+                  slotState.disclosurePresent
+                    ? undefined
+                    : collapsedExpandedContentStyle
+                }
+              >
+                {listStructureToggle}
+              </View>
+            ) : null}
+            {slotState.expandedTrailingInset > 0 &&
+            (listExpandedContent !== undefined ||
+              listStructureToggle !== undefined) ? (
+              <View
+                testID="native-list-trailing-inset-slot"
+                style={trailingInsetStyle}
+              />
+            ) : null}
+            {listFooter}
+          </View>
         ) : null}
       </View>
     );
+    const bandWidth = sidecarLayout
+      ? Math.min(viewportWidth, sidecarLayout.maxContentWidth)
+      : 0;
+    const sidecarMargin = Math.max(0, (viewportWidth - bandWidth) / 2);
+    const leftWidth = Math.max(
+      0,
+      bandWidth - (sidecarLayout?.width ?? 0) - (sidecarLayout?.gap ?? 0)
+    );
+    const scrollContent = sidecarLayout ? (
+      <View
+        ref={setBoundsRef}
+        style={{ position: 'relative', minHeight: sidecarHeight }}
+      >
+        <View style={{ marginStart: sidecarMargin, width: leftWidth }}>
+          {content}
+        </View>
+        <View
+          style={{
+            position: 'absolute',
+            end: sidecarMargin,
+            top: 0,
+            width: sidecarLayout.width,
+          }}
+          onLayout={(event) =>
+            setSidecarHeight(event.nativeEvent.layout.height)
+          }
+        >
+          {listSidecar}
+        </View>
+      </View>
+    ) : (
+      content
+    );
     return (
       <View
         {...viewProps}
+        onLayout={(event) => {
+          setViewportWidth(event.nativeEvent.layout.width);
+          viewProps.onLayout?.(event);
+        }}
         style={[viewProps.style, { position: 'relative', minHeight: 0 }]}
       >
         {webScrollHost === undefined ? (
@@ -532,10 +688,10 @@ export const NativeList = forwardRef<NativeListRef, NativeListProps>(
             ref={setScrollHostRef}
             style={{ position: 'absolute', inset: 0, overflow: 'scroll' }}
           >
-            {content}
+            {scrollContent}
           </View>
         ) : (
-          content
+          scrollContent
         )}
       </View>
     );

package/src/index.ts

@@ -14,10 +14,12 @@ export type {
   ScrollToKeyParams,
   ScrollToLocationParams,
   ScrollToOffsetParams,
+  StructuralTransitionSettledEvent,
 } from './NativeList';
 export type * from './models';
 export {
   applyRowPatches,
+  planNativeListPatches,
   serializePatches,
   serializeSnapshot,
   validatePatches,

package/src/models.ts

@@ -185,6 +185,7 @@ export const ROW_BOX_STYLE_KEYS_BY_TYPE = {
     'trailingGap',
     'image',
   ],
+  buttonGroup: [],
   system: ['horizontalPadding', 'verticalPadding', 'lineGap'],
 } as const;
 
@@ -201,6 +202,7 @@ type TemplateBoxStyle<T extends keyof typeof ROW_BOX_STYLE_KEYS_BY_TYPE> = Pick<
  */
 export type IdentityRowStyle = TemplateBoxStyle<'identity'> &
   Readonly<{
+    leadingContentMaxWidthRatio?: number;
     title?: NativeListTextStyle;
     subtitle?: NativeListTextStyle;
     tertiary?: NativeListTextStyle;
@@ -279,8 +281,16 @@ export type SectionHeaderRowStyle = TemplateBoxStyle<'sectionHeader'> &
     title?: NativeListTextStyle;
     subtitle?: NativeListTextStyle;
     value?: NativeListTextStyle;
+    valuePlacement?: 'afterTitle';
+    titleDecoration?: 'none' | 'dashed';
   }>;
 
+export type RowTextHelp = Readonly<{
+  actionKey: string;
+  presentation: 'tooltip' | 'popover';
+  underline?: 'dashed';
+}>;
+
 export type ActionRowStyle = TemplateBoxStyle<'action'> &
   Readonly<{
     title?: NativeListTextStyle;
@@ -344,19 +354,27 @@ export type VisualOverlay = Readonly<{
   offsetX?: number;
   offsetY?: number;
   image?: ImageSource;
+  fallbackIcon?: Readonly<{ name: string; tintColor?: string }>;
   name?: string;
   text?: string;
+  fontWeight?: NativeListTextStyle['fontWeight'];
   tintColor?: string;
   backgroundColor?: string;
 }>;
 
 type VisualWithImage = Readonly<{
-  fallbackIcon?: Readonly<{ name: string; tintColor?: string }>;
+  fallbackIcon?: Readonly<{
+    name: string;
+    tintColor?: string;
+    size?: number;
+    backgroundColor?: string;
+  }>;
   overlays?: readonly VisualOverlay[];
   borderStyle?: 'dashed';
   borderColor?: string;
   image?: ImageSource;
   fallbackText?: string;
+  fallbackTextColor?: string;
   backgroundColor?: string;
   shape?: 'circle' | 'rounded' | 'square';
   cornerIcon?: Readonly<{
@@ -408,9 +426,26 @@ export type TrailingAccessory =
       kind: 'valuePair';
       primary: string;
       secondary: string;
+      primaryFontWeight?: 'medium';
+      primaryHelp?: RowTextHelp;
+      primaryTextSegments?: readonly ValueTextSegment[];
+      secondaryTextSegments?: readonly ValueTextSegment[];
       primaryTone?: TextTone;
       secondaryTone?: TextTone;
     }>
+  | Readonly<{
+      kind: 'button';
+      label: string;
+      actionKey: string;
+      disabled?: boolean;
+      testID?: string;
+      accessibilityLabel?: string;
+      textColor?: string;
+      backgroundColor?: string;
+      pressedBackgroundColor?: string;
+      hoverBackgroundColor?: string;
+      focusRingColor?: string;
+    }>
   | Readonly<{
       kind: 'checkbox';
       state: CheckboxState;
@@ -438,6 +473,7 @@ export type TrailingAccessory =
       kind: 'icon';
       name: string;
       tintColor?: string;
+      buttonStyle?: 'tertiary';
       disabled?: boolean;
       actionKey?: string;
       testID?: string;
@@ -480,6 +516,10 @@ export type RowBase = Readonly<{
 export type IdentityRow = RowBase &
   Readonly<{
     type: 'identity';
+    /** Opt in to content-based height; explicit row/container height still wins. */
+    contentHeight?: 'auto';
+    /** Emits a row action instead of a press after a successful long press. */
+    longPressActionKey?: string;
     // OneKey patch: UTF-16 ranges match Fuse indices and native attributed strings.
     titleMatch?: readonly Readonly<{ start: number; end: number }>[];
     titleActionKey?: string;
@@ -489,11 +529,27 @@ export type IdentityRow = RowBase &
     leading: LeadingVisual;
     leadingAction?: Extract<TrailingAccessory, { kind: 'icon' }>;
     title: string;
+    /** Plain 12/16 labels beside the title, preserving independent tones. */
+    titleSuffixes?: readonly Readonly<{
+      text: string;
+      tone: 'secondary' | 'disabled';
+      maxWidth?: number;
+    }>[];
+    titleIcon?: Readonly<{
+      name: string;
+      tintColor?: string;
+      accessibilityLabel?: string;
+      /** Web-only anchored help from this icon; does not add a click action. */
+      hoverActionKey?: string;
+    }>;
+    /** Web-only additional help icon after titleIcon. */
+    secondaryTitleIcon?: IdentityRow['titleIcon'];
     subtitle?: string;
     tertiary?: string;
     tertiaryTone?: 'secondary' | 'info';
     titleLines?: 1 | 2;
-    subtitleLines?: 1 | 2;
+    /** Zero displays the complete subtitle. */
+    subtitleLines?: 0 | 1 | 2;
     badges?: readonly BadgeModel[];
     trailing?: readonly TrailingAccessory[];
     draggable?: boolean;
@@ -534,6 +590,7 @@ export type ActivityRow = RowBase &
   Readonly<{
     type: 'activity';
     leading: LeadingVisual;
+    hideLeading?: boolean;
     secondaryLeading?: LeadingVisual;
     title: string;
     description?: string;
@@ -559,11 +616,14 @@ export type ActivityRow = RowBase &
 export type MessageRow = RowBase &
   Readonly<{
     type: 'message';
+    /** Draws only top and bottom container borders when a border is supplied. */
+    presentation?: 'inlineWarning';
     unread?: boolean;
     leading?: LeadingVisual;
     title: string;
     body: string;
-    bodyLines?: 1 | 2 | 3;
+    /** Zero displays the complete body. */
+    bodyLines?: 0 | 1 | 2 | 3;
     time: string;
     thumbnail?: ImageSource;
     style?: MessageRowStyle;
@@ -572,8 +632,12 @@ export type MessageRow = RowBase &
 export type DataColumn = Readonly<{
   key: string;
   text: string;
+  textSegments?: readonly ValueTextSegment[];
+  titleIcon?: IdentityRow['titleIcon'];
+  secondaryTitleIcon?: IdentityRow['titleIcon'];
   secondaryLeadingText?: string;
   secondaryText?: string;
+  secondaryTextSegments?: readonly ValueTextSegment[];
   weight?: 1 | 2 | 3;
   alignment?: 'start' | 'center' | 'end';
   tone?: 'primary' | 'secondary' | 'positive' | 'negative';
@@ -585,6 +649,7 @@ export type DataRow = RowBase &
     type: 'dataRow';
     leading?: LeadingVisual;
     columns: readonly DataColumn[];
+    trailing?: readonly TrailingAccessory[];
     checkbox?: Extract<TrailingAccessory, { kind: 'checkbox' }>;
     index?: number;
     badge?: BadgeModel;
@@ -766,9 +831,11 @@ export type SectionHeaderRow = RowBase &
     indexTitle?: string;
     variant?: 'summary' | 'gallery' | 'history';
     title: string;
+    leadingBadge?: BadgeModel;
     titleLoading?: boolean;
     subtitle?: string;
     value?: string;
+    valueHelp?: RowTextHelp;
     valueActionKey?: string;
     titleIcon?: Extract<TrailingAccessory, { kind: 'icon' }>;
     valueIcon?: Extract<TrailingAccessory, { kind: 'icon' }>;
@@ -789,6 +856,21 @@ export type ActionRow = RowBase &
     style?: ActionRowStyle;
   }>;
 
+export type ButtonGroupRow = RowBase &
+  Readonly<{
+    type: 'buttonGroup';
+    buttons: readonly Readonly<{
+      key: string;
+      label: string;
+      actionKey: string;
+      disabled?: boolean;
+      loading?: boolean;
+      testID?: string;
+      accessibilityLabel?: string;
+    }>[];
+    style?: TemplateBoxStyle<'buttonGroup'>;
+  }>;
+
 export type SystemRow = RowBase &
   Readonly<{ style?: SystemRowStyle }> &
   (
@@ -841,6 +923,7 @@ export type RowModel =
   | MetricCardRow
   | SectionHeaderRow
   | ActionRow
+  | ButtonGroupRow
   | SystemRow;
 
 export type NativeListTheme = Readonly<{
@@ -853,6 +936,8 @@ export type NativeListTheme = Readonly<{
   rowBackground: string;
   rowSelectedBackground: string;
   rowPressedBackground?: string;
+  /** Web-only enabled-row hover color; defaults to rowPressedBackground. */
+  rowHoverBackground?: string;
   subduedBackground?: string;
   strongBackground?: string;
   /** Web-only background for a displayed declared image fallback. */
@@ -865,6 +950,8 @@ export type NativeListTheme = Readonly<{
   separator: string;
   accent: string;
   positive: string;
+  /** Optional exact background for the success tone of section leading badges. */
+  successBackground?: string;
   negative: string;
   criticalBackground?: string;
   inverseBackground?: string;
@@ -911,6 +998,16 @@ export type NativeListListStyle = Readonly<{
 export type NativeListSnapshot = Readonly<{
   schemaVersion: 1;
   generation: number;
+  /** One-shot animation for a user-initiated row-key insertion or removal. */
+  structuralTransition?: Readonly<{
+    id: string;
+    durationMs?: number;
+    anchorKey?: string;
+  }>;
+  disclosure?: Readonly<{
+    expanded: boolean;
+    expandedTrailingInset?: number;
+  }>;
   layout: Readonly<{
     kind: NativeListLayout;
     orientation?: NativeListOrientation;
@@ -968,7 +1065,13 @@ export type RowPatch =
           IdentityRow,
           | CommonPatchFields
           | 'title'
+          | 'titleSuffixes'
+          | 'titleIcon'
+          | 'secondaryTitleIcon'
           | 'subtitle'
+          | 'subtitleLines'
+          | 'contentHeight'
+          | 'longPressActionKey'
           | 'tertiary'
           | 'tertiaryTone'
           | 'badges'
@@ -1010,6 +1113,7 @@ export type RowPatch =
           | 'primaryAmount'
           | 'secondaryAmount'
           | 'leading'
+          | 'hideLeading'
           | 'secondaryLeading'
           | 'footerActions'
         >
@@ -1026,6 +1130,7 @@ export type RowPatch =
           | 'title'
           | 'body'
           | 'bodyLines'
+          | 'presentation'
           | 'time'
           | 'thumbnail'
         >
@@ -1040,6 +1145,7 @@ export type RowPatch =
           | CommonPatchFields
           | 'leading'
           | 'columns'
+          | 'trailing'
           | 'checkbox'
           | 'index'
           | 'badge'
@@ -1124,6 +1230,8 @@ export type RowPatch =
           | 'title'
           | 'subtitle'
           | 'value'
+          | 'valueHelp'
+          | 'leadingBadge'
           | 'valueActionKey'
           | 'titleActionKey'
           | 'titleActionOnHover'
@@ -1148,6 +1256,11 @@ export type RowPatch =
         >
       >;
     }>
+  | Readonly<{
+      type: 'buttonGroup';
+      key: string;
+      changes: Partial<Pick<ButtonGroupRow, CommonPatchFields | 'buttons'>>;
+    }>
   | Readonly<{
       type: 'system';
       key: string;
@@ -1164,6 +1277,7 @@ export type NativeListActionSource =
   | 'leadingAction'
   | 'trailingAccessory'
   | 'footerAction'
+  | 'buttonGroup'
   | 'description'
   | 'mediaClose';
 

package/src/selection.ts

@@ -39,6 +39,7 @@ export function isRowPressEnabled(row: RowModel): boolean {
   return (
     !row.disabled &&
     !row.pressDisabled &&
+    row.type !== 'buttonGroup' &&
     (row.type !== 'system' || row.variant === 'retry')
   );
 }