# Documentation

| Document                                                                                                     | What it covers                                                                                        |
| ------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------- |
| [COMPONENTS.md](COMPONENTS.md)                                                                               | All 44 components: signatures, value domains, program syntax rules                                    |
| [ARCHITECTURE.md](ARCHITECTURE.md)                                                                           | Host/client halves, reply pipeline, module map, robustness model, prompt architecture, testing matrix |
| [design.md](design.md)                                                                                       | Design-system v3: tokens, type scale, shared atoms, per-component visual guidance                     |
| [index.html](index.html)                                                                                     | Documentation site landing page (served at the GitHub Pages root)                                     |
| [Gallery page](https://markyangkp.github.io/dsh-intelligence-ui/gallery.html) / [gallery.html](gallery.html) | Full rendered gallery (light theme, generated by `pnpm shot`)                                         |
| [gallery.png](gallery.png) · [gallery-dark.png](gallery-dark.png) · [gallery-mobile.png](gallery-mobile.png) | Gallery screenshots: light, dark, 390px                                                               |
| [hero.png](hero.png)                                                                                         | Repository preview image used by the README                                                           |

The gallery and screenshots are generated artefacts (`pnpm shot`); do not edit them by hand.
The docs are written for contributors and integrators. Agent-facing component guidance is injected
at runtime by the host prompt modules (`index.js`), not read from this directory.