drizzle-cube 0.6.1 → 0.6.3

package/dist/cjs/client/components/charts/gaugeChartHelpers.d.ts

@@ -0,0 +1,36 @@
+import { AxisFormatConfig, ThresholdBand } from '../../types.js';
+/**
+ * Co-located helpers for GaugeChart: pure geometry/value math and threshold
+ * parsing extracted from the component so the render body stays flat. Pure
+ * extraction — no behaviour change.
+ */
+export declare const START_ANGLE: number;
+export declare const END_ANGLE: number;
+export declare const TRACK_COLOR = "#e2e8f0";
+export declare const DEFAULT_FILL = "#6366f1";
+export declare function parseNum(v: unknown): number | null;
+export declare function clamp(v: number, lo: number, hi: number): number;
+export declare function valueToAngle(value: number, min: number, max: number): number;
+export declare function resolveColor(fraction: number, thresholds: ThresholdBand[]): string;
+export declare function buildArcPath(innerRadius: number, outerRadius: number, startAngle: number, endAngle: number): string;
+/** Parse the displayConfig.thresholds value (array or JSON string) into bands. */
+export declare function parseThresholds(raw: unknown): ThresholdBand[];
+export interface ThresholdArcBand {
+    color: string;
+    start: number;
+    end: number;
+}
+/** Build the outer-ring threshold arc bands (in fraction space 0..1). */
+export declare function buildThresholdBands(thresholds: ThresholdBand[]): ThresholdArcBand[];
+export interface GaugeGeometry {
+    effectiveMax: number;
+    clampedValue: number;
+    fraction: number;
+    fillColor: string;
+    fillAngle: number;
+    needleAngle: number;
+}
+/** Compute the gauge's clamped value, fraction, fill colour, and angles. */
+export declare function computeGaugeGeometry(rawValue: number, minValue: number, maxValue: number, thresholds: ThresholdBand[]): GaugeGeometry;
+/** Format a gauge value with the optional axis format, else locale string. */
+export declare function formatGaugeValue(value: number, yAxisFormat?: AxisFormatConfig): string;

package/dist/cjs/client/components/charts/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Chart components for drizzle-cube client
+ * Minimal Recharts-based components with Tailwind styling
+ */
+export { default as RechartsBarChart } from './BarChart.js';
+export { default as RechartsLineChart } from './LineChart.js';
+export { default as RechartsAreaChart } from './AreaChart.js';
+export { default as RechartsPieChart } from './PieChart.js';
+export { default as RechartsScatterChart } from './ScatterChart.js';
+export { default as RechartsRadarChart } from './RadarChart.js';
+export { default as RechartsRadialBarChart } from './RadialBarChart.js';
+export { default as RechartsTreeMapChart } from './TreeMapChart.js';
+export { default as BubbleChart } from './BubbleChart.js';
+export { default as DataTable } from './DataTable.js';
+export { default as FunnelChart } from './FunnelChart.js';
+export { default as ActivityGridChart } from './ActivityGridChart.js';
+export { default as KpiNumber } from './KpiNumber.js';
+export { default as KpiDelta } from './KpiDelta.js';
+export { default as KpiText } from './KpiText.js';
+export { default as MarkdownChart } from './MarkdownChart.js';
+export { default as BoxPlotChart } from './BoxPlotChart.js';
+export { default as WaterfallChart } from './WaterfallChart.js';
+export { default as CandlestickChart } from './CandlestickChart.js';
+export { default as MeasureProfileChart } from './MeasureProfileChart.js';
+export { default as GaugeChart } from './GaugeChart.js';

package/dist/cjs/client/components/charts/kpiTextHelpers.d.ts

