@carto/ps-react-ui 4.4.0-chat-ui.5 → 4.4.0-chat-ui.7

package/dist/types/widgets-v2/test-utils.d.ts

@@ -0,0 +1,52 @@
+import { vi } from 'vitest';
+import { ECharts, EChartsOption } from 'echarts';
+import { WidgetState, WidgetStoreApi } from './stores';
+export interface MockChartHandlers {
+    finished?: () => void;
+    rendered?: () => void;
+    click?: (params: unknown) => void;
+    globalcursortaken?: (params: unknown) => void;
+    datazoom?: (params: unknown) => void;
+    brushselected?: (params: unknown) => void;
+    brushend?: (params: unknown) => void;
+    [key: string]: ((params?: unknown) => void) | undefined;
+}
+export interface MockChart {
+    dispatchAction: ReturnType<typeof vi.fn>;
+    setOption: ReturnType<typeof vi.fn>;
+    getOption: ReturnType<typeof vi.fn>;
+    resize: ReturnType<typeof vi.fn>;
+    clear: ReturnType<typeof vi.fn>;
+    dispose: ReturnType<typeof vi.fn>;
+    isDisposed: ReturnType<typeof vi.fn>;
+    getWidth: ReturnType<typeof vi.fn>;
+    getHeight: ReturnType<typeof vi.fn>;
+    getDom: ReturnType<typeof vi.fn>;
+    on: (event: string, callback: (params?: unknown) => void) => void;
+    off: (event: string, callback?: (params?: unknown) => void) => void;
+    __handlers: MockChartHandlers;
+    __emit: (event: keyof MockChartHandlers, params?: unknown) => void;
+}
+/**
+ * Returns a duck-typed `ECharts` instance suitable for tests. The instance
+ * captures `on()` handlers in `__handlers` so tests can `__emit('finished')`
+ * directly, and all imperative methods (`dispatchAction`, `setOption`,
+ * `resize`, …) are `vi.fn()` spies.
+ */
+export declare function createMockChart(): MockChart;
+/** Convenience cast for tests that need an `ECharts`-typed reference. */
+export declare const asEcharts: (chart: MockChart) => ECharts;
+/**
+ * Returns a `vi.fn()` option factory. The factory takes the standard
+ * `(option, data, ctx)` signature and returns the supplied `output` unchanged.
+ * Useful when the test only cares about how the bridge wires the factory in.
+ */
+export declare function createMockOptionFactory(output?: EChartsOption): import('vitest').Mock<() => EChartsOption>;
+/**
+ * Typed re-export of `getWidgetStore(id).getState()` — the verbose form
+ * shows up dozens of times across the suite. Tests that need the store
+ * api itself (`setState`, `subscribe`) still call `getWidgetStore(id)`.
+ */
+export declare function getState(id: string): WidgetState;
+/** Typed re-export of `getWidgetStore(id)` for tests that need the api. */
+export declare function getStore(id: string): WidgetStoreApi;

package/dist/types/widgets-v2/timeseries/download.d.ts

@@ -0,0 +1,17 @@
+import { DownloadItem } from '../actions/download';
+import { TimeseriesWidgetData } from './types';
+/**
+ * Download menu items for the Timeseries widget. Always includes a CSV
+ * item with `time, series_1, series_2, …` columns (one row per unique time
+ * across all series; ISO-8601 strings for `Date`/numeric times). When
+ * `getCaptureEl` is supplied, prepends a PNG item that rasterises the
+ * captured element via `html2canvas`.
+ */
+export declare function createTimeseriesDownloadConfig(args: {
+    filename: string;
+    getData: () => TimeseriesWidgetData;
+    seriesNames?: readonly string[];
+    getCaptureEl?: () => HTMLElement | null;
+    pngPixelRatio?: number;
+    pngBackgroundColor?: string | null;
+}): DownloadItem[];

package/dist/types/widgets-v2/timeseries/download.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,4 @@
+export { timeseriesOptions, createTimeseriesOptionFactory } from './options';
+export { TimeseriesSkeleton } from './skeleton';
+export { createTimeseriesDownloadConfig } from './download';
+export type { TimeseriesDatum, TimeseriesWidgetData, TimeseriesOptionsInput, TimeseriesOptionFactoryInput, TimeseriesEChartsOption, } from './types';

