irr-gh 0.1.0

package/dist/types/components/IrrigationGraph.vue.d.ts

@@ -0,0 +1,25 @@
+import type { Component } from 'vue';
+
+interface IrrigationGraphProps {
+  data?: any;
+  config?: any;
+  readonly?: boolean;
+  showToolbar?: boolean;
+  toolbarConfig?: any;
+}
+
+interface IrrigationGraphEmits {
+  (event: 'nodeClick', params: any): void;
+  (event: 'nodeDblclick', params: any): void;
+  (event: 'nodeContextmenu', params: any): void;
+  (event: 'edgeClick', params: any): void;
+  (event: 'edgeDblclick', params: any): void;
+  (event: 'edgeContextmenu', params: any): void;
+  (event: 'canvasClick', params: any): void;
+  (event: 'graphReady', graph: any): void;
+  (event: 'dataChange', data: any): void;
+}
+
+declare const IrrigationGraph: Component<IrrigationGraphProps>;
+
+export default IrrigationGraph;

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

@@ -0,0 +1,95 @@
+// 核心模块类型定义
+
+// 图管理器类型
+export interface IrrigationGraphManager {
+  render(container: HTMLElement, data: any): void;
+  updateData(data: any): void;
+  destroy(): void;
+  on(event: string, callback: Function): void;
+  off(event: string, callback: Function): void;
+  emit(event: string, params?: any): void;
+}
+
+export function createGraphManager(options?: any): IrrigationGraphManager;
+
+// 数据转换器类型
+export interface TransformConfig {
+  spacing?: Partial<LayoutSpacing>;
+  autoGenerateAuxiliary?: boolean;
+  autoGenerateEdges?: boolean;
+  startPosition?: { x: number; y: number };
+}
+
+export interface LayoutSpacing {
+  horizontal: number;
+  vertical: number;
+  branchOffset: number;
+}
+
+export interface DataTransformer {
+  transform(data: any): any;
+  setSpacing(spacing: Partial<LayoutSpacing>): void;
+  getConfig(): TransformConfig;
+}
+
+export function createTransformer(config?: TransformConfig): DataTransformer;
+export function transformData(data: any, config?: TransformConfig): any;
+
+// 节点和边样式类型
+export interface NodeStyleConfig {
+  fill?: string;
+  stroke?: string;
+  lineWidth?: number;
+  radius?: number;
+  width?: number;
+  height?: number;
+  size?: number | [number, number];
+}
+
+export interface EdgeStyleConfig {
+  stroke?: string;
+  lineWidth?: number;
+  lineDash?: number[];
+  endArrow?: boolean;
+  router?: {
+    type: string;
+    offset: number;
+  };
+}
+
+// 工具函数类型
+export function serializeGraphData(data: any): string;
+export function deserializeGraphData(json: string): any;
+export function downloadJSON(data: any, filename: string): void;
+export function readJSONFile(file: File): Promise<any>;
+export function copyToClipboard(text: string): Promise<void>;
+export function generateId(prefix?: string): string;
+export function deepClone<T>(obj: T): T;
+export function debounce<T extends (...args: any[]) => any>(func: T, wait: number): T;
+export function throttle<T extends (...args: any[]) => any>(func: T, wait: number): T;
+export function distance(p1: { x: number; y: number }, p2: { x: number; y: number }): number;
+export function pointToSegmentDistance(
+  point: { x: number; y: number },
+  segStart: { x: number; y: number },
+  segEnd: { x: number; y: number }
+): number;
+export function validateGraphData(data: any): boolean;
+
+// 布局工具函数类型
+export type AlignType = 'horizontal' | 'vertical';
+export type DistributeType = 'horizontal' | 'vertical';
+
+export function getNodePosition(node: any): { x: number; y: number };
+export function setNodePosition(node: any, x: number, y: number): void;
+export function alignNodesHorizontally(nodes: any[], alignment: 'top' | 'middle' | 'bottom'): void;
+export function alignNodesVertically(nodes: any[], alignment: 'left' | 'center' | 'right'): void;
+export function distributeNodesHorizontally(nodes: any[], spacing: number): void;
+export function distributeNodesVertically(nodes: any[], spacing: number): void;
+export function moveNodes(nodes: any[], deltaX: number, deltaY: number): void;
+export function getNodesBoundingBox(nodes: any[]): { minX: number; minY: number; maxX: number; maxY: number };
+export function centerNodesToPosition(nodes: any[], centerX: number, centerY: number): void;
+export function getNodesByCanalId(nodes: any[], canalId: string): any[];
+export function getConnectedNodes(nodeId: string, edges: any[]): string[];
+export function autoAdjustSpacing(nodes: any[], edges: any[], initialSpacing?: { horizontal: number; vertical: number }): { horizontal: number; vertical: number };
+export function flipNodes(nodes: any[], direction: 'horizontal' | 'vertical', centerX?: number, centerY?: number): void;
+export function rotateNodes90(nodes: any[], centerX?: number, centerY?: number, clockwise?: boolean): void;

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

