@antv/gpt-vis 0.6.0 → 1.0.0-beta.1

package/dist/esm/vis/violin/index.js

@@ -0,0 +1,245 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { Chart } from '@antv/g2';
+import { getBackgroundColor, getThemeColors, getThemeObject } from "../../util/theme";
+
+/**
+ * ViolinDataItem is the type for each data item in the violin chart.
+ */
+
+/**
+ * ViolinConfig defines the configuration for rendering the violin chart.
+ */
+
+/**
+ * ViolinInstance represents a violin chart instance with render and destroy.
+ */
+
+/**
+ * Violin chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const violin = Violin({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * violin.render({
+ *   type: 'violin',
+ *   data: [
+ *     { category: '班级A', value: 15 },
+ *     { category: '班级A', value: 18 },
+ *     { category: '班级A', value: 22 },
+ *     { category: '班级A', value: 27 },
+ *     { category: '班级A', value: 35 },
+ *   ],
+ *   theme: 'academy'
+ * });
+ *
+ * violin.destroy();
+ * ```
+ */
+export var Violin = function Violin(options) {
+  var container = options.container,
+    width = options.width,
+    height = options.height,
+    _options$theme = options.theme,
+    chartTheme = _options$theme === void 0 ? 'default' : _options$theme;
+  var chart = null;
+
+  /**
+   * Render the violin chart with the given configuration.
+   */
+  var render = function render(config) {
+    var _;
+    var _config$data = config.data,
+      data = _config$data === void 0 ? [] : _config$data,
+      _config$theme = config.theme,
+      theme = _config$theme === void 0 ? chartTheme : _config$theme,
+      title = config.title,
+      axisXTitle = config.axisXTitle,
+      axisYTitle = config.axisYTitle,
+      _config$style = config.style,
+      style = _config$style === void 0 ? {} : _config$style;
+
+    // Clean up previous chart if exists
+    if (chart) {
+      chart.destroy();
+    }
+
+    // Get colors from style.palette or theme defaults
+    var colors = style.palette || getThemeColors(theme);
+    var backgroundColor = style.backgroundColor || getBackgroundColor(theme);
+    var startAtZero = style.startAtZero || false;
+
+    // Determine if data has group field for grouped violin plot
+    var hasGroupField = ((_ = (data || [])[0]) === null || _ === void 0 ? void 0 : _.group) !== undefined;
+
+    // Create chart
+    chart = new Chart({
+      container: container,
+      width: width,
+      height: height,
+      autoFit: true
+    });
+
+    // Configure chart children for violin plot
+    // Violin plot is composed of density plot + boxplot overlay
+    var children = [];
+    if (hasGroupField) {
+      // Grouped violin plot: density by category and group
+      children = [{
+        type: 'density',
+        data: {
+          transform: [{
+            type: 'kde',
+            field: 'value',
+            groupBy: ['category', 'group']
+          }]
+        },
+        encode: {
+          x: 'category',
+          y: 'y',
+          color: 'group',
+          series: 'group',
+          size: 'size'
+        },
+        scale: {
+          y: {
+            nice: true
+          },
+          color: {
+            range: colors
+          }
+        }
+      }, {
+        type: 'boxplot',
+        encode: {
+          x: 'category',
+          y: 'value',
+          series: 'group',
+          color: 'group',
+          shape: 'violin'
+        },
+        style: {
+          opacity: 0.5,
+          strokeOpacity: 0.5,
+          point: false
+        },
+        scale: {
+          y: {
+            nice: true
+          },
+          color: {
+            range: colors
+          }
+        }
+      }];
+    } else {
+      // Simple violin plot: density by category only
+      children = [{
+        type: 'density',
+        data: {
+          transform: [{
+            type: 'kde',
+            field: 'value',
+            groupBy: ['category'],
+            size: 20
+          }]
+        },
+        encode: {
+          x: 'category',
+          y: 'y',
+          color: 'category',
+          size: 'size'
+        },
+        scale: {
+          y: {
+            nice: true
+          },
+          color: {
+            range: colors
+          }
+        }
+      }, {
+        type: 'boxplot',
+        encode: {
+          x: 'category',
+          y: 'value',
+          color: 'category',
+          shape: 'violin'
+        },
+        style: {
+          opacity: 0.5,
+          strokeOpacity: 0.5,
+          point: false
+        },
+        scale: {
+          y: {
+            nice: true
+          },
+          color: {
+            range: colors
+          }
+        }
+      }];
+    }
+
+    // Configure chart options
+    // Note: Using 'any' type due to G2's complex type system with transformations
+    // This is consistent with how G2 5.0 is used elsewhere in the codebase
+    var chartOptions = _objectSpread(_objectSpread({
+      type: 'view',
+      data: data,
+      title: title !== null && title !== void 0 ? title : '',
+      axis: {
+        x: {
+          title: axisXTitle || false
+        },
+        y: {
+          title: axisYTitle || false
+        }
+      },
+      scale: {
+        y: {
+          nice: true,
+          zero: startAtZero
+        }
+      },
+      children: children,
+      legend: {
+        color: hasGroupField ? {
+          position: 'top'
+        } : false
+      }
+    }, backgroundColor ? {
+      viewStyle: {
+        viewFill: backgroundColor
+      }
+    } : {}), {}, {
+      theme: getThemeObject(theme)
+    });
+    chart.options(chartOptions);
+    chart.render();
+  };
+
+  /**
+   * Destroy the chart instance and clean up resources.
+   */
+  var destroy = function destroy() {
+    if (chart) {
+      chart.destroy();
+      chart = null;
+    }
+  };
+  return {
+    render: render,
+    destroy: destroy
+  };
+};

