@vervedoc/core 3.0.10

package/dist/docxParser/constants.d.ts

@@ -0,0 +1,42 @@
+export declare const NS: {
+    readonly w: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+    readonly r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+    readonly a: "http://schemas.openxmlformats.org/drawingml/2006/main";
+    readonly wp: "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing";
+    readonly c: "http://schemas.openxmlformats.org/drawingml/2006/chart";
+    readonly v: "urn:schemas-microsoft-com:vml";
+    readonly pic: "http://schemas.openxmlformats.org/drawingml/2006/picture";
+    readonly mc: "http://schemas.openxmlformats.org/markup-compatibility/2006";
+    readonly wps: "http://schemas.microsoft.com/office/word/2010/wordprocessingShape";
+    readonly rel: "http://schemas.openxmlformats.org/package/2006/relationships";
+    readonly m: "http://schemas.openxmlformats.org/officeDocument/2006/math";
+};
+/** Twip（1/1440 英寸）转 px（96dpi） */
+export declare function twipToPx(twip: number): number;
+/** 半磅转磅（字号：Word sz 值 / 2） */
+export declare function halfPtToPt(halfPt: number): number;
+/**
+ * 半磅转像素（Word sz 单位 → canvas px，96dpi）
+ * Word sz = 半磅，pt = sz/2，px = pt × 96/72
+ * 即 px = sz × (96 / 144) = sz × (2/3)
+ */
+export declare function halfPtToPx(halfPt: number): number;
+/** EMU 转 px（1 英寸 = 914400 EMU = 96px） */
+export declare function emuToPx(emu: number): number;
+/** 八分之一磅转 px（边框宽度） */
+export declare function eighthPtToPx(val: number): number;
+/** Word 高亮颜色名 → CSS hex */
+export declare const HIGHLIGHT_COLOR_MAP: Record<string, string>;
+export declare function normalizeFont(rawFontName: string | undefined): string | undefined;
+export declare const NUM_FMT_MAP: Record<string, {
+    listType: string;
+    listStyle: string;
+}>;
+export declare const ALIGNMENT_MAP: Record<string, string>;
+export declare const BORDER_TYPE_MAP: Record<string, number>;
+/**
+ * OOXML 中 themeFill / themeColor 可能使用语义名（如 background1），
+ * 需映射到 clrScheme 中的实际槽位名（如 lt1）
+ */
+export declare const THEME_COLOR_SEMANTIC_MAP: Record<string, string>;
+export declare const TRANSPARENT_1PX_PNG = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==";

package/dist/docxParser/docx.parser.d.ts

@@ -0,0 +1,13 @@
+import { IDocxParseResult, IDocxParseOptions } from './types';
+export declare class DocxParser {
+    private options;
+    constructor(options?: IDocxParseOptions);
+    parse(arrayBuffer: ArrayBuffer): Promise<IDocxParseResult>;
+    parseFromFile(file: File): Promise<IDocxParseResult>;
+    private parseDocumentSync;
+    private readZipEntry;
+    private extractMediaFiles;
+    private extractChartRelFiles;
+    private extractChartXmlFiles;
+    private getMergedOptions;
+}

package/dist/docxParser/index.d.ts

@@ -0,0 +1,13 @@
+import { DocxParser } from './docx.parser';
+import { IDocxParseOptions, IDocxParseResult } from './types';
+export type { IDocxParseResult, IDocxParseOptions } from './types';
+export { DocxParser } from './docx.parser';
+/**
+ * 创建解析器实例的工厂函数
+ */
+export declare function createDocxParser(options?: IDocxParseOptions): DocxParser;
+/**
+ * 快捷解析函数（保持与旧 API 兼容）
+ */
+export declare function parseDocx(data: ArrayBuffer | File, options?: IDocxParseOptions): Promise<IDocxParseResult>;
+export default DocxParser;

package/dist/docxParser/types.d.ts

