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

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

@@ -0,0 +1,59 @@
+import type { VisualizationOptions } from '../../types';
+/**
+ * BoxplotDataItem is the type for each data item in the boxplot chart.
+ */
+export type BoxplotDataItem = {
+    category: string;
+    value: number;
+    group?: string;
+};
+/**
+ * BoxplotConfig defines the configuration for rendering the boxplot chart.
+ */
+export interface BoxplotConfig {
+    type?: 'boxplot';
+    data: BoxplotDataItem[];
+    theme?: 'default' | 'academy' | 'dark';
+    title?: string;
+    axisXTitle?: string;
+    axisYTitle?: string;
+    style?: {
+        backgroundColor?: string;
+        palette?: string[];
+        startAtZero?: boolean;
+    };
+}
+/**
+ * BoxplotInstance represents a boxplot chart instance with render and destroy.
+ */
+export interface BoxplotInstance {
+    render: (config: BoxplotConfig) => void;
+    destroy: () => void;
+}
+/**
+ * Boxplot chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const boxplot = Boxplot({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * boxplot.render({
+ *   type: 'boxplot',
+ *   data: [
+ *     { category: '班级A', value: 15 },
+ *     { category: '班级A', value: 18 },
+ *     { category: '班级A', value: 22 },
+ *     { category: '班级A', value: 27 },
+ *     { category: '班级A', value: 35 },
+ *   ],
+ *   theme: 'academy'
+ * });
+ *
+ * boxplot.destroy();
+ * ```
+ */
+export declare const Boxplot: (options: VisualizationOptions) => BoxplotInstance;

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