@@ -0,0 +1,19 @@
+// Hooks 类型定义
+
+export interface UseIrrigationGraphOptions {
+  containerId: string;
+  data?: any;
+  config?: any;
+}
+
+export interface UseIrrigationGraphReturn {
+  graph: any;
+  data: any;
+  loading: boolean;
+  error: Error | null;
+  updateData: (newData: any) => void;
+  refresh: () => void;
+  destroy: () => void;
+}
+
+export function useIrrigationGraph(options: UseIrrigationGraphOptions): UseIrrigationGraphReturn;

package/dist/types/index.d.ts

@@ -0,0 +1,19 @@
+import type { App, Plugin } from 'vue';
+import IrrigationGraph from './components/IrrigationGraph.vue';
+
+// 导出组件
+export { IrrigationGraph };
+
+// 导出类型
+export * from './types';
+
+// 导出核心模块
+export * from './core';
+
+// 导出 Hooks
+export * from './hooks';
+
+// 插件类型定义
+declare const IrrGh: Plugin;
+
+export default IrrGh;

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

@@ -0,0 +1,139 @@
+// 业务数据类型定义
+export interface BaseEntity {
+  id: string;
+  name: string;
+  type: string;
+  properties?: Record<string, unknown>;
+}
+
+export interface CanalEntity extends BaseEntity {
+  type: 'canal';
+  parentId?: string;
+  forkChainage?: number;
+  bankSide?: 'left' | 'right' | 'center';
+  startChainage?: number;
+  endChainage?: number;
+  level?: number;
+}
+
+export interface PointEntity extends BaseEntity {
+  canalId: string;
+  chainage: number;
+}
+
+export interface SluiceEntity extends PointEntity {
+  type: 'sluice';
+  sluiceType?: 'intake' | 'diversion' | 'control' | 'regulation';
+  designFlow?: number;
+  gateWidth?: number;
+  gateHeight?: number;
+}
+
+export interface PumpStationEntity extends PointEntity {
+  type: 'pumpStation';
+  capacity: number;
+  pumpType?: 'lift' | 'pressure' | 'mixed';
+  power?: number;
+}
+
+export interface ReservoirEntity extends PointEntity {
+  type: 'reservoir';
+  storageCapacity: number;
+  normalLevel?: number;
+  deadStorage?: number;
+}
+
+export interface DispatchUnitEntity extends PointEntity {
+  type: 'dispatchUnit';
+  unitType?: 'management' | 'control' | 'monitoring';
+  area?: number;
+}
+
+export interface DispatchNodeEntity extends PointEntity {
+  type: 'dispatchNode';
+  nodeType?: 'terminal' | 'relay' | 'gateway';
+}
+
+export interface AuxiliaryNodeEntity extends PointEntity {
+  type: 'auxiliary';
+  auxiliaryType: 'fork' | 'end' | 'junction';
+  branchCanalId?: string;
+  autoGenerated?: boolean;
+}
+
+export type PointEntityUnion =
+  | PumpStationEntity
+  | ReservoirEntity
+  | SluiceEntity
+  | DispatchUnitEntity
+  | DispatchNodeEntity
+  | AuxiliaryNodeEntity;
+
+export type IrrigationEntity = CanalEntity | PointEntityUnion;
+
+export interface IrrigationData {
+  canals: CanalEntity[];
+  points: PointEntityUnion[];
+  connections?: ConnectionData[];
+}
+
+export interface ConnectionData {
+  id: string;
+  sourceId: string;
+  targetId: string;
+  connectionType?: 'flow' | 'control' | 'supply';
+  properties?: Record<string, unknown>;
+}
+
+// 图形数据类型定义
+export interface IrrigationNodeData {
+  id: string;
+  data: { label: string };
+  entityType: string;
+  businessData: IrrigationEntity;
+  nodeShape?: string;
+  styleConfig?: Record<string, unknown>;
+  style?: Record<string, unknown>;
+}
+
+export interface IrrigationEdgeData {
+  id: string;
+  source: string;
+  target: string;
+  data: { label: string };
+  edgeShape?: string;
+  connectionType?: string;
+  styleConfig?: Record<string, unknown>;
+}
+
+export interface IrrigationComboData {
+  id: string;
+  data: { label: string };
+  comboShape?: string;
+  styleConfig?: Record<string, unknown>;
+}
+
+export interface IrrigationGraphData {
+  nodes: IrrigationNodeData[];
+  edges: IrrigationEdgeData[];
+  combos?: IrrigationComboData[];
+}
+
+// 布局配置
+export interface LayoutConfig {
+  type: 'force' | 'grid' | 'radial' | 'dagre' | 'custom';
+  options?: Record<string, unknown>;
+}
+
+// 交互事件类型
+export type InteractionEventType = 
+  | 'node:click'
+  | 'node:dblclick'
+  | 'node:contextmenu'
+  | 'edge:click'
+  | 'edge:dblclick'
+  | 'edge:contextmenu'
+  | 'combo:click'
+  | 'canvas:click'
+  | 'canvas:drag'
+  | 'canvas:zoom';

