drizzle-cube 0.5.8 → 0.6.0

package/dist/client/components/charts/ActivityGridChart.render.d.ts

@@ -0,0 +1,31 @@
+import { GridCell, GridMapping } from './ActivityGridChart.helpers';
+import { ColorPalette } from '../../types';
+import { ChartDataPointClickEvent } from '../../types/drill';
+export interface ActivityGridSafeConfig {
+    showTooltip: boolean;
+    showLabels: boolean;
+    fitToWidth: boolean;
+}
+export interface ActivityGridRenderContext {
+    svgEl: SVGSVGElement;
+    gridData: GridCell[];
+    gridMapping: GridMapping;
+    granularity: string;
+    dimensions: {
+        width: number;
+        height: number;
+    };
+    safeDisplayConfig: ActivityGridSafeConfig;
+    colorPalette?: ColorPalette;
+    isDark: boolean;
+    valueField: string;
+    dateField: string;
+    getFieldLabel: (field: string) => string;
+    drillEnabled?: boolean;
+    onDataPointClick?: (event: ChartDataPointClickEvent) => void;
+}
+/**
+ * Render the activity grid into the given SVG element. Returns a cleanup
+ * function removing the tooltip, or undefined when there is nothing to draw.
+ */
+export declare function renderActivityGrid(ctx: ActivityGridRenderContext): (() => void) | undefined;

package/dist/client/components/charts/AxisFormatControls.d.ts

@@ -29,7 +29,9 @@ interface MultiAxisFormatControlsProps {
     };
 }
 /**
- * Container component for multiple axis format controls
+ * Container component for multiple axis format controls. Each configured axis
+ * renders an `AxisFormatControls`; the per-axis entries are data-driven so the
+ * three branches collapse into a single map.
  */
 export declare function MultiAxisFormatControls({ displayConfig, onChange, showAxes }: MultiAxisFormatControlsProps): import("react").JSX.Element;
 export default AxisFormatControls;

package/dist/client/components/charts/BarChart.helpers.d.ts

@@ -0,0 +1,23 @@
+import { ChartDisplayConfig } from '../../types';
+export interface StackMode {
+    shouldStack: boolean;
+    isPercentStack: boolean;
+}
+/** Derive stacking flags from `stackType` (new) or `stacked` (legacy). */
+export declare function resolveStackMode(displayConfig: ChartDisplayConfig | undefined): StackMode;
+/**
+ * Filter out rows where every series value is null, returning the kept rows and
+ * the number skipped (used to render the "N hidden" footer note).
+ */
+export declare function filterEmptyRows(transformedData: Record<string, any>[], seriesKeys: string[]): {
+    chartData: Record<string, any>[];
+    skippedCount: number;
+};
+export interface BarColoringMode {
+    /** Single series with mixed positive/negative values → green/red bars. */
+    usePositiveNegativeColoring: boolean;
+    /** Single measure, no series dimension, multiple categories → colour per category. */
+    useColorByCategory: boolean;
+}
+/** Decide which special per-bar colouring mode (if any) applies. */
+export declare function resolveBarColoringMode(seriesKeys: string[], chartData: Record<string, any>[], seriesFieldsLength: number): BarColoringMode;

package/dist/client/components/charts/BarSeries.d.ts

@@ -0,0 +1,29 @@
+import { default as React } from 'react';
+import { ColorPalette } from '../../types';
+import { ChartDataPointClickEvent } from '../../types/drill';
+interface BarSeriesProps {
+    seriesKey: string;
+    index: number;
+    /** Original field name backing this series key (for axis assignment + drill). */
+    originalField: string | undefined;
+    axisId: 'left' | 'right';
+    stackId: string | undefined;
+    chartData: Record<string, any>[];
+    enhancedChartData: Record<string, any>[];
+    colorPalette?: ColorPalette;
+    hoveredLegend: string | null;
+    usePositiveNegativeColoring: boolean;
+    useColorByCategory: boolean;
+    drillEnabled?: boolean;
+    onDataPointClick?: (event: ChartDataPointClickEvent) => void;
+}
+/**
+ * Single `<Bar>` for a series key.
+ *
+ * Encapsulates the per-bar colouring modes (positive/negative, colour-by-category)
+ * and the drill click handler that were previously inlined in BarChart's render.
+ * Returned as a fragment-bearing component so it can be used directly inside the
+ * Recharts `<ComposedChart>` children list. Behaviour is identical to the original.
+ */
+export declare function BarSeries({ seriesKey, index, originalField, axisId, stackId, chartData, enhancedChartData, colorPalette, hoveredLegend, usePositiveNegativeColoring, useColorByCategory, drillEnabled, onDataPointClick }: BarSeriesProps): React.JSX.Element;
+export {};

