@basic-genomics/hivtrace-viz 1.1.3 → 1.1.5

package/dist/react/HivtraceViz.d.ts

@@ -3,6 +3,6 @@
  * 封装 iframe 和 postMessage 通信，提供简洁的 React 接口
  */
 import type { HivtraceVizProps } from './types';
-export declare function HivtraceViz({ data, options, isDataFetched, showLoadingOnUpdate, onTrackCluster, onFullscreenChange, onReady, onError, error, className, style, emptyState, loadingState, }: HivtraceVizProps): import("react/jsx-runtime").JSX.Element;
+export declare function HivtraceViz({ data, options, isDataFetched, showLoadingOnUpdate, onFullscreenChange, onReady, onError, onRetry, error, className, style, emptyState, loadingState, customContextMenuItems, onCustomMenuItemClick, }: HivtraceVizProps): import("react/jsx-runtime").JSX.Element;
 export default HivtraceViz;
 //# sourceMappingURL=HivtraceViz.d.ts.map

package/dist/react/HivtraceViz.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HivtraceViz.d.ts","sourceRoot":"","sources":["../../src/react/HivtraceViz.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAA6C,MAAM,SAAS,CAAC;AA2F3F,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,OAAO,EACP,aAAa,EACb,mBAA0B,EAC1B,cAAc,EACd,kBAAkB,EAClB,OAAO,EACP,OAAO,EACP,KAAK,EACL,SAAS,EACT,KAAK,EACL,UAAU,EACV,YAAY,GACb,EAAE,gBAAgB,2CAiKlB;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"HivtraceViz.d.ts","sourceRoot":"","sources":["../../src/react/HivtraceViz.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAA6C,MAAM,SAAS,CAAC;AA6F3F,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,OAAO,EACP,aAAa,EACb,mBAA0B,EAC1B,kBAAkB,EAClB,OAAO,EACP,OAAO,EACP,OAAO,EACP,KAAK,EACL,SAAS,EACT,KAAK,EACL,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,GACtB,EAAE,gBAAgB,2CA0KlB;AAED,eAAe,WAAW,CAAC"}

package/dist/react/HivtraceViz.js

@@ -44,7 +44,7 @@ function DefaultLoadingState({ message }) {
                         animation: 'pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite',
                     } }), _jsx("p", { style: { color: '#6b7280' }, children: message })] }) }));
 }
