@univerjs-pro/engine-chart 1.0.0-alpha.6 → 1.0.0-alpha.8

package/lib/types/chart-builder/candlestick-inline-table.d.ts

@@ -0,0 +1,4 @@
+import { ChartTypeBits } from '../enum';
+export declare const CANDLESTICK_INLINE_COLUMN_COUNT = 5;
+/** Enforces the fixed Category/Open/High/Low/Close inline-host contract. */
+export declare function normalizeCandlestickInlineTable<T>(chartType: ChartTypeBits, values: T[][]): T[][] | undefined;

package/lib/types/chart-builder/chart-builder-adapter.d.ts

@@ -1,5 +1,5 @@
-import type { IChartRenderModelImageExportOptions, IChartRenderModelImageExportResult, IUniverDataSet } from '../types';
-import type { ChartPendingConfig, IChartDescription, IResolvedChartData } from './chart-types';
+import type { IChartData, IChartRenderModelImageExportOptions, IChartRenderModelImageExportResult, IUniverDataSet } from '../types';
+import type { ChartPendingConfig, IChartDescription } from './chart-types';
 /** Host-owned persistence and rendering capabilities used by a chart builder. */
 export interface IChartBuilderAdapter<THostDescription extends object = object> {
     /** Reads the canonical host description, optionally evaluating pending config against an alternate data set without persisting either. */
@@ -7,7 +7,7 @@ export interface IChartBuilderAdapter<THostDescription extends object = object>
     /** Persists one pending semantic configuration patch. */
     commit(config: ChartPendingConfig): void;
     /** Materializes fresh engine semantic data for the effective pending state without mutating the host. */
-    resolveData(config: ChartPendingConfig): IResolvedChartData;
+    resolveData(config: ChartPendingConfig): IChartData;
     /** Renders the hosted chart as an image when rendering is available. */
     exportImage(options?: IChartRenderModelImageExportOptions): Promise<IChartRenderModelImageExportResult | null>;
 }

package/lib/types/chart-builder/chart-builder.d.ts

@@ -1,8 +1,8 @@
 import type { DeepReadonly } from '@univerjs/core';
 import type { IChartBuilderAdapter } from './chart-builder-adapter';
-import type { ChartPendingConfig, IChartDescription, IResolvedChartData } from './chart-types';
+import type { IChartData, IUniverDataSet } from '../types';
+import type { ChartPendingConfig, IChartDescription } from './chart-types';
 import type { IChartConfigOperation } from './configuration/chart-config-operation';
