@carto/ps-react-ui 4.9.1 → 4.11.0

package/dist/types/chat/types.d.ts

@@ -0,0 +1,184 @@
+import { ReactNode } from 'react';
+import { ButtonBaseProps, SxProps, Theme } from '@mui/material';
+export interface ChatSxProps {
+    sx?: SxProps<Theme>;
+}
+export interface ChatErrorAction {
+    label: string;
+    onClick: () => void;
+}
+export interface ChatUserMessageProps extends ChatSxProps {
+    children: ReactNode;
+    /** enabled to render text with a lighter color for indicating things like an error sending the message */
+    muted?: boolean;
+    /** content to render on top of the message for user attachments */
+    topContext?: ReactNode;
+}
+export interface ChatAgentMessageProps extends ChatSxProps {
+    children: ReactNode;
+}
+export interface ChatErrorMessageProps extends ChatSxProps {
+    errors: string[];
+    icon?: ReactNode;
+    actions?: ChatErrorAction[];
+}
+export interface ChatSuggestionButtonProps extends ChatSxProps, Omit<ButtonBaseProps, 'children'> {
+    label: ReactNode;
+    color?: string;
+}
+export interface ChatThinkingProps extends ChatSxProps {
+    duration?: number;
+    children?: ReactNode;
+}
+export interface ChatLoaderProps extends ChatSxProps {
+    size?: number;
+    labels?: {
+        loading?: string;
+    };
+}
+export interface ChatContentProps extends ChatSxProps {
+    children: ReactNode;
+    /**
+     * Smooth-scrolls to the bottom whenever new content is added — but only if
+     * the user was already at (or near) the bottom. Readers who scrolled up to
+     * revisit older messages are left alone. Defaults to `true`; pass `false`
+     * to opt out and manage scroll yourself via the ref.
+     */
+    autoScroll?: boolean;
+    labels?: {
+        jumpToLatest?: string;
+    };
+}
+/**
+ * Imperative handle exposed by `ChatContent` via `ref`. Use it to drive scroll
+ * from the parent — for example, calling `scrollToBottom()` when a new agent
+ * message arrives.
+ */
+export interface ChatContentRef {
+    /** Smooth-scrolls the content area to the bottom. */
+    scrollToBottom: () => void;
+    /** Smooth-scrolls the content area to the top. */
+    scrollToTop: () => void;
+    /** `true` when the content area is scrolled to (or near) its bottom edge. */
+    isAtBottom: boolean;
+    /** `true` when the content area is scrolled to (or near) its top edge. */
+    isAtTop: boolean;
+}
+export interface ChatHeaderProps extends ChatSxProps {
+    leftSlot?: ReactNode;
+    title: ReactNode;
+    rightSlot?: ReactNode;
+    onClose?: () => void;
+}
+export interface ChatFooterProps extends ChatSxProps {
+    /** Current value of the chat message area. */
+    value: string;
+    /** Called with the new textarea value on every keystroke. */
+    onChange: (value: string) => void;
+    /** Called when the send button is clicked or Enter is pressed (without Shift). */
+    onSend: () => void;
+    /** Called when the stop button is clicked. Only shown while `isGenerating` is true. */
+    onStop?: () => void;
+    /** When true, swaps the send button for a stop button and disables the textarea. */
+    isGenerating?: boolean;
+    /** Disables the textarea and both send/stop buttons. */
+    disabled?: boolean;
+    /** Placeholder text for the textarea. Defaults to `'Type a message...'`. */
+    placeholder?: string;
+    /** Accessible labels for the send and stop buttons (used as `aria-label`). */
+    labels?: {
+        /** Defaults to `'Send'`. */
+        send?: string;
+        /** Defaults to `'Stop'`. */
+        stop?: string;
+    };
+    /** Helper text rendered under the input. Defaults to an AI disclaimer; pass `null` to hide. */
+    caption?: ReactNode;
+}
+export interface ChatStarterItem {
+    label: string;
+    color?: string;
+}
+export interface ChatStarterProps extends ChatSxProps {
+    icon?: ReactNode;
+    title?: ReactNode;
+    description?: ReactNode;
+    items: string[] | ChatStarterItem[];
+    size?: 'small' | 'medium';
+    onSelect?: (prompt: string) => void;
+}
+export interface ChatRatingActionProps {
+    onRatingChange?: (rating: 'up' | 'down' | null) => void;
+    rating?: 'up' | 'down' | null;
+    labels?: {
+        thumbUp?: string;
+        thumbDown?: string;
+    };
+}
+export interface ChatToolItem {
+    id: string;
+    name: string;
+    status: 'running' | 'complete' | 'error';
+    /** Display label shown while status is 'running'. Falls back to a capitalized `name`. */
+    runningLabel?: string;
+    /** Display label shown for non-running statuses. Falls back to a capitalized `name`. */
+    label?: string;
+    /** Friendly reference name for the tool (e.g. "add_marker"). Displayed with icon. */
+    reference?: string;
+    /** Execution duration in seconds (e.g. 1.8) */
+    duration?: number;
+    /** Input arguments as a JSON string or plain text */
+    inputArguments?: string;
+    /** Output as a JSON string or plain text */
+    output?: string;
+}
+export interface ChatToolTraceProps extends ChatSxProps {
+    tool: ChatToolItem;
+    /** Whether the trace accordion is expanded */
+    expanded?: boolean;
+    /** Callback when accordion expansion state changes */
+    onExpandedChange?: (expanded: boolean) => void;
+    labels?: {
+        toolExecuted?: string;
+        reference?: string;
+        duration?: string;
+        status?: string;
+        inputArguments?: string;
+        output?: string;
+        fullView?: string;
+        success?: string;
+        error?: string;
+        running?: string;
+    };
+}
+export interface ChatToolCodeAreaProps extends ChatSxProps {
+    /** Code content to display */
+    content: string;
+    /** Label for the full view dialog title */
+    title?: string;
+    /** Render with error styling (red left border, tinted background) */
+    isError?: boolean;
+    labels?: {
+        fullView?: string;
+    };
+}
+export interface ChatToolFullViewDialogProps {
+    open: boolean;
+    onClose: () => void;
+    title: string;
+    content: string;
+}
+export interface ChatToolGroupProps extends ChatSxProps {
+    tools: ChatToolItem[];
+    /** Whether the group accordion is expanded */
+    expanded?: boolean;
+    /** Callback when group expansion state changes */
+    onExpandedChange?: (expanded: boolean) => void;
+    /** Map of tool IDs to their individual expanded state. Used to preserve expansion state during grouping. */
+    expandedTools?: Record<string, boolean>;
+    /** Callback when an individual tool's expansion state changes */
+    onToolExpandedChange?: (value: Record<string, boolean>, toolId?: string) => void;
+    labels?: ChatToolTraceProps['labels'] & {
+        toolsUsed?: string;
+    };
+}