package/dist/client/components/charts/BubbleChart.helpers.d.ts

@@ -0,0 +1,43 @@
+import { AxisFormatConfig, ChartAxisConfig, ChartDisplayConfig, CubeQuery } from '../../types';
+export interface BubbleData {
+    x: number;
+    xLabel?: string;
+    y: number;
+    size: number;
+    color?: string | number;
+    label: string;
+    series?: string;
+}
+export interface BubbleDisplayOptions {
+    showLegend: boolean;
+    showGrid: boolean;
+    showTooltip: boolean;
+    minBubbleSize: number;
+    maxBubbleSize: number;
+    bubbleOpacity: number;
+    xAxisFormat?: AxisFormatConfig;
+    leftYAxisFormat?: AxisFormatConfig;
+}
+/** Resolve bubble display options with defaults from the display config. */
+export declare function resolveBubbleDisplayOptions(displayConfig: ChartDisplayConfig | undefined): BubbleDisplayOptions;
+export interface BubbleFields {
+    xAxisField: string;
+    yAxisField: string;
+    seriesField: string;
+    sizeFieldName: string;
+    colorFieldName?: string;
+}
+/** Resolve the bubble chart field names; returns null when required fields missing. */
+export declare function resolveBubbleFields(chartConfig: ChartAxisConfig | undefined): BubbleFields | null;
+/**
+ * Transform query rows into bubble data, filtering out points with invalid
+ * x/y coordinates or non-positive size. Mirrors the original inline map+filter.
+ */
+export declare function transformBubbleData(data: Record<string, any>[], fields: BubbleFields, queryObject: CubeQuery | undefined): BubbleData[];
+/** Read a CSS custom property from the document root with a fallback. */
+export declare function getThemeColor(varName: string, fallback: string): string;
+/** Resolve text + grid colours for the current theme. */
+export declare function resolveThemeColors(isDark: boolean): {
+    textColor: string;
+    gridColor: string;
+};

package/dist/client/components/charts/BubbleChart.render.d.ts

@@ -0,0 +1,21 @@
+import { BubbleData, BubbleDisplayOptions, BubbleFields } from './BubbleChart.helpers';
+import { ColorPalette, CubeQuery } from '../../types';
+export interface BubbleRenderContext {
+    svgEl: SVGSVGElement;
+    bubbleData: BubbleData[];
+    fields: BubbleFields;
+    options: BubbleDisplayOptions;
+    dimensions: {
+        width: number;
+        height: number;
+    };
+    queryObject: CubeQuery | undefined;
+    colorPalette?: ColorPalette;
+    isDark: boolean;
+    getFieldLabel: (field: string) => string;
+}
+/**
+ * Render the bubble chart into the given SVG element. Returns a cleanup function
+ * that removes the floating tooltip. Returns undefined when there is nothing to draw.
+ */
+export declare function renderBubbleChart(ctx: BubbleRenderContext): (() => void) | undefined;

package/dist/client/components/charts/ChartStates.d.ts

