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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (93) hide show
  1. package/lib/cjs/facade.js +1 -1
  2. package/lib/cjs/index.js +1 -1
  3. package/lib/es/facade.js +1 -1
  4. package/lib/es/index.js +1 -1
  5. package/lib/facade.js +1 -1
  6. package/lib/index.js +1 -1
  7. package/lib/types/chart-builder/candlestick-inline-table.d.ts +4 -0
  8. package/lib/types/chart-builder/chart-builder-adapter.d.ts +3 -3
  9. package/lib/types/chart-builder/chart-builder.d.ts +3 -3
  10. package/lib/types/chart-builder/chart-color.d.ts +49 -0
  11. package/lib/types/chart-builder/chart-starter-data.d.ts +3 -0
  12. package/lib/types/chart-builder/chart-types.d.ts +109 -68
  13. package/lib/types/chart-builder/configuration/assertions.d.ts +3 -0
  14. package/lib/types/chart-builder/configuration/auto-gradient-fill.d.ts +4 -0
  15. package/lib/types/chart-builder/configuration/candlestick.d.ts +9 -0
  16. package/lib/types/chart-builder/configuration/chart-config-operation.d.ts +4 -0
  17. package/lib/types/chart-builder/configuration/histogram.d.ts +11 -0
  18. package/lib/types/chart-builder/configuration/index.d.ts +5 -0
  19. package/lib/types/chart-builder/configuration/pie.d.ts +5 -1
  20. package/lib/types/chart-builder/configuration/point-mapping.d.ts +3 -0
  21. package/lib/types/chart-builder/configuration/treemap.d.ts +8 -0
  22. package/lib/types/chart-builder/conversion/chart-config-converter.d.ts +8 -3
  23. package/lib/types/chart-builder/conversion/chart-context-patch.d.ts +5 -0
  24. package/lib/types/chart-builder/conversion/chart-model-fields.d.ts +6 -0
  25. package/lib/types/chart-builder/conversion/resolve-chart-model-data.d.ts +3 -3
  26. package/lib/types/chart-builder/index.d.ts +5 -0
  27. package/lib/types/chart-builder/internal/host-builder-runtime.d.ts +0 -2
  28. package/lib/types/chart-text-measure-canvas.d.ts +6 -0
  29. package/lib/types/enum.d.ts +34 -1
  30. package/lib/types/facade/builders/f-area-chart-builder.d.ts +2 -2
  31. package/lib/types/facade/builders/f-boxplot-chart-builder.d.ts +5 -0
  32. package/lib/types/facade/builders/f-bubble-chart-builder.d.ts +2 -2
  33. package/lib/types/facade/builders/f-candlestick-chart-builder.d.ts +133 -0
  34. package/lib/types/facade/builders/f-histogram-chart-builder.d.ts +74 -0
  35. package/lib/types/facade/builders/f-line-chart-builder.d.ts +2 -2
  36. package/lib/types/facade/builders/f-pie-chart-builder.d.ts +42 -1
  37. package/lib/types/facade/builders/f-relation-chart-builder.d.ts +38 -0
  38. package/lib/types/facade/builders/f-scatter-chart-builder.d.ts +2 -2
  39. package/lib/types/facade/builders/f-treemap-chart-builder.d.ts +34 -0
  40. package/lib/types/facade/builders/index.d.ts +4 -0
  41. package/lib/types/facade/chart-builder-type-map.d.ts +5 -2
  42. package/lib/types/facade/f-cartesian-chart-builder.d.ts +14 -4
  43. package/lib/types/facade/f-chart-base.d.ts +2 -2
  44. package/lib/types/facade/f-chart-builder-base.d.ts +31 -0
  45. package/lib/types/index.d.ts +10 -9
  46. package/lib/types/models/chart-data-operators/histogram-data.d.ts +10 -0
  47. package/lib/types/models/chart-data-operators/index.d.ts +1 -0
  48. package/lib/types/models/chart-data-operators/operators.d.ts +7 -1
  49. package/lib/types/models/chart-data-operators/treemap-data.d.ts +3 -0
  50. package/lib/types/models/chart-element-edit-overlay/chart-element-edit-overlay.d.ts +2 -1
  51. package/lib/types/models/chart-locale-texts.d.ts +15 -1
  52. package/lib/types/models/chart-model.d.ts +368 -164
  53. package/lib/types/models/constants/default-chart-style.d.ts +45 -0
  54. package/lib/types/models/constants/histogram-defaults.d.ts +4 -0
  55. package/lib/types/models/constants/treemap.d.ts +1 -0
  56. package/lib/types/models/data-context-transformers/candlestick-data-context-transformer.d.ts +4 -0
  57. package/lib/types/models/data-context-transformers/histogram-data-context-transformer.d.ts +7 -0
  58. package/lib/types/models/data-context-transformers/treemap-data-context-transformer.d.ts +11 -0
  59. package/lib/types/models/echart-render-model.d.ts +10 -7
  60. package/lib/types/models/echart-to-chart-model-init.d.ts +2 -1
  61. package/lib/types/models/mode-converter/converters/boxplot-chart-converter.d.ts +3 -2
  62. package/lib/types/models/mode-converter/converters/bubble-chart-converter.d.ts +3 -2
  63. package/lib/types/models/mode-converter/converters/candlestick-chart-converter.d.ts +5 -0
  64. package/lib/types/models/mode-converter/converters/combination-chart-converter.d.ts +3 -2
  65. package/lib/types/models/mode-converter/converters/funnel-chart-converter.d.ts +3 -2
  66. package/lib/types/models/mode-converter/converters/heatmap-chart-convert.d.ts +3 -2
  67. package/lib/types/models/mode-converter/converters/histogram-chart-converter.d.ts +4 -0
  68. package/lib/types/models/mode-converter/converters/pareto-chart-converter.d.ts +3 -2
  69. package/lib/types/models/mode-converter/converters/pie-chart-converter.d.ts +3 -2
  70. package/lib/types/models/mode-converter/converters/radar-chart-converter.d.ts +3 -2
  71. package/lib/types/models/mode-converter/converters/relation-chart-converter.d.ts +3 -2
  72. package/lib/types/models/mode-converter/converters/sankey-chart-converter.d.ts +3 -2
  73. package/lib/types/models/mode-converter/converters/scatter-chart-converter.d.ts +3 -2
  74. package/lib/types/models/mode-converter/converters/treemap-chart-converter.d.ts +4 -0
  75. package/lib/types/models/mode-converter/converters/waterfall-chart-converter.d.ts +3 -2
  76. package/lib/types/models/mode-converter/converters/word-cloud-converter.d.ts +3 -2
  77. package/lib/types/models/mode-converter/render-spec-operators/auto-gradient-presets.d.ts +5 -0
  78. package/lib/types/models/mode-converter/render-spec-operators/chart-color.d.ts +23 -0
  79. package/lib/types/models/mode-converter/render-spec-operators/rich-text-inheritance.operator.d.ts +2 -0
  80. package/lib/types/models/mode-converter/render-spec-operators/tool-tip-operator.d.ts +8 -2
  81. package/lib/types/models/mode-converter/render-spec-operators/tools.d.ts +3 -2
  82. package/lib/types/types.d.ts +147 -13
  83. package/lib/types/util.d.ts +1 -7
  84. package/lib/types/wordcloud-chart/canvas.d.ts +3 -3
  85. package/lib/types/wordcloud-chart/core/layout/word-shrink.d.ts +5 -8
  86. package/lib/types/wordcloud-chart/core/text/formatter.d.ts +2 -2
  87. package/lib/types/wordcloud-chart/core/text/normalize.d.ts +2 -2
  88. package/lib/types/wordcloud-chart/defaults.d.ts +2 -2
  89. package/lib/types/wordcloud-chart/index.d.ts +1 -1
  90. package/lib/types/wordcloud-chart/types.d.ts +0 -3
  91. package/lib/umd/facade.js +1 -1
  92. package/lib/umd/index.js +1 -1
  93. package/package.json +5 -5