package/dist/types/chat/use-typewriter.d.ts

@@ -0,0 +1,30 @@
+interface UseTypewriterOptions {
+    /** Characters revealed per second (default: `500`). */
+    speed?: number;
+    /** When true on mount, skip the animation and reveal the full text immediately. */
+    skipAnimation?: boolean;
+}
+interface UseTypewriterResult {
+    /** The portion of `fullText` revealed so far. */
+    displayedText: string;
+    /** `true` while characters are still being revealed. */
+    isTyping: boolean;
+}
+/**
+ * Reveals a string character-by-character at a steady rate via
+ * `requestAnimationFrame`. Useful for smoothing out bursty WebSocket-streamed
+ * agent message text — pair it with `ChatAgentMessage`.
+ *
+ * @example
+ * ```tsx
+ * const { displayedText, isTyping } = useTypewriter(message)
+ * return (
+ *   <ChatAgentMessage>
+ *     <Markdown>{displayedText}</Markdown>
+ *     {isTyping ? <Cursor /> : null}
+ *   </ChatAgentMessage>
+ * )
+ * ```
+ */
+export declare function useTypewriter(fullText: string, options?: UseTypewriterOptions): UseTypewriterResult;
+export {};

package/dist/types/components/copy-button/copy-button.d.ts

@@ -0,0 +1,2 @@
+import { CopyButtonProps } from './types';
+export declare function CopyButton({ copyText, onSuccess, onError, 'aria-label': ariaLabel, ...props }: CopyButtonProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/copy-button/types.d.ts

@@ -0,0 +1,6 @@
+import { IconButtonProps } from '@mui/material/IconButton';
+export interface CopyButtonProps extends Omit<IconButtonProps, 'onError' | 'onClick'> {
+    copyText: string;
+    onSuccess?: () => void;
+    onError?: (err: Error) => void;
+}

package/dist/types/components/index.d.ts

@@ -18,3 +18,5 @@ export { BasemapsUI } from './basemaps/basemaps';
 export type { BasemapsUIProps } from './basemaps/types';
 export { Tooltip, setTooltipEnterDelay } from './tooltip/tooltip';
 export { SmartTooltip } from './smart-tooltip/smart-tooltip';
+export type { CopyButtonProps } from './copy-button/types';
+export { CopyButton } from './copy-button/copy-button';

package/dist/types/widgets/actions/brush-toggle/style.d.ts

@@ -8,7 +8,7 @@ export declare const styles: {
     };
     trigger: {
         '&[data-active="true"]': {
-            background: (theme: Theme) => any;
+            background: (theme: Theme) => string;
         };
     };
 };