@@ -0,0 +1,38 @@
+import { default as React } from 'react';
+/**
+ * Shared guard/state components for chart rendering.
+ *
+ * Cartesian charts (bar, line, area, pie, …) all duplicated the same
+ * centred flex blocks for their empty / config-error / render-error states,
+ * differing only in the hint text. These components own the duplicated wrapper
+ * JSX; each chart supplies its own already-resolved `hint` (a translation key
+ * resolved via `t()`, or a literal string) so per-chart messaging is preserved.
+ */
+interface ChartStateProps {
+    height?: string | number;
+    /** Already-resolved hint text (caller resolves its own i18n key) */
+    hint?: React.ReactNode;
+}
+/**
+ * Empty / no-data state (muted styling). `titleKey` defaults to the generic
+ * "No data available" heading but can be overridden (e.g. for the post-transform
+ * "No valid data" state).
+ */
+export declare function ChartEmptyState({ height, hint, titleKey }: ChartStateProps & {
+    titleKey?: string;
+}): React.JSX.Element;
+/**
+ * Invalid-configuration state (warning styling). Title is always
+ * "Configuration Error"; the chart supplies a hint describing what is missing.
+ */
+export declare function ChartConfigError({ height, hint }: ChartStateProps): React.JSX.Element;
+/**
+ * Render-error state (error styling), used in chart `catch` blocks.
+ */
+export declare function ChartRenderError({ height, chartType, error }: {
+    height?: string | number;
+    /** Display name used in the "{chartType} Error" heading */
+    chartType: string;
+    error: unknown;
+}): React.JSX.Element;
+export {};

package/dist/client/components/charts/FunnelChart.helpers.d.ts

@@ -0,0 +1,25 @@
+import { ChartDisplayConfig } from '../../types';
+import { FunnelChartData } from '../../types/funnel';
+/** Check if data is already in funnel data format. */
+export declare function isFunnelData(data: unknown[]): data is FunnelChartData[];
+/**
+ * Render time metrics based on config options - returns array of lines for
+ * vertical stacking.
+ */
+export declare function getTimeMetricsLines(step: FunnelChartData, showAvg: boolean, showMedian: boolean, showP90: boolean): string[];
+/** Coerce arbitrary query rows into FunnelChartData by probing field names. */
+export declare function toFunnelData(data: unknown[]): FunnelChartData[];
+export interface FunnelDisplayOptions {
+    customStepLabels?: string[];
+    isVertical: boolean;
+    funnelStyle: NonNullable<ChartDisplayConfig['funnelStyle']>;
+    showConversion: boolean;
+    showAvgTime: boolean;
+    showMedianTime: boolean;
+    showP90Time: boolean;
+    hideSummaryFooter: boolean;
+}
+/** Resolve every funnel display option (with backward-compat for time metrics). */
+export declare function resolveFunnelDisplayOptions(displayConfig: ChartDisplayConfig | undefined): FunnelDisplayOptions;
+/** Color for a funnel step (cyclic over the palette or the default funnel gradient). */
+export declare function getStepColor(index: number, colorPalette: string[]): string;

package/dist/client/components/charts/FunnelViews.d.ts

@@ -0,0 +1,16 @@
+import { FunnelChartData } from '../../types/funnel';
+import { FunnelDisplayOptions } from './FunnelChart.helpers';
+interface FunnelViewProps {
+    funnelData: FunnelChartData[];
+    firstStepValue: number;
+    paletteColors: string[];
+    options: FunnelDisplayOptions;
+    height: string | number;
+}
+/** Recharts trapezoid funnel style. */
+export declare function FunnelShapeView({ funnelData, firstStepValue, paletteColors, options, height }: FunnelViewProps): import("react").JSX.Element;
+/** Vertical bars (steps laid out horizontally, bars grow bottom-to-top). */
+export declare function FunnelVerticalView({ funnelData, firstStepValue, paletteColors, options, height }: FunnelViewProps): import("react").JSX.Element;
+/** Horizontal bars (default - steps stacked vertically, bars grow left-to-right). */
+export declare function FunnelHorizontalView({ funnelData, firstStepValue, paletteColors, options, height }: FunnelViewProps): import("react").JSX.Element;
+export {};

package/dist/client/components/charts/HeatMapCanvas.d.ts

