# `ZoiForge.Generator`
[🔗](https://github.com/rusl-labs/zoi_forge/blob/v0.1.0/lib/zoi_forge/generator.ex#L1)

Core schema-to-module generator for ZoiForge.

Scans a source directory for `*.schema.json` files, converts each JSON Schema
into a typed Elixir module backed by `Zoi`, and writes formatted source files
to the configured output directory.

# `run`

```elixir
@spec run(ZoiForge.Config.t() | keyword()) ::
  {:ok, [{String.t(), String.t()}]} | {:error, term()}
```

Runs code generation with the given config struct or keyword options.

Returns `{:ok, generated}` where `generated` is a list of
`{module_name, output_path}` tuples in deterministic order.

---

*Consult [api-reference.md](api-reference.md) for complete listing*