@@ -0,0 +1,46 @@
+import { ColorPalette } from '../../types.js';
+/**
+ * Co-located pure helpers for KpiText: value extraction, statistics, number
+ * formatting, template processing, and colour resolution. Extracted so the
+ * component body stays focused on dimensioning + render. Pure extraction — no
+ * behaviour change.
+ */
+/** Extract the configured measure fields from a chart config (string or array). */
+export declare function extractValueFields(yAxis: string | string[] | undefined): string[];
+/**
+ * Extract the values for a field from each row, falling back to the first
+ * available field when the configured field is absent. Null/undefined dropped.
+ */
+export declare function extractValues(data: Record<string, any>[], valueField: string): any[];
+export interface KpiStats {
+    mainValue: any;
+    min: number | null;
+    max: number | null;
+    showStats: boolean;
+}
+/**
+ * Reduce extracted values to the displayed main value plus optional min/max
+ * statistics. Numeric multi-value sets average and expose min/max; non-numeric
+ * sets concatenate.
+ */
+export declare function computeKpiStats(values: any[]): KpiStats;
+interface NumberFormatOptions {
+    formatValue?: (value: any) => string;
+    decimals?: number;
+}
+/** Format a number with K/M/B abbreviation, honouring a custom formatter. */
+export declare function formatKpiNumber(value: number | null | undefined, options: NumberFormatOptions): string;
+interface TemplateContext {
+    value: any;
+    valueField: string;
+    fieldLabel: string;
+    min: number | null;
+    max: number | null;
+    count: number;
+    formatNumber: (value: number | null | undefined) => string;
+}
+/** Replace `${var}` tokens in a KPI template, falling back to the raw value. */
+export declare function processKpiTemplate(template: string, ctx: TemplateContext): string;
+/** Resolve the KPI text colour from the palette by index, with a fallback. */
+export declare function resolveValueColor(valueColorIndex: number | undefined, colorPalette: ColorPalette | undefined): string;
+export {};

package/dist/cjs/client/components/charts/radarChartHelpers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Co-located data-shaping helpers for RadarChart. The component supports a
+ * config-driven format and a legacy auto-detection format; both branches are
+ * isolated here so the component body stays focused on rendering. Pure
+ * extraction — no behaviour change.
+ */
+export interface RadarShape {
+    radarData: any[];
+    seriesKeys: string[];
+    /** True when no numeric value fields could be found (legacy auto-detect). */
+    noNumericFields?: boolean;
+}
+/** Shape rows for the radar chart via config-driven or legacy auto-detection. */
+export declare function buildRadarData(data: any[], chartConfig: any, queryObject: any): RadarShape;

package/dist/cjs/client/components/charts/radialBarChartHelpers.d.ts

@@ -0,0 +1,22 @@
+import { ColorPalette } from '../../types.js';
+/**
+ * Co-located data-shaping helpers for RadialBarChart. The component supports a
+ * config-driven format and a legacy auto-detection format; both branches are
+ * isolated here so the component body stays focused on rendering. Pure
+ * extraction — no behaviour change.
+ */
+export interface RadialDatum {
+    name: string;
+    value: number;
+    fill?: string;
+}
+export interface RadialShape {
+    radialData: RadialDatum[];
+    /** True when the legacy auto-detect found no usable value field. */
+    noValueField?: boolean;
+}
+/**
+ * Shape rows for the radial bar chart (config-driven or legacy auto-detect),
+ * filtering out null/zero values.
+ */
+export declare function buildRadialData(data: any[], chartConfig: any, queryObject: any, colorPalette: ColorPalette | undefined): RadialShape;

package/dist/cjs/client/components/charts/useChartDimensions.d.ts

@@ -0,0 +1,20 @@
+import { RefObject } from 'react';
+interface ChartDimensions {
+    containerRef: RefObject<HTMLDivElement>;
+    dimensions: {
+        width: number;
+        height: number;
+    };
+    dimensionsReady: boolean;
+}
+/**
+ * Shared container-measurement hook for the D3/SVG charts (BubbleChart,
+ * ActivityGridChart).
+ *
+ * Performs an initial measurement with a requestAnimationFrame + setTimeout
+ * retry ladder (handles containers that aren't laid out yet), then keeps the
+ * dimensions in sync via a ResizeObserver and window resize. Mirrors the
+ * original per-component effects exactly.
+ */
+export declare function useChartDimensions(): ChartDimensions;
+export {};