@@ -0,0 +1,25 @@
+import { HeatMapDisplayOptions } from './HeatMapChart.helpers';
+interface HeatMapDatum {
+    x: string;
+    y: number | null;
+}
+interface HeatMapSerie {
+    id: string;
+    data: HeatMapDatum[];
+}
+interface HeatMapCanvasProps {
+    data: HeatMapSerie[];
+    truncated: boolean;
+    colors: string[];
+    options: HeatMapDisplayOptions;
+    xAxisField: string;
+    yAxisField: string;
+    valueField: string;
+}
+/**
+ * The nivo `<ResponsiveHeatMap>` for HeatMapChart, with all axis/legend/colour
+ * config resolved from helpers. Extracted so the chart component stays a thin
+ * orchestrator. Behaviour matches the original inline JSX.
+ */
+export declare function HeatMapCanvas({ data, truncated, colors, options, xAxisField, yAxisField, valueField, }: HeatMapCanvasProps): import("react").JSX.Element;
+export {};

package/dist/client/components/charts/HeatMapChart.helpers.d.ts

@@ -0,0 +1,64 @@
+import { AxisFormatConfig, ChartDisplayConfig } from '../../types';
+/**
+ * Maximum dimensions for heatmap to prevent browser lockup. 50x50 = 2500 cells.
+ */
+export declare const MAX_HEATMAP_ROWS = 50;
+export declare const MAX_HEATMAP_COLS = 50;
+/** Parse color string (hex or rgb) to RGB values. */
+export declare function parseColor(color: string): {
+    r: number;
+    g: number;
+    b: number;
+} | null;
+/** Relative luminance of a color (0 black .. 1 white) per WCAG. */
+export declare function getLuminance(color: string): number;
+/** Contrasting text color (white or dark) based on a background color. */
+export declare function getContrastingTextColor(bgColor: string): string;
+interface HeatMapDatum {
+    x: string;
+    y: number | null;
+}
+interface HeatMapSerie {
+    id: string;
+    data: HeatMapDatum[];
+}
+export interface HeatMapTransformResult {
+    data: HeatMapSerie[];
+    truncated: boolean;
+    originalRows: number;
+    originalCols: number;
+}
+/**
+ * Transform drizzle-cube flat query results to nivo heatmap format.
+ *
+ * Groups rows by the Y dimension, sorts X chronologically when possible, and
+ * truncates to MAX_HEATMAP_ROWS x MAX_HEATMAP_COLS to prevent browser lockup.
+ */
+export declare function transformToHeatMapFormat(data: Record<string, unknown>[], xAxisField: string | undefined, yAxisField: string | undefined, valueField: string | undefined, xGranularity?: string, yGranularity?: string): HeatMapTransformResult;
+/** Coerce an axis config value (string | array | undefined) to a single field. */
+export declare function firstField(value: string | string[] | undefined): string | undefined;
+export interface HeatMapDisplayOptions {
+    showLabels: boolean;
+    cellShape: 'rect' | 'circle';
+    showLegend: boolean;
+    xAxisFormat?: AxisFormatConfig;
+    yAxisFormat?: AxisFormatConfig;
+    valueFormat?: AxisFormatConfig;
+}
+/** Resolve heatmap display options from the (loosely-typed) display config. */
+export declare function resolveHeatMapDisplayOptions(displayConfig: ChartDisplayConfig | undefined): HeatMapDisplayOptions;
+/** Build an axis `format` fn that applies the given axis format config (or none). */
+export declare function makeAxisFormatter(format: AxisFormatConfig | undefined): ((v: string | number) => string) | undefined;
+/** Resolve the heatmap value formatter (custom format or nivo default). */
+export declare function makeValueFormatter(valueFormat: AxisFormatConfig | undefined): ((v: number) => string) | string;
+/** Sequential colours config for nivo; falls back to a built-in scheme. */
+export declare function resolveHeatMapColors(colors: string[]): {
+    type: 'sequential';
+    colors: [string, string];
+} | {
+    type: 'sequential';
+    scheme: 'greens';
+};
+/** Default sequential blue gradient when no palette gradient is supplied. */
+export declare const DEFAULT_HEATMAP_COLORS: string[];
+export {};

package/dist/client/components/charts/KpiDelta.helpers.d.ts

