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

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

@@ -0,0 +1,56 @@
+import type { VisualizationOptions } from '../../types';
+/**
+ * SankeyDataItem is the type for each data item in the sankey chart.
+ */
+export type SankeyDataItem = {
+    source: string;
+    target: string;
+    value: number;
+};
+/**
+ * SankeyConfig defines the configuration for rendering the sankey chart.
+ */
+export interface SankeyConfig {
+    type?: 'sankey';
+    data: SankeyDataItem[];
+    nodeAlign?: 'left' | 'center' | 'right' | 'justify';
+    theme?: 'default' | 'academy' | 'dark';
+    title?: string;
+    style?: {
+        backgroundColor?: string;
+        palette?: string[];
+    };
+}
+/**
+ * SankeyInstance represents a sankey chart instance with render and destroy methods.
+ */
+export interface SankeyInstance {
+    render: (config: SankeyConfig) => void;
+    destroy: () => void;
+}
+/**
+ * Sankey chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const sankey = Sankey({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * sankey.render({
+ *   type: 'sankey',
+ *   data: [
+ *     { source: '煤炭', target: '发电厂', value: 120 },
+ *     { source: '天然气', target: '发电厂', value: 80 },
+ *     { source: '发电厂', target: '工业', value: 100 },
+ *   ],
+ *   nodeAlign: 'justify',
+ *   theme: 'academy'
+ * });
+ *
+ * sankey.destroy();
+ * ```
+ */
+export declare const Sankey: (options: VisualizationOptions) => SankeyInstance;

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