package/dist/cjs/client/components/charts/useKpiDimensions.d.ts

@@ -0,0 +1,30 @@
+import { RefObject } from 'react';
+interface KpiDimensionOptions {
+    /** Container divisor for the width-based font size candidate. */
+    widthDivisor: number;
+    /** Container divisor for the height-based font size candidate. */
+    heightDivisor: number;
+    /** Minimum clamped font size. */
+    minFontSize: number;
+    /** Maximum clamped font size. */
+    maxFontSize: number;
+    /** Computes the measured-text width from the value element's box + container width. */
+    measureWidth: (measuredWidth: number, containerWidth: number) => number;
+    /** Re-run measurement whenever any of these change. */
+    deps: unknown[];
+}
+interface KpiDimensions {
+    containerRef: RefObject<HTMLDivElement>;
+    valueRef: RefObject<HTMLDivElement>;
+    fontSize: number;
+    textWidth: number;
+}
+/**
+ * Shared container-measurement hook for KPI cards (KpiNumber / KpiDelta).
+ *
+ * Measures the container to derive a responsive font size, then (after the font
+ * is applied) measures the rendered value element to size the histogram. Mirrors
+ * the original per-component effects exactly — only the tunable constants differ.
+ */
+export declare function useKpiDimensions({ widthDivisor, heightDivisor, minFontSize, maxFontSize, measureWidth, deps }: KpiDimensionOptions): KpiDimensions;
+export {};

package/dist/cjs/client/components/dashboard/DashboardContext.d.ts

