@carto/ps-react-ui 5.0.0-widgets.9 → 5.1.0

package/dist/types/widgets/formula/components/prefix.d.ts

@@ -1,2 +1,5 @@
-import { ValueProps } from '../types';
-export declare function Prefix({ id, index, ...props }: ValueProps): import("react/jsx-runtime").JSX.Element | null;
+import { ValueProps } from '../types.js';
+/**
+ * Renders the prefix content (e.g., currency symbol) before a formula value, if defined in the data item.
+ */
+export declare function Prefix({ id, index, ...props }: ValueProps): import('react').JSX.Element | null;

package/dist/types/widgets/formula/components/row.d.ts

@@ -1,2 +1,5 @@
-import { RowProps } from '../types';
-export declare function Row(props: RowProps): import("react/jsx-runtime").JSX.Element[] | undefined;
+import { RowProps } from '../types.js';
+/**
+ * Iterates over the widget's data items and renders a row for each one using render props.
+ */
+export declare function Row(props: RowProps): import('react').JSX.Element[] | undefined;

package/dist/types/widgets/formula/components/series.d.ts

@@ -1,2 +1,5 @@
-import { ValueProps } from '../types';
-export declare function Series({ id, index }: Pick<ValueProps, 'id' | 'index'>): import("react/jsx-runtime").JSX.Element | null;
+import { ValueProps } from '../types.js';
+/**
+ * Renders a colored avatar badge showing the first letter of the series name for multi-value formula widgets.
+ */
+export declare function Series({ id, index }: Pick<ValueProps, 'id' | 'index'>): import('react').JSX.Element | null;

package/dist/types/widgets/formula/components/suffix.d.ts

@@ -1,2 +1,5 @@
-import { ValueProps } from '../types';
-export declare function Suffix({ id, index, ...props }: ValueProps): import("react/jsx-runtime").JSX.Element | null;
+import { ValueProps } from '../types.js';
+/**
+ * Renders the suffix content (e.g., unit label) after a formula value, if defined in the data item.
+ */
+export declare function Suffix({ id, index, ...props }: ValueProps): import('react').JSX.Element | null;

package/dist/types/widgets/formula/components/value.d.ts

@@ -1,2 +1,5 @@
-import { ValueProps } from '../types';
-export declare function Value({ id, index, ...props }: ValueProps): import("react/jsx-runtime").JSX.Element;
+import { ValueProps } from '../types.js';
+/**
+ * Displays the formatted numeric value for a formula widget data item, applying the widget's formatter and color.
+ */
+export declare function Value({ id, index, ...props }: ValueProps): import('react').JSX.Element;

package/dist/types/widgets/formula/config.d.ts

@@ -1,4 +1,15 @@
-import { ConfigProps } from '../root/types';
-import { FormulaDownloadConfig, FormulaWidgetConfig } from './types';
+import { ConfigProps } from '../loader/types.js';
+import { FormulaDownloadConfig, FormulaWidgetConfig } from './types.js';
+/**
+ * Creates download configuration for formula widgets, supporting PNG (screenshot) and CSV (data) exports.
+ *
+ * @param props - Configuration with `refUI` reference for PNG export.
+ * @returns Array of download items for use with the Download action.
+ */
 export declare function formulaDownloadConfig({ refUI, }: ConfigProps): FormulaDownloadConfig;
+/**
+ * Returns the default configuration for formula (single or multiple numeric value) widgets.
+ *
+ * @returns Default formula widget config with empty series.
+ */
 export declare function formulaConfig(): FormulaWidgetConfig;

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

@@ -1,2 +1,5 @@
-import { FormulaUIProps } from './types';
-export declare function FormulaUI(props: FormulaUIProps): import("react/jsx-runtime").JSX.Element;
+import { FormulaUIProps } from './types.js';
+/**
+ * Renders a formula widget displaying one or more KPI values with optional prefixes, suffixes, and series indicators.
+ */
+export declare function FormulaUI(props: FormulaUIProps): import('react').JSX.Element;

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

