@carto/ps-react-ui 4.11.2 → 4.12.0

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

@@ -18,24 +18,91 @@ export declare const styles: {
     };
     footerWrapper: {
         padding: ({ spacing }: Theme) => string;
-        position: "relative";
-    };
-    footerCorner: {
-        position: "absolute";
-        bottom: string;
-        right: string;
-        margin: string;
     };
-    footer: {
+    /**
+     * Rounded input box, matching the reference ChatFooter. A two-column grid:
+     * main column (input + optional slots) | send button, bottom-aligned so it
+     * stays at the end as the input grows. NO vertical padding — the textarea's own
+     * padding sets the ~32px single-line height, so the box hugs the input.
+     */
+    footerBox: {
         maxWidth: number;
+        width: string;
         margin: string;
-        '&.MuiFilledInput-root.MuiInputBase-multiline.MuiInputBase-sizeSmall textarea': {
+        display: "grid";
+        gridTemplateColumns: string;
+        alignItems: "end";
+        columnGap: ({ spacing }: Theme) => string;
+        backgroundColor: ({ palette }: Theme) => string;
+        borderRadius: ({ spacing }: Theme) => string;
+        paddingInline: ({ spacing }: Theme) => string;
+    };
+    /** Main grid area: input stacked above the (optional) slots row. */
+    footerMain: {
+        minWidth: number;
+        display: "flex";
+        flexDirection: "column";
+        gap: ({ spacing }: Theme) => string;
+    };
+    /**
+     * Send-button grid area, bottom-aligned (matches the reference flex-end row) so
+     * the button stays at the bottom as the input grows. The small bottom padding
+     * keeps it off the box edge — in the single-line state it reads as vertically
+     * centered (4px top / 4px bottom around the 24px button in the 32px row).
+     */
+    footerSend: {
+        alignSelf: "end";
+        paddingBottom: ({ spacing }: Theme) => string;
+        '& .MuiIconButton-root': {
+            padding: ({ spacing }: Theme) => string;
+        };
+    };
+    /** The chrome-less multiline input (no underline / no filled affordance). */
+    footerInput: {
+        width: string;
+        typography: string;
+        minHeight: string;
+        '& textarea': {
+            fontSize: ({ typography }: Theme) => string;
+            lineHeight: ({ typography }: Theme) => string;
+            letterSpacing: ({ typography }: Theme) => string;
+        };
+        '& textarea:not([aria-hidden])': {
             resize: "none";
-            maxHeight: string;
-            overflowY: "auto !important";
-            paddingRight: ({ spacing }: Theme) => string;
+            padding: ({ spacing }: Theme) => string;
         };
     };
+    /**
+     * Slots row under the input: start slot + model selector + end slot. The left
+     * padding lines the row's content up with the input text above it: the input
+     * text is inset ~12px from the box edge (InputBase root padding + the textarea's
+     * 10px left padding) while the model-selector text button only insets ~8px, so a
+     * 4px indent here makes the slot label share the placeholder's left edge instead
+     * of sitting further out.
+     */
+    footerSlots: {
+        display: "flex";
+        alignItems: "center";
+        gap: ({ spacing }: Theme) => string;
+        minWidth: number;
+        flexWrap: "wrap";
+        paddingLeft: ({ spacing }: Theme) => string;
+        paddingBottom: ({ spacing }: Theme) => string;
+    };
+    modelSelector: {
+        textTransform: "none";
+        color: ({ palette }: Theme) => string;
+        maxWidth: string;
+        minWidth: number;
+        '& .MuiButton-endIcon': {
+            marginLeft: ({ spacing }: Theme) => string;
+        };
+    };
+    modelSelectorLabel: {
+        overflow: "hidden";
+        textOverflow: "ellipsis";
+        whiteSpace: "nowrap";
+    };
     footerCaption: {
         textAlign: "center";
     };

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

@@ -1,4 +1,4 @@
-export type { ChatSxProps, ChatErrorAction, ChatUserMessageProps, ChatAgentMessageProps, ChatErrorMessageProps, ChatSuggestionButtonProps, ChatThinkingProps, ChatLoaderProps, ChatContentProps, ChatContentRef, ChatHeaderProps, ChatFooterProps, ChatStarterItem, ChatStarterProps, ChatRatingActionProps, ChatToolItem, ChatToolTraceProps, ChatToolCodeAreaProps, ChatToolFullViewDialogProps, ChatToolGroupProps, } from './types';
+export type { ChatSxProps, ChatErrorAction, ChatUserMessageProps, ChatAgentMessageProps, ChatErrorMessageProps, ChatSuggestionButtonProps, ChatThinkingProps, ChatLoaderProps, ChatContentProps, ChatContentRef, ChatHeaderProps, ChatFooterProps, ChatModelOption, ChatStarterItem, ChatStarterProps, ChatRatingActionProps, ChatToolItem, ChatToolTraceProps, ChatToolCodeAreaProps, ChatToolFullViewDialogProps, ChatToolGroupProps, } from './types';
 export { CHAT_MAX_WIDTH, CHAT_SCROLL_DELAY, CHAT_DIVIDER_DELAY, CHAT_TOOL_CODE_AREA_MAX_HEIGHT, } from './const';
 export { useTypewriter } from './use-typewriter';
 export { ChatUserMessage } from './bubbles/chat-user-message';

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

@@ -91,9 +91,30 @@ export interface ChatFooterProps extends ChatSxProps {
         send?: string;
         /** Defaults to `'Stop'`. */
         stop?: string;
+        /** `aria-label` for the model-selector trigger. Defaults to `'Select model'`. */
+        model?: string;
     };
     /** Helper text rendered under the input. Defaults to an AI disclaimer; pass `null` to hide. */
     caption?: ReactNode;
+    /**
+     * Selectable models for the in-toolbar model selector. The selector is only
+     * rendered when this is a non-empty array; the component is otherwise
+     * model-agnostic (the host owns the list, selection, and default).
+     */
+    models?: ChatModelOption[];
+    /** Currently selected model `value`. Controlled — the host owns the state. */
+    selectedModel?: string;
+    /** Called with the picked model `value` when the user selects one. */
+    onModelChange?: (value: string) => void;
+    /** Extra controls rendered at the start (left) of the toolbar, before the model selector. */
+    startToolbarSlot?: ReactNode;
+    /** Extra controls rendered at the end (right) of the toolbar, before the send/stop button. */
+    endToolbarSlot?: ReactNode;
+}
+/** An option for the `ChatFooter` model selector. */
+export interface ChatModelOption {
+    value: string;
+    label: string;
 }
 export interface ChatStarterItem {
     label: string;

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

@@ -1,7 +1,7 @@
 interface UseTypewriterOptions {
     /** Characters revealed per second (default: `500`). */
     speed?: number;
-    /** When true on mount, skip the animation and reveal the full text immediately. */
+    /** When true, reveal the full text immediately (and snap to it if it grows). */
     skipAnimation?: boolean;
 }
 interface UseTypewriterResult {
@@ -12,8 +12,10 @@ interface UseTypewriterResult {
 }
 /**
  * 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`.
+ * `requestAnimationFrame`. Designed for bursty, streamed agent text: as
+ * `fullText` grows the reveal keeps chasing the new end, and flipping
+ * `skipAnimation` to `true` (e.g. once generation finishes) snaps to the full
+ * text. Pair it with `ChatAgentMessage`.
  *
  * @example
  * ```tsx

package/dist/types/widgets-v2/actions/download/constants.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Canonical `DownloadItem.id`s for the built-in download formats. Centralised
+ * so the per-format builders — and anything that keys off the id (menu logic,
+ * tests) — reference one source of truth instead of re-typing string literals.
+ * The Markdown format keeps the short `'md'` id to match its `.md` extension.
+ */
+export declare const DOWNLOAD_ITEM_IDS: {
+    readonly png: "png";
+    readonly csv: "csv";
+    readonly markdown: "md";
+};
+export type DownloadItemId = (typeof DOWNLOAD_ITEM_IDS)[keyof typeof DOWNLOAD_ITEM_IDS];

package/dist/types/widgets-v2/actions/download/csv-item.d.ts

@@ -0,0 +1,38 @@
+import { DownloadItem } from './types';
+interface BuildCsvDownloadItemBase {
+    /** Base filename (without extension). The item appends `.csv`. */
+    filename: string;
+    /** Override the menu label. Default `'CSV'`. */
+    label?: string;
+}
+/**
+ * Args for {@link buildCsvDownloadItem}. A discriminated union: a caller must
+ * supply exactly one content source — `getRows` (rows serialised through the
+ * shared `toCsvString`) or `getCsv` (a pre-built CSV string). The `?: never`
+ * arms make passing both — or neither — a compile-time error.
+ */
+export type BuildCsvDownloadItemArgs = (BuildCsvDownloadItemBase & {
+    /**
+     * Builds the CSV rows at click time. Used by most widgets — rows are run
+     * through `toCsvString` so escaping (incl. the spreadsheet
+     * formula-injection guard) stays consistent across widgets.
+     */
+    getRows: () => readonly (readonly unknown[])[];
+    getCsv?: never;
+}) | (BuildCsvDownloadItemBase & {
+    /**
+     * Returns a pre-built CSV string at click time. Escape hatch for widgets
+     * (e.g. Table) that already serialise their own CSV with bespoke
+     * header/cell handling.
+     */
+    getCsv: () => string;
+    getRows?: never;
+});
+/**
+ * Builds the standard CSV `DownloadItem` used by every per-widget download
+ * config. Centralised so the menu label, icon, and `.csv` filename suffix stay
+ * consistent across widgets — mirrors {@link buildPngDownloadItem} so neither
+ * format can drift again.
+ */
+export declare function buildCsvDownloadItem(args: BuildCsvDownloadItemArgs): DownloadItem;
+export {};

package/dist/types/widgets-v2/actions/download/icons.d.ts

@@ -5,6 +5,12 @@ import { SvgIconProps } from '@mui/material';
  * config's `icon` override without pulling MUI directly.
  */
 export declare function PNGIcon(props: SvgIconProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Generic "document" glyph used for the Markdown download item. Wraps MUI's
+ * `ArticleOutlined`, mirroring {@link PNGIcon}, so the Markdown menu item
+ * carries an icon consistent with the other download formats.
+ */
+export declare function MarkdownIcon(props: SvgIconProps): import("react/jsx-runtime").JSX.Element;
 /**
  * "CSV" rectangle with the letters spelled inside — matches v1 visual and is
  * easier to recognise in a download menu than a generic table glyph.

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

@@ -1,6 +1,8 @@
 export { Download, type DownloadProps } from './download';
 export { downloadToCSV, downloadDOMToPNG, toCsvString, triggerLinkDownload, type DownloadHandle, type DownloadDOMToPNGOptions, } from './exports';
-export { CSVIcon, PNGIcon } from './icons';
+export { CSVIcon, PNGIcon, MarkdownIcon } from './icons';
 export { buildPngDownloadItem, type BuildPngDownloadItemArgs } from './png-item';
+export { buildCsvDownloadItem, type BuildCsvDownloadItemArgs } from './csv-item';
+export { DOWNLOAD_ITEM_IDS, type DownloadItemId } from './constants';
 export type { DownloadItem } from './types';
 export { DEFAULT_DOWNLOAD_LABELS, type DownloadLabels } from './labels';

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

@@ -4,7 +4,7 @@ export { ShowAllToggle, setShowAll, SHOW_ALL_ID, DEFAULT_SHOW_ALL_LABELS, type S
 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';
-export { Download, downloadToCSV, downloadDOMToPNG, toCsvString, triggerLinkDownload, buildPngDownloadItem, CSVIcon, PNGIcon, DEFAULT_DOWNLOAD_LABELS, type DownloadProps, type DownloadItem, type DownloadHandle, type DownloadDOMToPNGOptions, type BuildPngDownloadItemArgs, type DownloadLabels, } from './download';
+export { Download, downloadToCSV, downloadDOMToPNG, toCsvString, triggerLinkDownload, buildPngDownloadItem, buildCsvDownloadItem, CSVIcon, PNGIcon, MarkdownIcon, DEFAULT_DOWNLOAD_LABELS, DOWNLOAD_ITEM_IDS, type DownloadProps, type DownloadItem, type DownloadItemId, type DownloadHandle, type DownloadDOMToPNGOptions, type BuildPngDownloadItemArgs, type BuildCsvDownloadItemArgs, type DownloadLabels, } from './download';
 export { FullScreen, DEFAULT_FULLSCREEN_LABELS, type FullScreenTriggerProps, type FullScreenSlotProps, type FullScreenLabels, type FullScreenWidgetState, } from './fullscreen';
 export { LockSelection, filterByLockedItems, DEFAULT_LOCK_SELECTION_LABELS, type LockSelectionProps, type LockSelectionKey, type LockSelectionLabels, } from './lock-selection';
 export { ChangeColumn, DEFAULT_CHANGE_COLUMN_LABELS, type ChangeColumnProps, type ChangeColumnItem, type ChangeColumnLabels, type ChangeColumnWidgetState, } from './change-column';

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

@@ -31,18 +31,6 @@ export declare const styles: {
                 opacity: number;
             };
         };
-        '&.Mui-disabled': {
-            pointerEvents: "none";
-            bgcolor: "background.paper";
-            '& .MuiAccordionSummary-root.Mui-disabled': {
-                opacity: number;
-                color: "inherit";
-                backgroundColor: "transparent";
-            };
-            '& .MuiAccordionSummary-expandIconWrapper': {
-                display: "none";
-            };
-        };
     };
     loading: {
         position: "absolute";
@@ -60,6 +48,11 @@ export declare const styles: {
             alignItems: "center";
         };
     };
+    summaryDisabled: {
+        '&, &:hover:not(.Mui-disabled)': {
+            cursor: "default";
+        };
+    };
     titleCell: {
         flexGrow: number;
         flexShrink: number;

package/dist/widgets-v2/actions.js

@@ -1,47 +1,51 @@
-import { B as s, C as e, D as o, a as A, b as E, c as S, d as t, e as _, f as r, g as T, h as l, i as D, j as d, F as c, L as g, R as n, S as B, k as O, l as C, m as F, n as U, Z as m, o as h, p as i, q as G, r as R, s as f, t as w, u as I, v as N } from "../change-column-DjjwoPt1.js";
-import { Z as k, a as u, c as x } from "../transforms-Cdx4fkU5.js";
-import { d as H, a as P, t as b, b as v } from "../exports-Cx-f6m6U.js";
-import { C as V, P as W, b as y } from "../png-item-BE9uEqlD.js";
+import { B as L, C as o, D as e, a as A, b as E, c as r, d as t, e as S, f as _, g as T, h as l, i as D, j as d, F as n, L as c, R as O, S as g, k as B, l as C, m, n as F, Z as U, o as i, p as I, q as h, r as w, s as G, t as f, u as N, v as R } from "../change-column-DjjwoPt1.js";
+import { Z as u, a as x, c as M } from "../transforms-Cdx4fkU5.js";
+import { d as b, a as p, t as v, b as H } from "../exports-Cx-f6m6U.js";
+import { C as W, D as V, M as y, P as K, b as j } from "../png-item-9dNbB37T.js";
+import { b as Y } from "../csv-item-hH_Gt7ur.js";
 export {
-  s as BrushToggle,
-  V as CSVIcon,
-  e as ChangeColumn,
-  o as DEFAULT_BRUSH_TOGGLE_LABELS,
+  L as BrushToggle,
+  W as CSVIcon,
+  o as ChangeColumn,
+  e as DEFAULT_BRUSH_TOGGLE_LABELS,
   A as DEFAULT_CHANGE_COLUMN_LABELS,
   E as DEFAULT_DOWNLOAD_LABELS,
-  S as DEFAULT_FULLSCREEN_LABELS,
+  r as DEFAULT_FULLSCREEN_LABELS,
   t as DEFAULT_LOCK_SELECTION_LABELS,
-  _ as DEFAULT_RELATIVE_DATA_LABELS,
-  r as DEFAULT_SEARCHER_LABELS,
+  S as DEFAULT_RELATIVE_DATA_LABELS,
+  _ as DEFAULT_SEARCHER_LABELS,
   T as DEFAULT_SHOW_ALL_LABELS,
   l as DEFAULT_STACK_TOGGLE_LABELS,
   D as DEFAULT_ZOOM_TOGGLE_LABELS,
+  V as DOWNLOAD_ITEM_IDS,
   d as Download,
-  c as FullScreen,
-  g as LockSelection,
-  W as PNGIcon,
-  n as RelativeData,
-  B as SHOW_ALL_ID,
-  O as Searcher,
+  n as FullScreen,
+  c as LockSelection,
+  y as MarkdownIcon,
+  K as PNGIcon,
+  O as RelativeData,
+  g as SHOW_ALL_ID,
+  B as Searcher,
   C as SearcherToggle,
-  F as ShowAllToggle,
-  U as StackToggle,
-  k as ZOOM_LAYOUT,
-  m as ZoomToggle,
-  h as addBrush,
-  i as addStack,
-  u as addZoom,
-  y as buildPngDownloadItem,
-  x as createAddZoom,
-  G as createPercentFormatter,
-  H as downloadDOMToPNG,
-  P as downloadToCSV,
-  R as filterByLockedItems,
-  f as filterBySearchText,
-  w as setSearcherText,
-  I as setShowAll,
-  b as toCsvString,
-  N as toRelativeData,
-  v as triggerLinkDownload
+  m as ShowAllToggle,
+  F as StackToggle,
+  u as ZOOM_LAYOUT,
+  U as ZoomToggle,
+  i as addBrush,
+  I as addStack,
+  x as addZoom,
+  Y as buildCsvDownloadItem,
+  j as buildPngDownloadItem,
+  M as createAddZoom,
+  h as createPercentFormatter,
+  b as downloadDOMToPNG,
+  p as downloadToCSV,
+  w as filterByLockedItems,
+  G as filterBySearchText,
+  f as setSearcherText,
+  N as setShowAll,
+  v as toCsvString,
+  R as toRelativeData,
+  H as triggerLinkDownload
 };
 //# sourceMappingURL=actions.js.map

package/dist/widgets-v2/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}
+{"version":3,"file":"actions.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}