# Layout: agent spec

Twin of `/layout`. Source wins: `packages/brand/app/assets/css/brand.css`, `app/assets/css/main.css`, `app/pages/[...slug].vue`, `packages/brand/app/app.config.ts`.

## Breakpoints

Tailwind v4 defaults, with `lg` moved to 1124px (`packages/brand/app/assets/css/brand.css`).

| Breakpoint | Width | What changes |
|---|---|---|
| Base | 0–1123px | One column for `::grid`, `::compare-grid`, `::component-grid`, at any `columns`. Top bar and menu (`MobileBar.vue`). |
| `md` | 768px / 48rem | Website pads go 4 across. |
| `lg` | 1124px / 70.25rem (`--breakpoint-lg`) | The layout switch. Grids take their column count. `::component-grid` is 2 columns. Sidebar (`UPageAside`) and foot bar replace the top bar. `--page-gutter` 15px → 60px. Type takes its full steps (`/agent/typography.md`). |
| `xl` | 1280px / 80rem | `::component-grid` is 3 columns. The report's section navigator (`ReportToc`) shows. |

- Use `lg:` for anything that follows the sidebar. The below-`lg` tokens are one `@variant max-lg` block in `brand.css`.
- In JS, use `useSiteBreakpoints()`. Never write a raw width in a media query: use `@variant` in CSS.
- `sm` changes nothing in the guide's layout.

## Spacing

Tailwind's 4px unit. No separate scale.

| Value | Px | Use |
|---|---|---|
| `gap-x-4` | 16 | `::grid` column gap (default `gap="4"`), `::component-grid`, `::compare-grid` (`gap-4`) |
| `gap-y-8` | 32 | `::grid` row gap: twice the column gap |
| `my-6` | 24 | Space above and below a grid |
| `mt-6` | 24 | Page title to lead |
| `my-5` | 20 | Between prose paragraphs (Nuxt UI prose `p`) |
| `p-6` | 24 | Padding in 3:2 tiles (`LogoTile`, `TypeTile`, `MotifSquare`) |
| `p-8` | 32 | Padding in `IconTile`, `IconPairTile`, `ComponentCard`; sidebar top (`pt-8`) |
| none | 0 | `LogoClearspace`, `LogoMarkStage`, `ProfileMockup`, loader preview: art sized in the tile |
| `mt-3` | 12 | Caption under a tile (`TileFrame`) |
| `--sidebar-gap` | 64 (4rem) | Sidebar to content |
| `--prose-h2-above` | 96 (6rem) | Above every `##` |
| `--prose-h2-below` | 32 (2rem) | Below every `##` |
| `--prose-h3-above` | 48 (3rem) | Above every `###` |
| `--prose-h3-below` | 16 (1rem) | Below every `###` |
| `--page-gutter` | 60 (3.75rem); 15 (0.9375rem) below `lg` | Page side margin, both bars |
| `--text-measure` | 56ch (521px) | Prose `p`, callout; `ul`/`ol` take `+ --spacing(6)` (545px) |

## Composition grid

`/layout` shows only this grid; the guide's own web layout lives in this spec. For covers, posts, adverts and slides. `app/utils/composition-grid.ts` (`compositionGrid({ width, height })`); demo `::layout-grid` (`LayoutGrid.vue`), in a 16:9 `bg-elevated` tile, `p-4`.

| Term | Value |
|---|---|
| Cell (`c`) | Square. `width / (4n + 5)` |
| Block | 2 × 2 cells (`COMPOSITION_BLOCK_CELLS`) |
| Columns | 4 (`COMPOSITION_COLUMNS`), each `n` cells, `n` odd: `2 × round(((width / target - 5) / 4 - 1) / 2) + 1`, `target = min(width, height) / 25`. Every column starts on a block edge |
| Margin | 1 cell, every side. Nothing is placed in it |
| Gutter | 1 cell (`COMPOSITION_GUTTER_CELLS`) |
| Column `i` | starts at `c + i × (n + 1) × c`, width `n × c` |
| Rows | `floor((height - 2c) / c)`, from the top margin. The bottom margin takes the remainder |
| Mark | 2 cells high (`COMPOSITION_MARK_CELLS`), bottom right; its foot on the last row line. Y = 1.34c, so the 1-cell margin clears ½Y |
| Title | Two lines, top left. Capitals 2 cells high: font size `2c / 0.6505` (Overused Grotesk cap height). Baselines on rows 2 and 5; row 3 empty. Line 1 `--ui-primary`, line 2 `--ui-text-muted`. Tracking -0.045em |
| Caption | CommitMono 400, uppercase, tracking 0.025em, font size `title × 10 / 72` (label to H1), bottom left, baseline on the last row line |
| Type sizes | ≤ 3 per composition |

