Policies
The choices a design makes once, stated as data beside its tokens: dividers, markers, the featured plan, icon delivery and scheme, each shown as two renders.
The 5 policies
| Policy | Values | What it decides |
|---|---|---|
dividers | a divider policy | What falls between two sections: none, rule, rule-contained or hatch |
markers | true, false | Whether a small accent square sits before each eyebrow and fine-print item |
featured | rule, plate | How the featured plan in pricing stands apart: an inset rule and a stamp, or a plate with a chip |
icons | inline, image | Whether an icon is inline SVG in the text's color, or an image with its color resolved from the Theme |
scheme | auto, light | Whether the page follows the reader's color scheme, or renders its light palette in every scheme |
The first four change the markup a page renders, so they take effect when the page renders. scheme changes only the stylesheet.
Reading a pair
Each pair below wears one Theme's tokens. The left frame is a section rendered under that Theme. The right frame is the same section rendered under the bundled Theme whose policies differ most narrowly, with the left Theme's compileTheme output in place of its own. Pick the Theme whose tokens both frames wear; the caption names any other policy the two differ in.
Dividers
A section never declares its own dividers. The composer chooses each one from the pair of sections it sits between, under the Theme's divider policy:
| Field | Chooses by |
|---|---|
default | Any pair no other field matches |
after | The earlier section's kind; it wins over every other field |
afterSurface | The earlier section's shell surface |
around | Either neighbor's kind |
withinPlate | Two plate sections in a row |
The quaypoint policy rules every pair, sets nothing after an article or a plate section, and draws a contained rule between two plates:
{ "default": "rule", "after": { "article": "none" }, "afterSurface": { "plate": "none" }, "withinPlate": "rule-contained" }Markers
certificate is the one bundled Theme with markers on: an accent square before each eyebrow and fine-print item.
Featured plan
plate sets the featured plan on the plate with a chip; rule keeps it on paper with an inset accent rule and a stamp.
Icon delivery
A Theme chooses one delivery for every icon. Under image, the render context resolves each icon's role to the Theme's literal value on the background it sits on. The two deliveries rasterize a few pixels apart.
Scheme
scheme has no dark-only value. A design that is dark in every scheme puts its dark palette in light and declares no dark. See Dark mode.