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

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

@@ -0,0 +1,315 @@
+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); }
+var _excluded = ["children"];
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+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); }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+import { Graph, idOf, positionOf, treeToGraphData } from '@antv/g6';
+import { getBackgroundColor, normalizePalette } from "../../util/theme";
+
+/**
+ * MindmapConfig defines the configuration for rendering the mindmap.
+ */
+
+/**
+ * MindmapInstance represents a mindmap instance with render and destroy methods.
+ */
+
+/** Props type for SSR package to import */
+
+/**
+ * Convert GPT-Vis tree data (name-based) to G6 tree data (id-based).
+ */
+function toG6TreeData(node) {
+  return {
+    id: node.name,
+    children: (node.children || []).map(toG6TreeData)
+  };
+}
+
+/**
+ * Convert GPT-Vis tree data to G6 graph data with depth info.
+ */
+function convertTreeData(treeData) {
+  return treeToGraphData(toG6TreeData(treeData), {
+    getNodeData: function getNodeData(datum, depth) {
+      datum.depth = depth;
+      if (!datum.children) return datum;
+      var children = datum.children,
+        rest = _objectWithoutProperties(datum, _excluded);
+      return _objectSpread(_objectSpread({}, rest), {}, {
+        children: children.map(function (child) {
+          return child.id;
+        })
+      });
+    }
+  });
+}
+
+/**
+ * Assign branch colors to graph data before rendering.
+ * Each depth=1 node gets a unique color from the palette; descendants inherit.
+ * Runs before Graph creation so colors are available on first render.
+ */
+function assignBranchColors(graphData, colors) {
+  var nodes = graphData.nodes || [];
+  var colorIndex = 0;
+  var nodeMap = new Map();
+  var _iterator = _createForOfIteratorHelper(nodes),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var node = _step.value;
+      nodeMap.set(String(node.id), node);
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  var dfs = function dfs(nodeId, color) {
+    var _node$children;
+    var node = nodeMap.get(String(nodeId));
+    if (!node) return;
+    node.style = node.style || {};
+    node.style.color = color || colors[colorIndex++ % colors.length];
+    (_node$children = node.children) === null || _node$children === void 0 || _node$children.forEach(function (childId) {
+      return dfs(childId, node.style.color);
+    });
+  };
+  nodes.filter(function (n) {
+    return n.depth === 1;
+  }).forEach(function (n) {
+    return dfs(String(n.id));
+  });
+}
+
+/**
+ * Get the side of a node relative to its parent.
+ */
+function getNodeSide(nodeData, parentData) {
+  if (!parentData) return 'center';
+  return positionOf(parentData)[0] > positionOf(nodeData)[0] ? 'left' : 'right';
+}
+
+/**
+ * Estimate node width based on text length (approximate).
+ */
+function estimateNodeWidth(text, fontSize, padding) {
+  var avgCharWidth = fontSize * 0.58;
+  var cjkCount = (text.match(/[\u4e00-\u9fff\u3000-\u303f\uff00-\uffef]/g) || []).length;
+  var otherCount = text.length - cjkCount;
+  var textWidth = cjkCount * fontSize + otherCount * avgCharWidth;
+  return Math.min(Math.max(textWidth + padding, 120), 300);
+}
+
+/**
+ * Mindmap component using G6 5.0 with mindmap layout.
+ * Follows the "boxed" type style from 0.x @ant-design/graphs MindMap.
+ */
+export var Mindmap = function Mindmap(options) {
+  var container = options.container,
+    width = options.width,
+    height = options.height,
+    _options$theme = options.theme,
+    chartTheme = _options$theme === void 0 ? 'default' : _options$theme;
+  var graph = null;
+  var render = function render(config) {
+    var data = config.data,
+      _config$direction = config.direction,
+      direction = _config$direction === void 0 ? 'H' : _config$direction,
+      _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;
+    if (!data || !data.name) {
+      throw new Error('Mindmap: data with a name field is required');
+    }
+    if (graph) {
+      graph.destroy();
+      graph = null;
+    }
+    var containerEl = typeof container === 'string' ? document.querySelector(container) : container;
+    if (!containerEl) {
+      throw new Error('Mindmap: container element not found');
+    }
+    containerEl.innerHTML = '';
+    var colors = normalizePalette(style.palette, theme);
+    var backgroundColor = style.backgroundColor || getBackgroundColor(theme);
+    var isDark = theme === 'dark';
+    containerEl.style.background = backgroundColor;
+
+    // Convert tree data and assign branch colors before rendering
+    var graphData = convertTreeData(data);
+    assignBranchColors(graphData, colors);
+
+    // Pre-calculate node sizes so layout and renderer use consistent values
+    var _iterator2 = _createForOfIteratorHelper(graphData.nodes || []),
+      _step2;
+    try {
+      for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+        var _node$depth;
+        var node = _step2.value;
+        var label = String(node.id);
+        var depth = (_node$depth = node.depth) !== null && _node$depth !== void 0 ? _node$depth : 0;
+        var fontSize = depth === 0 ? 24 : 16;
+        var pad = depth === 0 ? 64 : 36;
+        node.layoutSize = [estimateNodeWidth(label, fontSize, pad), depth === 0 ? 60 : 48];
+      }
+    } catch (err) {
+      _iterator2.e(err);
+    } finally {
+      _iterator2.f();
+    }
+    graph = new Graph({
+      animation: false,
+      container: containerEl,
+      width: width,
+      height: height,
+      autoFit: 'view',
+      autoResize: true,
+      padding: 20,
+      zoomRange: [0.1, 5],
+      zoom: 1,
+      theme: chartTheme,
+      data: graphData,
+      plugins: title ? [{
+        key: 'title',
+        type: 'title',
+        title: title,
+        titleFill: isDark ? '#e0e6ed' : '#1a1a2e'
+      }] : [],
+      node: {
+        type: 'rect',
+        animation: {
+          translate: false,
+          update: false
+        },
+        style: function (d) {
+          var _depth, _d$style;
+          var depth = (_depth = d.depth) !== null && _depth !== void 0 ? _depth : 0;
+          var color = (_d$style = d.style) === null || _d$style === void 0 ? void 0 : _d$style.color;
+          var label = String(idOf(d));
+          var parentData = this.getParentData(idOf(d), 'tree');
+          var _ref = d.layoutSize || [120, 48],
+            _ref2 = _slicedToArray(_ref, 2),
+            nodeWidth = _ref2[0],
+            nodeHeight = _ref2[1];
+
+          // Node side for dx offset (matching 0.x getNodeSide + dx logic)
+          var side = direction === 'RL' ? 'left' : direction === 'LR' ? 'right' : getNodeSide(d, parentData);
+          var fontSize = depth === 0 ? 24 : 16;
+          var fontWeight = depth <= 1 ? 600 : 400;
+
+          // dx offset: left=-width, center=-width/2, right=0 (matching 0.x)
+          var dx = side === 'left' ? -nodeWidth : side === 'center' ? -nodeWidth / 2 : 0;
+
+          // Common style
+          var base = {
+            size: [nodeWidth, nodeHeight],
+            dx: dx,
+            radius: 8,
+            labelText: label,
+            labelPlacement: 'center',
+            labelFontSize: fontSize,
+            labelFontWeight: fontWeight,
+            ports: [{
+              placement: 'left'
+            }, {
+              placement: 'right'
+            }]
+          };
+
+          // Depth 0: gray filled (root)
+          if (depth === 0) {
+            return _objectSpread(_objectSpread({}, base), {}, {
+              fill: isDark ? '#333' : '#f1f4f5',
+              labelFill: isDark ? '#e0e0e0' : '#252525'
+            });
+          }
+
+          // Depth 1: filled with branch color
+          if (depth === 1) {
+            return _objectSpread(_objectSpread({}, base), {}, {
+              fill: color || '#99ADD1',
+              labelFill: '#fff'
+            });
+          }
+
+          // Depth 2+: outlined with branch color border
+          return _objectSpread(_objectSpread({}, base), {}, {
+            fill: backgroundColor,
+            stroke: color || (isDark ? '#555' : '#99ADD1'),
+            lineWidth: 3,
+            labelFill: isDark ? color || '#ccc' : color || '#333'
+          });
+        }
+      },
+      edge: {
+        type: 'cubic-horizontal',
+        animation: {
+          translate: false,
+          update: false
+        },
+        style: {
+          lineWidth: 3,
+          stroke: function stroke(edgeData) {
+            var _sourceNode$style;
+            var sourceNode = this.getNodeData(edgeData.source);
+            return (sourceNode === null || sourceNode === void 0 || (_sourceNode$style = sourceNode.style) === null || _sourceNode$style === void 0 ? void 0 : _sourceNode$style.color) || (isDark ? '#555' : '#99ADD1');
+          }
+        }
+      },
+      layout: {
+        type: 'mindmap',
+        direction: direction,
+        preLayout: false,
+        getWidth: function getWidth(nodeData) {
+          var _nodeData$layoutSize$, _nodeData$layoutSize;
+          return (_nodeData$layoutSize$ = (_nodeData$layoutSize = nodeData.layoutSize) === null || _nodeData$layoutSize === void 0 ? void 0 : _nodeData$layoutSize[0]) !== null && _nodeData$layoutSize$ !== void 0 ? _nodeData$layoutSize$ : 120;
+        },
+        getHeight: function getHeight(nodeData) {
+          var _nodeData$layoutSize$2, _nodeData$layoutSize2;
+          return (_nodeData$layoutSize$2 = (_nodeData$layoutSize2 = nodeData.layoutSize) === null || _nodeData$layoutSize2 === void 0 ? void 0 : _nodeData$layoutSize2[1]) !== null && _nodeData$layoutSize$2 !== void 0 ? _nodeData$layoutSize$2 : 48;
+        },
+        getHGap: function getHGap() {
+          return 64;
+        },
+        getVGap: function getVGap() {
+          return 14;
+        }
+      },
+      behaviors: ['drag-canvas']
+    });
+    graph.render();
+  };
+  var destroy = function destroy() {
+    if (graph) {
+      graph.destroy();
+      graph = null;
+    }
+  };
+  return {
+    render: render,
+    destroy: destroy,
+    zoomTo: function zoomTo(zoom) {
+      var _graph;
+      return (_graph = graph) === null || _graph === void 0 ? void 0 : _graph.zoomTo(zoom);
+    },
+    getZoom: function getZoom() {
+      var _graph2;
+      return (_graph2 = graph) === null || _graph2 === void 0 ? void 0 : _graph2.getZoom();
+    }
+  };
+};