package/dist/esm/vis/waterfall/index.d.ts

@@ -0,0 +1,67 @@
+import type { VisualizationOptions } from '../../types';
+/**
+ * WaterfallDataItem is the type for each data item in the waterfall chart.
+ */
+export type WaterfallDataItem = {
+    category: string;
+    value?: number;
+    isIntermediateTotal?: boolean;
+    isTotal?: boolean;
+};
+/**
+ * WaterfallPalette defines custom colors for positive, negative, total bars.
+ */
+export interface WaterfallPalette {
+    positiveColor?: string;
+    negativeColor?: string;
+    totalColor?: string;
+}
+/**
+ * WaterfallConfig defines the configuration for rendering the waterfall chart.
+ */
+export interface WaterfallConfig {
+    type?: 'waterfall';
+    data: WaterfallDataItem[];
+    theme?: 'default' | 'academy' | 'dark';
+    title?: string;
+    axisXTitle?: string;
+    axisYTitle?: string;
+    style?: {
+        backgroundColor?: string;
+        palette?: WaterfallPalette;
+    };
+}
+/**
+ * WaterfallInstance represents a waterfall chart instance with render/destroy.
+ */
+export interface WaterfallInstance {
+    render: (config: WaterfallConfig) => void;
+    destroy: () => void;
+}
+/**
+ * Waterfall chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const waterfall = Waterfall({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * waterfall.render({
+ *   type: 'waterfall',
+ *   data: [
+ *     { category: '期初利润', value: 100 },
+ *     { category: '销售收入', value: 80 },
+ *     { category: '运营成本', value: -50 },
+ *     { category: '税费', value: -20 },
+ *     { category: '总计', isTotal: true },
+ *   ],
+ *   theme: 'academy'
+ * });
+ *
+ * waterfall.destroy();
+ * ```
+ */
+export declare const Waterfall: (options: VisualizationOptions) => WaterfallInstance;

package/dist/esm/vis/waterfall/index.js

