shadcn-shell — Frontend Renderer Resmi

Updated: 2026-07-15 · Status: Outline

Shell resmi FormSpec: SPA React + TypeScript + shadcn/ui yang menginterpretasikan spec saat runtime lewat Spec Resolution API. Kode: renderers/react-shadcn/.

Dokumen	Cakupan
01-architecture.md	Struktur SPA, bootstrap, konsumsi API
02-derivation-engine.md	Derivasi otomatis Table/Form/Page/Menu dari Entity (Layer 0)
03-kind-renderers.md	Katalog renderer per kind yang di-ship
04-theming-assets.md	Theme, CSS layer, asset/custom component
05-routing.md	Empat jenis route, cara membedakan, cara resolve Form/menu

Verifikasi lewat browser

Sebagian invarian tidak bisa diuji di jsdom karena butuh layout dan percetakan sungguhan. Yang sudah punya harness Playwright (make e2e-kafe, renderers/react-shadcn/e2e/):

• print-fidelity.spec.ts — hasil cetak kind: Print harus identik dari layar mana pun (mobile 375×812 sampai 4K): ukuran kertas = ukuran manifest, lembar = kotak cetak halaman (bukan kotak kertas, agar tidak diskalakan ulang), QR = size_mm, dan sha1 tiap content stream PDF sama di semua layar. Geometrinya diambil dari lib/paper.ts sheetBox(), bukan di-hardcode, agar spec tidak bisa "setuju" dengan regresi.