package/dist/types/widgets-v2/timeseries/options.d.ts

@@ -0,0 +1,39 @@
+import { OptionFactory } from '../echart';
+import { TimeseriesEChartsOption, TimeseriesOptionFactoryInput, TimeseriesOptionsInput } from './types';
+/**
+ * Builds the **structural** ECharts option for a timeseries widget —
+ * time x-axis, value y-axis, themed tooltip, themed legend, CARTO color
+ * palette. Mirrors {@link import('../bar/options').barOptions} so all
+ * four ECharts widgets share v1 look-and-feel.
+ *
+ * Intentional deviations from bar (timeseries-specific):
+ *   - **X-axis is `type: 'time'`** (not 'category'). ECharts handles
+ *     uneven sample spacing and zoom-level-aware label formatting.
+ *     `labelFormatter` is wrapped so the consumer sees a `Date`, not
+ *     a numeric timestamp.
+ *   - **Tooltip body reads `{ name, value }` rows**, same as bar, but
+ *     the `name` may arrive as `Date | number | string`. The
+ *     `labelFormatter` receives a `Date` regardless.
+ *
+ * Intentionally data-agnostic: no series, no dataset, no `legend.show`
+ * (those depend on data and are added by the option factory's merge
+ * phase via {@link createTimeseriesOptionFactory}).
+ */
+export declare function timeseriesOptions({ theme, formatter, labelFormatter, }: TimeseriesOptionsInput): TimeseriesEChartsOption;
+/**
+ * Returns the timeseries widget's {@link OptionFactory} — one closure
+ * that owns BOTH phases of option construction:
+ *
+ *   - **Structural phase** (`option == null`) — builds the theme-aware
+ *     structural option via {@link timeseriesOptions}, optionally merging
+ *     the consumer-supplied `optionsOverride`. Called once by Provider to
+ *     seed `rawOptions` in the store.
+ *   - **Merge phase** (`option != null`) — fuses post-pipeline `state.data`
+ *     (`TimeseriesWidgetData`) into the option via the dataset API: one
+ *     dataset per series, each series referencing its dataset by index,
+ *     encoded by `name` (x — time) and `value` (y). Mirrors {@link import('../bar/options').createBarOptionFactory}:
+ *     series-template merge for `addStack`, reactive formatters from
+ *     `ctx`, `niceNum`-rounded y-axis bounds at fusion time, and
+ *     `positionDataZoomForLegend` layout for ZoomToggle sliders.
+ */
+export declare function createTimeseriesOptionFactory(options: TimeseriesOptionFactoryInput): OptionFactory;