@@ -0,0 +1,113 @@
+import { ReactNode, HTMLAttributes, DragEvent, MouseEvent, MutableRefObject } from 'react';
+import { LayoutItem, Layout } from 'react-grid-layout';
+import { UseDashboardActions } from '../../hooks/useDashboardHook.js';
+import { DashboardDisplayMode } from '../../hooks/useResponsiveDashboard.js';
+import { ColorPalette } from '../../utils/colorPalettes.js';
+import { DashboardConfig, PortletConfig, DashboardFilter, DashboardFilterMapping, CubeMeta, DashboardLayoutMode, DashboardGridSettings, RowLayout, FeaturesConfig } from '../../types.js';
+/**
+ * Props accepted by DashboardProvider (the public composable entry point).
+ * Mirrors the former DashboardGridProps plus `hideToolbar` and `children`.
+ */
+export interface DashboardProviderProps {
+    config: DashboardConfig;
+    editable?: boolean;
+    /** Dashboard-level filters to apply to portlets */
+    dashboardFilters?: DashboardFilter[];
+    /** Custom loading indicator for all portlets */
+    loadingComponent?: ReactNode;
+    onConfigChange?: (config: DashboardConfig) => void;
+    onPortletRefresh?: (portletId: string) => void;
+    onSave?: (config: DashboardConfig) => Promise<void> | void;
+    /** Callback to save thumbnail separately - called on edit mode exit when thumbnail feature is enabled */
+    onSaveThumbnail?: (thumbnailData: string) => Promise<string | void>;
+    /** Complete palette with both colors and gradient */
+    colorPalette?: ColorPalette;
+    /** Cube metadata for filter panel */
+    schema?: CubeMeta | null;
+    /** Handler for dashboard filter changes */
+    onDashboardFiltersChange?: (filters: DashboardFilter[]) => void;
+    dashboardModes?: DashboardLayoutMode[];
+    /** When true, DashboardToolbar renders nothing (both the top bar and floating toolbar) */
+    hideToolbar?: boolean;
+    children: ReactNode;
+}
+/**
+ * Everything the composable pieces need. Built fresh each render by the coordinator,
+ * matching the re-render cadence of the former monolithic DashboardGrid.
+ */
+export interface DashboardContextValue {
+    config: DashboardConfig;
+    editable: boolean;
+    dashboardFilters?: DashboardFilter[];
+    loadingComponent?: ReactNode;
+    colorPalette?: ColorPalette;
+    schema?: CubeMeta | null;
+    onSave?: (config: DashboardConfig) => Promise<void> | void;
+    onConfigChange?: (config: DashboardConfig) => void;
+    onDashboardFiltersChange?: (filters: DashboardFilter[]) => void;
+    hideToolbar?: boolean;
+    isEditMode: boolean;
+    selectedFilterId: string | null;
+    isPortletModalOpen: boolean;
+    editingPortlet: PortletConfig | null;
+    isTextModalOpen: boolean;
+    editingTextPortlet: PortletConfig | null;
+    isFilterConfigModalOpen: boolean;
+    filterConfigPortlet: PortletConfig | null;
+    deleteConfirmPortletId: string | null;
+    draftRows: RowLayout[] | null;
+    isDraggingPortlet: boolean;
+    isInitialized: boolean;
+    canEdit: boolean;
+    canChangeLayoutMode: boolean;
+    selectedFilter: DashboardFilter | null;
+    resolvedRows: RowLayout[];
+    layoutMode: DashboardLayoutMode;
+    allowedModes: DashboardLayoutMode[];
+    actions: UseDashboardActions;
+    displayMode: DashboardDisplayMode;
+    scaleFactor: number;
+    designWidth: number;
+    gridWidth: number;
+    isResponsiveEditable: boolean;
+    isScrolled: boolean;
+    isEditBarVisible: boolean;
+    scrollContainer: HTMLElement | null;
+    features: FeaturesConfig;
+    editBarRef: MutableRefObject<HTMLDivElement | null>;
+    gridContentRef: MutableRefObject<HTMLDivElement | null>;
+    gridSettings: DashboardGridSettings;
+    baseLayout: LayoutItem[];
+    renderPortletCard: (portlet: PortletConfig, containerProps?: HTMLAttributes<HTMLDivElement>, headerProps?: HTMLAttributes<HTMLDivElement>) => ReactNode;
+    /** Renders the active (grid or row) layout. A function so it's not evaluated in mobile/empty cases. */
+    renderActiveLayout: () => ReactNode;
+    handleAddPortlet: () => void;
+    handleAddText: () => void;
+    handlePaletteChange: (paletteName: string) => Promise<void>;
+    handleFilterSelect: (filterId: string) => void;
+    handleSelectAllForFilter: (filterId: string) => Promise<void>;
+    handleSaveFilterConfig: (mapping: DashboardFilterMapping) => Promise<void>;
+    handlePortletSave: (portletData: PortletConfig | Omit<PortletConfig, 'id' | 'x' | 'y'>) => Promise<void>;
+    handlePortletRefresh: (portletId: string, options?: {
+        bustCache?: boolean;
+    }) => void;
+    handleLayoutChange: (layout: Layout) => void;
+    handleDragStop: (layout: Layout, oldItem: LayoutItem | null, newItem: LayoutItem | null, placeholder: LayoutItem | null, e: Event, element: HTMLElement | null) => void;
+    handleResizeStop: (layout: Layout, oldItem: LayoutItem | null, newItem: LayoutItem | null, placeholder: LayoutItem | null, e: Event, element: HTMLElement | null) => void;
+    startRowResize: (rowIndex: number, event: MouseEvent<HTMLDivElement>) => void;
+    startColumnResize: (rowIndex: number, columnIndex: number, event: MouseEvent<HTMLDivElement>) => void;
+    handlePortletDragStart: (rowIndex: number, colIndex: number, portletId: string, event: DragEvent<HTMLDivElement>) => void;
+    handlePortletDragEnd: () => void;
+    handleRowDrop: (rowIndex: number, insertIndex: number | null) => void;
+    handleNewRowDrop: (insertIndex: number) => void;
+}
+declare const DashboardContext: import('react').Context<DashboardContextValue | null>;
+/**
+ * Access the dashboard context published by DashboardProvider.
+ * Lets a host render its own toolbar/controls while drizzle-cube owns the
+ * edit/save state machine.
+ *
+ * @throws if used outside a DashboardProvider (or DashboardGrid).
+ */
+export declare function useDashboardContext(): DashboardContextValue;
+export default DashboardContext;

