feat: add reference docs for shape, table, image, chart, slide, master, output, coordinate

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

reference/text.md

@@ -0,0 +1,391 @@
+# 文字参数 (Text Props)
+
+文字参数来自 `TextPropsOptions`（继承 `TextBaseProps`、`PositionProps`、`ObjectNameProps`）和 `TextGlowProps`，用于 `slide.addText()` 方法。
+
+---
+
+## 基础文字属性 (TextBaseProps)
+
+- **align**：水平对齐方式
+  - 类型：`'left' | 'center' | 'right' | 'justify'`
+  - 取值范围：`left`、`center`、`right`、`justify`
+  - 默认值：`'left'`
+
+- **bold**：粗体样式
+  - 类型：`boolean`
+  - 取值范围：`true` / `false`
+  - 默认值：`false`
+
+- **breakLine**：添加换行符
+  - 类型：`boolean`
+  - 取值范围：`true` / `false`
+  - 默认值：`false`
+
+- **bullet**：添加标准或自定义项目符号
+  - 类型：`boolean | BulletOptions`
+  - 取值范围：
+    - `true` — 使用标准项目符号
+    - `false` — 无项目符号
+    - 对象 — 自定义项目符号配置
+  - 默认值：`false`
+  - 子参数：
+    - **bullet.type**：项目符号类型
+      - 类型：`'bullet' | 'number'`
+      - 取值范围：`bullet`、`number`
+      - 默认值：`'bullet'`
+    - **bullet.characterCode**：项目符号字符代码（Unicode）
+      - 类型：`string`
+      - 示例：`'25BA'`（U+25BA 黑色右指向指针）
+    - **bullet.indent**：缩进量（项目符号与文字之间的距离，单位 pt）
+      - 类型：`number`
+      - 取值范围：任意正整数
+      - 默认值：`27`
+    - **bullet.numberType**：编号类型
+      - 类型：`string`
+      - 取值范围：
+        `alphaLcParenBoth` | `alphaLcParenR` | `alphaLcPeriod` | `alphaUcParenBoth` | `alphaUcParenR` |
+        `alphaUcPeriod` | `arabicParenBoth` | `arabicParenR` | `arabicPeriod` | `arabicPlain` |
+        `romanLcParenBoth` | `romanLcParenR` | `romanLcPeriod` | `romanUcParenBoth` | `romanUcParenR` |
+        `romanUcPeriod`
+    - **bullet.numberStartAt**：编号起始值
+      - 类型：`number`
+      - 取值范围：任意正整数
+      - 默认值：`1`
+
+- **color**：文字颜色
+  - 类型：`Color`（`HexColor | ThemeColor`）
+  - 取值范围：6 位十六进制颜色值（不含 `#`）或主题色（`tx1`、`tx2`、`bg1`、`bg2`、`accent1`–`accent6`）
+  - 示例：`'FF0000'`、`pptx.SchemeColor.text1`
+
+- **fontFace**：字体名称
+  - 类型：`string`
+  - 示例：`'Arial'`、`'微软雅黑'`
+
+- **fontSize**：字号
+  - 类型：`number`
+  - 取值范围：`1`–`400`（pt）
+  - 示例：`12`、`24`
+
+- **highlight**：文字高亮颜色
+  - 类型：`HexColor`
+  - 格式：6 位十六进制颜色值（不含 `#`）
+  - 示例：`'FFFF00'`（黄色）
+
+- **italic**：斜体样式
+  - 类型：`boolean`
+  - 取值范围：`true` / `false`
+  - 默认值：`false`
+
+- **lang**：语言
+  - 类型：`string`
+  - 取值范围：ISO 639-1 标准语言代码
+  - 默认值：`'en-US'`
+  - 示例：`'fr-CA'`
+
+- **softBreakBefore**：在文字内容前添加软换行（Shift+Enter）
+  - 类型：`boolean`
+  - 取值范围：`true` / `false`
+  - 默认值：`false`
+  - 始于：v3.5.0
+
+- **tabStops**：制表位
+  - 类型：`Array<{ position: number, alignment?: 'l' | 'r' | 'ctr' | 'dec' }>`
+  - 说明：PowerPoint 段落 > 制表位 > 制表位位置
+  - 示例：`[{ position: 1 }, { position: 3 }]`
+  - 子参数：
+    - **position**：制表位位置（英寸）
+    - **alignment**：对齐方式（可选），`'l'`（左）、`'r'`（右）、`'ctr'`（居中）、`'dec'`（小数点）
+
+- **textDirection**：文字方向
+  - 类型：`'horz' | 'vert' | 'vert270' | 'wordArtVert'`
+  - 取值范围：
+    - `horz` — 水平
+    - `vert` — 旋转 90 度
+    - `vert270` — 旋转 270 度
+    - `wordArtVert` — 堆叠
+  - 默认值：`'horz'`
+
+- **transparency**：透明度
+  - 类型：`number`
+  - 取值范围：`0`–`100`（百分比）
+  - 默认值：`0`
+
+- **underline**：下划线属性
+  - 类型：`{ style?: string, color?: Color }`
+  - 子参数：
+    - **underline.style**：下划线样式
+      - 类型：`string`
+      - 取值范围：
+        `'dash'` | `'dashHeavy'` | `'dashLong'` | `'dashLongHeavy'` | `'dbl'` | `'dotDash'` |
+        `'dotDashHeave'` | `'dotDotDash'` | `'dotDotDashHeavy'` | `'dotted'` | `'dottedHeavy'` |
+        `'heavy'` | `'none'` | `'sng'` | `'wavy'` | `'wavyDbl'` | `'wavyHeavy'`
+    - **underline.color**：下划线颜色
+      - 类型：`Color`
+
+- **valign**：垂直对齐
+  - 类型：`'top' | 'middle' | 'bottom'`
+  - 取值范围：`top`、`middle`、`bottom`
+  - 默认值：`'top'`
+
+---
+
+## 文字专有属性 (TextPropsOptions 特有)
+
+- **baseline**：基线偏移
+  - 类型：`number`
+
+- **charSpacing**：字符间距
+  - 类型：`number`
+
+- **fit**：文本适配方式
+  - 类型：`'none' | 'shrink' | 'resize'`
+  - 取值范围：
+    - `none` — 不自动调整
+    - `shrink` — 溢出时缩小文字
+    - `resize` — 调整形状以适配文字
+  - 默认值：`'none'`
+  - 始于：v3.3.0
+
+- **fill**：形状填充
+  - 类型：`ShapeFillProps`
+  - 子参数：
+    - **fill.color**：填充颜色
+      - 类型：`Color`
+      - 格式：`HexColor`（6 位十六进制无 `#`）或 `ThemeColor`
+    - **fill.transparency**：透明度
+      - 类型：`number`
+      - 取值范围：`0`–`100`
+      - 默认值：`0`
+    - **fill.type**：填充类型
+      - 类型：`'none' | 'solid'`
+      - 默认值：`'solid'`
+
+- **flipH**：水平翻转
+  - 类型：`boolean`
+  - 取值范围：`true` / `false`
+  - 默认值：`false`
+
+- **flipV**：垂直翻转
+  - 类型：`boolean`
+  - 取值范围：`true` / `false`
+  - 默认值：`false`
+
+- **glow**：发光效果
+  - 类型：`TextGlowProps`
+  - 子参数：
+    - **glow.color**：发光颜色
+      - 类型：`HexColor`
+      - 格式：6 位十六进制（无 `#`）
+    - **glow.opacity**：不透明度
+      - 类型：`number`
+      - 取值范围：`0.0`–`1.0`
+    - **glow.size**：发光大小
+      - 类型：`number`
+      - 单位：pt
+
+- **hyperlink**：超链接
+  - 类型：`HyperlinkProps`
+  - 子参数：
+    - **hyperlink.slide**：链接到页码
+      - 类型：`number`
+    - **hyperlink.url**：链接 URL
+      - 类型：`string`
+    - **hyperlink.tooltip**：超链接提示
+      - 类型：`string`
+
+- **indentLevel**：缩进层级
+  - 类型：`number`
+
+- **isTextBox**：是否为文本框
+  - 类型：`boolean`
+
+- **line**：线条（边框/轮廓线）
+  - 类型：`ShapeLineProps`
+  - 子参数（继承 `ShapeFillProps`）：
+    - **line.color**：线条颜色
+      - 类型：`Color`
+    - **line.transparency**：线条透明度
+      - 类型：`number`
+      - 取值范围：`0`–`100`
+    - **line.type**：填充类型
+      - 类型：`'none' | 'solid'`
+    - **line.width**：线条宽度
+      - 类型：`number`
+      - 单位：pt
+      - 默认值：`1`
+    - **line.dashType**：虚线类型
+      - 类型：`string`
+      - 取值范围：`'solid' | 'dash' | 'dashDot' | 'lgDash' | 'lgDashDot' | 'lgDashDotDot' | 'sysDash' | 'sysDot'`
+      - 默认值：`'solid'`
+    - **line.beginArrowType**：起点箭头类型
+      - 类型：`'none' | 'arrow' | 'diamond' | 'oval' | 'stealth' | 'triangle'`
+    - **line.endArrowType**：终点箭头类型
+      - 类型：`'none' | 'arrow' | 'diamond' | 'oval' | 'stealth' | 'triangle'`
+
+- **lineSpacing**：行间距（固定值）
+  - 类型：`number`
+  - 单位：pt
+  - 说明：PowerPoint 段落 > 缩进和间距 > 行距 > "固定值"
+  - 示例：`28`
+
+- **lineSpacingMultiple**：行间距（倍数）
+  - 类型：`number`
+  - 取值范围：`0.0`–`9.99`
+  - 单位：百分比倍数
+  - 说明：PowerPoint 段落 > 缩进和间距 > 行距 > "多倍行距"
+  - 示例：`1.5`（1.5 倍行距）
+  - 始于：v3.5.0
+
+- **margin**：边距
+  - 类型：`Margin`（`number | [number, number, number, number]`）
+  - 单位：pt
+  - 说明：PowerPoint 设置形状格式 > 形状选项 > 大小与属性 > 文本框 > 左右上下边距
+  - 默认值：PowerPoint 默认 "常规" 边距
+  - 示例：`0`（四边统一）、`[10, 5, 10, 5]`（上、右、下、左）
+
+- **outline**：文字轮廓
+  - 类型：`{ color: Color, size: number }`
+  - 子参数：
+    - **outline.color**：轮廓颜色
+      - 类型：`Color`
+    - **outline.size**：轮廓大小
+      - 类型：`number`
+      - 单位：pt
+
+- **paraSpaceAfter**：段后间距
+  - 类型：`number`
+
+- **paraSpaceBefore**：段前间距
+  - 类型：`number`
+
+- **placeholder**：占位符类型
+  - 类型：`string`
+  - 示例：`'body'`
+
+- **rectRadius**：圆角矩形半径
+  - 类型：`number`
+  - 取值范围：`0.0`–`1.0`
+  - 默认值：`0`
+  - 说明：仅适用于 `ROUNDED_RECTANGLE` 形状
+
+- **rotate**：旋转角度
+  - 类型：`number`
+  - 取值范围：`-360`–`360`（度）
+  - 默认值：`0`
+
+- **rtlMode**：从右向左模式
+  - 类型：`boolean`
+  - 取值范围：`true` / `false`
+  - 默认值：`false`
+
+- **shadow**：阴影
+  - 类型：`ShadowProps`
+  - 子参数：
+    - **shadow.type**：阴影类型
+      - 类型：`'outer' | 'inner' | 'none'`
+      - 默认值：`'none'`
+    - **shadow.opacity**：不透明度
+      - 类型：`number`
+      - 取值范围：`0.0`–`1.0`
+    - **shadow.blur**：模糊
+      - 类型：`number`
+      - 取值范围：`0`–`100`（pt）
+      - 默认值：`0`
+    - **shadow.angle**：角度
+      - 类型：`number`
+      - 取值范围：`0`–`359`（度）
+      - 默认值：`0`
+    - **shadow.offset**：偏移距离
+      - 类型：`number`
+      - 取值范围：`0`–`200`（pt）
+      - 默认值：`0`
+    - **shadow.color**：阴影颜色
+      - 类型：`HexColor`
+      - 格式：6 位十六进制（无 `#`）
+    - **shadow.rotateWithShape**：阴影是否随形状旋转
+      - 类型：`boolean`
+      - 默认值：`false`
+
+- **shape**：形状名称
+  - 类型：`SHAPE_NAME`
+  - 说明：将文字转为指定形状
+
+- **strike**：删除线
+  - 类型：`boolean | 'dblStrike' | 'sngStrike'`
+  - 取值范围：`true`（单删除线）、`false`、`'dblStrike'`（双删除线）、`'sngStrike'`（单删除线）
+
+- **subscript**：下标
+  - 类型：`boolean`
+  - 取值范围：`true` / `false`
+  - 默认值：`false`
+
+- **superscript**：上标
+  - 类型：`boolean`
+  - 取值范围：`true` / `false`
+  - 默认值：`false`
+
+- **vert**：垂直文字模式
+  - 类型：`string`
+  - 取值范围：
+    `'eaVert'` | `'horz'` | `'mongolianVert'` | `'vert'` | `'vert270'` | `'wordArtVert'` | `'wordArtVertRtl'`
+
+- **wrap**：文字自动换行
+  - 类型：`boolean`
+  - 取值范围：`true` / `false`
+  - 默认值：`true`
+  - 始于：v3.3.0
+
+---
+
+## 位置属性 (PositionProps)
+
+- **x**：水平位置
+  - 类型：`Coord`（`number | `${number}%``）
+  - 单位：英寸（number）或百分比（`'50%'`）
+
+- **y**：垂直位置
+  - 类型：`Coord`
+  - 单位：英寸或百分比
+
+- **w**：宽度
+  - 类型：`Coord`
+  - 单位：英寸或百分比
+
+- **h**：高度
+  - 类型：`Coord`
+  - 单位：英寸或百分比
+
+---
+
+## 对象名称属性 (ObjectNameProps)
+
+- **objectName**：对象名称
+  - 类型：`string`
+  - 说明：替代默认的 "Object N" 名称，在 PowerPoint 选择窗格中显示
+  - 默认值：`'Object 1'`
+  - 始于：v3.10.0
+
+---
+
+## TextProps
+
+- **text**：文字内容
+  - 类型：`string`
+- **options**：文字选项
+  - 类型：`TextPropsOptions`
+
+---
+
+## 已废弃参数
+
+以下参数已废弃，建议使用替代参数：
+
+| 已废弃参数 | 替代参数 | 废弃版本 |
+|---|---|---|
+| `autoFit` | `fit` | v3.3.0 |
+| `shrinkText` | `fit` | v3.3.0 |
+| `inset` | `margin` | v3.10.0 |
+| `lineDash` | `line.dashType` | v3.3.0 |
+| `lineHead` | `line.beginArrowType` | v3.3.0 |
+| `lineSize` | `line.width` | v3.3.0 |
+| `lineTail` | `line.endArrowType` | v3.3.0 |