package/dist/types/widgets-v2/timeseries/options.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/widgets-v2/timeseries/skeleton.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Loading state for the Timeseries widget. Mirrors a line chart's
+ * silhouette — three thin horizontal segments at staggered offsets to
+ * suggest a moving line, plus a 2-dot legend stub. Sibling-consistent
+ * with Bar / Histogram / Scatter skeletons (column-flex container with
+ * legend strip below).
+ */
+export declare function TimeseriesSkeleton(): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,60 @@
+import { Theme } from '@mui/material';
+import { EChartsOption } from 'echarts';
+import { WidgetSeries } from '../types';
+/**
+ * A single point on a time series. `name` is the time coordinate — accepts a
+ * Date object, a number (ms-since-epoch), or an ISO-8601 string. ECharts'
+ * time axis parses any of these.
+ */
+export interface TimeseriesDatum {
+    name: Date | number | string;
+    value: number;
+}
+/** Timeseries widget data — one array of points per series. */
+export type TimeseriesWidgetData = readonly (readonly TimeseriesDatum[])[];
+/** Inputs to the structural-only {@link timeseriesOptions} builder. */
+export interface TimeseriesOptionsInput {
+    theme: Theme;
+    formatter?: (value: number) => string;
+    /** Optional formatter for the time-axis tick labels. Receives a JS Date. */
+    labelFormatter?: (value: Date) => string;
+}
+/**
+ * Combined inputs for the timeseries option factory creator. Carries
+ * everything the widget needs across BOTH phases — the structural-build
+ * (`theme`, `formatter`, `labelFormatter`, `optionsOverride`) AND the
+ * data merge (`series`, `smooth`, `area`, `selection`).
+ */
+export interface TimeseriesOptionFactoryInput {
+    theme: Theme;
+    formatter?: (value: number) => string;
+    /**
+     * Time-axis label formatter (also used in the tooltip name). Receives
+     * a JS Date — applied both at structural-build time (x-axis ticks) and
+     * at fusion time (tooltip name) so the date-aware labeling survives
+     * RelativeData's reactive formatter swaps.
+     */
+    labelFormatter?: (value: Date) => string;
+    /**
+     * Per-series metadata — drives the legend, `series[i].name`, and
+     * (when `color` is set) per-series line + marker colour overrides.
+     */
+    series?: readonly WidgetSeries[];
+    /** Smooth lines (default `true`). */
+    smooth?: boolean;
+    /** Filled area below each line (default `false`). */
+    area?: boolean;
+    /**
+     * Selected point keys (matched against `TimeseriesDatum.name`; `Date`
+     * names are normalized to ms-since-epoch). Points not in this list render
+     * dimmed (`itemStyle.opacity: 0.15`). `null`/empty means no selection.
+     */
+    selection?: readonly (string | number)[] | null;
+    /**
+     * Consumer-supplied partial option merged into the structural option at
+     * structural-build time. Lets stories override pieces of the theme-aware
+     * base without forking the structural builder.
+     */
+    optionsOverride?: Partial<EChartsOption>;
+}
+export type TimeseriesEChartsOption = EChartsOption;

package/dist/types/widgets-v2/toolbox/labels.d.ts

@@ -0,0 +1,5 @@
+export interface ToolboxLabels {
+    trigger: string;
+    close: string;
+}
+export declare const DEFAULT_TOOLBOX_LABELS: ToolboxLabels;

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

@@ -0,0 +1,30 @@
+export declare const styles: {
+    root: {
+        display: "flex";
+        alignItems: "center";
+        gap: number;
+        width: string;
+        borderRadius: number;
+        gridColumn: number;
+        height: string;
+    };
+    preview: {
+        display: "flex";
+        alignItems: "center";
+        gap: number;
+    };
+    triggerActive: {
+        bgcolor: "primary.relatedLight";
+    };
+    paper: {
+        display: "flex";
+        alignItems: "center";
+        gap: number;
+        px: number;
+        py: number;
+        mx: number;
+        mt: string;
+        bgcolor: "background.paper";
+        borderRadius: number;
+    };
+};

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

