MorphDoc/packages/docx-theme-engine/README.md

@md-to-pdf/docx-theme-engine

DOCX 主题映射引擎负责在浏览器主题 CSS 与 Word 样式之间建立稳定、可诊断 的中间协议。

当前阶段包含：

• 56 个标准 Markdown 与结构化文档语义槽位；
• 覆盖普通文档、公文、简报、项目报告和标书的标准探针 DOM；
• Chromium/Electron 计算样式快照协议；
• 不绑定具体浏览器实现的计算样式采集器；
• 可安全注入主题 CSS、等待字体并自动清理 iframe 的浏览器运行脚本；
• 基于主题 CSS SHA-256 指纹的并发合并和 LRU 快照缓存；
• Word 目标样式令牌；
• 自动映射、显式覆盖和预设降级配置；
• 样式来源、映射置信度和诊断协议；
• 旧版 docxStyle.preset 兼容归一化。

本包不负责：

• 启动 Playwright 或 Electron；
• 读取主题目录或网络资源；
• 执行 Pandoc；
• 直接修改 OOXML；
• 按主题 ID 维护专属转换分支。

Server Playwright 与 Desktop Electron 适配器负责在现有受限浏览器生命周期 中执行本包脚本；主题 CSS 和字体资源继续使用各平台已有的同源资源协议。 本包下一步负责将快照归一化为 DOCX 样式令牌， @md-to-pdf/docx-engine 再消费令牌生成 reference.docx 和最终 OOXML。