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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antv/gpt-vis",
-  "version": "0.6.0",
+  "version": "1.0.0-beta.1",
   "description": "Components for GPTs, generative AI, and LLM projects. Not only UI Components.",
   "keywords": [
     "antv",
@@ -23,84 +23,58 @@
   "types": "dist/esm/index.d.ts",
   "jsdelivr": "dist/umd/index.min.js",
   "unpkg": "dist/umd/index.min.js",
-  "browser": {
-    "./src/export-map.ts": "./src/export-map.browser.ts",
-    "./dist/esm/export-map.js": "./dist/esm/export-map.browser.js"
-  },
   "files": [
+    "src",
     "dist",
     "README.md",
     "!dist/umd/report.html"
   ],
+  "scripts": {
+    "prepare": "husky",
+    "build": "father build && limit-size",
+    "check-deps": "father doctor",
+    "check-format": "prettier './**/*.{ts,tsx,js,jsx,json,md,css,less}' --check",
+    "format": "prettier './**/*.{ts,tsx,js,jsx,json,md,css,less}' --write",
+    "lint:ts": "eslint src/**",
+    "lint:ts-fix": "pnpm lint:ts --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "changeset": "changeset add",
+    "publish-version": "changeset version",
+    "publish-package": "pnpm build && changeset publish"
+  },
   "dependencies": {
-    "@ant-design/graphs": "^2.1.1",
-    "@ant-design/icons": "^5.6.1",
-    "@ant-design/plots": "^2.6.5",
-    "@antv/event-emitter": "^0.1.3",
-    "@antv/g": "6.1.27",
     "@antv/g2": "^5.4.1",
-    "@antv/g6": "^5.0.49",
-    "@antv/l7": "^2.23.0",
-    "@antv/larkmap": "^1.5.1",
-    "@antv/s2": "^2.0.0",
-    "@playwright/test": "^1.56.0",
+    "@antv/t8": "^0.3.0",
     "@zumer/snapdom": "^1.9.14",
-    "copy-text-to-clipboard": "^3.2.2",
-    "lodash": "^4.17.21",
-    "rc-resize-observer": "^1.4.3",
-    "react-error-boundary": "6.0.3",
-    "react-markdown": "^9.1.0",
-    "react-syntax-highlighter": "^15.6.6",
-    "rehype-raw": "^7.0.0",
-    "remark-gfm": "^4.0.1",
-    "styled-components": "^6.1.19"
+    "measury": "^0.1.5"
   },
   "devDependencies": {
-    "@ant-design/x": "^1.6.1",
     "@changesets/changelog-github": "^0.5.1",
     "@changesets/cli": "^2.29.7",
     "@commitlint/cli": "^19.8.1",
     "@commitlint/config-conventional": "^19.8.1",
     "@eslint/js": "^9.37.0",
-    "@playwright/test": "^1.56.0",
-    "@types/jest": "^29.5.14",
-    "@types/lodash": "^4.17.20",
-    "@types/react": "^18.3.26",
-    "@types/react-dom": "^18.3.1",
-    "@types/react-syntax-highlighter": "^15.5.13",
     "@types/webpack-bundle-analyzer": "^4.7.0",
-    "antd": "^5.27.5",
-    "dumi": "^2.4.21",
     "eslint": "^9.37.0",
     "eslint-config-prettier": "^9.1.2",
-    "eslint-plugin-jest": "^28.14.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^5.2.0",
     "father": "^4.6.7",
-    "gh-pages": "^6.3.0",
     "globals": "^15.15.0",
     "husky": "^9.1.7",
-    "jest": "^29.7.0",
-    "jest-environment-jsdom": "^29.7.0",
     "limit-size": "^0.1.4",
     "lint-staged": "^15.5.2",
     "npm-run-all": "^4.1.5",
-    "prettier": "^3.6.2",
+    "prettier": "^3.8.1",
     "prettier-plugin-organize-imports": "^4.3.0",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "ts-jest": "^29.4.5",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.46.1",
+    "vitest": "^4.0.18",
     "webpack-bundle-analyzer": "^4.10.2"
   },
-  "peerDependencies": {
-    "antd": "^5.24.6",
-    "react": ">=16.9.0",
-    "react-dom": ">=16.9.0"
-  },
   "engines": {
     "node": ">=18",
     "pnpm": ">=8"
@@ -124,31 +98,16 @@
   "limit-size": [
     {
       "path": "dist/umd/index.min.js",
-      "limit": "5 Mb"
+      "limit": "1.5 Mb"
+    },
+    {
+      "path": "dist/umd/index.min.js",
+      "limit": "500 Kb",
+      "gzip": true
     }
   ],
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
-  },
-  "scripts": {
-    "start": "pnpm dev",
-    "dev": "dumi dev",
-    "build": "father build",
-    "docs:build": "dumi build",
-    "docs:build-analyze": "ANALYZE=1 dumi build",
-    "docs:deploy": "gh-pages -d docs-dist",
-    "deploy": "pnpm docs:build && pnpm docs:deploy",
-    "check-deps": "father doctor",
-    "check-format": "prettier './**/*.{ts,tsx,js,jsx,json,md,css,less}' --check",
-    "format": "prettier './**/*.{ts,tsx,js,jsx,json,md,css,less}' --write",
-    "lint:ts": "eslint src/**",
-    "lint:ts-fix": "pnpm lint:ts --fix",
-    "test:unit": "jest --config ./jest.config.ts",
-    "test": "pnpm build && npx playwright test",
-    "test:size": "pnpm build && limit-size",
-    "changeset": "changeset add",
-    "publish-version": "changeset version && node scripts/sync-version",
-    "publish-package": "pnpm build && changeset publish"
   }
 }