package/dist/esm/vis/network-graph/index.d.ts

@@ -0,0 +1,59 @@
+import type { GraphData, VisualizationOptions } from '../../types';
+export type NetworkGraphNode = GraphData['nodes'][number];
+export type NetworkGraphEdge = GraphData['edges'][number];
+export type NetworkGraphData = GraphData;
+/**
+ * NetworkGraphConfig defines the configuration for rendering the network graph.
+ */
+export interface NetworkGraphConfig {
+    type?: 'network-graph';
+    data: NetworkGraphData;
+    layout?: 'force' | 'circular' | 'grid' | 'radial' | 'concentric' | 'dagre';
+    theme?: 'default' | 'academy' | 'dark';
+    title?: string;
+    style?: {
+        backgroundColor?: string;
+        palette?: string[];
+    };
+}
+/**
+ * NetworkGraphInstance represents a network graph instance with render and destroy methods.
+ */
+export interface NetworkGraphInstance {
+    render: (config: NetworkGraphConfig) => void;
+    destroy: () => void;
+    zoomTo: (zoom: number) => void;
+    getZoom: () => number | undefined;
+}
+/**
+ * NetworkGraph component using G6 5.0.
+ *
+ * @example
+ * ```ts
+ * const graph = NetworkGraph({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * graph.render({
+ *   type: 'network-graph',
+ *   data: {
+ *     nodes: [
+ *       { name: '哈利·波特' },
+ *       { name: '赫敏·格兰杰' },
+ *       { name: '伏地魔' },
+ *     ],
+ *     edges: [
+ *       { source: '哈利·波特', target: '赫敏·格兰杰', name: '朋友' },
+ *       { source: '哈利·波特', target: '伏地魔', name: '敌人' },
+ *     ],
+ *   },
+ *   layout: 'force',
+ *   theme: 'academy',
+ * });
+ *
+ * graph.destroy();
+ * ```
+ */
+export declare const NetworkGraph: (options: VisualizationOptions) => NetworkGraphInstance;

