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

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

reference/image.md

@@ -0,0 +1,197 @@
+# 图片参数 (Image Props)
+
+图片参数来自 `ImageProps`（继承 `PositionProps`、`DataOrPathProps`、`ObjectNameProps`），用于 `slide.addImage()` 方法。
+
+---
+
+## 位置属性 (PositionProps)
+
+- **x**：水平位置
+  - 类型：`Coord`（`number | `${number}%``）
+  - 单位：英寸（number）或百分比（`'50%'`）
+
+- **y**：垂直位置
+  - 类型：`Coord`
+  - 单位：英寸或百分比
+
+- **w**：宽度
+  - 类型：`Coord`
+  - 单位：英寸或百分比
+
+- **h**：高度
+  - 类型：`Coord`
+  - 单位：英寸或百分比
+
+---
+
+## 数据/路径属性 (DataOrPathProps)
+
+- **path**：图片 URL 或本地路径
+  - 类型：`string`
+  - 示例：`'https://onedrives.com/myimg.png'`、`'/home/gitbrent/images/myimg.png'`
+
+- **data**：base64 编码数据
+  - 类型：`string`
+  - 格式：`'image/png;base64,iVtDafDrBF[...]='`
+  - 说明：base64 编码的图片数据，用时可避免路径/服务器问题
+
+---
+
+## 对象名称属性 (ObjectNameProps)
+
+- **objectName**：对象名称
+  - 类型：`string`
+  - 说明：替代默认的 "Object N" 名称，在 PowerPoint 选择窗格中显示
+  - 默认值：`'Object 1'`
+  - 始于：v3.10.0
+
+---
+
+## 图片专有属性 (ImageProps)
+
+- **altText**：替代文字（无障碍）
+  - 类型：`string`
+  - 说明：PowerPoint 中右击图片 > "编辑替代文字"
+
+- **flipH**：水平翻转
+  - 类型：`boolean`
+  - 取值范围：`true` / `false`
+  - 默认值：`false`
+
+- **flipV**：垂直翻转
+  - 类型：`boolean`
+  - 取值范围：`true` / `false`
+  - 默认值：`false`
+
+- **hyperlink**：超链接
+  - 类型：`HyperlinkProps`
+  - 子参数：
+    - **hyperlink.slide**：链接到页码
+      - 类型：`number`
+    - **hyperlink.url**：链接 URL
+      - 类型：`string`
+    - **hyperlink.tooltip**：超链接提示
+      - 类型：`string`
+
+- **placeholder**：占位符类型
+  - 类型：`string`
+  - 取值范围：`'body'`、`'header'`、`'footer'`、`'title'` 等
+  - 示例：`'body'`
+
+- **rotate**：旋转角度
+  - 类型：`number`
+  - 取值范围：`-360`–`360`（度）
+  - 默认值：`0`
+  - 示例：`180`（旋转 180 度）
+
+- **rounding**：启用图片圆角
+  - 类型：`boolean`
+  - 默认值：`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`
+
+- **sizing**：图片大小调整
+  - 类型：`{ type: 'contain' | 'cover' | 'crop', w: Coord, h: Coord, x?: Coord, y?: Coord }`
+  - 子参数：
+    - **sizing.type**：调整类型
+      - 类型：`'contain' | 'cover' | 'crop'`
+      - 取值范围：
+        - `contain` — 包含（保持比例适配）
+        - `cover` — 覆盖（填充区域）
+        - `crop` — 裁剪
+    - **sizing.w**：图片宽度
+      - 类型：`Coord`（英寸或百分比）
+    - **sizing.h**：图片高度
+      - 类型：`Coord`（英寸或百分比）
+    - **sizing.x**：裁剪左偏移
+      - 类型：`Coord`（仅用于 `crop` 模式）
+    - **sizing.y**：裁剪上偏移
+      - 类型：`Coord`（仅用于 `crop` 模式）
+
+- **transparency**：透明度
+  - 类型：`number`
+  - 取值范围：`0`–`100`（百分比）
+  - 默认值：`0`
+  - 示例：`25`（25% 透明）
+
+---
+
+## ShadowProps
+
+用于 `shadow` 属性的类型定义（图表、图片、文字通用）。
+
+- **type**：阴影类型
+  - 类型：`'outer' | 'inner' | 'none'`
+  - 默认值：`'none'`
+
+- **opacity**：不透明度
+  - 类型：`number`
+  - 取值范围：`0.0`–`1.0`
+  - 示例：`0.5`（50% 不透明）
+
+- **blur**：模糊大小
+  - 类型：`number`
+  - 取值范围：`0`–`100`（pt）
+  - 默认值：`0`
+
+- **angle**：阴影角度
+  - 类型：`number`
+  - 取值范围：`0`–`359`（度）
+  - 默认值：`0`
+
+- **offset**：阴影偏移距离
+  - 类型：`number`
+  - 取值范围：`0`–`200`（pt）
+  - 默认值：`0`
+
+- **color**：阴影颜色
+  - 类型：`HexColor`
+  - 格式：6 位十六进制（无 `#`）
+
+- **rotateWithShape**：是否随形状旋转
+  - 类型：`boolean`
+  - 默认值：`false`
+
+---
+
+## HyperlinkProps
+
+用于 `hyperlink` 属性的类型定义。
+
+- **slide**：链接到页码
+  - 类型：`number`
+  - 说明：跳转到演示文稿的指定幻灯片
+
+- **url**：超链接 URL
+  - 类型：`string`
+  - 说明：链接到外部网址
+
+- **tooltip**：超链接提示
+  - 类型：`string`
+  - 说明：鼠标悬停时显示的文字