-export function HivtraceViz({ data, options, isDataFetched, showLoadingOnUpdate = true, onTrackCluster, onFullscreenChange, onReady, onError, error, className, style, emptyState, loadingState, }) {
+export function HivtraceViz({ data, options, isDataFetched, showLoadingOnUpdate = true, onFullscreenChange, onReady, onError, onRetry, error, className, style, emptyState, loadingState, customContextMenuItems, onCustomMenuItemClick, }) {
     const iframeRef = useRef(null);
     const [internalLoadingState, setInternalLoadingState] = useState('initial');
     const [isIframeReady, setIsIframeReady] = useState(false);
@@ -61,9 +61,13 @@ export function HivtraceViz({ data, options, isDataFetched, showLoadingOnUpdate
         iframe.contentWindow.postMessage({
             type,
             graphData: data,
-            options,
+            options: {
+                ...options,
+                // 传递自定义菜单项配置到 iframe
+                customContextMenuItems,
+            },
         }, '*');
-    }, [data, options]);
+    }, [data, options, customContextMenuItems]);
     // 发送错误到 iframe
     const sendError = useCallback((message) => {
         const iframe = iframeRef.current;
@@ -92,11 +96,6 @@ export function HivtraceViz({ data, options, isDataFetched, showLoadingOnUpdate
                     setInternalLoadingState('rendered');
                     onReady?.();
                     break;
-                case 'TRACK_CLUSTER':
-                    if (msg.clusterInfo && msg.allData) {
-                        onTrackCluster?.(msg.clusterInfo, msg.allData);
-                    }
-                    break;
                 case 'FULLSCREEN_CHANGE':
                     if (typeof msg.isFullscreen === 'boolean') {
                         onFullscreenChange?.(msg.isFullscreen);
@@ -105,11 +104,19 @@ export function HivtraceViz({ data, options, isDataFetched, showLoadingOnUpdate
                 case 'ERROR':
                     onError?.(msg.message || 'Unknown error');
                     break;
+                case 'HIVTRACE_RETRY':
+                    onRetry?.();
+                    break;
+                case 'CUSTOM_MENU_CLICK':
+                    if (msg.itemId && msg.clusterInfo) {
+                        onCustomMenuItemClick?.(msg.itemId, msg.clusterInfo);
+                    }
+                    break;
             }
         };
         window.addEventListener('message', handleMessage);
         return () => window.removeEventListener('message', handleMessage);
-    }, [onTrackCluster, onFullscreenChange, onReady, onError]);
+    }, [onFullscreenChange, onReady, onError, onRetry, onCustomMenuItemClick]);
     // iframe 加载完成时发送初始数据或错误
     useEffect(() => {
         if (isIframeReady && internalLoadingState === 'frameReady') {

package/dist/react/index.d.ts

@@ -1,3 +1,3 @@
 export { HivtraceViz, default } from './HivtraceViz';
-export type { HivtraceVizProps, HivtraceVizData, HivtraceVizOptions, ClusterInfo, NetworkInfo, } from './types';
+export type { HivtraceVizProps, HivtraceVizData, HivtraceVizOptions, ClusterInfo, ClusterNodeInfo, NetworkInfo, CustomContextMenuItem, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,WAAW,GACZ,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,WAAW,EACX,qBAAqB,GACtB,MAAM,SAAS,CAAC"}

package/dist/react/types.d.ts

@@ -18,6 +18,29 @@ export interface HivtraceVizOptions {
     /** 基因距离阈值（如 0.015 表示 1.5%） */
     threshold?: number;
 }
+/**
+ * 簇内节点的详细信息
+ */
+export interface ClusterNodeInfo {
+    /** 节点 ID */
+    id: string;
+    /** 节点度数 */
+    degree?: number;
+    /** 节点属性（如患者属性等） */
+    attributes?: Record<string, unknown>;
+    /** 节点 X 坐标 */
+    x?: number;
+    /** 节点 Y 坐标 */
+    y?: number;
+    /** 是否隐藏 */
+    is_hidden?: boolean;
+    /** 是否匹配当前筛选条件 */
+    match_filter?: boolean;
+    /** 子簇 ID */
+    subcluster_id?: string;
+    /** 子簇标签 */
+    subcluster_label?: string;
+}
 export interface ClusterInfo {
     cluster_id: string | number;
     node_count: number;
@@ -30,7 +53,10 @@ export interface ClusterInfo {
         expanded: boolean;
         fixed: boolean;
     };
+    /** 节点 ID 列表（向后兼容） */
     node_ids: string[];
+    /** 完整节点信息列表 */
+    nodes?: ClusterNodeInfo[];
 }
 export interface NetworkInfo {
     network_info: {
@@ -39,6 +65,19 @@ export interface NetworkInfo {
         total_clusters: number;
     };
 }
+/**
+ * 自定义上下文菜单项接口
+ */
+export interface CustomContextMenuItem {
+    /** 菜单项唯一标识符 */
+    id: string;
+    /** 显示的标签文本 */
+    label: string;
+    /** 可选的 FontAwesome 图标类名（如 'fa-star'） */
+    icon?: string;
+    /** 是否禁用该菜单项 */
+    disabled?: boolean;
+}
 export interface HivtraceVizProps {
     /** 分析数据 */
     data?: HivtraceVizData;
@@ -56,14 +95,14 @@ export interface HivtraceVizProps {
      * - false: 静默更新，不显示 loading
      */
     showLoadingOnUpdate?: boolean;
-    /** 簇追踪回调 */
-    onTrackCluster?: (clusterInfo: ClusterInfo, networkInfo: NetworkInfo) => void;
     /** 全屏状态变化回调 */
     onFullscreenChange?: (isFullscreen: boolean) => void;
     /** 可视化渲染完成回调 */
     onReady?: () => void;
     /** 错误回调 */
     onError?: (message: string) => void;
+    /** 重试回调（用户点击错误状态下的重试按钮时触发） */
+    onRetry?: () => void;
     /**
      * 错误信息
      * - 传入错误消息时，组件会显示错误状态而不是加载态
@@ -78,5 +117,16 @@ export interface HivtraceVizProps {
     emptyState?: React.ReactNode;
     /** 自定义加载状态渲染 */
     loadingState?: React.ReactNode;
+    /**
+     * 自定义上下文菜单项
+     * 会在簇节点点击菜单的默认项之后显示
+     */
+    customContextMenuItems?: CustomContextMenuItem[];
+    /**
+     * 自定义菜单项点击回调
+     * @param itemId - 被点击菜单项的 id
+     * @param clusterInfo - 当前簇的信息
+     */
+    onCustomMenuItemClick?: (itemId: string, clusterInfo: ClusterInfo) => void;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/react/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/react/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE;QACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,gBAAgB;IAChB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,KAAK,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,IAAI,CAAC,EAAE,eAAe,CAAC;IAEvB,WAAW;IACX,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAE7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,YAAY;IACZ,cAAc,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC;IAE9E,eAAe;IACf,kBAAkB,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,KAAK,IAAI,CAAC;IAErD,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB,WAAW;IACX,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,YAAY;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,YAAY;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAE5B,eAAe;IACf,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE7B,gBAAgB;IAChB,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAChC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/react/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basic-genomics/hivtrace-viz",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "HIV-TRACE molecular transmission network visualization with React integration",
   "engines": {
     "node": ">=18"
@@ -103,4 +103,4 @@
     "vite"
   ],
   "packageManager": "yarn@1.22.19+sha1.4ba7fc5c6e704fce2066ecbfb0b0d8976fe62447"
-}
+}