package/dist/esm/vis/network-graph/index.js

@@ -0,0 +1,240 @@
+import { Graph } from '@antv/g6';
+import { getBackgroundColor, normalizePalette } from "../../util/theme";
+
+/**
+ * NetworkGraphConfig defines the configuration for rendering the network graph.
+ */
+
+/**
+ * NetworkGraphInstance represents a network graph instance with render and destroy methods.
+ */
+
+/**
+ * NetworkGraph component using G6 5.0.
+ *
+ * @example
+ * ```ts
+ * const graph = NetworkGraph({
+ *   container: '#container',
+ *   width: 600,
+ *   height: 400,
+ * });
+ *
+ * graph.render({
+ *   type: 'network-graph',
+ *   data: {
+ *     nodes: [
+ *       { name: '哈利·波特' },
+ *       { name: '赫敏·格兰杰' },
+ *       { name: '伏地魔' },
+ *     ],
+ *     edges: [
+ *       { source: '哈利·波特', target: '赫敏·格兰杰', name: '朋友' },
+ *       { source: '哈利·波特', target: '伏地魔', name: '敌人' },
+ *     ],
+ *   },
+ *   layout: 'force',
+ *   theme: 'academy',
+ * });
+ *
+ * graph.destroy();
+ * ```
+ */
+export var NetworkGraph = function NetworkGraph(options) {
+  var container = options.container,
+    width = options.width,
+    height = options.height,
+    _options$theme = options.theme,
+    chartTheme = _options$theme === void 0 ? 'default' : _options$theme;
+  var graph = null;
+
+  /**
+   * Render the network graph with the given configuration.
+   */
+  var render = function render(config) {
+    var _config$data = config.data,
+      data = _config$data === void 0 ? {
+        nodes: [],
+        edges: []
+      } : _config$data,
+      _config$layout = config.layout,
+      layout = _config$layout === void 0 ? 'force' : _config$layout,
+      _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;
+    var _data$nodes = data.nodes,
+      nodes = _data$nodes === void 0 ? [] : _data$nodes,
+      _data$edges = data.edges,
+      edges = _data$edges === void 0 ? [] : _data$edges;
+
+    // Clean up previous graph if exists
+    if (graph) {
+      graph.destroy();
+      graph = null;
+    }
+    var colors = normalizePalette(style.palette, theme);
+    var backgroundColor = style.backgroundColor || getBackgroundColor(theme);
+    var isDark = theme === 'dark';
+    var containerEl = typeof container === 'string' ? document.querySelector(container) : container;
+    if (!containerEl) {
+      throw new Error('NetworkGraph: container element not found');
+    }
+
+    // Clear previous content
+    containerEl.innerHTML = '';
+
+    // Set container styles
+    containerEl.style.background = backgroundColor;
+    containerEl.style.borderRadius = '4px';
+    containerEl.style.overflow = 'hidden';
+
+    // Build G6 node data
+    var nodeData = nodes.map(function (node, index) {
+      return {
+        id: node.name,
+        data: {
+          label: node.name
+        },
+        style: {
+          fill: colors[index % colors.length],
+          stroke: isDark ? '#444' : '#fff',
+          lineWidth: 2,
+          labelText: node.name,
+          labelFill: isDark ? '#e0e0e0' : '#333',
+          labelFontSize: 12,
+          size: 28
+        }
+      };
+    });
+
+    // Build G6 edge data
+    var edgeData = edges.map(function (edge) {
+      var _edge$name, _edge$name2;
+      return {
+        source: edge.source,
+        target: edge.target,
+        data: {
+          label: (_edge$name = edge.name) !== null && _edge$name !== void 0 ? _edge$name : ''
+        },
+        style: {
+          stroke: isDark ? '#555' : '#ccc',
+          lineWidth: 1.5,
+          endArrow: true,
+          labelText: (_edge$name2 = edge.name) !== null && _edge$name2 !== void 0 ? _edge$name2 : '',
+          labelFill: isDark ? '#aaa' : '#666',
+          labelFontSize: 11,
+          labelBackground: !!edge.name,
+          labelBackgroundFill: backgroundColor,
+          labelBackgroundOpacity: 0.8
+        }
+      };
+    });
+
+    // Layout configuration.
+    // IMPORTANT for 'force' layout:
+    //   - edgeStrength default is 500 (edge attraction), NOT a small decimal
+    //   - nodeStrength default is 1000 (node attraction); Coulomb repulsion is
+    //     handled separately via factor/coulombDisScale, so no need for negative value
+    //   - gravity keeps nodes near center so they don't drift off canvas
+    var layoutConfig = {
+      force: {
+        type: 'force',
+        preventOverlap: true,
+        nodeSize: 32,
+        linkDistance: 150,
+        gravity: 10
+      },
+      circular: {
+        type: 'circular'
+      },
+      grid: {
+        type: 'grid',
+        rows: Math.max(1, Math.ceil(Math.sqrt(nodes.length)))
+      },
+      radial: {
+        type: 'radial',
+        preventOverlap: true,
+        nodeSize: 32
+      },
+      concentric: {
+        type: 'concentric',
+        preventOverlap: true,
+        nodeSize: 32
+      },
+      dagre: {
+        type: 'dagre',
+        rankdir: 'TB',
+        nodesep: 50,
+        ranksep: 80
+      }
+    };
+
+    // G6 v5 source confirms: autoFit is called AFTER postLayout() completes
+    // (see runtime/graph.ts render() method), so autoFit: 'view' is safe here.
+    graph = new Graph({
+      animation: false,
+      container: containerEl,
+      width: width,
+      height: height,
+      autoFit: 'view',
+      autoResize: true,
+      padding: 24,
+      data: {
+        nodes: nodeData,
+        edges: edgeData
+      },
+      layout: layoutConfig[layout] || layoutConfig.force,
+      node: {
+        style: {
+          labelPlacement: 'bottom',
+          labelMaxWidth: 100
+        }
+      },
+      behaviors: ['drag-canvas', 'drag-element', 'click-select'],
+      plugins: title ? [{
+        key: 'title',
+        type: 'title',
+        title: title,
+        titleFill: isDark ? '#e0e6ed' : '#1a1a2e'
+      }] : []
+    });
+    graph.render();
+  };
+
+  /**
+   * Destroy the graph instance and clean up resources.
+   */
+  var destroy = function destroy() {
+    if (graph) {
+      graph.destroy();
+      graph = null;
+    }
+  };
+
+  /**
+   * Zoom the graph to a specific level (for wrapper zoom controls).
+   */
+  var zoomTo = function zoomTo(zoom) {
+    if (graph) {
+      graph.zoomTo(zoom);
+    }
+  };
+
+  /**
+   * Get the current zoom level.
+   */
+  var getZoom = function getZoom() {
+    if (graph) {
+      return graph.getZoom();
+    }
+    return 1;
+  };
+  return {
+    render: render,
+    destroy: destroy,
+    zoomTo: zoomTo,
+    getZoom: getZoom
+  };
+};