package/dist/types/widgets/actions/shared/styles.d.ts

@@ -5,7 +5,7 @@ import { Theme } from '@mui/material';
 export declare const actionButtonStyles: {
     trigger: {
         '&[data-active="true"]': {
-            background: (theme: Theme) => any;
+            background: (theme: Theme) => string;
         };
     };
 };

package/dist/types/widgets/actions/zoom-toggle/style.d.ts

@@ -7,7 +7,7 @@ export declare const styles: {
     };
     trigger: {
         '&[data-active="true"]': {
-            background: (theme: Theme) => any;
+            background: (theme: Theme) => string;
         };
     };
 };

package/dist/types/widgets/echart/types.d.ts

@@ -1,7 +1,7 @@
 import { EChartsOption } from 'echarts';
 import { BaseWidgetState } from '../stores/types';
 import { Ref, RefObject } from 'react';
-import { theme as CartoTheme } from '../../theme';
+import { theme as CartoTheme } from '@carto/meridian-ds/theme';
 import type * as echarts from 'echarts';
 export type EchartOptionsProps = EChartsOption;
 export interface EchartUIProps {

package/dist/types/widgets/toolbar-actions/styles.d.ts

@@ -31,7 +31,7 @@ export declare const styles: {
     };
     triggerButton: {
         '&[data-active="true"]': {
-            backgroundColor: ({ palette }: Theme) => any;
+            backgroundColor: ({ palette }: Theme) => string;
         };
     };
 };

package/dist/types/widgets-v2/actions/brush-toggle/style.d.ts

@@ -7,6 +7,6 @@ export declare const styles: {
         };
     };
     toggleActive: {
-        background: (theme: Theme) => any;
+        background: (theme: Theme) => string;
     };
 };

package/dist/types/widgets-v2/actions/change-column/style.d.ts

@@ -7,7 +7,7 @@ export declare const styles: {
         };
     };
     toggleActive: {
-        background: (theme: Theme) => any;
+        background: (theme: Theme) => string;
     };
     menuPaper: {
         overflow: "hidden";

package/dist/types/widgets-v2/actions/fullscreen/style.d.ts

@@ -14,7 +14,7 @@ export declare const styles: {
         };
     };
     triggerActive: {
-        background: (theme: Theme) => any;
+        background: (theme: Theme) => string;
     };
     dialogPaper: {
         width: string;

package/dist/types/widgets-v2/actions/index.d.ts

@@ -1,5 +1,6 @@
 export { Searcher, SearcherToggle, setSearcherText, filterBySearchText, DEFAULT_SEARCHER_LABELS, type SearcherProps, type SearcherToggleProps, type SearcherLabels, } from './searcher';
 export { StackToggle, addStack, DEFAULT_STACK_TOGGLE_LABELS, type StackToggleProps, type StackToggleLabels, } from './stack-toggle';
+export { ShowAllToggle, setShowAll, SHOW_ALL_ID, DEFAULT_SHOW_ALL_LABELS, type ShowAllToggleProps, type ShowAllLabels, } from './show-all';
 export { ZoomToggle, addZoom, createAddZoom, ZOOM_LAYOUT, DEFAULT_ZOOM_TOGGLE_LABELS, type ZoomToggleProps, type ZoomToggleLabels, } from './zoom-toggle';
 export { BrushToggle, addBrush, DEFAULT_BRUSH_TOGGLE_LABELS, type BrushToggleProps, type BrushToggleLabels, } from './brush-toggle';
 export { RelativeData, toRelativeData, createPercentFormatter, DEFAULT_RELATIVE_DATA_LABELS, type RelativeDataProps, type RelativeDataLabels, } from './relative-data';

package/dist/types/widgets-v2/actions/lock-selection/style.d.ts

@@ -7,6 +7,6 @@ export declare const styles: {
         };
     };
     toggleActive: {
-        background: (theme: Theme) => any;
+        background: (theme: Theme) => string;
     };
 };

