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

package/lib/types/models/chart-render/format/chart-value-format.d.ts

@@ -0,0 +1,16 @@
+/** Canonical authored formats shared by chart editors and Facade consumers. */
+export declare const CHART_VALUE_FORMAT_PRESETS: {
+    readonly source: null;
+    readonly number: "#,##0.00";
+    readonly percentage: "0.00%";
+    readonly currency: "$#,##0.00";
+    readonly scientific: "0.00E+00";
+};
+/** Stable representative value used only for editor previews. */
+export declare const CHART_VALUE_FORMAT_PREVIEW_VALUE = 1234.5;
+/**
+ * Formats one semantic chart value without exposing renderer formatter contracts.
+ * Invalid authored patterns fall back to the source display text.
+ */
+export declare function formatChartValue(value: number, sourceFormattedValue: string, format?: string): string;
+export declare function toPercentage(value: number, fractionDigits?: number): string;

package/lib/types/models/{chart-runtime-style.d.ts → chart-render/style/chart-runtime-style.d.ts}

@@ -1,5 +1,5 @@
-import type { ChartStyle } from '../types';
-import { ChartTypeBits } from '../enum';
+import type { ChartRuntimeStyle, ChartStyle } from '../../../types';
+import { ChartTypeBits } from '../../../enum';
 /**
  * Converts persisted semantic chart style buckets into transient render buckets.
  *
@@ -9,5 +9,6 @@ import { ChartTypeBits } from '../enum';
  * saved field names. This resolver swaps y-axis option/title buckets only in
  * the runtime render style consumed by physical-position operators.
  */
+export declare function resolveChartRuntimeStyle(style: ChartRuntimeStyle, chartType?: ChartTypeBits): ChartRuntimeStyle;
 export declare function resolveChartRuntimeStyle(style: ChartStyle, chartType?: ChartTypeBits): ChartStyle;
 export declare function resolveChartStyleBackgroundColor(style?: Pick<ChartStyle, 'backgroundColor'> | null): string;

package/lib/types/models/common/chart-field-diagnostic.d.ts

@@ -0,0 +1,14 @@
+import type { ChartTypeBits } from '../../enum';
+export declare enum ChartFieldDiagnosticCode {
+    MissingCategoryFields = "chart-field.missing-category-fields",
+    MissingSeriesFields = "chart-field.missing-series-fields",
+    InvalidFieldIndex = "chart-field.invalid-field-index",
+    InvalidValueFieldType = "chart-field.invalid-value-field-type",
+    InvalidDataStructure = "chart-field.invalid-data-structure",
+    UnsupportedChartType = "chart-field.unsupported-chart-type"
+}
+export interface IChartFieldDiagnostic {
+    code: ChartFieldDiagnosticCode;
+    chartType: ChartTypeBits;
+    details?: Readonly<Record<string, number | string>>;
+}

package/lib/types/models/common/chart-field-role.d.ts

@@ -0,0 +1,53 @@
+export declare const ChartFieldRoleIndex: {
+    readonly CategoryValue: {
+        readonly Category: 0;
+        readonly Value: 0;
+    };
+    readonly Point: {
+        readonly Label: 0;
+        readonly X: 0;
+        readonly Y: 1;
+    };
+    readonly Bubble: {
+        readonly Label: 0;
+        readonly Group: 1;
+        readonly X: 0;
+        readonly Y: 1;
+        readonly Size: 2;
+    };
+    readonly Hierarchy: {
+        readonly Value: 0;
+    };
+    readonly Candlestick: {
+        readonly Category: 0;
+        readonly Open: 0;
+        readonly High: 1;
+        readonly Low: 2;
+        readonly Close: 3;
+    };
+    readonly Edge: {
+        readonly Source: 0;
+        readonly Target: 1;
+        readonly Value: 0;
+    };
+};
+export declare const ChartFieldRoleCount: {
+    readonly None: 0;
+    readonly CategoryValue: {
+        readonly Category: 1;
+        readonly Value: 1;
+    };
+    readonly Point: {
+        readonly XY: 2;
+    };
+    readonly Bubble: {
+        readonly Labels: 2;
+        readonly Values: 3;
+    };
+    readonly Edge: {
+        readonly Endpoints: 2;
+    };
+    readonly Candlestick: {
+        readonly OHLC: 4;
+    };
+};

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

@@ -0,0 +1,44 @@
+export interface IChartLocaleTexts {
+    seriesDefaultName: string;
+    categoryDefaultName: string;
+    blank: string;
+    boxplotMin: string;
+    boxplotQ1: string;
+    boxplotMedian: string;
+    boxplotQ3: string;
+    boxplotMax: string;
+    bubbleEmptyTips: string;
+    cloudWord: string;
+    cloudFrequency: string;
+    msgEmptyTips: string;
+    msgSankeyCircularTips: string;
+    paretoLineName: string;
+    pieAggregateOther: string;
+    pieAggregateMembers: string;
+    relationEmptyTips: string;
+    waterfallPositive: string;
+    waterfallNegative: string;
+    waterfallSubtotal: string;
+    candlestickSeries: string;
+    candlestickCategory: string;
+    candlestickOpen: string;
+    candlestickHigh: string;
+    candlestickLow: string;
+    candlestickClose: string;
+    histogramFrequency: string;
+    treemapEmptyTips: string;
+    treemapOwnValue: string;
+    treemapChildren: string;
+    sunburstEmptyTips: string;
+    sunburstOwnValue: string;
+    sunburstChildren: string;
+    gaugeEmptyTips: string;
+    gaugeInvalidMapping: string;
+    gaugeInvalidConfig: string;
+    chordEmptyTips: string;
+    chordInvalidMapping: string;
+    chordInvalidConfig: string;
+    chordCount: string;
+    chordAssociatedValue: string;
+}
+export declare function replaceLocaleParams(text: string, ...args: string[]): string;

package/lib/types/models/common/constants/chord.d.ts

@@ -0,0 +1,5 @@
+import type { IChartChordMappingSpec } from '../../../types';
+export declare const DEFAULT_CHORD_SOURCE_INDEX = 0;
+export declare const DEFAULT_CHORD_TARGET_INDEX = 1;
+export declare const DEFAULT_CHORD_VALUE_INDEX = 2;
+export declare const DEFAULT_CHORD_MAPPING: Readonly<IChartChordMappingSpec>;