refactor: complete three-layer serial refactoring (knowledge→schema→renderer)

Step 1 — Knowledge base: perfect all reference/*.md with type, range, default, unit
- text.md: add DataOrPathProps, path/data, bullet deprecated params
- chart.md: add deprecated section, fix 19 params with missing elements
- slide.md: add bkgd→background deprecated mapping
- output.md: add masterSlide, presLayout

Step 2 — Schema: align schema/presentation.schema.json with KB
- Add catAxisItem and valAxisItem definitions with full sub-property constraints
- Fix 7 enum constraints (barDir, displayBlanksAs, bar3DShape, etc.)
- Add 4 missing fields (verbose, autoPageCharWeight, autoPageLineWeight, notes,
  masterSlide, presLayout)

Step 3 — Translation engine: transform renderers from passthrough to validation
- index.js: add normalizePosition, normalizeColor, validateEnum shared utilities
- All renderers: position validation, color hex normalization, enum validation
- Image: graceful failure handling (catch load errors, warn, continue)
- Chart: chartType enum validation, data parity check
- Table: colspan/rowspan integer validation, border array check
- Full verification: basic.json and full.json generate valid PPTX

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

reference/chart.md

@@ -202,6 +202,9 @@
 
 - **catAxisLabelFontSize**：轴标签字号
   - 类型：`number`
+  - 单位：pt
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **catAxisLabelFrequency**：标签频率
   - 类型：`string`
@@ -211,6 +214,9 @@
 
 - **catAxisLabelRotate**：标签旋转角度
   - 类型：`number`
+  - 单位：度
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **catAxisLineColor**：轴线颜色
   - 类型：`string`
@@ -220,6 +226,9 @@
 
 - **catAxisLineSize**：轴线粗细
   - 类型：`number`
+  - 单位：pt
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **catAxisLineStyle**：轴线样式
   - 类型：`'solid' | 'dash' | 'dot'`
@@ -232,6 +241,9 @@
 
 - **catAxisMajorUnit**：主要刻度单位
   - 类型：`number`
+  - 单位：无单位（数值刻度）
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **catAxisMaxVal**：轴最大值
   - 类型：`number`
@@ -244,6 +256,9 @@
 
 - **catAxisMinorUnit**：次要刻度单位
   - 类型：`number`
+  - 单位：无单位（数值刻度）
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **catAxisMinVal**：轴最小值
   - 类型：`number`
@@ -269,6 +284,9 @@
 
 - **catAxisTitleRotate**：轴标题旋转
   - 类型：`number`
+  - 单位：度
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **catGridLine**：分类网格线
   - 类型：`OptsChartGridLine`
@@ -307,6 +325,9 @@
 
 - **serAxisLabelFontSize**：系列轴标签字号
   - 类型：`number`
+  - 单位：pt
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **serAxisLabelFrequency**：系列轴标签频率
   - 类型：`string`
@@ -399,6 +420,9 @@
 
 - **valAxisLabelFontSize**：数值轴标签字号
   - 类型：`number`
+  - 单位：pt
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **valAxisLabelFormatCode**：数值轴标签格式代码
   - 类型：`string`
@@ -408,6 +432,9 @@
 
 - **valAxisLabelRotate**：数值轴标签旋转
   - 类型：`number`
+  - 单位：度
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **valAxisLineColor**：数值轴线颜色
   - 类型：`string`
@@ -417,6 +444,9 @@
 
 - **valAxisLineSize**：数值轴线粗细
   - 类型：`number`
+  - 单位：pt
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **valAxisLineStyle**：数值轴线样式
   - 类型：`'solid' | 'dash' | 'dot'`
@@ -431,15 +461,24 @@
 
 - **valAxisMajorUnit**：数值轴主要刻度单位
   - 类型：`number`
+  - 单位：无单位（数值刻度）
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **valAxisMaxVal**：数值轴最大值
   - 类型：`number`
+  - 单位：无单位（数值与数据一致）
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **valAxisMinorTickMark**：数值轴副刻度标记
   - 类型：`ChartAxisTickMark`
 
 - **valAxisMinVal**：数值轴最小值
   - 类型：`number`
+  - 单位：无单位（数值与数据一致）
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **valAxisOrientation**：数值轴方向
   - 类型：`'minMax'`
@@ -473,13 +512,19 @@
 
 - **bar3DShape**：3D 柱形形状
   - 类型：`string`
+  - 取值范围：`'box' | 'cylinder' | 'cone' | 'pyramid'`（PowerPoint 标准值），类型声明为 string，也可接受其他值
+  - 默认值：`'box'`
 
 - **barDir**：柱形方向
   - 类型：`string`
   - 取值范围：`'bar'`（水平）、`'col'`（垂直）
+  - 默认值：`'col'`
 
 - **barGapDepthPct**：3D 柱形深度间距百分比
   - 类型：`number`
+  - 取值范围：`0`–`500`
+  - 默认值：`150`
+  - 单位：%
 
 - **barGapWidthPct**：间距宽度百分比
   - 类型：`number`
@@ -488,6 +533,8 @@
 
 - **barGrouping**：分组方式
   - 类型：`string`
+  - 取值范围：`'clustered' | 'stacked' | 'standard'`（PowerPoint 标准值），类型声明为 string，也可接受其他值
+  - 默认值：`'clustered'`
 
 - **barOverlapPct**：系列重叠百分比
   - 类型：`number`
@@ -501,9 +548,12 @@
 
 - **dataNoEffects**：禁用数据点效果
   - 类型：`boolean`
+  - 默认值：`false`
 
 - **holeSize**：中心孔大小
   - 类型：`number`
+  - 取值范围：`0`–`90`（百分比）
+  - 默认值：`50`
 
 ---
 
@@ -548,6 +598,7 @@
 
 - **dataNoEffects**：禁用数据点效果
   - 类型：`boolean`
+  - 默认值：`false`
 
 - **firstSliceAng**：第一扇区起始角度
   - 类型：`number`
@@ -569,9 +620,12 @@
 
 - **dataLabelBkgrdColors**：数据标签背景色
   - 类型：`boolean`
+  - 默认值：`false`
 
 - **dataLabelColor**：数据标签颜色
   - 类型：`string`
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **dataLabelFontBold**：数据标签粗体
   - 类型：`boolean`
@@ -584,6 +638,9 @@
 
 - **dataLabelFontSize**：数据标签字号
   - 类型：`number`
+  - 单位：pt
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **dataLabelFormatCode**：数据标签格式代码
   - 类型：`string`
@@ -601,6 +658,9 @@
 
 - **dataTableFontSize**：数据表字号
   - 类型：`number`
+  - 单位：pt
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **dataTableFormatCode**：数据表格式代码
   - 类型：`string`
@@ -650,6 +710,8 @@
 
 - **titleAlign**：标题对齐
   - 类型：`string`
+  - 取值范围：`'l' | 'ctr' | 'r'`
+  - 默认值：`'ctr'`
 
 - **titleBold**：标题粗体
   - 类型：`boolean`
@@ -682,6 +744,9 @@
 
 - **size**：网格线粗细
   - 类型：`number`
+  - 单位：pt
+  - 取值范围：无特殊约束范围
+  - 无默认值
 
 - **style**：网格线样式
   - 类型：`'solid' | 'dash' | 'dot' | 'none'`
@@ -705,3 +770,12 @@
 - **altText**：替代文字（无障碍）
   - 类型：`string`
   - 说明：PowerPoint 中右击图表 > "编辑替代文字"
+
+---
+
+## 已废弃参数
+
+| 已废弃参数 | 替代参数 | 废弃版本 |
+|---|---|---|
+| `border` | `plotArea.border` | v3.11.0 |
+| `fill` | `plotArea.fill` | v3.11.0 |

reference/output.md

@@ -154,3 +154,11 @@ type WRITE_OUTPUT_TYPE = JSZIP_OUTPUT_TYPE | 'STREAM'
 
 - **title**：演示文稿标题
   - 类型：`string`
+
+- **masterSlide**：当前母版
+  - 类型：`PresSlide`
+  - 说明：当前演示文稿的母版幻灯片对象
+
+- **presLayout**：布局信息
+  - 类型：`PresLayout`
+  - 说明：只读，包含 `name`（布局名称）、`width`（宽度，英寸）、`height`（高度，英寸）

reference/slide.md

@@ -220,3 +220,4 @@ pptx.addSection(props: SectionProps)
 |---|---|---|
 | `fill` | `ShapeFillProps.color` | v3.6.0 |
 | `src` | `DataOrPathProps.path` | v3.6.0 |
+| `bkgd` (Slide 类) | `background` | v3.3.0 |

reference/text.md

@@ -1,6 +1,6 @@
 # 文字参数 (Text Props)
 
-文字参数来自 `TextPropsOptions`（继承 `TextBaseProps`、`PositionProps`、`ObjectNameProps`）和 `TextGlowProps`，用于 `slide.addText()` 方法。
+文字参数来自 `TextPropsOptions`（继承 `TextBaseProps`、`PositionProps`、`DataOrPathProps`、`ObjectNameProps`）和 `TextGlowProps`，用于 `slide.addText()` 方法。
 
 ---
 
@@ -131,6 +131,16 @@
 
 ## 文字专有属性 (TextPropsOptions 特有)
 
+继承 `DataOrPathProps`，支持以下嵌入图片的属性：
+
+- **path**：图片路径
+  - 类型：`string`
+  - 说明：URL 或本地路径，可在文本框中嵌入图片
+
+- **data**：图片 Base64 数据
+  - 类型：`string`
+  - 说明：Base64 编码的图片数据，替代 `path`
+
 - **baseline**：基线偏移
   - 类型：`number`
 
@@ -231,7 +241,7 @@
 - **lineSpacingMultiple**：行间距（倍数）
   - 类型：`number`
   - 取值范围：`0.0`–`9.99`
-  - 单位：百分比倍数
+  - 单位：倍数（非百分比）
   - 说明：PowerPoint 段落 > 缩进和间距 > 行距 > "多倍行距"
   - 示例：`1.5`（1.5 倍行距）
   - 始于：v3.5.0
@@ -385,6 +395,10 @@
 | `autoFit` | `fit` | v3.3.0 |
 | `shrinkText` | `fit` | v3.3.0 |
 | `inset` | `margin` | v3.10.0 |
+| `bullet.code` | `bullet.characterCode` | v3.3.0 |
+| `bullet.marginPt` | `bullet.indent` | v3.3.0 |
+| `bullet.startAt` | `bullet.numberStartAt` | v3.3.0 |
+| `bullet.style` | `bullet.numberType` | v3.3.0 |
 | `lineDash` | `line.dashType` | v3.3.0 |
 | `lineHead` | `line.beginArrowType` | v3.3.0 |
 | `lineSize` | `line.width` | v3.3.0 |