@advt-gpt-chart/package 3.2.1 → 3.2.4

package/dist/DataView/Dataset/transforms.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 数据转换工具函数
+ *
+ * 这些是纯工具函数，不依赖 DataView 类实例状态
+ */
+import { Dayjs } from 'dayjs';
+import { ChartJson } from '../../Chart/ChartCodeRender/type';
+import { ChartType } from '../../types/chart';
+import { DataItem } from '../../types/chart';
+import { TimeGrainType } from '../../utils/date';
+import { Dataset, FieldInfoItem } from '../Dataset/types';
+/**
+ * 过滤数据
+ * 根据 metrics 和 dimensions 过滤数据字段
+ */
+export declare const filterDataByFieldInfo: (data: Record<string, any>[], { metrics, dimensions }: {
+    metrics?: string[];
+    dimensions?: string[];
+}) => Record<string, any>[];
+/**
+ * Fold 转换
+ * 将宽数据转换为长数据
+ */
+export declare const transform2FoldData: (data: Record<string, any>[], dimensions?: string[], metrics?: string[]) => {
+    foldData: DataItem[];
+    foldKey?: string;
+    foldValue?: string;
+    isMetricFolded: boolean;
+};
+/**
+ * 设置字段角色
+ * 根据 metrics 和 dimensions 设置字段的 role
+ */
+export declare const setFieldItem: (item: FieldInfoItem, metrics?: any[], dimensions?: any[]) => FieldInfoItem;
+/**
+ * 按维度合并数据
+ * 生成合并列名，用于数据分组
+ */
+export declare const mergeDataByDimensions: (data: Record<string, any>[], fieldInfo: FieldInfoItem[], type: ChartType, dimensions?: string[], metrics?: string[]) => {
+    data: DataItem[];
+    isColumnMegred?: boolean;
+    megreColumnName?: string;
+};
+/**
+ * 时间补点
+ * 根据时间范围和时间粒度补全缺失的数据点
+ */
+export declare const transform2FillData: (data: Record<string, any>[], { fieldInfo, dimensions, metrics, timeGrain, }: {
+    fieldInfo?: FieldInfoItem[];
+    dimensions?: string[];
+    metrics?: string[];
+    timeGrain?: TimeGrainType;
+}) => Record<string, any>[];
+/**
+ * 生成时间序列
+ * 根据时间范围和时间粒度生成时间序列
+ */
+export declare const generateTimeSeries: (startTime: any, endTime: any, timeGrain: any) => string[];
+/**
+ * 填充数据
+ * 根据时间序列填充缺失的数据点
+ */
+export declare const filledDataByTimeSeries: (sortedData: Record<string, any>[] | undefined, timeSeries: string[], timeGrain: TimeGrainType, timeField: string, metrics?: string[]) => Record<string, any>[];
+/**
+ * 获取时间间隔
+ * 根据时间粒度计算时间间隔（毫秒）
+ */
+export declare const getTimeGrainInterval: (timeGrain: string, sortedData: any[], timeField: string) => number;
+/**
+ * 格式化时间到粒度
+ * 将时间值格式化为指定粒度的字符串
+ */
+export declare const formatTime2TimeGrain: (timeGrain: TimeGrainType, value: Dayjs | number) => string;
+/**
+ * 获取字段信息
+ * 从数据中提取字段信息并设置角色
+ */
+export declare const getFileldInfo: (data: Record<string, any>[], { columns, metrics, dimensions, }: {
+    columns?: Record<string, any>[];
+    metrics?: string[];
+    dimensions?: string[];
+}) => FieldInfoItem[];
+/**
+ * 检查是否需要更新 DataSet
+ * 比较新旧数据，判断是否需要重新转换
+ */
+export declare const checkUptateDataSet: (preJson: ChartJson, newJson: ChartJson, dataset: Dataset) => {
+    dataset?: Dataset;
+    isShouldUpdate: boolean;
+};
+export declare const transform2FillAndMegreData: (data: any[] | undefined, fieldInfo: FieldInfoItem[] | undefined, chartJson: ChartJson) => {
+    data: DataItem[];
+    isColumnMegred?: boolean;
+    megreColumnName?: string;
+};

package/dist/{Chart → DataView}/Dataset/types.d.ts

