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

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

@@ -0,0 +1,101 @@
+import { Text } from '@antv/t8';
+import { getBackgroundColor } from "../../util/theme";
+
+/**
+ * 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'/'default' 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');
+  }
+
+  // Create a wrapper element for padding and theme background
+  var wrapper = document.createElement('div');
+  wrapper.className = 'gpt-vis-summary';
+  container.appendChild(wrapper);
+  var text = null;
+
+  /**
+   * Render the summary with the given T8 syntax string.
+   * Supports an optional `theme <value>` line in the syntax to override the theme.
+   */
+  var render = function render(syntax) {
+    // Clean up previous instance if exists
+    if (text) {
+      text.unmount();
+    }
+
+    // Extract optional `theme <value>` line from syntax
+    var activeTheme = theme;
+    var cleanedSyntax = syntax.replace(/^theme\s+(light|dark)\s*$/im, function (_, t) {
+      activeTheme = t;
+      return '';
+    });
+
+    // Create T8 Text instance
+    text = new Text(wrapper);
+
+    // Set background color and padding on the wrapper
+    wrapper.style.backgroundColor = activeTheme === 'dark' ? getBackgroundColor('dark') : '';
+    wrapper.style.padding = '16px';
+
+    // Set theme and render syntax
+    text.theme(activeTheme);
+    text.render(cleanedSyntax.trim());
+  };
+
+  /**
+   * Destroy the summary instance and clean up resources.
+   */
+  var destroy = function destroy() {
+    if (text) {
+      text.unmount();
+      text = null;
+    }
+    if (wrapper.parentNode) {
+      wrapper.parentNode.removeChild(wrapper);
+    }
+  };
+  return {
+    render: render,
+    destroy: destroy
+  };
+};

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

