ppt-dsl-renderer 1.1.8 → 1.1.10

package/AGENT_PPTX_EXPORT.md

@@ -98,11 +98,15 @@ CLI 复用原 `dist/pptx/exporter.js`，没有修改 DSL、Vue/HTML 渲染或 PP
 - 视频封面会转成 PNG 后写入 PPTX；音视频实际内容嵌入文件，不仅保留链接或封面。
 - 渐变／特殊形状、图片填充形状和有路径的公式使用 SVG 图片导出，不能当作原生可编辑形状／公式。无公式路径时沿用当前预览，输出公式源码文字。
 - 标记为 `roundRect` 且路径为标准四角圆框或横向胶囊的普通形状导出为原生圆角矩形，按原路径半径设置 `rectRadius`，支持 Office/WPS 的黄色圆角调节手柄。仅顶部圆角、异形路径及拉伸后角弧为椭圆的形状保留自定义几何，不改变原形状。
-- 闭合直线路径为左右对称、上底较窄且下底铺满 viewBox 的规则梯形导出为原生 `trapezoid`，按缩放后的上底内缩量设置调整参数，支持黄色手柄调整上底宽度／斜边倾斜。不对称梯形、三角形和曲线路径仍保留自定义几何。
+- 闭合直线路径为左右对称、较宽底边铺满 viewBox 的规则正梯形或倒梯形导出为原生 `trapezoid`，按缩放后的窄底内缩量设置调整参数，支持黄色手柄调整窄底宽度／斜边倾斜。倒梯形通过原生几何的垂直翻转保持方向，并与元素原有的垂直翻转叠加。不对称梯形、三角形和曲线路径仍保留自定义几何。
 - 渐变页面背景取首尾色的混合色，渐变文字取显式色标平均色；普通图表使用原生可编辑图表，`bar` 横向、`column` 竖向。表格禁止自动拆成额外页面，保持选定页数；合并区域使用包含占位单元格的完整行列网格，导出时跳过被覆盖的单元格。
+- 表格 `outline` 仅表示整表外框，不生成内部单元格网格线。外框使用无填充的原生矩形保留 RGBA 透明度及实线、虚线、点线样式；表格本身仍为原生可编辑表格，外框是独立对象。
+- HTML 表格按浏览器实际边框导出：仅设置外框时不补单元格网格线，显式单元格边框继续保留；同色但透明度不同的各边分别绘制，不统一成首条边框的透明度。
+- HTML 同一文本流内、同一实际行的连续行内文字合并为一个原生富文本框，保留各段字体、字号、颜色、透明度、粗斜体和文字装饰。浏览器折行、显式换行及独立定位的文字继续分开，避免改变原布局。
 - 默认母版背景取 `document.theme.backgroundColor`，省略时为白色；各页显式背景优先。不把主题字体、颜色自动下沉到所有元素。
 - 普通文本与形状文字的 `inset` 均按「上、右、下、左」解释，单位为 CSS 像素；默认分别为 0px、8px，与网页一致。两者均读取 `lineHeight`、`paragraphSpace`、`wordSpace`，默认行高 1.4、段距和字距为 0；富文本内显式的 `line-height`、`letter-spacing`、段落 `margin-top/bottom` 优先。行高按字号换算为 PPTX 点数，显式换行分别计算；Office 自动折行的混合字号段落仍可能与浏览器存在差异。
-- 字体栈取第一个字体名并进行 XML 属性转义，避免引号或 `&` 破坏 PPTX。图片背景按 `image.size` 导出：默认 `cover` 居中裁切，`contain` 等比完整显示，`stretch` 拉伸；背景图片作为最底层图片对象，留白使用页面背景色。
+- 字体栈按 CSS 顺序选择导出浏览器中可用的具体字体，再进行 XML 属性转义，避免缺失的首选字体被 Office 随意替换。若所有具体候选均缺失，保留首选字体名；单个字体名保持不变。图片背景按 `image.size` 导出：默认 `cover` 居中裁切，`contain` 等比完整显示，`stretch` 拉伸；背景图片作为最底层图片对象，留白使用页面背景色。
+- 图片元素按 `fit` 导出，与网页一致：默认 `cover` 等比居中裁切，`contain` 等比完整显示，只有 `fill` 拉伸。设置 `clip.range` 时先在裁剪前的图片框中应用 `fit`，再显示指定区域，保持元素的位置和尺寸。
 - 富文本里的粗体细对勾 `✓` 导出为可编辑的重对勾 `✔`，避免浏览器字体回退与 Office 固定字体产生明显不同的字形；非粗体细对勾保持原字符。
 - 普通文本、标题及 `fixedHeight` 文本均保持 DSL 的位置和宽高，不再额外扩宽或设置 Office 自动改框。字体不一致导致的换行差异应通过字体环境核对，不能靠修改原框掩盖。
 - 普通文本在网页中实际只有一行时关闭 Office 自动换行，避免大号章节数字被重新拆行；网页已折行、显式多行、列表和竖排保留自动换行。测量使用原字号、字体、字距和扣除左右内边距后的宽度，不改变输入 DSL 或导出文本框尺寸。