drizzle-cube 0.6.1 → 0.6.3

package/dist/cjs/client/types.d.ts

@@ -0,0 +1,600 @@
+import { ReactNode } from 'react';
+import { ColorPalette } from './utils/colorPalettes.js';
+import { FunnelBindingKey } from './types/funnel.js';
+import { FlowChartData } from './types/flow.js';
+import { RetentionChartData } from './types/retention.js';
+export type TimeGranularity = 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
+export interface CubeMetaMeasure {
+    name: string;
+    title: string;
+    shortTitle: string;
+    type: string;
+    /** Dimension names shown when drilling into this measure */
+    drillMembers?: string[];
+}
+export interface CubeMetaDimension {
+    name: string;
+    title: string;
+    shortTitle: string;
+    type: string;
+    /** Supported granularities for time dimensions (for time-based drill-down) */
+    granularities?: TimeGranularity[];
+}
+export interface CubeMetaField {
+    name: string;
+    title: string;
+    shortTitle: string;
+    type: string;
+}
+export interface CubeMetaRelationship {
+    targetCube: string;
+    relationship: 'belongsTo' | 'hasOne' | 'hasMany' | 'belongsToMany';
+    joinFields?: Array<{
+        sourceField: string;
+        targetField: string;
+    }>;
+}
+/**
+ * Hierarchy metadata for structured drill-down paths
+ */
+export interface CubeMetaHierarchy {
+    /** Unique identifier for the hierarchy */
+    name: string;
+    /** Display title for the hierarchy */
+    title: string;
+    /** Cube name this hierarchy belongs to */
+    cubeName: string;
+    /** Full dimension names in order from least to most granular */
+    levels: string[];
+}
+export interface CubeMetaCube {
+    name: string;
+    title: string;
+    description?: string;
+    measures: CubeMetaMeasure[];
+    dimensions: CubeMetaDimension[];
+    segments: CubeMetaField[];
+    relationships?: CubeMetaRelationship[];
+    /** Hierarchies for structured drill-down paths */
+    hierarchies?: CubeMetaHierarchy[];
+    /** Additional cube metadata (e.g., eventStream configuration for funnel queries) */
+    meta?: {
+        eventStream?: {
+            bindingKey: string;
+            timeDimension: string;
+        };
+        [key: string]: any;
+    };
+}
+export interface CubeMeta {
+    cubes: CubeMetaCube[];
+}
+export type FieldLabelMap = Record<string, string>;
+export type { ColorPalette } from './utils/colorPalettes.js';
+export type BuiltInChartType = 'line' | 'bar' | 'pie' | 'table' | 'area' | 'scatter' | 'radar' | 'radialBar' | 'treemap' | 'bubble' | 'activityGrid' | 'kpiNumber' | 'kpiDelta' | 'kpiText' | 'markdown' | 'funnel' | 'sankey' | 'sunburst' | 'heatmap' | 'retentionHeatmap' | 'retentionCombined' | 'boxPlot' | 'waterfall' | 'candlestick' | 'measureProfile' | 'gauge';
+export type ChartType = BuiltInChartType | (string & {});
+export interface AxisFormatConfig {
+    label?: string;
+    unit?: 'currency' | 'percent' | 'number' | 'custom';
+    abbreviate?: boolean;
+    decimals?: number;
+    customPrefix?: string;
+    customSuffix?: string;
+}
+export interface ChartAxisConfig {
+    xAxis?: string[];
+    yAxis?: string[];
+    series?: string[];
+    sizeField?: string;
+    colorField?: string;
+    dateField?: string[];
+    valueField?: string[];
+    x?: string;
+    y?: string[];
+    yAxisAssignment?: Record<string, 'left' | 'right'>;
+}
+export interface ThresholdBand {
+    value: number;
+    color: string;
+}
+export interface ChartDisplayConfig {
+    showLegend?: boolean;
+    showGrid?: boolean;
+    showTooltip?: boolean;
+    colors?: string[];
+    orientation?: 'horizontal' | 'vertical';
+    stacked?: boolean;
+    stackType?: 'none' | 'normal' | 'percent';
+    connectNulls?: boolean;
+    showAllXLabels?: boolean;
+    hideHeader?: boolean;
+    innerRadius?: string;
+    minBubbleSize?: number;
+    maxBubbleSize?: number;
+    bubbleOpacity?: number;
+    showLabels?: boolean;
+    fitToWidth?: boolean;
+    pivotTimeDimension?: boolean;
+    target?: string;
+    template?: string;
+    prefix?: string;
+    suffix?: string;
+    decimals?: number;
+    formatValue?: (value: number | null | undefined) => string;
+    valueColor?: string;
+    valueColorIndex?: number;
+    positiveColorIndex?: number;
+    negativeColorIndex?: number;
+    showHistogram?: boolean;
+    useLastCompletePeriod?: boolean;
+    skipLastPeriod?: boolean;
+    content?: string;
+    accentColorIndex?: number;
+    fontSize?: 'small' | 'medium' | 'large';
+    alignment?: 'left' | 'center' | 'right';
+    transparentBackground?: boolean;
+    autoHeight?: boolean;
+    accentBorder?: 'none' | 'left' | 'top' | 'bottom';
+    xAxisFormat?: AxisFormatConfig;
+    leftYAxisFormat?: AxisFormatConfig;
+    rightYAxisFormat?: AxisFormatConfig;
+    /**
+     * How to display compared periods:
+     * - 'separate': Each period as distinct series with different colors (default)
+     * - 'overlay': Periods aligned by day-of-period index with ghost styling for prior periods
+     */
+    comparisonMode?: 'separate' | 'overlay';
+    /** Line style for prior periods in overlay mode */
+    priorPeriodStyle?: 'solid' | 'dashed' | 'dotted';
+    /** Opacity for prior period lines (0-1), default: 0.5 */
+    priorPeriodOpacity?: number;
+    /** Include period labels in legend */
+    showPeriodLabels?: boolean;
+    /** Custom labels for funnel steps (array indexed by step, e.g., ["Signup", "Activation", "Purchase"]) */
+    funnelStepLabels?: string[];
+    /** Hide the summary footer in funnel charts */
+    hideSummaryFooter?: boolean;
+    /** Funnel orientation: horizontal (bars left to right) or vertical (bars bottom to top) */
+    funnelOrientation?: 'horizontal' | 'vertical';
+    /** @deprecated Use showFunnelAvgTime, showFunnelMedianTime, showFunnelP90Time instead */
+    showFunnelTimeMetrics?: boolean;
+    /** Funnel visualization style: 'bars' (horizontal bars) or 'funnel' (trapezoid funnel shape) */
+    funnelStyle?: 'bars' | 'funnel';
+    /** Show step-to-step conversion rate (default: true) */
+    showFunnelConversion?: boolean;
+    /** Show average time-to-convert metric in funnel charts */
+    showFunnelAvgTime?: boolean;
+    /** Show median time-to-convert metric in funnel charts */
+    showFunnelMedianTime?: boolean;
+    /** Show P90 time-to-convert metric in funnel charts */
+    showFunnelP90Time?: boolean;
+    /** Retention display mode: line chart, heatmap table, or combined view */
+    retentionDisplayMode?: 'line' | 'heatmap' | 'combined';
+    showTotal?: boolean;
+    showConnectorLine?: boolean;
+    showDataLabels?: boolean;
+    bullColor?: string;
+    bearColor?: string;
+    showWicks?: boolean;
+    rangeMode?: 'ohlc' | 'range';
+    showReferenceLineAtZero?: boolean;
+    lineType?: 'monotone' | 'linear' | 'step';
+    minValue?: number;
+    maxValue?: number;
+    thresholds?: string | ThresholdBand[];
+    showCenterLabel?: boolean;
+    showPercentage?: boolean;
+}
+export interface PortletConfig {
+    id: string;
+    title: string;
+    /**
+     * Canonical format for analysis configuration.
+     * This is the single source of truth for all query/chart config.
+     * New portlets only save this field. Legacy portlets are migrated on-the-fly.
+     */
+    analysisConfig?: import('./types/analysisConfig.js').AnalysisConfig;
+    /** @deprecated Use analysisConfig.query instead */
+    query?: string;
+    /** @deprecated Use analysisConfig.charts[mode].chartType instead */
+    chartType?: ChartType;
+    /** @deprecated Use analysisConfig.charts[mode].chartConfig instead */
+    chartConfig?: ChartAxisConfig;
+    /** @deprecated Use analysisConfig.charts[mode].displayConfig instead */
+    displayConfig?: ChartDisplayConfig;
+    dashboardFilterMapping?: DashboardFilterMapping;
+    eagerLoad?: boolean;
+    /** @deprecated Use analysisConfig.analysisType instead */
+    analysisType?: AnalysisType;
+    /** @deprecated Use analysisConfig for funnel mode */
+    funnelCube?: string | null;
+    /** @deprecated Use analysisConfig for funnel mode */
+    funnelSteps?: FunnelStepState[];
+    /** @deprecated Use analysisConfig for funnel mode */
+    funnelTimeDimension?: string | null;
+    /** @deprecated Use analysisConfig for funnel mode */
+    funnelBindingKey?: FunnelBindingKey | null;
+    /** @deprecated Use analysisConfig for funnel mode */
+    funnelChartType?: ChartType;
+    /** @deprecated Use analysisConfig for funnel mode */
+    funnelChartConfig?: ChartAxisConfig;
+    /** @deprecated Use analysisConfig for funnel mode */
+    funnelDisplayConfig?: ChartDisplayConfig;
+    w: number;
+    h: number;
+    x: number;
+    y: number;
+}
+export type DashboardLayoutMode = 'grid' | 'rows';
+export interface DashboardGridSettings {
+    cols: number;
+    rowHeight: number;
+    minW: number;
+    minH: number;
+}
+export interface RowLayoutColumn {
+    portletId: string;
+    w: number;
+}
+export interface RowLayout {
+    id: string;
+    h: number;
+    columns: RowLayoutColumn[];
+}
+export interface DashboardConfig {
+    portlets: PortletConfig[];
+    layoutMode?: DashboardLayoutMode;
+    grid?: DashboardGridSettings;
+    rows?: RowLayout[];
+    layouts?: {
+        [key: string]: any;
+    };
+    colorPalette?: string;
+    filters?: DashboardFilter[];
+    eagerLoad?: boolean;
+    thumbnailData?: string;
+    thumbnailUrl?: string;
+}
+export type AnalysisType = 'query' | 'funnel' | 'flow' | 'retention';
+/**
+ * State for a single funnel step (dedicated for Funnel mode)
+ * Each step represents a stage in the funnel with its own cube and filters
+ */
+export interface FunnelStepState {
+    /** Unique step identifier */
+    id: string;
+    /** Display name for the step (e.g., "Signup", "Purchase") */
+    name: string;
+    /** Which cube this step uses (for multi-cube funnels) */
+    cube: string;
+    /** Filters that define which events qualify for this step */
+    filters: Filter[];
+    /** Time window from previous step (ISO 8601 duration, e.g., "P7D" for 7 days) */
+    timeToConvert?: string;
+}
+export type FilterOperator = 'equals' | 'notEquals' | 'contains' | 'notContains' | 'startsWith' | 'notStartsWith' | 'endsWith' | 'notEndsWith' | 'like' | 'notLike' | 'ilike' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'notBetween' | 'in' | 'notIn' | 'arrayContains' | 'arrayOverlaps' | 'arrayContained' | 'set' | 'notSet' | 'isEmpty' | 'isNotEmpty' | 'inDateRange' | 'beforeDate' | 'afterDate' | 'regex' | 'notRegex';
+export interface SimpleFilter {
+    member: string;
+    operator: FilterOperator;
+    values: any[];
+    dateRange?: string | string[];
+}
+export interface GroupFilter {
+    type: 'and' | 'or';
+    filters: Filter[];
+}
+export type Filter = SimpleFilter | GroupFilter;
+export interface DashboardFilter {
+    id: string;
+    label: string;
+    filter: Filter;
+    isUniversalTime?: boolean;
+}
+export interface DashboardFilterMappingEntry {
+    filterId: string;
+    member?: string;
+}
+export type DashboardFilterMapping = Array<string | DashboardFilterMappingEntry>;
+export interface CubeQuery {
+    measures?: string[];
+    dimensions?: string[];
+    timeDimensions?: Array<{
+        dimension: string;
+        granularity?: string;
+        dateRange?: string[] | string;
+        fillMissingDates?: boolean;
+        /**
+         * Array of date ranges for period-over-period comparison.
+         * When specified, queries are executed for each period and results are merged.
+         */
+        compareDateRange?: (string | [string, string])[];
+    }>;
+    filters?: Filter[];
+    order?: {
+        [key: string]: 'asc' | 'desc';
+    };
+    limit?: number;
+    offset?: number;
+    segments?: string[];
+    /** When true, returns raw row-level data without GROUP BY or aggregation */
+    ungrouped?: boolean;
+}
+/**
+ * Merge strategy for combining multiple query results
+ * - 'concat': Append rows with __queryIndex marker (for separate series per query)
+ * - 'merge': Align data by common dimension key (for combined visualization)
+ *
+ * Note: For funnel analysis, use the dedicated funnel mode (analysisType === 'funnel')
+ */
+export type QueryMergeStrategy = 'concat' | 'merge';
+/**
+ * Configuration for multi-query portlets
+ * Detected by presence of 'queries' array property
+ *
+ * Note: For funnel analysis, use the dedicated funnel mode (analysisType === 'funnel')
+ */
+export interface MultiQueryConfig {
+    queries: CubeQuery[];
+    mergeStrategy: QueryMergeStrategy;
+    mergeKeys?: string[];
+    queryLabels?: string[];
+}
+/**
+ * Type guard to detect multi-query configuration
+ */
+export declare function isMultiQueryConfig(obj: unknown): obj is MultiQueryConfig;
+export interface CubeQueryOptions {
+    skip?: boolean;
+    resetResultSetOnChange?: boolean;
+    subscribe?: boolean;
+}
+export interface CubeApiOptions {
+    apiUrl?: string;
+    token?: string;
+    headers?: Record<string, string>;
+    credentials?: 'include' | 'omit' | 'same-origin';
+}
+export interface CubeResultSet {
+    rawData(): any[];
+    tablePivot(): any[];
+    series(): any[];
+    annotation(): any;
+    loadResponse?: any;
+    cacheInfo?(): {
+        hit: true;
+        cachedAt: string;
+        ttlMs: number;
+        ttlRemainingMs: number;
+    } | undefined;
+}
+export interface AnalyticsPortletProps {
+    query: string;
+    chartType: ChartType;
+    chartConfig?: ChartAxisConfig;
+    displayConfig?: ChartDisplayConfig;
+    dashboardFilters?: DashboardFilter[];
+    dashboardFilterMapping?: DashboardFilterMapping;
+    eagerLoad?: boolean;
+    isVisible?: boolean;
+    height?: string | number;
+    title?: string;
+    colorPalette?: ColorPalette;
+    loadingComponent?: ReactNode;
+    onDebugDataReady?: (debugData: {
+        chartConfig: ChartAxisConfig;
+        displayConfig: ChartDisplayConfig;
+        queryObject: any;
+        data: any[] | FlowChartData | RetentionChartData;
+        chartType: ChartType;
+        cacheInfo?: {
+            hit: true;
+            cachedAt: string;
+            ttlMs: number;
+            ttlRemainingMs: number;
+        } | null;
+        drillState?: {
+            isDrilling: boolean;
+            drillPath: Array<{
+                id: string;
+                label: string;
+                clickedValue?: unknown;
+                dimension?: string;
+                granularity?: string;
+                hierarchy?: string;
+            }>;
+            currentDrillDepth: number;
+            originalQuery: any;
+            activeQuery: any;
+        };
+    }) => void;
+}
+export interface AnalyticsDashboardProps {
+    config: DashboardConfig;
+    editable?: boolean;
+    dashboardFilters?: DashboardFilter[];
+    loadingComponent?: ReactNode;
+    onConfigChange?: (config: DashboardConfig) => void;
+    onSave?: (config: DashboardConfig) => Promise<void> | void;
+    onSaveThumbnail?: (thumbnailData: string) => Promise<string | void>;
+    onDirtyStateChange?: (isDirty: boolean) => void;
+}
+export interface ChartProps {
+    data: any[];
+    chartConfig?: ChartAxisConfig;
+    displayConfig?: ChartDisplayConfig;
+    queryObject?: CubeQuery;
+    height?: string | number;
+    colorPalette?: ColorPalette;
+    /** Handler for data point clicks - fires ChartDataPointClickEvent */
+    onDataPointClick?: (event: import('./types/drill.js').ChartDataPointClickEvent) => void;
+    /** Whether drill-down is enabled (shows pointer cursor on clickable elements) */
+    drillEnabled?: boolean;
+}
+export interface ThumbnailFeatureConfig {
+    enabled: boolean;
+    width?: number;
+    height?: number;
+    format?: 'png' | 'jpeg';
+    quality?: number;
+}
+export interface XlsExportFeatureConfig {
+    enabled: boolean;
+    /** Optional prefix for exported filenames (default: portlet title) */
+    filenamePrefix?: string;
+}
+export interface FeaturesConfig {
+    enableAI?: boolean;
+    aiEndpoint?: string;
+    showSchemaDiagram?: boolean;
+    useAnalysisBuilder?: boolean;
+    editToolbar?: 'floating' | 'top' | 'both';
+    floatingToolbarPosition?: 'left' | 'right';
+    thumbnail?: ThumbnailFeatureConfig;
+    manualRefresh?: boolean;
+    xlsExport?: XlsExportFeatureConfig;
+}
+export interface GridLayout {
+    i: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    minW?: number;
+    minH?: number;
+}
+export interface ResponsiveLayout {
+    [breakpoint: string]: GridLayout[];
+}
+export type DashboardDisplayMode = 'desktop' | 'scaled' | 'mobile';
+export type { FunnelBindingKey, FunnelBindingKeyMapping, FunnelStep, FunnelConfig, FunnelStepResult, FunnelExecutionResult, FunnelChartData, FunnelValidationError, FunnelValidationResult, UseFunnelQueryOptions, UseFunnelQueryResult, ServerFunnelQuery, } from './types/funnel.js';
+/**
+ * Type guard to detect server funnel query format
+ * Used to distinguish { funnel: {...} } from CubeQuery or MultiQueryConfig
+ */
+export declare function isServerFunnelQuery(obj: unknown): obj is import('./types/funnel.js').ServerFunnelQuery;
+export type { FlowStartingStep, ServerFlowQuery, FlowQueryConfig, SankeyNode, SankeyLink, FlowResultRow, FlowChartData, FlowSliceState, FlowSliceActions, } from './types/flow.js';
+export { isServerFlowQuery, isSankeyData } from './types/flow.js';
+/**
+ * Options for EXPLAIN query execution
+ */
+export interface ExplainOptions {
+    /** Use EXPLAIN ANALYZE to actually execute the query and get real timing (PostgreSQL, MySQL 8.0.18+) */
+    analyze?: boolean;
+}
+/**
+ * A single operation/node in the query execution plan
+ * Normalized structure across all databases
+ */
+export interface ExplainOperation {
+    /** Operation type (e.g., 'Seq Scan', 'Index Scan', 'Hash Join', 'Sort') */
+    type: string;
+    /** Table name if applicable */
+    table?: string;
+    /** Index name if used */
+    index?: string;
+    /** Estimated row count from planner */
+    estimatedRows?: number;
+    /** Actual row count (if ANALYZE was used) */
+    actualRows?: number;
+    /** Estimated cost (database-specific units) */
+    estimatedCost?: number;
+    /** Filter condition if any */
+    filter?: string;
+    /** Additional details specific to this operation */
+    details?: string;
+    /** Nested/child operations */
+    children?: ExplainOperation[];
+}
+/**
+ * Summary statistics from the execution plan
+ */
+export interface ExplainSummary {
+    /** Database engine type */
+    database: 'postgres' | 'mysql' | 'sqlite';
+    /** Planning time in milliseconds (if available) */
+    planningTime?: number;
+    /** Execution time in milliseconds (if ANALYZE was used) */
+    executionTime?: number;
+    /** Total estimated cost */
+    totalCost?: number;
+    /** Quick flag: true if any sequential scans detected */
+    hasSequentialScans: boolean;
+    /** List of indexes used in the plan */
+    usedIndexes: string[];
+}
+/**
+ * Result of an EXPLAIN query
+ * Provides both normalized structure and raw output
+ */
+export interface ExplainResult {
+    /** Normalized hierarchical plan as operations */
+    operations: ExplainOperation[];
+    /** Summary statistics */
+    summary: ExplainSummary;
+    /** Raw EXPLAIN output as text (for display) */
+    raw: string;
+    /** Original SQL query */
+    sql: {
+        sql: string;
+        params?: unknown[];
+    };
+}
+/**
+ * A recommendation from AI analysis of an execution plan
+ */
+export interface ExplainRecommendation {
+    /** Type of recommendation */
+    type: 'index' | 'table' | 'cube' | 'general';
+    /** Severity/priority of the recommendation */
+    severity: 'critical' | 'warning' | 'suggestion';
+    /** Short actionable title */
+    title: string;
+    /** Detailed explanation of why this helps */
+    description: string;
+    /** Actionable SQL statement (e.g., CREATE INDEX) - for index/table recommendations */
+    sql?: string;
+    /** TypeScript code snippet to add to cube definition - for cube recommendations */
+    cubeCode?: string;
+    /** Which cube to modify - for cube recommendations */
+    cubeName?: string;
+    /** Affected database table */
+    table?: string;
+    /** Affected columns */
+    columns?: string[];
+    /** Expected performance improvement */
+    estimatedImpact?: string;
+}
+/**
+ * Issue identified in the execution plan
+ */
+export interface ExplainIssue {
+    /** Type of issue */
+    type: 'sequential_scan' | 'missing_index' | 'high_cost' | 'sort_operation' | string;
+    /** Description of the issue */
+    description: string;
+    /** Severity level */
+    severity: 'high' | 'medium' | 'low';
+}
+/**
+ * AI-generated analysis of an execution plan
+ */
+export interface AIExplainAnalysis {
+    /** One-sentence description of what the query does */
+    summary: string;
+    /** Overall performance assessment */
+    assessment: 'good' | 'warning' | 'critical';
+    /** Reason for the assessment */
+    assessmentReason: string;
+    /** Detailed explanation of the query's purpose and structure */
+    queryUnderstanding: string;
+    /** Issues identified in the execution plan */
+    issues: ExplainIssue[];
+    /** Actionable recommendations for improvement */
+    recommendations: ExplainRecommendation[];
+    /** Metadata from the AI analysis */
+    _meta?: {
+        model: string;
+        usingUserKey: boolean;
+    };
+}
+export type { ChartDataPointClickEvent, DrillOptionType, DrillScope, DrillOption, DrillPathEntry, DrillResult, UseDrillInteractionOptions, DrillInteraction, DrillMenuProps, DrillBreadcrumbProps, } from './types/drill.js';

