@hufe921/canvas-editor 0.9.137 → 1.0.1

package/dist/src/editor/core/draw/ruler/Ruler.d.ts

@@ -0,0 +1,43 @@
+import { Draw } from '../Draw';
+export declare class Ruler {
+    private readonly MM_PX;
+    private readonly HANDLE_HIT_TOLERANCE;
+    private readonly MIN_INNER_SIZE;
+    private draw;
+    private options;
+    private container;
+    private rulerContainer;
+    private canvasX;
+    private ctxX;
+    private canvasY;
+    private ctxY;
+    private dragSide;
+    private dragStartPosition;
+    private dragOriginMargins;
+    private mousemoveHandler;
+    private mouseupHandler;
+    constructor(draw: Draw);
+    isEnable(): boolean;
+    private _createDOM;
+    setEnabled(enabled: boolean): void;
+    dispose(): void;
+    render(): void;
+    private _renderX;
+    private _renderY;
+    private _drawXHandle;
+    private _drawYHandle;
+    private _getHitMarginSideX;
+    private _getHitMarginSideY;
+    private _getRelativeX;
+    private _getRelativeY;
+    private _isMarginDragDisabled;
+    private _startDrag;
+    private _mousedownX;
+    private _mousedownY;
+    private _updateCursorX;
+    private _updateCursorY;
+    private _dragMargin;
+    private _stopDrag;
+    clampMargin(value: number, max: number): number;
+    private _setDisplayedMargins;
+}

package/dist/src/editor/core/event/GlobalEvent.d.ts