package/package.json

@@ -0,0 +1,67 @@
+{
+	"name": "irr-gh",
+	"version": "0.1.0",
+	"description": "灌溉系统概化图组件",
+	"type": "module",
+	"main": "./dist/irr-gh.umd.cjs",
+	"module": "./dist/irr-gh.js",
+	"types": "./dist/types/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/types/index.d.ts",
+			"import": "./dist/irr-gh.js",
+			"require": "./dist/irr-gh.umd.cjs"
+		},
+		"./style.css": "./dist/style.css"
+	},
+	"files": [
+		"dist"
+	],
+	"engines": {
+		"node": "^20.19.0 || >=22.12.0"
+	},
+	"scripts": {
+		"dev": "vite",
+		"build": "run-p type-check build-only",
+		"build:lib": "vue-tsc --declaration --emitDeclarationOnly --project tsconfig.types.json && vite build",
+		"preview": "vite preview",
+		"build-only": "vite build",
+		"type-check": "vue-tsc --build"
+	},
+	"peerDependencies": {
+		"vue": "^3.3.0"
+	},
+	"devDependencies": {
+		"@tsconfig/node24": "^24.0.3",
+		"@types/node": "^24.10.4",
+		"@vitejs/plugin-vue": "^6.0.3",
+		"@vue/tsconfig": "^0.8.1",
+		"npm-run-all2": "^8.0.4",
+		"typescript": "~5.9.3",
+		"vite": "^7.3.0",
+		"vite-plugin-vue-devtools": "^8.0.5",
+		"vue": "^3.5.26",
+		"vue-tsc": "^3.2.2"
+	},
+	"keywords": [
+		"vue",
+		"vue3",
+		"irrigation",
+		"graph",
+		"灌溉",
+		"概化图"
+	],
+	"author": "Your Name <your.email@example.com>",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/your-username/irr-gh.git"
+	},
+	"bugs": {
+		"url": "https://github.com/your-username/irr-gh/issues"
+	},
+	"homepage": "https://github.com/your-username/irr-gh#readme",
+	"dependencies": {
+		"@antv/g6": "^5.0.51"
+	}
+}