@@ -0,0 +1,50 @@
+import type { VisualizationOptions } from '../../types';
+/**
+ * TableConfig defines the configuration for rendering the table.
+ */
+export interface TableConfig {
+    type?: 'table';
+    data: Record<string, any>[];
+    title?: string;
+    theme?: 'default' | 'dark';
+}
+/**
+ * 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;

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

@@ -0,0 +1,167 @@
+import { measureText } from 'measury';
+
+/**
+ * TableConfig defines the configuration for rendering the table.
+ */
+
+/**
+ * TableInstance represents a table instance with render and destroy methods.
+ */
+
+var SCOPE_ID = '__gpt-vis-table__';
+var FONT_FAMILY = '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif';
+var CELL_PADDING = 16; // 8px * 2
+var MIN_WIDTH_MULTIPLIER = 1.1;
+
+// CSS styles for the table component
+var TABLE_STYLES = "\n  .".concat(SCOPE_ID, " {\n    font-family: ").concat(FONT_FAMILY, ";\n    overflow: auto;\n    height: 100%;\n    padding: 16px;\n  }\n\n  .").concat(SCOPE_ID, " .table-title {\n    font-size: 16px;\n    font-weight: 500;\n    margin-bottom: 12px;\n    color: #1d2129;\n  }\n\n  .").concat(SCOPE_ID, " table {\n    border-collapse: separate;\n    border-spacing: 0;\n    background: #fff;\n    border-radius: 8px;\n    overflow: hidden;\n  }\n\n  .").concat(SCOPE_ID, " th,\n  .").concat(SCOPE_ID, " td {\n    border-bottom: 1px solid #f0f0f0;\n    padding: 8px;\n    text-align: left;\n    font-size: 14px;\n    color: #333;\n    white-space: nowrap;\n  }\n\n  .").concat(SCOPE_ID, " th {\n    background: #f5f5f5;\n    font-weight: 600;\n    color: #000000e0;\n    position: relative;\n  }\n\n  .").concat(SCOPE_ID, " th:not(:last-child)::after {\n    content: '';\n    position: absolute;\n    top: 25%;\n    right: 0;\n    width: 1px;\n    height: 50%;\n    background: #e0e0e0;\n  }\n\n  .").concat(SCOPE_ID, " tr {\n    transition: background 0.2s;\n  }\n\n  .").concat(SCOPE_ID, " tbody tr:hover {\n    background: #f5f5f5;\n    cursor: pointer;\n  }\n\n  .").concat(SCOPE_ID, "[data-theme=\"dark\"] {\n    background: #000;\n  }\n\n  .").concat(SCOPE_ID, "[data-theme=\"dark\"] .table-title {\n    color: #ffffffd9;\n  }\n\n  .").concat(SCOPE_ID, "[data-theme=\"dark\"] table {\n    background: #141414;\n  }\n\n  .").concat(SCOPE_ID, "[data-theme=\"dark\"] th,\n  .").concat(SCOPE_ID, "[data-theme=\"dark\"] td {\n    border-bottom: 1px solid #303030;\n    color: #ffffffd9;\n  }\n\n  .").concat(SCOPE_ID, "[data-theme=\"dark\"] th {\n    background: #1f1f1f;\n    color: #ffffffa6;\n  }\n\n  .").concat(SCOPE_ID, "[data-theme=\"dark\"] th:not(:last-child)::after {\n    background: #303030;\n  }\n\n  .").concat(SCOPE_ID, "[data-theme=\"dark\"] tbody tr:hover {\n    background: #1f1f1f;\n  }\n");
+
+/**
+ * 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 var calculateTableMinWidth = function calculateTableMinWidth(data, columns) {
+  var maxRowWidth = 0;
+
+  // Measure header row
+  var headerWidth = columns.reduce(function (total, col) {
+    var metrics = measureText(String(col), {
+      fontFamily: FONT_FAMILY,
+      fontSize: 14,
+      fontWeight: '600'
+    });
+    return total + metrics.width + CELL_PADDING;
+  }, 0);
+  maxRowWidth = Math.max(maxRowWidth, headerWidth);
+
+  // Measure each data row
+  data.forEach(function (row) {
+    var rowText = columns.map(function (col) {
+      return String(row[col] != null ? row[col] : '');
+    }).join('');
+    var metrics = measureText(rowText, {
+      fontFamily: FONT_FAMILY,
+      fontSize: 14
+    });
+    var rowWidth = metrics.width + columns.length * CELL_PADDING;
+    maxRowWidth = Math.max(maxRowWidth, rowWidth);
+  });
+
+  // Return min-width with 110% multiplier for optimal spacing
+  return maxRowWidth * MIN_WIDTH_MULTIPLIER;
+};
+
+// Inject CSS into the document head if not already present
+var injectStyles = function injectStyles() {
+  if (document.querySelector("style[data-scope=\"".concat(SCOPE_ID, "\"]"))) {
+    return;
+  }
+  var styleElement = document.createElement('style');
+  styleElement.setAttribute('data-scope', SCOPE_ID);
+  styleElement.textContent = TABLE_STYLES;
+  document.head.appendChild(styleElement);
+};
+
+/**
+ * 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 var Table = function Table(options) {
+  var _options$theme = options.theme,
+    chartTheme = _options$theme === void 0 ? 'default' : _options$theme;
+  var container = typeof options.container === 'string' ? document.querySelector(options.container) : options.container;
+  if (!container) {
+    throw new Error('Container not found');
+  }
+  var tableWrapper = null;
+
+  /**
+   * Render the table with the given configuration.
+   */
+  var render = function render(config) {
+    var _config$data = config.data,
+      data = _config$data === void 0 ? [] : _config$data,
+      title = config.title,
+      _config$theme = config.theme,
+      theme = _config$theme === void 0 ? chartTheme : _config$theme;
+
+    // Inject styles if not already present
+    injectStyles();
+
+    // Clean up previous render
+    if (tableWrapper) {
+      tableWrapper.remove();
+    }
+
+    // Create wrapper element
+    tableWrapper = document.createElement('div');
+    tableWrapper.className = SCOPE_ID;
+    if (theme === 'dark') {
+      tableWrapper.setAttribute('data-theme', 'dark');
+    }
+
+    // Handle empty data case
+    if (data.length === 0) {
+      tableWrapper.innerHTML = "\n        ".concat(title ? "<div class=\"table-title\">".concat(title, "</div>") : '', "\n        <div style=\"padding: 20px; text-align: center; color: #999;\">No data available</div>\n      ");
+      container.appendChild(tableWrapper);
+      return;
+    }
+
+    // Get columns from the first data item
+    var columns = Object.keys(data[0]);
+
+    // Calculate the minimum width needed for the table using pure function
+    var minWidth = calculateTableMinWidth(data, columns);
+    // Ensure a minimum width for columns
+    minWidth = Math.max(minWidth, columns.length * 100);
+
+    // Build table HTML using template strings
+    var headerHTML = columns.map(function (col) {
+      return "<th>".concat(col, "</th>");
+    }).join('');
+    var bodyHTML = data.map(function (row) {
+      return "<tr>".concat(columns.map(function (col) {
+        return "<td>".concat(row[col] != null ? row[col] : '', "</td>");
+      }).join(''), "</tr>");
+    }).join('');
+    tableWrapper.innerHTML = "\n      ".concat(title ? "<div class=\"table-title\">".concat(title, "</div>") : '', "\n      <table style=\"min-width: ").concat(minWidth, "px;\">\n        <thead><tr>").concat(headerHTML, "</tr></thead>\n        <tbody>").concat(bodyHTML, "</tbody>\n      </table>\n    ");
+    container.appendChild(tableWrapper);
+  };
+
+  /**
+   * Destroy the table instance and clean up resources.
+   */
+  var destroy = function destroy() {
+    if (tableWrapper) {
+      tableWrapper.remove();
+      tableWrapper = null;
+    }
+  };
+  return {
+    render: render,
+    destroy: destroy
+  };
+};

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

