@master/internal-site 0.0.0-stage → 0.1.0

package/src/styles/system/data.css

@@ -0,0 +1,134 @@
+/* Data and documents: tables own their frame, numbers align, sources stay in view. */
+@layer components {
+  /* The contour is a border: an inset shadow would sit under the sticky header cells. */
+  .ui-table { min-width: 0; overflow: auto; border: 1px solid var(--ui-line-contour); border-radius: var(--ui-radius-xl); background: var(--ui-surface-sheet); scrollbar-width: thin; }
+  .ui-table:focus-visible { @apply --ui-focus-ring; outline-offset: 2px; }
+  .ui-table table { width: 100%; border-collapse: separate; border-spacing: 0; font-size: var(--ui-text-small); line-height: 1.5; }
+  .ui-table thead th { position: sticky; top: 0; z-index: 1; padding: .625rem var(--ui-space-md); background: var(--ui-surface-sheet-lo); color: var(--ui-text-muted); @apply --ui-label-type; text-align: start; white-space: nowrap; box-shadow: inset 0 -1px 0 var(--ui-line-divider); }
+  .ui-table :is(td, tbody th) { padding: .6875rem var(--ui-space-md); color: var(--ui-text-body); font-weight: var(--ui-weight-regular); text-align: start; vertical-align: top; border-top: 1px solid var(--ui-line-hair); }
+  .ui-table tr:first-child > :is(td, th) { border-top: 0; }
+  .ui-table tbody tr { transition: background-color var(--ui-duration-quick); }
+  .ui-table tbody tr:hover { background: light-dark(oklch(22% .002 265 / .022), oklch(100% 0 none / .025)); }
+  .ui-table tbody tr > :first-child { color: var(--ui-text-strong); }
+  .ui-table :is(td, th)[data-align="end"] { text-align: end; font-variant-numeric: tabular-nums; white-space: nowrap; }
+  /* In a cell code is a fill only: several hairline chips to a cell read as a grid inside the grid. A long value may wrap
+     when the table runs out of room, so the prose column beside it keeps a readable measure. */
+  /* A code name in a column head reads as part of the caption: the head's ink and size in mono, without a chip. */
+  .ui-table thead th code { padding: 0; border-radius: 0; background: none; color: inherit; box-shadow: none; font: inherit; font-family: var(--font-family-mono); font-size: .75rem; letter-spacing: 0; }
+  .ui-table :is(td, tbody th) code { padding: .125em .375em; border-radius: var(--ui-radius-xs); background: var(--ui-surface-chip); color: var(--ui-text-strong); box-shadow: none; font: var(--ui-weight-regular) .8125rem/1.6 var(--font-family-mono); overflow-wrap: anywhere; -webkit-box-decoration-break: clone; box-decoration-break: clone; }
+  /* The row's key reads whole: the first column's names break only where the text allows (a space, a slash marked
+     with <wbr>), never inside a name. */
+  .ui-table :is(td:first-child, tbody th) code { white-space: normal; overflow-wrap: normal; }
+  .ui-table :is(td, tbody th) .ui-preview { display: inline-block; width: 1.25rem; height: 1.25rem; margin-right: var(--ui-space-xs); border-radius: var(--ui-radius-sm); vertical-align: -.3em; box-shadow: inset 0 0 0 1px var(--ui-line-contour); }
+  .ui-table[data-density="compact"] :is(th, td) { padding-block: .4375rem; }
+  /* Lookup: the key column fits its longest key; values wrap at their spaces */
+  .ui-table[data-variant="lookup"] tbody th { width: 1%; white-space: nowrap; }
+  .ui-table[data-variant="lookup"] td code { white-space: normal; line-height: 1.5; }
+  .ui-table :is(td, tbody th) ul { display: flex; flex-wrap: wrap; gap: 6px; margin: 0; padding: 0; list-style: none; }
+  .ui-table :is(td, tbody th) .ui-disclosure > summary { min-height: 2.25rem; }
+  .ui-table-caption { display: flex; justify-content: space-between; gap: var(--ui-space-md); padding: var(--ui-space-sm) var(--ui-space-md); color: var(--ui-text-muted); font-size: .75rem; box-shadow: inset 0 1px 0 var(--ui-line-hair); }
+
+  /* Metrics: aligned values with their caveats */
+  .ui-metrics { display: grid; grid-template-columns: repeat(auto-fit, minmax(min(100%, 10rem), 1fr)); gap: var(--ui-inset); }
+  .ui-metric { display: grid; align-content: start; min-width: 0; gap: 6px; overflow-wrap: anywhere; padding: var(--ui-space-md); border-radius: var(--ui-radius-lg); @apply --ui-sheet-face; box-shadow: var(--ui-elevation-rise-1); }
+  .ui-metric > small { color: var(--ui-text-muted); @apply --ui-label-type; }
+  .ui-metric > b { color: var(--ui-text-strong); font-size: 1.625rem; font-weight: var(--ui-weight-heading); letter-spacing: -.03em; line-height: 1.1; font-variant-numeric: tabular-nums; }
+  .ui-metric > b > span { color: var(--ui-text-muted); font-size: .875rem; font-weight: var(--ui-weight-medium); letter-spacing: 0; }
+  .ui-metric > p { margin: 0; color: var(--ui-text-muted); font-size: .75rem; line-height: 1.5; }
+  .ui-bar { height: 6px; border-radius: var(--ui-radius-pill); background: var(--ui-surface-well); box-shadow: var(--ui-elevation-sink); overflow: hidden; }
+  .ui-bar > i { display: block; height: 100%; border-radius: inherit; background: var(--ui-text-strong); }
+  .ui-bar > i[data-tone="muted"] { background: var(--ui-line-mark); }
+  /* Series tones appear only where a legend names them */
+  .ui-bar > i[data-tone="blue"] { background: var(--ui-tone-blue); }
+  .ui-bar > i[data-tone="violet"] { background: var(--ui-tone-violet); }
+  .ui-bar > i[data-tone="amber"] { background: var(--ui-tone-amber); }
+  .ui-bar > i[data-tone="green"] { background: var(--ui-tone-green); }
+  .ui-bar > i[data-tone="red"] { background: var(--ui-tone-red); }
+  .ui-bar > i[data-tone="neutral"] { background: var(--ui-tone-neutral); }
+  .ui-bar[data-variant="stacked"] { display: flex; gap: 1px; }
+  .ui-bar[data-variant="stacked"] > i { flex: none; border-radius: 0; }
+  .ui-bar[data-variant="stacked"] > i:first-child { border-start-start-radius: inherit; border-end-start-radius: inherit; }
+  .ui-bar[data-variant="stacked"] > i:last-child { border-start-end-radius: inherit; border-end-end-radius: inherit; }
+
+  /* Evidence footer: the source and its date, always beside the claim */
+  .ui-source { display: flex; flex-wrap: wrap; align-items: center; gap: 4px var(--ui-space-md); padding: var(--ui-space-sm) var(--ui-space-sm) 2px; color: var(--ui-text-muted); font: var(--ui-weight-regular) .71875rem/1.5 var(--font-family-mono); }
+  .ui-source a { color: var(--ui-text-body); text-decoration: underline; text-decoration-color: var(--ui-line-mark); text-underline-offset: .2em; }
+
+  /* Parameters / contracts: a definition list that reads like a table */
+  .ui-params { display: grid; margin: 0; border-radius: var(--ui-radius-xl); background: var(--ui-surface-sheet); box-shadow: inset 0 0 0 1px var(--ui-line-contour); }
+  .ui-params > div { display: grid; grid-template-columns: minmax(8rem, 13rem) minmax(0, 1fr); gap: var(--ui-space-xs) var(--ui-space-lg); padding: var(--ui-space-sm) var(--ui-space-md); border-top: 1px solid var(--ui-line-hair); }
+  .ui-params > div:first-child { border-top: 0; }
+  .ui-params dt { display: flex; flex-wrap: wrap; align-items: baseline; gap: 6px; min-width: 0; overflow-wrap: anywhere; color: var(--ui-text-strong); font: var(--ui-weight-medium) .8125rem/1.5 var(--font-family-mono); }
+  .ui-params dt small { color: var(--ui-text-muted); font-weight: var(--ui-weight-regular); }
+  .ui-params dd { margin: 0; color: var(--ui-text-body); font-size: var(--ui-text-small); line-height: 1.6; overflow-wrap: anywhere; }
+  .ui-params dd > * { margin: 0; }
+  .ui-params dd > * + * { margin-top: var(--ui-space-xs); }
+  .ui-params dd small { color: var(--ui-text-muted); font-size: .75rem; }
+  /* A link in a description reads as the prose's own links do. */
+  .ui-params dd a:not([class]) { color: var(--ui-text-strong); text-decoration: underline 1px var(--ui-line-strong); text-underline-offset: .24em; }
+  .ui-params dd a:not([class]):hover { text-decoration-color: currentColor; }
+  .ui-params :is(dt, dd) :is(h3, h4) { margin: 0; font: inherit; color: inherit; letter-spacing: inherit; }
+  .ui-params dd code { padding: .125em .375em; border-radius: var(--ui-radius-xs); background: var(--ui-surface-chip); color: var(--ui-text-strong); box-shadow: inset 0 0 0 1px var(--ui-line-hair); font: var(--ui-weight-regular) .8125rem/1 var(--font-family-mono); }
+  @media (width < 35rem) { .ui-params > div { grid-template-columns: 1fr; } }
+
+  /* Steps: numbered sequence on one hairline rail; code stays in the reading flow */
+  .ui-steps { counter-reset: step; display: grid; gap: 0; margin: 0; padding: 0; list-style: none; }
+  .ui-steps > li { counter-increment: step; position: relative; display: grid; grid-template-columns: 1.75rem minmax(0, 1fr); gap: var(--ui-space-lg); padding-bottom: var(--ui-space-2xl); }
+  .ui-steps > li::before { content: counter(step, decimal-leading-zero); display: grid; place-items: center; width: 1.75rem; height: 1.75rem; color: var(--ui-text-muted); font: var(--ui-weight-regular) .875rem/1 var(--font-family-sans); font-variant-numeric: tabular-nums; }
+  .ui-steps > li::after { content: ""; position: absolute; top: 2.25rem; bottom: .5rem; left: .875rem; width: 1px; background: var(--ui-line-divider); }
+  .ui-steps > li:last-child { padding-bottom: 0; }
+  .ui-steps > li:last-child::after { display: none; }
+  .ui-steps > li > div > h4 { margin: .125rem 0 var(--ui-space-xs); color: var(--ui-text-strong); font-size: var(--ui-text-base); font-weight: var(--ui-weight-medium); line-height: 1.5rem; }
+  .ui-steps > li > div > p { margin: 0 0 var(--ui-space-sm); }
+
+  /* Index: grouped links with a useful start — free-standing hairline sheets, so a short last row leaves only canvas */
+  .ui-index { display: grid; grid-template-columns: repeat(auto-fill, minmax(min(100%, 14rem), 1fr)); gap: var(--ui-space-sm); }
+  .ui-index > a { display: grid; align-content: start; gap: var(--ui-space-2xs); padding: var(--ui-space-md) var(--ui-space-md) 1.125rem; border-radius: var(--ui-radius-xl); background: var(--ui-surface-sheet); color: var(--ui-text-body); box-shadow: inset 0 0 0 1px var(--ui-line-contour), 0 1px 0 var(--ui-lip); text-decoration: none; transition: box-shadow var(--ui-duration-quick) var(--ui-ease), translate var(--ui-duration-quick) var(--ui-ease); }
+  .ui-index > a:hover { translate: 0 -.5px; box-shadow: var(--ui-elevation-rise-1h); }
+  .ui-index > a:focus-visible { @apply --ui-focus-ring; outline-offset: 2px; }
+  .ui-index > a > svg { width: 18px; height: 18px; margin-bottom: var(--ui-space-2xs); color: var(--ui-text-strong); stroke-width: 1.5; }
+  .ui-index > a > b { color: var(--ui-text-strong); font-size: .9375rem; font-weight: var(--ui-weight-medium); line-height: 1.4; letter-spacing: -.006em; }
+  .ui-index > a > span { font-size: .8125rem; line-height: 1.6; color: var(--ui-text-muted); }
+  .ui-index > a > b code { font: var(--ui-weight-medium) .875rem/1.45 var(--font-family-mono); letter-spacing: 0; overflow-wrap: anywhere; }
+  .ui-index[data-density="compact"] { grid-template-columns: repeat(auto-fill, minmax(min(100%, 12rem), 1fr)); gap: var(--ui-space-xs); }
+  .ui-index[data-density="compact"] > a { gap: 2px; padding: var(--ui-space-sm) var(--ui-space-md); }
+
+  /* Logo directory: compact, open rows; the surrounding group owns the section rule. */
+  .ui-logos { display: grid; grid-template-columns: repeat(auto-fit, minmax(min(100%, 9rem), 1fr)); gap: var(--ui-space-2xs) var(--ui-space-md); }
+  .ui-logos > a { display: flex; align-items: center; gap: var(--ui-space-sm); min-width: 0; min-height: 2.75rem; padding: .5rem var(--ui-space-xs); border-radius: var(--ui-radius-sm); color: var(--ui-text-body); font-size: .8125rem; line-height: 1.5; text-decoration: none; transition: background var(--ui-duration-quick) var(--ui-ease), color var(--ui-duration-quick) var(--ui-ease); }
+  .ui-logos > a:hover { color: var(--ui-text-strong); background: var(--ui-surface-chip); }
+  .ui-logos > a:focus-visible { @apply --ui-focus-ring; outline-offset: 2px; }
+  .ui-logos > a > svg { flex: none; width: 1.25rem; height: 1.25rem; }
+  .ui-logos > a > span { min-width: 0; overflow-wrap: anywhere; }
+
+  /* Chart frame: units, series and sample context together. Captions and readings are small sans with tabular figures. */
+  .ui-chart { display: grid; gap: var(--ui-space-md); padding: var(--ui-space-lg); border-radius: var(--ui-radius-xl); @apply --ui-sheet-face; box-shadow: var(--ui-elevation-rise-1); }
+  .ui-chart-head { display: flex; flex-wrap: wrap; justify-content: space-between; gap: var(--ui-space-xs) var(--ui-space-md); }
+  .ui-chart-head b { color: var(--ui-text-strong); font-size: var(--ui-text-small); font-weight: var(--ui-weight-strong); }
+  .ui-chart-head small { display: block; color: var(--ui-text-muted); font: var(--ui-weight-regular) var(--ui-text-caption)/1.5 var(--font-family-sans); font-variant-numeric: tabular-nums; }
+  .ui-chart-row { display: grid; grid-template-columns: minmax(6.5rem, 12rem) minmax(0, 1fr) minmax(4.5rem, auto); align-items: center; gap: var(--ui-space-xs) var(--ui-space-sm); font-size: .8125rem; }
+  .ui-chart-row > span:first-child { display: flex; flex-wrap: wrap; align-items: center; gap: 2px var(--ui-space-xs); min-width: 0; color: var(--ui-text-strong); overflow-wrap: anywhere; }
+  .ui-chart-row > span:first-child > small { flex-basis: 100%; color: var(--ui-text-muted); font: var(--ui-weight-regular) .75rem/1.4 var(--font-family-sans); font-variant-numeric: tabular-nums; }
+  .ui-chart-row > output { color: var(--ui-text-body); font: var(--ui-weight-regular) .8125rem/1 var(--font-family-sans); text-align: end; white-space: nowrap; font-variant-numeric: tabular-nums; }
+  /* A stacked row names its segments under the bar */
+  .ui-chart-row > .ui-legend { grid-column: 2 / -1; gap: 2px var(--ui-space-md); font-size: .75rem; }
+  .ui-chart-row > .ui-legend b { color: var(--ui-text-strong); font-weight: var(--ui-weight-medium); }
+  @media (width < 35rem) {
+    .ui-chart-row { grid-template-columns: minmax(0, 1fr) auto; }
+    .ui-chart-row > .ui-bar { grid-column: 1 / -1; grid-row: 2; }
+    .ui-chart-row > .ui-legend { grid-column: 1 / -1; }
+  }
+
+  /* Waterfall: resource order on one time axis */
+  .ui-waterfall { display: grid; gap: 2px; padding: var(--ui-space-md) var(--ui-space-lg) var(--ui-space-lg); border-radius: var(--ui-radius-xl); @apply --ui-sheet-face; box-shadow: var(--ui-elevation-rise-1); }
+  .ui-waterfall-axis { display: grid; grid-template-columns: 7.5rem 1fr; margin-bottom: var(--ui-space-xs); color: var(--ui-text-muted); font: var(--ui-weight-regular) .65625rem/1 var(--font-family-mono); }
+  .ui-waterfall-axis > div { display: flex; justify-content: space-between; }
+  .ui-waterfall-row { display: grid; grid-template-columns: 7.5rem 1fr; align-items: center; min-height: 1.75rem; font-size: .78125rem; }
+  .ui-waterfall-row > span { overflow: hidden; color: var(--ui-text-strong); font-family: var(--font-family-mono); font-size: .71875rem; text-overflow: ellipsis; white-space: nowrap; }
+  .ui-waterfall-track { position: relative; height: 100%; background: repeating-linear-gradient(90deg, var(--ui-line-hair) 0 1px, transparent 1px 25%); }
+  .ui-waterfall-track > i { position: absolute; top: 50%; height: 8px; translate: 0 -50%; border-radius: 3px; background: var(--ui-text-strong); }
+  @media (forced-colors: active) { .ui-waterfall-track > i { box-sizing: border-box; border: 1px solid CanvasText; } }
+  .ui-waterfall-track > i[data-tone="muted"] { background: var(--ui-line-mark); }
+  .ui-waterfall-track > i[data-tone="blocking"] { background: var(--ui-tone-amber); }
+  .ui-waterfall-mark { position: absolute; top: 2px; bottom: 2px; width: 2px; margin-left: -1px; border-radius: 1px; background: var(--ui-status-danger); }
+}

