@carto/ps-react-ui 4.20.2 → 4.22.0

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

@@ -1,6 +1,6 @@
 import { ComponentType, ReactNode } from 'react';
-import { SvgIconProps } from '@mui/material';
-import { FullScreenLabels } from './labels';
+import { SvgIconProps, SxProps, Theme } from '@mui/material';
+import { FullScreenLabels } from './labels.js';
 export interface FullScreenTriggerProps {
     labels?: Partial<FullScreenLabels>;
     enterIcon?: ComponentType<SvgIconProps>;
@@ -16,6 +16,25 @@ export interface FullScreenSlotProps {
     children: (isFullScreen: boolean) => ReactNode;
     /** Header text rendered above the body when the modal is open. */
     title?: ReactNode;
+    /**
+     * Buttons rendered in the modal header, to the left of the close icon —
+     * the fullscreen counterpart of `<Widget.Actions>`, which lives in the
+     * wrapper's summary row and is covered by the dialog. Pass the same
+     * elements you compose there (typically `<Widget.Download>`); the
+     * fullscreen trigger is intentionally not among them, since the close
+     * icon already exits.
+     */
+    actions?: ReactNode;
+    /**
+     * Per-widget override merged over the default `90vw x 90vh` dialog paper.
+     * Charts want the default (their canvas grows to fill it); content-sized
+     * widgets (Range, Markdown) pass their own width / `height: 'auto'` so the
+     * modal doesn't leave a large empty box around them.
+     *
+     * Shallow-merged over the default, same as `Widget.Actions`' `sx`: pass a
+     * plain style object, not the array or theme-callback form.
+     */
+    paperSx?: SxProps<Theme>;
     labels?: Partial<FullScreenLabels>;
     closeIcon?: ComponentType<SvgIconProps>;
     iconProps?: SvgIconProps;
@@ -37,7 +56,7 @@ declare function FullScreenTrigger({ labels, enterIcon: EnterIcon, exitIcon: Exi
  * ECharts (or any other heavy child) stays mounted while only its DOM
  * parent changes.
  */
-declare function FullScreenSlot({ children, title, labels, closeIcon: CloseSvg, iconProps, }: FullScreenSlotProps): import("react").JSX.Element;
+declare function FullScreenSlot({ children, title, actions, paperSx, labels, closeIcon: CloseSvg, iconProps, }: FullScreenSlotProps): import("react").JSX.Element;
 /**
  * Namespace export. Consumers compose with:
  *
@@ -46,7 +65,7 @@ declare function FullScreenSlot({ children, title, labels, closeIcon: CloseSvg,
  *   <Widget.FullScreen.Trigger />
  * </Widget.Actions>
  * <Widget.Content>
- *   <Widget.FullScreen.Slot title={title}>
+ *   <Widget.FullScreen.Slot title={title} actions={<Widget.Download items={items} />}>
  *     {(isFullScreen) => <Body visibleCount={isFullScreen ? undefined : 2} />}
  *   </Widget.FullScreen.Slot>
  * </Widget.Content>

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

@@ -1,3 +1,3 @@
-export { FullScreen, type FullScreenTriggerProps, type FullScreenSlotProps, } from './fullscreen';
-export { DEFAULT_FULLSCREEN_LABELS, type FullScreenLabels } from './labels';
-export type { FullScreenWidgetState } from './types';
+export { FullScreen, type FullScreenTriggerProps, type FullScreenSlotProps, } from './fullscreen.js';
+export { DEFAULT_FULLSCREEN_LABELS, type FullScreenLabels } from './labels.js';
+export type { FullScreenWidgetState } from './types.js';

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

@@ -19,6 +19,8 @@ export declare const styles: {
     dialogPaper: {
         width: string;
         height: string;
+        minWidth: string;
+        minHeight: string;
         maxWidth: string;
         maxHeight: string;
     };
@@ -31,6 +33,12 @@ export declare const styles: {
         pr: number;
         pb: number;
     };
+    dialogActions: {
+        display: "flex";
+        alignItems: "center";
+        gap: number;
+        flexShrink: number;
+    };
     titleText: {
         minWidth: number;
         overflow: "hidden";
@@ -44,5 +52,6 @@ export declare const styles: {
         py: number;
         px: number;
         overflow: "auto";
+        minHeight: number;
     };
 };

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

@@ -1,4 +1,4 @@
-import { WidgetState } from '../../stores';
+import { WidgetState } from '../../stores/index.js';
 /**
  * State extension owned by FullScreen. The base `WidgetState` deliberately
  * stays free of widget-specific UI flags (R12 from the round-5 amendment);

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

@@ -1,10 +1,10 @@
-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';
-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';
+export { Searcher, SearcherToggle, setSearcherText, filterBySearchText, DEFAULT_SEARCHER_LABELS, type SearcherProps, type SearcherToggleProps, type SearcherLabels, } from './searcher/index.js';
+export { StackToggle, addStack, DEFAULT_STACK_TOGGLE_LABELS, type StackToggleProps, type StackToggleLabels, } from './stack-toggle/index.js';
+export { ShowAllToggle, setShowAll, SHOW_ALL_ID, DEFAULT_SHOW_ALL_LABELS, type ShowAllToggleProps, type ShowAllLabels, } from './show-all/index.js';
+export { ZoomToggle, addZoom, createAddZoom, ZOOM_LAYOUT, DEFAULT_ZOOM_TOGGLE_LABELS, type ZoomToggleProps, type ZoomToggleLabels, } from './zoom-toggle/index.js';
+export { BrushToggle, addBrush, DEFAULT_BRUSH_TOGGLE_LABELS, type BrushToggleProps, type BrushToggleLabels, } from './brush-toggle/index.js';
+export { RelativeData, toRelativeData, createPercentFormatter, DEFAULT_RELATIVE_DATA_LABELS, type RelativeDataProps, type RelativeDataLabels, } from './relative-data/index.js';
+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/index.js';
+export { FullScreen, DEFAULT_FULLSCREEN_LABELS, type FullScreenTriggerProps, type FullScreenSlotProps, type FullScreenLabels, type FullScreenWidgetState, } from './fullscreen/index.js';
+export { LockSelection, filterByLockedItems, DEFAULT_LOCK_SELECTION_LABELS, type LockSelectionProps, type LockSelectionKey, type LockSelectionLabels, } from './lock-selection/index.js';
+export { ChangeColumn, DEFAULT_CHANGE_COLUMN_LABELS, type ChangeColumnProps, type ChangeColumnItem, type ChangeColumnLabels, type ChangeColumnWidgetState, } from './change-column/index.js';

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

@@ -1,3 +1,3 @@
-export { LockSelection, type LockSelectionProps, type LockSelectionKey, } from './lock-selection';
-export { filterByLockedItems } from './transforms';
-export { DEFAULT_LOCK_SELECTION_LABELS, type LockSelectionLabels, } from './labels';
+export { LockSelection, type LockSelectionProps, type LockSelectionKey, } from './lock-selection.js';
+export { filterByLockedItems } from './transforms.js';
+export { DEFAULT_LOCK_SELECTION_LABELS, type LockSelectionLabels, } from './labels.js';

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

@@ -1,6 +1,6 @@
 import { ComponentType } from 'react';
 import { SvgIconProps } from '@mui/material';
-import { LockSelectionLabels } from './labels';
+import { LockSelectionLabels } from './labels.js';
 export type LockSelectionKey = string | number;
 export interface LockSelectionProps<K extends LockSelectionKey = LockSelectionKey> {
     /**

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

@@ -1,3 +1,3 @@
-export { RelativeData, type RelativeDataProps } from './relative-data';
-export { toRelativeData, createPercentFormatter } from './transforms';
-export { DEFAULT_RELATIVE_DATA_LABELS, type RelativeDataLabels } from './labels';
+export { RelativeData, type RelativeDataProps } from './relative-data.js';
+export { toRelativeData, createPercentFormatter } from './transforms.js';
+export { DEFAULT_RELATIVE_DATA_LABELS, type RelativeDataLabels } from './labels.js';

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

@@ -1,6 +1,6 @@
 import { ComponentType } from 'react';
 import { SvgIconProps } from '@mui/material';
-import { RelativeDataLabels } from './labels';
+import { RelativeDataLabels } from './labels.js';
 export interface RelativeDataProps {
     initialEnabled?: boolean;
     /**

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

@@ -1,4 +1,4 @@
-export { Searcher, type SearcherProps } from './searcher';
-export { SearcherToggle, setSearcherText, type SearcherToggleProps, } from './searcher-toggle';
-export { filterBySearchText } from './filter';
-export { DEFAULT_SEARCHER_LABELS, type SearcherLabels } from './labels';
+export { Searcher, type SearcherProps } from './searcher.js';
+export { SearcherToggle, setSearcherText, type SearcherToggleProps, } from './searcher-toggle.js';
+export { filterBySearchText } from './filter.js';
+export { DEFAULT_SEARCHER_LABELS, type SearcherLabels } from './labels.js';

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

@@ -1,6 +1,6 @@
 import { ComponentType } from 'react';
 import { SvgIconProps } from '@mui/material';
-import { SearcherLabels } from './labels';
+import { SearcherLabels } from './labels.js';
 export interface SearcherToggleProps {
     labels?: Partial<SearcherLabels>;
     icon?: ComponentType<SvgIconProps>;

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

@@ -1,4 +1,4 @@
-import { SearcherLabels } from './labels';
+import { SearcherLabels } from './labels.js';
 export interface SearcherProps {
     labels?: Partial<SearcherLabels>;
     /** Debounce delay before the input value is written to the widget store. */

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

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

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

@@ -1,6 +1,6 @@
 import { ComponentType } from 'react';
 import { SvgIconProps } from '@mui/material';
-import { ShowAllLabels } from './labels';
+import { ShowAllLabels } from './labels.js';
 /**
  * The `show-all` flag is a pure UI signal (no data/config transform): the
  * Category overflow row writes it `true` via {@link setShowAll}, the

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

@@ -1,3 +1,3 @@
-export { StackToggle, type StackToggleProps } from './stack-toggle';
-export { addStack } from './transforms';
-export { DEFAULT_STACK_TOGGLE_LABELS, type StackToggleLabels } from './labels';
+export { StackToggle, type StackToggleProps } from './stack-toggle.js';
+export { addStack } from './transforms.js';
+export { DEFAULT_STACK_TOGGLE_LABELS, type StackToggleLabels } from './labels.js';

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

@@ -1,6 +1,6 @@
 import { ComponentType } from 'react';
 import { SvgIconProps } from '@mui/material';
-import { StackToggleLabels } from './labels';
+import { StackToggleLabels } from './labels.js';
 export interface StackToggleProps {
     initialEnabled?: boolean;
     labels?: Partial<StackToggleLabels>;

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

@@ -1,3 +1,3 @@
-export { ZoomToggle, type ZoomToggleProps } from './zoom-toggle';
-export { addZoom, createAddZoom, ZOOM_LAYOUT, type ZoomAxis, type CreateAddZoomOptions, } from './transforms';
-export { DEFAULT_ZOOM_TOGGLE_LABELS, type ZoomToggleLabels } from './labels';
+export { ZoomToggle, type ZoomToggleProps } from './zoom-toggle.js';
+export { addZoom, createAddZoom, ZOOM_LAYOUT, type ZoomAxis, type CreateAddZoomOptions, } from './transforms.js';
+export { DEFAULT_ZOOM_TOGGLE_LABELS, type ZoomToggleLabels } from './labels.js';

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

@@ -1,7 +1,7 @@
 import { ComponentType } from 'react';
 import { SvgIconProps } from '@mui/material';
-import { ZoomAxis } from './transforms';
-import { ZoomToggleLabels } from './labels';
+import { ZoomAxis } from './transforms.js';
+import { ZoomToggleLabels } from './labels.js';
 export interface ZoomToggleProps {
     initialEnabled?: boolean;
     labels?: Partial<ZoomToggleLabels>;

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

@@ -1,5 +1,5 @@
-import { DownloadItem } from '../actions/download';
-import { BarWidgetData } from './types';
+import { DownloadItem } from '../actions/download/index.js';
+import { BarWidgetData } from './types.js';
 export interface BarDownloadConfigArgs {
     filename: string;
     getData: () => BarWidgetData;

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

@@ -1,4 +1,4 @@
-export { barOptions, createBarOptionFactory } from './options';
-export { BarSkeleton } from './skeleton';
-export { createBarDownloadConfig } from './download';
-export type { BarDatum, BarWidgetData, BarOptionsInput, BarOptionFactoryInput, BarEChartsOption, } from './types';
+export { barOptions, createBarOptionFactory } from './options.js';
+export { BarSkeleton } from './skeleton.js';
+export { createBarDownloadConfig } from './download.js';
+export type { BarDatum, BarWidgetData, BarOptionsInput, BarOptionFactoryInput, BarEChartsOption, } from './types.js';

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

@@ -1,5 +1,5 @@
-import { OptionFactory } from '../echart';
-import { BarEChartsOption, BarOptionFactoryInput, BarOptionsInput } from './types';
+import { OptionFactory } from '../echart/index.js';
+import { BarEChartsOption, BarOptionFactoryInput, BarOptionsInput } from './types.js';
 /**
  * Builds the **structural** ECharts option for a bar widget — axes, grid,
  * tooltip styling, themed legend. Intentionally data-agnostic: no series,

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

@@ -1,6 +1,6 @@
 import { Theme } from '@mui/material';
 import { EChartsOption } from 'echarts';
-import { WidgetSeries } from '../types';
+import { WidgetSeries } from '../types.js';
 /** A single category entry in a bar series. */
 export interface BarDatum {
     name: string | number;

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

@@ -1,4 +1,4 @@
-import { CategoryKey, CategoryLabels, CategorySeriesConfig, CategorySize, CategoryWidgetData } from './types';
+import { CategoryKey, CategoryLabels, CategorySeriesConfig, CategorySize, CategoryWidgetData } from './types.js';
 export interface CategoryUIProps {
     data: CategoryWidgetData;
     /** Currently-selected category names (destination-owned). */

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

@@ -1,4 +1,4 @@
-import { CategoryKey, CategoryLabels, CategorySeriesConfig, CategorySize } from './types';
+import { CategoryKey, CategoryLabels, CategorySeriesConfig, CategorySize } from './types.js';
 export interface CategoryProps {
     /** Currently-selected category names. Destination-owned. */
     selection?: readonly CategoryKey[];

package/dist/types/widgets-v2/category/components/category-bar-stacked.d.ts

@@ -1,4 +1,4 @@
-import { CategorySize } from '../types';
+import { CategorySize } from '../types.js';
 export interface CategoryBarStackedProps {
     /** One value per series. Zero values render no segment (visually + in the DOM). */
     values: readonly number[];

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

@@ -1,4 +1,4 @@
-import { CategorySize } from '../types';
+import { CategorySize } from '../types.js';
 export interface CategoryBarProps {
     /** Numeric value driving the fill width. */
     value: number;

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

@@ -1,4 +1,4 @@
-import { CategorySeriesConfig } from '../types';
+import { CategorySeriesConfig } from '../types.js';
 export interface CategoryLegendProps {
     /** Series metadata. Empty array → renders nothing. */
     series: readonly CategorySeriesConfig[];

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

@@ -1,4 +1,4 @@
-import { CategoryKey, CategorySize } from '../types';
+import { CategoryKey, CategorySize } from '../types.js';
 export interface CategoryRowMultiProps {
     /** Raw category key — what gets emitted to `onToggle`. */
     name: CategoryKey;

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

@@ -1,4 +1,4 @@
-import { CategoryKey, CategorySize } from '../types';
+import { CategoryKey, CategorySize } from '../types.js';
 export interface CategoryRowSingleProps {
     /** Raw category key — what gets emitted to `onToggle` regardless of formatter. */
     name: CategoryKey;

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

@@ -1,4 +1,4 @@
-import { CategoryKey, CategorySize } from '../types';
+import { CategoryKey, CategorySize } from '../types.js';
 export interface CategoryRowStackedProps {
     /** Raw category key — what gets emitted to `onToggle`. */
     name: CategoryKey;

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

@@ -1,5 +1,5 @@
-import { DownloadItem } from '../actions/download';
-import { CategoryWidgetData } from './types';
+import { DownloadItem } from '../actions/download/index.js';
+import { CategoryWidgetData } from './types.js';
 /**
  * Download menu items for the Category widget. Always includes a CSV item
  * with `series, name, value` columns (one row per item). When

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

@@ -1,10 +1,10 @@
-export { Category, type CategoryProps } from './category';
-export { CategoryUI, type CategoryUIProps } from './category-ui';
-export { CategorySkeleton, type CategorySkeletonProps } from './skeleton';
-export { createCategoryDownloadConfig } from './download';
-export { CategoryBar, type CategoryBarProps } from './components/category-bar';
-export { CategoryRowSingle, type CategoryRowSingleProps, } from './components/category-row-single';
-export { CategoryRowMulti, type CategoryRowMultiProps, } from './components/category-row-multi';
-export { CategoryRowOther, type CategoryRowOtherProps, } from './components/category-row-other';
-export { CategoryLegend, type CategoryLegendProps, } from './components/category-legend';
-export type { CategoryDataItem, CategoryWidgetData, CategoryKey, CategorySeriesConfig, CategoryLabels, CategorySize, } from './types';
+export { Category, type CategoryProps } from './category.js';
+export { CategoryUI, type CategoryUIProps } from './category-ui.js';
+export { CategorySkeleton, type CategorySkeletonProps } from './skeleton.js';
+export { createCategoryDownloadConfig } from './download.js';
+export { CategoryBar, type CategoryBarProps } from './components/category-bar.js';
+export { CategoryRowSingle, type CategoryRowSingleProps, } from './components/category-row-single.js';
+export { CategoryRowMulti, type CategoryRowMultiProps, } from './components/category-row-multi.js';
+export { CategoryRowOther, type CategoryRowOtherProps, } from './components/category-row-other.js';
+export { CategoryLegend, type CategoryLegendProps, } from './components/category-legend.js';
+export type { CategoryDataItem, CategoryWidgetData, CategoryKey, CategorySeriesConfig, CategoryLabels, CategorySize, } from './types.js';

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

@@ -1,4 +1,4 @@
-import { CategorySize } from './types';
+import { CategorySize } from './types.js';
 export interface CategorySkeletonProps {
     rows?: number;
     /**

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

@@ -1,5 +1,5 @@
 import { SxProps, Theme } from '@mui/material';
-import { CategorySize } from './types';
+import { CategorySize } from './types.js';
 export declare const styles: {
     root: {
         display: string;

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

@@ -1,4 +1,4 @@
-import { WidgetSeries } from '../types';
+import { WidgetSeries } from '../types.js';
 /** A single row in a Category widget. `name` is the category key. */
 export interface CategoryDataItem {
     name: string | number;

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

@@ -2,7 +2,6 @@ import { SxProps, Theme } from '@mui/material';
 import * as echarts from 'echarts';
 export declare const DEFAULT_INIT_OPTS: {
     renderer: "svg";
-    height: number;
 };
 export type EchartsEventHandler = (event: unknown) => void;
 export interface EchartUIProps {
@@ -25,7 +24,8 @@ export interface EchartUIProps {
     /**
      * Init options forwarded to echarts.init. Captured at mount only — to change
      * `renderer` or `height` after mount, unmount and remount the chart.
-     * Defaults: `{ renderer: 'svg', height: 304 }`.
+     * Defaults: `{ renderer: 'svg' }` — height is container-driven, so prefer
+     * `sx={{ minHeight }}` over pinning `height` here.
      */
     init?: echarts.EChartsInitOpts;
     /**

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

@@ -1,4 +1,5 @@
-import { EchartsEventHandler } from './echart-ui';
+import { SxProps, Theme } from '@mui/material';
+import { EchartsEventHandler } from './echart-ui.js';
 import type * as echarts from 'echarts';
 /**
  * Reactive context passed to every {@link OptionFactory} call so the
@@ -48,6 +49,13 @@ export interface EchartProps {
     onEvents?: Record<string, EchartsEventHandler>;
     init?: echarts.EChartsInitOpts;
     className?: string;
+    /**
+     * Styles for the chart container — this is where its height comes from.
+     * `min-height` defaults to the card height (304px) and `flex: 1` lets the
+     * chart fill a taller parent; override either here, e.g.
+     * `sx={{ minHeight: 400 }}` for a taller card.
+     */
+    sx?: SxProps<Theme>;
 }
 /**
  * Stateful Echart bridge — owns the entire ECharts coupling. The whole
@@ -72,4 +80,4 @@ export interface EchartProps {
  * a renderer-agnostic shell. The `ProviderProps` surface has no ECharts
  * coupling, so non-Echart widgets don't transitively import the type.
  */
-export declare function Echart({ optionFactory, onEvents, init, className, }: EchartProps): import("react").JSX.Element;
+export declare function Echart({ optionFactory, onEvents, init, className, sx, }: EchartProps): import("react").JSX.Element;

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

@@ -1,4 +1,4 @@
-export { EchartUI, DEFAULT_INIT_OPTS, type EchartUIProps, type EchartsEventHandler, } from './echart-ui';
-export { Echart, type EchartProps, type OptionFactory, type OptionFactoryContext, } from './echart';
-export { useChartSelection, type SelectionKey, type UseChartSelectionOptions, type ChartSelectionWiring, } from './use-chart-selection';
-export { observeResize, __resetSharedResizeObserver, } from './shared-resize-observer';
+export { EchartUI, DEFAULT_INIT_OPTS, type EchartUIProps, type EchartsEventHandler, } from './echart-ui.js';
+export { Echart, type EchartProps, type OptionFactory, type OptionFactoryContext, } from './echart.js';
+export { useChartSelection, type SelectionKey, type UseChartSelectionOptions, type ChartSelectionWiring, } from './use-chart-selection.js';
+export { observeResize, __resetSharedResizeObserver, } from './shared-resize-observer.js';

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

@@ -1,6 +1,7 @@
 export declare const styles: {
     root: {
         width: string;
+        flex: number;
         minHeight: number;
     };
 };

package/dist/types/widgets-v2/echart/use-chart-selection.d.ts

@@ -1,5 +1,5 @@
 import { CallbackDataParams } from 'echarts/types/dist/shared';
-import { EchartsEventHandler } from './echart-ui';
+import { EchartsEventHandler } from './echart-ui.js';
 export type SelectionKey = string | number;
 export interface UseChartSelectionOptions<K extends SelectionKey> {
     /**

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

@@ -1,5 +1,5 @@
 import { ChipProps } from '@mui/material';
-import { DeltaSeverity } from './types';
+import { DeltaSeverity } from './types.js';
 export interface DeltaProps {
     /** Numeric magnitude. Used for the default percent label and severity inference. */
     value: number;

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

@@ -1,5 +1,5 @@
-import { DownloadItem } from '../actions/download';
-import { FormulaWidgetData } from './types';
+import { DownloadItem } from '../actions/download/index.js';
+import { FormulaWidgetData } from './types.js';
 export interface FormulaDownloadConfigArgs {
     filename: string;
     getData: () => FormulaWidgetData;

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

@@ -1,5 +1,5 @@
 import { Ref } from 'react';
-import { FormulaDataItem } from './types';
+import { FormulaDataItem } from './types.js';
 export interface FormulaUIProps {
     items: readonly FormulaDataItem[];
     /** Number formatter — applied to each item's `value`. */

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

@@ -1,11 +1,11 @@
-export { Formula } from './formula';
-export { FormulaUI, type FormulaUIProps } from './formula-ui';
-export { Prefix, type PrefixProps } from './prefix';
-export { Suffix, type SuffixProps } from './suffix';
-export { Value, type ValueProps } from './value';
-export { Series, type SeriesProps } from './series';
-export { Note, type NoteProps } from './note';
-export { Delta, type DeltaProps } from './delta';
-export { FormulaSkeleton, type FormulaSkeletonProps } from './skeleton';
-export { createFormulaDownloadConfig } from './download';
-export type { FormulaDataItem, FormulaWidgetData, FormulaSeries, FormulaDelta, DeltaSeverity, } from './types';
+export { Formula } from './formula.js';
+export { FormulaUI, type FormulaUIProps } from './formula-ui.js';
+export { Prefix, type PrefixProps } from './prefix.js';
+export { Suffix, type SuffixProps } from './suffix.js';
+export { Value, type ValueProps } from './value.js';
+export { Series, type SeriesProps } from './series.js';
+export { Note, type NoteProps } from './note.js';
+export { Delta, type DeltaProps } from './delta.js';
+export { FormulaSkeleton, type FormulaSkeletonProps } from './skeleton.js';
+export { createFormulaDownloadConfig } from './download.js';
+export type { FormulaDataItem, FormulaWidgetData, FormulaSeries, FormulaDelta, DeltaSeverity, } from './types.js';

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

@@ -1,4 +1,4 @@
-import { WidgetSeries } from '../types';
+import { WidgetSeries } from '../types.js';
 /**
  * Series metadata rendered as a coloured avatar at the start of a row.
  *

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

@@ -1,5 +1,5 @@
-import { DownloadItem } from '../actions/download';
-import { HistogramWidgetData } from './types';
+import { DownloadItem } from '../actions/download/index.js';
+import { HistogramWidgetData } from './types.js';
 /**
  * Download menu items for histograms. Always includes a CSV item with
  * `bin_low, bin_high, series_1_count, series_2_count, …` columns (one row

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

@@ -1,5 +1,5 @@
-export { histogramOptions, createHistogramOptionFactory } from './options';
-export { HistogramSkeleton, type HistogramSkeletonProps } from './skeleton';
-export { createHistogramDownloadConfig } from './download';
-export { toRelativeHistogramData, filterHistogramByLockedBins, } from './transforms';
-export type { HistogramWidgetData, HistogramOptionsInput, HistogramOptionFactoryInput, HistogramEChartsOption, } from './types';
+export { histogramOptions, createHistogramOptionFactory } from './options.js';
+export { HistogramSkeleton, type HistogramSkeletonProps } from './skeleton.js';
+export { createHistogramDownloadConfig } from './download.js';
+export { toRelativeHistogramData, filterHistogramByLockedBins, } from './transforms.js';
+export type { HistogramWidgetData, HistogramOptionsInput, HistogramOptionFactoryInput, HistogramEChartsOption, } from './types.js';

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

@@ -1,9 +1,9 @@
-import { OptionFactory } from '../echart';
-import { HistogramEChartsOption, HistogramOptionFactoryInput, HistogramOptionsInput } from './types';
+import { OptionFactory } from '../echart/index.js';
+import { HistogramEChartsOption, HistogramOptionFactoryInput, HistogramOptionsInput } from './types.js';
 /**
  * Builds the **structural** ECharts option for a histogram widget — axes,
  * grid, tooltip, value-axis label formatter, themed legend. Mirrors
- * {@link import('../bar/options').barOptions} so the two widgets share v1
+ * {@link import('../bar/options.js').barOptions} so the two widgets share v1
  * look-and-feel: themed dark tooltip with positioner, CARTO color palette,
  * structural legend (`show` toggled by the merger based on series count),
  * y-axis labels rendered inside the plot via the `niceNum` closure pattern.

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

@@ -1,6 +1,6 @@
 import { Theme } from '@mui/material';
 import { EChartsOption } from 'echarts';
-import { WidgetSeries } from '../types';
+import { WidgetSeries } from '../types.js';
 /**
  * Histogram widget data — array of series, each a flat array of bin counts.
  * The option factory's merge phase (see {@link createHistogramOptionFactory})