rowvia 0.1.0 → 0.2.1

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

@@ -1,12 +1,12 @@
 /**
  * UI text for menus, popups and tool panels. Mirrors ag-grid's `localeText`
- * option: the grid merges user-supplied keys over these English defaults and
+ * option: the grid merges user-supplied keys over these Chinese defaults and
  * every built-in string resolves through `t(key)` / `translate(key, fallback)`.
  */
 export declare const DEFAULT_LOCALE_TEXT: Record<string, string>;
 /** filter condition value → locale key (same names as ag-grid) */
 export declare const CONDITION_LABELS: Record<string, string>;
-/** resolves UI text: user overrides first, then the English defaults, then the key itself */
+/** resolves UI text: user overrides first, then the Chinese defaults, then the key itself */
 export declare class LocaleText {
     private overrides;
     constructor(overrides: Record<string, string>);

package/dist/types/index.d.ts

@@ -26,3 +26,4 @@ export * from './gantt';
 export * from './personnel';
 export { createDetailDialog } from './components/detailDialog';
 export type { DetailDialogContent } from './components/detailDialog';
+export * from './pages';

package/dist/types/pages/finance/component.d.ts

@@ -0,0 +1,2 @@
+import { type GridPageOptions } from '../lifecycle';
+export declare function createFinancePage(container: HTMLElement, options?: GridPageOptions): import("rowvia").GridPageHandle;

package/dist/types/pages/finance/data.d.ts

@@ -0,0 +1,14 @@
+declare function logoFor(ticker: string): string;
+export interface Instrument {
+    ticker: string;
+    name: string;
+    instrument: string;
+    quantity: number;
+    purchaseDate: string;
+    purchasePrice: number;
+    price: number;
+    timeline: number[];
+}
+export declare function getData(): Instrument[];
+export declare function updateRows(rowData: Instrument[]): void;
+export { logoFor };

package/dist/types/pages/hr/component.d.ts

@@ -0,0 +1,2 @@
+import { type GridPageOptions } from '../lifecycle';
+export declare function createHrPage(container: HTMLElement, options?: GridPageOptions): import("rowvia").GridPageHandle;

package/dist/types/pages/hr/data.d.ts

@@ -0,0 +1,21 @@
+/** Deterministic pseudo random generator (LCG) so demos render identically. */
+export declare function createRandom(seed?: number): () => number;
+export declare const DEPARTMENTS: Record<string, string>;
+interface EmployeeRecord {
+    orgHierarchy: string[];
+    contact: string;
+    jobTitle: string;
+    employmentType: string;
+    department: string;
+    employeeId: number;
+    location: string;
+    joinDate: string;
+    basicMonthlySalary: number;
+    currency: string;
+    paymentMethod: string;
+    paymentStatus: string;
+    image: string;
+    flag: string;
+}
+export declare function getData(): EmployeeRecord[];
+export {};

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

@@ -0,0 +1,12 @@
+export { createFinancePage } from './finance/component';
+export { createHrPage } from './hr/component';
+export { createInventoryPage } from './inventory/component';
+export { createPerformancePage } from './performance/component';
+export { createServerSidePage } from './server-side/component';
+export type { GridPageOptions, GridPageHandle } from './lifecycle';
+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 { WorkItem, ViewState, SavedView, Rule, ColorRule } from './work-items/model';
+export { topicDemoConfig, dateDemoConfig } from './work-items/config';

package/dist/types/pages/inventory/component.d.ts

@@ -0,0 +1,2 @@
+import { type GridPageOptions } from '../lifecycle';
+export declare function createInventoryPage(container: HTMLElement, options?: GridPageOptions): import("rowvia").GridPageHandle;

package/dist/types/pages/inventory/data.d.ts

@@ -0,0 +1,26 @@
+/** Inventory demo data: 10 vinyl albums with variant details. */
+export interface VariantDetail {
+    title: string;
+    available: number;
+    format: string;
+    label: string;
+    cat: string;
+    country: string;
+    year: string;
+}
+export interface Album {
+    product: string;
+    artist: string;
+    category: string;
+    year: string;
+    status: 'active' | 'paused' | 'outOfStock';
+    available: number;
+    incoming: number;
+    image: string;
+    price: number;
+    sold: number;
+    priceIncrease: number;
+    variants: number;
+    variantDetails: VariantDetail[];
+}
+export declare function getData(): Album[];

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

@@ -0,0 +1,24 @@
+import type { GridOptions, GridApi, ColumnApi } from '../types';
+export interface GridPageOptions {
+    /** Overrides the demo's columns, data, callbacks or remote datasource. */
+    gridOptions?: Partial<GridOptions>;
+    /** Finance sample stream; disable when supplying business data. */
+    liveUpdates?: boolean;
+}
+export interface GridPageHandle {
+    readonly api: GridApi | null;
+    readonly columnApi: ColumnApi | null;
+    destroy(): void;
+}
+export declare function createPageLifecycle(container: HTMLElement, name: string, markup: string, options: GridPageOptions): {
+    host: HTMLElement;
+    handle: GridPageHandle;
+    timeout: (callback: () => void, delay: number) => number;
+    cleanup(callback: () => void): void;
+    interval(callback: () => void, delay: number): number;
+    createGrid(element: HTMLElement, defaults: GridOptions): {
+        api: GridApi;
+        columnApi: ColumnApi;
+        grid: import("../grid").Grid;
+    };
+};

package/dist/types/pages/performance/component.d.ts

@@ -0,0 +1,2 @@
+import { type GridPageOptions } from '../lifecycle';
+export declare function createPerformancePage(container: HTMLElement, options?: GridPageOptions): import("rowvia").GridPageHandle;

package/dist/types/pages/performance/data.d.ts

@@ -0,0 +1,33 @@
+/** Performance demo data + column generation. */
+export interface RowItem {
+    name: string;
+    language: string;
+    country: string;
+    game: {
+        name: string;
+        bought: boolean;
+    };
+    bankBalance: number;
+    rating: number;
+    totalWinnings: number;
+    [month: string]: any;
+    [key: `col${number}`]: any;
+}
+export declare const COUNTRY_NAMES: string[];
+export declare const LANGUAGES: string[];
+export declare const GAMES: string[];
+export declare const MONTHS: string[];
+/** deterministic LCG so every reload produces identical data */
+export declare function createRandom(seed?: number): () => number;
+export declare function resetRandom(): void;
+export declare function createRowItem(index: number, extraColumnCount: number): RowItem;
+export declare function createData(rowCount: number, extraColumnCount: number): RowItem[];
+declare const DATA_TYPES: readonly ["currency", "percent", "rating", "text", "number"];
+export interface ExtraColumnConfig {
+    field: string;
+    group: string;
+    dataType: (typeof DATA_TYPES)[number];
+    width: number;
+}
+export declare function createExtraColumns(count: number): ExtraColumnConfig[];
+export {};

package/dist/types/pages/server-side/component.d.ts

@@ -0,0 +1,2 @@
+import { type GridPageOptions } from '../lifecycle';
+export declare function createServerSidePage(container: HTMLElement, options?: GridPageOptions): import("rowvia").GridPageHandle;

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

@@ -0,0 +1,60 @@
+import type { FieldControl } from "./controls";
+import type { ColDef } from "rowvia";
+import { type WorkItem } from "./model";
+export type FieldKind = (string & {}) | "richText" | "number" | "dateTime" | "detail" | "title" | "text" | "longText" | "multiSelect" | "select" | "status" | "person" | "date" | "vote" | "relation";
+export interface FieldConfig {
+    key: string;
+    label: string;
+    kind?: FieldKind;
+    /** Registered control ID; defaults to the field kind. */
+    control?: string;
+    width?: number;
+    minWidth?: number;
+    pinned?: "left" | "right" | null;
+    hidden?: boolean;
+    editable?: boolean;
+    required?: boolean;
+    options?: string[];
+    /** 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;
+    };
+    colors?: Record<string, string>;
+    defaultValue?: string | number | string[] | null;
+    column?: Partial<ColDef>;
+}
+export interface FormFieldConfig {
+    field: string;
+    label?: string;
+    required?: boolean;
+    editable?: boolean;
+}
+export interface FormConfig {
+    fields: FormFieldConfig[];
+    showRoles?: boolean;
+    showMeetings?: boolean;
+    showApproval?: boolean;
+    showVotes?: boolean;
+}
+export interface WorkItemPageConfig {
+    container: HTMLElement;
+    title: string;
+    workspace: string;
+    storageKey: string;
+    currentUser: string;
+    fields: FieldConfig[];
+    createForm: FormConfig;
+    detailForm: FormConfig;
+    items: WorkItem[];
+    controls?: FieldControl[];
+    /** Opt in to browser URL hash integration. Disabled for embedded pages. */
+    syncLocationHash?: boolean;
+    onDataChange?: (items: WorkItem[]) => void;
+}
+/** The table, create form, and detail layout are three independent configurations. */
+export declare function topicDemoConfig(container: HTMLElement): WorkItemPageConfig;
+/** Deterministic 1,000-row fixture for exercising all three date controls. */
+export declare function dateDemoConfig(container: HTMLElement): WorkItemPageConfig;

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

@@ -0,0 +1,34 @@
+export { sanitizeRichText } from './rich-control';
+import type { FieldConfig } from './config';
+import type { WorkItem } from './model';
+export type ControlSurface = 'cell' | 'detail' | 'create';
+export interface ControlContext {
+    field: FieldConfig;
+    value: unknown;
+    item: WorkItem;
+    surface: ControlSurface;
+    readonly: boolean;
+    openDetail: (id: string) => void;
+}
+export interface ControlEditor {
+    element: HTMLElement;
+    read: () => unknown;
+    validate?: () => string | undefined;
+    focus?: () => void;
+    destroy?: () => void;
+}
+/** Definitions are scoped to a page. Return fresh DOM for each mount. */
+export interface FieldControl {
+    id: string;
+    label: string;
+    description: string;
+    glyph: string;
+    action?: 'edit' | 'select' | 'view';
+    render: (context: ControlContext) => HTMLElement;
+    createEditor: (context: ControlContext) => ControlEditor;
+}
+export declare function createControlRegistry(custom?: FieldControl[]): {
+    register: (control: FieldControl) => void;
+    list: () => FieldControl[];
+    resolve: (field: FieldConfig) => FieldControl;
+};

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

@@ -0,0 +1,3 @@
+import type { ControlContext, ControlEditor } from './controls';
+export declare function renderDate(context: ControlContext): HTMLElement;
+export declare function dateEditor(context: ControlContext): ControlEditor;

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

@@ -0,0 +1,72 @@
+import type { FieldConfig } from "./config";
+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: string[];
+    history: string[];
+}
+export declare const fields: readonly [readonly ["name", "选题概要"], readonly ["description", "选题描述"], readonly ["vote", "选题投票"], readonly ["showVotes", "是否展示投票结果"], readonly ["status", "状态"], readonly ["selectedTopic", "确定入选"], readonly ["format", "内容形式"], readonly ["approved", "选题是否通过"], readonly ["category", "主题分类"], readonly ["owner", "当前负责人"], readonly ["space", "所属空间"], readonly ["created", "创建时间"], readonly ["creator", "创建者"]];
+export type Field = string;
+export declare const statuses: string[];
+export declare const categories: string[];
+export declare const formats: string[];
+export declare const options: Partial<Record<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 declare const emptyView: () => ViewState;
+export declare const storageKey = "rowvia:work-items:v2";
+export declare const names: string[];
+export declare const seed: WorkItem[];
+export declare function matches(item: WorkItem, rules: Rule[]): 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 declare function loadData(key?: string, initialItems?: WorkItem[]): {
+    items: WorkItem[];
+    views: SavedView[];
+    drafts: WorkItem[];
+    customFields: FieldConfig[];
+};

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

