@homebound/beam 4.34.0 → 4.35.0

package/dist/index.d.cts

@@ -5715,6 +5715,8 @@ declare class TableState<R extends Kinded> {
      * have `row.selectable !== false`.
      */
     get selectedRows(): RowState<R>[];
+    /** How many leaf rows are selected, for `GridTableLayout`'s selection summary; see `GridDataRow.childrenCount`. */
+    get selectedLeafRowCount(): number;
     /** Returns kept group row, with the latest kept children, if any. */
     get keptRowGroup(): GridDataRow<R>;
     /** Returns kept rows, i.e. those that were user-selected but then client-side or server-side filtered. */
@@ -5874,6 +5876,8 @@ declare class RowState<R extends Kinded> {
      * to their visible children explicitly.
      */
     get isSelected(): boolean;
+    /** This row's share of `TableState.selectedLeafRowCount`, see `GridDataRow.childrenCount`. */
+    get selectedLeafRowCount(): number;
     /** The UI state for checked/unchecked + "partially checked" for parents. */
     get selectedState(): SelectedState;
     /**
@@ -6018,6 +6022,8 @@ type GridDataRow<R extends Kinded> = {
     selectable?: false;
     /** Whether this row should infer its selected state based on its children's selected state */
     inferSelectedState?: false;
+    /** Total children, e.g. when they load lazily; a selected row counts as this many in `getSelectedLeafRowCount`. */
+    childrenCount?: number;
     /** Whether this row is draggable, usually to allow drag & drop reordering of rows */
     draggable?: boolean;
     /** Image src for the row, to be used for card view */
@@ -6091,6 +6097,8 @@ type GridTableApi<R extends Kinded> = {
     getSelectedRows(): GridDataRow<R>[];
     /** Returns the currently-selected rows of the given `kind`. */
     getSelectedRows<K extends R["kind"]>(kind: K): GridDataRow<DiscriminateUnion<R, "kind", K>>[];
+    /** Returns how many leaf rows are selected; see `GridDataRow.childrenCount`. */
+    getSelectedLeafRowCount(): number;
     /** Set selected state of a row by id. */
     selectRow(id: string, selected?: boolean): void;
     /** De-selects all selected rows. */
@@ -6152,6 +6160,7 @@ declare class GridTableApiImpl<R extends Kinded> implements GridTableApi<R> {
     private getSelectedRowIdsImpl;
     getSelectedRows(kind?: string): any;
     private getSelectedRowsImpl;
+    getSelectedLeafRowCount(): number;
     getVisibleRows(kind?: string): any;
     private getVisibleRowsImpl;
     getVisibleRowIds(kind?: string): any;
@@ -9507,6 +9516,8 @@ type GridTableLayoutProps<F extends Record<string, unknown>, R extends Kinded, X
     emptyFallback?: string;
     /** Inline buttons, icon buttons, and an optional overflow menu (`kind: "menu"`). */
     actions?: HeaderAction[];
+    /** Shows "N Rows Selected · Clear" before the columns selector; Clear deselects every row. */
+    selectionSummary?: boolean;
     hideEditColumns?: boolean;
     totalCount?: number;
     /** When true, shows a view toggle button and renders the table with `as="card"` when in card view. */
@@ -9994,9 +10005,13 @@ declare function SelectedOptionPillList(props: SelectedOptionPillListProps): Rea
 
 type SelectionSummaryPillProps = {
     text: string;
+    /** How many are selected, shown alone when `numberOnly`. */
+    count: number;
     onClick: () => void;
     /** If a ReactNode, that reason is shown in a tooltip. */
     disabled?: boolean | ReactNode;
+    /** Shows just `count` and an × instead of the text, e.g. on small screens. `text` stays the accessible name. */
+    numberOnly?: boolean;
     /** Storybook-only visual state overrides for snapshotting pseudo-interactions. */
     __storyState?: {
         hovered?: boolean;

package/dist/index.d.ts

@@ -5715,6 +5715,8 @@ declare class TableState<R extends Kinded> {
      * have `row.selectable !== false`.
      */
     get selectedRows(): RowState<R>[];
+    /** How many leaf rows are selected, for `GridTableLayout`'s selection summary; see `GridDataRow.childrenCount`. */
+    get selectedLeafRowCount(): number;
     /** Returns kept group row, with the latest kept children, if any. */
     get keptRowGroup(): GridDataRow<R>;
     /** Returns kept rows, i.e. those that were user-selected but then client-side or server-side filtered. */
@@ -5874,6 +5876,8 @@ declare class RowState<R extends Kinded> {
      * to their visible children explicitly.
      */
     get isSelected(): boolean;
+    /** This row's share of `TableState.selectedLeafRowCount`, see `GridDataRow.childrenCount`. */
+    get selectedLeafRowCount(): number;
     /** The UI state for checked/unchecked + "partially checked" for parents. */
     get selectedState(): SelectedState;
     /**
@@ -6018,6 +6022,8 @@ type GridDataRow<R extends Kinded> = {
     selectable?: false;
     /** Whether this row should infer its selected state based on its children's selected state */
     inferSelectedState?: false;
+    /** Total children, e.g. when they load lazily; a selected row counts as this many in `getSelectedLeafRowCount`. */
+    childrenCount?: number;
     /** Whether this row is draggable, usually to allow drag & drop reordering of rows */
     draggable?: boolean;
     /** Image src for the row, to be used for card view */
@@ -6091,6 +6097,8 @@ type GridTableApi<R extends Kinded> = {
     getSelectedRows(): GridDataRow<R>[];
     /** Returns the currently-selected rows of the given `kind`. */
     getSelectedRows<K extends R["kind"]>(kind: K): GridDataRow<DiscriminateUnion<R, "kind", K>>[];
+    /** Returns how many leaf rows are selected; see `GridDataRow.childrenCount`. */
+    getSelectedLeafRowCount(): number;
     /** Set selected state of a row by id. */
     selectRow(id: string, selected?: boolean): void;
     /** De-selects all selected rows. */
@@ -6152,6 +6160,7 @@ declare class GridTableApiImpl<R extends Kinded> implements GridTableApi<R> {
     private getSelectedRowIdsImpl;
     getSelectedRows(kind?: string): any;
     private getSelectedRowsImpl;
+    getSelectedLeafRowCount(): number;
     getVisibleRows(kind?: string): any;
     private getVisibleRowsImpl;
     getVisibleRowIds(kind?: string): any;
@@ -9507,6 +9516,8 @@ type GridTableLayoutProps<F extends Record<string, unknown>, R extends Kinded, X
     emptyFallback?: string;
     /** Inline buttons, icon buttons, and an optional overflow menu (`kind: "menu"`). */
     actions?: HeaderAction[];
+    /** Shows "N Rows Selected · Clear" before the columns selector; Clear deselects every row. */
+    selectionSummary?: boolean;
     hideEditColumns?: boolean;
     totalCount?: number;
     /** When true, shows a view toggle button and renders the table with `as="card"` when in card view. */
@@ -9994,9 +10005,13 @@ declare function SelectedOptionPillList(props: SelectedOptionPillListProps): Rea
 
 type SelectionSummaryPillProps = {
     text: string;
+    /** How many are selected, shown alone when `numberOnly`. */
+    count: number;
     onClick: () => void;
     /** If a ReactNode, that reason is shown in a tooltip. */
     disabled?: boolean | ReactNode;
+    /** Shows just `count` and an × instead of the text, e.g. on small screens. `text` stays the accessible name. */
+    numberOnly?: boolean;
     /** Storybook-only visual state overrides for snapshotting pseudo-interactions. */
     __storyState?: {
         hovered?: boolean;