package/src/styles/system/mixins.css

@@ -0,0 +1,7 @@
+/* Shared declarations of the system components, expanded in place by Master CSS (`@apply --name`). */
+@mixin --ui-sheet-face { background: linear-gradient(180deg, var(--ui-surface-sheet), var(--ui-surface-sheet-lo)); }
+@mixin --ui-focus-ring { outline: 2px solid var(--ui-focus); }
+/* A caption over a group: small, quiet, in the reading face — never a mono capital eyebrow. */
+@mixin --ui-label-type { font: var(--ui-weight-regular) var(--ui-text-label)/1.5 var(--font-family-sans); letter-spacing: var(--ui-tracking-label); text-transform: none; }
+/* An eyebrow over a group or a page: small sans capitals, medium weight, tracked open so the capitals breathe. */
+@mixin --ui-eyebrow-type { font: var(--ui-weight-medium) var(--ui-text-eyebrow)/1rem var(--font-family-sans); letter-spacing: var(--ui-tracking-eyebrow); text-transform: uppercase; }

package/src/styles/system/prose.css

@@ -0,0 +1,75 @@
+/* Prose: the reading column. Rules reach only the article's own flow, never into components.
+   Framed surfaces (tray, code, table, parameters, prompt, tree) bleed past the text by one gutter; index cards are links and keep its edges. */
+@layer components {
+  /* One line unit (--line, 32px at 16px: body text set at line-height 2) sets the vertical rhythm: paragraphs part by
+     three quarters of it, sections open on two lines, wide blocks keep one line of air. */
+  .ui-prose { --measure: 41rem; --bleed: 2rem; --line: 2rem; color: var(--ui-text-body); font-size: var(--ui-text-base); line-height: var(--ui-leading-body); }
+  .ui-prose > :is(p, ul, ol, h2, h3, h4, blockquote, .ui-callout, .ui-disclosure, hr):not(:where(.ui-steps)) { max-width: var(--measure); }
+  .ui-prose > :is(.ui-tray, .ui-code, .ui-table, .ui-params, .ui-prompt, .ui-tree) { margin-inline: calc(var(--bleed) * -1); }
+  @media (width < 52rem) { .ui-prose { --bleed: 0rem; } }
+  .ui-prose > :is(p, ul, ol, blockquote) { margin-block: calc(var(--line) * .75); }
+  .ui-prose > :is(.ui-tray, .ui-code, .ui-table, .ui-callout, .ui-steps, .ui-index, .ui-logos, .ui-params, .ui-prompt, .ui-tree) { margin-block: var(--line); }
+  /* Files that answer one instruction sit together: consecutive code panels part by a small gap, not a line. */
+  .ui-prose > .ui-code:has(+ .ui-code) { margin-bottom: var(--ui-space-sm); }
+  .ui-prose > .ui-code + .ui-code { margin-top: var(--ui-space-sm); }
+  .ui-prose > h2 { margin: calc(var(--line) * 2) 0 calc(var(--line) * .5); color: var(--ui-text-strong); font-size: var(--ui-text-h2); font-weight: var(--ui-weight-heading); line-height: var(--ui-leading-h2); letter-spacing: var(--ui-tracking-h2); text-wrap: balance; }
+  .ui-prose > h3 { margin: calc(var(--line) * 1.5) 0 calc(var(--line) * .375); color: var(--ui-text-strong); font-size: var(--ui-text-h3); font-weight: var(--ui-weight-heading); line-height: var(--ui-leading-h3); letter-spacing: var(--ui-tracking-h3); }
+  .ui-prose > h4 { margin: calc(var(--line) * 1.25) 0 calc(var(--line) * .25); color: var(--ui-text-strong); font-size: var(--ui-text-base); font-weight: var(--ui-weight-strong); line-height: 1.5rem; }
+  /* A subsection that opens its section sits close under it, as one heading group. */
+  .ui-prose > h2 + h3, .ui-prose > h3 + :is(h3, h4) { margin-top: calc(var(--line) * .5); }
+  .ui-prose > :is(h2, h3) { position: relative; width: fit-content; scroll-margin-top: 5rem; }
+  /* A section opens on one hairline across the reading measure, closer to its heading than to the text before it. */
+  .ui-prose > h2 { width: auto; }
+  .ui-prose > h2:not(:first-child)::before { content: ""; display: var(--section-rule, block); position: absolute; top: calc(var(--line) * -.875); inset-inline: 0 var(--rule-end, 0); height: 1px; background: var(--ui-line-hair); pointer-events: none; }
+  /* The page's first section keeps only its space (after the page head too), and so does one after a disclosure, which
+     already closes on a hairline, even as the last part of a section wrapper;
+     legacy anchors and space-only rules in between do not count. A disclosure joined under its code is a framed panel, not
+     a rule, so the heading after it keeps its own. */
+  .ui-prose > :is(a[id]:empty, .sr-only):first-child + h2,
+  .ui-prose > .ui-disclosure:not(.ui-code + *) + h2, .ui-prose > .ui-disclosure:not(.ui-code + *) + a[id]:empty + h2,
+  .ui-prose > .ui-disclosure:not(.ui-code + *) + hr + h2, .ui-prose > .ui-disclosure:not(.ui-code + *) + hr + a[id]:empty + h2,
+  .ui-prose > .ui-pagehead + h2, .ui-prose > .ui-pagehead + a[id]:empty + h2,
+  .ui-prose > :has(> .ui-disclosure:last-child) + h2 { --section-rule: none; }
+  .ui-anchor { position: absolute; right: 100%; top: 50%; translate: -.375rem -50%; display: grid; place-items: center; width: 1.5rem; height: 1.5rem; border-radius: var(--ui-radius-sm); color: var(--ui-text-disabled); font: var(--ui-weight-regular) .875rem/1 var(--font-family-mono); opacity: 0; text-decoration: none; transition: opacity var(--ui-duration-quick), color var(--ui-duration-quick); }
+  .ui-anchor:hover { color: var(--ui-text-muted); }
+  .ui-prose > :is(h2, h3):is(:hover, :target, :focus-within) > .ui-anchor { opacity: 1; }
+  .ui-anchor:focus-visible { opacity: 1; @apply --ui-focus-ring; outline-offset: 1px; }
+  .ui-prose > :is(p, ul, ol, blockquote, h2, h3, h4) :is(strong, b) { color: var(--ui-text-strong); font-weight: var(--ui-weight-strong); }
+  .ui-prose > :is(p, ul, ol, blockquote) a:not([class]) { color: var(--ui-text-strong); text-decoration: underline; text-decoration-color: var(--ui-line-strong); text-decoration-thickness: 1px; text-underline-offset: .24em; transition: text-decoration-color var(--ui-duration-quick); }
+  .ui-prose > :is(p, ul, ol, blockquote) a:not([class]):hover { text-decoration-color: currentColor; }
+  .ui-prose > :is(p, ul, ol, blockquote) a:not([class]):focus-visible { @apply --ui-focus-ring; outline-offset: 2px; border-radius: var(--ui-radius-xs); }
+  /* Inline code is set apart by a hairline chip in a mid ink, never the darkest spot of a paragraph. */
+  .ui-prose > :is(p, ul, ol, blockquote, h2, h3, h4) code:not(pre code), .ui-callout code { padding: .125em .375em; border-radius: var(--ui-radius-xs); background: var(--ui-surface-chip); color: color-mix(in oklab, var(--ui-text-strong) 60%, var(--ui-text-body)); box-shadow: inset 0 0 0 1px var(--ui-line-hair); font: var(--ui-weight-regular) .84em/1 var(--font-family-mono); overflow-wrap: anywhere; }
+  /* In a heading, code is the heading's own words in the mono face. */
+  .ui-prose > :is(h2, h3, h4) code:not(pre code) { padding: 0; background: none; box-shadow: none; color: inherit; font-size: .9em; }
+  .ui-prose > :is(ul, ol):not([class]) { padding-left: 1.25em; }
+  .ui-prose > :is(ul, ol):not([class]) li { margin-block: calc(var(--line) * .25); padding-left: .375em; }
+  .ui-prose > :is(ul, ol):not([class]) li > :is(p, ul, ol) { margin-block: calc(var(--line) * .25); }
+  .ui-prose > ul:not([class]) { list-style: disc; }
+  .ui-prose > ul:not([class]) li::marker { color: var(--ui-text-disabled); font-size: .8em; }
+  .ui-prose > ol:not([class]) li::marker { color: var(--ui-text-muted); font: var(--ui-weight-regular) .875em var(--font-family-sans); font-variant-numeric: tabular-nums; }
+  .ui-prose > hr { height: 1px; margin: calc(var(--line) * 1.75) 0 calc(var(--line) * 1.25); border: 0; background: var(--ui-line-divider); }
+  .ui-prose > hr + * { margin-top: 0; }
+  /* A rule an author sets before a section heading (or the legacy anchor before it) is space only: the heading's own opening already parts the sections. */
+  .ui-prose > hr:has(+ h2, + a[id]:empty + h2) { height: 0; margin: 0; background: none; }
+  .ui-prose > hr + h2 { margin-top: calc(var(--line) * 2); }
+  .ui-prose > blockquote { margin-inline: 0; padding: .25rem 0 .25rem 1.25rem; box-shadow: inset 1px 0 0 var(--ui-line-strong); color: color-mix(in oklab, var(--ui-text-strong) 50%, var(--ui-text-body)); }
+  .ui-prose > blockquote > p { margin-block: 0; } .ui-prose > blockquote > p + p { margin-top: .75em; }
+  .ui-prose > figure { margin: var(--line) 0; }
+  .ui-prose > figure:not(.ui-tray) > figcaption { margin-top: var(--ui-space-sm); color: var(--ui-text-muted); font-size: var(--ui-text-caption); line-height: var(--ui-leading-caption); }
+
+  /* Callout: one icon, one tint, a hairline — never a thick left border */
+  /* Hint: how to use the example that follows, a muted line led by its gesture */
+  .ui-hint { display: flex; align-items: flex-start; gap: var(--ui-space-xs); color: var(--ui-text-muted); font-size: var(--ui-text-small); line-height: var(--ui-leading-small); }
+  .ui-hint > svg { flex: none; width: 1rem; height: 1rem; margin-top: calc((1lh - 1rem) / 2); color: var(--ui-text-body); stroke-width: 1.5; }
+  .ui-callout { --tone: var(--ui-tone-neutral); display: grid; grid-template-columns: auto minmax(0, 1fr); gap: var(--ui-space-sm); padding: .875rem var(--ui-space-md); border-radius: var(--ui-radius-lg);
+    background: color-mix(in oklab, var(--tone) 2.5%, var(--ui-surface-canvas)); box-shadow: inset 0 0 0 1px color-mix(in oklab, var(--tone) 12%, var(--ui-line-contour)); color: var(--ui-text-body); font-size: var(--ui-text-small); line-height: var(--ui-leading-small); }
+  .ui-callout > svg { width: 1rem; height: 1rem; margin-top: .21875rem; color: color-mix(in oklab, var(--tone) 80%, var(--ui-text-strong)); }
+  .ui-callout > div { min-width: 0; overflow-wrap: anywhere; }
+  .ui-callout > div > :first-child { margin-top: 0; } .ui-callout > div > :last-child { margin-bottom: 0; }
+  .ui-callout b { color: var(--ui-text-strong); font-weight: var(--ui-weight-strong); }
+  .ui-callout[data-tone="info"] { --tone: var(--ui-status-info); }
+  .ui-callout[data-tone="success"], .ui-callout[data-tone="do"] { --tone: var(--ui-status-success); }
+  .ui-callout[data-tone="warning"] { --tone: var(--ui-status-warning); }
+  .ui-callout[data-tone="danger"], .ui-callout[data-tone="dont"] { --tone: var(--ui-status-danger); }
+}