@@ -0,0 +1,170 @@
+import { IElement } from '@vervedoc/docx-editor-schema';
+export interface IDocxParseResult {
+    success: boolean;
+    elements: IElement[];
+    comments?: DocxCommentMeta[];
+    html?: string;
+    error?: string;
+}
+export interface IChartRenderer {
+    renderToDataUrl(option: unknown, width: number, height: number, pixelRatio?: number): string;
+}
+export interface IDocxParseOptions {
+    preserveStyles?: boolean;
+    defaultFont?: string;
+    defaultSize?: number;
+    targetInnerWidth?: number;
+    tableWidthMode?: 'fit' | 'word';
+    defaultTableRowHeight?: number;
+    defaultTableTdPadding?: [number, number, number, number];
+    forceDefaultLineHeight?: number;
+    chartRenderer?: IChartRenderer;
+}
+export declare const DEFAULT_OPTIONS: Required<Pick<IDocxParseOptions, 'preserveStyles' | 'defaultFont' | 'defaultSize' | 'tableWidthMode' | 'defaultTableRowHeight' | 'forceDefaultLineHeight'>> & {
+    defaultTableTdPadding: [number, number, number, number];
+};
+export interface IWorkerRequest {
+    documentXml: string;
+    stylesXml: string | null;
+    numberingXml: string | null;
+    themeXml: string | null;
+    documentRels: string | null;
+    commentsXml: string | null;
+    chartRelsMap: Record<string, string>;
+    chartXmlMap: Record<string, string>;
+    mediaMap: Record<string, string>;
+    options: IDocxParseOptions;
+}
+export interface IWorkerResponse {
+    success: boolean;
+    elements: IElement[];
+    error?: string;
+}
+export type DocNode = ParagraphNode | TableNode | ColumnNode;
+export interface ParagraphNode {
+    type: 'paragraph';
+    chunks: InlineChunk[];
+    style: ParagraphStyle;
+}
+export interface TableNode {
+    type: 'table';
+    rows: TableRowNode[];
+    colWidths: number[];
+    borderType?: string;
+    borderColor?: string;
+    borderWidth?: number;
+}
+export interface ColumnNode {
+    type: 'column';
+    columns: number;
+    colWidths: number[];
+    colSpace: number;
+    separator: boolean;
+    groups: ParagraphNode[][];
+}
+export interface TableRowNode {
+    height?: number;
+    cells: TableCellNode[];
+}
+export interface TableCellNode {
+    paragraphs: ParagraphNode[];
+    colspan: number;
+    rowspan: number;
+    backgroundColor?: string;
+    verticalAlign?: string;
+    borderTypes?: number[];
+    borderStyle?: string;
+    width?: number;
+}
+export interface ParagraphStyle {
+    rowFlex?: string;
+    spacingBefore?: number;
+    spacingAfter?: number;
+    lineHeight?: number;
+    /** 行高规则：auto=倍率, exact=精确值(px), atLeast=最小值(px) */
+    lineHeightRule?: 'auto' | 'exact' | 'atLeast';
+    indentLeft?: number;
+    indentRight?: number;
+    firstLineIndent?: number;
+    paragraphColor?: string;
+    titleLevel?: number;
+    listType?: string;
+    listStyle?: string;
+    listLevel?: number;
+    numId?: string;
+    /** 制表符停止位 */
+    tabStops?: Array<{
+        pos: number;
+        type: string;
+    }>;
+}
+export type InlineChunk = TextChunk | ImageChunk | HyperlinkChunk | BreakChunk | TabChunk | BookmarkChunk | CommentMarkerChunk;
+export interface TextChunk {
+    type: 'text';
+    value: string;
+    style: RunStyle;
+    revision?: {
+        id: string;
+        type: 'insert' | 'delete';
+        author: string;
+        date: string;
+    };
+}
+export interface ImageChunk {
+    type: 'image';
+    src: string;
+    width: number;
+    height: number;
+    display?: string;
+    floatPosition?: {
+        x: number;
+        y: number;
+    };
+}
+export interface HyperlinkChunk {
+    type: 'hyperlink';
+    url: string;
+    children: TextChunk[];
+}
+export interface BreakChunk {
+    type: 'break';
+    breakType: 'line' | 'page' | 'column';
+}
+export interface TabChunk {
+    type: 'tab';
+}
+export interface BookmarkChunk {
+    type: 'bookmark';
+    name: string;
+}
+export interface CommentMarkerChunk {
+    type: 'commentMarker';
+    markType: 'start' | 'end';
+    commentId: string;
+}
+export interface RunStyle {
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strikeout?: boolean;
+    font?: string;
+    size?: number;
+    color?: string;
+    highlight?: string;
+    letterSpacing?: number;
+    vertAlign?: 'superscript' | 'subscript';
+    textDecoration?: {
+        style: string;
+    };
+}
+export interface ResolvedStyle {
+    paragraph: ParagraphStyle;
+    run: RunStyle;
+}
+export interface DocxCommentMeta {
+    id: string;
+    author: string;
+    date: string;
+    initials?: string;
+    content: string;
+}

