mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-01 19:42:03 +00:00
Miguel Ángel
9734578e60
Restores the 208 catalog items reverted after their previews 404'd in production, this time on the payload mechanism rather than the .html files that caused the outage. The generator no longer writes a preview document to docs/public. That writer, and the machinery under it, existed only to produce files the docs host discards, so it is gone rather than bypassed. Items now embed the composition itself via a payload, which is what the previous change already does for the items that were already in the catalog. The variables explorer is parked, not restored: it drove its preview through the same unpublished .html path, so it would have shown an empty frame. Items that declare variables get the live player plus the static variables table, and reconnecting the explorer to payloads is a follow-up.
33 lines
2.8 KiB
Markdown
33 lines
2.8 KiB
Markdown
# Theme token contract
|
|
|
|
Theme packs provide one global value for every contract token. Primitive HTML consumes these tokens at the point of use with a fallback, for example `var(--fg, #f8fafc)`. Primitive HTML must not declare contract tokens in `:root` because those declarations escape composition scoping.
|
|
|
|
The source plan calls this a 16-token contract, but its enumerated list contains 17 properties because the three spacing tokens are separate properties. The BUILT primitive audit adds `--accent-2`, which is consumed by three background primitives. The effective gate contract therefore contains 18 tokens.
|
|
|
|
## Final token set
|
|
|
|
| Group | Tokens |
|
|
| ----------------- | --------------------------------------------------------------------------------------- |
|
|
| Palette | `--bg`, `--fg`, `--muted`, `--surface`, `--border`, `--brand`, `--accent`, `--accent-2` |
|
|
| Type | `--font-display`, `--font-body`, `--font-mono` |
|
|
| Shape and spacing | `--radius`, `--space-1`, `--space-2`, `--space-3` |
|
|
| Motion | `--dur-beat`, `--ease-standard`, `--ease-emphasis` |
|
|
|
|
`--accent-2` is part of the contract because `aurora-drift`, `grain-field`, and `beat-pulse-background` consume it. `--demo-bg` is not a primitive token. It is local to two demo harnesses and should remain outside reusable primitive styling.
|
|
|
|
## One-off contract violations
|
|
|
|
These theme-like tokens are each consumed by only one BUILT primitive and must be normalized later. They are not supplied by the theme packs.
|
|
|
|
| Token | Primitive | Normalize toward |
|
|
| ---------------- | -------------- | --------------------------------------------------------- |
|
|
| `--radius-lg` | `OutlineDraw` | `--radius` |
|
|
| `--shadow-panel` | `OutlineDraw` | A local shadow composed from contract palette tokens |
|
|
| `--space-4` | `pan-stations` | The nearest `--space-1`, `--space-2`, or `--space-3` step |
|
|
| `--space-5` | `pan-stations` | The nearest `--space-1`, `--space-2`, or `--space-3` step |
|
|
| `--space-8` | `OutlineDraw` | The nearest `--space-1`, `--space-2`, or `--space-3` step |
|
|
|
|
## Theme pack rules
|
|
|
|
Each theme file contains exactly one `:root` block and defines all 18 tokens. Theme packs are the only files in this directory allowed to declare contract tokens globally. A staged theme block is injected at the end of the QA page head, re-targeted at :root, #root, [data-composition-id] with !important on every declaration: demos declare contract tokens at element scope (#root), which a plain :root injection can never override for descendants.
|