package/src/styles/system/shell.css

@@ -0,0 +1,102 @@
+/* Docs shell: header, sidebar, contents, page head, pager, search. Chrome stays on the canvas; only content gets material. */
+@layer components {
+  .ui-app { min-height: 100dvh; background: var(--ui-surface-canvas); color: var(--ui-text-body); }
+
+  .ui-header { position: sticky; top: 0; z-index: 40; display: flex; align-items: center; gap: var(--ui-space-lg); height: 3.75rem; padding: 0 var(--ui-space-lg);
+    background: color-mix(in oklab, var(--ui-surface-canvas) 82%, transparent); -webkit-backdrop-filter: blur(16px) saturate(1.3); backdrop-filter: blur(16px) saturate(1.3);
+    box-shadow: inset 0 -1px 0 var(--ui-line-hair); }
+  .ui-header-brand { display: inline-flex; align-items: center; gap: var(--ui-space-xs); color: var(--ui-text-strong); font-weight: var(--ui-weight-medium); font-size: 1.0625rem; letter-spacing: -.02em; text-decoration: none; white-space: nowrap; }
+  /* Section links are plain words: ink marks the section being read, no pill. */
+  .ui-header-nav { display: flex; align-items: center; gap: var(--ui-space-3xs); }
+  .ui-header-nav > a { display: inline-flex; align-items: center; height: 2.25rem; padding: 0 .75rem; border-radius: var(--ui-radius-md); color: var(--ui-text-body); font-size: var(--ui-text-small); font-weight: var(--ui-weight-regular); text-decoration: none; transition: color var(--ui-duration-quick); }
+  .ui-header-nav > a:hover { color: var(--ui-text-strong); }
+  .ui-header-nav > a:is([aria-current="page"], [aria-current="true"]) { color: var(--ui-text-strong); font-weight: var(--ui-weight-medium); }
+  .ui-header-nav > a:focus-visible { @apply --ui-focus-ring; outline-offset: 0; }
+  /* A recent section: one small chip-washed word after its name */
+  .ui-header-nav > a > small { margin-left: var(--ui-space-2xs); padding: 1px 5px; border-radius: var(--ui-radius-xs); background: var(--ui-surface-chip); color: var(--ui-text-muted); box-shadow: inset 0 0 0 1px var(--ui-line-hair); font: var(--ui-weight-medium) .6875rem/1.4 var(--font-family-sans); letter-spacing: .02em; }
+  .ui-header-end { display: flex; align-items: center; gap: var(--ui-space-3xs); margin-left: auto; }
+  .ui-header-divider { width: 1px; height: 1rem; margin-inline: var(--ui-space-xs); background: var(--ui-line-divider); }
+  .ui-version { display: inline-flex; align-items: center; gap: var(--ui-space-3xs); height: 2.25rem; padding: 0 .375rem; border-radius: var(--ui-radius-md); color: var(--ui-text-body); font: var(--ui-weight-regular) var(--ui-text-small)/1 var(--font-family-sans); font-variant-numeric: tabular-nums; }
+
+  /* The sidebar: quiet group captions over entries hung on one hairline; the page being read inks a short bar on it. */
+  .ui-sidebar { display: grid; align-content: start; gap: var(--ui-space-lg); padding: var(--ui-space-lg) var(--ui-space-lg) var(--ui-space-2xl) var(--ui-space-xl); }
+  .ui-search-trigger { appearance: none; display: flex; align-items: center; gap: .625rem; width: 100%; height: 2.5rem; padding: 0; border: 0; border-radius: 0;
+    background: transparent; color: var(--ui-text-muted); box-shadow: inset 0 -1px 0 var(--ui-line-hair); font: var(--ui-weight-regular) var(--ui-text-small)/1 var(--font-family-sans); cursor: pointer; transition: color var(--ui-duration-quick), box-shadow var(--ui-duration-quick); }
+  .ui-search-trigger:hover { color: var(--ui-text-strong); box-shadow: inset 0 -1px 0 var(--ui-line-strong); }
+  .ui-search-trigger > .ui-kbd { box-shadow: none; }
+  .ui-search-trigger:focus-visible { @apply --ui-focus-ring; outline-offset: 2px; border-radius: var(--ui-radius-sm); }
+  .ui-search-trigger > svg { flex: none; width: 15px; height: 15px; }
+  .ui-search-trigger > .ui-kbd { margin-left: auto; }
+  .ui-nav-group { display: grid; }
+  .ui-nav-group > h4 { display: flex; align-items: center; min-height: 2rem; margin: 0 0 var(--ui-space-3xs); color: var(--ui-text-muted); @apply --ui-eyebrow-type; }
+  .ui-nav-link { position: relative; display: flex; align-items: center; min-height: 2rem; padding: .3125rem 0 .3125rem 1rem; color: var(--ui-text-muted); font-size: var(--ui-text-small); line-height: 1.4; text-decoration: none; box-shadow: inset 1px 0 0 var(--ui-line-divider); transition: color var(--ui-duration-quick); }
+  .ui-nav-link::before { content: ""; position: absolute; top: .4375rem; bottom: .4375rem; left: 0; width: 2px; margin-left: -.5px; border-radius: 1px; background: transparent; transition: background-color var(--ui-duration-quick); }
+  .ui-nav-link:hover { color: var(--ui-text-strong); }
+  .ui-nav-link:hover::before { background: var(--ui-line-mark); }
+  .ui-nav-link:is([aria-current="page"], [aria-current="true"]) { color: var(--ui-text-strong); font-weight: var(--ui-weight-medium); }
+  .ui-nav-link:is([aria-current="page"], [aria-current="true"])::before { background: var(--ui-text-strong); }
+  .ui-nav-link:focus-visible { @apply --ui-focus-ring; outline-offset: 1px; border-radius: var(--ui-radius-sm); }
+  .ui-nav-link > .ui-badge { margin-left: auto; }
+
+  /* One ruler: long section ticks and short subsection ticks share a right edge before the text. Titles share a second edge;
+     current location changes ink, never the tick's length or the title's position. */
+  .ui-toc { --toc-tick: 1.5rem; --toc-tick-subsection: .75rem; --toc-gap: .75rem; --toc-gutter: calc(var(--toc-tick) + var(--toc-gap)); --toc-row-padding: .5rem;
+    display: grid; align-content: start; gap: var(--ui-space-xs); padding: var(--ui-space-xl) var(--ui-space-lg); font-size: var(--ui-text-caption); }
+  .ui-toc > h4 { margin: 0 0 var(--ui-space-2xs); padding-left: var(--toc-gutter); color: var(--ui-text-muted); @apply --ui-eyebrow-type; }
+  .ui-toc ol { display: grid; margin: 0; padding: 0; list-style: none; }
+  .ui-toc a { position: relative; display: block; padding: var(--toc-row-padding) 0 var(--toc-row-padding) var(--toc-gutter); color: var(--ui-text-muted); line-height: 1.125rem; text-decoration: none; transition: color var(--ui-duration-quick); }
+  .ui-toc a::before { content: ""; position: absolute; top: calc(var(--toc-row-padding) + .5lh - 1px); right: calc(100% - var(--toc-tick)); width: var(--toc-tick); height: 2px; border-radius: 1px; background: var(--ui-line-divider); pointer-events: none; transition: background-color var(--ui-duration-quick); }
+  .ui-toc :is(ol ol a, a[data-level="3"])::before { width: var(--toc-tick-subsection); }
+  .ui-toc a:hover { color: var(--ui-text-strong); }
+  .ui-toc a:hover::before { background: var(--ui-line-mark); }
+  .ui-toc a[aria-current="location"] { color: var(--ui-text-strong); font-weight: var(--ui-weight-medium); }
+  .ui-toc a[aria-current="location"]::before { background: var(--ui-text-strong); }
+  .ui-toc a:focus-visible { @apply --ui-focus-ring; outline-offset: 1px; border-radius: var(--ui-radius-xs); }
+  .ui-toc ol ol a:not([aria-current]) { color: color-mix(in oklab, var(--ui-text-muted) 72%, var(--ui-text-disabled)); }
+  .ui-toc ol ol a:not([aria-current])::before { background: var(--ui-line-hair); }
+  .ui-toc ol ol a:not([aria-current]):hover { color: var(--ui-text-strong); }
+  .ui-toc-actions { display: grid; padding: var(--ui-space-sm) 0 0 var(--toc-gutter); }
+  .ui-toc-actions a { padding: .3125rem 0; color: var(--ui-text-muted); font-size: .75rem; line-height: 1.5; }
+  .ui-toc-actions a::before { content: none; }
+
+  /* The page head: an eyebrow, the title and its lead. Space, not a rule, parts it from the reading. */
+  .ui-pagehead { display: grid; grid-template-columns: minmax(0, 1fr); gap: var(--ui-space-md); margin-bottom: var(--ui-space-2xl); }
+  .ui-pagehead-kicker { margin-bottom: calc(var(--ui-space-3xs) * -1); color: var(--ui-text-muted); @apply --ui-eyebrow-type; }
+  .ui-pagehead h1 { margin: 0; color: var(--ui-text-strong); font-size: var(--ui-text-title); font-weight: var(--ui-weight-heading); line-height: var(--ui-leading-title); letter-spacing: var(--ui-tracking-title); text-wrap: balance; overflow-wrap: break-word; }
+  /* The lead runs a little past the reading measure: at 18px it keeps the same number of words a line. */
+  .ui-pagehead p { max-width: calc(var(--measure, 41rem) * 1.125); margin: 0; color: var(--ui-text-body); font-size: var(--ui-text-lead); line-height: var(--ui-leading-lead); letter-spacing: -.004em; text-wrap: pretty; overflow-wrap: break-word; }
+  /* A second line of the lead, at reading size. */
+  .ui-pagehead p + p:not([class]) { max-width: var(--measure, 41rem); margin-top: calc(var(--ui-space-xs) * -1); font-size: var(--ui-text-base); line-height: var(--ui-leading-body); letter-spacing: 0; }
+
+  /* The pager: the previous and next documents under one hairline, an eyebrow over each title; no boxes. */
+  .ui-pager { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: var(--ui-space-xl); margin-top: 5rem; padding-top: var(--ui-space-lg); box-shadow: inset 0 1px 0 var(--ui-line-hair); }
+  .ui-pager > a { display: grid; align-content: start; gap: var(--ui-space-2xs); color: var(--ui-text-body); text-decoration: none; transition: color var(--ui-duration-quick); }
+  .ui-pager > a:hover { color: var(--ui-text-strong); }
+  .ui-pager > a:focus-visible { @apply --ui-focus-ring; outline-offset: 4px; border-radius: var(--ui-radius-xs); }
+  .ui-pager > a[rel="next"] { justify-items: end; text-align: right; }
+  .ui-pager small { color: var(--ui-text-muted); @apply --ui-eyebrow-type; }
+  .ui-pager b { font-weight: var(--ui-weight-regular); font-size: var(--ui-text-base); line-height: 1.5; text-wrap: balance; }
+  .ui-pager > a[rel="prev"] > b::before { content: "←"; margin-right: .5em; color: var(--ui-text-muted); }
+  .ui-pager > a[rel="next"] > b::after { content: "→"; margin-left: .5em; color: var(--ui-text-muted); }
+  .ui-pager > a:hover > b::before, .ui-pager > a:hover > b::after { color: var(--ui-text-strong); }
+
+  /* Overlay dialog (search, image preview) */
+  .ui-dialog { width: min(40rem, calc(100vw - 2rem)); max-height: min(36rem, calc(100dvh - 4rem)); padding: 0; overflow: hidden; border: 0; border-radius: var(--ui-radius-2xl); background: var(--ui-surface-float); color: var(--ui-text-body); box-shadow: var(--ui-elevation-overlay); }
+  .ui-dialog::backdrop { background: var(--ui-surface-scrim); -webkit-backdrop-filter: blur(6px); backdrop-filter: blur(6px); }
+  .ui-dialog-search { display: flex; flex-wrap: wrap; align-items: center; gap: var(--ui-space-sm); min-height: 3.5rem; padding: 0 var(--ui-space-md); box-shadow: inset 0 -1px 0 var(--ui-line-hair); }
+  .ui-dialog-search input { flex: 1 1 8rem; min-width: 0; border: 0; background: transparent; color: var(--ui-text-strong); font: var(--ui-weight-regular) 1rem/1 var(--font-family-sans); }
+  .ui-dialog-search input:focus { outline: none; }
+  @media (forced-colors: active) { .ui-dialog-search input:focus-visible { outline: 2px solid Highlight; outline-offset: 2px; } }
+  .ui-results { display: grid; gap: 2px; margin: 0; padding: var(--ui-inset); list-style: none; }
+  .ui-results > li > a { display: grid; gap: 2px; padding: .625rem .75rem; border-radius: var(--ui-radius-md); color: var(--ui-text-body); text-decoration: none; }
+  .ui-results > li > a small { color: var(--ui-text-muted); font: var(--ui-weight-regular) .75rem/1.4 var(--font-family-sans); }
+  .ui-results > li > a b { color: var(--ui-text-strong); font-weight: var(--ui-weight-medium); font-size: var(--ui-text-small); }
+  .ui-results > li > a[aria-selected="true"], .ui-results > li > a:hover { background: var(--ui-surface-chip); box-shadow: inset 0 0 0 1px var(--ui-line-hair); }
+  .ui-dialog-foot { display: flex; flex-wrap: wrap; gap: var(--ui-space-md); padding: var(--ui-space-sm) var(--ui-space-md); box-shadow: inset 0 1px 0 var(--ui-line-hair); color: var(--ui-text-muted); font-size: .71875rem; }
+  .ui-dialog-foot span { display: inline-flex; align-items: center; gap: 6px; }
+
+  .ui-pagehead-meta { display: flex; flex-wrap: wrap; align-items: center; gap: var(--ui-space-xs) var(--ui-space-md); padding-top: var(--ui-space-xs); color: var(--ui-text-muted); font-size: .78125rem; }
+  .ui-pagehead-meta > a { color: inherit; text-decoration: none; }
+  .ui-pagehead-meta > a:hover { color: var(--ui-text-strong); }
+  .ui-pagehead-meta > span + span::before, .ui-pagehead-meta > * + a::before { content: "·"; margin-right: var(--ui-space-md); color: var(--ui-text-disabled); }
+}

