topo-engine 0.1.0 → 0.1.3

package/dist/index.d.ts

@@ -0,0 +1,115 @@
+/**
+ * 拓扑引擎类型声明文件
+ */
+
+// 核心 API
+export class TopoApi {
+  constructor(graph: any, model: any, layout: any, nodeByIdMap: Map<string, any>);
+  
+  // 查询 API
+  getNode(nodeId: string): any;
+  getAllNodes(): any[];
+  findNodes(filter: object): any[];
+  getSelectedId(): string | null;
+  getNeighbors(nodeId: string): { upstream: any[], downstream: any[] };
+  getStreamNodes(nodeId: string, direction: 'upstream' | 'downstream'): any[];
+  getTrunkNodes(): any[];
+  getSubtreeNodes(nodeId: string): any[];
+  getPath(fromId: string, toId: string): any[] | null;
+  getEdge(srcId: string, tgtId: string): any;
+  getEdges(): any[];
+  getStreamEdges(nodeId: string, direction: 'upstream' | 'downstream'): any[];
+  getMainEdge(): any[];
+  getNodePosition(nodeId: string): { x: number, y: number } | null;
+  getEdgePath(srcId: string, tgtId: string): number[][] | null;
+  getGraphBounds(): { minX: number, minY: number, maxX: number, maxY: number };
+  getStats(): any;
+  
+  // 视图控制
+  fitView(padding?: number): void;
+  zoomTo(ratio: number, center?: { x: number, y: number }): void;
+  zoomIn(step?: number): void;
+  zoomOut(step?: number): void;
+  locateNode(nodeId: string, zoom?: number): void;
+  getViewport(): { zoom: number, center: { x: number, y: number } };
+  
+  // 节点样式
+  setNodeStyle(nodeId: string, style: object): void;
+  batchSetNodeStyle(nodeIds: string[], style: object): void;
+  resetNodeStyle(nodeId: string): void;
+  resetAllNodeStyles(): void;
+  
+  // 边样式
+  setEdgeStyle(srcId: string, tgtId: string, style: object): void;
+  batchSetEdgeStyle(edgeIds: [string, string][], style: object): void;
+  resetEdgeStyle(srcId: string, tgtId: string): void;
+  
+  // 高亮与标注
+  highlightNode(nodeId: string, opts?: object): void;
+  unhighlightNode(nodeId: string): void;
+  highlightPath(nodeIds: string[], opts?: object): void;
+  unhighlightAll(): void;
+  dimOthers(keepIds: string[], opacity?: number): void;
+  
+  // 动画
+  setNodePulse(nodeId: string, opts?: object): void;
+  setEdgeFlow(srcId: string, tgtId: string, opts?: object): void;
+  removeAnimation(targetId: string): void;
+  removeAllAnimations(): void;
+  
+  // 文字标注
+  setText(nodeId: string, text: string, opts?: object): void;
+  removeText(nodeId: string): void;
+  removeAllTexts(): void;
+  setDeviceText(cat: string, fontSize: number): void;
+  changeUserName(mode: 'full' | 'short' | 'hidden'): void;
+  
+  // 卡片盒
+  showCard(nodeId: string, content: object): void;
+  hideCard(nodeId: string): void;
+  hideAllCards(): void;
+  
+  // 连接线与拓扑线
+  addConnection(fromId: string, toId: string, opts?: object): void;
+  removeConnection(fromId: string, toId: string): void;
+  removeAllConnections(): void;
+  addTopoLine(nodeIds: string[], opts?: object): string;
+  removeTopoLine(lineId: string): void;
+  removeAllTopoLines(): void;
+  
+  // 事件系统
+  on(event: string, handler: Function): void;
+  off(event: string, handler?: Function): void;
+  
+  // 导出
+  exportPng(filename?: string): Promise<void>;
+  toDataURL(opts?: object): Promise<string>;
+  getGraphData(): object;
+  
+  // 底层访问
+  getGraphInstance(): any;
+  getModel(): any;
+  getLayoutData(): any;
+  getNodeByIdMap(): Map<string, any>;
+  
+  // 数据刷新
+  update(graph: any, model: any, layout: any, nodeByIdMap: Map<string, any>): void;
+  
+  // 销毁
+  destroy(): void;
+}
+
+// 工具函数
+export function parseTopo(raw: object): any;
+export function computeOrthogonalLayout(model: any, options?: object): any;
+export function assertOrthogonal(model: any, edgeCP: Map<string, number[][]>): string[];
+export function buildGraphData(model: any, layout: any): any;
+export function edgeStyle(datum: any): any;
+export function calculateTopDistances(edges: any[], nodes: any[], edgeCP: Map<string, number[][]>, fishboneRibs: Set<string>, topN?: number): any[];
+export function getSymbolSpec(cat: string): { w: number, h: number };
+
+// 常量
+export const SYMBOL_SPEC: Record<string, { w: number, h: number }>;
+export const FONT: string;
+export const VERSION: string;
+export const DESCRIPTION: string;