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

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-element-edit-overlay/chart-element-edit-overlay.d.ts

@@ -1,4 +1,5 @@
 import type { IChartElementBounds, IChartElementHit } from '../../types';
+import type { ECharts } from '../../utils/echarts';
 import type { ChartElementEditBorderType, IChartElementEditOverlayPalette } from './types';
 export declare class ChartElementEditOverlay {
     private readonly _getInstance;
@@ -11,7 +12,7 @@ export declare class ChartElementEditOverlay {
     private _hoverBorderHitKey;
     private _fixedBorder;
     private _fixedBorderBounds;
-    constructor(_getInstance: () => echarts.ECharts | null, _getContainer?: () => HTMLElement | null | undefined, _paletteOverride?: Partial<IChartElementEditOverlayPalette> | undefined);
+    constructor(_getInstance: () => ECharts | null, _getContainer?: () => HTMLElement | null | undefined, _paletteOverride?: Partial<IChartElementEditOverlayPalette> | undefined);
     ensure(): any;
     remove(): void;
     clearAll(): void;

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>;