package/src/styles/system/specimens.css

@@ -0,0 +1,98 @@
+/* Specimens and annotations: the vocabulary inside a stage. Hue appears only here, always named by a legend or label. */
+@layer components {
+  /* Item: a tile that stands for content. tone × variant */
+  .ui-item {
+    --tone: var(--ui-tone-neutral);
+    display: grid; place-items: center; min-width: 3rem; min-height: 3rem; padding: var(--ui-space-xs) var(--ui-space-sm);
+    border-radius: var(--ui-radius-md); @apply --ui-sheet-face;
+    color: var(--ui-text-strong); box-shadow: var(--ui-elevation-rise-1); font: var(--ui-weight-medium) .8125rem/1.4 var(--font-family-mono);
+  }
+  .ui-item[data-tone="blue"], .ui-badge[data-tone="blue"], .ui-legend [data-tone="blue"] { --tone: var(--ui-tone-blue); }
+  .ui-item[data-tone="violet"], .ui-badge[data-tone="violet"], .ui-legend [data-tone="violet"] { --tone: var(--ui-tone-violet); }
+  .ui-item[data-tone="amber"], .ui-badge[data-tone="amber"], .ui-legend [data-tone="amber"] { --tone: var(--ui-tone-amber); }
+  .ui-item[data-tone="green"], .ui-badge[data-tone="green"], .ui-legend [data-tone="green"] { --tone: var(--ui-tone-green); }
+  .ui-item[data-tone="red"], .ui-badge[data-tone="red"], .ui-legend [data-tone="red"] { --tone: var(--ui-tone-red); }
+  .ui-item:not([data-tone="neutral"], :not([data-tone])) {
+    background: linear-gradient(180deg, color-mix(in oklab, var(--tone) 10%, var(--ui-surface-sheet)), color-mix(in oklab, var(--tone) 13%, var(--ui-surface-sheet-lo)));
+    color: color-mix(in oklab, var(--tone) 72%, var(--ui-text-strong));
+    box-shadow: inset 0 1px 0 var(--ui-highlight), 0 0 0 1px color-mix(in oklab, var(--tone) 36%, transparent), 0 1px 1px -.5px var(--ui-shade-1), 0 2px 2px -1px var(--ui-shade-2);
+  }
+  .ui-item[data-variant="solid"] { background: var(--tone); color: light-dark(oklch(100% 0 none), oklch(15% .0016 265)); box-shadow: inset 0 1px 0 oklch(100% 0 none / .22), 0 0 0 1px color-mix(in oklab, var(--tone) 80%, black), 0 1px 1px -.5px var(--ui-shade-1), 0 2px 2px -1px var(--ui-shade-2); }
+  .ui-item[data-variant="outline"] { background: transparent; color: var(--ui-text-strong); box-shadow: inset 0 0 0 1px color-mix(in oklab, var(--tone) 60%, transparent); }
+  .ui-item[data-variant="ghost"] { background: var(--ui-hatch); color: var(--ui-text-muted); box-shadow: inset 0 0 0 1px var(--ui-line-divider); }
+
+  /* Badge: a small, legible category or state */
+  .ui-badge {
+    --tone: var(--ui-tone-neutral);
+    display: inline-flex; align-items: center; gap: 5px; max-width: 100%; height: 1.375rem; padding: 0 .5rem; border-radius: var(--ui-radius-sm);
+    background: color-mix(in oklab, var(--tone) 10%, transparent); color: color-mix(in oklab, var(--tone) 75%, var(--ui-text-strong));
+    box-shadow: inset 0 0 0 1px color-mix(in oklab, var(--tone) 24%, transparent);
+    font: var(--ui-weight-medium) .71875rem/1 var(--font-family-mono); letter-spacing: .01em; white-space: nowrap; vertical-align: middle;
+  }
+  .ui-badge[data-tone="neutral"], .ui-badge:not([data-tone]) { background: var(--ui-surface-well); color: var(--ui-text-body); box-shadow: inset 0 0 0 1px var(--ui-line-contour); }
+  .ui-badge[data-variant="dot"]::before { content: ""; width: 6px; height: 6px; border-radius: 50%; background: var(--tone); }
+  .ui-badge[data-size="sm"] { height: 1.125rem; padding: 0 .375rem; font-size: .65625rem; }
+
+  /* Label: names a condition, outside the measured layout */
+  .ui-label { display: inline-block; color: var(--ui-text-muted); @apply --ui-label-type; }
+  .ui-label[data-case="as-is"] { text-transform: none; letter-spacing: 0; font-size: .75rem; }
+  /* Without `as-is` a label is a quiet heading over a group: an eyebrow. */
+  .ui-label:not([data-case]) { @apply --ui-eyebrow-type; }
+
+  /* Legend: every teaching color has a visible name */
+  .ui-legend { display: flex; flex-wrap: wrap; gap: var(--ui-space-xs) var(--ui-space-lg); margin: 0; padding: 0; list-style: none; color: var(--ui-text-body); font: var(--ui-weight-regular) .75rem/1.4 var(--font-family-sans); font-variant-numeric: tabular-nums; }
+  .ui-legend > li { display: inline-flex; align-items: center; gap: var(--ui-space-xs); }
+  .ui-legend > li > i { --tone: var(--ui-tone-neutral); width: 10px; height: 10px; border-radius: 3px; background: var(--tone); box-shadow: inset 0 0 0 1px oklch(0% 0 none / .12); }
+
+  /* Measure: drafting leaders — hairline, end dots, value on the stage */
+  .ui-measure { display: grid; gap: var(--ui-space-xs); min-width: 0; }
+  .ui-measure-head { display: flex; flex-wrap: wrap; align-items: baseline; justify-content: space-between; gap: 2px var(--ui-space-sm); color: var(--ui-text-muted); font: var(--ui-weight-regular) .6875rem/1.4 var(--font-family-mono); }
+  .ui-measure-head output { color: var(--ui-text-strong); font-weight: var(--ui-weight-medium); font-variant-numeric: tabular-nums; }
+  .ui-measure-rule { position: relative; height: 9px; }
+  .ui-measure-rule::before { content: ""; position: absolute; top: 4px; right: 3px; left: 3px; height: 1px; background: var(--ui-line-mark); }
+  .ui-measure-rule::after { content: ""; position: absolute; inset: 1px 0 auto; height: 7px; background: radial-gradient(circle at 3.5px 50%, var(--ui-surface-stage) 2px, var(--ui-line-mark) 2.2px 3px, transparent 3.2px), radial-gradient(circle at calc(100% - 3.5px) 50%, var(--ui-surface-stage) 2px, var(--ui-line-mark) 2.2px 3px, transparent 3.2px); }
+  .ui-leader { position: absolute; display: flex; align-items: center; gap: var(--ui-space-xs); color: var(--ui-text-body); font: var(--ui-weight-medium) .65625rem/1 var(--font-family-mono); white-space: nowrap; }
+  .ui-leader > i { font-style: normal; color: var(--ui-text-muted); }
+
+  /* Axes: physical directions around the subject */
+  .ui-axes { display: grid; grid-template-columns: 2rem minmax(0, 1fr); grid-template-rows: auto auto; gap: var(--ui-space-sm); min-width: 0; }
+  .ui-axes > .ui-axes-inline { grid-column: 2; display: flex; align-items: center; gap: var(--ui-space-sm); color: var(--ui-text-body); font: var(--ui-weight-medium) .6875rem/1 var(--font-family-mono); white-space: nowrap; }
+  .ui-axes > .ui-axes-block { grid-row: 2; display: flex; flex-direction: column; align-items: center; gap: var(--ui-space-xs); color: var(--ui-text-body); font: var(--ui-weight-medium) .6875rem/1 var(--font-family-mono); }
+  .ui-axes > .ui-axes-block > span:first-child { writing-mode: vertical-rl; white-space: nowrap; }
+  .ui-axes-rule { position: relative; flex: 1; background: var(--ui-line-mark); }
+  .ui-axes-inline .ui-axes-rule { height: 1px; }
+  .ui-axes-block .ui-axes-rule { width: 1px; }
+  .ui-axes-rule::after { content: ""; position: absolute; width: 6px; height: 6px; border: solid var(--ui-line-mark); }
+  .ui-axes-inline .ui-axes-rule::after { right: 0; top: -3px; border-width: 1px 1px 0 0; rotate: 45deg; }
+  .ui-axes-block .ui-axes-rule::after { bottom: 0; left: -3px; border-width: 0 1px 1px 0; rotate: 45deg; }
+  .ui-axes > .ui-axes-content { grid-column: 2; grid-row: 2; min-width: 0; }
+
+  /* Swatch: a named role with its actual paint */
+  .ui-swatch { display: grid; gap: var(--ui-space-xs); min-width: 0; margin: 0; padding: var(--ui-inset); border-radius: var(--ui-radius-lg); @apply --ui-sheet-face; box-shadow: var(--ui-elevation-rise-1); }
+  .ui-swatch-paint { height: 4.5rem; border-radius: calc(var(--ui-radius-lg) - var(--ui-inset)); box-shadow: inset 0 0 0 1px var(--ui-line-contour); }
+  .ui-swatch > figcaption { display: grid; gap: 2px; padding: 0 4px 2px; }
+  .ui-swatch > figcaption b { color: var(--ui-text-strong); font-size: .75rem; font-weight: var(--ui-weight-strong); }
+  .ui-swatch > figcaption code { color: var(--ui-text-muted); font: var(--ui-weight-regular) .6875rem/1.4 var(--font-family-mono); overflow-wrap: anywhere; }
+
+  /* Palette: fixed preset colors, copy on click */
+  .ui-palette { display: grid; gap: var(--ui-space-md); container-type: inline-size; }
+  .ui-palette-row { display: grid; grid-template-columns: 4.5rem repeat(13, minmax(0, 1fr)); align-items: center; gap: 3px; }
+  .ui-palette-row > span { color: var(--ui-text-strong); font-size: .75rem; font-weight: var(--ui-weight-medium); text-transform: capitalize; }
+  .ui-palette-cell { display: grid; min-width: 0; gap: var(--ui-space-2xs); text-align: center; }
+  .ui-palette-cell > span { color: var(--ui-text-muted); font: var(--ui-weight-regular) .6875rem/1.5 var(--font-family-mono); }
+  .ui-palette-chip { appearance: none; forced-color-adjust: none; height: 2.25rem; border: 0; border-radius: var(--ui-radius-sm); cursor: pointer; box-shadow: inset 0 0 0 1px light-dark(oklch(0% 0 none / .06), oklch(100% 0 none / .08)); transition: translate var(--ui-duration-quick) var(--ui-ease), box-shadow var(--ui-duration-quick); }
+  .ui-palette-cell:first-of-type > .ui-palette-chip { border-radius: var(--ui-radius-md) 3px 3px var(--ui-radius-md); }
+  .ui-palette-cell:last-of-type > .ui-palette-chip { border-radius: 3px var(--ui-radius-md) var(--ui-radius-md) 3px; }
+  .ui-palette-chip:hover { translate: 0 -1px; box-shadow: inset 0 0 0 1px light-dark(oklch(0% 0 none / .08), oklch(100% 0 none / .2)), 0 4px 8px -4px var(--ui-shade-2); }
+  .ui-palette-chip:focus-visible { @apply --ui-focus-ring; outline-offset: 2px; }
+  @container (width < 36rem) { .ui-palette-row { grid-template-columns: repeat(7, minmax(0, 1fr)); } .ui-palette-row > span { grid-column: 1 / -1; } }
+
+  /* Spacing specimen */
+  .ui-spacing { position: relative; display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: var(--ui-space-md); padding: var(--ui-space-md); border-radius: var(--ui-radius-lg); background: var(--ui-hatch); box-shadow: inset 0 0 0 1px var(--ui-line-divider); }
+
+  /* Player: play, pause and replay a native animation; the timeline reads its actual state */
+  .ui-player { display: flex; flex-wrap: wrap; align-items: center; gap: var(--ui-space-xs); }
+  .ui-player-time { display: flex; align-items: center; gap: var(--ui-space-sm); flex: 1; min-width: 8rem; color: var(--ui-text-muted); font: var(--ui-weight-medium) .6875rem/1 var(--font-family-mono); font-variant-numeric: tabular-nums; }
+  .ui-player-time > .ui-bar { flex: 1; height: 4px; box-shadow: none; background: var(--ui-line-divider); }
+  .ui-player[data-state="playing"] .ui-player-time > output { color: var(--ui-text-strong); }
+}

