@antv/gpt-vis 0.6.1 → 1.0.0-beta.2

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

@@ -0,0 +1,167 @@
+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, normalizePalette } from "../../util/theme";
+
+/**
+ * VennDataItem is the type for each data item in the venn chart.
+ */
+
+function normalizeVennSets(sets) {
+  if (Array.isArray(sets)) return sets.map(function (s) {
+    return String(s);
+  });
+  if (typeof sets === 'string') {
+    return sets.split(',').map(function (s) {
+      return s.trim();
+    }).filter(Boolean);
+  }
+  if (sets == null) return [];
+  return [String(sets)];
+}
+
+/**
+ * VennConfig defines the configuration for rendering the venn chart.
+ */
+
+/**
+ * VennInstance represents a venn chart instance with render and destroy methods.
+ */
+
+/**
+ * Venn chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const venn = Venn({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * venn.render({
+ *   type: 'venn',
+ *   data: [
+ *     { sets: ['A'], value: 20, label: '集合A' },
+ *     { sets: ['B'], value: 15, label: '集合B' },
+ *     { sets: ['A', 'B'], value: 5, label: '交集AB' },
+ *   ],
+ *   theme: 'academy'
+ * });
+ *
+ * venn.destroy();
+ * ```
+ */
+export var Venn = function Venn(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 venn 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,
+      _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 = normalizePalette(style.palette, theme);
+    var backgroundColor = style.backgroundColor || getBackgroundColor(theme);
+    var normalizedData = data.map(function (d) {
+      return _objectSpread(_objectSpread({}, d), {}, {
+        sets: normalizeVennSets(d.sets)
+      });
+    });
+
+    // 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 = {
+      animate: false,
+      type: 'path',
+      data: {
+        value: normalizedData,
+        transform: [{
+          type: 'venn',
+          padding: 8,
+          sets: 'sets',
+          size: 'value',
+          as: ['key', 'path']
+        }]
+      },
+      title: title !== null && title !== void 0 ? title : '',
+      encode: {
+        d: 'path',
+        color: 'key'
+      },
+      scale: {
+        color: {
+          range: colors
+        }
+      },
+      style: {
+        // Set opacity: intersections (sets.length > 1) are nearly transparent, single sets are more opaque
+        opacity: function opacity(d) {
+          return normalizeVennSets(d.sets).length > 1 ? 0.001 : 0.65;
+        }
+      },
+      labels: [{
+        position: 'inside',
+        text: function text(d) {
+          return d.label || '';
+        },
+        fill: '#000',
+        fillOpacity: 0.85,
+        fontSize: 10
+      }],
+      viewStyle: {
+        viewFill: backgroundColor
+      },
+      theme: getThemeObject(theme),
+      legend: false,
+      axis: false,
+      tooltip: false
+    };
+    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/violin/index.d.ts

@@ -0,0 +1,59 @@
+import type { VisualizationOptions } from '../../types';
+/**
+ * ViolinDataItem is the type for each data item in the violin chart.
+ */
+export type ViolinDataItem = {
+    category: string;
+    value: number;
+    group?: string;
+};
+/**
+ * ViolinConfig defines the configuration for rendering the violin chart.
+ */
+export interface ViolinConfig {
+    type?: 'violin';
+    data: ViolinDataItem[];
+    theme?: 'default' | 'academy' | 'dark';
+    title?: string;
+    axisXTitle?: string;
+    axisYTitle?: string;
+    style?: {
+        backgroundColor?: string;
+        palette?: string[];
+        startAtZero?: boolean;
+    };
+}
+/**
+ * ViolinInstance represents a violin chart instance with render and destroy.
+ */
+export interface ViolinInstance {
+    render: (config: ViolinConfig) => void;
+    destroy: () => void;
+}
+/**
+ * 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 declare const Violin: (options: VisualizationOptions) => ViolinInstance;

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

@@ -0,0 +1,246 @@
+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, normalizePalette } 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 = normalizePalette(style.palette, 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({
+      animate: false,
+      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,64 @@
+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;
+};
+/**
+ * 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;
+        /**
+         * Custom color palette for waterfall bars.
+         * Array order: [0] positive color, [1] negative color, [2] total/intermediate-total color.
+         * Defaults: ['#FF4D4F', '#2EBB59', '#1783FF']
+         */
+        palette?: string[];
+    };
+}
+/**
+ * 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;