@@ -0,0 +1,20 @@
+import { ChartAxisConfig } from '../../types';
+/** Coerce a config axis value (string | array | undefined) to a field list. */
+export declare function toFieldList(axis: ChartAxisConfig['yAxis']): string[];
+/** Sort rows ascending by the dimension field (stable when absent). */
+export declare function sortByDimension<T extends Record<string, any>>(data: T[], dimensionField: string | undefined): T[];
+/** Extract finite numeric values for a field. */
+export declare function extractNumericValues(rows: Record<string, any>[], valueField: string): number[];
+export interface DeltaStats {
+    lastValue: number;
+    absoluteChange: number;
+    percentageChange: number;
+    isPositiveChange: boolean;
+}
+/** Compute last value + delta vs the previous value. Requires >= 2 values. */
+export declare function computeDelta(values: number[]): DeltaStats;
+/**
+ * Resolve a palette colour by index, falling back to a default. Used for both
+ * the positive and negative delta colours.
+ */
+export declare function resolvePaletteColor(colorIndex: number | undefined, colors: string[] | undefined, fallback: string): string;

package/dist/client/components/charts/KpiNumber.helpers.d.ts

@@ -0,0 +1,30 @@
+import { ChartAxisConfig, ChartDisplayConfig } from '../../types';
+/** Extract the value field list from chart config (string | array | undefined). */
+export declare function getKpiValueFields(yAxis: ChartAxisConfig['yAxis']): string[];
+/** Sort rows ascending by the time-dimension field (stable when absent). */
+export declare function sortKpiData<T extends Record<string, any>>(data: T[] | undefined, timeDimensionField: string | undefined): T[];
+/**
+ * Extract numeric values for the configured field, falling back to the first
+ * numeric field on each row when the configured field is absent.
+ */
+export declare function extractKpiValues(dataToUse: Record<string, any>[], valueField: string): number[];
+/** Compute avg/min/max over a numeric series (0s when empty). */
+export declare function computeKpiStats(values: number[]): {
+    avg: number;
+    min: number;
+    max: number;
+};
+/**
+ * Format a numeric KPI value with thousands/millions/billions suffixes,
+ * honouring a custom `formatValue`, `decimals` and `prefix` from displayConfig.
+ */
+export declare function formatKpiNumber(value: number | null | undefined, displayConfig: ChartDisplayConfig): string;
+/**
+ * Resolve the label to display for a KPI field: prefer the resolved field label,
+ * but fall back to the raw field name when the label looks empty/too short.
+ */
+export declare function resolveDisplayLabel(label: string | undefined, fieldName: string): string;
+/** Resolve the main value colour from the palette / displayConfig overrides. */
+export declare function resolveValueColor(valueColorIndex: number | undefined, colors: string[] | undefined): string;
+/** Resolve the variance colour (green/red based on sign), with palette overrides. */
+export declare function resolveVarianceColor(variance: number | null, positiveColorIndex: number | undefined, negativeColorIndex: number | undefined, colors: string[] | undefined): string;

package/dist/client/components/charts/KpiStates.d.ts

@@ -0,0 +1,19 @@
+import { default as React } from 'react';
+type KpiStateVariant = 'muted' | 'danger' | 'warning';
+/** Resolve the shared `height`/`minHeight` style used by every KPI card state. */
+export declare function kpiHeightStyle(height: string | number): React.CSSProperties;
+/**
+ * Centred KPI state card (no-data / config-error / insufficient-data).
+ *
+ * Owns the duplicated centred flex wrapper shared by KpiNumber and KpiDelta.
+ * Callers supply already-resolved title/hint text (i18n resolved at the call
+ * site) plus an optional colour variant and extra children.
+ */
+export declare function KpiCenteredState({ height, title, hint, variant, children }: {
+    height: string | number;
+    title: React.ReactNode;
+    hint?: React.ReactNode;
+    variant?: KpiStateVariant;
+    children?: React.ReactNode;
+}): React.JSX.Element;
+export {};

package/dist/client/components/charts/ScatterChart.helpers.d.ts

