@coding01/docsjs 0.1.3 → 0.1.5

package/README.md

@@ -3,6 +3,10 @@
 Render-first Word fidelity component for the web.  
 Import Word/WPS/Google Docs content from paste or `.docx` while preserving structure and layout as much as possible.
 
+[![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)
+
 [中文文档](./README.zh-CN.md)
 
 ## What You Get
@@ -101,17 +105,24 @@ el.addEventListener("docsjs-change", (e) => {
 - ✅ 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
-- ⏳ Floating anchors (`wp:anchor`) full layout fidelity
-- ⏳ Merged cells / nested tables full fidelity
-- ⏳ Footnotes / endnotes / comments / track changes
-- ⏳ OMML / charts / SmartArt
-- ⏳ Automated fidelity benchmark scorecard
+- ✅ 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)
 
 ## What's New in v0.1.3
 
@@ -121,15 +132,21 @@ el.addEventListener("docsjs-change", (e) => {
   - footnotes and endnotes (read-only rendering)
   - comments (read-only rendering)
   - revisions insert/delete markers (read-only rendering)
+  - comment range markers and revision metadata attributes
   - page break semantic markers (`w:br type=page`, `lastRenderedPageBreak`)
+  - table width mapping (`tblGrid/gridCol`, `tcW`)
+  - table border model / cell spacing / table-layout mapping
+  - OMML formula fallback rendering and chart/SmartArt semantic fallback
 - Added floating image MVP:
   - anchor position mapping (`wp:anchor`)
   - wrap mode markers (`square`, `tight`, `topAndBottom`, `none`)
+  - anchor layout metadata (`relativeFrom`, `behindDoc`, `allowOverlap`, `layoutInCell`, `relativeHeight`, `dist*`)
 - Added fidelity tooling:
   - semantic stats collector
   - fidelity score calculator
   - baseline regression framework (config-driven)
   - visual regression workflow scaffold (Playwright + diff artifacts)
+  - golden corpus benchmark + trend report workflow (`fidelity-benchmark.yml`)
 - Added engineering quality gates:
   - ESLint + strict verify pipeline (`lint`, `typecheck`, `test`, `build`, `sizecheck`)
   - CI workflow for mandatory quality checks
@@ -146,6 +163,7 @@ npm install
 npm run typecheck
 npm run test
 npm run build
+npm run benchmark:fidelity
 ```
 
 ## Demos
@@ -184,6 +202,15 @@ Workflow: `.github/workflows/publish.yml`
 - Trigger: push tag `v*.*.*`
 - Steps: `npm ci` -> `npm run typecheck` -> `npm run build` -> `npm publish --provenance`
 
+### GitHub Packages (repo sidebar "Packages")
+
+Workflow: `.github/workflows/publish-github-packages.yml`
+
+- Trigger: push tag `v*.*.*` or manual run
+- Target registry: `https://npm.pkg.github.com`
+- Package name in GitHub Packages: `@fanly/docsjs`
+- Note: GitHub sidebar "Packages" only shows packages published to GitHub Packages, not npmjs
+
 ## Roadmap
 
 See [ROADMAP.md](./ROADMAP.md) for prioritized execution plan (P0/P1/P2) and acceptance criteria.

package/README.zh-CN.md

@@ -3,6 +3,10 @@
 面向 Web 的 Render-first Word 高保真导入组件。  
 目标是在粘贴或上传 `.docx` 时，尽可能无损保留 Word/WPS/Google Docs 的结构和版式。
 
+[![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)
+
 [English README](./README.md)
 
 ## 核心能力
@@ -96,17 +100,24 @@ document.body.appendChild(el);
 - ✅ Run 基础样式（粗斜体、下划线、删除线、颜色、高亮、上下标）
 - ✅ 列表基础恢复（`numId` + `ilvl` + `lvlText`）
 - ✅ 表格基础结构（`table/tr/td`）
+- ✅ 表格合并与嵌套表格只读保真（`vMerge/gridSpan`）
+- ✅ 表格宽度映射（`tblGrid/gridCol`、`tcW`）
 - ✅ 图片关系映射（`rId -> media`）
 - ✅ 页面几何映射（页高、页边距、版心宽）
 - ✅ 运行时渲染修正（`mso-*` 兼容、分页 spacer、空段落修正）
 - ✅ 事件与公共 API
 - ✅ React/Vue 可运行示例
 - ✅ npm OIDC 自动发布流水线
-- ⏳ 浮动锚点对象（`wp:anchor`）完整还原
-- ⏳ 合并单元格/嵌套表格完整还原
-- ⏳ 批注/脚注/修订等高级语义
-- ⏳ OMML/图表/SmartArt
-- ⏳ 自动化保真评分体系
+- ✅ 批注/脚注/修订只读语义支持
+- ✅ 批注区间标记（`commentRangeStart/commentRangeEnd`）
+- ✅ 修订元数据标记（`id/author/date`）
+- ✅ 浮动锚点对象 v1 保真（定位参照/层级/避让距离/重叠策略标记）
+- ✅ Word 表格 v1 保真（边框模型/单元格间距/布局类型映射）
+- ✅ OMML/图表/SmartArt 语义降级渲染（v1）
+- ✅ 自动化保真评分 v1（golden corpus + CI 趋势产物）
+- ⏳ 浮动对象文字绕排碰撞的像素级还原
+- ⏳ Word 表格自动布局与桌面 Word 深度一致
+- ⏳ OMML 高保真渲染（MathML/KaTeX 渲染链）
 
 ## v0.1.3 更新内容
 
@@ -116,15 +127,21 @@ document.body.appendChild(el);
   - 脚注与尾注（只读渲染）
   - 批注（只读渲染）
   - 修订新增/删除标记（只读渲染）
+  - 批注区间标记与修订元数据属性
   - 分页语义标记（`w:br type=page`、`lastRenderedPageBreak`）
+  - 表格宽度映射（`tblGrid/gridCol`、`tcW`）
+  - 表格边框模型/单元格间距/布局类型映射
+  - OMML 公式降级渲染、图表/SmartArt 语义降级渲染
 - 浮动图片 MVP：
   - 锚点定位（`wp:anchor`）
   - 绕排模式标记（`square`、`tight`、`topAndBottom`、`none`）
+  - 锚点布局元数据（`relativeFrom`、`behindDoc`、`allowOverlap`、`layoutInCell`、`relativeHeight`、`dist*`）
 - 保真工具链增强：
   - 语义统计器
   - 保真评分器
   - 配置驱动的基准回归测试框架
   - 视觉回归工作流骨架（Playwright + diff artifacts）
+  - golden corpus 基准评分 + 趋势报告工作流（`fidelity-benchmark.yml`）
 - 工程质量门增强：
   - ESLint + 严格 `verify`（`lint/typecheck/test/build/sizecheck`）
   - CI 必过质量门
@@ -141,6 +158,7 @@ npm install
 npm run typecheck
 npm run test
 npm run build
+npm run benchmark:fidelity
 ```
 
 ## 演示
@@ -165,6 +183,13 @@ npm run dev
 
 执行优先级与验收标准见 [ROADMAP.md](./ROADMAP.md)。
 
+## 发布与关联
+
+- npmjs 发布工作流：`.github/workflows/publish.yml`
+- GitHub Packages 发布工作流：`.github/workflows/publish-github-packages.yml`
+- GitHub 侧栏 `Packages` 只显示发布到 GitHub Packages 的包，不显示 npmjs 包
+- 当前 GitHub Packages 包名：`@fanly/docsjs`
+
 ## 安全说明
 
 - 默认策略是保真优先，不主动清洗 Word 内联样式。