package/dist/cjs/client/utils/axisValueFormatting.d.ts

@@ -0,0 +1,32 @@
+import { AxisFormatConfig } from '../types.js';
+/**
+ * Get the currency code for a given locale.
+ * Maps common locales to their default currency.
+ */
+export declare function getCurrencyCodeForLocale(locale: string): string;
+/**
+ * Abbreviation result: the (possibly scaled) display value and its suffix.
+ */
+export interface AbbreviatedValue {
+    displayValue: number;
+    abbreviationSuffix: string;
+}
+/**
+ * Scale a number to a K/M/B abbreviation when `abbreviate` is enabled.
+ */
+export declare function abbreviateValue(num: number, abbreviate: boolean): AbbreviatedValue;
+/**
+ * Resolved formatting parameters shared by the per-unit formatters.
+ */
+export interface AxisFormatParams {
+    displayValue: number;
+    abbreviate: boolean;
+    abbreviationSuffix: string;
+    decimals: number;
+    locale: string;
+    config: AxisFormatConfig;
+}
+/**
+ * Format an abbreviated/scaled value according to its configured unit type.
+ */
+export declare function formatByUnit(params: AxisFormatParams): string;

package/dist/cjs/client/utils/chartConstants.d.ts

@@ -0,0 +1,16 @@
+export declare const CHART_COLORS: string[];
+export declare const CHART_COLORS_GRADIENT: string[];
+export declare const POSITIVE_COLOR = "#10b981";
+export declare const NEGATIVE_COLOR = "#ef4444";
+export declare const CHART_MARGINS: {
+    top: number;
+    right: number;
+    left: number;
+    bottom: number;
+};
+export declare const RESPONSIVE_CHART_MARGINS: {
+    top: number;
+    right: number;
+    left: number;
+    bottom: number;
+};

