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

package/dist/cjs/types/index.d.ts

@@ -1,2 +1,33 @@
-export * from './chart';
-export type { GlobalConfig } from './config';
+/**
+ * Common visualization options for all chart components.
+ * Defines the container and dimensions for rendering visualizations.
+ */
+export interface VisualizationOptions {
+    container: string | HTMLElement;
+    width?: number;
+    height?: number;
+    theme?: 'default' | 'light' | 'dark' | 'academy';
+    wrapper?: boolean;
+    locale?: string;
+}
+/**
+ * Tree graph data structure
+ */
+export interface TreeGraphData {
+    name: string;
+    description?: string;
+    children?: TreeGraphData[];
+}
+/**
+ * Network graph data structure
+ */
+export interface GraphData {
+    nodes: {
+        name: string;
+    }[];
+    edges: {
+        source: string;
+        target: string;
+        name?: string;
+    }[];
+}

package/dist/cjs/types/index.js

@@ -10,14 +10,8 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/types/index.ts
 var types_exports = {};
 module.exports = __toCommonJS(types_exports);
-__reExport(types_exports, require("./chart"), module.exports);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ...require("./chart")
-});

package/dist/cjs/util/container.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Resolve a container parameter to an HTMLElement.
+ * Supports CSS selectors (e.g., '#container', '.my-chart') and direct HTMLElement references.
+ */
+export declare function resolveContainer(container: string | HTMLElement): HTMLElement;

package/dist/cjs/{utils/map/util.js → util/container.js}

