···11+# Volt CLI
22+33+Development tools for the Volt.js project. Uses:
44+55+- `commander` for command-line parsing
66+- `chalk` for colored output
77+- TypeScript Compiler API for parsing source files
88+99+## Installation
1010+1111+From the project root:
1212+1313+```sh
1414+pnpm install
1515+```
1616+1717+The `volt` command will be available after installation.
1818+1919+## Commands
2020+2121+### `volt docs`
2222+2323+Generates API documentation from TypeScript source files.
2424+2525+- Scans all `.ts` files in `src/`
2626+- Extracts JSDoc comments and type signatures
2727+- Outputs markdown files to `docs/api/`
2828+- Supports `@example` tags in JSDoc
2929+3030+Generated documentation includes:
3131+3232+- Function signatures and descriptions
3333+- Interface definitions and members
3434+- Type aliases
3535+- Code examples from `@example` tags
3636+3737+### `volt stats`
3838+3939+Displays lines of code statistics.
4040+4141+- Default: counts code in `src/` only
4242+- Excludes JSDoc comments, single-line comments, and empty lines
4343+- Use `--full` to include test files
4444+4545+Outputs:
4646+4747+- Total files
4848+- Total lines (including comments)
4949+- Code lines (excluding docs/comments)
5050+- Documentation/comment lines
5151+5252+## Development
5353+5454+### Build
5555+5656+```sh
5757+pnpm build
5858+```
5959+6060+Compiles TypeScript to `dist/` using tsdown.
6161+6262+### Test
6363+6464+```sh
6565+pnpm test # Watch mode
6666+pnpm test:run # Single run
6767+```
6868+6969+### Type Check
7070+7171+```sh
7272+pnpm typecheck
7373+```