package/src/gpt-vis/index.ts

@@ -0,0 +1,283 @@
+import { isVisSyntax, parse } from '../syntax/parser';
+import type { VisualizationOptions } from '../types';
+import { createVisWrapper, type WrapperInstance } from '../vis-wrapper';
+import type { AreaConfig, AreaInstance } from '../vis/area';
+import { Area } from '../vis/area';
+import type { BarConfig, BarInstance } from '../vis/bar';
+import { Bar } from '../vis/bar';
+import type { BoxplotConfig, BoxplotInstance } from '../vis/boxplot';
+import { Boxplot } from '../vis/boxplot';
+import type { ColumnConfig, ColumnInstance } from '../vis/column';
+import { Column } from '../vis/column';
+import type { DualAxesConfig, DualAxesInstance } from '../vis/dual-axes';
+import { DualAxes } from '../vis/dual-axes';
+import type { FunnelConfig, FunnelInstance } from '../vis/funnel';
+import { Funnel } from '../vis/funnel';
+import type { HistogramConfig, HistogramInstance } from '../vis/histogram';
+import { Histogram } from '../vis/histogram';
+import type { LineConfig, LineInstance } from '../vis/line';
+import { Line } from '../vis/line';
+import type { LiquidConfig, LiquidInstance } from '../vis/liquid';
+import { Liquid } from '../vis/liquid';
+import type { PieConfig, PieInstance } from '../vis/pie';
+import { Pie } from '../vis/pie';
+import type { RadarConfig, RadarInstance } from '../vis/radar';
+import { Radar } from '../vis/radar';
+import type { SankeyConfig, SankeyInstance } from '../vis/sankey';
+import { Sankey } from '../vis/sankey';
+import type { ScatterConfig, ScatterInstance } from '../vis/scatter';
+import { Scatter } from '../vis/scatter';
+import type { SummaryConfig, SummaryInstance } from '../vis/summary';
+import { Summary } from '../vis/summary';
+import type { TableConfig, TableInstance } from '../vis/table';
+import { Table } from '../vis/table';
+import type { TreemapConfig, TreemapInstance } from '../vis/treemap';
+import { Treemap } from '../vis/treemap';
+import type { VennConfig, VennInstance } from '../vis/venn';
+import { Venn } from '../vis/venn';
+import type { ViolinConfig, ViolinInstance } from '../vis/violin';
+import { Violin } from '../vis/violin';
+import type { WaterfallConfig, WaterfallInstance } from '../vis/waterfall';
+import { Waterfall } from '../vis/waterfall';
+import type { WordCloudConfig, WordCloudInstance } from '../vis/word-cloud';
+import { WordCloud } from '../vis/word-cloud';
+
+/**
+ * Union type for all supported chart configurations
+ */
+export type GPTVisConfig =
+  | AreaConfig
+  | BarConfig
+  | BoxplotConfig
+  | ColumnConfig
+  | DualAxesConfig
+  | FunnelConfig
+  | HistogramConfig
+  | LineConfig
+  | LiquidConfig
+  | PieConfig
+  | RadarConfig
+  | SankeyConfig
+  | ScatterConfig
+  | SummaryConfig
+  | TableConfig
+  | TreemapConfig
+  | VennConfig
+  | ViolinConfig
+  | WaterfallConfig
+  | WordCloudConfig;
+
+/**
+ * Union type for all chart instances
+ */
+type ChartInstance =
+  | AreaInstance
+  | BarInstance
+  | BoxplotInstance
+  | ColumnInstance
+  | DualAxesInstance
+  | FunnelInstance
+  | HistogramInstance
+  | LineInstance
+  | LiquidInstance
+  | PieInstance
+  | RadarInstance
+  | SankeyInstance
+  | ScatterInstance
+  | SummaryInstance
+  | TableInstance
+  | TreemapInstance
+  | VennInstance
+  | ViolinInstance
+  | WaterfallInstance
+  | WordCloudInstance;
+
+/**
+ * GPTVis is the unified API for all chart types.
+ * It provides a simple interface to render different types of visualizations.
+ *
+ * @example
+ * ```ts
+ * import { GPTVis } from '@antv/gpt-vis';
+ *
+ * const g = new GPTVis({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ *   theme: 'academy', // Optional theme
+ *   wrapper: true, // Enable wrapper with tabs and controls (default: false)
+ * });
+ *
+ * // Render with config object
+ * g.render({
+ *   type: 'pie',
+ *   data: [
+ *     { category: '分类一', value: 27 },
+ *     { category: '分类二', value: 25 },
+ *   ],
+ *   innerRadius: 0.6,
+ * });
+ *
+ * // Or render with syntax string
+ * g.render(`
+ * vis pie
+ * data
+ *   - category 分类一
+ *     value 27
+ *   - category 分类二
+ *     value 25
+ * innerRadius: 0.6
+ * `);
+ *
+ * g.destroy();
+ * ```
+ */
+export class GPTVis {
+  private options: VisualizationOptions;
+  private currentChart: ChartInstance | null = null;
+  private wrapperInstance: WrapperInstance | null = null;
+
+  /**
+   * Chart type registry mapping type strings to factory functions
+   */
+  private static readonly chartRegistry: Record<
+    string,
+    (options: VisualizationOptions) => ChartInstance
+  > = {
+    area: Area,
+    bar: Bar,
+    boxplot: Boxplot,
+    column: Column,
+    'dual-axes': DualAxes,
+    funnel: Funnel,
+    histogram: Histogram,
+    line: Line,
+    liquid: Liquid,
+    pie: Pie,
+    radar: Radar,
+    sankey: Sankey,
+    scatter: Scatter,
+    summary: Summary,
+    table: Table,
+    treemap: Treemap,
+    venn: Venn,
+    violin: Violin,
+    waterfall: Waterfall,
+    'word-cloud': WordCloud,
+  };
+
+  /**
+   * Constructor
+   * @param options - Visualization options containing container, dimensions, and optional theme
+   */
+  constructor(options: VisualizationOptions) {
+    this.options = options;
+  }
+
+  /**
+   * Render a chart based on the provided configuration or syntax string.
+   *
+   * @param config - Chart configuration object (with type field) or syntax string (starting with 'vis [type]')
+   *
+   * @example
+   * ```ts
+   * // With config object
+   * g.render({
+   *   type: 'pie',
+   *   data: [{ category: 'A', value: 30 }, { category: 'B', value: 70 }]
+   * });
+   *
+   * // With syntax string
+   * g.render(`
+   * vis pie
+   * data
+   *   - category A
+   *     value 30
+   *   - category B
+   *     value 70
+   * `);
+   * ```
+   */
+  render(config: string | Record<string, unknown>): void {
+    let type = '';
+    let chartConfig: any;
+    // If config is a string, parse it as syntax
+    if (!isVisSyntax(config) && typeof config === 'string') {
+      // Parse the syntax string by `Summary` component directly
+      type = 'summary';
+      chartConfig = config;
+    } else {
+      // Otherwise, parse the config object or syntax string
+      chartConfig = typeof config === 'string' ? parse(config) : config;
+      type = chartConfig.type as string;
+    }
+
+    if (!type) {
+      throw new Error(
+        'Chart type is required. Please provide a "type" field in the config object or use syntax string starting with "vis [type]".',
+      );
+    }
+
+    if (!type) {
+      throw new Error('Chart type is required');
+    }
+
+    const chartFactory = GPTVis.chartRegistry[type];
+
+    if (!chartFactory) {
+      const availableTypes = Object.keys(GPTVis.chartRegistry).join(', ');
+      throw new Error(`Unsupported chart type: "${type}". Available types: ${availableTypes}`);
+    }
+
+    // Destroy previous chart if exists
+    if (this.currentChart) {
+      this.currentChart.destroy();
+    }
+
+    // Destroy previous wrapper if exists
+    if (this.wrapperInstance) {
+      this.wrapperInstance.destroy();
+      this.wrapperInstance = null;
+    }
+
+    // Create wrapper if enabled
+    let chartContainer = this.options.container;
+    if (this.options.wrapper) {
+      this.wrapperInstance = createVisWrapper(this.options.container, {
+        chartType: type,
+        syntax: config,
+        locale: this.options.locale || 'zh-CN',
+      });
+      chartContainer = this.wrapperInstance.chartContainer;
+    }
+
+    // Create chart options with the appropriate container and theme
+    const chartOptions: VisualizationOptions = {
+      ...this.options,
+      container: chartContainer,
+    };
+
+    // Create new chart instance and render with merged config
+    this.currentChart = chartFactory(chartOptions);
+    (this.currentChart as any).render(chartConfig);
+
+    // Set chart reference in wrapper if wrapper is enabled
+    if (this.wrapperInstance) {
+      this.wrapperInstance.setChartRef(this.currentChart);
+    }
+  }
+
+  /**
+   * Destroy the current chart instance and clean up resources
+   */
+  destroy(): void {
+    if (this.currentChart) {
+      this.currentChart.destroy();
+      this.currentChart = null;
+    }
+    if (this.wrapperInstance) {
+      this.wrapperInstance.destroy();
+      this.wrapperInstance = null;
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,44 @@
+export { GPTVis } from './gpt-vis';
+export type { GPTVisConfig } from './gpt-vis';
+export { isVisSyntax } from './syntax';
+export type { VisualizationOptions } from './types';
+export { Area } from './vis/area';
+export type { AreaConfig, AreaDataItem } from './vis/area';
+export { Bar } from './vis/bar';
+export type { BarConfig, BarDataItem } from './vis/bar';
+export { Boxplot } from './vis/boxplot';
+export type { BoxplotConfig, BoxplotDataItem } from './vis/boxplot';
+export { Column } from './vis/column';
+export type { ColumnConfig, ColumnDataItem } from './vis/column';
+export { DualAxes } from './vis/dual-axes';
+export type { DualAxesConfig, DualAxesSeriesItem } from './vis/dual-axes';
+export { Funnel } from './vis/funnel';
+export type { FunnelConfig, FunnelDataItem } from './vis/funnel';
+export { Histogram } from './vis/histogram';
+export type { HistogramConfig } from './vis/histogram';
+export { Line } from './vis/line';
+export type { LineConfig, LineDataItem } from './vis/line';
+export { Liquid } from './vis/liquid';
+export type { LiquidConfig } from './vis/liquid';
+export { Pie } from './vis/pie';
+export type { PieConfig } from './vis/pie';
+export { Radar } from './vis/radar';
+export type { RadarConfig, RadarDataItem } from './vis/radar';
+export { Sankey } from './vis/sankey';
+export type { SankeyConfig, SankeyDataItem } from './vis/sankey';
+export { Scatter } from './vis/scatter';
+export type { ScatterConfig, ScatterDataItem } from './vis/scatter';
+export { Summary } from './vis/summary';
+export type { SummaryConfig } from './vis/summary';
+export { Table } from './vis/table';
+export type { TableConfig } from './vis/table';
+export { Treemap } from './vis/treemap';
+export type { TreemapConfig, TreemapDataItem } from './vis/treemap';
+export { Venn } from './vis/venn';
+export type { VennConfig, VennDataItem } from './vis/venn';
+export { Violin } from './vis/violin';
+export type { ViolinConfig, ViolinDataItem } from './vis/violin';
+export { Waterfall } from './vis/waterfall';
+export type { WaterfallConfig, WaterfallDataItem, WaterfallPalette } from './vis/waterfall';
+export { WordCloud } from './vis/word-cloud';
+export type { WordCloudConfig, WordCloudDataItem } from './vis/word-cloud';

package/src/readme.md

@@ -0,0 +1,37 @@
+# GPT-Vis 1.0: Visualization for AI, Friendly!
+
+## Vision
+
+GPT-Vis is repositioning itself as **AntV's entry point for AI-powered visualization**. The new vision focuses on providing AI-friendly visualization components that work seamlessly across different technology stacks and frameworks.
+
+### Core Philosophy
+
+**AI-First Design**: We believe AI will gradually abstract away the complexities of underlying visualization engines. Users care about their needs, and AI-powered solutions are what matter most. GPT-Vis 1.0 embraces this by offering visualization syntax and components optimized for AI interaction, streaming output, and fault tolerance.
+
+**Technology Agnostic**: Moving away from React-only implementation to support pure JavaScript, Vue, and other frameworks. This ensures GPT-Vis can serve as a universal visualization solution for AI applications across the entire frontend ecosystem.
+
+**Unified Gateway**: GPT-Vis serves as the unified entry point for all AntV visualization libraries (G2, S2, G6, X6, L7) in AI environments, making it easier for AI agents to leverage powerful data visualization capabilities without understanding the intricacies of each engine.
+
+The library now provides 20+ common statistical charts with enhanced capabilities, improved user experience, and reduced bundle size. It introduces an AI-friendly visualization syntax inspired by Infographic standards, supporting streaming rendering and robust error handling.
+
+GPT-Vis 1.0 is designed for AI-driven scenarios including data visualization, data analysis, AI-generated reports, and presentations, ensuring that visualization remains accessible and powerful in the age of artificial intelligence.
+
+## Release Schedule
+
+**⏰ Version 1.0 Stable Release: Expected March 21, 2026**
+
+Stay tuned for the official release featuring the complete reimagined architecture and comprehensive AI visualization capabilities.
+
+---
+
+## ⚠️ AI-Generated Code Policy
+
+> **Warning**: This project **only merges code generated by AI**.
+
+To contribute to this project, please follow these steps:
+
+1. **Submit an Issue**: Clearly describe the problem, feature request, or improvement you'd like to see
+2. **Assign to Copilot**: Tag `@copilot` in your issue and describe your requirements in detail
+3. **AI-Generated Code**: Let Copilot or other AI coding assistants generate the implementation
+
+This policy ensures consistency with the project's AI-first philosophy and maintains a high standard of AI-compatible code throughout the codebase.

package/src/syntax/index.ts

@@ -0,0 +1,2 @@
+export { isVisSyntax, parse } from './parser';
+export type { ParsedConfig } from './parser';