@agile_jy/word-editor 0.0.1-beta.21 → 0.0.1-beta.23

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

@@ -120,6 +120,7 @@ export declare class Command {
     getCatalog: CommandAdapt['getCatalog'];
     getImage: CommandAdapt['getImage'];
     getOptions: CommandAdapt['getOptions'];
+    getDefaultLineHeight: CommandAdapt['getDefaultLineHeight'];
     getValue: CommandAdapt['getValue'];
     getValueAsync: CommandAdapt['getValueAsync'];
     getAreaValue: CommandAdapt['getAreaValue'];

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

@@ -10,7 +10,7 @@ import { ICatalog } from '../../interface/Catalog';
 import { DeepRequired } from '../../interface/Common';
 import { IGetControlValueOption, IGetControlValueResult, ILocationControlOption, IRemoveControlOption, ISetControlExtensionOption, ISetControlHighlightOption, ISetControlProperties, ISetControlValueOption } from '../../interface/Control';
 import { IAppendElementListOption, IDrawImagePayload, IForceUpdateOption, IGetImageOption, IGetValueOption, IPainterOption } from '../../interface/Draw';
-import { IEditorData, IEditorHTML, IEditorOption, IEditorResult, IEditorText, IFocusOption, IImportDocxOption, ISetHtmlDocxOption, ISetValueOption, IUpdateOption } from '../../interface/Editor';
+import { IEditorData, IEditorHTML, IEditorOption, IEditorResult, IEditorText, IFocusOption, IGetDefaultLineHeightOption, IDefaultLineHeightResult, IImportDocxOption, ISetHtmlDocxOption, ISetValueOption, IUpdateOption } from '../../interface/Editor';
 import { IDeleteElementByIdOption, IElement, IElementPosition, IGetElementByIdOption, IImageCaption, IImageCrop, IInsertElementListOption, IUpdateElementByIdOption } from '../../interface/Element';
 import { ICopyOption, IPasteOption, IPositionContextByEventOption, IPositionContextByEventResult } from '../../interface/Event';
 import { IMargin } from '../../interface/Margin';
@@ -116,6 +116,11 @@ export declare class CommandAdapt {
     changeImageDisplay(element: IElement, display: ImageDisplay): void;
     getImage(payload?: IGetImageOption): Promise<string[]>;
     getOptions(): DeepRequired<IEditorOption>;
+    /**
+     * 获取默认行高（与 canvas 排版 / 导出 HTML 一致）
+     * 可传入 size、rowMargin 覆盖默认值
+     */
+    getDefaultLineHeight(payload?: IGetDefaultLineHeightOption): IDefaultLineHeightResult;
     getValue(options?: IGetValueOption): IEditorResult;
     getValueAsync(options?: IGetValueOption): Promise<IEditorResult>;
     getAreaValue(options?: IGetAreaValueOption): IGetAreaValueResult | null;

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

@@ -1,5 +1,5 @@
 import './assets/css/index.css';
-import { IEditorData, IEditorOption, IEditorResult, IImportDocxOption } from './interface/Editor';
+import { IEditorData, IEditorOption, IEditorResult, IImportDocxOption, IGetDefaultLineHeightOption, IDefaultLineHeightResult } from './interface/Editor';
 import { IElement, IFormInputImage, IUpdateElementByIdOption } from './interface/Element';
 import { IFormImageProperties, ISignatureImage, ISealImage, IRiskCopyImage } from '../utils';
 import { Command } from './core/command/Command';
@@ -44,6 +44,7 @@ import { INTERNAL_SHORTCUT_KEY } from './dataset/constant/Shortcut';
 import { formInputPropertiesConfigDialog, formCheckboxPropertiesConfigDialog, formRadioPropertiesConfigDialog, formImagePropertiesConfigDialog, formSignatureConfigDialog, formSealConfigDialog, formRiskCopyConfigDialog } from '../utils';
 import { Dialog, type IDialogData, type IDialogConfirm, type IDialogOptions } from '../components/dialog/Dialog';
 import docxPlugin from '../plugins/docx';
+import { computeElementLineHeightPx, computeElementRowMarginPx } from './utils/rowMargin';
 export default class Editor {
     command: Command;
     version: string;
@@ -98,5 +99,5 @@ export default class Editor {
 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 };
-export type { IElement, IEditorData, IEditorOption, IEditorResult, IContextMenuContext, IRegisterContextMenu, IWatermark, INavigateInfo, IBlock, ILang, ICatalog, ICatalogItem, IRange, IRangeStyle, IBadge, IGetElementListByHTMLOption, IFormInputImage, IUpdateElementByIdOption, IFormImageProperties, ISignatureImage, ISealImage, IRiskCopyImage, IDialogData, IDialogConfirm, IDialogOptions, IImportDocxOption };
-export { Dialog, docxPlugin, formInputPropertiesConfigDialog, formCheckboxPropertiesConfigDialog, formRadioPropertiesConfigDialog, formImagePropertiesConfigDialog, formSignatureConfigDialog, formSealConfigDialog, formRiskCopyConfigDialog };
+export type { IElement, IEditorData, IEditorOption, IEditorResult, IContextMenuContext, IRegisterContextMenu, IWatermark, INavigateInfo, IBlock, ILang, ICatalog, ICatalogItem, IRange, IRangeStyle, IBadge, IGetElementListByHTMLOption, IFormInputImage, IUpdateElementByIdOption, IFormImageProperties, ISignatureImage, ISealImage, IRiskCopyImage, IDialogData, IDialogConfirm, IDialogOptions, IImportDocxOption, IGetDefaultLineHeightOption, IDefaultLineHeightResult };
+export { Dialog, docxPlugin, computeElementRowMarginPx, computeElementLineHeightPx, formInputPropertiesConfigDialog, formCheckboxPropertiesConfigDialog, formRadioPropertiesConfigDialog, formImagePropertiesConfigDialog, formSignatureConfigDialog, formSealConfigDialog, formRiskCopyConfigDialog };

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

@@ -128,6 +128,24 @@ export interface IImportDocxOption {
     /** 页边距 [上, 右, 下, 左]，传入则覆盖 DOM 解析结果 */
     margins?: IMargin;
 }
+/** getDefaultLineHeight 可选覆盖项 */
+export interface IGetDefaultLineHeightOption {
+    /** 覆盖默认字号 */
+    size?: number;
+    /** 覆盖默认行距倍数 */
+    rowMargin?: number;
+}
+/** 默认行高计算结果（与 canvas / 导出 HTML 公式一致） */
+export interface IDefaultLineHeightResult {
+    /** 行距倍数 */
+    rowMargin: number;
+    /** 单侧行距 px */
+    rowMarginPx: number;
+    /** 整行高近似 px：字号 + 2×单侧行距 */
+    lineHeightPx: number;
+    /** 参与计算的字号 */
+    size: number;
+}
 export type IEditorText = IEditorHTML;
 export type IUpdateOption = Omit<IEditorOption, 'mode' | 'width' | 'height' | 'scale' | 'pageGap' | 'pageMode' | 'paperDirection' | 'historyMaxRecordCount' | 'scrollContainerSelector'>;
 export interface ISetValueOption {

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

@@ -0,0 +1,13 @@
+import { DeepRequired } from '../interface/Common';
+import { IEditorOption } from '../interface/Editor';
+import { IElement } from '../interface/Element';
+/**
+ * 计算元素单侧行距（px），与 Draw.getElementRowMargin 公式一致：
+ * defaultBasicRowMarginHeight × ratio × (rowMargin ?? defaultRowMargin) × scale
+ */
+export declare function computeElementRowMarginPx(el: IElement, options: DeepRequired<IEditorOption> | IEditorOption): number;
+/**
+ * 导出 HTML 用的整行高近似（px）：
+ * 字号 + 2 × 单侧行距（对应 canvas：ascent+descent+2×rowMargin）
+ */
+export declare function computeElementLineHeightPx(el: IElement, options: DeepRequired<IEditorOption> | IEditorOption): number;

package/dist/src/plugins/docx/index.d.ts

@@ -4,5 +4,5 @@ export type { IImportDocxOption } from '../../editor/interface/Editor';
  * 兼容旧用法：executeImportDocx 已内置到 Command，无需再挂载。
  * 保留插件导出，避免旧代码 instance.use(docxPlugin) 报错。
  */
-export default function docxPlugin(_editor: Editor): void;
+export default function docxPlugin(_editor?: Editor): void;
 export { docxPlugin };

package/package.json

@@ -2,7 +2,7 @@
   "name": "@agile_jy/word-editor",
   "author": "JIANGYONG",
   "license": "MIT",
-  "version": "0.0.1-beta.21",
+  "version": "0.0.1-beta.23",
   "description": "rich text editor by canvas/svg",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",