rowvia 0.3.0 → 0.3.1

package/dist/types/contracts/work-item.d.ts

@@ -198,12 +198,16 @@ export interface FormPlacement {
 export interface FormGroupConfig {
     id: string;
     label: string;
-    items: FormPlacement[];
+    items: FormLayoutItem[];
+    columns?: 1 | 2;
+    columnRatio?: [number, number];
+    span?: 1 | 2;
     visibleWhen?: FormCondition;
 }
-export type FormLayoutItem = FormPlacement | FormGroupConfig;
+export type FormLayoutItem = FormPlacement | FormGroupConfig | FormBlockConfig;
 export interface FormBlockConfig {
     id: string;
+    span?: 1 | 2;
     kind: 'roles' | 'meetings' | 'approval' | 'votes' | 'custom';
     label?: string;
     visibleWhen?: FormCondition;

package/dist/types/index.d.ts

@@ -19,6 +19,8 @@ export * from './gantt';
 export * from './node-flow';
 export * from './personnel';
 export * from './work-items';
+export { createWorkflowDetail } from './work-items/workflow-detail';
+export type * from './work-items/workflow-detail-types';
 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';

package/dist/types/work-items/detail/detail-comments.d.ts

@@ -0,0 +1,44 @@
+import type { WorkItem } from '../../contracts/work-item';
+import type { FieldServices, FieldOption } from '../../fields/types';
+export type DetailComment = Exclude<WorkItem['comments'][number], string> & {
+    authorId?: string;
+    replyTo?: string;
+};
+export interface DetailCommentSave {
+    action: 'create' | 'edit' | 'reply';
+    id?: string;
+    replyTo?: string;
+    html: string;
+    content: string;
+}
+export interface DetailCommentsPermissions {
+    create?: boolean;
+    reply?: boolean | ((comment: DetailComment) => boolean);
+    edit?: boolean | ((comment: DetailComment) => boolean);
+}
+export interface DetailCommentsOptions {
+    comments?: Array<string | DetailComment>;
+    data?: Array<string | DetailComment>;
+    author: string | {
+        id: string;
+        display: string;
+    };
+    permissions?: DetailCommentsPermissions;
+    people?: FieldOption[];
+    services?: Pick<FieldServices, 'searchOptions'>;
+    onSave?: (command: DetailCommentSave, signal: AbortSignal) => WorkItem['comments'] | Promise<WorkItem['comments']>;
+    onPublish?: (payload: DetailCommentSave, signal: AbortSignal) => boolean | Promise<boolean>;
+    onEdit?: (id: string, payload: DetailCommentSave, signal: AbortSignal) => boolean | Promise<boolean>;
+    hasMore?: boolean;
+    onLoadMore?: (signal: AbortSignal) => void | Promise<void>;
+    renderActions?: (container: HTMLElement, comment: DetailComment) => void | (() => void);
+    renderAttachments?: (container: HTMLElement, comment: DetailComment) => void | (() => void);
+}
+export declare function createDetailComments(initial: DetailCommentsOptions): {
+    element: HTMLElement;
+    composer: HTMLDivElement;
+    decorateTab: (surface: HTMLElement) => void;
+    update: (patch: Partial<Pick<DetailCommentsOptions, "comments" | "data" | "permissions" | "hasMore">>) => void;
+    deactivate: () => void;
+    destroy: () => void;
+};

package/dist/types/work-items/detail/detail-history.d.ts

@@ -0,0 +1,38 @@
+import type { WorkItem } from '../../contracts/work-item';
+import { type HistoryQuery, type HistoryEntry, type HistoryModule } from './history-model';
+export interface DetailHistoryPage {
+    rows: HistoryEntry[];
+    total?: number;
+    matching?: number;
+    nextCursor?: string | null;
+    previousCursor?: string | null;
+}
+export interface DetailHistoryQuery extends HistoryQuery {
+    cursor?: string;
+}
+export interface DetailHistoryOptions {
+    records?: WorkItem['history'];
+    rows?: HistoryEntry[];
+    query?: Partial<DetailHistoryQuery>;
+    nextCursor?: string | null;
+    previousCursor?: string | null;
+    actor?: string;
+    nodeFlow?: boolean;
+    mode?: 'server' | 'local';
+    page?: DetailHistoryPage;
+    modules?: HistoryModule[];
+    operators?: Array<{
+        id: string;
+        label: string;
+    }>;
+    onQuery?: (query: DetailHistoryQuery, signal: AbortSignal) => DetailHistoryPage | void | Promise<DetailHistoryPage | void>;
+    onLoadMore?: (cursor: string, query: DetailHistoryQuery, signal: AbortSignal) => DetailHistoryPage | void | Promise<DetailHistoryPage | void>;
+    renderDetail?: (container: HTMLElement, entry: HistoryEntry) => void | (() => void);
+}
+export declare function createDetailHistory(initial: DetailHistoryOptions): {
+    element: HTMLElement;
+    refresh: (loadMore?: boolean) => void;
+    deactivate: () => void;
+    update: (patch: Partial<Pick<DetailHistoryOptions, "records" | "rows" | "page" | "query" | "nextCursor" | "previousCursor" | "modules" | "operators">>) => void;
+    destroy: () => void;
+};

package/dist/types/work-items/detail/history-model.d.ts

@@ -0,0 +1,48 @@
+import type { WorkItem } from '../../contracts/work-item';
+export type HistoryEntry = Exclude<WorkItem['history'][number], string>;
+export interface HistoryModule {
+    key: string;
+    label: string;
+}
+export interface HistoryQuery {
+    keyword: string;
+    keywordFilter: boolean;
+    operatorKinds: Set<string>;
+    operators: Set<string>;
+    modules: Set<string>;
+    start: string;
+    end: string;
+    page: number;
+}
+export declare const historyModules: HistoryModule[];
+export declare function normalizeHistory(item: Pick<WorkItem, 'history'>, actor: string): HistoryEntry[];
+/** The log endpoint already supplies localized display content; origin_content is not HTML. */
+export declare function adaptOperationRecords(records: Array<{
+    id: string;
+    operator?: {
+        user_key: string;
+        name: string;
+    };
+    operator_type: number;
+    op_record_type_key: string;
+    op_record_type_name: string;
+    content: string;
+    created_at: number;
+}>): HistoryEntry[];
+export declare function queryHistory(logs: HistoryEntry[], query: HistoryQuery): {
+    rows: {
+        id?: string;
+        actor: string;
+        actorId?: string;
+        actorKind?: "user" | "computed" | "automation" | "system";
+        module: string;
+        moduleKey?: string;
+        detail: string;
+        createdAt: string;
+    }[];
+    total: number;
+    matching: number;
+    filteredTotal: number;
+    page: number;
+    pageCount: number;
+};

package/dist/types/work-items/index.d.ts

@@ -1,4 +1,12 @@
 export type * from '../contracts/work-item';
+export { createWorkflowDetail } from './workflow-detail';
+export type * from './workflow-detail-types';
+export { createDetailComments } from './detail/detail-comments';
+export type { DetailComment, DetailCommentSave, DetailCommentsPermissions, DetailCommentsOptions } from './detail/detail-comments';
+export { createDetailHistory } from './detail/detail-history';
+export type { DetailHistoryPage, DetailHistoryQuery, DetailHistoryOptions } from './detail/detail-history';
+export { historyModules, normalizeHistory, queryHistory, adaptOperationRecords } from './detail/history-model';
+export type { HistoryEntry, HistoryModule, HistoryQuery } from './detail/history-model';
 export type { FormCondition, FormConditionOp, FormScope, FormSurfaceContext } from '../forms/form-conditions';
 export { emptyView, matches } from './model';
 export { createWorkItemTabs } from './tabs';

package/dist/types/work-items/workflow-detail-model.d.ts

@@ -0,0 +1,51 @@
+import type { FlowDefinition, FlowNode } from '../node-flow/types';
+/** demand_fetch 的 modules / biz_data / ui_data 在 demo 中的轻量投影。
+ * 配置控制区域与字段，FlowNode 只提供实例值；不依赖 node-flow 组件。 */
+export declare function projectWorkflowDetail(flow: FlowDefinition): {
+    controls: {
+        roles: {
+            id: string;
+            label: string;
+            color?: string;
+            nodeIds?: string[];
+            enabled?: boolean;
+            tooltip?: string;
+        }[];
+        switches: {
+            id: string;
+            label: string;
+            checked: boolean;
+            nodeIds?: string[];
+        }[];
+    };
+    graph: {
+        nodes: FlowNode[];
+        edges: {
+            from: string;
+            to: string;
+        }[];
+    };
+    nodeList: FlowNode[];
+    node: (node: FlowNode) => {
+        data: FlowNode;
+        form: import("..").FormItem[];
+        fields: {
+            key: "owner" | "schedule" | "estimate";
+            label: string;
+        }[];
+        sections: ("form" | "tasks")[];
+        completeLabel: string;
+        deletable: boolean;
+    };
+};
+/** 按实际依赖拓扑分列，不根据阶段名猜测连线。 */
+export declare function layoutWorkflowGraph(graph: ReturnType<typeof projectWorkflowDetail>['graph']): {
+    nodes: {
+        node: FlowNode;
+        x: number;
+        y: number;
+        width: number;
+    }[];
+    paths: string[];
+    width: number;
+};

package/dist/types/work-items/workflow-detail-types.d.ts

@@ -0,0 +1,95 @@
+import type { CustomButton, FlowDefinition, FlowNode, FormItem, NodeField, SubTask } from '../node-flow/types';
+export type WorkflowDetailCommand = {
+    type: 'update-node';
+    nodeId: string;
+    patch: Partial<FlowNode>;
+    detail: string;
+} | {
+    type: 'delete-node';
+    nodeId: string;
+} | {
+    type: 'update-flow';
+    detail: NonNullable<FlowDefinition['detail']>;
+} | {
+    type: 'action';
+    nodeId: string;
+    actionId: string;
+};
+export type WorkflowDetailPermission = 'edit' | 'complete' | 'delete' | 'create-task' | 'toggle-task' | 'configure' | 'action';
+export interface WorkflowDetailRenderContext {
+    node: FlowNode;
+    surface: 'selected' | 'list';
+    readonly: boolean;
+    pending: boolean;
+    signal: AbortSignal;
+    context: WorkflowDetailContext;
+    can(permission: WorkflowDetailPermission, key?: string): boolean;
+    commit(patch: Partial<FlowNode>, detail?: string): Promise<boolean>;
+    action(actionId: string): Promise<boolean>;
+}
+export interface WorkflowDetailContext {
+    currentUser?: string;
+    people?: {
+        id: string;
+        name: string;
+    }[];
+    workItems?: {
+        id: string;
+        name: string;
+    }[];
+}
+export type WorkflowDetailResult = FlowDefinition | void | Promise<FlowDefinition | void>;
+export interface WorkflowDetailCallbackContext {
+    flow: FlowDefinition;
+    signal: AbortSignal;
+}
+export interface WorkflowDetailOptions {
+    flow: FlowDefinition;
+    selectedNodeId?: string;
+    currentUser?: string;
+    workItems?: {
+        id: string;
+        name: string;
+    }[];
+    readonly?: boolean;
+    context?: WorkflowDetailContext;
+    can?: (permission: WorkflowDetailPermission, node?: FlowNode, key?: string) => boolean;
+    onChange?: (nodeId: string, patch: Partial<FlowNode>, detail: string, context: WorkflowDetailCallbackContext) => WorkflowDetailResult;
+    onComplete?: (nodeId: string, context: WorkflowDetailCallbackContext) => WorkflowDetailResult;
+    onAction?: (nodeId: string, actionId: string, context: WorkflowDetailCallbackContext) => WorkflowDetailResult;
+    onDelete?: (nodeId: string, context: WorkflowDetailCallbackContext) => WorkflowDetailResult;
+    onFlowChange?: (detail: NonNullable<FlowDefinition['detail']>, context: WorkflowDetailCallbackContext) => WorkflowDetailResult;
+    onCreateTask?: (nodeId: string, context: WorkflowDetailCallbackContext) => WorkflowDetailResult;
+    taskColumns?: (node: FlowNode) => {
+        key: string;
+        label: string;
+    }[];
+    renderTaskField?: (host: HTMLElement, task: SubTask, column: {
+        key: string;
+        label: string;
+    }, context: WorkflowDetailRenderContext) => void | (() => void);
+    onCommand?: (command: WorkflowDetailCommand, context: {
+        flow: FlowDefinition;
+        signal: AbortSignal;
+    }) => FlowDefinition | void | Promise<FlowDefinition | void>;
+    onError?: (error: unknown, command: WorkflowDetailCommand) => void;
+    onSelectNode?: (nodeId: string) => void;
+    renderField?: (container: HTMLElement, field: FormItem | NodeField, context: WorkflowDetailRenderContext) => void | (() => void);
+    renderSystemField?: (container: HTMLElement, field: {
+        key: 'owner' | 'schedule' | 'estimate';
+        label: string;
+    }, context: WorkflowDetailRenderContext) => void | (() => void);
+    renderActions?: (container: HTMLElement, buttons: CustomButton[], context: WorkflowDetailRenderContext) => void | (() => void);
+    renderNodeFields?: (node: FlowNode, host: HTMLElement, context: WorkflowDetailRenderContext) => void | (() => void);
+    renderNodeForm?: (node: FlowNode, host: HTMLElement, context: WorkflowDetailRenderContext) => void | (() => void);
+}
+export interface WorkflowDetailApi {
+    element: HTMLElement;
+    nodeListElement: HTMLElement;
+    renderNodeDetails(): HTMLElement;
+    setFlow(flow: FlowDefinition): void;
+    update(options: Partial<WorkflowDetailOptions>): void;
+    selectNode(nodeId: string): void;
+    getSelectedNode(): FlowNode | undefined;
+    destroy(): void;
+}

package/dist/types/work-items/workflow-detail.d.ts

@@ -0,0 +1,3 @@
+import type { WorkflowDetailApi, WorkflowDetailOptions } from './workflow-detail-types';
+export type * from './workflow-detail-types';
+export declare function createWorkflowDetail(options: WorkflowDetailOptions): WorkflowDetailApi;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rowvia",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "零运行时依赖的 TypeScript 数据表格、甘特图与人员排期组件库",
   "type": "module",
   "scripts": {