package/dist/cjs/client/components/dashboard/DashboardCoordinator.d.ts

@@ -0,0 +1,2 @@
+import { DashboardProviderProps } from './DashboardContext.js';
+export default function DashboardCoordinator({ config, editable, dashboardFilters, loadingComponent, onConfigChange, onPortletRefresh, onSave, onSaveThumbnail, colorPalette, schema, onDashboardFiltersChange, dashboardModes, hideToolbar, children }: DashboardProviderProps): import("react").JSX.Element;

package/dist/cjs/client/components/dashboard/DashboardEditBar.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Sticky top edit bar for the dashboard toolbar. Reads everything from
+ * DashboardContext; rendered only when the top toolbar variant is active.
+ */
+export default function DashboardEditBar(): import("react").JSX.Element;

package/dist/cjs/client/components/dashboard/DashboardFilterBar.d.ts

@@ -0,0 +1,8 @@
+/**
+ * DashboardFilterBar
+ *
+ * The dashboard-level filter UI (the internal DashboardFilterPanel) plus the
+ * filter-selection-mode banner shown while assigning a filter to portlets.
+ * Reads everything from DashboardContext.
+ */
+export default function DashboardFilterBar(): import("react").JSX.Element;

package/dist/cjs/client/components/dashboard/DashboardGridSurface.d.ts

@@ -0,0 +1,8 @@
+/**
+ * DashboardGridSurface
+ *
+ * Renders the portlet layout (grid / row / scaled / mobile) inside the
+ * thumbnail-capture wrapper, or the empty-state placeholder when there are no
+ * portlets. Reads everything from DashboardContext.
+ */
+export default function DashboardGridSurface(): import("react").JSX.Element;

package/dist/cjs/client/components/dashboard/DashboardModals.d.ts

@@ -0,0 +1,8 @@
+/**
+ * DashboardModals
+ *
+ * The four dashboard modals (add/edit portlet, add/edit text, portlet filter config,
+ * delete confirmation). All read their open/target state from DashboardContext; when
+ * closed they render nothing, so always mounting them is harmless.
+ */
+export default function DashboardModals(): import("react").JSX.Element;

package/dist/cjs/client/components/dashboard/DashboardProvider.d.ts

@@ -0,0 +1,2 @@
+import { DashboardProviderProps } from './DashboardContext.js';
+export default function DashboardProvider({ children, ...props }: DashboardProviderProps): import("react").JSX.Element;

package/dist/cjs/client/components/dashboard/DashboardToolbar.d.ts

@@ -0,0 +1,11 @@
+/**
+ * DashboardToolbar
+ *
+ * The bundled action toolbar: the sticky top edit bar (Edit / layout-mode toggle /
+ * palette / Add Text / Add Portlet) plus the FloatingEditToolbar that appears when the
+ * top bar scrolls out of view.
+ *
+ * Reads everything from DashboardContext. Renders nothing when `hideToolbar` is set, so
+ * a host can either omit this component or pass `hideToolbar` to suppress it.
+ */
+export default function DashboardToolbar(): import("react").JSX.Element | null;

package/dist/cjs/client/components/dashboard/LayoutModeToggle.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Grid / Rows layout-mode toggle used inside the dashboard edit bar.
+ */
+interface LayoutModeToggleProps {
+    layoutMode: string;
+    canChangeLayoutMode: boolean;
+    onLayoutModeChange: (mode: 'grid' | 'rows') => void;
+}
+export default function LayoutModeToggle({ layoutMode, canChangeLayoutMode, onLayoutModeChange }: LayoutModeToggleProps): import("react").JSX.Element;
+export {};