@@ -1,11 +1,11 @@
-export { Item } from './components/item';
-export { Value } from './components/value';
-export { Prefix } from './components/prefix';
-export { Suffix } from './components/suffix';
-export { Series } from './components/series';
-export { Row } from './components/row';
-export { formulaConfig, formulaDownloadConfig } from './config';
-export { FormulaUI } from './formula-ui';
-export { FormulaSkeleton } from './skeleton';
-export { sanitizeDataItem, sanitizeDataItems } from './serializer';
-export type { DataItem, FormulaDownloadConfig, FormulaUIProps, FormulaWidgetConfig, FormulaWidgetData, FormulaWidgetState, ItemProps, RowProps, SeriesConfig, ValueProps, } from './types';
+export { Item } from './components/item.js';
+export { Value } from './components/value.js';
+export { Prefix } from './components/prefix.js';
+export { Suffix } from './components/suffix.js';
+export { Series } from './components/series.js';
+export { Row } from './components/row.js';
+export { formulaConfig, formulaDownloadConfig } from './config.js';
+export { FormulaUI } from './formula-ui.js';
+export { FormulaSkeleton } from './skeleton.js';
+export { sanitizeDataItem, sanitizeDataItems } from './serializer.js';
+export type { DataItem, FormulaDownloadConfig, FormulaUIProps, FormulaWidgetConfig, FormulaWidgetData, FormulaWidgetState, ItemProps, RowProps, SeriesConfig, ValueProps, } from './types.js';

package/dist/types/widgets/formula/serializer.d.ts

@@ -1,4 +1,4 @@
-import { DataItem } from './types';
+import { DataItem } from './types.js';
 /**
  * Sanitizes DataItem by converting ReactNode prefix/suffix values to undefined.
  * This ensures only string values are stored in the widget state.

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

@@ -1 +1 @@
-export declare function FormulaSkeleton(): import("react/jsx-runtime").JSX.Element;
+export declare function FormulaSkeleton(): import('react').JSX.Element;

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

@@ -1,8 +1,8 @@
 import { TypographyProps } from '@mui/material';
 import { ReactNode } from 'react';
-import { BaseWidgetState, WidgetsStoreProps } from '../stores/types';
-import { WrapperState } from '../wrapper/types';
-import { DownloadItem } from '../actions/download/types';
+import { BaseWidgetState, WidgetsStoreProps } from '../stores/types.js';
+import { WrapperState } from '../wrapper/types.js';
+import { DownloadItem } from '../actions/download/types.js';
 export interface FormulaUIProps {
     id: WidgetsStoreProps['id'];
 }

package/dist/types/widgets/histogram/config.d.ts

@@ -1,5 +1,21 @@
-import { HistogramConfig, HistogramWidgetConfig, HistogramWidgetData } from './types';
-import { DownloadItem } from '../actions';
-import { ConfigProps } from '../root/types';
-export declare function histogramDownloadConfig({ refUI, }: ConfigProps): DownloadItem<HistogramWidgetData>[];
+import { HistogramConfig, HistogramWidgetConfig } from './types.js';
+import { DownloadItem } from '../actions/index.js';
+import { ConfigProps } from '../loader/types.js';
+export interface HistogramDownloadConfigProps extends ConfigProps {
+    ticks: number[];
+    labelFormatter?: (value: string | number) => string | number;
+}
+export declare function histogramDataToCSV(data: number[][], ticks: number[], labelFormatter?: (value: string | number) => string | number): string[][];
+export declare function histogramDownloadConfig({ refUI, ticks, labelFormatter, }: HistogramDownloadConfigProps): DownloadItem<number[][]>[];
+/**
+ * Generates ECharts configuration for distribution histogram widgets with
+ * adjacent bars (minimal gap) and axis formatting styled with the CARTO theme.
+ *
+ * Accepts raw `number[][]` data and `ticks` boundaries. The ticks and
+ * `labelFormatter` are used to create the x-axis category labels; the raw
+ * numeric data is embedded directly in each series.
+ *
+ * @param props - Histogram configuration including raw data, ticks, and theme.
+ * @returns Widget config with ECharts option object.
+ */
 export declare function histogramConfig(props: HistogramConfig): HistogramWidgetConfig;

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