@@ -0,0 +1,23 @@
+import { type FieldControl } from "./controls";
+import { type ColumnState } from "rowvia";
+import { type WorkItem, type Rule } from "./model";
+import type { WorkItemPageConfig } from "./config";
+export declare function createWorkItemPage(config: WorkItemPageConfig): {
+    registerControl: (control: FieldControl) => void;
+    getControls: () => FieldControl[];
+    api: import("rowvia").GridApi;
+    columnApi: import("rowvia").ColumnApi;
+    getViewState: () => {
+        columns: ColumnState[];
+        filters: Rule[];
+        sorts: {
+            colId: string;
+            sort: "asc" | "desc";
+        }[];
+        groups: string[];
+        colors: import("rowvia").ColorRule[];
+        showTerminated: boolean;
+    };
+    getItems: () => WorkItem[];
+    destroy: () => void;
+};

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

@@ -0,0 +1,4 @@
+import type { ControlContext, ControlEditor } from './controls';
+/** Preserve editor formatting while dropping executable content and untrusted attributes. */
+export declare function sanitizeRichText(value: unknown): string;
+export declare function richEditor(context: ControlContext): ControlEditor;

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

@@ -58,7 +58,7 @@ export declare class HeaderView {
     updateIndicators(): void;
     private headerColumnIndex;
     private layoutPositions;
-    setScrollLeft(left: number): void;
+    setScrollLeft(left: number, scrollbarWidth?: number): void;
     getHeaderCell(column: Column): HTMLElement | undefined;
     getHeaderRow(): HTMLElement;
 }

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

