@orange-halo/mcp 1.1.0 → 1.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/index.json +1 -1
- package/package.json +4 -4
package/index.json
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"versions":{"@orange-halo/brand-orange-halo":"3.0.0","@orange-halo/components":"4.0.0","@orange-halo/tokens":"4.0.0","@orange-halo/utils":"1.1.0"},"brands":[{"id":"hoodlum","name":"Hoodlum","formerIds":["hood"]},{"id":"orange-halo","name":"Orange Halo","formerIds":[]}],"elements":[{"tagName":"oh-accordion","pkg":"@orange-halo/components","description":"Collapsible sections, each with a heading that shows and hides its content. Use one item for a single show/hide section.\n\n**Use it for** content readers scan by heading and open as needed (FAQs, details, a \"Show as table\" section). **Don't use it for** content most readers need (leave it visible); for switching between views of the same thing (use tabs); or for site navigation.\n\n**Parts:** `items` is an array of `{ heading, hiddenText?, open? }` (in HTML, a JSON array). Item N's content is any markup in a child with `slot=\"item-N\"`, such as a paragraph or a table.\n\n**Variants:** `subtle` (default), inline with surrounding content, its trigger styled as a link; `standout`, each item a separate boxed surface, for when the sections are the page's main content.\n\n**States:** collapsed and expanded per item (any number can be open; `open` sets the starting state), plus hover and focus-visible on the trigger.\n\n**Behaviour:** each trigger is a `<button>` inside a heading at `heading-level` (default 3), so the items fit the page's outline. Click, Enter or Space toggles it. While collapsed, the panel is `aria-hidden` and `inert`, so nothing inside it takes focus. Motion is turned off under `prefers-reduced-motion`.\n\n**Accessibility:** the trigger has `aria-expanded` and `aria-controls`; the panel is a `region` labelled by its trigger. `hiddenText` adds heading text only screen readers hear, so several items with the same visible heading (e.g. \"Show as table\") can be told apart. Set `heading-level` to fit the headings around it.\n\n**Look:** set by tokens. `subtle`: the trigger uses `color.text.link` and an underline set by `decoration.underlineThickness`, `underlineDash` and `underlinePeriod`, which clears on hover; focus is a solid `color.brand.primary` underline; items are divided by `stroke.divider` in `color.border.subtle`. `standout`: each item uses `color.surface.container`, a `stroke.control` border in `color.border.emphasis` (`color.brand.primary` when expanded), `shape.container` corners and an `elevation.offset.*` shadow in `elevation.color.neutral`, which moves by `lift.hoverMd` on hover. Type uses `typography.body.*`; motion uses `motion.*` tokens.","attributes":[{"name":"items","type":{"text":"AccordionItem[]"},"default":"[]","description":"The sections: { heading, hiddenText?, open? }. In HTML, a JSON array.\nEach item's content is a child with slot=\"item-<index>\".","fieldName":"items"},{"name":"variant","type":{"text":"AccordionVariant"},"default":"\"subtle\"","description":"subtle (inline) or standout (boxed)","fieldName":"variant"},{"name":"heading-level","type":{"text":"HeadingLevel"},"default":"3","description":"The heading level of each item's trigger, to fit the page's outline","fieldName":"headingLevel"}],"members":[{"kind":"field","name":"items","type":{"text":"AccordionItem[]"},"default":"[]","description":"The sections: { heading, hiddenText?, open? }. In HTML, a JSON array.\nEach item's content is a child with slot=\"item-<index>\".","attribute":"items"},{"kind":"field","name":"variant","type":{"text":"AccordionVariant"},"default":"\"subtle\"","description":"subtle (inline) or standout (boxed)","attribute":"variant","reflects":true},{"kind":"field","name":"headingLevel","type":{"text":"HeadingLevel"},"default":"3","description":"The heading level of each item's trigger, to fit the page's outline","attribute":"heading-level","reflects":true}],"slots":[{"description":"The content of the item at index N (item-0 is the first)","name":"item-N"}],"released":null},{"tagName":"oh-alert","pkg":"@orange-halo/components","description":"A message box that tells the user about the result of an action or something that needs their attention.\n\n**Use it for** feedback on what just happened (saved, failed) or a notice about the page or account, near the content it's about. **Don't use it for** a short status label (use `oh-badge`); for a field's validation error (use the field's own error message); or for a message that must interrupt the user (use `oh-modal`).\n\n**Variants:** `info` (default), `success`, `warning`, `error`, each by its feedback role. Each has its own icon, so the meaning isn't carried by colour alone.\n\n**Behaviour:** with `dismissible`, a \"Close\" button follows the content; selecting it fires `oh-close` (as `oh-modal` and `oh-drawer` do) and sets `hidden` on the alert. Content goes in the default slot and can include links.\n\n**Accessibility:** set `live` only for an alert added after the page has rendered (e.g. after submit); it adds `role=\"alert\"` so screen readers announce it. Leave it off for alerts present on page load. Icons are `aria-hidden`; put the meaning in the text. Links show a solid outline in the current text colour on focus; the close button shows an underline.\n\n**Look:** set by tokens. Each variant uses `color.feedback.<variant>Subtle` for the background and `color.feedback.<variant>` for the border, icon and links; text is `color.text.primary`. `stroke.control` sets the border, `shape.container` the corners, `typography.body.*` the text, and `decoration.underlineThickness`, `underlineDash` and `underlinePeriod` the link underline. The close button uses `closeButton.state.hover.background`, `closeButton.state.hover.shadowColor`, `elevation.offset.*`, `lift.*` and `shape.compact`.","attributes":[{"name":"variant","type":{"text":"AlertVariant"},"default":"\"info\"","description":"The feedback role: `info` (default), `success`, `warning` or `error`. Each has its own icon and colours.","fieldName":"variant"},{"name":"dismissible","type":{"text":"boolean"},"default":"false","description":"Adds a \"Close\" button after the content; selecting it fires `oh-close` and hides the alert.","fieldName":"dismissible"},{"name":"live","type":{"text":"boolean"},"default":"false","description":"When true, adds role=\"alert\" for screen reader announcement.\nUse for dynamically inserted alerts only, not for static page content.","fieldName":"live"}],"members":[{"kind":"field","name":"variant","type":{"text":"AlertVariant"},"default":"\"info\"","description":"The feedback role: `info` (default), `success`, `warning` or `error`. Each has its own icon and colours.","attribute":"variant","reflects":true},{"kind":"field","name":"dismissible","type":{"text":"boolean"},"default":"false","description":"Adds a \"Close\" button after the content; selecting it fires `oh-close` and hides the alert.","attribute":"dismissible","reflects":true},{"kind":"field","name":"live","type":{"text":"boolean"},"default":"false","description":"When true, adds role=\"alert\" for screen reader announcement.\nUse for dynamically inserted alerts only, not for static page content.","attribute":"live","reflects":true}],"events":[{"description":"When the close button is selected, before the alert hides.","name":"oh-close"}],"slots":[{"description":"The message. Can include links.","name":""}],"cssParts":[{"description":"The alert box.","name":"alert"},{"description":"The message wrapper.","name":"content"},{"description":"The close button (only when `dismissible`).","name":"close"}],"released":null},{"tagName":"oh-badge","pkg":"@orange-halo/components","description":"A short, non-interactive label that shows the status or category of the thing next to it.\n\n**Use it for** a status (\"Delivered\", \"Pending\"), a count or a tag next to the item it describes. **Don't use it for** anything the user can select or remove, such as a filter (use `oh-tag`), or an action (use `oh-button` or a link); or for a message with more than a word or two (use `oh-alert`).\n\n**Variants:** `brand` (default) and `accent` for categories; `success`, `warning`, `error` and `info` for status. **Appearance:** `subtle` (default), for most badges; `filled`, the stronger appearance, for the one status that matters most.\n\n**Sizes:** `md` (default); `lg`, as tall as a small `oh-button` (`badge.size.lg.minHeight`, which follows `button.size.sm.minHeight`), for a badge in a row of buttons. Same text and padding, and still no border or hover, so it reads as a label.\n\n**Parts:** the default slot holds the text; the `icon` slot an optional leading icon, sized to the text.\n\n**Behaviour:** none. It doesn't take focus or respond to the pointer.\n\n**Accessibility:** the badge is plain text to screen readers, so the text must make sense on its own (say \"Pending\", don't rely on the colour). Mark a decorative icon `aria-hidden`.\n\n**Look:** set by tokens. Subtle uses the variant's `color.feedback.<variant>Subtle`, `color.brand.primarySubtle` or `color.accent.subtle` background with the role colour as text; filled uses the role colour (`color.feedback.<variant>`, `color.brand.primary`, `color.accent.default`) as background with `color.text.on<Role>` as text. `shape.compact` sets the corners; `typography.body.*`, `typography.label.base.fontWeight` and `typography.control.letterSpacing` the text.","attributes":[{"name":"variant","type":{"text":"BadgeVariant"},"default":"\"brand\"","description":"`brand` (default) or `accent` for a category; `success`, `warning`, `error` or `info` for a status.","fieldName":"variant"},{"name":"appearance","type":{"text":"BadgeAppearance"},"default":"\"subtle\"","description":"`subtle` (default) for most badges; `filled`, the stronger appearance, for the one status that matters most","fieldName":"appearance"},{"name":"size","type":{"text":"BadgeSize"},"default":"\"md\"","description":"`md` (default); `lg`, as tall as a small button, for a badge in a row of them","fieldName":"size"}],"members":[{"kind":"field","name":"variant","type":{"text":"BadgeVariant"},"default":"\"brand\"","description":"`brand` (default) or `accent` for a category; `success`, `warning`, `error` or `info` for a status.","attribute":"variant","reflects":true},{"kind":"field","name":"appearance","type":{"text":"BadgeAppearance"},"default":"\"subtle\"","description":"`subtle` (default) for most badges; `filled`, the stronger appearance, for the one status that matters most","attribute":"appearance","reflects":true},{"kind":"field","name":"size","type":{"text":"BadgeSize"},"default":"\"md\"","description":"`md` (default); `lg`, as tall as a small button, for a badge in a row of them","attribute":"size","reflects":true}],"slots":[{"description":"The badge text.","name":""},{"description":"Optional leading icon.","name":"icon"}],"cssParts":[{"description":"The badge.","name":"badge"}],"released":null},{"tagName":"oh-breadcrumb","pkg":"@orange-halo/components","description":"A breadcrumb trail showing where the current page sits in the site's hierarchy.\n\n**Use it for** pages two or more levels deep in a hierarchy. **Don't use it\nfor** a site's main navigation (use `oh-navbar`) or for steps in a process.\n\n**Parts:** pass `items`, an array of `{ label, href }`, from the top level\ndown. The last item is the current page and is shown as text, not a link.\n\n**Behaviour:** below the `size.breakpoint.sm` width the trail collapses to a\nsingle \"Back to [parent]\" link to the second-to-last item; with one item,\nnothing shows there. Link underlines retract on hover; keyboard focus\n(`:focus-visible`) shows a solid underline and a background tint, as\n`oh-link` does. The back link's chevron is `oh-icon` `chevron-left`, which\nmirrors in right-to-left pages.\nTransitions are cut short under `prefers-reduced-motion`. Renders nothing\nwhen `items` is empty.\n\n**Accessibility:** renders `<nav aria-label=\"Breadcrumb\">` with an ordered\nlist, `aria-current=\"page\"` on the last item and `aria-hidden` separators.\nUse one breadcrumb per page.\n\n**Look:** set by tokens — `color.text.link` the links,\n`decoration.underlineThickness`, `decoration.underlineDash` and\n`decoration.underlinePeriod` their underline; `color.brand.primary` at\n`decoration.underlineFocusThickness` the focus underline, `focus.decorationColor`\nthe focus tint (none where a brand's glow is transparent) and `shape.tight`\nits corners;\n`color.text.primary` and `typography.label.base.fontWeight` the current\npage; `color.text.secondary` the separators; `typography.body.*` the text;\n`spacing.*` the gaps; `motion.relaxed` and `motion.easeGentle` the\ntransitions.","attributes":[{"name":"items","type":{"text":"BreadcrumbItem[]"},"default":"[]","description":"The trail, from the top level down, as `{ label, href }` objects. The last item is the current page and shows as text. Set it as a property, or as JSON in the attribute.","fieldName":"items"}],"members":[{"kind":"field","name":"items","type":{"text":"BreadcrumbItem[]"},"default":"[]","description":"The trail, from the top level down, as `{ label, href }` objects. The last item is the current page and shows as text. Set it as a property, or as JSON in the attribute.","attribute":"items"}],"released":null},{"tagName":"oh-button","pkg":"@orange-halo/components","description":"A button that starts an action, or a link styled as a button when `href` is set.\n\n**Use it for** actions: submitting, saving, opening a dialog, confirming.\n**Don't use it for** links inside running text (use `oh-link`).\n\n**Variants:** `primary` for the main action, `secondary` for the others,\n`accent` for an action that takes the accent colour role. **Sizes:** `sm`, `md` (default), `lg`.\n**States:** rest, hover, active, focus and `loading`.\n\n**Behaviour:** fires `oh-click` when the inner `<button>` is clicked, except\nwhile `loading`. `loading` shows a spinner, keeps the label for screen\nreaders, sets `aria-busy` and `aria-disabled` and ignores clicks, while the\nbutton stays focusable. With `href` it renders an `<a>` (and\n`target=\"_blank\"` adds `rel=\"noopener noreferrer\"`); link buttons don't fire\n`oh-click`. It has no `disabled` property and doesn't submit a form by\nitself: handle `oh-click`. Under `prefers-reduced-motion` it doesn't move.\n\n**Accessibility:** focus shows a solid underline on the label. An\n`icon-only` button has no visible text, so always set `accessible-label`\n(not `aria-label`, which isn't forwarded into the shadow root).\n\n**Look:** set by tokens — `stroke.control` (border width), `shape.control`\n(corners), `typography.control.*` (type), `button.variant.<variant>.*`\n(background, text, border and shadow colour per state), `button.size.<size>.*`\n(font size, padding, minimum height), `elevation.offset.*` (shadow offset)\nand `lift.hoverMd` / `lift.activeMd` (movement on hover and press).","attributes":[{"name":"variant","type":{"text":"ButtonVariant"},"default":"\"primary\"","description":"`primary` for the main action, `secondary` for the others, `accent` for an action in the accent colour role.","fieldName":"variant"},{"name":"size","type":{"text":"ButtonSize"},"default":"\"md\"","description":"`sm`, `md` (default) or `lg`: the font size, padding and minimum height.","fieldName":"size"},{"name":"loading","type":{"text":"boolean"},"default":"false","description":"Shows a spinner and ignores clicks while an action runs. The label stays for screen readers and the button stays focusable.","fieldName":"loading"},{"name":"icon-only","type":{"text":"boolean"},"default":"false","description":"A square button showing only its icon. Always set `accessible-label` with it, as there's no visible text.","fieldName":"iconOnly"},{"name":"accessible-label","type":{"text":"string | undefined"},"description":"Accessible name for the inner button/anchor. Required for icon-only\nbuttons. Use this, not aria-label: an aria-label on the host isn't\nforwarded into the shadow root.","fieldName":"accessibleLabel"},{"name":"force-state","type":{"text":"ButtonState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'active' | 'focus'","fieldName":"forceState"},{"name":"href","type":{"text":"string | undefined"},"description":"When provided, renders as an anchor tag instead of a button","fieldName":"href"},{"name":"target","type":{"text":"string | undefined"},"description":"Target for the link (e.g., \"_blank\" for new tab)","fieldName":"target"}],"members":[{"kind":"field","name":"variant","type":{"text":"ButtonVariant"},"default":"\"primary\"","description":"`primary` for the main action, `secondary` for the others, `accent` for an action in the accent colour role.","attribute":"variant","reflects":true},{"kind":"field","name":"size","type":{"text":"ButtonSize"},"default":"\"md\"","description":"`sm`, `md` (default) or `lg`: the font size, padding and minimum height.","attribute":"size","reflects":true},{"kind":"field","name":"loading","type":{"text":"boolean"},"default":"false","description":"Shows a spinner and ignores clicks while an action runs. The label stays for screen readers and the button stays focusable.","attribute":"loading","reflects":true},{"kind":"field","name":"iconOnly","type":{"text":"boolean"},"default":"false","description":"A square button showing only its icon. Always set `accessible-label` with it, as there's no visible text.","attribute":"icon-only","reflects":true},{"kind":"field","name":"accessibleLabel","type":{"text":"string | undefined"},"description":"Accessible name for the inner button/anchor. Required for icon-only\nbuttons. Use this, not aria-label: an aria-label on the host isn't\nforwarded into the shadow root.","attribute":"accessible-label"},{"kind":"field","name":"forceState","type":{"text":"ButtonState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'active' | 'focus'","attribute":"force-state","reflects":true},{"kind":"field","name":"href","type":{"text":"string | undefined"},"description":"When provided, renders as an anchor tag instead of a button","attribute":"href"},{"kind":"field","name":"target","type":{"text":"string | undefined"},"description":"Target for the link (e.g., \"_blank\" for new tab)","attribute":"target"},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}],"description":"Focus the internal button/anchor element"},{"kind":"method","name":"blur","description":"Blur the internal button/anchor element"}],"events":[{"description":"The button was clicked (not while loading). `detail.originalEvent` is the click.","name":"oh-click"}],"slots":[{"description":"The label.","name":""},{"description":"An icon before the label.","name":"icon-left"},{"description":"An icon after the label.","name":"icon-right"}],"cssParts":[{"description":"The inner `<button>` or `<a>`.","name":"button"}],"released":null},{"tagName":"oh-card","pkg":"@orange-halo/components","description":"A surface that groups related content (a summary, a teaser, a settings group), with optional header and footer.\n\n**Use it for** a self-contained block of content among others, such as a teaser that links to more detail. **Don't use it for** page layout or spacing alone (use `oh-stack`, `oh-grid`); for a message that needs attention (use `oh-alert`); or for a single action (use `oh-button`).\n\n**Variants:** `default`, the standard card; `featured`, for the one card that should stand out; `subtle`, a quieter card, for dense layouts. **Padding:** `none`, `sm`, `md` (default), `lg` set the content padding (and the header and footer padding to match). With `none`, the content sets its own padding.\n\n**Actions:** a card that leads somewhere has one call to action under its content: an `oh-link` with `variant=\"standalone\"` and `arrow`, named for where it goes (\"Read the guide\", not \"Learn more\"), so each one makes sense on its own in a list of links. A card with actions puts them as buttons in the `footer` slot. The heading stays plain text, and the card itself isn't a click target, so every card works the same way and only what looks clickable is.\n\n**Accessibility:** links inside use `color.text.linkOnContainer`, which keeps contrast on card surfaces. Headings inside a card stay headings, and each link or button is named by its own text.\n\n**Look:** set by tokens. `card.variant.<variant>.gradientStart`/`gradientMid`/`gradientEnd` set each variant's surface, `card.variant.<variant>.borderColor` and `card.base.borderWidth` its border, `shape.large` the corners, and `elevation.surface.default`/`subtle`/`featured` its shadow. Header and footer dividers use `card.base.dividerColor` and `stroke.divider`; the header surface uses `card.base.headerBackgroundStart`/`End`, the footer `color.surface.container` to `color.surface.inset`.","attributes":[{"name":"variant","type":{"text":"CardVariant"},"default":"\"default\"","description":"`default`, `featured` for the one card that should stand out, or `subtle`, a quieter card for dense layouts.","fieldName":"variant"},{"name":"padding","type":{"text":"CardPadding"},"default":"\"md\"","description":"The content padding, which the header and footer match: `none`, `sm`, `md` (default) or `lg`. With `none`, the content sets its own.","fieldName":"padding"}],"members":[{"kind":"field","name":"variant","type":{"text":"CardVariant"},"default":"\"default\"","description":"`default`, `featured` for the one card that should stand out, or `subtle`, a quieter card for dense layouts.","attribute":"variant","reflects":true},{"kind":"field","name":"padding","type":{"text":"CardPadding"},"default":"\"md\"","description":"The content padding, which the header and footer match: `none`, `sm`, `md` (default) or `lg`. With `none`, the content sets its own.","attribute":"padding","reflects":true}],"slots":[{"description":"The card's main content.","name":""},{"description":"Optional header, above the content, with a divider below. Not drawn when nothing is slotted.","name":"header"},{"description":"Optional footer, below the content, with a divider above (e.g. actions). Not drawn when nothing is slotted.","name":"footer"}],"cssParts":[{"description":"The card surface.","name":"card"},{"description":"The header wrapper.","name":"header"},{"description":"The content wrapper.","name":"content"},{"description":"The footer wrapper.","name":"footer"}],"released":null},{"tagName":"oh-chart","pkg":"@orange-halo/components","description":"A chart: ranked bars, columns, lines, a donut or dots along a line, with a caption, a takeaway, keyboard access to every point and a table view.\n\n**Use it for** data that's easier to see than to read: amounts compared across categories (`bar`), a few periods side by side (`column`), change over time (`line`), parts of a whole (`donut`), or when things happened, a row per category (`dot`: every gig for each of a few artists, say). **Don't use it for** a few exact numbers (use `oh-description-list` with `value-size=\"lg\"`) or data people look things up in (use `oh-table`). See Foundation / Data visualisation for choosing a chart.\n\n**Data:** set the `data` property to `{ labels, series }`: `labels` are the categories, in order, and `series` is one `{ name, values }` with a value per label (`null` when it's missing); a `line` chart takes up to five series. Colour follows the series, not its position: give each line's series a `color` slot (1 to 5), and a donut's `data.colors` one per part, so the rest keep their colours when one is filtered out; without them, the slot is the position. A slot used twice warns in the console. Bars and columns start at zero; values below zero aren't supported yet. Rank a bar chart's data yourself, largest first, unless the categories have their own order. Bars and columns can lead somewhere: `data.links` gives each one's address, in label order (`null` for one that doesn't), and those bars or columns become links. A dot chart takes `data.dots` instead of `series`: `{ label, at, name }` for each dot, where `label` is its row (one of `labels`), `at` is where it falls (a `Date`, for a time axis, or a number) and `name` says what it is. `formatValue` formats each value in labels, names and the table (default: the page language's number format); the value axis shows plain numbers, so put the unit in the caption.\n\n**Types:** `bar` draws horizontal bars with the label before each bar and the value after it; when the chart is narrow (or the text large), each label moves above its bar. `column` draws vertical columns over a value axis with gridlines; each column's value shows when it's focused or hovered. **Sizes:** `md` (default) and `sm`, a shorter plot (`chart.size.sm.plotHeight`) for a chart that sits beside a short list or a few figures. Category labels under columns and lines stay on one line; when they don't all fit, every second (third, fifth…) one shows, from the first, and every point still has its name on focus and in the table. `line` draws each series as a line over the same axis, with a marker at each value; series differ by colour, dash pattern and marker shape, and with two or more there's a legend and each line's name at its end. A missing value leaves a gap in its line. `dot` draws a row per label with a dot for each of its items along one axis under all the rows: years on a time axis (every year, or every 2, 5, 10… when they don't all fit), round numbers otherwise. A dot's date (or value) and name show beside it when it's focused or hovered; when the chart is narrow, each row's label moves above its dots. `donut` shows parts of a whole (four at most; it warns beyond that), with a gap between slices and a label beside each one giving its value and share; when there isn't room beside the donut, the labels are a list under it.\n\n**Parts:** `caption` names the chart; it's required, and the chart warns in the console without it. When a heading right above already names the chart, give `caption` the same words and set `hide-caption`: the caption still names the chart for screen readers but isn't shown twice. `summary` says, in one sentence, what the chart shows (\"March was the busiest month\"); it's recommended when the data has a clear takeaway, and left out (not invented) when it doesn't. Under the plot, a \"Show as table\" section (an `oh-accordion`, its heading at `heading-level`) holds the same data in an `oh-table`, whose first column header is `category-label` (a dot chart's table has a row per dot, with `value-label` and `detail-label` as its other headers); the caption is added to its heading for screen readers, so several charts' tables can be told apart. `hide-table` leaves this section out when the data is already readable as text: the page shows it in a table of its own (two small charts sharing one, say), or the chart is a bar chart, whose every label and value is on screen and in each bar's name. Never set it on another chart without that table.\n\n**Keyboard:** the chart is one Tab stop. Tab moves to the last point you were on (the first, to begin with); the arrow keys move to the next and previous point, swapped in right-to-left pages; Home and End move to the first and last. In a line chart, Left and Right move along a line and Up and Down move to the same point (or the nearest one with a value) on the next or previous line; in a dot chart, Left and Right move along a row, Home and End to its ends, and Up and Down to the nearest dot on the next or previous row. Enter follows a linked bar or column (in a new tab with Ctrl, Cmd or Shift, as a click with them does). Each point is announced as \"category: value\" (\"series, category: value\" in a line chart with several lines; \"part: value, share\" in a donut; \"row, date: name\" in a dot chart). Escape hides a column's value label until you move on.\n\n**Motion:** the first time the chart scrolls into view, bars and columns grow from the baseline, lines draw from the start, and donut slices sweep round; marks move to new values when the data changes. Timed by `motion.*`. With `prefers-reduced-motion` they appear in place.\n\n**Accessibility:** the plot is a group named by the caption and described by the takeaway; each point is an image named by its category and value, and a linked bar or column is a link with the same name. Linked bars and columns are `role=\"link\"` rather than `<a>` elements, so they stay in the chart's single Tab stop in Safari, which skips `<a>` elements on Tab by default; their labels (a column's is under it) take the link colour and dashed underline, so you can see which ones lead somewhere, and clicking a column's label follows its link too. Colour is never the only cue: every bar and donut slice is labelled, a column's or point's value appears beside it on focus or hover, and lines differ by dash and marker shape too. Under Windows high contrast, marks use system colours.\n\n**Look:** set by tokens. `color.data.categorical.1` colours bars and columns, and `color.data.muted` the others while one is focused or hovered (lines and slices keep their colours, since no grey stays clear of all five); `color.data.grid` and `color.data.axis` the gridlines and baseline (`stroke.divider` wide); `typography.label.base.*` the caption, `typography.body.base.*` the takeaway, `typography.body.sm.*` the axis and value labels, in `color.text.secondary` and `color.text.primary`; `shape.tight` the marks' data ends; `color.data.categorical.1` to `.5` the lines and slices, by slot (a donut part past the fifth takes `color.data.muted`); `chart.base.*` (and `chart.size.sm.plotHeight`) the plot height, bar thickness, column widths, line width, marker size (also a dot's size), dot row height and donut thickness; `color.text.link` and `decoration.underline*` a linked bar's or column's label; `color.data.grid` a dot chart's row lines, and a `stroke.data` ring in `color.surface.base` around each dot, so dots that overlap stay apart; `focus.ring*` the focus indicator; `motion.relaxed`, `motion.slow`, `motion.easeOut` and `motion.quick` the motion.","attributes":[{"name":"type","type":{"text":"ChartType"},"default":"\"column\"","description":"`bar` (horizontal, ranked), `column` (vertical), `line` (change over time, up to five series), `donut` (parts of a whole, up to four) or `dot` (when things happened, a row per category).","fieldName":"type"},{"name":"caption","type":{"text":"string"},"default":"\"\"","description":"The chart's name. Required.","fieldName":"caption"},{"name":"size","type":{"text":"ChartSize"},"default":"\"md\"","description":"`md` (default) or `sm`, a shorter plot for a chart beside a short list or a few figures","fieldName":"size"},{"name":"hide-caption","type":{"text":"boolean"},"default":"false","description":"Hides the caption on screen (screen readers still use it), for a chart under a heading that already names it","fieldName":"hideCaption"},{"name":"hide-table","type":{"text":"boolean"},"default":"false","description":"Leaves out the \"Show as table\" section: for a chart whose data the page already shows in a table of its own (several charts sharing one, say), or a bar chart, whose labels and values are all on screen. Never set it on another chart without that table.","fieldName":"hideTable"},{"name":"summary","type":{"text":"string"},"default":"\"\"","description":"One sentence saying what the chart shows. Optional: leave it out rather than invent one.","fieldName":"summary"},{"name":"data","type":{"text":"ChartData"},"default":"{ labels: [], series: [] }","description":"`{ labels, series }`: the categories, and the series of values (one, or up to five for `line`).","fieldName":"data"},{"name":"category-label","type":{"text":"string"},"default":"\"Category\"","description":"The table view's header for the categories column.","fieldName":"categoryLabel"},{"name":"heading-level","type":{"text":"2 | 3 | 4 | 5 | 6"},"default":"3","description":"The level of the \"Show as table\" heading, to fit the page's outline.","fieldName":"headingLevel"},{"name":"value-label","type":{"text":"string"},"default":"\"\"","description":"Dot charts: the table's header for where each dot falls. Default: \"Date\" on a time axis, \"Value\" otherwise.","fieldName":"valueLabel"},{"name":"detail-label","type":{"text":"string"},"default":"\"Details\"","description":"Dot charts: the table's header for the dots' names.","fieldName":"detailLabel"},{"name":"empty-text","type":{"text":"string"},"default":"\"No data to show.\"","description":"Shown instead of the plot when there's no data.","fieldName":"emptyText"}],"members":[{"kind":"field","name":"type","type":{"text":"ChartType"},"default":"\"column\"","description":"`bar` (horizontal, ranked), `column` (vertical), `line` (change over time, up to five series), `donut` (parts of a whole, up to four) or `dot` (when things happened, a row per category).","attribute":"type","reflects":true},{"kind":"field","name":"caption","type":{"text":"string"},"default":"\"\"","description":"The chart's name. Required.","attribute":"caption"},{"kind":"field","name":"size","type":{"text":"ChartSize"},"default":"\"md\"","description":"`md` (default) or `sm`, a shorter plot for a chart beside a short list or a few figures","attribute":"size","reflects":true},{"kind":"field","name":"hideCaption","type":{"text":"boolean"},"default":"false","description":"Hides the caption on screen (screen readers still use it), for a chart under a heading that already names it","attribute":"hide-caption","reflects":true},{"kind":"field","name":"hideTable","type":{"text":"boolean"},"default":"false","description":"Leaves out the \"Show as table\" section: for a chart whose data the page already shows in a table of its own (several charts sharing one, say), or a bar chart, whose labels and values are all on screen. Never set it on another chart without that table.","attribute":"hide-table","reflects":true},{"kind":"field","name":"summary","type":{"text":"string"},"default":"\"\"","description":"One sentence saying what the chart shows. Optional: leave it out rather than invent one.","attribute":"summary"},{"kind":"field","name":"data","type":{"text":"ChartData"},"default":"{ labels: [], series: [] }","description":"`{ labels, series }`: the categories, and the series of values (one, or up to five for `line`).","attribute":"data"},{"kind":"field","name":"formatValue","type":{"text":"(value: number) => string | undefined"},"description":"Formats each value for labels, names and the table. Default: the page language's number format."},{"kind":"field","name":"categoryLabel","type":{"text":"string"},"default":"\"Category\"","description":"The table view's header for the categories column.","attribute":"category-label"},{"kind":"field","name":"headingLevel","type":{"text":"2 | 3 | 4 | 5 | 6"},"default":"3","description":"The level of the \"Show as table\" heading, to fit the page's outline.","attribute":"heading-level"},{"kind":"field","name":"valueLabel","type":{"text":"string"},"default":"\"\"","description":"Dot charts: the table's header for where each dot falls. Default: \"Date\" on a time axis, \"Value\" otherwise.","attribute":"value-label"},{"kind":"field","name":"detailLabel","type":{"text":"string"},"default":"\"Details\"","description":"Dot charts: the table's header for the dots' names.","attribute":"detail-label"},{"kind":"field","name":"emptyText","type":{"text":"string"},"default":"\"No data to show.\"","description":"Shown instead of the plot when there's no data.","attribute":"empty-text"}],"cssParts":[{"description":"The figure around the whole chart.","name":"chart"},{"description":"The plot: the bars or columns and their axes.","name":"plot"}],"released":null},{"tagName":"oh-checkbox-group","pkg":"@orange-halo/components","description":"A set of related checkboxes under one legend, where any number can be\nchosen.\n\n**Use it for** choosing any number of options from a short list, such as\ninterests or notification types. **Don't use it for** one standalone\nyes/no option (use `oh-checkbox`), exactly one choice (use\n`oh-radio-group`, or `oh-select` for a long list), or settings that apply\nstraight away (use `oh-toggle`).\n\n**Parts:** a `label` (rendered as the fieldset's `<legend>`) and a list of `options` (`{ label, value }`).\n`value` is the array of checked option values. **States:** each option\nunchecked, checked, hover, active and focus; the group can be `required`\n(a marker on the label), disabled, and in error (set `error-text`).\n\n**Behaviour:** Tab moves through the options and Space toggles one. Each\nchange updates `value` and fires `oh-change` with the new array. In a\nnative `<form>` it submits each checked value under `name`, as a set of\nsame-named native checkboxes does (`FormData.getAll(name)` reads them\nall); `required` blocks submitting with none checked, reset restores the\nstarting values, and `disabled` (or a disabled `<fieldset>` around it)\ntakes every option out of the tab order and the form.\n\n**Accessibility:** a `<fieldset>` with a `<legend>`, so screen readers\nread the label with each option. Always set `label`. The error shows\nafter the legend and before the options, with an icon; the fieldset gets\n`aria-invalid` and `aria-describedby`, and the error is announced\n(`role=\"alert\"`) only when it appears after first render. Focus underlines\nthe option's label.\n\n**Look:** set by tokens — the same as `oh-checkbox`: `stroke.control` in\n`color.border.emphasis` (border), `shape.compact` (corners),\n`elevation.offset.*` with `elevation.color.secondary` / `elevation.color.primary` (shadow),\n`lift.hoverSm` / `lift.activeSm` (movement on hover and press),\n`color.brand.primary` and `color.text.onBrand` (checked),\n`color.feedback.error` and `elevation.color.error` (error); `typography.control.*`\nfor the legend and labels; `color.surface.disabled`, `color.border.disabled`\nand `color.text.disabled` (disabled).","attributes":[{"name":"label","type":{"text":"string"},"default":"\"\"","description":"The group's label, rendered as the fieldset's <legend>. Always set one","fieldName":"label"},{"name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name each checked value is submitted under.","fieldName":"name"},{"name":"options","type":{"text":"CheckboxOption[]"},"default":"[]","description":"The checkboxes, as `{ label, value }` objects. Set it as a property, or as JSON in the attribute.","fieldName":"options"},{"name":"value","type":{"text":"string[]"},"default":"[]","description":"The values of the checked options, in option order. Updated on every change.","fieldName":"value"},{"name":"required","type":{"text":"boolean"},"default":"false","description":"At least one box must be ticked: marks the label and blocks a native form from submitting while none is.","fieldName":"required"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","fieldName":"disabled"},{"name":"error-text","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","fieldName":"errorText"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"The group's label, rendered as the fieldset's <legend>. Always set one","attribute":"label"},{"kind":"field","name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name each checked value is submitted under.","attribute":"name"},{"kind":"field","name":"options","type":{"text":"CheckboxOption[]"},"default":"[]","description":"The checkboxes, as `{ label, value }` objects. Set it as a property, or as JSON in the attribute.","attribute":"options"},{"kind":"field","name":"value","type":{"text":"string[]"},"default":"[]","description":"The values of the checked options, in option order. Updated on every change.","attribute":"value"},{"kind":"field","name":"required","type":{"text":"boolean"},"default":"false","description":"At least one box must be ticked: marks the label and blocks a native form from submitting while none is.","attribute":"required","reflects":true},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","attribute":"disabled","reflects":true},{"kind":"field","name":"form","description":"The form this group belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}]},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]},{"kind":"field","name":"errorText","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","attribute":"error-text"}],"events":[{"description":"An option was toggled. detail: { value } (the checked values)","name":"oh-change"}],"released":null},{"tagName":"oh-checkbox","pkg":"@orange-halo/components","description":"A single checkbox with its label, for turning one option on or off.\n\n**Use it for** one yes/no choice, such as agreeing to terms, or as part of\na set where any number can be chosen. **Don't use it for** a set of\nrelated options on its own (use `oh-checkbox-group`, which adds the\nfieldset and legend), one choice from several (use `oh-radio-group`), or a\nsetting that applies straight away (use `oh-toggle`).\n\n**States:** unchecked, checked, hover, active, focus, error (set\n`error-text`), required, disabled.\n\n**Behaviour:** clicking the box or the label toggles it, as does Space\nwhen it's focused. Each change sets `checked` and fires `oh-change`. In a\nnative `<form>`, a checked checkbox submits `value` (`on` if unset) under\n`name`, as a native checkbox does; `required` blocks submitting while it's\nunchecked, reset restores the starting `checked`, and `disabled` (or a\ndisabled `<fieldset>` around it) takes it out of the tab order and the\nform.\n\n**Accessibility:** a real native checkbox, visually hidden, carries the\nrole, state and keyboard behaviour; the drawn box is decoration. Always\nset `label`: it's the checkbox's name. Focus underlines the label. The\nerror message shows under the checkbox with an icon, sets `aria-invalid`\nand is linked with `aria-describedby`; it's announced (`role=\"alert\"`)\nonly when it appears after first render.\n\n**Look:** set by tokens — `stroke.control` in `color.border.emphasis`\n(border), `shape.compact` (corners), `typography.control.*` (label),\n`elevation.offset.*` and `elevation.color.secondary` (shadow), `lift.hoverSm` /\n`lift.activeSm` (movement on hover and press), `color.border.hover`\n(hover), `color.brand.primary` (and its hover and active tokens),\n`color.text.onBrand` and `elevation.color.primary` (checked),\n`color.feedback.error` and `elevation.color.error` (error),\n`color.surface.disabled`, `color.border.disabled` and\n`color.text.disabled` (disabled).","attributes":[{"name":"checked","type":{"text":"boolean"},"default":"false","description":"Whether the box is ticked. Updated when the user toggles it; reset restores the starting value.","fieldName":"checked"},{"name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label, which also names the checkbox. Always set it.","fieldName":"label"},{"name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name it submits under while checked.","fieldName":"name"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"The value submitted while checked (`on` if empty).","fieldName":"value"},{"name":"required","type":{"text":"boolean"},"default":"false","description":"Must be checked before the form submits","fieldName":"required"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","fieldName":"disabled"},{"name":"error-text","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","fieldName":"errorText"},{"name":"force-state","type":{"text":"CheckboxState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'focus'","fieldName":"forceState"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"checked","type":{"text":"boolean"},"default":"false","description":"Whether the box is ticked. Updated when the user toggles it; reset restores the starting value.","attribute":"checked","reflects":true},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label, which also names the checkbox. Always set it.","attribute":"label"},{"kind":"field","name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name it submits under while checked.","attribute":"name"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"The value submitted while checked (`on` if empty).","attribute":"value"},{"kind":"field","name":"required","type":{"text":"boolean"},"default":"false","description":"Must be checked before the form submits","attribute":"required","reflects":true},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","attribute":"disabled","reflects":true},{"kind":"field","name":"errorText","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","attribute":"error-text"},{"kind":"field","name":"forceState","type":{"text":"CheckboxState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'focus'","attribute":"force-state","reflects":true},{"kind":"field","name":"form","description":"The form this checkbox belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}]},{"kind":"method","name":"blur"},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]}],"events":[{"description":"The checkbox was toggled. detail: { checked, value }","name":"oh-change"}],"cssParts":[{"description":"The drawn checkbox","name":"box"},{"description":"The label text","name":"label"},{"description":"The error message","name":"error"}],"released":null},{"tagName":"oh-cluster","pkg":"@orange-halo/components","description":"A horizontal group of items that wraps onto new lines when space runs out.\n\n**Use it for** button groups, tags and rows of links. **Don't use it for**\nvertical lists (use `oh-stack`) or equal-width columns (use `oh-grid`).\n\n**Gaps:** `gap` is `none`, `xs` (`spacing.1`), `sm` (`spacing.2`), `md`\n(default, `spacing.4`), `lg` (`spacing.6`) or `xl` (`spacing.8`), between\nitems and between rows. `justify` is `start` (default), `center`, `end`,\n`between` or `around`; `align` is `start`, `center` (default), `end` or\n`baseline`. `nowrap` keeps everything on one line. `align` lines the items\nup; it doesn't change how the text inside them is aligned.","attributes":[{"name":"gap","type":{"text":"ClusterGap"},"default":"\"md\"","description":"The space between items and between rows: `none`, `xs`, `sm`, `md` (default), `lg` or `xl`, from the `spacing` scale.","fieldName":"gap"},{"name":"justify","type":{"text":"ClusterJustify"},"default":"\"start\"","description":"How items sit along the row: `start` (default), `center`, `end`, `between` or `around`.","fieldName":"justify"},{"name":"align","type":{"text":"ClusterAlign"},"default":"\"center\"","description":"How items line up across the row: `start`, `center` (default), `end` or `baseline`.","fieldName":"align"},{"name":"nowrap","type":{"text":"boolean"},"default":"false","description":"Keeps every item on one line instead of wrapping.","fieldName":"nowrap"}],"members":[{"kind":"field","name":"gap","type":{"text":"ClusterGap"},"default":"\"md\"","description":"The space between items and between rows: `none`, `xs`, `sm`, `md` (default), `lg` or `xl`, from the `spacing` scale.","attribute":"gap","reflects":true},{"kind":"field","name":"justify","type":{"text":"ClusterJustify"},"default":"\"start\"","description":"How items sit along the row: `start` (default), `center`, `end`, `between` or `around`.","attribute":"justify","reflects":true},{"kind":"field","name":"align","type":{"text":"ClusterAlign"},"default":"\"center\"","description":"How items line up across the row: `start`, `center` (default), `end` or `baseline`.","attribute":"align","reflects":true},{"kind":"field","name":"nowrap","type":{"text":"boolean"},"default":"false","description":"Keeps every item on one line instead of wrapping.","attribute":"nowrap","reflects":true}],"slots":[{"description":"The items to group.","name":""}],"released":null},{"tagName":"oh-container","pkg":"@orange-halo/components","description":"A centred wrapper that limits content to a maximum width and adds side padding.\n\n**Use it for** the outer width of a page or section. **Don't use it for**\nspacing between items (use `oh-stack`, `oh-cluster` or `oh-grid`).\n\n**Sizes:** `size` picks the max-width: `sm`, `md`, `lg` (default) and `xl`\nuse `layout.container.sm` to `layout.container.xl`; `full` is the full\nwidth with no side padding. `center` centres the text.\n\n**Behaviour:** side padding is `spacing.4`, rising to `spacing.6` from the\n`size.breakpoint.sm` width and `spacing.8` from `size.breakpoint.lg`.","attributes":[{"name":"size","type":{"text":"ContainerSize"},"default":"\"lg\"","description":"The maximum width: `sm`, `md`, `lg` (default) or `xl`, from `layout.container.*`; `full` is the full width with no side padding.","fieldName":"size"},{"name":"center","type":{"text":"boolean"},"default":"false","description":"Centres the text inside.","fieldName":"center"}],"members":[{"kind":"field","name":"size","type":{"text":"ContainerSize"},"default":"\"lg\"","description":"The maximum width: `sm`, `md`, `lg` (default) or `xl`, from `layout.container.*`; `full` is the full width with no side padding.","attribute":"size","reflects":true},{"kind":"field","name":"center","type":{"text":"boolean"},"default":"false","description":"Centres the text inside.","attribute":"center","reflects":true}],"slots":[{"description":"The content to contain.","name":""}],"released":null},{"tagName":"oh-description-list","pkg":"@orange-halo/components","description":"A list of labels and their values: the details of one thing, or a few highlights.\n\n**Use it for** facts about one thing, each with a label: an order's details, a profile, a settings summary, a set of milestones. **Don't use it for** data compared across rows and columns (use `oh-table`); a list of items with no labels (use a list); or a form (use the form controls). A few headline figures (statistics) are this list too, with `layout=\"grid\"` and `value-size=\"lg\"`.\n\n**Parts:** the default slot holds one `<dl>`, written as normal HTML. Each item is a `<div>` with one `<dt>` (the label) and a `<dd>` (the value). A second `<dd>` is a note under the value. A `<dd data-actions>` holds the item's actions, such as a \"Change\" link; give each action visually hidden text that names its item (\"Change name\"), so it makes sense on its own. In a list of figures (`value-size=\"lg\"`), an item whose value is words, such as a name, takes `data-value=\"text\"` on its `<div>`: it's set smaller (`descriptionList.size.lg.text*`) so it fits its column.\n\n**Layout:** `rows` (default) puts each label beside its value, with a line between items and actions at the end; below the `size.breakpoint.sm` width the label sits above the value. `grid` puts each label above its value, with items side by side in as many columns as fit, each at least `descriptionList.base.columnMinWidth` wide and with a line above it.\n\n**Value size:** `md` (default) sets values as body text. `lg` sets them as figures, in `descriptionList.size.lg.value*`, for a few headline numbers (totals, counts) scanned at a glance; use it with `grid`. Labels and notes don't change. One list has one value size: put a value that isn't a figure in its own list.\n\n**Behaviour:** none of its own: it styles the list and adds no roles or focus stops. Long values wrap.\n\n**Accessibility:** a `<dl>` groups each label with its value for assistive tech. Keep the label in the `<dt>` and the value in the `<dd>`, never the other way round, and give a list that has no visible heading nearby a heading before it.\n\n**Look:** set by tokens. `typography.label.base.*` and `color.text.secondary` set the labels; `typography.body.base.*` and `color.text.primary` the values; `typography.body.sm.*` and `color.text.secondary` the notes; `stroke.divider` with `color.border.divider` the lines; `spacing.*` the gaps; `descriptionList.base.columnMinWidth` the grid's narrowest column (`descriptionList.size.lg.columnMinWidth` with large values); `descriptionList.size.lg.value*` large values.","attributes":[{"name":"layout","type":{"text":"DescriptionListLayout"},"default":"\"rows\"","description":"`rows` (label beside value) or `grid` (label above value, items side by side).","fieldName":"layout"},{"name":"value-size","type":{"text":"DescriptionListValueSize"},"default":"\"md\"","description":"`md` (body text) or `lg` (figures, for headline numbers in the grid layout).","fieldName":"valueSize"}],"members":[{"kind":"field","name":"layout","type":{"text":"DescriptionListLayout"},"default":"\"rows\"","description":"`rows` (label beside value) or `grid` (label above value, items side by side).","attribute":"layout","reflects":true},{"kind":"field","name":"valueSize","type":{"text":"DescriptionListValueSize"},"default":"\"md\"","description":"`md` (body text) or `lg` (figures, for headline numbers in the grid layout).","attribute":"value-size","reflects":true}],"slots":[{"description":"One native `<dl>`, each item a `<div>` with a `<dt>` and its `<dd>`s.","name":""}],"released":null},{"tagName":"oh-drawer","pkg":"@orange-halo/components","description":"A panel that slides in from the side of the viewport, over the page, for navigation or supplementary content.\n\n**Use it for** a site's navigation on small screens, filters, or settings that relate to the page behind. **Don't use it for** a decision the user must make before going on (use `oh-modal`); or for content that should always be visible (put it in the page).\n\n**Parts:** `heading` (an optional visible `h2`), a built-in Close button, and the default slot for the content, which scrolls when it's taller than the viewport.\n\n**Positions:** `start` (the default) or `end` follow the text direction, so in right-to-left text a `start` drawer opens from the right. `left` and `right` are the same physical side in either direction.\n\n**Behaviour:** set `open`, or call `show()` and `hide()`. On open, focus moves to the Close button, Tab and Shift+Tab wrap inside the panel, and the page behind stops scrolling. The Close button, Escape, a click on the backdrop and `hide()` close it and fire `oh-close`; focus then returns to the element that opened it. While closed the panel is `inert`. Motion is off under `prefers-reduced-motion`.\n\n**Accessibility:** the panel is `role=\"dialog\"` with `aria-modal=\"true\"`, labelled by `heading`, or \"Navigation menu\" when there's no heading, so set `heading` for any other use. The Close button's accessible name is \"Close menu\".\n\n**Look:** set by tokens. `color.surface.overlay` sets the backdrop and `color.surface.base` the panel. A start or left drawer's shadow is `elevation.strong`; an end or right drawer's is an `elevation.offset.lg` offset in `color.border.strong`. The heading uses `typography.heading.h5.fontSize`, `typography.heading.h5.lineHeight` and `typography.emphasis.fontWeight`. Motion uses `motion.relaxed` and `motion.easeGentle`. The width is `drawer.base.width`, which `--oh-drawer-width` overrides, and it always leaves `drawer.base.viewportGap` of the viewport uncovered.","attributes":[{"name":"open","type":{"text":"boolean"},"default":"false","description":"Whether the drawer is open","fieldName":"open"},{"name":"position","type":{"text":"DrawerPosition"},"default":"\"start\"","description":"The side the drawer opens from. `start` (the default) and `end` follow the\ntext direction: `start` is the left in left-to-right text and the right in\nright-to-left. `left` and `right` are the same physical side either way.","fieldName":"position"},{"name":"heading","type":{"text":"string | undefined"},"description":"Title shown in the drawer header","fieldName":"heading"}],"members":[{"kind":"field","name":"open","type":{"text":"boolean"},"default":"false","description":"Whether the drawer is open","attribute":"open","reflects":true},{"kind":"field","name":"position","type":{"text":"DrawerPosition"},"default":"\"start\"","description":"The side the drawer opens from. `start` (the default) and `end` follow the\ntext direction: `start` is the left in left-to-right text and the right in\nright-to-left. `left` and `right` are the same physical side either way.","attribute":"position"},{"kind":"field","name":"heading","type":{"text":"string | undefined"},"description":"Title shown in the drawer header","attribute":"heading"},{"kind":"method","name":"show","description":"Public method to open the drawer"},{"kind":"method","name":"hide","description":"Public method to close the drawer"}],"events":[{"name":"oh-close","type":{"text":"CustomEvent"},"description":"When the drawer is closed by the Close button, Escape, the backdrop or `hide()`. Not fired when you set `open` to false yourself."}],"slots":[{"description":"Default slot for drawer content","name":""}],"released":null},{"tagName":"oh-footer","pkg":"@orange-halo/components","description":"A site footer with a logo, copyright line, social links and columns of links.\n\n**Use it for** the footer at the bottom of every page. **Don't use it for**\nthe main navigation (use `oh-navbar`).\n\n**Parts:** the `logo` slot; `copyright`, a line of text under the logo;\nthe `social` slot for `oh-icon` links (with `inverse`); and the default\nslot, where each `oh-stack` becomes a column (start it with a heading, then\n`oh-link`s with `inverse`).\n\n**Behaviour:** the columns follow `oh-grid`'s four-column steps at the\n`size.breakpoint.*` widths; at and below `size.breakpoint.md` the logo\ncolumn spans the full width.\n\n**Accessibility:** renders a `<footer>`. Give the logo an accessible name,\neach social icon a `label`, and the column headings a level that fits the\npage's outline.\n\n**Look:** set by tokens — `color.accent.default` the background,\n`color.text.onAccent` the text, `typography.body.*` the type, `spacing.8`\nthe vertical padding.","attributes":[{"name":"copyright","type":{"text":"string"},"default":"\"\"","description":"Copyright text","fieldName":"copyright"}],"members":[{"kind":"field","name":"copyright","type":{"text":"string"},"default":"\"\"","description":"Copyright text","attribute":"copyright"}],"slots":[{"description":"Slot for logo element","name":"logo"},{"description":"Slot for social media icons","name":"social"},{"description":"Default slot for link columns (use oh-stack for each column)","name":""}],"released":null},{"tagName":"oh-grid","pkg":"@orange-halo/components","description":"A CSS grid of equal-width columns, fixed or as many as fit.\n\n**Use it for** cards, galleries and other sets of similar items. **Don't\nuse it for** a single column (use `oh-stack`) or items of varying width in\na row (use `oh-cluster`).\n\n**Columns:** `columns` is `1`–`4`, `auto-fit` (default) or `auto-fill`.\nAuto columns are at least `min-width` wide (any CSS length); `auto-fit`\nstretches the items to fill the row, `auto-fill` keeps empty tracks.\n**Gaps:** `gap` is `none`, `xs` (`spacing.1`), `sm` (`spacing.2`), `md`\n(default, `spacing.4`), `lg` (`spacing.6`) or `xl` (`spacing.8`).\n`align-items` is `start`, `center`, `end` or `stretch` (default).\n\n**Behaviour:** fixed columns respond to the viewport: up to\n`size.breakpoint.sm` they become one column; up to `size.breakpoint.md`,\n3 and 4 become 2; up to `size.breakpoint.lg`, 4 becomes 3.","attributes":[{"name":"columns","type":{"text":"GridColumns"},"default":"\"auto-fit\"","description":"`1` to `4` fixed columns (fewer on narrow screens), or `auto-fit` (default) and `auto-fill` for as many as fit.","fieldName":"columns"},{"name":"gap","type":{"text":"GridGap"},"default":"\"md\"","description":"The space between items: `none`, `xs`, `sm`, `md` (default), `lg` or `xl`, from the `spacing` scale.","fieldName":"gap"},{"name":"min-width","type":{"text":"string"},"default":"\"280px\"","description":"The narrowest an auto column can be, as any CSS length.","fieldName":"minWidth"},{"name":"align-items","type":{"text":"\"start\" | \"center\" | \"end\" | \"stretch\""},"default":"\"stretch\"","description":"How items line up in their row: `start`, `center`, `end` or `stretch` (default).","fieldName":"alignItems"}],"members":[{"kind":"field","name":"columns","type":{"text":"GridColumns"},"default":"\"auto-fit\"","description":"`1` to `4` fixed columns (fewer on narrow screens), or `auto-fit` (default) and `auto-fill` for as many as fit.","attribute":"columns","reflects":true},{"kind":"field","name":"gap","type":{"text":"GridGap"},"default":"\"md\"","description":"The space between items: `none`, `xs`, `sm`, `md` (default), `lg` or `xl`, from the `spacing` scale.","attribute":"gap","reflects":true},{"kind":"field","name":"minWidth","type":{"text":"string"},"default":"\"280px\"","description":"The narrowest an auto column can be, as any CSS length.","attribute":"min-width"},{"kind":"field","name":"alignItems","type":{"text":"\"start\" | \"center\" | \"end\" | \"stretch\""},"default":"\"stretch\"","description":"How items line up in their row: `start`, `center`, `end` or `stretch` (default).","attribute":"align-items","reflects":true}],"slots":[{"description":"The grid items.","name":""}],"released":null},{"tagName":"oh-icon","pkg":"@orange-halo/components","description":"An icon from the system's built-in set, shown on its own, with a label, or as an icon-only link.\n\n**Use it for** an icon next to text, an icon that carries meaning on its own (with `accessible-label`), or a compact link such as a social profile (`href` + `accessible-label`). **Don't use it for** an icon-only button (use `oh-button` with `icon-only`); or for an image or logo (use `<img>`).\n\n**Names:** `name` picks the icon: social (`twitter`, `github`, `linkedin`, `instagram`, `youtube`, `facebook`, `email`, `substack`), navigation (`arrow-*`, `chevron-*`, `external-link`), actions (`close`, `plus`, `minus`, `check`, `search`, `menu`, `settings`, `heart`, `sparkle`) and feedback (`info`, `warning`, `error`, `success`). An unknown name renders nothing and logs a warning.\n\n**Sizes:** with no `size` the icon is 1em and follows the text; `sm`, `md`, `lg`, `xl` set fixed sizes. **`inverse`:** for icons on an accent-coloured or dark background.\n\n**Behaviour:** the icon takes the current text colour. `arrow-left`, `arrow-right`, `chevron-left` and `chevron-right` mirror in right-to-left text, so they keep pointing back and forward along the line. With `href` it renders as a link, with hover, active and focus-visible states; `target=\"_blank\"` adds `rel=\"noopener noreferrer\"`.\n\n**Accessibility:** without `accessible-label` the icon is decorative (`aria-hidden=\"true\"`). With `accessible-label` it's `role=\"img\"` with that name. As a link, `accessible-label` is required (it logs a warning without one) and becomes the link's `aria-label`. Focus-visible shows a solid ring in `focus.ringColor` (`color.text.onAccent` when `inverse`).\n\n**Look:** set by tokens. The icon is `currentColor`; `inverse` sets `color.text.onAccent`. As a link: `shape.compact` corners, hover moves by `lift.hoverMd` with an `elevation.offset.lg` shadow in `color.border.default` (`color.text.onAccent` when `inverse`); motion uses `motion.snappy` and `motion.easeGentle`, off under `prefers-reduced-motion`.","attributes":[{"name":"name","type":{"text":"IconName"},"default":"\"info\"","description":"Which built-in icon to show. An unknown name renders nothing and logs a warning.","fieldName":"name"},{"name":"size","type":{"text":"IconSize | undefined"},"description":"`sm`, `md`, `lg` or `xl` for a fixed size; leave it unset to follow the text size.","fieldName":"size"},{"name":"inverse","type":{"text":"boolean"},"default":"false","description":"For icons on an accent-coloured or dark background.","fieldName":"inverse"},{"name":"accessible-label","type":{"text":"string | undefined"},"description":"Names an icon that carries meaning (`role=\"img\"`), or an icon link. Without it the icon is decorative and hidden from screen readers.","fieldName":"accessibleLabel"},{"name":"href","type":{"text":"string | undefined"},"description":"Renders the icon as a link to this URL. Set `accessible-label` too.","fieldName":"href"},{"name":"target","type":{"text":"string | undefined"},"description":"The link's target; `_blank` adds `rel=\"noopener noreferrer\"`.","fieldName":"target"}],"members":[{"kind":"field","name":"name","type":{"text":"IconName"},"default":"\"info\"","description":"Which built-in icon to show. An unknown name renders nothing and logs a warning.","attribute":"name"},{"kind":"field","name":"size","type":{"text":"IconSize | undefined"},"description":"`sm`, `md`, `lg` or `xl` for a fixed size; leave it unset to follow the text size.","attribute":"size","reflects":true},{"kind":"field","name":"inverse","type":{"text":"boolean"},"default":"false","description":"For icons on an accent-coloured or dark background.","attribute":"inverse","reflects":true},{"kind":"field","name":"accessibleLabel","type":{"text":"string | undefined"},"description":"Names an icon that carries meaning (`role=\"img\"`), or an icon link. Without it the icon is decorative and hidden from screen readers.","attribute":"accessible-label"},{"kind":"field","name":"href","type":{"text":"string | undefined"},"description":"Renders the icon as a link to this URL. Set `accessible-label` too.","attribute":"href"},{"kind":"field","name":"target","type":{"text":"string | undefined"},"description":"The link's target; `_blank` adds `rel=\"noopener noreferrer\"`.","attribute":"target"}],"released":null},{"tagName":"oh-input","pkg":"@orange-halo/components","description":"A single-line text field that submits with a native form, with optional\ntyping suggestions.\n\n**Use it for** short free text: names, email addresses, search terms.\n**Don't use it for** several lines (use `oh-textarea`) or a choice from a\nfixed list (use `oh-select`, or `oh-radio-group` for a few options).\n`suggestions` offers values while still allowing any text.\n\n**Types:** `text` (default), `email`, `password`, `search`, `tel`, `url`.\nOne size. **States:** rest, hover, focus, error (set `error-text`),\ndisabled, required.\n\n**Behaviour:** form-associated: the value submits under `name`, `required`\nblocks submission (validity comes from the inner `<input>`), a form reset\nrestores the starting value, and a disabled `<fieldset>` disables it.\nFires `oh-input` as the text changes and `oh-change` when it's committed.\n`suggestions` renders a native `<datalist>`, so the browser handles its\nkeyboard and screen reader support. `autocomplete` is passed to the inner\n`<input>`.\n\n**Accessibility:** always set `label`: it's the field's name. The error\nshows after the label and before the field, with an icon, and is linked\nwith `aria-describedby` and `aria-invalid`; it's announced (`role=\"alert\"`)\nonly when it appears after first render. Helper text is linked the same\nway (it's hidden while an error shows). Focus is a solid inset ring.\nSet `autocomplete` for personal data (WCAG 1.3.5).\n\n**Look:** set by tokens — `color.surface.field` (fill),\n`input.base.borderWidth` (`stroke.control`) in\n`color.border.emphasis` (border), `shape.control` (corners),\n`typography.control.*` (type), `input.size.md.minHeight` (height),\n`elevation.offset.md` and `elevation.color.field` (inset shadow),\n`color.border.hover` (hover), `focus.ringColor` and\n`color.surface.highlight` (focus), `color.feedback.error`,\n`color.feedback.errorSubtle` and `elevation.color.error` (error),\n`color.feedback.errorHover` (error hover),\n`color.surface.disabled`, `color.border.disabled` and\n`color.text.disabled` (disabled).","attributes":[{"name":"type","type":{"text":"InputType"},"default":"\"text\"","description":"The kind of text: text, email, password, search, tel or url","fieldName":"type"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"The text in the field","fieldName":"value"},{"name":"placeholder","type":{"text":"string"},"default":"\"\"","description":"Example text shown while the field is empty. Not a replacement for the label","fieldName":"placeholder"},{"name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label. Always set one: it names the field","fieldName":"label"},{"name":"helper-text","type":{"text":"string"},"default":"\"\"","description":"Help shown under the field and linked to it","fieldName":"helperText"},{"name":"error-text","type":{"text":"string"},"default":"\"\"","description":"Error shown before the field and linked to it. Setting it puts the field in its error state","fieldName":"errorText"},{"name":"name","type":{"text":"string"},"default":"\"\"","description":"The name the value is submitted under","fieldName":"name"},{"name":"required","type":{"text":"boolean"},"default":"false","description":"Must be filled in before the form submits","fieldName":"required"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not editable, and left out of the form's data","fieldName":"disabled"},{"name":"suggestions","type":{"text":"string[]"},"default":"[]","description":"Values offered while typing, shown by the browser as a list under the\nfield. They suggest, they don't restrict: any text is still allowed.\nSet it as a property (an array of strings) or, in HTML, as a JSON array:\nsuggestions='[\"Option one\",\"Option two\"]'. Browsers also offer the\nfield's autofill history, so set autocomplete=\"off\" to show only these.","fieldName":"suggestions"},{"name":"autocomplete","type":{"text":"string | undefined"},"description":"The input's purpose, for autofill and assistive tech (WCAG 1.3.5):\nan HTML autocomplete token such as \"email\", \"name\" or \"tel\".\nPassed to the inner <input>.","fieldName":"autocomplete"},{"name":"force-state","type":{"text":"InputState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'focus'","fieldName":"forceState"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"type","type":{"text":"InputType"},"default":"\"text\"","description":"The kind of text: text, email, password, search, tel or url","attribute":"type"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"The text in the field","attribute":"value"},{"kind":"field","name":"placeholder","type":{"text":"string"},"default":"\"\"","description":"Example text shown while the field is empty. Not a replacement for the label","attribute":"placeholder"},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label. Always set one: it names the field","attribute":"label"},{"kind":"field","name":"helperText","type":{"text":"string"},"default":"\"\"","description":"Help shown under the field and linked to it","attribute":"helper-text"},{"kind":"field","name":"errorText","type":{"text":"string"},"default":"\"\"","description":"Error shown before the field and linked to it. Setting it puts the field in its error state","attribute":"error-text"},{"kind":"field","name":"name","type":{"text":"string"},"default":"\"\"","description":"The name the value is submitted under","attribute":"name","reflects":true},{"kind":"field","name":"required","type":{"text":"boolean"},"default":"false","description":"Must be filled in before the form submits","attribute":"required","reflects":true},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not editable, and left out of the form's data","attribute":"disabled","reflects":true},{"kind":"field","name":"suggestions","type":{"text":"string[]"},"default":"[]","description":"Values offered while typing, shown by the browser as a list under the\nfield. They suggest, they don't restrict: any text is still allowed.\nSet it as a property (an array of strings) or, in HTML, as a JSON array:\nsuggestions='[\"Option one\",\"Option two\"]'. Browsers also offer the\nfield's autofill history, so set autocomplete=\"off\" to show only these.","attribute":"suggestions"},{"kind":"field","name":"autocomplete","type":{"text":"string | undefined"},"description":"The input's purpose, for autofill and assistive tech (WCAG 1.3.5):\nan HTML autocomplete token such as \"email\", \"name\" or \"tel\".\nPassed to the inner <input>.","attribute":"autocomplete"},{"kind":"field","name":"forceState","type":{"text":"InputState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'focus'","attribute":"force-state","reflects":true},{"kind":"field","name":"form","description":"The form this field belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}]},{"kind":"method","name":"blur"},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]}],"events":[{"description":"Whenever the text changes: typing, or picking a suggestion. detail: { value, originalEvent }","name":"oh-input"},{"description":"When the value is committed (on blur or Enter). detail: { value, originalEvent }","name":"oh-change"}],"cssParts":[{"description":"The visible label","name":"label"},{"description":"The text field","name":"input"},{"description":"The helper text, and the error message (which also has the error part)","name":"helper"},{"description":"The error message","name":"error"}],"released":null},{"tagName":"oh-link","pkg":"@orange-halo/components","description":"A text link, for use inside body copy or on its own as a call to action.\n\n**Use it for** navigating to another page or place. **Don't use it for**\nactions that don't navigate (use `oh-button` instead).\n\n**Variants:** `inline` (default) sits in running text; `standalone` is\nlarger and bolder for links on their own, and can show a trailing arrow\n(`arrow`). `inverse` is for links on accent surfaces.\n\n**Behaviour:** renders a native `<a>`, so Enter follows it and it takes\nfocus in tab order. On hover the underline retracts and the arrow nudges\nforward. Keyboard focus (`:focus-visible`) shows a solid underline and a\ntint; mouse focus doesn't. Transitions are cut short under\n`prefers-reduced-motion`. With `target=\"_blank\"` it adds an external icon,\nscreen-reader text \"(opens in new tab)\" and `rel=\"noopener noreferrer\"`\nwhen `rel` isn't set; the arrow is not shown on external links.\n\n**Accessibility:** the underline shows at rest and on focus, so links\ndon't rely on colour. Write link text that makes sense out of context.\n\n**Look:** set by tokens — `color.text.link` the colour (`color.text.onAccent`\nwhen `inverse`); `decoration.underlineThickness`, `decoration.underlineDash`\nand `decoration.underlinePeriod` the underline; `color.brand.primary`\n(`color.text.onAccent` when `inverse`) and\n`decoration.underlineFocusThickness` the focus underline; `focus.decorationColor`\n(`link.variant.inverse.focusBackground` when `inverse`) the focus tint;\n`typography.body.fontFamily`, plus `typography.body.lg.fontSize` and\n`typography.emphasis.fontWeight` for `standalone`; `motion.slow` and\n`motion.snappy` the transitions.","attributes":[{"name":"href","type":{"text":"string"},"default":"\"\"","description":"Where the link goes.","fieldName":"href"},{"name":"target","type":{"text":"string"},"default":"\"\"","description":"The link's target. `_blank` adds an external icon and the screen-reader text \"(opens in new tab)\".","fieldName":"target"},{"name":"rel","type":{"text":"string"},"default":"\"\"","description":"The link's `rel`. Left empty with `target=\"_blank\"`, it becomes `noopener noreferrer`.","fieldName":"rel"},{"name":"variant","type":{"text":"LinkVariant"},"default":"\"inline\"","description":"`inline` (default) for links in running text, or `standalone`, larger and bolder, for a link on its own.","fieldName":"variant"},{"name":"arrow","type":{"text":"boolean"},"default":"false","description":"Shows a trailing arrow on a `standalone` link (not on external links).","fieldName":"arrow"},{"name":"inverse","type":{"text":"boolean"},"default":"false","description":"For links on accent-coloured or dark surfaces.","fieldName":"inverse"}],"members":[{"kind":"field","name":"href","type":{"text":"string"},"default":"\"\"","description":"Where the link goes.","attribute":"href"},{"kind":"field","name":"target","type":{"text":"string"},"default":"\"\"","description":"The link's target. `_blank` adds an external icon and the screen-reader text \"(opens in new tab)\".","attribute":"target"},{"kind":"field","name":"rel","type":{"text":"string"},"default":"\"\"","description":"The link's `rel`. Left empty with `target=\"_blank\"`, it becomes `noopener noreferrer`.","attribute":"rel"},{"kind":"field","name":"variant","type":{"text":"LinkVariant"},"default":"\"inline\"","description":"`inline` (default) for links in running text, or `standalone`, larger and bolder, for a link on its own.","attribute":"variant"},{"kind":"field","name":"arrow","type":{"text":"boolean"},"default":"false","description":"Shows a trailing arrow on a `standalone` link (not on external links).","attribute":"arrow"},{"kind":"field","name":"inverse","type":{"text":"boolean"},"default":"false","description":"For links on accent-coloured or dark surfaces.","attribute":"inverse","reflects":true}],"slots":[{"description":"The link text.","name":""}],"released":null},{"tagName":"oh-modal","pkg":"@orange-halo/components","description":"A dialog that opens over the page and holds the user's attention until they close it or act on it.\n\n**Use it for** a short task or decision that must be done before going on: a confirmation, a small form. **Don't use it for** content the user may want alongside the page (use `oh-drawer`); for a message that doesn't need an answer (use `oh-alert`); or for long, multi-step flows (use a page).\n\n**Parts:** `heading` (a visible `h2`); the default slot for the body, which scrolls when it's taller than the viewport; the `footer` slot for actions (with nothing in it, there's no footer).\n\n**Sizes:** `sm`, `md` (default), `lg` and `xl` set the dialog's width (never wider than the viewport). `xl` is for an image beside its details, such as a poster or a photo with its caption and facts; keep forms and messages at `md` or `lg`, where lines stay readable.\n\n**Behaviour:** set `open` to show it. On open, focus moves to the Close button (or the first focusable element when there's none), Tab and Shift+Tab wrap inside the dialog, and the page behind stops scrolling. On close, focus returns to the element that had it. With `dismissible` (the default), the Close button, Escape and a click on the backdrop each fire `oh-close` and set `open` to false; without it, only your own buttons close it. Motion is reduced under `prefers-reduced-motion`.\n\n**Accessibility:** the panel is `role=\"dialog\"` with `aria-modal=\"true\"`, named by `heading`. Without a visible heading, set `accessible-label` (not `aria-label` on the host, which isn't forwarded). The close button has a visible \"Close\" label.\n\n**Look:** set by tokens. `modal.base.backdrop` sets the backdrop; the panel uses `color.surface.base`, a `stroke.control` border in `color.border.emphasis`, `shape.container` corners and an `elevation.offset.2xl` shadow in `elevation.color.overlay`. Header and footer dividers use `stroke.control` in `color.border.subtle`; the title uses `typography.heading.h4.*`, the body `typography.body.*`. The close button uses `closeButton.*`, `lift.*` and `shape.compact`. Motion uses `motion.gentle` and `motion.easeEmphasized`. Widths come from `modal.size.*.width`.","attributes":[{"name":"open","type":{"text":"boolean"},"default":"false","description":"Whether the dialog is showing. Set it to open; closing sets it back to false.","fieldName":"open"},{"name":"heading","type":{"text":"string"},"default":"\"\"","description":"The visible title (an `h2`), which also names the dialog. Without one, set `accessible-label`.","fieldName":"heading"},{"name":"accessible-label","type":{"text":"string | undefined"},"description":"Names the dialog when it has no visible heading. Use this rather than\naria-label on the host, which isn't forwarded into the shadow root.\nA visible heading always wins.","fieldName":"accessibleLabel"},{"name":"dismissible","type":{"text":"boolean"},"default":"true","description":"Lets the Close button, Escape and a backdrop click close it, each firing `oh-close` (default on). Turn it off to close only from your own buttons.","fieldName":"dismissible"},{"name":"size","type":{"text":"ModalSize"},"default":"\"md\"","description":"The dialog's width: `sm`, `md` (default), `lg` or `xl` (an image beside its details), never wider than the viewport.","fieldName":"size"}],"members":[{"kind":"field","name":"open","type":{"text":"boolean"},"default":"false","description":"Whether the dialog is showing. Set it to open; closing sets it back to false.","attribute":"open","reflects":true},{"kind":"field","name":"heading","type":{"text":"string"},"default":"\"\"","description":"The visible title (an `h2`), which also names the dialog. Without one, set `accessible-label`.","attribute":"heading"},{"kind":"field","name":"accessibleLabel","type":{"text":"string | undefined"},"description":"Names the dialog when it has no visible heading. Use this rather than\naria-label on the host, which isn't forwarded into the shadow root.\nA visible heading always wins.","attribute":"accessible-label"},{"kind":"field","name":"dismissible","type":{"text":"boolean"},"default":"true","description":"Lets the Close button, Escape and a backdrop click close it, each firing `oh-close` (default on). Turn it off to close only from your own buttons.","attribute":"dismissible","reflects":true},{"kind":"field","name":"size","type":{"text":"ModalSize"},"default":"\"md\"","description":"The dialog's width: `sm`, `md` (default), `lg` or `xl` (an image beside its details), never wider than the viewport.","attribute":"size","reflects":true}],"events":[{"description":"When the user closes the dialog with the Close button, Escape or the backdrop. Not fired when you set `open` to false yourself.","name":"oh-close"}],"slots":[{"description":"The dialog body.","name":""},{"description":"Actions, below the body.","name":"footer"}],"cssParts":[{"description":"The dialog panel.","name":"modal"},{"description":"The header (heading and close button).","name":"header"},{"description":"The close button (only when `dismissible`).","name":"close"},{"description":"The scrolling body.","name":"body"},{"description":"The footer.","name":"footer"}],"released":null},{"tagName":"oh-navbar","pkg":"@orange-halo/components","description":"A site header bar with a logo and the site's main navigation links, which move into a drawer on narrow viewports.\n\n**Use it for** the main navigation at the top of every page. **Don't use\nit for** in-page sections (use `oh-tabs`) or a trail through the hierarchy\n(use `oh-breadcrumb`).\n\n**Parts:** the `logo` slot (a link to the home page), the default slot for\nthe bar's links (`oh-link`), and the `mobile` slot for the same links in the\ndrawer. `drawer-heading` names the drawer (defaults to \"Menu\").\n\n**Behaviour:** at and below the `size.breakpoint.md` width the links hide\nand an icon-only menu button (\"Open navigation menu\") opens an `oh-drawer`\nfrom the left, which traps focus and closes on Escape or its close button.\n\n**Accessibility:** the bar and the drawer each wrap their links in a\n`<nav>`; the drawer is a modal dialog. Give the logo link an accessible\nname (`alt` on its image, or text).\n\n**Look:** set by tokens — `color.surface.base` the background,\n`navbar.base.shadow` the shadow (`elevation.offset.sm` and `focus.decorationColor`), `typography.body.*` the text, `spacing.*` the\npadding and gaps, `stroke.divider` and `color.border.subtle` the dividers\nbetween drawer links. `navbar.base.logoHeight` sets the logo height, and `--oh-navbar-logo-height` overrides it on a page.","attributes":[{"name":"drawer-heading","type":{"text":"string"},"default":"\"Menu\"","description":"Heading shown in the mobile drawer","fieldName":"drawerHeading"}],"members":[{"kind":"field","name":"drawerHeading","type":{"text":"string"},"default":"\"Menu\"","description":"Heading shown in the mobile drawer","attribute":"drawer-heading"}],"slots":[{"description":"Slot for logo/brand element","name":"logo"},{"description":"Default slot for navigation links","name":""},{"description":"The navigation links again, shown in the drawer","name":"mobile"}],"released":null},{"tagName":"oh-progress","pkg":"@orange-halo/components","description":"A bar that shows how much of a task is done, with an optional percentage and visible label.\n\n**Use it for** a task with a known end: an upload, a download, steps completed. **Don't use it for** a wait of unknown length (it has no indeterminate state); or for a measurement that isn't progress, like storage used against a quota (a meter).\n\n**Variants:** `brand` (default), and `success`, `info`, `warning`, `error` by their feedback role. **Sizes:** `sm`, `md` (default), `lg` set the track height and the value's text size. **`inverse`:** for use on a brand-coloured or dark background.\n\n**Behaviour:** `value` runs from 0 to `max` (default 100) and is clamped to that range; the bar and the percentage show `value / max`, rounded. `show-value` (on by default) shows the percentage; `show-label` shows `label` above the bar. The fill's width animates when the value changes, except under `prefers-reduced-motion`.\n\n**Accessibility:** the bar is a `progressbar` with `aria-valuenow`, `aria-valuemin`, `aria-valuemax` and `aria-label` from `label` (default \"Progress\"). Always set `label` to say what is progressing. The visible percentage is `aria-hidden`, since screen readers read the value from the progressbar.\n\n**Look:** set by tokens. The track uses `color.surface.inset`, a `stroke.control` border in `color.border.default`, `shape.pill` corners and an inset `elevation.offset.sm` shadow in `progress.base.trackInsetShadow`. The fill is `color.brand.primary` or `color.feedback.<variant>`. Text uses `color.text.primary` and `typography.body.*`. Inverse uses `progress.variant.inverse.trackBackground`, `progress.variant.inverse.trackBorder`, `progress.variant.inverse.fill` and `color.text.onBrand`. Motion uses `motion.relaxed` and `motion.easeGentle`.","attributes":[{"name":"value","type":{"text":"number"},"default":"0","description":"Current progress value (0-100 by default, or 0-max)","fieldName":"value"},{"name":"max","type":{"text":"number"},"default":"100","description":"Maximum value (default 100)","fieldName":"max"},{"name":"label","type":{"text":"string"},"default":"\"Progress\"","description":"Accessible label describing what the progress represents","fieldName":"label"},{"name":"show-label","type":{"text":"boolean"},"default":"false","description":"Whether to show the visible label above the bar","fieldName":"showLabel"},{"name":"show-value","type":{"text":"boolean"},"default":"true","description":"Whether to show the percentage number","fieldName":"showValue"},{"name":"size","type":{"text":"ProgressSize"},"default":"\"md\"","description":"Size variant","fieldName":"size"},{"name":"variant","type":{"text":"ProgressVariant"},"default":"\"brand\"","description":"Color variant","fieldName":"variant"},{"name":"inverse","type":{"text":"boolean"},"default":"false","description":"Inverse colors for dark backgrounds","fieldName":"inverse"}],"members":[{"kind":"field","name":"value","type":{"text":"number"},"default":"0","description":"Current progress value (0-100 by default, or 0-max)","attribute":"value","reflects":true},{"kind":"field","name":"max","type":{"text":"number"},"default":"100","description":"Maximum value (default 100)","attribute":"max","reflects":true},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"Progress\"","description":"Accessible label describing what the progress represents","attribute":"label"},{"kind":"field","name":"showLabel","type":{"text":"boolean"},"default":"false","description":"Whether to show the visible label above the bar","attribute":"show-label"},{"kind":"field","name":"showValue","type":{"text":"boolean"},"default":"true","description":"Whether to show the percentage number","attribute":"show-value"},{"kind":"field","name":"size","type":{"text":"ProgressSize"},"default":"\"md\"","description":"Size variant","attribute":"size","reflects":true},{"kind":"field","name":"variant","type":{"text":"ProgressVariant"},"default":"\"brand\"","description":"Color variant","attribute":"variant","reflects":true},{"kind":"field","name":"inverse","type":{"text":"boolean"},"default":"false","description":"Inverse colors for dark backgrounds","attribute":"inverse","reflects":true},{"kind":"field","name":"percentage","type":{"text":"number"},"privacy":"private","description":"Calculate percentage (clamped 0-100)","readonly":true}],"cssParts":[{"description":"The bar's track.","name":"track"},{"description":"The filled part of the track.","name":"fill"},{"description":"The percentage text.","name":"value"}],"released":null},{"tagName":"oh-radio-group","pkg":"@orange-halo/components","description":"A set of radio buttons under one label, where exactly one can be chosen.\n\n**Use it for** one choice from a few options that should all be visible,\nsuch as a plan or a delivery speed. **Don't use it for** a long list (use\n`oh-select`), several choices (use `oh-checkbox-group`) or an on/off\nsetting (use `oh-toggle` or `oh-checkbox`). Use it rather than separate\n`oh-radio` elements, which can't form a group.\n\n**Parts:** a `label` for the group and a list of `options`\n(`{ label, value }`). `value` is the chosen option's value. **States:**\neach option unchecked, checked, hover, active and focus; the group can be\n`required`, disabled, and in error (set `error-text`).\n\n**Behaviour:** Tab moves into and out of the group; arrow keys move\nbetween options and choose them (the browser's native radio behaviour).\nEach change sets `value` and fires `oh-change`. In a native `<form>` it\nsubmits `value` under `name` (nothing while no option is chosen);\n`required` blocks submitting with none chosen, reset restores the\nstarting value, and `disabled` (or a disabled `<fieldset>` around it)\ntakes every option out of the tab order and the form.\n\n**Accessibility:** `role=\"radiogroup\"` labelled by `label`, so always set\none. The error shows after the label and before the options, with an\nicon; the group gets `aria-invalid` and `aria-describedby`, and the error\nis announced (`role=\"alert\"`) only when it appears after first render.\nFocus underlines the option's label.\n\n**Look:** set by tokens — the same as `oh-radio`: `stroke.control` in\n`color.border.emphasis` (border), `shape.pill` (circle),\n`elevation.offset.*` with `elevation.color.secondary` / `elevation.color.primary` (shadow),\n`lift.hoverSm` / `lift.activeSm` (movement on hover and press),\n`color.brand.primary` and `color.text.onBrand` (checked),\n`color.feedback.error` and `elevation.color.error` (error); `typography.control.*`\nfor the group label and option labels; `color.surface.disabled`,\n`color.border.disabled` and `color.text.disabled` (disabled).","attributes":[{"name":"label","type":{"text":"string"},"default":"\"\"","description":"The group's visible label, which also names the group. Always set it.","fieldName":"label"},{"name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name the chosen value is submitted under.","fieldName":"name"},{"name":"options","type":{"text":"RadioOption[]"},"default":"[]","description":"The radios, as `{ label, value }` objects. Set it as a property, or as JSON in the attribute.","fieldName":"options"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"The chosen option's value (empty for none). Updated on every change.","fieldName":"value"},{"name":"required","type":{"text":"boolean"},"default":"false","description":"An option must be chosen: marks the label and blocks a native form from submitting while none is.","fieldName":"required"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","fieldName":"disabled"},{"name":"error-text","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","fieldName":"errorText"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"The group's visible label, which also names the group. Always set it.","attribute":"label"},{"kind":"field","name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name the chosen value is submitted under.","attribute":"name"},{"kind":"field","name":"options","type":{"text":"RadioOption[]"},"default":"[]","description":"The radios, as `{ label, value }` objects. Set it as a property, or as JSON in the attribute.","attribute":"options"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"The chosen option's value (empty for none). Updated on every change.","attribute":"value"},{"kind":"field","name":"required","type":{"text":"boolean"},"default":"false","description":"An option must be chosen: marks the label and blocks a native form from submitting while none is.","attribute":"required","reflects":true},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","attribute":"disabled","reflects":true},{"kind":"field","name":"form","description":"The form this group belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}],"description":"Focuses the chosen option, or the first"},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]},{"kind":"field","name":"errorText","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","attribute":"error-text"}],"events":[{"description":"An option was chosen. detail: { value }","name":"oh-change"}],"released":null},{"tagName":"oh-radio","pkg":"@orange-halo/components","description":"A single radio button with its label.\n\n**Use it for** a one-off radio you manage yourself. **For a set of\nchoices, use `oh-radio-group`.** Each `oh-radio` keeps its native radio\ninside its own shadow root, so two of them with the same `name` don't form\na group: checking one doesn't uncheck the other, and arrow keys don't move\nbetween them. `oh-radio-group` renders the whole set in one place, with\narrow-key navigation and one label for the group. For an independent\non/off choice use `oh-checkbox`.\n\n**States:** unchecked, checked, hover, active, focus, error (set `error-text`).\n\n**Behaviour:** clicking the circle or label checks it. Checking sets\n`checked` and fires `oh-change`. The native radio sits in the shadow\nroot, so it doesn't submit with a native form.\n\n**Accessibility:** a real native radio, visually hidden, carries the role\nand state; the drawn circle is decoration. Always set `label`: it's the\nradio's name. Focus underlines the label. The error message shows under\nthe radio with an icon, sets `aria-invalid` and is linked with\n`aria-describedby`; it's announced (`role=\"alert\"`) only when it appears\nafter first render.\n\n**Look:** set by tokens — `stroke.control` in `color.border.emphasis`\n(border), `shape.pill` (circle), `typography.control.*` (label),\n`elevation.offset.*` and `elevation.color.secondary` (shadow), `lift.hoverSm` /\n`lift.activeSm` (movement on hover and press), `color.border.hover`\n(hover), `color.brand.primary` (and its hover and active tokens),\n`color.text.onBrand` and `elevation.color.primary` (checked),\n`color.feedback.error` and `elevation.color.error` (error).","attributes":[{"name":"checked","type":{"text":"boolean"},"default":"false","description":"Whether this radio is chosen.","fieldName":"checked"},{"name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label, which also names the radio. Always set it.","fieldName":"label"},{"name":"name","type":{"text":"string"},"default":"\"\"","description":"A name for your own grouping. Radios in separate elements don't form a native group, so use `oh-radio-group` for a set.","fieldName":"name"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"This radio's value, sent with `oh-change`.","fieldName":"value"},{"name":"error-text","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","fieldName":"errorText"},{"name":"force-state","type":{"text":"RadioState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'focus'","fieldName":"forceState"}],"members":[{"kind":"field","name":"checked","type":{"text":"boolean"},"default":"false","description":"Whether this radio is chosen.","attribute":"checked","reflects":true},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label, which also names the radio. Always set it.","attribute":"label"},{"kind":"field","name":"name","type":{"text":"string"},"default":"\"\"","description":"A name for your own grouping. Radios in separate elements don't form a native group, so use `oh-radio-group` for a set.","attribute":"name"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"This radio's value, sent with `oh-change`.","attribute":"value"},{"kind":"field","name":"errorText","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","attribute":"error-text"},{"kind":"field","name":"forceState","type":{"text":"RadioState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'focus'","attribute":"force-state","reflects":true}],"events":[{"description":"The radio was checked. detail: { checked, value }","name":"oh-change"}],"cssParts":[{"description":"The drawn radio circle","name":"circle"},{"description":"The label text","name":"label"},{"description":"The error message","name":"error"}],"released":null},{"tagName":"oh-select","pkg":"@orange-halo/components","description":"A dropdown for choosing one option from a list.\n\n**Use it for** one choice from a list too long to show every option.\n**Don't use it for** a few options (use `oh-radio-group`, which shows them\nall), several choices (use `oh-checkbox-group`) or free text (use\n`oh-input` with `suggestions`).\n\n**Parts:** a trigger showing the selected option's label (or\n`placeholder`), and a list of `options` (`{ label, value }`). One size.\n**States:** rest, hover, active, focus, open, error (set `error-text`),\nrequired, disabled.\n\n**Behaviour:** click the trigger, or press Enter, Space or an arrow key,\nto open the list. Arrow keys, Home and End move the highlight, Enter or\nSpace selects, Escape and Tab close, and clicking outside closes. Typing\nletters jumps to a matching option (and selects it while the list is\nclosed). Selecting sets `value`, returns focus to the trigger and fires\n`oh-change`. In a native `<form>` it submits `value` under `name` (nothing\nwhile no option is chosen), `required` blocks submitting with no option\nchosen, reset restores the starting value, and `disabled` (or a disabled\n`<fieldset>` around it) takes it out of the tab order and the form.\n\n**Accessibility:** the trigger is a `combobox` controlling a `listbox`,\nwith `aria-activedescendant` for the highlighted option, so focus stays\non the trigger. Always set `label`: it names the trigger and the list.\nThe error shows after the label and before the trigger, with an icon, sets\n`aria-invalid` and is linked with `aria-describedby`; it's announced\n(`role=\"alert\"`) only when it appears after first render. Focus is a\nsolid underline on the trigger text.\n\n**Look:** set by tokens — `color.surface.field` (trigger fill),\n`stroke.control` in `color.border.emphasis` (border), `shape.control` (trigger corners), `shape.container` (list\ncorners), `typography.control.*` (type), `elevation.offset.*` and\n`elevation.color.secondary` (shadow), `lift.hoverMd` / `lift.activeSm` (movement\non hover and press), `color.border.hover` (hover), `focus.ringColor` and\n`color.surface.highlight` (open), `color.surface.hover` and\n`color.brand.primary` (selected option), `color.feedback.error` and\n`elevation.color.error` (error). The open list is at most\n`select.base.listMaxHeight` tall and scrolls beyond it; it slides\ndown `select.base.listEnterOffset` as it opens.","attributes":[{"name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label, which names the trigger and the list. Always set it.","fieldName":"label"},{"name":"placeholder","type":{"text":"string"},"default":"\"Select an option\"","description":"Shown on the trigger while no option is chosen.","fieldName":"placeholder"},{"name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name the chosen value is submitted under.","fieldName":"name"},{"name":"options","type":{"text":"SelectOption[]"},"default":"[]","description":"The choices, as `{ label, value }` objects. Set it as a property, or as JSON in the attribute.","fieldName":"options"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"The chosen option's value (empty for none). Updated when the user selects.","fieldName":"value"},{"name":"required","type":{"text":"boolean"},"default":"false","description":"An option must be chosen: marks the label and blocks a native form from submitting while none is.","fieldName":"required"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","fieldName":"disabled"},{"name":"helper-text","type":{"text":"string"},"default":"\"\"","description":"Help shown under the field and linked to it with `aria-describedby`.","fieldName":"helperText"},{"name":"error-text","type":{"text":"string"},"default":"\"\"","description":"An error message. Setting it is the error state: it shows after the label, sets `aria-invalid` and is linked to the trigger.","fieldName":"errorText"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label, which names the trigger and the list. Always set it.","attribute":"label"},{"kind":"field","name":"placeholder","type":{"text":"string"},"default":"\"Select an option\"","description":"Shown on the trigger while no option is chosen.","attribute":"placeholder"},{"kind":"field","name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name the chosen value is submitted under.","attribute":"name"},{"kind":"field","name":"options","type":{"text":"SelectOption[]"},"default":"[]","description":"The choices, as `{ label, value }` objects. Set it as a property, or as JSON in the attribute.","attribute":"options"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"The chosen option's value (empty for none). Updated when the user selects.","attribute":"value"},{"kind":"field","name":"required","type":{"text":"boolean"},"default":"false","description":"An option must be chosen: marks the label and blocks a native form from submitting while none is.","attribute":"required","reflects":true},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","attribute":"disabled","reflects":true},{"kind":"field","name":"helperText","type":{"text":"string"},"default":"\"\"","description":"Help shown under the field and linked to it with `aria-describedby`.","attribute":"helper-text"},{"kind":"field","name":"errorText","type":{"text":"string"},"default":"\"\"","description":"An error message. Setting it is the error state: it shows after the label, sets `aria-invalid` and is linked to the trigger.","attribute":"error-text"},{"kind":"field","name":"form","description":"The form this select belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}]},{"kind":"method","name":"blur"},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]}],"events":[{"description":"An option was selected. detail: { value }","name":"oh-change"}],"released":null},{"tagName":"oh-skip-link","pkg":"@orange-halo/components","description":"A \"skip to content\" link that lets keyboard users jump past repeated content, such as navigation.\n\n**Use it for** the first focusable element on every page, pointing at the\nmain content. Add more for other landmarks (search results, footer) if\nuseful. **Don't use it for** in-page navigation that everyone sees (use\n`oh-link`).\n\n**Parts:** `href` is the target (defaults to `#main`); `text` is the label\n(defaults to \"Skip to main content\").\n\n**Behaviour:** hidden until it receives keyboard focus, then shown fixed at\nthe top-left of the viewport, above other content. Enter follows the link.\nTransitions are cut short under `prefers-reduced-motion`.\n\n**Accessibility:** screen readers can read it at all times. Put it first in\nthe page, and give the target an `id` and `tabindex=\"-1\"` so focus moves to\nit.\n\n**Look:** set by tokens — `color.surface.base`, `color.border.emphasis` and\n`color.text.link` at rest; `color.surface.container`, `color.text.linkOnContainer`\nand `color.brand.primary` (border) on focus; `stroke.control` the border,\n`shape.control` the corners; `elevation.offset.lg` with `elevation.color.neutral`\n(`elevation.color.primary` on focus) the shadow; `typography.body.*` and\n`typography.label.base.fontWeight` the text; `spacing.*` the padding and\nposition; `motion.gentle`, `motion.quick` and `motion.snappy` the\ntransitions.","attributes":[{"name":"href","type":{"text":"string"},"default":"\"#main\"","description":"The target to jump to, usually the main content's `id`.","fieldName":"href"},{"name":"text","type":{"text":"string"},"default":"\"Skip to main content\"","description":"The link's text.","fieldName":"text"}],"members":[{"kind":"field","name":"href","type":{"text":"string"},"default":"\"#main\"","description":"The target to jump to, usually the main content's `id`.","attribute":"href"},{"kind":"field","name":"text","type":{"text":"string"},"default":"\"Skip to main content\"","description":"The link's text.","attribute":"text"}],"released":null},{"tagName":"oh-stack","pkg":"@orange-halo/components","description":"A vertical layout that spaces its children evenly, top to bottom.\n\n**Use it for** consistent vertical rhythm without margins on children.\n**Don't use it for** items in a row (use `oh-cluster`) or a grid of cards\n(use `oh-grid`).\n\n**Gaps:** `gap` is `none`, `xs` (`spacing.1`), `sm` (`spacing.2`), `md`\n(default, `spacing.4`), `lg` (`spacing.6`), `xl` (`spacing.8`) or `2xl`\n(`spacing.12`). `align` sets horizontal alignment: `start`, `center`,\n`end` or `stretch` (default). It places the children; it doesn't change\nhow the text inside them is aligned.","attributes":[{"name":"gap","type":{"text":"StackGap"},"default":"\"md\"","description":"The space between children: `none`, `xs`, `sm`, `md` (default), `lg`, `xl` or `2xl`, from the `spacing` scale.","fieldName":"gap"},{"name":"align","type":{"text":"StackAlign"},"default":"\"stretch\"","description":"Horizontal alignment of the children: `start`, `center`, `end` or `stretch` (default).","fieldName":"align"}],"members":[{"kind":"field","name":"gap","type":{"text":"StackGap"},"default":"\"md\"","description":"The space between children: `none`, `xs`, `sm`, `md` (default), `lg`, `xl` or `2xl`, from the `spacing` scale.","attribute":"gap","reflects":true},{"kind":"field","name":"align","type":{"text":"StackAlign"},"default":"\"stretch\"","description":"Horizontal alignment of the children: `start`, `center`, `end` or `stretch` (default).","attribute":"align","reflects":true}],"slots":[{"description":"The items to stack.","name":""}],"released":null},{"tagName":"oh-table","pkg":"@orange-halo/components","description":"A data table: the styles and scrolling for a native `<table>` you write inside it.\n\n**Use it for** data people compare across rows and columns: figures by month, a list of records with several attributes. **Don't use it for** layout; a list of single items (use a list); or label-and-value pairs (use a description list, `<dl>`).\n\n**Parts:** the default slot holds one `<table>`, written as normal HTML: a `<caption>` that names it, `<thead>` with `<th scope=\"col\">` headers, `<tbody>`, and an optional `<tfoot>` for totals. Use `<th scope=\"row\">` for the cell that names its row. Cells can hold anything, including links, badges and buttons. Put `data-align=\"end\"` on the header and cells of a column of numbers so the digits line up; figures are tabular throughout. Show an empty result as one row with a cell spanning every column (`colspan`) that says there's nothing to show.\n\n**Density:** `default`, or `compact` for long tables or tight spaces. Density changes the cell padding, not the text size.\n\n**Behaviour:** none of its own: no sorting, selection or sticky header. The table is as wide as its content. Column headers and end-aligned cells stay on one line; other cells wrap. When it's wider than its container it scrolls sideways, and the element becomes a focusable region named by the caption, so keyboard users can scroll it with the arrow keys.\n\n**Accessibility:** always give the table a `<caption>` (visually hidden if a heading already names it), or failing that `aria-label` on the `<table>`, which `accessible-label` sets for you. Use `<th>` with `scope` for every header; never use the table for layout.\n\n**Look:** set by tokens. `typography.body.base.*` sets the cell text and `typography.label.*` the caption and header weight; `color.text.secondary` the column headers; `stroke.divider` with `color.border.divider` the row lines, and with `color.border.emphasis` the lines under the headers and above the totals; `spacing.*` the cell padding. The focus outline (when it scrolls) is `focus.ringColor`.","attributes":[{"name":"density","type":{"text":"TableDensity"},"default":"\"default\"","description":"`default`, or `compact` for long tables or tight spaces.","fieldName":"density"},{"name":"accessible-label","type":{"text":"string | undefined"},"description":"Names the table for assistive tech when it has no `<caption>`: set as the table's `aria-label`.","fieldName":"accessibleLabel"}],"members":[{"kind":"field","name":"density","type":{"text":"TableDensity"},"default":"\"default\"","description":"`default`, or `compact` for long tables or tight spaces.","attribute":"density","reflects":true},{"kind":"field","name":"accessibleLabel","type":{"text":"string | undefined"},"description":"Names the table for assistive tech when it has no `<caption>`: set as the table's `aria-label`.","attribute":"accessible-label"}],"slots":[{"description":"One native `<table>`, with a `<caption>`.","name":""}],"cssParts":[{"description":"The wrapper around the slotted table.","name":"table"}],"released":null},{"tagName":"oh-tabs","pkg":"@orange-halo/components","description":"A set of tabs that switches between panels of related content in the same place.\n\n**Use it for** a few peer sections of content where only one needs to be\nseen at a time. **Don't use it for** navigating between pages (use links\nor `oh-navbar`), or for content people need to compare side by side.\n\n**Parts:** pass `items`, an array of `{ id, label, content? }`. A panel\nshows `content` as text, or else the light-DOM element with\n`slot=\"<id>\"`. `value` is the selected tab's `id` (defaults to the first).\n\n**States:** each tab is selected or not; unselected tabs show an underline\non hover.\n\n**Behaviour:** click selects a tab. Arrow keys move focus between tabs and\nwrap (Left/Right, swapped in right-to-left text, or Up/Down when\n`orientation=\"vertical\"`; orientation changes the keys only, not the\nlayout); Home/End jump to the first/last.\nEnter or Space selects the focused tab and moves focus to its panel.\nSelecting a different tab fires `oh-change`. Transitions are cut short\nunder `prefers-reduced-motion`.\n\n**Narrow screens:** tabs take less padding in a narrow space, and when they still don't fit (many tabs, or large text) the tab row scrolls sideways on its own, so the page doesn't, with an arrow button at each end that has more tabs to show. Keyboard users move with the arrow keys, which bring the focused tab into view, so the scroll buttons stay out of the Tab order.\n\n**Accessibility:** tablist/tab/tabpanel roles with `aria-selected`,\n`aria-controls` and `aria-labelledby`; one tab is in the tab order at a\ntime; inactive panels are `hidden`; the active panel is focusable. Keyboard\nfocus shows a solid underline on the tab label and an outline on the panel.\nKeep labels short.\n\n**Look:** set by tokens — `color.brand.primary` the unselected tabs and\ntheir hover underline (`decoration.underlineThickness`,\n`decoration.underlineDash`, `decoration.underlinePeriod`);\n`color.text.primary`, `color.surface.base` and `color.border.emphasis` the\nselected tab and panel; `stroke.control` the borders; `shape.control` the\ntab corners and `shape.container` the panel corners;\n`typography.body.*` and `typography.label.base.fontWeight` the text;\n`spacing.*` the padding; `motion.snappy` and `motion.relaxed` the\ntransitions.","attributes":[{"name":"items","type":{"text":"TabItem[]"},"default":"[]","description":"The tabs: `{ id, label, content? }`. In HTML, a JSON array","fieldName":"items"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"The selected tab's `id`. Defaults to the first tab","fieldName":"value"},{"name":"orientation","type":{"text":"\"horizontal\" | \"vertical\""},"default":"\"horizontal\"","description":"Orientation of the tabs (affects arrow key behavior)","fieldName":"orientation"}],"members":[{"kind":"field","name":"items","type":{"text":"TabItem[]"},"default":"[]","description":"The tabs: `{ id, label, content? }`. In HTML, a JSON array","attribute":"items"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"The selected tab's `id`. Defaults to the first tab","attribute":"value","reflects":true},{"kind":"field","name":"orientation","type":{"text":"\"horizontal\" | \"vertical\""},"default":"\"horizontal\"","description":"Orientation of the tabs (affects arrow key behavior)","attribute":"orientation"}],"events":[{"description":"When a different tab is selected. `detail: { value }`, the tab's `id`.","name":"oh-change"}],"released":null},{"tagName":"oh-tag","pkg":"@orange-halo/components","description":"A small interactive label: a filter the user turns on and off, or a value\nthey've chosen and can remove.\n\n**Use it for** filters that narrow a list (\"Festivals\", \"2024\"), shown side\nby side, and for the values someone has picked, such as the filters\ncurrently applied, each with a × to remove it. **Don't use it for** a\nlabel nobody acts on, such as a status or category (use `oh-badge`); an\naction (use `oh-button`); a link to another page (use `oh-link`); or one\nsetting in a form (use `oh-checkbox` or `oh-toggle`).\n\n**Kinds:** a filter by default; `removable` for a chosen value. A tag is one\nor the other: a removable tag can't be turned on.\n\n**Size:** the same as `oh-badge`, so the two line up in a row. There's one\nsize.\n\n**Parts:** the default slot holds the text, a word or two; the `icon` slot\nan optional leading icon, sized to the text.\n\n**States:** off, on, hover, active, focus, disabled.\n\n**Behaviour:** a filter tag is one button. Clicking it, or pressing Space or\nEnter while it's focused, flips `checked` and fires `oh-change` with\n`{ checked }`. In a native `<form>`, an \"on\" tag submits `value` (`on` if\nunset) under `name`, like a checkbox, so a row of tags with one `name`\nsubmits every one that's on; reset restores the starting state. A\nremovable tag has one button, the ×: clicking it, or pressing Space or\nEnter on it, fires `oh-remove` with `{ value }`. The tag stays until the\npage removes it, and the page should then move focus to the next tag's ×,\nor to the heading or control before the list when it was the last one,\nbecause the focused button has gone. Pressing Backspace or Delete on the ×\ndoes the same as clicking it. `disabled` (or a disabled `<fieldset>`\naround it) takes it out of the tab order and the form; a disabled removable\ntag still shows its text normally, and only the × can't be used.\n\n**Accessibility:** a filter tag is a `<button>` with `aria-pressed`, named\nby its text. A removable tag's text is plain, and its × is a `<button>`\nnamed \"Remove\" and the text (\"Remove Festivals\"); set `remove-label` to\ntranslate \"Remove\". On, a filter tag shows a check mark as well as its\ncolour. Group a row of tags under a visible heading or a `<fieldset>` and\n`<legend>` that says what they filter. Focus is a solid outline in\n`focus.ringColor`.\n\n**Look:** set by tokens. `shape.compact` sets the corners;\n`typography.body.*`, `typography.label.base.fontWeight` and\n`typography.control.letterSpacing` the text; `spacing.1` and\n`spacing.2-5` the padding, as on `oh-badge`. Off: `color.surface.base`,\n`color.text.primary`, and a `stroke.control` frame in\n`color.border.emphasis` (`color.surface.hover` and `color.border.hover` on\nhover). On: `color.brand.primary` (`color.brand.primaryHover` on hover)\nwith `color.text.onBrand`, inside the same frame. The × takes `color.surface.hoverTint` on hover.\nFocus: `focus.ringColor`, `focus.ringWidth` and `focus.ringOffset`.\nDisabled: `color.surface.disabled`, `color.border.disabled` and\n`color.text.disabled` on a filter tag; a removable tag keeps its text and\nonly its × takes `color.text.disabled`, as the value is still chosen.","attributes":[{"name":"checked","type":{"text":"boolean"},"default":"false","description":"A filter tag: whether it's on. Ignored on a removable tag","fieldName":"checked"},{"name":"removable","type":{"text":"boolean"},"default":"false","description":"A chosen value with a × that fires `oh-remove`, instead of a filter","fieldName":"removable"},{"name":"remove-label","type":{"text":"string"},"default":"\"Remove\"","description":"The word before the text in the ×'s name (\"Remove Festivals\"). Set it to translate \"Remove\"","fieldName":"removeLabel"},{"name":"name","type":{"text":"string | undefined"},"description":"Name for form submission (filter tags)","fieldName":"name"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"Submitted when a filter tag is on (`on` if unset), and sent with `oh-remove`","fieldName":"value"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","fieldName":"disabled"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"checked","type":{"text":"boolean"},"default":"false","description":"A filter tag: whether it's on. Ignored on a removable tag","attribute":"checked","reflects":true},{"kind":"field","name":"removable","type":{"text":"boolean"},"default":"false","description":"A chosen value with a × that fires `oh-remove`, instead of a filter","attribute":"removable","reflects":true},{"kind":"field","name":"removeLabel","type":{"text":"string"},"default":"\"Remove\"","description":"The word before the text in the ×'s name (\"Remove Festivals\"). Set it to translate \"Remove\"","attribute":"remove-label"},{"kind":"field","name":"name","type":{"text":"string | undefined"},"description":"Name for form submission (filter tags)","attribute":"name"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"Submitted when a filter tag is on (`on` if unset), and sent with `oh-remove`","attribute":"value"},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","attribute":"disabled","reflects":true},{"kind":"field","name":"form","description":"The form this tag belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}],"description":"Focuses the tag's button: the tag, or a removable tag's ×"},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]}],"events":[{"description":"A filter tag was turned on or off. detail: { checked }","name":"oh-change"},{"description":"A removable tag's × was pressed. detail: { value }","name":"oh-remove"}],"slots":[{"description":"The tag text.","name":""},{"description":"Optional leading icon. Mark it `aria-hidden`.","name":"icon"}],"cssParts":[{"description":"The tag: the button, or the frame round a removable tag.","name":"tag"},{"description":"A removable tag's × button.","name":"remove"}],"released":null},{"tagName":"oh-textarea","pkg":"@orange-halo/components","description":"A multi-line text field that submits with a native form.\n\n**Use it for** messages, comments, feedback: text that may run to several\nlines. **Don't use it for** a single line of text (use `oh-input`).\n\n**States:** rest, hover, focus, error (set `error-text`), disabled,\nrequired. `rows` sets the visible lines (default 4); people can drag it\ntaller. `maxlength` limits the length.\n\n**Behaviour:** form-associated. Give it a `name` and it submits with the\nform. `required` stops the form submitting while it's empty, with the\nbrowser's own message. A form reset restores its starting text, and a\ndisabled `<fieldset>` disables it. Fires `oh-input` on every keystroke and\n`oh-change` when the value is committed. Its line height is 1.5 times the\ntext size, rounded up to `grid.unit`, so long messages stay on the grid.\n\n**Accessibility:** always set `label`: it names the field. A placeholder\nisn't a label. Helper and error text are linked to the field with\n`aria-describedby`, so screen readers read them. Errors come before the\nfield, with an icon, set `aria-invalid`, and are announced only when they\nappear after the page has loaded. Focus is a solid inset ring. Use\n`autocomplete` when the field asks for something a browser can fill in,\nsuch as an address (WCAG 1.3.5).\n\n**Look:** set by tokens — `color.surface.field` (fill), `stroke.control` in\n`color.border.emphasis` (border), `shape.control` (corners), `typography.control.*` (type),\n`elevation.offset.md` and `elevation.color.field` (inset shadow),\n`color.border.hover` (hover), `focus.ringColor` and\n`color.surface.highlight` (focus), `color.feedback.error`,\n`color.feedback.errorSubtle` and `elevation.color.error` (error),\n`color.feedback.errorHover` (error hover),\n`color.surface.disabled`, `color.border.disabled` and\n`color.text.disabled` (disabled).","attributes":[{"name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label. Always set one: it names the field.","fieldName":"label"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"The text in the field","fieldName":"value"},{"name":"placeholder","type":{"text":"string"},"default":"\"\"","description":"Example text shown while the field is empty. Not a replacement for the label","fieldName":"placeholder"},{"name":"helper-text","type":{"text":"string"},"default":"\"\"","description":"Help shown under the field and linked to it","fieldName":"helperText"},{"name":"error-text","type":{"text":"string"},"default":"\"\"","description":"Error shown before the field and linked to it. Setting it puts the field in its error state","fieldName":"errorText"},{"name":"name","type":{"text":"string"},"default":"\"\"","description":"The name the value is submitted under","fieldName":"name"},{"name":"required","type":{"text":"boolean"},"default":"false","description":"Must be filled in before the form submits","fieldName":"required"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not editable, and left out of the form's data","fieldName":"disabled"},{"name":"rows","type":{"text":"number"},"default":"4","description":"Visible lines of text before the field scrolls (people can drag it taller)","fieldName":"rows"},{"name":"maxlength","type":{"text":"number | undefined"},"description":"Longest allowed text, in characters","fieldName":"maxlength"},{"name":"autocomplete","type":{"text":"string | undefined"},"description":"The field's purpose for autofill and assistive tech (WCAG 1.3.5), e.g. \"street-address\"","fieldName":"autocomplete"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label. Always set one: it names the field.","attribute":"label"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"The text in the field","attribute":"value"},{"kind":"field","name":"placeholder","type":{"text":"string"},"default":"\"\"","description":"Example text shown while the field is empty. Not a replacement for the label","attribute":"placeholder"},{"kind":"field","name":"helperText","type":{"text":"string"},"default":"\"\"","description":"Help shown under the field and linked to it","attribute":"helper-text"},{"kind":"field","name":"errorText","type":{"text":"string"},"default":"\"\"","description":"Error shown before the field and linked to it. Setting it puts the field in its error state","attribute":"error-text"},{"kind":"field","name":"name","type":{"text":"string"},"default":"\"\"","description":"The name the value is submitted under","attribute":"name","reflects":true},{"kind":"field","name":"required","type":{"text":"boolean"},"default":"false","description":"Must be filled in before the form submits","attribute":"required","reflects":true},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not editable, and left out of the form's data","attribute":"disabled","reflects":true},{"kind":"field","name":"rows","type":{"text":"number"},"default":"4","description":"Visible lines of text before the field scrolls (people can drag it taller)","attribute":"rows"},{"kind":"field","name":"maxlength","type":{"text":"number | undefined"},"description":"Longest allowed text, in characters","attribute":"maxlength"},{"kind":"field","name":"autocomplete","type":{"text":"string | undefined"},"description":"The field's purpose for autofill and assistive tech (WCAG 1.3.5), e.g. \"street-address\"","attribute":"autocomplete"},{"kind":"field","name":"form","description":"The form this field belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}]},{"kind":"method","name":"blur"},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]}],"events":[{"description":"On every keystroke. detail: { value, originalEvent }","name":"oh-input"},{"description":"When the value is committed (on blur). detail: { value, originalEvent }","name":"oh-change"}],"cssParts":[{"description":"The visible label","name":"label"},{"description":"The text field","name":"textarea"},{"description":"The helper text","name":"helper"},{"description":"The error message","name":"error"}],"released":null},{"tagName":"oh-timeline","pkg":"@orange-halo/components","description":"A dated list: entries under group headings, each a date beside what happened, with markers and notes between groups.\n\n**Use it for** things that happened, or will, in order: a history of events, a CV's jobs and education, a changelog, an order's progress written as a list. **Don't use it for** data compared across columns (use `oh-table`); facts about one thing (use `oh-description-list`); or steps someone works through (a stepper, which OHDS doesn't have yet).\n\n**Parts:** everything is normal HTML inside the element.\n- A **group** is a heading (`<h2>`–`<h6>`: a year, \"Upcoming\", \"Experience\") followed by an `<ol>` (or `<ul>`) of entries. A `<small>` inside the heading holds a count or note (\"12 gigs\").\n- An **entry** is an `<li>`. Its first child is the **date**: a `<time datetime>`, or a `<p>` holding a range (`<time>2019</time> – <time>2023</time>`). Its second child holds **what happened**: a heading (`<h3>`–`<h6>`) and paragraphs; give a paragraph `data-meta` to set it in the secondary colour (a place, a type). An optional element with `data-aside` holds **badges or actions** at the end of the row.\n- A **marker** (`<p data-marker>`) is a line across the list with a label, such as \"Today\" between upcoming and past events, or \"Now\" in a CV.\n- A **note** (`<p data-note>`) is a short line between groups, such as \"No gigs in 2016\" or \"Career break\".\n\n**Options:** `sticky-headings` keeps each group heading in view while its entries scroll past (on `color.surface.base`, so use it on that surface).\n\n**Layout:** the date sits in a column (`timeline.base.dateWidth`) beside what happened, with the aside at the end. In a narrow space (under 30em, or with large text) the date sits above what happened and the aside below it. Long words break rather than widening the page.\n\n**Behaviour:** none of its own: it styles the markup and adds no roles or focus stops. To bring someone to an entry (from a link or a dialog), give the `<li>` `tabindex=\"-1\"` and focus it: it shows the focus ring until focus moves on.\n\n**Accessibility:** the headings let screen-reader users move between groups, each list announces how many entries it has, and `<time datetime>` gives each date a machine-readable value. Use heading levels that fit the page's outline, one level below the group headings for entry titles. Write the date as it should be read (\"Sat 15 Nov 2026\", not \"15/11\").\n\n**Look:** set by tokens. `typography.heading.h3.*` the group headings and `typography.heading.h4.*` entry titles; `typography.label.sm.*` and `color.text.secondary` the dates, counts and markers; `typography.body.sm.*` the details; `stroke.divider` with `color.border.divider` the lines between entries; `stroke.control` with `color.text.primary` the marker's line; `spacing.*` the gaps; `timeline.base.dateWidth` the date column; `focus.ring*` an entry brought into focus.","attributes":[{"name":"sticky-headings","type":{"text":"boolean"},"default":"false","description":"Keeps each group heading in view while its entries scroll past.","fieldName":"stickyHeadings"}],"members":[{"kind":"field","name":"stickyHeadings","type":{"text":"boolean"},"default":"false","description":"Keeps each group heading in view while its entries scroll past.","attribute":"sticky-headings","reflects":true}],"slots":[{"description":"Group headings, lists of entries, markers and notes, as normal HTML.","name":""}],"released":null},{"tagName":"oh-toggle","pkg":"@orange-halo/components","description":"A switch that turns a setting on or off.\n\n**Use it for** a setting that takes effect straight away, such as turning\nnotifications on, or an on/off setting in a settings form. **Don't use it\nfor** something that must be agreed to (use `oh-checkbox`), or a choice\nbetween more than two options (use `oh-radio-group`).\n\n**States:** off, on, hover, active, focus, disabled.\n\n**Behaviour:** clicking the switch or its label, or pressing Space or\nEnter while it's focused, flips `checked` and fires `oh-change` with\n`{ checked }`. In a native `<form>`, an \"on\" toggle submits `value` (`on`\nif unset) under `name`, like a checkbox; reset restores the starting\nstate, and `disabled` (or a disabled `<fieldset>` around it) takes it out\nof the tab order and the form. Under `prefers-reduced-motion` it doesn't\nanimate.\n\n**Accessibility:** `role=\"switch\"` with `aria-checked`, in the tab order.\nDisabled, it has `aria-disabled=\"true\"` and leaves the tab order.\nSet `label` (a visible label, linked with `aria-labelledby`), or\n`accessible-label` when there's no visible label (not `aria-label`, which\nisn't forwarded into the shadow root). Focus is a solid outline in\n`focus.ringColor`.\n\n**Look:** set by tokens — `shape.pill` (track), `color.surface.container` /\n`color.brand.primary` (track off / on), `color.surface.base`,\n`stroke.control` and `color.border.emphasis` (thumb),\n`elevation.offset.*` with `elevation.color.secondary` / `elevation.color.primary` (thumb\nshadow off / on), `lift.hoverSm` / `lift.activeSm` (movement on hover and\npress), `focus.ringColor` and `focus.decorationColor` (focus),\n`typography.body.*` (label), `color.surface.disabled`,\n`color.border.disabled` and `color.text.disabled` (disabled).","attributes":[{"name":"checked","type":{"text":"boolean"},"default":"false","description":"Whether the toggle is checked/on","fieldName":"checked"},{"name":"label","type":{"text":"string | undefined"},"description":"Label text displayed next to the toggle","fieldName":"label"},{"name":"accessible-label","type":{"text":"string | undefined"},"description":"Accessible name when there's no visible label. Use this, not aria-label:\nan aria-label on the host isn't forwarded into the shadow root.","fieldName":"accessibleLabel"},{"name":"name","type":{"text":"string | undefined"},"description":"Name for form submission","fieldName":"name"},{"name":"value","type":{"text":"string"},"default":"\"on\"","description":"Value for form submission","fieldName":"value"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","fieldName":"disabled"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"checked","type":{"text":"boolean"},"default":"false","description":"Whether the toggle is checked/on","attribute":"checked","reflects":true},{"kind":"field","name":"label","type":{"text":"string | undefined"},"description":"Label text displayed next to the toggle","attribute":"label"},{"kind":"field","name":"accessibleLabel","type":{"text":"string | undefined"},"description":"Accessible name when there's no visible label. Use this, not aria-label:\nan aria-label on the host isn't forwarded into the shadow root.","attribute":"accessible-label"},{"kind":"field","name":"name","type":{"text":"string | undefined"},"description":"Name for form submission","attribute":"name"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"on\"","description":"Value for form submission","attribute":"value"},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","attribute":"disabled","reflects":true},{"kind":"field","name":"form","description":"The form this toggle belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}]},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]}],"events":[{"name":"oh-change","type":{"text":"CustomEvent"},"description":"Fired when the toggle state changes. detail: { checked }"}],"released":null},{"tagName":"oh-hero","pkg":"@orange-halo/brand-orange-halo","description":"The banner at the top of an Orange Halo page: a heading on the brand\ncolour, with a subtitle and actions, or a journey's name, step and progress.\n\n**Use it for** the top of an Orange Halo page, once. **Don't use it for**\na section further down the page (use headings and `oh-card`), or in\nanother brand: it's an Orange Halo brand pattern.\n\n**Parts:** `heading` is the page's `<h1>`. `content` (default) adds\n`subtitle` and the default slot for actions: the main action an\n`oh-button variant=\"secondary\"`, further ones `oh-link variant=\"standalone\"\ninverse`. `journey` shows `journey-name` above the heading and an inverse\n`oh-progress` for `current-step` of `total-steps`; the default slot sits\nunder it.\n\n**Accessibility:** the heading is the page's only `<h1>`. The hero isn't a\nlandmark: put it inside `<header>` or `<main>` as the page needs.\n\n**Look:** `color.brand.primary` background with `color.text.onBrand` text;\n`layout.container.*` (from `size`) sets the content width.","attributes":[{"name":"variant","type":{"text":"HeroVariant"},"default":"\"content\"","description":"`content` (default): a heading, subtitle and actions slot. `journey`: a journey name, the page heading and a progress bar for a multi-step flow.","fieldName":"variant"},{"name":"size","type":{"text":"HeroSize"},"default":"\"lg\"","description":"The content's maximum width: `sm`, `md`, `lg` (default) or `xl`, from `layout.container.*`.","fieldName":"size"},{"name":"heading","type":{"text":"string"},"default":"\"\"","description":"The page heading, rendered as the page's `h1`.","fieldName":"heading"},{"name":"subtitle","type":{"text":"string"},"default":"\"\"","description":"A line under the heading (`content` variant only).","fieldName":"subtitle"},{"name":"journey-name","type":{"text":"string"},"default":"\"\"","description":"The journey's name, shown above the page heading (`journey` variant only).","fieldName":"journeyName"},{"name":"current-step","type":{"text":"number"},"default":"1","description":"The step the user is on, for the progress bar (`journey` variant only).","fieldName":"currentStep"},{"name":"total-steps","type":{"text":"number"},"default":"1","description":"How many steps the journey has (`journey` variant only).","fieldName":"totalSteps"}],"members":[{"kind":"field","name":"variant","type":{"text":"HeroVariant"},"default":"\"content\"","description":"`content` (default): a heading, subtitle and actions slot. `journey`: a journey name, the page heading and a progress bar for a multi-step flow.","attribute":"variant","reflects":true},{"kind":"field","name":"size","type":{"text":"HeroSize"},"default":"\"lg\"","description":"The content's maximum width: `sm`, `md`, `lg` (default) or `xl`, from `layout.container.*`.","attribute":"size","reflects":true},{"kind":"field","name":"heading","type":{"text":"string"},"default":"\"\"","description":"The page heading, rendered as the page's `h1`.","attribute":"heading"},{"kind":"field","name":"subtitle","type":{"text":"string"},"default":"\"\"","description":"A line under the heading (`content` variant only).","attribute":"subtitle"},{"kind":"field","name":"journeyName","type":{"text":"string"},"default":"\"\"","description":"The journey's name, shown above the page heading (`journey` variant only).","attribute":"journey-name"},{"kind":"field","name":"currentStep","type":{"text":"number"},"default":"1","description":"The step the user is on, for the progress bar (`journey` variant only).","attribute":"current-step"},{"kind":"field","name":"totalSteps","type":{"text":"number"},"default":"1","description":"How many steps the journey has (`journey` variant only).","attribute":"total-steps"}],"slots":[{"description":"Actions (content), or anything under the progress bar (journey).","name":""}],"released":null}],"apiValues":{"oh-accordion":{"variant":["standout","subtle"]},"oh-alert":{"variant":["error","info","success","warning"]},"oh-badge":{"variant":["accent","brand","error","info","success","warning"],"appearance":["filled","subtle"],"size":["lg","md"]},"oh-button":{"variant":["accent","primary","secondary"],"size":["lg","md","sm"],"force-state":["active","default","focus","hover"]},"oh-card":{"variant":["default","featured","subtle"],"padding":["lg","md","none","sm"]},"oh-chart":{"type":["bar","column","donut","dot","line"],"size":["md","sm"]},"oh-checkbox":{"force-state":["default","focus","hover"]},"oh-cluster":{"gap":["lg","md","none","sm","xl","xs"],"justify":["around","between","center","end","start"],"align":["baseline","center","end","start"]},"oh-container":{"size":["full","lg","md","sm","xl"]},"oh-description-list":{"layout":["grid","rows"],"value-size":["lg","md"]},"oh-drawer":{"position":["end","left","right","start"]},"oh-grid":{"columns":["1","2","3","4","auto-fill","auto-fit"],"gap":["lg","md","none","sm","xl","xs"],"align-items":["center","end","start","stretch"]},"oh-hero":{"variant":["content","journey"],"size":["lg","md","sm","xl"]},"oh-icon":{"name":["arrow-down","arrow-left","arrow-right","arrow-up","check","chevron-down","chevron-left","chevron-right","chevron-up","close","email","error","external-link","facebook","github","heart","image","info","instagram","linkedin","list","menu","minus","plus","search","settings","sparkle","substack","success","twitter","warning","youtube"],"size":["lg","md","sm","xl"]},"oh-input":{"type":["email","password","search","tel","text","url"],"force-state":["default","focus","hover"]},"oh-link":{"variant":["inline","standalone"]},"oh-modal":{"size":["lg","md","sm","xl"]},"oh-progress":{"size":["lg","md","sm"],"variant":["brand","error","info","success","warning"]},"oh-radio":{"force-state":["default","focus","hover"]},"oh-stack":{"gap":["2xl","lg","md","none","sm","xl","xs"],"align":["center","end","start","stretch"]},"oh-table":{"density":["compact","default"]},"oh-tabs":{"orientation":["horizontal","vertical"]}},"llms":"# Orange Halo Design System (OHDS)\n\n> Accessible web components (Lit) and W3C DTCG design tokens, shared by several brands: `orange-halo` (Orange Halo), `hoodlum` (Hoodlum). The components, their behaviour and the token roles are the same in every brand; each brand's tokens set its look. Generated from the code by `scripts/build-ai-index.mjs`; don't edit by hand.\n\n## Use it\n\n- Install: `pnpm add @orange-halo/tokens @orange-halo/components`\n- Load one brand's tokens, once, on the page: `import \"@orange-halo/tokens/brands/<brand>.css\"` (`orange-halo`, `hoodlum`). Dark theme: also `brands/<brand>-dark.css`, and `data-theme=\"dark\"` on `<html>`.\n- Register the components: `import \"@orange-halo/components\"` (or one: `@orange-halo/components/oh-button.js`).\n- No build step (a plain HTML page): load both from jsDelivr, which bundles the components' dependencies: `<link rel=\"stylesheet\" href=\"https://cdn.jsdelivr.net/npm/@orange-halo/tokens@4/dist/brands/<brand>.css\">` and `<script type=\"module\">import \"https://cdn.jsdelivr.net/npm/@orange-halo/components@4/+esm\";</script>`.\n- orange-halo brand patterns: `import \"@orange-halo/brand-orange-halo\"`\n- Style your own layout with tier 2 tokens only (the list below), never a brand's palette: `var(--oh-color-surface-container)`, `var(--oh-spacing-4)`.\n- Docs (every component, in every brand): https://orangehalo.co.uk/ohds/\n- Full API, machine-readable: `@orange-halo/components/custom-elements.json`, `@orange-halo/brand-orange-halo/custom-elements.json`\n- For AI assistants: the MCP server `npx -y @orange-halo/mcp` answers the same questions on demand (components, tokens with each brand's value, rules and recipes)\n\n## Rules that matter when using it\n\n- Every form control takes `label` (its visible name). With no visible label, use `accessible-label`, not `aria-label` (it isn't forwarded into the shadow root).\n- Errors: set `error-text`; it puts the control in its error state and is announced. Help: `helper-text`.\n- Attributes are kebab case. Events start with `oh-`; a value change is `oh-change` with `detail.value` (or `detail.checked`).\n- Arrays and objects (`options`, `items`, `suggestions`) are properties; in plain HTML, pass JSON in the attribute.\n- No hex colours or pixel values in your CSS: use the tokens.\n\n## Text, headings and layout\n\nThere's no text component: style headings and paragraphs with a typography role's tokens, its size and line height together (that keeps text on the brand's grid):\n\n```css\nh2 {\n font-family: var(--oh-typography-heading-font-family);\n font-size: var(--oh-typography-heading-h2-font-size);\n line-height: var(--oh-typography-heading-h2-line-height);\n font-weight: var(--oh-typography-heading-h2-font-weight);\n letter-spacing: var(--oh-typography-heading-h2-letter-spacing);\n}\np {\n font-family: var(--oh-typography-body-font-family);\n font-size: var(--oh-typography-body-base-font-size);\n line-height: var(--oh-typography-body-base-line-height);\n color: var(--oh-color-text-secondary);\n}\n```\n\n- **Token name to custom property:** dots become hyphens and camelCase becomes kebab case, after `--oh-`: `typography.heading.h2.fontSize` is `--oh-typography-heading-h2-font-size`, `color.text.linkOnContainer` is `--oh-color-text-link-on-container`.\n- **Heading levels follow the page's outline, not the size you want:** pick the level the page needs (don't skip one), then any role's size.\n- **Layout:** `oh-container` (page width), `oh-stack` (vertical), `oh-cluster` (rows that wrap), `oh-grid` (columns). For your own widths and gaps: `--oh-layout-container-sm` … `-xl` and `--oh-spacing-*`.\n- **Text on cards:** `color.text.primary` and `color.text.secondary`; links inside `oh-card` switch to `color.text.linkOnContainer` on their own. These are contrast-checked on card surfaces in every brand (`pnpm check:contrast`).\n\n## Forms\n\n- Every form control submits with a native `<form>` under its `name`: `oh-input`, `oh-textarea`, `oh-select`, `oh-checkbox`, `oh-checkbox-group` (one entry per ticked option), `oh-radio-group`, `oh-toggle` and filter `oh-tag`s (each one that's on). `required` blocks the submit, the form's reset restores starting values, and `disabled` (or a disabled `<fieldset>`) leaves a control out. Use `oh-radio-group`, not single `oh-radio` elements, in a form.\n- `oh-button` doesn't submit a form by itself. Submit from its `oh-click`: `button.addEventListener(\"oh-click\", () => form.requestSubmit())`, then read the values in the form's `submit` handler.\n- Give every control a visible `label`; put a control's error in `error-text` and its help in `helper-text`.\n\n## Components\n\n### <oh-accordion>\n\nCollapsible sections, each with a heading that shows and hides its content. Use one item for a single show/hide section.\n\n**Use it for** content readers scan by heading and open as needed (FAQs, details, a \"Show as table\" section). **Don't use it for** content most readers need (leave it visible); for switching between views of the same thing (use tabs); or for site navigation.\n\n**Parts:** `items` is an array of `{ heading, hiddenText?, open? }` (in HTML, a JSON array). Item N's content is any markup in a child with `slot=\"item-N\"`, such as a paragraph or a table.\n\n- Attributes:\n - `items`: AccordionItem[] — The sections: { heading, hiddenText?, open? }.\n - `variant`: \"standout\" | \"subtle\" = \"subtle\" — subtle (inline) or standout (boxed)\n - `heading-level`: HeadingLevel = 3 — The heading level of each item's trigger, to fit the page's outline\n- Slots:\n - `item-N` — The content of the item at index N (item-0 is the first)\n\n### <oh-alert>\n\nA message box that tells the user about the result of an action or something that needs their attention.\n\n**Use it for** feedback on what just happened (saved, failed) or a notice about the page or account, near the content it's about. **Don't use it for** a short status label (use `oh-badge`); for a field's validation error (use the field's own error message); or for a message that must interrupt the user (use `oh-modal`).\n\n- Attributes:\n - `variant`: \"error\" | \"info\" | \"success\" | \"warning\" = \"info\" — The feedback role: info (default), success, warning or error.\n - `dismissible`: boolean = false — Adds a \"Close\" button after the content; selecting it fires oh-close and hides the alert.\n - `live`: boolean = false — When true, adds role=\"alert\" for screen reader announcement.\n- Events: `oh-close`\n- Slots:\n - `default` — The message. Can include links.\n- Parts: `alert`, `content`, `close`\n\n### <oh-badge>\n\nA short, non-interactive label that shows the status or category of the thing next to it.\n\n**Use it for** a status (\"Delivered\", \"Pending\"), a count or a tag next to the item it describes. **Don't use it for** anything the user can select or remove, such as a filter (use `oh-tag`), or an action (use `oh-button` or a link); or for a message with more than a word or two (use `oh-alert`).\n\n**Parts:** the default slot holds the text; the `icon` slot an optional leading icon, sized to the text.\n\n- Attributes:\n - `variant`: \"accent\" | \"brand\" | \"error\" | \"info\" | \"success\" | \"warning\" = \"brand\" — brand (default) or accent for a category; success, warning, error or info for a status.\n - `appearance`: \"filled\" | \"subtle\" = \"subtle\" — subtle (default) for most badges; filled, the stronger appearance, for the one status that matters most\n - `size`: \"lg\" | \"md\" = \"md\" — md (default); lg, as tall as a small button, for a badge in a row of them\n- Slots:\n - `default` — The badge text.\n - `icon` — Optional leading icon.\n- Parts: `badge`\n\n### <oh-breadcrumb>\n\nA breadcrumb trail showing where the current page sits in the site's hierarchy.\n\n**Use it for** pages two or more levels deep in a hierarchy. **Don't use it for** a site's main navigation (use `oh-navbar`) or for steps in a process.\n\n**Parts:** pass `items`, an array of `{ label, href }`, from the top level down. The last item is the current page and is shown as text, not a link.\n\n- Attributes:\n - `items`: BreadcrumbItem[] — The trail, from the top level down, as { label, href } objects.\n\n### <oh-button>\n\nA button that starts an action, or a link styled as a button when `href` is set.\n\n**Use it for** actions: submitting, saving, opening a dialog, confirming. **Don't use it for** links inside running text (use `oh-link`).\n\n- Attributes:\n - `variant`: \"accent\" | \"primary\" | \"secondary\" = \"primary\" — primary for the main action, secondary for the others, accent for an action in the accent colour role.\n - `size`: \"lg\" | \"md\" | \"sm\" = \"md\" — sm, md (default) or lg: the font size, padding and minimum height.\n - `loading`: boolean = false — Shows a spinner and ignores clicks while an action runs.\n - `icon-only`: boolean = false — A square button showing only its icon.\n - `accessible-label`: string — Accessible name for the inner button/anchor.\n - `href`: string — When provided, renders as an anchor tag instead of a button\n - `target`: string — Target for the link (e.g., \"_blank\" for new tab)\n- Events: `oh-click`\n- Slots:\n - `default` — The label.\n - `icon-left` — An icon before the label.\n - `icon-right` — An icon after the label.\n- Parts: `button`\n\n### <oh-card>\n\nA surface that groups related content (a summary, a teaser, a settings group), with optional header and footer.\n\n**Use it for** a self-contained block of content among others, such as a teaser that links to more detail. **Don't use it for** page layout or spacing alone (use `oh-stack`, `oh-grid`); for a message that needs attention (use `oh-alert`); or for a single action (use `oh-button`).\n\n- Attributes:\n - `variant`: \"default\" | \"featured\" | \"subtle\" = \"default\" — default, featured for the one card that should stand out, or subtle, a quieter card for dense layouts.\n - `padding`: \"lg\" | \"md\" | \"none\" | \"sm\" = \"md\" — The content padding, which the header and footer match: none, sm, md (default) or lg.\n- Slots:\n - `default` — The card's main content.\n - `header` — Optional header, above the content, with a divider below. Not drawn when nothing is slotted.\n - `footer` — Optional footer, below the content, with a divider above (e.g. actions). Not drawn when nothing is slotted.\n- Parts: `card`, `header`, `content`, `footer`\n\n### <oh-chart>\n\nA chart: ranked bars, columns, lines, a donut or dots along a line, with a caption, a takeaway, keyboard access to every point and a table view.\n\n**Use it for** data that's easier to see than to read: amounts compared across categories (`bar`), a few periods side by side (`column`), change over time (`line`), parts of a whole (`donut`), or when things happened, a row per category (`dot`: every gig for each of a few artists, say). **Don't use it for** a few exact numbers (use `oh-description-list` with `value-size=\"lg\"`) or data people look things up in (use `oh-table`). See Foundation / Data visualisation for choosing a chart.\n\n**Parts:** `caption` names the chart; it's required, and the chart warns in the console without it. When a heading right above already names the chart, give `caption` the same words and set `hide-caption`: the caption still names the chart for screen readers but isn't shown twice. `summary` says, in one sentence, what the chart shows (\"March was the busiest month\"); it's recommended when the data has a clear takeaway, and left out (not invented) when it doesn't. Under the plot, a \"Show as table\" section (an `oh-accordion`, its heading at `heading-level`) holds the same data in an `oh-table`, whose first column header is `category-label` (a dot chart's table has a row per dot, with `value-label` and `detail-label` as its other headers); the caption is added to its heading for screen readers, so several charts' tables can be told apart. `hide-table` leaves this section out when the data is already readable as text: the page shows it in a table of its own (two small charts sharing one, say), or the chart is a bar chart, whose every label and value is on screen and in each bar's name. Never set it on another chart without that table.\n\n- Attributes:\n - `type`: \"bar\" | \"column\" | \"donut\" | \"dot\" | \"line\" = \"column\" — bar (horizontal, ranked), column (vertical), line (change over time, up to five series), donut (parts of a whole, up to four) or dot (when things happened, a row per category).\n - `caption`: string — The chart's name.\n - `size`: \"md\" | \"sm\" = \"md\" — md (default) or sm, a shorter plot for a chart beside a short list or a few figures\n - `hide-caption`: boolean = false — Hides the caption on screen (screen readers still use it), for a chart under a heading that already names it\n - `hide-table`: boolean = false — Leaves out the \"Show as table\" section: for a chart whose data the page already shows in a table of its own (several charts sharing one, say), or a bar chart, whose labels and values are all on screen.\n - `summary`: string — One sentence saying what the chart shows.\n - `data`: ChartData = { labels: [], series: [] } — { labels, series }: the categories, and the series of values (one, or up to five for line).\n - `category-label`: string = \"Category\" — The table view's header for the categories column.\n - `heading-level`: 2 | 3 | 4 | 5 | 6 = 3 — The level of the \"Show as table\" heading, to fit the page's outline.\n - `value-label`: string — Dot charts: the table's header for where each dot falls.\n - `detail-label`: string = \"Details\" — Dot charts: the table's header for the dots' names.\n - `empty-text`: string = \"No data to show.\" — Shown instead of the plot when there's no data.\n- Parts: `chart`, `plot`\n\n### <oh-checkbox>\n\nA single checkbox with its label, for turning one option on or off.\n\n**Use it for** one yes/no choice, such as agreeing to terms, or as part of a set where any number can be chosen. **Don't use it for** a set of related options on its own (use `oh-checkbox-group`, which adds the fieldset and legend), one choice from several (use `oh-radio-group`), or a setting that applies straight away (use `oh-toggle`).\n\n- Attributes:\n - `checked`: boolean = false — Whether the box is ticked.\n - `label`: string — The visible label, which also names the checkbox.\n - `name`: string — The form field name it submits under while checked.\n - `value`: string — The value submitted while checked (on if empty).\n - `required`: boolean = false — Must be checked before the form submits\n - `disabled`: boolean = false — Not interactive, and left out of the form\n - `error-text`: string — Error shown with the control and linked to it.\n- Events: `oh-change`\n- Parts: `box`, `label`, `error`\n\n### <oh-checkbox-group>\n\nA set of related checkboxes under one legend, where any number can be chosen.\n\n**Use it for** choosing any number of options from a short list, such as interests or notification types. **Don't use it for** one standalone yes/no option (use `oh-checkbox`), exactly one choice (use `oh-radio-group`, or `oh-select` for a long list), or settings that apply straight away (use `oh-toggle`).\n\n**Parts:** a `label` (rendered as the fieldset's `<legend>`) and a list of `options` (`{ label, value }`). `value` is the array of checked option values. **States:** each option unchecked, checked, hover, active and focus; the group can be `required` (a marker on the label), disabled, and in error (set `error-text`).\n\n- Attributes:\n - `label`: string — The group's label, rendered as the fieldset's <legend>.\n - `name`: string — The form field name each checked value is submitted under.\n - `options`: CheckboxOption[] — The checkboxes, as { label, value } objects.\n - `value`: string[] — The values of the checked options, in option order.\n - `required`: boolean = false — At least one box must be ticked: marks the label and blocks a native form from submitting while none is.\n - `disabled`: boolean = false — Not interactive, and left out of the form\n - `error-text`: string — Error shown with the control and linked to it.\n- Events: `oh-change`\n\n### <oh-cluster>\n\nA horizontal group of items that wraps onto new lines when space runs out.\n\n**Use it for** button groups, tags and rows of links. **Don't use it for** vertical lists (use `oh-stack`) or equal-width columns (use `oh-grid`).\n\n- Attributes:\n - `gap`: \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" = \"md\" — The space between items and between rows: none, xs, sm, md (default), lg or xl, from the spacing scale.\n - `justify`: \"around\" | \"between\" | \"center\" | \"end\" | \"start\" = \"start\" — How items sit along the row: start (default), center, end, between or around.\n - `align`: \"baseline\" | \"center\" | \"end\" | \"start\" = \"center\" — How items line up across the row: start, center (default), end or baseline.\n - `nowrap`: boolean = false — Keeps every item on one line instead of wrapping.\n- Slots:\n - `default` — The items to group.\n\n### <oh-container>\n\nA centred wrapper that limits content to a maximum width and adds side padding.\n\n**Use it for** the outer width of a page or section. **Don't use it for** spacing between items (use `oh-stack`, `oh-cluster` or `oh-grid`).\n\n- Attributes:\n - `size`: \"full\" | \"lg\" | \"md\" | \"sm\" | \"xl\" = \"lg\" — The maximum width: sm, md, lg (default) or xl, from layout.container.*; full is the full width with no side padding.\n - `center`: boolean = false — Centres the text inside.\n- Slots:\n - `default` — The content to contain.\n\n### <oh-description-list>\n\nA list of labels and their values: the details of one thing, or a few highlights.\n\n**Use it for** facts about one thing, each with a label: an order's details, a profile, a settings summary, a set of milestones. **Don't use it for** data compared across rows and columns (use `oh-table`); a list of items with no labels (use a list); or a form (use the form controls). A few headline figures (statistics) are this list too, with `layout=\"grid\"` and `value-size=\"lg\"`.\n\n**Parts:** the default slot holds one `<dl>`, written as normal HTML. Each item is a `<div>` with one `<dt>` (the label) and a `<dd>` (the value). A second `<dd>` is a note under the value. A `<dd data-actions>` holds the item's actions, such as a \"Change\" link; give each action visually hidden text that names its item (\"Change name\"), so it makes sense on its own. In a list of figures (`value-size=\"lg\"`), an item whose value is words, such as a name, takes `data-value=\"text\"` on its `<div>`: it's set smaller (`descriptionList.size.lg.text*`) so it fits its column.\n\n- Attributes:\n - `layout`: \"grid\" | \"rows\" = \"rows\" — rows (label beside value) or grid (label above value, items side by side).\n - `value-size`: \"lg\" | \"md\" = \"md\" — md (body text) or lg (figures, for headline numbers in the grid layout).\n- Slots:\n - `default` — One native `<dl>`, each item a `<div>` with a `<dt>` and its `<dd>`s.\n\n### <oh-drawer>\n\nA panel that slides in from the side of the viewport, over the page, for navigation or supplementary content.\n\n**Use it for** a site's navigation on small screens, filters, or settings that relate to the page behind. **Don't use it for** a decision the user must make before going on (use `oh-modal`); or for content that should always be visible (put it in the page).\n\n**Parts:** `heading` (an optional visible `h2`), a built-in Close button, and the default slot for the content, which scrolls when it's taller than the viewport.\n\n- Attributes:\n - `open`: boolean = false — Whether the drawer is open\n - `position`: \"end\" | \"left\" | \"right\" | \"start\" = \"start\" — The side the drawer opens from.\n - `heading`: string — Title shown in the drawer header\n- Events: `oh-close`\n- Slots:\n - `default` — Default slot for drawer content\n\n### <oh-footer>\n\nA site footer with a logo, copyright line, social links and columns of links.\n\n**Use it for** the footer at the bottom of every page. **Don't use it for** the main navigation (use `oh-navbar`).\n\n**Parts:** the `logo` slot; `copyright`, a line of text under the logo; the `social` slot for `oh-icon` links (with `inverse`); and the default slot, where each `oh-stack` becomes a column (start it with a heading, then `oh-link`s with `inverse`).\n\n- Attributes:\n - `copyright`: string — Copyright text\n- Slots:\n - `logo` — Slot for logo element\n - `social` — Slot for social media icons\n - `default` — Default slot for link columns (use oh-stack for each column)\n\n### <oh-grid>\n\nA CSS grid of equal-width columns, fixed or as many as fit.\n\n**Use it for** cards, galleries and other sets of similar items. **Don't use it for** a single column (use `oh-stack`) or items of varying width in a row (use `oh-cluster`).\n\n- Attributes:\n - `columns`: \"1\" | \"2\" | \"3\" | \"4\" | \"auto-fill\" | \"auto-fit\" = \"auto-fit\" — 1 to 4 fixed columns (fewer on narrow screens), or auto-fit (default) and auto-fill for as many as fit.\n - `gap`: \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" = \"md\" — The space between items: none, xs, sm, md (default), lg or xl, from the spacing scale.\n - `min-width`: string = \"280px\" — The narrowest an auto column can be, as any CSS length.\n - `align-items`: \"center\" | \"end\" | \"start\" | \"stretch\" = \"stretch\" — How items line up in their row: start, center, end or stretch (default).\n- Slots:\n - `default` — The grid items.\n\n### <oh-hero> (from @orange-halo/brand-orange-halo)\n\nThe banner at the top of an Orange Halo page: a heading on the brand colour, with a subtitle and actions, or a journey's name, step and progress.\n\n**Use it for** the top of an Orange Halo page, once. **Don't use it for** a section further down the page (use headings and `oh-card`), or in another brand: it's an Orange Halo brand pattern.\n\n**Parts:** `heading` is the page's `<h1>`. `content` (default) adds `subtitle` and the default slot for actions: the main action an `oh-button variant=\"secondary\"`, further ones `oh-link variant=\"standalone\" inverse`. `journey` shows `journey-name` above the heading and an inverse `oh-progress` for `current-step` of `total-steps`; the default slot sits under it.\n\n- Attributes:\n - `variant`: \"content\" | \"journey\" = \"content\" — content (default): a heading, subtitle and actions slot.\n - `size`: \"lg\" | \"md\" | \"sm\" | \"xl\" = \"lg\" — The content's maximum width: sm, md, lg (default) or xl, from layout.container.*.\n - `heading`: string — The page heading, rendered as the page's h1.\n - `subtitle`: string — A line under the heading (content variant only).\n - `journey-name`: string — The journey's name, shown above the page heading (journey variant only).\n - `current-step`: number = 1 — The step the user is on, for the progress bar (journey variant only).\n - `total-steps`: number = 1 — How many steps the journey has (journey variant only).\n- Slots:\n - `default` — Actions (content), or anything under the progress bar (journey).\n\n### <oh-icon>\n\nAn icon from the system's built-in set, shown on its own, with a label, or as an icon-only link.\n\n**Use it for** an icon next to text, an icon that carries meaning on its own (with `accessible-label`), or a compact link such as a social profile (`href` + `accessible-label`). **Don't use it for** an icon-only button (use `oh-button` with `icon-only`); or for an image or logo (use `<img>`).\n\n- Attributes:\n - `name`: \"arrow-down\" | \"arrow-left\" | \"arrow-right\" | \"arrow-up\" | \"check\" | \"chevron-down\" | \"chevron-left\" | \"chevron-right\" | \"chevron-up\" | \"close\" | \"email\" | \"error\" | \"external-link\" | \"facebook\" | \"github\" | \"heart\" | \"image\" | \"info\" | \"instagram\" | \"linkedin\" | \"list\" | \"menu\" | \"minus\" | \"plus\" | \"search\" | \"settings\" | \"sparkle\" | \"substack\" | \"success\" | \"twitter\" | \"warning\" | \"youtube\" = \"info\" — Which built-in icon to show.\n - `size`: \"lg\" | \"md\" | \"sm\" | \"xl\" — sm, md, lg or xl for a fixed size; leave it unset to follow the text size.\n - `inverse`: boolean = false — For icons on an accent-coloured or dark background.\n - `accessible-label`: string — Names an icon that carries meaning (role=\"img\"), or an icon link.\n - `href`: string — Renders the icon as a link to this URL.\n - `target`: string — The link's target; _blank adds rel=\"noopener noreferrer\".\n\n### <oh-input>\n\nA single-line text field that submits with a native form, with optional typing suggestions.\n\n**Use it for** short free text: names, email addresses, search terms. **Don't use it for** several lines (use `oh-textarea`) or a choice from a fixed list (use `oh-select`, or `oh-radio-group` for a few options). `suggestions` offers values while still allowing any text.\n\n- Attributes:\n - `type`: \"email\" | \"password\" | \"search\" | \"tel\" | \"text\" | \"url\" = \"text\" — The kind of text: text, email, password, search, tel or url\n - `value`: string — The text in the field\n - `placeholder`: string — Example text shown while the field is empty.\n - `label`: string — The visible label.\n - `helper-text`: string — Help shown under the field and linked to it\n - `error-text`: string — Error shown before the field and linked to it.\n - `name`: string — The name the value is submitted under\n - `required`: boolean = false — Must be filled in before the form submits\n - `disabled`: boolean = false — Not editable, and left out of the form's data\n - `suggestions`: string[] — Values offered while typing, shown by the browser as a list under the field.\n - `autocomplete`: string — The input's purpose, for autofill and assistive tech (WCAG 1.3.5): an HTML autocomplete token such as \"email\", \"name\" or \"tel\".\n- Events: `oh-input`, `oh-change`\n- Parts: `label`, `input`, `helper`, `error`\n\n### <oh-link>\n\nA text link, for use inside body copy or on its own as a call to action.\n\n**Use it for** navigating to another page or place. **Don't use it for** actions that don't navigate (use `oh-button` instead).\n\n- Attributes:\n - `href`: string — Where the link goes.\n - `target`: string — The link's target.\n - `rel`: string — The link's rel.\n - `variant`: \"inline\" | \"standalone\" = \"inline\" — inline (default) for links in running text, or standalone, larger and bolder, for a link on its own.\n - `arrow`: boolean = false — Shows a trailing arrow on a standalone link (not on external links).\n - `inverse`: boolean = false — For links on accent-coloured or dark surfaces.\n- Slots:\n - `default` — The link text.\n\n### <oh-modal>\n\nA dialog that opens over the page and holds the user's attention until they close it or act on it.\n\n**Use it for** a short task or decision that must be done before going on: a confirmation, a small form. **Don't use it for** content the user may want alongside the page (use `oh-drawer`); for a message that doesn't need an answer (use `oh-alert`); or for long, multi-step flows (use a page).\n\n**Parts:** `heading` (a visible `h2`); the default slot for the body, which scrolls when it's taller than the viewport; the `footer` slot for actions (with nothing in it, there's no footer).\n\n- Attributes:\n - `open`: boolean = false — Whether the dialog is showing.\n - `heading`: string — The visible title (an h2), which also names the dialog.\n - `accessible-label`: string — Names the dialog when it has no visible heading.\n - `dismissible`: boolean = true — Lets the Close button, Escape and a backdrop click close it, each firing oh-close (default on).\n - `size`: \"lg\" | \"md\" | \"sm\" | \"xl\" = \"md\" — The dialog's width: sm, md (default), lg or xl (an image beside its details), never wider than the viewport.\n- Events: `oh-close`\n- Slots:\n - `default` — The dialog body.\n - `footer` — Actions, below the body.\n- Parts: `modal`, `header`, `close`, `body`, `footer`\n\n### <oh-navbar>\n\nA site header bar with a logo and the site's main navigation links, which move into a drawer on narrow viewports.\n\n**Use it for** the main navigation at the top of every page. **Don't use it for** in-page sections (use `oh-tabs`) or a trail through the hierarchy (use `oh-breadcrumb`).\n\n**Parts:** the `logo` slot (a link to the home page), the default slot for the bar's links (`oh-link`), and the `mobile` slot for the same links in the drawer. `drawer-heading` names the drawer (defaults to \"Menu\").\n\n- Attributes:\n - `drawer-heading`: string = \"Menu\" — Heading shown in the mobile drawer\n- Slots:\n - `logo` — Slot for logo/brand element\n - `default` — Default slot for navigation links\n - `mobile` — The navigation links again, shown in the drawer\n\n### <oh-progress>\n\nA bar that shows how much of a task is done, with an optional percentage and visible label.\n\n**Use it for** a task with a known end: an upload, a download, steps completed. **Don't use it for** a wait of unknown length (it has no indeterminate state); or for a measurement that isn't progress, like storage used against a quota (a meter).\n\n- Attributes:\n - `value`: number = 0 — Current progress value (0-100 by default, or 0-max)\n - `max`: number = 100 — Maximum value (default 100)\n - `label`: string = \"Progress\" — Accessible label describing what the progress represents\n - `show-label`: boolean = false — Whether to show the visible label above the bar\n - `show-value`: boolean = true — Whether to show the percentage number\n - `size`: \"lg\" | \"md\" | \"sm\" = \"md\" — Size variant\n - `variant`: \"brand\" | \"error\" | \"info\" | \"success\" | \"warning\" = \"brand\" — Color variant\n - `inverse`: boolean = false — Inverse colors for dark backgrounds\n- Parts: `track`, `fill`, `value`\n\n### <oh-radio>\n\nA single radio button with its label.\n\n**Use it for** a one-off radio you manage yourself. **For a set of choices, use `oh-radio-group`.** Each `oh-radio` keeps its native radio inside its own shadow root, so two of them with the same `name` don't form a group: checking one doesn't uncheck the other, and arrow keys don't move between them. `oh-radio-group` renders the whole set in one place, with arrow-key navigation and one label for the group. For an independent on/off choice use `oh-checkbox`.\n\n- Attributes:\n - `checked`: boolean = false — Whether this radio is chosen.\n - `label`: string — The visible label, which also names the radio.\n - `name`: string — A name for your own grouping.\n - `value`: string — This radio's value, sent with oh-change.\n - `error-text`: string — Error shown with the control and linked to it.\n- Events: `oh-change`\n- Parts: `circle`, `label`, `error`\n\n### <oh-radio-group>\n\nA set of radio buttons under one label, where exactly one can be chosen.\n\n**Use it for** one choice from a few options that should all be visible, such as a plan or a delivery speed. **Don't use it for** a long list (use `oh-select`), several choices (use `oh-checkbox-group`) or an on/off setting (use `oh-toggle` or `oh-checkbox`). Use it rather than separate `oh-radio` elements, which can't form a group.\n\n**Parts:** a `label` for the group and a list of `options` (`{ label, value }`). `value` is the chosen option's value. **States:** each option unchecked, checked, hover, active and focus; the group can be `required`, disabled, and in error (set `error-text`).\n\n- Attributes:\n - `label`: string — The group's visible label, which also names the group.\n - `name`: string — The form field name the chosen value is submitted under.\n - `options`: RadioOption[] — The radios, as { label, value } objects.\n - `value`: string — The chosen option's value (empty for none).\n - `required`: boolean = false — An option must be chosen: marks the label and blocks a native form from submitting while none is.\n - `disabled`: boolean = false — Not interactive, and left out of the form\n - `error-text`: string — Error shown with the control and linked to it.\n- Events: `oh-change`\n\n### <oh-select>\n\nA dropdown for choosing one option from a list.\n\n**Use it for** one choice from a list too long to show every option. **Don't use it for** a few options (use `oh-radio-group`, which shows them all), several choices (use `oh-checkbox-group`) or free text (use `oh-input` with `suggestions`).\n\n**Parts:** a trigger showing the selected option's label (or `placeholder`), and a list of `options` (`{ label, value }`). One size. **States:** rest, hover, active, focus, open, error (set `error-text`), required, disabled.\n\n- Attributes:\n - `label`: string — The visible label, which names the trigger and the list.\n - `placeholder`: string = \"Select an option\" — Shown on the trigger while no option is chosen.\n - `name`: string — The form field name the chosen value is submitted under.\n - `options`: SelectOption[] — The choices, as { label, value } objects.\n - `value`: string — The chosen option's value (empty for none).\n - `required`: boolean = false — An option must be chosen: marks the label and blocks a native form from submitting while none is.\n - `disabled`: boolean = false — Not interactive, and left out of the form\n - `helper-text`: string — Help shown under the field and linked to it with aria-describedby.\n - `error-text`: string — An error message.\n- Events: `oh-change`\n\n### <oh-skip-link>\n\nA \"skip to content\" link that lets keyboard users jump past repeated content, such as navigation.\n\n**Use it for** the first focusable element on every page, pointing at the main content. Add more for other landmarks (search results, footer) if useful. **Don't use it for** in-page navigation that everyone sees (use `oh-link`).\n\n**Parts:** `href` is the target (defaults to `#main`); `text` is the label (defaults to \"Skip to main content\").\n\n- Attributes:\n - `href`: string = \"#main\" — The target to jump to, usually the main content's id.\n - `text`: string = \"Skip to main content\" — The link's text.\n\n### <oh-stack>\n\nA vertical layout that spaces its children evenly, top to bottom.\n\n**Use it for** consistent vertical rhythm without margins on children. **Don't use it for** items in a row (use `oh-cluster`) or a grid of cards (use `oh-grid`).\n\n- Attributes:\n - `gap`: \"2xl\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" = \"md\" — The space between children: none, xs, sm, md (default), lg, xl or 2xl, from the spacing scale.\n - `align`: \"center\" | \"end\" | \"start\" | \"stretch\" = \"stretch\" — Horizontal alignment of the children: start, center, end or stretch (default).\n- Slots:\n - `default` — The items to stack.\n\n### <oh-table>\n\nA data table: the styles and scrolling for a native `<table>` you write inside it.\n\n**Use it for** data people compare across rows and columns: figures by month, a list of records with several attributes. **Don't use it for** layout; a list of single items (use a list); or label-and-value pairs (use a description list, `<dl>`).\n\n**Parts:** the default slot holds one `<table>`, written as normal HTML: a `<caption>` that names it, `<thead>` with `<th scope=\"col\">` headers, `<tbody>`, and an optional `<tfoot>` for totals. Use `<th scope=\"row\">` for the cell that names its row. Cells can hold anything, including links, badges and buttons. Put `data-align=\"end\"` on the header and cells of a column of numbers so the digits line up; figures are tabular throughout. Show an empty result as one row with a cell spanning every column (`colspan`) that says there's nothing to show.\n\n- Attributes:\n - `density`: \"compact\" | \"default\" = \"default\" — default, or compact for long tables or tight spaces.\n - `accessible-label`: string — Names the table for assistive tech when it has no <caption>: set as the table's aria-label.\n- Slots:\n - `default` — One native `<table>`, with a `<caption>`.\n- Parts: `table`\n\n### <oh-tabs>\n\nA set of tabs that switches between panels of related content in the same place.\n\n**Use it for** a few peer sections of content where only one needs to be seen at a time. **Don't use it for** navigating between pages (use links or `oh-navbar`), or for content people need to compare side by side.\n\n**Parts:** pass `items`, an array of `{ id, label, content? }`. A panel shows `content` as text, or else the light-DOM element with `slot=\"<id>\"`. `value` is the selected tab's `id` (defaults to the first).\n\n- Attributes:\n - `items`: TabItem[] — The tabs: { id, label, content? }.\n - `value`: string — The selected tab's id.\n - `orientation`: \"horizontal\" | \"vertical\" = \"horizontal\" — Orientation of the tabs (affects arrow key behavior)\n- Events: `oh-change`\n\n### <oh-tag>\n\nA small interactive label: a filter the user turns on and off, or a value they've chosen and can remove.\n\n**Use it for** filters that narrow a list (\"Festivals\", \"2024\"), shown side by side, and for the values someone has picked, such as the filters currently applied, each with a × to remove it. **Don't use it for** a label nobody acts on, such as a status or category (use `oh-badge`); an action (use `oh-button`); a link to another page (use `oh-link`); or one setting in a form (use `oh-checkbox` or `oh-toggle`).\n\n**Kinds:** a filter by default; `removable` for a chosen value. A tag is one or the other: a removable tag can't be turned on.\n\n**Parts:** the default slot holds the text, a word or two; the `icon` slot an optional leading icon, sized to the text.\n\n- Attributes:\n - `checked`: boolean = false — A filter tag: whether it's on.\n - `removable`: boolean = false — A chosen value with a × that fires oh-remove, instead of a filter\n - `remove-label`: string = \"Remove\" — The word before the text in the ×'s name (\"Remove Festivals\").\n - `name`: string — Name for form submission (filter tags)\n - `value`: string — Submitted when a filter tag is on (on if unset), and sent with oh-remove\n - `disabled`: boolean = false — Not interactive, and left out of the form\n- Events: `oh-change`, `oh-remove`\n- Slots:\n - `default` — The tag text.\n - `icon` — Optional leading icon. Mark it `aria-hidden`.\n- Parts: `tag`, `remove`\n\n### <oh-textarea>\n\nA multi-line text field that submits with a native form.\n\n**Use it for** messages, comments, feedback: text that may run to several lines. **Don't use it for** a single line of text (use `oh-input`).\n\n- Attributes:\n - `label`: string — The visible label.\n - `value`: string — The text in the field\n - `placeholder`: string — Example text shown while the field is empty.\n - `helper-text`: string — Help shown under the field and linked to it\n - `error-text`: string — Error shown before the field and linked to it.\n - `name`: string — The name the value is submitted under\n - `required`: boolean = false — Must be filled in before the form submits\n - `disabled`: boolean = false — Not editable, and left out of the form's data\n - `rows`: number = 4 — Visible lines of text before the field scrolls (people can drag it taller)\n - `maxlength`: number — Longest allowed text, in characters\n - `autocomplete`: string — The field's purpose for autofill and assistive tech (WCAG 1.3.5), e.g. \"street-address\"\n- Events: `oh-input`, `oh-change`\n- Parts: `label`, `textarea`, `helper`, `error`\n\n### <oh-timeline>\n\nA dated list: entries under group headings, each a date beside what happened, with markers and notes between groups.\n\n**Use it for** things that happened, or will, in order: a history of events, a CV's jobs and education, a changelog, an order's progress written as a list. **Don't use it for** data compared across columns (use `oh-table`); facts about one thing (use `oh-description-list`); or steps someone works through (a stepper, which OHDS doesn't have yet).\n\n**Parts:** everything is normal HTML inside the element. - A **group** is a heading (`<h2>`–`<h6>`: a year, \"Upcoming\", \"Experience\") followed by an `<ol>` (or `<ul>`) of entries. A `<small>` inside the heading holds a count or note (\"12 gigs\"). - An **entry** is an `<li>`. Its first child is the **date**: a `<time datetime>`, or a `<p>` holding a range (`<time>2019</time> – <time>2023</time>`). Its second child holds **what happened**: a heading (`<h3>`–`<h6>`) and paragraphs; give a paragraph `data-meta` to set it in the secondary colour (a place, a type). An optional element with `data-aside` holds **badges or actions** at the end of the row. - A **marker** (`<p data-marker>`) is a line across the list with a label, such as \"Today\" between upcoming and past events, or \"Now\" in a CV. - A **note** (`<p data-note>`) is a short line between groups, such as \"No gigs in 2016\" or \"Career break\".\n\n- Attributes:\n - `sticky-headings`: boolean = false — Keeps each group heading in view while its entries scroll past.\n- Slots:\n - `default` — Group headings, lists of entries, markers and notes, as normal HTML.\n\n### <oh-toggle>\n\nA switch that turns a setting on or off.\n\n**Use it for** a setting that takes effect straight away, such as turning notifications on, or an on/off setting in a settings form. **Don't use it for** something that must be agreed to (use `oh-checkbox`), or a choice between more than two options (use `oh-radio-group`).\n\n- Attributes:\n - `checked`: boolean = false — Whether the toggle is checked/on\n - `label`: string — Label text displayed next to the toggle\n - `accessible-label`: string — Accessible name when there's no visible label.\n - `name`: string — Name for form submission\n - `value`: string = \"on\" — Value for form submission\n - `disabled`: boolean = false — Not interactive, and left out of the form\n- Events: `oh-change`\n\n## Tier 2 tokens (the same names in every brand)\n\nUse as CSS custom properties: `color.brand.primary` is `var(--oh-color-brand-primary)`. Values differ by brand; see https://orangehalo.co.uk/ohds/?path=/docs/foundation-tokens--docs\n\n- `color.brand`: `primary`, `primaryHover`, `primaryActive`, `primarySubtle`, `highlight`\n- `color.accent`: `default`, `hover`, `active`, `subtle`, `shadow`\n- `color.feedback`: `success`, `successSubtle`, `error`, `errorHover`, `errorSubtle`, `warning`, `warningSubtle`, `info`, `infoSubtle`\n- `color.surface`: `base`, `container`, `featured`, `inset`, `field`, `highlight`, `overlay`, `disabled`, `hover`, `active`, `featuredStart`, `featuredMid`, `featuredEnd`, `headerTint`, `backdrop`, `hoverTint`, `headerTintFade`, `onBrandTrack`, `onBrandFocus`\n- `color.border`: `default`, `subtle`, `emphasis`, `strong`, `hover`, `disabled`, `brand`, `brandHover`, `divider`, `onBrandTrack`\n- `color.text`: `primary`, `secondary`, `disabled`, `inverse`, `link`, `linkHover`, `linkOnContainer`, `brand`, `onBrand`, `onAccent`, `onSuccess`, `onError`, `onWarning`, `onInfo`\n- `color.data`: `categorical.1`, `categorical.2`, `categorical.3`, `categorical.4`, `categorical.5`, `muted`, `grid`, `axis`\n- `typography.heading`: `fontFamily`, `h1.fontSize`, `h1.fontWeight`, `h1.lineHeight`, `h1.letterSpacing`, `h2.fontSize`, `h2.fontWeight`, `h2.lineHeight`, `h2.letterSpacing`, `h3.fontSize`, `h3.fontWeight`, `h3.lineHeight`, `h3.letterSpacing`, `h4.fontSize`, `h4.fontWeight`, `h4.lineHeight`, `h4.letterSpacing`, `h5.fontSize`, `h5.fontWeight`, `h5.lineHeight`, `h6.fontSize`, `h6.fontWeight`, `h6.lineHeight`\n- `typography.body`: `fontFamily`, `xl.fontSize`, `xl.fontWeight`, `xl.lineHeight`, `lg.fontSize`, `lg.fontWeight`, `lg.lineHeight`, `base.fontSize`, `base.fontWeight`, `base.lineHeight`, `sm.fontSize`, `sm.fontWeight`, `sm.lineHeight`, `sm.letterSpacing`, `xs.fontSize`, `xs.fontWeight`, `xs.lineHeight`, `xs.letterSpacing`\n- `typography.label`: `fontFamily`, `base.fontSize`, `base.fontWeight`, `base.lineHeight`, `base.letterSpacing`, `sm.fontSize`, `sm.fontWeight`, `sm.lineHeight`, `sm.letterSpacing`\n- `typography.eyebrow`: `fontFamily`, `fontSize`, `fontWeight`, `letterSpacing`\n- `typography.control`: `fontFamily`, `fontWeight`, `letterSpacing`, `fontSize.sm`, `fontSize.md`, `fontSize.lg`\n- `typography.emphasis`: `fontWeight`\n- `typography.code`: `fontFamily`, `fontSize`, `lineHeight`\n- `spacing`: `layout.page`, `layout.section`, `layout.stack`, `layout.inline`\n- `layout`: `container.sm`, `container.md`, `container.lg`, `container.xl`\n- `shape`: `control`, `container`, `large`, `compact`, `tight`, `pill`\n- `elevation`: `soft`, `medium`, `strong`, `inset`\n- `elevation.surface`: `subtle`, `default`, `hover`, `active`, `focus`, `featured`, `featuredHover`, `featuredFocus`\n- `elevation.offset`: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`\n- `elevation.color`: `primary`, `secondary`, `error`, `neutral`, `neutralHover`, `overlay`, `field`, `hoverTint`, `inset`\n- `lift`: `hoverSm`, `hoverMd`, `activeSm`, `activeMd`\n- `stroke`: `control`, `surface`, `divider`, `data`\n- `decoration`: `underlineThickness`, `underlineFocusThickness`, `underlineDash`, `underlinePeriod`\n- `motion`: `quick`, `snappy`, `gentle`, `relaxed`, `slow`, `easeGentle`, `easeOut`, `easeEmphasized`\n- `focus`: `ringWidth`, `ringOffset`, `ringColor`, `decorationColor`\n- `spacing`: `0`, `0-5`, `1`, `1-5`, `2`, `2-5`, `3`, `3-5`, `4`, `5`, `6`, `7`, `8`, `10`, `12`, `16`, `20`, `px` (`spacing.<n>` is n half grid units)\n","tier2":[{"path":"color.brand.primary","description":"Primary brand action — WCAG AA"},{"path":"color.brand.primaryHover","description":"Hover state"},{"path":"color.brand.primaryActive","description":"Active/pressed state"},{"path":"color.brand.primarySubtle","description":"Subtle tint"},{"path":"color.brand.highlight","description":"Golden accent"},{"path":"color.accent.default","description":"Signature blue accent"},{"path":"color.accent.hover","description":""},{"path":"color.accent.active","description":""},{"path":"color.accent.subtle","description":""},{"path":"color.accent.shadow","description":"Chunky shadow for accent"},{"path":"color.feedback.success","description":"5.2:1 on successSubtle — green.600 failed AA for text"},{"path":"color.feedback.successSubtle","description":""},{"path":"color.feedback.error","description":""},{"path":"color.feedback.errorHover","description":"Error hover/active state"},{"path":"color.feedback.errorSubtle","description":""},{"path":"color.feedback.warning","description":""},{"path":"color.feedback.warningSubtle","description":""},{"path":"color.feedback.info","description":""},{"path":"color.feedback.infoSubtle","description":""},{"path":"color.surface.base","description":"Page background — warm off-white"},{"path":"color.surface.container","description":"Cards, panels — slight lift"},{"path":"color.surface.featured","description":"Featured — use with gradient"},{"path":"color.surface.inset","description":"Inputs, wells — pressed in"},{"path":"color.surface.field","description":"The fill of text fields, text areas and select triggers. Orange Halo's fields sit on the page colour; their border and inset shadow set them apart."},{"path":"color.surface.highlight","description":"Brightest surface — focused inputs, top of raised gradients"},{"path":"color.surface.overlay","description":"Modal backdrop — warm"},{"path":"color.surface.disabled","description":"Quiet disabled"},{"path":"color.surface.hover","description":"Warm hover tint"},{"path":"color.surface.active","description":"Active/pressed surface"},{"path":"color.surface.featuredStart","description":"Featured (sunlit) card gradient: top"},{"path":"color.surface.featuredMid","description":"Featured (sunlit) card gradient: 30%"},{"path":"color.surface.featuredEnd","description":"Featured (sunlit) card gradient: bottom"},{"path":"color.surface.headerTint","description":"Light glaze at the top of card headers, fading to transparent"},{"path":"color.surface.backdrop","description":"Modal backdrop — darker than surface.overlay so the dialog stands out"},{"path":"color.surface.hoverTint","description":"A translucent hover layer that works over any surface, for icon-only buttons such as close buttons. Darkens in light themes, lightens in dark ones"},{"path":"color.surface.headerTintFade","description":"Where color.surface.headerTint fades to: fully transparent"},{"path":"color.surface.onBrandTrack","description":"A track (such as a progress bar's) on a brand or accent background. The same in both themes: the brand background doesn't change much between them, and check:contrast checks the fill against it"},{"path":"color.surface.onBrandFocus","description":"The tint behind a focused link on a brand or accent background, paired with the underline (the indicator). The same in both themes, like color.surface.onBrandTrack"},{"path":"color.border.default","description":"Standard border"},{"path":"color.border.subtle","description":"Subtle dividers"},{"path":"color.border.emphasis","description":"Strong border for form elements"},{"path":"color.border.strong","description":"Neutral edge between default and emphasis — card hover, drawer edge. Decorative, not a 3:1 control border"},{"path":"color.border.hover","description":"Hover border — darker for feedback"},{"path":"color.border.disabled","description":""},{"path":"color.border.brand","description":"Brand-tinted border"},{"path":"color.border.brandHover","description":"Brand-tinted border on hover. Decorative container edge — not a focus or control border"},{"path":"color.border.divider","description":"Decorative divider inside a container, such as a card's header and footer"},{"path":"color.border.onBrandTrack","description":"The border of a track on a brand or accent background. The same in both themes, like color.surface.onBrandTrack"},{"path":"color.text.primary","description":"Primary text — warm brown"},{"path":"color.text.secondary","description":"Secondary text"},{"path":"color.text.disabled","description":"Disabled text"},{"path":"color.text.inverse","description":"On dark backgrounds"},{"path":"color.text.link","description":"Link text"},{"path":"color.text.linkHover","description":"Link hover"},{"path":"color.text.linkOnContainer","description":"Links on raised (linen) surfaces — text.link is only 4.4:1 on linen"},{"path":"color.text.brand","description":""},{"path":"color.text.onBrand","description":"Light text on dark brand bg"},{"path":"color.text.onAccent","description":"Light text on dark accent bg"},{"path":"color.text.onSuccess","description":"Text on filled color.feedback.success"},{"path":"color.text.onError","description":"Text on filled color.feedback.error"},{"path":"color.text.onWarning","description":"Text on filled color.feedback.warning"},{"path":"color.text.onInfo","description":"Text on filled color.feedback.info"},{"path":"color.data.categorical.1","description":""},{"path":"color.data.categorical.2","description":""},{"path":"color.data.categorical.3","description":""},{"path":"color.data.categorical.4","description":""},{"path":"color.data.categorical.5","description":""},{"path":"color.data.muted","description":"De-emphasised data: everything but the series a chart highlights (which uses categorical.1)"},{"path":"color.data.grid","description":"Gridlines: recessive"},{"path":"color.data.axis","description":"Axis and baseline lines"},{"path":"typography.heading.fontFamily","description":""},{"path":"typography.heading.h1.fontSize","description":""},{"path":"typography.heading.h1.fontWeight","description":""},{"path":"typography.heading.h1.lineHeight","description":""},{"path":"typography.heading.h1.letterSpacing","description":""},{"path":"typography.heading.h2.fontSize","description":""},{"path":"typography.heading.h2.fontWeight","description":""},{"path":"typography.heading.h2.lineHeight","description":""},{"path":"typography.heading.h2.letterSpacing","description":""},{"path":"typography.heading.h3.fontSize","description":""},{"path":"typography.heading.h3.fontWeight","description":""},{"path":"typography.heading.h3.lineHeight","description":""},{"path":"typography.heading.h3.letterSpacing","description":""},{"path":"typography.heading.h4.fontSize","description":""},{"path":"typography.heading.h4.fontWeight","description":""},{"path":"typography.heading.h4.lineHeight","description":""},{"path":"typography.heading.h4.letterSpacing","description":""},{"path":"typography.heading.h5.fontSize","description":""},{"path":"typography.heading.h5.fontWeight","description":""},{"path":"typography.heading.h5.lineHeight","description":""},{"path":"typography.heading.h6.fontSize","description":""},{"path":"typography.heading.h6.fontWeight","description":""},{"path":"typography.heading.h6.lineHeight","description":""},{"path":"typography.body.fontFamily","description":""},{"path":"typography.body.xl.fontSize","description":""},{"path":"typography.body.xl.fontWeight","description":""},{"path":"typography.body.xl.lineHeight","description":""},{"path":"typography.body.lg.fontSize","description":""},{"path":"typography.body.lg.fontWeight","description":""},{"path":"typography.body.lg.lineHeight","description":""},{"path":"typography.body.base.fontSize","description":""},{"path":"typography.body.base.fontWeight","description":""},{"path":"typography.body.base.lineHeight","description":""},{"path":"typography.body.sm.fontSize","description":""},{"path":"typography.body.sm.fontWeight","description":""},{"path":"typography.body.sm.lineHeight","description":""},{"path":"typography.body.sm.letterSpacing","description":""},{"path":"typography.body.xs.fontSize","description":""},{"path":"typography.body.xs.fontWeight","description":""},{"path":"typography.body.xs.lineHeight","description":""},{"path":"typography.body.xs.letterSpacing","description":""},{"path":"typography.label.fontFamily","description":""},{"path":"typography.label.base.fontSize","description":""},{"path":"typography.label.base.fontWeight","description":""},{"path":"typography.label.base.lineHeight","description":"1.5 for WCAG 1.4.12"},{"path":"typography.label.base.letterSpacing","description":""},{"path":"typography.label.sm.fontSize","description":""},{"path":"typography.label.sm.fontWeight","description":""},{"path":"typography.label.sm.lineHeight","description":"1.5 for WCAG 1.4.12"},{"path":"typography.label.sm.letterSpacing","description":""},{"path":"typography.eyebrow.fontFamily","description":""},{"path":"typography.eyebrow.fontSize","description":""},{"path":"typography.eyebrow.fontWeight","description":""},{"path":"typography.eyebrow.letterSpacing","description":""},{"path":"typography.control.fontFamily","description":""},{"path":"typography.control.fontWeight","description":""},{"path":"typography.control.letterSpacing","description":""},{"path":"typography.control.fontSize.sm","description":"Small buttons, field labels"},{"path":"typography.control.fontSize.md","description":"Default: input text, choices, buttons"},{"path":"typography.control.fontSize.lg","description":"Large buttons"},{"path":"typography.emphasis.fontWeight","description":""},{"path":"typography.code.fontFamily","description":""},{"path":"typography.code.fontSize","description":""},{"path":"typography.code.lineHeight","description":""},{"path":"spacing.layout.page","description":""},{"path":"spacing.layout.section","description":""},{"path":"spacing.layout.stack","description":""},{"path":"spacing.layout.inline","description":""},{"path":"layout.container.sm","description":""},{"path":"layout.container.md","description":""},{"path":"layout.container.lg","description":""},{"path":"layout.container.xl","description":""},{"path":"shape.control","description":"Buttons, inputs, selects, tabs"},{"path":"shape.container","description":"Alerts, modals, dropdowns, accordion items, panels"},{"path":"shape.large","description":"Cards"},{"path":"shape.compact","description":"Small controls and tags: close buttons, checkboxes, badges, code blocks"},{"path":"shape.tight","description":"Focus outlines on text links, inline code"},{"path":"shape.pill","description":"Pills, radios, toggles, progress bars"},{"path":"elevation.soft","description":"Cards, raised elements"},{"path":"elevation.medium","description":"Dropdowns, popovers"},{"path":"elevation.strong","description":"Modals, dialogs"},{"path":"elevation.inset","description":"Inputs, wells"},{"path":"elevation.surface.subtle","description":""},{"path":"elevation.surface.default","description":""},{"path":"elevation.surface.hover","description":"Hovered"},{"path":"elevation.surface.active","description":""},{"path":"elevation.surface.focus","description":"Sits under the focus glow"},{"path":"elevation.surface.featured","description":""},{"path":"elevation.surface.featuredHover","description":""},{"path":"elevation.surface.featuredFocus","description":""},{"path":"elevation.offset.xs","description":""},{"path":"elevation.offset.sm","description":""},{"path":"elevation.offset.md","description":""},{"path":"elevation.offset.lg","description":""},{"path":"elevation.offset.xl","description":""},{"path":"elevation.offset.2xl","description":""},{"path":"elevation.color.primary","description":"Primary buttons"},{"path":"elevation.color.secondary","description":"Secondary/form elements"},{"path":"elevation.color.error","description":"Error state"},{"path":"elevation.color.neutral","description":"Containers and the skip link"},{"path":"elevation.color.neutralHover","description":"Lifted containers"},{"path":"elevation.color.overlay","description":"Dialogs"},{"path":"elevation.color.field","description":"The inset shadow inside text fields"},{"path":"elevation.color.hoverTint","description":"The ring shadow of an icon-only button on hover, with color.surface.hoverTint"},{"path":"elevation.color.inset","description":"The inner shadow of a track (such as a progress bar's), neutral so it works on every track colour"},{"path":"lift.hoverSm","description":""},{"path":"lift.hoverMd","description":""},{"path":"lift.activeSm","description":""},{"path":"lift.activeMd","description":""},{"path":"stroke.control","description":"Controls and framed containers: buttons, fields, checkboxes, alerts, dialogs"},{"path":"stroke.surface","description":"Card edges"},{"path":"stroke.divider","description":"Lines between sections"},{"path":"stroke.data","description":"Lines that carry data: a line chart's lines, and the gap between donut slices"},{"path":"decoration.underlineThickness","description":""},{"path":"decoration.underlineFocusThickness","description":"The solid underline that shows keyboard focus on inline links"},{"path":"decoration.underlineDash","description":""},{"path":"decoration.underlinePeriod","description":""},{"path":"motion.quick","description":""},{"path":"motion.snappy","description":""},{"path":"motion.gentle","description":""},{"path":"motion.relaxed","description":""},{"path":"motion.slow","description":""},{"path":"motion.easeGentle","description":""},{"path":"motion.easeOut","description":""},{"path":"motion.easeEmphasized","description":""},{"path":"focus.ringWidth","description":""},{"path":"focus.ringOffset","description":""},{"path":"focus.ringColor","description":"The focus colour: outlines, focused control borders. Must stay opaque (4.7:1 on cream, WCAG 1.4.11)"},{"path":"focus.decorationColor","description":"Decorative glow only — never the sole focus indicator"},{"path":"spacing.0","description":""},{"path":"spacing.1","description":""},{"path":"spacing.2","description":""},{"path":"spacing.3","description":""},{"path":"spacing.4","description":""},{"path":"spacing.5","description":""},{"path":"spacing.6","description":""},{"path":"spacing.7","description":""},{"path":"spacing.8","description":""},{"path":"spacing.10","description":""},{"path":"spacing.12","description":""},{"path":"spacing.16","description":""},{"path":"spacing.20","description":""},{"path":"spacing.px","description":""},{"path":"spacing.0-5","description":""},{"path":"spacing.1-5","description":""},{"path":"spacing.2-5","description":""},{"path":"spacing.3-5","description":""}],"values":{"hoodlum":{"color.brand.primary":"#1f1f1f","color.brand.primaryHover":"#454545","color.brand.primaryActive":"#0d0d0d","color.brand.primarySubtle":"#ededed","color.brand.highlight":"#292929","color.accent.default":"#1f5cb3","color.accent.hover":"#184a91","color.accent.active":"#184a91","color.accent.subtle":"#edf3fc","color.accent.shadow":"#b3cdf2","color.feedback.success":"#1d7238","color.feedback.successSubtle":"#ebf6ee","color.feedback.error":"#b02525","color.feedback.errorHover":"#8c1d1d","color.feedback.errorSubtle":"#fceeee","color.feedback.warning":"#835600","color.feedback.warningSubtle":"#fcf4e3","color.feedback.info":"#1f5cb3","color.feedback.infoSubtle":"#edf3fc","color.surface.base":"#ffffff","color.surface.container":"#f7f7f7","color.surface.featured":"#ffffff","color.surface.inset":"#ededed","color.surface.field":"#f7f7f7","color.surface.highlight":"#ffffff","color.surface.overlay":"#00000066","color.surface.disabled":"#ededed","color.surface.hover":"#f7f7f7","color.surface.active":"#dedede","color.surface.featuredStart":"#ffffff","color.surface.featuredMid":"#f7f7f7","color.surface.featuredEnd":"#ededed","color.surface.headerTint":"#ffffff00","color.surface.backdrop":"#00000080","color.surface.hoverTint":"#00000014","color.surface.headerTintFade":"#ffffff00","color.surface.onBrandTrack":"#ffffff26","color.surface.onBrandFocus":"#0000001a","color.border.default":"#dedede","color.border.subtle":"#ededed","color.border.emphasis":"#6b6b6b","color.border.strong":"#c4c4c4","color.border.hover":"#1f1f1f","color.border.disabled":"#ededed","color.border.brand":"#1f1f1f40","color.border.brandHover":"#1f1f1f73","color.border.divider":"#dedede","color.border.onBrandTrack":"#ffffff4d","color.text.primary":"#1f1f1f","color.text.secondary":"#6b6b6b","color.text.disabled":"#a8a8a8","color.text.inverse":"#ffffff","color.text.link":"#1f1f1f","color.text.linkHover":"#575757","color.text.linkOnContainer":"#1f1f1f","color.text.brand":"#1f1f1f","color.text.onBrand":"#ffffff","color.text.onAccent":"#ffffff","color.text.onSuccess":"#ffffff","color.text.onError":"#ffffff","color.text.onWarning":"#ffffff","color.text.onInfo":"#ffffff","color.data.categorical.1":"#1f1f1f","color.data.categorical.2":"#ef6505","color.data.categorical.3":"#209993","color.data.categorical.4":"#771fa5","color.data.categorical.5":"#656d0f","color.data.muted":"#6b6b6b","color.data.grid":"#dedede","color.data.axis":"#6b6b6b","typography.heading.fontFamily":"'Plus Jakarta Sans', Arial, Helvetica, sans-serif","typography.heading.h1.fontSize":"3.5rem","typography.heading.h1.fontWeight":"800","typography.heading.h1.lineHeight":1.1429,"typography.heading.h1.letterSpacing":"-0.02em","typography.heading.h2.fontSize":"2.5rem","typography.heading.h2.fontWeight":"800","typography.heading.h2.lineHeight":1.2,"typography.heading.h2.letterSpacing":"-0.01em","typography.heading.h3.fontSize":"2rem","typography.heading.h3.fontWeight":"700","typography.heading.h3.lineHeight":1.25,"typography.heading.h3.letterSpacing":"-0.01em","typography.heading.h4.fontSize":"1.5rem","typography.heading.h4.fontWeight":"700","typography.heading.h4.lineHeight":1.3333,"typography.heading.h4.letterSpacing":"0","typography.heading.h5.fontSize":"1.25rem","typography.heading.h5.fontWeight":"700","typography.heading.h5.lineHeight":1.6,"typography.heading.h6.fontSize":"1rem","typography.heading.h6.fontWeight":"700","typography.heading.h6.lineHeight":1.5,"typography.body.fontFamily":"'Plus Jakarta Sans', Arial, Helvetica, sans-serif","typography.body.xl.fontSize":"1.5rem","typography.body.xl.fontWeight":"400","typography.body.xl.lineHeight":1.6667,"typography.body.lg.fontSize":"1.25rem","typography.body.lg.fontWeight":"400","typography.body.lg.lineHeight":1.6,"typography.body.base.fontSize":"1rem","typography.body.base.fontWeight":"400","typography.body.base.lineHeight":1.5,"typography.body.sm.fontSize":"0.75rem","typography.body.sm.fontWeight":"400","typography.body.sm.lineHeight":1.6667,"typography.body.sm.letterSpacing":"0","typography.body.xs.fontSize":"0.75rem","typography.body.xs.fontWeight":"400","typography.body.xs.lineHeight":1.6667,"typography.body.xs.letterSpacing":"0.02em","typography.label.fontFamily":"'Plus Jakarta Sans', Arial, Helvetica, sans-serif","typography.label.base.fontSize":"1rem","typography.label.base.fontWeight":"600","typography.label.base.lineHeight":1.5,"typography.label.base.letterSpacing":"0.02em","typography.label.sm.fontSize":"0.75rem","typography.label.sm.fontWeight":"600","typography.label.sm.lineHeight":1.6667,"typography.label.sm.letterSpacing":"0.08em","typography.eyebrow.fontFamily":"'Plus Jakarta Sans', Arial, Helvetica, sans-serif","typography.eyebrow.fontSize":"0.75rem","typography.eyebrow.fontWeight":"600","typography.eyebrow.letterSpacing":"0.08em","typography.control.fontFamily":"'Plus Jakarta Sans', Arial, Helvetica, sans-serif","typography.control.fontWeight":"600","typography.control.letterSpacing":"0.02em","typography.control.fontSize.sm":"1rem","typography.control.fontSize.md":"1rem","typography.control.fontSize.lg":"1.25rem","typography.emphasis.fontWeight":"700","typography.code.fontFamily":"ui-monospace, SFMono-Regular, Menlo, Consolas, monospace","typography.code.fontSize":"1rem","typography.code.lineHeight":1.5,"spacing.layout.page":"1.5rem","spacing.layout.section":"3rem","spacing.layout.stack":"1.25rem","spacing.layout.inline":"1rem","layout.container.sm":"640px","layout.container.md":"768px","layout.container.lg":"1024px","layout.container.xl":"1280px","shape.control":"4px","shape.container":"4px","shape.large":"6px","shape.compact":"2px","shape.tight":"2px","shape.pill":"9999px","elevation.soft":"none","elevation.medium":"none","elevation.strong":"0 12px 32px rgba(0, 0, 0, 0.35)","elevation.inset":"none","elevation.surface.subtle":"none","elevation.surface.default":"none","elevation.surface.hover":"none","elevation.surface.active":"none","elevation.surface.focus":"none","elevation.surface.featured":"none","elevation.surface.featuredHover":"none","elevation.surface.featuredFocus":"none","elevation.offset.xs":"0px","elevation.offset.sm":"0px","elevation.offset.md":"0px","elevation.offset.lg":"0px","elevation.offset.xl":"0px","elevation.offset.2xl":"0px","elevation.color.primary":"#c4c4c4","elevation.color.secondary":"#dedede","elevation.color.error":"#f59a9a","elevation.color.neutral":"#c4c4c4","elevation.color.neutralHover":"#a8a8a8","elevation.color.overlay":"#a8a8a8","elevation.color.field":"#c4c4c4","elevation.color.hoverTint":"#00000026","elevation.color.inset":"#0000000f","lift.hoverSm":"0px","lift.hoverMd":"0px","lift.activeSm":"0px","lift.activeMd":"0px","stroke.control":"1px","stroke.surface":"1px","stroke.divider":"1px","stroke.data":"2px","decoration.underlineThickness":"1px","decoration.underlineFocusThickness":"2px","decoration.underlineDash":"4px","decoration.underlinePeriod":"8px","motion.quick":"100ms","motion.snappy":"150ms","motion.gentle":"200ms","motion.relaxed":"250ms","motion.slow":"350ms","motion.easeGentle":[0.4,0,0.2,1],"motion.easeOut":[0,0,0.2,1],"motion.easeEmphasized":[0,0,0.2,1],"focus.ringWidth":"2px","focus.ringOffset":"2px","focus.ringColor":"#1f1f1f","focus.decorationColor":"#00000000","spacing.0":"0","spacing.1":"0.25rem","spacing.2":"0.5rem","spacing.3":"0.75rem","spacing.4":"1rem","spacing.5":"1.25rem","spacing.6":"1.5rem","spacing.7":"1.75rem","spacing.8":"2rem","spacing.10":"2.5rem","spacing.12":"3rem","spacing.16":"4rem","spacing.20":"5rem","spacing.px":"1px","spacing.0-5":"0.125rem","spacing.1-5":"0.375rem","spacing.2-5":"0.625rem","spacing.3-5":"0.875rem"},"orange-halo":{"color.brand.primary":"#c54300","color.brand.primaryHover":"#9e3500","color.brand.primaryActive":"#9e3500","color.brand.primarySubtle":"#fff3e0","color.brand.highlight":"#e8a838","color.accent.default":"#3d5a80","color.accent.hover":"#354f70","color.accent.active":"#2e4460","color.accent.subtle":"#eef4f9","color.accent.shadow":"#a0b4c8","color.feedback.success":"#3d7340","color.feedback.successSubtle":"#f0f7f1","color.feedback.error":"#b54540","color.feedback.errorHover":"#943836","color.feedback.errorSubtle":"#fdf4f3","color.feedback.warning":"#8c5e1c","color.feedback.warningSubtle":"#fefaee","color.feedback.info":"#3d5a80","color.feedback.infoSubtle":"#eef4f9","color.surface.base":"#faf7f2","color.surface.container":"#f5f0e8","color.surface.featured":"#faf7f2","color.surface.inset":"#ede8df","color.surface.field":"#faf7f2","color.surface.highlight":"#ffffff","color.surface.overlay":"#3d322966","color.surface.disabled":"#e2dcd2","color.surface.hover":"#fff4e6","color.surface.active":"#f0ebe3","color.surface.featuredStart":"#fffbf5","color.surface.featuredMid":"#fdf6ee","color.surface.featuredEnd":"#f8efe4","color.surface.headerTint":"#ffffff80","color.surface.backdrop":"#3d322999","color.surface.hoverTint":"#00000014","color.surface.headerTintFade":"#ffffff00","color.surface.onBrandTrack":"#ffffff26","color.surface.onBrandFocus":"#0000001a","color.border.default":"#e2dcd2","color.border.subtle":"#ede8df","color.border.emphasis":"#6b5d4d","color.border.strong":"#c9c1b4","color.border.hover":"#8b4726","color.border.disabled":"#ede8df","color.border.brand":"#c5430040","color.border.brandHover":"#c5430059","color.border.divider":"#e2d5c899","color.border.onBrandTrack":"#ffffff4d","color.text.primary":"#3d3229","color.text.secondary":"#6b5d4d","color.text.disabled":"#c9c1b4","color.text.inverse":"#faf7f2","color.text.link":"#c54300","color.text.linkHover":"#9e3500","color.text.linkOnContainer":"#9e3500","color.text.brand":"#c54300","color.text.onBrand":"#ffffff","color.text.onAccent":"#ffffff","color.text.onSuccess":"#ffffff","color.text.onError":"#ffffff","color.text.onWarning":"#ffffff","color.text.onInfo":"#ffffff","color.data.categorical.1":"#c54300","color.data.categorical.2":"#0e5794","color.data.categorical.3":"#9c0451","color.data.categorical.4":"#8d6300","color.data.categorical.5":"#1d9999","color.data.muted":"#8a7a68","color.data.grid":"#e2d5c899","color.data.axis":"#6b5d4d","typography.heading.fontFamily":"'Bricolage Grotesque', 'General Sans', sans-serif","typography.heading.h1.fontSize":"2.5rem","typography.heading.h1.fontWeight":"700","typography.heading.h1.lineHeight":1.2,"typography.heading.h1.letterSpacing":"-0.02em","typography.heading.h2.fontSize":"2rem","typography.heading.h2.fontWeight":"700","typography.heading.h2.lineHeight":1.25,"typography.heading.h2.letterSpacing":"-0.01em","typography.heading.h3.fontSize":"1.75rem","typography.heading.h3.fontWeight":"600","typography.heading.h3.lineHeight":1.4286,"typography.heading.h3.letterSpacing":"-0.01em","typography.heading.h4.fontSize":"1.5rem","typography.heading.h4.fontWeight":"600","typography.heading.h4.lineHeight":1.3333,"typography.heading.h4.letterSpacing":"0","typography.heading.h5.fontSize":"1.25rem","typography.heading.h5.fontWeight":"500","typography.heading.h5.lineHeight":1.6,"typography.heading.h6.fontSize":"1rem","typography.heading.h6.fontWeight":"500","typography.heading.h6.lineHeight":1.5,"typography.body.fontFamily":"'Bricolage Grotesque', 'General Sans', -apple-system, BlinkMacSystemFont, sans-serif","typography.body.xl.fontSize":"1.5rem","typography.body.xl.fontWeight":"400","typography.body.xl.lineHeight":1.6667,"typography.body.lg.fontSize":"1.25rem","typography.body.lg.fontWeight":"400","typography.body.lg.lineHeight":1.6,"typography.body.base.fontSize":"1rem","typography.body.base.fontWeight":"400","typography.body.base.lineHeight":1.5,"typography.body.sm.fontSize":"0.75rem","typography.body.sm.fontWeight":"400","typography.body.sm.lineHeight":1.6667,"typography.body.sm.letterSpacing":"0.01em","typography.body.xs.fontSize":"0.75rem","typography.body.xs.fontWeight":"400","typography.body.xs.lineHeight":1.6667,"typography.body.xs.letterSpacing":"0.01em","typography.label.fontFamily":"'Bricolage Grotesque', 'General Sans', -apple-system, BlinkMacSystemFont, sans-serif","typography.label.base.fontSize":"1rem","typography.label.base.fontWeight":"500","typography.label.base.lineHeight":1.5,"typography.label.base.letterSpacing":"0.01em","typography.label.sm.fontSize":"0.75rem","typography.label.sm.fontWeight":"500","typography.label.sm.lineHeight":1.6667,"typography.label.sm.letterSpacing":"0.01em","typography.eyebrow.fontFamily":"'Bricolage Grotesque', 'General Sans', -apple-system, BlinkMacSystemFont, sans-serif","typography.eyebrow.fontSize":"1rem","typography.eyebrow.fontWeight":"500","typography.eyebrow.letterSpacing":"0.05em","typography.control.fontFamily":"'Bricolage Grotesque', 'General Sans', -apple-system, BlinkMacSystemFont, sans-serif","typography.control.fontWeight":"600","typography.control.letterSpacing":"0.01em","typography.control.fontSize.sm":"1rem","typography.control.fontSize.md":"1.25rem","typography.control.fontSize.lg":"1.5rem","typography.emphasis.fontWeight":"600","typography.code.fontFamily":"'JetBrains Mono', 'Fira Code', ui-monospace, monospace","typography.code.fontSize":"1rem","typography.code.lineHeight":1.5,"spacing.layout.page":"1.5rem","spacing.layout.section":"3rem","spacing.layout.stack":"1.25rem","spacing.layout.inline":"1rem","layout.container.sm":"640px","layout.container.md":"768px","layout.container.lg":"1024px","layout.container.xl":"1280px","shape.control":"10px","shape.container":"10px","shape.large":"14px","shape.compact":"6px","shape.tight":"4px","shape.pill":"9999px","elevation.soft":"0 2px 8px rgba(61, 50, 41, 0.06), 0 1px 3px rgba(61, 50, 41, 0.08)","elevation.medium":"0 4px 16px rgba(61, 50, 41, 0.08), 0 2px 6px rgba(61, 50, 41, 0.06)","elevation.strong":"0 8px 24px rgba(61, 50, 41, 0.10), 0 4px 8px rgba(61, 50, 41, 0.06)","elevation.inset":"inset 0 1px 3px rgba(61, 50, 41, 0.08)","elevation.surface.subtle":"0 1px 2px rgba(61, 50, 41, 0.04), inset 0 1px 0 rgba(255, 255, 255, 0.6)","elevation.surface.default":"0 2px 6px rgba(61, 50, 41, 0.08), 0 6px 16px rgba(61, 50, 41, 0.05), inset 0 1px 0 rgba(255, 255, 255, 0.8)","elevation.surface.hover":"0 4px 12px rgba(61, 50, 41, 0.1), 0 12px 28px rgba(61, 50, 41, 0.08), inset 0 1px 0 rgba(255, 255, 255, 0.9)","elevation.surface.active":"0 1px 3px rgba(61, 50, 41, 0.1), 0 3px 8px rgba(61, 50, 41, 0.06), inset 0 1px 2px rgba(61, 50, 41, 0.04)","elevation.surface.focus":"0 2px 6px rgba(61, 50, 41, 0.08), inset 0 1px 0 rgba(255, 255, 255, 0.8)","elevation.surface.featured":"0 2px 8px rgba(139, 69, 19, 0.08), 0 8px 24px rgba(139, 69, 19, 0.06), 0 0 20px rgba(197, 67, 0, 0.04), inset 0 1px 0 rgba(255, 255, 255, 0.9)","elevation.surface.featuredHover":"0 4px 12px rgba(139, 69, 19, 0.12), 0 12px 32px rgba(139, 69, 19, 0.08), 0 0 28px rgba(197, 67, 0, 0.06), inset 0 1px 0 rgba(255, 255, 255, 1)","elevation.surface.featuredFocus":"0 2px 8px rgba(139, 69, 19, 0.08), inset 0 1px 0 rgba(255, 255, 255, 0.9)","elevation.offset.xs":"1px","elevation.offset.sm":"2px","elevation.offset.md":"3px","elevation.offset.lg":"4px","elevation.offset.xl":"5px","elevation.offset.2xl":"6px","elevation.color.primary":"#e8c4a0","elevation.color.secondary":"#d4c4b0","elevation.color.error":"#b545404d","elevation.color.neutral":"#6b5d4d26","elevation.color.neutralHover":"#6b5d4d33","elevation.color.overlay":"#6b5d4d40","elevation.color.field":"#3d322926","elevation.color.hoverTint":"#00000026","elevation.color.inset":"#0000000f","lift.hoverSm":"-1px","lift.hoverMd":"-2px","lift.activeSm":"1px","lift.activeMd":"2px","stroke.control":"2.5px","stroke.surface":"1px","stroke.divider":"1px","stroke.data":"2px","decoration.underlineThickness":"2px","decoration.underlineFocusThickness":"3px","decoration.underlineDash":"4px","decoration.underlinePeriod":"8px","motion.quick":"100ms","motion.snappy":"150ms","motion.gentle":"200ms","motion.relaxed":"300ms","motion.slow":"400ms","motion.easeGentle":[0.4,0,0.2,1],"motion.easeOut":[0,0,0.2,1],"motion.easeEmphasized":[0.34,1.3,0.64,1],"focus.ringWidth":"3px","focus.ringOffset":"2px","focus.ringColor":"#c54300","focus.decorationColor":"#c5430026","spacing.0":"0","spacing.1":"0.25rem","spacing.2":"0.5rem","spacing.3":"0.75rem","spacing.4":"1rem","spacing.5":"1.25rem","spacing.6":"1.5rem","spacing.7":"1.75rem","spacing.8":"2rem","spacing.10":"2.5rem","spacing.12":"3rem","spacing.16":"4rem","spacing.20":"5rem","spacing.px":"1px","spacing.0-5":"0.125rem","spacing.1-5":"0.375rem","spacing.2-5":"0.625rem","spacing.3-5":"0.875rem"}},"tier3":[{"path":"button.base.fontFamily","role":"typography.control.fontFamily","description":""},{"path":"button.base.fontWeight","role":"typography.control.fontWeight","description":""},{"path":"button.base.letterSpacing","role":"typography.control.letterSpacing","description":""},{"path":"button.base.borderRadius","role":"shape.control","description":""},{"path":"button.base.borderWidth","role":"stroke.control","description":""},{"path":"button.size.sm.fontSize","role":"typography.control.fontSize.sm","description":""},{"path":"button.size.sm.paddingX","role":"spacing.4","description":""},{"path":"button.size.sm.paddingY","role":"spacing.2","description":""},{"path":"button.size.sm.minHeight","role":"40px","description":""},{"path":"button.size.sm.gap","role":"spacing.2","description":""},{"path":"button.size.md.fontSize","role":"typography.control.fontSize.md","description":""},{"path":"button.size.md.paddingX","role":"spacing.6","description":""},{"path":"button.size.md.paddingY","role":"spacing.3","description":""},{"path":"button.size.md.minHeight","role":"48px","description":""},{"path":"button.size.md.gap","role":"spacing.2","description":""},{"path":"button.size.lg.fontSize","role":"typography.control.fontSize.lg","description":""},{"path":"button.size.lg.paddingX","role":"spacing.8","description":""},{"path":"button.size.lg.paddingY","role":"spacing.4","description":""},{"path":"button.size.lg.minHeight","role":"56px","description":""},{"path":"button.size.lg.gap","role":"spacing.2-5","description":""},{"path":"button.variant.primary.background","role":"color.brand.primary","description":""},{"path":"button.variant.primary.backgroundHover","role":"color.brand.primaryHover","description":""},{"path":"button.variant.primary.backgroundActive","role":"color.brand.primaryActive","description":""},{"path":"button.variant.primary.color","role":"color.text.onBrand","description":""},{"path":"button.variant.primary.borderColor","role":"color.brand.primary","description":""},{"path":"button.variant.primary.shadowColor","role":"elevation.color.primary","description":""},{"path":"button.variant.secondary.background","role":"color.surface.base","description":""},{"path":"button.variant.secondary.backgroundHover","role":"color.surface.hover","description":""},{"path":"button.variant.secondary.backgroundActive","role":"color.surface.active","description":""},{"path":"button.variant.secondary.color","role":"color.text.primary","description":""},{"path":"button.variant.secondary.borderColor","role":"color.border.emphasis","description":""},{"path":"button.variant.secondary.shadowColor","role":"elevation.color.secondary","description":""},{"path":"button.variant.accent.background","role":"color.accent.default","description":""},{"path":"button.variant.accent.backgroundHover","role":"color.accent.hover","description":""},{"path":"button.variant.accent.backgroundActive","role":"color.accent.active","description":""},{"path":"button.variant.accent.color","role":"color.text.onAccent","description":""},{"path":"button.variant.accent.borderColor","role":"color.accent.default","description":""},{"path":"button.variant.accent.shadowColor","role":"color.accent.shadow","description":""},{"path":"input.base.borderWidth","role":"stroke.control","description":""},{"path":"input.size.md.minHeight","role":"48px","description":""},{"path":"card.base.borderWidth","role":"stroke.surface","description":""},{"path":"card.base.dividerColor","role":"color.border.divider","description":""},{"path":"card.base.headerBackgroundStart","role":"color.surface.headerTint","description":""},{"path":"card.base.headerBackgroundEnd","role":"color.surface.headerTintFade","description":""},{"path":"card.variant.default.gradientStart","role":"color.surface.highlight","description":""},{"path":"card.variant.default.gradientMid","role":"color.surface.base","description":""},{"path":"card.variant.default.gradientEnd","role":"color.surface.container","description":""},{"path":"card.variant.default.borderColor","role":"color.border.default","description":""},{"path":"card.variant.featured.gradientStart","role":"color.surface.featuredStart","description":""},{"path":"card.variant.featured.gradientMid","role":"color.surface.featuredMid","description":""},{"path":"card.variant.featured.gradientEnd","role":"color.surface.featuredEnd","description":""},{"path":"card.variant.featured.borderColor","role":"color.border.brand","description":""},{"path":"card.variant.subtle.gradientStart","role":"color.surface.base","description":""},{"path":"card.variant.subtle.gradientEnd","role":"color.surface.container","description":""},{"path":"card.variant.subtle.borderColor","role":"color.border.default","description":""},{"path":"progress.base.trackInsetShadow","role":"elevation.color.inset","description":"Neutral, so it works on every track colour"},{"path":"progress.variant.inverse.trackBackground","role":"color.surface.onBrandTrack","description":""},{"path":"progress.variant.inverse.trackBorder","role":"color.border.onBrandTrack","description":""},{"path":"progress.variant.inverse.fill","role":"color.text.inverse","description":""},{"path":"badge.size.lg.minHeight","role":"button.size.sm.minHeight","description":"A badge in a row of small buttons (size=\"lg\"): as tall as a small button, so they line up. It follows the button, so a brand that changes one changes both"},{"path":"link.variant.inverse.focusBackground","role":"color.surface.onBrandFocus","description":"Focus tint — paired with the underline, which is the indicator"},{"path":"modal.size.sm.width","role":"400px","description":"A small dialog's width (size=\"sm\"): a short confirmation"},{"path":"modal.size.md.width","role":"560px","description":"The default dialog width: a short message or a small form"},{"path":"modal.size.lg.width","role":"720px","description":"A large dialog's width (size=\"lg\"): a longer form"},{"path":"modal.size.xl.width","role":"layout.container.lg","description":"An extra-large dialog's width (size=\"xl\"): an image beside its details. A dialog is never wider than the viewport"},{"path":"modal.base.backdrop","role":"color.surface.backdrop","description":""},{"path":"closeButton.state.hover.background","role":"color.surface.hoverTint","description":"Neutral tint that works on every alert variant"},{"path":"closeButton.state.hover.shadowColor","role":"elevation.color.hoverTint","description":"Offset shadow colour on hover and press. Neutral, like the background, so it works on every alert variant"},{"path":"navbar.base.shadow","role":"0 {elevation.offset.sm} 8px {focus.decorationColor}","description":"The bar's soft shadow, in the focus glow colour; a brand with a transparent glow or no offset has none"},{"path":"navbar.base.logoHeight","role":"40px","description":"Logo height in the bar; a page can override it with --oh-navbar-logo-height"},{"path":"select.base.listMaxHeight","role":"280px","description":"The open list's tallest height; longer lists scroll inside it"},{"path":"select.base.listEnterOffset","role":"spacing.2","description":"How far above its resting place the list starts as it opens and slides down"},{"path":"drawer.base.width","role":"280px","description":"The panel's width; a page can override it with --oh-drawer-width"},{"path":"drawer.base.viewportGap","role":"spacing.12","description":"The least room left beside the panel, so it never covers the whole viewport and the backdrop stays visible to close it"},{"path":"descriptionList.base.columnMinWidth","role":"240px","description":"The narrowest a column gets in the grid layout before items wrap onto fewer columns"},{"path":"descriptionList.size.lg.columnMinWidth","role":"160px","description":"The narrowest a column gets in a grid of large values (figures), which are short, so five or six fit in a row on a wide page"},{"path":"descriptionList.size.lg.valueFontFamily","role":"typography.heading.fontFamily","description":"Large values (figures): the heading family"},{"path":"descriptionList.size.lg.valueFontSize","role":"typography.heading.h2.fontSize","description":"Large values (figures): the h2 size, so a brand can point it elsewhere without touching the component"},{"path":"descriptionList.size.lg.valueFontWeight","role":"typography.heading.h2.fontWeight","description":""},{"path":"descriptionList.size.lg.valueLineHeight","role":"typography.heading.h2.lineHeight","description":"The h2 line height, which keeps the figure on the grid"},{"path":"descriptionList.size.lg.valueLetterSpacing","role":"typography.heading.h2.letterSpacing","description":""},{"path":"descriptionList.size.lg.textFontFamily","role":"typography.heading.fontFamily","description":"A value that's words, not a figure, in a list of large values (data-value=\"text\"): the heading family"},{"path":"descriptionList.size.lg.textFontSize","role":"typography.heading.h4.fontSize","description":"Words in a list of figures: the h4 size, smaller than the figures so a name or title fits its column"},{"path":"descriptionList.size.lg.textFontWeight","role":"typography.heading.h4.fontWeight","description":""},{"path":"descriptionList.size.lg.textLineHeight","role":"typography.heading.h4.lineHeight","description":"The h4 line height, which keeps the text on the grid"},{"path":"chart.base.plotHeight","role":"240px","description":"Height of a column chart's plot area (the bars' full scale)"},{"path":"chart.base.barThickness","role":"spacing.4","description":"Thickness of each bar in a bar chart"},{"path":"chart.base.columnMinWidth","role":"spacing.6","description":"The narrowest a column's slot gets; below it the chart scrolls sideways instead of squeezing"},{"path":"chart.base.columnMaxWidth","role":"spacing.12","description":"The widest a column gets, so a chart with few columns doesn't draw slabs"},{"path":"chart.base.lineWidth","role":"stroke.data","description":"Width of a line chart's lines, and the gap between donut slices"},{"path":"chart.base.markerSize","role":"spacing.3","description":"Size of a line chart's point markers and of the colour keys beside labels"},{"path":"chart.base.donutThickness","role":"spacing.8","description":"Thickness of a donut chart's ring (its diameter is chart.base.plotHeight)"},{"path":"chart.base.dotRowHeight","role":"spacing.8","description":"Height of each row in a dot chart, so a row's dots and its label have room"},{"path":"chart.size.sm.plotHeight","role":"96px","description":"A small chart's plot area (size=\"sm\"): for a chart that sits beside a short list or a few figures, so the two line up"},{"path":"timeline.base.dateWidth","role":"144px","description":"Width of the date column beside each entry: room for a short date or a range of years (\"2019 – 2023\")"}]}
|
|
1
|
+
{"versions":{"@orange-halo/brand-orange-halo":"3.0.0","@orange-halo/components":"4.2.0","@orange-halo/tokens":"4.2.0","@orange-halo/utils":"1.1.0"},"brands":[{"id":"hoodlum","name":"Hoodlum","formerIds":["hood"]},{"id":"orange-halo","name":"Orange Halo","formerIds":[]}],"elements":[{"tagName":"oh-accordion","pkg":"@orange-halo/components","description":"Collapsible sections, each with a heading that shows and hides its content. Use one item for a single show/hide section.\n\n**Use it for** content readers scan by heading and open as needed (FAQs, details, a \"Show as table\" section). **Don't use it for** content most readers need (leave it visible); for switching between views of the same thing (use tabs); or for site navigation.\n\n**Parts:** `items` is an array of `{ heading, hiddenText?, open? }` (in HTML, a JSON array). Item N's content is any markup in a child with `slot=\"item-N\"`, such as a paragraph or a table.\n\n**Variants:** `subtle` (default), inline with surrounding content, its trigger styled as a link; `standout`, each item a separate boxed surface, for when the sections are the page's main content.\n\n**States:** collapsed and expanded per item (any number can be open; `open` sets the starting state), plus hover and focus-visible on the trigger.\n\n**Behaviour:** each trigger is a `<button>` inside a heading at `heading-level` (default 3), so the items fit the page's outline. Click, Enter or Space toggles it. While collapsed, the panel is `aria-hidden` and `inert`, so nothing inside it takes focus. Motion is turned off under `prefers-reduced-motion`.\n\n**Accessibility:** the trigger has `aria-expanded` and `aria-controls`; the panel is a `region` labelled by its trigger. `hiddenText` adds heading text only screen readers hear, so several items with the same visible heading (e.g. \"Show as table\") can be told apart. Set `heading-level` to fit the headings around it.\n\n**Look:** set by tokens. `subtle`: the trigger uses `color.text.link` and an underline set by `decoration.underlineThickness`, `underlineDash` and `underlinePeriod`, which clears on hover; focus is a solid `color.brand.primary` underline; items are divided by `stroke.divider` in `color.border.subtle`. `standout`: each item uses `color.surface.container`, a `stroke.control` border in `color.border.emphasis` (`color.brand.primary` when expanded), `shape.container` corners and an `elevation.offset.*` shadow in `elevation.color.neutral`, which moves by `lift.hoverMd` on hover. Type uses `typography.body.*`; motion uses `motion.*` tokens.","attributes":[{"name":"items","type":{"text":"AccordionItem[]"},"default":"[]","description":"The sections: { heading, hiddenText?, open? }. In HTML, a JSON array.\nEach item's content is a child with slot=\"item-<index>\".","fieldName":"items"},{"name":"variant","type":{"text":"AccordionVariant"},"default":"\"subtle\"","description":"subtle (inline) or standout (boxed)","fieldName":"variant"},{"name":"heading-level","type":{"text":"HeadingLevel"},"default":"3","description":"The heading level of each item's trigger, to fit the page's outline","fieldName":"headingLevel"}],"members":[{"kind":"field","name":"items","type":{"text":"AccordionItem[]"},"default":"[]","description":"The sections: { heading, hiddenText?, open? }. In HTML, a JSON array.\nEach item's content is a child with slot=\"item-<index>\".","attribute":"items"},{"kind":"field","name":"variant","type":{"text":"AccordionVariant"},"default":"\"subtle\"","description":"subtle (inline) or standout (boxed)","attribute":"variant","reflects":true},{"kind":"field","name":"headingLevel","type":{"text":"HeadingLevel"},"default":"3","description":"The heading level of each item's trigger, to fit the page's outline","attribute":"heading-level","reflects":true}],"slots":[{"description":"The content of the item at index N (item-0 is the first)","name":"item-N"}],"released":null},{"tagName":"oh-alert","pkg":"@orange-halo/components","description":"A message box that tells the user about the result of an action or something that needs their attention.\n\n**Use it for** feedback on what just happened (saved, failed) or a notice about the page or account, near the content it's about. **Don't use it for** a short status label (use `oh-badge`); for a field's validation error (use the field's own error message); or for a message that must interrupt the user (use `oh-modal`).\n\n**Variants:** `info` (default), `success`, `warning`, `error`, each by its feedback role. Each has its own icon, so the meaning isn't carried by colour alone.\n\n**Behaviour:** with `dismissible`, a \"Close\" button follows the content; selecting it fires `oh-close` (as `oh-modal` and `oh-drawer` do) and sets `hidden` on the alert. Focus then moves to the next focusable element on the page (or the previous one, when nothing follows), unless an `oh-close` listener has already moved it. Content goes in the default slot and can include links.\n\n**Accessibility:** set `live` only for an alert added after the page has rendered (e.g. after submit); it adds `role=\"alert\"` so screen readers announce it. Leave it off for alerts present on page load. Icons are `aria-hidden`; put the meaning in the text. Links show a solid outline in the current text colour on focus; the close button shows an underline.\n\n**Look:** set by tokens. Each variant uses `color.feedback.<variant>Subtle` for the background and `color.feedback.<variant>` for the border, icon and links; text is `color.text.primary`. `stroke.control` sets the border, `shape.container` the corners, `typography.body.*` the text, and `decoration.underlineThickness`, `underlineDash` and `underlinePeriod` the link underline. The close button uses `closeButton.state.hover.background`, `closeButton.state.hover.shadowColor`, `elevation.offset.*`, `lift.*` and `shape.compact`.","attributes":[{"name":"variant","type":{"text":"AlertVariant"},"default":"\"info\"","description":"The feedback role: `info` (default), `success`, `warning` or `error`. Each has its own icon and colours.","fieldName":"variant"},{"name":"dismissible","type":{"text":"boolean"},"default":"false","description":"Adds a \"Close\" button after the content; selecting it fires `oh-close` and hides the alert.","fieldName":"dismissible"},{"name":"live","type":{"text":"boolean"},"default":"false","description":"When true, adds role=\"alert\" for screen reader announcement.\nUse for dynamically inserted alerts only, not for static page content.","fieldName":"live"}],"members":[{"kind":"field","name":"variant","type":{"text":"AlertVariant"},"default":"\"info\"","description":"The feedback role: `info` (default), `success`, `warning` or `error`. Each has its own icon and colours.","attribute":"variant","reflects":true},{"kind":"field","name":"dismissible","type":{"text":"boolean"},"default":"false","description":"Adds a \"Close\" button after the content; selecting it fires `oh-close` and hides the alert.","attribute":"dismissible","reflects":true},{"kind":"field","name":"live","type":{"text":"boolean"},"default":"false","description":"When true, adds role=\"alert\" for screen reader announcement.\nUse for dynamically inserted alerts only, not for static page content.","attribute":"live","reflects":true}],"events":[{"description":"When the close button is selected, before the alert hides.","name":"oh-close"}],"slots":[{"description":"The message. Can include links.","name":""}],"cssParts":[{"description":"The alert box.","name":"alert"},{"description":"The message wrapper.","name":"content"},{"description":"The close button (only when `dismissible`).","name":"close"}],"released":null},{"tagName":"oh-badge","pkg":"@orange-halo/components","description":"A short, non-interactive label that shows the status or category of the thing next to it.\n\n**Use it for** a status (\"Delivered\", \"Pending\"), a count or a tag next to the item it describes. **Don't use it for** anything the user can select or remove, such as a filter (use `oh-tag`), or an action (use `oh-button` or a link); or for a message with more than a word or two (use `oh-alert`).\n\n**Variants:** `brand` (default) and `accent` for categories; `success`, `warning`, `error` and `info` for status. **Appearance:** `subtle` (default), for most badges; `filled`, the stronger appearance, for the one status that matters most.\n\n**Sizes:** `md` (default); `lg`, as tall as a small `oh-button` (`badge.size.lg.minHeight`, which follows `button.size.sm.minHeight`), for a badge in a row of buttons. Same text and padding, and still no border or hover, so it reads as a label.\n\n**Parts:** the default slot holds the text; the `icon` slot an optional leading icon, sized to the text.\n\n**Behaviour:** none. It doesn't take focus or respond to the pointer.\n\n**Accessibility:** the badge is plain text to screen readers, so the text must make sense on its own (say \"Pending\", don't rely on the colour). Mark a decorative icon `aria-hidden`.\n\n**Look:** set by tokens. Subtle uses the variant's `color.feedback.<variant>Subtle`, `color.brand.primarySubtle` or `color.brand.accentSubtle` background with the role colour as text; filled uses the role colour (`color.feedback.<variant>`, `color.brand.primary`, `color.brand.accent`) as background with `color.text.on<Role>` as text. `shape.compact` sets the corners; `typography.body.*`, `typography.label.base.fontWeight` and `typography.control.letterSpacing` the text.","attributes":[{"name":"variant","type":{"text":"BadgeVariant"},"default":"\"brand\"","description":"`brand` (default) or `accent` for a category; `success`, `warning`, `error` or `info` for a status.","fieldName":"variant"},{"name":"appearance","type":{"text":"BadgeAppearance"},"default":"\"subtle\"","description":"`subtle` (default) for most badges; `filled`, the stronger appearance, for the one status that matters most","fieldName":"appearance"},{"name":"size","type":{"text":"BadgeSize"},"default":"\"md\"","description":"`md` (default); `lg`, as tall as a small button, for a badge in a row of them","fieldName":"size"}],"members":[{"kind":"field","name":"variant","type":{"text":"BadgeVariant"},"default":"\"brand\"","description":"`brand` (default) or `accent` for a category; `success`, `warning`, `error` or `info` for a status.","attribute":"variant","reflects":true},{"kind":"field","name":"appearance","type":{"text":"BadgeAppearance"},"default":"\"subtle\"","description":"`subtle` (default) for most badges; `filled`, the stronger appearance, for the one status that matters most","attribute":"appearance","reflects":true},{"kind":"field","name":"size","type":{"text":"BadgeSize"},"default":"\"md\"","description":"`md` (default); `lg`, as tall as a small button, for a badge in a row of them","attribute":"size","reflects":true}],"slots":[{"description":"The badge text.","name":""},{"description":"Optional leading icon.","name":"icon"}],"cssParts":[{"description":"The badge.","name":"badge"}],"released":null},{"tagName":"oh-breadcrumb","pkg":"@orange-halo/components","description":"A breadcrumb trail showing where the current page sits in the site's hierarchy.\n\n**Use it for** pages two or more levels deep in a hierarchy. **Don't use it\nfor** a site's main navigation (use `oh-navbar`) or for steps in a process.\n\n**Parts:** pass `items`, an array of `{ label, href }`, from the top level\ndown. The last item is the current page and is shown as text, not a link.\n\n**Behaviour:** below the `size.breakpoint.sm` width the trail collapses to a\nsingle \"Back to [parent]\" link to the second-to-last item; with one item,\nnothing shows there. Link underlines retract on hover; keyboard focus\n(`:focus-visible`) shows a solid underline and a background tint, as\n`oh-link` does. The back link's chevron is `oh-icon` `chevron-left`, which\nmirrors in right-to-left pages.\nTransitions are cut short under `prefers-reduced-motion`. Renders nothing\nwhen `items` is empty.\n\n**Accessibility:** renders `<nav aria-label=\"Breadcrumb\">` with an ordered\nlist, `aria-current=\"page\"` on the last item and `aria-hidden` separators.\nUse one breadcrumb per page.\n\n**Look:** set by tokens — `color.text.link` the links,\n`decoration.underlineThickness`, `decoration.underlineDash` and\n`decoration.underlinePeriod` their underline; `color.brand.primary` at\n`decoration.underlineFocusThickness` the focus underline, `focus.decorationColor`\nthe focus tint (none where a brand's glow is transparent) and `shape.tight`\nits corners;\n`color.text.primary` and `typography.label.base.fontWeight` the current\npage; `color.text.secondary` the separators; `typography.body.*` the text;\n`spacing.*` the gaps; `motion.relaxed` and `motion.easeGentle` the\ntransitions.","attributes":[{"name":"items","type":{"text":"BreadcrumbItem[]"},"default":"[]","description":"The trail, from the top level down, as `{ label, href }` objects. The last item is the current page and shows as text. Set it as a property, or as JSON in the attribute.","fieldName":"items"}],"members":[{"kind":"field","name":"items","type":{"text":"BreadcrumbItem[]"},"default":"[]","description":"The trail, from the top level down, as `{ label, href }` objects. The last item is the current page and shows as text. Set it as a property, or as JSON in the attribute.","attribute":"items"}],"released":null},{"tagName":"oh-button","pkg":"@orange-halo/components","description":"A button that starts an action, or a link styled as a button when `href` is set.\n\n**Use it for** actions: submitting, saving, opening a dialog, confirming.\n**Don't use it for** links inside running text (use `oh-link`).\n\n**Parts:** the default slot holds the label. `icon-left` and `icon-right`\ntake an `oh-icon` beside it. An `icon-only` button takes its `oh-icon` in the\ndefault slot, and its name from `accessible-label`.\n\n**Variants:** `primary` for the main action, `secondary` for the others,\n`accent` for an action that takes the accent colour role. **Sizes:** `sm`, `md` (default), `lg`.\n**States:** rest, hover, active, focus and `loading`.\n\n**Behaviour:** fires `oh-click` when the inner `<button>` is clicked, except\nwhile `loading`. `loading` shows `oh-spinner` in the label's place, keeps the label for screen\nreaders, sets `aria-busy` and `aria-disabled` and ignores clicks, while the\nbutton stays focusable. With `href` it renders an `<a>` (and\n`target=\"_blank\"` adds `rel=\"noopener noreferrer\"`); link buttons don't fire\n`oh-click`. It has no `disabled` property and doesn't submit a form by\nitself: handle `oh-click`. Under `prefers-reduced-motion` it doesn't move.\nAn `icon-only` button can show its name on hover and focus inside `oh-tooltip`.\n\n**Accessibility:** focus shows a solid underline on the label. An\n`icon-only` button has no visible text, so always set `accessible-label`\n(not `aria-label`, which isn't forwarded into the shadow root).\n\n**Look:** set by tokens — `stroke.control` (border width), `shape.control`\n(corners), `typography.control.*` (type), `button.variant.<variant>.*`\n(background, text, border and shadow colour per state), `button.size.<size>.*`\n(font size, padding, minimum height), `elevation.offset.*` (shadow offset)\nand `lift.hoverMd` / `lift.activeMd` (movement on hover and press).","attributes":[{"name":"variant","type":{"text":"ButtonVariant"},"default":"\"primary\"","description":"`primary` for the main action, `secondary` for the others, `accent` for an action in the accent colour role.","fieldName":"variant"},{"name":"size","type":{"text":"ButtonSize"},"default":"\"md\"","description":"`sm`, `md` (default) or `lg`: the font size, padding and minimum height.","fieldName":"size"},{"name":"loading","type":{"text":"boolean"},"default":"false","description":"Shows a spinner and ignores clicks while an action runs. The label stays for screen readers and the button stays focusable.","fieldName":"loading"},{"name":"icon-only","type":{"text":"boolean"},"default":"false","description":"A square button showing only its icon. Always set `accessible-label` with it, as there's no visible text.","fieldName":"iconOnly"},{"name":"accessible-label","type":{"text":"string | undefined"},"description":"Accessible name for the inner button/anchor. Required for icon-only\nbuttons. Use this, not aria-label: an aria-label on the host isn't\nforwarded into the shadow root.","fieldName":"accessibleLabel"},{"name":"force-state","type":{"text":"ButtonState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'active' | 'focus'","fieldName":"forceState"},{"name":"href","type":{"text":"string | undefined"},"description":"When provided, renders as an anchor tag instead of a button","fieldName":"href"},{"name":"target","type":{"text":"string | undefined"},"description":"Target for the link (e.g., \"_blank\" for new tab)","fieldName":"target"}],"members":[{"kind":"field","name":"variant","type":{"text":"ButtonVariant"},"default":"\"primary\"","description":"`primary` for the main action, `secondary` for the others, `accent` for an action in the accent colour role.","attribute":"variant","reflects":true},{"kind":"field","name":"size","type":{"text":"ButtonSize"},"default":"\"md\"","description":"`sm`, `md` (default) or `lg`: the font size, padding and minimum height.","attribute":"size","reflects":true},{"kind":"field","name":"loading","type":{"text":"boolean"},"default":"false","description":"Shows a spinner and ignores clicks while an action runs. The label stays for screen readers and the button stays focusable.","attribute":"loading","reflects":true},{"kind":"field","name":"iconOnly","type":{"text":"boolean"},"default":"false","description":"A square button showing only its icon. Always set `accessible-label` with it, as there's no visible text.","attribute":"icon-only","reflects":true},{"kind":"field","name":"accessibleLabel","type":{"text":"string | undefined"},"description":"Accessible name for the inner button/anchor. Required for icon-only\nbuttons. Use this, not aria-label: an aria-label on the host isn't\nforwarded into the shadow root.","attribute":"accessible-label"},{"kind":"field","name":"forceState","type":{"text":"ButtonState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'active' | 'focus'","attribute":"force-state","reflects":true},{"kind":"field","name":"href","type":{"text":"string | undefined"},"description":"When provided, renders as an anchor tag instead of a button","attribute":"href"},{"kind":"field","name":"target","type":{"text":"string | undefined"},"description":"Target for the link (e.g., \"_blank\" for new tab)","attribute":"target"},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}],"description":"Focus the internal button/anchor element"},{"kind":"method","name":"blur","description":"Blur the internal button/anchor element"}],"events":[{"description":"The button was clicked (not while loading). `detail.originalEvent` is the click.","name":"oh-click"}],"slots":[{"description":"The label.","name":""},{"description":"An icon before the label.","name":"icon-left"},{"description":"An icon after the label.","name":"icon-right"}],"cssParts":[{"description":"The inner `<button>` or `<a>`.","name":"button"}],"released":null},{"tagName":"oh-callout","pkg":"@orange-halo/components","description":"A passive note that sits beside the content it's about: a tip, an aside or something good to know.\n\n**Use it for** supporting information people can read or skip: a tip next to a setting, an aside in an article, what a choice will reveal. **Don't use it for** feedback on something that just happened, or anything urgent (use `oh-alert`); for an error (use `oh-alert variant=\"error\"`, or the field's own error message); or for a short status (use `oh-badge`).\n\n**Variants:** `neutral` (default), for most notes; `brand`, for a tip in the brand's voice; `info`, `success` and `warning`, by their feedback role, for a note that leans one way (a warning callout is a caution to read first, not an error).\n\n**Parts:** the default slot holds the note, which can include a lead-in in `<strong>`, paragraphs and links. `icon` adds any `oh-icon` before it.\n\n**Behaviour:** none. It doesn't take focus and never announces itself.\n\n**Accessibility:** `role=\"note\"`, read in place, in order. It isn't a live region, so adding one later doesn't announce it: if people must hear it, use `oh-alert` with `live`. The icon is decorative (`aria-hidden`), so put the meaning in the text, not in the colour or the icon.\n\n**Look:** set by tokens. `neutral` uses `color.surface.container` with a bar in `color.border.emphasis`; `brand` uses `color.brand.primarySubtle` and `color.brand.primary`; `info`, `success` and `warning` use `color.feedback.<variant>Subtle` and `color.feedback.<variant>`. The bar is `stroke.control` wide on the inline-start side. Text is `color.text.primary` in `typography.body.base.*`; the icon takes the bar's colour. Inside, `color.text.link` is remapped to `color.text.linkOnContainer`, which keeps links at 4.5:1 on every fill. `shape.container` sets the corners.","attributes":[{"name":"variant","type":{"text":"CalloutVariant"},"default":"\"neutral\"","description":"The note's role: `neutral` (default), `brand`, `info`, `success` or `warning`. Sets the fill, the bar and the icon colour.","fieldName":"variant"},{"name":"icon","type":{"text":"IconName | undefined"},"description":"An `oh-icon` name to show before the note, such as `sparkle` for a tip. Decorative: the text carries the meaning.","fieldName":"icon"}],"members":[{"kind":"field","name":"variant","type":{"text":"CalloutVariant"},"default":"\"neutral\"","description":"The note's role: `neutral` (default), `brand`, `info`, `success` or `warning`. Sets the fill, the bar and the icon colour.","attribute":"variant","reflects":true},{"kind":"field","name":"icon","type":{"text":"IconName | undefined"},"description":"An `oh-icon` name to show before the note, such as `sparkle` for a tip. Decorative: the text carries the meaning.","attribute":"icon"}],"slots":[{"description":"The note. Can include a lead-in in `<strong>`, paragraphs and links.","name":""}],"cssParts":[{"description":"The callout box.","name":"callout"},{"description":"The icon (only when `icon` is set).","name":"icon"},{"description":"The note's wrapper.","name":"content"}],"released":null},{"tagName":"oh-card","pkg":"@orange-halo/components","description":"A surface that groups related content (a summary, a teaser, a settings group), with optional header and footer.\n\n**Use it for** a self-contained block of content among others, such as a teaser that links to more detail. **Don't use it for** page layout or spacing alone (use `oh-stack`, `oh-grid`); for a message that needs attention (use `oh-alert`); or for a single action (use `oh-button`).\n\n**Variants:** `default`, the standard card; `featured`, for the one card that should stand out; `subtle`, a quieter card, for dense layouts. **Padding:** `none`, `sm`, `md` (default), `lg` set the content padding (and the header and footer padding to match). With `none`, the content sets its own padding.\n\n**Actions:** a card that leads somewhere has one call to action under its content: an `oh-link` with `variant=\"standalone\"` and `arrow`, named for where it goes (\"Read the guide\", not \"Learn more\"), so each one makes sense on its own in a list of links. A card with actions puts them as buttons in the `footer` slot. The heading stays plain text, and the card itself isn't a click target, so every card works the same way and only what looks clickable is.\n\n**Accessibility:** links inside use `color.text.linkOnContainer`, which keeps contrast on card surfaces. Headings inside a card stay headings, and each link or button is named by its own text.\n\n**Look:** set by tokens. `card.variant.<variant>.gradientStart`/`gradientMid`/`gradientEnd` set each variant's surface, `card.variant.<variant>.borderColor` and `card.base.borderWidth` its border, `shape.large` the corners, and `elevation.surface.default`/`subtle`/`featured` its shadow. Header and footer dividers use `card.base.dividerColor` and `stroke.divider`; the header surface uses `card.base.headerBackgroundStart`/`End`, the footer `color.surface.container` to `color.surface.inset`.","attributes":[{"name":"variant","type":{"text":"CardVariant"},"default":"\"default\"","description":"`default`, `featured` for the one card that should stand out, or `subtle`, a quieter card for dense layouts.","fieldName":"variant"},{"name":"padding","type":{"text":"CardPadding"},"default":"\"md\"","description":"The content padding, which the header and footer match: `none`, `sm`, `md` (default) or `lg`. With `none`, the content sets its own.","fieldName":"padding"}],"members":[{"kind":"field","name":"variant","type":{"text":"CardVariant"},"default":"\"default\"","description":"`default`, `featured` for the one card that should stand out, or `subtle`, a quieter card for dense layouts.","attribute":"variant","reflects":true},{"kind":"field","name":"padding","type":{"text":"CardPadding"},"default":"\"md\"","description":"The content padding, which the header and footer match: `none`, `sm`, `md` (default) or `lg`. With `none`, the content sets its own.","attribute":"padding","reflects":true}],"slots":[{"description":"The card's main content.","name":""},{"description":"Optional header, above the content, with a divider below. Not drawn when nothing is slotted.","name":"header"},{"description":"Optional footer, below the content, with a divider above (e.g. actions). Not drawn when nothing is slotted.","name":"footer"}],"cssParts":[{"description":"The card surface.","name":"card"},{"description":"The header wrapper.","name":"header"},{"description":"The content wrapper.","name":"content"},{"description":"The footer wrapper.","name":"footer"}],"released":null},{"tagName":"oh-chart","pkg":"@orange-halo/components","description":"A chart: ranked bars, columns, lines, a donut or dots along a line, with a caption, a takeaway, keyboard access to every point and a table view.\n\n**Use it for** data that's easier to see than to read: amounts compared across categories (`bar`), a few periods side by side (`column`), change over time (`line`), parts of a whole (`donut`), or when things happened, a row per category (`dot`: every gig for each of a few artists, say). **Don't use it for** a few exact numbers (use `oh-description-list` with `value-size=\"lg\"`) or data people look things up in (use `oh-table`). See Foundation / Data visualisation for choosing a chart.\n\n**Data:** set the `data` property to `{ labels, series }`: `labels` are the categories, in order, and `series` is one `{ name, values }` with a value per label (`null` when it's missing); a `line` chart takes up to five series. Colour follows the series, not its position: give each line's series a `color` slot (1 to 5), and a donut's `data.colors` one per part, so the rest keep their colours when one is filtered out; without them, the slot is the position. A slot used twice warns in the console. Bars and columns start at zero; values below zero aren't supported yet. Rank a bar chart's data yourself, largest first, unless the categories have their own order. Bars and columns can lead somewhere: `data.links` gives each one's address, in label order (`null` for one that doesn't), and those bars or columns become links. A dot chart takes `data.dots` instead of `series`: `{ label, at, name }` for each dot, where `label` is its row (one of `labels`), `at` is where it falls (a `Date`, for a time axis, or a number) and `name` says what it is. `formatValue` formats each value in labels, names and the table (default: the page language's number format); the value axis shows plain numbers, so put the unit in the caption.\n\n**Types:** `bar` draws horizontal bars with the label before each bar and the value after it; when the chart is narrow (or the text large), each label moves above its bar. `column` draws vertical columns over a value axis with gridlines; each column's value shows when it's focused or hovered. **Sizes:** `md` (default) and `sm`, a shorter plot (`chart.size.sm.plotHeight`) for a chart that sits beside a short list or a few figures. Category labels under columns and lines stay on one line; when they don't all fit, every second (third, fifth…) one shows, from the first, and every point still has its name on focus and in the table. `line` draws each series as a line over the same axis, with a marker at each value; series differ by colour, dash pattern and marker shape, and with two or more there's a legend and each line's name at its end. A missing value leaves a gap in its line. `dot` draws a row per label with a dot for each of its items along one axis under all the rows: years on a time axis (every year, or every 2, 5, 10… when they don't all fit), round numbers otherwise. A dot's date (or value) and name show beside it when it's focused or hovered; when the chart is narrow, each row's label moves above its dots. `donut` shows parts of a whole (four at most; it warns beyond that), with a gap between slices and a label beside each one giving its value and share; when there isn't room beside the donut, the labels are a list under it.\n\n**Parts:** `caption` names the chart; it's required, and the chart warns in the console without it. When a heading right above already names the chart, give `caption` the same words and set `hide-caption`: the caption still names the chart for screen readers but isn't shown twice. `summary` says, in one sentence, what the chart shows (\"March was the busiest month\"); it's recommended when the data has a clear takeaway, and left out (not invented) when it doesn't. Under the plot, a \"Show as table\" section (an `oh-accordion`, its heading at `heading-level`) holds the same data in an `oh-table`, whose first column header is `category-label` (a dot chart's table has a row per dot, with `value-label` and `detail-label` as its other headers); the caption is added to its heading for screen readers, so several charts' tables can be told apart. `hide-table` leaves this section out when the data is already readable as text: the page shows it in a table of its own (two small charts sharing one, say), or the chart is a bar chart, whose every label and value is on screen and in each bar's name. Never set it on another chart without that table.\n\n**Keyboard:** the chart is one Tab stop. Tab moves to the last point you were on (the first, to begin with); the arrow keys move to the next and previous point, swapped in right-to-left pages; Home and End move to the first and last. In a line chart, Left and Right move along a line and Up and Down move to the same point (or the nearest one with a value) on the next or previous line; in a dot chart, Left and Right move along a row, Home and End to its ends, and Up and Down to the nearest dot on the next or previous row. Enter follows a linked bar or column (in a new tab with Ctrl, Cmd or Shift, as a click with them does). Each point is announced as \"category: value\" (\"series, category: value\" in a line chart with several lines; \"part: value, share\" in a donut; \"row, date: name\" in a dot chart). Escape hides a column's value label until you move on.\n\n**Motion:** the first time the chart scrolls into view, bars and columns grow from the baseline, lines draw from the start, and donut slices sweep round; marks move to new values when the data changes. Timed by `motion.*`. With `prefers-reduced-motion` they appear in place.\n\n**Accessibility:** the plot is a group named by the caption and described by the takeaway; each point is an image named by its category and value, and a linked bar or column is a link with the same name. Linked bars and columns are `role=\"link\"` rather than `<a>` elements, so they stay in the chart's single Tab stop in Safari, which skips `<a>` elements on Tab by default; their labels (a column's is under it) take the link colour and dashed underline, so you can see which ones lead somewhere, and clicking a column's label follows its link too. Colour is never the only cue: every bar and donut slice is labelled, a column's or point's value appears beside it on focus or hover, and lines differ by dash and marker shape too. Under Windows high contrast, marks use system colours.\n\n**Look:** set by tokens. `color.data.categorical.1` colours bars and columns, and `color.data.muted` the others while one is focused or hovered (lines and slices keep their colours, since no grey stays clear of all five); `color.data.grid` and `color.data.axis` the gridlines and baseline (`stroke.divider` wide); `typography.label.base.*` the caption, `typography.body.base.*` the takeaway, `typography.body.sm.*` the axis and value labels, in `color.text.secondary` and `color.text.primary`; `shape.tight` the marks' data ends; `color.data.categorical.1` to `.5` the lines and slices, by slot (a donut part past the fifth takes `color.data.muted`); `chart.base.*` (and `chart.size.sm.plotHeight`) the plot height, bar thickness, column widths, line width, marker size (also a dot's size), dot row height and donut thickness; `color.text.link` and `decoration.underline*` a linked bar's or column's label; `color.data.grid` a dot chart's row lines, and a `stroke.data` ring in `color.surface.base` around each dot, so dots that overlap stay apart; `focus.ring*` the focus indicator; `motion.relaxed`, `motion.slow`, `motion.easeOut` and `motion.quick` the motion.","attributes":[{"name":"type","type":{"text":"ChartType"},"default":"\"column\"","description":"`bar` (horizontal, ranked), `column` (vertical), `line` (change over time, up to five series), `donut` (parts of a whole, up to four) or `dot` (when things happened, a row per category).","fieldName":"type"},{"name":"caption","type":{"text":"string"},"default":"\"\"","description":"The chart's name. Required.","fieldName":"caption"},{"name":"size","type":{"text":"ChartSize"},"default":"\"md\"","description":"`md` (default) or `sm`, a shorter plot for a chart beside a short list or a few figures","fieldName":"size"},{"name":"hide-caption","type":{"text":"boolean"},"default":"false","description":"Hides the caption on screen (screen readers still use it), for a chart under a heading that already names it","fieldName":"hideCaption"},{"name":"hide-table","type":{"text":"boolean"},"default":"false","description":"Leaves out the \"Show as table\" section: for a chart whose data the page already shows in a table of its own (several charts sharing one, say), or a bar chart, whose labels and values are all on screen. Never set it on another chart without that table.","fieldName":"hideTable"},{"name":"summary","type":{"text":"string"},"default":"\"\"","description":"One sentence saying what the chart shows. Optional: leave it out rather than invent one.","fieldName":"summary"},{"name":"data","type":{"text":"ChartData"},"default":"{ labels: [], series: [] }","description":"`{ labels, series }`: the categories, and the series of values (one, or up to five for `line`).","fieldName":"data"},{"name":"category-label","type":{"text":"string"},"default":"\"Category\"","description":"The table view's header for the categories column.","fieldName":"categoryLabel"},{"name":"heading-level","type":{"text":"2 | 3 | 4 | 5 | 6"},"default":"3","description":"The level of the \"Show as table\" heading, to fit the page's outline.","fieldName":"headingLevel"},{"name":"value-label","type":{"text":"string"},"default":"\"\"","description":"Dot charts: the table's header for where each dot falls. Default: \"Date\" on a time axis, \"Value\" otherwise.","fieldName":"valueLabel"},{"name":"detail-label","type":{"text":"string"},"default":"\"Details\"","description":"Dot charts: the table's header for the dots' names.","fieldName":"detailLabel"},{"name":"empty-text","type":{"text":"string"},"default":"\"No data to show.\"","description":"Shown instead of the plot when there's no data.","fieldName":"emptyText"}],"members":[{"kind":"field","name":"type","type":{"text":"ChartType"},"default":"\"column\"","description":"`bar` (horizontal, ranked), `column` (vertical), `line` (change over time, up to five series), `donut` (parts of a whole, up to four) or `dot` (when things happened, a row per category).","attribute":"type","reflects":true},{"kind":"field","name":"caption","type":{"text":"string"},"default":"\"\"","description":"The chart's name. Required.","attribute":"caption"},{"kind":"field","name":"size","type":{"text":"ChartSize"},"default":"\"md\"","description":"`md` (default) or `sm`, a shorter plot for a chart beside a short list or a few figures","attribute":"size","reflects":true},{"kind":"field","name":"hideCaption","type":{"text":"boolean"},"default":"false","description":"Hides the caption on screen (screen readers still use it), for a chart under a heading that already names it","attribute":"hide-caption","reflects":true},{"kind":"field","name":"hideTable","type":{"text":"boolean"},"default":"false","description":"Leaves out the \"Show as table\" section: for a chart whose data the page already shows in a table of its own (several charts sharing one, say), or a bar chart, whose labels and values are all on screen. Never set it on another chart without that table.","attribute":"hide-table","reflects":true},{"kind":"field","name":"summary","type":{"text":"string"},"default":"\"\"","description":"One sentence saying what the chart shows. Optional: leave it out rather than invent one.","attribute":"summary"},{"kind":"field","name":"data","type":{"text":"ChartData"},"default":"{ labels: [], series: [] }","description":"`{ labels, series }`: the categories, and the series of values (one, or up to five for `line`).","attribute":"data"},{"kind":"field","name":"formatValue","type":{"text":"(value: number) => string | undefined"},"description":"Formats each value for labels, names and the table. Default: the page language's number format."},{"kind":"field","name":"categoryLabel","type":{"text":"string"},"default":"\"Category\"","description":"The table view's header for the categories column.","attribute":"category-label"},{"kind":"field","name":"headingLevel","type":{"text":"2 | 3 | 4 | 5 | 6"},"default":"3","description":"The level of the \"Show as table\" heading, to fit the page's outline.","attribute":"heading-level"},{"kind":"field","name":"valueLabel","type":{"text":"string"},"default":"\"\"","description":"Dot charts: the table's header for where each dot falls. Default: \"Date\" on a time axis, \"Value\" otherwise.","attribute":"value-label"},{"kind":"field","name":"detailLabel","type":{"text":"string"},"default":"\"Details\"","description":"Dot charts: the table's header for the dots' names.","attribute":"detail-label"},{"kind":"field","name":"emptyText","type":{"text":"string"},"default":"\"No data to show.\"","description":"Shown instead of the plot when there's no data.","attribute":"empty-text"}],"cssParts":[{"description":"The figure around the whole chart.","name":"chart"},{"description":"The plot: the bars or columns and their axes.","name":"plot"}],"released":null},{"tagName":"oh-checkbox-group","pkg":"@orange-halo/components","description":"A set of related checkboxes under one legend, where any number can be\nchosen.\n\n**Use it for** choosing any number of options from a short list, such as\ninterests or notification types. **Don't use it for** one standalone\nyes/no option (use `oh-checkbox`), exactly one choice (use\n`oh-radio-group`, or `oh-select` for a long list), or settings that apply\nstraight away (use `oh-toggle`).\n\n**Parts:** a `label` (rendered as the fieldset's `<legend>`) and a list of `options` (`{ label, value }`).\n`value` is the array of checked option values. **States:** each option\nunchecked, checked, hover, active and focus; the group can be `required`\n(a marker on the label), disabled, and in error (set `error-text`).\n\n**Behaviour:** Tab moves through the options and Space toggles one. Each\nchange updates `value` and fires `oh-change` with the new array. In a\nnative `<form>` it submits each checked value under `name`, as a set of\nsame-named native checkboxes does (`FormData.getAll(name)` reads them\nall); `required` blocks submitting with none checked, reset restores the\nstarting values, and `disabled` (or a disabled `<fieldset>` around it)\ntakes every option out of the tab order and the form.\n\n**Accessibility:** a `<fieldset>` with a `<legend>`, so screen readers\nread the label with each option. Always set `label`. The error shows\nafter the legend and before the options, with an icon; the fieldset gets\n`aria-invalid` and `aria-describedby`, and the error is announced\n(`role=\"alert\"`) only when it appears after first render. Focus underlines\nthe option's label.\n\n**Look:** set by tokens — the same as `oh-checkbox`: `stroke.control` in\n`color.border.emphasis` (border), `shape.compact` (corners),\n`elevation.offset.*` with `elevation.color.secondary` / `elevation.color.primary` (shadow),\n`lift.hoverSm` / `lift.activeSm` (movement on hover and press),\n`color.brand.primary` and `color.text.onBrand` (checked),\n`color.feedback.error` and `elevation.color.error` (error); `typography.control.*`\nfor the legend and labels; `color.surface.disabled`, `color.border.disabled`\nand `color.text.disabled` (disabled).","attributes":[{"name":"label","type":{"text":"string"},"default":"\"\"","description":"The group's label, rendered as the fieldset's <legend>. Always set one","fieldName":"label"},{"name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name each checked value is submitted under.","fieldName":"name"},{"name":"options","type":{"text":"CheckboxOption[]"},"default":"[]","description":"The checkboxes, as `{ label, value }` objects. Set it as a property, or as JSON in the attribute.","fieldName":"options"},{"name":"value","type":{"text":"string[]"},"default":"[]","description":"The values of the checked options, in option order. Updated on every change.","fieldName":"value"},{"name":"required","type":{"text":"boolean"},"default":"false","description":"At least one box must be ticked: marks the label and blocks a native form from submitting while none is.","fieldName":"required"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","fieldName":"disabled"},{"name":"error-text","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","fieldName":"errorText"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"The group's label, rendered as the fieldset's <legend>. Always set one","attribute":"label"},{"kind":"field","name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name each checked value is submitted under.","attribute":"name"},{"kind":"field","name":"options","type":{"text":"CheckboxOption[]"},"default":"[]","description":"The checkboxes, as `{ label, value }` objects. Set it as a property, or as JSON in the attribute.","attribute":"options"},{"kind":"field","name":"value","type":{"text":"string[]"},"default":"[]","description":"The values of the checked options, in option order. Updated on every change.","attribute":"value"},{"kind":"field","name":"required","type":{"text":"boolean"},"default":"false","description":"At least one box must be ticked: marks the label and blocks a native form from submitting while none is.","attribute":"required","reflects":true},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","attribute":"disabled","reflects":true},{"kind":"field","name":"form","description":"The form this group belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}]},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]},{"kind":"field","name":"errorText","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","attribute":"error-text"}],"events":[{"description":"An option was toggled. detail: { value } (the checked values)","name":"oh-change"}],"released":null},{"tagName":"oh-checkbox","pkg":"@orange-halo/components","description":"A single checkbox with its label, for turning one option on or off.\n\n**Use it for** one yes/no choice, such as agreeing to terms, or as part of\na set where any number can be chosen. **Don't use it for** a set of\nrelated options on its own (use `oh-checkbox-group`, which adds the\nfieldset and legend), one choice from several (use `oh-radio-group`), or a\nsetting that applies straight away (use `oh-toggle`).\n\n**States:** unchecked, checked, hover, active, focus, error (set\n`error-text`), required, disabled.\n\n**Behaviour:** clicking the box or the label toggles it, as does Space\nwhen it's focused. Each change sets `checked` and fires `oh-change`. In a\nnative `<form>`, a checked checkbox submits `value` (`on` if unset) under\n`name`, as a native checkbox does; `required` blocks submitting while it's\nunchecked, reset restores the starting `checked`, and `disabled` (or a\ndisabled `<fieldset>` around it) takes it out of the tab order and the\nform.\n\n**Accessibility:** a real native checkbox, visually hidden, carries the\nrole, state and keyboard behaviour; the drawn box is decoration. Always\nset `label`: it's the checkbox's name. Focus underlines the label. The\nerror message shows under the checkbox with an icon, sets `aria-invalid`\nand is linked with `aria-describedby`; it's announced (`role=\"alert\"`)\nonly when it appears after first render.\n\n**Look:** set by tokens — `stroke.control` in `color.border.emphasis`\n(border), `shape.compact` (corners), `typography.control.*` (label),\n`elevation.offset.*` and `elevation.color.secondary` (shadow), `lift.hoverSm` /\n`lift.activeSm` (movement on hover and press), `color.border.hover`\n(hover), `color.brand.primary` (and its hover and active tokens),\n`color.text.onBrand` and `elevation.color.primary` (checked),\n`color.feedback.error` and `elevation.color.error` (error),\n`color.surface.disabled`, `color.border.disabled` and\n`color.text.disabled` (disabled).","attributes":[{"name":"checked","type":{"text":"boolean"},"default":"false","description":"Whether the box is ticked. Updated when the user toggles it; reset restores the starting value.","fieldName":"checked"},{"name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label, which also names the checkbox. Always set it.","fieldName":"label"},{"name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name it submits under while checked.","fieldName":"name"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"The value submitted while checked (`on` if empty).","fieldName":"value"},{"name":"required","type":{"text":"boolean"},"default":"false","description":"Must be checked before the form submits","fieldName":"required"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","fieldName":"disabled"},{"name":"error-text","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","fieldName":"errorText"},{"name":"force-state","type":{"text":"CheckboxState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'focus'","fieldName":"forceState"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"checked","type":{"text":"boolean"},"default":"false","description":"Whether the box is ticked. Updated when the user toggles it; reset restores the starting value.","attribute":"checked","reflects":true},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label, which also names the checkbox. Always set it.","attribute":"label"},{"kind":"field","name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name it submits under while checked.","attribute":"name"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"The value submitted while checked (`on` if empty).","attribute":"value"},{"kind":"field","name":"required","type":{"text":"boolean"},"default":"false","description":"Must be checked before the form submits","attribute":"required","reflects":true},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","attribute":"disabled","reflects":true},{"kind":"field","name":"errorText","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","attribute":"error-text"},{"kind":"field","name":"forceState","type":{"text":"CheckboxState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'focus'","attribute":"force-state","reflects":true},{"kind":"field","name":"form","description":"The form this checkbox belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}]},{"kind":"method","name":"blur"},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]}],"events":[{"description":"The checkbox was toggled. detail: { checked, value }","name":"oh-change"}],"cssParts":[{"description":"The drawn checkbox","name":"box"},{"description":"The label text","name":"label"},{"description":"The error message","name":"error"}],"released":null},{"tagName":"oh-cluster","pkg":"@orange-halo/components","description":"A horizontal group of items that wraps onto new lines when space runs out.\n\n**Use it for** button groups, tags and rows of links. **Don't use it for**\nvertical lists (use `oh-stack`) or equal-width columns (use `oh-grid`).\n\n**Gaps:** `gap` is `none`, `xs` (`spacing.1`), `sm` (`spacing.2`), `md`\n(default, `spacing.4`), `lg` (`spacing.6`) or `xl` (`spacing.8`), between\nitems and between rows. `justify` is `start` (default), `center`, `end`,\n`between` or `around`; `align` is `start`, `center` (default), `end` or\n`baseline`. `nowrap` keeps everything on one line. `align` lines the items\nup; it doesn't change how the text inside them is aligned.","attributes":[{"name":"gap","type":{"text":"ClusterGap"},"default":"\"md\"","description":"The space between items and between rows: `none`, `xs`, `sm`, `md` (default), `lg` or `xl`, from the `spacing` scale.","fieldName":"gap"},{"name":"justify","type":{"text":"ClusterJustify"},"default":"\"start\"","description":"How items sit along the row: `start` (default), `center`, `end`, `between` or `around`.","fieldName":"justify"},{"name":"align","type":{"text":"ClusterAlign"},"default":"\"center\"","description":"How items line up across the row: `start`, `center` (default), `end` or `baseline`.","fieldName":"align"},{"name":"nowrap","type":{"text":"boolean"},"default":"false","description":"Keeps every item on one line instead of wrapping.","fieldName":"nowrap"}],"members":[{"kind":"field","name":"gap","type":{"text":"ClusterGap"},"default":"\"md\"","description":"The space between items and between rows: `none`, `xs`, `sm`, `md` (default), `lg` or `xl`, from the `spacing` scale.","attribute":"gap","reflects":true},{"kind":"field","name":"justify","type":{"text":"ClusterJustify"},"default":"\"start\"","description":"How items sit along the row: `start` (default), `center`, `end`, `between` or `around`.","attribute":"justify","reflects":true},{"kind":"field","name":"align","type":{"text":"ClusterAlign"},"default":"\"center\"","description":"How items line up across the row: `start`, `center` (default), `end` or `baseline`.","attribute":"align","reflects":true},{"kind":"field","name":"nowrap","type":{"text":"boolean"},"default":"false","description":"Keeps every item on one line instead of wrapping.","attribute":"nowrap","reflects":true}],"slots":[{"description":"The items to group.","name":""}],"released":null},{"tagName":"oh-container","pkg":"@orange-halo/components","description":"A centred wrapper that limits content to a maximum width and adds side padding.\n\n**Use it for** the outer width of a page or section. **Don't use it for**\nspacing between items (use `oh-stack`, `oh-cluster` or `oh-grid`).\n\n**Sizes:** `size` picks the max-width: `sm`, `md`, `lg` (default) and `xl`\nuse `layout.container.sm` to `layout.container.xl`; `full` is the full\nwidth with no side padding. `center` centres the text.\n\n**Behaviour:** side padding is `spacing.4`, rising to `spacing.6` from the\n`size.breakpoint.sm` width and `spacing.8` from `size.breakpoint.lg`.","attributes":[{"name":"size","type":{"text":"ContainerSize"},"default":"\"lg\"","description":"The maximum width: `sm`, `md`, `lg` (default) or `xl`, from `layout.container.*`; `full` is the full width with no side padding.","fieldName":"size"},{"name":"center","type":{"text":"boolean"},"default":"false","description":"Centres the text inside.","fieldName":"center"}],"members":[{"kind":"field","name":"size","type":{"text":"ContainerSize"},"default":"\"lg\"","description":"The maximum width: `sm`, `md`, `lg` (default) or `xl`, from `layout.container.*`; `full` is the full width with no side padding.","attribute":"size","reflects":true},{"kind":"field","name":"center","type":{"text":"boolean"},"default":"false","description":"Centres the text inside.","attribute":"center","reflects":true}],"slots":[{"description":"The content to contain.","name":""}],"released":null},{"tagName":"oh-description-list","pkg":"@orange-halo/components","description":"A list of labels and their values: the details of one thing, or a few highlights.\n\n**Use it for** facts about one thing, each with a label: an order's details, a profile, a settings summary, a set of milestones. **Don't use it for** data compared across rows and columns (use `oh-table`); a list of items with no labels (use a list); or a form (use the form controls). A few headline figures (statistics) are this list too, with `layout=\"grid\"` and `value-size=\"lg\"`.\n\n**Parts:** the default slot holds one `<dl>`, written as normal HTML. Each item is a `<div>` with one `<dt>` (the label) and a `<dd>` (the value). A second `<dd>` is a note under the value. A `<dd data-actions>` holds the item's actions, such as a \"Change\" link; give each action visually hidden text that names its item (\"Change name\"), so it makes sense on its own. In a list of figures (`value-size=\"lg\"`), an item whose value is words, such as a name, takes `data-value=\"text\"` on its `<div>`: it's set smaller (`descriptionList.size.lg.text*`) so it fits its column.\n\n**Layout:** `rows` (default) puts each label beside its value, with a line between items and actions at the end; below the `size.breakpoint.sm` width the label sits above the value. `grid` puts each label above its value, with items side by side in as many columns as fit, each at least `descriptionList.base.columnMinWidth` wide and with a line above it.\n\n**Value size:** `md` (default) sets values as body text. `lg` sets them as figures, in `descriptionList.size.lg.value*`, for a few headline numbers (totals, counts) scanned at a glance; use it with `grid`. Labels and notes don't change. One list has one value size: put a value that isn't a figure in its own list.\n\n**Behaviour:** none of its own: it styles the list and adds no roles or focus stops. Long values wrap.\n\n**Accessibility:** a `<dl>` groups each label with its value for assistive tech. Keep the label in the `<dt>` and the value in the `<dd>`, never the other way round, and give a list that has no visible heading nearby a heading before it.\n\n**Look:** set by tokens. `typography.label.base.*` and `color.text.secondary` set the labels; `typography.body.base.*` and `color.text.primary` the values; `typography.body.sm.*` and `color.text.secondary` the notes; `stroke.divider` with `color.border.divider` the lines; `spacing.*` the gaps; `descriptionList.base.columnMinWidth` the grid's narrowest column (`descriptionList.size.lg.columnMinWidth` with large values); `descriptionList.size.lg.value*` large values.","attributes":[{"name":"layout","type":{"text":"DescriptionListLayout"},"default":"\"rows\"","description":"`rows` (label beside value) or `grid` (label above value, items side by side).","fieldName":"layout"},{"name":"value-size","type":{"text":"DescriptionListValueSize"},"default":"\"md\"","description":"`md` (body text) or `lg` (figures, for headline numbers in the grid layout).","fieldName":"valueSize"}],"members":[{"kind":"field","name":"layout","type":{"text":"DescriptionListLayout"},"default":"\"rows\"","description":"`rows` (label beside value) or `grid` (label above value, items side by side).","attribute":"layout","reflects":true},{"kind":"field","name":"valueSize","type":{"text":"DescriptionListValueSize"},"default":"\"md\"","description":"`md` (body text) or `lg` (figures, for headline numbers in the grid layout).","attribute":"value-size","reflects":true}],"slots":[{"description":"One native `<dl>`, each item a `<div>` with a `<dt>` and its `<dd>`s.","name":""}],"released":null},{"tagName":"oh-divider","pkg":"@orange-halo/components","description":"A rule that separates sections of a page or groups of items.\n\n**Use it for** a break between sections that don't each have a heading, or between groups in a toolbar or a footer. **Don't use it for** a card's header or footer line (`oh-card` draws its own); for space alone (use the gap of `oh-stack` or `oh-cluster`); or between every item in a list, where the gap is usually enough.\n\n**Orientation:** `horizontal` (default) runs across the inline axis; `vertical` stands between items in a row (an `oh-cluster`) and is as tall as the row.\n\n**Behaviour:** none. It doesn't take focus. It adds no space of its own: the layout it's in sets the space around it.\n\n**Accessibility:** a native `<hr>`, which screen readers announce as a separator; `vertical` adds `aria-orientation=\"vertical\"`. A divider between sections that already have headings adds little, so leave it out there.\n\n**Look:** set by tokens. `stroke.divider` sets the thickness and `color.border.divider` the colour.","attributes":[{"name":"orientation","type":{"text":"DividerOrientation"},"default":"\"horizontal\"","description":"`horizontal` (default), across the inline axis, or `vertical`, between items in a row.","fieldName":"orientation"}],"members":[{"kind":"field","name":"orientation","type":{"text":"DividerOrientation"},"default":"\"horizontal\"","description":"`horizontal` (default), across the inline axis, or `vertical`, between items in a row.","attribute":"orientation","reflects":true}],"cssParts":[{"description":"The rule (an `<hr>`).","name":"divider"}],"released":null},{"tagName":"oh-drawer","pkg":"@orange-halo/components","description":"A panel that slides in from the side of the viewport, over the page, for navigation or supplementary content.\n\n**Use it for** a site's navigation on small screens, filters, or settings that relate to the page behind. **Don't use it for** a decision the user must make before going on (use `oh-modal`); or for content that should always be visible (put it in the page).\n\n**Parts:** `heading` (an optional visible `h2`), a built-in Close button, and the default slot for the content, which scrolls when it's taller than the viewport.\n\n**Positions:** `start` (the default) or `end` follow the text direction, so in right-to-left text a `start` drawer opens from the right. `left` and `right` are the same physical side in either direction.\n\n**Behaviour:** set `open`, or call `show()` and `hide()`. On open, focus moves to the Close button, Tab and Shift+Tab wrap inside the panel, and the page behind stops scrolling. The Close button, Escape, a click on the backdrop and `hide()` close it and fire `oh-close`; focus then returns to the element that opened it. While closed the panel is `inert`. Motion is off under `prefers-reduced-motion`.\n\n**Accessibility:** the panel is `role=\"dialog\"` with `aria-modal=\"true\"`, labelled by `heading`, or \"Navigation menu\" when there's no heading, so set `heading` for any other use. The Close button's accessible name is \"Close menu\".\n\n**Look:** set by tokens. `color.surface.overlay` sets the backdrop and `color.surface.base` the panel. A start or left drawer's shadow is `elevation.strong`; an end or right drawer's is an `elevation.offset.lg` offset in `color.border.strong`. The heading uses `typography.heading.h5.fontSize`, `typography.heading.h5.lineHeight` and `typography.emphasis.fontWeight`. Motion uses `motion.relaxed` and `motion.easeGentle`. The width is `drawer.base.width`, which `--oh-drawer-width` overrides, and it always leaves `drawer.base.viewportGap` of the viewport uncovered.","attributes":[{"name":"open","type":{"text":"boolean"},"default":"false","description":"Whether the drawer is open","fieldName":"open"},{"name":"position","type":{"text":"DrawerPosition"},"default":"\"start\"","description":"The side the drawer opens from. `start` (the default) and `end` follow the\ntext direction: `start` is the left in left-to-right text and the right in\nright-to-left. `left` and `right` are the same physical side either way.","fieldName":"position"},{"name":"heading","type":{"text":"string | undefined"},"description":"Title shown in the drawer header","fieldName":"heading"}],"members":[{"kind":"field","name":"open","type":{"text":"boolean"},"default":"false","description":"Whether the drawer is open","attribute":"open","reflects":true},{"kind":"field","name":"position","type":{"text":"DrawerPosition"},"default":"\"start\"","description":"The side the drawer opens from. `start` (the default) and `end` follow the\ntext direction: `start` is the left in left-to-right text and the right in\nright-to-left. `left` and `right` are the same physical side either way.","attribute":"position"},{"kind":"field","name":"heading","type":{"text":"string | undefined"},"description":"Title shown in the drawer header","attribute":"heading"},{"kind":"method","name":"show","description":"Public method to open the drawer"},{"kind":"method","name":"hide","description":"Public method to close the drawer"}],"events":[{"name":"oh-close","type":{"text":"CustomEvent"},"description":"When the drawer is closed by the Close button, Escape, the backdrop or `hide()`. Not fired when you set `open` to false yourself."}],"slots":[{"description":"Default slot for drawer content","name":""}],"released":null},{"tagName":"oh-footer","pkg":"@orange-halo/components","description":"A site footer with a logo, copyright line, social links and columns of links.\n\n**Use it for** the footer at the bottom of every page. **Don't use it for**\nthe main navigation (use `oh-navbar`).\n\n**Parts:** the `logo` slot; `copyright`, a line of text under the logo;\nthe `social` slot for `oh-icon` links (with `inverse`); and the default\nslot, where each `oh-stack` becomes a column (start it with a heading, then\n`oh-link`s with `inverse`).\n\n**Behaviour:** the columns follow `oh-grid`'s four-column steps at the\n`size.breakpoint.*` widths; at and below `size.breakpoint.md` the logo\ncolumn spans the full width.\n\n**Accessibility:** renders a `<footer>`. Give the logo an accessible name,\neach social icon a `label`, and the column headings a level that fits the\npage's outline.\n\n**Look:** set by tokens — `color.brand.accent` the background,\n`color.text.onAccent` the text, `typography.body.*` the type, `spacing.8`\nthe vertical padding.","attributes":[{"name":"copyright","type":{"text":"string"},"default":"\"\"","description":"Copyright text","fieldName":"copyright"}],"members":[{"kind":"field","name":"copyright","type":{"text":"string"},"default":"\"\"","description":"Copyright text","attribute":"copyright"}],"slots":[{"description":"Slot for logo element","name":"logo"},{"description":"Slot for social media icons","name":"social"},{"description":"Default slot for link columns (use oh-stack for each column)","name":""}],"released":null},{"tagName":"oh-grid","pkg":"@orange-halo/components","description":"A CSS grid of equal-width columns, fixed or as many as fit.\n\n**Use it for** cards, galleries and other sets of similar items. **Don't\nuse it for** a single column (use `oh-stack`) or items of varying width in\na row (use `oh-cluster`).\n\n**Columns:** `columns` is `1`–`4`, `auto-fit` (default) or `auto-fill`.\nAuto columns are at least `min-width` wide (any CSS length); `auto-fit`\nstretches the items to fill the row, `auto-fill` keeps empty tracks.\n**Gaps:** `gap` is `none`, `xs` (`spacing.1`), `sm` (`spacing.2`), `md`\n(default, `spacing.4`), `lg` (`spacing.6`) or `xl` (`spacing.8`).\n`align-items` is `start`, `center`, `end` or `stretch` (default).\n\n**Behaviour:** fixed columns respond to the viewport: up to\n`size.breakpoint.sm` they become one column; up to `size.breakpoint.md`,\n3 and 4 become 2; up to `size.breakpoint.lg`, 4 becomes 3.","attributes":[{"name":"columns","type":{"text":"GridColumns"},"default":"\"auto-fit\"","description":"`1` to `4` fixed columns (fewer on narrow screens), or `auto-fit` (default) and `auto-fill` for as many as fit.","fieldName":"columns"},{"name":"gap","type":{"text":"GridGap"},"default":"\"md\"","description":"The space between items: `none`, `xs`, `sm`, `md` (default), `lg` or `xl`, from the `spacing` scale.","fieldName":"gap"},{"name":"min-width","type":{"text":"string"},"default":"\"280px\"","description":"The narrowest an auto column can be, as any CSS length.","fieldName":"minWidth"},{"name":"align-items","type":{"text":"\"start\" | \"center\" | \"end\" | \"stretch\""},"default":"\"stretch\"","description":"How items line up in their row: `start`, `center`, `end` or `stretch` (default).","fieldName":"alignItems"}],"members":[{"kind":"field","name":"columns","type":{"text":"GridColumns"},"default":"\"auto-fit\"","description":"`1` to `4` fixed columns (fewer on narrow screens), or `auto-fit` (default) and `auto-fill` for as many as fit.","attribute":"columns","reflects":true},{"kind":"field","name":"gap","type":{"text":"GridGap"},"default":"\"md\"","description":"The space between items: `none`, `xs`, `sm`, `md` (default), `lg` or `xl`, from the `spacing` scale.","attribute":"gap","reflects":true},{"kind":"field","name":"minWidth","type":{"text":"string"},"default":"\"280px\"","description":"The narrowest an auto column can be, as any CSS length.","attribute":"min-width"},{"kind":"field","name":"alignItems","type":{"text":"\"start\" | \"center\" | \"end\" | \"stretch\""},"default":"\"stretch\"","description":"How items line up in their row: `start`, `center`, `end` or `stretch` (default).","attribute":"align-items","reflects":true}],"slots":[{"description":"The grid items.","name":""}],"released":null},{"tagName":"oh-icon","pkg":"@orange-halo/components","description":"An icon from the system's built-in set, shown on its own, with a label, or as an icon-only link.\n\n**Use it for** an icon next to text, an icon that carries meaning on its own (with `accessible-label`), or a compact link such as a social profile (`href` + `accessible-label`). **Don't use it for** an icon-only button (use `oh-button` with `icon-only`); or for an image or logo (use `<img>`).\n\n**Names:** `name` picks the icon: social (`twitter`, `github`, `linkedin`, `instagram`, `youtube`, `facebook`, `email`, `substack`), navigation (`arrow-*`, `chevron-*`, `external-link`), actions (`close`, `plus`, `minus`, `check`, `search`, `menu`, `settings`, `heart`, `sparkle`) and feedback (`info`, `warning`, `error`, `success`). An unknown name renders nothing and logs a warning.\n\n**Sizes:** with no `size` the icon is 1em and follows the text; `sm`, `md`, `lg`, `xl` set fixed sizes. **`inverse`:** for icons on an accent-coloured or dark background.\n\n**Behaviour:** the icon takes the current text colour. `arrow-left`, `arrow-right`, `chevron-left` and `chevron-right` mirror in right-to-left text, so they keep pointing back and forward along the line. With `href` it renders as a link, with hover, active and focus-visible states; `target=\"_blank\"` adds `rel=\"noopener noreferrer\"`.\n\n**Accessibility:** without `accessible-label` the icon is decorative (`aria-hidden=\"true\"`). With `accessible-label` it's `role=\"img\"` with that name. As a link, `accessible-label` is required (it logs a warning without one) and becomes the link's `aria-label`. Focus-visible shows a solid ring in `focus.ringColor` (`color.text.onAccent` when `inverse`).\n\n**Look:** set by tokens. The icon is `currentColor`; `inverse` sets `color.text.onAccent`. As a link: `shape.compact` corners, hover moves by `lift.hoverMd` with an `elevation.offset.lg` shadow in `color.border.default` (`color.text.onAccent` when `inverse`); motion uses `motion.snappy` and `motion.easeGentle`, off under `prefers-reduced-motion`.","attributes":[{"name":"name","type":{"text":"IconName"},"default":"\"info\"","description":"Which built-in icon to show. An unknown name renders nothing and logs a warning.","fieldName":"name"},{"name":"size","type":{"text":"IconSize | undefined"},"description":"`sm`, `md`, `lg` or `xl` for a fixed size; leave it unset to follow the text size.","fieldName":"size"},{"name":"inverse","type":{"text":"boolean"},"default":"false","description":"For icons on an accent-coloured or dark background.","fieldName":"inverse"},{"name":"accessible-label","type":{"text":"string | undefined"},"description":"Names an icon that carries meaning (`role=\"img\"`), or an icon link. Without it the icon is decorative and hidden from screen readers.","fieldName":"accessibleLabel"},{"name":"href","type":{"text":"string | undefined"},"description":"Renders the icon as a link to this URL. Set `accessible-label` too.","fieldName":"href"},{"name":"target","type":{"text":"string | undefined"},"description":"The link's target; `_blank` adds `rel=\"noopener noreferrer\"`.","fieldName":"target"}],"members":[{"kind":"field","name":"name","type":{"text":"IconName"},"default":"\"info\"","description":"Which built-in icon to show. An unknown name renders nothing and logs a warning.","attribute":"name"},{"kind":"field","name":"size","type":{"text":"IconSize | undefined"},"description":"`sm`, `md`, `lg` or `xl` for a fixed size; leave it unset to follow the text size.","attribute":"size","reflects":true},{"kind":"field","name":"inverse","type":{"text":"boolean"},"default":"false","description":"For icons on an accent-coloured or dark background.","attribute":"inverse","reflects":true},{"kind":"field","name":"accessibleLabel","type":{"text":"string | undefined"},"description":"Names an icon that carries meaning (`role=\"img\"`), or an icon link. Without it the icon is decorative and hidden from screen readers.","attribute":"accessible-label"},{"kind":"field","name":"href","type":{"text":"string | undefined"},"description":"Renders the icon as a link to this URL. Set `accessible-label` too.","attribute":"href"},{"kind":"field","name":"target","type":{"text":"string | undefined"},"description":"The link's target; `_blank` adds `rel=\"noopener noreferrer\"`.","attribute":"target"}],"released":null},{"tagName":"oh-input","pkg":"@orange-halo/components","description":"A single-line text field that submits with a native form, with optional\ntyping suggestions.\n\n**Use it for** short free text: names, email addresses, search terms.\n**Don't use it for** several lines (use `oh-textarea`) or a choice from a\nfixed list (use `oh-select`, or `oh-radio-group` for a few options).\n`suggestions` offers values while still allowing any text.\n\n**Types:** `text` (default), `email`, `password`, `search`, `tel`, `url`.\nOne size. **States:** rest, hover, focus, error (set `error-text`),\ndisabled, required.\n\n**Behaviour:** form-associated: the value submits under `name`, `required`\nblocks submission (validity comes from the inner `<input>`), a form reset\nrestores the starting value, and a disabled `<fieldset>` disables it.\nFires `oh-input` as the text changes and `oh-change` when it's committed.\n`suggestions` renders a native `<datalist>`, so the browser handles its\nkeyboard and screen reader support. `autocomplete` is passed to the inner\n`<input>`.\n\n**Accessibility:** always set `label`: it's the field's name. The error\nshows after the label and before the field, with an icon, and is linked\nwith `aria-describedby` and `aria-invalid`; it's announced (`role=\"alert\"`)\nonly when it appears after first render. Helper text is linked the same\nway (it's hidden while an error shows). Focus is a solid inset ring.\nSet `autocomplete` for personal data (WCAG 1.3.5).\n\n**Look:** set by tokens — `color.surface.field` (fill),\n`input.base.borderWidth` (`stroke.control`) in\n`color.border.emphasis` (border), `shape.control` (corners),\n`typography.control.*` (type), `input.size.md.minHeight` (height),\n`elevation.offset.md` and `elevation.color.field` (inset shadow),\n`color.border.hover` (hover), `focus.ringColor` and\n`color.surface.highlight` (focus), `color.feedback.error`,\n`color.feedback.errorSubtle` and `elevation.color.error` (error),\n`color.feedback.errorHover` (error hover),\n`color.surface.disabled`, `color.border.disabled` and\n`color.text.disabled` (disabled).","attributes":[{"name":"type","type":{"text":"InputType"},"default":"\"text\"","description":"The kind of text: text, email, password, search, tel or url","fieldName":"type"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"The text in the field","fieldName":"value"},{"name":"placeholder","type":{"text":"string"},"default":"\"\"","description":"Example text shown while the field is empty. Not a replacement for the label","fieldName":"placeholder"},{"name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label. Always set one: it names the field","fieldName":"label"},{"name":"helper-text","type":{"text":"string"},"default":"\"\"","description":"Help shown under the field and linked to it","fieldName":"helperText"},{"name":"error-text","type":{"text":"string"},"default":"\"\"","description":"Error shown before the field and linked to it. Setting it puts the field in its error state","fieldName":"errorText"},{"name":"name","type":{"text":"string"},"default":"\"\"","description":"The name the value is submitted under","fieldName":"name"},{"name":"required","type":{"text":"boolean"},"default":"false","description":"Must be filled in before the form submits","fieldName":"required"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not editable, and left out of the form's data","fieldName":"disabled"},{"name":"suggestions","type":{"text":"string[]"},"default":"[]","description":"Values offered while typing, shown by the browser as a list under the\nfield. They suggest, they don't restrict: any text is still allowed.\nSet it as a property (an array of strings) or, in HTML, as a JSON array:\nsuggestions='[\"Option one\",\"Option two\"]'. Browsers also offer the\nfield's autofill history, so set autocomplete=\"off\" to show only these.","fieldName":"suggestions"},{"name":"autocomplete","type":{"text":"string | undefined"},"description":"The input's purpose, for autofill and assistive tech (WCAG 1.3.5):\nan HTML autocomplete token such as \"email\", \"name\" or \"tel\".\nPassed to the inner <input>.","fieldName":"autocomplete"},{"name":"force-state","type":{"text":"InputState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'focus'","fieldName":"forceState"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"type","type":{"text":"InputType"},"default":"\"text\"","description":"The kind of text: text, email, password, search, tel or url","attribute":"type"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"The text in the field","attribute":"value"},{"kind":"field","name":"placeholder","type":{"text":"string"},"default":"\"\"","description":"Example text shown while the field is empty. Not a replacement for the label","attribute":"placeholder"},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label. Always set one: it names the field","attribute":"label"},{"kind":"field","name":"helperText","type":{"text":"string"},"default":"\"\"","description":"Help shown under the field and linked to it","attribute":"helper-text"},{"kind":"field","name":"errorText","type":{"text":"string"},"default":"\"\"","description":"Error shown before the field and linked to it. Setting it puts the field in its error state","attribute":"error-text"},{"kind":"field","name":"name","type":{"text":"string"},"default":"\"\"","description":"The name the value is submitted under","attribute":"name","reflects":true},{"kind":"field","name":"required","type":{"text":"boolean"},"default":"false","description":"Must be filled in before the form submits","attribute":"required","reflects":true},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not editable, and left out of the form's data","attribute":"disabled","reflects":true},{"kind":"field","name":"suggestions","type":{"text":"string[]"},"default":"[]","description":"Values offered while typing, shown by the browser as a list under the\nfield. They suggest, they don't restrict: any text is still allowed.\nSet it as a property (an array of strings) or, in HTML, as a JSON array:\nsuggestions='[\"Option one\",\"Option two\"]'. Browsers also offer the\nfield's autofill history, so set autocomplete=\"off\" to show only these.","attribute":"suggestions"},{"kind":"field","name":"autocomplete","type":{"text":"string | undefined"},"description":"The input's purpose, for autofill and assistive tech (WCAG 1.3.5):\nan HTML autocomplete token such as \"email\", \"name\" or \"tel\".\nPassed to the inner <input>.","attribute":"autocomplete"},{"kind":"field","name":"forceState","type":{"text":"InputState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'focus'","attribute":"force-state","reflects":true},{"kind":"field","name":"form","description":"The form this field belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}]},{"kind":"method","name":"blur"},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]}],"events":[{"description":"Whenever the text changes: typing, or picking a suggestion. detail: { value, originalEvent }","name":"oh-input"},{"description":"When the value is committed (on blur or Enter). detail: { value, originalEvent }","name":"oh-change"}],"cssParts":[{"description":"The visible label","name":"label"},{"description":"The text field","name":"input"},{"description":"The helper text, and the error message (which also has the error part)","name":"helper"},{"description":"The error message","name":"error"}],"released":null},{"tagName":"oh-link","pkg":"@orange-halo/components","description":"A text link, for use inside body copy or on its own as a call to action.\n\n**Use it for** navigating to another page or place. **Don't use it for**\nactions that don't navigate (use `oh-button` instead).\n\n**Variants:** `inline` (default) sits in running text; `standalone` is\nlarger and bolder for links on their own, and can show a trailing arrow\n(`arrow`). `inverse` is for links on accent surfaces.\n\n**Behaviour:** renders a native `<a>`, so Enter follows it and it takes\nfocus in tab order. On hover the underline retracts and the arrow nudges\nforward. Keyboard focus (`:focus-visible`) shows a solid underline and a\ntint; mouse focus doesn't. Transitions are cut short under\n`prefers-reduced-motion`. With `target=\"_blank\"` it adds an external icon,\nscreen-reader text \"(opens in new tab)\" and `rel=\"noopener noreferrer\"`\nwhen `rel` isn't set; the arrow is not shown on external links.\n\n**Accessibility:** the underline shows at rest and on focus, so links\ndon't rely on colour. Write link text that makes sense out of context.\n\n**Look:** set by tokens — `color.text.link` the colour (`color.text.onAccent`\nwhen `inverse`); `decoration.underlineThickness`, `decoration.underlineDash`\nand `decoration.underlinePeriod` the underline; `color.brand.primary`\n(`color.text.onAccent` when `inverse`) and\n`decoration.underlineFocusThickness` the focus underline; `focus.decorationColor`\n(`link.variant.inverse.focusBackground` when `inverse`) the focus tint;\n`typography.body.fontFamily`, plus `typography.body.lg.fontSize` and\n`typography.emphasis.fontWeight` for `standalone`; `motion.slow` and\n`motion.snappy` the transitions.","attributes":[{"name":"href","type":{"text":"string"},"default":"\"\"","description":"Where the link goes.","fieldName":"href"},{"name":"target","type":{"text":"string"},"default":"\"\"","description":"The link's target. `_blank` adds an external icon and the screen-reader text \"(opens in new tab)\".","fieldName":"target"},{"name":"rel","type":{"text":"string"},"default":"\"\"","description":"The link's `rel`. Left empty with `target=\"_blank\"`, it becomes `noopener noreferrer`.","fieldName":"rel"},{"name":"variant","type":{"text":"LinkVariant"},"default":"\"inline\"","description":"`inline` (default) for links in running text, or `standalone`, larger and bolder, for a link on its own.","fieldName":"variant"},{"name":"arrow","type":{"text":"boolean"},"default":"false","description":"Shows a trailing arrow on a `standalone` link (not on external links).","fieldName":"arrow"},{"name":"inverse","type":{"text":"boolean"},"default":"false","description":"For links on accent-coloured or dark surfaces.","fieldName":"inverse"}],"members":[{"kind":"field","name":"href","type":{"text":"string"},"default":"\"\"","description":"Where the link goes.","attribute":"href"},{"kind":"field","name":"target","type":{"text":"string"},"default":"\"\"","description":"The link's target. `_blank` adds an external icon and the screen-reader text \"(opens in new tab)\".","attribute":"target"},{"kind":"field","name":"rel","type":{"text":"string"},"default":"\"\"","description":"The link's `rel`. Left empty with `target=\"_blank\"`, it becomes `noopener noreferrer`.","attribute":"rel"},{"kind":"field","name":"variant","type":{"text":"LinkVariant"},"default":"\"inline\"","description":"`inline` (default) for links in running text, or `standalone`, larger and bolder, for a link on its own.","attribute":"variant"},{"kind":"field","name":"arrow","type":{"text":"boolean"},"default":"false","description":"Shows a trailing arrow on a `standalone` link (not on external links).","attribute":"arrow"},{"kind":"field","name":"inverse","type":{"text":"boolean"},"default":"false","description":"For links on accent-coloured or dark surfaces.","attribute":"inverse","reflects":true}],"slots":[{"description":"The link text.","name":""}],"released":null},{"tagName":"oh-modal","pkg":"@orange-halo/components","description":"A dialog that opens over the page and holds the user's attention until they close it or act on it.\n\n**Use it for** a short task or decision that must be done before going on: a confirmation, a small form. **Don't use it for** content the user may want alongside the page (use `oh-drawer`); for a message that doesn't need an answer (use `oh-alert`); or for long, multi-step flows (use a page).\n\n**Parts:** `heading` (a visible `h2`); the default slot for the body, which scrolls when it's taller than the viewport; the `footer` slot for actions (with nothing in it, there's no footer).\n\n**Sizes:** `sm`, `md` (default), `lg` and `xl` set the dialog's width (never wider than the viewport). `xl` is for an image beside its details, such as a poster or a photo with its caption and facts; keep forms and messages at `md` or `lg`, where lines stay readable.\n\n**Behaviour:** set `open` to show it. On open, focus moves to the Close button (or the first focusable element when there's none), Tab and Shift+Tab wrap inside the dialog, and the page behind stops scrolling. On close, focus returns to the element that had it. With `dismissible` (the default), the Close button, Escape and a click on the backdrop each fire `oh-close` and set `open` to false; without it, only your own buttons close it. Motion is reduced under `prefers-reduced-motion`.\n\n**Accessibility:** the panel is `role=\"dialog\"` with `aria-modal=\"true\"`, named by `heading`. Without a visible heading, set `accessible-label` (not `aria-label` on the host, which isn't forwarded). The close button has a visible \"Close\" label.\n\n**Look:** set by tokens. `modal.base.backdrop` sets the backdrop; the panel uses `color.surface.base`, a `stroke.control` border in `color.border.emphasis`, `shape.container` corners and an `elevation.offset.2xl` shadow in `elevation.color.overlay`. Header and footer dividers use `stroke.control` in `color.border.subtle`; the title uses `typography.heading.h4.*`, the body `typography.body.*`. The close button uses `closeButton.*`, `lift.*` and `shape.compact`. Motion uses `motion.gentle` and `motion.easeEmphasized`. Widths come from `modal.size.*.width`.","attributes":[{"name":"open","type":{"text":"boolean"},"default":"false","description":"Whether the dialog is showing. Set it to open; closing sets it back to false.","fieldName":"open"},{"name":"heading","type":{"text":"string"},"default":"\"\"","description":"The visible title (an `h2`), which also names the dialog. Without one, set `accessible-label`.","fieldName":"heading"},{"name":"accessible-label","type":{"text":"string | undefined"},"description":"Names the dialog when it has no visible heading. Use this rather than\naria-label on the host, which isn't forwarded into the shadow root.\nA visible heading always wins.","fieldName":"accessibleLabel"},{"name":"dismissible","type":{"text":"boolean"},"default":"true","description":"Lets the Close button, Escape and a backdrop click close it, each firing `oh-close` (default on). Turn it off to close only from your own buttons.","fieldName":"dismissible"},{"name":"size","type":{"text":"ModalSize"},"default":"\"md\"","description":"The dialog's width: `sm`, `md` (default), `lg` or `xl` (an image beside its details), never wider than the viewport.","fieldName":"size"}],"members":[{"kind":"field","name":"open","type":{"text":"boolean"},"default":"false","description":"Whether the dialog is showing. Set it to open; closing sets it back to false.","attribute":"open","reflects":true},{"kind":"field","name":"heading","type":{"text":"string"},"default":"\"\"","description":"The visible title (an `h2`), which also names the dialog. Without one, set `accessible-label`.","attribute":"heading"},{"kind":"field","name":"accessibleLabel","type":{"text":"string | undefined"},"description":"Names the dialog when it has no visible heading. Use this rather than\naria-label on the host, which isn't forwarded into the shadow root.\nA visible heading always wins.","attribute":"accessible-label"},{"kind":"field","name":"dismissible","type":{"text":"boolean"},"default":"true","description":"Lets the Close button, Escape and a backdrop click close it, each firing `oh-close` (default on). Turn it off to close only from your own buttons.","attribute":"dismissible","reflects":true},{"kind":"field","name":"size","type":{"text":"ModalSize"},"default":"\"md\"","description":"The dialog's width: `sm`, `md` (default), `lg` or `xl` (an image beside its details), never wider than the viewport.","attribute":"size","reflects":true}],"events":[{"description":"When the user closes the dialog with the Close button, Escape or the backdrop. Not fired when you set `open` to false yourself.","name":"oh-close"}],"slots":[{"description":"The dialog body.","name":""},{"description":"Actions, below the body.","name":"footer"}],"cssParts":[{"description":"The dialog panel.","name":"modal"},{"description":"The header (heading and close button).","name":"header"},{"description":"The close button (only when `dismissible`).","name":"close"},{"description":"The scrolling body.","name":"body"},{"description":"The footer.","name":"footer"}],"released":null},{"tagName":"oh-navbar","pkg":"@orange-halo/components","description":"A site header bar with a logo and the site's main navigation links, which move into a drawer on narrow viewports.\n\n**Use it for** the main navigation at the top of every page. **Don't use\nit for** in-page sections (use `oh-tabs`) or a trail through the hierarchy\n(use `oh-breadcrumb`).\n\n**Parts:** the `logo` slot (a link to the home page), the default slot for\nthe bar's links (`oh-link`), and the `mobile` slot for the same links in the\ndrawer. `drawer-heading` names the drawer (defaults to \"Menu\").\n\n**Behaviour:** at and below the `size.breakpoint.md` width the links hide\nand an icon-only menu button (\"Open navigation menu\") opens an `oh-drawer`\nfrom the left, which traps focus and closes on Escape or its close button.\n\n**Accessibility:** the bar and the drawer each wrap their links in a\n`<nav>`; the drawer is a modal dialog. Give the logo link an accessible\nname (`alt` on its image, or text).\n\n**Look:** set by tokens — `color.surface.base` the background,\n`navbar.base.shadow` the shadow (`elevation.offset.sm` and `focus.decorationColor`), `typography.body.*` the text, `spacing.*` the\npadding and gaps, `stroke.divider` and `color.border.subtle` the dividers\nbetween drawer links. `navbar.base.logoHeight` sets the logo height, and `--oh-navbar-logo-height` overrides it on a page.","attributes":[{"name":"drawer-heading","type":{"text":"string"},"default":"\"Menu\"","description":"Heading shown in the mobile drawer","fieldName":"drawerHeading"}],"members":[{"kind":"field","name":"drawerHeading","type":{"text":"string"},"default":"\"Menu\"","description":"Heading shown in the mobile drawer","attribute":"drawer-heading"}],"slots":[{"description":"Slot for logo/brand element","name":"logo"},{"description":"Default slot for navigation links","name":""},{"description":"The navigation links again, shown in the drawer","name":"mobile"}],"released":null},{"tagName":"oh-progress","pkg":"@orange-halo/components","description":"A bar that shows how much of a task is done, with an optional percentage and visible label.\n\n**Use it for** a task with a known end: an upload, a download, steps completed. **Don't use it for** a wait of unknown length (it has no indeterminate state); or for a measurement that isn't progress, like storage used against a quota (a meter).\n\n**Variants:** `brand` (default), and `success`, `info`, `warning`, `error` by their feedback role. **Sizes:** `sm`, `md` (default), `lg` set the track height and the value's text size. **`inverse`:** for use on a brand-coloured or dark background.\n\n**Behaviour:** `value` runs from 0 to `max` (default 100) and is clamped to that range; the bar and the percentage show `value / max`, rounded. `show-value` (on by default) shows the percentage; `show-label` shows `label` above the bar. The fill's width animates when the value changes, except under `prefers-reduced-motion`.\n\n**Accessibility:** the bar is a `progressbar` with `aria-valuenow`, `aria-valuemin`, `aria-valuemax` and `aria-label` from `label` (default \"Progress\"). Always set `label` to say what is progressing. The visible percentage is `aria-hidden`, since screen readers read the value from the progressbar.\n\n**Look:** set by tokens. The track uses `color.surface.inset`, a `stroke.control` border in `color.border.default`, `shape.pill` corners and an inset `elevation.offset.sm` shadow in `progress.base.trackInsetShadow`. The fill is `color.brand.primary` or `color.feedback.<variant>`. Text uses `color.text.primary` and `typography.body.*`. Inverse uses `progress.variant.inverse.trackBackground`, `progress.variant.inverse.trackBorder`, `progress.variant.inverse.fill` and `color.text.onBrand`. Motion uses `motion.relaxed` and `motion.easeGentle`.","attributes":[{"name":"value","type":{"text":"number"},"default":"0","description":"Current progress value (0-100 by default, or 0-max)","fieldName":"value"},{"name":"max","type":{"text":"number"},"default":"100","description":"Maximum value (default 100)","fieldName":"max"},{"name":"label","type":{"text":"string"},"default":"\"Progress\"","description":"Accessible label describing what the progress represents","fieldName":"label"},{"name":"show-label","type":{"text":"boolean"},"default":"false","description":"Whether to show the visible label above the bar","fieldName":"showLabel"},{"name":"show-value","type":{"text":"boolean"},"default":"true","description":"Whether to show the percentage number","fieldName":"showValue"},{"name":"size","type":{"text":"ProgressSize"},"default":"\"md\"","description":"Size variant","fieldName":"size"},{"name":"variant","type":{"text":"ProgressVariant"},"default":"\"brand\"","description":"Color variant","fieldName":"variant"},{"name":"inverse","type":{"text":"boolean"},"default":"false","description":"Inverse colors for dark backgrounds","fieldName":"inverse"}],"members":[{"kind":"field","name":"value","type":{"text":"number"},"default":"0","description":"Current progress value (0-100 by default, or 0-max)","attribute":"value","reflects":true},{"kind":"field","name":"max","type":{"text":"number"},"default":"100","description":"Maximum value (default 100)","attribute":"max","reflects":true},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"Progress\"","description":"Accessible label describing what the progress represents","attribute":"label"},{"kind":"field","name":"showLabel","type":{"text":"boolean"},"default":"false","description":"Whether to show the visible label above the bar","attribute":"show-label"},{"kind":"field","name":"showValue","type":{"text":"boolean"},"default":"true","description":"Whether to show the percentage number","attribute":"show-value"},{"kind":"field","name":"size","type":{"text":"ProgressSize"},"default":"\"md\"","description":"Size variant","attribute":"size","reflects":true},{"kind":"field","name":"variant","type":{"text":"ProgressVariant"},"default":"\"brand\"","description":"Color variant","attribute":"variant","reflects":true},{"kind":"field","name":"inverse","type":{"text":"boolean"},"default":"false","description":"Inverse colors for dark backgrounds","attribute":"inverse","reflects":true},{"kind":"field","name":"percentage","type":{"text":"number"},"privacy":"private","description":"Calculate percentage (clamped 0-100)","readonly":true}],"cssParts":[{"description":"The bar's track.","name":"track"},{"description":"The filled part of the track.","name":"fill"},{"description":"The percentage text.","name":"value"}],"released":null},{"tagName":"oh-radio-group","pkg":"@orange-halo/components","description":"A set of radio buttons under one label, where exactly one can be chosen.\n\n**Use it for** one choice from a few options that should all be visible,\nsuch as a plan or a delivery speed. **Don't use it for** a long list (use\n`oh-select`), several choices (use `oh-checkbox-group`) or an on/off\nsetting (use `oh-toggle` or `oh-checkbox`). Use it rather than separate\n`oh-radio` elements, which can't form a group.\n\n**Parts:** a `label` for the group and a list of `options`\n(`{ label, value }`). `value` is the chosen option's value. **States:**\neach option unchecked, checked, hover, active and focus; the group can be\n`required`, disabled, and in error (set `error-text`).\n\n**Behaviour:** Tab moves into and out of the group; arrow keys move\nbetween options and choose them (the browser's native radio behaviour).\nEach change sets `value` and fires `oh-change`. In a native `<form>` it\nsubmits `value` under `name` (nothing while no option is chosen);\n`required` blocks submitting with none chosen, reset restores the\nstarting value, and `disabled` (or a disabled `<fieldset>` around it)\ntakes every option out of the tab order and the form.\n\n**Accessibility:** `role=\"radiogroup\"` labelled by `label`, so always set\none. The error shows after the label and before the options, with an\nicon; the group gets `aria-invalid` and `aria-describedby`, and the error\nis announced (`role=\"alert\"`) only when it appears after first render.\nFocus underlines the option's label.\n\n**Look:** set by tokens — the same as `oh-radio`: `stroke.control` in\n`color.border.emphasis` (border), `shape.pill` (circle),\n`elevation.offset.*` with `elevation.color.secondary` / `elevation.color.primary` (shadow),\n`lift.hoverSm` / `lift.activeSm` (movement on hover and press),\n`color.brand.primary` and `color.text.onBrand` (checked),\n`color.feedback.error` and `elevation.color.error` (error); `typography.control.*`\nfor the group label and option labels; `color.surface.disabled`,\n`color.border.disabled` and `color.text.disabled` (disabled).","attributes":[{"name":"label","type":{"text":"string"},"default":"\"\"","description":"The group's visible label, which also names the group. Always set it.","fieldName":"label"},{"name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name the chosen value is submitted under.","fieldName":"name"},{"name":"options","type":{"text":"RadioOption[]"},"default":"[]","description":"The radios, as `{ label, value }` objects. Set it as a property, or as JSON in the attribute.","fieldName":"options"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"The chosen option's value (empty for none). Updated on every change.","fieldName":"value"},{"name":"required","type":{"text":"boolean"},"default":"false","description":"An option must be chosen: marks the label and blocks a native form from submitting while none is.","fieldName":"required"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","fieldName":"disabled"},{"name":"error-text","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","fieldName":"errorText"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"The group's visible label, which also names the group. Always set it.","attribute":"label"},{"kind":"field","name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name the chosen value is submitted under.","attribute":"name"},{"kind":"field","name":"options","type":{"text":"RadioOption[]"},"default":"[]","description":"The radios, as `{ label, value }` objects. Set it as a property, or as JSON in the attribute.","attribute":"options"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"The chosen option's value (empty for none). Updated on every change.","attribute":"value"},{"kind":"field","name":"required","type":{"text":"boolean"},"default":"false","description":"An option must be chosen: marks the label and blocks a native form from submitting while none is.","attribute":"required","reflects":true},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","attribute":"disabled","reflects":true},{"kind":"field","name":"form","description":"The form this group belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}],"description":"Focuses the chosen option, or the first"},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]},{"kind":"field","name":"errorText","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","attribute":"error-text"}],"events":[{"description":"An option was chosen. detail: { value }","name":"oh-change"}],"released":null},{"tagName":"oh-radio","pkg":"@orange-halo/components","description":"A single radio button with its label.\n\n**Use it for** a one-off radio you manage yourself. **Don't use it for** a\nset of choices (use `oh-radio-group`). Each `oh-radio` keeps its native radio\ninside its own shadow root, so two of them with the same `name` don't form\na group: checking one doesn't uncheck the other, and arrow keys don't move\nbetween them. `oh-radio-group` renders the whole set in one place, with\narrow-key navigation and one label for the group. For an independent\non/off choice use `oh-checkbox`.\n\n**States:** unchecked, checked, hover, active, focus, error (set `error-text`).\n\n**Behaviour:** clicking the circle or label checks it. Checking sets\n`checked` and fires `oh-change`. The native radio sits in the shadow\nroot, so it doesn't submit with a native form.\n\n**Accessibility:** a real native radio, visually hidden, carries the role\nand state; the drawn circle is decoration. Always set `label`: it's the\nradio's name. Focus underlines the label. The error message shows under\nthe radio with an icon, sets `aria-invalid` and is linked with\n`aria-describedby`; it's announced (`role=\"alert\"`) only when it appears\nafter first render.\n\n**Look:** set by tokens — `stroke.control` in `color.border.emphasis`\n(border), `shape.pill` (circle), `typography.control.*` (label),\n`elevation.offset.*` and `elevation.color.secondary` (shadow), `lift.hoverSm` /\n`lift.activeSm` (movement on hover and press), `color.border.hover`\n(hover), `color.brand.primary` (and its hover and active tokens),\n`color.text.onBrand` and `elevation.color.primary` (checked),\n`color.feedback.error` and `elevation.color.error` (error).","attributes":[{"name":"checked","type":{"text":"boolean"},"default":"false","description":"Whether this radio is chosen.","fieldName":"checked"},{"name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label, which also names the radio. Always set it.","fieldName":"label"},{"name":"name","type":{"text":"string"},"default":"\"\"","description":"A name for your own grouping. Radios in separate elements don't form a native group, so use `oh-radio-group` for a set.","fieldName":"name"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"This radio's value, sent with `oh-change`.","fieldName":"value"},{"name":"error-text","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","fieldName":"errorText"},{"name":"force-state","type":{"text":"RadioState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'focus'","fieldName":"forceState"}],"members":[{"kind":"field","name":"checked","type":{"text":"boolean"},"default":"false","description":"Whether this radio is chosen.","attribute":"checked","reflects":true},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label, which also names the radio. Always set it.","attribute":"label"},{"kind":"field","name":"name","type":{"text":"string"},"default":"\"\"","description":"A name for your own grouping. Radios in separate elements don't form a native group, so use `oh-radio-group` for a set.","attribute":"name"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"This radio's value, sent with `oh-change`.","attribute":"value"},{"kind":"field","name":"errorText","type":{"text":"string"},"default":"\"\"","description":"Error shown with the control and linked to it. Setting it puts the\ncontrol in its error state; clear it to leave that state.","attribute":"error-text"},{"kind":"field","name":"forceState","type":{"text":"RadioState"},"default":"\"default\"","description":"Force a visual state (for documentation only)\nValues: 'hover' | 'focus'","attribute":"force-state","reflects":true}],"events":[{"description":"The radio was checked. detail: { checked, value }","name":"oh-change"}],"cssParts":[{"description":"The drawn radio circle","name":"circle"},{"description":"The label text","name":"label"},{"description":"The error message","name":"error"}],"released":null},{"tagName":"oh-select","pkg":"@orange-halo/components","description":"A dropdown for choosing one option from a list.\n\n**Use it for** one choice from a list too long to show every option.\n**Don't use it for** a few options (use `oh-radio-group`, which shows them\nall), several choices (use `oh-checkbox-group`) or free text (use\n`oh-input` with `suggestions`).\n\n**Parts:** a trigger showing the selected option's label (or\n`placeholder`), and a list of `options` (`{ label, value }`). One size.\n**States:** rest, hover, active, focus, open, error (set `error-text`),\nrequired, disabled.\n\n**Behaviour:** click the trigger, or press Enter, Space or an arrow key,\nto open the list. Arrow keys, Home and End move the highlight, Enter or\nSpace selects, Escape and Tab close, and clicking outside closes. Typing\nletters jumps to a matching option (and selects it while the list is\nclosed). Selecting sets `value`, returns focus to the trigger and fires\n`oh-change`. In a native `<form>` it submits `value` under `name` (nothing\nwhile no option is chosen), `required` blocks submitting with no option\nchosen, reset restores the starting value, and `disabled` (or a disabled\n`<fieldset>` around it) takes it out of the tab order and the form.\n\n**Accessibility:** the trigger is a `combobox` controlling a `listbox`,\nwith `aria-activedescendant` for the highlighted option, so focus stays\non the trigger. Always set `label`: it names the trigger and the list.\nThe error shows after the label and before the trigger, with an icon, sets\n`aria-invalid` and is linked with `aria-describedby`; it's announced\n(`role=\"alert\"`) only when it appears after first render. Focus is a\nsolid underline on the trigger text.\n\n**Look:** set by tokens — `color.surface.field` (trigger fill),\n`stroke.control` in `color.border.emphasis` (border), `shape.control` (trigger corners), `shape.container` (list\ncorners), `typography.control.*` (type), `elevation.offset.*` and\n`elevation.color.secondary` (shadow), `lift.hoverMd` / `lift.activeSm` (movement\non hover and press), `color.border.hover` (hover), `focus.ringColor` and\n`color.surface.highlight` (open), `color.surface.hover` and\n`color.brand.primary` (selected option), `color.feedback.error` and\n`elevation.color.error` (error). The open list is at most\n`select.base.listMaxHeight` tall and scrolls beyond it; it slides\ndown `select.base.listEnterOffset` as it opens.","attributes":[{"name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label, which names the trigger and the list. Always set it.","fieldName":"label"},{"name":"placeholder","type":{"text":"string"},"default":"\"Select an option\"","description":"Shown on the trigger while no option is chosen.","fieldName":"placeholder"},{"name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name the chosen value is submitted under.","fieldName":"name"},{"name":"options","type":{"text":"SelectOption[]"},"default":"[]","description":"The choices, as `{ label, value }` objects. Set it as a property, or as JSON in the attribute.","fieldName":"options"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"The chosen option's value (empty for none). Updated when the user selects.","fieldName":"value"},{"name":"required","type":{"text":"boolean"},"default":"false","description":"An option must be chosen: marks the label and blocks a native form from submitting while none is.","fieldName":"required"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","fieldName":"disabled"},{"name":"helper-text","type":{"text":"string"},"default":"\"\"","description":"Help shown under the field and linked to it with `aria-describedby`.","fieldName":"helperText"},{"name":"error-text","type":{"text":"string"},"default":"\"\"","description":"An error message. Setting it is the error state: it shows after the label, sets `aria-invalid` and is linked to the trigger.","fieldName":"errorText"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label, which names the trigger and the list. Always set it.","attribute":"label"},{"kind":"field","name":"placeholder","type":{"text":"string"},"default":"\"Select an option\"","description":"Shown on the trigger while no option is chosen.","attribute":"placeholder"},{"kind":"field","name":"name","type":{"text":"string"},"default":"\"\"","description":"The form field name the chosen value is submitted under.","attribute":"name"},{"kind":"field","name":"options","type":{"text":"SelectOption[]"},"default":"[]","description":"The choices, as `{ label, value }` objects. Set it as a property, or as JSON in the attribute.","attribute":"options"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"The chosen option's value (empty for none). Updated when the user selects.","attribute":"value"},{"kind":"field","name":"required","type":{"text":"boolean"},"default":"false","description":"An option must be chosen: marks the label and blocks a native form from submitting while none is.","attribute":"required","reflects":true},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","attribute":"disabled","reflects":true},{"kind":"field","name":"helperText","type":{"text":"string"},"default":"\"\"","description":"Help shown under the field and linked to it with `aria-describedby`.","attribute":"helper-text"},{"kind":"field","name":"errorText","type":{"text":"string"},"default":"\"\"","description":"An error message. Setting it is the error state: it shows after the label, sets `aria-invalid` and is linked to the trigger.","attribute":"error-text"},{"kind":"field","name":"form","description":"The form this select belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}]},{"kind":"method","name":"blur"},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]}],"events":[{"description":"An option was selected. detail: { value }","name":"oh-change"}],"released":null},{"tagName":"oh-skip-link","pkg":"@orange-halo/components","description":"A \"skip to content\" link that lets keyboard users jump past repeated content, such as navigation.\n\n**Use it for** the first focusable element on every page, pointing at the\nmain content. Add more for other landmarks (search results, footer) if\nuseful. **Don't use it for** in-page navigation that everyone sees (use\n`oh-link`).\n\n**Parts:** `href` is the target (defaults to `#main`); `text` is the label\n(defaults to \"Skip to main content\").\n\n**Behaviour:** hidden until it receives keyboard focus, then shown fixed at\nthe top-left of the viewport, above other content. Enter follows the link.\nTransitions are cut short under `prefers-reduced-motion`.\n\n**Accessibility:** screen readers can read it at all times. Put it first in\nthe page, and give the target an `id` and `tabindex=\"-1\"` so focus moves to\nit.\n\n**Look:** set by tokens — `color.surface.base`, `color.border.emphasis` and\n`color.text.link` at rest; `color.surface.container`, `color.text.linkOnContainer`\nand `color.brand.primary` (border) on focus; `stroke.control` the border,\n`shape.control` the corners; `elevation.offset.lg` with `elevation.color.neutral`\n(`elevation.color.primary` on focus) the shadow; `typography.body.*` and\n`typography.label.base.fontWeight` the text; `spacing.*` the padding and\nposition; `motion.gentle`, `motion.quick` and `motion.snappy` the\ntransitions.","attributes":[{"name":"href","type":{"text":"string"},"default":"\"#main\"","description":"The target to jump to, usually the main content's `id`.","fieldName":"href"},{"name":"text","type":{"text":"string"},"default":"\"Skip to main content\"","description":"The link's text.","fieldName":"text"}],"members":[{"kind":"field","name":"href","type":{"text":"string"},"default":"\"#main\"","description":"The target to jump to, usually the main content's `id`.","attribute":"href"},{"kind":"field","name":"text","type":{"text":"string"},"default":"\"Skip to main content\"","description":"The link's text.","attribute":"text"}],"released":null},{"tagName":"oh-spinner","pkg":"@orange-halo/components","description":"A turning arc that shows something is loading, when you can't say how long it will take.\n\n**Use it for** a wait of unknown length: a panel fetching its content, a search running. **Don't use it for** a task with a known end (use `oh-progress`, which shows how far along it is); or for a button's own action (set `loading` on `oh-button`, which draws this spinner and keeps the button's name).\n\n**Sizes:** with no `size` the spinner is 1em and follows the text, for a spinner inside a line or a control; `sm`, `md` and `lg` are fixed sizes for a spinner on its own.\n\n**Parts:** `label` shows a visible message beside the arc (\"Loading results\"). Without it, the spinner is named by `accessible-label` (default \"Loading\") for screen readers only.\n\n**Behaviour:** the arc turns until the spinner is removed. `inverse` is for a spinner on a brand-coloured or dark fill. Under `prefers-reduced-motion` the arc doesn't turn, so give a long wait a visible `label`.\n\n**Accessibility:** `role=\"progressbar\"` with no value (an indeterminate progress bar), named by `label` or `accessible-label`. It isn't a live region: adding it to the page doesn't announce it. When people need to hear that something is loading, put the message in a live region of your own. Remove the spinner when the content arrives, and set `aria-busy=\"true\"` on the region that's loading while it waits.\n\n**Look:** set by tokens. The arc is `color.brand.primary` (`color.text.onBrand` when `inverse`), `stroke.control` thick, and makes a turn every `spinner.base.cycleDuration`. Sizes are `spacing.4`, `spacing.6` and `spacing.8`. The label is `color.text.secondary` in `typography.body.base.*`.","attributes":[{"name":"size","type":{"text":"SpinnerSize | undefined"},"description":"`sm`, `md` or `lg` for a fixed size; leave it unset to follow the text size.","fieldName":"size"},{"name":"label","type":{"text":"string"},"default":"\"\"","description":"A visible message beside the arc, such as \"Loading results\". It also names the spinner.","fieldName":"label"},{"name":"accessible-label","type":{"text":"string"},"default":"\"Loading\"","description":"The spinner's name for screen readers when there's no visible `label`.","fieldName":"accessibleLabel"},{"name":"inverse","type":{"text":"boolean"},"default":"false","description":"For a spinner on a brand-coloured or dark fill.","fieldName":"inverse"}],"members":[{"kind":"field","name":"size","type":{"text":"SpinnerSize | undefined"},"description":"`sm`, `md` or `lg` for a fixed size; leave it unset to follow the text size.","attribute":"size","reflects":true},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"A visible message beside the arc, such as \"Loading results\". It also names the spinner.","attribute":"label"},{"kind":"field","name":"accessibleLabel","type":{"text":"string"},"default":"\"Loading\"","description":"The spinner's name for screen readers when there's no visible `label`.","attribute":"accessible-label"},{"kind":"field","name":"inverse","type":{"text":"boolean"},"default":"false","description":"For a spinner on a brand-coloured or dark fill.","attribute":"inverse","reflects":true}],"cssParts":[{"description":"The wrapper holding the arc and the label.","name":"spinner"},{"description":"The turning arc.","name":"arc"},{"description":"The visible label (only when `label` is set).","name":"label"}],"released":null},{"tagName":"oh-stack","pkg":"@orange-halo/components","description":"A vertical layout that spaces its children evenly, top to bottom.\n\n**Use it for** consistent vertical rhythm without margins on children.\n**Don't use it for** items in a row (use `oh-cluster`) or a grid of cards\n(use `oh-grid`).\n\n**Gaps:** `gap` is `none`, `xs` (`spacing.1`), `sm` (`spacing.2`), `md`\n(default, `spacing.4`), `lg` (`spacing.6`), `xl` (`spacing.8`) or `2xl`\n(`spacing.12`). `align` sets horizontal alignment: `start`, `center`,\n`end` or `stretch` (default). It places the children; it doesn't change\nhow the text inside them is aligned.","attributes":[{"name":"gap","type":{"text":"StackGap"},"default":"\"md\"","description":"The space between children: `none`, `xs`, `sm`, `md` (default), `lg`, `xl` or `2xl`, from the `spacing` scale.","fieldName":"gap"},{"name":"align","type":{"text":"StackAlign"},"default":"\"stretch\"","description":"Horizontal alignment of the children: `start`, `center`, `end` or `stretch` (default).","fieldName":"align"}],"members":[{"kind":"field","name":"gap","type":{"text":"StackGap"},"default":"\"md\"","description":"The space between children: `none`, `xs`, `sm`, `md` (default), `lg`, `xl` or `2xl`, from the `spacing` scale.","attribute":"gap","reflects":true},{"kind":"field","name":"align","type":{"text":"StackAlign"},"default":"\"stretch\"","description":"Horizontal alignment of the children: `start`, `center`, `end` or `stretch` (default).","attribute":"align","reflects":true}],"slots":[{"description":"The items to stack.","name":""}],"released":null},{"tagName":"oh-table","pkg":"@orange-halo/components","description":"A data table: the styles and scrolling for a native `<table>` you write inside it.\n\n**Use it for** data people compare across rows and columns: figures by month, a list of records with several attributes. **Don't use it for** layout; a list of single items (use a list); or label-and-value pairs (use a description list, `<dl>`).\n\n**Parts:** the default slot holds one `<table>`, written as normal HTML: a `<caption>` that names it, `<thead>` with `<th scope=\"col\">` headers, `<tbody>`, and an optional `<tfoot>` for totals. Use `<th scope=\"row\">` for the cell that names its row. Cells can hold anything, including links, badges and buttons. Put `data-align=\"end\"` on the header and cells of a column of numbers so the digits line up; figures are tabular throughout. Show an empty result as one row with a cell spanning every column (`colspan`) that says there's nothing to show.\n\n**Density:** `default`, or `compact` for long tables or tight spaces. Density changes the cell padding, not the text size.\n\n**Behaviour:** none of its own: no sorting, selection or sticky header. The table is as wide as its content. Column headers and end-aligned cells stay on one line; other cells wrap. When it's wider than its container it scrolls sideways, and the element becomes a focusable region named by the caption, so keyboard users can scroll it with the arrow keys.\n\n**Accessibility:** always give the table a `<caption>` (visually hidden if a heading already names it), or failing that `aria-label` on the `<table>`, which `accessible-label` sets for you. Use `<th>` with `scope` for every header; never use the table for layout.\n\n**Look:** set by tokens. `typography.body.base.*` sets the cell text and `typography.label.*` the caption and header weight; `color.text.secondary` the column headers; `stroke.divider` with `color.border.divider` the row lines, and with `color.border.emphasis` the lines under the headers and above the totals; `spacing.*` the cell padding. The focus outline (when it scrolls) is `focus.ringColor`.","attributes":[{"name":"density","type":{"text":"TableDensity"},"default":"\"default\"","description":"`default`, or `compact` for long tables or tight spaces.","fieldName":"density"},{"name":"accessible-label","type":{"text":"string | undefined"},"description":"Names the table for assistive tech when it has no `<caption>`: set as the table's `aria-label`.","fieldName":"accessibleLabel"}],"members":[{"kind":"field","name":"density","type":{"text":"TableDensity"},"default":"\"default\"","description":"`default`, or `compact` for long tables or tight spaces.","attribute":"density","reflects":true},{"kind":"field","name":"accessibleLabel","type":{"text":"string | undefined"},"description":"Names the table for assistive tech when it has no `<caption>`: set as the table's `aria-label`.","attribute":"accessible-label"}],"slots":[{"description":"One native `<table>`, with a `<caption>`.","name":""}],"cssParts":[{"description":"The wrapper around the slotted table.","name":"table"}],"released":null},{"tagName":"oh-tabs","pkg":"@orange-halo/components","description":"A set of tabs that switches between panels of related content in the same place.\n\n**Use it for** a few peer sections of content where only one needs to be\nseen at a time. **Don't use it for** navigating between pages (use links\nor `oh-navbar`), or for content people need to compare side by side.\n\n**Parts:** pass `items`, an array of `{ id, label, content? }`. A panel\nshows `content` as text, or else the light-DOM element with\n`slot=\"<id>\"`. `value` is the selected tab's `id` (defaults to the first).\n\n**States:** each tab is selected or not; unselected tabs show an underline\non hover.\n\n**Behaviour:** click selects a tab. Arrow keys move focus between tabs and\nwrap (Left/Right, swapped in right-to-left text, or Up/Down when\n`orientation=\"vertical\"`; orientation changes the keys only, not the\nlayout); Home/End jump to the first/last.\nEnter or Space selects the focused tab and moves focus to its panel.\nSelecting a different tab fires `oh-change`. Transitions are cut short\nunder `prefers-reduced-motion`.\n\n**Narrow screens:** tabs take less padding in a narrow space, and when they still don't fit (many tabs, or large text) the tab row scrolls sideways on its own, so the page doesn't, with an arrow button at each end that has more tabs to show. Keyboard users move with the arrow keys, which bring the focused tab into view, so the scroll buttons stay out of the Tab order.\n\n**Accessibility:** tablist/tab/tabpanel roles with `aria-selected`,\n`aria-controls` and `aria-labelledby`; one tab is in the tab order at a\ntime; inactive panels are `hidden`; the active panel is focusable. Keyboard\nfocus shows a solid underline on the tab label and an outline on the panel.\nKeep labels short.\n\n**Look:** set by tokens — `color.brand.primary` the unselected tabs and\ntheir hover underline (`decoration.underlineThickness`,\n`decoration.underlineDash`, `decoration.underlinePeriod`);\n`color.text.primary`, `color.surface.base` and `color.border.emphasis` the\nselected tab and panel; `stroke.control` the borders; `shape.control` the\ntab corners and `shape.container` the panel corners;\n`typography.body.*` and `typography.label.base.fontWeight` the text;\n`spacing.*` the padding; `motion.snappy` and `motion.relaxed` the\ntransitions.","attributes":[{"name":"items","type":{"text":"TabItem[]"},"default":"[]","description":"The tabs: `{ id, label, content? }`. In HTML, a JSON array","fieldName":"items"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"The selected tab's `id`. Defaults to the first tab","fieldName":"value"},{"name":"orientation","type":{"text":"\"horizontal\" | \"vertical\""},"default":"\"horizontal\"","description":"Orientation of the tabs (affects arrow key behavior)","fieldName":"orientation"}],"members":[{"kind":"field","name":"items","type":{"text":"TabItem[]"},"default":"[]","description":"The tabs: `{ id, label, content? }`. In HTML, a JSON array","attribute":"items"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"The selected tab's `id`. Defaults to the first tab","attribute":"value","reflects":true},{"kind":"field","name":"orientation","type":{"text":"\"horizontal\" | \"vertical\""},"default":"\"horizontal\"","description":"Orientation of the tabs (affects arrow key behavior)","attribute":"orientation"}],"events":[{"description":"When a different tab is selected. `detail: { value }`, the tab's `id`.","name":"oh-change"}],"released":null},{"tagName":"oh-tag","pkg":"@orange-halo/components","description":"A small interactive label: a filter the user turns on and off, or a value\nthey've chosen and can remove.\n\n**Use it for** filters that narrow a list (\"Festivals\", \"2024\"), shown side\nby side, and for the values someone has picked, such as the filters\ncurrently applied, each with a × to remove it. **Don't use it for** a\nlabel nobody acts on, such as a status or category (use `oh-badge`); an\naction (use `oh-button`); a link to another page (use `oh-link`); or one\nsetting in a form (use `oh-checkbox` or `oh-toggle`).\n\n**Kinds:** a filter by default; `removable` for a chosen value. A tag is one\nor the other: a removable tag can't be turned on.\n\n**Size:** the same as `oh-badge`, so the two line up in a row. There's one\nsize.\n\n**Parts:** the default slot holds the text, a word or two; the `icon` slot\nan optional leading icon, sized to the text.\n\n**States:** off, on, hover, active, focus, disabled.\n\n**Behaviour:** a filter tag is one button. Clicking it, or pressing Space or\nEnter while it's focused, flips `checked` and fires `oh-change` with\n`{ checked }`. In a native `<form>`, an \"on\" tag submits `value` (`on` if\nunset) under `name`, like a checkbox, so a row of tags with one `name`\nsubmits every one that's on; reset restores the starting state. A\nremovable tag has one button, the ×: clicking it, or pressing Space or\nEnter on it, fires `oh-remove` with `{ value }`. The tag stays until the\npage removes it, and the page should then move focus to the next tag's ×,\nor to the heading or control before the list when it was the last one,\nbecause the focused button has gone. Pressing Backspace or Delete on the ×\ndoes the same as clicking it. `disabled` (or a disabled `<fieldset>`\naround it) takes it out of the tab order and the form; a disabled removable\ntag still shows its text normally, and only the × can't be used.\n\n**Accessibility:** a filter tag is a `<button>` with `aria-pressed`, named\nby its text. A removable tag's text is plain, and its × is a `<button>`\nnamed \"Remove\" and the text (\"Remove Festivals\"); set `remove-label` to\ntranslate \"Remove\". On, a filter tag shows a check mark as well as its\ncolour. Group a row of tags under a visible heading or a `<fieldset>` and\n`<legend>` that says what they filter. Focus is a solid outline in\n`focus.ringColor`.\n\n**Look:** set by tokens. `shape.compact` sets the corners;\n`typography.body.*`, `typography.label.base.fontWeight` and\n`typography.control.letterSpacing` the text; `spacing.1` and\n`spacing.2-5` the padding, as on `oh-badge`. Off: `color.surface.base`,\n`color.text.primary`, and a `stroke.control` frame in\n`color.border.emphasis` (`color.surface.hover` and `color.border.hover` on\nhover). On: `color.brand.primary` (`color.brand.primaryHover` on hover)\nwith `color.text.onBrand`, inside the same frame. The × takes `color.surface.hoverTint` on hover.\nFocus: `focus.ringColor`, `focus.ringWidth` and `focus.ringOffset`.\nDisabled: `color.surface.disabled`, `color.border.disabled` and\n`color.text.disabled` on a filter tag; a removable tag keeps its text and\nonly its × takes `color.text.disabled`, as the value is still chosen.","attributes":[{"name":"checked","type":{"text":"boolean"},"default":"false","description":"A filter tag: whether it's on. Ignored on a removable tag","fieldName":"checked"},{"name":"removable","type":{"text":"boolean"},"default":"false","description":"A chosen value with a × that fires `oh-remove`, instead of a filter","fieldName":"removable"},{"name":"remove-label","type":{"text":"string"},"default":"\"Remove\"","description":"The word before the text in the ×'s name (\"Remove Festivals\"). Set it to translate \"Remove\"","fieldName":"removeLabel"},{"name":"name","type":{"text":"string | undefined"},"description":"Name for form submission (filter tags)","fieldName":"name"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"Submitted when a filter tag is on (`on` if unset), and sent with `oh-remove`","fieldName":"value"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","fieldName":"disabled"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"checked","type":{"text":"boolean"},"default":"false","description":"A filter tag: whether it's on. Ignored on a removable tag","attribute":"checked","reflects":true},{"kind":"field","name":"removable","type":{"text":"boolean"},"default":"false","description":"A chosen value with a × that fires `oh-remove`, instead of a filter","attribute":"removable","reflects":true},{"kind":"field","name":"removeLabel","type":{"text":"string"},"default":"\"Remove\"","description":"The word before the text in the ×'s name (\"Remove Festivals\"). Set it to translate \"Remove\"","attribute":"remove-label"},{"kind":"field","name":"name","type":{"text":"string | undefined"},"description":"Name for form submission (filter tags)","attribute":"name"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"Submitted when a filter tag is on (`on` if unset), and sent with `oh-remove`","attribute":"value"},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","attribute":"disabled","reflects":true},{"kind":"field","name":"form","description":"The form this tag belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}],"description":"Focuses the tag's button: the tag, or a removable tag's ×"},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]}],"events":[{"description":"A filter tag was turned on or off. detail: { checked }","name":"oh-change"},{"description":"A removable tag's × was pressed. detail: { value }","name":"oh-remove"}],"slots":[{"description":"The tag text.","name":""},{"description":"Optional leading icon. Mark it `aria-hidden`.","name":"icon"}],"cssParts":[{"description":"The tag: the button, or the frame round a removable tag.","name":"tag"},{"description":"A removable tag's × button.","name":"remove"}],"released":null},{"tagName":"oh-textarea","pkg":"@orange-halo/components","description":"A multi-line text field that submits with a native form.\n\n**Use it for** messages, comments, feedback: text that may run to several\nlines. **Don't use it for** a single line of text (use `oh-input`).\n\n**States:** rest, hover, focus, error (set `error-text`), disabled,\nrequired. `rows` sets the visible lines (default 4); people can drag it\ntaller. `maxlength` limits the length.\n\n**Behaviour:** form-associated. Give it a `name` and it submits with the\nform. `required` stops the form submitting while it's empty, with the\nbrowser's own message. A form reset restores its starting text, and a\ndisabled `<fieldset>` disables it. Fires `oh-input` on every keystroke and\n`oh-change` when the value is committed. Its line height is 1.5 times the\ntext size, rounded up to `grid.unit`, so long messages stay on the grid.\n\n**Accessibility:** always set `label`: it names the field. A placeholder\nisn't a label. Helper and error text are linked to the field with\n`aria-describedby`, so screen readers read them. Errors come before the\nfield, with an icon, set `aria-invalid`, and are announced only when they\nappear after the page has loaded. Focus is a solid inset ring. Use\n`autocomplete` when the field asks for something a browser can fill in,\nsuch as an address (WCAG 1.3.5).\n\n**Look:** set by tokens — `color.surface.field` (fill), `stroke.control` in\n`color.border.emphasis` (border), `shape.control` (corners), `typography.control.*` (type),\n`elevation.offset.md` and `elevation.color.field` (inset shadow),\n`color.border.hover` (hover), `focus.ringColor` and\n`color.surface.highlight` (focus), `color.feedback.error`,\n`color.feedback.errorSubtle` and `elevation.color.error` (error),\n`color.feedback.errorHover` (error hover),\n`color.surface.disabled`, `color.border.disabled` and\n`color.text.disabled` (disabled).","attributes":[{"name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label. Always set one: it names the field.","fieldName":"label"},{"name":"value","type":{"text":"string"},"default":"\"\"","description":"The text in the field","fieldName":"value"},{"name":"placeholder","type":{"text":"string"},"default":"\"\"","description":"Example text shown while the field is empty. Not a replacement for the label","fieldName":"placeholder"},{"name":"helper-text","type":{"text":"string"},"default":"\"\"","description":"Help shown under the field and linked to it","fieldName":"helperText"},{"name":"error-text","type":{"text":"string"},"default":"\"\"","description":"Error shown before the field and linked to it. Setting it puts the field in its error state","fieldName":"errorText"},{"name":"name","type":{"text":"string"},"default":"\"\"","description":"The name the value is submitted under","fieldName":"name"},{"name":"required","type":{"text":"boolean"},"default":"false","description":"Must be filled in before the form submits","fieldName":"required"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not editable, and left out of the form's data","fieldName":"disabled"},{"name":"rows","type":{"text":"number"},"default":"4","description":"Visible lines of text before the field scrolls (people can drag it taller)","fieldName":"rows"},{"name":"maxlength","type":{"text":"number | undefined"},"description":"Longest allowed text, in characters","fieldName":"maxlength"},{"name":"autocomplete","type":{"text":"string | undefined"},"description":"The field's purpose for autofill and assistive tech (WCAG 1.3.5), e.g. \"street-address\"","fieldName":"autocomplete"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"label","type":{"text":"string"},"default":"\"\"","description":"The visible label. Always set one: it names the field.","attribute":"label"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"\"","description":"The text in the field","attribute":"value"},{"kind":"field","name":"placeholder","type":{"text":"string"},"default":"\"\"","description":"Example text shown while the field is empty. Not a replacement for the label","attribute":"placeholder"},{"kind":"field","name":"helperText","type":{"text":"string"},"default":"\"\"","description":"Help shown under the field and linked to it","attribute":"helper-text"},{"kind":"field","name":"errorText","type":{"text":"string"},"default":"\"\"","description":"Error shown before the field and linked to it. Setting it puts the field in its error state","attribute":"error-text"},{"kind":"field","name":"name","type":{"text":"string"},"default":"\"\"","description":"The name the value is submitted under","attribute":"name","reflects":true},{"kind":"field","name":"required","type":{"text":"boolean"},"default":"false","description":"Must be filled in before the form submits","attribute":"required","reflects":true},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not editable, and left out of the form's data","attribute":"disabled","reflects":true},{"kind":"field","name":"rows","type":{"text":"number"},"default":"4","description":"Visible lines of text before the field scrolls (people can drag it taller)","attribute":"rows"},{"kind":"field","name":"maxlength","type":{"text":"number | undefined"},"description":"Longest allowed text, in characters","attribute":"maxlength"},{"kind":"field","name":"autocomplete","type":{"text":"string | undefined"},"description":"The field's purpose for autofill and assistive tech (WCAG 1.3.5), e.g. \"street-address\"","attribute":"autocomplete"},{"kind":"field","name":"form","description":"The form this field belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}]},{"kind":"method","name":"blur"},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]}],"events":[{"description":"On every keystroke. detail: { value, originalEvent }","name":"oh-input"},{"description":"When the value is committed (on blur). detail: { value, originalEvent }","name":"oh-change"}],"cssParts":[{"description":"The visible label","name":"label"},{"description":"The text field","name":"textarea"},{"description":"The helper text","name":"helper"},{"description":"The error message","name":"error"}],"released":null},{"tagName":"oh-timeline","pkg":"@orange-halo/components","description":"A dated list: entries under group headings, each a date beside what happened, with markers and notes between groups.\n\n**Use it for** things that happened, or will, in order: a history of events, a CV's jobs and education, a changelog, an order's progress written as a list. **Don't use it for** data compared across columns (use `oh-table`); facts about one thing (use `oh-description-list`); or steps someone works through (a stepper, which OHDS doesn't have yet).\n\n**Parts:** everything is normal HTML inside the element.\n- A **group** is a heading (`<h2>`–`<h6>`: a year, \"Upcoming\", \"Experience\") followed by an `<ol>` (or `<ul>`) of entries. A `<small>` inside the heading holds a count or note (\"12 gigs\").\n- An **entry** is an `<li>`. Its first child is the **date**: a `<time datetime>`, or a `<p>` holding a range (`<time>2019</time> – <time>2023</time>`). Its second child holds **what happened**: a heading (`<h3>`–`<h6>`) and paragraphs; give a paragraph `data-meta` to set it in the secondary colour (a place, a type). An optional element with `data-aside` holds **badges or actions** at the end of the row.\n- A **marker** (`<p data-marker>`) is a line across the list with a label, such as \"Today\" between upcoming and past events, or \"Now\" in a CV.\n- A **note** (`<p data-note>`) is a short line between groups, such as \"No gigs in 2016\" or \"Career break\".\n\n**Options:** `sticky-headings` keeps each group heading in view while its entries scroll past (on `color.surface.base`, so use it on that surface).\n\n**Layout:** the date sits in a column (`timeline.base.dateWidth`) beside what happened, with the aside at the end. In a narrow space (under 30em, or with large text) the date sits above what happened and the aside below it. Long words break rather than widening the page.\n\n**Behaviour:** none of its own: it styles the markup and adds no roles or focus stops. To bring someone to an entry (from a link or a dialog), give the `<li>` `tabindex=\"-1\"` and focus it: it shows the focus ring until focus moves on.\n\n**Accessibility:** the headings let screen-reader users move between groups, each list announces how many entries it has, and `<time datetime>` gives each date a machine-readable value. Use heading levels that fit the page's outline, one level below the group headings for entry titles. Write the date as it should be read (\"Sat 15 Nov 2026\", not \"15/11\").\n\n**Look:** set by tokens. `typography.heading.h3.*` the group headings and `typography.heading.h4.*` entry titles; `typography.label.sm.*` and `color.text.secondary` the dates, counts and markers; `typography.body.sm.*` the details; `stroke.divider` with `color.border.divider` the lines between entries; `stroke.control` with `color.text.primary` the marker's line; `spacing.*` the gaps; `timeline.base.dateWidth` the date column; `focus.ring*` an entry brought into focus.","attributes":[{"name":"sticky-headings","type":{"text":"boolean"},"default":"false","description":"Keeps each group heading in view while its entries scroll past.","fieldName":"stickyHeadings"}],"members":[{"kind":"field","name":"stickyHeadings","type":{"text":"boolean"},"default":"false","description":"Keeps each group heading in view while its entries scroll past.","attribute":"sticky-headings","reflects":true}],"slots":[{"description":"Group headings, lists of entries, markers and notes, as normal HTML.","name":""}],"released":null},{"tagName":"oh-toggle","pkg":"@orange-halo/components","description":"A switch that turns a setting on or off.\n\n**Use it for** a setting that takes effect straight away, such as turning\nnotifications on, or an on/off setting in a settings form. **Don't use it\nfor** something that must be agreed to (use `oh-checkbox`), or a choice\nbetween more than two options (use `oh-radio-group`).\n\n**States:** off, on, hover, active, focus, disabled.\n\n**Behaviour:** clicking the switch or its label, or pressing Space or\nEnter while it's focused, flips `checked` and fires `oh-change` with\n`{ checked }`. In a native `<form>`, an \"on\" toggle submits `value` (`on`\nif unset) under `name`, like a checkbox; reset restores the starting\nstate, and `disabled` (or a disabled `<fieldset>` around it) takes it out\nof the tab order and the form. Under `prefers-reduced-motion` it doesn't\nanimate.\n\n**Accessibility:** `role=\"switch\"` with `aria-checked`, in the tab order.\nDisabled, it has `aria-disabled=\"true\"` and leaves the tab order.\nSet `label` (a visible label, linked with `aria-labelledby`), or\n`accessible-label` when there's no visible label (not `aria-label`, which\nisn't forwarded into the shadow root). Focus is a solid outline in\n`focus.ringColor`.\n\n**Look:** set by tokens — `shape.pill` (track), `color.surface.container` /\n`color.brand.primary` (track off / on), `color.surface.base`,\n`stroke.control` and `color.border.emphasis` (thumb),\n`elevation.offset.*` with `elevation.color.secondary` / `elevation.color.primary` (thumb\nshadow off / on), `lift.hoverSm` / `lift.activeSm` (movement on hover and\npress), `focus.ringColor` and `focus.decorationColor` (focus),\n`typography.body.*` (label), `color.surface.disabled`,\n`color.border.disabled` and `color.text.disabled` (disabled).","attributes":[{"name":"checked","type":{"text":"boolean"},"default":"false","description":"Whether the toggle is checked/on","fieldName":"checked"},{"name":"label","type":{"text":"string | undefined"},"description":"Label text displayed next to the toggle","fieldName":"label"},{"name":"accessible-label","type":{"text":"string | undefined"},"description":"Accessible name when there's no visible label. Use this, not aria-label:\nan aria-label on the host isn't forwarded into the shadow root.","fieldName":"accessibleLabel"},{"name":"name","type":{"text":"string | undefined"},"description":"Name for form submission","fieldName":"name"},{"name":"value","type":{"text":"string"},"default":"\"on\"","description":"Value for form submission","fieldName":"value"},{"name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","fieldName":"disabled"}],"members":[{"kind":"field","name":"formAssociated","type":{"text":"boolean"},"static":true,"default":"true"},{"kind":"field","name":"checked","type":{"text":"boolean"},"default":"false","description":"Whether the toggle is checked/on","attribute":"checked","reflects":true},{"kind":"field","name":"label","type":{"text":"string | undefined"},"description":"Label text displayed next to the toggle","attribute":"label"},{"kind":"field","name":"accessibleLabel","type":{"text":"string | undefined"},"description":"Accessible name when there's no visible label. Use this, not aria-label:\nan aria-label on the host isn't forwarded into the shadow root.","attribute":"accessible-label"},{"kind":"field","name":"name","type":{"text":"string | undefined"},"description":"Name for form submission","attribute":"name"},{"kind":"field","name":"value","type":{"text":"string"},"default":"\"on\"","description":"Value for form submission","attribute":"value"},{"kind":"field","name":"disabled","type":{"text":"boolean"},"default":"false","description":"Not interactive, and left out of the form","attribute":"disabled","reflects":true},{"kind":"field","name":"form","description":"The form this toggle belongs to","readonly":true},{"kind":"method","name":"focus","parameters":[{"name":"options","optional":true,"type":{"text":"FocusOptions"}}]},{"kind":"method","name":"formResetCallback"},{"kind":"method","name":"formDisabledCallback","parameters":[{"name":"disabled","type":{"text":"boolean"}}]},{"kind":"method","name":"formStateRestoreCallback","parameters":[{"name":"state","type":{"text":"string | File | FormData | null"}}]}],"events":[{"name":"oh-change","type":{"text":"CustomEvent"},"description":"Fired when the toggle state changes. detail: { checked }"}],"released":null},{"tagName":"oh-tooltip","pkg":"@orange-halo/components","description":"Shows the name of an icon-only control in a small bubble while the pointer rests on it or it has keyboard focus.\n\n**Use it for** an icon-only button or link, so people who can see the screen learn its name too. **Don't use it for** information people need to finish a task, or anything they'd need on a touch screen (put it on the page, or in `oh-callout`); for a control that already shows its name as text; or for anything interactive: the bubble holds plain text only.\n\n**Parts:** the default slot holds one control, usually `<oh-button icon-only accessible-label=\"…\">`. `text` is what the bubble says, and must be the control's name: the same words as its `accessible-label` or `aria-label`. The tooltip warns in the console when they differ.\n\n**Placement:** `top` (default) or `bottom`. The bubble flips to the other side when there isn't room, and stays inside the viewport.\n\n**Behaviour:** the bubble shows after `tooltip.base.showDelay` when the pointer rests on the control, and at once when the control gets keyboard focus. It stays while the pointer is on the control or the bubble, and for `tooltip.base.hideDelay` after it leaves, so the pointer can move onto it. Escape hides it without moving focus. A pointer press doesn't show it.\n\n**Accessibility:** the bubble is `aria-hidden`, because it repeats the control's name, which screen readers already announce. It meets WCAG 1.4.13: it can be dismissed with Escape, the pointer can move onto it, and it stays until the pointer or focus leaves. Touch screens have no hover, which is why a tooltip only ever repeats a name.\n\n**Look:** set by tokens. `tooltip.base.background` and `tooltip.base.color` set the bubble and its text, in `typography.body.sm.*`; `shape.compact` the corners; `spacing.1` and `spacing.2` the padding; `spacing.2` the gap to the control; and `tooltip.base.maxWidth` how wide it gets before wrapping.","attributes":[{"name":"text","type":{"text":"string"},"default":"\"\"","description":"What the bubble says: the control's name, the same words as its `accessible-label`.","fieldName":"text"},{"name":"placement","type":{"text":"TooltipPlacement"},"default":"\"top\"","description":"`top` (default) or `bottom`. The bubble flips when there isn't room.","fieldName":"placement"}],"members":[{"kind":"field","name":"text","type":{"text":"string"},"default":"\"\"","description":"What the bubble says: the control's name, the same words as its `accessible-label`.","attribute":"text"},{"kind":"field","name":"placement","type":{"text":"TooltipPlacement"},"default":"\"top\"","description":"`top` (default) or `bottom`. The bubble flips when there isn't room.","attribute":"placement","reflects":true},{"kind":"field","name":"open","type":{"text":"boolean"},"description":"Whether the bubble is showing.","readonly":true}],"slots":[{"description":"The control the tooltip names: one icon-only button or link.","name":""}],"cssParts":[{"description":"The bubble.","name":"bubble"}],"released":null},{"tagName":"oh-visually-hidden","pkg":"@orange-halo/components","description":"Text that screen readers read but the screen doesn't show, such as the extra words that make a repeated link make sense on its own.\n\n**Use it for** words that complete a name for people who can't see the layout: \"Read review\" + \"of Ferocious and focused\", \"Change\" + \"name\", a heading for a group whose purpose is clear by sight. **Don't use it for** hiding content from everyone (use `hidden`); for naming a control that takes `label` or `accessible-label` (use those); or for text sighted people need too.\n\n**Parts:** the default slot holds the hidden text, usually inline inside a link, a button's label or a heading.\n\n**Behaviour:** it takes no space and shows nothing. With `focusable`, it shows while anything inside it has focus.\n\n**Accessibility:** the text stays in the accessibility tree, so it joins the accessible name of the link or button around it and screen readers read it in place. Never put a focusable control inside without `focusable`: a focused control must be visible (WCAG 2.4.7).","attributes":[{"name":"focusable","type":{"text":"boolean"},"default":"false","description":"Shows the content while something inside it has focus, such as a skip link.","fieldName":"focusable"}],"members":[{"kind":"field","name":"focusable","type":{"text":"boolean"},"default":"false","description":"Shows the content while something inside it has focus, such as a skip link.","attribute":"focusable","reflects":true}],"slots":[{"description":"The hidden text.","name":""}],"released":null},{"tagName":"oh-hero","pkg":"@orange-halo/brand-orange-halo","description":"The banner at the top of an Orange Halo page: a heading on the brand\ncolour, with a subtitle and actions, or a journey's name, step and progress.\n\n**Use it for** the top of an Orange Halo page, once. **Don't use it for**\na section further down the page (use headings and `oh-card`), or in\nanother brand: it's an Orange Halo brand pattern.\n\n**Parts:** `heading` is the page's `<h1>`. `content` (default) adds\n`subtitle` and the default slot for actions: the main action an\n`oh-button variant=\"secondary\"`, further ones `oh-link variant=\"standalone\"\ninverse`. `journey` shows `journey-name` above the heading and an inverse\n`oh-progress` for `current-step` of `total-steps`; the default slot sits\nunder it.\n\n**Accessibility:** the heading is the page's only `<h1>`. The hero isn't a\nlandmark: put it inside `<header>` or `<main>` as the page needs.\n\n**Look:** `color.brand.primary` background with `color.text.onBrand` text;\n`layout.container.*` (from `size`) sets the content width.","attributes":[{"name":"variant","type":{"text":"HeroVariant"},"default":"\"content\"","description":"`content` (default): a heading, subtitle and actions slot. `journey`: a journey name, the page heading and a progress bar for a multi-step flow.","fieldName":"variant"},{"name":"size","type":{"text":"HeroSize"},"default":"\"lg\"","description":"The content's maximum width: `sm`, `md`, `lg` (default) or `xl`, from `layout.container.*`.","fieldName":"size"},{"name":"heading","type":{"text":"string"},"default":"\"\"","description":"The page heading, rendered as the page's `h1`.","fieldName":"heading"},{"name":"subtitle","type":{"text":"string"},"default":"\"\"","description":"A line under the heading (`content` variant only).","fieldName":"subtitle"},{"name":"journey-name","type":{"text":"string"},"default":"\"\"","description":"The journey's name, shown above the page heading (`journey` variant only).","fieldName":"journeyName"},{"name":"current-step","type":{"text":"number"},"default":"1","description":"The step the user is on, for the progress bar (`journey` variant only).","fieldName":"currentStep"},{"name":"total-steps","type":{"text":"number"},"default":"1","description":"How many steps the journey has (`journey` variant only).","fieldName":"totalSteps"}],"members":[{"kind":"field","name":"variant","type":{"text":"HeroVariant"},"default":"\"content\"","description":"`content` (default): a heading, subtitle and actions slot. `journey`: a journey name, the page heading and a progress bar for a multi-step flow.","attribute":"variant","reflects":true},{"kind":"field","name":"size","type":{"text":"HeroSize"},"default":"\"lg\"","description":"The content's maximum width: `sm`, `md`, `lg` (default) or `xl`, from `layout.container.*`.","attribute":"size","reflects":true},{"kind":"field","name":"heading","type":{"text":"string"},"default":"\"\"","description":"The page heading, rendered as the page's `h1`.","attribute":"heading"},{"kind":"field","name":"subtitle","type":{"text":"string"},"default":"\"\"","description":"A line under the heading (`content` variant only).","attribute":"subtitle"},{"kind":"field","name":"journeyName","type":{"text":"string"},"default":"\"\"","description":"The journey's name, shown above the page heading (`journey` variant only).","attribute":"journey-name"},{"kind":"field","name":"currentStep","type":{"text":"number"},"default":"1","description":"The step the user is on, for the progress bar (`journey` variant only).","attribute":"current-step"},{"kind":"field","name":"totalSteps","type":{"text":"number"},"default":"1","description":"How many steps the journey has (`journey` variant only).","attribute":"total-steps"}],"slots":[{"description":"Actions (content), or anything under the progress bar (journey).","name":""}],"released":true}],"apiValues":{"oh-accordion":{"variant":["standout","subtle"]},"oh-alert":{"variant":["error","info","success","warning"]},"oh-badge":{"variant":["accent","brand","error","info","success","warning"],"appearance":["filled","subtle"],"size":["lg","md"]},"oh-button":{"variant":["accent","primary","secondary"],"size":["lg","md","sm"],"force-state":["active","default","focus","hover"]},"oh-callout":{"variant":["brand","info","neutral","success","warning"],"icon":["arrow-down","arrow-left","arrow-right","arrow-up","check","chevron-down","chevron-left","chevron-right","chevron-up","close","email","error","external-link","facebook","github","heart","image","info","instagram","linkedin","list","menu","minus","plus","refresh","search","settings","sparkle","substack","success","twitter","warning","youtube"]},"oh-card":{"variant":["default","featured","subtle"],"padding":["lg","md","none","sm"]},"oh-chart":{"type":["bar","column","donut","dot","line"],"size":["md","sm"]},"oh-checkbox":{"force-state":["default","focus","hover"]},"oh-cluster":{"gap":["lg","md","none","sm","xl","xs"],"justify":["around","between","center","end","start"],"align":["baseline","center","end","start"]},"oh-container":{"size":["full","lg","md","sm","xl"]},"oh-description-list":{"layout":["grid","rows"],"value-size":["lg","md"]},"oh-divider":{"orientation":["horizontal","vertical"]},"oh-drawer":{"position":["end","left","right","start"]},"oh-grid":{"columns":["1","2","3","4","auto-fill","auto-fit"],"gap":["lg","md","none","sm","xl","xs"],"align-items":["center","end","start","stretch"]},"oh-hero":{"variant":["content","journey"],"size":["lg","md","sm","xl"]},"oh-icon":{"name":["arrow-down","arrow-left","arrow-right","arrow-up","check","chevron-down","chevron-left","chevron-right","chevron-up","close","email","error","external-link","facebook","github","heart","image","info","instagram","linkedin","list","menu","minus","plus","refresh","search","settings","sparkle","substack","success","twitter","warning","youtube"],"size":["lg","md","sm","xl"]},"oh-input":{"type":["email","password","search","tel","text","url"],"force-state":["default","focus","hover"]},"oh-link":{"variant":["inline","standalone"]},"oh-modal":{"size":["lg","md","sm","xl"]},"oh-progress":{"size":["lg","md","sm"],"variant":["brand","error","info","success","warning"]},"oh-radio":{"force-state":["default","focus","hover"]},"oh-spinner":{"size":["lg","md","sm"]},"oh-stack":{"gap":["2xl","lg","md","none","sm","xl","xs"],"align":["center","end","start","stretch"]},"oh-table":{"density":["compact","default"]},"oh-tabs":{"orientation":["horizontal","vertical"]},"oh-tooltip":{"placement":["bottom","top"]}},"llms":"# Orange Halo Design System (OHDS)\n\n> Accessible web components (Lit) and W3C DTCG design tokens, shared by several brands: `orange-halo` (Orange Halo), `hoodlum` (Hoodlum). The components, their behaviour and the token roles are the same in every brand; each brand's tokens set its look. Generated from the code by `scripts/build-ai-index.mjs`; don't edit by hand.\n\n## Use it\n\n- Install: `pnpm add @orange-halo/tokens @orange-halo/components`\n- Load one brand's tokens, once, on the page: `import \"@orange-halo/tokens/brands/<brand>.css\"` (`orange-halo`, `hoodlum`). Dark theme: also `brands/<brand>-dark.css`, and `data-theme=\"dark\"` on `<html>`.\n- Register the components: `import \"@orange-halo/components\"` (or one: `@orange-halo/components/oh-button.js`).\n- No build step (a plain HTML page): load both from jsDelivr, which bundles the components' dependencies: `<link rel=\"stylesheet\" href=\"https://cdn.jsdelivr.net/npm/@orange-halo/tokens@4/dist/brands/<brand>.css\">` and `<script type=\"module\">import \"https://cdn.jsdelivr.net/npm/@orange-halo/components@4/+esm\";</script>`. Dark theme: also `https://cdn.jsdelivr.net/npm/@orange-halo/tokens@4/dist/brands/<brand>-dark.css`, which only applies under `data-theme=\"dark\"`.\n- Fonts: the tokens name each brand's fonts but don't load them; load them yourself, or the text falls back to the stack's next font. orange-halo: Bricolage Grotesque (`@fontsource/bricolage-grotesque`, weights 400, 500, 600, 700), JetBrains Mono (`@fontsource/jetbrains-mono`, weights 400, 500); hoodlum: Plus Jakarta Sans (`@fontsource/plus-jakarta-sans`, weights 400, 500, 600, 700, 800).\n- orange-halo brand patterns: `import \"@orange-halo/brand-orange-halo\"`\n- Style your own layout with tier 2 tokens only (the list below), never a brand's palette: `var(--oh-color-surface-container)`, `var(--oh-spacing-4)`.\n- Docs (every component, in every brand): https://orangehalo.co.uk/ohds/\n- Full API, machine-readable: `@orange-halo/components/custom-elements.json`, `@orange-halo/brand-orange-halo/custom-elements.json`\n- For AI assistants: the MCP server `npx -y @orange-halo/mcp` answers the same questions on demand (components, tokens with each brand's value, rules and recipes). It reads its answers once, when it starts, so restart it (or the assistant's session) after upgrading OHDS; until then it answers for the old version\n\n## Rules that matter when using it\n\n- Every form control takes `label` (its visible name). With no visible label, use `accessible-label`, not `aria-label` (it isn't forwarded into the shadow root).\n- Errors: set `error-text`; it puts the control in its error state and is announced. Help: `helper-text`.\n- Attributes are kebab case. Events start with `oh-`; a value change is `oh-change` with `detail.value` (or `detail.checked`).\n- Arrays and objects (`options`, `items`, `suggestions`) are properties; in plain HTML, pass JSON in the attribute.\n- No hex colours or pixel values in your CSS: use the tokens.\n\n## Text, headings and layout\n\nThere's no text component: style headings and paragraphs with a typography role's tokens, its size and line height together (that keeps text on the brand's grid):\n\n```css\nh2 {\n font-family: var(--oh-typography-heading-font-family);\n font-size: var(--oh-typography-heading-h2-font-size);\n line-height: var(--oh-typography-heading-h2-line-height);\n font-weight: var(--oh-typography-heading-h2-font-weight);\n letter-spacing: var(--oh-typography-heading-h2-letter-spacing);\n}\np {\n font-family: var(--oh-typography-body-font-family);\n font-size: var(--oh-typography-body-base-font-size);\n line-height: var(--oh-typography-body-base-line-height);\n color: var(--oh-color-text-secondary);\n}\n```\n\n- **Token name to custom property:** dots become hyphens and camelCase becomes kebab case, after `--oh-`: `typography.heading.h2.fontSize` is `--oh-typography-heading-h2-font-size`, `color.text.linkOnContainer` is `--oh-color-text-link-on-container`.\n- **Heading levels follow the page's outline, not the size you want:** pick the level the page needs (don't skip one), then any role's size.\n- **Layout:** `oh-container` (page width), `oh-stack` (vertical), `oh-cluster` (rows that wrap), `oh-grid` (columns). For your own widths and gaps: `--oh-layout-container-sm` … `-xl` and `--oh-spacing-*`.\n- **Text on cards:** `color.text.primary` and `color.text.secondary`; links inside `oh-card` switch to `color.text.linkOnContainer` on their own. These are contrast-checked on card surfaces in every brand (`pnpm check:contrast`).\n\n## Forms\n\n- Every form control submits with a native `<form>` under its `name`: `oh-input`, `oh-textarea`, `oh-select`, `oh-checkbox`, `oh-checkbox-group` (one entry per ticked option), `oh-radio-group`, `oh-toggle` and filter `oh-tag`s (each one that's on). `required` blocks the submit, the form's reset restores starting values, and `disabled` (or a disabled `<fieldset>`) leaves a control out. Use `oh-radio-group`, not single `oh-radio` elements, in a form.\n- `oh-button` doesn't submit a form by itself. Submit from its `oh-click`: `button.addEventListener(\"oh-click\", () => form.requestSubmit())`, then read the values in the form's `submit` handler.\n- Give every control a visible `label`; put a control's error in `error-text` and its help in `helper-text`.\n\n## Components\n\n### <oh-accordion>\n\nCollapsible sections, each with a heading that shows and hides its content. Use one item for a single show/hide section.\n\n**Use it for** content readers scan by heading and open as needed (FAQs, details, a \"Show as table\" section). **Don't use it for** content most readers need (leave it visible); for switching between views of the same thing (use tabs); or for site navigation.\n\n**Parts:** `items` is an array of `{ heading, hiddenText?, open? }` (in HTML, a JSON array). Item N's content is any markup in a child with `slot=\"item-N\"`, such as a paragraph or a table.\n\n**Behaviour:** each trigger is a `<button>` inside a heading at `heading-level` (default 3), so the items fit the page's outline. Click, Enter or Space toggles it. While collapsed, the panel is `aria-hidden` and `inert`, so nothing inside it takes focus. Motion is turned off under `prefers-reduced-motion`.\n\n**Accessibility:** the trigger has `aria-expanded` and `aria-controls`; the panel is a `region` labelled by its trigger. `hiddenText` adds heading text only screen readers hear, so several items with the same visible heading (e.g. \"Show as table\") can be told apart. Set `heading-level` to fit the headings around it.\n\n- Attributes:\n - `items`: AccordionItem[] — The sections: { heading, hiddenText?, open? }.\n - `variant`: \"standout\" | \"subtle\" = \"subtle\" — subtle (inline) or standout (boxed)\n - `heading-level`: HeadingLevel = 3 — The heading level of each item's trigger, to fit the page's outline\n- Slots:\n - `item-N` — The content of the item at index N (item-0 is the first)\n\n### <oh-alert>\n\nA message box that tells the user about the result of an action or something that needs their attention.\n\n**Use it for** feedback on what just happened (saved, failed) or a notice about the page or account, near the content it's about. **Don't use it for** a short status label (use `oh-badge`); for a field's validation error (use the field's own error message); or for a message that must interrupt the user (use `oh-modal`).\n\n**Behaviour:** with `dismissible`, a \"Close\" button follows the content; selecting it fires `oh-close` (as `oh-modal` and `oh-drawer` do) and sets `hidden` on the alert. Focus then moves to the next focusable element on the page (or the previous one, when nothing follows), unless an `oh-close` listener has already moved it. Content goes in the default slot and can include links.\n\n**Accessibility:** set `live` only for an alert added after the page has rendered (e.g. after submit); it adds `role=\"alert\"` so screen readers announce it. Leave it off for alerts present on page load. Icons are `aria-hidden`; put the meaning in the text. Links show a solid outline in the current text colour on focus; the close button shows an underline.\n\n- Attributes:\n - `variant`: \"error\" | \"info\" | \"success\" | \"warning\" = \"info\" — The feedback role: info (default), success, warning or error.\n - `dismissible`: boolean = false — Adds a \"Close\" button after the content; selecting it fires oh-close and hides the alert.\n - `live`: boolean = false — When true, adds role=\"alert\" for screen reader announcement.\n- Events: `oh-close`\n- Slots:\n - `default` — The message. Can include links.\n- Parts: `alert`, `content`, `close`\n\n### <oh-badge>\n\nA short, non-interactive label that shows the status or category of the thing next to it.\n\n**Use it for** a status (\"Delivered\", \"Pending\"), a count or a tag next to the item it describes. **Don't use it for** anything the user can select or remove, such as a filter (use `oh-tag`), or an action (use `oh-button` or a link); or for a message with more than a word or two (use `oh-alert`).\n\n**Parts:** the default slot holds the text; the `icon` slot an optional leading icon, sized to the text.\n\n**Behaviour:** none. It doesn't take focus or respond to the pointer.\n\n**Accessibility:** the badge is plain text to screen readers, so the text must make sense on its own (say \"Pending\", don't rely on the colour). Mark a decorative icon `aria-hidden`.\n\n- Attributes:\n - `variant`: \"accent\" | \"brand\" | \"error\" | \"info\" | \"success\" | \"warning\" = \"brand\" — brand (default) or accent for a category; success, warning, error or info for a status.\n - `appearance`: \"filled\" | \"subtle\" = \"subtle\" — subtle (default) for most badges; filled, the stronger appearance, for the one status that matters most\n - `size`: \"lg\" | \"md\" = \"md\" — md (default); lg, as tall as a small button, for a badge in a row of them\n- Slots:\n - `default` — The badge text.\n - `icon` — Optional leading icon.\n- Parts: `badge`\n\n### <oh-breadcrumb>\n\nA breadcrumb trail showing where the current page sits in the site's hierarchy.\n\n**Use it for** pages two or more levels deep in a hierarchy. **Don't use it for** a site's main navigation (use `oh-navbar`) or for steps in a process.\n\n**Parts:** pass `items`, an array of `{ label, href }`, from the top level down. The last item is the current page and is shown as text, not a link.\n\n**Behaviour:** below the `size.breakpoint.sm` width the trail collapses to a single \"Back to [parent]\" link to the second-to-last item; with one item, nothing shows there. Link underlines retract on hover; keyboard focus (`:focus-visible`) shows a solid underline and a background tint, as `oh-link` does. The back link's chevron is `oh-icon` `chevron-left`, which mirrors in right-to-left pages. Transitions are cut short under `prefers-reduced-motion`. Renders nothing when `items` is empty.\n\n**Accessibility:** renders `<nav aria-label=\"Breadcrumb\">` with an ordered list, `aria-current=\"page\"` on the last item and `aria-hidden` separators. Use one breadcrumb per page.\n\n- Attributes:\n - `items`: BreadcrumbItem[] — The trail, from the top level down, as { label, href } objects.\n\n### <oh-button>\n\nA button that starts an action, or a link styled as a button when `href` is set.\n\n**Use it for** actions: submitting, saving, opening a dialog, confirming. **Don't use it for** links inside running text (use `oh-link`).\n\n**Parts:** the default slot holds the label. `icon-left` and `icon-right` take an `oh-icon` beside it. An `icon-only` button takes its `oh-icon` in the default slot, and its name from `accessible-label`.\n\n**Behaviour:** fires `oh-click` when the inner `<button>` is clicked, except while `loading`. `loading` shows `oh-spinner` in the label's place, keeps the label for screen readers, sets `aria-busy` and `aria-disabled` and ignores clicks, while the button stays focusable. With `href` it renders an `<a>` (and `target=\"_blank\"` adds `rel=\"noopener noreferrer\"`); link buttons don't fire `oh-click`. It has no `disabled` property and doesn't submit a form by itself: handle `oh-click`. Under `prefers-reduced-motion` it doesn't move. An `icon-only` button can show its name on hover and focus inside `oh-tooltip`.\n\n**Accessibility:** focus shows a solid underline on the label. An `icon-only` button has no visible text, so always set `accessible-label` (not `aria-label`, which isn't forwarded into the shadow root).\n\n- Attributes:\n - `variant`: \"accent\" | \"primary\" | \"secondary\" = \"primary\" — primary for the main action, secondary for the others, accent for an action in the accent colour role.\n - `size`: \"lg\" | \"md\" | \"sm\" = \"md\" — sm, md (default) or lg: the font size, padding and minimum height.\n - `loading`: boolean = false — Shows a spinner and ignores clicks while an action runs.\n - `icon-only`: boolean = false — A square button showing only its icon.\n - `accessible-label`: string — Accessible name for the inner button/anchor.\n - `href`: string — When provided, renders as an anchor tag instead of a button\n - `target`: string — Target for the link (e.g., \"_blank\" for new tab)\n- Events: `oh-click`\n- Slots:\n - `default` — The label.\n - `icon-left` — An icon before the label.\n - `icon-right` — An icon after the label.\n- Parts: `button`\n\n### <oh-callout>\n\nA passive note that sits beside the content it's about: a tip, an aside or something good to know.\n\n**Use it for** supporting information people can read or skip: a tip next to a setting, an aside in an article, what a choice will reveal. **Don't use it for** feedback on something that just happened, or anything urgent (use `oh-alert`); for an error (use `oh-alert variant=\"error\"`, or the field's own error message); or for a short status (use `oh-badge`).\n\n**Parts:** the default slot holds the note, which can include a lead-in in `<strong>`, paragraphs and links. `icon` adds any `oh-icon` before it.\n\n**Behaviour:** none. It doesn't take focus and never announces itself.\n\n**Accessibility:** `role=\"note\"`, read in place, in order. It isn't a live region, so adding one later doesn't announce it: if people must hear it, use `oh-alert` with `live`. The icon is decorative (`aria-hidden`), so put the meaning in the text, not in the colour or the icon.\n\n- Attributes:\n - `variant`: \"brand\" | \"info\" | \"neutral\" | \"success\" | \"warning\" = \"neutral\" — The note's role: neutral (default), brand, info, success or warning.\n - `icon`: \"arrow-down\" | \"arrow-left\" | \"arrow-right\" | \"arrow-up\" | \"check\" | \"chevron-down\" | \"chevron-left\" | \"chevron-right\" | \"chevron-up\" | \"close\" | \"email\" | \"error\" | \"external-link\" | \"facebook\" | \"github\" | \"heart\" | \"image\" | \"info\" | \"instagram\" | \"linkedin\" | \"list\" | \"menu\" | \"minus\" | \"plus\" | \"refresh\" | \"search\" | \"settings\" | \"sparkle\" | \"substack\" | \"success\" | \"twitter\" | \"warning\" | \"youtube\" — An oh-icon name to show before the note, such as sparkle for a tip.\n- Slots:\n - `default` — The note. Can include a lead-in in `<strong>`, paragraphs and links.\n- Parts: `callout`, `icon`, `content`\n\n### <oh-card>\n\nA surface that groups related content (a summary, a teaser, a settings group), with optional header and footer.\n\n**Use it for** a self-contained block of content among others, such as a teaser that links to more detail. **Don't use it for** page layout or spacing alone (use `oh-stack`, `oh-grid`); for a message that needs attention (use `oh-alert`); or for a single action (use `oh-button`).\n\n**Accessibility:** links inside use `color.text.linkOnContainer`, which keeps contrast on card surfaces. Headings inside a card stay headings, and each link or button is named by its own text.\n\n- Attributes:\n - `variant`: \"default\" | \"featured\" | \"subtle\" = \"default\" — default, featured for the one card that should stand out, or subtle, a quieter card for dense layouts.\n - `padding`: \"lg\" | \"md\" | \"none\" | \"sm\" = \"md\" — The content padding, which the header and footer match: none, sm, md (default) or lg.\n- Slots:\n - `default` — The card's main content.\n - `header` — Optional header, above the content, with a divider below. Not drawn when nothing is slotted.\n - `footer` — Optional footer, below the content, with a divider above (e.g. actions). Not drawn when nothing is slotted.\n- Parts: `card`, `header`, `content`, `footer`\n\n### <oh-chart>\n\nA chart: ranked bars, columns, lines, a donut or dots along a line, with a caption, a takeaway, keyboard access to every point and a table view.\n\n**Use it for** data that's easier to see than to read: amounts compared across categories (`bar`), a few periods side by side (`column`), change over time (`line`), parts of a whole (`donut`), or when things happened, a row per category (`dot`: every gig for each of a few artists, say). **Don't use it for** a few exact numbers (use `oh-description-list` with `value-size=\"lg\"`) or data people look things up in (use `oh-table`). See Foundation / Data visualisation for choosing a chart.\n\n**Parts:** `caption` names the chart; it's required, and the chart warns in the console without it. When a heading right above already names the chart, give `caption` the same words and set `hide-caption`: the caption still names the chart for screen readers but isn't shown twice. `summary` says, in one sentence, what the chart shows (\"March was the busiest month\"); it's recommended when the data has a clear takeaway, and left out (not invented) when it doesn't. Under the plot, a \"Show as table\" section (an `oh-accordion`, its heading at `heading-level`) holds the same data in an `oh-table`, whose first column header is `category-label` (a dot chart's table has a row per dot, with `value-label` and `detail-label` as its other headers); the caption is added to its heading for screen readers, so several charts' tables can be told apart. `hide-table` leaves this section out when the data is already readable as text: the page shows it in a table of its own (two small charts sharing one, say), or the chart is a bar chart, whose every label and value is on screen and in each bar's name. Never set it on another chart without that table.\n\n**Accessibility:** the plot is a group named by the caption and described by the takeaway; each point is an image named by its category and value, and a linked bar or column is a link with the same name. Linked bars and columns are `role=\"link\"` rather than `<a>` elements, so they stay in the chart's single Tab stop in Safari, which skips `<a>` elements on Tab by default; their labels (a column's is under it) take the link colour and dashed underline, so you can see which ones lead somewhere, and clicking a column's label follows its link too. Colour is never the only cue: every bar and donut slice is labelled, a column's or point's value appears beside it on focus or hover, and lines differ by dash and marker shape too. Under Windows high contrast, marks use system colours.\n\n- Attributes:\n - `type`: \"bar\" | \"column\" | \"donut\" | \"dot\" | \"line\" = \"column\" — bar (horizontal, ranked), column (vertical), line (change over time, up to five series), donut (parts of a whole, up to four) or dot (when things happened, a row per category).\n - `caption`: string — The chart's name.\n - `size`: \"md\" | \"sm\" = \"md\" — md (default) or sm, a shorter plot for a chart beside a short list or a few figures\n - `hide-caption`: boolean = false — Hides the caption on screen (screen readers still use it), for a chart under a heading that already names it\n - `hide-table`: boolean = false — Leaves out the \"Show as table\" section: for a chart whose data the page already shows in a table of its own (several charts sharing one, say), or a bar chart, whose labels and values are all on screen.\n - `summary`: string — One sentence saying what the chart shows.\n - `data`: ChartData = { labels: [], series: [] } — { labels, series }: the categories, and the series of values (one, or up to five for line).\n - `category-label`: string = \"Category\" — The table view's header for the categories column.\n - `heading-level`: 2 | 3 | 4 | 5 | 6 = 3 — The level of the \"Show as table\" heading, to fit the page's outline.\n - `value-label`: string — Dot charts: the table's header for where each dot falls.\n - `detail-label`: string = \"Details\" — Dot charts: the table's header for the dots' names.\n - `empty-text`: string = \"No data to show.\" — Shown instead of the plot when there's no data.\n- Parts: `chart`, `plot`\n\n### <oh-checkbox>\n\nA single checkbox with its label, for turning one option on or off.\n\n**Use it for** one yes/no choice, such as agreeing to terms, or as part of a set where any number can be chosen. **Don't use it for** a set of related options on its own (use `oh-checkbox-group`, which adds the fieldset and legend), one choice from several (use `oh-radio-group`), or a setting that applies straight away (use `oh-toggle`).\n\n**Behaviour:** clicking the box or the label toggles it, as does Space when it's focused. Each change sets `checked` and fires `oh-change`. In a native `<form>`, a checked checkbox submits `value` (`on` if unset) under `name`, as a native checkbox does; `required` blocks submitting while it's unchecked, reset restores the starting `checked`, and `disabled` (or a disabled `<fieldset>` around it) takes it out of the tab order and the form.\n\n**Accessibility:** a real native checkbox, visually hidden, carries the role, state and keyboard behaviour; the drawn box is decoration. Always set `label`: it's the checkbox's name. Focus underlines the label. The error message shows under the checkbox with an icon, sets `aria-invalid` and is linked with `aria-describedby`; it's announced (`role=\"alert\"`) only when it appears after first render.\n\n- Attributes:\n - `checked`: boolean = false — Whether the box is ticked.\n - `label`: string — The visible label, which also names the checkbox.\n - `name`: string — The form field name it submits under while checked.\n - `value`: string — The value submitted while checked (on if empty).\n - `required`: boolean = false — Must be checked before the form submits\n - `disabled`: boolean = false — Not interactive, and left out of the form\n - `error-text`: string — Error shown with the control and linked to it.\n- Events: `oh-change`\n- Parts: `box`, `label`, `error`\n\n### <oh-checkbox-group>\n\nA set of related checkboxes under one legend, where any number can be chosen.\n\n**Use it for** choosing any number of options from a short list, such as interests or notification types. **Don't use it for** one standalone yes/no option (use `oh-checkbox`), exactly one choice (use `oh-radio-group`, or `oh-select` for a long list), or settings that apply straight away (use `oh-toggle`).\n\n**Parts:** a `label` (rendered as the fieldset's `<legend>`) and a list of `options` (`{ label, value }`). `value` is the array of checked option values. **States:** each option unchecked, checked, hover, active and focus; the group can be `required` (a marker on the label), disabled, and in error (set `error-text`).\n\n**Behaviour:** Tab moves through the options and Space toggles one. Each change updates `value` and fires `oh-change` with the new array. In a native `<form>` it submits each checked value under `name`, as a set of same-named native checkboxes does (`FormData.getAll(name)` reads them all); `required` blocks submitting with none checked, reset restores the starting values, and `disabled` (or a disabled `<fieldset>` around it) takes every option out of the tab order and the form.\n\n**Accessibility:** a `<fieldset>` with a `<legend>`, so screen readers read the label with each option. Always set `label`. The error shows after the legend and before the options, with an icon; the fieldset gets `aria-invalid` and `aria-describedby`, and the error is announced (`role=\"alert\"`) only when it appears after first render. Focus underlines the option's label.\n\n- Attributes:\n - `label`: string — The group's label, rendered as the fieldset's <legend>.\n - `name`: string — The form field name each checked value is submitted under.\n - `options`: CheckboxOption[] — The checkboxes, as { label, value } objects.\n - `value`: string[] — The values of the checked options, in option order.\n - `required`: boolean = false — At least one box must be ticked: marks the label and blocks a native form from submitting while none is.\n - `disabled`: boolean = false — Not interactive, and left out of the form\n - `error-text`: string — Error shown with the control and linked to it.\n- Events: `oh-change`\n\n### <oh-cluster>\n\nA horizontal group of items that wraps onto new lines when space runs out.\n\n**Use it for** button groups, tags and rows of links. **Don't use it for** vertical lists (use `oh-stack`) or equal-width columns (use `oh-grid`).\n\n- Attributes:\n - `gap`: \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" = \"md\" — The space between items and between rows: none, xs, sm, md (default), lg or xl, from the spacing scale.\n - `justify`: \"around\" | \"between\" | \"center\" | \"end\" | \"start\" = \"start\" — How items sit along the row: start (default), center, end, between or around.\n - `align`: \"baseline\" | \"center\" | \"end\" | \"start\" = \"center\" — How items line up across the row: start, center (default), end or baseline.\n - `nowrap`: boolean = false — Keeps every item on one line instead of wrapping.\n- Slots:\n - `default` — The items to group.\n\n### <oh-container>\n\nA centred wrapper that limits content to a maximum width and adds side padding.\n\n**Use it for** the outer width of a page or section. **Don't use it for** spacing between items (use `oh-stack`, `oh-cluster` or `oh-grid`).\n\n**Behaviour:** side padding is `spacing.4`, rising to `spacing.6` from the `size.breakpoint.sm` width and `spacing.8` from `size.breakpoint.lg`.\n\n- Attributes:\n - `size`: \"full\" | \"lg\" | \"md\" | \"sm\" | \"xl\" = \"lg\" — The maximum width: sm, md, lg (default) or xl, from layout.container.*; full is the full width with no side padding.\n - `center`: boolean = false — Centres the text inside.\n- Slots:\n - `default` — The content to contain.\n\n### <oh-description-list>\n\nA list of labels and their values: the details of one thing, or a few highlights.\n\n**Use it for** facts about one thing, each with a label: an order's details, a profile, a settings summary, a set of milestones. **Don't use it for** data compared across rows and columns (use `oh-table`); a list of items with no labels (use a list); or a form (use the form controls). A few headline figures (statistics) are this list too, with `layout=\"grid\"` and `value-size=\"lg\"`.\n\n**Parts:** the default slot holds one `<dl>`, written as normal HTML. Each item is a `<div>` with one `<dt>` (the label) and a `<dd>` (the value). A second `<dd>` is a note under the value. A `<dd data-actions>` holds the item's actions, such as a \"Change\" link; give each action visually hidden text that names its item (\"Change name\"), so it makes sense on its own. In a list of figures (`value-size=\"lg\"`), an item whose value is words, such as a name, takes `data-value=\"text\"` on its `<div>`: it's set smaller (`descriptionList.size.lg.text*`) so it fits its column.\n\n**Behaviour:** none of its own: it styles the list and adds no roles or focus stops. Long values wrap.\n\n**Accessibility:** a `<dl>` groups each label with its value for assistive tech. Keep the label in the `<dt>` and the value in the `<dd>`, never the other way round, and give a list that has no visible heading nearby a heading before it.\n\n- Attributes:\n - `layout`: \"grid\" | \"rows\" = \"rows\" — rows (label beside value) or grid (label above value, items side by side).\n - `value-size`: \"lg\" | \"md\" = \"md\" — md (body text) or lg (figures, for headline numbers in the grid layout).\n- Slots:\n - `default` — One native `<dl>`, each item a `<div>` with a `<dt>` and its `<dd>`s.\n\n### <oh-divider>\n\nA rule that separates sections of a page or groups of items.\n\n**Use it for** a break between sections that don't each have a heading, or between groups in a toolbar or a footer. **Don't use it for** a card's header or footer line (`oh-card` draws its own); for space alone (use the gap of `oh-stack` or `oh-cluster`); or between every item in a list, where the gap is usually enough.\n\n**Behaviour:** none. It doesn't take focus. It adds no space of its own: the layout it's in sets the space around it.\n\n**Accessibility:** a native `<hr>`, which screen readers announce as a separator; `vertical` adds `aria-orientation=\"vertical\"`. A divider between sections that already have headings adds little, so leave it out there.\n\n- Attributes:\n - `orientation`: \"horizontal\" | \"vertical\" = \"horizontal\" — horizontal (default), across the inline axis, or vertical, between items in a row.\n- Parts: `divider`\n\n### <oh-drawer>\n\nA panel that slides in from the side of the viewport, over the page, for navigation or supplementary content.\n\n**Use it for** a site's navigation on small screens, filters, or settings that relate to the page behind. **Don't use it for** a decision the user must make before going on (use `oh-modal`); or for content that should always be visible (put it in the page).\n\n**Parts:** `heading` (an optional visible `h2`), a built-in Close button, and the default slot for the content, which scrolls when it's taller than the viewport.\n\n**Behaviour:** set `open`, or call `show()` and `hide()`. On open, focus moves to the Close button, Tab and Shift+Tab wrap inside the panel, and the page behind stops scrolling. The Close button, Escape, a click on the backdrop and `hide()` close it and fire `oh-close`; focus then returns to the element that opened it. While closed the panel is `inert`. Motion is off under `prefers-reduced-motion`.\n\n**Accessibility:** the panel is `role=\"dialog\"` with `aria-modal=\"true\"`, labelled by `heading`, or \"Navigation menu\" when there's no heading, so set `heading` for any other use. The Close button's accessible name is \"Close menu\".\n\n- Attributes:\n - `open`: boolean = false — Whether the drawer is open\n - `position`: \"end\" | \"left\" | \"right\" | \"start\" = \"start\" — The side the drawer opens from.\n - `heading`: string — Title shown in the drawer header\n- Events: `oh-close`\n- Slots:\n - `default` — Default slot for drawer content\n\n### <oh-footer>\n\nA site footer with a logo, copyright line, social links and columns of links.\n\n**Use it for** the footer at the bottom of every page. **Don't use it for** the main navigation (use `oh-navbar`).\n\n**Parts:** the `logo` slot; `copyright`, a line of text under the logo; the `social` slot for `oh-icon` links (with `inverse`); and the default slot, where each `oh-stack` becomes a column (start it with a heading, then `oh-link`s with `inverse`).\n\n**Behaviour:** the columns follow `oh-grid`'s four-column steps at the `size.breakpoint.*` widths; at and below `size.breakpoint.md` the logo column spans the full width.\n\n**Accessibility:** renders a `<footer>`. Give the logo an accessible name, each social icon a `label`, and the column headings a level that fits the page's outline.\n\n- Attributes:\n - `copyright`: string — Copyright text\n- Slots:\n - `logo` — Slot for logo element\n - `social` — Slot for social media icons\n - `default` — Default slot for link columns (use oh-stack for each column)\n\n### <oh-grid>\n\nA CSS grid of equal-width columns, fixed or as many as fit.\n\n**Use it for** cards, galleries and other sets of similar items. **Don't use it for** a single column (use `oh-stack`) or items of varying width in a row (use `oh-cluster`).\n\n**Behaviour:** fixed columns respond to the viewport: up to `size.breakpoint.sm` they become one column; up to `size.breakpoint.md`, 3 and 4 become 2; up to `size.breakpoint.lg`, 4 becomes 3.\n\n- Attributes:\n - `columns`: \"1\" | \"2\" | \"3\" | \"4\" | \"auto-fill\" | \"auto-fit\" = \"auto-fit\" — 1 to 4 fixed columns (fewer on narrow screens), or auto-fit (default) and auto-fill for as many as fit.\n - `gap`: \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" = \"md\" — The space between items: none, xs, sm, md (default), lg or xl, from the spacing scale.\n - `min-width`: string = \"280px\" — The narrowest an auto column can be, as any CSS length.\n - `align-items`: \"center\" | \"end\" | \"start\" | \"stretch\" = \"stretch\" — How items line up in their row: start, center, end or stretch (default).\n- Slots:\n - `default` — The grid items.\n\n### <oh-hero> (from @orange-halo/brand-orange-halo)\n\nThe banner at the top of an Orange Halo page: a heading on the brand colour, with a subtitle and actions, or a journey's name, step and progress.\n\n**Use it for** the top of an Orange Halo page, once. **Don't use it for** a section further down the page (use headings and `oh-card`), or in another brand: it's an Orange Halo brand pattern.\n\n**Parts:** `heading` is the page's `<h1>`. `content` (default) adds `subtitle` and the default slot for actions: the main action an `oh-button variant=\"secondary\"`, further ones `oh-link variant=\"standalone\" inverse`. `journey` shows `journey-name` above the heading and an inverse `oh-progress` for `current-step` of `total-steps`; the default slot sits under it.\n\n**Accessibility:** the heading is the page's only `<h1>`. The hero isn't a landmark: put it inside `<header>` or `<main>` as the page needs.\n\n- Attributes:\n - `variant`: \"content\" | \"journey\" = \"content\" — content (default): a heading, subtitle and actions slot.\n - `size`: \"lg\" | \"md\" | \"sm\" | \"xl\" = \"lg\" — The content's maximum width: sm, md, lg (default) or xl, from layout.container.*.\n - `heading`: string — The page heading, rendered as the page's h1.\n - `subtitle`: string — A line under the heading (content variant only).\n - `journey-name`: string — The journey's name, shown above the page heading (journey variant only).\n - `current-step`: number = 1 — The step the user is on, for the progress bar (journey variant only).\n - `total-steps`: number = 1 — How many steps the journey has (journey variant only).\n- Slots:\n - `default` — Actions (content), or anything under the progress bar (journey).\n\n### <oh-icon>\n\nAn icon from the system's built-in set, shown on its own, with a label, or as an icon-only link.\n\n**Use it for** an icon next to text, an icon that carries meaning on its own (with `accessible-label`), or a compact link such as a social profile (`href` + `accessible-label`). **Don't use it for** an icon-only button (use `oh-button` with `icon-only`); or for an image or logo (use `<img>`).\n\n**Behaviour:** the icon takes the current text colour. `arrow-left`, `arrow-right`, `chevron-left` and `chevron-right` mirror in right-to-left text, so they keep pointing back and forward along the line. With `href` it renders as a link, with hover, active and focus-visible states; `target=\"_blank\"` adds `rel=\"noopener noreferrer\"`.\n\n**Accessibility:** without `accessible-label` the icon is decorative (`aria-hidden=\"true\"`). With `accessible-label` it's `role=\"img\"` with that name. As a link, `accessible-label` is required (it logs a warning without one) and becomes the link's `aria-label`. Focus-visible shows a solid ring in `focus.ringColor` (`color.text.onAccent` when `inverse`).\n\n- Attributes:\n - `name`: \"arrow-down\" | \"arrow-left\" | \"arrow-right\" | \"arrow-up\" | \"check\" | \"chevron-down\" | \"chevron-left\" | \"chevron-right\" | \"chevron-up\" | \"close\" | \"email\" | \"error\" | \"external-link\" | \"facebook\" | \"github\" | \"heart\" | \"image\" | \"info\" | \"instagram\" | \"linkedin\" | \"list\" | \"menu\" | \"minus\" | \"plus\" | \"refresh\" | \"search\" | \"settings\" | \"sparkle\" | \"substack\" | \"success\" | \"twitter\" | \"warning\" | \"youtube\" = \"info\" — Which built-in icon to show.\n - `size`: \"lg\" | \"md\" | \"sm\" | \"xl\" — sm, md, lg or xl for a fixed size; leave it unset to follow the text size.\n - `inverse`: boolean = false — For icons on an accent-coloured or dark background.\n - `accessible-label`: string — Names an icon that carries meaning (role=\"img\"), or an icon link.\n - `href`: string — Renders the icon as a link to this URL.\n - `target`: string — The link's target; _blank adds rel=\"noopener noreferrer\".\n\n### <oh-input>\n\nA single-line text field that submits with a native form, with optional typing suggestions.\n\n**Use it for** short free text: names, email addresses, search terms. **Don't use it for** several lines (use `oh-textarea`) or a choice from a fixed list (use `oh-select`, or `oh-radio-group` for a few options). `suggestions` offers values while still allowing any text.\n\n**Behaviour:** form-associated: the value submits under `name`, `required` blocks submission (validity comes from the inner `<input>`), a form reset restores the starting value, and a disabled `<fieldset>` disables it. Fires `oh-input` as the text changes and `oh-change` when it's committed. `suggestions` renders a native `<datalist>`, so the browser handles its keyboard and screen reader support. `autocomplete` is passed to the inner `<input>`.\n\n**Accessibility:** always set `label`: it's the field's name. The error shows after the label and before the field, with an icon, and is linked with `aria-describedby` and `aria-invalid`; it's announced (`role=\"alert\"`) only when it appears after first render. Helper text is linked the same way (it's hidden while an error shows). Focus is a solid inset ring. Set `autocomplete` for personal data (WCAG 1.3.5).\n\n- Attributes:\n - `type`: \"email\" | \"password\" | \"search\" | \"tel\" | \"text\" | \"url\" = \"text\" — The kind of text: text, email, password, search, tel or url\n - `value`: string — The text in the field\n - `placeholder`: string — Example text shown while the field is empty.\n - `label`: string — The visible label.\n - `helper-text`: string — Help shown under the field and linked to it\n - `error-text`: string — Error shown before the field and linked to it.\n - `name`: string — The name the value is submitted under\n - `required`: boolean = false — Must be filled in before the form submits\n - `disabled`: boolean = false — Not editable, and left out of the form's data\n - `suggestions`: string[] — Values offered while typing, shown by the browser as a list under the field.\n - `autocomplete`: string — The input's purpose, for autofill and assistive tech (WCAG 1.3.5): an HTML autocomplete token such as \"email\", \"name\" or \"tel\".\n- Events: `oh-input`, `oh-change`\n- Parts: `label`, `input`, `helper`, `error`\n\n### <oh-link>\n\nA text link, for use inside body copy or on its own as a call to action.\n\n**Use it for** navigating to another page or place. **Don't use it for** actions that don't navigate (use `oh-button` instead).\n\n**Behaviour:** renders a native `<a>`, so Enter follows it and it takes focus in tab order. On hover the underline retracts and the arrow nudges forward. Keyboard focus (`:focus-visible`) shows a solid underline and a tint; mouse focus doesn't. Transitions are cut short under `prefers-reduced-motion`. With `target=\"_blank\"` it adds an external icon, screen-reader text \"(opens in new tab)\" and `rel=\"noopener noreferrer\"` when `rel` isn't set; the arrow is not shown on external links.\n\n**Accessibility:** the underline shows at rest and on focus, so links don't rely on colour. Write link text that makes sense out of context.\n\n- Attributes:\n - `href`: string — Where the link goes.\n - `target`: string — The link's target.\n - `rel`: string — The link's rel.\n - `variant`: \"inline\" | \"standalone\" = \"inline\" — inline (default) for links in running text, or standalone, larger and bolder, for a link on its own.\n - `arrow`: boolean = false — Shows a trailing arrow on a standalone link (not on external links).\n - `inverse`: boolean = false — For links on accent-coloured or dark surfaces.\n- Slots:\n - `default` — The link text.\n\n### <oh-modal>\n\nA dialog that opens over the page and holds the user's attention until they close it or act on it.\n\n**Use it for** a short task or decision that must be done before going on: a confirmation, a small form. **Don't use it for** content the user may want alongside the page (use `oh-drawer`); for a message that doesn't need an answer (use `oh-alert`); or for long, multi-step flows (use a page).\n\n**Parts:** `heading` (a visible `h2`); the default slot for the body, which scrolls when it's taller than the viewport; the `footer` slot for actions (with nothing in it, there's no footer).\n\n**Behaviour:** set `open` to show it. On open, focus moves to the Close button (or the first focusable element when there's none), Tab and Shift+Tab wrap inside the dialog, and the page behind stops scrolling. On close, focus returns to the element that had it. With `dismissible` (the default), the Close button, Escape and a click on the backdrop each fire `oh-close` and set `open` to false; without it, only your own buttons close it. Motion is reduced under `prefers-reduced-motion`.\n\n**Accessibility:** the panel is `role=\"dialog\"` with `aria-modal=\"true\"`, named by `heading`. Without a visible heading, set `accessible-label` (not `aria-label` on the host, which isn't forwarded). The close button has a visible \"Close\" label.\n\n- Attributes:\n - `open`: boolean = false — Whether the dialog is showing.\n - `heading`: string — The visible title (an h2), which also names the dialog.\n - `accessible-label`: string — Names the dialog when it has no visible heading.\n - `dismissible`: boolean = true — Lets the Close button, Escape and a backdrop click close it, each firing oh-close (default on).\n - `size`: \"lg\" | \"md\" | \"sm\" | \"xl\" = \"md\" — The dialog's width: sm, md (default), lg or xl (an image beside its details), never wider than the viewport.\n- Events: `oh-close`\n- Slots:\n - `default` — The dialog body.\n - `footer` — Actions, below the body.\n- Parts: `modal`, `header`, `close`, `body`, `footer`\n\n### <oh-navbar>\n\nA site header bar with a logo and the site's main navigation links, which move into a drawer on narrow viewports.\n\n**Use it for** the main navigation at the top of every page. **Don't use it for** in-page sections (use `oh-tabs`) or a trail through the hierarchy (use `oh-breadcrumb`).\n\n**Parts:** the `logo` slot (a link to the home page), the default slot for the bar's links (`oh-link`), and the `mobile` slot for the same links in the drawer. `drawer-heading` names the drawer (defaults to \"Menu\").\n\n**Behaviour:** at and below the `size.breakpoint.md` width the links hide and an icon-only menu button (\"Open navigation menu\") opens an `oh-drawer` from the left, which traps focus and closes on Escape or its close button.\n\n**Accessibility:** the bar and the drawer each wrap their links in a `<nav>`; the drawer is a modal dialog. Give the logo link an accessible name (`alt` on its image, or text).\n\n- Attributes:\n - `drawer-heading`: string = \"Menu\" — Heading shown in the mobile drawer\n- Slots:\n - `logo` — Slot for logo/brand element\n - `default` — Default slot for navigation links\n - `mobile` — The navigation links again, shown in the drawer\n\n### <oh-progress>\n\nA bar that shows how much of a task is done, with an optional percentage and visible label.\n\n**Use it for** a task with a known end: an upload, a download, steps completed. **Don't use it for** a wait of unknown length (it has no indeterminate state); or for a measurement that isn't progress, like storage used against a quota (a meter).\n\n**Behaviour:** `value` runs from 0 to `max` (default 100) and is clamped to that range; the bar and the percentage show `value / max`, rounded. `show-value` (on by default) shows the percentage; `show-label` shows `label` above the bar. The fill's width animates when the value changes, except under `prefers-reduced-motion`.\n\n**Accessibility:** the bar is a `progressbar` with `aria-valuenow`, `aria-valuemin`, `aria-valuemax` and `aria-label` from `label` (default \"Progress\"). Always set `label` to say what is progressing. The visible percentage is `aria-hidden`, since screen readers read the value from the progressbar.\n\n- Attributes:\n - `value`: number = 0 — Current progress value (0-100 by default, or 0-max)\n - `max`: number = 100 — Maximum value (default 100)\n - `label`: string = \"Progress\" — Accessible label describing what the progress represents\n - `show-label`: boolean = false — Whether to show the visible label above the bar\n - `show-value`: boolean = true — Whether to show the percentage number\n - `size`: \"lg\" | \"md\" | \"sm\" = \"md\" — Size variant\n - `variant`: \"brand\" | \"error\" | \"info\" | \"success\" | \"warning\" = \"brand\" — Color variant\n - `inverse`: boolean = false — Inverse colors for dark backgrounds\n- Parts: `track`, `fill`, `value`\n\n### <oh-radio>\n\nA single radio button with its label.\n\n**Use it for** a one-off radio you manage yourself. **Don't use it for** a set of choices (use `oh-radio-group`). Each `oh-radio` keeps its native radio inside its own shadow root, so two of them with the same `name` don't form a group: checking one doesn't uncheck the other, and arrow keys don't move between them. `oh-radio-group` renders the whole set in one place, with arrow-key navigation and one label for the group. For an independent on/off choice use `oh-checkbox`.\n\n**Behaviour:** clicking the circle or label checks it. Checking sets `checked` and fires `oh-change`. The native radio sits in the shadow root, so it doesn't submit with a native form.\n\n**Accessibility:** a real native radio, visually hidden, carries the role and state; the drawn circle is decoration. Always set `label`: it's the radio's name. Focus underlines the label. The error message shows under the radio with an icon, sets `aria-invalid` and is linked with `aria-describedby`; it's announced (`role=\"alert\"`) only when it appears after first render.\n\n- Attributes:\n - `checked`: boolean = false — Whether this radio is chosen.\n - `label`: string — The visible label, which also names the radio.\n - `name`: string — A name for your own grouping.\n - `value`: string — This radio's value, sent with oh-change.\n - `error-text`: string — Error shown with the control and linked to it.\n- Events: `oh-change`\n- Parts: `circle`, `label`, `error`\n\n### <oh-radio-group>\n\nA set of radio buttons under one label, where exactly one can be chosen.\n\n**Use it for** one choice from a few options that should all be visible, such as a plan or a delivery speed. **Don't use it for** a long list (use `oh-select`), several choices (use `oh-checkbox-group`) or an on/off setting (use `oh-toggle` or `oh-checkbox`). Use it rather than separate `oh-radio` elements, which can't form a group.\n\n**Parts:** a `label` for the group and a list of `options` (`{ label, value }`). `value` is the chosen option's value. **States:** each option unchecked, checked, hover, active and focus; the group can be `required`, disabled, and in error (set `error-text`).\n\n**Behaviour:** Tab moves into and out of the group; arrow keys move between options and choose them (the browser's native radio behaviour). Each change sets `value` and fires `oh-change`. In a native `<form>` it submits `value` under `name` (nothing while no option is chosen); `required` blocks submitting with none chosen, reset restores the starting value, and `disabled` (or a disabled `<fieldset>` around it) takes every option out of the tab order and the form.\n\n**Accessibility:** `role=\"radiogroup\"` labelled by `label`, so always set one. The error shows after the label and before the options, with an icon; the group gets `aria-invalid` and `aria-describedby`, and the error is announced (`role=\"alert\"`) only when it appears after first render. Focus underlines the option's label.\n\n- Attributes:\n - `label`: string — The group's visible label, which also names the group.\n - `name`: string — The form field name the chosen value is submitted under.\n - `options`: RadioOption[] — The radios, as { label, value } objects.\n - `value`: string — The chosen option's value (empty for none).\n - `required`: boolean = false — An option must be chosen: marks the label and blocks a native form from submitting while none is.\n - `disabled`: boolean = false — Not interactive, and left out of the form\n - `error-text`: string — Error shown with the control and linked to it.\n- Events: `oh-change`\n\n### <oh-select>\n\nA dropdown for choosing one option from a list.\n\n**Use it for** one choice from a list too long to show every option. **Don't use it for** a few options (use `oh-radio-group`, which shows them all), several choices (use `oh-checkbox-group`) or free text (use `oh-input` with `suggestions`).\n\n**Parts:** a trigger showing the selected option's label (or `placeholder`), and a list of `options` (`{ label, value }`). One size. **States:** rest, hover, active, focus, open, error (set `error-text`), required, disabled.\n\n**Behaviour:** click the trigger, or press Enter, Space or an arrow key, to open the list. Arrow keys, Home and End move the highlight, Enter or Space selects, Escape and Tab close, and clicking outside closes. Typing letters jumps to a matching option (and selects it while the list is closed). Selecting sets `value`, returns focus to the trigger and fires `oh-change`. In a native `<form>` it submits `value` under `name` (nothing while no option is chosen), `required` blocks submitting with no option chosen, reset restores the starting value, and `disabled` (or a disabled `<fieldset>` around it) takes it out of the tab order and the form.\n\n**Accessibility:** the trigger is a `combobox` controlling a `listbox`, with `aria-activedescendant` for the highlighted option, so focus stays on the trigger. Always set `label`: it names the trigger and the list. The error shows after the label and before the trigger, with an icon, sets `aria-invalid` and is linked with `aria-describedby`; it's announced (`role=\"alert\"`) only when it appears after first render. Focus is a solid underline on the trigger text.\n\n- Attributes:\n - `label`: string — The visible label, which names the trigger and the list.\n - `placeholder`: string = \"Select an option\" — Shown on the trigger while no option is chosen.\n - `name`: string — The form field name the chosen value is submitted under.\n - `options`: SelectOption[] — The choices, as { label, value } objects.\n - `value`: string — The chosen option's value (empty for none).\n - `required`: boolean = false — An option must be chosen: marks the label and blocks a native form from submitting while none is.\n - `disabled`: boolean = false — Not interactive, and left out of the form\n - `helper-text`: string — Help shown under the field and linked to it with aria-describedby.\n - `error-text`: string — An error message.\n- Events: `oh-change`\n\n### <oh-skip-link>\n\nA \"skip to content\" link that lets keyboard users jump past repeated content, such as navigation.\n\n**Use it for** the first focusable element on every page, pointing at the main content. Add more for other landmarks (search results, footer) if useful. **Don't use it for** in-page navigation that everyone sees (use `oh-link`).\n\n**Parts:** `href` is the target (defaults to `#main`); `text` is the label (defaults to \"Skip to main content\").\n\n**Behaviour:** hidden until it receives keyboard focus, then shown fixed at the top-left of the viewport, above other content. Enter follows the link. Transitions are cut short under `prefers-reduced-motion`.\n\n**Accessibility:** screen readers can read it at all times. Put it first in the page, and give the target an `id` and `tabindex=\"-1\"` so focus moves to it.\n\n- Attributes:\n - `href`: string = \"#main\" — The target to jump to, usually the main content's id.\n - `text`: string = \"Skip to main content\" — The link's text.\n\n### <oh-spinner>\n\nA turning arc that shows something is loading, when you can't say how long it will take.\n\n**Use it for** a wait of unknown length: a panel fetching its content, a search running. **Don't use it for** a task with a known end (use `oh-progress`, which shows how far along it is); or for a button's own action (set `loading` on `oh-button`, which draws this spinner and keeps the button's name).\n\n**Parts:** `label` shows a visible message beside the arc (\"Loading results\"). Without it, the spinner is named by `accessible-label` (default \"Loading\") for screen readers only.\n\n**Behaviour:** the arc turns until the spinner is removed. `inverse` is for a spinner on a brand-coloured or dark fill. Under `prefers-reduced-motion` the arc doesn't turn, so give a long wait a visible `label`.\n\n**Accessibility:** `role=\"progressbar\"` with no value (an indeterminate progress bar), named by `label` or `accessible-label`. It isn't a live region: adding it to the page doesn't announce it. When people need to hear that something is loading, put the message in a live region of your own. Remove the spinner when the content arrives, and set `aria-busy=\"true\"` on the region that's loading while it waits.\n\n- Attributes:\n - `size`: \"lg\" | \"md\" | \"sm\" — sm, md or lg for a fixed size; leave it unset to follow the text size.\n - `label`: string — A visible message beside the arc, such as \"Loading results\".\n - `accessible-label`: string = \"Loading\" — The spinner's name for screen readers when there's no visible label.\n - `inverse`: boolean = false — For a spinner on a brand-coloured or dark fill.\n- Parts: `spinner`, `arc`, `label`\n\n### <oh-stack>\n\nA vertical layout that spaces its children evenly, top to bottom.\n\n**Use it for** consistent vertical rhythm without margins on children. **Don't use it for** items in a row (use `oh-cluster`) or a grid of cards (use `oh-grid`).\n\n- Attributes:\n - `gap`: \"2xl\" | \"lg\" | \"md\" | \"none\" | \"sm\" | \"xl\" | \"xs\" = \"md\" — The space between children: none, xs, sm, md (default), lg, xl or 2xl, from the spacing scale.\n - `align`: \"center\" | \"end\" | \"start\" | \"stretch\" = \"stretch\" — Horizontal alignment of the children: start, center, end or stretch (default).\n- Slots:\n - `default` — The items to stack.\n\n### <oh-table>\n\nA data table: the styles and scrolling for a native `<table>` you write inside it.\n\n**Use it for** data people compare across rows and columns: figures by month, a list of records with several attributes. **Don't use it for** layout; a list of single items (use a list); or label-and-value pairs (use a description list, `<dl>`).\n\n**Parts:** the default slot holds one `<table>`, written as normal HTML: a `<caption>` that names it, `<thead>` with `<th scope=\"col\">` headers, `<tbody>`, and an optional `<tfoot>` for totals. Use `<th scope=\"row\">` for the cell that names its row. Cells can hold anything, including links, badges and buttons. Put `data-align=\"end\"` on the header and cells of a column of numbers so the digits line up; figures are tabular throughout. Show an empty result as one row with a cell spanning every column (`colspan`) that says there's nothing to show.\n\n**Behaviour:** none of its own: no sorting, selection or sticky header. The table is as wide as its content. Column headers and end-aligned cells stay on one line; other cells wrap. When it's wider than its container it scrolls sideways, and the element becomes a focusable region named by the caption, so keyboard users can scroll it with the arrow keys.\n\n**Accessibility:** always give the table a `<caption>` (visually hidden if a heading already names it), or failing that `aria-label` on the `<table>`, which `accessible-label` sets for you. Use `<th>` with `scope` for every header; never use the table for layout.\n\n- Attributes:\n - `density`: \"compact\" | \"default\" = \"default\" — default, or compact for long tables or tight spaces.\n - `accessible-label`: string — Names the table for assistive tech when it has no <caption>: set as the table's aria-label.\n- Slots:\n - `default` — One native `<table>`, with a `<caption>`.\n- Parts: `table`\n\n### <oh-tabs>\n\nA set of tabs that switches between panels of related content in the same place.\n\n**Use it for** a few peer sections of content where only one needs to be seen at a time. **Don't use it for** navigating between pages (use links or `oh-navbar`), or for content people need to compare side by side.\n\n**Parts:** pass `items`, an array of `{ id, label, content? }`. A panel shows `content` as text, or else the light-DOM element with `slot=\"<id>\"`. `value` is the selected tab's `id` (defaults to the first).\n\n**Behaviour:** click selects a tab. Arrow keys move focus between tabs and wrap (Left/Right, swapped in right-to-left text, or Up/Down when `orientation=\"vertical\"`; orientation changes the keys only, not the layout); Home/End jump to the first/last. Enter or Space selects the focused tab and moves focus to its panel. Selecting a different tab fires `oh-change`. Transitions are cut short under `prefers-reduced-motion`.\n\n**Accessibility:** tablist/tab/tabpanel roles with `aria-selected`, `aria-controls` and `aria-labelledby`; one tab is in the tab order at a time; inactive panels are `hidden`; the active panel is focusable. Keyboard focus shows a solid underline on the tab label and an outline on the panel. Keep labels short.\n\n- Attributes:\n - `items`: TabItem[] — The tabs: { id, label, content? }.\n - `value`: string — The selected tab's id.\n - `orientation`: \"horizontal\" | \"vertical\" = \"horizontal\" — Orientation of the tabs (affects arrow key behavior)\n- Events: `oh-change`\n\n### <oh-tag>\n\nA small interactive label: a filter the user turns on and off, or a value they've chosen and can remove.\n\n**Use it for** filters that narrow a list (\"Festivals\", \"2024\"), shown side by side, and for the values someone has picked, such as the filters currently applied, each with a × to remove it. **Don't use it for** a label nobody acts on, such as a status or category (use `oh-badge`); an action (use `oh-button`); a link to another page (use `oh-link`); or one setting in a form (use `oh-checkbox` or `oh-toggle`).\n\n**Kinds:** a filter by default; `removable` for a chosen value. A tag is one or the other: a removable tag can't be turned on.\n\n**Parts:** the default slot holds the text, a word or two; the `icon` slot an optional leading icon, sized to the text.\n\n**Behaviour:** a filter tag is one button. Clicking it, or pressing Space or Enter while it's focused, flips `checked` and fires `oh-change` with `{ checked }`. In a native `<form>`, an \"on\" tag submits `value` (`on` if unset) under `name`, like a checkbox, so a row of tags with one `name` submits every one that's on; reset restores the starting state. A removable tag has one button, the ×: clicking it, or pressing Space or Enter on it, fires `oh-remove` with `{ value }`. The tag stays until the page removes it, and the page should then move focus to the next tag's ×, or to the heading or control before the list when it was the last one, because the focused button has gone. Pressing Backspace or Delete on the × does the same as clicking it. `disabled` (or a disabled `<fieldset>` around it) takes it out of the tab order and the form; a disabled removable tag still shows its text normally, and only the × can't be used.\n\n**Accessibility:** a filter tag is a `<button>` with `aria-pressed`, named by its text. A removable tag's text is plain, and its × is a `<button>` named \"Remove\" and the text (\"Remove Festivals\"); set `remove-label` to translate \"Remove\". On, a filter tag shows a check mark as well as its colour. Group a row of tags under a visible heading or a `<fieldset>` and `<legend>` that says what they filter. Focus is a solid outline in `focus.ringColor`.\n\n- Attributes:\n - `checked`: boolean = false — A filter tag: whether it's on.\n - `removable`: boolean = false — A chosen value with a × that fires oh-remove, instead of a filter\n - `remove-label`: string = \"Remove\" — The word before the text in the ×'s name (\"Remove Festivals\").\n - `name`: string — Name for form submission (filter tags)\n - `value`: string — Submitted when a filter tag is on (on if unset), and sent with oh-remove\n - `disabled`: boolean = false — Not interactive, and left out of the form\n- Events: `oh-change`, `oh-remove`\n- Slots:\n - `default` — The tag text.\n - `icon` — Optional leading icon. Mark it `aria-hidden`.\n- Parts: `tag`, `remove`\n\n### <oh-textarea>\n\nA multi-line text field that submits with a native form.\n\n**Use it for** messages, comments, feedback: text that may run to several lines. **Don't use it for** a single line of text (use `oh-input`).\n\n**Behaviour:** form-associated. Give it a `name` and it submits with the form. `required` stops the form submitting while it's empty, with the browser's own message. A form reset restores its starting text, and a disabled `<fieldset>` disables it. Fires `oh-input` on every keystroke and `oh-change` when the value is committed. Its line height is 1.5 times the text size, rounded up to `grid.unit`, so long messages stay on the grid.\n\n**Accessibility:** always set `label`: it names the field. A placeholder isn't a label. Helper and error text are linked to the field with `aria-describedby`, so screen readers read them. Errors come before the field, with an icon, set `aria-invalid`, and are announced only when they appear after the page has loaded. Focus is a solid inset ring. Use `autocomplete` when the field asks for something a browser can fill in, such as an address (WCAG 1.3.5).\n\n- Attributes:\n - `label`: string — The visible label.\n - `value`: string — The text in the field\n - `placeholder`: string — Example text shown while the field is empty.\n - `helper-text`: string — Help shown under the field and linked to it\n - `error-text`: string — Error shown before the field and linked to it.\n - `name`: string — The name the value is submitted under\n - `required`: boolean = false — Must be filled in before the form submits\n - `disabled`: boolean = false — Not editable, and left out of the form's data\n - `rows`: number = 4 — Visible lines of text before the field scrolls (people can drag it taller)\n - `maxlength`: number — Longest allowed text, in characters\n - `autocomplete`: string — The field's purpose for autofill and assistive tech (WCAG 1.3.5), e.g. \"street-address\"\n- Events: `oh-input`, `oh-change`\n- Parts: `label`, `textarea`, `helper`, `error`\n\n### <oh-timeline>\n\nA dated list: entries under group headings, each a date beside what happened, with markers and notes between groups.\n\n**Use it for** things that happened, or will, in order: a history of events, a CV's jobs and education, a changelog, an order's progress written as a list. **Don't use it for** data compared across columns (use `oh-table`); facts about one thing (use `oh-description-list`); or steps someone works through (a stepper, which OHDS doesn't have yet).\n\n**Parts:** everything is normal HTML inside the element. - A **group** is a heading (`<h2>`–`<h6>`: a year, \"Upcoming\", \"Experience\") followed by an `<ol>` (or `<ul>`) of entries. A `<small>` inside the heading holds a count or note (\"12 gigs\"). - An **entry** is an `<li>`. Its first child is the **date**: a `<time datetime>`, or a `<p>` holding a range (`<time>2019</time> – <time>2023</time>`). Its second child holds **what happened**: a heading (`<h3>`–`<h6>`) and paragraphs; give a paragraph `data-meta` to set it in the secondary colour (a place, a type). An optional element with `data-aside` holds **badges or actions** at the end of the row. - A **marker** (`<p data-marker>`) is a line across the list with a label, such as \"Today\" between upcoming and past events, or \"Now\" in a CV. - A **note** (`<p data-note>`) is a short line between groups, such as \"No gigs in 2016\" or \"Career break\".\n\n**Behaviour:** none of its own: it styles the markup and adds no roles or focus stops. To bring someone to an entry (from a link or a dialog), give the `<li>` `tabindex=\"-1\"` and focus it: it shows the focus ring until focus moves on.\n\n**Accessibility:** the headings let screen-reader users move between groups, each list announces how many entries it has, and `<time datetime>` gives each date a machine-readable value. Use heading levels that fit the page's outline, one level below the group headings for entry titles. Write the date as it should be read (\"Sat 15 Nov 2026\", not \"15/11\").\n\n- Attributes:\n - `sticky-headings`: boolean = false — Keeps each group heading in view while its entries scroll past.\n- Slots:\n - `default` — Group headings, lists of entries, markers and notes, as normal HTML.\n\n### <oh-toggle>\n\nA switch that turns a setting on or off.\n\n**Use it for** a setting that takes effect straight away, such as turning notifications on, or an on/off setting in a settings form. **Don't use it for** something that must be agreed to (use `oh-checkbox`), or a choice between more than two options (use `oh-radio-group`).\n\n**Behaviour:** clicking the switch or its label, or pressing Space or Enter while it's focused, flips `checked` and fires `oh-change` with `{ checked }`. In a native `<form>`, an \"on\" toggle submits `value` (`on` if unset) under `name`, like a checkbox; reset restores the starting state, and `disabled` (or a disabled `<fieldset>` around it) takes it out of the tab order and the form. Under `prefers-reduced-motion` it doesn't animate.\n\n**Accessibility:** `role=\"switch\"` with `aria-checked`, in the tab order. Disabled, it has `aria-disabled=\"true\"` and leaves the tab order. Set `label` (a visible label, linked with `aria-labelledby`), or `accessible-label` when there's no visible label (not `aria-label`, which isn't forwarded into the shadow root). Focus is a solid outline in `focus.ringColor`.\n\n- Attributes:\n - `checked`: boolean = false — Whether the toggle is checked/on\n - `label`: string — Label text displayed next to the toggle\n - `accessible-label`: string — Accessible name when there's no visible label.\n - `name`: string — Name for form submission\n - `value`: string = \"on\" — Value for form submission\n - `disabled`: boolean = false — Not interactive, and left out of the form\n- Events: `oh-change`\n\n### <oh-tooltip>\n\nShows the name of an icon-only control in a small bubble while the pointer rests on it or it has keyboard focus.\n\n**Use it for** an icon-only button or link, so people who can see the screen learn its name too. **Don't use it for** information people need to finish a task, or anything they'd need on a touch screen (put it on the page, or in `oh-callout`); for a control that already shows its name as text; or for anything interactive: the bubble holds plain text only.\n\n**Parts:** the default slot holds one control, usually `<oh-button icon-only accessible-label=\"…\">`. `text` is what the bubble says, and must be the control's name: the same words as its `accessible-label` or `aria-label`. The tooltip warns in the console when they differ.\n\n**Behaviour:** the bubble shows after `tooltip.base.showDelay` when the pointer rests on the control, and at once when the control gets keyboard focus. It stays while the pointer is on the control or the bubble, and for `tooltip.base.hideDelay` after it leaves, so the pointer can move onto it. Escape hides it without moving focus. A pointer press doesn't show it.\n\n**Accessibility:** the bubble is `aria-hidden`, because it repeats the control's name, which screen readers already announce. It meets WCAG 1.4.13: it can be dismissed with Escape, the pointer can move onto it, and it stays until the pointer or focus leaves. Touch screens have no hover, which is why a tooltip only ever repeats a name.\n\n- Attributes:\n - `text`: string — What the bubble says: the control's name, the same words as its accessible-label.\n - `placement`: \"bottom\" | \"top\" = \"top\" — top (default) or bottom.\n- Slots:\n - `default` — The control the tooltip names: one icon-only button or link.\n- Parts: `bubble`\n\n### <oh-visually-hidden>\n\nText that screen readers read but the screen doesn't show, such as the extra words that make a repeated link make sense on its own.\n\n**Use it for** words that complete a name for people who can't see the layout: \"Read review\" + \"of Ferocious and focused\", \"Change\" + \"name\", a heading for a group whose purpose is clear by sight. **Don't use it for** hiding content from everyone (use `hidden`); for naming a control that takes `label` or `accessible-label` (use those); or for text sighted people need too.\n\n**Parts:** the default slot holds the hidden text, usually inline inside a link, a button's label or a heading.\n\n**Behaviour:** it takes no space and shows nothing. With `focusable`, it shows while anything inside it has focus.\n\n**Accessibility:** the text stays in the accessibility tree, so it joins the accessible name of the link or button around it and screen readers read it in place. Never put a focusable control inside without `focusable`: a focused control must be visible (WCAG 2.4.7).\n\n- Attributes:\n - `focusable`: boolean = false — Shows the content while something inside it has focus, such as a skip link.\n- Slots:\n - `default` — The hidden text.\n\n## Tier 2 tokens (the same names in every brand)\n\nUse as CSS custom properties: `color.brand.primary` is `var(--oh-color-brand-primary)`. Values differ by brand; see https://orangehalo.co.uk/ohds/?path=/docs/foundation-tokens--docs\n\n- `color.brand`: `primary`, `primaryHover`, `primaryActive`, `primarySubtle`, `highlight`, `accent`, `accentHover`, `accentActive`, `accentSubtle`, `accentShadow`\n- `color.feedback`: `success`, `successSubtle`, `error`, `errorHover`, `errorSubtle`, `warning`, `warningSubtle`, `info`, `infoSubtle`\n- `color.surface`: `base`, `container`, `featured`, `inset`, `field`, `highlight`, `overlay`, `disabled`, `hover`, `active`, `featuredStart`, `featuredMid`, `featuredEnd`, `headerTint`, `backdrop`, `hoverTint`, `headerTintFade`, `onBrandTrack`, `onBrandFocus`\n- `color.border`: `default`, `subtle`, `emphasis`, `strong`, `hover`, `disabled`, `brand`, `brandHover`, `divider`, `onBrandTrack`\n- `color.text`: `primary`, `secondary`, `disabled`, `inverse`, `link`, `linkHover`, `linkOnContainer`, `brand`, `onBrand`, `onAccent`, `onSuccess`, `onError`, `onWarning`, `onInfo`\n- `color.data`: `categorical.1`, `categorical.2`, `categorical.3`, `categorical.4`, `categorical.5`, `muted`, `grid`, `axis`\n- `typography.heading`: `fontFamily`, `h1.fontSize`, `h1.fontWeight`, `h1.lineHeight`, `h1.letterSpacing`, `h2.fontSize`, `h2.fontWeight`, `h2.lineHeight`, `h2.letterSpacing`, `h3.fontSize`, `h3.fontWeight`, `h3.lineHeight`, `h3.letterSpacing`, `h4.fontSize`, `h4.fontWeight`, `h4.lineHeight`, `h4.letterSpacing`, `h5.fontSize`, `h5.fontWeight`, `h5.lineHeight`, `h6.fontSize`, `h6.fontWeight`, `h6.lineHeight`\n- `typography.body`: `fontFamily`, `xl.fontSize`, `xl.fontWeight`, `xl.lineHeight`, `lg.fontSize`, `lg.fontWeight`, `lg.lineHeight`, `base.fontSize`, `base.fontWeight`, `base.lineHeight`, `sm.fontSize`, `sm.fontWeight`, `sm.lineHeight`, `sm.letterSpacing`, `xs.fontSize`, `xs.fontWeight`, `xs.lineHeight`, `xs.letterSpacing`\n- `typography.label`: `fontFamily`, `base.fontSize`, `base.fontWeight`, `base.lineHeight`, `base.letterSpacing`, `sm.fontSize`, `sm.fontWeight`, `sm.lineHeight`, `sm.letterSpacing`\n- `typography.eyebrow`: `fontFamily`, `fontSize`, `fontWeight`, `letterSpacing`\n- `typography.control`: `fontFamily`, `fontWeight`, `letterSpacing`, `sm.fontSize`, `md.fontSize`, `lg.fontSize`\n- `typography.emphasis`: `fontWeight`\n- `typography.code`: `fontFamily`, `fontSize`, `lineHeight`\n- `spacing`: `layout.page`, `layout.section`, `layout.stack`, `layout.inline`\n- `layout`: `container.sm`, `container.md`, `container.lg`, `container.xl`\n- `shape`: `control`, `container`, `large`, `compact`, `tight`, `pill`\n- `elevation`: `soft`, `medium`, `strong`, `inset`\n- `elevation.surface`: `subtle`, `default`, `hover`, `active`, `focus`, `featured`, `featuredHover`, `featuredFocus`\n- `elevation.offset`: `xs`, `sm`, `md`, `lg`, `xl`, `2xl`\n- `elevation.color`: `primary`, `secondary`, `error`, `neutral`, `neutralHover`, `overlay`, `field`, `hoverTint`, `inset`\n- `lift`: `hoverSm`, `hoverMd`, `activeSm`, `activeMd`\n- `stroke`: `control`, `surface`, `divider`, `data`\n- `decoration`: `underlineThickness`, `underlineFocusThickness`, `underlineDash`, `underlinePeriod`\n- `motion`: `quick`, `snappy`, `gentle`, `relaxed`, `slow`, `easeGentle`, `easeOut`, `easeEmphasized`\n- `focus`: `ringWidth`, `ringOffset`, `ringColor`, `decorationColor`\n- `spacing`: `0`, `0-5`, `1`, `1-5`, `2`, `2-5`, `3`, `3-5`, `4`, `5`, `6`, `7`, `8`, `10`, `12`, `16`, `20`, `px` (`spacing.<n>` is n half grid units)\n\nDeprecated, removed in the next major (don't use): `color.accent.default`, `color.accent.hover`, `color.accent.active`, `color.accent.subtle`, `color.accent.shadow`, `typography.control.fontSize.sm`, `typography.control.fontSize.md`, `typography.control.fontSize.lg`\n","tier2":[{"path":"color.brand.primary","description":"Primary brand action — WCAG AA"},{"path":"color.brand.primaryHover","description":"Hover state"},{"path":"color.brand.primaryActive","description":"Active/pressed state"},{"path":"color.brand.primarySubtle","description":"Subtle tint"},{"path":"color.brand.highlight","description":"Golden accent"},{"path":"color.brand.accent","description":"Signature blue accent"},{"path":"color.brand.accentHover","description":""},{"path":"color.brand.accentActive","description":""},{"path":"color.brand.accentSubtle","description":""},{"path":"color.brand.accentShadow","description":"Chunky shadow for accent"},{"path":"color.accent.default","description":"Deprecated, don't use: Renamed in 4.2 to color.brand.accent; removed in 5.0"},{"path":"color.accent.hover","description":"Deprecated, don't use: Renamed in 4.2 to color.brand.accentHover; removed in 5.0"},{"path":"color.accent.active","description":"Deprecated, don't use: Renamed in 4.2 to color.brand.accentActive; removed in 5.0"},{"path":"color.accent.subtle","description":"Deprecated, don't use: Renamed in 4.2 to color.brand.accentSubtle; removed in 5.0"},{"path":"color.accent.shadow","description":"Deprecated, don't use: Renamed in 4.2 to color.brand.accentShadow; removed in 5.0"},{"path":"color.feedback.success","description":"5.2:1 on successSubtle — green.600 failed AA for text"},{"path":"color.feedback.successSubtle","description":""},{"path":"color.feedback.error","description":""},{"path":"color.feedback.errorHover","description":"Error hover/active state"},{"path":"color.feedback.errorSubtle","description":""},{"path":"color.feedback.warning","description":""},{"path":"color.feedback.warningSubtle","description":""},{"path":"color.feedback.info","description":""},{"path":"color.feedback.infoSubtle","description":""},{"path":"color.surface.base","description":"Page background — warm off-white"},{"path":"color.surface.container","description":"Cards, panels — slight lift"},{"path":"color.surface.featured","description":"Featured — use with gradient"},{"path":"color.surface.inset","description":"Inputs, wells — pressed in"},{"path":"color.surface.field","description":"The fill of text fields, text areas and select triggers. Orange Halo's fields sit on the page colour; their border and inset shadow set them apart."},{"path":"color.surface.highlight","description":"Brightest surface — focused inputs, top of raised gradients"},{"path":"color.surface.overlay","description":"Modal backdrop — warm"},{"path":"color.surface.disabled","description":"Quiet disabled"},{"path":"color.surface.hover","description":"Warm hover tint"},{"path":"color.surface.active","description":"Active/pressed surface"},{"path":"color.surface.featuredStart","description":"Featured (sunlit) card gradient: top"},{"path":"color.surface.featuredMid","description":"Featured (sunlit) card gradient: 30%"},{"path":"color.surface.featuredEnd","description":"Featured (sunlit) card gradient: bottom"},{"path":"color.surface.headerTint","description":"Light glaze at the top of card headers, fading to transparent"},{"path":"color.surface.backdrop","description":"Modal backdrop — darker than surface.overlay so the dialog stands out"},{"path":"color.surface.hoverTint","description":"A translucent hover layer that works over any surface, for icon-only buttons such as close buttons. Darkens in light themes, lightens in dark ones"},{"path":"color.surface.headerTintFade","description":"Where color.surface.headerTint fades to: fully transparent"},{"path":"color.surface.onBrandTrack","description":"A track (such as a progress bar's) on a brand or accent background. The same in both themes: the brand background doesn't change much between them, and check:contrast checks the fill against it"},{"path":"color.surface.onBrandFocus","description":"The tint behind a focused link on a brand or accent background, paired with the underline (the indicator). The same in both themes, like color.surface.onBrandTrack"},{"path":"color.border.default","description":"Standard border"},{"path":"color.border.subtle","description":"Subtle dividers"},{"path":"color.border.emphasis","description":"Strong border for form elements"},{"path":"color.border.strong","description":"Neutral edge between default and emphasis — card hover, drawer edge. Decorative, not a 3:1 control border"},{"path":"color.border.hover","description":"Hover border — darker for feedback"},{"path":"color.border.disabled","description":""},{"path":"color.border.brand","description":"Brand-tinted border"},{"path":"color.border.brandHover","description":"Brand-tinted border on hover. Decorative container edge — not a focus or control border"},{"path":"color.border.divider","description":"Decorative divider inside a container, such as a card's header and footer"},{"path":"color.border.onBrandTrack","description":"The border of a track on a brand or accent background. The same in both themes, like color.surface.onBrandTrack"},{"path":"color.text.primary","description":"Primary text — warm brown"},{"path":"color.text.secondary","description":"Secondary text"},{"path":"color.text.disabled","description":"Disabled text"},{"path":"color.text.inverse","description":"On dark backgrounds"},{"path":"color.text.link","description":"Link text"},{"path":"color.text.linkHover","description":"Link hover"},{"path":"color.text.linkOnContainer","description":"Links on raised (linen) surfaces — text.link is only 4.4:1 on linen"},{"path":"color.text.brand","description":""},{"path":"color.text.onBrand","description":"Light text on dark brand bg"},{"path":"color.text.onAccent","description":"Light text on dark accent bg"},{"path":"color.text.onSuccess","description":"Text on filled color.feedback.success"},{"path":"color.text.onError","description":"Text on filled color.feedback.error"},{"path":"color.text.onWarning","description":"Text on filled color.feedback.warning"},{"path":"color.text.onInfo","description":"Text on filled color.feedback.info"},{"path":"color.data.categorical.1","description":""},{"path":"color.data.categorical.2","description":""},{"path":"color.data.categorical.3","description":""},{"path":"color.data.categorical.4","description":""},{"path":"color.data.categorical.5","description":""},{"path":"color.data.muted","description":"De-emphasised data: everything but the series a chart highlights (which uses categorical.1)"},{"path":"color.data.grid","description":"Gridlines: recessive"},{"path":"color.data.axis","description":"Axis and baseline lines"},{"path":"typography.heading.fontFamily","description":""},{"path":"typography.heading.h1.fontSize","description":""},{"path":"typography.heading.h1.fontWeight","description":""},{"path":"typography.heading.h1.lineHeight","description":""},{"path":"typography.heading.h1.letterSpacing","description":""},{"path":"typography.heading.h2.fontSize","description":""},{"path":"typography.heading.h2.fontWeight","description":""},{"path":"typography.heading.h2.lineHeight","description":""},{"path":"typography.heading.h2.letterSpacing","description":""},{"path":"typography.heading.h3.fontSize","description":""},{"path":"typography.heading.h3.fontWeight","description":""},{"path":"typography.heading.h3.lineHeight","description":""},{"path":"typography.heading.h3.letterSpacing","description":""},{"path":"typography.heading.h4.fontSize","description":""},{"path":"typography.heading.h4.fontWeight","description":""},{"path":"typography.heading.h4.lineHeight","description":""},{"path":"typography.heading.h4.letterSpacing","description":""},{"path":"typography.heading.h5.fontSize","description":""},{"path":"typography.heading.h5.fontWeight","description":""},{"path":"typography.heading.h5.lineHeight","description":""},{"path":"typography.heading.h6.fontSize","description":""},{"path":"typography.heading.h6.fontWeight","description":""},{"path":"typography.heading.h6.lineHeight","description":""},{"path":"typography.body.fontFamily","description":""},{"path":"typography.body.xl.fontSize","description":""},{"path":"typography.body.xl.fontWeight","description":""},{"path":"typography.body.xl.lineHeight","description":""},{"path":"typography.body.lg.fontSize","description":""},{"path":"typography.body.lg.fontWeight","description":""},{"path":"typography.body.lg.lineHeight","description":""},{"path":"typography.body.base.fontSize","description":""},{"path":"typography.body.base.fontWeight","description":""},{"path":"typography.body.base.lineHeight","description":""},{"path":"typography.body.sm.fontSize","description":""},{"path":"typography.body.sm.fontWeight","description":""},{"path":"typography.body.sm.lineHeight","description":""},{"path":"typography.body.sm.letterSpacing","description":""},{"path":"typography.body.xs.fontSize","description":""},{"path":"typography.body.xs.fontWeight","description":""},{"path":"typography.body.xs.lineHeight","description":""},{"path":"typography.body.xs.letterSpacing","description":""},{"path":"typography.label.fontFamily","description":""},{"path":"typography.label.base.fontSize","description":""},{"path":"typography.label.base.fontWeight","description":""},{"path":"typography.label.base.lineHeight","description":"1.5 for WCAG 1.4.12"},{"path":"typography.label.base.letterSpacing","description":""},{"path":"typography.label.sm.fontSize","description":""},{"path":"typography.label.sm.fontWeight","description":""},{"path":"typography.label.sm.lineHeight","description":"1.5 for WCAG 1.4.12"},{"path":"typography.label.sm.letterSpacing","description":""},{"path":"typography.eyebrow.fontFamily","description":""},{"path":"typography.eyebrow.fontSize","description":""},{"path":"typography.eyebrow.fontWeight","description":""},{"path":"typography.eyebrow.letterSpacing","description":""},{"path":"typography.control.fontFamily","description":""},{"path":"typography.control.fontWeight","description":""},{"path":"typography.control.letterSpacing","description":""},{"path":"typography.control.sm.fontSize","description":"Small buttons, field labels"},{"path":"typography.control.md.fontSize","description":"Default: input text, choices, buttons"},{"path":"typography.control.lg.fontSize","description":"Large buttons"},{"path":"typography.control.fontSize.sm","description":"Deprecated, don't use: Renamed in 4.2 to typography.control.sm.fontSize; removed in 5.0"},{"path":"typography.control.fontSize.md","description":"Deprecated, don't use: Renamed in 4.2 to typography.control.md.fontSize; removed in 5.0"},{"path":"typography.control.fontSize.lg","description":"Deprecated, don't use: Renamed in 4.2 to typography.control.lg.fontSize; removed in 5.0"},{"path":"typography.emphasis.fontWeight","description":""},{"path":"typography.code.fontFamily","description":""},{"path":"typography.code.fontSize","description":""},{"path":"typography.code.lineHeight","description":""},{"path":"spacing.layout.page","description":""},{"path":"spacing.layout.section","description":""},{"path":"spacing.layout.stack","description":""},{"path":"spacing.layout.inline","description":""},{"path":"layout.container.sm","description":""},{"path":"layout.container.md","description":""},{"path":"layout.container.lg","description":""},{"path":"layout.container.xl","description":""},{"path":"shape.control","description":"Buttons, inputs, selects, tabs"},{"path":"shape.container","description":"Alerts, modals, dropdowns, accordion items, panels"},{"path":"shape.large","description":"Cards"},{"path":"shape.compact","description":"Small controls and tags: close buttons, checkboxes, badges, code blocks"},{"path":"shape.tight","description":"Focus outlines on text links, inline code"},{"path":"shape.pill","description":"Pills, radios, toggles, progress bars"},{"path":"elevation.soft","description":"Cards, raised elements"},{"path":"elevation.medium","description":"Dropdowns, popovers"},{"path":"elevation.strong","description":"Modals, dialogs"},{"path":"elevation.inset","description":"Inputs, wells"},{"path":"elevation.surface.subtle","description":""},{"path":"elevation.surface.default","description":""},{"path":"elevation.surface.hover","description":"Hovered"},{"path":"elevation.surface.active","description":""},{"path":"elevation.surface.focus","description":"Sits under the focus glow"},{"path":"elevation.surface.featured","description":""},{"path":"elevation.surface.featuredHover","description":""},{"path":"elevation.surface.featuredFocus","description":""},{"path":"elevation.offset.xs","description":""},{"path":"elevation.offset.sm","description":""},{"path":"elevation.offset.md","description":""},{"path":"elevation.offset.lg","description":""},{"path":"elevation.offset.xl","description":""},{"path":"elevation.offset.2xl","description":""},{"path":"elevation.color.primary","description":"Primary buttons"},{"path":"elevation.color.secondary","description":"Secondary/form elements"},{"path":"elevation.color.error","description":"Error state"},{"path":"elevation.color.neutral","description":"Containers and the skip link"},{"path":"elevation.color.neutralHover","description":"Lifted containers"},{"path":"elevation.color.overlay","description":"Dialogs"},{"path":"elevation.color.field","description":"The inset shadow inside text fields"},{"path":"elevation.color.hoverTint","description":"The ring shadow of an icon-only button on hover, with color.surface.hoverTint"},{"path":"elevation.color.inset","description":"The inner shadow of a track (such as a progress bar's), neutral so it works on every track colour"},{"path":"lift.hoverSm","description":""},{"path":"lift.hoverMd","description":""},{"path":"lift.activeSm","description":""},{"path":"lift.activeMd","description":""},{"path":"stroke.control","description":"Controls and framed containers: buttons, fields, checkboxes, alerts, dialogs"},{"path":"stroke.surface","description":"Card edges"},{"path":"stroke.divider","description":"Lines between sections"},{"path":"stroke.data","description":"Lines that carry data: a line chart's lines, and the gap between donut slices"},{"path":"decoration.underlineThickness","description":""},{"path":"decoration.underlineFocusThickness","description":"The solid underline that shows keyboard focus on inline links"},{"path":"decoration.underlineDash","description":""},{"path":"decoration.underlinePeriod","description":""},{"path":"motion.quick","description":""},{"path":"motion.snappy","description":""},{"path":"motion.gentle","description":""},{"path":"motion.relaxed","description":""},{"path":"motion.slow","description":""},{"path":"motion.easeGentle","description":""},{"path":"motion.easeOut","description":""},{"path":"motion.easeEmphasized","description":""},{"path":"focus.ringWidth","description":""},{"path":"focus.ringOffset","description":""},{"path":"focus.ringColor","description":"The focus colour: outlines, focused control borders. Must stay opaque (4.7:1 on cream, WCAG 1.4.11)"},{"path":"focus.decorationColor","description":"Decorative glow only — never the sole focus indicator"},{"path":"spacing.0","description":""},{"path":"spacing.1","description":""},{"path":"spacing.2","description":""},{"path":"spacing.3","description":""},{"path":"spacing.4","description":""},{"path":"spacing.5","description":""},{"path":"spacing.6","description":""},{"path":"spacing.7","description":""},{"path":"spacing.8","description":""},{"path":"spacing.10","description":""},{"path":"spacing.12","description":""},{"path":"spacing.16","description":""},{"path":"spacing.20","description":""},{"path":"spacing.px","description":""},{"path":"spacing.0-5","description":""},{"path":"spacing.1-5","description":""},{"path":"spacing.2-5","description":""},{"path":"spacing.3-5","description":""}],"values":{"hoodlum":{"color.brand.primary":"#1f1f1f","color.brand.primaryHover":"#454545","color.brand.primaryActive":"#0d0d0d","color.brand.primarySubtle":"#ededed","color.brand.highlight":"#292929","color.brand.accent":"#1f5cb3","color.brand.accentHover":"#184a91","color.brand.accentActive":"#184a91","color.brand.accentSubtle":"#edf3fc","color.brand.accentShadow":"#b3cdf2","color.accent.default":"#1f5cb3","color.accent.hover":"#184a91","color.accent.active":"#184a91","color.accent.subtle":"#edf3fc","color.accent.shadow":"#b3cdf2","color.feedback.success":"#1d7238","color.feedback.successSubtle":"#ebf6ee","color.feedback.error":"#b02525","color.feedback.errorHover":"#8c1d1d","color.feedback.errorSubtle":"#fceeee","color.feedback.warning":"#835600","color.feedback.warningSubtle":"#fcf4e3","color.feedback.info":"#1f5cb3","color.feedback.infoSubtle":"#edf3fc","color.surface.base":"#ffffff","color.surface.container":"#f7f7f7","color.surface.featured":"#ffffff","color.surface.inset":"#ededed","color.surface.field":"#f7f7f7","color.surface.highlight":"#ffffff","color.surface.overlay":"#00000066","color.surface.disabled":"#ededed","color.surface.hover":"#f7f7f7","color.surface.active":"#dedede","color.surface.featuredStart":"#ffffff","color.surface.featuredMid":"#f7f7f7","color.surface.featuredEnd":"#ededed","color.surface.headerTint":"#ffffff00","color.surface.backdrop":"#00000080","color.surface.hoverTint":"#00000014","color.surface.headerTintFade":"#ffffff00","color.surface.onBrandTrack":"#ffffff26","color.surface.onBrandFocus":"#0000001a","color.border.default":"#dedede","color.border.subtle":"#ededed","color.border.emphasis":"#6b6b6b","color.border.strong":"#c4c4c4","color.border.hover":"#1f1f1f","color.border.disabled":"#ededed","color.border.brand":"#1f1f1f40","color.border.brandHover":"#1f1f1f73","color.border.divider":"#dedede","color.border.onBrandTrack":"#ffffff4d","color.text.primary":"#1f1f1f","color.text.secondary":"#6b6b6b","color.text.disabled":"#a8a8a8","color.text.inverse":"#ffffff","color.text.link":"#1f1f1f","color.text.linkHover":"#575757","color.text.linkOnContainer":"#1f1f1f","color.text.brand":"#1f1f1f","color.text.onBrand":"#ffffff","color.text.onAccent":"#ffffff","color.text.onSuccess":"#ffffff","color.text.onError":"#ffffff","color.text.onWarning":"#ffffff","color.text.onInfo":"#ffffff","color.data.categorical.1":"#1f1f1f","color.data.categorical.2":"#ef6505","color.data.categorical.3":"#209993","color.data.categorical.4":"#771fa5","color.data.categorical.5":"#656d0f","color.data.muted":"#6b6b6b","color.data.grid":"#dedede","color.data.axis":"#6b6b6b","typography.heading.fontFamily":"'Plus Jakarta Sans', Arial, Helvetica, sans-serif","typography.heading.h1.fontSize":"3.5rem","typography.heading.h1.fontWeight":"800","typography.heading.h1.lineHeight":1.1429,"typography.heading.h1.letterSpacing":"-0.02em","typography.heading.h2.fontSize":"2.5rem","typography.heading.h2.fontWeight":"800","typography.heading.h2.lineHeight":1.2,"typography.heading.h2.letterSpacing":"-0.01em","typography.heading.h3.fontSize":"2rem","typography.heading.h3.fontWeight":"700","typography.heading.h3.lineHeight":1.25,"typography.heading.h3.letterSpacing":"-0.01em","typography.heading.h4.fontSize":"1.5rem","typography.heading.h4.fontWeight":"700","typography.heading.h4.lineHeight":1.3333,"typography.heading.h4.letterSpacing":"0","typography.heading.h5.fontSize":"1.25rem","typography.heading.h5.fontWeight":"700","typography.heading.h5.lineHeight":1.6,"typography.heading.h6.fontSize":"1rem","typography.heading.h6.fontWeight":"700","typography.heading.h6.lineHeight":1.5,"typography.body.fontFamily":"'Plus Jakarta Sans', Arial, Helvetica, sans-serif","typography.body.xl.fontSize":"1.5rem","typography.body.xl.fontWeight":"400","typography.body.xl.lineHeight":1.6667,"typography.body.lg.fontSize":"1.25rem","typography.body.lg.fontWeight":"400","typography.body.lg.lineHeight":1.6,"typography.body.base.fontSize":"1rem","typography.body.base.fontWeight":"400","typography.body.base.lineHeight":1.5,"typography.body.sm.fontSize":"0.75rem","typography.body.sm.fontWeight":"400","typography.body.sm.lineHeight":1.6667,"typography.body.sm.letterSpacing":"0","typography.body.xs.fontSize":"0.75rem","typography.body.xs.fontWeight":"400","typography.body.xs.lineHeight":1.6667,"typography.body.xs.letterSpacing":"0.02em","typography.label.fontFamily":"'Plus Jakarta Sans', Arial, Helvetica, sans-serif","typography.label.base.fontSize":"1rem","typography.label.base.fontWeight":"600","typography.label.base.lineHeight":1.5,"typography.label.base.letterSpacing":"0.02em","typography.label.sm.fontSize":"0.75rem","typography.label.sm.fontWeight":"600","typography.label.sm.lineHeight":1.6667,"typography.label.sm.letterSpacing":"0.08em","typography.eyebrow.fontFamily":"'Plus Jakarta Sans', Arial, Helvetica, sans-serif","typography.eyebrow.fontSize":"0.75rem","typography.eyebrow.fontWeight":"600","typography.eyebrow.letterSpacing":"0.08em","typography.control.fontFamily":"'Plus Jakarta Sans', Arial, Helvetica, sans-serif","typography.control.fontWeight":"600","typography.control.letterSpacing":"0.02em","typography.control.sm.fontSize":"1rem","typography.control.md.fontSize":"1rem","typography.control.lg.fontSize":"1.25rem","typography.control.fontSize.sm":"1rem","typography.control.fontSize.md":"1rem","typography.control.fontSize.lg":"1.25rem","typography.emphasis.fontWeight":"700","typography.code.fontFamily":"ui-monospace, SFMono-Regular, Menlo, Consolas, monospace","typography.code.fontSize":"1rem","typography.code.lineHeight":1.5,"spacing.layout.page":"1.5rem","spacing.layout.section":"3rem","spacing.layout.stack":"1.25rem","spacing.layout.inline":"1rem","layout.container.sm":"640px","layout.container.md":"768px","layout.container.lg":"1024px","layout.container.xl":"1280px","shape.control":"4px","shape.container":"4px","shape.large":"6px","shape.compact":"2px","shape.tight":"2px","shape.pill":"9999px","elevation.soft":"none","elevation.medium":"none","elevation.strong":"0 12px 32px rgba(0, 0, 0, 0.35)","elevation.inset":"none","elevation.surface.subtle":"none","elevation.surface.default":"none","elevation.surface.hover":"none","elevation.surface.active":"none","elevation.surface.focus":"none","elevation.surface.featured":"none","elevation.surface.featuredHover":"none","elevation.surface.featuredFocus":"none","elevation.offset.xs":"0px","elevation.offset.sm":"0px","elevation.offset.md":"0px","elevation.offset.lg":"0px","elevation.offset.xl":"0px","elevation.offset.2xl":"0px","elevation.color.primary":"#c4c4c4","elevation.color.secondary":"#dedede","elevation.color.error":"#f59a9a","elevation.color.neutral":"#c4c4c4","elevation.color.neutralHover":"#a8a8a8","elevation.color.overlay":"#a8a8a8","elevation.color.field":"#c4c4c4","elevation.color.hoverTint":"#00000026","elevation.color.inset":"#0000000f","lift.hoverSm":"0px","lift.hoverMd":"0px","lift.activeSm":"0px","lift.activeMd":"0px","stroke.control":"1px","stroke.surface":"1px","stroke.divider":"1px","stroke.data":"2px","decoration.underlineThickness":"1px","decoration.underlineFocusThickness":"2px","decoration.underlineDash":"4px","decoration.underlinePeriod":"8px","motion.quick":"100ms","motion.snappy":"150ms","motion.gentle":"200ms","motion.relaxed":"250ms","motion.slow":"350ms","motion.easeGentle":[0.4,0,0.2,1],"motion.easeOut":[0,0,0.2,1],"motion.easeEmphasized":[0,0,0.2,1],"focus.ringWidth":"2px","focus.ringOffset":"2px","focus.ringColor":"#1f1f1f","focus.decorationColor":"#00000000","spacing.0":"0","spacing.1":"0.25rem","spacing.2":"0.5rem","spacing.3":"0.75rem","spacing.4":"1rem","spacing.5":"1.25rem","spacing.6":"1.5rem","spacing.7":"1.75rem","spacing.8":"2rem","spacing.10":"2.5rem","spacing.12":"3rem","spacing.16":"4rem","spacing.20":"5rem","spacing.px":"1px","spacing.0-5":"0.125rem","spacing.1-5":"0.375rem","spacing.2-5":"0.625rem","spacing.3-5":"0.875rem"},"orange-halo":{"color.brand.primary":"#c54300","color.brand.primaryHover":"#9e3500","color.brand.primaryActive":"#9e3500","color.brand.primarySubtle":"#fff3e0","color.brand.highlight":"#e8a838","color.brand.accent":"#3d5a80","color.brand.accentHover":"#354f70","color.brand.accentActive":"#2e4460","color.brand.accentSubtle":"#eef4f9","color.brand.accentShadow":"#a0b4c8","color.accent.default":"#3d5a80","color.accent.hover":"#354f70","color.accent.active":"#2e4460","color.accent.subtle":"#eef4f9","color.accent.shadow":"#a0b4c8","color.feedback.success":"#3d7340","color.feedback.successSubtle":"#f0f7f1","color.feedback.error":"#b54540","color.feedback.errorHover":"#943836","color.feedback.errorSubtle":"#fdf4f3","color.feedback.warning":"#8c5e1c","color.feedback.warningSubtle":"#fefaee","color.feedback.info":"#3d5a80","color.feedback.infoSubtle":"#eef4f9","color.surface.base":"#faf7f2","color.surface.container":"#f5f0e8","color.surface.featured":"#faf7f2","color.surface.inset":"#ede8df","color.surface.field":"#faf7f2","color.surface.highlight":"#ffffff","color.surface.overlay":"#3d322966","color.surface.disabled":"#e2dcd2","color.surface.hover":"#fff4e6","color.surface.active":"#f0ebe3","color.surface.featuredStart":"#fffbf5","color.surface.featuredMid":"#fdf6ee","color.surface.featuredEnd":"#f8efe4","color.surface.headerTint":"#ffffff80","color.surface.backdrop":"#3d322999","color.surface.hoverTint":"#00000014","color.surface.headerTintFade":"#ffffff00","color.surface.onBrandTrack":"#ffffff26","color.surface.onBrandFocus":"#0000001a","color.border.default":"#e2dcd2","color.border.subtle":"#ede8df","color.border.emphasis":"#6b5d4d","color.border.strong":"#c9c1b4","color.border.hover":"#8b4726","color.border.disabled":"#ede8df","color.border.brand":"#c5430040","color.border.brandHover":"#c5430059","color.border.divider":"#e2d5c899","color.border.onBrandTrack":"#ffffff4d","color.text.primary":"#3d3229","color.text.secondary":"#6b5d4d","color.text.disabled":"#c9c1b4","color.text.inverse":"#faf7f2","color.text.link":"#c54300","color.text.linkHover":"#9e3500","color.text.linkOnContainer":"#9e3500","color.text.brand":"#c54300","color.text.onBrand":"#ffffff","color.text.onAccent":"#ffffff","color.text.onSuccess":"#ffffff","color.text.onError":"#ffffff","color.text.onWarning":"#ffffff","color.text.onInfo":"#ffffff","color.data.categorical.1":"#c54300","color.data.categorical.2":"#0e5794","color.data.categorical.3":"#9c0451","color.data.categorical.4":"#8d6300","color.data.categorical.5":"#1d9999","color.data.muted":"#8a7a68","color.data.grid":"#e2d5c899","color.data.axis":"#6b5d4d","typography.heading.fontFamily":"'Bricolage Grotesque', 'General Sans', sans-serif","typography.heading.h1.fontSize":"2.5rem","typography.heading.h1.fontWeight":"700","typography.heading.h1.lineHeight":1.2,"typography.heading.h1.letterSpacing":"-0.02em","typography.heading.h2.fontSize":"2rem","typography.heading.h2.fontWeight":"700","typography.heading.h2.lineHeight":1.25,"typography.heading.h2.letterSpacing":"-0.01em","typography.heading.h3.fontSize":"1.75rem","typography.heading.h3.fontWeight":"600","typography.heading.h3.lineHeight":1.4286,"typography.heading.h3.letterSpacing":"-0.01em","typography.heading.h4.fontSize":"1.5rem","typography.heading.h4.fontWeight":"600","typography.heading.h4.lineHeight":1.3333,"typography.heading.h4.letterSpacing":"0","typography.heading.h5.fontSize":"1.25rem","typography.heading.h5.fontWeight":"500","typography.heading.h5.lineHeight":1.6,"typography.heading.h6.fontSize":"1rem","typography.heading.h6.fontWeight":"500","typography.heading.h6.lineHeight":1.5,"typography.body.fontFamily":"'Bricolage Grotesque', 'General Sans', -apple-system, BlinkMacSystemFont, sans-serif","typography.body.xl.fontSize":"1.5rem","typography.body.xl.fontWeight":"400","typography.body.xl.lineHeight":1.6667,"typography.body.lg.fontSize":"1.25rem","typography.body.lg.fontWeight":"400","typography.body.lg.lineHeight":1.6,"typography.body.base.fontSize":"1rem","typography.body.base.fontWeight":"400","typography.body.base.lineHeight":1.5,"typography.body.sm.fontSize":"0.75rem","typography.body.sm.fontWeight":"400","typography.body.sm.lineHeight":1.6667,"typography.body.sm.letterSpacing":"0.01em","typography.body.xs.fontSize":"0.75rem","typography.body.xs.fontWeight":"400","typography.body.xs.lineHeight":1.6667,"typography.body.xs.letterSpacing":"0.01em","typography.label.fontFamily":"'Bricolage Grotesque', 'General Sans', -apple-system, BlinkMacSystemFont, sans-serif","typography.label.base.fontSize":"1rem","typography.label.base.fontWeight":"500","typography.label.base.lineHeight":1.5,"typography.label.base.letterSpacing":"0.01em","typography.label.sm.fontSize":"0.75rem","typography.label.sm.fontWeight":"500","typography.label.sm.lineHeight":1.6667,"typography.label.sm.letterSpacing":"0.01em","typography.eyebrow.fontFamily":"'Bricolage Grotesque', 'General Sans', -apple-system, BlinkMacSystemFont, sans-serif","typography.eyebrow.fontSize":"1rem","typography.eyebrow.fontWeight":"500","typography.eyebrow.letterSpacing":"0.05em","typography.control.fontFamily":"'Bricolage Grotesque', 'General Sans', -apple-system, BlinkMacSystemFont, sans-serif","typography.control.fontWeight":"600","typography.control.letterSpacing":"0.01em","typography.control.sm.fontSize":"1rem","typography.control.md.fontSize":"1.25rem","typography.control.lg.fontSize":"1.5rem","typography.control.fontSize.sm":"1rem","typography.control.fontSize.md":"1.25rem","typography.control.fontSize.lg":"1.5rem","typography.emphasis.fontWeight":"600","typography.code.fontFamily":"'JetBrains Mono', 'Fira Code', ui-monospace, monospace","typography.code.fontSize":"1rem","typography.code.lineHeight":1.5,"spacing.layout.page":"1.5rem","spacing.layout.section":"3rem","spacing.layout.stack":"1.25rem","spacing.layout.inline":"1rem","layout.container.sm":"640px","layout.container.md":"768px","layout.container.lg":"1024px","layout.container.xl":"1280px","shape.control":"10px","shape.container":"10px","shape.large":"14px","shape.compact":"6px","shape.tight":"4px","shape.pill":"9999px","elevation.soft":"0 2px 8px rgba(61, 50, 41, 0.06), 0 1px 3px rgba(61, 50, 41, 0.08)","elevation.medium":"0 4px 16px rgba(61, 50, 41, 0.08), 0 2px 6px rgba(61, 50, 41, 0.06)","elevation.strong":"0 8px 24px rgba(61, 50, 41, 0.10), 0 4px 8px rgba(61, 50, 41, 0.06)","elevation.inset":"inset 0 1px 3px rgba(61, 50, 41, 0.08)","elevation.surface.subtle":"0 1px 2px rgba(61, 50, 41, 0.04), inset 0 1px 0 rgba(255, 255, 255, 0.6)","elevation.surface.default":"0 2px 6px rgba(61, 50, 41, 0.08), 0 6px 16px rgba(61, 50, 41, 0.05), inset 0 1px 0 rgba(255, 255, 255, 0.8)","elevation.surface.hover":"0 4px 12px rgba(61, 50, 41, 0.1), 0 12px 28px rgba(61, 50, 41, 0.08), inset 0 1px 0 rgba(255, 255, 255, 0.9)","elevation.surface.active":"0 1px 3px rgba(61, 50, 41, 0.1), 0 3px 8px rgba(61, 50, 41, 0.06), inset 0 1px 2px rgba(61, 50, 41, 0.04)","elevation.surface.focus":"0 2px 6px rgba(61, 50, 41, 0.08), inset 0 1px 0 rgba(255, 255, 255, 0.8)","elevation.surface.featured":"0 2px 8px rgba(139, 69, 19, 0.08), 0 8px 24px rgba(139, 69, 19, 0.06), 0 0 20px rgba(197, 67, 0, 0.04), inset 0 1px 0 rgba(255, 255, 255, 0.9)","elevation.surface.featuredHover":"0 4px 12px rgba(139, 69, 19, 0.12), 0 12px 32px rgba(139, 69, 19, 0.08), 0 0 28px rgba(197, 67, 0, 0.06), inset 0 1px 0 rgba(255, 255, 255, 1)","elevation.surface.featuredFocus":"0 2px 8px rgba(139, 69, 19, 0.08), inset 0 1px 0 rgba(255, 255, 255, 0.9)","elevation.offset.xs":"1px","elevation.offset.sm":"2px","elevation.offset.md":"3px","elevation.offset.lg":"4px","elevation.offset.xl":"5px","elevation.offset.2xl":"6px","elevation.color.primary":"#e8c4a0","elevation.color.secondary":"#d4c4b0","elevation.color.error":"#b545404d","elevation.color.neutral":"#6b5d4d26","elevation.color.neutralHover":"#6b5d4d33","elevation.color.overlay":"#6b5d4d40","elevation.color.field":"#3d322926","elevation.color.hoverTint":"#00000026","elevation.color.inset":"#0000000f","lift.hoverSm":"-1px","lift.hoverMd":"-2px","lift.activeSm":"1px","lift.activeMd":"2px","stroke.control":"2.5px","stroke.surface":"1px","stroke.divider":"1px","stroke.data":"2px","decoration.underlineThickness":"2px","decoration.underlineFocusThickness":"3px","decoration.underlineDash":"4px","decoration.underlinePeriod":"8px","motion.quick":"100ms","motion.snappy":"150ms","motion.gentle":"200ms","motion.relaxed":"300ms","motion.slow":"400ms","motion.easeGentle":[0.4,0,0.2,1],"motion.easeOut":[0,0,0.2,1],"motion.easeEmphasized":[0.34,1.3,0.64,1],"focus.ringWidth":"3px","focus.ringOffset":"2px","focus.ringColor":"#c54300","focus.decorationColor":"#c5430026","spacing.0":"0","spacing.1":"0.25rem","spacing.2":"0.5rem","spacing.3":"0.75rem","spacing.4":"1rem","spacing.5":"1.25rem","spacing.6":"1.5rem","spacing.7":"1.75rem","spacing.8":"2rem","spacing.10":"2.5rem","spacing.12":"3rem","spacing.16":"4rem","spacing.20":"5rem","spacing.px":"1px","spacing.0-5":"0.125rem","spacing.1-5":"0.375rem","spacing.2-5":"0.625rem","spacing.3-5":"0.875rem"}},"tier3":[{"path":"button.base.fontFamily","role":"typography.control.fontFamily","description":""},{"path":"button.base.fontWeight","role":"typography.control.fontWeight","description":""},{"path":"button.base.letterSpacing","role":"typography.control.letterSpacing","description":""},{"path":"button.base.borderRadius","role":"shape.control","description":""},{"path":"button.base.borderWidth","role":"stroke.control","description":""},{"path":"button.size.sm.fontSize","role":"typography.control.sm.fontSize","description":""},{"path":"button.size.sm.paddingX","role":"spacing.4","description":""},{"path":"button.size.sm.paddingY","role":"spacing.2","description":""},{"path":"button.size.sm.minHeight","role":"40px","description":""},{"path":"button.size.sm.gap","role":"spacing.2","description":""},{"path":"button.size.md.fontSize","role":"typography.control.md.fontSize","description":""},{"path":"button.size.md.paddingX","role":"spacing.6","description":""},{"path":"button.size.md.paddingY","role":"spacing.3","description":""},{"path":"button.size.md.minHeight","role":"48px","description":""},{"path":"button.size.md.gap","role":"spacing.2","description":""},{"path":"button.size.lg.fontSize","role":"typography.control.lg.fontSize","description":""},{"path":"button.size.lg.paddingX","role":"spacing.8","description":""},{"path":"button.size.lg.paddingY","role":"spacing.4","description":""},{"path":"button.size.lg.minHeight","role":"56px","description":""},{"path":"button.size.lg.gap","role":"spacing.2-5","description":""},{"path":"button.variant.primary.background","role":"color.brand.primary","description":""},{"path":"button.variant.primary.backgroundHover","role":"color.brand.primaryHover","description":""},{"path":"button.variant.primary.backgroundActive","role":"color.brand.primaryActive","description":""},{"path":"button.variant.primary.color","role":"color.text.onBrand","description":""},{"path":"button.variant.primary.borderColor","role":"color.brand.primary","description":""},{"path":"button.variant.primary.shadowColor","role":"elevation.color.primary","description":""},{"path":"button.variant.secondary.background","role":"color.surface.base","description":""},{"path":"button.variant.secondary.backgroundHover","role":"color.surface.hover","description":""},{"path":"button.variant.secondary.backgroundActive","role":"color.surface.active","description":""},{"path":"button.variant.secondary.color","role":"color.text.primary","description":""},{"path":"button.variant.secondary.borderColor","role":"color.border.emphasis","description":""},{"path":"button.variant.secondary.shadowColor","role":"elevation.color.secondary","description":""},{"path":"button.variant.accent.background","role":"color.brand.accent","description":""},{"path":"button.variant.accent.backgroundHover","role":"color.brand.accentHover","description":""},{"path":"button.variant.accent.backgroundActive","role":"color.brand.accentActive","description":""},{"path":"button.variant.accent.color","role":"color.text.onAccent","description":""},{"path":"button.variant.accent.borderColor","role":"color.brand.accent","description":""},{"path":"button.variant.accent.shadowColor","role":"color.brand.accentShadow","description":""},{"path":"input.base.borderWidth","role":"stroke.control","description":""},{"path":"input.size.md.minHeight","role":"48px","description":""},{"path":"card.base.borderWidth","role":"stroke.surface","description":""},{"path":"card.base.dividerColor","role":"color.border.divider","description":""},{"path":"card.base.headerBackgroundStart","role":"color.surface.headerTint","description":""},{"path":"card.base.headerBackgroundEnd","role":"color.surface.headerTintFade","description":""},{"path":"card.variant.default.gradientStart","role":"color.surface.highlight","description":""},{"path":"card.variant.default.gradientMid","role":"color.surface.base","description":""},{"path":"card.variant.default.gradientEnd","role":"color.surface.container","description":""},{"path":"card.variant.default.borderColor","role":"color.border.default","description":""},{"path":"card.variant.featured.gradientStart","role":"color.surface.featuredStart","description":""},{"path":"card.variant.featured.gradientMid","role":"color.surface.featuredMid","description":""},{"path":"card.variant.featured.gradientEnd","role":"color.surface.featuredEnd","description":""},{"path":"card.variant.featured.borderColor","role":"color.border.brand","description":""},{"path":"card.variant.subtle.gradientStart","role":"color.surface.base","description":""},{"path":"card.variant.subtle.gradientEnd","role":"color.surface.container","description":""},{"path":"card.variant.subtle.borderColor","role":"color.border.default","description":""},{"path":"progress.base.trackInsetShadow","role":"elevation.color.inset","description":"Neutral, so it works on every track colour"},{"path":"progress.variant.inverse.trackBackground","role":"color.surface.onBrandTrack","description":""},{"path":"progress.variant.inverse.trackBorder","role":"color.border.onBrandTrack","description":""},{"path":"progress.variant.inverse.fill","role":"color.text.inverse","description":""},{"path":"badge.size.lg.minHeight","role":"button.size.sm.minHeight","description":"A badge in a row of small buttons (size=\"lg\"): as tall as a small button, so they line up. It follows the button, so a brand that changes one changes both"},{"path":"link.variant.inverse.focusBackground","role":"color.surface.onBrandFocus","description":"Focus tint — paired with the underline, which is the indicator"},{"path":"modal.size.sm.width","role":"400px","description":"A small dialog's width (size=\"sm\"): a short confirmation"},{"path":"modal.size.md.width","role":"560px","description":"The default dialog width: a short message or a small form"},{"path":"modal.size.lg.width","role":"720px","description":"A large dialog's width (size=\"lg\"): a longer form"},{"path":"modal.size.xl.width","role":"layout.container.lg","description":"An extra-large dialog's width (size=\"xl\"): an image beside its details. A dialog is never wider than the viewport"},{"path":"modal.base.backdrop","role":"color.surface.backdrop","description":""},{"path":"closeButton.state.hover.background","role":"color.surface.hoverTint","description":"Neutral tint that works on every alert variant"},{"path":"closeButton.state.hover.shadowColor","role":"elevation.color.hoverTint","description":"Offset shadow colour on hover and press. Neutral, like the background, so it works on every alert variant"},{"path":"navbar.base.shadow","role":"0 {elevation.offset.sm} 8px {focus.decorationColor}","description":"The bar's soft shadow, in the focus glow colour; a brand with a transparent glow or no offset has none"},{"path":"navbar.base.logoHeight","role":"40px","description":"Logo height in the bar; a page can override it with --oh-navbar-logo-height"},{"path":"select.base.listMaxHeight","role":"280px","description":"The open list's tallest height; longer lists scroll inside it"},{"path":"select.base.listEnterOffset","role":"spacing.2","description":"How far above its resting place the list starts as it opens and slides down"},{"path":"drawer.base.width","role":"280px","description":"The panel's width; a page can override it with --oh-drawer-width"},{"path":"drawer.base.viewportGap","role":"spacing.12","description":"The least room left beside the panel, so it never covers the whole viewport and the backdrop stays visible to close it"},{"path":"descriptionList.base.columnMinWidth","role":"240px","description":"The narrowest a column gets in the grid layout before items wrap onto fewer columns"},{"path":"descriptionList.size.lg.columnMinWidth","role":"160px","description":"The narrowest a column gets in a grid of large values (figures), which are short, so five or six fit in a row on a wide page"},{"path":"descriptionList.size.lg.valueFontFamily","role":"typography.heading.fontFamily","description":"Large values (figures): the heading family"},{"path":"descriptionList.size.lg.valueFontSize","role":"typography.heading.h2.fontSize","description":"Large values (figures): the h2 size, so a brand can point it elsewhere without touching the component"},{"path":"descriptionList.size.lg.valueFontWeight","role":"typography.heading.h2.fontWeight","description":""},{"path":"descriptionList.size.lg.valueLineHeight","role":"typography.heading.h2.lineHeight","description":"The h2 line height, which keeps the figure on the grid"},{"path":"descriptionList.size.lg.valueLetterSpacing","role":"typography.heading.h2.letterSpacing","description":""},{"path":"descriptionList.size.lg.textFontFamily","role":"typography.heading.fontFamily","description":"A value that's words, not a figure, in a list of large values (data-value=\"text\"): the heading family"},{"path":"descriptionList.size.lg.textFontSize","role":"typography.heading.h4.fontSize","description":"Words in a list of figures: the h4 size, smaller than the figures so a name or title fits its column"},{"path":"descriptionList.size.lg.textFontWeight","role":"typography.heading.h4.fontWeight","description":""},{"path":"descriptionList.size.lg.textLineHeight","role":"typography.heading.h4.lineHeight","description":"The h4 line height, which keeps the text on the grid"},{"path":"chart.base.plotHeight","role":"240px","description":"Height of a column chart's plot area (the bars' full scale)"},{"path":"chart.base.barThickness","role":"spacing.4","description":"Thickness of each bar in a bar chart"},{"path":"chart.base.columnMinWidth","role":"spacing.6","description":"The narrowest a column's slot gets; below it the chart scrolls sideways instead of squeezing"},{"path":"chart.base.columnMaxWidth","role":"spacing.12","description":"The widest a column gets, so a chart with few columns doesn't draw slabs"},{"path":"chart.base.lineWidth","role":"stroke.data","description":"Width of a line chart's lines, and the gap between donut slices"},{"path":"chart.base.markerSize","role":"spacing.3","description":"Size of a line chart's point markers and of the colour keys beside labels"},{"path":"chart.base.donutThickness","role":"spacing.8","description":"Thickness of a donut chart's ring (its diameter is chart.base.plotHeight)"},{"path":"chart.base.dotRowHeight","role":"spacing.8","description":"Height of each row in a dot chart, so a row's dots and its label have room"},{"path":"chart.size.sm.plotHeight","role":"96px","description":"A small chart's plot area (size=\"sm\"): for a chart that sits beside a short list or a few figures, so the two line up"},{"path":"timeline.base.dateWidth","role":"144px","description":"Width of the date column beside each entry: room for a short date or a range of years (\"2019 – 2023\")"},{"path":"spinner.base.cycleDuration","role":"800ms","description":"One turn of the spinning arc. Under reduced motion the arc doesn't turn"},{"path":"tooltip.base.background","role":"color.text.primary","description":"The bubble: the page's text colour, so it stands apart from every surface"},{"path":"tooltip.base.color","role":"color.text.inverse","description":"Text on the bubble (pair checked by check:contrast)"},{"path":"tooltip.base.maxWidth","role":"320px","description":"Widest the bubble gets before its text wraps"},{"path":"tooltip.base.showDelay","role":"400ms","description":"How long the pointer rests on the control before the bubble shows, so passing over doesn't flash it. Keyboard focus shows it at once"},{"path":"tooltip.base.hideDelay","role":"motion.relaxed","description":"How long the bubble stays after the pointer leaves, so the pointer can move onto it (WCAG 1.4.13)"}]}
|