Demo formats: 1920 × 1080 (16:9: `n` = 9, 41 cells, `c` = 46.8, 21 rows) and 1080 × 1350 (4:5: `n` = 5, 25 cells, `c` = 43.2, 29 rows).

Pattern on the grid, in blocks:

1. `generatePatternBlocks({ cols: floor((cells across - 2) / 2), rows })` from the left margin. The live width is odd cells: the last block in the band takes the spare cell (3 or 5 cells wide), so the path ends on the right margin.
2. Band: its bottom row holds the mark and the caption; the row above is the generator's clear row. Path rows: `min(blockRows, max(min(square + 2, blockRows), round(rows / 2 × 0.6)))` blocks, bottom on the last row line.
3. `blockRows`: `floor((rows - 6) / 2)`, so every block stays ≥ 1 cell from the title (`floor((rows - 7) / 2)` under the title). Square rows: a square that starts ≥ 1 block right of the title's measured width may rise to the top margin (`floor(rows / 2)`; blocks are shifted down into the lower band, the rows above open only to the square); a square under the title keeps `floor((rows - 7) / 2)`, ≥ 1 block from it.
4. Square: `--ui-primary`, whole blocks. Landscape 1.1 columns, portrait 1.5 (`squareColumns`): `round((span × n + ceil(span) - 1) / 2)` blocks, clamped to square rows `- 2`. Starts on any block (seed `× 15485863`) among the placements with path on both sides and the largest size, then `placePhoto({ size, edges: [edge] })`. It need not align to a column. Measured: 16:9 gives 10 cells, 4:5 gives 8.
5. Checked over 200 seeds in the browser (100 per format): nothing in the margins, every block ≥ 2 × 2 cells and ≥ 1 cell from the title, caption and mark, the square ≥ 1 block from them, the path touching both sides of the square and ending on the right margin.

Canvas `var(--ui-bg)`, gradients `var(--ui-bg)` to `var(--ui-primary)`. Grid overlay: `--ui-text-dimmed`, dashed 3 2; margins and column edges full, cell lines at 40%.

## Tiles

| Tile | Shape |
|---|---|
| Logo, logo stage, `::profile-mockup`, clearspace, type, component card, pattern, motif, loader preview, prose card (`ui.prose.card`) | 3:2 (`aspect-[3/2]`) |
| `IconTile`, `IconPairTile` | Square |
| Colour chip (`PalettePair`: two square chips, 2:1) | Square |

`MotifSquare` draws a square motif inside its 3:2 tile. A captioned tile wraps `TileFrame` (`as="figure"` gives a `figcaption`).

## Rounding

Two styles. Pick one per surface and hold it for everything on that surface.

| Style | Content containers | Controls | Hairline and shadow |
|---|---|---|---|
| Square | 0 (`rounded-none`) | `--ui-radius`: 0.125rem / 2px | None |
| Rounded | `--radius-panel` 1.25rem (panel), `--radius-tile` 0.75rem (tile in a panel) | `--radius-control` 0.5rem, `--radius-thumb` 0.25rem (inside a tile), `rounded-full` (chips, search field) | `--hairline` ring (ink at 10%) and `0 8px 16px rgb(0 0 0 / 0.12)` on floating surfaces only |

