Cursor rule

1---
2description: Project architecture and crate structure for skia-rs
3globs: ["**/*.rs", "**/Cargo.toml"]
4alwaysApply: true
5---
6 
7# Skia-RS Architecture
8 
9Skia-RS is a 100% Rust implementation of Google's Skia 2D graphics library, designed for API compatibility with the original C++ Skia library. The project provides both a native Rust API and C FFI bindings for cross-language interoperability.
10 
11## Workspace Structure
12 
13```
14skia-rs/
15├── crates/
16│   ├── skia-rs-core/     # Foundation: Scalar, Point, Rect, Color, Matrix, ImageInfo
17│   ├── skia-rs-path/     # Path geometry: Path, PathBuilder, PathOps, PathEffects
18│   ├── skia-rs-paint/    # Styling: Paint, Shaders, BlendModes, Filters
19│   ├── skia-rs-canvas/   # Drawing: Canvas, Surface, Picture recording
20│   ├── skia-rs-text/     # Typography: Font loading, text shaping, layout
21│   ├── skia-rs-gpu/      # GPU backends: Vulkan, OpenGL, WebGPU
22│   ├── skia-rs-codec/    # Image I/O: PNG, JPEG, GIF, WebP
23│   ├── skia-rs-svg/      # SVG support: parsing and rendering
24│   ├── skia-rs-pdf/      # PDF generation
25│   ├── skia-rs-ffi/      # C API bindings for FFI
26│   ├── skia-rs-safe/     # High-level ergonomic Rust API
27│   └── skia-rs-bench/    # Performance benchmarks
28├── fuzz/                 # Fuzz testing with cargo-fuzz/libFuzzer
29├── skia/                 # Official Skia submodule (reference)
30└── TODO.md              # Development roadmap
31```
32 
33## Crate Dependencies
34 
35```
36skia-rs-core (no internal deps)
37    ↓
38skia-rs-path (depends on: core)
39    ↓
40skia-rs-paint (depends on: core, path)
41    ↓
42skia-rs-canvas (depends on: core, path, paint)
43    ↓
44skia-rs-text (depends on: core, path, paint)
45    ↓
46skia-rs-gpu (depends on: core, path, paint, canvas)
47skia-rs-codec (depends on: core)
48skia-rs-svg (depends on: core, path, paint, canvas)
49skia-rs-pdf (depends on: core, path, paint, canvas, text)
50    ↓
51skia-rs-ffi (depends on: all above)
52skia-rs-safe (depends on: all above, re-exports)
53```
54 
55## File Organization
56 
57Each crate should follow this structure:
58 
59```
60crates/skia-rs-{name}/
61├── Cargo.toml
62├── src/
63│   ├── lib.rs          # Module declarations and re-exports
64│   ├── {feature}.rs    # Feature implementations
65│   └── ...
66```
67 
68## Re-exports
69 
70- `lib.rs` should re-export all public types
71- Use `pub use module::*;` for complete re-exports
72- Group related items in modules
73 
74```rust
75// lib.rs
76pub mod color;
77pub mod geometry;
78pub mod matrix;
79 
80pub use color::*;
81pub use geometry::*;
82pub use matrix::*;
83```
84