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

package/lib/types/facade/builders/f-candlestick-chart-builder.d.ts

@@ -0,0 +1,133 @@
+import type { IChartCandlestickMappingSpec, IChartCandlestickStateStyleSpec } from '@univerjs-pro/engine-chart';
+import { FAxisChartBuilder } from '../f-axis-chart-builder';
+/** Fluent semantic builder for a single OHLC Candlestick series. */
+export declare class FCandlestickChartBuilder extends FAxisChartBuilder {
+    /**
+     * Replaces Open, High, Low, and Close source fields atomically.
+     *
+     * Category remains configured through `setCategoryField()`. Every supplied index must be a
+     * unique non-negative integer. Read the pending or persisted value with
+     * `builder.describe().mapping?.candlestick`.
+     *
+     * @param fields Required semantic OHLC source field indexes.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * const builder = worksheet.charts.create()
+     *   .setType(univerAPI.Enum.ChartTypeString.Candlestick)
+     *   .setCategoryField(0)
+     *   .setCandlestickFields({ openIndex: 1, highIndex: 2, lowIndex: 3, closeIndex: 4 });
+     * const mapping = builder.describe().mapping?.candlestick;
+     * ```
+     */
+    setCandlestickFields(fields: IChartCandlestickMappingSpec): this;
+    /**
+     * Clears the atomic OHLC mapping while preserving the category field.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create()
+     *   .setType(univerAPI.Enum.ChartTypeString.Candlestick)
+     *   .clearCandlestickFields();
+     * ```
+     */
+    clearCandlestickFields(): this;
+    /**
+     * Sets semantic Rising candle body and wick style overrides.
+     *
+     * @param style Rising body and wick style values, passed through without Facade range validation.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick)
+     *   .setRisingStyle({ color: '#0DA471', hollow: true });
+     * ```
+     */
+    setRisingStyle(style: IChartCandlestickStateStyleSpec): this;
+    /**
+     * Clears explicit Rising style overrides so runtime defaults apply.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).clearRisingStyle();
+     * ```
+     */
+    clearRisingStyle(): this;
+    /**
+     * Sets semantic Falling candle body and wick style overrides.
+     *
+     * @param style Falling body and wick style values, passed through without Facade range validation.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick)
+     *   .setFallingStyle({ color: '#F05252' });
+     * ```
+     */
+    setFallingStyle(style: IChartCandlestickStateStyleSpec): this;
+    /**
+     * Clears explicit Falling style overrides so runtime defaults apply.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).clearFallingStyle();
+     * ```
+     */
+    clearFallingStyle(): this;
+    /**
+     * Sets semantic Doji body and wick style overrides.
+     *
+     * @param style Doji body and wick style values, passed through without Facade range validation.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick)
+     *   .setDojiStyle({ color: '#8C8C8C', border: { width: 2 } });
+     * ```
+     */
+    setDojiStyle(style: IChartCandlestickStateStyleSpec): this;
+    /**
+     * Clears explicit Doji style overrides so runtime defaults apply.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).clearDojiStyle();
+     * ```
+     */
+    clearDojiStyle(): this;
+    /**
+     * Sets a fixed candle width value without Facade range validation.
+     *
+     * @param width Fixed candle width in pixels.
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).setCandleWidth(18);
+     * ```
+     */
+    setCandleWidth(width: number): this;
+    /**
+     * Removes the fixed candle width so the renderer chooses it automatically.
+     *
+     * @returns This builder for chaining.
+     * @example
+     * ```ts
+     * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
+     * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).resetCandleWidth();
+     * ```
+     */
+    resetCandleWidth(): this;
+}

package/lib/types/facade/builders/f-histogram-chart-builder.d.ts