@@ -0,0 +1,135 @@
+import { Chart } from '@antv/g2';
+import { getBackgroundColor, getThemeColors, getThemeObject } from "../../util/theme";
+
+/**
+ * SankeyDataItem is the type for each data item in the sankey chart.
+ */
+
+/**
+ * SankeyConfig defines the configuration for rendering the sankey chart.
+ */
+
+/**
+ * SankeyInstance represents a sankey chart instance with render and destroy methods.
+ */
+
+/**
+ * Sankey chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const sankey = Sankey({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * sankey.render({
+ *   type: 'sankey',
+ *   data: [
+ *     { source: '煤炭', target: '发电厂', value: 120 },
+ *     { source: '天然气', target: '发电厂', value: 80 },
+ *     { source: '发电厂', target: '工业', value: 100 },
+ *   ],
+ *   nodeAlign: 'justify',
+ *   theme: 'academy'
+ * });
+ *
+ * sankey.destroy();
+ * ```
+ */
+export var Sankey = function Sankey(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 sankey chart with the given configuration.
+   */
+  var render = function render(config) {
+    var _config$data = config.data,
+      data = _config$data === void 0 ? [] : _config$data,
+      _config$nodeAlign = config.nodeAlign,
+      nodeAlign = _config$nodeAlign === void 0 ? 'center' : _config$nodeAlign,
+      _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 = style.palette || getThemeColors(theme);
+    var backgroundColor = style.backgroundColor || getBackgroundColor(theme);
+
+    // 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 = {
+      type: 'sankey',
+      data: {
+        value: data,
+        transform: [{
+          type: 'custom',
+          callback: function callback(data) {
+            return {
+              links: data
+            };
+          }
+        }]
+      },
+      layout: {
+        nodeAlign: nodeAlign,
+        nodePadding: 0.01
+      },
+      title: title !== null && title !== void 0 ? title : '',
+      scale: {
+        color: {
+          range: colors
+        }
+      },
+      style: {
+        labelSpacing: 2,
+        nodeLineWidth: 1,
+        linkFillOpacity: 0.3
+      },
+      viewStyle: {
+        viewFill: backgroundColor
+      },
+      theme: getThemeObject(theme),
+      legend: 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/scatter/index.d.ts

@@ -0,0 +1,54 @@
+import type { VisualizationOptions } from '../../types';
+/**
+ * ScatterDataItem is the type for each data item in the scatter chart.
+ */
+export type ScatterDataItem = {
+    x: number;
+    y: number;
+    group?: string;
+};
+/**
+ * ScatterConfig defines the configuration for rendering the scatter chart.
+ */
+export interface ScatterConfig {
+    type?: 'scatter';
+    data: ScatterDataItem[];
+    title?: string;
+    theme?: 'default' | 'academy' | 'dark';
+    style?: {
+        backgroundColor?: string;
+        palette?: string[];
+    };
+}
+/**
+ * ScatterInstance represents a scatter chart instance with render and destroy methods.
+ */
+export interface ScatterInstance {
+    render: (config: ScatterConfig) => void;
+    destroy: () => void;
+}
+/**
+ * Scatter chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const scatter = Scatter({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * scatter.render({
+ *   type: 'scatter',
+ *   data: [
+ *     { x: 10, y: 15 },
+ *     { x: 20, y: 25 },
+ *     { x: 30, y: 35 },
+ *     { x: 40, y: 45 },
+ *   ],
+ * });
+ *
+ * scatter.destroy();
+ * ```
+ */
+export declare const Scatter: (options: VisualizationOptions) => ScatterInstance;

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

@@ -0,0 +1,158 @@
+import { Chart } from '@antv/g2';
+import { getBackgroundColor, getThemeColors, getThemeObject } from "../../util/theme";
+
+/**
+ * ScatterDataItem is the type for each data item in the scatter chart.
+ */
+
+/**
+ * ScatterConfig defines the configuration for rendering the scatter chart.
+ */
+
+/**
+ * ScatterInstance represents a scatter chart instance with render and destroy methods.
+ */
+
+/**
+ * Scatter chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const scatter = Scatter({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * scatter.render({
+ *   type: 'scatter',
+ *   data: [
+ *     { x: 10, y: 15 },
+ *     { x: 20, y: 25 },
+ *     { x: 30, y: 35 },
+ *     { x: 40, y: 45 },
+ *   ],
+ * });
+ *
+ * scatter.destroy();
+ * ```
+ */
+export var Scatter = function Scatter(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 scatter 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,
+      _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);
+
+    // Check if data has group field
+    var hasGroupField = data.length > 0 && ((_data$ = data[0]) === null || _data$ === void 0 ? void 0 : _data$.group) !== undefined;
+
+    // Create chart
+    chart = new Chart({
+      container: container,
+      width: width,
+      height: height,
+      autoFit: true
+    });
+
+    // Configure chart encode based on whether there's a group field
+    var encode = {};
+    var scaleConfig = {
+      y: {
+        nice: true
+      }
+    };
+    if (hasGroupField) {
+      encode = {
+        x: 'x',
+        y: 'y',
+        color: 'group'
+      };
+      scaleConfig.color = {
+        range: colors
+      };
+    } else {
+      encode = {
+        x: 'x',
+        y: 'y',
+        color: function color() {
+          return 'all';
+        }
+      };
+    }
+
+    // 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 = {
+      type: 'point',
+      data: data,
+      title: title !== null && title !== void 0 ? title : '',
+      encode: encode,
+      legend: hasGroupField ? {
+        color: {
+          position: 'top'
+        }
+      } : false,
+      scale: scaleConfig,
+      style: {
+        lineWidth: 1
+      },
+      tooltip: {
+        title: function title(d) {
+          return d !== null && d !== void 0 && d.group ? d.group : false;
+        },
+        items: [{
+          channel: 'x',
+          name: 'x'
+        }, {
+          channel: 'y',
+          name: 'y'
+        }]
+      },
+      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/summary/index.d.ts

@@ -0,0 +1,41 @@
+import type { VisualizationOptions } from '../../types';
+/**
+ * SummaryConfig is a T8 Syntax string for narrative text visualization.
+ * Supports markdown-like syntax with special annotations for metrics.
+ * @example
+ * ```
+ * # Sales Report
+ * Total sales reached [¥1,234,567](metric_value, origin=1234567).
+ * ```
+ */
+export type SummaryConfig = string;
+/**
+ * SummaryInstance represents a summary instance with render and destroy methods.
+ */
+export interface SummaryInstance {
+    render: (syntax: SummaryConfig) => void;
+    destroy: () => void;
+}
+/**
+ * Summary component using @antv/t8 for narrative text visualization.
+ *
+ * This component provides a way to render data summaries with rich text formatting
+ * and inline data visualization using T8 syntax (markdown-like syntax).
+ *
+ * @example
+ * ```ts
+ * const summary = Summary({
+ *   container: '#container',
+ *   theme: 'light',
+ * });
+ *
+ * summary.render(`
+ *   # Sales Report
+ *   Total sales reached [¥1,234,567](metric_value, origin=1234567).
+ *   This represents a [15%](delta_value, status=increase) increase compared to last quarter.
+ * `);
+ *
+ * summary.destroy();
+ * ```
+ */
+export declare const Summary: (options: VisualizationOptions) => SummaryInstance;

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

@@ -0,0 +1,80 @@
+import { Text } from '@antv/t8';
+
+/**
+ * SummaryConfig is a T8 Syntax string for narrative text visualization.
+ * Supports markdown-like syntax with special annotations for metrics.
+ * @example
+ * ```
+ * # Sales Report
+ * Total sales reached [¥1,234,567](metric_value, origin=1234567).
+ * ```
+ */
+
+/**
+ * SummaryInstance represents a summary instance with render and destroy methods.
+ */
+
+/**
+ * Summary component using @antv/t8 for narrative text visualization.
+ *
+ * This component provides a way to render data summaries with rich text formatting
+ * and inline data visualization using T8 syntax (markdown-like syntax).
+ *
+ * @example
+ * ```ts
+ * const summary = Summary({
+ *   container: '#container',
+ *   theme: 'light',
+ * });
+ *
+ * summary.render(`
+ *   # Sales Report
+ *   Total sales reached [¥1,234,567](metric_value, origin=1234567).
+ *   This represents a [15%](delta_value, status=increase) increase compared to last quarter.
+ * `);
+ *
+ * summary.destroy();
+ * ```
+ */
+export var Summary = function Summary(options) {
+  // T8 only supports 'light' and 'dark', so map 'academy' to 'light'
+  var _options$theme = options.theme,
+    theme = _options$theme === void 0 ? 'light' : _options$theme;
+  if (theme === 'academy' || theme === 'default') theme = 'light';
+  var container = typeof options.container === 'string' ? document.querySelector(options.container) : options.container;
+  if (!container) {
+    throw new Error('Container not found');
+  }
+  var text = null;
+
+  /**
+   * Render the summary with the given T8 syntax string.
+   */
+  var render = function render(syntax) {
+    // Clean up previous instance if exists
+    if (text) {
+      text.unmount();
+    }
+
+    // Create T8 Text instance
+    text = new Text(container);
+
+    // Set theme and render syntax
+    text.theme(theme);
+    text.render(syntax);
+  };
+
+  /**
+   * Destroy the summary instance and clean up resources.
+   */
+  var destroy = function destroy() {
+    if (text) {
+      text.unmount();
+      text = null;
+    }
+  };
+  return {
+    render: render,
+    destroy: destroy
+  };
+};

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

@@ -0,0 +1,49 @@
+import type { VisualizationOptions } from '../../types';
+/**
+ * TableConfig defines the configuration for rendering the table.
+ */
+export interface TableConfig {
+    type?: 'table';
+    data: Record<string, any>[];
+    title?: string;
+}
+/**
+ * TableInstance represents a table instance with render and destroy methods.
+ */
+export interface TableInstance {
+    render: (config: TableConfig) => void;
+    destroy: () => void;
+}
+/**
+ * Calculate the minimum width needed for a table based on its data.
+ * This is a pure function that measures text width and returns the calculated min-width.
+ *
+ * @param data - Table data array
+ * @param columns - Column names array
+ * @returns Calculated minimum width in pixels
+ */
+export declare const calculateTableMinWidth: (data: Record<string, any>[], columns: string[]) => number;
+/**
+ * Table component using pure JavaScript.
+ *
+ * @example
+ * ```ts
+ * const table = Table({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * table.render({
+ *   type: 'table',
+ *   data: [
+ *     { "Indicator": "经度(°)", "Mean": "104.15°", "Std": "±0.64°" },
+ *     { "Indicator": "纬度(°)", "Mean": "31.60°", "Std": "±0.48°" },
+ *   ],
+ *   title: '一个文本标题',
+ * });
+ *
+ * table.destroy();
+ * ```
+ */
+export declare const Table: (options: VisualizationOptions) => TableInstance;