// 订阅 bpmn-js 'selection.changed',返回当前单选 element(多选/空选返 null)。 // 卸载时解绑;modeler 为 null 时不订阅、恒返 null。 import { useEffect, useState } from 'react'; /** bpmn-js businessObject 的最小契约(本侧板用到的读法)。 */ export interface BpmnBusinessObject { $type?: string; /** 未在 moddle 描述符中声明的长尾扩展属性(命名空间键→字符串值)。 */ $attrs?: Record; /** 读取声明属性(如 'activiti:candidateUsers'/'loopCharacteristics'/'extensionElements')。 */ get(name: string): unknown; } /** bpmn-js diagram element 的最小契约。 */ export interface BpmnElement { id: string; /** moddle 类型,如 'bpmn:UserTask'。 */ type: string; businessObject: BpmnBusinessObject; } /** 订阅所需的最小 modeler 契约(bpmn-js Modeler 天然满足)。 */ export interface SelectionModeler { on(event: string, cb: (e: unknown) => void): void; off?(event: string, cb: (e: unknown) => void): void; } interface SelectionChangedEvent { newSelection?: unknown[]; } /** * 返回当前单选的 bpmn element;多选或空选返 null。modeler 变更/卸载自动重订阅、解绑。 */ export function useSelectedElement( modeler: SelectionModeler | null | undefined, ): BpmnElement | null { const [element, setElement] = useState(null); useEffect(() => { if (!modeler) { setElement(null); return; } const handler = (e: unknown) => { const sel = ((e as SelectionChangedEvent | undefined)?.newSelection ?? []) as BpmnElement[]; setElement(sel.length === 1 ? sel[0] : null); }; modeler.on('selection.changed', handler); return () => { modeler.off?.('selection.changed', handler); }; }, [modeler]); return element; }