@@ -0,0 +1,74 @@
+import { FCartesianChartBuilder } from '../f-cartesian-chart-builder';
+/**
+ * Fluent builder for a one-field raw-sample Histogram.
+ *
+ * Histogram settings are persisted as authored. Rendering uses Scott Auto when explicit
+ * binning is ineffective, never emits more than 1000 visible bins, and falls back to a
+ * zero visual gap for ineffective gap values.
+ *
+ * @example
+ * const chart = worksheet.charts.create()
+ *   .setType(univerAPI.Enum.ChartTypeString.Histogram)
+ *   .setHistogramField(0)
+ *   .setBinCount(12)
+ *   .setBinGap(0.1);
+ */
+export declare class FHistogramChartBuilder extends FCartesianChartBuilder {
+    /**
+     * Selects the only active Histogram value field by zero-based source index.
+     * @example `builder.setHistogramField(2)`
+     */
+    setHistogramField(index: number): this;
+    /**
+     * Clears the active Histogram value field.
+     * @example `builder.clearHistogramField()`
+     */
+    clearHistogramField(): this;
+    /**
+     * Stores an explicit total visible-bin count. Integers from 1 through 1000 are effective
+     * when enabled edge bins still leave room for a regular bin. Other finite values remain
+     * persisted and visible through `describe()` but render with Scott Auto. Non-finite calls
+     * produce no Pending change.
+     * @example `builder.setBinCount(20)`
+     */
+    setBinCount(count: number): this;
+    /**
+     * Stores an explicit width. A positive finite width is effective only when the current
+     * range produces at most 1000 visible bins; otherwise rendering uses Scott Auto without
+     * rewriting the stored value. Non-finite calls produce no Pending change.
+     * @example `builder.setBinWidth(2.5)`
+     */
+    setBinWidth(width: number): this;
+    /**
+     * Removes explicit binning and restores runtime-only Scott Auto.
+     * @example `builder.resetBinning()`
+     */
+    resetBinning(): this;
+    /**
+     * Enables the inclusive `x <= threshold` Underflow bin. If both thresholds are present,
+     * they are effective only when Underflow is less than Overflow. Non-finite calls are no-op.
+     * @example `builder.setUnderflowThreshold(0)`
+     */
+    setUnderflowThreshold(value: number): this;
+    /** Disables Underflow. @example `builder.clearUnderflowThreshold()` */
+    clearUnderflowThreshold(): this;
+    /**
+     * Enables the exclusive `x > threshold` Overflow bin. An ineffective finite threshold
+     * pair remains persisted but both thresholds are ignored for rendering. Non-finite calls are no-op.
+     * @example `builder.setOverflowThreshold(100)`
+     */
+    setOverflowThreshold(value: number): this;
+    /** Disables Overflow. @example `builder.clearOverflowThreshold()` */
+    clearOverflowThreshold(): this;
+    /**
+     * Stores the visual gap ratio. Values from 0 through 0.9 are effective; other finite values
+     * remain persisted but render with the 0.007-gap default. Non-finite calls are no-op.
+     * @example `builder.setBinGap(0.15)`
+     */
+    setBinGap(value: number): this;
+    /**
+     * Removes the explicit gap and restores the 0.007 runtime default.
+     * @example `builder.resetBinGap()`
+     */
+    resetBinGap(): this;
+}

package/lib/types/facade/builders/f-treemap-chart-builder.d.ts

@@ -0,0 +1,34 @@
+import type { IChartTreemapLabelSpec, TreemapParentLabelLayout } from '@univerjs-pro/engine-chart';
+import { FChartBuilderBase } from '../f-chart-builder-base';
+/**
+ * Fluent semantic builder for an automatically laid-out Treemap.
+ *
+ * Field indexes are zero-based in the orientation-normalized dataset. Rendering needs at
+ * least one ordered hierarchy field and exactly one value field. Duplicate complete paths
+ * sum finite numeric values; blank, textual, non-finite, and final non-positive values do
+ * not render. Parent-owned facts add to child totals. Layout is automatic and navigation
+ * is disabled. The runtime defaults are banner parent labels and visible category-name
+ * leaf labels; labels may hide when their rectangle cannot fit the complete content.
+ *
+ * @example
+ * const chart = worksheet.charts.create()
+ *   .setType(univerAPI.Enum.ChartTypeString.Treemap)
+ *   .setHierarchyFields([0, 1, 2])
+ *   .setValueField(3)
+ *   .setParentLabelLayout('banner')
+ *   .setTreemapLabel({ visible: true, contentType: univerAPI.Enum.LabelContentType.CategoryName });
+ */
+export declare class FTreemapChartBuilder extends FChartBuilderBase {
+    /** Replaces the ordered root-to-leaf hierarchy with zero-based field indexes. */
+    setHierarchyFields(indexes: readonly number[]): this;
+    /** Replaces the sole numeric value field with a zero-based field index. */
+    setValueField(index: number): this;
+    /** Sets parent names to a reserved banner, overlapping text, or hidden. */
+    setParentLabelLayout(layout: TreemapParentLabelLayout): this;
+    /** Removes the explicit parent layout and restores the runtime banner default. */
+    resetParentLabelLayout(): this;
+    /** Sets leaf font and CategoryName/Value content. Other content bits are inert. */
+    setTreemapLabel(label: IChartTreemapLabelSpec): this;
+    /** Removes explicit leaf-label style and restores visible category-name labels. */
+    resetTreemapLabel(): this;
+}

package/lib/types/facade/builders/index.d.ts

@@ -1,14 +1,17 @@
 export { FAreaChartBuilder } from './f-area-chart-builder';
 export { FBoxplotChartBuilder } from './f-boxplot-chart-builder';
 export { FBubbleChartBuilder } from './f-bubble-chart-builder';
+export { FCandlestickChartBuilder } from './f-candlestick-chart-builder';
 export { FCombinationChartBuilder } from './f-combination-chart-builder';
 export { FFunnelChartBuilder } from './f-funnel-chart-builder';
 export { FHeatmapChartBuilder } from './f-heatmap-chart-builder';