package/dist/types/widgets-v2/actions/relative-data/style.d.ts

@@ -7,6 +7,6 @@ export declare const styles: {
         };
     };
     toggleActive: {
-        background: (theme: Theme) => any;
+        background: (theme: Theme) => string;
     };
 };

package/dist/types/widgets-v2/actions/searcher/style.d.ts

@@ -7,7 +7,7 @@ export declare const styles: {
         };
     };
     toggleActive: {
-        background: (theme: Theme) => any;
+        background: (theme: Theme) => string;
     };
     input: {
         width: string;

package/dist/types/widgets-v2/actions/show-all/index.d.ts

@@ -0,0 +1,2 @@
+export { ShowAllToggle, setShowAll, SHOW_ALL_ID, type ShowAllToggleProps, } from './show-all';
+export { DEFAULT_SHOW_ALL_LABELS, type ShowAllLabels } from './labels';

package/dist/types/widgets-v2/actions/show-all/labels.d.ts

@@ -0,0 +1,5 @@
+export interface ShowAllLabels {
+    /** Tooltip + aria-label for the collapse (✕) button shown while expanded. */
+    toggle: string;
+}
+export declare const DEFAULT_SHOW_ALL_LABELS: ShowAllLabels;

package/dist/types/widgets-v2/actions/show-all/show-all.d.ts

@@ -0,0 +1,33 @@
+import { ComponentType } from 'react';
+import { SvgIconProps } from '@mui/material';
+import { ShowAllLabels } from './labels';
+/**
+ * The `show-all` flag is a pure UI signal (no data/config transform): the
+ * Category overflow row writes it `true` via {@link setShowAll}, the
+ * composer reads it with `useTransformEnabled(id, SHOW_ALL_ID)` to drop the
+ * row cap, and this button writes it back `false` to collapse. Stored under
+ * `transformStates` so `useTransformEnabled` can observe it like any other
+ * action flag — but it never registers a pipeline transform, so toggling it
+ * never re-runs the data pipeline.
+ */
+export declare const SHOW_ALL_ID = "show-all";
+export interface ShowAllToggleProps {
+    labels?: Partial<ShowAllLabels>;
+    icon?: ComponentType<SvgIconProps>;
+    iconProps?: SvgIconProps;
+}
+/**
+ * Collapse (✕) affordance shown while a widget is expanded into its
+ * "show all" state. Clicking it clears the `show-all` flag, returning the
+ * widget to its capped view. Mount it conditionally (only while the flag is
+ * set) so it doesn't occupy a `Widget.Toolbox` visibility-budget slot when
+ * the widget is collapsed.
+ */
+export declare function ShowAllToggle({ labels, icon: Icon, iconProps, }: ShowAllToggleProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Imperatively writes the `show-all` flag into the widget store. Mirrors
+ * {@link setSearcherText} — used by the Category overflow row (to expand)
+ * and the {@link ShowAllToggle} button (to collapse) without routing through
+ * a re-rendered subscription.
+ */
+export declare function setShowAll(widgetId: string, value: boolean): void;

package/dist/types/widgets-v2/actions/show-all/style.d.ts

@@ -0,0 +1,8 @@
+export declare const styles: {
+    toggle: {
+        p: number;
+        '& .MuiSvgIcon-root': {
+            fontSize: number;
+        };
+    };
+};

package/dist/types/widgets-v2/actions/stack-toggle/style.d.ts

@@ -7,6 +7,6 @@ export declare const styles: {
         };
     };
     toggleActive: {
-        background: (theme: Theme) => any;
+        background: (theme: Theme) => string;
     };
 };

