# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
## [Unreleased]
---
## [0.3.0] - 2026-03-25
### Added
- **PathBuilder**：基于 `pk::SkPathBuilder` 的 FFI 封装，`snapshot` / `detach`、`set_fill_type`、`add_path` 及与 `Path` 对齐的几何构建 API
- **`RRectType`**：与 `SkRRect::Type` 一致的 cxx 共享枚举，crate 根导出
### Changed
- **OpBuilder**：改为调用 `pk::SkOpBuilder`（FFI），不再在 Rust 内逐次 `path_op`
- **RRect**：移除本地 `sk_rrect_type` 常量，类型判断统一使用 `RRectType`
- **PathFillType**：移除 `from_sk_bits` / `from_raw_bits` / `as_raw_bits`；`is_even_odd`、`is_inverse`、`to_non_inverse` 直接按变体判断
- **`bridge::ffi`**：改为 `pub(crate) mod ffi`，外部仅通过 crate 根 `pub use` 使用公开类型
- **路径效果文档**：去掉「实验性」模块说明（实现未改）
- **构建**：不在上游 `pathkit/pathkit.h` 中增加 include；`SkPathBuilder` 仅在 `pathkit-bridge` 头文件中包含
### Documentation
- 更新 crate 文档中的类型表与若干 API 中英注释
## [0.2.0] - 2026-03-24
### Added
- **PathMeasure**：SkPathMeasure safe 封装，`length`, `pos_tan`, `get_segment`, `set_path`, `is_closed`, `next_contour`
- **描边样式**：`StrokeCap`（Butt, Round, Square）, `StrokeJoin`（Miter, Round, Bevel）
- **描边参数**：`StrokeRec::set_cap`, `set_join`, `set_stroke_params`, `cap`, `join`, `miter_limit`
- **Paint**：SkPaint safe 封装，`PaintStyle`（Fill/Stroke/StrokeAndFill）
- **Paint 方法**：`set_style`, `set_stroke_width`, `set_stroke_cap`, `set_stroke_join`, `set_stroke_miter`, `get_fill_path`
---
## [0.1.0] - 2026-03-24
### Added
- **Path 构建**：`move_to`, `line_to`, `quad_to`, `cubic_to`, `close`
- **Path 形状**：`add_rect`, `add_oval`, `add_circle`, `add_round_rect`, `add_rrect`, `add_rrect_with_start`
- **Path 查询**：`is_empty`, `count_points`, `count_verbs`, `get_point`, `tight_bounds`, `contains`, `is_rect`, `is_rrect`, `conservatively_contains_rect`
- **路径布尔运算**：`path_op`, `OpBuilder`（`add` / `add_ref` 支持引用传入）, Union / Intersect / Difference / Xor / ReverseDifference
- **路径运算**：`simplify`, `pathops_tight_bounds`
- **路径迭代**：`PathIter`, `PathVerbItem`（Move, Line, Quad, Conic, Cubic, Close）
- **描边**：`StrokeRec`（fill, hairline, stroke）, `apply_to_path`
- **类型**：`Path`, `Rect`, `Point`, `RRect`, `Radii`, `Direction`, `RectCorner`, `PathOp`
- **PathEffect（实验性）**：`DashPathEffect`, `CornerPathEffect`（sk_sp 生命周期未完善，使用需注意）
- **构建**：`cargo:rerun-if-changed` 优化增量编译
### Dependencies
- **[pathkit](https://github.com/libpag/pathkit)** — 从 Skia 提取的 PathOps C++ 库，随本 crate 内嵌编译（BSD-3-Clause）
- PathOps C++ library extracted from Skia, vendored and compiled with this crate (BSD-3-Clause)