@@ -0,0 +1,177 @@
+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";
+
+/**
+ * BoxplotDataItem is the type for each data item in the boxplot chart.
+ */
+
+/**
+ * BoxplotConfig defines the configuration for rendering the boxplot chart.
+ */
+
+/**
+ * BoxplotInstance represents a boxplot chart instance with render and destroy.
+ */
+
+/**
+ * Boxplot chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const boxplot = Boxplot({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * boxplot.render({
+ *   type: 'boxplot',
+ *   data: [
+ *     { category: '班级A', value: 15 },
+ *     { category: '班级A', value: 18 },
+ *     { category: '班级A', value: 22 },
+ *     { category: '班级A', value: 27 },
+ *     { category: '班级A', value: 35 },
+ *   ],
+ *   theme: 'academy'
+ * });
+ *
+ * boxplot.destroy();
+ * ```
+ */
+export var Boxplot = function Boxplot(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 boxplot 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 boxplot
+    var hasGroupField = ((_ = (data || [])[0]) === null || _ === void 0 ? void 0 : _.group) !== undefined;
+    var encode = {};
+    if (hasGroupField) {
+      encode = {
+        x: 'category',
+        y: 'value',
+        color: 'group',
+        series: 'group'
+      };
+    } else {
+      encode = {
+        x: 'category',
+        y: 'value',
+        color: 'category'
+      };
+    }
+
+    // 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: 'boxplot',
+      data: data,
+      title: title !== null && title !== void 0 ? title : '',
+      encode: encode,
+      axis: {
+        x: {
+          title: axisXTitle || false
+        },
+        y: {
+          title: axisYTitle || false
+        }
+      },
+      scale: {
+        x: {
+          paddingInner: 0.6,
+          paddingOuter: 0.3
+        },
+        series: {
+          paddingInner: 0.3,
+          paddingOuter: 0.1
+        },
+        y: {
+          nice: true,
+          zero: startAtZero
+        },
+        color: {
+          range: colors
+        }
+      },
+      // When hasGroupField is true, set point to false to prevent G2's Boxplot composite mark
+      // from splitting into box + point child marks. The point child mark does not inherit
+      // the `scale` config, causing legendFilter interaction to throw
+      // "Cannot read properties of undefined (reading 'color')" when clicking legend items.
+      style: _objectSpread({
+        stroke: 'black'
+      }, hasGroupField ? {
+        point: false
+      } : {}),
+      legend: {
+        color: hasGroupField ? {
+          position: 'top'
+        } : false
+      },
+      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/column/index.d.ts

@@ -0,0 +1,60 @@
+import type { VisualizationOptions } from '../../types';
+/**
+ * ColumnDataItem is the type for each data item in the column chart.
+ */
+export type ColumnDataItem = {
+    category: string;
+    value: number;
+    group?: string;
+};
+/**
+ * ColumnConfig defines the configuration for rendering the column chart.
+ */
+export interface ColumnConfig {
+    type?: 'column';
+    data: ColumnDataItem[];
+    group?: boolean;
+    stack?: boolean;
+    title?: string;
+    axisXTitle?: string;
+    axisYTitle?: string;
+    theme?: 'default' | 'academy' | 'dark';
+    style?: {
+        backgroundColor?: string;
+        palette?: string[];
+    };
+}
+/**
+ * ColumnInstance represents a column chart instance with render and destroy methods.
+ */
+export interface ColumnInstance {
+    render: (config: ColumnConfig) => void;
+    destroy: () => void;
+}
+/**
+ * Column chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const column = Column({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * column.render({
+ *   type: 'column',
+ *   data: [
+ *     { category: '2015 年', value: 80 },
+ *     { category: '2016 年', value: 140 },
+ *     { category: '2017 年', value: 220 },
+ *   ],
+ *   title: '海底捞公司外卖收入',
+ *   axisXTitle: '年份',
+ *   axisYTitle: '金额 （百万元）',
+ * });
+ *
+ * column.destroy();
+ * ```
+ */
+export declare const Column: (options: VisualizationOptions) => ColumnInstance;

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

@@ -0,0 +1,199 @@
+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";
+
+/**
+ * ColumnDataItem is the type for each data item in the column chart.
+ */
+
+/**
+ * ColumnConfig defines the configuration for rendering the column chart.
+ */
+
+/**
+ * ColumnInstance represents a column chart instance with render and destroy methods.
+ */
+
+/**
+ * Column chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const column = Column({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * column.render({
+ *   type: 'column',
+ *   data: [
+ *     { category: '2015 年', value: 80 },
+ *     { category: '2016 年', value: 140 },
+ *     { category: '2017 年', value: 220 },
+ *   ],
+ *   title: '海底捞公司外卖收入',
+ *   axisXTitle: '年份',
+ *   axisYTitle: '金额 （百万元）',
+ * });
+ *
+ * column.destroy();
+ * ```
+ */
+export var Column = function Column(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 column chart with the given configuration.
+   */
+  var render = function render(config) {
+    var _data$;
+    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$group = config.group,
+      group = _config$group === void 0 ? false : _config$group,
+      _config$stack = config.stack,
+      stack = _config$stack === void 0 ? false : _config$stack,
+      _config$style = config.style,
+      style = _config$style === void 0 ? {} : _config$style;
+
+    // Clean up previous chart if exists
+    if (chart) {
+      chart.destroy();
+    }
+    var hasGroupField = data.length > 0 && ((_data$ = data[0]) === null || _data$ === void 0 ? void 0 : _data$.group) !== undefined;
+    var colors = normalizePalette(style.palette, theme);
+    var backgroundColor = style.backgroundColor || getBackgroundColor(theme);
+
+    // Create chart
+    chart = new Chart({
+      container: container,
+      width: width,
+      height: height,
+      autoFit: true
+    });
+
+    // Configure chart encode and transform based on group/stack
+    var encode = {};
+    var transform = [];
+    var radiusStyle = {};
+
+    // academy theme uses no rounded corners; other themes use rounded top corners
+    if (theme !== 'academy') {
+      radiusStyle = {
+        radiusTopLeft: 4,
+        radiusTopRight: 4
+      };
+    }
+
+    // Configure transforms based on group/stack flags
+    if (hasGroupField && group) {
+      transform = [{
+        type: 'dodgeX'
+      }];
+    }
+    if (hasGroupField && stack) {
+      transform = [{
+        type: 'stackY'
+      }];
+    }
+
+    // Configure encode based on whether data has group field
+    if (hasGroupField) {
+      encode = {
+        x: 'category',
+        y: 'value',
+        color: 'group'
+      };
+    } else {
+      encode = {
+        x: 'category',
+        y: 'value',
+        color: 'category'
+      };
+    }
+
+    // Configure scale
+    var scaleConfig = _objectSpread({
+      y: {
+        nice: true
+      }
+    }, style.palette ? {
+      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 = {
+      animate: false,
+      type: 'interval',
+      data: data,
+      title: title !== null && title !== void 0 ? title : '',
+      encode: encode,
+      transform: transform,
+      scale: scaleConfig,
+      axis: {
+        x: {
+          title: axisXTitle || false
+        },
+        y: {
+          title: axisYTitle || false
+        }
+      },
+      legend: hasGroupField ? {
+        color: {
+          position: 'top'
+        }
+      } : false,
+      tooltip: {
+        items: [function (d) {
+          return {
+            name: axisYTitle || d.category,
+            value: d.value
+          };
+        }]
+      },
+      style: _objectSpread(_objectSpread({}, radiusStyle), {}, {
+        columnWidthRatio: 0.8
+      }),
+      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/dual-axes/index.d.ts

@@ -0,0 +1,64 @@
+import type { VisualizationOptions } from '../../types';
+/**
+ * DualAxesSeriesItem defines a single series in the dual-axes chart.
+ */
+export type DualAxesSeriesItem = {
+    type: 'line' | 'column';
+    data: number[];
+    axisYTitle?: string;
+};
+/**
+ * DualAxesConfig defines the configuration for rendering the dual-axes chart.
+ */
+export interface DualAxesConfig {
+    type?: 'dual-axes';
+    categories: string[];
+    series: DualAxesSeriesItem[];
+    title?: string;
+    axisXTitle?: string;
+    theme?: 'default' | 'academy' | 'dark';
+    style?: {
+        backgroundColor?: string;
+        palette?: string[];
+        startAtZero?: boolean;
+    };
+}
+/**
+ * DualAxesInstance represents a dual-axes chart instance with render and destroy methods.
+ */
+export interface DualAxesInstance {
+    render: (config: DualAxesConfig) => void;
+    destroy: () => void;
+}
+/**
+ * DualAxes chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const dualAxes = DualAxes({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * dualAxes.render({
+ *   type: 'dual-axes',
+ *   categories: ['2018', '2019', '2020', '2021', '2022'],
+ *   series: [
+ *     {
+ *       type: 'column',
+ *       data: [91.9, 99.1, 101.6, 114.4, 121],
+ *       axisYTitle: '销售额',
+ *     },
+ *     {
+ *       type: 'line',
+ *       data: [0.055, 0.06, 0.062, 0.07, 0.075],
+ *       axisYTitle: '利润率',
+ *     },
+ *   ],
+ * });
+ *
+ * dualAxes.destroy();
+ * ```
+ */
+export declare const DualAxes: (options: VisualizationOptions) => DualAxesInstance;