@@ -1,3 +1,4 @@
-export type { HistogramConfig, HistogramWidgetConfig, HistogramWidgetData, HistogramWidgetState, } from './types';
-export { histogramConfig, histogramDownloadConfig } from './config';
-export { HistogramSkeleton } from './skeleton';
+export type { HistogramConfig, HistogramWidgetConfig, HistogramWidgetData, HistogramWidgetState, } from './types.js';
+export type { HistogramDownloadConfigProps } from './config.js';
+export { histogramConfig, histogramDataToCSV, histogramDownloadConfig, } from './config.js';
+export { HistogramSkeleton } from './skeleton.js';

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

@@ -1 +1 @@
-export declare function HistogramSkeleton(): import("react/jsx-runtime").JSX.Element;
+export declare function HistogramSkeleton(): import('react').JSX.Element;

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

@@ -1,9 +1,12 @@
-import { EchartWidgetData, EchartWidgetState } from '../echart';
-import { EchartWidgetOptionProps, EchartWidgetProps } from '../echart/types';
-import { ConfigProps } from '../root';
-export type HistogramWidgetData = EchartWidgetData;
+import { EchartWidgetState } from '../echart/index.js';
+import { EchartWidgetOptionProps, EchartWidgetProps } from '../echart/types.js';
+import { ConfigProps } from '../loader/index.js';
+export type HistogramWidgetData = number[][];
 export type HistogramWidgetState = EchartWidgetState;
 export type HistogramWidgetConfig = EchartWidgetProps & {
     type: 'histogram';
 };
-export type HistogramConfig = ConfigProps & EchartWidgetOptionProps<HistogramWidgetData>;
+export type HistogramConfig = ConfigProps & Pick<EchartWidgetOptionProps<unknown>, 'theme' | 'formatter' | 'labelFormatter'> & {
+    data?: number[][];
+    ticks: number[];
+};

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

@@ -0,0 +1,3 @@
+export { WidgetLoader } from './loader.js';
+export { mergeWidgetConfig, resolveConfig, type ConfigOrFn } from './utils.js';
+export type { WidgetLoaderProps, ConfigProps } from './types.js';

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

@@ -0,0 +1,24 @@
+import { WidgetLoaderProps } from './types.js';
+/**
+ * Foundation component for all widgets that manages state initialization, synchronization with the widget store, and data transformation pipeline execution.
+ *
+ * @remarks
+ * The WidgetLoader is stateless -- it manages data flow but does not render any UI. Always wrap it with WidgetWrapper for consistent widget appearance.
+ *
+ * @example
+ * ```tsx
+ * <WidgetLoader
+ *   id="sales-chart"
+ *   type="bar"
+ *   data={data}
+ *   isLoading={false}
+ *   isFetching={false}
+ *   config={barConfig({ data })}
+ * >
+ *   <WidgetWrapper id="sales-chart" title="Sales">
+ *     <Echart id="sales-chart" />
+ *   </WidgetWrapper>
+ * </WidgetLoader>
+ * ```
+ */
+export declare function WidgetLoader<T extends object = Record<string, unknown>>(props: WidgetLoaderProps<T>): import('react').ReactNode;

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

@@ -0,0 +1,9 @@
+import { ReactNode } from 'react';
+import { WidgetsStoreProps, WidgetState } from '../stores/types.js';
+export interface WidgetLoaderProps<T extends object = Record<string, unknown>> extends WidgetsStoreProps {
+    children: ReactNode;
+    config?: T;
+}
+export interface ConfigProps {
+    refUI?: WidgetState['refUI'];
+}

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

