@hufe921/canvas-editor 1.0.4 → 1.0.5

package/dist/src/editor/core/draw/Draw.d.ts

@@ -5,6 +5,7 @@ import { IMarkElementListDeletedOption } from '../../interface/Trace';
 import { IRow } from '../../interface/Row';
 import { IColumnLayout, IColumnOption } from '../../interface/Column';
 import { ColumnManager } from './column/ColumnManager';
+import { IncrementalRowComputer } from './IncrementalRowComputer';
 import { Cursor } from '../cursor/Cursor';
 import { CanvasEvent } from '../event/CanvasEvent';
 import { GlobalEvent } from '../event/GlobalEvent';
@@ -131,6 +132,9 @@ export declare class Draw {
     private LETTER_REG;
     private WORD_LIKE_REG;
     private rowList;
+    private rawRowList;
+    private incrementalRowComputer;
+    private isElementListTruncated;
     private pageRowList;
     private pageDirectionList;
     private painterStyle;
@@ -232,12 +236,18 @@ export declare class Draw {
     getTableElementList(sourceElementList: IElement[]): IElement[];
     getElementList(): IElement[];
     getMainElementList(): IElement[];
+    getRawRowList(): IRow[];
+    getIncrementalRowComputer(): IncrementalRowComputer;
+    getIsElementListTruncated(): boolean;
+    getIsControlMinWidthPlaceholder(): boolean;
     getOriginalElementList(): IElement[];
     getOriginalMainElementList(): IElement[];
     getFooterElementList(): IElement[];
     getTd(): ITd | null;
     insertElementList(payload: IElement[], options?: IInsertElementListOption): void;
     appendElementList(elementList: IElement[], options?: IAppendElementListOption): void;
+    setElementProperty(elementList: IElement | IElement[], properties: Partial<IElement>): void;
+    deleteElementProperty(elementList: IElement | IElement[], keys: (keyof IElement)[]): void;
     spliceElementList(elementList: IElement[], start: number, deleteCount: number, items?: IElement[], options?: ISpliceElementListOption): void;
     getCanvasEvent(): CanvasEvent;
     getGlobalEvent(): GlobalEvent;

package/dist/src/editor/core/draw/IncrementalRowComputer.d.ts

@@ -0,0 +1,43 @@
+import type { IComputeRange, IComputeRowListPayload, IIncrementalRowListResult } from '../../interface/Draw';
+import type { IElement } from '../../interface/Element';
+import type { IRow, IRowComputeState } from '../../interface/Row';
+import type { Draw } from './Draw';
+/**
+ * 行级增量行计算器。
+ *
+ * 行边界是断行依赖链的重置点（行首 x 由容器状态决定），因此编辑只需从受影响行
+ * 断点续算，与某个旧行结构状态收敛即停（通常 1~3 行），其后旧行原样复用。
+ * y/pageNo 等位置状态不影响行内容，过期快照依然安全。
+ *
+ * 门控不满足时返回 null，调用方退回全量，行为与未开启时一致。
+ */
+export declare class IncrementalRowComputer {
+    private draw;
+    private readonly snapshotMap;
+    private lastLayoutSignature;
+    private dirtyElementList;
+    private dirtyStartIndex;
+    private dirtyEndIndex;
+    private isLayoutDirty;
+    constructor(draw: Draw);
+    recordSnapshot(row: IRow, snapshot: IRowComputeState, firstElement?: IElement): void;
+    /**
+     * 记录主文档元素列表的一次修改区间（脏区间，增量续算提示）。
+     * splice/delete 助手自动记录；少数直接 splice 的场景需显式调用。
+     */
+    markRangeDirty(elementList: IElement[], start: number, deleteCount: number, insertCount: number): void;
+    markFullDirty(): void;
+    consumeDirtyRange(): IComputeRange | undefined;
+    findPageNoOfRow(row: IRow): number | undefined;
+    /**
+     * 尝试增量计算。成功返回合并后的行列表与首个变动行
+     * （拆分跨页表格前的原始行列表），失败返回 null（调用方走全量）。
+     */
+    tryCompute(range: IComputeRange | undefined, payload: IComputeRowListPayload): IIncrementalRowListResult | null;
+    observeLayout(): void;
+    private getLayoutSignature;
+    private _findRowIndexOfElement;
+    private _isComplexElement;
+    private _isStructuralEqual;
+    private static readonly MAX_CASCADE_ELEMENT;
+}

package/dist/src/editor/core/position/Position.d.ts

@@ -1,4 +1,4 @@
-import { IComputePageRowPositionPayload, IComputePageRowPositionResult, IComputeRowPositionPayload, IFloatPosition, IGetFloatPositionByXYPayload, ISetSurroundPositionPayload } from '../../interface/Position';
+import { IComputePageRowPositionPayload, IComputePageRowPositionResult, IComputePositionListPayload, IComputeRowPositionPayload, IFloatPosition, IGetFloatPositionByXYPayload, ISetSurroundPositionPayload } from '../../interface/Position';
 import { IElement, IElementPosition } from '../../interface/Element';
 import { ITd } from '../../interface/table/Td';
 import { ICurrentPosition, IGetPositionByXYPayload, IPositionContext } from '../../interface/Position';
@@ -10,6 +10,7 @@ export declare class Position {
     private tablePagingPositionList;
     private tablePagingPositionMap;
     private floatPositionList;
+    private pagePositionCacheList;
     private draw;
     private eventBus;
     private options;
@@ -37,7 +38,7 @@ export declare class Position {
     };
     computePageRowPosition(payload: IComputePageRowPositionPayload): IComputePageRowPositionResult;
     private _offsetTdPositionByVerticalAlign;
-    computePositionList(): void;
+    computePositionList(payload?: IComputePositionListPayload): void;
     computeRowPosition(payload: IComputeRowPositionPayload): IElementPosition[];
     setCursorPosition(position: IElementPosition | null): void;
     getCursorPosition(): IElementPosition | null;

package/dist/src/editor/interface/Control.d.ts

@@ -77,6 +77,10 @@ export interface IControlBasic {
     cascade?: IControlCascadeRule[];
     validation?: IControlValidation;
     compute?: string;
+    activeBackgroundColor?: string;
+    disabledBackgroundColor?: string;
+    existValueBackgroundColor?: string;
+    noValueBackgroundColor?: string;
 }
 export interface IControlStyle {
     font?: string;

package/dist/src/editor/interface/Draw.d.ts

@@ -1,7 +1,7 @@
 import { ImageDisplay } from '../dataset/enum/Common';
 import { EditorMode, EditorZone } from '../dataset/enum/Editor';
 import { IElement, IElementPosition } from './Element';
-import { IRow } from './Row';
+import { IRow, IRowComputeState, IRowElement } from './Row';
 export interface IDrawOption {
     curIndex?: number;
     isSetCursor?: boolean;
@@ -12,6 +12,10 @@ export interface IDrawOption {
     isSourceHistory?: boolean;
     isFirstRender?: boolean;
 }
+export interface IComputeRange {
+    startIndex: number;
+    endIndex: number;
+}
 export interface IForceUpdateOption {
     isSubmitHistory?: boolean;
 }
@@ -72,4 +76,21 @@ export interface IComputeRowListPayload {
     isPagingMode?: boolean;
     pageHeight?: number;
     surroundElementList?: IElement[];
+    /**
+     * 断点续算：从 state 对应的行首元素（startIndex）重新参与断行，
+     * 到与某个旧行状态收敛（converge 返回 true）或文档末尾即止，
+     * 收敛点之后的旧行对象可原样复用。
+     */
+    resume?: IComputeRowListResume;
+}
+export interface IComputeRowListResume {
+    startIndex: number;
+    state: IRowComputeState;
+    preRowLastElement?: IRowElement;
+    shouldAbort?: (element: IElement, index: number) => boolean;
+    converge?: (state: IRowComputeState, firstElement: IElement, startIndex: number) => boolean;
+}
+export interface IIncrementalRowListResult {
+    rowList: IRow[];
+    firstChangedRow: IRow;
 }

package/dist/src/editor/interface/Editor.d.ts

@@ -34,6 +34,14 @@ import { ITraceOption } from './Trace';
 import { IRulerOption } from './Ruler';
 import { IHintOption } from './Hint';
 import type { ISpellcheckOption } from './Spellcheck';
+export interface ILabOption {
+    /**
+     * 行级增量行计算：编辑时仅从受影响行断点续算，区间外行复用。
+     * 复杂结构（表格/控件/浮动图/分栏/minWidth 控件占位等）自动退化全量。
+     * 默认：false
+     */
+    incrementalCompute?: boolean;
+}
 export interface IEditorData {
     header?: IElement[];
     main: IElement[];
@@ -86,6 +94,7 @@ export interface IEditorOption {
     scrollContainerSelector?: string;
     pageOuterSelectionDisable?: boolean;
     wordBreak?: WordBreak;
+    lab?: ILabOption;
     table?: ITableOption;
     header?: IHeader;
     footer?: IFooter;

package/dist/src/editor/interface/Position.d.ts

@@ -88,6 +88,9 @@ export interface IComputePageRowPositionResult {
     y: number;
     index: number;
 }
+export interface IComputePositionListPayload {
+    fromPageNo?: number;
+}
 export interface IFloatPosition {
     pageNo: number;
     element: IElement;

package/dist/src/editor/interface/Row.d.ts

@@ -1,6 +1,7 @@
 import { PaperDirection } from '../dataset/enum/Editor';
 import { RowFlex } from '../dataset/enum/Row';
 import { IElement, IElementMetrics, IElementPosition, ITableRowFragment } from './Element';
+import { IMargin } from './Margin';
 import { ITd } from './table/Td';
 export type IRowElement = IElement & {
     metrics: IElementMetrics;
@@ -31,3 +32,18 @@ export interface IRow {
         positionList: IElementPosition[];
     }[];
 }
+export interface IRowComputeState {
+    rowIndex: number;
+    x: number;
+    y: number;
+    pageNo: number;
+    pageStartY: number;
+    direction: PaperDirection;
+    margins: IMargin;
+    innerWidth: number;
+    startX: number;
+    pageHeight: number;
+    column: number;
+    controlRealWidth: number;
+    listIndexMap: Map<string, number>;
+}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@hufe921/canvas-editor",
   "author": "Hufe",
   "license": "MIT",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "A Canvas/SVG-based rich text editor",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -51,21 +51,21 @@
     "@eslint/js": "^10.0.1",
     "@rollup/plugin-typescript": "^12.3.0",
     "@types/jsdom": "^28.0.3",
-    "@types/node": "^24.13.6",
+    "@types/node": "^24.19.1",
     "@types/prismjs": "^1.26.6",
-    "@typescript-eslint/eslint-plugin": "^8.70.1",
-    "@typescript-eslint/parser": "^8.70.1",
+    "@typescript-eslint/eslint-plugin": "^8.71.1",
+    "@typescript-eslint/parser": "^8.71.1",
     "@vitest/coverage-v8": "^4.1.11",
     "cypress": "^15.21.1",
     "cypress-file-upload": "^5.0.8",
-    "eslint": "^10.11.0",
-    "globals": "^17.12.0",
+    "eslint": "^10.12.0",
+    "globals": "^17.13.0",
     "jsdom": "^29.1.1",
     "simple-git-hooks": "^2.14.0",
     "tslib": "^2.8.1",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.70.1",
-    "vite": "^8.3.0",
+    "typescript-eslint": "^8.71.1",
+    "vite": "^8.3.3",
     "vite-plugin-css-injected-by-js": "^5.0.1",
     "vitepress": "^1.6.4",
     "vitest": "^4.1.11",