package/dist/types/widgets-v2/actions/zoom-toggle/style.d.ts

@@ -7,6 +7,6 @@ export declare const styles: {
         };
     };
     toggleActive: {
-        background: (theme: Theme) => any;
+        background: (theme: Theme) => string;
     };
 };

package/dist/types/widgets-v2/category/category-ui.d.ts

@@ -23,7 +23,7 @@ export interface CategoryUIProps {
      * Caps the number of visible category rows.
      *
      * - `undefined` (omitted) — caps at {@link DEFAULT_MAX_ITEMS} (20).
-     *   Surplus rows fold into a single italic "Other (X more)" footer.
+     *   Surplus rows fold into a single "Others <count>" footer row.
      *   `undefined` cannot mean "no cap" because it's consumed by the
      *   default-parameter syntax — pass `null` instead.
      * - positive finite N — same as the default but with a custom cap.
@@ -44,6 +44,13 @@ export interface CategoryUIProps {
     maxItems?: number | null;
     /** Labels for the "Other" overflow row. `{count}` placeholder is replaced. */
     labels?: CategoryLabels;
+    /**
+     * When provided, the "Other" overflow row becomes a button — clicking it
+     * fires `onShowAll`, which a composer typically wires to expand the widget
+     * (drop the row cap) so every category becomes reachable. When omitted the
+     * overflow row stays a static summary.
+     */
+    onShowAll?: () => void;
     /** Manual override for the bar-width denominator. */
     maxOverride?: number;
     /**
@@ -78,4 +85,4 @@ export interface CategoryUIProps {
  * Returns `null` when there's nothing to render — `Widget.State` is the
  * empty-state authority in the canonical compositor.
  */
-export declare function CategoryUI({ data, selection, onSelectionChange, formatter, labelFormatter, series, maxItems, labels, maxOverride, size, stacked, }: CategoryUIProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function CategoryUI({ data, selection, onSelectionChange, formatter, labelFormatter, series, maxItems, labels, onShowAll, maxOverride, size, stacked, }: CategoryUIProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/widgets-v2/category/category.d.ts

@@ -7,7 +7,7 @@ export interface CategoryProps {
     /** Per-series metadata. Enables the legend + overrides palette per index. */
     series?: readonly CategorySeriesConfig[];
     /**
-     * Cap visible rows; overflow folds into "Other (X more)". Default 20
+     * Cap visible rows; overflow folds into an "Others <count>" row. Default 20
      * (when omitted). Pass `0` to swap the cap for a scrollable viewport
      * (composers use this when the user opens the SearcherToggle —
      * `maxItems = searcherOpen ? 0 : userMaxItems`). Pass `null` to disable
@@ -16,6 +16,13 @@ export interface CategoryProps {
     maxItems?: number | null;
     /** Labels for the "Other" overflow row. */
     labels?: CategoryLabels;
+    /**
+     * When provided, the "Other" overflow row becomes a button that fires this
+     * callback. Composers wire it to expand the widget (e.g. flip the
+     * `show-all` flag) so every category is shown. Forwarded to
+     * {@link CategoryUI}.
+     */
+    onShowAll?: () => void;
     /**
      * Manual override for the bar-width denominator. When omitted, the
      * bridge auto-fills from the widget store's `rawData` so bar widths
@@ -45,4 +52,4 @@ export interface CategoryProps {
  * `onSelectionChange` follow the destination-owned principle: the
  * consumer keeps the list in their own store and passes it through.
  */
-export declare function Category({ selection, onSelectionChange, series, maxItems, labels, maxOverride, size, stacked, }: CategoryProps): import("react/jsx-runtime").JSX.Element;
+export declare function Category({ selection, onSelectionChange, series, maxItems, labels, onShowAll, maxOverride, size, stacked, }: CategoryProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets-v2/category/components/category-row-other.d.ts

@@ -1,13 +1,26 @@
 export interface CategoryRowOtherProps {
     hiddenCount: number;
-    /** Label for the overflow row. Defaults to `'Other'`. */
+    /** Label for the overflow row. Defaults to `'Others'`. */
     otherLabel?: string;
-    /** Count text with `{count}` placeholder. Defaults to `'{count} more'`. */
+    /** Count text with `{count}` placeholder. Defaults to `'{count}'`. */
     otherCountLabel?: string;
+    /**
+     * When provided, the row becomes a button: clicking it (or Enter/Space)
+     * fires `onShowAll`, expanding the widget to reveal every category. When
+     * omitted the row renders as a static, non-interactive summary.
+     */
+    onShowAll?: () => void;
+    /** Tooltip shown over the button form. Defaults to `'Show all'`. */
+    showAllLabel?: string;
 }
 /**
- * Static "Other (X more)" overflow summary row. Rendered after the last
- * visible category row when `data.length > maxItems`. Non-interactive —
- * no selection, no keyboard target.
+ * Overflow summary row rendered after the last visible category row when
+ * `data.length > maxItems`. Shows `Others <count>` (count muted, no
+ * parentheses).
+ *
+ * When `onShowAll` is supplied the row is an interactive button — clicking
+ * it (or Enter/Space) expands the widget to show all categories, mirroring
+ * the Searcher's full-list view. Without `onShowAll` it stays a static,
+ * non-interactive summary (backward-compatible default).
  */
-export declare function CategoryRowOther({ hiddenCount, otherLabel, otherCountLabel, }: CategoryRowOtherProps): import("react/jsx-runtime").JSX.Element;
+export declare function CategoryRowOther({ hiddenCount, otherLabel, otherCountLabel, onShowAll, showAllLabel, }: CategoryRowOtherProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets-v2/category/style.d.ts

@@ -13,6 +13,9 @@ export declare const styles: {
         gap: number;
         py: number;
     };
+    listScroll: {
+        pr: number;
+    };
     rowSingle: {
         display: string;
         flexDirection: string;
@@ -150,17 +153,33 @@ export declare const styles: {
     };
     otherRow: {
         display: string;
-        justifyContent: string;
         alignItems: string;
+        gap: number;
         py: number;
         px: number;
     };
+    otherLabelButton: {
+        cursor: string;
+        userSelect: string;
+        borderRadius: number;
+        px: number;
+        ml: number;
+        transition: string;
+        '&:hover': {
+            bgcolor: string;
+        };
+        '&:focus-visible': {
+            outline: string;
+            outlineColor: string;
+            outlineOffset: number;
+        };
+    };
     otherLabel: {
-        fontStyle: string;
         color: string;
         fontWeight: string;
     };
     otherCount: {
         color: string;
+        fontVariantNumeric: string;
     };
 };

package/dist/types/widgets-v2/category/types.d.ts

@@ -42,6 +42,8 @@ export type CategorySeriesConfig = WidgetSeries;
 export interface CategoryLabels {
     other?: string;
     otherCount?: string;
+    /** Tooltip shown over the clickable "Others" row. Defaults to `'Show all'`. */
+    showAll?: string;
 }
 /**
  * Visual density of the bar primitive. `'small'` (default) keeps the

package/dist/types/widgets-v2/index.d.ts

@@ -9,7 +9,7 @@ import { Toolbox } from './toolbox/toolbox';
 import { DEFAULT_TOOLBOX_LABELS } from './toolbox/labels';
 import { Echart, EchartUI, DEFAULT_INIT_OPTS } from './echart';
 import { DEFAULT_NOTE_LABELS } from './note/labels';
-import { Searcher, SearcherToggle, StackToggle, ZoomToggle, BrushToggle, RelativeData, Download, LockSelection, ChangeColumn } from './actions';
+import { Searcher, SearcherToggle, StackToggle, ShowAllToggle, ZoomToggle, BrushToggle, RelativeData, Download, LockSelection, ChangeColumn } from './actions';
 import { Formula, FormulaUI } from './formula';
 import { Markdown, MarkdownUI } from './markdown';
 import { Spread, SpreadUI } from './spread';
@@ -59,6 +59,7 @@ export declare const Widget: {
     readonly Searcher: typeof Searcher;
     readonly SearcherToggle: typeof SearcherToggle;
     readonly StackToggle: typeof StackToggle;
+    readonly ShowAllToggle: typeof ShowAllToggle;
     readonly ZoomToggle: typeof ZoomToggle;
     readonly BrushToggle: typeof BrushToggle;
     readonly RelativeData: typeof RelativeData;
@@ -95,7 +96,7 @@ export type { ToolboxLabels } from './toolbox/labels';
 export type { EchartProps, EchartUIProps, EchartsEventHandler } from './echart';
 export type { NoteProps, NoteMarkdownProps } from './note/widget-note';
 export type { NoteLabels } from './note/labels';
-export type { SearcherProps, SearcherToggleProps, StackToggleProps, ZoomToggleProps, BrushToggleProps, RelativeDataProps, DownloadProps, DownloadItem, FullScreenTriggerProps, FullScreenSlotProps, LockSelectionProps, LockSelectionKey, ChangeColumnProps, ChangeColumnItem, } from './actions';
+export type { SearcherProps, SearcherToggleProps, StackToggleProps, ShowAllToggleProps, ZoomToggleProps, BrushToggleProps, RelativeDataProps, DownloadProps, DownloadItem, FullScreenTriggerProps, FullScreenSlotProps, LockSelectionProps, LockSelectionKey, ChangeColumnProps, ChangeColumnItem, } from './actions';
 export type { FormulaUIProps, FormulaDataItem, FormulaWidgetData, } from './formula';
 export type { MarkdownUIProps, MarkdownWidgetData } from './markdown';
 export type { PieDatum, PieWidgetData } from './pie';

package/dist/types/widgets-v2/selection-summary/labels.d.ts

@@ -1,6 +1,11 @@
+import { ReactNode } from 'react';
 export interface SelectionSummaryLabels {
-    allSelected: string;
-    selections: (count: number) => string;
+    /**
+     * Optional custom renderer for the count. Defaults to the built-in two-tone
+     * `selected / total` rendering. Receives the already-resolved displayed
+     * number (which equals `total` when nothing is selected).
+     */
+    summary?: (selected: number, total: number) => ReactNode;
     clear: string;
 }
 export declare const DEFAULT_SELECTION_SUMMARY_LABELS: SelectionSummaryLabels;

package/dist/types/widgets-v2/selection-summary/selection-summary.d.ts

@@ -4,19 +4,26 @@ import { SelectionSummaryLabels } from './labels';
 export interface SelectionSummaryProps {
     /** Number of currently selected items. */
     count: number;
-    /** Optional total — when 0 the component renders nothing (no data to summarize). */
+    /** Optional total — when `undefined` or `0` the component renders nothing (no data). */
     total?: number;
-    /** Clear callback. Shown only when count > 0. */
+    /** Clear callback. The Clear control is shown only when `count > 0` and `onClear` is provided. */
     onClear?: () => void;
     labels?: Partial<SelectionSummaryLabels>;
     icon?: ComponentType<SvgIconProps>;
     iconProps?: SvgIconProps;
 }
 /**
+ * Renders a `selected / total` count.
+ *
  * Render rules:
- *   - `total === 0` → render nothing.
- *   - `count === 0` → render `labels.allSelected` (matches v1 default),
- *     prefixed with the optional `icon` glyph when provided.
- *   - `count > 0`   → render `labels.selections(count)` + Clear (when `onClear`).
+ *   - `!total` (undefined or 0) → render nothing (no data to summarize).
+ *   - `count === 0` → display `total / total` (everything is implicitly in
+ *     scope); no Clear button.
+ *   - `count > 0` → display `count / total` + Clear (when `onClear` is given).
+ *
+ * The count is two-tone by default (selected number bold/`text.primary`,
+ * ` / total` in `text.secondary`). Pass `labels.summary` to render a custom
+ * node instead — it receives the already-resolved displayed number (which
+ * equals `total` when nothing is selected).
  */
 export declare function SelectionSummary({ count, total, onClear, labels, icon: Icon, iconProps, }: SelectionSummaryProps): import("react/jsx-runtime").JSX.Element | null;