package/dist/docxParser/worker/builder/element.builder.d.ts

@@ -0,0 +1,6 @@
+import { IElement } from '@vervedoc/docx-editor-schema';
+import { DocNode, IDocxParseOptions, DocxCommentMeta } from '../../types';
+/**
+ * 将中间表示 DocNode[] 转换为编辑器 IElement[]
+ */
+export declare function buildElements(nodes: DocNode[], options: IDocxParseOptions, _commentMetas?: Map<string, DocxCommentMeta>): IElement[];

package/dist/docxParser/worker/docx.parse.worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/docxParser/worker/numbering.resolver.d.ts

@@ -0,0 +1,29 @@
+export interface NumberingInfo {
+    listType: string;
+    listStyle: string;
+    level: number;
+    indentLeft?: number;
+    indentHanging?: number;
+}
+/**
+ * 列表编号解析器：解析 word/numbering.xml
+ *
+ * 支持：
+ *   - <w:abstractNum>：抽象编号定义（含各级格式）
+ *   - <w:num>：具体编号实例（引用 abstractNum）
+ *   - <w:lvlOverride>：级别覆盖（如 startOverride 重置起始值）
+ */
+export declare class NumberingResolver {
+    private abstractNums;
+    private numRefs;
+    constructor(numberingXml: string | null);
+    /**
+     * 根据 numId 和列表层级解析编号信息
+     * 返回 null 表示找不到对应定义
+     */
+    resolve(numId: string, level: number): NumberingInfo | null;
+    private parseNumberingXml;
+    private parseAbstractNums;
+    private parseNumReferences;
+    private mapLevelToInfo;
+}

package/dist/docxParser/worker/parsers/chart.parser.d.ts

@@ -0,0 +1,16 @@
+import { ImageChunk } from '../../types';
+import { RelationshipEntry } from '../relationship.resolver';
+/**
+ * 从 <w:drawing> 中提取图表预览图
+ *
+ * 策略：
+ * 1. 检测 <c:chart r:id="rIdX"/>
+ * 2. 查找图表 .rels 文件中的预览图
+ * 3. 回退到 <a:blipFill> 缓存图片
+ * 4. 无预览图则返回 null
+ */
+export declare function parseChart(drawingEl: Element, documentRels: Map<string, RelationshipEntry>, chartRelsMap: Record<string, string>, mediaMap: Record<string, string>): ImageChunk | null;
+/**
+ * 检测 drawing 中是否包含图表
+ */
+export declare function isChartDrawing(drawingEl: Element): boolean;

package/dist/docxParser/worker/parsers/comment.parser.d.ts

@@ -0,0 +1,5 @@
+import { DocxCommentMeta } from '../../types';
+/**
+ * 解析 word/comments.xml，返回 commentId → DocxCommentMeta 映射
+ */
+export declare function parseComments(commentsXml: string | null): Map<string, DocxCommentMeta>;

package/dist/docxParser/worker/parsers/hyperlink.parser.d.ts