package/dist/cjs/client/components/dashboard/dashboardGridUtils.d.ts

@@ -0,0 +1,17 @@
+import { CSSProperties } from 'react';
+import { DashboardConfig, DashboardGridSettings, RowLayoutColumn } from '../../types.js';
+export declare const DEFAULT_GRID_SETTINGS: DashboardGridSettings;
+export declare const createRowId: () => string;
+export declare const getGridSettings: (config: DashboardConfig) => DashboardGridSettings;
+export declare const equalizeRowColumns: (portletIds: string[], gridSettings: DashboardGridSettings) => RowLayoutColumn[];
+export declare const adjustRowWidths: (columns: RowLayoutColumn[], gridSettings: DashboardGridSettings) => RowLayoutColumn[];
+/**
+ * Finds the nearest scrollable ancestor of an element.
+ * Used to detect scroll container for lazy loading IntersectionObserver.
+ */
+export declare function findScrollableAncestor(element: HTMLElement | null): HTMLElement | null;
+/** Inline "Tt" typography icon for Add Text buttons */
+export declare function TextIcon({ className, style }: {
+    className?: string;
+    style?: CSSProperties;
+}): import("react").JSX.Element;

package/dist/cjs/client/components/dashboard/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Composable dashboard pieces.
+ *
+ * Compose these under a DashboardProvider, or use the back-compat DashboardGrid
+ * which wires them together for you.
+ */
+export { default as DashboardProvider } from './DashboardProvider.js';
+export { default as DashboardToolbar } from './DashboardToolbar.js';
+export { default as DashboardFilterBar } from './DashboardFilterBar.js';
+export { default as DashboardGridSurface } from './DashboardGridSurface.js';
+export { default as DashboardModals } from './DashboardModals.js';
+export { useDashboardContext } from './DashboardContext.js';
+export type { DashboardContextValue, DashboardProviderProps } from './DashboardContext.js';

package/dist/cjs/client/components/dashboardPortletCard/FilterFieldChip.d.ts

@@ -0,0 +1,12 @@
+import { CSSProperties, ComponentType } from 'react';
+import { EffectiveFilterField } from './filterField.js';
+interface FilterFieldChipProps {
+    field: EffectiveFilterField;
+    FilterIcon: ComponentType<{
+        className?: string;
+        style?: CSSProperties;
+    }>;
+    onOpenFilterConfig: () => void;
+}
+export default function FilterFieldChip({ field, FilterIcon, onOpenFilterConfig }: FilterFieldChipProps): import("react").JSX.Element;
+export {};

package/dist/cjs/client/components/dashboardPortletCard/PortletCardHeader.d.ts

@@ -0,0 +1,43 @@
+import { default as React, CSSProperties, ComponentType } from 'react';
+import { PortletConfig } from '../../types.js';
+import { PortletDebugDataEntry } from '../../stores/dashboardStore.js';
+type IconComponent = ComponentType<{
+    className?: string;
+    style?: CSSProperties;
+}>;
+interface CardIcons {
+    RefreshIcon: IconComponent;
+    EditIcon: IconComponent;
+    DeleteIcon: IconComponent;
+    CopyIcon: IconComponent;
+    FilterIcon: IconComponent;
+}
+interface PortletCardHeaderProps {
+    portlet: PortletConfig;
+    className: string;
+    headerStyle?: CSSProperties;
+    restHeaderProps: Record<string, unknown>;
+    headerOnClick?: (event: React.MouseEvent<HTMLDivElement>) => void;
+    editable: boolean;
+    isEditMode: boolean;
+    isInSelectionMode: boolean;
+    debugData?: PortletDebugDataEntry;
+    copyAvailable: boolean;
+    copySuccess: boolean;
+    xlsExportAvailable: boolean;
+    exportInProgress: boolean;
+    showCacheBustIndicator: boolean;
+    icons: CardIcons;
+    onRefresh: (options?: {
+        bustCache?: boolean;
+    }) => void;
+    onHoverRefreshChange: (hovering: boolean) => void;
+    onCopyToClipboard: (event: React.MouseEvent | React.TouchEvent) => void;
+    onExportXlsx: (event: React.MouseEvent | React.TouchEvent) => void;
+    onOpenFilterConfig: () => void;
+    onDuplicate: () => void;
+    onEdit: () => void;
+    onDelete: () => void;
+}
+export default function PortletCardHeader(props: PortletCardHeaderProps): React.JSX.Element;
+export {};