package/dist/esm/vis/organization-chart/index.d.ts

@@ -0,0 +1,64 @@
+import type { TreeGraphData, VisualizationOptions } from '../../types';
+export type OrganizationChartData = TreeGraphData;
+/**
+ * OrganizationChartConfig defines the configuration for rendering the organization chart.
+ */
+export interface OrganizationChartConfig {
+    type?: 'organization-chart';
+    data: OrganizationChartData;
+    theme?: 'default' | 'academy' | 'dark';
+    title?: string;
+    style?: {
+        backgroundColor?: string;
+        palette?: string[];
+    };
+}
+/**
+ * OrganizationChartInstance represents a chart instance with render and destroy methods.
+ */
+export interface OrganizationChartInstance {
+    render: (config: OrganizationChartConfig) => void;
+    destroy: () => void;
+    zoomTo: (zoom: number) => void;
+    getZoom: () => number | undefined;
+}
+/**
+ * OrganizationChart component using G6 5.0.
+ * - dagre (TB) layout for hierarchical structure
+ * - custom rect node with name + description labels
+ * - depth-based color cycling
+ *
+ * @example
+ * ```ts
+ * const chart = OrganizationChart({ container: '#container', width: 600, height: 400 });
+ *
+ * chart.render({
+ *   type: 'organization-chart',
+ *   data: {
+ *     name: 'Alice Johnson',
+ *     description: 'Chief Technology Officer',
+ *     children: [
+ *       {
+ *         name: 'Bob Smith',
+ *         description: 'Senior Software Engineer',
+ *         children: [
+ *           { name: 'Charlie Brown', description: 'Software Engineer' },
+ *           { name: 'Diana White',   description: 'Software Engineer' },
+ *         ],
+ *       },
+ *       {
+ *         name: 'Eve Black',
+ *         description: 'IT Support Department Head',
+ *         children: [
+ *           { name: 'Frank Green', description: 'IT Support Specialist' },
+ *           { name: 'Grace Blue',  description: 'IT Support Specialist' },
+ *         ],
+ *       },
+ *     ],
+ *   },
+ * });
+ *
+ * chart.destroy();
+ * ```
+ */
+export declare const OrganizationChart: (options: VisualizationOptions) => OrganizationChartInstance;