svgpack_parser 0.1.0

SVG/XML parsing helpers for svgpack.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145

# svgpack

Fast SVG optimizer for build pipelines, implemented in Rust.

This repository contains the first working version of `svgpack` as a Rust workspace with:

- CLI command entrypoint
- Core optimization pipeline orchestration
- Basic parser helpers
- MVP optimizer passes
- Sprite generation (`symbol` format)
- React component code generation
- Duplicate detection
- Basic SVG analysis reporting

## Current status

Version target: `v0.1.0` (MVP foundation).

Implemented:

- `optimize` flow (single file or directory)
- `--in-place`, `--dry-run`, `--stats`, and `--format json`
- `sprite` subcommand
- `codegen` subcommand (`--framework react`)
- `dedup` subcommand
- `analyze` subcommand

## Workspace layout

```
svgpack/
├── Cargo.toml
├── crates/
│   ├── svgpack_cli/
│   ├── svgpack_core/
│   ├── svgpack_parser/
│   ├── svgpack_optimizer/
│   ├── svgpack_sprite/
│   ├── svgpack_codegen/
│   ├── svgpack_dedup/
│   ├── svgpack_analysis/
│   └── svgpack_config/
└── tests/
    └── fixtures/
```

## Build

Requirements:

- Rust stable toolchain
- Cargo

Commands:

```bash
cargo fmt
cargo check
cargo test
```

## CLI usage

Run via cargo:

```bash
cargo run -p svgpack_cli -- <args>
```

Optimize:

```bash
cargo run -p svgpack_cli -- icons/ -o dist/icons/ --stats
```

Optimize in place:

```bash
cargo run -p svgpack_cli -- icons/ --in-place
```

Dry run:

```bash
cargo run -p svgpack_cli -- icons/ --dry-run --stats
```

JSON output:

```bash
cargo run -p svgpack_cli -- icons/ --format json
```

Sprite generation:

```bash
cargo run -p svgpack_cli -- sprite icons/ -o dist/sprite.svg
```

React codegen:

```bash
cargo run -p svgpack_cli -- codegen icons/ -o src/icons/ --framework react --index
```

Duplicate detection:

```bash
cargo run -p svgpack_cli -- dedup icons/
```

Analyze:

```bash
cargo run -p svgpack_cli -- analyze icons/
```

## Config

You can pass a JSON config with `--config`:

```bash
cargo run -p svgpack_cli -- --config svgpack.config.json icons/ -o dist/icons/
```

Supported now:

- `preset`
- `multipass`
- `max_passes`
- `passes` map (`enabled`, `precision`, `prefix`)

## Roadmap

- `v0.2`: stronger path/transforms optimization + better SVGO parity.
- `v0.3`: sprite improvements + React/Vue codegen hardening.
- `v0.4`: build-tool plugins (Vite/Rspack/Webpack) + watch mode.
- `v1.0`: stable API, regression corpus, performance benchmarks.

## Notes

- This is a first version focused on architecture and working command flow.
- Path-data optimization is still minimal and should be expanded in the next iteration.
- Visual regression tests and SVGO compatibility mapping are planned next.