# amble_script
`amble_script` is the domain-specific language, parser, and compiler that powers Amble worlds. It turns human-friendly `.amble` sources into the TOML data consumed by `amble_engine`, and ships linting plus reverse-engineering helpers for round-tripping content.
## Highlights
- Pest grammar designed to read like natural narrative prose while staying precise.
- Compiler emits structured TOML for rooms, items, triggers, spinners, NPCs, and goals.
- Linter catches unresolved references, type mismatches, and missing assets early.
- CLI supports compiling single files, entire directories, or lint-only passes.
## Amble DSL Syntax
- one bit of the base game's code for handling a cake item gag can be seen in the screenshot from the Zed editor below
<img src="docs/amble_zed_dsl_screenshot.png" alt="Amble DSL in Zed with syntax highlighting" width="950" />
## CLI Usage
```bash
# Compile a single DSL file to TOML
cargo run -p amble_script -- compile path/to/file.amble --out path/to/out.toml
# Compile a directory of DSL files into category TOMLs expected by the engine
cargo run -p amble_script -- compile-dir amble_script/data/Amble --out-dir amble_engine/data
# Lint files (optionally deny missing references)
cargo run -p amble_script -- lint path/to/file.or.dir --deny-missing
```
Generated TOML includes headers noting the source path and hash so it is easy to trace provenance.
## Documentation
Read the Creator Handbook and reference materials in `docs/`:
- `amble_script/docs/dsl_creator_handbook.md`
- `docs/README.md` (project overview)
## License
MIT License – see the repository root `LICENSE`.