@@ -0,0 +1,43 @@
+import { CHART_MARGINS } from '../../utils/chartConstants';
+import { AxisFormatConfig, ChartAxisConfig, ChartDisplayConfig, CubeQuery } from '../../types';
+export interface ScatterRenderState {
+    showLegend: boolean;
+    showGrid: boolean;
+    showTooltip: boolean;
+    /** Whether to render one Scatter per series group vs a single series. */
+    hasSeries: boolean;
+    xAxisFormat?: AxisFormatConfig;
+    /** For scatter charts the y-axis uses the left-axis format config. */
+    yAxisFormat?: AxisFormatConfig;
+    chartMargins: typeof CHART_MARGINS;
+}
+/**
+ * Resolve all render-time display flags, axis formats and margins for the
+ * scatter chart from the display config and the transformed series keys.
+ */
+export declare function resolveScatterRenderState(displayConfig: ChartDisplayConfig | undefined, seriesKeys: string[]): ScatterRenderState;
+export interface ScatterAxisFields {
+    xAxisField: string;
+    yAxisField: string;
+    seriesFields: string[];
+    /** Set when the config is invalid (no usable axis fields). */
+    errorCode?: 'axisInvalid' | 'axisFields';
+}
+/** Resolve x/y/series fields supporting both the new and legacy config shapes. */
+export declare function resolveScatterAxisFields(chartConfig: ChartAxisConfig | undefined): ScatterAxisFields;
+export interface ScatterPoint {
+    x: number;
+    y: number;
+    name: string;
+    timeValues: Record<string, string>;
+    originalItem: Record<string, any>;
+}
+export interface ScatterTransform {
+    scatterData: ScatterPoint[];
+    seriesGroups: Record<string, ScatterPoint[]>;
+}
+/**
+ * Transform rows into scatter points, grouping by series when configured.
+ * Null x/y coordinates are filtered out. Mirrors the original two-branch logic.
+ */
+export declare function transformScatterData(data: Record<string, any>[], xAxisField: string, yAxisField: string, seriesFields: string[], timeDimensionFields: string[], queryObject: CubeQuery | undefined): ScatterTransform;

package/dist/client/components/charts/ScatterSeries.d.ts

@@ -0,0 +1,17 @@
+import { ColorPalette } from '../../types';
+import { ScatterPoint } from './ScatterChart.helpers';
+interface ScatterSeriesProps {
+    hasSeries: boolean;
+    seriesKeys: string[];
+    seriesGroups: Record<string, ScatterPoint[]>;
+    scatterData: ScatterPoint[];
+    colorPalette?: ColorPalette;
+    hoveredLegend: string | null;
+}
+/**
+ * Renders the `<Scatter>` series for ScatterChart — one per series group when
+ * `hasSeries`, otherwise a single series. Returned as a fragment so it composes
+ * inside the Recharts chart children. Behaviour matches the original inline JSX.
+ */
+export declare function ScatterSeries({ hasSeries, seriesKeys, seriesGroups, scatterData, colorPalette, hoveredLegend }: ScatterSeriesProps): import("react").JSX.Element;
+export {};

package/dist/client/components/charts/ScatterTooltip.d.ts

@@ -0,0 +1,21 @@
+import { AxisFormatConfig } from '../../types';
+import { ScatterPoint } from './ScatterChart.helpers';
+interface ScatterTooltipProps {
+    active?: boolean;
+    payload?: Array<{
+        payload?: ScatterPoint;
+    }>;
+    xAxisField: string;
+    yAxisField: string;
+    xAxisFormat?: AxisFormatConfig;
+    yAxisFormat?: AxisFormatConfig;
+    getFieldLabel: (field: string) => string;
+}
+/**
+ * Custom Recharts tooltip content for ScatterChart.
+ *
+ * Extracted from the inline `content` render prop to keep the chart body lean.
+ * Renders the point name, any time-dimension values, and the formatted x/y.
+ */
+export declare function ScatterTooltip({ active, payload, xAxisField, yAxisField, xAxisFormat, yAxisFormat, getFieldLabel }: ScatterTooltipProps): import("react").JSX.Element | null;
+export {};

package/dist/client/components/charts/TreeMapChart.helpers.d.ts

