rowvia 0.2.4 → 0.3.1

package/dist/types/api.d.ts

@@ -1,4 +1,4 @@
-import type { Grid } from './grid';
+import type { GridHost as Grid } from './core/gridHost';
 import type { ColumnApi, GridApi } from './types';
 export declare function createGridApi(grid: Grid): {
     api: GridApi;

package/dist/types/components/cells.d.ts

@@ -0,0 +1,25 @@
+export interface TagCellOptions {
+    label: string;
+    className?: string;
+    markerClassName?: string;
+    marker?: Node;
+}
+/** Plain text labels are always escaped by the DOM, including remote values. */
+export declare function createTagCell(options: TagCellOptions): HTMLElement;
+export interface MediaCellOptions {
+    title: string;
+    description?: string;
+    image?: {
+        src: string;
+        alt: string;
+    };
+    leading?: HTMLElement;
+    className?: string;
+    contentClassName?: string;
+    titleClassName?: string;
+    descriptionClassName?: string;
+    titleTag?: 'span' | 'div' | 'b';
+    descriptionTag?: 'span' | 'div';
+    inline?: boolean;
+}
+export declare function createMediaCell(options: MediaCellOptions): HTMLElement;

package/dist/types/components/detailDialog.d.ts

@@ -1,3 +1,4 @@
+import { type InteractionOptions } from '../shared/interaction';
 export interface DetailDialogContent {
     title: string;
     fields: Array<{
@@ -5,8 +6,13 @@ export interface DetailDialogContent {
         value: string;
     }>;
 }
+export interface DetailDialogOptions extends InteractionOptions {
+    onOpen?: (content: DetailDialogContent) => void;
+    onClose?: () => void;
+}
 /** Text-only detail dialog owned by its mount, with no global IDs or selectors. */
-export declare function createDetailDialog(container: HTMLElement): {
+export declare function createDetailDialog(container: HTMLElement, options?: DetailDialogOptions): {
+    onInteraction: (listener: (event: import("..").ComponentInteraction) => void) => import("../shared/lifecycle").Dispose;
     open(content: DetailDialogContent): void;
     close: () => void;
     destroy(): void;

package/dist/types/components/scrollbars.d.ts

@@ -0,0 +1,10 @@
+export interface ScrollbarOptions {
+    viewport: HTMLElement;
+    wrapper: HTMLElement;
+    onHorizontalScroll: (left: number) => void;
+}
+/** External scrollbars mirror a viewport without owning its data or rendering. */
+export declare function createScrollbars(options: ScrollbarOptions): {
+    sync: () => void;
+    destroy(): void;
+};

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

@@ -0,0 +1,339 @@
+import type { InteractionOptions, InteractionSource } from '../shared/interaction';
+import type { ColDef } from '../types';
+import type { FormCondition, FormScope, FormSurfaceContext } from '../forms/form-conditions';
+import type { FieldConfig as CoreFieldConfig } from '../fields/types';
+export type { FieldOption, AttachmentValue, VoteValue, FieldKind } from '../fields/types';
+import type { FieldOption, AttachmentValue, VoteValue } from '../fields/types';
+export interface FieldConfig extends CoreFieldConfig {
+    width?: number;
+    minWidth?: number;
+    pinned?: 'left' | 'right' | null;
+    hidden?: boolean;
+    column?: Partial<ColDef>;
+}
+export interface FieldServices {
+    searchOptions?: (field: FieldConfig, query: string, signal: AbortSignal) => Promise<FieldOption[]>;
+    upload?: (field: FieldConfig, files: File[], signal: AbortSignal) => Promise<AttachmentValue[]>;
+    vote?: (field: FieldConfig, item: WorkItem, selected: string[], signal: AbortSignal) => Promise<VoteValue>;
+}
+export interface FormFieldConfig {
+    field: string;
+    label?: string;
+    required?: boolean;
+    editable?: boolean;
+}
+export interface FormConfig {
+    fields: FormFieldConfig[];
+    showRoles?: boolean;
+    showMeetings?: boolean;
+    showApproval?: boolean;
+    showVotes?: boolean;
+    /**
+     * Detail-page tab configuration (full replacement of the four system tabs).
+     * Entries follow FormTabConfig: kind 'form' tabs carry their own items/blocks,
+     * system tabs are marked `system`, visibility uses visibleWhen + visibleScope.
+     * See docs/form-surface.md §4.
+     */
+    tabs?: FormTabConfig[];
+}
+export type ControlSurface = 'cell' | 'detail' | 'create';
+export type ControlPage = 'table' | 'basic';
+export type ControlMode = 'default' | 'expanded' | 'editing';
+export interface ControlContext extends InteractionOptions {
+    field: FieldConfig;
+    value: unknown;
+    item: WorkItem;
+    surface: ControlSurface;
+    readonly: boolean;
+    /** Explicit page layout. When omitted it is inferred from surface. */
+    page?: ControlPage;
+    /** Explicit visual state used by hosts and custom controls. */
+    mode?: ControlMode;
+    /** Permission gate for the expanded and editing states. */
+    canEdit?: boolean;
+    openDetail: (id: string) => void;
+    services?: FieldServices;
+    /** Host retains labels for remote selections; values still contain stable IDs only. */
+    onSelectedOptions?: (options: FieldOption[]) => void;
+    /** Transient hosts can dismiss their popup when the editor withdraws. */
+    onDeactivate?: () => void;
+    /** Optional host boundary, e.g. a popup containing its Save/Cancel buttons. */
+    focusBoundary?: HTMLElement;
+}
+export interface ControlEditor extends Partial<InteractionSource> {
+    element: HTMLElement;
+    /** Interactive surface hosted outside element, e.g. a top-layer popup.
+     *  Hosts looking for the editor's inputs must search here too. */
+    content?: HTMLElement;
+    read: () => unknown;
+    validate?: () => string | undefined;
+    focus?: () => void;
+    destroy?: () => void;
+    /** Close internal menus/fullscreen without discarding the draft. */
+    deactivate?: () => void;
+}
+export interface FieldControl {
+    id: string;
+    label: string;
+    description: string;
+    glyph: string;
+    action?: 'edit' | 'select' | 'view';
+    group?: '文本' | '选择' | '人员' | '日期' | '投票' | '其他' | '关联工作项' | '系统';
+    readonly?: boolean;
+    example?: {
+        value: unknown;
+        field?: Partial<FieldConfig>;
+    };
+    render: (context: ControlContext) => HTMLElement;
+    createEditor: (context: ControlContext) => ControlEditor;
+}
+export interface WorkItem {
+    [field: string]: any;
+    id: string;
+    name: string;
+    description: string;
+    vote: string;
+    showVotes: string;
+    status: string;
+    selectedTopic: string;
+    format: string | string[];
+    approved: string;
+    category: string;
+    owner: string;
+    space: string;
+    created: string;
+    creator: string;
+    source: string;
+    followed: boolean;
+    starred: boolean;
+    viewed: boolean;
+    comments: Array<string | {
+        id: string;
+        author: string;
+        content: string;
+        html?: string;
+        createdAt: string;
+    }>;
+    history: Array<string | {
+        id?: string;
+        actor: string;
+        actorId?: string;
+        actorKind?: 'user' | 'computed' | 'automation' | 'system';
+        module: string;
+        moduleKey?: string;
+        detail: string;
+        createdAt: string;
+    }>;
+    nodeFlow?: import('../node-flow/types').FlowDefinition;
+}
+export type Field = string;
+export interface Rule {
+    field: Field;
+    operator: "contains" | "equals" | "notEqual" | "blank" | "notBlank";
+    value: string;
+}
+export interface ColorRule extends Rule {
+    color: string;
+    scope?: string;
+}
+export interface ViewState {
+    filters: Rule[];
+    sorts: {
+        colId: string;
+        sort: "asc" | "desc";
+    }[];
+    groups: string[];
+    colors: ColorRule[];
+    showTerminated: boolean;
+}
+export interface SavedView {
+    name: string;
+    state: ViewState;
+    columns?: unknown;
+    gridState?: unknown;
+    tab?: string;
+    search?: string;
+    filterSearch?: boolean;
+    collaborators?: string;
+    visibility?: string;
+    inNavigation?: boolean;
+}
+export interface FormFieldPermission {
+    /** 范围外不渲染。 */
+    view?: FormScope;
+    /** 范围外只读展示态。 */
+    edit?: FormScope;
+    /** 必填作用范围（按成员/团队/角色）。 */
+    required?: FormScope;
+}
+export interface FormFieldDef extends FieldConfig {
+    /** 「新建页可见」开关：create 面不渲染未开启的字段。 */
+    createVisible?: boolean;
+    /** 字段默认状态覆盖（open 编辑态 / 展示态）。 */
+    defaultState?: 'display' | 'edit';
+    /** 「在某条件下必填」。 */
+    requiredWhen?: FormCondition;
+    /** 「默认全部可见 / 某条件下可见」。 */
+    visibleWhen?: FormCondition;
+    /** 是否展示默认值：不展示 / 统一展示 / 某条件下展示。 */
+    defaultMode?: 'none' | 'always' | 'conditional';
+    defaultWhen?: {
+        when: FormCondition;
+        value: unknown;
+    }[];
+    /** 附加说明。 */
+    description?: string;
+    permission?: FormFieldPermission;
+}
+export interface FormPlacement {
+    /** 指向 fields[].key；同一字段可放置多次。 */
+    field: string;
+    /** 两栏占比：1 = 单栏宽，2 = 通栏。 */
+    span?: 1 | 2;
+    /** 字段展示方式：侧面标签 / 顶部标签。 */
+    labelPosition?: 'side' | 'top';
+    visibleWhen?: FormCondition;
+    requiredWhen?: FormCondition;
+}
+export interface FormGroupConfig {
+    id: string;
+    label: string;
+    items: FormLayoutItem[];
+    columns?: 1 | 2;
+    columnRatio?: [number, number];
+    span?: 1 | 2;
+    visibleWhen?: FormCondition;
+}
+export type FormLayoutItem = FormPlacement | FormGroupConfig | FormBlockConfig;
+export interface FormBlockConfig {
+    id: string;
+    span?: 1 | 2;
+    kind: 'roles' | 'meetings' | 'approval' | 'votes' | 'custom';
+    label?: string;
+    visibleWhen?: FormCondition;
+    /** 「角色是否必填」：这些角色必须选择人员才能创建。 */
+    requiredRoles?: string[];
+    /** 角色下拉候选；缺省只有「提报人」。 */
+    roleOptions?: string[];
+    /** 人员候选目录，人员框与人员控件共用同一选择器。 */
+    people?: FieldOption[];
+    render?: (ctx: FormRenderContext) => HTMLElement | string;
+}
+export interface FormActionConfig {
+    /** 按钮 data-action（宿主事件委托用）。 */
+    id: string;
+    label?: string;
+    kind?: 'button' | 'submit' | 'checkbox';
+    glyph?: string;
+    variant?: 'primary' | 'outline' | '';
+    checked?: boolean;
+    visibleWhen?: FormCondition;
+}
+export interface FormRenderContext {
+    data: Record<string, unknown>;
+    context: FormSurfaceContext;
+    variant: 'create' | 'detail';
+    tab?: FormTabConfig;
+}
+export type FormTabKind = 'form' | 'comments' | 'history' | 'nodes' | 'materials' | 'plugin' | 'custom';
+export interface FormTabConfig {
+    id: string;
+    label: string;
+    kind: FormTabKind;
+    /** 系统预置标签页（基本信息 / 节点详情 / 评论·备注 / 操作记录）。 */
+    system?: boolean;
+    order?: number;
+    /** 可删除：只移除布局，不影响字段值。 */
+    removable?: boolean;
+    /** 「满足条件可见」，与字段级条件 AND。 */
+    visibleWhen?: FormCondition;
+    /** 可见成员范围：人员 / 团队 / 角色。 */
+    visibleScope?: FormScope;
+    /** kind='form' 的字段放置与分组。 */
+    items?: FormLayoutItem[];
+    blocks?: FormBlockConfig[];
+    /** kind='plugin' | 'custom' 的宿主渲染。 */
+    render?: (ctx: FormRenderContext) => HTMLElement | string;
+}
+export interface FormSurfaceEvents {
+    onDestroy?(): void;
+    onChange?(key: string, value: unknown, data: Record<string, unknown>): void;
+    /** 退回展示态时回调（详情页由此持久化）。 */
+    onCommit?(key: string, value: unknown, data: Record<string, unknown>): void;
+    onSubmit?(data: Record<string, unknown>): void;
+    onSaveDraft?(data: Record<string, unknown>): void;
+    /** 提交校验失败时回调（第一条错误文案；首个错误字段已回到编辑态）。 */
+    onInvalid?(message: string): void;
+    onTabChange?(id: string, tab: FormTabConfig): void;
+    onFieldStateChange?(key: string, state: 'display' | 'edit'): void;
+    onCancel?(): void;
+    onAction?(id: string, data: Record<string, unknown>): void;
+    onOpenDetail?(id: string): void;
+}
+export interface FormSurfaceConfig extends InteractionOptions {
+    variant: 'create' | 'detail';
+    presentation?: 'modal' | 'drawer' | 'fullscreen';
+    /** 组件默认是否处于 open 态（页面已展开）。 */
+    open?: boolean;
+    /** 字段默认状态：展示态，或直接进入 open（编辑）态。 */
+    fieldState?: 'display' | 'edit';
+    simpleMode?: boolean;
+    /** 简洁模式保留的字段 key，默认第一个字段。 */
+    simpleKeep?: string[];
+    title?: string;
+    layout?: {
+        labelPosition?: 'side' | 'top';
+        labelWidth?: number;
+        columns?: 1 | 2;
+        /** 新建页布局模式：灵活布局 / 与详情页同步（items 缺省时生效）。 */
+        mode?: 'flexible' | 'sync-detail';
+    };
+    fields: FormFieldDef[];
+    /** create 表单（或未启用 tabs 时）的字段放置；缺省按 fields 顺序。 */
+    items?: FormLayoutItem[];
+    blocks?: FormBlockConfig[];
+    /** 详情页标签页配置；缺省单个「基本信息」表单页。 */
+    tabs?: FormTabConfig[];
+    defaultTab?: string;
+    data?: Record<string, unknown>;
+    context?: FormSurfaceContext;
+    /** 操作区；缺省按 variant 给出飞书默认按钮组。 */
+    actions?: FormActionConfig[];
+    events?: FormSurfaceEvents;
+    labels?: Record<string, string>;
+    /** 宿主装饰（标题栏附加内容、导航、页签右侧、底部评论框等）。 */
+    slots?: {
+        header?: HTMLElement | string;
+        /** 标题栏左侧（返回按钮等）。 */
+        leading?: HTMLElement | string;
+        /** 标题栏下方的子标题条（阶段、标签、信号等）。 */
+        subHeader?: HTMLElement | string;
+        navigation?: HTMLElement | string;
+        tabSuffix?: HTMLElement | string;
+        footer?: HTMLElement | string;
+    };
+}
+export interface FormSurfaceDeps {
+    controls?: ControlRegistry;
+    services?: FieldServices;
+    renderers?: Partial<Record<'comments' | 'history' | 'nodes' | 'materials' | 'plugin' | 'block', (ctx: FormRenderContext & {
+        block?: FormBlockConfig;
+    }) => HTMLElement | string>>;
+}
+export interface FormSurfaceInstance extends InteractionSource {
+    element: HTMLElement;
+    read(): Record<string, unknown>;
+    validate(): string | undefined;
+    setOpen(open: boolean): void;
+    setFieldState(state: 'display' | 'edit'): void;
+    setTab(id: string): void;
+    setSimpleMode(on: boolean): void;
+    activeTab(): string | undefined;
+    update(patch: Partial<Pick<FormSurfaceConfig, 'data' | 'fields' | 'tabs' | 'items' | 'blocks' | 'actions' | 'context'>>): void;
+    destroy(): void;
+}
+export interface ControlRegistry {
+    register(control: FieldControl): void;
+    list(): FieldControl[];
+    resolve(field: FieldConfig): FieldControl;
+}

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

@@ -1,6 +1,6 @@
 import type { Column, GridOptions, RowDataTransaction, RowNode, RowNodeTransactionResult } from '../types';
-import { type RowNodeServices } from './rowNode';
 import { EventService } from './eventService';
+import { type RowNodeServices } from './rowNode';
 export interface RowModel {
     getType(): string;
     /** optional: notify the model that the visible row window changed */
@@ -62,7 +62,6 @@ export declare class ClientSideRowModel implements RowModel {
     private groupDefaultExpandedApplied;
     private pinnedTopRows;
     private pinnedBottomRows;
-    private displayStartIndex;
     private totalRowCount;
     constructor(params: {
         options: GridOptions;

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

@@ -1,4 +1,4 @@
-import type { ColDef, Column, ColumnState, PinPosition, GridOptions } from '../types';
+import type { ColDef, Column, ColumnState, GridOptions, PinPosition } from '../types';
 import { EventService } from './eventService';
 export interface ColumnGroupInfo {
     id: string;
@@ -75,7 +75,7 @@ export declare class ColumnModel {
     removeRowGroupColumn(colKey: string | Column, source?: string): void;
     setValueColumns(colIds: Array<string | Column>, source?: string): void;
     addValueColumn(colKey: string | Column, aggFunc?: string, source?: string): void;
-    setPivotColumns(colIds: Array<string | Column>, source?: string): void;
+    setPivotColumns(colIds: Array<string | Column>, _source?: string): void;
     setColumnVisible(colKey: string | Column, visible: boolean, source?: string): void;
     setColumnsVisible(keys: Array<string | Column>, visible: boolean, source?: string): void;
     setColumnPinned(colKey: string | Column, pinned: PinPosition, source?: string): void;