@@ -16,23 +16,28 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/utils/map/util.ts
-var util_exports = {};
-__export(util_exports, {
-  urlToMarkerId: () => urlToMarkerId
+// src/util/container.ts
+var container_exports = {};
+__export(container_exports, {
+  resolveContainer: () => resolveContainer
 });
-module.exports = __toCommonJS(util_exports);
-function urlToMarkerId(url) {
-  let hash = 0;
-  if (url.length > 0) {
-    for (let i = 0; i < url.length; i++) {
-      hash = (hash << 5) - hash + url.charCodeAt(i) | 0;
+module.exports = __toCommonJS(container_exports);
+function resolveContainer(container) {
+  if (typeof container === "string") {
+    if (typeof document === "undefined") {
+      throw new Error(
+        `Container element "${container}" cannot be resolved in a non-browser environment.`
+      );
     }
+    const el = document.querySelector(container);
+    if (!el) {
+      throw new Error(`Container element "${container}" not found`);
+    }
+    return el;
   }
-  const id = Math.abs(hash % 1e4).toString().padStart(4, "0");
-  return `marker-${id}`;
+  return container;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  urlToMarkerId
+  resolveContainer
 });

package/dist/cjs/util/theme.d.ts

@@ -0,0 +1,26 @@
+export declare const DEFAULT_COLOR_PALETTE: string[];
+export declare const ACADEMY_COLOR_PALETTE: string[];
+export declare const THEME_MAP: Record<string, any>;
+/**
+ * Get normalized theme name for G2.
+ * Converts 'default' to 'light' for G2 compatibility.
+ */
+export declare const getTheme: (theme: string) => string;
+/**
+ * Get theme object from THEME_MAP.
+ * This should be used for visualization components to properly support dark theme with multiple marks.
+ */
+export declare const getThemeObject: (theme: string) => any;
+/**
+ * Get theme color palette based on theme name.
+ */
+export declare const getThemeColors: (theme: string) => string[];
+/**
+ * Get background color based on theme.
+ */
+export declare const getBackgroundColor: (theme: string) => string;
+/**
+ * Normalize palette to always return an array.
+ * Handles the case where a single color is parsed as a string instead of an array.
+ */
+export declare const normalizePalette: (palette: string | string[] | undefined, theme: string) => string[];

package/dist/cjs/{theme.js → util/theme.js}

@@ -16,14 +16,43 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/theme.ts
+// src/util/theme.ts
 var theme_exports = {};
 __export(theme_exports, {
-  G6THEME_MAP: () => G6THEME_MAP,
-  THEME_MAP: () => THEME_MAP
+  ACADEMY_COLOR_PALETTE: () => ACADEMY_COLOR_PALETTE,
+  DEFAULT_COLOR_PALETTE: () => DEFAULT_COLOR_PALETTE,
+  THEME_MAP: () => THEME_MAP,
+  getBackgroundColor: () => getBackgroundColor,
+  getTheme: () => getTheme,
+  getThemeColors: () => getThemeColors,
+  getThemeObject: () => getThemeObject,
+  normalizePalette: () => normalizePalette
 });
 module.exports = __toCommonJS(theme_exports);
-var import_palette = require("./utils/palette");
+var DEFAULT_COLOR_PALETTE = [
+  "#1783FF",
+  "#F08F56",
+  "#D580FF",
+  "#00C9C9",
+  "#7863FF",
+  "#DB9D0D",
+  "#60C42D",
+  "#FF80CA",
+  "#2491B3",
+  "#17C76F"
+];
+var ACADEMY_COLOR_PALETTE = [
+  "#4e79a7",
+  "#f28e2c",
+  "#e15759",
+  "#76b7b2",
+  "#59a14f",
+  "#edc949",
+  "#af7aa1",
+  "#ff9da7",
+  "#9c755f",
+  "#bab0ab"
+];
 var DEFAULT_THEME = {
   type: "light",
   view: {
@@ -116,18 +145,45 @@ var THEME_MAP = {
   academy: ACADEMY_THEME,
   dark: DARK_THEME
 };
-var G6THEME_MAP = {
-  default: {
-    type: "assign-color-by-branch",
-    colors: import_palette.DEFAULT_COLOR_PALETTE
-  },
-  academy: {
-    type: "assign-color-by-branch",
-    colors: import_palette.ACADEMY_COLOR_PALETTE
+var getTheme = (theme) => {
+  return theme === "default" ? "light" : theme;
+};
+var getThemeObject = (theme) => {
+  return THEME_MAP[theme] || THEME_MAP.default;
+};
+var getThemeColors = (theme) => {
+  switch (theme) {
+    case "academy":
+      return ACADEMY_COLOR_PALETTE;
+    case "dark":
+    case "default":
+    default:
+      return DEFAULT_COLOR_PALETTE;
   }
 };
+var getBackgroundColor = (theme) => {
+  switch (theme) {
+    case "dark":
+      return "#000";
+    case "academy":
+    case "default":
+    default:
+      return "#FFF";
+  }
+};
+var normalizePalette = (palette, theme) => {
+  if (!palette || Array.isArray(palette) && palette.length === 0)
+    return getThemeColors(theme);
+  return Array.isArray(palette) ? palette : [palette];
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  G6THEME_MAP,
-  THEME_MAP
+  ACADEMY_COLOR_PALETTE,
+  DEFAULT_COLOR_PALETTE,
+  THEME_MAP,
+  getBackgroundColor,
+  getTheme,
+  getThemeColors,
+  getThemeObject,
+  normalizePalette
 });

package/dist/cjs/vis/area/index.d.ts

@@ -0,0 +1,60 @@
+import type { VisualizationOptions } from '../../types';
+/**
+ * AreaDataItem is the type for each data item in the area chart.
+ */
+export type AreaDataItem = {
+    time: string | number;
+    value: number;
+    group?: string;
+};
+/**
+ * AreaConfig defines the configuration for rendering the area chart.
+ */
+export interface AreaConfig {
+    type?: 'area';
+    data: AreaDataItem[];
+    stack?: boolean;
+    title?: string;
+    axisXTitle?: string;
+    axisYTitle?: string;
+    theme?: 'default' | 'academy' | 'dark';
+    style?: {
+        backgroundColor?: string;
+        palette?: string[];
+        lineWidth?: number;
+    };
+}
+/**
+ * AreaInstance represents an area chart instance with render and destroy methods.
+ */
+export interface AreaInstance {
+    render: (config: AreaConfig) => void;
+    destroy: () => void;
+}
+/**
+ * Area chart component using G2 5.0.
+ *
+ * @example
+ * ```ts
+ * const area = Area({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * area.render({
+ *   type: 'area',
+ *   data: [
+ *     { time: '1 月', value: 23.895 },
+ *     { time: '2 月', value: 23.695 },
+ *     { time: '3 月', value: 23.655 },
+ *   ],
+ *   title: '1月到3月股票价格的变化',
+ *   axisXTitle: '月份',
+ *   axisYTitle: '价格',
+ * });
+ *
+ * area.destroy();
+ * ```
+ */
+export declare const Area: (options: VisualizationOptions) => AreaInstance;

package/dist/cjs/vis/area/index.js

@@ -0,0 +1,152 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/vis/area/index.ts
+var area_exports = {};
+__export(area_exports, {
+  Area: () => Area
+});
+module.exports = __toCommonJS(area_exports);
+var import_g2 = require("@antv/g2");
+var import_theme = require("../../util/theme");
+var getLinearGradientColor = (color) => `linear-gradient(-90deg, white 0%, ${color} 100%)`;
+var DEFAULT_COLOR = "#3A95FF";
+var Area = (options) => {
+  const { container, width, height, theme: chartTheme = "default" } = options;
+  let chart = null;
+  const render = (config) => {
+    var _a;
+    const {
+      data = [],
+      theme = chartTheme,
+      title,
+      axisXTitle,
+      axisYTitle,
+      stack = false,
+      style = {}
+    } = config;
+    if (chart) {
+      chart.destroy();
+    }
+    const { lineWidth = 2 } = style;
+    const hasGroupField = data.length > 0 && ((_a = data[0]) == null ? void 0 : _a.group) !== void 0;
+    const colors = (0, import_theme.normalizePalette)(style.palette, theme);
+    const backgroundColor = style.backgroundColor || (0, import_theme.getBackgroundColor)(theme);
+    const fillColor = getLinearGradientColor(colors[0] || DEFAULT_COLOR);
+    chart = new import_g2.Chart({
+      container,
+      width,
+      height,
+      autoFit: true
+    });
+    let encode = {};
+    let transform = [];
+    const scaleConfig = { y: { nice: true } };
+    let children = [];
+    if (hasGroupField && stack) {
+      encode = { x: "time", y: "value", color: "group" };
+      transform = [{ type: "stackY" }];
+      scaleConfig.color = { range: colors };
+      children = [
+        {
+          type: "area",
+          style: { fillOpacity: 0.6 }
+        },
+        {
+          type: "line",
+          style: { lineWidth, strokeOpacity: 0.6 }
+        }
+      ];
+    } else if (hasGroupField) {
+      encode = { x: "time", y: "value", color: "group" };
+      scaleConfig.color = { range: colors };
+      children = [
+        {
+          type: "area",
+          style: { fillOpacity: 0.6 }
+        },
+        {
+          type: "line",
+          style: { lineWidth, strokeOpacity: 0.6 }
+        }
+      ];
+    } else {
+      encode = { x: "time", y: "value" };
+      children = [
+        {
+          type: "area",
+          style: {
+            fillOpacity: 0.6,
+            fill: fillColor
+          }
+        },
+        {
+          type: "line",
+          style: {
+            lineWidth,
+            strokeOpacity: 0.6,
+            ...style.palette ? { stroke: colors[0] } : {}
+          }
+        }
+      ];
+    }
+    const chartOptions = {
+      animate: false,
+      type: "view",
+      data,
+      title: title ?? "",
+      encode,
+      transform,
+      children,
+      scale: scaleConfig,
+      axis: {
+        x: { title: axisXTitle || false },
+        y: { title: axisYTitle || false }
+      },
+      legend: hasGroupField ? { color: { position: "top" } } : false,
+      tooltip: {
+        items: [
+          (d) => ({
+            name: axisYTitle || d.time,
+            value: d.value
+          })
+        ]
+      },
+      viewStyle: {
+        viewFill: backgroundColor
+      },
+      theme: (0, import_theme.getThemeObject)(theme)
+    };
+    chart.options(chartOptions);
+    chart.render();
+  };
+  const destroy = () => {
+    if (chart) {
+      chart.destroy();
+      chart = null;
+    }
+  };
+  return {
+    render,
+    destroy
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Area
+});

package/dist/cjs/vis/bar/index.d.ts

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

package/dist/cjs/vis/bar/index.js

@@ -0,0 +1,123 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/vis/bar/index.ts
+var bar_exports = {};
+__export(bar_exports, {
+  Bar: () => Bar
+});
+module.exports = __toCommonJS(bar_exports);
+var import_g2 = require("@antv/g2");
+var import_theme = require("../../util/theme");
+var Bar = (options) => {
+  const { container, width, height, theme: chartTheme = "default" } = options;
+  let chart = null;
+  const render = (config) => {
+    var _a;
+    const {
+      data = [],
+      theme = chartTheme,
+      title,
+      axisXTitle,
+      axisYTitle,
+      group = false,
+      stack = false,
+      style = {}
+    } = config;
+    if (chart) {
+      chart.destroy();
+    }
+    const hasGroupField = data.length > 0 && ((_a = data[0]) == null ? void 0 : _a.group) !== void 0;
+    const colors = (0, import_theme.normalizePalette)(style.palette, theme);
+    const backgroundColor = style.backgroundColor || (0, import_theme.getBackgroundColor)(theme);
+    chart = new import_g2.Chart({
+      container,
+      width,
+      height,
+      autoFit: true
+    });
+    let encode = {};
+    let transform = [];
+    let radiusStyle = {};
+    if (theme !== "academy") {
+      radiusStyle = { radiusTopLeft: 4, radiusTopRight: 4 };
+    }
+    if (hasGroupField && group) {
+      transform = [{ type: "dodgeX" }];
+    }
+    if (hasGroupField && stack) {
+      transform = [{ type: "stackY" }];
+    }
+    if (hasGroupField) {
+      encode = { x: "category", y: "value", color: "group" };
+    } else {
+      encode = { x: "category", y: "value", color: "category" };
+    }
+    const scaleConfig = {
+      y: { nice: true },
+      ...style.palette ? { color: { range: colors } } : {}
+    };
+    const chartOptions = {
+      animate: false,
+      type: "interval",
+      data,
+      title: title ?? "",
+      encode,
+      transform,
+      coordinate: { transform: [{ type: "transpose" }] },
+      scale: scaleConfig,
+      axis: {
+        x: { title: axisXTitle || false },
+        y: { title: axisYTitle || false }
+      },
+      legend: hasGroupField ? { color: { position: "top" } } : false,
+      tooltip: {
+        items: [
+          (d) => ({
+            name: axisYTitle || d.category,
+            value: d.value
+          })
+        ]
+      },
+      style: {
+        ...radiusStyle,
+        columnWidthRatio: 0.8
+      },
+      viewStyle: {
+        viewFill: backgroundColor
+      },
+      theme: (0, import_theme.getThemeObject)(theme)
+    };
+    chart.options(chartOptions);
+    chart.render();
+  };
+  const destroy = () => {
+    if (chart) {
+      chart.destroy();
+      chart = null;
+    }
+  };
+  return {
+    render,
+    destroy
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Bar
+});

package/dist/cjs/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;