@@ -0,0 +1,49 @@
+import { ComponentType, ReactNode } from 'react';
+import { SvgIconProps, SxProps, Theme } from '@mui/material';
+import { ToolboxLabels } from './labels';
+export interface ToolboxProps {
+    /**
+     * Maximum number of (non-`data-toolbar-hidden`) children rendered inline
+     * when collapsed. Excess children are revealed via the overflow trigger
+     * inside a floating Paper. When omitted, all children render inline.
+     */
+    visibleCount?: number;
+    labels?: Partial<ToolboxLabels>;
+    /**
+     * Glyph used for the closed-state trigger. Defaults to the meridian-ds
+     * `WidgetOptions` icon (matches v1's `ToolbarActions`).
+     */
+    icon?: ComponentType<SvgIconProps>;
+    iconProps?: SvgIconProps;
+    /**
+     * Side the overflow Paper opens toward. `'right'` (default) places the
+     * trigger on the left and the Paper covers the row to the right;
+     * `'left'` is the mirror.
+     */
+    direction?: 'left' | 'right';
+    sx?: SxProps<Theme>;
+    children: ReactNode;
+}
+/**
+ * Smart overflow toolbar with **single-mount** items. Children mount once
+ * into a stable, hidden host element and are *physically reparented* via
+ * `appendChild` between the inline preview area and the overflow `<Paper>`
+ * as the popper opens / closes — same pattern as `Widget.FullScreen.Slot`.
+ * Items with no inline space when closed are kept mounted but visually
+ * hidden via `display: none`.
+ *
+ * Why this matters: every toggle's `useTransform` registers a config /
+ * data transform on mount and removes it on unmount. If items remounted
+ * on each open / close, the brief setup → cleanup window would re-emit
+ * the pipeline (transform missing → transform present), causing a visible
+ * flicker on state-bearing transforms (Stack, Zoom, RelativeData). With
+ * stable mounts the transform stays registered across the whole popover
+ * lifecycle.
+ *
+ * Children flagged with `data-toolbar-hidden` (e.g. dividers) skip the
+ * visibility budget but still render in their natural position. Trailing
+ * hidden items past the budget are excluded from the inline preview so
+ * they don't appear as orphan separators in the inline row; they're still
+ * there in the popover.
+ */
+export declare function Toolbox({ visibleCount, labels, icon: Icon, iconProps, direction, sx, children, }: ToolboxProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,25 @@
+/**
+ * Canonical cross-widget series metadata.
+ *
+ * Every widget that can carry multiple series (Bar, Pie, Histogram,
+ * Scatterplot, Timeseries, Category, Formula, Spread) accepts a
+ * `series: readonly WidgetSeries[]` prop. The `name` drives legends,
+ * tooltips, and category-row avatars; the optional `color` overrides
+ * the default palette assignment.
+ *
+ * For backward compatibility, the widget-specific names
+ * (`FormulaSeries`, `CategorySeriesConfig`) are kept as type aliases of
+ * `WidgetSeries` — see `formula/types.ts` and `category/types.ts`.
+ *
+ * Colours accept MUI theme paths (e.g. `'primary.main'`) as well as raw
+ * CSS strings (`'#ff0000'`, `'rgb(…)'`). The echart-based widgets
+ * resolve them through `resolveThemeColor` (see
+ * `widgets-v2/utils/resolve-theme-color.ts`); Category and Formula/Spread
+ * resolve them implicitly via MUI's `sx` prop.
+ */
+export interface WidgetSeries {
+    /** Display name — drives legend, tooltip, and avatar glyphs. */
+    name: string;
+    /** Optional colour override. MUI theme path or raw CSS string. */
+    color?: string;
+}

package/dist/types/widgets-v2/utils/data-zoom-layout.d.ts

@@ -0,0 +1,11 @@
+/**
+ * If the option includes a `dataZoom` array (from ZoomToggle's transform),
+ * lift any slider entries above the legend row so they don't overlap.
+ * Returns `null` when there is no `dataZoom` — caller skips the layout
+ * adjustment entirely.
+ *
+ * Shared between bar, histogram, and timeseries — every widget with a
+ * horizontal x-axis dataZoom slider needs the same offset when a legend
+ * is rendered below the plot.
+ */
+export declare function positionDataZoomForLegend(dataZoom: unknown, hasLegend: boolean): unknown[] | null;

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

@@ -0,0 +1,3 @@
+export { mergeOptions } from './merge-options';
+export { positionDataZoomForLegend } from './data-zoom-layout';
+export { resolveThemeColor } from './resolve-theme-color';

package/dist/types/widgets-v2/utils/merge-options.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shallow-merges two ECharts option objects:
+ *   - Top-level keys from both are combined.
+ *   - Arrays are merged by index (element-wise shallow merge, primitive override).
+ *   - Plain objects are shallow-merged.
+ *   - Primitives are overridden by the override value.
+ *
+ * Designed for the two-stage memoization pattern: first build a base option
+ * object from data + theme + formatters, then call `mergeOptions(base, override)`
+ * inside a second `useMemo` keyed on `[base, override]`.
+ */
+export declare function mergeOptions<T extends Record<string, unknown>>(base: T, override?: Partial<T>): T;

package/dist/types/widgets-v2/utils/merge-options.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/widgets-v2/utils/resolve-theme-color.d.ts

@@ -0,0 +1,18 @@
+import { Theme } from '@mui/material';
+/**
+ * Resolve a colour string against the MUI theme palette.
+ *
+ * - `'primary.main'`, `'secondary.dark'`, `'success.contrastText'`, … →
+ *   walks `theme.palette` along the dot-separated path and returns the
+ *   resolved string when traversal succeeds.
+ * - `'#ff0000'`, `'rgb(255, 0, 0)'`, `'red'` → returned as-is (assumed
+ *   raw CSS; ECharts consumes them directly).
+ * - `undefined` → `undefined` (callers fall back to ECharts' palette).
+ *
+ * Used by the echart option factories (Bar, Pie, Histogram, Scatterplot,
+ * Timeseries) so per-series colours specified as theme paths in the
+ * unified `WidgetSeries` shape paint correctly. Category, Formula, and
+ * Spread render colours through MUI's `sx` resolver, which already
+ * handles theme paths — they don't need this helper.
+ */
+export declare function resolveThemeColor(theme: Theme, raw: string | undefined): string | undefined;

package/dist/types/widgets-v2/utils/resolve-theme-color.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,4 @@
+export { Wrapper, type WrapperProps } from './widget-wrapper';
+export { Actions, Options, type ActionsProps, type OptionsProps, } from './widget-actions';
+export { Content, Footer, type ContentProps, type FooterProps, } from './widget-content';
+export { DEFAULT_WRAPPER_LABELS, type WrapperLabels } from './labels';

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

@@ -0,0 +1,6 @@
+export interface WrapperLabels {
+    collapse: string;
+    expand: string;
+    errorFallbackTitle: string;
+}
+export declare const DEFAULT_WRAPPER_LABELS: WrapperLabels;

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

@@ -0,0 +1,111 @@
+import { Theme } from '@mui/material';
+export declare const styles: {
+    root: {
+        position: "relative";
+        width: string;
+        minWidth: number;
+        bgcolor: "background.paper";
+        border: "1px solid";
+        borderColor: "divider";
+        borderRadius: number;
+        overflow: "hidden";
+        '&::before': {
+            display: "none";
+        };
+        '& .widget-wrapper-actions > *': {
+            opacity: number;
+            transition: ({ transitions }: Theme) => string;
+            '@media (hover: hover)': {
+                opacity: number;
+            };
+            '&.active': {
+                opacity: number;
+            };
+        };
+        '&:hover .widget-wrapper-actions > *': {
+            opacity: number;
+        };
+        '&[data-collapsed="true"] .widget-wrapper-actions > *': {
+            opacity: number;
+            pointerEvents: "none";
+            '&.active': {
+                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";
+        top: number;
+        left: number;
+        width: string;
+        height: ({ spacing }: Theme) => string;
+        zIndex: number;
+    };
+    summary: {
+        minHeight: ({ spacing }: Theme) => string;
+        '& .MuiAccordionSummary-content': {
+            gap: ({ spacing }: Theme) => string;
+            paddingInlineEnd: ({ spacing }: Theme) => string;
+            alignItems: "center";
+        };
+    };
+    titleCell: {
+        flexGrow: number;
+        flexShrink: number;
+        minWidth: number;
+        display: "flex";
+        alignItems: "center";
+        minHeight: ({ spacing }: Theme) => string;
+    };
+    titleText: {
+        minWidth: number;
+        wordBreak: "break-word";
+        overflow: "hidden";
+        display: "-webkit-box";
+        WebkitLineClamp: number;
+        WebkitBoxOrient: "vertical";
+    };
+    actions: {
+        display: "flex";
+        alignItems: "center";
+        gap: number;
+        justifyContent: "flex-end";
+        flexShrink: number;
+        '& > *': {
+            pointerEvents: "auto";
+        };
+    };
+    options: {
+        display: "flex";
+        alignItems: "center";
+        gap: number;
+        flexShrink: number;
+    };
+    detail: {
+        display: "flex";
+        flexDirection: "column";
+        gap: ({ spacing }: Theme) => string;
+        paddingTop: ({ spacing }: Theme) => string;
+    };
+    content: {
+        minWidth: number;
+        display: "flex";
+        flexDirection: "column";
+        gap: number;
+    };
+    footer: {
+        pt: number;
+    };
+};

package/dist/types/widgets-v2/wrapper/widget-actions.d.ts

@@ -0,0 +1,22 @@
+import { SxProps, Theme } from '@mui/material';
+import { ReactNode } from 'react';
+export interface ActionsProps {
+    sx?: SxProps<Theme>;
+    children: ReactNode;
+}
+/**
+ * Slot for the wrapper header's right-side action buttons. The
+ * `widget-wrapper-actions` className activates the hover-fade CSS rule on
+ * `<Wrapper>`: action children fade in on hover (always visible on coarse-
+ * pointer devices), and stay full-opacity when a descendant is marked with
+ * `.active` — typically applied by toggled actions.
+ *
+ * The container also stops click propagation so interacting with an action
+ * doesn't toggle the wrapper's collapse.
+ */
+export declare function Actions({ sx, children }: ActionsProps): import("react/jsx-runtime").JSX.Element;
+export interface OptionsProps {
+    sx?: SxProps<Theme>;
+    children: ReactNode;
+}
+export declare function Options({ sx, children }: OptionsProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/widgets-v2/wrapper/widget-content.d.ts

@@ -0,0 +1,12 @@
+import { SxProps, Theme } from '@mui/material';
+import { ReactNode } from 'react';
+export interface ContentProps {
+    sx?: SxProps<Theme>;
+    children: ReactNode;
+}
+export declare function Content({ sx, children }: ContentProps): import("react/jsx-runtime").JSX.Element;
+export interface FooterProps {
+    sx?: SxProps<Theme>;
+    children: ReactNode;
+}
+export declare function Footer({ sx, children }: FooterProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,51 @@
+import { ComponentType, ReactNode } from 'react';
+import { SvgIconProps, SxProps, Theme } from '@mui/material';
+import { WrapperLabels } from './labels';
+export interface WrapperProps {
+    title: string;
+    /**
+     * Controlled collapsed state. When supplied, the wrapper is fully
+     * controlled — the consumer is responsible for updating it via
+     * `onCollapseChange`. Leave undefined to use the uncontrolled mode,
+     * which seeds internal state from `defaultCollapsed`.
+     */
+    collapsed?: boolean;
+    /**
+     * Fires whenever the user interacts to toggle the wrapper, with the
+     * NEXT collapsed value. Called for both controlled and uncontrolled
+     * usage — consumers can subscribe to user-driven toggles even when
+     * letting the wrapper manage its own state.
+     */
+    onCollapseChange?: (collapsed: boolean) => void;
+    /**
+     * Initial collapsed state when the wrapper is uncontrolled (i.e.
+     * `collapsed` is undefined). Ignored when `collapsed` is supplied.
+     */
+    defaultCollapsed?: boolean;
+    disabled?: boolean;
+    labels?: Partial<WrapperLabels>;
+    /**
+     * Icon shown at the right edge of the summary row. Accordion rotates it
+     * 180° automatically when the wrapper expands. Default: `ExpandMoreIcon`.
+     */
+    expandIcon?: ComponentType<SvgIconProps>;
+    iconProps?: SvgIconProps;
+    sx?: SxProps<Theme>;
+    children: ReactNode;
+}
+/**
+ * Widget shell — title + collapsible body, built on MUI `<Accordion>` for
+ * native click-to-toggle on the summary header and a smooth open/close
+ * transition. UX matches v1 `<WrapperUI>`:
+ *
+ *   • hover-fade action buttons (always visible on coarse-pointer devices)
+ *   • multi-line title clamp (`WebkitLineClamp: 2`, word-break) + SmartTooltip
+ *     when the text overflows
+ *   • top-edge `<LinearProgress>` driven by the widget store's `isFetching`
+ *   • chevron at the right end (rotated by Accordion based on expanded state)
+ *
+ * Children are partitioned by component identity: `<Actions>` and `<Options>`
+ * render inside the summary row; everything else (`<Content>`, `<Footer>`,
+ * loose nodes) renders inside the details panel.
+ */
+export declare function Wrapper({ title, collapsed, onCollapseChange, defaultCollapsed, disabled, labels, expandIcon: ExpandIcon, iconProps, sx, children, }: WrapperProps): import("react/jsx-runtime").JSX.Element;