The guide's own pages are Square. The website (`Site*`) is Rounded: grey page (`bg-elevated`), panels on the grey too (`sitePanel`, 8px padding, 8px apart, told apart by their shadow), tiles on the ground inside a panel. Things on a tile (its arrow badge, the carousel's buttons, the newsletter field) are the grey. `::report-note` is `rounded-3xl`.

Nested rounding: outer radius = inner radius + padding between them (20 = 12 + 8, 12 = 4 + 8).

## Rules

1. Gap between groups ≥ 2× gap inside a group.
2. A content container is a flat fill (`bg-elevated`, the ground or a palette surface) with no border or outline. Square: no box inside a box. Rounded: a tile sits inside a panel, never deeper.
3. Square: borders and `--ui-radius` are for controls only. Rounded: `--hairline` only on a floating surface (the menu) and on the search field.
4. Do not add a one-off gap or a new breakpoint. Reuse a step or change the content.
5. A caption is body text, left-aligned, `mt-3` under its tile (`TileFrame` `label`). Never a mono `text-caption` label, never under a rule.
6. No rules between sections or under the page title. Section spacing separates.
7. Media spans the content column. Text keeps `--text-measure` (56ch). The lead keeps `max-w-[40rem]`.
8. Navigation, search and the theme switch stay reachable at every width. Below `lg` they live in the menu.
9. On the report, a block that also renders on a slide uses a container query, never a viewport query.
10. Never shrink type to fit a slide. Paginate.
11. Do not add next/previous links at the foot of a page.

## Guide chrome (`[...slug].vue`)

- Page grid from `lg`: full window width, no max-width. `--page-gutter` each side, `--sidebar-width` (26rem) column, `--sidebar-gap`, content `minmax(0,1fr)`.
- Sidebar: navigation only, no logo. Items on the Body step (16/22), `--nav-pitch` 40px apart, only the current page in full ink.
- Foot bar (from `lg`, guide pages only): fixed, `h-16`, `bg-default`, no rule, in a `UContainer`. Left: the search field (icon and a borderless `type="search"` input, placeholder "Search") and `ThemeSwitch`. Right: `LogoMark fit intro="load"`, 30px tall, linking home. Pages reserve `h-16` at the foot. Sidebar takes `pb-24`.
- Top bar (below `lg`, `MobileBar.vue`): sticky, `--mobile-bar-height` 54px (3.375rem), page ground. Menu button (40×40) on the left gutter, `LogoMark fit intro="load"`, 30px, on the right. Hides on scroll down, returns on scroll up, stays while the menu is open.
- Search: no modal and no ⌘K. `useSiteSearch()` holds the query and the sections (`queryCollectionSearchSections`, loaded on first focus). While the query is not empty, or after Search in the menu, `SearchResults` replaces the page header and body in the content column: an H1 "Search", a count line, then results (title, trail, excerpt), at most 30, title matches first. Below `lg` it has its own field. Escape, a result, or a page change clears it.
- Menu: fills the window under the bar. Pages at H3 (`py-1.5`, 42px apart, `pt-2` above the first), left on the gutter. Its foot is `h-16`. Search (a button) left and `ThemeSwitch` right at its foot. Search closes the menu and opens the results view. A disclosure (`aria-expanded`), not a dialog. Escape, the button, a page choice or widening past `lg` closes it. The page under it does not scroll.
- Page title: `pt-11.5` (46px) under the top bar, `pt-8` from `lg`.

## Report layout

- Artboard: 1280×720, scaled with `transform: scale()` on `.deck-canvas` (`transform-origin: top left`). Print: `@page { size: 1280px 720px }`.
- Containers: `.report-paper` and `.deck-canvas`. Container queries: `@5xl` in `ReportSection`, `@3xl` in `ReportTimeline`, `@container` on `.report-stats`.
- Gutter: `--report-gutter` 1rem, 3.75rem from 40rem, 2rem on a slide. Each block's `*-frame` element (`.report-cover-frame`, `.report-quote-frame`, `.report-section-frame`) holds the padding the deck re-insets.
- Column: `--report-column` and `--report-column-start` (from `--report-measure`, `--report-gutter`, `--report-rail`). `.breakout-grid`, bands, covers and the quote read them.
- `::report-section`: header column `--report-header-width` (19rem) beside the body, `items-start`. A body that opens on text drops so its first line sits on the title's last baseline (measured in `ReportSection`).
- `.breakout-grid` places every top-level block in the column. `full-bleed` escapes it, only as a direct child of the grid.
- On a slide, a body holding `.report-slide-foot` or a table goes to the slide's foot, full width (`main.css`).
- `::report-stats`: 1 column, 2 from a 48rem container, 4 on a slide (`.report-deck .report-stats`). The only mode-based layout. Use CSS, not JavaScript.
- A section too long for a slide paginates (`paginate` in `ReportDeck.vue`) with the same eyebrow, title and icon.