package/dist/cjs/client/utils/chartUtils.d.ts

@@ -0,0 +1,35 @@
+import { FieldLabelMap, AxisFormatConfig } from '../types.js';
+export declare function isValidNumericValue(value: any): boolean;
+export declare function parseNumericValue(value: any): number | null;
+export declare function formatNumericValue(value: any): string;
+/**
+ * Format a numeric value for axis/tooltip display with configurable formatting
+ *
+ * @param value - The numeric value to format
+ * @param config - Optional formatting configuration
+ * @param locale - Optional locale string (defaults to browser locale)
+ * @returns Formatted string representation of the value
+ *
+ * @example
+ * formatAxisValue(1250000, { unit: 'currency', abbreviate: true }) // "$1.25M"
+ * formatAxisValue(0.75, { unit: 'percent', decimals: 1 }) // "75.0%"
+ * formatAxisValue(1234567, { abbreviate: true, decimals: 2 }) // "1.23M"
+ */
+export declare function formatAxisValue(value: number | null | undefined, config?: AxisFormatConfig, locale?: string): string;
+/**
+ * Create a tick formatter function for Recharts axes
+ * Returns a function that can be used as tickFormatter prop
+ */
+export declare function createAxisTickFormatter(config?: AxisFormatConfig): (value: any) => string;
+export declare function getFieldLabel(fieldName: string, labelMap: FieldLabelMap): string;
+export declare function transformSeriesKeysWithLabels(seriesKeys: string[], labelMap: FieldLabelMap): string[];
+export declare function formatTimeValue(value: any, granularity?: string): string;
+export declare function getFieldGranularity(queryObject: any, fieldName: string): string | undefined;
+export declare function transformChartData(data: any[], xAxisField: string, yAxisFields: string[], queryObject: any, getFieldLabelFn?: (fieldName: string) => string): any[];
+export interface ChartSeriesResult {
+    data: any[];
+    seriesKeys: string[];
+    hasDimensions: boolean;
+}
+export declare function transformChartDataWithSeries(data: any[], xAxisField: string, yAxisFields: string[], queryObject: any, seriesFields?: string[], // New optional parameter for explicit series fields
+getFieldLabelFn?: (fieldName: string) => string): ChartSeriesResult;