@carto/ps-react-ui 5.3.0 → 6.1.0

package/dist/types/widgets/table/table-ui.d.ts

@@ -1,32 +1,44 @@
-import { TableCell, TableProps as MuiTableProps } from '@mui/material';
-import { Ref } from 'react';
-import { TableUIProps } from './types.js';
-/**
- * Props for the base Table component
- */
-interface TableComponentProps extends MuiTableProps {
-    /** Table element ref */
-    ref?: Ref<HTMLTableElement>;
-}
-/**
- * Base Table component with compound component pattern
- * Provides Table.Head, Table.Body, Table.Row, Table.Cell, Table.CellHeader, Table.Pagination
- */
-declare function Table({ children, ref, stickyHeader, ...props }: TableComponentProps): import('react').JSX.Element;
-declare namespace Table {
-    var Head: import("@mui/material/OverridableComponent").OverridableComponent<import("@mui/material").TableHeadTypeMap<{}, "thead">>;
-    var CellHeader: typeof import("./index.js").CellHeader;
-    var Body: import("@mui/material/OverridableComponent").OverridableComponent<import("@mui/material").TableBodyTypeMap<{}, "tbody">>;
-    var Row: typeof import("./index.js").Row;
-    var Cell: typeof TableCell;
-    var Container: typeof TableContainer;
-    var Paper: import("@mui/material/OverridableComponent").OverridableComponent<import("@mui/material").PaperTypeMap<{}, "div">>;
-    var Pagination: typeof import("./index.js").Pagination;
-    var PaginationActions: typeof import("./index.js").PaginationActions;
+import { TableProps as MuiTableProps } from '@mui/material';
+import { TableLabels } from './labels.js';
+import { TableColumn, TableRow, TableSortState } from './types.js';
+export interface TableUIProps<T extends TableRow = TableRow> {
+    columns: readonly TableColumn[];
+    /** Already-paginated, already-sorted rows for the current view. */
+    rows: readonly T[];
+    /** Total row count (across all pages). Required for pagination footer. */
+    total: number;
+    page: number;
+    pageSize: number;
+    pageSizeOptions?: readonly number[];
+    sort?: TableSortState;
+    /**
+     * Column name to use as the row identity. Drives selection lookup,
+     * React keys, and aria labels. Defaults to `'id'` — point it at
+     * another column when your rows don't carry an `id` field.
+     */
+    keyColumn?: string;
+    /** Selected row ids. Destination-owned. */
+    selection?: readonly (string | number)[];
+    selectable?: boolean;
+    onSortChange?: (next: TableSortState) => void;
+    onPageChange?: (page: number) => void;
+    onPageSizeChange?: (pageSize: number) => void;
+    onSelectionChange?: (next: readonly (string | number)[]) => void;
+    onRowClick?: (row: T) => void;
+    onRowHover?: (row: T | null) => void;
+    labels?: Partial<TableLabels>;
+    /** Row rendered when `rows` is empty for the current page. */
+    emptyContent?: React.ReactNode;
+    /**
+     * Forwarded to MUI's `<Table size>` — `'small'` for compact rows,
+     * `'medium'` for the default density. Leave `undefined` (the default)
+     * to let MUI's own default kick in.
+     */
+    size?: MuiTableProps['size'];
 }
-export { Table };
 /**
- * TableContainer widget component
- * Integrates with widget store and provides ref registration using custom hook
+ * Pure renderer for a paginated, sortable, optionally-selectable table.
+ * Has no widget-store coupling — `<Table>` (the bridge) reads from the store
+ * and feeds this UI with already-projected data.
  */
-declare function TableContainer(props: TableUIProps): import('react').JSX.Element;
+export declare function TableUI<T extends TableRow = TableRow>({ columns, rows, total, page, pageSize, pageSizeOptions, sort, keyColumn, selection, selectable, onSortChange, onPageChange, onPageSizeChange, onSelectionChange, onRowClick, onRowHover, labels, emptyContent, size, }: TableUIProps<T>): import('react').JSX.Element;

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

@@ -1,196 +1,48 @@
-import { ReactNode, Ref } from 'react';
-import { TableProps as MuiTableProps } from '@mui/material';
-import { BaseWidgetState, WidgetsStoreProps } from '../stores/types.js';
-import { WrapperState } from '../wrapper/types.js';
-import { DownloadItem } from '../actions/download/types.js';
+import { ReactNode } from 'react';
+import { WidgetState } from '../stores/index.js';
 /**
- * Table UI component props
+ * Single row of tabular data.
+ *
+ * The default row-identity column is `id`. Consumers that don't have a
+ * literal `id` field can point `<Table>` / `<TableUI>` at a different
+ * column via the `keyColumn` prop; the library reads `row[keyColumn]`
+ * for selection lookup, React keys, and aria labels.
  */
-export interface TableUIProps {
-    id: WidgetsStoreProps['id'];
-    children?: ReactNode;
+export interface TableRow extends Record<string, unknown> {
+    /**
+     * Default row identity. Required when no `keyColumn` is configured.
+     * Omit when wiring `keyColumn` to a different column.
+     */
+    id?: string | number;
+}
+export type TableWidgetData = readonly TableRow[];
+export type TableSortDirection = 'asc' | 'desc';
+export interface TableSortState {
+    columnId: string | null;
+    direction: TableSortDirection;
 }
-/**
- * Table column definition
- */
 export interface TableColumn {
-    /** Unique column identifier, matches key in row data */
+    /** Unique column identifier; matches the field name on each row. */
     id: string;
-    /** Column header label */
-    label: string | ReactNode;
-    /** Text alignment */
+    /** Header label. */
+    label: ReactNode;
     align?: 'left' | 'center' | 'right';
-    /** Column width (number for px, string for CSS value) */
     width?: number | string;
-    /** Enable sorting for this column */
     sortable?: boolean;
-    /** Custom cell value formatter */
+    /** Custom cell renderer. Falls back to a string-cast of the raw value. */
     formatter?: (value: unknown, row: TableRow) => ReactNode;
 }
 /**
- * Table row data - extends Record for flexible data
- */
-export interface TableRow extends Record<string, unknown> {
-    /** Unique row identifier */
-    id: string | number;
-}
-/**
- * Table widget data type - array of row records
- */
-export type TableWidgetData = TableRow[];
-/**
- * Pagination state
- */
-export interface TablePaginationState {
-    /** Current page (0-indexed) */
-    page: number;
-    /** Rows per page */
-    rowsPerPage: number;
-    /** Total number of rows (for remote pagination) */
-    total: number;
-}
-/**
- * Sort direction
- */
-export type SortDirection = 'asc' | 'desc';
-/**
- * Sort state for single-column sorting
- */
-export interface SortState {
-    /** Column ID being sorted */
-    columnId: string | null;
-    /** Sort direction */
-    direction: SortDirection;
-}
-/**
- * Pagination and sort mode
- */
-export type Mode = 'local' | 'remote';
-/**
- * Table widget configuration
- */
-export interface TableWidgetConfig {
-    /** Column definitions */
-    columns?: TableColumn[];
-    /** Enable row selection with checkboxes */
-    selectable?: boolean;
-    /** Currently selected row IDs */
-    selected?: (string | number)[];
-    /** Pagination and sort mode: local (client-side) or remote (server-side) */
-    mode: Mode;
-    /** Pagination configuration */
-    pagination?: {
-        /** Current page (0-indexed) */
-        page?: number;
-        /** Available rows per page options */
-        rowsPerPageOptions?: number[];
-        /** Default rows per page */
-        rowsPerPage?: number;
-        /** Total rows for remote pagination */
-        total?: number;
-    };
-    /** Sort configuration */
-    sort?: {
-        /** Default sort column */
-        columnId: string | null;
-        /** Default sort direction */
-        direction?: SortDirection;
-    };
-    /** Callback when a row is clicked */
-    onRowClick?: (row: TableRow) => void;
-    /** Callback when hovering over a row (null when leaving table) */
-    onRowHover?: (row: TableRow | null) => void;
-    /** Callback when selection changes */
-    onSelectionChange?: (selected: (string | number)[]) => void;
-    /** Callback when page changes (for remote pagination) */
-    onPageChange?: (page: number, rowsPerPage: number) => void;
-    /** Callback when sort changes (for remote sorting) */
-    onSortChange?: (columnId: string, direction: SortDirection) => void;
-}
-/**
- * Table widget state - includes both configuration and runtime state
- */
-export type TableWidgetState = BaseWidgetState<WrapperState<TableWidgetConfig & {}> & {
-    data: TableWidgetData;
-}>;
-/**
- * Table download configuration
- */
-export type TableDownloadConfig = DownloadItem<TableWidgetData>[];
-/**
- * Props for the base Table component
- */
-export interface TableProps extends MuiTableProps {
-    /** Table element ref */
-    ref?: Ref<HTMLTableElement>;
-}
-/**
- * Props for CellHeader component
- */
-export interface CellHeaderProps {
-    /** Column definition */
-    column: TableColumn;
-    /** Current sort state */
-    sortState?: SortState;
-    /** Callback when sort is triggered */
-    onSort?: (columnId: string) => void;
-    /** Whether this is a select-all checkbox header */
-    isSelectAll?: boolean;
-    /** Whether all rows are selected */
-    isAllSelected?: boolean;
-    /** Whether some rows are selected (indeterminate state) */
-    isIndeterminate?: boolean;
-    /** Callback for select-all toggle */
-    onSelectAll?: () => void;
-}
-/**
- * Props for Row component
- */
-export interface RowProps {
-    /** Row data */
-    row: TableRow;
-    /** Column definitions */
-    columns: TableColumn[];
-    /** Whether row is selected */
-    isSelected?: boolean;
-    /** Whether selection is enabled */
-    selectable?: boolean;
-    /** Callback when row is clicked */
-    onClick?: (row: TableRow) => void;
-    /** Callback when row selection is toggled */
-    onSelect?: (row: TableRow) => void;
-    /** Callback when mouse enters row */
-    onMouseEnter?: (row: TableRow) => void;
-    /** Callback when mouse leaves row */
-    onMouseLeave?: () => void;
-}
-/**
- * Props for Pagination component
- */
-export interface PaginationProps {
-    /** Current page (0-indexed) */
-    page: number;
-    /** Rows per page */
-    rowsPerPage: number;
-    /** Total row count */
-    total: number;
-    /** Available rows per page options */
-    rowsPerPageOptions?: number[];
-    /** Callback when page changes */
-    onPageChange: (page: number) => void;
-    /** Callback when rows per page changes */
-    onRowsPerPageChange: (rowsPerPage: number) => void;
-}
-/**
- * Props for PaginationActions component
+ * State extension carrying Table-specific UI state on the per-widget store.
+ * Per R12: widget-specific UI state lives in widget-specific extensions of
+ * `WidgetState`, not on the base type.
  */
-export interface PaginationActionsProps {
-    /** Current page (0-indexed) */
+export interface TableWidgetState extends WidgetState {
+    /** Optional reordered column list driven by ChangeColumn. Falls back to props. */
+    columnOrder?: readonly string[];
+    sort?: TableSortState;
     page: number;
-    /** Total row count */
-    count: number;
-    /** Rows per page */
-    rowsPerPage: number;
-    /** Callback when page changes */
-    onPageChange: (event: React.MouseEvent<HTMLButtonElement> | null, newPage: number) => void;
+    pageSize: number;
 }
+export declare const DEFAULT_TABLE_PAGE_SIZE = 10;
+export declare const DEFAULT_TABLE_PAGE_SIZE_OPTIONS: readonly [10, 25, 50, 100];

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

@@ -0,0 +1,12 @@
+import { DownloadItem, WidgetDownloadArgs } from '../actions/download/index.js';
+import { TimeseriesWidgetData } from './types.js';
+/**
+ * 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 given, prepends a PNG item that rasterises the captured
+ * element via `html2canvas`.
+ */
+export declare function createTimeseriesDownloadConfig(args: WidgetDownloadArgs<TimeseriesWidgetData> & {
+    seriesNames?: readonly string[];
+}): DownloadItem[];

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

@@ -1,3 +1,5 @@
-export type { TimeseriesWidgetData, TimeseriesWidgetState, TimeseriesWidgetConfig, TimeseriesConfig, } from './types.js';
-export { timeseriesConfig, timeseriesDownloadConfig } from './config.js';
+export { timeseriesOptions, createTimeseriesOptionFactory } from './options.js';
 export { TimeseriesSkeleton } from './skeleton.js';
+export { createTimeseriesDownloadConfig } from './download.js';
+export { filterTimeseriesByLockedItems } from './transforms.js';
+export type { TimeseriesDatum, TimeseriesWidgetData, TimeseriesOptionsInput, TimeseriesOptionFactoryInput, TimeseriesEChartsOption, } from './types.js';

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

@@ -1 +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.Element;

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

@@ -1,9 +1,60 @@
-import { EchartWidgetData, EchartWidgetState } from '../echart/index.js';
-import { EchartWidgetOptionProps, EchartWidgetProps } from '../echart/types.js';
-import { ConfigProps } from '../loader/index.js';
-export type TimeseriesWidgetData = EchartWidgetData;
-export type TimeseriesWidgetState = EchartWidgetState;
-export type TimeseriesWidgetConfig = EchartWidgetProps & {
-    type: 'timeseries';
-};
-export type TimeseriesConfig = ConfigProps & EchartWidgetOptionProps<TimeseriesWidgetData>;
+import { Theme } from '@mui/material';
+import { EChartsOption } from 'echarts';
+import { WidgetSeries } from '../types.js';
+/**
+ * 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 → widgets}/types.d.ts

@@ -1,3 +1,4 @@
+import { PaletteColor } from '../components/types.js';
 /**
  * Canonical cross-widget series metadata.
  *
@@ -11,15 +12,15 @@
  * (`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.
+ * Colours are {@link PaletteColor}: a theme path (`'primary.main'`) or a raw
+ * CSS string (`'#ff0000'`). Formula and Spread hand them to `sx`, which
+ * resolves paths itself; the echart widgets and Category paint outside `sx`
+ * and go through `resolveThemeColor` (see
+ * `widgets/utils/resolve-theme-color.ts`).
  */
 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;
+    color?: PaletteColor;
 }

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

@@ -1,7 +1,3 @@
-export { defaultFormatter, defaultLabelFormatter } from './formatter.js';
-export { createChartWidgetConfig } from './chart-config/index.js';
-export type { ChartWidgetBaseConfig, CreateChartWidgetConfigParams, } from './chart-config/index.js';
-export { flattenObjectArrayToCSV, scatterplotDataToCSV } from './chart-config/index.js';
-export { buildLegendConfig, buildGridConfig, createTooltipPositioner, createAxisLabelFormatter, createTooltipFormatter, applyXAxisFormatter, applyYAxisFormatter, niceNum, } from './chart-config/index.js';
-export { baseSkeletonStyles } from './skeleton/index.js';
-export { createChartDownloadConfig } from './chart-config/index.js';
+export { mergeOptions } from './merge-options.js';
+export { positionDataZoomForLegend } from './data-zoom-layout.js';
+export { resolveThemeColor } from './resolve-theme-color.js';

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

@@ -1,6 +1,4 @@
-export { Actions } from './components/actions.js';
-export { Options } from './components/options.js';
-export { Title } from './components/title.js';
-export { WidgetWrapper } from './wrapper.js';
-export { WrapperUI } from './wrapper-ui.js';
-export type { WrapperActionsProps, WrapperOption, WrapperOptionsProps, WrapperProps, WrapperState, WrapperUIProps, } from './types.js';
+export { Wrapper, type WrapperProps } from './widget-wrapper.js';
+export { Actions, Options, type ActionsProps, type OptionsProps, } from './widget-actions.js';
+export { Content, Footer, type ContentProps, type FooterProps, } from './widget-content.js';
+export { DEFAULT_WRAPPER_LABELS, type WrapperLabels } from './labels.js';

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

@@ -40,43 +40,14 @@ export declare const styles: {
         height: ({ spacing }: Theme) => string;
         zIndex: number;
     };
-    header: {
-        display: "flex";
-        alignItems: "center";
-        gap: ({ spacing }: Theme) => string;
-        minHeight: ({ spacing }: Theme) => string;
-        paddingInlineEnd: ({ spacing }: Theme) => string;
-    };
     summary: {
-        flex: number;
-        minWidth: number;
         minHeight: ({ spacing }: Theme) => string;
-        paddingInlineEnd: number;
         '& .MuiAccordionSummary-content': {
+            gap: ({ spacing }: Theme) => string;
+            paddingInlineEnd: ({ spacing }: Theme) => string;
             alignItems: "center";
-            minWidth: number;
-            marginInlineEnd: number;
-            paddingInlineEnd: number;
         };
     };
-    headerNoIcon: {
-        paddingInlineEnd: ({ spacing }: Theme) => string;
-    };
-    expandIcon: {
-        display: "flex";
-        marginInlineStart: ({ spacing }: Theme) => string;
-        color: "text.secondary";
-        cursor: "pointer";
-        '& svg': {
-            width: number;
-            height: number;
-            color: "inherit";
-        };
-        transition: ({ transitions }: Theme) => string;
-    };
-    expanded: {
-        transform: "rotate(180deg)";
-    };
     summaryDisabled: {
         '&, &:hover:not(.Mui-disabled)': {
             cursor: "default";

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

@@ -11,8 +11,8 @@ export interface ActionsProps {
  * 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 a click on an action never
- * reaches handlers further up the widget.
+ * 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.Element;
 export interface OptionsProps {

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

@@ -30,8 +30,8 @@ export interface WrapperProps {
     variant?: 'outlined' | 'elevation';
     labels?: Partial<WrapperLabels>;
     /**
-     * Icon shown at the right edge of the header row, rotated 180° while the
-     * wrapper is expanded. Default: `ExpandMoreIcon`.
+     * 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;

package/dist/{utils-Dr6gf3vD.js → utils-C-eWwOhE.js}

@@ -1,5 +1,5 @@
-import { r as e } from "./zoom-toggle-IsF8BnAp.js";
-//#region src/widgets-v2/utils/merge-options.ts
+import { r as e } from "./zoom-toggle-MmLjMTEw.js";
+//#region src/widgets/utils/merge-options.ts
 function t(e, t) {
 	if (!t) return e;
 	let r = { ...e };
@@ -29,7 +29,7 @@ function r(e) {
 	return t === Object.prototype || t === null;
 }
 //#endregion
-//#region src/widgets-v2/utils/data-zoom-layout.ts
+//#region src/widgets/utils/data-zoom-layout.ts
 function i(t, n) {
 	return !Array.isArray(t) || t.length === 0 ? null : t.map((t) => {
 		if (typeof t != "object" || !t) return t;
@@ -41,7 +41,7 @@ function i(t, n) {
 	});
 }
 //#endregion
-//#region src/widgets-v2/utils/resolve-theme-color.ts
+//#region src/widgets/utils/resolve-theme-color.ts
 function a(e, t) {
 	if (t == null) return;
 	if (!t.includes(".")) return t;
@@ -55,4 +55,4 @@ function a(e, t) {
 //#endregion
 export { i as n, t as r, a as t };
 
-//# sourceMappingURL=utils-Dr6gf3vD.js.map
+//# sourceMappingURL=utils-C-eWwOhE.js.map

package/dist/utils-C-eWwOhE.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-C-eWwOhE.js","names":[],"sources":["../src/widgets/utils/merge-options.ts","../src/widgets/utils/data-zoom-layout.ts","../src/widgets/utils/resolve-theme-color.ts"],"sourcesContent":["/**\n * Shallow-merges two ECharts option objects:\n *   - Top-level keys from both are combined.\n *   - Arrays are merged by index (element-wise shallow merge, primitive override).\n *   - Plain objects are shallow-merged.\n *   - Primitives are overridden by the override value.\n *\n * Designed for the two-stage memoization pattern: first build a base option\n * object from data + theme + formatters, then call `mergeOptions(base, override)`\n * inside a second `useMemo` keyed on `[base, override]`.\n */\nexport function mergeOptions<T extends Record<string, unknown>>(\n  base: T,\n  override?: Partial<T>,\n): T {\n  if (!override) return base\n  const out: Record<string, unknown> = { ...base }\n  for (const key of Object.keys(override) as (keyof T)[]) {\n    const a = base[key]\n    const b = override[key]\n    if (b === undefined) continue\n    out[key as string] = mergeValue(a, b)\n  }\n  return out as T\n}\n\nfunction mergeValue(a: unknown, b: unknown): unknown {\n  if (Array.isArray(a) && Array.isArray(b)) {\n    const len = Math.max(a.length, b.length)\n    const result = new Array<unknown>(len)\n    for (let i = 0; i < len; i++) {\n      const av: unknown = a[i]\n      const bv: unknown = b[i]\n      if (bv === undefined) result[i] = av\n      else if (av === undefined) result[i] = bv\n      else result[i] = mergeValue(av, bv)\n    }\n    return result\n  }\n  if (isPlainObject(a) && isPlainObject(b)) {\n    return { ...a, ...b }\n  }\n  return b\n}\n\nfunction isPlainObject(v: unknown): v is Record<string, unknown> {\n  if (v === null || typeof v !== 'object') return false\n  const proto = Object.getPrototypeOf(v) as unknown\n  return proto === Object.prototype || proto === null\n}\n","import { ZOOM_LAYOUT } from '../actions/zoom-toggle'\n\n/**\n * If the option includes a `dataZoom` array (from ZoomToggle's transform),\n * lift any slider entries above the legend row so they don't overlap.\n * Returns `null` when there is no `dataZoom` — caller skips the layout\n * adjustment entirely.\n *\n * Shared between bar, histogram, and timeseries — every widget with a\n * horizontal x-axis dataZoom slider needs the same offset when a legend\n * is rendered below the plot.\n */\nexport function positionDataZoomForLegend(\n  dataZoom: unknown,\n  hasLegend: boolean,\n): unknown[] | null {\n  if (!Array.isArray(dataZoom) || dataZoom.length === 0) return null\n  return dataZoom.map((entry: unknown) => {\n    if (entry == null || typeof entry !== 'object') return entry\n    const dz = entry as { type?: string; bottom?: number }\n    if (dz.type === 'slider' && hasLegend) {\n      return { ...dz, bottom: ZOOM_LAYOUT.sliderBottomWithLegend }\n    }\n    return dz\n  })\n}\n","import type { Theme } from '@mui/material'\n\n/**\n * Resolve a colour string against the MUI theme palette.\n *\n * - `'primary.main'`, `'secondary.dark'`, `'success.contrastText'`, … →\n *   walks `theme.palette` along the dot-separated path and returns the\n *   resolved string when traversal succeeds.\n * - `'#ff0000'`, `'rgb(255, 0, 0)'`, `'red'` → returned as-is (assumed\n *   raw CSS; ECharts consumes them directly).\n * - `undefined` → `undefined` (callers fall back to ECharts' palette).\n *\n * Used by the echart option factories (Bar, Pie, Histogram, Scatterplot,\n * Timeseries) so per-series colours specified as theme paths in the\n * unified `WidgetSeries` shape paint correctly. Category, Formula, and\n * Spread render colours through MUI's `sx` resolver, which already\n * handles theme paths — they don't need this helper.\n */\nexport function resolveThemeColor(\n  theme: Theme,\n  raw: string | undefined,\n): string | undefined {\n  if (raw == null) return undefined\n  if (!raw.includes('.')) return raw\n  const parts = raw.split('.')\n  let cursor: unknown = theme.palette\n  for (const part of parts) {\n    if (cursor == null || typeof cursor !== 'object') {\n      return raw\n    }\n    cursor = (cursor as Record<string, unknown>)[part]\n  }\n  return typeof cursor === 'string' ? cursor : raw\n}\n"],"mappings":";;AAWA,SAAgB,EACd,GACA,GACG;CACH,IAAI,CAAC,GAAU,OAAO;CACtB,IAAM,IAA+B,EAAE,GAAG,EAAK;CAC/C,KAAK,IAAM,KAAO,OAAO,KAAK,CAAQ,GAAkB;EACtD,IAAM,IAAI,EAAK,IACT,IAAI,EAAS;EACf,MAAM,KAAA,MACV,EAAI,KAAiB,EAAW,GAAG,CAAC;CACtC;CACA,OAAO;AACT;AAEA,SAAS,EAAW,GAAY,GAAqB;CACnD,IAAI,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,GAAG;EACxC,IAAM,IAAM,KAAK,IAAI,EAAE,QAAQ,EAAE,MAAM,GACjC,IAAa,MAAe,CAAG;EACrC,KAAK,IAAI,IAAI,GAAG,IAAI,GAAK,KAAK;GAC5B,IAAM,IAAc,EAAE,IAChB,IAAc,EAAE;GACtB,AAAI,MAAO,KAAA,IAAW,EAAO,KAAK,IACzB,MAAO,KAAA,IAAW,EAAO,KAAK,IAClC,EAAO,KAAK,EAAW,GAAI,CAAE;EACpC;EACA,OAAO;CACT;CAIA,OAHI,EAAc,CAAC,KAAK,EAAc,CAAC,IAC9B;EAAE,GAAG;EAAG,GAAG;CAAE,IAEf;AACT;AAEA,SAAS,EAAc,GAA0C;CAC/D,IAAkB,OAAO,KAAM,aAA3B,GAAqC,OAAO;CAChD,IAAM,IAAQ,OAAO,eAAe,CAAC;CACrC,OAAO,MAAU,OAAO,aAAa,MAAU;AACjD;;;ACrCA,SAAgB,EACd,GACA,GACkB;CAElB,OADI,CAAC,MAAM,QAAQ,CAAQ,KAAK,EAAS,WAAW,IAAU,OACvD,EAAS,KAAK,MAAmB;EACtC,IAAqB,OAAO,KAAU,aAAlC,GAA4C,OAAO;EACvD,IAAM,IAAK;EAIX,OAHI,EAAG,SAAS,YAAY,IACnB;GAAE,GAAG;GAAI,QAAQ,EAAY;EAAuB,IAEtD;CACT,CAAC;AACH;;;ACPA,SAAgB,EACd,GACA,GACoB;CACpB,IAAI,KAAO,MAAM;CACjB,IAAI,CAAC,EAAI,SAAS,GAAG,GAAG,OAAO;CAC/B,IAAM,IAAQ,EAAI,MAAM,GAAG,GACvB,IAAkB,EAAM;CAC5B,KAAK,IAAM,KAAQ,GAAO;EACxB,IAAsB,OAAO,KAAW,aAApC,GACF,OAAO;EAET,IAAU,EAAmC;CAC/C;CACA,OAAO,OAAO,KAAW,WAAW,IAAS;AAC/C"}

package/dist/widgets/actions.js

@@ -1,2 +1,4 @@
-import { _ as e, a as t, b as n, c as r, d as i, f as a, g as o, h as s, i as c, l, m as u, n as d, o as f, p, r as m, s as h, t as g, u as _, v, y } from "../actions-CGJD6q0t.js";
-export { g as BRUSH_TOGGLE_TOOL_ID, d as BrushToggle, m as CHANGE_COLUMN_TOOL_ID, c as ChangeColumn, y as Download, n as FullScreen, r as LOCK_SELECTION_TOOL_ID, l as LockSelection, u as RELATIVE_DATA_CONFIG_TOOL_ID, s as RELATIVE_DATA_TOOL_ID, o as RelativeData, f as SEARCHER_TOOL_ID, _ as STACK_TOGGLE_TOOL_ID, h as Searcher, t as SearcherToggle, i as StackToggle, a as ZOOM_TOGGLE_TOOL_ID, p as ZoomToggle, e as downloadToCSV, v as downloadToPNG };
+import { C as e, E as t, S as n, T as r, _ as i, a, b as o, c as s, d as c, f as l, g as u, h as d, i as f, l as p, m, n as h, o as g, p as _, r as v, s as y, t as b, u as x, v as S, w as C, x as w, y as T } from "../actions-BWlS5tpP.js";
+import { a as E, i as D, n as O, r as k, t as A } from "../zoom-toggle-MmLjMTEw.js";
+import { a as j, c as M, d as N, f as P, i as F, l as I, n as L, o as R, p as z, r as B, s as V, t as H, u as U } from "../download-B4sykOFm.js";
+export { l as BrushToggle, j as CSVIcon, b as ChangeColumn, _ as DEFAULT_BRUSH_TOGGLE_LABELS, h as DEFAULT_CHANGE_COLUMN_LABELS, I as DEFAULT_DOWNLOAD_LABELS, y as DEFAULT_FULLSCREEN_LABELS, f as DEFAULT_LOCK_SELECTION_LABELS, p as DEFAULT_RELATIVE_DATA_LABELS, r as DEFAULT_SEARCHER_LABELS, S as DEFAULT_SHOW_ALL_LABELS, o as DEFAULT_STACK_TOGGLE_LABELS, O as DEFAULT_ZOOM_TOGGLE_LABELS, F as DOWNLOAD_ITEM_IDS, M as Download, g as FullScreen, v as LockSelection, R as MarkdownIcon, V as PNGIcon, s as RelativeData, d as SHOW_ALL_ID, n as Searcher, e as SearcherToggle, u as ShowAllToggle, T as StackToggle, k as ZOOM_LAYOUT, A as ZoomToggle, m as addBrush, w as addStack, D as addZoom, L as buildCsvDownloadItem, B as buildPngDownloadItem, E as createAddZoom, x as createPercentFormatter, U as downloadDOMToPNG, N as downloadToCSV, a as filterByLockedItems, t as filterBySearchText, C as setSearcherText, i as setShowAll, P as toCsvString, c as toRelativeData, z as triggerLinkDownload, H as withPngItem };