package/dist/cjs/client/components/dashboardPortletCard/cardStyles.d.ts

@@ -0,0 +1,33 @@
+import { CSSProperties } from 'react';
+import { ChartType, ChartDisplayConfig } from '../../types.js';
+export interface PortletDisplayModes {
+    isMarkdownAutoHeight: boolean;
+    isTransparentContent: boolean;
+    isTransparent: boolean;
+    shouldHideHeader: boolean;
+}
+/**
+ * Resolve the markdown / transparency / header-visibility display modes for a
+ * portlet from its chart type and display config. Extracted to keep the card
+ * component flat.
+ */
+export declare function resolveDisplayModes(params: {
+    renderChartType: ChartType;
+    renderDisplayConfig?: ChartDisplayConfig;
+    layoutMode: string;
+    isEditMode: boolean;
+    portletTitle?: string;
+}): PortletDisplayModes;
+export declare function buildContainerClassName(params: {
+    isTransparent: boolean;
+    isMarkdownAutoHeight: boolean;
+    isInSelectionMode: boolean;
+    extraClassName?: string;
+}): string;
+export declare function buildHeaderClassName(isEditMode: boolean, extraClassName?: string): string;
+export declare function buildContainerStyle(params: {
+    isTransparent: boolean;
+    isInSelectionMode: boolean;
+    hasSelectedFilter: boolean;
+    containerStyle?: CSSProperties;
+}): CSSProperties;

package/dist/cjs/client/components/dashboardPortletCard/filterField.d.ts

@@ -0,0 +1,12 @@
+import { DashboardFilter, PortletConfig } from '../../types.js';
+export interface EffectiveFilterField {
+    field: string;
+    isOverride: boolean;
+}
+export declare function resolveEffectiveFilterField(params: {
+    isInSelectionMode: boolean;
+    hasSelectedFilter: boolean;
+    selectedFilterId: string | null | undefined;
+    dashboardFilters?: DashboardFilter[];
+    dashboardFilterMapping: PortletConfig['dashboardFilterMapping'];
+}): EffectiveFilterField | null;

package/dist/cjs/client/components/dashboardPortletCard/propsEqual.d.ts

@@ -0,0 +1,55 @@
+import { HTMLAttributes, ReactNode, ComponentType, CSSProperties } from 'react';
+import { ChartType, DashboardFilter, DashboardLayoutMode, PortletConfig } from '../../types.js';
+import { ColorPalette } from '../../utils/colorPalettes.js';
+export interface DashboardPortletCardProps {
+    portlet: PortletConfig;
+    editable: boolean;
+    layoutMode?: DashboardLayoutMode;
+    dashboardFilters?: DashboardFilter[];
+    configEagerLoad?: boolean;
+    loadingComponent?: ReactNode;
+    colorPalette?: ColorPalette;
+    containerProps?: HTMLAttributes<HTMLDivElement>;
+    headerProps?: HTMLAttributes<HTMLDivElement>;
+    setPortletRef: (portletId: string, element: HTMLDivElement | null) => void;
+    setPortletComponentRef: (portletId: string, element: {
+        refresh: (options?: {
+            bustCache?: boolean;
+        }) => void;
+    } | null) => void;
+    callbacks: {
+        onToggleFilter: (portletId: string, filterId: string) => void;
+        onRefresh: (portletId: string, options?: {
+            bustCache?: boolean;
+        }) => void;
+        onDuplicate: (portletId: string) => void;
+        onEdit: (portlet: PortletConfig) => void;
+        onDelete: (portletId: string) => void;
+        onOpenFilterConfig: (portlet: PortletConfig) => void;
+    };
+    icons: {
+        RefreshIcon: ComponentType<{
+            className?: string;
+            style?: CSSProperties;
+        }>;
+        EditIcon: ComponentType<{
+            className?: string;
+            style?: CSSProperties;
+        }>;
+        DeleteIcon: ComponentType<{
+            className?: string;
+            style?: CSSProperties;
+        }>;
+        CopyIcon: ComponentType<{
+            className?: string;
+            style?: CSSProperties;
+        }>;
+        FilterIcon: ComponentType<{
+            className?: string;
+            style?: CSSProperties;
+        }>;
+    };
+}
+export type { ChartType };
+export declare function shallowEqualObjects<T extends object>(a: T | undefined, b: T | undefined): boolean;
+export declare function arePropsEqual(prevProps: DashboardPortletCardProps, nextProps: DashboardPortletCardProps): boolean;