@@ -0,0 +1,68 @@
+import type { VisualizationOptions } from '../../types';
+/**
+ * TreemapDataItem is the type for each data item in the treemap chart.
+ */
+export type TreemapDataItem = {
+    name: string;
+    value: number;
+    children?: TreemapDataItem[];
+};
+/**
+ * TreemapConfig defines the configuration for rendering the treemap chart.
+ */
+export interface TreemapConfig {
+    type?: 'treemap';
+    data: TreemapDataItem[];
+    theme?: 'default' | 'academy' | 'dark';
+    title?: string;
+    style?: {
+        backgroundColor?: string;
+        palette?: string[];
+    };
+}
+/**
+ * TreemapInstance represents a treemap chart instance with render and destroy methods.
+ */
+export interface TreemapInstance {
+    render: (config: TreemapConfig) => void;
+    destroy: () => void;
+}
+/**
+ * Treemap chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const treemap = Treemap({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * treemap.render({
+ *   type: 'treemap',
+ *   data: [
+ *     {
+ *       name: 'A',
+ *       value: 100,
+ *       children: [
+ *         { name: 'A1', value: 40 },
+ *         { name: 'A2', value: 30 },
+ *         { name: 'A3', value: 30 },
+ *       ],
+ *     },
+ *     {
+ *       name: 'B',
+ *       value: 80,
+ *       children: [
+ *         { name: 'B1', value: 50 },
+ *         { name: 'B2', value: 30 },
+ *       ],
+ *     },
+ *   ],
+ *   theme: 'academy'
+ * });
+ *
+ * treemap.destroy();
+ * ```
+ */
+export declare const Treemap: (options: VisualizationOptions) => TreemapInstance;

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

@@ -0,0 +1,159 @@
+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";
+
+/**
+ * TreemapDataItem is the type for each data item in the treemap chart.
+ */
+
+/**
+ * TreemapConfig defines the configuration for rendering the treemap chart.
+ */
+
+/**
+ * TreemapInstance represents a treemap chart instance with render and destroy methods.
+ */
+
+/**
+ * Treemap chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const treemap = Treemap({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * treemap.render({
+ *   type: 'treemap',
+ *   data: [
+ *     {
+ *       name: 'A',
+ *       value: 100,
+ *       children: [
+ *         { name: 'A1', value: 40 },
+ *         { name: 'A2', value: 30 },
+ *         { name: 'A3', value: 30 },
+ *       ],
+ *     },
+ *     {
+ *       name: 'B',
+ *       value: 80,
+ *       children: [
+ *         { name: 'B1', value: 50 },
+ *         { name: 'B2', value: 30 },
+ *       ],
+ *     },
+ *   ],
+ *   theme: 'academy'
+ * });
+ *
+ * treemap.destroy();
+ * ```
+ */
+export var Treemap = function Treemap(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 treemap 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);
+
+    // 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: 'treemap',
+      data: {
+        type: 'inline',
+        value: {
+          name: 'root',
+          children: data
+        }
+      },
+      title: title !== null && title !== void 0 ? title : '',
+      layout: {
+        tile: 'treemapBinary',
+        paddingInner: 2
+      },
+      encode: {
+        value: 'value'
+      },
+      style: {
+        fillOpacity: 0.8,
+        labelFontSize: 10
+      },
+      legend: false,
+      tooltip: {
+        items: [function (d) {
+          var _d$data, _d$data2;
+          return {
+            name: ((_d$data = d.data) === null || _d$data === void 0 ? void 0 : _d$data.name) || d.name,
+            value: ((_d$data2 = d.data) === null || _d$data2 === void 0 ? void 0 : _d$data2.value) || d.value
+          };
+        }]
+      },
+      viewStyle: {
+        viewFill: backgroundColor
+      },
+      theme: getThemeObject(theme),
+      scale: _objectSpread({}, colors.length > 0 ? {
+        color: {
+          range: colors
+        }
+      } : {})
+    };
+    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/venn/index.d.ts

@@ -0,0 +1,55 @@
+import type { VisualizationOptions } from '../../types';
+/**
+ * VennDataItem is the type for each data item in the venn chart.
+ */
+export type VennDataItem = {
+    /** Parser / DSL often yields a comma-separated string; G2 venn transform expects string[]. */
+    sets: string[] | string;
+    value: number;
+    label?: string;
+};
+/**
+ * VennConfig defines the configuration for rendering the venn chart.
+ */
+export interface VennConfig {
+    type?: 'venn';
+    data: VennDataItem[];
+    theme?: 'default' | 'academy' | 'dark';
+    title?: string;
+    style?: {
+        backgroundColor?: string;
+        palette?: string[];
+    };
+}
+/**
+ * VennInstance represents a venn chart instance with render and destroy methods.
+ */
+export interface VennInstance {
+    render: (config: VennConfig) => void;
+    destroy: () => void;
+}
+/**
+ * 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 declare const Venn: (options: VisualizationOptions) => VennInstance;