rowvia 0.2.3 → 0.3.0

package/dist/types/gantt/component.d.ts

@@ -1,8 +1,9 @@
+import { type InteractionOptions, type InteractionSource } from '../shared/interaction';
 import type { GridApi } from '../types';
-import { GanttChart } from './ganttChart';
-import type { GanttUnit } from './ganttChart';
 import type { GanttTask, TeamMember } from './data';
-export interface GanttOptions {
+import type { GanttUnit } from './ganttChart';
+import { GanttChart } from './ganttChart';
+export interface GanttOptions extends InteractionOptions {
     tasks: GanttTask[];
     members?: TeamMember[];
     title?: string;
@@ -12,7 +13,7 @@ export interface GanttOptions {
     /** Overrides the built-in text detail dialog when provided. */
     onTaskOpen?: (task: GanttTask) => void;
 }
-export interface GanttApi {
+export interface GanttApi extends InteractionSource {
     grid: GridApi;
     chart: GanttChart;
     setTasks(tasks: GanttTask[]): void;

package/dist/types/gantt/ganttChart.d.ts

@@ -1,14 +1,14 @@
+import { observeInteractions, type InteractionOptions } from '../shared/interaction';
 import type { GanttTask, TeamMember } from './data';
-export type GanttUnit = 'day' | 'week' | 'biweek' | 'month' | 'bimonth' | 'quarter' | 'halfyear' | 'year';
-export type GanttTheme = 'content' | 'color';
-export declare const GANTT_UNITS: GanttUnit[];
-export declare const UNIT_LABEL: Record<GanttUnit, string>;
+import { type GanttTheme, type GanttUnit } from './scale';
+export { GANTT_UNITS, UNIT_LABEL } from './scale';
+export type { GanttTheme, GanttUnit } from './scale';
 export interface ChartRow {
     id: string;
     group: boolean;
     expanded: boolean;
 }
-export interface GanttChartOptions {
+export interface GanttChartOptions extends InteractionOptions {
     members: TeamMember[];
     rowHeight: number;
     onSelect: (id: string | null) => void;
@@ -17,6 +17,8 @@ export interface GanttChartOptions {
     onAssign: (id: string, memberId: string | null) => void;
 }
 export declare class GanttChart {
+    private interactions;
+    onInteraction: ReturnType<typeof observeInteractions>['onInteraction'];
     private options;
     private eRoot;
     private eHeader;
@@ -79,7 +81,6 @@ export declare class GanttChart {
     scrollToToday(fraction?: number): void;
     private computeDomain;
     private dateX;
-    private xToDate;
     private resizeCanvases;
     private tick;
     private onScroll;
@@ -96,7 +97,6 @@ export declare class GanttChart {
     private drawBars;
     private drawTaskBar;
     private drawSummaryBar;
-    private firstVisibleChildIndex;
     private drawMilestone;
     private pushHit;
     private drawLocateButtons;

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

@@ -1,5 +1,5 @@
 export { createGantt } from './component';
 export type { GanttApi, GanttOptions } from './component';
-export type { GanttTask, TeamMember, TaskKind, TaskStatus } from './data';
-export { GanttChart, GANTT_UNITS, UNIT_LABEL } from './ganttChart';
-export type { GanttUnit, GanttTheme } from './ganttChart';
+export type { GanttTask, TaskKind, TaskStatus, TeamMember } from './data';
+export { GANTT_UNITS, GanttChart, UNIT_LABEL } from './ganttChart';
+export type { GanttTheme, GanttUnit } from './ganttChart';

package/dist/types/gantt/scale.d.ts

@@ -0,0 +1,18 @@
+export type GanttUnit = 'day' | 'week' | 'biweek' | 'month' | 'bimonth' | 'quarter' | 'halfyear' | 'year';
+export type GanttTheme = 'content' | 'color';
+export declare const GANTT_UNITS: GanttUnit[];
+export declare const UNIT_LABEL: Record<GanttUnit, string>;
+/** px per day at zoom 1 — smaller units need a denser canvas */
+export declare const UNIT_BASE: Record<GanttUnit, number>;
+/** Monday-based index of the week containing date */
+export declare function weekStart(date: Date): Date;
+/** business days between two dates, inclusive of the start day */
+export declare function workDaysBetween(from: Date, to: Date): number;
+export interface RulerCell {
+    start: Date;
+    end: Date;
+    primary: string;
+    secondary: string;
+}
+/** cells of the given unit covering [from, to) */
+export declare function rulerCells(unit: GanttUnit, from: Date, to: Date): RulerCell[];

package/dist/types/grid.d.ts

@@ -1,29 +1,33 @@
-import type { Column, ColumnApi, GridApi, GridOptions, RowDataTransaction, RowNode, RowNodeTransactionResult } from './types';
-import { EventService } from './core/eventService';
-import { ColumnModel } from './core/columnModel';
 import { RowModel } from './core/clientSideRowModel';
+import { ColumnModel } from './core/columnModel';
+import { EventService } from './core/eventService';
+import type { GridHost } from './core/gridHost';
 import { InfiniteRowModel, ServerSideRowModel, ViewportRowModel } from './core/remoteRowModels';
-import { RowRenderer } from './render/rowRenderer';
-import { HeaderView } from './render/headerView';
-import { SelectionService } from './features/selectionService';
+import { ChartService } from './features/chartService';
 import { EditService } from './features/editService';
+import { ExportService } from './features/exportService';
+import { FilterGui } from './features/filterGui';
 import { FilterService } from './features/filterService';
-import { SortService } from './features/sortService';
+import { FindService } from './features/findService';
+import { FormulaEditorService } from './features/formulaEditor';
+import { NotesService } from './features/notesService';
+import { OverlayService } from './features/overlays';
 import { PaginationService } from './features/paginationService';
 import { PopupService } from './features/popupService';
-import { FilterGui } from './features/filterGui';
-import { SideBarService } from './features/sideBar';
-import { FindService } from './features/findService';
 import { RangeSelectionService } from './features/rangeSelection';
-import { ChartService } from './features/chartService';
-import { OverlayService } from './features/overlays';
-import { ExportService } from './features/exportService';
+import { RowDragService } from './features/rowDragService';
 import { RowGroupPanel } from './features/rowGroupPanel';
+import { SelectionService } from './features/selectionService';
+import { SideBarService } from './features/sideBar';
+import { SortService } from './features/sortService';
 import { UndoRedoService } from './features/undoRedoService';
-import { FormulaEditorService } from './features/formulaEditor';
-import { NotesService } from './features/notesService';
-import { RowDragService } from './features/rowDragService';
-export declare class Grid {
+import { HeaderView } from './render/headerView';
+import { RowRenderer } from './render/rowRenderer';
+import { observeInteractions } from './shared/interaction';
+import type { Column, ColumnApi, GridApi, GridOptions, RowDataTransaction, RowNode, RowNodeTransactionResult } from './types';
+export declare class Grid implements GridHost {
+    private interactions;
+    onInteraction: ReturnType<typeof observeInteractions>['onInteraction'];
     private options;
     private eventService;
     private columnModel;

package/dist/types/index.d.ts

@@ -1,29 +1,28 @@
-import { Grid } from './grid';
-import type { GridOptions, GridApi, ColumnApi } from './types';
-import { CELL_RENDERERS, CELL_EDITORS } from './render/cellRenderers';
-import { createSparklineSvg } from './render/cellRenderers';
 import { formatNumberCommas } from './core/utils';
+import { Grid } from './grid';
+import { CELL_EDITORS, CELL_RENDERERS, createSparklineSvg } from './render/cellRenderers';
+export type { AggFunc, CellClassParams, CellRange, CellRendererParams, ColDef, Column, ColumnApi, ColumnState, ExportParams, FilterModelItem, GridApi, GridOptions, ICellEditor, ICellRenderer, RowDataTransaction, RowNode, SideBarDef, SortModelItem, StatusPanelDef, ValueFormatterParams, ValueGetterParams } from './types';
 export { Grid };
-export type { GridOptions, ColDef, GridApi, ColumnApi, RowNode, Column, ColumnState, SortModelItem, FilterModelItem, CellRange, CellRendererParams, ValueFormatterParams, ValueGetterParams, CellClassParams, ICellRenderer, ICellEditor, AggFunc, ExportParams, RowDataTransaction, SideBarDef, StatusPanelDef, } from './types';
-/**
- * Create a grid inside the given element. Mirrors ag-grid's createGrid().
- */
-export declare function createGrid(eGridDiv: HTMLElement, gridOptions: GridOptions): {
-    api: GridApi;
-    columnApi: ColumnApi;
-    grid: Grid;
-};
+export { createGrid } from './createGrid';
 /** Register custom cell renderers / editors (ag-grid module-style registry). */
 export declare function registerRenderer(name: string, factory: (params: any) => any): void;
 export declare function registerEditor(name: string, factory: (params: any) => any): void;
-export { CELL_RENDERERS, CELL_EDITORS, createSparklineSvg, formatNumberCommas };
-export { computeStickyGroupRows } from './render/stickyGroupRows';
-export { DEFAULT_LOCALE_TEXT } from './core/localeText';
-export { evaluateFormula, isFormula, tokenize, parse, FORMULA_FUNCTIONS, registerFormulaFunction } from './core/formulaEngine';
+export { evaluateFormula, FORMULA_FUNCTIONS, isFormula, parse, registerFormulaFunction, tokenize } from './core/formulaEngine';
 export type { FormulaContext, FormulaValue } from './core/formulaEngine';
+export { DEFAULT_LOCALE_TEXT } from './core/localeText';
+export { computeStickyGroupRows } from './render/stickyGroupRows';
+export { CELL_EDITORS, CELL_RENDERERS, createSparklineSvg, formatNumberCommas };
 export default Grid;
+export { createDetailDialog } from './components/detailDialog';
+export type { DetailDialogContent, DetailDialogOptions } from './components/detailDialog';
 export * from './gantt';
+export * from './node-flow';
 export * from './personnel';
-export { createDetailDialog } from './components/detailDialog';
-export type { DetailDialogContent } from './components/detailDialog';
-export * from './pages';
+export * from './work-items';
+export { createControlRegistry, BaseFieldControl, sanitizeRichText } from './work-items/fields/registry';
+export { createWorkItemFormSurface, evalFormCondition, evalFormScope } from './forms/form-surface';
+export type { ComponentInteraction, InteractionOptions, InteractionSource } from './shared/interaction';
+export { createTagCell, createMediaCell } from './components/cells';
+export type { TagCellOptions, MediaCellOptions } from './components/cells';
+export { BaseField, renderContent, createFieldRegistry, CustomField, TextField, NumberField, RichTextField, TextareaField, ChoiceField, MultiChoiceField, PersonField, MultiPersonField, RelationField, MultiRelationField, RadioField, CascadeField, MultiCascadeField, DateTimeField, DateField, DateRangeField, SwitchField, AttachmentField, LocationField, VoteField, SingleVoteField, MultiVoteField, ComputedField, SignalField, CompositeField, LinkField, EmailField, PhoneField, ActionField } from './fields/index';
+export type { FieldDefinition, FieldOptions, FieldState, FieldContent, FieldView, FieldSnapshot, FieldEvent, FieldListener, FieldRenderContext, FieldRenderer } from './fields/index';

package/dist/types/node-flow/canvas.d.ts

@@ -0,0 +1,26 @@
+import { type InteractionOptions, type InteractionSource } from '../shared/interaction';
+import type { FlowDefinition } from './types';
+export interface FlowCanvasOptions extends InteractionOptions {
+    flow: FlowDefinition;
+    selectedNodeId?: string;
+    query?: string;
+    onSelectNode?: (nodeId: string) => void;
+    onZoomChange?: (zoom: number) => void;
+    /** 未命中「节点显示条件」的节点占位说明 */
+    hiddenHints?: {
+        name: string;
+        reason: string;
+    }[];
+}
+export interface FlowCanvasApi extends InteractionSource {
+    update(options: Partial<FlowCanvasOptions>): void;
+    focusNode(nodeId: string): void;
+    fit(): void;
+    getZoom(): number;
+    destroy(): void;
+}
+/**
+ * ② 流程画布：分组（含并行段）、节点信息展示、缩放与定位。
+ * 对应配置：节点流水线设计（分组）、流程图信息显示、节点显示条件、里程碑。
+ */
+export declare function createFlowCanvas(container: HTMLElement, options: FlowCanvasOptions): FlowCanvasApi;

package/dist/types/node-flow/card.d.ts

@@ -0,0 +1,23 @@
+import { type InteractionOptions, type InteractionSource } from '../shared/interaction';
+import type { FlowNode, GateCondition } from './types';
+export interface NodeCardOptions extends InteractionOptions {
+    node?: FlowNode | null;
+    readonly?: boolean;
+    /** 返回 false 阻止默认完成行为 */
+    onComplete?: (nodeId: string, gates: GateCondition[]) => boolean | void;
+    onAction?: (action: string, nodeId: string) => void;
+    onFieldChange?: (nodeId: string, fieldId: string, value: string) => void;
+    onFormChange?: (nodeId: string, formId: string, value: string) => void;
+    onTaskToggle?: (nodeId: string, taskId: string, done: boolean) => void;
+}
+export interface NodeCardApi extends InteractionSource {
+    update(node: FlowNode | null, options?: Partial<NodeCardOptions>): void;
+    destroy(): void;
+}
+/**
+ * ③ 节点操作卡：身份与操作、通行条件、字段、表单、子任务、事件。
+ * 对应配置：节点核心规则、节点流转规则、节点子项管理、节点事件触发。
+ */
+export declare function createNodeCard(container: HTMLElement, options: NodeCardOptions): NodeCardApi;
+/** 字段来源提示，跟随元素定位，2.6s 后自动消失 */
+export declare function showTip(anchor: HTMLElement, text: string): () => void;

package/dist/types/node-flow/cardSections.d.ts

@@ -0,0 +1,14 @@
+import type { FlowNode, GateCondition, NodeField } from './types';
+interface FieldSection {
+    key: string;
+    title: string;
+    fields: NodeField[];
+}
+/** 把节点上的系统字段与自定义字段整理成四个分组 */
+export declare function collectSections(node: FlowNode): FieldSection[];
+export declare function fieldRow(node: FlowNode, field: NodeField, readonly: boolean): string;
+export declare function gateList(gates: GateCondition[]): string;
+export declare function taskTable(node: FlowNode, readonly: boolean): string;
+export declare function formSection(node: FlowNode, readonly: boolean): string;
+export declare function eventSection(node: FlowNode): string;
+export {};

package/dist/types/node-flow/component.d.ts

@@ -0,0 +1,9 @@
+import type { NodeFlowApi, NodeFlowOptions } from './types';
+/**
+ * 节点流程管理面板：上下文条 + 流程画布 + 节点操作卡 + 节点时间线。
+ *
+ * 对应飞书项目「节点流程配置」的使用端表现。四个区块可以分别独立挂载
+ * （createFlowContextBar / createFlowCanvas / createNodeCard / createNodeTimeline），
+ * 也可以用本函数整体接入；卸载时调用返回对象的 destroy()。
+ */
+export declare function createNodeFlow(container: HTMLElement, options: NodeFlowOptions): NodeFlowApi;

package/dist/types/node-flow/contextBar.d.ts

@@ -0,0 +1,20 @@
+import { type InteractionOptions, type InteractionSource } from '../shared/interaction';
+import type { FlowDefinition } from './types';
+export interface FlowContextBarOptions extends InteractionOptions {
+    flow: FlowDefinition;
+    query?: string;
+    onQuery?: (query: string) => void;
+    onFocusNode?: (nodeId: string) => void;
+    onOpenRules?: () => void;
+    onOpenDiff?: () => void;
+}
+export interface FlowContextBarApi extends InteractionSource {
+    update(flow: FlowDefinition, query?: string): void;
+    getQuery(): string;
+    destroy(): void;
+}
+/**
+ * ① 流程上下文条：流程类型、进度摘要、节点查找、只读规则与模板版本。
+ * 对应配置：流程类型管理、查找节点、状态计算规则、预览与保存。
+ */
+export declare function createFlowContextBar(container: HTMLElement, options: FlowContextBarOptions): FlowContextBarApi;

package/dist/types/node-flow/demo.d.ts

@@ -0,0 +1,6 @@
+import type { FlowDefinition } from './types';
+/**
+ * 演示流程：内容制作全流程（视频流程），22 个节点、6 个分组、1 段 9 路并行。
+ * 数据结构与飞书项目「节点流程配置」的配置项一一对应，业务项目可参照构造自己的流程。
+ */
+export declare function videoFlow(): FlowDefinition;

package/dist/types/node-flow/index.d.ts

@@ -0,0 +1,13 @@
+export { createFlowCanvas } from './canvas';
+export { createNodeCard, showTip } from './card';
+export { createNodeFlow } from './component';
+export { createFlowContextBar } from './contextBar';
+export { videoFlow } from './demo';
+export { COMPLETION_LABEL, STATUS_META, allGatesMet, escapeHtml, evaluateGates, groupNodes, matchNodes, summarize } from './model';
+export type { FlowSummary, StatusMeta } from './model';
+export { createNodeTimeline } from './timeline';
+export type { FlowCanvasApi, FlowCanvasOptions } from './canvas';
+export type { NodeCardApi, NodeCardOptions } from './card';
+export type { FlowContextBarApi, FlowContextBarOptions } from './contextBar';
+export type { NodeTimelineApi, NodeTimelineOptions } from './timeline';
+export type { ButtonPlacement, ButtonVariant, CompletionMode, CustomButton, FlowDefinition, FlowGroup, FlowNode, FormItem, GateCondition, NodeEvent, NodeEventTrigger, NodeField, NodeFieldType, NodeFlowApi, NodeFlowOptions, NodeStatus, SubTask } from './types';

package/dist/types/node-flow/model.d.ts

@@ -0,0 +1,48 @@
+import type { CompletionMode, FlowDefinition, FlowGroup, GateCondition, NodeStatus, SubTask } from './types';
+export { escapeHtml } from '../core/utils';
+export interface StatusMeta {
+    key: NodeStatus;
+    label: string;
+    className: string;
+}
+export declare const STATUS_META: Record<NodeStatus, StatusMeta>;
+export declare const COMPLETION_LABEL: Record<CompletionMode, string>;
+/** 通行条件清单：系统必填项 + 业务自定义完成流转条件 */
+export declare function evaluateGates(node: {
+    owner?: string;
+    schedule?: string;
+    estimate?: string;
+    milestone?: boolean;
+    form?: {
+        id: string;
+        label: string;
+        required?: boolean;
+        value?: string;
+    }[];
+    gates?: GateCondition[];
+}): GateCondition[];
+export declare const allGatesMet: (gates: GateCondition[]) => boolean;
+export interface FlowSummary {
+    total: number;
+    done: number;
+    current: number;
+    failed: number;
+    index: number;
+}
+export declare function summarize(flow: FlowDefinition): FlowSummary;
+/** 组内任务完成度，用于分组标题 x/y */
+export declare function groupProgress(nodes: {
+    groupId?: string;
+    status: NodeStatus;
+    tasks?: SubTask[];
+}[], group: FlowGroup): {
+    done: number;
+    total: number;
+};
+/** 按 flow.groups 归组，未知分组的节点落入首组，保证流程完整 */
+export declare function groupNodes(flow: FlowDefinition): {
+    group: FlowGroup;
+    nodes: FlowDefinition['nodes'];
+}[];
+/** 模糊匹配节点名，返回命中的节点 id */
+export declare function matchNodes(flow: FlowDefinition, query: string): Set<string>;

package/dist/types/node-flow/timeline.d.ts

@@ -0,0 +1,16 @@
+import { type InteractionOptions, type InteractionSource } from '../shared/interaction';
+import type { FlowDefinition } from './types';
+export interface NodeTimelineOptions extends InteractionOptions {
+    flow: FlowDefinition;
+    selectedNodeId?: string;
+    onSelectNode?: (nodeId: string) => void;
+}
+export interface NodeTimelineApi extends InteractionSource {
+    update(options: Partial<NodeTimelineOptions>): void;
+    destroy(): void;
+}
+/**
+ * ④ 节点时间线：全部节点的只读总览，替代「卡片的列表化副本」。
+ * 对应配置：节点进度、排期估分、节点状态与状态计算规则。
+ */
+export declare function createNodeTimeline(container: HTMLElement, options: NodeTimelineOptions): NodeTimelineApi;

package/dist/types/node-flow/types.d.ts

@@ -0,0 +1,220 @@
+import type { InteractionOptions, InteractionSource } from '../shared/interaction';
+/**
+ * 节点流程管理（Node Flow）数据模型。
+ *
+ * 字段命名对齐飞书项目「节点流程配置」帮助文档：
+ * 节点核心规则（展示什么）、节点流转规则（如何完成）、节点子项、节点事件。
+ * 业务项目只需构造这份纯数据结构，无需关心渲染细节。
+ */
+/** 节点状态，对应文档「节点流转状态」：未开始 / 进行中 / 已完成 / 未通过 */
+export type NodeStatus = 'pending' | 'inProgress' | 'done' | 'failed';
+/** 完成方式，对应文档「完成方式」：自动完成 / 单人确认（并签） / 多人确认（会签） */
+export type CompletionMode = 'auto' | 'and' | 'or';
+/** 自定义按钮样式，对应文档「按钮样式」：主操作 / 普通操作 / 警告操作 */
+export type ButtonVariant = 'primary' | 'normal' | 'warning';
+/** 按钮展示位置，对应文档「展示位置」：默认展示 / 收起到更多 */
+export type ButtonPlacement = 'inline' | 'more';
+/** 节点事件触发时机，对应文档「节点流转事件」 */
+export type NodeEventTrigger = 'arrive' | 'complete';
+/** 节点字段类型，对应文档「节点字段」 */
+export type NodeFieldType = 'text' | 'number' | 'date' | 'select' | 'radio' | 'progress';
+export interface FlowGroup {
+    id: string;
+    name: string;
+    /** 组内节点是否并行展示（对应文档「节点分组」与并行段） */
+    layout?: 'sequence' | 'parallel';
+}
+/** 节点上的一个字段（系统字段或自定义字段） */
+export interface NodeField {
+    id: string;
+    label: string;
+    value?: string;
+    /** 必填字段未完成时进入通行条件清单（对应「节点字段必填」） */
+    required?: boolean;
+    /** 该字段的编辑权限说明，展示在字段的 ⓘ 提示里 */
+    permission?: string;
+    /** 字段来源，展示为配置溯源提示 */
+    source?: string;
+    /** 分组键，决定字段落在操作卡的哪一段 */
+    group?: 'schedule' | 'progress' | 'conclusion' | 'custom';
+    readonly?: boolean;
+    /** group === 'progress' 时的进度百分比 */
+    percent?: number;
+    /** 进度写入方式，对应文档「进度写入方式」 */
+    writeMode?: string;
+}
+/** 节点表单（交付物清单），对应文档「完成表单」 */
+export interface FormItem {
+    id: string;
+    label: string;
+    required?: boolean;
+    value?: string;
+    type?: NodeFieldType;
+    options?: string[];
+    placeholder?: string;
+    /** 关联工作项控件；值为本地工作项 ID 列表（逗号分隔）。 */
+    control?: 'workItemSelect';
+    visibleWhen?: {
+        fieldId: string;
+        value: string;
+    };
+}
+/** 子任务，对应文档「子任务」 */
+export interface SubTask {
+    id: string;
+    name: string;
+    deliverable?: string;
+    owner?: string;
+    estimate?: string;
+    schedule?: string;
+    done?: boolean;
+    /** 是否作为节点完成必要条件（阻塞项） */
+    blocking?: boolean;
+}
+/** 完成流转条件，对应文档「完成流转条件」 */
+export interface GateCondition {
+    id: string;
+    label: string;
+    met: boolean;
+    /** 未满足时的引导文案 */
+    fixLabel?: string;
+    detail?: string;
+    /** 命中失败时可跳转的视图（对应「生成不符合条件的视图」） */
+    viewLink?: string;
+}
+/** 节点事件，对应文档「节点事件触发」 */
+export interface NodeEvent {
+    trigger: NodeEventTrigger;
+    text: string;
+}
+/** 自定义按钮，对应文档「节点自定义按钮」 */
+export interface CustomButton {
+    id: string;
+    label: string;
+    variant?: ButtonVariant;
+    placement?: ButtonPlacement;
+    /** 授权操作角色，hover 时展示 */
+    roles?: string[];
+    hint?: string;
+}
+export interface FlowNode {
+    id: string;
+    name: string;
+    status: NodeStatus;
+    groupId?: string;
+    /** 对应文档「设为里程碑」 */
+    milestone?: boolean;
+    /** 里程碑仅可填写截止时间 */
+    deadline?: string;
+    completionMode?: CompletionMode;
+    owner?: string;
+    /** 负责人来源，对应文档「节点负责人」三种方式 */
+    ownerSource?: string;
+    schedule?: string;
+    estimate?: string;
+    worklog?: string;
+    conclusion?: string;
+    conclusionOptions?: string[];
+    opinion?: string;
+    /** 流程图节点右侧统一展示信息（对应「流程图信息显示」） */
+    info?: string;
+    /** 节点延期标识 */
+    delayed?: boolean;
+    /** 进度 */
+    progress?: number;
+    /** 进度写入方式 */
+    progressMode?: string;
+    /** 前序节点名，用于未开始节点的依赖提示 */
+    predecessors?: string[];
+    fields?: NodeField[];
+    form?: FormItem[];
+    tasks?: SubTask[];
+    /** 业务自定义的完成流转条件，与系统必填项合并展示 */
+    gates?: GateCondition[];
+    events?: NodeEvent[];
+    buttons?: CustomButton[];
+    /** 节点显示条件未命中时的原因（对应「节点显示条件」） */
+    hiddenReason?: string;
+    /** 授权可完成/回滚的人员（对应「授权操作角色」） */
+    actionRoles?: string[];
+    /** 允许删除节点的角色（对应「允许删除节点」） */
+    deleteRoles?: string[];
+}
+export interface FlowDefinition {
+    id: string;
+    /** 流程类型名，对应文档「流程类型管理」 */
+    name: string;
+    groups: FlowGroup[];
+    nodes: FlowNode[];
+    /** 流程级统一展示字段（整条流程一致，保证横向可比） */
+    infoField?: {
+        label: string;
+        position: 'right' | 'below' | 'none';
+    };
+    /** 流程模板版本，用于升级模板提示 */
+    templateVersion?: string;
+    latestTemplateVersion?: string;
+    /** 状态计算规则摘要，只读展示（对应「状态计算规则」） */
+    statusRules?: string[];
+    /** 工作项详情页的流程展示配置，与独立 node-flow 面板分别渲染。 */
+    detail?: {
+        version?: number;
+        tags: {
+            id: string;
+            label: string;
+            color?: string;
+            nodeIds?: string[];
+            enabled?: boolean;
+            tooltip?: string;
+        }[];
+        switches: {
+            id: string;
+            label: string;
+            checked: boolean;
+            nodeIds?: string[];
+        }[];
+        fields: {
+            key: 'owner' | 'schedule' | 'estimate';
+            label: string;
+        }[];
+        menu: ('estimate' | 'group-chat' | 'delete-node')[];
+        /** 实例依赖图；控制项隐藏节点后由详情投影重连可见前后节点。 */
+        connections?: Record<string, string[]>;
+        /** 模块配置和节点实例值分开，两个节点呈现区域共用此配置。 */
+        nodes?: Record<string, {
+            sections: ('form' | 'tasks')[];
+            fields?: {
+                key: 'owner' | 'schedule' | 'estimate';
+                label: string;
+            }[];
+            completeLabel?: string;
+            deletable?: boolean;
+        }>;
+    };
+}
+export interface NodeFlowSearch {
+    query: string;
+}
+export interface NodeFlowOptions extends InteractionOptions {
+    flow: FlowDefinition;
+    title?: string;
+    selectedNodeId?: string;
+    /** 只读模式：隐藏所有写操作 */
+    readonly?: boolean;
+    onSelectNode?: (nodeId: string) => void;
+    /** 返回 false 阻止默认完成行为，用于后端校验 */
+    onComplete?: (nodeId: string, gates: GateCondition[]) => boolean | void;
+    onAction?: (action: string, nodeId: string) => void;
+    onFieldChange?: (nodeId: string, fieldId: string, value: string) => void;
+    onFormChange?: (nodeId: string, formId: string, value: string) => void;
+    onTaskToggle?: (nodeId: string, taskId: string, done: boolean) => void;
+}
+export interface NodeFlowApi extends InteractionSource {
+    selectNode(nodeId: string): void;
+    getSelectedNode(): FlowNode | null;
+    setFlow(flow: FlowDefinition): void;
+    updateNode(nodeId: string, patch: Partial<FlowNode>): void;
+    /** 定位并滚动到指定节点 */
+    focusNode(nodeId: string): void;
+    destroy(): void;
+}

package/dist/types/personnel/component.d.ts

@@ -1,5 +1,6 @@
+import { type InteractionOptions, type InteractionSource } from '../shared/interaction';
 import type { ScheduleItem, SchedulePerson } from './model';
-export interface PersonnelScheduleOptions {
+export interface PersonnelScheduleOptions extends InteractionOptions {
     people: SchedulePerson[];
     items: ScheduleItem[];
     today?: string;
@@ -10,7 +11,7 @@ export interface PersonnelScheduleOptions {
     onItemChange?: (item: ScheduleItem) => void;
     onItemOpen?: (item: ScheduleItem) => void;
 }
-export interface PersonnelScheduleApi {
+export interface PersonnelScheduleApi extends InteractionSource {
     setData(people: SchedulePerson[], items: ScheduleItem[]): void;
     getItems(): ScheduleItem[];
     updateItem(id: string, changes: Partial<Omit<ScheduleItem, 'id'>>): void;

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

@@ -1,3 +1,3 @@
 export { createPersonnelSchedule } from './component';
 export type { PersonnelScheduleApi, PersonnelScheduleOptions } from './component';
-export type { SchedulePerson, ScheduleItem } from './model';
+export type { ScheduleItem, SchedulePerson } from './model';

package/dist/types/personnel/render.d.ts

@@ -0,0 +1,22 @@
+import type { ScheduleItem, SchedulePerson } from './model';
+export interface ScheduleView {
+    people: SchedulePerson[];
+    items: ScheduleItem[];
+    today: string;
+    selected: Set<string>;
+    onlyScheduled: boolean;
+    query: string;
+    status: string;
+    sort: string;
+    descending: boolean;
+    zoom: number;
+    expanded: boolean;
+    children: boolean;
+    loose: boolean;
+    colorFirst: boolean;
+    from: number;
+    days: number;
+    rangeStart: string;
+    rangeEnd: string;
+}
+export declare function renderSchedule(root: HTMLElement, state: ScheduleView): void;