## Craft: `better-layout`

- Group with space first, a background shape second, a line last.
- Make every control distinct from content: a fill, a border or a fixed place.
- Use logical properties (`ps-*`, `pe-*`, `ms-*`, `me-*`, `inset-inline`). Physical `left`/`right` only for the deck's two paging zones.
- DOM order is reading order. A visual move (`order`, `grid-area`) does not change it.
- Give hidden content a visible cue: a disclosure control, or the next item peeking 16–32px.
- Space controls 12px apart when bordered or filled, 24px when text- or icon-only. Hit areas never overlap.
- Backgrounds and media may bleed. Controls and text stay inside the margins and `env(safe-area-inset-*)`.
- Break where the content stops fitting. Prefer a container query.
- No fixed width or height on a text container. Use `max-width`.

## Craft: `better-accessibility`

1. Use the native element: `<button>` for an action, `<a href>` for navigation. Every enabled button, `role="button"`, `summary`, `label[for]` and `select` shows the pointer (`main.css` base layer).
2. Show focus on `:focus-visible`. A custom ring has ≥2px solid perimeter and survives forced colours. Never `outline: none` without a replacement.
3. Hit area ≥ 24×24px. Aim for 44×44 on touch. Extend with a pseudo-element. Decorative layers take `pointer-events: none`.
4. Every pointer action has a keyboard path. Escape closes an overlay. Use only `tabindex="0"` or `"-1"`.
5. Every control has an accessible name. An icon-only button takes `aria-label`. A decorative element takes `aria-hidden="true"`, never a focusable one.
6. Colour is never the only signal. Add an icon, a word or an underline.
7. Alt text by purpose: describe an informative image, `alt=""` for a decorative one. An icon beside its own text takes `aria-hidden`.
8. Reduced motion: `/agent/motion.md`.

## Related

- `/agent/typography.md`: type steps, `--text-measure`.
- `/agent/motion.md`: motion tokens, reduced motion.
- `/agent/icons.md`, `/agent/pattern.md`: tile and full-bleed uses.
- `/agent/colour.md`: contrast floors.

## Content components

- `::compare-grid` takes `mt-16` (64px) straight after a grid: twice the grid's 32px row gap.
- `::compare-card{variant label}`: no fill. The label and the check or cross icon are in the ink (`text-highlighted`); the text is body. No red or green.
- `::placeholder-image{src label alt}`: `src` defaults to `/placeholder.jpg` (1920×1280), 3:2, full width, in `TileFrame`. A stand-in for an image that does not exist yet; with `src`, a real 3:2 image from `public/images/`.
- Icon tiles (`IconTile`, `IconPairTile`): the icon sits absolutely inside the `aspect-square` box (`inset-8`), so Safari cannot stretch the box to the icon. Icons are at most 128px: a single tile is capped at `max-w-48` (192px), a pair tile at `max-w-80` (320px; no gap, each icon moved 8px inward, since each glyph has padding inside its 512 frame). The box shrinks with the icon. Their grids are `::grid{columns="icons"}` (columns 8–12rem) and `columns="icon-pairs"` (10–20rem), packed from the left, not stretched to the content width.

## Website components