@@ -0,0 +1,14 @@
+import { HyperlinkChunk, RunStyle } from '../../types';
+import { StyleResolver } from '../style.resolver';
+import { ThemeData } from '../theme.resolver';
+import { RelationshipEntry } from '../relationship.resolver';
+/**
+ * 解析 <w:hyperlink> 元素
+ *
+ * 支持：
+ *   - 外部链接（r:id → rels 中的目标 URL）
+ *   - 内部书签锚点（w:anchor → "#anchorName"）
+ *
+ * 默认样式：rPr 未明确设置颜色时使用超链接蓝色，未明确设置下划线时添加下划线
+ */
+export declare function parseHyperlink(hyperlinkEl: Element, styleResolver: StyleResolver, theme: ThemeData, baseRunStyle: RunStyle, rels: Map<string, RelationshipEntry>): HyperlinkChunk | null;

package/dist/docxParser/worker/parsers/image.parser.d.ts

@@ -0,0 +1,12 @@
+import { ImageChunk } from '../../types';
+import { RelationshipEntry } from '../relationship.resolver';
+export interface PageMargins {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+/**
+ * 解析 <w:drawing> 元素
+ */
+export declare function parseImage(drawingEl: Element, rels: Map<string, RelationshipEntry>, mediaMap: Record<string, string>, pageMargins?: PageMargins): ImageChunk | null;

package/dist/docxParser/worker/parsers/list.parser.d.ts

@@ -0,0 +1,6 @@
+import { ParagraphStyle } from '../../types';
+import { NumberingResolver } from '../numbering.resolver';
+/**
+ * 检测段落是否为列表项，并填充列表信息
+ */
+export declare function resolveListInfo(style: ParagraphStyle, numberingResolver: NumberingResolver): void;

package/dist/docxParser/worker/parsers/ooxml.chart.parser.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 解析 OOXML chart XML，返回 ECharts option
+ */
+export declare function parseOoxmlChartToOption(chartXml: string): any | null;

package/dist/docxParser/worker/parsers/paragraph.parser.d.ts

@@ -0,0 +1,10 @@
+import { ParagraphNode } from '../../types';
+import { StyleResolver } from '../style.resolver';
+import { ThemeData } from '../theme.resolver';
+import { NumberingResolver } from '../numbering.resolver';
+import { RelationshipEntry } from '../relationship.resolver';
+import { PageMargins } from './image.parser';
+/**
+ * 解析 <w:p> 元素为 ParagraphNode
+ */
+export declare function parseParagraph(paragraphEl: Element, styleResolver: StyleResolver, theme: ThemeData, numberingResolver: NumberingResolver, rels: Map<string, RelationshipEntry>, mediaMap: Record<string, string>, pageMargins?: PageMargins, defaultFontSize?: number): ParagraphNode;

package/dist/docxParser/worker/parsers/run.parser.d.ts

@@ -0,0 +1,22 @@
+import { RunStyle, InlineChunk } from '../../types';
+import { StyleResolver } from '../style.resolver';
+import { ThemeData } from '../theme.resolver';
+/**
+ * 全局脚注 / 尾注计数器（每次 parseSync 开始前由 DocxParser 重置）
+ */
+export declare const footnoteCounter: {
+    value: number;
+};
+/**
+ * 解析 <w:r> 元素，返回 InlineChunk 列表
+ *
+ * 处理内容：
+ *   <w:t>           文本
+ *   <w:br>          换行 / 分页 / 分栏符
+ *   <w:tab>         制表符
+ *   <w:sym>         符号字符
+ *   <w:softHyphen>  软连字符（忽略）
+ *   <w:noBreakHyphen> 不换行连字符（输出 "-"）
+ *   <w:footnoteReference> / <w:endnoteReference>  脚注 / 尾注（输出上标序号）
+ */
+export declare function parseRun(runEl: Element, styleResolver: StyleResolver, _theme: ThemeData, baseRunStyle: RunStyle): InlineChunk[];

package/dist/docxParser/worker/parsers/section.parser.d.ts

@@ -0,0 +1,20 @@
+import { ParagraphNode, ColumnNode } from '../../types';
+/** 分节类型：nextPage / evenPage / oddPage 均产生分页，continuous / nextColumn 不分页 */
+export type SectionBreakType = 'nextPage' | 'evenPage' | 'oddPage' | 'continuous' | 'nextColumn';
+export interface SectionProperties {
+    /** 分节类型，默认 nextPage */
+    breakType: SectionBreakType;
+    columns: number;
+    colWidths: number[];
+    colSpace: number;
+    separator: boolean;
+}
+/**
+ * 解析 <w:sectPr> 中的分节属性（分页类型 + 分栏）
+ */
+export declare function parseSectionProperties(sectPrEl: Element): SectionProperties;
+/**
+ * 将段落列表按分栏属性分组，构建 ColumnNode
+ * ColumnNode 是编辑器原生分栏格式（推荐）
+ */
+export declare function buildColumnNode(paragraphs: ParagraphNode[], sectionProps: SectionProperties, targetInnerWidth: number): ColumnNode;

package/dist/docxParser/worker/parsers/table.parser.d.ts

@@ -0,0 +1,11 @@
+import { TableNode } from '../../types';
+import { StyleResolver } from '../style.resolver';
+import { ThemeData } from '../theme.resolver';
+import { NumberingResolver } from '../numbering.resolver';
+import { RelationshipEntry } from '../relationship.resolver';
+import { PageMargins } from './image.parser';
+/**
+ * 解析 <w:tbl> 元素为 TableNode
+ * 支持嵌套表格、合并单元格（colspan / rowspan）、单元格边框
+ */
+export declare function parseTable(tableEl: Element, styleResolver: StyleResolver, theme: ThemeData, numberingResolver: NumberingResolver, rels: Map<string, RelationshipEntry>, mediaMap: Record<string, string>, pageMargins?: PageMargins): TableNode;

package/dist/docxParser/worker/parsers/toc.parser.d.ts

@@ -0,0 +1,13 @@
+import { ParagraphNode } from '../../types';
+import { StyleResolver } from '../style.resolver';
+import { ThemeData } from '../theme.resolver';
+import { NumberingResolver } from '../numbering.resolver';
+import { RelationshipEntry } from '../relationship.resolver';
+/**
+ * 检测元素是否为 TOC（目录）结构化文档标签
+ */
+export declare function isTocSdt(sdtEl: Element): boolean;
+/**
+ * 解析 TOC SDT 为段落列表（当作普通段落处理）
+ */
+export declare function parseTocContent(sdtEl: Element, styleResolver: StyleResolver, theme: ThemeData, numberingResolver: NumberingResolver, rels: Map<string, RelationshipEntry>, mediaMap: Record<string, string>): ParagraphNode[];

package/dist/docxParser/worker/relationship.resolver.d.ts

@@ -0,0 +1,17 @@
+export interface RelationshipEntry {
+    id: string;
+    type: string;
+    target: string;
+}
+/**
+ * 解析 .rels 文件，建立 rId → target 映射
+ */
+export declare function parseRelationships(relsXml: string): Map<string, RelationshipEntry>;
+/**
+ * 通过 rId 获取 target 路径
+ */
+export declare function getTargetByRId(rels: Map<string, RelationshipEntry>, rId: string): string | null;
+/**
+ * 查找指定类型的 relationship
+ */
+export declare function findRelByType(rels: Map<string, RelationshipEntry>, typeSubstring: string): RelationshipEntry | null;

package/dist/docxParser/worker/style.resolver.d.ts

@@ -0,0 +1,33 @@
+import { ParagraphStyle, RunStyle, ResolvedStyle } from '../types';
+import { ThemeData } from './theme.resolver';
+/**
+ * 样式解析器：解析 word/styles.xml，提供完整的样式继承链查询
+ *
+ * 合并优先级（低 → 高）：
+ *   docDefaults → basedOn 链（从根祖先到直接父级）→ 当前 styleId → 段落/run 局部属性
+ */
+export declare class StyleResolver {
+    private styleMap;
+    private defaultParagraphStyle;
+    private defaultRunStyle;
+    private theme;
+    constructor(stylesXml: string | null, theme: ThemeData);
+    /**
+     * 解析段落属性 <w:pPr>，返回局部 ParagraphStyle（不含继承链）
+     */
+    parseParagraphProperties(pPr: Element): ParagraphStyle;
+    /**
+     * 解析 Run 属性 <w:rPr>，返回局部 RunStyle（不含继承链）
+     */
+    parseRunProperties(rPr: Element): RunStyle;
+    /**
+     * 根据 styleId 解析完整样式（含 docDefaults + 完整继承链）
+     */
+    resolveStyle(styleId: string | null): ResolvedStyle;
+    getDefaultRunStyle(): RunStyle;
+    getDefaultParagraphStyle(): ParagraphStyle;
+    private parseStylesXml;
+    private parseDocDefaults;
+    private parseStyleElement;
+}
+export declare function resolveShdFill(shd: Element, theme: ThemeData): string | null;

package/dist/docxParser/worker/theme.resolver.d.ts

@@ -0,0 +1,21 @@
+export interface ThemeData {
+    colors: Map<string, string>;
+    majorFont: string | null;
+    minorFont: string | null;
+}
+/**
+ * 解析 word/theme/theme1.xml，提取颜色方案和字体方案
+ */
+export declare function parseTheme(themeXml: string | null): ThemeData;
+/**
+ * 将主题颜色名（含语义别名）解析为 #RRGGBB 颜色字符串
+ *
+ * tint / shade 为 OOXML 十六进制字符串（0x00-0xFF），在 HSL 色彩空间运算：
+ *   tint：L_new = L + (1 - L) * factor   (变亮)
+ *   shade：L_new = L * factor             (变暗)
+ */
+export declare function resolveThemeColor(theme: ThemeData, themeColorName: string, themeTint?: string, themeShade?: string): string | null;
+/**
+ * 解析主题字体引用（asciiTheme / eastAsiaTheme 属性值）
+ */
+export declare function resolveThemeFont(theme: ThemeData, fontRef: string | null | undefined): string | null;

package/dist/docxParser/worker/xml.helper.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 解析 XML 字符串为 Document
+ */
+export declare function parseXml(xmlString: string): Document;
+/**
+ * 获取指定命名空间下的子元素（直接子元素）
+ */
+export declare function getChildrenByTag(parent: Element, ns: string, localName: string): Element[];
+/**
+ * 获取第一个指定命名空间下的子元素
+ */
+export declare function getFirstChildByTag(parent: Element, ns: string, localName: string): Element | null;
+/**
+ * 获取 w:val 属性值
+ */
+export declare function getWVal(el: Element | null): string | null;
+/**
+ * 获取指定命名空间的属性值
+ */
+export declare function getAttr(el: Element, ns: string, name: string): string | null;
+/**
+ * 获取属性（兼容带前缀和不带前缀的写法）
+ */
+export declare function getAttrVal(el: Element, attrName: string): string | null;
+/**
+ * 遍历直接子元素（所有命名空间）
+ */
+export declare function forEachChild(parent: Element, callback: (child: Element) => void): void;
+/**
+ * 获取所有后代元素（指定命名空间和标签名）
+ */
+export declare function getElementsByTag(parent: Element, ns: string, localName: string): Element[];
+/**
+ * 检查元素是否存在（用于 boolean 属性如 <w:b/>）
+ */
+export declare function hasChild(parent: Element, ns: string, localName: string): boolean;

package/dist/export/ExportComponent.d.ts

@@ -0,0 +1,9 @@
+type Draw = any;
+type Command = any;
+export declare class ExportComponent {
+    private _command;
+    install(draw: Draw, command: Command): this;
+    exportDocx(payload?: any): Promise<Blob | null>;
+    previewHtml(payload?: any): string;
+}
+export {};

package/dist/i18n/I18n.d.ts

@@ -0,0 +1,8 @@
+type Draw = any;
+type ILang = any;
+type DeepPartial<T> = T;
+export declare class I18n {
+    install(_draw: Draw): this;
+    setLang(_locale: string, _lang: DeepPartial<ILang>): void;
+}
+export {};