@@ -76,7 +76,13 @@ export declare enum ChartTypeBits {
76
76
  /** Sankey chart */
77
77
  Sankey = 32768,
78
78
  Heatmap = 65536,
79
- Boxplot = 131072
79
+ Boxplot = 131072,
80
+ /** Candlestick chart */
81
+ Candlestick = 262144,
82
+ /** Histogram chart */
83
+ Histogram = 524288,
84
+ /** Treemap chart */
85
+ Treemap = 1048576
80
86
  }
81
87
  export declare enum CategoryType {
82
88
  Linear = "Linear",
@@ -116,6 +122,33 @@ export declare enum ChartWaterfallPointRole {
116
122
  Change = "change",
117
123
  Total = "total"
118
124
  }
125
+ /** Candlestick point states used by persisted style keys and render classification. */
126
+ export declare const ChartCandlestickState: {
127
+ readonly Rising: "rising";
128
+ readonly Falling: "falling";
129
+ readonly Doji: "doji";
130
+ };
131
+ export type ChartCandlestickState = typeof ChartCandlestickState[keyof typeof ChartCandlestickState];
132
+ /** Histogram bin sizing modes persisted by the semantic chart model. */
133
+ export declare const HistogramBinningMode: {
134
+ readonly Count: "count";
135
+ readonly Width: "width";
136
+ };
137
+ export type HistogramBinningMode = typeof HistogramBinningMode[keyof typeof HistogramBinningMode];
138
+ /** Roles assigned to computed Histogram bins. */
139
+ export declare const ChartHistogramBinKind: {
140
+ readonly Underflow: "underflow";
141
+ readonly Regular: "regular";
142
+ readonly Overflow: "overflow";
143
+ };
144
+ export type ChartHistogramBinKind = typeof ChartHistogramBinKind[keyof typeof ChartHistogramBinKind];
145
+ /** Layout modes for Treemap parent labels. */
146
+ export declare const TreemapParentLabelLayout: {
147
+ readonly Banner: "banner";
148
+ readonly Overlapping: "overlapping";
149
+ readonly None: "none";
150
+ };
151
+ export type TreemapParentLabelLayout = typeof TreemapParentLabelLayout[keyof typeof TreemapParentLabelLayout];
119
152
  export declare enum IRuntimeAxisPriority {
120
153
  Primary = 1,
121
154
  Secondary = 2,
@@ -1,6 +1,6 @@
1
- import type { AreaLineStyle } from '@univerjs-pro/engine-chart';
1
+ import type { AreaLineStyle, IChartLineSeriesPatch } from '@univerjs-pro/engine-chart';
2
2
  import { FCartesianChartBuilder } from '../f-cartesian-chart-builder';
3
- export declare class FAreaChartBuilder extends FCartesianChartBuilder {
3
+ export declare class FAreaChartBuilder extends FCartesianChartBuilder<Omit<IChartLineSeriesPatch, 'selector'>> {
4
4
  /**
5
5
  * Sets the area line style configuration and returns this builder for chaining.
6
6
  *
@@ -0,0 +1,5 @@
1
+ import type { IChartSolidSeriesPatch, IChartSolidSeriesStyleSpec } from '@univerjs-pro/engine-chart';
2
+ import { FCartesianChartBuilder } from '../f-cartesian-chart-builder';
3
+ /** Boxplot keeps its existing automatic preset but does not expose explicit gradients. */
4
+ export declare class FBoxplotChartBuilder extends FCartesianChartBuilder<Omit<IChartSolidSeriesPatch, 'selector'>, IChartSolidSeriesStyleSpec> {
5
+ }
@@ -1,6 +1,6 @@
1
- import type { IChartBubbleMappingSpec } from '@univerjs-pro/engine-chart';
1
+ import type { IChartBubbleMappingSpec, IChartSolidSeriesPatch, IChartSolidSeriesStyleSpec } from '@univerjs-pro/engine-chart';
2
2
  import { FCartesianChartBuilder } from '../f-cartesian-chart-builder';
3
- export declare class FBubbleChartBuilder extends FCartesianChartBuilder {
3
+ export declare class FBubbleChartBuilder extends FCartesianChartBuilder<Omit<IChartSolidSeriesPatch, 'selector'>, IChartSolidSeriesStyleSpec> {
4
4
  /**
5
5
  * Sets the bubble mapping configuration and returns this builder for chaining.
6
6
  *
@@ -0,0 +1,133 @@
1
+ import type { IChartCandlestickMappingSpec, IChartCandlestickStateStyleSpec } from '@univerjs-pro/engine-chart';
2
+ import { FAxisChartBuilder } from '../f-axis-chart-builder';
3
+ /** Fluent semantic builder for a single OHLC Candlestick series. */
4
+ export declare class FCandlestickChartBuilder extends FAxisChartBuilder {
5
+ /**
6
+ * Replaces Open, High, Low, and Close source fields atomically.
7
+ *
8
+ * Category remains configured through `setCategoryField()`. Every supplied index must be a
9
+ * unique non-negative integer. Read the pending or persisted value with
10
+ * `builder.describe().mapping?.candlestick`.
11
+ *
12
+ * @param fields Required semantic OHLC source field indexes.
13
+ * @returns This builder for chaining.
14
+ * @example
15
+ * ```ts
16
+ * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
17
+ * const builder = worksheet.charts.create()
18
+ * .setType(univerAPI.Enum.ChartTypeString.Candlestick)
19
+ * .setCategoryField(0)
20
+ * .setCandlestickFields({ openIndex: 1, highIndex: 2, lowIndex: 3, closeIndex: 4 });
21
+ * const mapping = builder.describe().mapping?.candlestick;
22
+ * ```
23
+ */
24
+ setCandlestickFields(fields: IChartCandlestickMappingSpec): this;
25
+ /**
26
+ * Clears the atomic OHLC mapping while preserving the category field.
27
+ *
28
+ * @returns This builder for chaining.
29
+ * @example
30
+ * ```ts
31
+ * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
32
+ * worksheet.charts.create()
33
+ * .setType(univerAPI.Enum.ChartTypeString.Candlestick)
34
+ * .clearCandlestickFields();
35
+ * ```
36
+ */
37
+ clearCandlestickFields(): this;
38
+ /**
39
+ * Sets semantic Rising candle body and wick style overrides.
40
+ *
41
+ * @param style Rising body and wick style values, passed through without Facade range validation.
42
+ * @returns This builder for chaining.
43
+ * @example
44
+ * ```ts
45
+ * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
46
+ * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick)
47
+ * .setRisingStyle({ color: '#0DA471', hollow: true });
48
+ * ```
49
+ */
50
+ setRisingStyle(style: IChartCandlestickStateStyleSpec): this;
51
+ /**
52
+ * Clears explicit Rising style overrides so runtime defaults apply.
53
+ *
54
+ * @returns This builder for chaining.
55
+ * @example
56
+ * ```ts
57
+ * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
58
+ * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).clearRisingStyle();
59
+ * ```
60
+ */
61
+ clearRisingStyle(): this;
62
+ /**
63
+ * Sets semantic Falling candle body and wick style overrides.
64
+ *
65
+ * @param style Falling body and wick style values, passed through without Facade range validation.
66
+ * @returns This builder for chaining.
67
+ * @example
68
+ * ```ts
69
+ * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
70
+ * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick)
71
+ * .setFallingStyle({ color: '#F05252' });
72
+ * ```
73
+ */
74
+ setFallingStyle(style: IChartCandlestickStateStyleSpec): this;
75
+ /**
76
+ * Clears explicit Falling style overrides so runtime defaults apply.
77
+ *
78
+ * @returns This builder for chaining.
79
+ * @example
80
+ * ```ts
81
+ * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
82
+ * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).clearFallingStyle();
83
+ * ```
84
+ */
85
+ clearFallingStyle(): this;
86
+ /**
87
+ * Sets semantic Doji body and wick style overrides.
88
+ *
89
+ * @param style Doji body and wick style values, passed through without Facade range validation.
90
+ * @returns This builder for chaining.
91
+ * @example
92
+ * ```ts
93
+ * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
94
+ * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick)
95
+ * .setDojiStyle({ color: '#8C8C8C', border: { width: 2 } });
96
+ * ```
97
+ */
98
+ setDojiStyle(style: IChartCandlestickStateStyleSpec): this;
99
+ /**
100
+ * Clears explicit Doji style overrides so runtime defaults apply.
101
+ *
102
+ * @returns This builder for chaining.
103
+ * @example
104
+ * ```ts
105
+ * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
106
+ * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).clearDojiStyle();
107
+ * ```
108
+ */
109
+ clearDojiStyle(): this;
110
+ /**
111
+ * Sets a fixed candle width value without Facade range validation.
112
+ *
113
+ * @param width Fixed candle width in pixels.
114
+ * @returns This builder for chaining.
115
+ * @example
116
+ * ```ts
117
+ * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
118
+ * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).setCandleWidth(18);
119
+ * ```
120
+ */
121
+ setCandleWidth(width: number): this;
122
+ /**
123
+ * Removes the fixed candle width so the renderer chooses it automatically.
124
+ *
125
+ * @returns This builder for chaining.
126
+ * @example
127
+ * ```ts
128
+ * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
129
+ * worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Candlestick).resetCandleWidth();
130
+ * ```
131
+ */
132
+ resetCandleWidth(): this;
133
+ }
@@ -0,0 +1,74 @@
1
+ import { FCartesianChartBuilder } from '../f-cartesian-chart-builder';
2
+ /**
3
+ * Fluent builder for a one-field raw-sample Histogram.
4
+ *
5
+ * Histogram settings are persisted as authored. Rendering uses Scott Auto when explicit
6
+ * binning is ineffective, never emits more than 1000 visible bins, and falls back to a
7
+ * zero visual gap for ineffective gap values.
8
+ *
9
+ * @example
10
+ * const chart = worksheet.charts.create()
11
+ * .setType(univerAPI.Enum.ChartTypeString.Histogram)
12
+ * .setHistogramField(0)
13
+ * .setBinCount(12)
14
+ * .setBinGap(0.1);
15
+ */
16
+ export declare class FHistogramChartBuilder extends FCartesianChartBuilder {
17
+ /**
18
+ * Selects the only active Histogram value field by zero-based source index.
19
+ * @example `builder.setHistogramField(2)`
20
+ */
21
+ setHistogramField(index: number): this;
22
+ /**
23
+ * Clears the active Histogram value field.
24
+ * @example `builder.clearHistogramField()`
25
+ */
26
+ clearHistogramField(): this;
27
+ /**
28
+ * Stores an explicit total visible-bin count. Integers from 1 through 1000 are effective
29
+ * when enabled edge bins still leave room for a regular bin. Other finite values remain
30
+ * persisted and visible through `describe()` but render with Scott Auto. Non-finite calls
31
+ * produce no Pending change.
32
+ * @example `builder.setBinCount(20)`
33
+ */
34
+ setBinCount(count: number): this;
35
+ /**
36
+ * Stores an explicit width. A positive finite width is effective only when the current
37
+ * range produces at most 1000 visible bins; otherwise rendering uses Scott Auto without
38
+ * rewriting the stored value. Non-finite calls produce no Pending change.
39
+ * @example `builder.setBinWidth(2.5)`
40
+ */
41
+ setBinWidth(width: number): this;
42
+ /**
43
+ * Removes explicit binning and restores runtime-only Scott Auto.
44
+ * @example `builder.resetBinning()`
45
+ */
46
+ resetBinning(): this;
47
+ /**
48
+ * Enables the inclusive `x <= threshold` Underflow bin. If both thresholds are present,
49
+ * they are effective only when Underflow is less than Overflow. Non-finite calls are no-op.
50
+ * @example `builder.setUnderflowThreshold(0)`
51
+ */
52
+ setUnderflowThreshold(value: number): this;
53
+ /** Disables Underflow. @example `builder.clearUnderflowThreshold()` */
54
+ clearUnderflowThreshold(): this;
55
+ /**
56
+ * Enables the exclusive `x > threshold` Overflow bin. An ineffective finite threshold
57
+ * pair remains persisted but both thresholds are ignored for rendering. Non-finite calls are no-op.
58
+ * @example `builder.setOverflowThreshold(100)`
59
+ */
60
+ setOverflowThreshold(value: number): this;
61
+ /** Disables Overflow. @example `builder.clearOverflowThreshold()` */
62
+ clearOverflowThreshold(): this;
63
+ /**
64
+ * Stores the visual gap ratio. Values from 0 through 0.9 are effective; other finite values
65
+ * remain persisted but render with the 0.007-gap default. Non-finite calls are no-op.
66
+ * @example `builder.setBinGap(0.15)`
67
+ */
68
+ setBinGap(value: number): this;
69
+ /**
70
+ * Removes the explicit gap and restores the 0.007 runtime default.
71
+ * @example `builder.resetBinGap()`
72
+ */
73
+ resetBinGap(): this;
74
+ }
@@ -1,6 +1,6 @@
1
- import type { IChartSeriesBorderSpec } from '@univerjs-pro/engine-chart';
1
+ import type { IChartLineSeriesPatch, IChartSeriesBorderSpec } from '@univerjs-pro/engine-chart';
2
2
  import { FCartesianChartBuilder } from '../f-cartesian-chart-builder';
3
- export declare class FLineChartBuilder extends FCartesianChartBuilder {
3
+ export declare class FLineChartBuilder extends FCartesianChartBuilder<Omit<IChartLineSeriesPatch, 'selector'>> {
4
4
  /**
5
5
  * Sets the line style configuration and returns this builder for chaining.
6
6
  *
@@ -1,6 +1,47 @@
1
- import type { IChartPieLabelSpec } from '@univerjs-pro/engine-chart';
1
+ import type { IChartPieLabelSpec, IChartSliceStyleSpec } from '@univerjs-pro/engine-chart';
2
2
  import { FChartBuilderBase } from '../f-chart-builder-base';
3
3
  export declare class FPieChartBuilder extends FChartBuilderBase {
4
+ /**
5
+ * Sets the style for the materialized slice at `index`.
6
+ *
7
+ * This method executes synchronously.
8
+ *
9
+ * @param index The zero-based slice index.
10
+ * @param value The slice style patch.
11
+ * @returns This builder for chaining.
12
+ * @example
13
+ * ```ts
14
+ * import { chartLinearGradient } from '@univerjs-pro/engine-chart';
15
+ *
16
+ * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
17
+ * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Pie);
18
+ * const color = chartLinearGradient({
19
+ * start: { x: 0, y: 0 },
20
+ * end: { x: 1, y: 1 },
21
+ * stops: [
22
+ * { offset: 0, color: '#fff1b8' },
23
+ * { offset: 1, color: '#faad14' },
24
+ * ],
25
+ * });
26
+ * builder.setSliceStyle(0, { color });
27
+ * ```
28
+ */
29
+ setSliceStyle(index: number, value: IChartSliceStyleSpec): this;
30
+ /**
31
+ * Clears the authored style for the materialized slice at `index`.
32
+ *
33
+ * This method executes synchronously.
34
+ *
35
+ * @param index The zero-based slice index.
36
+ * @returns This builder for chaining.
37
+ * @example
38
+ * ```ts
39
+ * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
40
+ * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Pie);
41
+ * builder.clearSliceStyle(0);
42
+ * ```
43
+ */
44
+ clearSliceStyle(index: number): this;
4
45
  /**
5
46
  * Sets the doughnut hole configuration and returns this builder for chaining.
6
47
  *
@@ -1,5 +1,43 @@
1
1
  import type { IChartRelationForceSpec, LinePointShape, RelationChartLayoutEnum } from '@univerjs-pro/engine-chart';
2
2
  import { FChartBuilderBase } from '../f-chart-builder-base';
3
+ /**
4
+ * Configures a relation chart.
5
+ *
6
+ * @remarks
7
+ * Relation chart sources are recognized in the following order:
8
+ *
9
+ * 1. **Co-word matrix**. For `N` node rows, the converted chart data must contain `N + 2`
10
+ * dimension headers and `N + 1` source columns. Headers starting at index `2`
11
+ * provide node names, source column `1` provides each node's category, and numeric matrix cells
12
+ * provide link weights. This format is checked before the edge-list format.
13
+ * Use this format when nodes need different categories.
14
+ * 2. **Edge list**. Column `0` is the source node and column `1` is the target node. Both must
15
+ * contain non-empty strings. An optional numeric weight column must contain finite, non-negative
16
+ * values; without one, every link has weight `1`.
17
+ *
18
+ * A two-column edge list is treated as unweighted. A three-column edge list uses column `2` as its
19
+ * weight automatically. If the range has more than three columns, select exactly one weight column
20
+ * with {@link FChartBuilderBase.setValueFields}; selecting multiple weight columns or either endpoint
21
+ * column makes the source invalid. A weighted edge list creates at most one category, named after
22
+ * the selected weight column when that column has a non-empty header. An unweighted edge list
23
+ * creates no categories.
24
+ *
25
+ * @example
26
+ * A worksheet range `A1:C4` can contain this weighted edge list:
27
+ *
28
+ * | Source | Target | Weight |
29
+ * | --- | --- | ---: |
30
+ * | A | B | 5 |
31
+ * | A | C | 3 |
32
+ * | C | B | 2 |
33
+ *
34
+ * ```ts
35
+ * worksheet.charts.create()
36
+ * .setSource('A1:C4')
37
+ * .setType(univerAPI.Enum.ChartTypeString.Relation)
38
+ * .setValueFields([2]);
39
+ * ```
40
+ */
3
41
  export declare class FRelationChartBuilder extends FChartBuilderBase {
4
42
  /**
5
43
  * Sets the layout configuration and returns this builder for chaining.
@@ -1,6 +1,6 @@
1
- import type { IChartScatterMappingSpec } from '@univerjs-pro/engine-chart';
1
+ import type { IChartScatterMappingSpec, IChartSolidSeriesPatch, IChartSolidSeriesStyleSpec } from '@univerjs-pro/engine-chart';
2
2
  import { FCartesianChartBuilder } from '../f-cartesian-chart-builder';
3
- export declare class FScatterChartBuilder extends FCartesianChartBuilder {
3
+ export declare class FScatterChartBuilder extends FCartesianChartBuilder<Omit<IChartSolidSeriesPatch, 'selector'>, IChartSolidSeriesStyleSpec> {
4
4
  /**
5
5
  * Sets the scatter mapping configuration and returns this builder for chaining.
6
6
  *
@@ -0,0 +1,34 @@
1
+ import type { IChartTreemapLabelSpec, TreemapParentLabelLayout } from '@univerjs-pro/engine-chart';
2
+ import { FChartBuilderBase } from '../f-chart-builder-base';
3
+ /**
4
+ * Fluent semantic builder for an automatically laid-out Treemap.
5
+ *
6
+ * Field indexes are zero-based in the orientation-normalized dataset. Rendering needs at
7
+ * least one ordered hierarchy field and exactly one value field. Duplicate complete paths
8
+ * sum finite numeric values; blank, textual, non-finite, and final non-positive values do
9
+ * not render. Parent-owned facts add to child totals. Layout is automatic and navigation
10
+ * is disabled. The runtime defaults are banner parent labels and visible category-name
11
+ * leaf labels; labels may hide when their rectangle cannot fit the complete content.
12
+ *
13
+ * @example
14
+ * const chart = worksheet.charts.create()
15
+ * .setType(univerAPI.Enum.ChartTypeString.Treemap)
16
+ * .setHierarchyFields([0, 1, 2])
17
+ * .setValueField(3)
18
+ * .setParentLabelLayout('banner')
19
+ * .setTreemapLabel({ visible: true, contentType: univerAPI.Enum.LabelContentType.CategoryName });
20
+ */
21
+ export declare class FTreemapChartBuilder extends FChartBuilderBase {
22
+ /** Replaces the ordered root-to-leaf hierarchy with zero-based field indexes. */
23
+ setHierarchyFields(indexes: readonly number[]): this;
24
+ /** Replaces the sole numeric value field with a zero-based field index. */
25
+ setValueField(index: number): this;
26
+ /** Sets parent names to a reserved banner, overlapping text, or hidden. */
27
+ setParentLabelLayout(layout: TreemapParentLabelLayout): this;
28
+ /** Removes the explicit parent layout and restores the runtime banner default. */
29
+ resetParentLabelLayout(): this;
30
+ /** Sets leaf font and CategoryName/Value content. Other content bits are inert. */
31
+ setTreemapLabel(label: IChartTreemapLabelSpec): this;
32
+ /** Removes explicit leaf-label style and restores visible category-name labels. */
33
+ resetTreemapLabel(): this;
34
+ }
@@ -1,13 +1,17 @@
1
1
  export { FAreaChartBuilder } from './f-area-chart-builder';
2
+ export { FBoxplotChartBuilder } from './f-boxplot-chart-builder';
2
3
  export { FBubbleChartBuilder } from './f-bubble-chart-builder';
4
+ export { FCandlestickChartBuilder } from './f-candlestick-chart-builder';
3
5
  export { FCombinationChartBuilder } from './f-combination-chart-builder';
4
6
  export { FFunnelChartBuilder } from './f-funnel-chart-builder';
5
7
  export { FHeatmapChartBuilder } from './f-heatmap-chart-builder';
8
+ export { FHistogramChartBuilder } from './f-histogram-chart-builder';
6
9
  export { FLineChartBuilder } from './f-line-chart-builder';
7
10
  export { FParetoChartBuilder } from './f-pareto-chart-builder';
8
11
  export { FPieChartBuilder } from './f-pie-chart-builder';
9
12
  export { FRadarChartBuilder } from './f-radar-chart-builder';
10
13
  export { FRelationChartBuilder } from './f-relation-chart-builder';
11
14
  export { FScatterChartBuilder } from './f-scatter-chart-builder';
15
+ export { FTreemapChartBuilder } from './f-treemap-chart-builder';
12
16
  export { FWaterfallChartBuilder } from './f-waterfall-chart-builder';
13
17
  export { FWordCloudChartBuilder } from './f-word-cloud-chart-builder';
@@ -1,5 +1,5 @@
1
1
  import type { ChartTypeString } from '@univerjs-pro/engine-chart';
2
- import type { FAreaChartBuilder, FBubbleChartBuilder, FCombinationChartBuilder, FFunnelChartBuilder, FHeatmapChartBuilder, FLineChartBuilder, FParetoChartBuilder, FPieChartBuilder, FRadarChartBuilder, FRelationChartBuilder, FScatterChartBuilder, FWaterfallChartBuilder, FWordCloudChartBuilder } from './builders';
2
+ import type { FAreaChartBuilder, FBoxplotChartBuilder, FBubbleChartBuilder, FCandlestickChartBuilder, FCombinationChartBuilder, FFunnelChartBuilder, FHeatmapChartBuilder, FHistogramChartBuilder, FLineChartBuilder, FParetoChartBuilder, FPieChartBuilder, FRadarChartBuilder, FRelationChartBuilder, FScatterChartBuilder, FTreemapChartBuilder, FWaterfallChartBuilder, FWordCloudChartBuilder } from './builders';
3
3
  import type { FCartesianChartBuilder } from './f-cartesian-chart-builder';
4
4
  import type { FChartBuilderBase } from './f-chart-builder-base';
5
5
  export interface IChartBuilderTypeMap {
@@ -26,5 +26,8 @@ export interface IChartBuilderTypeMap {
26
26
  [ChartTypeString.Pareto]: FParetoChartBuilder;
27
27
  [ChartTypeString.Sankey]: FChartBuilderBase;
28
28
  [ChartTypeString.Heatmap]: FHeatmapChartBuilder;
29
- [ChartTypeString.Boxplot]: FCartesianChartBuilder;
29
+ [ChartTypeString.Boxplot]: FBoxplotChartBuilder;
30
+ [ChartTypeString.Candlestick]: FCandlestickChartBuilder;
31
+ [ChartTypeString.Histogram]: FHistogramChartBuilder;
32
+ [ChartTypeString.Treemap]: FTreemapChartBuilder;
30
33
  }
@@ -1,6 +1,6 @@
1
1
  import type { ChartAllSeriesStyleTarget, ChartAxisPointerTarget, ChartPublicSeriesSelector, ChartSeriesClearTarget, ChartSeriesTrendlineSelector, ChartTrendlineSelector, ChartTrendlineValue, IChartAxisPointerSpec, IChartBarSpec, IChartSeriesPatch, IChartSeriesStyleSpec } from '@univerjs-pro/engine-chart';
2
2
  import { FAxisChartBuilder } from './f-axis-chart-builder';
3
- export declare class FCartesianChartBuilder<TSeriesPatch extends Omit<IChartSeriesPatch, 'selector'> = Omit<IChartSeriesPatch, 'selector'>> extends FAxisChartBuilder {
3
+ export declare class FCartesianChartBuilder<TSeriesPatch extends Omit<IChartSeriesPatch, 'selector'> = Omit<IChartSeriesPatch, 'selector'>, TSeriesStyle extends IChartSeriesStyleSpec = IChartSeriesStyleSpec> extends FAxisChartBuilder {
4
4
  readonly __seriesPatchType?: TSeriesPatch;
5
5
  setBar(value: IChartBarSpec): this;
6
6
  clearBar(): this;
@@ -14,9 +14,19 @@ export declare class FCartesianChartBuilder<TSeriesPatch extends Omit<IChartSeri
14
14
  * @returns This builder for chaining.
15
15
  * @example
16
16
  * ```ts
17
+ * import { chartLinearGradient } from '@univerjs-pro/engine-chart';
18
+ *
17
19
  * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
18
- * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Line);
19
- * builder.setSeries(0, { color: '#1677ff' });
20
+ * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Column);
21
+ * const color = chartLinearGradient({
22
+ * start: { x: 0, y: 1 },
23
+ * end: { x: 0, y: 0 },
24
+ * stops: [
25
+ * { offset: 0, color: 'rgba(22, 119, 255, 0)' },
26
+ * { offset: 1, color: '#1677ff' },
27
+ * ],
28
+ * });
29
+ * builder.setSeries(0, { color });
20
30
  * ```
21
31
  */
22
32
  setSeries(selector: ChartPublicSeriesSelector, patch: TSeriesPatch): this;
@@ -50,7 +60,7 @@ export declare class FCartesianChartBuilder<TSeriesPatch extends Omit<IChartSeri
50
60
  * builder.setAllSeriesStyle({ color: '#1677ff', fillOpacity: 0.8 });
51
61
  * ```
52
62
  */
53
- setAllSeriesStyle(style: IChartSeriesStyleSpec): this;
63
+ setAllSeriesStyle(style: TSeriesStyle): this;
54
64
  /**
55
65
  * Clears persistent defaults inherited by every series.
56
66
  *
@@ -1,4 +1,4 @@
1
- import type { ChartBuilder, ChartDescription, IChartRenderModelImageExportOptions, IChartRenderModelImageExportResult, IResolvedChartData } from '@univerjs-pro/engine-chart';
1
+ import type { ChartBuilder, ChartDescription, IChartData, IChartRenderModelImageExportOptions, IChartRenderModelImageExportResult } from '@univerjs-pro/engine-chart';
2
2
  import type { DeepReadonly } from '@univerjs/core';
3
3
  import type { IChartBuilderFacadeContext, IChartBuilderFacadeContextAccess } from './internal/chart-builder-facade-context';
4
4
  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 =
51
51
  * console.log(data.series);
52
52
  * ```
53
53
  */
54
- resolveData(): DeepReadonly<IResolvedChartData>;
54
+ resolveData(): DeepReadonly<IChartData>;
55
55
  /**
56
56
  * Commits all pending builder changes synchronously.
57
57
  *
@@ -195,6 +195,37 @@ export declare class FChartBuilderBase<TBuilder extends ChartBuilder = ChartBuil
195
195
  * ```
196
196
  */
197
197
  clearAppearance(target?: ChartAppearanceTarget): this;
198
+ /**
199
+ * Enables or disables the automatic gradient preset for supported chart marks.
200
+ *
201
+ * Explicit gradient colors configured on a series or slice take precedence over this preset.
202
+ * This method executes synchronously.
203
+ *
204
+ * @param value Whether to apply the chart type's automatic gradient preset.
205
+ * @returns This builder for chaining.
206
+ * @example
207
+ * ```ts
208
+ * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
209
+ * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Column);
210
+ * builder.setAutoGradientFill(true);
211
+ * ```
212
+ */
213
+ setAutoGradientFill(value: boolean): this;
214
+ /**
215
+ * Clears the automatic-gradient override and restores the chart type's default behavior.
216
+ *
217
+ * This method executes synchronously.
218
+ *
219
+ * @returns This builder for chaining.
220
+ * @example
221
+ * ```ts
222
+ * const worksheet = univerAPI.getActiveWorkbook().getActiveSheet();
223
+ * const builder = worksheet.charts.create().setType(univerAPI.Enum.ChartTypeString.Column);
224
+ * builder.setAutoGradientFill(true);
225
+ * builder.resetAutoGradientFill();
226
+ * ```
227
+ */
228
+ resetAutoGradientFill(): this;
198
229
  /**
199
230
  * Sets the invalid value strategy configuration and returns this builder for chaining.
200
231
  *
@@ -1,15 +1,18 @@
1
- export type { ChartDescription, ChartLegendSpec, ChartPublicSeriesSelector, ChartSeriesSelector, ChartSeriesTrendlineSelector, ChartSubtitleSpec, ChartTitleSpec, IChartAggregationSpec, IChartAppearanceSpec, IChartAreaSpec, IChartAxesSpec, IChartAxisBindingDescription, IChartAxisLabelSpec, IChartAxisPointerSpec, IChartAxisSpec, IChartBarSpec, IChartBubbleMappingSpec, IChartDescription, IChartFontSpec, IChartFunnelSpec, IChartHeatmapLabelSpec, IChartHeatmapSpec, IChartLegendOptions, IChartMappingSpec, IChartMarkLineLabelSpec, IChartMarkLineSpec, IChartParetoBarLabelStyleSpec, IChartParetoBarStyleSpec, IChartParetoBorderStyleSpec, IChartParetoLineLabelStyleSpec, IChartParetoLineStyleSpec, IChartParetoPointStyleSpec, IChartParetoSpec, IChartPieLabelSpec, IChartPieSpec, IChartRadarSpec, IChartRelationForceSpec, IChartRelationSpec, IChartScatterMappingSpec, IChartSeriesBorderSpec, IChartSeriesDescription, IChartSeriesLabelSpec, IChartSeriesPatch, IChartSeriesPointSpec, IChartSeriesStyleSpec, IChartSubtitleOptions, IChartTitleOptions, IChartTrendlineSpec, IChartWaterfallConnectorStyleSpec, IChartWaterfallPointRoleSpec, IChartWaterfallSpec, IChartWordCloudDescription, IChartWordCloudSpec, IInlineChartBuilderAdapter, IInlineChartHostPatch, IResolvedChartData, } from './chart-builder';
2
- export { AREA_CHART_TYPES, AXIS_CHART_TYPES, CARTESIAN_CHART_TYPES, ChartAggregationTarget, ChartAllSeriesStyleTarget, ChartAppearanceTarget, ChartAxisName, ChartAxisPointerTarget, ChartAxisTarget, ChartAxisTickPosition, ChartSeriesAxis, ChartSeriesClearTarget, ChartSeriesTypeString, ChartTypeString, ChartVisualMapType, ChartWaterfallStyleTarget, ChartWordCloudShapeSource, DEFAULT_CHART_TYPE, } from './chart-builder';
3
- export { ChartBuilder, chartTypeToBits, clearAggregation, clearAllSeriesStyle, clearAppearance, clearAreaLineStyle, clearAxisPointer, clearAxisTitle, clearBar, clearBubbleMapping, clearCategoryField, clearCellLabel, clearCumulativeLineStyle, clearDoughnutHole, clearLegend, clearLineStyle, clearMarkLines, clearPalette, clearMaskImage, clearParetoBarStyle, clearPieLabel, clearRelationForce, clearRightYAxis, clearScatterMapping, clearSeries, clearSliceBorderColor, clearSubtitle, clearTheme, clearTitle, clearTrendlines, clearValueFields, clearValueRange, clearValueSuffix, clearValueUnit, clearWaterfallConnector, clearWaterfallStyle, clearXAxis, clearYAxis, describeChartModel, DetachedChartBuilderAdapter, InlineChartBuilder, removeTrendline, 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, 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, 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';
1
+ 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';
2
+ 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';
3
+ 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';
4
4
  export type { ChartPendingConfig, ChartTrendlineSelector, ChartTrendlineValue, IChartBuilderAdapter, IChartCreateConfig, } from './chart-builder';
5
- export { AreaLineStyle, BarShape, AxisAlignEnum, AxisValueType, 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';
5
+ export { normalizeCandlestickInlineTable } from './chart-builder/candlestick-inline-table';
6
+ export { createChartStarterRows } from './chart-builder/chart-starter-data';
7
+ 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';
6
8
  export { buildChartData, RelationColumnIndex } from './models/chart-data-operators/build-chart-data';
7
9
  export { CartesianPointRoleIndex, CartesianPointValueIndex } from './models/chart-data-operators/cartesian-point-data';
10
+ export { MAX_HISTOGRAM_BIN_COUNT } from './models/chart-data-operators/histogram-data';
8
11
  export { defaultChartContextOperators, findCategoryIndexes, findCategoryOperator, findHeaderOperator, findSeriesOperator, generateChartModelContextByOperators, pieSeriesFilterOperator, } from './models/chart-data-operators/operators';
9
12
  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';
10
13
  export type { IResolveChartHostFrameStyleInput, IResolveDefaultChartHostFrameStyleInput, } from './models/chart-host-style';
11
14
  export type { IChartLocaleTexts } from './models/chart-locale-texts';
12
- export { getDefaultChartLocaleTexts, replaceLocaleParams } from './models/chart-locale-texts';
15
+ export { getDefaultChartLocaleTexts, replaceLocaleParams, resolveChartLocaleTexts } from './models/chart-locale-texts';
13
16
  export { CHART_DEBOUNCE_TIME, ChartModel, } from './models/chart-model';
14
17
  export { resolveChartRenderModelImageExportInput } from './models/chart-render-input-resolver';
15
18
  export type { IChartRenderInputRuntime, IResolveChartRenderModelImageExportInputParams, } from './models/chart-render-input-resolver';
@@ -23,6 +26,7 @@ export type { IEchartTheme } from './models/constants/build-in-theme';
23
26
  export { getThemeProps } from './models/constants/build-in-theme';
24
27
  export { defaultChartHeight, defaultChartWidth, EChartRenderEngineName } from './models/constants/default';
25
28
  export { defaultChartConfig, RTLChartStyle, themeColors } from './models/constants/default-chart-style';
29
+ export { MAX_HISTOGRAM_BIN_GAP } from './models/constants/histogram-defaults';
26
30
  export { EChartRenderEngine, EChartRenderModel } from './models/echart-render-model';
27
31
  export type { IEChartRenderModelOptions } from './models/echart-render-model';
28
32
  export { echartToChartModelInit, isChartModelInit } from './models/echart-to-chart-model-init';
@@ -35,7 +39,7 @@ export { toChartDataItem } from './source/chart-data-item';
35
39
  export { ChartDataSource } from './source/chart-source';
36
40
  export { StaticChartSource } from './source/static-chart-source';
37
41
  export { ChartHostRenderMode, ChartImageSourceType } from './types';
38
- 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';
42
+ 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';
39
43
  export { chartBitsUtils, chartTypeCanUseTrendLine, mergeChartConfig, } from './util';
40
44
  export * from './utils/echarts';
41
45
  export { WordCloudResourceConfig } from './word-cloud-resource/word-cloud-resource-config';
@@ -73,9 +77,6 @@ export type { IWordCloudPlacedWord } from './wordcloud-chart/types';
73
77
  export type { IWordCloudProtocolSpec } from './wordcloud-chart/types';
74
78
  export type { IWordCloudSegmentationRegion } from './wordcloud-chart/types';
75
79
  export type { IWordCloudSegmentationResult } from './wordcloud-chart/types';
76
- export type { IWordCloudSeriesDataItem } from './wordcloud-chart/types';
77
- export type { IWordCloudSeriesOption } from './wordcloud-chart/types';
78
- export type { IWordCloudSpecBase } from './wordcloud-chart/types';
79
80
  export type { IWordCloudTextMarkAttrs } from './wordcloud-chart/types';
80
81
  export type { IWordCloudTextMarkSpec } from './wordcloud-chart/types';
81
82
  export type { IWordCloudTextMeasurer } from './wordcloud-chart/types';