@@ -0,0 +1,245 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { Chart } from '@antv/g2';
+import { getBackgroundColor, getThemeObject } from "../../util/theme";
+
+/**
+ * WaterfallDataItem is the type for each data item in the waterfall chart.
+ */
+
+/**
+ * WaterfallPalette defines custom colors for positive, negative, total bars.
+ */
+
+/**
+ * WaterfallConfig defines the configuration for rendering the waterfall chart.
+ */
+
+/**
+ * WaterfallInstance represents a waterfall chart instance with render/destroy.
+ */
+
+// Default colors for waterfall chart
+var DEFAULT_POSITIVE_COLOR = '#FF4D4F';
+var DEFAULT_NEGATIVE_COLOR = '#2EBB59';
+var DEFAULT_TOTAL_COLOR = '#1783FF';
+
+/**
+ * Transform waterfall data to add __start__ and __end__ fields
+ * for proper rendering of stacked intervals
+ */
+function transformWaterfallData(data) {
+  var cumulative = 0;
+  var lastIntermediateTotalEnd = 0;
+  var totalSum = 0;
+  return data.map(function (item) {
+    var value = item.value || 0;
+    var start;
+    var end;
+    if (item.isTotal) {
+      start = 0;
+      end = totalSum;
+    } else if (item.isIntermediateTotal) {
+      start = lastIntermediateTotalEnd;
+      end = cumulative;
+      lastIntermediateTotalEnd = end;
+    } else {
+      start = cumulative;
+      end = cumulative + value;
+      cumulative = end;
+      totalSum += value;
+    }
+    return _objectSpread(_objectSpread({}, item), {}, {
+      __start__: start,
+      __end__: end,
+      __value__: item.isTotal ? totalSum : item.isIntermediateTotal ? end - start : value
+    });
+  });
+}
+
+/**
+ * Generate link data for connecting waterfall bars
+ * Each link connects the end of the previous bar to the start of the current bar
+ */
+function generateLinkData(data) {
+  return data.reduce(function (result, current, index) {
+    if (index > 0) {
+      var previous = data[index - 1];
+      result.push({
+        x: [previous.category, current.category],
+        y: current.isTotal || current.isIntermediateTotal ? current.__end__ : current.__start__
+      });
+    }
+    return result;
+  }, []);
+}
+
+/**
+ * Waterfall chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const waterfall = Waterfall({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * waterfall.render({
+ *   type: 'waterfall',
+ *   data: [
+ *     { category: '期初利润', value: 100 },
+ *     { category: '销售收入', value: 80 },
+ *     { category: '运营成本', value: -50 },
+ *     { category: '税费', value: -20 },
+ *     { category: '总计', isTotal: true },
+ *   ],
+ *   theme: 'academy'
+ * });
+ *
+ * waterfall.destroy();
+ * ```
+ */
+export var Waterfall = function Waterfall(options) {
+  var container = options.container,
+    width = options.width,
+    height = options.height,
+    _options$theme = options.theme,
+    chartTheme = _options$theme === void 0 ? 'default' : _options$theme;
+  var chart = null;
+
+  /**
+   * Render the waterfall chart with the given configuration.
+   */
+  var render = function render(config) {
+    var _config$data = config.data,
+      data = _config$data === void 0 ? [] : _config$data,
+      _config$theme = config.theme,
+      theme = _config$theme === void 0 ? chartTheme : _config$theme,
+      title = config.title,
+      axisXTitle = config.axisXTitle,
+      axisYTitle = config.axisYTitle,
+      _config$style = config.style,
+      style = _config$style === void 0 ? {} : _config$style;
+
+    // Clean up previous chart if exists
+    if (chart) {
+      chart.destroy();
+    }
+
+    // Get colors from style.palette or defaults
+    var backgroundColor = style.backgroundColor || getBackgroundColor(theme);
+    var palette = style.palette || {};
+    var positiveColor = palette.positiveColor || DEFAULT_POSITIVE_COLOR;
+    var negativeColor = palette.negativeColor || DEFAULT_NEGATIVE_COLOR;
+    var totalColor = palette.totalColor || DEFAULT_TOTAL_COLOR;
+
+    // Transform data to include __start__ and __end__ fields
+    var transformedData = transformWaterfallData(data);
+
+    // Generate link data for connecting lines
+    var linkData = generateLinkData(transformedData);
+
+    // Create chart
+    chart = new Chart({
+      container: container,
+      width: width,
+      height: height,
+      autoFit: true
+    });
+
+    // Configure chart options
+    // Note: Using 'any' type due to G2's complex type system with transformations
+    // This is consistent with how G2 5.0 is used elsewhere in the codebase
+    var chartOptions = _objectSpread(_objectSpread({
+      type: 'view',
+      data: transformedData,
+      title: title !== null && title !== void 0 ? title : '',
+      marginRight: 28,
+      axis: {
+        x: {
+          title: axisXTitle || false
+        },
+        y: {
+          title: axisYTitle || false,
+          labelFormatter: '~s'
+        }
+      },
+      scale: {
+        y: {
+          nice: true
+        }
+      },
+      children: [{
+        type: 'interval',
+        data: transformedData,
+        encode: {
+          x: 'category',
+          y: ['__start__', '__end__'],
+          color: 'category'
+        },
+        style: {
+          maxWidth: 60,
+          stroke: '#666',
+          radius: 4,
+          fill: function fill(d) {
+            return d.isTotal || d.isIntermediateTotal ? totalColor : d.__value__ > 0 ? positiveColor : negativeColor;
+          }
+        },
+        labels: [{
+          text: '__value__',
+          position: 'inside',
+          fontSize: 10,
+          transform: [{
+            type: 'overflowHide'
+          }],
+          formatter: '~s',
+          fill: '#000',
+          fontWeight: 600,
+          stroke: '#fff'
+        }]
+      }, {
+        type: 'link',
+        data: linkData,
+        encode: {
+          x: 'x',
+          y: 'y'
+        },
+        zIndex: -1,
+        style: {
+          stroke: '#ccc',
+          lineDash: [4, 2],
+          lineWidth: 1
+        },
+        tooltip: false
+      }],
+      legend: false
+    }, backgroundColor ? {
+      viewStyle: {
+        viewFill: backgroundColor
+      }
+    } : {}), {}, {
+      theme: getThemeObject(theme)
+    });
+    chart.options(chartOptions);
+    chart.render();
+  };
+
+  /**
+   * Destroy the chart instance and clean up resources.
+   */
+  var destroy = function destroy() {
+    if (chart) {
+      chart.destroy();
+      chart = null;
+    }
+  };
+  return {
+    render: render,
+    destroy: destroy
+  };
+};