package/dist/cjs/client/components/dashboardPortletCard/usePortletCardActions.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+import { PortletDebugDataEntry } from '../../stores/dashboardStore.js';
+export declare function usePortletCardActions(params: {
+    portletTitle: string;
+    debugData?: PortletDebugDataEntry;
+}): {
+    chartContainerRef: React.MutableRefObject<HTMLDivElement | null>;
+    copySuccess: boolean;
+    copyAvailable: boolean;
+    xlsExportAvailable: boolean;
+    exportInProgress: boolean;
+    showCacheBustIndicator: boolean;
+    setIsHoveringRefresh: React.Dispatch<React.SetStateAction<boolean>>;
+    handleExportXlsx: (event: React.MouseEvent | React.TouchEvent) => Promise<void>;
+    handleCopyToClipboard: (event: React.MouseEvent | React.TouchEvent) => Promise<void>;
+};

package/dist/cjs/client/components/portletAnalysisModal/saveValidation.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Save-time validation helpers for PortletAnalysisModal, extracted to keep
+ * the save handler flat.
+ */
+/** True if a (possibly multi/funnel/flow/retention) query has content worth saving. */
+export declare function analysisConfigHasContent(query: any): boolean;
+/** Alert message shown when a query of the given analysis type has no content. */
+export declare function getEmptyContentMessage(analysisType: string): string;

package/dist/cjs/client/components/shared/DateRangeFilter.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { DateRangeFilterProps } from './types.js';
+declare const DateRangeFilter: React.FC<DateRangeFilterProps>;
+export default DateRangeFilter;

package/dist/cjs/client/components/shared/DateRangeSelector.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+interface DateRangeSelectorProps {
+    timeDimension: string;
+    availableTimeDimensions: string[];
+    currentDateRange?: string | string[];
+    onDateRangeChange: (timeDimension: string, dateRange: string | string[]) => void;
+    onTimeDimensionChange: (oldTimeDimension: string, newTimeDimension: string) => void;
+    onRemove: (timeDimension: string) => void;
+    hideFieldSelector?: boolean;
+    hideRemoveButton?: boolean;
+}
+declare const DateRangeSelector: React.FC<DateRangeSelectorProps>;
+export default DateRangeSelector;

package/dist/cjs/client/components/shared/FilterBuilder.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { FilterBuilderProps } from './types.js';
+declare const FilterBuilder: React.FC<FilterBuilderProps>;
+export default FilterBuilder;

package/dist/cjs/client/components/shared/FilterGroup.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { FilterGroupProps } from './types.js';
+declare const FilterGroup: React.FC<FilterGroupProps>;
+export default FilterGroup;

package/dist/cjs/client/components/shared/FilterItem.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { FilterItemProps } from './types.js';
+declare const FilterItem: React.FC<FilterItemProps>;
+export default FilterItem;