@hufe921/canvas-editor 1.0.0 → 1.0.1

package/dist/src/editor/core/command/Command.d.ts

@@ -81,6 +81,7 @@ export declare class Command {
     executePageScaleAdd: CommandAdapt['pageScaleAdd'];
     executePaperSize: CommandAdapt['paperSize'];
     executePaperDirection: CommandAdapt['paperDirection'];
+    executePageDirection: CommandAdapt['pageDirection'];
     executeSetPaperMargin: CommandAdapt['setPaperMargin'];
     executeSetMainBadge: CommandAdapt['setMainBadge'];
     executeSetAreaBadge: CommandAdapt['setAreaBadge'];

package/dist/src/editor/core/command/CommandAdapt.d.ts

@@ -146,6 +146,7 @@ export declare class CommandAdapt {
     pageScaleAdd(): void;
     paperSize(width: number, height: number): void;
     paperDirection(payload: PaperDirection): void;
+    pageDirection(payload: PaperDirection | null): void;
     getPaperMargin(): number[];
     setPaperMargin(payload: IMargin): void;
     setMainBadge(payload: IBadge | null): void;

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

@@ -21,6 +21,7 @@ import { TableParticle } from './particle/table/TableParticle';
 import { TableTool } from './particle/table/TableTool';
 import { Ruler } from './ruler/Ruler';
 import { HyperlinkParticle } from './particle/HyperlinkParticle';
+import { HintParticle } from './particle/HintParticle';
 import { TraceParticle } from './particle/TraceParticle';
 import { Header } from './frame/Header';
 import { SuperscriptParticle } from './particle/SuperscriptParticle';
@@ -101,6 +102,7 @@ export declare class Draw {
     private header;
     private footer;
     private hyperlinkParticle;
+    private hintParticle;
     private traceParticle;
     private labelParticle;
     private dateParticle;
@@ -128,6 +130,7 @@ export declare class Draw {
     private WORD_LIKE_REG;
     private rowList;
     private pageRowList;
+    private pageDirectionList;
     private painterStyle;
     private painterOptions;
     private visiblePageNoList;
@@ -153,21 +156,34 @@ export declare class Draw {
     setTraceEnabled(enabled: boolean): void;
     setRulerEnabled(enabled: boolean): void;
     deleteElementList(elementList: IElement[], index: number, count?: number, options?: IMarkElementListDeletedOption): IElement[];
-    getOriginalWidth(): number;
-    getOriginalHeight(): number;
-    getWidth(): number;
-    getHeight(): number;
+    getOriginalWidth(direction?: PaperDirection): number;
+    getOriginalHeight(direction?: PaperDirection): number;
+    getWidth(direction?: PaperDirection): number;
+    getHeight(direction?: PaperDirection): number;
     getMainHeight(): number;
-    getMainOuterHeight(pageNo?: number): number;
+    getMainOuterHeight(pageNo?: number, direction?: PaperDirection): number;
     getCanvasWidth(pageNo?: number): number;
     getCanvasHeight(pageNo?: number): number;
-    getInnerWidth(): number;
-    getColumnLayout(): IColumnLayout | null;
+    getInnerWidth(direction?: PaperDirection): number;
+    getColumnLayout(direction?: PaperDirection): IColumnLayout | null;
     setColumnConfig(config: IColumnOption | null): void;
     getOriginalInnerWidth(): number;
     getContextInnerWidth(): number;
-    getMargins(): IMargin;
-    getOriginalMargins(): number[];
+    getMargins(direction?: PaperDirection): IMargin;
+    getOriginalMargins(direction?: PaperDirection): number[];
+    getPageDirection(pageNo: number): PaperDirection;
+    getPageDirectionList(): PaperDirection[];
+    getPageSize(pageNo: number): {
+        width: number;
+        height: number;
+        margins: IMargin;
+        innerWidth: number;
+    };
+    getPageOffset(pageNo: number, isOriginal?: boolean): {
+        x: number;
+        y: number;
+    };
+    private _getPageMaxWidth;
     getPageGap(): number;
     getOriginalPageGap(): number;
     getPageNumberBottom(): number;
@@ -236,6 +252,7 @@ export declare class Draw {
     getHeader(): Header;
     getFooter(): Footer;
     getHyperlinkParticle(): HyperlinkParticle;
+    getHintParticle(): HintParticle;
     getTraceParticle(): TraceParticle;
     getDateParticle(): DateParticle;
     getListParticle(): ListParticle;
@@ -263,6 +280,7 @@ export declare class Draw {
     setPageDevicePixel(): void;
     setPaperSize(width: number, height: number): void;
     setPaperDirection(payload: PaperDirection): void;
+    setPageDirection(payload: PaperDirection | null): void;
     setPaperMargin(payload: IMargin): void;
     getOriginValue(options?: IGetOriginValueOption): Required<IEditorData>;
     getValue(options?: IGetValueOption): IEditorResult;
@@ -272,6 +290,7 @@ export declare class Draw {
     private _formatContainer;
     private _createPageContainer;
     private _createPage;
+    private _updatePageSizes;
     private _initPageContext;
     getElementFont(el: IElement, scale?: number): string;
     getElementSize(el: IElement): number;

package/dist/src/editor/core/draw/column/ColumnManager.d.ts

@@ -1,14 +1,15 @@
 import { IColumnLayout, IColumnOption } from '../../../interface/Column';
+import { PaperDirection } from '../../../dataset/enum/Editor';
 import { Draw } from '../Draw';
 export declare class ColumnManager {
     private draw;
     private options;
-    private layout;
+    private layoutMap;
     constructor(draw: Draw);
     computeLayout(innerWidth: number, config: IColumnOption | undefined): IColumnLayout | null;
     compute(): void;
-    getLayout(): IColumnLayout | null;
+    getLayout(direction?: PaperDirection): IColumnLayout | null;
     setConfig(config: IColumnOption | null | undefined): void;
-    getOffset(columnIndex: number | undefined): number;
+    getOffset(columnIndex: number | undefined, direction?: PaperDirection): number;
     drawSeparator(ctx: CanvasRenderingContext2D, pageNo: number): void;
 }

package/dist/src/editor/core/draw/control/Control.d.ts

@@ -37,6 +37,7 @@ export declare class Control {
     getElementList(): IElement[];
     getPosition(): IElementPosition | null;
     getPreY(): number;
+    getPreX(): number;
     getRange(): IRange;
     getValueRange(context?: IControlContext): IRange | null;
     shrinkBoundary(context?: IControlContext): void;

package/dist/src/editor/core/draw/frame/Footer.d.ts

@@ -1,3 +1,4 @@
+import { PaperDirection } from '../../../dataset/enum/Editor';
 import { IElement, IElementPosition } from '../../../interface/Element';
 import { IRow } from '../../../interface/Row';
 import { Draw } from '../Draw';
@@ -7,22 +8,23 @@ export declare class Footer {
     private zone;
     private options;
     private elementList;
-    private rowList;
-    private positionList;
+    private layoutMap;
     constructor(draw: Draw, data?: IElement[]);
     getRowList(): IRow[];
     setElementList(elementList: IElement[]): void;
     getElementList(): IElement[];
-    getPositionList(): IElementPosition[];
+    getPositionList(direction?: PaperDirection): IElementPosition[];
     compute(): void;
     recovery(): void;
+    private _getLayoutByDirection;
     private _computeRowList;
     private _computePositionList;
     getFooterBottom(pageNo?: number): number;
-    getMaxHeight(): number;
-    getHeight(pageNo?: number): number;
-    getRowHeight(): number;
-    getExtraHeight(pageNo?: number): number;
+    getMaxHeight(direction?: PaperDirection): number;
+    getHeight(pageNo?: number, direction?: PaperDirection): number;
+    getRowHeight(direction?: PaperDirection): number;
+    getExtraHeight(pageNo?: number, direction?: PaperDirection): number;
+    private _resolveDirection;
     isDisabled(pageNo?: number): boolean;
     render(ctx: CanvasRenderingContext2D, pageNo: number): void;
 }

package/dist/src/editor/core/draw/frame/Header.d.ts

@@ -1,3 +1,4 @@
+import { PaperDirection } from '../../../dataset/enum/Editor';
 import { IElement, IElementPosition } from '../../../interface/Element';
 import { IRow } from '../../../interface/Row';
 import { Draw } from '../Draw';
@@ -7,22 +8,23 @@ export declare class Header {
     private zone;
     private options;
     private elementList;
-    private rowList;
-    private positionList;
+    private layoutMap;
     constructor(draw: Draw, data?: IElement[]);
     getRowList(): IRow[];
     setElementList(elementList: IElement[]): void;
     getElementList(): IElement[];
-    getPositionList(): IElementPosition[];
+    getPositionList(direction?: PaperDirection): IElementPosition[];
     compute(): void;
     recovery(): void;
+    private _getLayoutByDirection;
     private _computeRowList;
     private _computePositionList;
     getHeaderTop(pageNo?: number): number;
-    getMaxHeight(): number;
-    getHeight(pageNo?: number): number;
-    getRowHeight(): number;
-    getExtraHeight(pageNo?: number): number;
+    getMaxHeight(direction?: PaperDirection): number;
+    getHeight(pageNo?: number, direction?: PaperDirection): number;
+    getRowHeight(direction?: PaperDirection): number;
+    getExtraHeight(pageNo?: number, direction?: PaperDirection): number;
+    private _resolveDirection;
     isDisabled(pageNo?: number): boolean;
     render(ctx: CanvasRenderingContext2D, pageNo: number): void;
 }

package/dist/src/editor/core/draw/frame/PageBorder.d.ts

@@ -5,5 +5,5 @@ export declare class PageBorder {
     private footer;
     private options;
     constructor(draw: Draw);
-    render(ctx: CanvasRenderingContext2D): void;
+    render(ctx: CanvasRenderingContext2D, pageNo: number): void;
 }

package/dist/src/editor/core/draw/frame/Watermark.d.ts

@@ -5,6 +5,6 @@ export declare class Watermark {
     private imageCache;
     constructor(draw: Draw);
     renderText(ctx: CanvasRenderingContext2D, pageNo: number): void;
-    renderImage(ctx: CanvasRenderingContext2D): void;
+    renderImage(ctx: CanvasRenderingContext2D, pageNo: number): void;
     render(ctx: CanvasRenderingContext2D, pageNo: number): void;
 }

package/dist/src/editor/core/draw/particle/HintParticle.d.ts

@@ -0,0 +1,23 @@
+import { IElementPosition } from '../../../interface/Element';
+import { ITd } from '../../../interface/table/Td';
+import { Draw } from '../Draw';
+interface IHintHit {
+    hint: string;
+    position?: IElementPosition;
+    td?: ITd;
+}
+export declare class HintParticle {
+    private draw;
+    private options;
+    private container;
+    private hintPopupContainer;
+    private hintDom;
+    private lastHoverKey;
+    constructor(draw: Draw);
+    private _createHintPopupDom;
+    private _getElementHint;
+    drawHintPopup(hit: IHintHit, pageNo: number): void;
+    clearHintPopup(): void;
+    handleMouseMove(evt: MouseEvent): void;
+}
+export {};

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/dataset/constant/Element.d.ts

@@ -5,6 +5,7 @@ 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/interface/Editor.d.ts

@@ -32,6 +32,7 @@ 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[];
@@ -114,6 +115,7 @@ export interface IEditorOption {
     column?: IColumnOption;
     trace?: ITraceOption;
     ruler?: IRulerOption;
+    hint?: IHintOption;
 }
 export interface IEditorResult {
     version: string;

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

@@ -1,5 +1,6 @@
 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';
@@ -23,6 +24,7 @@ export interface IElementBasic {
     value: string;
     extension?: unknown;
     externalId?: string;
+    hint?: string;
 }
 export interface IElementStyle {
     font?: string;
@@ -175,7 +177,10 @@ export interface ILabelElement {
         padding?: IPadding;
     };
 }
-export type IElement = IElementBasic & IElementStyle & IElementRule & IElementGroup & IElementTrace & 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;

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/Row.d.ts

@@ -1,3 +1,4 @@
+import { PaperDirection } from '../dataset/enum/Editor';
 import { RowFlex } from '../dataset/enum/Row';
 import { IElement, IElementMetrics, IElementPosition, ITableRowFragment } from './Element';
 import { ITd } from './table/Td';
@@ -13,6 +14,7 @@ export interface IRow {
     rowFlex?: RowFlex;
     startIndex: number;
     isPageBreak?: boolean;
+    paperDirection?: PaperDirection;
     isList?: boolean;
     listIndex?: number;
     offsetX?: number;

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/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/package.json

@@ -2,7 +2,7 @@
   "name": "@hufe921/canvas-editor",
   "author": "Hufe",
   "license": "MIT",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "A Canvas/SVG-based rich text editor",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -53,24 +53,24 @@
     "@types/jsdom": "^28.0.3",
     "@types/node": "^24.12.4",
     "@types/prismjs": "^1.26.6",
-    "@typescript-eslint/eslint-plugin": "^8.59.3",
-    "@typescript-eslint/parser": "^8.59.3",
+    "@typescript-eslint/eslint-plugin": "^8.67.0",
+    "@typescript-eslint/parser": "^8.67.0",
     "@vitest/coverage-v8": "^4.1.6",
-    "cypress": "^15.15.0",
+    "cypress": "^15.20.1",
     "cypress-file-upload": "^5.0.8",
-    "eslint": "^10.4.0",
-    "globals": "^17.6.0",
+    "eslint": "^10.8.1",
+    "globals": "^17.10.0",
     "jsdom": "^29.1.1",
     "simple-git-hooks": "^2.13.1",
     "tslib": "^2.8.1",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.3",
-    "vite": "^8.0.13",
+    "typescript-eslint": "^8.67.0",
+    "vite": "^8.2.1",
     "vite-plugin-css-injected-by-js": "^5.0.1",
     "vitepress": "^1.6.4",
     "vitest": "^4.1.6",
     "vitest-canvas-mock": "^1.1.4",
-    "vue": "^3.5.34"
+    "vue": "^3.5.41"
   },
   "simple-git-hooks": {
     "pre-commit": "npm run lint && npm run type:check",