package/dist/esm/vis/word-cloud/index.d.ts

@@ -0,0 +1,53 @@
+import type { VisualizationOptions } from '../../types';
+/**
+ * WordCloudDataItem is the type for each data item in the word cloud chart.
+ */
+export type WordCloudDataItem = {
+    text: string;
+    value: number;
+};
+/**
+ * WordCloudConfig defines the configuration for rendering the word cloud chart.
+ */
+export interface WordCloudConfig {
+    type?: 'word-cloud';
+    data: WordCloudDataItem[];
+    theme?: 'default' | 'academy' | 'dark';
+    title?: string;
+    style?: {
+        backgroundColor?: string;
+        palette?: string[];
+    };
+}
+/**
+ * WordCloudInstance represents a word cloud chart instance with render and destroy methods.
+ */
+export interface WordCloudInstance {
+    render: (config: WordCloudConfig) => void;
+    destroy: () => void;
+}
+/**
+ * WordCloud chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const wordCloud = WordCloud({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * wordCloud.render({
+ *   type: 'word-cloud',
+ *   data: [
+ *     { text: '环境', value: 20 },
+ *     { text: '保护', value: 15 },
+ *     { text: '可持续发展', value: 10 },
+ *   ],
+ *   theme: 'academy'
+ * });
+ *
+ * wordCloud.destroy();
+ * ```
+ */
+export declare const WordCloud: (options: VisualizationOptions) => WordCloudInstance;