@@ -9,6 +9,7 @@ export declare class GlobalEvent {
     private previewer;
     private tableTool;
     private hyperlinkParticle;
+    private hintParticle;
     private control;
     private magnifier;
     private dateParticle;

package/dist/src/editor/core/macro/MacroManager.d.ts

@@ -0,0 +1,25 @@
+import type { Command } from '../command/Command';
+import type { IMacro, IRecordedMacro, IScriptMacro, IMacroHandler } from '../../interface/Macro';
+export declare class MacroManager {
+    private macros;
+    private recording;
+    private isPlaying;
+    private command;
+    constructor(command: Command);
+    isRecording(): boolean;
+    startRecording(): void;
+    stopRecording(name: string): IRecordedMacro | null;
+    cancelRecording(): void;
+    play(idOrName: string, ...args: unknown[]): Promise<void>;
+    getMacros(): IMacro[];
+    getMacro(idOrName: string): IMacro | undefined;
+    removeMacro(idOrName: string): boolean;
+    exportMacros(): string;
+    importMacros(json: string, options?: {
+        overwrite?: boolean;
+    }): void;
+    register(name: string, handler: IMacroHandler): IScriptMacro;
+    unregister(idOrName: string): boolean;
+    private findMacro;
+    private logStep;
+}

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

@@ -1,19 +1,24 @@
 import { IComputePageRowPositionPayload, IComputePageRowPositionResult, 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';
 import { Draw } from '../draw/Draw';
 export declare class Position {
     private cursorPosition;
     private positionContext;
     private positionList;
+    private tablePagingPositionList;
+    private tablePagingPositionMap;
     private floatPositionList;
     private draw;
     private eventBus;
     private options;
     constructor(draw: Draw);
     getFloatPositionList(): IFloatPosition[];
+    getTablePagingPositionList(): IElementPosition[];
+    getTableFragmentPosition(index: number, pageNo: number, anchorPosition?: IElementPosition | null): IElementPosition | null;
     getTablePositionList(sourceElementList: IElement[]): IElementPosition[];
-    getTableTdByContext(sourceElementList: IElement[], context: IPositionContext): import("../../interface/table/Td").ITd | null;
+    getTableTdByContext(sourceElementList: IElement[], context: IPositionContext): ITd | null;
     buildTablePositionContext(context: IPositionContext, element: IElement, trIndex: number, tdIndex: number): IPositionContext;
     getTableElementByContext(sourceElementList: IElement[], context: IPositionContext): IElement | null;
     getTableElementPositionByContext(sourceElementList: IElement[], sourcePositionList: IElementPosition[], context: IPositionContext): IElementPosition | null;
@@ -31,6 +36,7 @@ export declare class Position {
         y: number;
     };
     computePageRowPosition(payload: IComputePageRowPositionPayload): IComputePageRowPositionResult;
+    private _offsetTdPositionByVerticalAlign;
     computePositionList(): void;
     computeRowPosition(payload: IComputeRowPositionPayload): IElementPosition[];
     setCursorPosition(position: IElementPosition | null): void;
@@ -38,6 +44,7 @@ export declare class Position {
     getPositionContext(): IPositionContext;
     setPositionContext(payload: IPositionContext): void;
     private _getColumnIndexByX;
+    private _getTableChildPositionByXY;
     getPositionByXY(payload: IGetPositionByXYPayload): ICurrentPosition;
     getFloatPositionByXY(payload: IGetFloatPositionByXYPayload): ICurrentPosition | void;
     adjustPositionContext(payload: IGetPositionByXYPayload): ICurrentPosition | null;

package/dist/src/editor/core/validate/Validate.d.ts

@@ -0,0 +1,19 @@
+import { IControlValidateResult, IValidateOption } from '../../interface/Control';
+import { Draw } from '../draw/Draw';
+export declare class Validate {
+    private draw;
+    private control;
+    private i18n;
+    private highlightedControlIds;
+    private lastErrorBackgroundColor;
+    constructor(draw: Draw);
+    private collectControlElements;
+    private getNormalizedValue;
+    private isHidden;
+    private t;
+    private validateControl;
+    private walkAllControlElements;
+    private applyHighlight;
+    clearHighlight(): void;
+    execute(payload?: IValidateOption): IControlValidateResult[];
+}

package/dist/src/editor/dataset/constant/ContextMenu.d.ts

@@ -56,5 +56,7 @@ export declare const INTERNAL_CONTEXT_MENU_KEY: {
         DELETE_TABLE: string;
         MERGE_CELL: string;
         CANCEL_MERGE_CELL: string;
+        AUTO_FIT_TO_CONTENT: string;
+        AUTO_FIT_TO_PAGE: string;
     };
 };

package/dist/src/editor/dataset/constant/Element.d.ts

@@ -4,6 +4,8 @@ import { ITd } from '../../interface/table/Td';
 import { IControlStyle } from '../../interface/Control';
 export declare const EDITOR_ELEMENT_STYLE_ATTR: Array<keyof IElement>;
 export declare const EDITOR_ROW_ATTR: Array<keyof IElement>;
+export declare const EDITOR_TRACE_ATTR: Array<keyof IElement>;
+export declare const EDITOR_HINT_ATTR: Array<keyof IElement>;
 export declare const EDITOR_ELEMENT_PARAGRAPH_STYLE_ATTR: Array<keyof IElement>;
 export declare const EDITOR_ELEMENT_COPY_ATTR: Array<keyof IElement>;
 export declare const EDITOR_ELEMENT_ZIP_ATTR: Array<keyof IElement>;

package/dist/src/editor/dataset/constant/Hint.d.ts

@@ -0,0 +1,2 @@
+import { IHintOption } from '../../interface/Hint';
+export declare const defaultHintOption: Readonly<Required<IHintOption>>;

package/dist/src/editor/dataset/constant/Ruler.d.ts

@@ -0,0 +1,2 @@
+import { IRulerOption } from '../../interface/Ruler';
+export declare const defaultRulerOption: Readonly<Required<IRulerOption>>;

package/dist/src/editor/dataset/constant/Trace.d.ts

@@ -0,0 +1,2 @@
+import { ITraceOption } from '../../interface/Trace';
+export declare const defaultTraceOption: Readonly<Required<ITraceOption>>;

package/dist/src/editor/dataset/enum/Editor.d.ts

@@ -19,7 +19,8 @@ export declare enum EditorMode {
     FORM = "form",// 表单模式（仅控件内可编辑）
     PRINT = "print",// 打印模式（文档不可编辑、隐藏辅助元素、选区、未书写控件及边框）
     DESIGN = "design",// 设计模式（不可删除、只读等配置不控制）
-    GRAFFITI = "graffiti"
+    GRAFFITI = "graffiti",// 涂鸦模式（屏蔽选区、允许长按移动绘制线条）
+    TRACE = "trace"
 }
 export declare enum EditorZone {
     HEADER = "header",

package/dist/src/editor/dataset/enum/Macro.d.ts

@@ -0,0 +1,4 @@
+export declare enum MacroType {
+    RECORDED = "recorded",
+    SCRIPT = "script"
+}

package/dist/src/editor/dataset/enum/Trace.d.ts

@@ -0,0 +1,4 @@
+export declare enum TraceType {
+    INSERTED = "inserted",
+    DELETED = "deleted"
+}

package/dist/src/editor/index.d.ts

@@ -15,6 +15,7 @@ import { ControlComponent, ControlIndentation, ControlState, ControlType } from
 import { INavigateInfo } from './core/draw/interactive/Search';
 import { KeyMap } from './dataset/enum/KeyMap';
 import { BlockType } from './dataset/enum/Block';
+import { MacroType } from './dataset/enum/Macro';
 import { IBlock } from './interface/Block';
 import { ILang } from './interface/i18n/I18n';
 import { VerticalAlign } from './dataset/enum/VerticalAlign';
@@ -24,6 +25,7 @@ import { TitleLevel } from './dataset/enum/Title';
 import { ListStyle, ListType } from './dataset/enum/List';
 import { ICatalog, ICatalogItem } from './interface/Catalog';
 import { UsePlugin } from './interface/Plugin';
+import { MacroManager } from './core/macro/MacroManager';
 import { EventBus } from './core/event/eventbus/EventBus';
 import { EventBusMap } from './interface/EventBus';
 import { IRangeStyle } from './interface/Listener';
@@ -49,9 +51,10 @@ export default class Editor {
     register: Register;
     destroy: () => void;
     use: UsePlugin;
+    macro: MacroManager;
     constructor(container: HTMLDivElement, data: IEditorData | IElement[], options?: IEditorOption);
 }
 export { splitText, createDomFromElementList, getElementListByHTML, getTextFromElementList };
 export { EDITOR_COMPONENT, LETTER_CLASS, INTERNAL_CONTEXT_MENU_KEY, INTERNAL_SHORTCUT_KEY, EDITOR_CLIPBOARD };
-export { Editor, RowFlex, VerticalAlign, EditorZone, EditorMode, ElementType, ControlType, EditorComponent, PageMode, RenderMode, ImageDisplay, Command, KeyMap, BlockType, PaperDirection, TableBorder, TdBorder, TdSlash, MaxHeightRatio, NumberType, TitleLevel, ListType, ListStyle, WordBreak, ControlIndentation, ControlComponent, BackgroundRepeat, BackgroundSize, TextDecorationStyle, LineNumberType, LocationPosition, AreaMode, ControlState, FlexDirection, WatermarkType, WatermarkLayer };
+export { Editor, RowFlex, VerticalAlign, EditorZone, EditorMode, ElementType, ControlType, EditorComponent, PageMode, RenderMode, ImageDisplay, Command, KeyMap, BlockType, MacroType, PaperDirection, TableBorder, TdBorder, TdSlash, MaxHeightRatio, NumberType, TitleLevel, ListType, ListStyle, WordBreak, ControlIndentation, ControlComponent, BackgroundRepeat, BackgroundSize, TextDecorationStyle, LineNumberType, LocationPosition, AreaMode, ControlState, FlexDirection, WatermarkType, WatermarkLayer };
 export type { IElement, IEditorData, IEditorOption, IEditorResult, IContextMenuContext, IRegisterContextMenu, IWatermark, INavigateInfo, IBlock, ILang, ICatalog, ICatalogItem, IRange, IRangeStyle, IBadge, IGetElementListByHTMLOption };

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

@@ -0,0 +1,5 @@
+import { IElement } from './Element';
+export interface IComparePayload {
+    oldData: IElement[];
+    newData?: IElement[];
+}

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

@@ -56,6 +56,7 @@ export interface IControlRule {
     disabled?: boolean;
     pasteDisabled?: boolean;
     hide?: boolean;
+    required?: boolean;
 }
 export interface IControlBasic {
     type: ControlType;
@@ -73,6 +74,9 @@ export interface IControlBasic {
     rowFlex?: RowFlex;
     preText?: string;
     postText?: string;
+    cascade?: IControlCascadeRule[];
+    validation?: IControlValidation;
+    compute?: string;
 }
 export interface IControlStyle {
     font?: string;
@@ -94,6 +98,7 @@ export interface IControlOption {
     disabledBackgroundColor?: string;
     existValueBackgroundColor?: string;
     noValueBackgroundColor?: string;
+    errorBackgroundColor?: string;
 }
 export interface IControlInitOption {
     index: number;
@@ -196,3 +201,44 @@ export interface IRemoveControlOption {
     id?: string;
     conceptId?: string;
 }
+export type CascadeTargetType = 'control' | 'title';
+export interface ICascadeAction {
+    controlId?: string;
+    conceptId?: string;
+    targetType?: CascadeTargetType;
+    effects: {
+        hide?: boolean;
+        required?: boolean;
+        disabled?: boolean;
+        deletable?: boolean;
+    };
+}
+export interface IControlCascadeRule {
+    expression: string;
+    actions: ICascadeAction[];
+    elseActions?: ICascadeAction[];
+}
+export interface IControlValidation {
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    min?: number;
+    max?: number;
+    integer?: boolean;
+    precision?: number;
+    minDate?: string;
+    maxDate?: string;
+    minChecked?: number;
+    maxChecked?: number;
+    message?: string;
+}
+export interface IValidateOption {
+    zone?: EditorZone;
+    errorBackgroundColor?: string;
+}
+export interface IControlValidateResult {
+    controlId: string;
+    conceptId?: string;
+    control: IControl;
+    errors: string[];
+}

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

@@ -34,6 +34,7 @@ export interface IDrawRowPayload {
     zone?: EditorZone;
     isDrawLineBreak?: boolean;
     isDrawWhiteSpace?: boolean;
+    isDrawRange?: boolean;
 }
 export interface IDrawFloatPayload {
     pageNo: number;

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

@@ -30,6 +30,9 @@ import { IGraffitiData, IGraffitiOption } from './Graffiti';
 import { IWhiteSpaceOption } from './WhiteSpace';
 import { IMagnifierOption } from './Magnifier';
 import { IAccessibilityOption } from './Accessibility';
+import { ITraceOption } from './Trace';
+import { IRulerOption } from './Ruler';
+import { IHintOption } from './Hint';
 export interface IEditorData {
     header?: IElement[];
     main: IElement[];
@@ -110,6 +113,9 @@ export interface IEditorOption {
     magnifier?: IMagnifierOption;
     accessibility?: IAccessibilityOption;
     column?: IColumnOption;
+    trace?: ITraceOption;
+    ruler?: IRulerOption;
+    hint?: IHintOption;
 }
 export interface IEditorResult {
     version: string;
@@ -136,7 +142,6 @@ export interface IPrintModeRule {
     imagePreviewerDisabled?: boolean;
     backgroundDisabled?: boolean;
     filterEmptyControl?: boolean;
-    filterHideElementRow?: boolean;
     areaHideDisabled?: boolean;
 }
 export interface IReadonlyModeRule {

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

@@ -1,6 +1,8 @@
 import { ImageDisplay } from '../dataset/enum/Common';
 import { ControlComponent } from '../dataset/enum/Control';
+import { PaperDirection } from '../dataset/enum/Editor';
 import { ElementType } from '../dataset/enum/Element';
+import { TraceType } from '../dataset/enum/Trace';
 import { ListStyle, ListType } from '../dataset/enum/List';
 import { RowFlex } from '../dataset/enum/Row';
 import { TitleLevel } from '../dataset/enum/Title';
@@ -14,6 +16,7 @@ import { IRadio } from './Radio';
 import { ITextDecoration } from './Text';
 import { ITitle } from './Title';
 import { IColgroup } from './table/Colgroup';
+import { ITd } from './table/Td';
 import { ITr } from './table/Tr';
 export interface IElementBasic {
     id?: string;
@@ -21,6 +24,7 @@ export interface IElementBasic {
     value: string;
     extension?: unknown;
     externalId?: string;
+    hint?: string;
 }
 export interface IElementStyle {
     font?: string;
@@ -46,6 +50,14 @@ export interface IElementRule {
 export interface IElementGroup {
     groupIds?: string[];
 }
+export interface ITraceRecord {
+    type: TraceType;
+    author?: string;
+    timestamp?: number;
+}
+export interface IElementTrace {
+    trace?: ITraceRecord[];
+}
 export interface ITitleElement {
     valueList?: IElement[];
     level?: TitleLevel;
@@ -58,6 +70,7 @@ export interface IListElement {
     listStyle?: ListStyle;
     listId?: string;
     listWrap?: boolean;
+    listLevel?: number;
 }
 export interface ITableAttr {
     colgroup?: IColgroup[];
@@ -76,8 +89,6 @@ export interface ITableElement {
     trId?: string;
     tableId?: string;
     conceptId?: string;
-    pagingId?: string;
-    pagingIndex?: number;
 }
 export type ITable = ITableAttr & ITableRule & ITableElement;
 export interface IHyperlinkElement {
@@ -166,7 +177,10 @@ export interface ILabelElement {
         padding?: IPadding;
     };
 }
-export type IElement = IElementBasic & IElementStyle & IElementRule & IElementGroup & ITable & IHyperlinkElement & ISuperscriptSubscript & ISeparator & IControlElement & ICheckboxElement & IRadioElement & ILaTexElement & IDateElement & IImageElement & IBlockElement & ITitleElement & IListElement & IAreaElement & ILabelElement;
+export interface IPageBreakElement {
+    paperDirection?: PaperDirection;
+}
+export type IElement = IElementBasic & IElementStyle & IElementRule & IElementGroup & IElementTrace & ITable & IHyperlinkElement & ISuperscriptSubscript & ISeparator & IControlElement & ICheckboxElement & IRadioElement & ILaTexElement & IDateElement & IImageElement & IBlockElement & ITitleElement & IListElement & IAreaElement & ILabelElement & IPageBreakElement;
 export interface IElementMetrics {
     width: number;
     height: number;
@@ -186,6 +200,7 @@ export interface IElementPosition {
     isFirstLetter: boolean;
     isLastLetter: boolean;
     columnIndex?: number;
+    tableFragment?: ITableRowFragment;
     coordinate: {
         leftTop: number[];
         leftBottom: number[];
@@ -193,6 +208,16 @@ export interface IElementPosition {
         rightBottom: number[];
     };
 }
+export interface ITableRowFragment {
+    startTrIndex: number;
+    endTrIndex: number;
+    skipHeight: number;
+    repeatHeight: number;
+    repeatTrIndexes?: number[];
+    startSplitTrOffset?: number;
+    endSplitTrHeight?: number;
+    carriedTds?: ITd[];
+}
 export interface IElementFillRect {
     x: number;
     y: number;

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

@@ -0,0 +1,7 @@
+export interface IHintOption {
+    disabled?: boolean;
+    backgroundColor?: string;
+    color?: string;
+    fontSize?: number;
+    maxWidth?: number;
+}

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

@@ -0,0 +1,19 @@
+import { MacroType } from '../dataset/enum/Macro';
+export interface IMacroStep {
+    command: string;
+    args: unknown[];
+}
+export interface IRecordedMacro {
+    id: string;
+    name: string;
+    type: MacroType.RECORDED;
+    steps: IMacroStep[];
+}
+export type IMacroHandler = (...args: unknown[]) => void | Promise<void>;
+export interface IScriptMacro {
+    id: string;
+    name: string;
+    type: MacroType.SCRIPT;
+    handler: IMacroHandler;
+}
+export type IMacro = IRecordedMacro | IScriptMacro;

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

@@ -1,5 +1,7 @@
+import { PaperDirection } from '../dataset/enum/Editor';
 import { RowFlex } from '../dataset/enum/Row';
-import { IElement, IElementMetrics } from './Element';
+import { IElement, IElementMetrics, IElementPosition, ITableRowFragment } from './Element';
+import { ITd } from './table/Td';
 export type IRowElement = IElement & {
     metrics: IElementMetrics;
     style: string;
@@ -12,6 +14,7 @@ export interface IRow {
     rowFlex?: RowFlex;
     startIndex: number;
     isPageBreak?: boolean;
+    paperDirection?: PaperDirection;
     isList?: boolean;
     listIndex?: number;
     offsetX?: number;
@@ -21,4 +24,10 @@ export interface IRow {
     rowIndex: number;
     isSurround?: boolean;
     columnIndex?: number;
+    tableFragment?: ITableRowFragment;
+    fragmentPosition?: IElementPosition;
+    repeatTdPositionList?: {
+        td: ITd;
+        positionList: IElementPosition[];
+    }[];
 }

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

@@ -0,0 +1,4 @@
+export interface IRulerOption {
+    disabled?: boolean;
+    height?: number;
+}

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

@@ -0,0 +1,11 @@
+export interface ITraceOption {
+    disabled?: boolean;
+    insertColor?: string;
+    deleteColor?: string;
+    author?: string;
+    lineWidth?: number;
+}
+export interface IMarkElementListDeletedOption {
+    isIgnoreDeletedRule?: boolean;
+    tdDeletable?: boolean;
+}

package/dist/src/editor/interface/i18n/I18n.d.ts

@@ -1,8 +1,12 @@
 import { IDatePickerLang } from '../../core/draw/particle/date/DatePicker';
 import { IContextmenuLang } from '../contextmenu/ContextMenu';
 import { IAccessibilityLang } from './Accessibility';
+import { ITraceLang } from './Trace';
+import { IValidateLang } from './Validate';
 export interface ILang {
     contextmenu: IContextmenuLang;
     datePicker: IDatePickerLang;
     accessibility: IAccessibilityLang;
+    trace: ITraceLang;
+    validate: IValidateLang;
 }

package/dist/src/editor/interface/i18n/Trace.d.ts

@@ -0,0 +1,7 @@
+export interface ITraceLang {
+    insert: string;
+    delete: string;
+    author: string;
+    time: string;
+    unknownAuthor: string;
+}

package/dist/src/editor/interface/i18n/Validate.d.ts

@@ -0,0 +1,15 @@
+export interface IValidateLang {
+    required: string;
+    minLength: string;
+    maxLength: string;
+    pattern: string;
+    invalidNumber: string;
+    min: string;
+    max: string;
+    integer: string;
+    precision: string;
+    minDate: string;
+    maxDate: string;
+    minChecked: string;
+    maxChecked: string;
+}

package/dist/src/editor/interface/table/Td.d.ts

@@ -32,4 +32,5 @@ export interface ITd {
     realMinHeight?: number;
     disabled?: boolean;
     deletable?: boolean;
+    hint?: string;
 }

package/dist/src/editor/utils/diff.d.ts

@@ -0,0 +1,7 @@
+import { IElement } from '../interface/Element';
+export interface IDiffOp {
+    type: 'equal' | 'insert' | 'delete';
+    value: string;
+}
+export declare function diffText(oldText: string, newText: string): IDiffOp[];
+export declare function compareElementList(oldList: IElement[], newList: IElement[]): IElement[];

package/dist/src/editor/utils/element.d.ts

@@ -3,6 +3,9 @@ import { RowFlex } from '../dataset/enum/Row';
 import { DeepRequired } from '../interface/Common';
 import { IEditorOption } from '../interface/Editor';
 import { IElement } from '../interface/Element';
+export declare function isElementTraceDeleted(element: IElement): boolean;
+export declare function getNonDeletedElementList(elementList: IElement[]): IElement[];
+export declare function getNonTraceElementList(elementList: IElement[]): IElement[];
 export declare function unzipElementList(elementList: IElement[]): IElement[];
 interface IFormatElementListOption {
     isHandleFirstElement?: boolean;
@@ -19,6 +22,7 @@ interface IZipElementListOption {
     extraPickAttrs?: Array<keyof IElement>;
     isClassifyArea?: boolean;
     isClone?: boolean;
+    isListValue?: boolean;
 }
 export declare function zipElementList(payload: IElement[], options?: IZipElementListOption): IElement[];
 export declare function convertTextAlignToRowFlex(node: HTMLElement): RowFlex;
@@ -47,11 +51,26 @@ export interface IGetElementListByHTMLOption {
     innerWidth: number;
 }
 export declare function getElementListByHTML(htmlText: string, options: IGetElementListByHTMLOption): IElement[];
-export declare function getTextFromElementList(elementList: IElement[]): string;
+export declare function getTextFromElementList(elementList: IElement[], options?: {
+    isClone?: boolean;
+}): string;
 export declare function getSlimCloneElementList(elementList: IElement[]): IElement[];
 export declare function getIsBlockElement(element?: IElement): boolean;
 export declare function replaceHTMLElementTag(oldDom: HTMLElement, tagName: keyof HTMLElementTagNameMap): HTMLElement;
 export declare function pickSurroundElementList(elementList: IElement[]): IElement[];
 export declare function deleteSurroundElementList(elementList: IElement[], pageNo: number): void;
-export declare function getNonHideElementIndex(elementList: IElement[], index: number, position?: LocationPosition): number;
+export declare function getNonHideElementIndex(elementList: IElement[], index: number, position?: LocationPosition, isHidden?: (element: IElement) => boolean): number;
+/**
+ * 嵌套感知的边界步进：从 index 按方向移动一位。
+ * 若落点 controlId 与 ownerId 相同，返回落点；
+ * 若落点 controlId 不同（进入了内层控件段），持续同向步进直到回到 ownerId 或越界。
+ * 用于替换边界扫描循环里的 i++ / i--。
+ */
+export declare function scanToOwner(elementList: IElement[], index: number, direction: 1 | -1, ownerId: string): number;
+/**
+ * 查找位置所属的最外层控件 controlId。
+ * 通过向左扫找到当前控件的 PREFIX，递归检查 PREFIX 前一位是否仍在另一控件段内。
+ */
+export declare function getOutermostOwner(elementList: IElement[], index: number): string | null;
+export declare function visitElementTree(elementList: IElement[], visitor: (element: IElement) => void): void;
 export {};

package/dist/src/editor/utils/print.d.ts

@@ -4,6 +4,7 @@ interface IPrintOption {
     width: number;
     height: number;
     direction?: PaperDirection;
+    pageDirections?: PaperDirection[];
     iframeInfoList?: IIframeInfo[][];
 }
 export declare function print(base64List: string[], options: IPrintOption): Promise<void>;

package/dist/src/editor/utils/table.d.ts

@@ -0,0 +1,4 @@
+import { IColgroup } from '../interface/table/Colgroup';
+export declare function getColgroupWidth(colgroup: IColgroup[]): number;
+export declare function shrinkColgroupToWidth(colgroup: IColgroup[], maxWidth: number, minWidth: number): void;
+export declare function scaleColgroupToWidth(colgroup: IColgroup[], targetWidth: number): void;