Overview
How the SHDL toolchain is put together, how the pieces talk to each other, and how the test suite and CI keep them honest.
Flattening pipeline
Every stage the flattener runs to turn an SHDL module into Base SHDL, with its inputs, outputs, error codes and a worked example traced through each stage.
Base SHDL
The flat netlist format between the SHDL flattener and the compiler, with every metadata key shown on real flattener output.
Compiler internals
How shdlc turns a Base SHDL netlist into C and a shared library, covering the reader, the validated circuit model, the code generator, the C compiler driver and the tests behind each one.
PySHDL internals
How the SHDL Python package turns a .shdl file into a loaded simulation, and how Circuit validates, marshals and cleans up around the C ABI.