rowvia 0.3.3 → 0.3.5

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

@@ -1,10 +1,18 @@
 export interface ScrollbarOptions {
     viewport: HTMLElement;
     wrapper: HTMLElement;
-    onHorizontalScroll: (left: number) => void;
+    onHorizontalScroll(left: number): void;
+    content?: Element | null;
+    labels?: {
+        horizontal?: string;
+        vertical?: string;
+    };
 }
-/** External scrollbars mirror a viewport without owning its data or rendering. */
-export declare function createScrollbars(options: ScrollbarOptions): {
+/** Overlay controls share the grid's scroll position without changing its layout. */
+export declare function createScrollbars({ viewport, wrapper, onHorizontalScroll, content, labels }: ScrollbarOptions): {
     sync: () => void;
     destroy(): void;
 };
+/** Alias for hosts mounting the table presentation helpers together. */
+export declare const mountTableScrollbars: typeof createScrollbars;
+export type TableScrollbarOptions = ScrollbarOptions;

package/dist/types/components/table-cell-content.d.ts

@@ -0,0 +1,9 @@
+export interface CellContentOptions {
+    textSelector?: string;
+    cellSelector?: string;
+    richTextSelector?: string;
+}
+/** Presentation only: retain full display text while the grid renders one line. */
+export declare function mountCellContent(grid: HTMLElement, options?: CellContentOptions): {
+    destroy(): void;
+};

package/dist/types/components/table-groups.d.ts

@@ -0,0 +1,32 @@
+import type { FieldConfig } from '../fields/types';
+import type { GridApi, RowNode } from '../types';
+export declare const TABLE_GROUP_HEIGHT = 50;
+export declare const TABLE_GROUP_INDENT = 16;
+export declare function groupLeadingGap(node: RowNode): number;
+export declare function groupTrailingSpace(node: RowNode): number;
+export declare function tableGroupRowHeight(node: RowNode, rowHeight: number): number;
+export declare function groupBoxHeight(node: RowNode, rowHeight: number): number;
+export declare function groupRowNumber(node: RowNode): number;
+export declare function groupCaption(node: RowNode, field?: FieldConfig, emptyLabel?: string): {
+    label: string;
+    color: string | undefined;
+};
+export interface TableGroupOptions {
+    wrapper?: HTMLElement;
+    grid?: HTMLElement;
+    emptyLabel?: string;
+    countLabel?: (count: number) => string;
+    toggleLabel?: (expanded: boolean, label: string) => string;
+    caption?: (node: RowNode) => {
+        label: string;
+        color?: string;
+    };
+    /** Hosts can retain expansion across remounts by supplying this map. */
+    expansion?: Map<string, boolean>;
+}
+/** The grid owns grouping, selection and virtualization. This presentation layer
+ * spans its pinned/scrollable sections without introducing a duplicate group column. */
+export declare function mountTableGroups(root: HTMLElement, api: GridApi, field: (level: number) => FieldConfig | undefined, rowHeight: () => number, onToggle: () => void, options?: TableGroupOptions): {
+    restoreExpansion(): void;
+    destroy(): void;
+};

package/dist/types/components/table-headers.d.ts

@@ -0,0 +1,11 @@
+import type { ColumnApi } from '../types';
+export interface TableHeaderOptions {
+    wrapper?: HTMLElement;
+    viewport?: HTMLElement | null;
+    canGesture?: (key: string) => boolean;
+    menuAnchor?: (cell: HTMLElement) => HTMLElement;
+}
+/** ColumnApi owns state; this layer owns pointer feedback and edge autoscrolling. */
+export declare function mountTableHeaders(root: HTMLElement, columns: ColumnApi, changed: () => void, closePopup: () => void, menu: (anchor: HTMLElement, key: string) => void, styled?: boolean, options?: TableHeaderOptions): {
+    destroy(): void;
+};

package/dist/types/components/table-inline-editor.d.ts

@@ -0,0 +1,13 @@
+import type { ControlEditor } from '../fields/types';
+export interface InlineCellEditorOptions {
+    /** 选项/日期这类控件选中即生效，选了就存，不必等失焦。 */
+    commitOnChange?: boolean;
+    saveErrorMessage?: string;
+    /** Additional host-owned popup boundaries. */
+    isInside?: (node: Node) => boolean;
+}
+/** Host a field control in a cell; persistence remains an asynchronous host callback. */
+export declare function mountInlineCellEditor(cell: HTMLElement, editor: ControlEditor, save: (value: unknown) => Promise<boolean>, onClose?: () => void, onInput?: () => void, options?: InlineCellEditorOptions): {
+    cancel: () => void;
+    commit: (close?: boolean) => Promise<void>;
+};

package/dist/types/components/table-popup.d.ts

@@ -0,0 +1,3 @@
+/** Shared with standalone field popups; fields keep their own dependency boundary. */
+export { anchorPopup, fixedOrigin } from '../fields/internal/anchored-popup';
+export type { AnchoredPopupOptions, PopupPlacement } from '../fields/internal/anchored-popup';

package/dist/types/components/table-presentation.d.ts

@@ -0,0 +1,14 @@
+export { anchorPopup, fixedOrigin } from './table-popup';
+export type { AnchoredPopupOptions, PopupPlacement } from './table-popup';
+export { createScrollbars, mountTableScrollbars } from './scrollbars';
+export type { ScrollbarOptions, TableScrollbarOptions } from './scrollbars';
+export { mountTableHeaders } from './table-headers';
+export type { TableHeaderOptions } from './table-headers';
+export { TABLE_GROUP_HEIGHT, TABLE_GROUP_INDENT, groupLeadingGap, groupTrailingSpace, tableGroupRowHeight, groupBoxHeight, groupRowNumber, groupCaption, mountTableGroups, } from './table-groups';
+export type { TableGroupOptions } from './table-groups';
+export { mountInlineCellEditor } from './table-inline-editor';
+export type { InlineCellEditorOptions } from './table-inline-editor';
+export { mountMultiTextCellEditor } from './table-text-editor';
+export type { MultiTextField, MultiTextCellEditorOptions, MultiTextEditorMessages } from './table-text-editor';
+export { mountCellContent } from './table-cell-content';
+export type { CellContentOptions } from './table-cell-content';

package/dist/types/components/table-text-editor.d.ts

@@ -0,0 +1,29 @@
+export interface MultiTextField {
+    label: string;
+    placeholder?: string;
+    maxLength?: number;
+    required?: boolean;
+}
+export interface MultiTextCellEditorOptions {
+    messages?: Partial<MultiTextEditorMessages>;
+    field: MultiTextField;
+    value: unknown;
+    save: (value: string) => Promise<boolean>;
+    onClose?: () => void;
+    onInput?: () => void;
+}
+export interface MultiTextEditorMessages {
+    undo: string;
+    redo: string;
+    expand: string;
+    collapse: string;
+    done: string;
+    placeholder: string;
+    required: string;
+    saveError: string;
+}
+/** Feishu's multi-line cell editor: a floating card over the cell, not an in-cell input. */
+export declare function mountMultiTextCellEditor(cell: HTMLElement, options: MultiTextCellEditorOptions): {
+    cancel: () => void;
+    commit: () => Promise<void>;
+};

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

@@ -0,0 +1,12 @@
+/** Editing metadata only. Hosts retain their own AST, conversion and evaluation. */
+export interface ConditionChoice {
+    value: string | number | boolean;
+    label: string;
+    disabled?: boolean;
+}
+export interface ConditionOperatorChoice extends ConditionChoice {
+    noValue?: boolean;
+}
+export type ConditionValueKind = 'text' | 'number' | 'boolean' | 'options' | 'number-range' | 'date' | 'date-range';
+/** Preserve incomplete drafts and the untouched endpoint without normalising the host's value. */
+export declare function updateConditionRange(value: unknown, index: 0 | 1, next: unknown): unknown[];

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

@@ -130,7 +130,7 @@ export interface WorkItem {
 export type Field = string;
 export interface Rule {
     field: Field;
-    operator: "contains" | "equals" | "notEqual" | "blank" | "notBlank";
+    operator: "contains" | "notContains" | "equals" | "notEqual" | "blank" | "notBlank" | "gt" | "gte" | "lt" | "lte";
     value: string;
 }
 export interface ColorRule extends Rule {

package/dist/types/fields/internal/anchored-popup.d.ts

@@ -0,0 +1,23 @@
+export type PopupPlacement = 'cell' | 'below' | 'choice' | 'column' | 'overlay';
+export interface AnchoredPopupOptions {
+    /** Size a nested shell when the positioned element is a portal layer. */
+    sizeElement?: HTMLElement;
+    width?: 'anchor' | 'auto' | number | (() => number);
+    widthOffset?: number;
+    gap?: number;
+    align?: 'start' | 'end';
+    optionSelector?: string;
+    optionTextSelector?: string;
+    /** Fullscreen editors suspend anchoring until they return to a card. */
+    paused?: () => boolean;
+}
+/** Viewport origin of the nearest fixed-position containing block. */
+export declare function fixedOrigin(element: Element): {
+    x: number;
+    y: number;
+};
+/** Anchor fixed layers through translated/scaled containing blocks, flip and clamp. */
+export declare function anchorPopup(panel: HTMLElement, anchor: HTMLElement, placement: PopupPlacement, onDetached: () => void, options?: AnchoredPopupOptions): {
+    update: () => void;
+    destroy: () => void;
+};

package/dist/types/fields/popup.d.ts

@@ -1,12 +1,3 @@
-/**
- * Top-layer popup host for field controls.
- *
- * Feishu Project renders option lists, calendars and cascade columns in a
- * body-level layer that floats above the page: it never joins the document
- * flow, never changes the geometry of the field that opened it and always
- * paints above the drawer/table below it. Rowvia reproduces that contract
- * here so every control shares one anchor/flip/clamp implementation.
- */
 export interface FieldPopupOptions {
     /** Element the popup is anchored to; normally the field trigger box. */
     anchor: HTMLElement;
@@ -31,6 +22,13 @@ export interface FieldPopup {
     reposition: () => void;
     close: () => void;
 }
+export interface FieldPopupPresentation {
+    className?: string;
+    width?: FieldPopupOptions['width'];
+    align?: FieldPopupOptions['align'];
+}
+/** A scoped presentation hook runs during popup creation, before positioning. */
+export declare function registerFieldPopupPresentation(owner: HTMLElement, presentation: (anchor: HTMLElement) => FieldPopupPresentation | undefined): () => void;
 /** True when the node belongs to any open field popup (option list, calendar, ...). */
 export declare function isInsideFieldPopup(node: Node | null, owner?: HTMLElement): boolean;
 /** Close every open field popup; hosts call this when a whole surface unmounts. */

package/dist/types/fields/types.d.ts

@@ -62,6 +62,9 @@ export interface FieldConfig {
         showTime?: boolean;
         showRange?: boolean;
         showSeconds?: boolean;
+        months?: 1 | 2;
+        rangeLabels?: [string, string];
+        collapseOnSelect?: boolean;
     };
     colors?: Record<string, string>;
     defaultValue?: unknown;

package/dist/types/index.d.ts

@@ -24,6 +24,7 @@ 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';
+export * from './components/table-presentation';
 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';

package/dist/types/vue/DualPanePicker.d.ts

@@ -0,0 +1,211 @@
+import { type PropType } from 'vue';
+/** Candidate data stays host-owned; keys absent from items remain selected. */
+export interface DualPanePickerItem {
+    key: string;
+    label: string;
+    sublabel?: string;
+    avatarText?: string;
+    avatarColor?: string;
+    /** Disables selection in the candidate pane. */
+    disabled?: boolean;
+}
+export declare const DualPanePicker: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    modelValue: {
+        type: PropType<string[]>;
+        required: true;
+    };
+    items: {
+        type: PropType<DualPanePickerItem[]>;
+        required: true;
+    };
+    disabled: BooleanConstructor;
+    disabledKeys: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    checkedKeys: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    excludedKeys: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    searchable: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    searchPlaceholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    searchAriaLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    groupLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    selectAll: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    clearable: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    totalText: {
+        type: StringConstructor;
+        default: string;
+    };
+    selectedText: {
+        type: StringConstructor;
+        default: string;
+    };
+    selectAllText: {
+        type: StringConstructor;
+        default: string;
+    };
+    unselectAllText: {
+        type: StringConstructor;
+        default: string;
+    };
+    clearText: {
+        type: StringConstructor;
+        default: string;
+    };
+    removeText: {
+        type: StringConstructor;
+        default: string;
+    };
+    disabledHint: {
+        type: StringConstructor;
+        default: string;
+    };
+    emptyText: {
+        type: StringConstructor;
+        default: string;
+    };
+    selectedEmptyText: {
+        type: StringConstructor;
+        default: string;
+    };
+    height: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    'update:modelValue': (_value: string[]) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    modelValue: {
+        type: PropType<string[]>;
+        required: true;
+    };
+    items: {
+        type: PropType<DualPanePickerItem[]>;
+        required: true;
+    };
+    disabled: BooleanConstructor;
+    disabledKeys: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    checkedKeys: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    excludedKeys: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    searchable: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    searchPlaceholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    searchAriaLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    groupLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    selectAll: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    clearable: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    totalText: {
+        type: StringConstructor;
+        default: string;
+    };
+    selectedText: {
+        type: StringConstructor;
+        default: string;
+    };
+    selectAllText: {
+        type: StringConstructor;
+        default: string;
+    };
+    unselectAllText: {
+        type: StringConstructor;
+        default: string;
+    };
+    clearText: {
+        type: StringConstructor;
+        default: string;
+    };
+    removeText: {
+        type: StringConstructor;
+        default: string;
+    };
+    disabledHint: {
+        type: StringConstructor;
+        default: string;
+    };
+    emptyText: {
+        type: StringConstructor;
+        default: string;
+    };
+    selectedEmptyText: {
+        type: StringConstructor;
+        default: string;
+    };
+    height: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{
+    "onUpdate:modelValue"?: ((_value: string[]) => any) | undefined;
+}>, {
+    height: string;
+    selectAll: boolean;
+    disabled: boolean;
+    disabledKeys: string[];
+    checkedKeys: string[];
+    excludedKeys: string[];
+    searchable: boolean;
+    searchPlaceholder: string;
+    searchAriaLabel: string;
+    groupLabel: string;
+    clearable: boolean;
+    totalText: string;
+    selectedText: string;
+    selectAllText: string;
+    unselectAllText: string;
+    clearText: string;
+    removeText: string;
+    disabledHint: string;
+    emptyText: string;
+    selectedEmptyText: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;