docs: 修正 README 管道顺序 + 新增 4 个 Phase 1 mark + 工厂函数

- 管道顺序修正: mark → scale → split → project → label → style → export
- 分离 Theme & Export 为独立小节
- mark 表格新增 area/text/violin/map（10 个已实现）
- 新增 Custom extensions 小节（make_mark/make_theme）
- README_ZH 同步更新

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: zorrooz

README.md

@@ -79,17 +79,17 @@ compose_grid(p1, p2, tag_levels = "A") |>
 Every plotit chart follows a consistent pipeline:
 
 ```
-data |> plotit(encode(...)) |> mark_*() |> scale_*() |> label_*() |> project_*() |> split_*() |> style() |> export()
+data |> plotit(encode(...)) |> mark_*() |> scale_*() |> split_*() |> project_*() |> label_*() |> style() |> export()
 ```
 
 | Step | Verb | Role |
 |:---|:---|:---|
 | 1. Initialise | `plotit()` + `encode()` | Bind data and aesthetic mappings |
 | 2. Layer | `mark_*()` | Add geometric layers (points, lines, bars, …) |
 | 3. Scale | `scale_*()` | Control how data maps to visual properties |
-| 4. Label | `label_*()` | Set titles, axis labels, legend titles |
+| 4. Facet | `split_*()` | Split into small multiples |
 | 5. Coordinate | `project_*()` | Choose coordinate system (cartesian, polar, map) |
-| 6. Facet | `split_*()` | Split into small multiples |
+| 6. Label | `label_*()` | Set titles, axis labels, legend titles |
 | 7. Theme | `style()` | Apply a complete theme |
 | 8. Export | `export()` | Render to file |
 
@@ -107,10 +107,14 @@ compose_*(p1, p2, ...) |> label_*() |> style() |> export()
 |:---|:---|:---|
 | `mark_point()` | `geom_point()` | Scatter plots |
 | `mark_line()` | `geom_line()` | Lines and trends |
+| `mark_area()` | `geom_area()` | Filled area / stream graph |
 | `mark_bar()` | `geom_bar()` / `geom_col()` | Bar charts |
+| `mark_text()` | `geom_text()` / `ggrepel` | Text labels and annotations |
 | `mark_boxplot()` | `geom_boxplot()` | Box-and-whisker plots |
 | `mark_histogram()` | `geom_histogram()` | Histograms |
-| `mark_density()` | `geom_density()` | Kernel density estimates |
+| `mark_density()` | `geom_density()` | 1D kernel density |
+| `mark_violin()` | `geom_violin()` | Violin plots |
+| `mark_map()` | `geom_sf()` | Geographic maps |
 
 ### `scale_*` — Data-to-visual mapping
 
@@ -167,6 +171,13 @@ compose_*(p1, p2, ...) |> label_*() |> style() |> export()
 | `style_default()` | Restore plotit's built-in theme |
 | `export()` | Render to file (pdf, png, svg, …) |
 
+### Custom extensions
+
+| Function | Description |
+|:---|:---|
+| `make_mark()` | Register a custom mark from any ggplot2 geom |
+| `make_theme()` | Create a reusable theme preset function |
+
 ## Documentation
 
 Full documentation is available at [zorrooz.github.io/plotit](https://zorrooz.github.io/plotit/).

README_ZH.md

@@ -76,18 +76,18 @@ compose_grid(p1, p2, tag_levels = "A") |>
 每个 plotit 图表都遵循一致的管道：
 
 ```
-data |> plotit(encode(...)) |> mark_*() |> scale_*() |> label_*() |> project_*() |> split_*() |> style() |> export()
+data |> plotit(encode(...)) |> mark_*() |> scale_*() |> split_*() |> project_*() |> label_*() |> style() |> export()
 ```
 
 | 步骤 | 动词 | 职责 |
 |:---|:---|:---|
 | 1. 初始化 | `plotit()` + `encode()` | 绑定数据与美学映射 |
 | 2. 图层 | `mark_*()` | 添加几何图层（点、线、柱等） |
 | 3. 标度 | `scale_*()` | 控制数据到视觉属性的映射 |
-| 4. 标签 | `label_*()` | 设置标题、轴标签、图例标题 |
+| 4. 分面 | `split_*()` | 拆分为小倍数图 |
 | 5. 坐标 | `project_*()` | 选择坐标系（笛卡尔、极坐标、地图） |
-| 6. 分面 | `split_*()` | 拆分为小倍数图 |
-| 7. 主题 | `style()` | 应用完整主题 |
+| 6. 标签 | `label_*()` | 设置标题、轴标签、图例标题 |
+| 7. 主题 | `style()` | 应用主题样式 |
 | 8. 导出 | `export()` | 渲染为文件 |
 
 多图组合遵循最外层管道：
@@ -104,10 +104,14 @@ compose_*(p1, p2, ...) |> label_*() |> style() |> export()
 |:---|:---|:---|
 | `mark_point()` | `geom_point()` | 散点图 |
 | `mark_line()` | `geom_line()` | 折线与趋势线 |
+| `mark_area()` | `geom_area()` | 面积图/河流图 |
 | `mark_bar()` | `geom_bar()` / `geom_col()` | 柱状图 |
+| `mark_text()` | `geom_text()` / `ggrepel` | 文本标签与数据标注 |
 | `mark_boxplot()` | `geom_boxplot()` | 箱线图 |
 | `mark_histogram()` | `geom_histogram()` | 直方图 |
-| `mark_density()` | `geom_density()` | 核密度估计 |
+| `mark_density()` | `geom_density()` | 1D 核密度估计 |
+| `mark_violin()` | `geom_violin()` | 小提琴图 |
+| `mark_map()` | `geom_sf()` | 地图/地理空间 |
 
 ### `scale_*` — 数据到视觉的映射
 
@@ -164,6 +168,13 @@ compose_*(p1, p2, ...) |> label_*() |> style() |> export()
 | `style_default()` | 恢复 plotit 内置主题 |
 | `export()` | 渲染为文件（pdf、png、svg 等） |
 
+### 自定义扩展
+
+| 函数 | 说明 |
+|:---|:---|
+| `make_mark()` | 基于任意 ggplot2 geom 注册自定义 Mark |
+| `make_theme()` | 创建可复用的主题预设函数 |
+
 ## 文档
 
 完整文档见 [zorrooz.github.io/plotit](https://zorrooz.github.io/plotit/)。