drizzle-cube 0.6.0 → 0.6.2

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;

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

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

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

@@ -0,0 +1,40 @@
+import { DateRangeType } from '../../shared/types.js';
+/**
+ * Date preset configuration for compact filter bar
+ */
+export interface DatePreset {
+    id: string;
+    label: string;
+    value: string;
+}
+export declare const DATE_PRESETS: DatePreset[];
+export declare const XTD_OPTIONS: DatePreset[];
+type DateRange = {
+    start: Date;
+    end: Date;
+};
+/**
+ * Calculate actual date range from a preset string
+ * Returns start and end dates for display purposes
+ */
+export declare function calculateDateRange(preset: string): DateRange | null;
+/**
+ * Format a date range for display (e.g., "Jan 1, 2024 - Jan 31, 2024")
+ */
+export declare function formatDateRangeDisplay(start: Date, end: Date): string;
+/**
+ * Detect preset ID from a date range value
+ * Returns the preset ID (e.g., '7d', 'mtd') or 'custom' if not a preset
+ */
+export declare function detectPresetFromDateRange(dateRange: string | string[] | undefined): string | null;
+export interface DerivedRange {
+    rangeType: DateRangeType;
+    /** Present only when the range encodes an explicit "last N" count. */
+    numberValue?: number;
+}
+/**
+ * Resolve the rangeType (and optional numberValue) that corresponds to a
+ * filter's stored `dateRange`. Returns `null` when there is nothing to derive.
+ */
+export declare function deriveRangeFromDateRange(dateRange: string | string[] | undefined): DerivedRange | null;
+export {};

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

@@ -0,0 +1,10 @@
+/**
+ * Filter value formatting utilities for compact chips.
+ *
+ * Split out of `shared/utils.ts` by concern. Re-exported from there to keep
+ * existing import paths stable.
+ */
+/**
+ * Format filter value for display in a compact chip
+ */
+export declare function formatFilterValueDisplay(values: any[], operator: string): string;

package/dist/cjs/client/components/shared/filterItem/FilterDateRangeSelector.d.ts

@@ -0,0 +1,17 @@
+import { DateRangeType } from '../types.js';
+interface FilterDateRangeSelectorProps {
+    rangeType: DateRangeType;
+    selectedRangeLabel: string;
+    numberValue: number;
+    customDates: {
+        startDate: string;
+        endDate: string;
+    };
+    isDropdownOpen: boolean;
+    onDropdownToggle: () => void;
+    onRangeTypeChange: (rangeType: DateRangeType) => void;
+    onCustomDateChange: (field: 'startDate' | 'endDate', value: string) => void;
+    onNumberChange: (value: number) => void;
+}
+export declare function FilterDateRangeSelector({ rangeType, selectedRangeLabel, numberValue, customDates, isDropdownOpen, onDropdownToggle, onRangeTypeChange, onCustomDateChange, onNumberChange }: FilterDateRangeSelectorProps): import("react").JSX.Element;
+export {};

package/dist/cjs/client/components/shared/filterItem/FilterFieldDropdown.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+import { MetaField } from '../types.js';
+interface FilterFieldDropdownProps {
+    isOpen: boolean;
+    selectedField: MetaField | undefined;
+    selectedMember: string | undefined;
+    fieldSearchTerm: string;
+    filteredQueryFields: MetaField[];
+    filteredAllFields: MetaField[];
+    searchInputRef: React.RefObject<HTMLInputElement>;
+    onToggle: () => void;
+    onSearchTermChange: (term: string) => void;
+    onFieldChange: (fieldName: string) => void;
+}
+export declare function FilterFieldDropdown({ isOpen, selectedField, selectedMember, fieldSearchTerm, filteredQueryFields, filteredAllFields, searchInputRef, onToggle, onSearchTermChange, onFieldChange }: FilterFieldDropdownProps): React.JSX.Element;
+export {};

package/dist/cjs/client/components/shared/filterItem/dateRangeSync.d.ts

@@ -0,0 +1,14 @@
+import { DateRangeType } from '../types.js';
+export interface ResolvedDateRangeState {
+    rangeType: DateRangeType;
+    customDates?: {
+        startDate: string;
+        endDate: string;
+    };
+    numberValue?: number;
+}
+/**
+ * Resolve the UI date-range state for a stored filter dateRange.
+ * Returns null when there is nothing to sync.
+ */
+export declare function resolveDateRangeState(dateRange: string | string[] | undefined): ResolvedDateRangeState | null;

package/dist/cjs/client/components/shared/filterItem/fieldVisuals.d.ts

@@ -0,0 +1,5 @@
+import { MetaField } from '../types.js';
+/** Icon for a field based on its type. */
+export declare function getFieldTypeIcon(field: MetaField): import("react").JSX.Element;
+/** Single-letter badge for a field based on its type. */
+export declare function getFieldTypeBadge(field: MetaField): import("react").JSX.Element;