@@ -27,6 +27,7 @@ export interface MetricFormat {
     prefix?: string;
     suffix?: string;
     valueUnit?: string;
+    thousandSeparator?: boolean;
 }
 export type DataFormat = {
     [metricName: string]: MetricFormat;

package/dist/DataView/data-set/data-set.d.ts

@@ -0,0 +1,39 @@
+import { DataItem } from '../../types';
+import { GenericDataType } from '../../utils/data';
+import { multiDimensionTransform, multiMetricTransform } from './transforms';
+import type { DataSetOptions, ProcessedItem, TransformOptions } from './types';
+export declare class DataSet {
+    private data;
+    private options;
+    constructor(data: DataItem[], options?: DataSetOptions);
+    /**
+     * 获取字段类型
+     */
+    getFieldType(fieldName: string): GenericDataType;
+    /**
+     * 获取轴类型
+     */
+    getAxesType(fieldName: string): 'band' | 'linear';
+    /**
+     * 格式化单个值
+     */
+    formatValue(fieldName: string, value: any, formatTimeStr?: string): any;
+    /**
+     * 创建 label 格式化方法
+     */
+    createLabelFormatMethod(fieldName: string): (text: string | string[], datum: any) => any;
+    /**
+     * 创建 tooltip 格式化方法
+     */
+    createTooltipFormatMethod(fieldName: string): (datum: any) => any;
+    format(dataFormat?: DataSetOptions['dataFormat']): DataSet;
+    transform(options: TransformOptions | ((data: DataItem[]) => DataItem[])): DataSet;
+    private applyDeriveTransform;
+    multiDimension(options: Parameters<typeof multiDimensionTransform>[1]): DataSet;
+    multiMetric(options: Parameters<typeof multiMetricTransform>[1]): DataSet;
+    filter(predicate: (item: DataItem) => boolean): DataSet;
+    sort(compareFn?: (a: DataItem, b: DataItem) => number): DataSet;
+    result(): ProcessedItem[];
+    getData(): DataItem[];
+}
+export default DataSet;

package/dist/DataView/data-set/index.d.ts

@@ -0,0 +1,3 @@
+export { DataSet } from './data-set';
+export * from './transforms';
+export * from './types';

package/dist/DataView/data-set/transforms/format-transform.d.ts

@@ -0,0 +1,9 @@
+import { DataItem } from '../../../types';
+import type { ColumnInfo, FormatTransformOptions } from '../types';
+export declare function formatNumber(value: number, config: any): string;
+export declare function formatTime(value: any, timeGrain?: string): string;
+export declare function isTimeFieldType(type: string): boolean;
+export declare function formatTransform(data: DataItem[], options: FormatTransformOptions & {
+    timeGrain?: string;
+    columns?: ColumnInfo[];
+}): DataItem[];

package/dist/DataView/data-set/transforms/index.d.ts

@@ -0,0 +1,3 @@
+export { formatTransform } from './format-transform';
+export { multiDimensionTransform } from './multi-dimension-transform';
+export { multiMetricTransform } from './multi-metric-transform';

package/dist/DataView/data-set/transforms/multi-dimension-transform.d.ts

@@ -0,0 +1,3 @@
+import { DataItem } from '../../../types';
+import type { MultiDimensionOptions } from '../types';
+export declare function multiDimensionTransform(data: DataItem[], options: MultiDimensionOptions): DataItem[];

package/dist/DataView/data-set/transforms/multi-metric-transform.d.ts

@@ -0,0 +1,3 @@
+import { DataItem } from '../../../types';
+import { MultiMetricOptions } from '../types';
+export declare function multiMetricTransform(data: DataItem[], options: MultiMetricOptions): DataItem[];

package/dist/DataView/data-set/types.d.ts

@@ -0,0 +1,55 @@
+import { DataItem } from "../../types";
+export type FormatType = 'none' | 'number' | 'percentage_raw' | 'percentage_scaled' | 'date' | 'time';
+export interface FormatConfig {
+    formatType: FormatType;
+    suffix?: string;
+    prefix?: string;
+    decimalPlaces?: number;
+    valueUnit?: string;
+}
+export interface DataFormat {
+    [field: string]: FormatConfig;
+}
+export interface ColumnInfo {
+    name: string;
+    type: string;
+}
+export interface DataSetOptions {
+    dataFormat?: DataFormat;
+    columns?: ColumnInfo[];
+    timeGrain?: string;
+    timeGrainFormat?: string;
+}
+export interface TransformOptions {
+    type: 'format' | 'multi-dimension' | 'multi-metric' | 'derive' | string;
+    options: any;
+}
+export interface MultiDimensionOptions {
+    dimensions: string[];
+    metrics: string[];
+    transformType: 'fold' | 'pivot';
+    key?: string;
+    value?: string;
+    [key: string]: any;
+}
+export interface MultiMetricOptions {
+    groupBy: string[];
+    aggregations: AggregationConfig[];
+}
+export interface AggregationConfig {
+    field: string;
+    op: 'sum' | 'avg' | 'count' | 'max' | 'min' | string;
+    as: string;
+}
+export type ProcessedItem = DataItem & {
+    [key: string]: any;
+};
+export interface FormatTransformOptions {
+    dataFormat?: DataFormat;
+    timeGrain?: string;
+    columns?: ColumnInfo[];
+}
+export interface DeriveTransformOptions {
+    field: string;
+    formula: (item: DataItem) => any;
+}

package/dist/GPTVis/hooks/useChartStore.d.ts

@@ -1,7 +1,7 @@
 import type { ChartJson } from '../../Chart/ChartCodeRender/type';
 import { ChartControllersState } from '../../Chart/ChartControllers';
-import type { Dataset } from '../../Chart/Dataset/types';
-import { DataSourceQueryInfo } from '../../Chart/DataSource/types';
+import type { Dataset } from '../../DataView/Dataset/types';
+import { DataSourceQueryInfo } from '../../DataView/DataSource/types';
 import { BaseChartProps } from '../../types';
 export interface ContextMenu {
     visible: boolean;

package/dist/components/CustomTimeRange/types.d.ts

@@ -1,7 +1,7 @@
 import { Dayjs } from 'dayjs';
 import { FilterItemType } from '../../Chart/ChartControllers/Filter/types';
 import { OrderItemType } from '../../Chart/ChartControllers/Orders/types';
-import { DataFormat } from '../../Chart/Dataset/types';
+import { DataFormat } from '../../DataView/Dataset/types';
 import { TimeGrainType } from '../../utils';
 export type CustomTimeRange = {
     from?: Dayjs;

package/dist/components/CustomTimeRange/utils.d.ts

@@ -1,4 +1,4 @@
-import { DataSource } from '../../Chart/DataSource/types';
+import { DataSource } from '../../DataView/DataSource/types';
 import { TimeGrainType } from '../../utils';
 import { AdvancedTimeRange, TimeRange } from './types';
 export declare const timeRangeOptions: {