@coding01/docsjs 0.1.5 → 0.1.6

package/README.md

@@ -6,9 +6,16 @@ Import Word/WPS/Google Docs content from paste or `.docx` while preserving struc
 [![npm version](https://img.shields.io/npm/v/@coding01/docsjs)](https://www.npmjs.com/package/@coding01/docsjs)
 [![npm downloads](https://img.shields.io/npm/dm/@coding01/docsjs)](https://www.npmjs.com/package/@coding01/docsjs)
 [![CI](https://github.com/fanly/docsjs/actions/workflows/ci.yml/badge.svg)](https://github.com/fanly/docsjs/actions/workflows/ci.yml)
+[![Pages](https://github.com/fanly/docsjs/actions/workflows/pages.yml/badge.svg)](https://github.com/fanly/docsjs/actions/workflows/pages.yml)
 
 [中文文档](./README.zh-CN.md)
 
+## GitHub Pages
+
+- Product page: [https://docsjs.coding01.cn/](https://docsjs.coding01.cn/)
+- Source: `docs/index.html`
+- Deploy workflow: `.github/workflows/pages.yml`
+
 ## What You Get
 
 - Web Component core: `docs-word-editor`
@@ -74,7 +81,7 @@ el.addEventListener("docsjs-change", (e) => {
 ### Events
 
 - `docsjs-change`
-  - payload: `{ htmlSnapshot: string; source: "paste" | "upload" | "api" | "clear"; fileName?: string }`
+  - payload: `{ htmlSnapshot: string; source: "paste" | "upload" | "api" | "clear"; fileName?: string; parseReport?: DocxParseReport }`
 - `docsjs-error`
   - payload: `{ message: string }`
 - `docsjs-ready`
@@ -95,34 +102,49 @@ el.addEventListener("docsjs-change", (e) => {
 
 ## Feature Checklist
 
+<!-- GENERATED:FEATURE_CHECKLIST_EN:START -->
+### Core
+
 - ✅ Web Component core (`docs-word-editor`)
-- ✅ React adapter (`@coding01/docsjs/react`)
-- ✅ Vue adapter (`@coding01/docsjs/vue`)
-- ✅ Paste import (`text/html`, `text/plain`)
-- ✅ Clipboard image hydration (`file:/blob:/cid:/mhtml:` to data URL)
-- ✅ `.docx` upload and parse
-- ✅ Basic paragraph semantics (alignment, headings, line break)
-- ✅ Basic run styles (bold/italic/underline/strike/color/highlight/super/sub)
-- ✅ List reconstruction (`numId` + `ilvl` + `lvlText`)
-- ✅ Basic table structure (`table/tr/td`)
-- ✅ Table merge + nested table read-only fidelity (`vMerge/gridSpan`)
-- ✅ Table width mapping (`tblGrid/gridCol`, `tcW`)
-- ✅ Embedded image relationship mapping (`rId -> media`)
-- ✅ Page geometry mapping (page height, margins, content width)
-- ✅ Runtime render fixes (`mso-*` compatibility, pagination spacer, empty paragraph normalization)
-- ✅ Events and public methods
-- ✅ React and Vue runnable demos
-- ✅ npm publish workflow with OIDC trusted publishing
-- ✅ Footnotes / endnotes / comments / track changes read-only semantics
-- ✅ Comment range markers (`commentRangeStart/commentRangeEnd`)
-- ✅ Revision metadata markers (`id/author/date`)
-- ✅ Floating anchors (`wp:anchor`) v1 fidelity (position ref / overlap / layer / wrap distance markers)
-- ✅ Word table v1 fidelity (border model / cell spacing / table-layout mapping)
-- ✅ OMML / charts / SmartArt semantic fallback rendering (v1)
-- ✅ Automated fidelity benchmark v1 (golden corpus + CI trend artifacts)
-- ⏳ Floating anchor text-wrap collision fidelity (pixel-level)
-- ⏳ Word table auto layout parity with desktop Word
-- ⏳ OMML high-fidelity renderer (MathML/KaTeX pipeline)
+- ✅ React adapter + Vue adapter
+- ✅ Events and imperative public API
+- ✅ Strict-only parser strategy
+
+### Import Pipeline
+
+- ✅ Clipboard import (`text/html`, `text/plain`)
+- ✅ `.docx` upload + relationship media mapping
+- ✅ Clipboard image hydration (`file:/blob:/cid:`)
+- ✅ Output as stable HTML snapshot
+
+### Layout Fidelity
+
+- ✅ List reconstruction (`numId`, `ilvl`, `lvlText`)
+- ✅ Table v1 (`tblGrid/tcW`, merge, border, spacing)
+- ✅ Floating anchors v1 (`wp:anchor` metadata)
+- ⏳ Anchor collision parity (pixel-level wrap)
+
+### Advanced Semantics
+
+- ✅ Footnotes / endnotes / comments
+- ✅ Revision markers (`ins` / `del`) + metadata
+- ✅ Page break semantic markers
+- ✅ DOCX hyperlink relationship + anchor mapping
+
+### Semantic Fallback
+
+- ✅ OMML fallback output
+- ✅ Chart semantic extraction fallback
+- ✅ SmartArt node fallback extraction
+- ⏳ OMML high-fidelity render pipeline (MathML/KaTeX)
+
+### Engineering Quality
+
+- ✅ 50 automated tests (regression + boundary)
+- ✅ Baseline snapshot regression framework
+- ✅ `verify` quality gate (lint/typecheck/test/build/size)
+- ✅ Parse report API for performance tuning
+<!-- GENERATED:FEATURE_CHECKLIST_EN:END -->
 
 ## What's New in v0.1.3
 
@@ -166,6 +188,13 @@ npm run build
 npm run benchmark:fidelity
 ```
 
+## Engineering Modes
+
+- Spec and conventions: [ENGINEERING_MODES.md](./ENGINEERING_MODES.md)
+- Parse API now supports:
+  - `parseDocxToHtmlSnapshot(file)`
+  - `parseDocxToHtmlSnapshotWithReport(file)`
+
 ## Demos
 
 ### React demo

package/README.zh-CN.md

@@ -6,9 +6,16 @@
 [![npm version](https://img.shields.io/npm/v/@coding01/docsjs)](https://www.npmjs.com/package/@coding01/docsjs)
 [![npm downloads](https://img.shields.io/npm/dm/@coding01/docsjs)](https://www.npmjs.com/package/@coding01/docsjs)
 [![CI](https://github.com/fanly/docsjs/actions/workflows/ci.yml/badge.svg)](https://github.com/fanly/docsjs/actions/workflows/ci.yml)
+[![Pages](https://github.com/fanly/docsjs/actions/workflows/pages.yml/badge.svg)](https://github.com/fanly/docsjs/actions/workflows/pages.yml)
 
 [English README](./README.md)
 
+## GitHub Pages
+
+- 产品单页: [https://docsjs.coding01.cn/](https://docsjs.coding01.cn/)
+- 页面源码: `docs/index.html`
+- 自动部署: `.github/workflows/pages.yml`
+
 ## 核心能力
 
 - Web Component 内核：`docs-word-editor`
@@ -90,34 +97,49 @@ document.body.appendChild(el);
 
 ## 功能清单
 
+<!-- GENERATED:FEATURE_CHECKLIST_ZH:START -->
+### 核心
+
 - ✅ Web Component 内核（`docs-word-editor`）
-- ✅ React 适配（`@coding01/docsjs/react`）
-- ✅ Vue 适配（`@coding01/docsjs/vue`）
-- ✅ 粘贴导入（`text/html`、`text/plain`）
-- ✅ 剪贴板不稳定图片源替换（`file:/blob:/cid:/mhtml:` -> data URL）
-- ✅ `.docx` 上传解析
-- ✅ 段落基础语义（对齐、标题映射、换行）
-- ✅ Run 基础样式（粗斜体、下划线、删除线、颜色、高亮、上下标）
-- ✅ 列表基础恢复（`numId` + `ilvl` + `lvlText`）
-- ✅ 表格基础结构（`table/tr/td`）
-- ✅ 表格合并与嵌套表格只读保真（`vMerge/gridSpan`）
-- ✅ 表格宽度映射（`tblGrid/gridCol`、`tcW`）
-- ✅ 图片关系映射（`rId -> media`）
-- ✅ 页面几何映射（页高、页边距、版心宽）
-- ✅ 运行时渲染修正（`mso-*` 兼容、分页 spacer、空段落修正）
-- ✅ 事件与公共 API
-- ✅ React/Vue 可运行示例
-- ✅ npm OIDC 自动发布流水线
-- ✅ 批注/脚注/修订只读语义支持
-- ✅ 批注区间标记（`commentRangeStart/commentRangeEnd`）
-- ✅ 修订元数据标记（`id/author/date`）
-- ✅ 浮动锚点对象 v1 保真（定位参照/层级/避让距离/重叠策略标记）
-- ✅ Word 表格 v1 保真（边框模型/单元格间距/布局类型映射）
-- ✅ OMML/图表/SmartArt 语义降级渲染（v1）
-- ✅ 自动化保真评分 v1（golden corpus + CI 趋势产物）
-- ⏳ 浮动对象文字绕排碰撞的像素级还原
-- ⏳ Word 表格自动布局与桌面 Word 深度一致
-- ⏳ OMML 高保真渲染（MathML/KaTeX 渲染链）
+- ✅ React + Vue 适配层
+- ✅ 事件体系与命令式公开 API
+- ✅ 严格模式唯一解析策略
+
+### 导入链路
+
+- ✅ 剪贴板导入（`text/html`、`text/plain`）
+- ✅ `.docx` 上传与关系媒体映射
+- ✅ 不稳定图片 URI 修复（`file:/blob:/cid:`）
+- ✅ 输出稳定 HTML Snapshot
+
+### 版式保真
+
+- ✅ 列表结构恢复（`numId`、`ilvl`、`lvlText`）
+- ✅ 表格 v1（`tblGrid/tcW`、合并、边框、间距）
+- ✅ 浮动锚点 v1（`wp:anchor` 元数据）
+- ⏳ 锚点碰撞一致性（像素级绕排）
+
+### 高级语义
+
+- ✅ 脚注/尾注/批注
+- ✅ 修订标记（`ins`/`del`）与元数据
+- ✅ 分页语义标记
+- ✅ DOCX 超链接关系与锚点映射
+
+### 语义降级
+
+- ✅ OMML 语义降级输出
+- ✅ 图表语义提取降级
+- ✅ SmartArt 节点降级提取
+- ⏳ OMML 高保真渲染链（MathML/KaTeX）
+
+### 工程质量
+
+- ✅ 50 条自动化测试（回归 + 边界）
+- ✅ 基准快照回归框架
+- ✅ `verify` 质量门禁（lint/typecheck/test/build/size）
+- ✅ 解析报告 API（性能调优）
+<!-- GENERATED:FEATURE_CHECKLIST_ZH:END -->
 
 ## v0.1.3 更新内容
 
@@ -161,6 +183,13 @@ npm run build
 npm run benchmark:fidelity
 ```
 
+## 工程模式
+
+- 规则说明: [ENGINEERING_MODES.md](./ENGINEERING_MODES.md)
+- 解析 API 支持:
+  - `parseDocxToHtmlSnapshot(file)`
+  - `parseDocxToHtmlSnapshotWithReport(file)`
+
 ## 演示
 
 ### React demo

package/dist/{chunk-IBVWD4UO.js → chunk-632UOG2B.js}

@@ -1,3 +1,6 @@
+// src/lib/docxHtml.ts
+import JSZip from "jszip";
+
 // src/lib/htmlSnapshot.ts
 var SNAPSHOT_SHELL_START = '<!DOCTYPE html><html><head><meta charset="utf-8"/>';
 var SNAPSHOT_SHELL_END = "</head><body></body></html>";
@@ -16,7 +19,21 @@ function buildHtmlSnapshot(rawHtml) {
 }
 
 // src/lib/docxHtml.ts
-import JSZip from "jszip";
+function createEmptyFeatureCounts() {
+  return {
+    hyperlinkCount: 0,
+    anchorImageCount: 0,
+    chartCount: 0,
+    smartArtCount: 0,
+    ommlCount: 0,
+    tableCount: 0,
+    footnoteRefCount: 0,
+    endnoteRefCount: 0,
+    commentRefCount: 0,
+    revisionCount: 0,
+    pageBreakCount: 0
+  };
+}
 function escapeHtml(text) {
   return text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
 }
@@ -191,6 +208,19 @@ function normalizeWordPath(relTarget) {
   if (normalized.startsWith("../")) return `word/${normalized.replace(/^(\.\.\/)+/, "")}`;
   return `word/${normalized}`;
 }
+function resolveHyperlinkHref(relMap, rid, anchor) {
+  if (anchor && anchor.trim()) return `#${encodeURIComponent(anchor.trim())}`;
+  if (!rid) return null;
+  const relTarget = relMap[rid];
+  if (!relTarget) return null;
+  const trimmed = relTarget.trim();
+  if (!trimmed) return null;
+  const lower = trimmed.toLowerCase();
+  if (lower.startsWith("http://") || lower.startsWith("https://") || lower.startsWith("mailto:") || lower.startsWith("tel:")) {
+    return trimmed;
+  }
+  return trimmed.startsWith("#") ? trimmed : `#${encodeURIComponent(trimmed)}`;
+}
 async function imageRidToDataUrl(zip, relMap, rid) {
   const relTarget = relMap[rid];
   if (!relTarget) return null;
@@ -365,7 +395,7 @@ function renderEndnotesSection(usedIds, endnotesMap) {
   const items = uniq.map((id) => `<li id="word-endnote-${id}" data-word-endnote-id="${id}">${endnotesMap[id]}</li>`).join("");
   return `<section data-word-endnotes="1"><hr/><ol>${items}</ol></section>`;
 }
-async function paragraphToHtml(zip, relMap, paragraph, paragraphIndex, footnotesMap, usedFootnoteIds, endnotesMap, usedEndnoteIds, commentsMap, usedCommentIds) {
+async function paragraphToHtml(zip, relMap, context, paragraph, paragraphIndex, footnotesMap, usedFootnoteIds, endnotesMap, usedEndnoteIds, commentsMap, usedCommentIds) {
   const tag = paragraphTag(paragraph);
   const alignStyle = paragraphAlignStyle(paragraph);
   const dataAttr = paragraphDataAttr(paragraphIndex);
@@ -406,6 +436,7 @@ async function paragraphToHtml(zip, relMap, paragraph, paragraphIndex, footnotes
     const footnoteRef = queryByLocalName(run, "footnoteReference");
     const footnoteId = getAttr(footnoteRef, "w:id") ?? getAttr(footnoteRef, "id");
     if (footnoteId && footnotesMap[footnoteId]) {
+      context.features.footnoteRefCount += 1;
       usedFootnoteIds.push(footnoteId);
       result.push(
         `<sup data-word-footnote-ref="${footnoteId}"><a href="#word-footnote-${footnoteId}">[${footnoteId}]</a></sup>`
@@ -415,6 +446,7 @@ async function paragraphToHtml(zip, relMap, paragraph, paragraphIndex, footnotes
     const endnoteRef = queryByLocalName(run, "endnoteReference");
     const endnoteId = getAttr(endnoteRef, "w:id") ?? getAttr(endnoteRef, "id");
     if (endnoteId && endnotesMap[endnoteId]) {
+      context.features.endnoteRefCount += 1;
       usedEndnoteIds.push(endnoteId);
       result.push(
         `<sup data-word-endnote-ref="${endnoteId}"><a href="#word-endnote-${endnoteId}">[${endnoteId}]</a></sup>`
@@ -424,6 +456,7 @@ async function paragraphToHtml(zip, relMap, paragraph, paragraphIndex, footnotes
     const commentRef = queryByLocalName(run, "commentReference");
     const commentId = getAttr(commentRef, "w:id") ?? getAttr(commentRef, "id");
     if (commentId && commentsMap[commentId]) {
+      context.features.commentRefCount += 1;
       usedCommentIds.push(commentId);
       result.push(
         `<sup data-word-comment-ref="${commentId}"><a href="#word-comment-${commentId}">[c${commentId}]</a></sup>`
@@ -441,6 +474,7 @@ async function paragraphToHtml(zip, relMap, paragraph, paragraphIndex, footnotes
           const dimensionAttrs = imageDimensionAttributes(imageSize);
           const anchorMeta = parseAnchorMeta(drawing);
           const attrs = mergeImageStyle(dimensionAttrs, anchorMeta);
+          if (anchorMeta) context.features.anchorImageCount += 1;
           result.push(`<img src="${src}" alt="word-image"${attrs}/>`);
           return result;
         }
@@ -451,6 +485,7 @@ async function paragraphToHtml(zip, relMap, paragraph, paragraphIndex, footnotes
         const chartXmlText = await readXmlByRid(zip, relMap, chartRid);
         if (chartXmlText) {
           const summary = parseChartSummary(chartXmlText);
+          context.features.chartCount += 1;
           result.push(
             `<figure data-word-chart="1" data-word-chart-type="${summary.type}" data-word-chart-series="${summary.seriesCount}" data-word-chart-points="${summary.pointCount}"><figcaption>${escapeHtml(summary.title)}</figcaption><div>Chart(${escapeHtml(summary.type)}): series=${summary.seriesCount}, points=${summary.pointCount}</div></figure>`
           );
@@ -462,6 +497,7 @@ async function paragraphToHtml(zip, relMap, paragraph, paragraphIndex, footnotes
       if (smartArtRid) {
         const diagramXmlText = await readXmlByRid(zip, relMap, smartArtRid);
         const textItems = diagramXmlText ? extractSmartArtText(diagramXmlText) : [];
+        context.features.smartArtCount += 1;
         const preview = textItems.length > 0 ? `: ${escapeHtml(textItems.join(" / "))}` : "";
         result.push(
           `<figure data-word-smartart="1" data-word-smartart-items="${textItems.length}"><figcaption>SmartArt fallback${preview}</figcaption></figure>`
@@ -483,12 +519,14 @@ async function paragraphToHtml(zip, relMap, paragraph, paragraphIndex, footnotes
       if (css) {
         const span = `<span style="${css}">${runText2}</span>`;
         if (revisionMeta) {
+          context.features.revisionCount += 1;
           const tagName = revisionMeta.type === "ins" ? "ins" : "del";
           result.push(`<${tagName} ${revisionMetaAttrs(revisionMeta)}>${span}</${tagName}>`);
         } else {
           result.push(span);
         }
       } else if (revisionMeta) {
+        context.features.revisionCount += 1;
         const tagName = revisionMeta.type === "ins" ? "ins" : "del";
         result.push(`<${tagName} ${revisionMetaAttrs(revisionMeta)}>${runText2}</${tagName}>`);
       } else {
@@ -496,6 +534,7 @@ async function paragraphToHtml(zip, relMap, paragraph, paragraphIndex, footnotes
       }
     }
     for (let i = 0; i < pageBreakCount; i += 1) {
+      context.features.pageBreakCount += 1;
       result.push(`<span data-word-page-break="1" style="display:block;break-before:page"></span>`);
     }
     return result;
@@ -512,9 +551,25 @@ async function paragraphToHtml(zip, relMap, paragraph, paragraphIndex, footnotes
     if (node.localName === "r") {
       return runToHtml(node, revisionFallback);
     }
+    if (node.localName === "hyperlink") {
+      const rid = getAttr(node, "r:id") ?? getAttr(node, "id");
+      const anchor = getAttr(node, "w:anchor") ?? getAttr(node, "anchor");
+      const href = resolveHyperlinkHref(relMap, rid, anchor);
+      const nested2 = [];
+      for (const child of Array.from(node.children)) {
+        nested2.push(...await nodeToHtml(child, revisionFallback));
+      }
+      const content2 = nested2.join("") || escapeHtml(node.textContent ?? "");
+      if (!href) return content2 ? [content2] : [];
+      context.features.hyperlinkCount += 1;
+      return [
+        `<a data-word-hyperlink="1" href="${escapeHtml(href)}" rel="noreferrer noopener" target="_blank">${content2}</a>`
+      ];
+    }
     if (node.localName === "oMath" || node.localName === "oMathPara") {
       const linear = ommlNodeToText(node).trim();
       if (!linear) return [];
+      context.features.ommlCount += 1;
       return [`<span data-word-omml="1">${escapeHtml(linear)}</span>`];
     }
     if (node.localName === "ins" || node.localName === "del") {
@@ -534,6 +589,7 @@ async function paragraphToHtml(zip, relMap, paragraph, paragraphIndex, footnotes
   const parts = [];
   const renderedPageBreakCount = queryAllByLocalName(paragraph, "lastRenderedPageBreak").length;
   for (let i = 0; i < renderedPageBreakCount; i += 1) {
+    context.features.pageBreakCount += 1;
     parts.push(`<span data-word-page-break="1" style="display:block;break-before:page"></span>`);
   }
   for (const child of Array.from(paragraph.children)) {
@@ -662,7 +718,7 @@ function parseCellBorderStyle(cell, tableStyle) {
   const left = parseBorderCss(directChildrenByLocalName(tcBorders, "left")[0] ?? null) ?? tableStyle.insideVCss ?? tableStyle.borderCss;
   return `border-top:${top};border-right:${right};border-bottom:${bottom};border-left:${left}`;
 }
-function tableCellHtml(cell, paragraphIndexMap) {
+function tableCellHtml(cell, paragraphIndexMap, context) {
   const blocks = [];
   for (const child of Array.from(cell.children)) {
     if (child.localName === "tcPr") continue;
@@ -672,7 +728,7 @@ function tableCellHtml(cell, paragraphIndexMap) {
       continue;
     }
     if (child.localName === "tbl") {
-      blocks.push(tableToHtml(child, paragraphIndexMap));
+      blocks.push(tableToHtml(child, paragraphIndexMap, context));
       continue;
     }
   }
@@ -680,7 +736,8 @@ function tableCellHtml(cell, paragraphIndexMap) {
   const text = queryAllByLocalName(cell, "t").map((t) => t.textContent ?? "").join("").trim();
   return escapeHtml(text) || "<br/>";
 }
-function tableToHtml(table, paragraphIndexMap) {
+function tableToHtml(table, paragraphIndexMap, context) {
+  context.features.tableCount += 1;
   const rows = directChildrenByLocalName(table, "tr");
   const gridWidthsPx = parseTblGridWidthsPx(table);
   const tableStyle = parseTableStyleProfile(table);
@@ -708,7 +765,7 @@ function tableToHtml(table, paragraphIndexMap) {
       while (activeByCol.has(colCursor)) {
         colCursor += 1;
       }
-      const html = tableCellHtml(cell, paragraphIndexMap);
+      const html = tableCellHtml(cell, paragraphIndexMap, context);
       const attrs = [];
       const widthStyle = parseCellWidthStyle(cell, colCursor, colSpan, gridWidthsPx);
       const borderStyle = parseCellBorderStyle(cell, tableStyle);
@@ -752,7 +809,9 @@ function tableToHtml(table, paragraphIndexMap) {
   const spacing = tableStyle.borderSpacingPx > 0 ? `border-spacing:${tableStyle.borderSpacingPx.toFixed(2)}px;` : "";
   return `<table style="border-collapse:${tableStyle.borderCollapse};${spacing}table-layout:${tableStyle.tableLayout};${tableWidthStyle};border:${tableStyle.borderCss};">${merged}</table>`;
 }
-async function parseDocxToHtmlSnapshot(file) {
+async function parseDocxToHtmlSnapshotWithReport(file) {
+  const startedAt = Date.now();
+  const context = { features: createEmptyFeatureCounts() };
   const maybeArrayBuffer = file.arrayBuffer;
   const buffer = maybeArrayBuffer ? await maybeArrayBuffer.call(file) : await new Response(file).arrayBuffer();
   const zip = await JSZip.loadAsync(buffer);
@@ -789,6 +848,7 @@ async function parseDocxToHtmlSnapshot(file) {
         await paragraphToHtml(
           zip,
           relMap,
+          context,
           child,
           paragraphIndex,
           footnotesMap,
@@ -802,14 +862,24 @@ async function parseDocxToHtmlSnapshot(file) {
       continue;
     }
     if (child.localName === "tbl") {
-      blockHtml.push(tableToHtml(child, paragraphIndexMap));
+      blockHtml.push(tableToHtml(child, paragraphIndexMap, context));
       continue;
     }
   }
   blockHtml.push(renderFootnotesSection(usedFootnoteIds, footnotesMap));
   blockHtml.push(renderEndnotesSection(usedEndnoteIds, endnotesMap));
   blockHtml.push(renderCommentsSection(usedCommentIds, commentsMap));
-  return buildHtmlSnapshot(blockHtml.join("\n"));
+  return {
+    htmlSnapshot: buildHtmlSnapshot(blockHtml.join("\n")),
+    report: {
+      elapsedMs: Date.now() - startedAt,
+      features: context.features
+    }
+  };
+}
+async function parseDocxToHtmlSnapshot(file) {
+  const result = await parseDocxToHtmlSnapshotWithReport(file);
+  return result.htmlSnapshot;
 }
 
 // src/lib/pastePipeline.ts
@@ -1940,7 +2010,7 @@ function applyWordRenderModel({ doc, styleProfile, showFormattingMarks }) {
 }
 
 // src/core/DocsWordElement.ts
-var VERSION = "0.1.2";
+var VERSION = "0.1.5";
 var MESSAGES = {
   zh: {
     readClipboard: "\u4ECE\u7CFB\u7EDF\u526A\u8D34\u677F\u8BFB\u53D6",
@@ -2083,15 +2153,15 @@ var DocsWordElement = class extends HTMLElement {
   }
   async applyDocx(file) {
     try {
-      const [snapshot, profile] = await Promise.all([
-        parseDocxToHtmlSnapshot(file),
+      const [parseResult, profile] = await Promise.all([
+        parseDocxToHtmlSnapshotWithReport(file),
         parseDocxStyleProfile(file)
       ]);
       this.styleProfile = profile;
-      this.htmlSnapshot = snapshot;
+      this.htmlSnapshot = parseResult.htmlSnapshot;
       this.renderSnapshot();
       this.setHint(MESSAGES[this.locale].loadedWord(profile.sourceFileName));
-      this.emitChange("upload", profile.sourceFileName);
+      this.emitChange("upload", profile.sourceFileName, parseResult.report);
     } catch (error) {
       this.emitError(error instanceof Error ? error.message : MESSAGES[this.locale].parseFailed);
     }
@@ -2151,8 +2221,10 @@ var DocsWordElement = class extends HTMLElement {
   renderSnapshot() {
     this.frame.srcdoc = this.htmlSnapshot;
   }
-  emitChange(source, fileName) {
-    this.dispatchEvent(new CustomEvent("docsjs-change", { detail: { htmlSnapshot: this.htmlSnapshot, source, fileName } }));
+  emitChange(source, fileName, parseReport) {
+    this.dispatchEvent(
+      new CustomEvent("docsjs-change", { detail: { htmlSnapshot: this.htmlSnapshot, source, fileName, parseReport } })
+    );
   }
   emitError(message) {
     this.dispatchEvent(new CustomEvent("docsjs-error", { detail: { message } }));
@@ -2187,7 +2259,9 @@ function defineDocsWordElement() {
 }
 
 export {
+  parseDocxToHtmlSnapshotWithReport,
+  parseDocxToHtmlSnapshot,
   DocsWordElement,
   defineDocsWordElement
 };
-//# sourceMappingURL=chunk-IBVWD4UO.js.map
+//# sourceMappingURL=chunk-632UOG2B.js.map