rowvia 0.2.3 → 0.2.4

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

@@ -8,5 +8,6 @@ export { createWorkItemPage } from './work-items/page';
 export { createControlRegistry, sanitizeRichText } from './work-items/controls';
 export type { FieldControl, ControlContext, ControlEditor, ControlSurface } from './work-items/controls';
 export type { WorkItemPageConfig, FieldConfig, FieldKind, FormConfig, FormFieldConfig } from './work-items/config';
+export type { FieldOption, AttachmentValue, VoteValue, FieldServices } from './work-items/config';
 export type { WorkItem, ViewState, SavedView, Rule, ColorRule } from './work-items/model';
 export { topicDemoConfig, dateDemoConfig } from './work-items/config';

package/dist/types/pages/work-items/cascade-control.d.ts

@@ -0,0 +1,3 @@
+import type { ControlContext, ControlEditor } from './controls';
+export declare function renderCascade(c: ControlContext): HTMLDivElement;
+export declare function cascadeEditor(multiple: boolean, c: ControlContext): ControlEditor;

package/dist/types/pages/work-items/choice-control.d.ts

@@ -0,0 +1,9 @@
+import type { ControlContext, ControlEditor } from './controls';
+import type { FieldConfig, FieldOption } from './config';
+export declare const el: <K extends keyof HTMLElementTagNameMap>(tag: K, cls?: string, text?: string) => HTMLElementTagNameMap[K];
+export declare const choices: (field: FieldConfig) => FieldOption[];
+export declare const color: (field: FieldConfig, id: string) => string;
+export declare function optionLabel(field: FieldConfig, id: string): string;
+export declare function renderChoice(c: ControlContext, variant?: 'choice' | 'person' | 'relation'): HTMLElement;
+/** Shared searchable picker; stores IDs and keeps legacy string options compatible. */
+export declare function choiceEditor(multiple: boolean, c: ControlContext, variant?: 'choice' | 'person' | 'relation' | 'radio'): ControlEditor;

package/dist/types/pages/work-items/config.d.ts

@@ -1,6 +1,33 @@
 import type { FieldControl } from "./controls";
 import type { ColDef } from "rowvia";
 import { type WorkItem } from "./model";
+/** Stable identity is separate from the displayed label. Conditions are resolved by the host. */
+export interface FieldOption {
+    id: string;
+    label: string;
+    color?: string;
+    description?: string;
+    disabled?: boolean;
+    exclusive?: boolean;
+    children?: FieldOption[];
+}
+export interface AttachmentValue {
+    id: string;
+    name: string;
+    url?: string;
+    size?: number;
+}
+export interface VoteValue {
+    selected: string[];
+    counts: Record<string, number>;
+    total?: number;
+}
+/** The host owns authorization, persistence and idempotency. No network is built into controls. */
+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 type FieldKind = (string & {}) | "richText" | "number" | "dateTime" | "detail" | "title" | "text" | "longText" | "multiSelect" | "select" | "status" | "person" | "date" | "vote" | "relation";
 export interface FieldConfig {
     key: string;
@@ -15,15 +42,34 @@ export interface FieldConfig {
     editable?: boolean;
     required?: boolean;
     options?: string[];
+    choices?: FieldOption[];
+    placeholder?: string;
+    maxLength?: number;
+    numberOptions?: {
+        min?: number;
+        max?: number;
+        step?: number;
+        decimals?: number;
+        suffix?: string;
+        thousandsSeparator?: boolean;
+    };
+    attachmentOptions?: {
+        accept?: string;
+        maxFiles?: number;
+        maxBytes?: number;
+    };
+    compositeFields?: FieldConfig[];
+    maxRows?: number;
     /** Maximum selected values for multiSelect; omitted means unlimited. */
     maxSelections?: number;
     /** Calendar features. date hides time by default; dateTime shows it. */
     dateOptions?: {
         showTime?: boolean;
         showRange?: boolean;
+        showSeconds?: boolean;
     };
     colors?: Record<string, string>;
-    defaultValue?: string | number | string[] | null;
+    defaultValue?: unknown;
     column?: Partial<ColDef>;
 }
 export interface FormFieldConfig {
@@ -50,6 +96,7 @@ export interface WorkItemPageConfig {
     detailForm: FormConfig;
     items: WorkItem[];
     controls?: FieldControl[];
+    fieldServices?: FieldServices;
     /** Opt in to browser URL hash integration. Disabled for embedded pages. */
     syncLocationHash?: boolean;
     onDataChange?: (items: WorkItem[]) => void;

package/dist/types/pages/work-items/controls.d.ts

@@ -1,4 +1,5 @@
 export { sanitizeRichText } from './rich-control';
+import type { FieldServices, FieldOption } from './config';
 import type { FieldConfig } from './config';
 import type { WorkItem } from './model';
 export type ControlSurface = 'cell' | 'detail' | 'create';
@@ -9,6 +10,13 @@ export interface ControlContext {
     surface: ControlSurface;
     readonly: 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 {
     element: HTMLElement;
@@ -16,6 +24,8 @@ export interface ControlEditor {
     validate?: () => string | undefined;
     focus?: () => void;
     destroy?: () => void;
+    /** Close internal menus/fullscreen without discarding the draft. */
+    deactivate?: () => void;
 }
 /** Definitions are scoped to a page. Return fresh DOM for each mount. */
 export interface FieldControl {
@@ -24,6 +34,12 @@ export interface FieldControl {
     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;
 }

package/dist/types/pages/work-items/field-controls.d.ts

@@ -0,0 +1,4 @@
+import type { FieldControl } from './controls';
+import type { FieldConfig } from './config';
+export declare function safeLink(value: unknown): string | undefined;
+export declare function extendedControls(resolve: (f: FieldConfig) => FieldControl): FieldControl[];

package/dist/types/pages/work-items/focus-editor.d.ts

@@ -0,0 +1,3 @@
+import type { ControlContext, ControlEditor, FieldControl } from './controls';
+/** One focus boundary for every registered editor, including custom controls. */
+export declare function focusEditor(control: FieldControl, context: ControlContext, editor: ControlEditor): ControlEditor;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rowvia",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "零运行时依赖的 TypeScript 数据表格、甘特图与人员排期组件库",
   "type": "module",
   "scripts": {
@@ -10,7 +10,7 @@
     "build:lib": "vite build --config vite.lib.config.ts && npm run build:types",
     "preview": "vite preview",
     "typecheck": "tsc --noEmit",
-    "test": "esbuild src/index.ts --bundle --format=esm --outfile=dist-test/rowvia.mjs --loader:.ts=ts --log-level=error && node test/smoke.mjs && node test/gantt.mjs && node test/personnel.mjs && node test/work-items.mjs",
+    "test": "esbuild src/index.ts --bundle --format=esm --outfile=dist-test/rowvia.mjs --loader:.ts=ts --log-level=error && node test/smoke.mjs && node test/gantt.mjs && node test/personnel.mjs && node test/work-items.mjs && node test/field-controls.mjs",
     "test:work-items": "node test/work-items.mjs",
     "build:types": "tsc -p tsconfig.build.json && node scripts/clean-types.mjs",
     "prepublishOnly": "npm run typecheck && npm test && npm run build:lib && npm run test:pages",