-import type { IUniverDataSet } from '../types';
 import { ChartTypeString } from './chart-types';
 /** Maintains an immutable chart baseline plus pending semantic configuration changes. */
 export declare class ChartBuilder<THostDescription extends object = object> {
@@ -23,7 +23,7 @@ export declare class ChartBuilder<THostDescription extends object = object> {
     /** Returns a frozen description composed from the baseline and pending state. */
     describe(): DeepReadonly<IChartDescription & THostDescription>;
     /** Materializes a fresh deeply read-only engine data result for this hosted builder. */
-    resolveData(): DeepReadonly<IResolvedChartData>;
+    resolveData(): DeepReadonly<IChartData>;
     /** Persists pending changes through the host adapter and refreshes the baseline. */
     commit(): void;
     protected refreshBaseline(): void;

package/lib/types/chart-builder/chart-color.d.ts

@@ -0,0 +1,49 @@
+/** Stable discriminator used by serializable linear-gradient chart colors. */
+export declare const CHART_LINEAR_GRADIENT_TYPE: "linear-gradient";
+/** A mark-local normalized coordinate used by a chart gradient. */
+export interface IChartGradientPoint {
+    /** Horizontal coordinate, where `0` is the mark's left edge and `1` is its right edge. */
+    x: number;
+    /** Vertical coordinate, where `0` is the mark's top edge and `1` is its bottom edge. */
+    y: number;
+}
+/** One color stop in a serializable chart gradient. */
+export interface IChartGradientStop {
+    /** Position along the gradient vector. Values are forwarded to the renderer. */
+    offset: number;
+    /** CSS color string, including `rgba(...)` when desired. */
+    color: string;
+    /** Optional alpha multiplier applied to the alpha already present in `color`. */
+    opacity?: number;
+}
+/** A mark-local linear gradient with at least two stops. */
+export interface IChartLinearGradient {
+    type: typeof CHART_LINEAR_GRADIENT_TYPE;
+    start: IChartGradientPoint;
+    end: IChartGradientPoint;
+    stops: IChartGradientStop[];
+}
+/** A solid CSS color or a serializable mark-local linear gradient. */
+export type ChartColor = string | IChartLinearGradient;
+/** Input accepted by {@link chartLinearGradient}; the discriminator is added automatically. */
+export type ChartLinearGradientInput = Omit<IChartLinearGradient, 'type'>;
+/**
+ * Creates and validates a serializable linear-gradient chart color.
+ *
+ * @param gradient Gradient coordinates and at least two color stops.
+ * @returns A plain-data gradient carrying the stable chart-color discriminator.
+ * @example
+ * ```ts
+ * import { chartLinearGradient } from '@univerjs-pro/engine-chart';
+ *
+ * const color = chartLinearGradient({
+ *     start: { x: 0, y: 1 },
+ *     end: { x: 0, y: 0 },
+ *     stops: [
+ *         { offset: 0, color: 'rgba(22, 119, 255, 0)' },
+ *         { offset: 1, color: '#1677ff' },
+ *     ],
+ * });
+ * ```
+ */
+export declare function chartLinearGradient(gradient: ChartLinearGradientInput): IChartLinearGradient;

package/lib/types/chart-builder/chart-starter-data.d.ts

@@ -0,0 +1,3 @@
+import { ChartTypeBits } from '../enum';
+/** Returns fresh numeric starter rows for chart types with specialized table semantics. */
+export declare function createChartStarterRows(chartType: ChartTypeBits): number[][] | undefined;

package/lib/types/chart-builder/chart-types.d.ts

@@ -1,6 +1,6 @@
 import type { AreaLineStyle, BarShape, ChartAxisDimension, ChartBorderDashType, ChartMarkLineLabelPosition, ChartSemanticAxis, ChartTrendlineType, ChartWaterfallPointRole, InvalidValueType, IRuntimeAxisPosition, LabelAlignEnum, LabelContentType, LegendPositionEnum, LinePointShape, PieLabelPosition, RadarShape, RelationChartLayoutEnum, SelectModeEnum, SeriesLabelPosition, TitlePositionEnum, WaterfallStackTypeEnum, WordCloudShapeEnum } from '../enum';
-import type { IChartData } from '../types';
-export { ChartAxisDimension, ChartMarkLineLabelPosition, ChartSemanticAxis, ChartWaterfallPointRole } from '../enum';
+import type { DeepNullish, IChartCandlestickMappingSpec, IChartCandlestickSpec, IChartHistogramSpec, IChartTreemapSpec } from '../types';
+import type { ChartColor } from './chart-color';
 /** Canonical semantic chart type names exposed by the chart facade. */
 export declare enum ChartTypeString {
     Line = "line",
@@ -26,7 +26,10 @@ export declare enum ChartTypeString {
     Pareto = "pareto",
     Sankey = "sankey",
     Heatmap = "heatmap",
-    Boxplot = "boxplot"
+    Boxplot = "boxplot",
+    Candlestick = "candlestick",
+    Histogram = "histogram",
+    Treemap = "treemap"
 }
 export declare enum ChartSeriesTypeString {
     Column = "column",
@@ -86,8 +89,8 @@ export interface IChartAxisLabelSpec extends IChartFontSpec {
 }
 export interface IChartAxisSpec {
     title?: string;
-    min?: number | null;
-    max?: number | null;
+    min?: number;
+    max?: number;
     reverse?: boolean;
     line?: {
         visible?: boolean;
@@ -101,7 +104,7 @@ export interface IChartAxisSpec {
         length?: number;
         position?: ChartAxisTickPosition;
     };
-    format?: string | null;
+    format?: string;
     titleStyle?: IChartFontSpec;
     label?: IChartAxisLabelSpec;
     gridLine?: {
@@ -158,7 +161,7 @@ export type ChartSeriesSelector = {
     name: string;
 };
 export interface IChartSeriesBorderSpec {
-    color?: string | null;
+    color?: string;
     width?: number;
     opacity?: number;
     dashType?: ChartBorderDashType;
@@ -166,7 +169,7 @@ export interface IChartSeriesBorderSpec {
 export interface IChartSeriesPointSpec {
     shape?: LinePointShape;
     size?: number;
-    color?: string | null;
+    color?: string;
 }
 export interface IChartSeriesLabelSpec extends IChartFontSpec {
     visible?: boolean;
@@ -178,24 +181,41 @@ export interface IChartHeatmapLabelSpec extends IChartFontSpec {
     position?: SeriesLabelPosition;
 }
 export interface IChartSeriesStyleSpec {
-    color?: string;
+    color?: ChartColor;
     fillOpacity?: number;
     border?: IChartSeriesBorderSpec;
     point?: IChartSeriesPointSpec;
     rightAxis?: boolean;
     label?: IChartSeriesLabelSpec;
 }
+/** Style fields accepted by fill-capable chart data points. */
+export interface IChartSeriesDataPointStyleSpec {
+    shape?: LinePointShape;
+    size?: number;
+    color?: ChartColor;
+    fillOpacity?: number;
+}
+/** Style fields accepted by symbol data points, whose color remains solid-only. */
+export interface IChartSymbolDataPointStyleSpec extends Omit<IChartSeriesDataPointStyleSpec, 'color'> {
+    color?: string;
+}
 export interface IChartSeriesPatch extends IChartSeriesStyleSpec {
     selector: ChartSeriesSelector;
     type?: ChartSeriesTypeString;
-    dataPoints?: Record<number, {
-        shape?: LinePointShape;
-        size?: number;
-        color?: string | null;
-        fillOpacity?: number;
-    }>;
+    dataPoints?: Record<number, IChartSeriesDataPointStyleSpec>;
     waterfallStyles?: Partial<Record<ChartWaterfallStyleTarget, Omit<IChartSeriesPatch, 'selector' | 'waterfallStyles'>>>;
 }
+/** Series patch for line-like marks whose data points are symbols. */
+export interface IChartLineSeriesPatch extends Omit<IChartSeriesPatch, 'dataPoints'> {
+    dataPoints?: Record<number, IChartSymbolDataPointStyleSpec>;
+}
+/** Series style for chart types that do not accept explicit gradients in the first release. */
+export interface IChartSolidSeriesStyleSpec extends Omit<IChartSeriesStyleSpec, 'color'> {
+    color?: string;
+}
+/** Series patch for chart marks that expose only solid colors. */
+export interface IChartSolidSeriesPatch extends Omit<IChartLineSeriesPatch, keyof IChartSeriesStyleSpec>, IChartSolidSeriesStyleSpec {
+}
 export interface IChartTrendlineSpec {
     selector: ChartSeriesSelector;
     type: ChartTrendlineType;
@@ -222,7 +242,7 @@ export interface IChartHeatmapSpec {
 }
 export interface IChartWordCloudSpec {
     shape?: WordCloudShapeEnum;
-    maskImageId?: string | null;
+    maskImageId?: string;
     repeat?: boolean;
 }
 export interface IChartWordCloudDescription {
@@ -234,11 +254,10 @@ export interface IChartWordCloudDescription {
 export interface IChartAppearanceSpec {
     background?: {
         /** CSS background color. Use `'transparent'` for an explicit transparent chart and host background. */
-        color?: string | null;
-        gradient?: boolean;
+        color?: string;
     };
     border?: {
-        color?: string | null;
+        color?: string;
         /** Persisted host-border width. Use `0` to hide the host border without changing host-owned stroke state. */
         width?: number;
     };
@@ -251,30 +270,38 @@ export interface IChartAppearanceSpec {
 export interface IChartScatterMappingSpec {
     xIndex: number;
     yIndex: number;
-    labelIndex?: number | null;
+    labelIndex?: number;
 }
 export interface IChartBubbleMappingSpec extends IChartScatterMappingSpec {
-    sizeIndex?: number | null;
-    seriesIndex?: number | null;
+    sizeIndex?: number;
+    seriesIndex?: number;
 }
 export interface IChartMappingSpec {
-    categoryIndex?: number | null;
-    seriesIndexes?: number[] | null;
-    useDateAxis?: boolean | null;
-    scatter?: IChartScatterMappingSpec | null;
-    bubble?: IChartBubbleMappingSpec | null;
+    categoryIndex?: number;
+    /** Ordered root-to-leaf hierarchy fields for hierarchy charts. */
+    hierarchyIndexes?: number[];
+    seriesIndexes?: number[];
+    useDateAxis?: boolean;
+    scatter?: IChartScatterMappingSpec;
+    bubble?: IChartBubbleMappingSpec;
+    candlestick?: IChartCandlestickMappingSpec;
 }
 export interface IChartAggregationSpec {
-    aggregate?: boolean | null;
-    topN?: number | null;
+    aggregate?: boolean;
+    topN?: number;
 }
 export interface IChartPieLabelSpec extends IChartFontSpec {
     visible?: boolean;
     position?: PieLabelPosition;
     contentType?: LabelContentType;
 }
+/** Authored style for one materialized Pie or Donut slice. */
+export interface IChartSliceStyleSpec {
+    color?: ChartColor;
+    fillOpacity?: number;
+}
 export interface IChartPieSpec {
-    doughnutHole?: number | null;
+    doughnutHole?: number;
     explosion?: number;
     borderColor?: string;
     hasPaddingAngle?: boolean;
@@ -285,6 +312,8 @@ export interface IChartPieSpec {
     valueSuffix?: string;
     digitalFixed?: number;
     label?: IChartPieLabelSpec;
+    /** Sparse authored slice styles keyed by materialized slice index. */
+    sliceStyles?: Partial<Record<number, IChartSliceStyleSpec>>;
 }
 export interface IChartRadarSpec {
     shape?: RadarShape;
@@ -316,14 +345,14 @@ export interface IChartParetoLineLabelStyleSpec extends IChartParetoLabelStyleBa
 }
 /** Supported appearance for the Pareto business bars. */
 export interface IChartParetoBarStyleSpec {
-    color?: string;
+    color?: ChartColor;
     opacity?: number;
     border?: IChartParetoBorderStyleSpec;
     label?: IChartParetoBarLabelStyleSpec;
 }
 /** Supported appearance for the derived Pareto cumulative line. */
 export interface IChartParetoLineStyleSpec {
-    color?: string;
+    color?: ChartColor;
     opacity?: number;
     width?: number;
     dashType?: ChartBorderDashType;
@@ -343,7 +372,7 @@ export interface IChartAxisPointerSpec {
     indicatorLabelTextColor?: string;
 }
 export interface IChartAreaSpec {
-    lineStyle?: AreaLineStyle | null;
+    lineStyle?: AreaLineStyle;
 }
 export interface IChartBarSpec {
     is3D?: boolean;
@@ -352,8 +381,8 @@ export interface IChartBarSpec {
     rotY?: number;
 }
 export interface IChartFunnelSpec {
-    gap?: number | null;
-    useAbsoluteValue?: boolean | null;
+    gap?: number;
+    useAbsoluteValue?: boolean;
 }
 export interface IChartRelationForceSpec {
     gravity?: number;
@@ -361,12 +390,12 @@ export interface IChartRelationForceSpec {
     edgeLength?: number;
 }
 export interface IChartRelationSpec {
-    layout?: RelationChartLayoutEnum | null;
-    useValueAsSymbolSize?: boolean | null;
-    emphasisEnabled?: boolean | null;
-    force?: IChartRelationForceSpec | null;
-    circularLabelRotation?: boolean | null;
-    nodeShape?: LinePointShape | null;
+    layout?: RelationChartLayoutEnum;
+    useValueAsSymbolSize?: boolean;
+    emphasisEnabled?: boolean;
+    force?: IChartRelationForceSpec;
+    circularLabelRotation?: boolean;
+    nodeShape?: LinePointShape;
 }
 /** Waterfall semantic configuration exposed through the Facade. */
 export interface IChartWaterfallSpec {
@@ -395,33 +424,43 @@ export interface IChartWaterfallConnectorStyleSpec {
 }
 interface IChartSemanticConfig {
     type?: ChartTypeString;
-    title?: ChartTitleSpec | null;
-    subtitle?: ChartSubtitleSpec | null;
-    trendlines?: IChartTrendlineSpec[] | null;
-    heatmap?: IChartHeatmapSpec | null;
-    invalidValueStrategy?: InvalidValueType | null;
-    legend?: ChartLegendSpec | null;
-    axes?: IChartAxesSpec | null;
-    allSeriesStyle?: IChartSeriesStyleSpec | null;
-    series?: IChartSeriesPatch[] | null;
-    wordCloud?: IChartWordCloudSpec | null;
-    appearance?: IChartAppearanceSpec | null;
-    mapping?: IChartMappingSpec | null;
-    aggregation?: IChartAggregationSpec | null;
-    pie?: IChartPieSpec | null;
-    radar?: IChartRadarSpec | null;
-    pareto?: IChartParetoSpec | null;
-    axisPointer?: IChartAxisPointerSpec | null;
-    area?: IChartAreaSpec | null;
-    bar?: IChartBarSpec | null;
-    funnel?: IChartFunnelSpec | null;
-    relation?: IChartRelationSpec | null;
-    waterfall?: IChartWaterfallSpec | null;
-    markLines?: IChartMarkLineSpec[] | null;
-    theme?: string | null;
+    autoGradientFill?: boolean;
+    title?: ChartTitleSpec;
+    subtitle?: ChartSubtitleSpec;
+    trendlines?: IChartTrendlineSpec[];
+    heatmap?: IChartHeatmapSpec;
+    invalidValueStrategy?: InvalidValueType;
+    legend?: ChartLegendSpec;
+    axes?: IChartAxesSpec;
+    allSeriesStyle?: IChartSeriesStyleSpec;
+    series?: IChartSeriesPatch[];
+    wordCloud?: IChartWordCloudSpec;
+    appearance?: IChartAppearanceSpec;
+    mapping?: IChartMappingSpec;
+    aggregation?: IChartAggregationSpec;
+    pie?: IChartPieSpec;
+    radar?: IChartRadarSpec;
+    pareto?: IChartParetoSpec;
+    axisPointer?: IChartAxisPointerSpec;
+    area?: IChartAreaSpec;
+    bar?: IChartBarSpec;
+    funnel?: IChartFunnelSpec;
+    relation?: IChartRelationSpec;
+    waterfall?: IChartWaterfallSpec;
+    candlestick?: IChartCandlestickSpec;
+    histogram?: IChartHistogramSpec;
+    treemap?: IChartTreemapSpec;
+    markLines?: IChartMarkLineSpec[];
+    theme?: string;
     /** Persisted absolute series colors. A non-empty value overrides theme colors. */
-    palette?: string[] | null;
+    palette?: string[];
 }
+/** Pending chart edits; `null` is a runtime-only delete marker consumed before persistence. */
+export type ChartPendingConfig = Pick<IChartSemanticConfig, 'type'> & DeepNullish<Omit<IChartSemanticConfig, 'type' | 'series'>> & {
+    series?: Array<{
+        selector: ChartSeriesSelector;
+    } & DeepNullish<Omit<IChartSeriesPatch, 'selector'>>> | null;
+};
 /** Data-free metadata and semantic styling for one source series. */
 export interface IChartSeriesDescription extends IChartSeriesStyleSpec {
     name: string;
@@ -434,10 +473,11 @@ export interface IChartCategoryDescription {
     name: string;
 }
 /** Materialized engine semantic data returned explicitly by hosted builders. */
-export type IResolvedChartData = IChartData;
-export interface IChartDescription extends Omit<IChartSemanticConfig, 'series'> {
+export interface IChartDescription extends Omit<IChartSemanticConfig, 'autoGradientFill' | 'series'> {
     id: string;
     type: ChartTypeString;
+    /** Effective automatic-gradient state after applying chart-type defaults. */
+    autoGradientFill: boolean;
     /** Series metadata keyed by source field index; materialized values are available from `resolveData()`. */
     series: Partial<Record<number, IChartSeriesDescription>>;
     /** Category metadata only; materialized category values are available from `resolveData()`. */
@@ -457,3 +497,4 @@ export interface IChartDescription extends Omit<IChartSemanticConfig, 'series'>
      */
     axisBindings?: Partial<Record<ChartSemanticAxis, IChartAxisBindingDescription>>;
 }
+export {};

package/lib/types/chart-builder/configuration/assertions.d.ts

@@ -0,0 +1,3 @@
+/** Validates semantic indexes before a Facade operation can mutate Pending state. */
+export declare function assertChartIndex(value: number, name: string): void;
+export declare function assertChartIndexes(values: readonly number[], name: string): void;

package/lib/types/chart-builder/configuration/auto-gradient-fill.d.ts

@@ -0,0 +1,4 @@
+/** Records whether solid mark colors should use the chart's automatic gradient preset. */
+export declare const setAutoGradientFill: (value: boolean) => import("./chart-config-operation").IChartConfigOperation;
+/** Clears an authored automatic-gradient override so the chart-type default applies. */
+export declare const resetAutoGradientFill: () => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/configuration/candlestick.d.ts

@@ -0,0 +1,9 @@
+import type { IChartCandlestickStateStyleSpec } from '../../types';
+export declare const setRisingStyle: (value: IChartCandlestickStateStyleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearRisingStyle: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setFallingStyle: (value: IChartCandlestickStateStyleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearFallingStyle: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setDojiStyle: (value: IChartCandlestickStateStyleSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearDojiStyle: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setCandleWidth: (value: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetCandleWidth: () => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/configuration/chart-config-operation.d.ts

@@ -3,9 +3,13 @@ import type { ChartPendingConfig } from '../chart-types';
 export declare enum ChartConfigGroup {
     AllSeriesStyle = "allSeriesStyle",
     Area = "area",
+    AutoGradientFill = "autoGradientFill",
     AxisPointer = "axisPointer",
     Aggregation = "aggregation",
     Appearance = "appearance",
+    Candlestick = "candlestick",
+    Histogram = "histogram",
+    Treemap = "treemap",
     Axes = "axes",
     Bar = "bar",
     Heatmap = "heatmap",

package/lib/types/chart-builder/configuration/histogram.d.ts

@@ -0,0 +1,11 @@
+export declare const setHistogramField: (index: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearHistogramField: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setHistogramBinCount: (count: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const setHistogramBinWidth: (width: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetHistogramBinning: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setHistogramUnderflowThreshold: (value: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearHistogramUnderflowThreshold: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setHistogramOverflowThreshold: (value: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const clearHistogramOverflowThreshold: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setHistogramBinGap: (value: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetHistogramBinGap: () => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/configuration/index.d.ts

@@ -3,13 +3,17 @@ export { ChartWaterfallStyleTarget } from '../chart-types';
 export * from './aggregation';
 export * from './appearance';
 export * from './area';
+export * from './auto-gradient-fill';
 export * from './axes';
 export * from './axis-pointer';
 export * from './bar';
+export * from './candlestick';
 export * from './cartesian-series';
+export type { IChartConfigOperation } from './chart-config-operation';
 export * from './combination';
 export * from './funnel';
 export * from './heatmap';
+export * from './histogram';
 export * from './invalid-value';
 export * from './legend';
 export * from './line';
@@ -24,6 +28,7 @@ export * from './relation';
 export * from './subtitle';
 export * from './theme';
 export * from './title';
+export * from './treemap';
 export * from './trendline';
 export * from './waterfall';
 export * from './word-cloud';

package/lib/types/chart-builder/configuration/pie.d.ts

@@ -1,4 +1,4 @@
-import type { IChartPieLabelSpec } from '../chart-types';
+import type { IChartPieLabelSpec, IChartSliceStyleSpec } from '../chart-types';
 export declare const setDoughnutHole: (value: number) => import("./chart-config-operation").IChartConfigOperation;
 export declare const clearDoughnutHole: () => import("./chart-config-operation").IChartConfigOperation;
 export declare const setExplosion: (value: number) => import("./chart-config-operation").IChartConfigOperation;
@@ -21,3 +21,7 @@ export declare const setDecimalPlaces: (value: number) => import("./chart-config
 export declare const resetDecimalPlaces: () => import("./chart-config-operation").IChartConfigOperation;
 export declare const setPieLabel: (value: IChartPieLabelSpec) => import("./chart-config-operation").IChartConfigOperation;
 export declare const clearPieLabel: () => import("./chart-config-operation").IChartConfigOperation;
+/** Records the authored style for one materialized Pie or Donut slice. */
+export declare const setSliceStyle: (index: number, value: IChartSliceStyleSpec) => import("./chart-config-operation").IChartConfigOperation;
+/** Clears the authored style for one materialized Pie or Donut slice. */
+export declare const clearSliceStyle: (index: number) => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/configuration/point-mapping.d.ts

@@ -1,5 +1,8 @@
+import type { IChartCandlestickMappingSpec } from '../../types';
 import type { IChartBubbleMappingSpec, IChartScatterMappingSpec } from '../chart-types';
 export declare const setScatterMapping: (value: IChartScatterMappingSpec) => import("./chart-config-operation").IChartConfigOperation;
 export declare const clearScatterMapping: () => import("./chart-config-operation").IChartConfigOperation;
 export declare const setBubbleMapping: (value: IChartBubbleMappingSpec) => import("./chart-config-operation").IChartConfigOperation;
 export declare const clearBubbleMapping: () => import("./chart-config-operation").IChartConfigOperation;
+export declare function setCandlestickFields(value: IChartCandlestickMappingSpec): import("./chart-config-operation").IChartConfigOperation;
+export declare const clearCandlestickFields: () => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/configuration/treemap.d.ts

@@ -0,0 +1,8 @@
+import type { TreemapParentLabelLayout } from '../../enum';
+import type { IChartTreemapLabelSpec } from '../../types';
+export declare const setTreemapHierarchyFields: (indexes: readonly number[]) => import("./chart-config-operation").IChartConfigOperation;
+export declare const setTreemapValueField: (index: number) => import("./chart-config-operation").IChartConfigOperation;
+export declare const setTreemapParentLabelLayout: (layout: TreemapParentLabelLayout) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetTreemapParentLabelLayout: () => import("./chart-config-operation").IChartConfigOperation;
+export declare const setTreemapLabel: (label: IChartTreemapLabelSpec) => import("./chart-config-operation").IChartConfigOperation;
+export declare const resetTreemapLabel: () => import("./chart-config-operation").IChartConfigOperation;

package/lib/types/chart-builder/conversion/chart-config-converter.d.ts

@@ -1,18 +1,23 @@
-import type { ChartStyle, IChartContext, IChartDataAggregation, IChartDataSeries } from '../../types';
+import type { ChartStyle, DeepNullish, IChartContext, IChartDataAggregation, IChartDataSeries } from '../../types';
 import type { ChartPendingConfig, IChartDescription } from '../chart-types';
 import { ChartTypeBits } from '../../enum';
 interface IChartConfigConversionOptions {
     series?: IChartDataSeries[];
+    currentChartType?: ChartTypeBits;
     currentStyle?: ChartStyle;
     currentContext?: IChartContext;
     currentDataAggregation?: IChartDataAggregation;
 }
-interface IChartModelConfigUpdate {
+type ChartContextPendingPatch = DeepNullish<IChartContext>;
+interface IChartModelConfigPendingUpdate {
     chartType?: ChartTypeBits;
     style?: ChartStyle;
-    context?: IChartContext;
+    context?: ChartContextPendingPatch;
     dataAggregation?: Partial<IChartDataAggregation>;
 }
+interface IChartModelConfigUpdate extends Omit<IChartModelConfigPendingUpdate, 'context'> {
+    context?: IChartContext;
+}
 export interface ICompleteChartModelConfig {
     chartType?: ChartTypeBits;
     style?: ChartStyle;

package/lib/types/chart-builder/conversion/chart-context-patch.d.ts

@@ -0,0 +1,5 @@
+import type { DeepNullish, IChartContext } from '../../types';
+/** Validates and clones a complete context received at a replacement boundary. */
+export declare function canonicalizeChartContext(value: unknown): IChartContext;
+/** Internal Pending boundary used before a command payload is created. */
+export declare function applyPendingChartContext(current: IChartContext | undefined, value: DeepNullish<IChartContext>): IChartContext;

package/lib/types/chart-builder/conversion/chart-model-fields.d.ts

@@ -6,12 +6,15 @@ export declare enum ChartStyleField {
     BackgroundColor = "backgroundColor",
     BorderColor = "borderColor",
     BorderWidth = "borderWidth",
+    Candlestick = "candlestick",
     FontColor = "fontColor",
     FontFamily = "fontFamily",
     FontSize = "fontSize",
     Funnel = "funnel",
     GradientFill = "gradientFill",
     Heatmap = "heatmap",
+    Histogram = "histogram",
+    Treemap = "treemap",
     InvalidValueType = "invalidValueType",
     MarkLines = "markLines",
     Palette = "palette",
@@ -33,6 +36,9 @@ export declare enum ChartContextField {
     BubbleSeriesIndex = "bubbleSeriesIndex",
     BubbleSizeIndex = "bubbleSizeIndex",
     CategoryIndex = "categoryIndex",
+    Candlestick = "candlestick",
+    Histogram = "histogram",
+    HierarchyIndexes = "hierarchyIndexes",
     ScatterLabelIndex = "scatterLabelIndex",
     ScatterXIndex = "scatterXIndex",
     ScatterYIndex = "scatterYIndex",

package/lib/types/chart-builder/conversion/resolve-chart-model-data.d.ts

@@ -1,5 +1,5 @@
 import type { ChartModel } from '../../models/chart-model';
-import type { IUniverDataSet } from '../../types';
-import type { ChartPendingConfig, IResolvedChartData } from '../chart-types';
+import type { IChartData, IUniverDataSet } from '../../types';
+import type { ChartPendingConfig } from '../chart-types';
 /** Resolves fresh engine semantic data from the model plus an uncommitted Facade patch. */
-export declare function resolveChartModelData(model: ChartModel, pending: ChartPendingConfig, dataSet?: IUniverDataSet, isRowDirection?: boolean): IResolvedChartData;
+export declare function resolveChartModelData(model: ChartModel, pending: ChartPendingConfig, dataSet?: IUniverDataSet, isRowDirection?: boolean): IChartData;

package/lib/types/chart-builder/index.d.ts

@@ -1,9 +1,14 @@
+export type { IChartCandlestickMappingSpec, IChartCandlestickSpec, IChartCandlestickStateStyleSpec, IChartHistogramBinningSpec, IChartHistogramDataSpec, IChartHistogramSpec, IChartHistogramStyleSpec, IChartTreemapLabelSpec, IChartTreemapSpec, } from '../types';
 export { ChartBuilder } from './chart-builder';
 export type { IChartBuilderAdapter } from './chart-builder-adapter';
+export { CHART_LINEAR_GRADIENT_TYPE, chartLinearGradient } from './chart-color';
+export type { ChartColor, ChartLinearGradientInput, IChartGradientPoint, IChartGradientStop, IChartLinearGradient, } from './chart-color';
 export type { ChartDescription } from './chart-description';
+export { createChartStarterRows } from './chart-starter-data';
 export * from './chart-types';
 export * from './configuration';
 export { toChartModelConfig, toCompleteChartModelConfig } from './conversion/chart-config-converter';
+export { canonicalizeChartContext } from './conversion/chart-context-patch';
 export { chartBitsToType, chartTypeToBits } from './conversion/chart-type-converter';
 export { describeChartModel, resolveChartDescriptionMetadata } from './conversion/describe-chart-model';
 export { resolveChartModelData } from './conversion/resolve-chart-model-data';

package/lib/types/chart-builder/internal/host-builder-runtime.d.ts

@@ -1,5 +1,3 @@
 import type { IUniverDataSet } from '../../types';
-export { resolveChartDescriptionMetadata } from '../conversion/describe-chart-model';
-export { resolveChartModelData } from '../conversion/resolve-chart-model-data';
 /** Builds a detached data set from raw inline values and disposes the temporary source. */
 export declare function resolveInlineChartDataSet<TCell>(values: TCell[][], buildDataSet: (data: TCell[][]) => IUniverDataSet, isRowDirection?: boolean): IUniverDataSet;

package/lib/types/chart-text-measure-canvas.d.ts

@@ -0,0 +1,6 @@
+interface ISize {
+    width: number;
+    height: number;
+}
+export declare const calcPosition: (text: string, font: string) => ISize;
+export {};