`packages/site-ui/app/components/site/*.vue` (`Site*`). Shown on `/components` under Website (`::website-components`), composed at `/examples/homepage` (`app/pages/examples/homepage.vue`), and placed as MDC blocks in the website app (`apps/site/content/staging/`, data in `apps/site/content/staging/data/`). Each wraps one Nuxt UI component and restyles it through `ui`, in the Rounded style. Type from `packages/brand/app/utils/type-steps.ts` (sizes repeat at `sm:` and `lg:`, so they replace Nuxt UI's breakpoint sizes). Image stand-ins are grey `bg-accented` fills. The source design is the Pencil file's DEMO SOURCE frame.

| Component | Built on | Notes |
|---|---|---|
| `SiteHeroTicker{lead titleLines speed clients}` | `SiteHeroNotes`, `SiteHomeMark`, `useRollTravel` | Home's hero, the window's height at every size. Mark and headline at the top, never shrinking: H2, and from `lg` 9svh between H2 and H1; `lead` ("Motive Unknown") in `--brand-accent`, the rest and the mark in `--surface-ink`, the headline in front (z 2). Logo ticker at the foot, never shrinking: logos 24px (28px from `lg`), masks in `--surface-ink` at 10%; the logo nearest the middle is `--brand-accent`. The notes fill the space between. |
| `SiteHomeMark` | `LogoMark`, `ULink` | The mark, linking to the site's home. |
| `SiteHeroNotes{images active seed still}` | `generatePatternBlocks`, `SiteDuotone` | The piano roll's walk, still, no playhead or label: notes are a gradient to `--brand-accent`. `active` (the ticker's middle logo) opens one note to a square as tall as the roll, with that client's image. Notes before it slide left and notes after it right by half the growth, so the walk stays joined. Open and close take `--duration-slow`. Only notes far enough in for the square to stay on screen open, never the one beside the last. `still`: the note nearest the middle stays open at every width and nothing moves. |
| `SiteDuotone{src}` | none | A photo in two colours from the rendered theme (`useRenderedTheme`): the page and the Accent. The darker of the two is the ink, so the image stays positive in every theme. CSS blend modes, no shader. |
| `SitePageHero{title description image breadcrumb compact}` | `SiteHeroNotes`, `SiteHomeMark`, `SiteBreadcrumb` | Every page but Home starts with it: the mark, H1, the description, still piano notes. `image` puts the page image in one open note. `compact` shortens it. With no `title`, only the mark and the notes show. |
| `SiteHeroImage{images note}` | `SiteFloatSquare` | A floating square, 1.5 times the client roll's squares, clear of the playhead and the edges. Each new `note` moves to the next image. |
| `SiteStatement{text images}` | `ScrollFloat`, `SiteFloatSquare` | The text crawl, pinned for 300lvh: `ScrollFloat` (`flip`, by letter, up, from the start, `sine.inOut`, duration 0.9, stagger 0.09, smoothing 1s, distance 130, stretch 1, no clip) floats the letters in from `--brand-accent` to the ink as the pin's progress runs. `SiteFloatSquare`s rise from the foot of the window in the room beside the text, the frame's padding clear of the edge and the text; with room under half a square (a phone) there are none. Reduced motion: no pin, text at rest. |
| `SiteFloatSquare{size x y scale src}` | none | A floating square image that crossfades to a new `src`. |
| `SiteServiceRoll` | none | Home: the services run past a playhead, half the window tall. The track position is written to the element, not bound, so the roll does not re-render every frame. |
| `SiteManifesto{lines}` | none | About: the page's H1, a sentence at a time, run on as one centred block. |
| `SiteMenu{links contact sections fixed stowed}` | Vue Equipment `MagicMenu` (`dropdown`, no scroll lock), `@maas/vue-autosize` | A fixed pill, 8px from the bottom and sides, at most 35rem. The bottom gap is `--site-menu-bottom` (0.5rem, and 1px on iOS WebKit, `@supports (-webkit-touch-callout: none)`): iOS 26 Safari draws nothing fixed below its layout viewport, so the pill sits 1px above that cut. The page is `viewport-fit=cover`, and on iOS the page fades into Safari's band around the menu. The open height is `100dvh` less both gaps and the bar, so it follows the toolbar. The scrub readout sits 8px above the pill. The roll (`SiteMenuRoll`, `useSiteRoll`) and a menu button. Opening grows the pill upward on `springMenuOpen` to fill the window (8px top and bottom) through `AutoSize`; the scrim is black at 50%. Panes are `MagicMenuChannel`s: root (square tiles, 2 across: the links, then Contact when `contact` is set, then the theme switch last as a ghost tile, no fill, an inset hairline), one list per item with `children` (its title beside Back), and `contact` (the form's title beside Back, then `SiteFormFields` `inline` `fill` with the privacy tick; fields and button `--radius-tile`; the message box at most 16rem, `--textarea-max-height`). A remote pushes a pane in from the right and Back pops it; items fade and rise in after the expansion, 35ms apart in reading order. Escape, an outside click, a link, or a drag down on the handle and header past 96px (`usePointerSwipe`; the pill follows the finger through `--sm-drag-y`, `data-dragging` while held) close it. `fixed: false` for `/components`. `stowed` slides the closed menu out under the window's foot. |
| `SiteMenuRoll{roll}` | none | The page as notes on three rows, one per section, width by section height; side-by-side sections split their span. Read notes in the ink, the rest dimmed, a `--brand-accent` playhead. A slider: drag scrubs the page, arrows and Home / End move by section. `#scrub` slot for the readout bubble. |
| `SiteTile{title description to icon meta}` | `ULink` | The square content pad ("drum pad"): a Motive icon or a `meta` line, the arrow chip (8px into its corner, `--radius-thumb`), the title (Body, H3 from `lg`), a two-line description from `xl`. The icon is `padIcon`: 30% of the pad, 64px to 256px. Every content link is one. Classic text buttons stay wide. |
| `SiteSection{title link row}` | none | The S card: panel, H2 with one link or an `#action` control, then a grid of square pads (2 across, 4 from `md`), any number of rows. With no `title`, no header: only the pads, labelled by `aria-label`. `row`: the pads scroll sideways in a `SiteRow`. |
| `SiteRow{id}` / `SiteRowControls{id}` | `MagicCarouselProvider`, `MagicCarouselTrack`, `SiteIconButton` | Pages of four square pads that scroll sideways: two by two on a phone, four across from `md`, from the left. The right edge fades while more pages are past it, never the left. `SiteRowControls` with the same `id` pages it, one page a click. A spent arrow keeps its fill and dims its icon. |
| `SiteCardSection{title cards source link layer}` | `SiteSection`, `SiteTile` | 2 × 2 `SiteTile`s, 4 across from `md`. `source`: `divisions` or `jobs` (a job's type and place as `meta`). `cards` follow. `layer="page"`: the title centred over the first four tiles, two by two, title only, square, no card; full width until `xl`, then as wide as two of a card's four pads. |
| `SiteClientList{title clients}` | none | Selected client, a page section that stays in place: in the middle of the window the title, then one client's name (H2, H1 from `lg`) and its services on the next line. A square image, sized to hide the text, scrolls up over it for each client, the first too, a window apart. The image covers the last client with no fade; when it covers the text, its client takes over, and each line floats in (`ScrollFloat`, as Home's statement) as the image's bottom edge passes it. A CSS scroll-driven animation (`.site-client-cover`) eases each image, faster at the edges and slower over the text, on native scroll. A client with no hero image takes another client's. A `sr-only` H2 holds the title and a `sr-only` list names every client. |
| `SiteCollectionGrid{source title division clients layer link emblem rise riseTo row}` | `SiteDrawerGrid`, `SiteProse` | `source` `services` (filtered by `division`) or `case-studies` (`clients` picks them, in order). The drawer's text is a service's body or a case study's summary in `SiteProse`. A case study's heading (`heading` slot) is an `hgroup`: its title as the H2 (`typeH2`, as "Ecommerce for world tour"), then the client's name (`typeH3`). `layer="page"` (default): a page section. `layer="card"`: an S card. `rise`: a last pad that names the items one at a time. |
| `SiteDrawerGrid{items title label layer link emblem rise riseLabel riseTo row iconCard}` | `SiteSection`, `SiteDrawerTile`, `SiteDrawer`, `SiteFade` | Square pads that open the item in one `SiteDrawer`: its image (or fading `images`) in the media pad, an H2 title (the `heading` slot replaces it), then the `page` slot. Previous and Next sit in `SiteDrawer`'s `footer`: ghost buttons (`ring-1 ring-inset` `--hairline`, no fill), `h-14`, `--radius-tile`, two across; a spent one dims in place. They and ArrowLeft and ArrowRight page it, from the top. The page behind keeps the current tile in view, so a close lands on it, with focus on it. `#<slug>` opens it. An item with a `logo` (a case study): the images dimmed (`--image-shade` at 50% opacity). `iconCard` (services): no image; the icon centred in the media pad, `50cqi`, in the Accent unless `emblem` is `ink`. |
| `SiteDrawerTile{title icon logo mark backdrop emblem as}` | `SitePad` | A drawer grid tile: a mark at the top (a Motive `icon`, else a `logo` mask, else `mark` set at H3), the title at the foot. `backdrop`: an image behind the face, darkened, the face in white. `emblem`: `accent`, `ink` or `none`. |
| `SiteContactDrawer` | `SiteDrawer`, `SiteFormFields` | On every website page. `#start-a-project` opens it: the site's `contactForm`, no media. Closing drops the hash and keeps the scroll place. |
| `SiteFade{images playing}` | none | Images that fade into each other in turn while `playing`: a case study's images in its drawer. |
| `SiteRisePad{names label to}` | `SitePad` | A pad that names `names` one at a time, each fading in quickly in place of the last: a list that is read, not clicked. `label` just over the names, both at the pad's foot. `to`: the pad is a link (`ULink`), with the arrow chip 8px into its top right, like `SiteTile`'s; the sector pages link it to the Services page (`rise-to`). Accent fill. |
| `SiteDrawer{id title image}` | Vue Equipment `MagicDrawer` | The one content overlay: the menu's panel at `--site-panel-width` (26rem; on a phone the window less `--site-menu-side` a side), over the menu bar, `100dvh` less the site gap tall, no shadow, no handle. One scrolling body: a 3:2 media pad (`image` or the `media` slot) with Close 8px in from its top right, in the panel colour, then the default slot on the panel. The `footer` slot sticks to the body's foot, 8px in like the media pad, over a fade from the panel colour (`--site-tile-chip`) to clear over 3rem: long text scrolls under it. The body shows no scrollbar (`scrollbar-width: none`, `site.css`). With no media, Close sits top right of the text. No header: `title` names it for screen readers. Drag down, Esc or the blur close it. Open with `useMagicDrawer(id).open()`. `scrollToTop()` is exposed. |
| `SiteHandle` | none | The drag handle at the top of the open menu. The drawer has none. |
| `SiteButton{label to type}` | `UButton` | Every basic button: ink fill (warm black in Light, warm white in Dark), never the Accent, 44px tall, 14px radius, 16px sides (the Subscribe button's size). Icon buttons stay square. |
| `SiteIconButton{icon label fill}` | `UButton` | A square 44px icon button, `--radius-control`. `fill`: `grey` (default), `ground` or `accent`. Disabled keeps the fill and dims the icon. |
| `SitePair` / `SitePad{image alt as}` | none | The M card: a panel of exactly two square pads (one column, two from `lg`), nothing above or below. A pad is `bg-elevated` at `--radius-tile`; an image pad fills and clips; a text pad grows past square rather than clip. |
| `SiteMediaText{title image alt link reverse}` | none | Panel: H2, `SiteProse` slot, a link, beside a square image tile (`reverse` puts it first from `lg`). |
| `SiteProse` | none | Markdown body at the measure, Body type, no paragraph margins. |
| `SiteText{title}` | none | Long text on the page layer, for legal pages: `title` is the page's H1, centred at H2 size; the text centred and centre-aligned at the measure, H2 headings set at H3, lists with the bullets inside, links underlined. |
| `SiteContact{title}` / `SiteNewsletterPrompt{title}` | `SitePromptCard` | Two square tiles: email and Network Notes. Staging pages get them in the footer, not as a block. |
| `SitePromptCard{title}` | none | A pad with a title and a slot for one control. |
| `SiteContactPrompt{title description label email}` | `UPageCTA` | A pad on the ground. H1 title (Display from `lg`), note, an ink mailto button. |
| `SiteNewsletterField{surface}` | `UInput`, `SiteButton` | The email field with Subscribe inside it: `h-14`, `--radius-tile`, a grey fill on the ground (`surface` swaps it). |
| `SiteForm{title description kind successTitle successDescription}` | `SitePair`, `SitePad`, `SiteFormFields` | An M card: title and description, then the form pad. With `kind="application"` and no copy, it takes the site's `applicationForm`. |
| `SiteFormFields{kind successTitle successDescription consent fill inline}` | Brand inputs, `SiteButton`, `SiteFormSuccess` | Name, email, message (contact) or CV and cover note (application), then `SiteFormSuccess`. `inline`: the labels are the placeholders and read out, not shown, and the send button is full width. `fill`: the message box takes the height left. `consent`: a native required checkbox for the privacy policy. |
| `SitePageSection` / `SiteStack` | none | The two layers, placed by the staging route, not by hand. A page section (hero ticker, hero roll, page header, statement, client roll) is z 0 on `--surface` and always sticks; a stack is a run of cards at z 1 with `--shadow-card-up` (the last card also `--shadow-card-down`), every card but the last sticky. `top: min(gap, 100lvh - --block-height - gap)`: a block taller than the window sticks by its foot. Hash jumps and the roll measure with `flowTop`. |
| `SiteFooter{columns revealed name home contact}` | `UFooterColumns`, `SiteContactPrompt`, `SiteNewsletterPrompt` | Page layer, sticky by its head (`bottom: min(0px, 100lvh - --block-height)`), uncovered by the last card. `contact` set: the two prompts first (`#contact`, 2 across from `lg`, `mb-8`/`lg:mb-12`, pads `dark:bg-elevated`), then mark and copyright and the columns. Bottom padding is the menu bar plus `--site-menu-bottom` plus 0.5rem: the menu sits under the columns and never stows. `revealed`: the wordmark (`h-8`, `h-11` from `lg`) rolls in each time it turns true (the page sets it when the mark is uncovered and fully in the window). |
| `SiteCookieNotice` | `UBanner` | Two verb buttons: "Accept analytics", "Reject analytics". Emits `choose`. |
| `SiteBreadcrumb{items}` | `UBreadcrumb` | Body text, `/` separator, current page in the ink. |
| `SiteImage{src alt label}` | none | 3:2, `object-cover`, caption through `TileFrame`. |
| `SiteFormSuccess{title description}` | `UAlert` | `bg-elevated`, check icon, `role="status"`. |
| `SiteNotFound` | `UError` | 404, H1 message, a button home. |

Tokens the website adds: `--radius-panel`, `--radius-tile`, `--radius-control`, `--radius-thumb`, `--hairline` (`brand.css`), `--brand-accent` and `--brand-on-accent` (from `brandAccent`, set in `app.vue`).

Also `BrandTextarea` (`UTextarea`) and `BrandFileUpload` (`UFileUpload`, on the grey, no border).

Every Nuxt UI control sets its text on the Body step (16/22), at every size and from `md` too (`packages/brand/app/app.config.ts`: button, form field, input, textarea, select, file upload, checkbox, switch, tabs, accordion, banner, alert, footer columns, page links, user). The scale has no 12 or 14 outside mono badges. A breadcrumb's current page is weight 500, like all type.

`/components` puts the large components first, one per row (`::component-grid`, 6rem apart). `::component-card{stage}` shows one on the page ground, centred in a 3:2 grey tile, as wide as its content up to `80cqi` (`{stage full}` takes the full `80cqi`, for components that size by their container) (10% padding top and bottom). A taller component grows the tile. Small components (buttons, inputs, breadcrumb and the like) come after, in `::component-scroller{label}`: one row, 384px cards, scroll snap, keyboard focusable.