@@ -0,0 +1,35 @@
+/**
+ * Config can be either an object or a function that receives baseConfig and data
+ * and returns a partial config to be merged with the base.
+ */
+export type ConfigOrFn<TConfig, TData = unknown> = Partial<TConfig> | ((baseConfig: TConfig, data: TData) => Partial<TConfig>);
+/**
+ * Resolves a widget config that may be either a partial object or a function receiving the computed base config and data. If it is a function, calls it with `baseConfig` and `data`; otherwise returns the value as-is.
+ *
+ * @param config - The config object or function to resolve.
+ * @param baseConfig - The computed base configuration.
+ * @param data - The widget data.
+ * @returns Resolved partial config, or undefined.
+ *
+ * @example
+ * ```tsx
+ * const resolved = resolveConfig(
+ *   (base, data) => ({ maxItems: base.maxItems + 5 }),
+ *   baseConfig,
+ *   widgetData,
+ * )
+ * ```
+ */
+export declare function resolveConfig<TConfig, TData>(config: ConfigOrFn<TConfig, TData> | undefined, baseConfig: TConfig, data: TData): Partial<TConfig> | undefined;
+/**
+ * Deep-merges two partial widget config objects using `deepmerge`, with arrays replaced rather than concatenated.
+ *
+ * @param options - A tuple of two partial configs to merge (base and override).
+ * @returns The merged config object.
+ *
+ * @example
+ * ```tsx
+ * const finalConfig = mergeWidgetConfig(baseConfig, resolvedConfig)
+ * ```
+ */
+export declare function mergeWidgetConfig<T>(...options: [Partial<T> | undefined, Partial<T> | undefined]): T;

package/dist/types/widgets/markdown/config.d.ts

@@ -1,4 +1,14 @@
-import { DownloadItem } from '../actions';
-import { MarkdownWidgetConfig, MarkdownWidgetData } from './types';
+import { DownloadItem } from '../actions/index.js';
+import { MarkdownWidgetConfig, MarkdownWidgetData } from './types.js';
+/**
+ * Creates download configuration for markdown widgets, supporting CSV export of text content. Does not require `refUI` since it only exports text.
+ *
+ * @returns Array of download items for use with the Download action.
+ */
 export declare function markdownDownloadConfig(): DownloadItem<MarkdownWidgetData>[];
+/**
+ * Returns the default configuration for markdown content display widgets.
+ *
+ * @returns Default markdown widget config (empty object).
+ */
 export declare function markdownConfig(): MarkdownWidgetConfig;

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

@@ -1,5 +1,5 @@
-export { Markdown } from './markdown';
-export { MarkdownUI } from './markdown-ui';
-export { MarkdownSkeleton } from './skeleton';
-export { markdownConfig, markdownDownloadConfig } from './config';
-export type { MarkdownComponentProps, MarkdownUIProps, MarkdownWidgetData, MarkdownWidgetState, MarkdownWidgetConfig, MarkdownDownloadConfig, MarkdownDataItem, } from './types';
+export { Markdown } from './markdown.js';
+export { MarkdownUI } from './markdown-ui.js';
+export { MarkdownSkeleton } from './skeleton.js';
+export { markdownConfig, markdownDownloadConfig } from './config.js';
+export type { MarkdownComponentProps, MarkdownUIProps, MarkdownWidgetData, MarkdownWidgetState, MarkdownWidgetConfig, MarkdownDownloadConfig, MarkdownDataItem, } from './types.js';

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

@@ -1,2 +1,9 @@
-import { MarkdownComponentProps } from './types';
-export declare function MarkdownUI({ children, overrides }: MarkdownComponentProps): import("react/jsx-runtime").JSX.Element;
+import { MarkdownComponentProps } from './types.js';
+/**
+ * Presentational component that renders a Markdown string as MUI-styled HTML using react-markdown.
+ *
+ * @remarks
+ * Maps Markdown elements (headings, paragraphs, links, lists) to MUI Typography and Link components.
+ * Custom component overrides can be passed via the `overrides` prop.
+ */
+export declare function MarkdownUI({ children, overrides }: MarkdownComponentProps): import('react').JSX.Element;

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

