feat: 建立 DOCX 主题映射引擎

2026-07-30 20:28:47 +08:00
parent e7c688df6e
commit 6fed666f44
15 changed files with 851 additions and 25 deletions
@@ -0,0 +1,25 @@
+# @md-to-pdf/docx-theme-engine
+
+DOCX 主题映射引擎负责在浏览器主题 CSS 与 Word 样式之间建立稳定、可诊断
+的中间协议。
+
+当前阶段包含：
+
+- 标准 Markdown 与结构化文档语义槽位；
+- Chromium/Electron 计算样式快照协议；
+- Word 目标样式令牌；
+- 自动映射、显式覆盖和预设降级配置；
+- 样式来源、映射置信度和诊断协议；
+- 旧版 `docxStyle.preset` 兼容归一化。
+
+本包不负责：
+
+- 启动 Playwright 或 Electron；
+- 读取主题目录或网络资源；
+- 执行 Pandoc；
+- 直接修改 OOXML；
+- 按主题 ID 维护专属转换分支。
+
+后续 Chromium 与 Electron 适配器只负责采集标准样式探针的
+`getComputedStyle()` 结果。本包负责将快照归一化为 DOCX 样式令牌，
+`@md-to-pdf/docx-engine` 再消费令牌生成 `reference.docx` 和最终 OOXML。