@@ -6,6 +6,8 @@ export interface RowRendererContext {
     options: GridOptions;
     eventService: EventService;
     rowModel: RowModel;
+    /** UI text lookup (localeText) */
+    t: (key: string) => string;
     getColumns: () => {
         left: Column[];
         center: Column[];
@@ -68,10 +70,11 @@ export declare class RowRenderer {
     private lastRange;
     private firstRendered;
     private heightVersion;
+    private scrollFrame;
     constructor(eRoot: HTMLElement, eHeader: HTMLElement, ctx: RowRendererContext);
     /**
-     * Forward wheel gestures from the non-scrollable sections (pinned column
-     * areas, sticky rows, floating rows, header) to the scrolling viewport.
+     * Apply wheel gestures to the shared viewport and pinned transforms in one
+     * handler, including gestures originating in the centre columns.
      */
     private onSectionWheel;
     private onBodyMouseOver;
@@ -112,6 +115,7 @@ export declare class RowRenderer {
     }): void;
     private rowCompKey;
     private findRowIndex;
+    private scheduleScrollRender;
     private onScroll;
     /** keep the pinned column sections aligned with the vertical scroll position */
     private syncPinnedScroll;
@@ -125,6 +129,7 @@ export declare class RowRenderer {
     getVerticalScrollTop(): number;
     setVerticalScrollTop(top: number): void;
     getHorizontalScrollLeft(): number;
+    getVerticalScrollbarWidth(): number;
     setHorizontalScrollLeft(left: number): void;
     /**
      * Re-renders the group rows that stick to the top of the viewport. A group
@@ -181,7 +186,6 @@ declare class RowComp {
     private updateCellContent;
     refreshCells(columns?: Column[], force?: boolean, flash?: boolean): void;
     appendTo(leftContainer: HTMLElement, centerContainer: HTMLElement, rightContainer: HTMLElement): void;
-    ensureVisibleCells(): void;
     setTop(top: number): void;
     getCenterElement(): HTMLElement | null;
     getCellElements(): HTMLElement[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rowvia",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "零运行时依赖的 TypeScript 数据表格、甘特图与人员排期组件库",
   "type": "module",
   "scripts": {
@@ -10,9 +10,11 @@
     "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",
+    "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: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"
+    "prepublishOnly": "npm run typecheck && npm test && npm run build:lib",
+    "test:pages": "node test/pages.mjs"
   },
   "devDependencies": {
     "esbuild": "^0.21.3",