package/src/styles/system/surfaces.css

@@ -0,0 +1,104 @@
+/* Surfaces and the example frame. tray (14) → 4px inset → stage / code / sheet (10) */
+@layer components {
+  .ui-sheet { position: relative; border-radius: var(--ui-radius-xl); @apply --ui-sheet-face; color: var(--ui-text-body); box-shadow: var(--ui-elevation-rise-2); }
+  .ui-sheet[data-elevation="1"] { box-shadow: var(--ui-elevation-rise-1); }
+  .ui-sheet[data-elevation="3"] { box-shadow: var(--ui-elevation-rise-3); }
+  .ui-sheet[data-elevation="flat"] { background: var(--ui-surface-sheet); box-shadow: var(--ui-elevation-flat); }
+  .ui-well { border-radius: var(--ui-radius-md); background: var(--ui-surface-well); box-shadow: var(--ui-elevation-sink); }
+
+  /* The tray holds one complete example: head, stage, source, caption */
+  .ui-tray { position: relative; min-width: 0; margin: 0; padding: var(--ui-inset); border-radius: var(--ui-radius-2xl); background: var(--ui-surface-tray); color: var(--ui-text-body); box-shadow: inset 0 0 0 1px var(--ui-line-hair), 0 1px 0 var(--ui-lip); }
+  .ui-tray-head { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: var(--ui-space-xs) var(--ui-space-md); min-height: 2.75rem; padding: 2px var(--ui-inset) var(--ui-space-xs) var(--ui-space-sm); }
+  .ui-tray-title { min-width: 0; margin: 0; color: var(--ui-text-strong); font-size: .8125rem; font-weight: var(--ui-weight-medium); line-height: 1.4; letter-spacing: 0; }
+  .ui-tray-description { margin: 2px 0 0; color: var(--ui-text-muted); font-size: .75rem; line-height: 1.5; }
+  .ui-tray-tools { display: flex; flex-wrap: wrap; align-items: center; gap: var(--ui-space-xs); }
+  .ui-tray-caption { margin: 0; padding: var(--ui-space-sm) var(--ui-space-sm) var(--ui-space-xs); color: var(--ui-text-muted); font-size: .78125rem; line-height: 1.6; text-wrap: pretty; overflow-wrap: anywhere; }
+  .ui-tray-caption code { color: var(--ui-text-body); }
+  .ui-tray > * + :is(.ui-stage, .ui-code, .ui-browser, .ui-compare) { margin-top: var(--ui-inset); }
+  .ui-tray > .ui-tray-head + :is(.ui-stage, .ui-code, .ui-browser, .ui-compare) { margin-top: 0; }
+  /* Concentric with the tray like every panel in it: 14 less the 4px inset. */
+  .ui-tray > .ui-callout { margin-top: var(--ui-inset); border-radius: var(--ui-radius-xl); }
+  .ui-tray > .ui-disclosure > summary { padding-inline: var(--ui-space-sm); }
+
+  /* The stage: a lit, slightly recessed well where the specimen stands. It holds a small specimen in a modest frame
+     (10rem) and otherwise follows its content, so a single row never floats in an empty well. */
+  .ui-stage {
+    position: relative; isolation: isolate; container: stage / inline-size; display: grid; place-items: center;
+    min-height: 10rem; padding: 3rem 2.5rem; border-radius: var(--ui-radius-xl); overflow: hidden;
+    background: var(--ui-stage-light), var(--ui-surface-stage);
+    box-shadow: inset 0 0 0 1px var(--ui-line-contour), inset 0 1px 2px light-dark(oklch(18% 0 none / .04), oklch(0% 0 none / .45)), 0 1px 0 var(--ui-lip);
+  }
+  .ui-stage[data-padding="none"] { padding: 0; place-items: stretch; }
+  .ui-stage[data-padding="sm"] { min-height: 0; padding: var(--ui-space-md); }
+  .ui-stage[data-align="start"] { place-items: start; }
+  .ui-stage[data-background="grid"] { background: linear-gradient(var(--ui-line-hair) 1px, transparent 1px) 0 0 / 20px 20px, linear-gradient(90deg, var(--ui-line-hair) 1px, transparent 1px) 0 0 / 20px 20px, var(--ui-stage-light), var(--ui-surface-stage); }
+  .ui-stage[data-background="dots"] { background: radial-gradient(var(--ui-line-divider) .8px, transparent 1.1px) 0 0 / 14px 14px, var(--ui-stage-light), var(--ui-surface-stage); }
+  .ui-stage[data-background="hatch"] { background: var(--ui-hatch), var(--ui-surface-stage); }
+  .ui-stage[data-background="checkerboard"] { background: conic-gradient(var(--ui-line-hair) 25%, transparent 0 50%, var(--ui-line-hair) 0 75%, transparent 0) 0 0 / 16px 16px, var(--ui-surface-stage); }
+  @media (width < 35rem) { .ui-stage { min-height: 8rem; padding: 2.25rem 1.125rem; } }
+
+  /* Inside a tray the stage is told apart by its tone alone: the tray's ring is the example's one edge, so a framed
+     subject on the stage (a card, a form, a window) is the only line within it. */
+  .ui-tray .ui-stage { box-shadow: none; }
+
+  /* Standalone stage without a tray (embedded in prose for very small specimens) */
+  .ui-stage[data-standalone] { border-radius: var(--ui-radius-2xl); }
+
+  /* Comparison: the same subject under two conditions */
+  .ui-compare { display: grid; grid-template-columns: repeat(auto-fit, minmax(min(100%, 15rem), 1fr)); gap: var(--ui-inset); }
+  .ui-compare > figure { display: grid; grid-template-rows: auto 1fr; gap: 0; min-width: 0; margin: 0; }
+  .ui-compare > figure > figcaption { padding: var(--ui-space-xs) var(--ui-space-sm); color: var(--ui-text-muted); @apply --ui-label-type; }
+  .ui-compare .ui-stage { min-height: 11rem; padding: var(--ui-space-xl) var(--ui-space-lg); }
+
+  /* Browser chrome for a real document in an iframe: one contour drawn over the whole window, the toolbar a tray tone
+     above the page with its dots only — the tray head names the document. Tone, not rules, parts them. */
+  .ui-browser { position: relative; overflow: hidden; border-radius: var(--ui-radius-xl); background: var(--ui-surface-stage); box-shadow: 0 1px 0 var(--ui-lip); }
+  .ui-browser::after { content: ""; position: absolute; inset: 0; z-index: 2; border-radius: inherit; box-shadow: inset 0 0 0 1px var(--ui-line-contour); pointer-events: none; }
+  /* A tray that holds only a browser lends it its place in the flow, not another frame. */
+  .ui-tray:has(> .ui-browser:only-child) { padding: 0; border-radius: var(--ui-radius-xl); background: none; box-shadow: none; }
+  /* Plain: a preview without chrome, where the window is not the lesson. It is a stage: inside a tray its tone sets it
+     apart and the contour goes; alone, or in a tray that lends it only its place, it keeps the contour as its edge.
+     A client viewport sits in its island's wrapper, so the tray is an ancestor, not a parent. */
+  .ui-tray .ui-browser[data-variant="plain"]::after { content: none; }
+  .ui-tray > .ui-browser[data-variant="plain"]:only-child::after { content: ""; }
+  .ui-browser-bar { display: flex; align-items: center; gap: var(--ui-space-sm); height: 2rem; padding: 0 var(--ui-space-sm); background: var(--ui-surface-tray); }
+  .ui-browser-dots { display: flex; gap: 6px; }
+  .ui-browser-dots > i { width: 9px; height: 9px; border-radius: 50%; background: var(--ui-line-divider); }
+  .ui-browser-body { position: relative; min-height: 12rem; }
+  /* A real document: the tools set the viewport width, the handle follows its edge */
+  .ui-browser-body:has(> .ui-browser-viewport) { min-height: 0; overflow-x: auto; scrollbar-width: thin; }
+  .ui-browser-viewport { position: relative; max-width: none; margin-inline: auto; }
+  .ui-browser-viewport > iframe { display: block; width: 100%; border: 0; background: transparent; }
+  /* The example's controls: a row on the tray itself, between the stage and the source, aligned with the tray head. No
+     surface of their own, so the stage stays the document and nothing inside it reads as part of the page shown. */
+  .ui-browser-tools { display: flex; flex-wrap: wrap; align-items: center; gap: var(--ui-space-xs) var(--ui-space-sm); padding: var(--ui-space-sm) var(--ui-space-sm) var(--ui-space-xs); }
+  /* One rhythm around the row: 12px to the stage above and to the source below (its 8px plus the tray's 4px inset), or to the first line of
+     a caption; its ends 16px in from the tray's edge, on the tray head's start; every control in it one 32px height. */
+  .ui-tray > :has(> .ui-browser-tools:last-child) + .ui-tray-caption, .ui-tray > .ui-browser-tools + .ui-tray-caption { padding-top: 0; }
+  .ui-browser-tools > .ui-segmented > :is(button, a) { min-height: 1.625rem; }
+  /* The range, its caption and its live reading stay one group, so a phone never parts the width from its slider. */
+  .ui-browser-range { display: flex; flex: 1 1 14rem; align-items: center; gap: var(--ui-space-sm); min-width: 0; }
+  /* Enlarged text must leave room for the label and reading in a narrow article. */
+  .ui-browser-range > .ui-range { flex: 1 1 6rem; min-width: 0; max-width: 12rem; }
+  /* The range's caption is a label in the tools' own type, whether or not the specimen parts are loaded. */
+  .ui-browser-range > label { color: var(--ui-text-muted); @apply --ui-label-type; }
+  .ui-browser-tools > output, .ui-browser-range > output { flex: 1 1 100%; color: var(--ui-text-muted); font: var(--ui-weight-regular) .6875rem/1.5 var(--font-family-mono); overflow-wrap: anywhere; }
+  /* The live viewport width stays beside the range that sets it. */
+  .ui-browser-range > .ui-browser-size { flex: none; font: var(--ui-weight-regular) .75rem/1.5 var(--font-family-sans); font-variant-numeric: tabular-nums; }
+  .ui-resize { position: absolute; top: 0; right: 0; bottom: 0; display: grid; place-items: center; width: 1rem; cursor: ew-resize; touch-action: none; }
+  .ui-resize::before { content: ""; width: 4px; height: 2.5rem; border-radius: var(--ui-radius-pill); background: var(--ui-line-strong); }
+
+  /* Local scroll region, keyboard reachable */
+  .ui-scroll { overflow: auto; overscroll-behavior: contain; max-height: 16rem; border-radius: var(--ui-radius-lg); background: var(--ui-surface-well); box-shadow: var(--ui-elevation-sink); }
+  .ui-scroll:focus-visible { @apply --ui-focus-ring; outline-offset: 2px; }
+
+  /* Expand: a long surface clamps under a canvas fade, with one quiet control to show the rest */
+  .ui-expand { position: relative; min-width: 0; }
+  .ui-expand[data-expanded="false"] > :first-child { max-height: 30rem; overflow: hidden; }
+  .ui-expand-control { display: flex; justify-content: center; padding-top: var(--ui-space-sm); }
+  .ui-expand[data-expanded="false"] > .ui-expand-control { position: absolute; inset-inline: 0; bottom: 0; padding-top: 6rem; background: linear-gradient(to bottom, transparent, var(--ui-surface-canvas) 72%); }
+  .ui-expand[data-expanded="true"] > .ui-expand-control { position: sticky; bottom: var(--ui-space-sm); pointer-events: none; }
+  .ui-expand-control > .ui-button { pointer-events: auto; }
+  .ui-expand-control > .ui-button > svg { transition: rotate var(--ui-duration-quick) var(--ui-ease); }
+  .ui-expand[data-expanded="true"] > .ui-expand-control > .ui-button > svg { rotate: 180deg; }
+}