# bazi-engine

**English** | [中文](./README.md)

A pure-TypeScript bazi (Chinese four-pillars) engine. Produces structured output for shishen (ten gods), hidden stems, and shensha (auspicious/inauspicious stars).

## Install

```bash
npm install @jabberwocky238/bazi-engine
# or
bun add @jabberwocky238/bazi-engine
```

## License

Released under the [MIT](./LICENSE) license. Use, modify, and redistribute freely.

## Contributing

PRs are welcome — bug fixes, new shensha rules, rule refinements, better typings, tests.

## Acknowledgements

- [问真八字 (Wenzhen Bazi)](https://pc.wenzhenbazi.com/) — rule reference and dataset for verification
- [lunar-typescript](https://github.com/6tail/lunar-typescript) — lunar/solar calendar conversion