@@ -0,0 +1,37 @@
+import { AxisFormatConfig, ChartAxisConfig, ColorPalette, CubeQuery } from '../../types';
+export interface TreemapDatum {
+    name: string;
+    size: number;
+    fill?: string;
+    series?: string;
+    [key: string]: unknown;
+}
+export interface TreemapBuildResult {
+    treemapData: TreemapDatum[];
+    isNumericSeries: boolean;
+    seriesField?: string;
+}
+/**
+ * Build treemap data (config or auto-detect), then drop non-positive sizes.
+ * Returns `null` when the legacy path can't find a usable size field.
+ */
+export declare function buildTreemapData(data: Record<string, any>[], chartConfig: ChartAxisConfig | undefined, queryObject: CubeQuery | undefined, colorPalette: ColorPalette | undefined): TreemapBuildResult | null;
+/** Min/max of the (numeric) series field across the raw rows. */
+export declare function seriesMinMax(data: Record<string, any>[], seriesField: string): {
+    min: number;
+    max: number;
+};
+/** Format a numeric value with the optional axis format (or `.toFixed(2)`). */
+export declare function formatSeriesValue(value: number, format: AxisFormatConfig | undefined): string;
+export interface LegendEntry {
+    value: string;
+    type: 'rect';
+    color: string;
+}
+/**
+ * Build the legend entries for the treemap: a gradient ramp for numeric series,
+ * or discrete swatches for categorical series. Empty when not applicable.
+ */
+export declare function buildTreemapLegend(data: Record<string, any>[], treemapData: TreemapDatum[], showLegend: boolean, seriesField: string | undefined, isNumericSeries: boolean, leftYAxisFormat: AxisFormatConfig | undefined): LegendEntry[];
+/** Adjust the outer container height to make room for a legend, if present. */
+export declare function adjustHeightForLegend(height: string | number, hasLegend: boolean): string | number;

package/dist/client/components/charts/TreeMapContent.d.ts

@@ -0,0 +1,24 @@
+import { default as React } from 'react';
+import { AxisFormatConfig, ChartAxisConfig, ColorPalette, CubeQuery } from '../../types';
+import { ChartDataPointClickEvent } from '../../types/drill';
+import { TreemapDatum } from './TreeMapChart.helpers';
+interface TreeMapContentOptions {
+    treemapData: TreemapDatum[];
+    colorPalette?: ColorPalette;
+    hoveredIndex: number | null;
+    setHoveredIndex: (index: number | null) => void;
+    leftYAxisFormat?: AxisFormatConfig;
+    drillEnabled?: boolean;
+    onDataPointClick?: (event: ChartDataPointClickEvent) => void;
+    queryObject?: CubeQuery;
+    chartConfig?: ChartAxisConfig;
+}
+/**
+ * Build the Recharts `content` renderer for treemap cells.
+ *
+ * Encapsulates the per-cell rect + foreignObject overlay, hover state and drill
+ * click handler that previously lived inline in TreeMapChart (the highest-
+ * complexity hot spots). Behaviour is identical to the original.
+ */
+export declare function makeTreeMapContent({ treemapData, colorPalette, hoveredIndex, setHoveredIndex, leftYAxisFormat, drillEnabled, onDataPointClick, queryObject, chartConfig, }: TreeMapContentOptions): (props: any) => React.JSX.Element | null;
+export {};

package/dist/client/components/charts/TreeMapLegend.d.ts

@@ -0,0 +1,13 @@
+import { AxisFormatConfig } from '../../types';
+import { LegendEntry } from './TreeMapChart.helpers';
+interface TreeMapLegendProps {
+    isNumericSeries: boolean;
+    seriesField?: string;
+    seriesLabel: string;
+    legendPayload: LegendEntry[];
+    data: Record<string, any>[];
+    leftYAxisFormat?: AxisFormatConfig;
+}
+/** Treemap legend wrapper — gradient for numeric series, swatches otherwise. */
+export declare function TreeMapLegend({ isNumericSeries, seriesField, seriesLabel, legendPayload, data, leftYAxisFormat, }: TreeMapLegendProps): import("react").JSX.Element;
+export {};