+export { FHistogramChartBuilder } from './f-histogram-chart-builder';
 export { FLineChartBuilder } from './f-line-chart-builder';
 export { FParetoChartBuilder } from './f-pareto-chart-builder';
 export { FPieChartBuilder } from './f-pie-chart-builder';
 export { FRadarChartBuilder } from './f-radar-chart-builder';
 export { FRelationChartBuilder } from './f-relation-chart-builder';
 export { FScatterChartBuilder } from './f-scatter-chart-builder';
+export { FTreemapChartBuilder } from './f-treemap-chart-builder';
 export { FWaterfallChartBuilder } from './f-waterfall-chart-builder';
 export { FWordCloudChartBuilder } from './f-word-cloud-chart-builder';

package/lib/types/facade/chart-builder-type-map.d.ts

@@ -1,5 +1,5 @@
 import type { ChartTypeString } from '@univerjs-pro/engine-chart';
-import type { FAreaChartBuilder, FBoxplotChartBuilder, FBubbleChartBuilder, FCombinationChartBuilder, FFunnelChartBuilder, FHeatmapChartBuilder, FLineChartBuilder, FParetoChartBuilder, FPieChartBuilder, FRadarChartBuilder, FRelationChartBuilder, FScatterChartBuilder, FWaterfallChartBuilder, FWordCloudChartBuilder } from './builders';
+import type { FAreaChartBuilder, FBoxplotChartBuilder, FBubbleChartBuilder, FCandlestickChartBuilder, FCombinationChartBuilder, FFunnelChartBuilder, FHeatmapChartBuilder, FHistogramChartBuilder, FLineChartBuilder, FParetoChartBuilder, FPieChartBuilder, FRadarChartBuilder, FRelationChartBuilder, FScatterChartBuilder, FTreemapChartBuilder, FWaterfallChartBuilder, FWordCloudChartBuilder } from './builders';
 import type { FCartesianChartBuilder } from './f-cartesian-chart-builder';
 import type { FChartBuilderBase } from './f-chart-builder-base';
 export interface IChartBuilderTypeMap {
@@ -27,4 +27,7 @@ export interface IChartBuilderTypeMap {
     [ChartTypeString.Sankey]: FChartBuilderBase;
     [ChartTypeString.Heatmap]: FHeatmapChartBuilder;
     [ChartTypeString.Boxplot]: FBoxplotChartBuilder;
+    [ChartTypeString.Candlestick]: FCandlestickChartBuilder;
+    [ChartTypeString.Histogram]: FHistogramChartBuilder;
+    [ChartTypeString.Treemap]: FTreemapChartBuilder;
 }

package/lib/types/facade/f-chart-base.d.ts

@@ -1,4 +1,4 @@
-import type { ChartBuilder, ChartDescription, IChartRenderModelImageExportOptions, IChartRenderModelImageExportResult, IResolvedChartData } from '@univerjs-pro/engine-chart';
+import type { ChartBuilder, ChartDescription, IChartData, IChartRenderModelImageExportOptions, IChartRenderModelImageExportResult } from '@univerjs-pro/engine-chart';
 import type { DeepReadonly } from '@univerjs/core';
 import type { IChartBuilderFacadeContext, IChartBuilderFacadeContextAccess } from './internal/chart-builder-facade-context';
 export declare abstract class FChartBase<TDescription extends ChartDescription = ChartDescription, TBuilder extends ChartBuilder = ChartBuilder> implements IChartBuilderFacadeContextAccess {
@@ -51,7 +51,7 @@ export declare abstract class FChartBase<TDescription extends ChartDescription =
      * console.log(data.series);
      * ```
      */
-    resolveData(): DeepReadonly<IResolvedChartData>;
+    resolveData(): DeepReadonly<IChartData>;
     /**
      * Commits all pending builder changes synchronously.
      *

package/lib/types/index.d.ts

@@ -1,15 +1,18 @@
-export type { ChartColor, ChartDescription, ChartLegendSpec, ChartLinearGradientInput, ChartPublicSeriesSelector, ChartSeriesSelector, ChartSeriesTrendlineSelector, ChartSubtitleSpec, ChartTitleSpec, IChartAggregationSpec, IChartAppearanceSpec, IChartAreaSpec, IChartAxesSpec, IChartAxisBindingDescription, IChartAxisLabelSpec, IChartAxisPointerSpec, IChartAxisSpec, IChartBarSpec, IChartBubbleMappingSpec, IChartDescription, IChartFontSpec, IChartFunnelSpec, IChartGradientPoint, IChartGradientStop, IChartHeatmapLabelSpec, IChartHeatmapSpec, IChartLegendOptions, IChartLinearGradient, IChartLineSeriesPatch, IChartMappingSpec, IChartMarkLineLabelSpec, IChartMarkLineSpec, IChartParetoBarLabelStyleSpec, IChartParetoBarStyleSpec, IChartParetoBorderStyleSpec, IChartParetoLineLabelStyleSpec, IChartParetoLineStyleSpec, IChartParetoPointStyleSpec, IChartParetoSpec, IChartPieLabelSpec, IChartPieSpec, IChartRadarSpec, IChartRelationForceSpec, IChartRelationSpec, IChartScatterMappingSpec, IChartSeriesBorderSpec, IChartSeriesDataPointStyleSpec, IChartSeriesDescription, IChartSeriesLabelSpec, IChartSeriesPatch, IChartSeriesPointSpec, IChartSeriesStyleSpec, IChartSliceStyleSpec, IChartSolidSeriesPatch, IChartSolidSeriesStyleSpec, IChartSubtitleOptions, IChartSymbolDataPointStyleSpec, IChartTitleOptions, IChartTrendlineSpec, IChartWaterfallConnectorStyleSpec, IChartWaterfallPointRoleSpec, IChartWaterfallSpec, IChartWordCloudDescription, IChartWordCloudSpec, IInlineChartBuilderAdapter, IInlineChartHostPatch, IResolvedChartData, } from './chart-builder';
+export type { ChartColor, ChartDescription, ChartLegendSpec, ChartLinearGradientInput, ChartPublicSeriesSelector, ChartSeriesSelector, ChartSeriesTrendlineSelector, ChartSubtitleSpec, ChartTitleSpec, IChartAggregationSpec, IChartAppearanceSpec, IChartAreaSpec, IChartAxesSpec, IChartAxisBindingDescription, IChartAxisLabelSpec, IChartAxisPointerSpec, IChartAxisSpec, IChartBarSpec, IChartBubbleMappingSpec, IChartCandlestickMappingSpec, IChartCandlestickSpec, IChartCandlestickStateStyleSpec, IChartConfigOperation, IChartDescription, IChartFontSpec, IChartFunnelSpec, IChartGradientPoint, IChartGradientStop, IChartHeatmapLabelSpec, IChartHeatmapSpec, IChartHistogramBinningSpec, IChartHistogramDataSpec, IChartHistogramSpec, IChartHistogramStyleSpec, IChartLegendOptions, IChartLinearGradient, IChartLineSeriesPatch, IChartMappingSpec, IChartMarkLineLabelSpec, IChartMarkLineSpec, IChartParetoBarLabelStyleSpec, IChartParetoBarStyleSpec, IChartParetoBorderStyleSpec, IChartParetoLineLabelStyleSpec, IChartParetoLineStyleSpec, IChartParetoPointStyleSpec, IChartParetoSpec, IChartPieLabelSpec, IChartPieSpec, IChartRadarSpec, IChartRelationForceSpec, IChartRelationSpec, IChartScatterMappingSpec, IChartSeriesBorderSpec, IChartSeriesDataPointStyleSpec, IChartSeriesDescription, IChartSeriesLabelSpec, IChartSeriesPatch, IChartSeriesPointSpec, IChartSeriesStyleSpec, IChartSliceStyleSpec, IChartSolidSeriesPatch, IChartSolidSeriesStyleSpec, IChartSubtitleOptions, IChartSymbolDataPointStyleSpec, IChartTitleOptions, IChartTreemapLabelSpec, IChartTreemapSpec, IChartTrendlineSpec, IChartWaterfallConnectorStyleSpec, IChartWaterfallPointRoleSpec, IChartWaterfallSpec, IChartWordCloudDescription, IChartWordCloudSpec, IInlineChartBuilderAdapter, IInlineChartHostPatch, } from './chart-builder';
 export { AREA_CHART_TYPES, AXIS_CHART_TYPES, CARTESIAN_CHART_TYPES, CHART_LINEAR_GRADIENT_TYPE, ChartAggregationTarget, ChartAllSeriesStyleTarget, ChartAppearanceTarget, ChartAxisName, ChartAxisPointerTarget, ChartAxisTarget, ChartAxisTickPosition, chartLinearGradient, ChartSeriesAxis, ChartSeriesClearTarget, ChartSeriesTypeString, ChartTypeString, ChartVisualMapType, ChartWaterfallStyleTarget, ChartWordCloudShapeSource, DEFAULT_CHART_TYPE, } from './chart-builder';
-export { ChartBuilder, chartTypeToBits, clearAggregation, clearAllSeriesStyle, clearAppearance, clearAreaLineStyle, clearAxisPointer, clearAxisTitle, clearBar, clearBubbleMapping, clearCategoryField, clearCellLabel, clearCumulativeLineStyle, clearDoughnutHole, clearLegend, clearLineStyle, clearMarkLines, clearMaskImage, clearPalette, clearParetoBarStyle, clearPieLabel, clearRelationForce, clearRightYAxis, clearScatterMapping, clearSeries, clearSliceBorderColor, clearSliceStyle, clearSubtitle, clearTheme, clearTitle, clearTrendlines, clearValueFields, clearValueRange, clearValueSuffix, clearValueUnit, clearWaterfallConnector, clearWaterfallStyle, clearXAxis, clearYAxis, describeChartModel, DetachedChartBuilderAdapter, InlineChartBuilder, removeTrendline, resetAutoGradientFill, resetCircularLabelRotation, resetCombinationSeriesAxis, resetCombinationSeriesType, resetDecimalPlaces, resetEmphasisEnabled, resetExplosion, resetFunnelGap, resetHalfPie, resetIncludeZeroValues, resetInvalidValueStrategy, resetLabelLineVisible, resetPaddingAngleEnabled, resetRadarFill, resetRadarShape, resetRelationLayout, resetRelationNodeShape, resetRosePie, resetUseAbsoluteValue, resetUseDateAxis, resetUseSubtotal, resetUseValueAsSymbolSize, resetValueScale, resetVisualMapType, resetWaterfallStackType, resetWordCloudRepeat, resetWordCloudShape, resolveChartDescriptionMetadata, resolveChartModelData, resolveInlineChartDataSet, setAggregation, setAllSeriesStyle, setAppearance, setAreaLineStyle, setAutoGradientFill, setAxisPointer, setAxisTitle, setBar, setBubbleMapping, setCategoryField, setCellLabel, setCircularLabelRotation, setCombinationSeriesAxis, setCombinationSeriesType, setCumulativeLineStyle, setDecimalPlaces, setDoughnutHole, setEmphasisEnabled, setExplosion, setFunnelGap, setHalfPie, setIncludeZeroValues, setInvalidValueStrategy, setLabelLineVisible, setLegend, setLineStyle, setMarkLines, setMaskImage, setPaddingAngleEnabled, setPalette, setParetoBarStyle, setPieLabel, setRadarFill, setRadarShape, setRelationForce, setRelationLayout, setRelationNodeShape, setRightYAxis, setRosePie, setScatterMapping, setSeries, setSliceBorderColor, setSliceStyle, setSubtitle, setTheme, setTitle, setTrendline, setUseAbsoluteValue, setUseDateAxis, setUseSubtotal, setUseValueAsSymbolSize, setValueFields, setValueRange, setValueScale, setValueSuffix, setValueUnit, setVisualMapType, setWaterfallConnector, setWaterfallPointRoles, setWaterfallStackType, setWaterfallStyle, setWordCloudRepeat, setWordCloudShape, setXAxis, setYAxis, toChartModelConfig, toCompleteChartModelConfig, } from './chart-builder';
+export { canonicalizeChartContext, ChartBuilder, chartTypeToBits, clearAggregation, clearAllSeriesStyle, clearAppearance, clearAreaLineStyle, clearAxisPointer, clearAxisTitle, clearBar, clearBubbleMapping, clearCandlestickFields, clearCategoryField, clearCellLabel, clearCumulativeLineStyle, clearDojiStyle, clearDoughnutHole, clearFallingStyle, clearHistogramField, clearHistogramOverflowThreshold, clearHistogramUnderflowThreshold, clearLegend, clearLineStyle, clearMarkLines, clearMaskImage, clearPalette, clearParetoBarStyle, clearPieLabel, clearRelationForce, clearRightYAxis, clearRisingStyle, clearScatterMapping, clearSeries, clearSliceBorderColor, clearSliceStyle, clearSubtitle, clearTheme, clearTitle, clearTrendlines, clearValueFields, clearValueRange, clearValueSuffix, clearValueUnit, clearWaterfallConnector, clearWaterfallStyle, clearXAxis, clearYAxis, describeChartModel, DetachedChartBuilderAdapter, InlineChartBuilder, removeTrendline, resetAutoGradientFill, resetCandleWidth, resetCircularLabelRotation, resetCombinationSeriesAxis, resetCombinationSeriesType, resetDecimalPlaces, resetEmphasisEnabled, resetExplosion, resetFunnelGap, resetHalfPie, resetHistogramBinGap, resetHistogramBinning, resetIncludeZeroValues, resetInvalidValueStrategy, resetLabelLineVisible, resetPaddingAngleEnabled, resetRadarFill, resetRadarShape, resetRelationLayout, resetRelationNodeShape, resetRosePie, resetTreemapLabel, resetTreemapParentLabelLayout, resetUseAbsoluteValue, resetUseDateAxis, resetUseSubtotal, resetUseValueAsSymbolSize, resetValueScale, resetVisualMapType, resetWaterfallStackType, resetWordCloudRepeat, resetWordCloudShape, resolveChartDescriptionMetadata, resolveChartModelData, resolveInlineChartDataSet, setAggregation, setAllSeriesStyle, setAppearance, setAreaLineStyle, setAutoGradientFill, setAxisPointer, setAxisTitle, setBar, setBubbleMapping, setCandlestickFields, setCandleWidth, setCategoryField, setCellLabel, setCircularLabelRotation, setCombinationSeriesAxis, setCombinationSeriesType, setCumulativeLineStyle, setDecimalPlaces, setDojiStyle, setDoughnutHole, setEmphasisEnabled, setExplosion, setFallingStyle, setFunnelGap, setHalfPie, setHistogramBinCount, setHistogramBinGap, setHistogramBinWidth, setHistogramField, setHistogramOverflowThreshold, setHistogramUnderflowThreshold, setIncludeZeroValues, setInvalidValueStrategy, setLabelLineVisible, setLegend, setLineStyle, setMarkLines, setMaskImage, setPaddingAngleEnabled, setPalette, setParetoBarStyle, setPieLabel, setRadarFill, setRadarShape, setRelationForce, setRelationLayout, setRelationNodeShape, setRightYAxis, setRisingStyle, setRosePie, setScatterMapping, setSeries, setSliceBorderColor, setSliceStyle, setSubtitle, setTheme, setTitle, setTreemapHierarchyFields, setTreemapLabel, setTreemapParentLabelLayout, setTreemapValueField, setTrendline, setUseAbsoluteValue, setUseDateAxis, setUseSubtotal, setUseValueAsSymbolSize, setValueFields, setValueRange, setValueScale, setValueSuffix, setValueUnit, setVisualMapType, setWaterfallConnector, setWaterfallPointRoles, setWaterfallStackType, setWaterfallStyle, setWordCloudRepeat, setWordCloudShape, setXAxis, setYAxis, toChartModelConfig, toCompleteChartModelConfig, } from './chart-builder';
 export type { ChartPendingConfig, ChartTrendlineSelector, ChartTrendlineValue, IChartBuilderAdapter, IChartCreateConfig, } from './chart-builder';
-export { AreaLineStyle, AxisAlignEnum, AxisValueType, BarShape, CategoryType, ChartAttributeBits, ChartAxisDimension, ChartBorderDashType, ChartMarkLineLabelPosition, ChartSemanticAxis, ChartSourceDataTypeEnum, ChartTrendlineType, ChartTypeBits, ChartWaterfallPointRole, DataOrientation, InvalidValueType, IRuntimeAxisPosition, IRuntimeAxisPriority, LabelAlignEnum, LabelContentType, LegendPositionEnum, LinePointShape, ParetoSeriesIndex, ParetoSeriesPart, PieLabelPosition, RadarShape, RelationChartLayoutEnum, SelectModeEnum, SeriesLabelPosition, StackType, TextAlign, TextVerticalAlign, TitlePositionEnum, WaterfallSeriesTypeEnum, WaterfallStackTypeEnum, WordCloudShapeEnum, } from './enum';
+export { normalizeCandlestickInlineTable } from './chart-builder/candlestick-inline-table';
+export { createChartStarterRows } from './chart-builder/chart-starter-data';
+export { AreaLineStyle, AxisAlignEnum, AxisValueType, BarShape, CategoryType, ChartAttributeBits, ChartAxisDimension, ChartBorderDashType, ChartCandlestickState, ChartHistogramBinKind, ChartMarkLineLabelPosition, ChartSemanticAxis, ChartSourceDataTypeEnum, ChartTrendlineType, ChartTypeBits, ChartWaterfallPointRole, DataOrientation, HistogramBinningMode, InvalidValueType, IRuntimeAxisPosition, IRuntimeAxisPriority, LabelAlignEnum, LabelContentType, LegendPositionEnum, LinePointShape, ParetoSeriesIndex, ParetoSeriesPart, PieLabelPosition, RadarShape, RelationChartLayoutEnum, SelectModeEnum, SeriesLabelPosition, StackType, TextAlign, TextVerticalAlign, TitlePositionEnum, TreemapParentLabelLayout, WaterfallSeriesTypeEnum, WaterfallStackTypeEnum, WordCloudShapeEnum, } from './enum';
 export { buildChartData, RelationColumnIndex } from './models/chart-data-operators/build-chart-data';
 export { CartesianPointRoleIndex, CartesianPointValueIndex } from './models/chart-data-operators/cartesian-point-data';
+export { MAX_HISTOGRAM_BIN_COUNT } from './models/chart-data-operators/histogram-data';
 export { defaultChartContextOperators, findCategoryIndexes, findCategoryOperator, findHeaderOperator, findSeriesOperator, generateChartModelContextByOperators, pieSeriesFilterOperator, } from './models/chart-data-operators/operators';
 export { CHART_HOST_DEFAULT_BORDER_COLOR, CHART_HOST_DEFAULT_BORDER_RADIUS, CHART_HOST_DEFAULT_BORDER_WIDTH, composeChartHostFrameImage, getChartHostFrameContentRect, resolveChartHostFrameBorder, resolveChartHostFrameStyle, resolveDefaultChartHostFrameStyle, shouldComposeChartHostFrame, } from './models/chart-host-style';
 export type { IResolveChartHostFrameStyleInput, IResolveDefaultChartHostFrameStyleInput, } from './models/chart-host-style';
 export type { IChartLocaleTexts } from './models/chart-locale-texts';
-export { getDefaultChartLocaleTexts, replaceLocaleParams } from './models/chart-locale-texts';
+export { getDefaultChartLocaleTexts, replaceLocaleParams, resolveChartLocaleTexts } from './models/chart-locale-texts';
 export { CHART_DEBOUNCE_TIME, ChartModel, } from './models/chart-model';
 export { resolveChartRenderModelImageExportInput } from './models/chart-render-input-resolver';
 export type { IChartRenderInputRuntime, IResolveChartRenderModelImageExportInputParams, } from './models/chart-render-input-resolver';
@@ -23,6 +26,7 @@ export type { IEchartTheme } from './models/constants/build-in-theme';
 export { getThemeProps } from './models/constants/build-in-theme';
 export { defaultChartHeight, defaultChartWidth, EChartRenderEngineName } from './models/constants/default';
 export { defaultChartConfig, RTLChartStyle, themeColors } from './models/constants/default-chart-style';
+export { MAX_HISTOGRAM_BIN_GAP } from './models/constants/histogram-defaults';
 export { EChartRenderEngine, EChartRenderModel } from './models/echart-render-model';
 export type { IEChartRenderModelOptions } from './models/echart-render-model';
 export { echartToChartModelInit, isChartModelInit } from './models/echart-to-chart-model-init';
@@ -35,7 +39,7 @@ export { toChartDataItem } from './source/chart-data-item';
 export { ChartDataSource } from './source/chart-source';
 export { StaticChartSource } from './source/static-chart-source';
 export { ChartHostRenderMode, ChartImageSourceType } from './types';
-export type { ChartDataSourceValue, ChartDataSourceValues, ChartDirection, ChartElementEventHandler, ChartElementEventType, ChartElementKind, ChartImageSource, ChartStyle, DeepPartial, DimensionDefinitionLoose, IAllSeriesStyle, IAxisOptions, IBarStyle, IChartConfig, IChartContext, IChartData, IChartDataAggregation, IChartDataCategory, IChartDataSeries, IChartDataSource, IChartElementBounds, IChartElementEvent, IChartElementHit, IChartElementOverlay, IChartHost, IChartHostBorderStyle, IChartHostLease, IChartHostRect, IChartHostStyle, IChartInstance, IChartRenderAsImageOptions, IChartRenderInput, IChartRenderInstance, IChartRenderInstanceCreateContext, IChartRenderInstanceSpecInput, IChartRenderInstanceStyleInput, IChartRenderModel, IChartRenderModelImageExportInput, IChartRenderModelImageExportOptions, IChartRenderModelImageExportResult, IChartSnapshot, IChartStyle, IDimensionDefinition, IDomChartHost, IGridLineStyle, IImageChartHost, ILabelStyle, ILegendStyle, IPieLabelStyle, IPointStyle, IRelationForceOptions, IRuntimeAxis, ISeriesLabelStyle, ISeriesStyle, ITrendLine, IUniverDataSet, OptionDataValue, RightYAxisOptions, } from './types';
+export type { OptionDataValue, ChartDataSourceValues, ChartDirection, ChartElementEventHandler, ChartElementEventType, ChartElementKind, ChartImageSource, ChartStyle, DeepNullish, DeepPartial, DimensionDefinitionLoose, IAllSeriesStyle, IAxisOptions, IBarStyle, IChartCandlestickData, IChartCandlestickPoint, IChartConfig, IChartContext, IChartData, IChartDataAggregation, IChartDataCategory, IChartDataSeries, IChartDataSource, IChartElementBounds, IChartElementEvent, IChartElementHit, IChartElementOverlay, IChartHistogramBin, IChartHistogramData, IChartHost, IChartHostBorderStyle, IChartHostLease, IChartHostRect, IChartHostStyle, IChartInstance, IChartRenderAsImageOptions, IChartRenderInput, IChartRenderInstance, IChartRenderInstanceCreateContext, IChartRenderInstanceSpecInput, IChartRenderInstanceStyleInput, IChartRenderModel, IChartRenderModelImageExportInput, IChartRenderModelImageExportOptions, IChartRenderModelImageExportResult, IChartSnapshot, IChartStyle, IChartTreemapData, IChartTreemapNode, IDimensionDefinition, IDomChartHost, IGridLineStyle, IImageChartHost, ILabelStyle, ILegendStyle, IPieLabelStyle, IPointStyle, IRelationForceOptions, IRuntimeAxis, ISeriesLabelStyle, ISeriesStyle, ITrendLine, IUniverDataSet, RightYAxisOptions, } from './types';
 export { chartBitsUtils, chartTypeCanUseTrendLine, mergeChartConfig, } from './util';
 export * from './utils/echarts';
 export { WordCloudResourceConfig } from './word-cloud-resource/word-cloud-resource-config';
@@ -73,9 +77,6 @@ export type { IWordCloudPlacedWord } from './wordcloud-chart/types';
 export type { IWordCloudProtocolSpec } from './wordcloud-chart/types';
 export type { IWordCloudSegmentationRegion } from './wordcloud-chart/types';
 export type { IWordCloudSegmentationResult } from './wordcloud-chart/types';
-export type { IWordCloudSeriesDataItem } from './wordcloud-chart/types';
-export type { IWordCloudSeriesOption } from './wordcloud-chart/types';
-export type { IWordCloudSpecBase } from './wordcloud-chart/types';
 export type { IWordCloudTextMarkAttrs } from './wordcloud-chart/types';
 export type { IWordCloudTextMarkSpec } from './wordcloud-chart/types';
 export type { IWordCloudTextMeasurer } from './wordcloud-chart/types';

package/lib/types/models/chart-data-operators/histogram-data.d.ts

@@ -0,0 +1,10 @@
+import type { IChartHistogramBin, IChartHistogramDataSpec } from '../../types';
+export declare const MAX_HISTOGRAM_BIN_COUNT = 1000;
+export interface IBuildHistogramBinsResult {
+    bins: IChartHistogramBin[];
+    sampleCount: number;
+}
+/** Builds deterministic numeric bins without renderer strings or persisted derived values. */
+export declare function buildHistogramBins(values: readonly unknown[], spec?: IChartHistogramDataSpec): IBuildHistogramBinsResult;
+/** Stable two-pass sample standard deviation using denominator n - 1. */
+export declare function sampleStandardDeviation(samples: readonly number[]): number;

package/lib/types/models/chart-data-operators/index.d.ts

@@ -1,2 +1,3 @@
 export * from './build-chart-data';
 export * from './operators';
+export * from './treemap-data';

package/lib/types/models/chart-data-operators/operators.d.ts

@@ -1,6 +1,10 @@
-import type { IChartContext, IChartDataSource, OptionDataValue } from '../../types';
+import type { IChartCandlestickMappingSpec, IChartContext, IChartDataSource, OptionDataValue } from '../../types';
 import type { ChartModel } from '../chart-model';
 import { ChartSourceDataTypeEnum } from '../../enum';
+export interface IResolvedCandlestickMapping {
+    categoryIndex: number;
+    candlestick: IChartCandlestickMappingSpec;
+}
 export type IChartContextOperator = (dataSource: IChartDataSource, context: IChartContext, model: ChartModel) => IChartContext;
 type Nil = null | undefined;
 export declare function isNil(value: any): value is Nil;
@@ -11,6 +15,8 @@ export declare function countTypesFromArray(arrayData: Array<OptionDataValue | u
 };
 export declare function toColumnOrient<T = any>(dataSource: T[][]): T[][];
 export declare function findCategoryIndexes(dataSource: IChartDataSource): number[];
+/** Resolves Category and OHLC roles without inspecting headers or locale text. */
+export declare function resolveCandlestickMapping(dataSource: IChartDataSource, context: IChartContext): IResolvedCandlestickMapping | undefined;
 export declare const findHeaderOperator: IChartContextOperator;
 export declare const findCategoryOperator: IChartContextOperator;
 export declare const findSeriesOperator: IChartContextOperator;

package/lib/types/models/chart-data-operators/treemap-data.d.ts

@@ -0,0 +1,3 @@
+import type { IChartContext, IChartTreemapData, IUniverDataSet } from '../../types';
+/** Builds a deterministic semantic tree from orientation-normalized field vectors. */
+export declare function buildTreemapData(dataSource: IUniverDataSet, context: IChartContext): IChartTreemapData;

package/lib/types/models/chart-locale-texts.d.ts

@@ -17,6 +17,20 @@ export interface IChartLocaleTexts {
     waterfallPositive: string;
     waterfallNegative: string;
     waterfallSubtotal: string;
+    candlestickSeries?: string;
+    candlestickCategory?: string;
+    candlestickOpen?: string;
+    candlestickHigh?: string;
+    candlestickLow?: string;
+    candlestickClose?: string;
+    histogramFrequency?: string;
+    treemapEmptyTips?: string;
+    treemapHierarchy?: string;
+    treemapValue?: string;
+    treemapOwnValue?: string;
+    treemapChildren?: string;
 }
 export declare function replaceLocaleParams(text: string, ...args: string[]): string;
-export declare function getDefaultChartLocaleTexts(): IChartLocaleTexts;
+export declare function getDefaultChartLocaleTexts(): Required<IChartLocaleTexts>;
+/** Resolves host locale keys over the engine defaults without leaking missing-key placeholders. */
+export declare function resolveChartLocaleTexts(resolveText: (localeKey: string) => string, localeKeys: Partial<Record<keyof IChartLocaleTexts, string>>): Required<IChartLocaleTexts>;