@@ -1,2 +1,5 @@
-import { MarkdownUIProps } from './types';
-export declare function Markdown({ id }: MarkdownUIProps): import("react/jsx-runtime").JSX.Element | null;
+import { MarkdownUIProps } from './types.js';
+/**
+ * Stateful markdown widget component that reads content from the widget store and renders it as formatted rich text.
+ */
+export declare function Markdown({ id }: MarkdownUIProps): import('react').JSX.Element | null;

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

@@ -1 +1 @@
-export declare function MarkdownSkeleton(): import("react/jsx-runtime").JSX.Element;
+export declare function MarkdownSkeleton(): import('react').JSX.Element;

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

@@ -1,6 +1,6 @@
-import { BaseWidgetState, WidgetsStoreProps } from '../stores/types';
-import { WrapperState } from '../wrapper/types';
-import { DownloadItem } from '../actions/download/types';
+import { BaseWidgetState, WidgetsStoreProps } from '../stores/types.js';
+import { WrapperState } from '../wrapper/types.js';
+import { DownloadItem } from '../actions/download/types.js';
 import { Components } from 'react-markdown';
 export interface MarkdownComponentProps {
     children: string;

package/dist/types/widgets/no-data/index.d.ts

@@ -1,2 +1,2 @@
-export { WidgetNoData } from './no-data';
-export type { WidgetNoDataProps } from './types';
+export { WidgetNoData } from './no-data.js';
+export type { WidgetNoDataProps } from './types.js';

package/dist/types/widgets/no-data/no-data.d.ts

@@ -1,9 +1,10 @@
-import { WidgetNoDataProps } from './types';
+import { WidgetNoDataProps } from './types.js';
 /**
  * NoData wrapper component that displays empty state UI when widget has no data
  *
- * Integrates with widget store to check loading/fetching state and data availability.
- * Works in conjunction with SkeletonLoader for complete loading/empty state handling.
+ * Integrates with widget store to check loading/fetching state and source data availability.
+ * Uses `sourceData` (pre-pipeline data) instead of `data` (post-pipeline) to distinguish
+ * "API returned nothing" from "pipeline tools filtered everything out".
  *
  * @example Basic usage
  * ```tsx
@@ -32,4 +33,4 @@ import { WidgetNoDataProps } from './types';
  * </NoData>
  * ```
  */
-export declare function WidgetNoData({ id, children, title, description, isEmpty, }: WidgetNoDataProps): string | number | bigint | boolean | Iterable<import('react').ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<import('react').ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
+export declare function WidgetNoData({ id, children, title, description, isEmpty, }: WidgetNoDataProps): string | number | bigint | boolean | Iterable<import('react').ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<import('react').ReactNode> | null | undefined> | import('react').JSX.Element | null | undefined;

package/dist/types/widgets/no-data/types.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { WidgetState } from '../stores/types';
+import { WidgetState } from '../stores/types.js';
 /**
  * Props for the WidgetNoData wrapper component
  *
@@ -54,7 +54,11 @@ export interface WidgetNoDataProps {
      */
     description?: string;
     /**
-     * Optional custom function to determine if data is empty
+     * Optional custom function to determine if source data is empty.
+     * Receives `sourceData` (pre-pipeline data from the API), not `data`
+     * (post-pipeline). This allows distinguishing "API returned nothing"
+     * from "pipeline tools filtered everything out".
+     *
      * If not provided, uses default isEmpty logic that handles:
      * - null/undefined → empty
      * - [] (empty array) → empty

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

@@ -1,2 +1,2 @@
-export { WidgetNote } from './note';
-export type { WidgetNoteProps } from './types';
+export { WidgetNote } from './note.js';
+export type { WidgetNoteProps } from './types.js';

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

@@ -1,2 +1,12 @@
-import { WidgetNoteProps } from './types';
-export declare function WidgetNote({ children, labels, }: WidgetNoteProps): import("react/jsx-runtime").JSX.Element | null;
+import { WidgetNoteProps } from './types.js';
+/**
+ * Displays text content with markdown support and automatic show more/less functionality for long content. Automatically detects content exceeding 3 lines and shows an expand/collapse button.
+ *
+ * @example
+ * ```tsx
+ * <WidgetNote>
+ *   {"**Important:** This data is from Q4 2024."}
+ * </WidgetNote>
+ * ```
+ */
+export declare function WidgetNote({ children, labels, }: WidgetNoteProps): import('react').JSX.Element | null;

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

@@ -1,4 +1,4 @@
-import { MarkdownComponentProps } from '../markdown';
+import { MarkdownComponentProps } from '../markdown/index.js';
 export interface WidgetNoteProps {
     children: MarkdownComponentProps['children'];
     labels?: {

package/dist/types/widgets/pie/config.d.ts

@@ -1,5 +1,9 @@
-import { PieConfig, PieWidgetConfig, PieWidgetData } from './types';
-import { DownloadItem } from '../actions';
-import { ConfigProps } from '../root/types';
-export declare function pieDownloadConfig({ refUI, }: ConfigProps): DownloadItem<PieWidgetData>[];
+import { PieConfig, PieWidgetConfig } from './types.js';
+export declare const pieDownloadConfig: ({ refUI }: import('../loader/index.js').ConfigProps) => import('../actions/index.js').DownloadItem<import('../echart/index.js').EchartWidgetData>[];
+/**
+ * Generates ECharts configuration for pie and donut chart widgets. Falls back to a horizontal bar layout when multiple data series are provided.
+ *
+ * @param props - Pie chart configuration including data and theme.
+ * @returns Widget config with ECharts option object.
+ */
 export declare function pieConfig(props: PieConfig): PieWidgetConfig;

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

@@ -1,3 +1,3 @@
-export type { PieWidgetData, PieWidgetState, PieWidgetConfig, PieConfig, } from './types';
-export { pieConfig, pieDownloadConfig } from './config';
-export { PieSkeleton } from './skeleton';
+export type { PieWidgetData, PieWidgetState, PieWidgetConfig, PieConfig, } from './types.js';
+export { pieConfig, pieDownloadConfig } from './config.js';
+export { PieSkeleton } from './skeleton.js';

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

@@ -1 +1 @@
-export declare function PieSkeleton(): import("react/jsx-runtime").JSX.Element;
+export declare function PieSkeleton(): import('react').JSX.Element;

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

@@ -1,6 +1,6 @@
-import { EchartWidgetData, EchartWidgetState } from '../echart';
-import { EchartWidgetOptionProps, EchartWidgetProps } from '../echart/types';
-import { ConfigProps } from '../root';
+import { EchartWidgetData, EchartWidgetState } from '../echart/index.js';
+import { EchartWidgetOptionProps, EchartWidgetProps } from '../echart/types.js';
+import { ConfigProps } from '../loader/index.js';
 export type PieWidgetData = EchartWidgetData;
 export type PieWidgetState = EchartWidgetState;
 export type PieWidgetConfig = EchartWidgetProps & {

package/dist/types/widgets/range/components/range-item.d.ts

@@ -1,2 +1,5 @@
-import { RangeItemProps } from '../types';
-export declare function RangeItem({ id, index }: RangeItemProps): import("react/jsx-runtime").JSX.Element | null;
+import { RangeItemProps } from '../types.js';
+/**
+ * Renders a single range slider with editable min/max text inputs, reading its configuration from the widget store.
+ */
+export declare function RangeItem({ id, index }: RangeItemProps): import('react').JSX.Element | null;

package/dist/types/widgets/range/config.d.ts

@@ -1,6 +1,7 @@
-import { RangeWidgetConfig } from './types';
-export interface RangeConfigProps {
-    formatter?: (value: number) => string;
-    onChange?: (value: number[], index: number) => void;
-}
+import { RangeWidgetConfig } from './types.js';
+/**
+ * Returns the default configuration for range (value range with labels) widgets.
+ *
+ * @returns Default range widget config.
+ */
 export declare function rangeConfig(): RangeWidgetConfig;

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

@@ -1,6 +1,6 @@
-export { RangeUI } from './range-ui';
-export { RangeSkeleton } from './skeleton';
-export { rangeConfig } from './config';
-export { RangeItem } from './components/range-item';
-export type { RangeWidgetState, RangeWidgetConfig, RangeDownloadConfig, RangeUIProps, RangeDataItem, RangeWidgetData, RangeItemProps, } from './types';
-export { sanitizeRangeDataItem, sanitizeRangeDataItems } from './serializer';
+export { RangeUI } from './range-ui.js';
+export { RangeSkeleton } from './skeleton.js';
+export { rangeConfig } from './config.js';
+export { RangeItem } from './components/range-item.js';
+export type { RangeWidgetState, RangeWidgetConfig, RangeDownloadConfig, RangeUIProps, RangeDataItem, RangeWidgetData, RangeItemProps, } from './types.js';
+export { sanitizeRangeDataItem, sanitizeRangeDataItems } from './serializer.js';

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

@@ -1,2 +1,5 @@
-import { RangeUIProps } from './types';
-export declare function RangeUI(props: RangeUIProps): import("react/jsx-runtime").JSX.Element;
+import { RangeUIProps } from './types.js';
+/**
+ * Renders a range widget with one or more interactive dual-slider controls for selecting value ranges.
+ */
+export declare function RangeUI(props: RangeUIProps): import('react').JSX.Element;

package/dist/types/widgets/range/serializer.d.ts

@@ -1,4 +1,4 @@
-import { RangeDataItem } from './types';
+import { RangeDataItem } from './types.js';
 /**
  * Sanitizes RangeDataItem by converting ReactNode note values to undefined.
  * This ensures only string values are stored in the widget state.

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

@@ -1 +1 @@
-export declare function RangeSkeleton(): import("react/jsx-runtime").JSX.Element;
+export declare function RangeSkeleton(): import('react').JSX.Element;

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

@@ -1,7 +1,7 @@
 import { ReactNode } from 'react';
-import { BaseWidgetState, WidgetsStoreProps } from '../stores/types';
-import { WrapperState } from '../wrapper/types';
-import { DownloadItem } from '../actions/download/types';
+import { BaseWidgetState, WidgetsStoreProps } from '../stores/types.js';
+import { WrapperState } from '../wrapper/types.js';
+import { DownloadItem } from '../actions/download/types.js';
 export interface RangeUIProps {
     id: WidgetsStoreProps['id'];
 }

package/dist/types/widgets/scatterplot/config.d.ts

@@ -1,5 +1,9 @@
-import { ScatterplotConfig, ScatterplotWidgetConfig, ScatterplotWidgetData } from './types';
-import { DownloadItem } from '../actions';
-import { ConfigProps } from '../root/types';
-export declare function scatterplotDownloadConfig({ refUI, }: ConfigProps): DownloadItem<ScatterplotWidgetData>[];
+import { ScatterplotConfig, ScatterplotWidgetConfig, ScatterplotWidgetData } from './types.js';
+export declare const scatterplotDownloadConfig: ({ refUI }: import('../loader/index.js').ConfigProps) => import('../actions/index.js').DownloadItem<ScatterplotWidgetData>[];
+/**
+ * Generates ECharts configuration for X-Y scatter plot widgets with value axes, legend support, and CARTO qualitative color palette.
+ *
+ * @param props - Scatterplot configuration including data points and theme.
+ * @returns Widget config with ECharts option object.
+ */
 export declare function scatterplotConfig(props: ScatterplotConfig): ScatterplotWidgetConfig;

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

@@ -1,3 +1,3 @@
-export type { ScatterplotWidgetData, ScatterplotWidgetState, ScatterplotWidgetConfig, ScatterplotConfig, } from './types';
-export { scatterplotConfig, scatterplotDownloadConfig } from './config';
-export { ScatterplotSkeleton } from './skeleton';
+export type { ScatterplotWidgetData, ScatterplotWidgetState, ScatterplotWidgetConfig, ScatterplotConfig, } from './types.js';
+export { scatterplotConfig, scatterplotDownloadConfig } from './config.js';
+export { ScatterplotSkeleton } from './skeleton.js';

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

@@ -1 +1 @@
-export declare function ScatterplotSkeleton(): import("react/jsx-runtime").JSX.Element;
+export declare function ScatterplotSkeleton(): import('react').JSX.Element;

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

@@ -1,6 +1,6 @@
-import { EchartWidgetState } from '../echart';
-import { EchartWidgetOptionProps, EchartWidgetProps } from '../echart/types';
-import { ConfigProps } from '../root';
+import { EchartWidgetState } from '../echart/index.js';
+import { EchartWidgetOptionProps, EchartWidgetProps } from '../echart/types.js';
+import { ConfigProps } from '../loader/index.js';
 export type ScatterplotWidgetData = [number, number][][];
 export type ScatterplotWidgetState = EchartWidgetState;
 export type ScatterplotWidgetConfig = EchartWidgetProps & {

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

@@ -1,2 +1,2 @@
-export { WidgetSelectionSummary } from './selection-summary';
-export type { WidgetSelectionSummaryProps, SelectionSummaryLabels, } from './types';
+export { WidgetSelectionSummary } from './selection-summary.js';
+export type { WidgetSelectionSummaryProps, SelectionSummaryLabels, } from './types.js';

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

@@ -1,2 +1,13 @@
-import { WidgetSelectionSummaryProps } from './types';
-export declare function WidgetSelectionSummary({ selections, onClear, labels, }: WidgetSelectionSummaryProps): import("react/jsx-runtime").JSX.Element;
+import { WidgetSelectionSummaryProps } from './types.js';
+/**
+ * Displays the count of selected items with an optional clear button. Commonly used with the LockSelection action to show selection state in widgets.
+ *
+ * @example
+ * ```tsx
+ * <WidgetSelectionSummary
+ *   selections={selectedItems.length}
+ *   onClear={() => setSelectedItems([])}
+ * />
+ * ```
+ */
+export declare function WidgetSelectionSummary({ selections, onClear, labels, }: WidgetSelectionSummaryProps): import('react').JSX.Element;

package/dist/types/widgets/skeleton-loader/index.d.ts

@@ -1,2 +1,2 @@
-export { SkeletonLoader } from './skeleton-loader';
-export type { SkeletonLoaderProps } from './types';
+export { SkeletonLoader } from './skeleton-loader.js';
+export type { SkeletonLoaderProps } from './types.js';

package/dist/types/widgets/skeleton-loader/skeleton-loader.d.ts

@@ -1,2 +1,12 @@
-import { SkeletonLoaderProps } from './types';
-export declare function SkeletonLoader({ id, children, Skeleton, }: SkeletonLoaderProps): string | number | bigint | boolean | Iterable<import('react').ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<import('react').ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
+import { SkeletonLoaderProps } from './types.js';
+/**
+ * Displays a skeleton loading placeholder while widget data is loading. Subscribes to widget loading state in the store and renders the provided Skeleton component or children accordingly.
+ *
+ * @example
+ * ```tsx
+ * <SkeletonLoader id="sales-chart" Skeleton={BarSkeleton}>
+ *   <Bar id="sales-chart" />
+ * </SkeletonLoader>
+ * ```
+ */
+export declare function SkeletonLoader({ id, children, Skeleton, }: SkeletonLoaderProps): string | number | bigint | boolean | Iterable<import('react').ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<import('react').ReactNode> | null | undefined> | import('react').JSX.Element | null | undefined;