@orange-halo/mcp 0.0.0-stage → 1.0.0

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 CHANGED
@@ -1,3 +1,33 @@
1
- # Temporary Holding Version
1
+ # @orange-halo/mcp
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ An MCP server that answers questions about the [Orange Halo Design System](https://orangehalo.co.uk/ohds/): every component and its API, every tier 2 token with each brand's value, the rules and the recipes. Everything it answers from is bundled in `index.json`, so it needs only Node. It never edits anything.
4
+
5
+ ## Use it
6
+
7
+ Add it to your project's `.mcp.json` (or your assistant's MCP settings):
8
+
9
+ ```json
10
+ {
11
+ "mcpServers": {
12
+ "ohds": {
13
+ "command": "npx",
14
+ "args": ["-y", "@orange-halo/mcp"]
15
+ }
16
+ }
17
+ }
18
+ ```
19
+
20
+ | Tool | Answers |
21
+ | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
22
+ | `list_components` | Every element, its package and what it is |
23
+ | `get_component` | One element's full API: description, attributes with their allowed values, defaults and descriptions, events, slots and parts |
24
+ | `find_tokens` | Tier 2 tokens for a word or a few words, with each brand's value and the CSS custom property. A component word ("card") adds the roles that component reads and the recipes that mention it |
25
+ | `get_rules` | How to load OHDS, the rules that matter when using it, and the recipes for text, headings, layout and forms |
26
+
27
+ Each version bundles OHDS as it was at that release; `get_rules` names the package versions it describes.
28
+
29
+ ## In the OHDS repo
30
+
31
+ `pnpm build` writes `index.json` (`build-index.mjs`, after the components and tokens build), from the manifests, the built tokens, `llms.txt` and `api-values.json`. The repo's `.mcp.json` runs `server.mjs` from the checkout. `pnpm --filter @orange-halo/mcp test` starts the server as an agent would and checks each tool's answer; `--server <path>` tests an installed copy instead.
32
+
33
+ Release it with the other packages: add a changeset for `@orange-halo/mcp` whenever a release changes components, tokens or the rules, so the published index stays current.
package/index.json ADDED
@@ -0,0 +1 @@
1
+ {"versions":{"@orange-halo/brand-orange-halo":"2.0.2","@orange-halo/components":"3.2.1","@orange-halo/tokens":"3.0.0","@orange-halo/utils":"1.1.0"},"brands":[{"id":"hood","name":"Hood"},{"id":"orange-halo","name":"Orange Halo"}],"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.raised`, 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"}]},{"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-dismiss` 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.backgroundHover`, `closeButton.shadowHover`, `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-dismiss` 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-dismiss` 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-dismiss"}],"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"}]},{"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 (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**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"}],"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}],"slots":[{"description":"The badge text.","name":""},{"description":"Optional leading icon.","name":"icon"}],"cssParts":[{"description":"The badge.","name":"badge"}]},{"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.\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` the\nfocus underline and `color.surface.hover` the focus tint;\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"}]},{"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.pressMd` (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"}]},{"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, or a whole-card link to more detail (`interactive`). **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**States (interactive only):** rest, hover, active (pressed) and focus-visible.\n\n**Behaviour:** with `interactive`, the card is focusable (`tabindex=\"0\"`), has `role=\"button\"`, and fires `oh-click` on click, Enter or Space. Hover movement is turned off under `prefers-reduced-motion`.\n\n**Accessibility:** focus shows a solid outline (`focus.ringWidth`, `focus.ringColor`, `focus.ringOffset`). Links inside use `color.text.linkRaised`, which keeps contrast on card surfaces. An interactive card is one button: give it a short heading so its accessible name makes sense, and don't put other buttons or links inside it.\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. Hover uses `color.border.strong` (or `card.variant.featured.borderColorHover`), `elevation.surface.hover`/`featuredHover` and `lift.hoverMd`/`lift.hoverSm`; active uses `elevation.surface.active`; focus sets the border to `color.brand.primary` and adds `focus.glowColor` with `elevation.surface.focus`/`featuredFocus`. Header and footer dividers use `card.section.dividerColor` and `stroke.divider`; the header surface uses `card.section.headerGradientStart`/`End`, the footer `color.surface.raised` to `color.surface.inset`; motion uses `motion.gentle` and `motion.easeGentle`.","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":"interactive","type":{"text":"boolean"},"default":"false","description":"Makes the whole card one button: focusable, `role=\"button\"`, firing `oh-click` on click, Enter or Space. Don't put other links or buttons inside.","fieldName":"interactive"},{"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":"interactive","type":{"text":"boolean"},"default":"false","description":"Makes the whole card one button: focusable, `role=\"button\"`, firing `oh-click` on click, Enter or Space. Don't put other links or buttons inside.","attribute":"interactive","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}],"events":[{"description":"When an `interactive` card is clicked or activated with Enter or Space. `detail.originalEvent` holds the source event.","name":"oh-click"}],"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 (the button when `interactive`).","name":"card"},{"description":"The header wrapper.","name":"header"},{"description":"The content wrapper.","name":"content"},{"description":"The footer wrapper.","name":"footer"}]},{"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.pressSm` (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"}]},{"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.pressSm` (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"}]},{"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.","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":""}]},{"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":""}]},{"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` and `typography.emphasis.fontWeight`. Motion uses `motion.relaxed` and `motion.easeGentle`. `--oh-drawer-width` sets the width.","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":""}]},{"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":""}]},{"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":""}]},{"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 `label`), or a compact link such as a social profile (`href` + `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 `label` the icon is decorative (`aria-hidden=\"true\"`). With `label` it's `role=\"img\"` with that name. As a link, `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":"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":"label"},{"name":"href","type":{"text":"string | undefined"},"description":"Renders the icon as a link to this URL. Set `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":"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.","attribute":"label"},{"kind":"field","name":"href","type":{"text":"string | undefined"},"description":"Renders the icon as a link to this URL. Set `label` too.","attribute":"href"},{"kind":"field","name":"target","type":{"text":"string | undefined"},"description":"The link's target; `_blank` adds `rel=\"noopener noreferrer\"`.","attribute":"target"}]},{"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 — `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.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"}]},{"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.glowColor`\n(`link.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":""}]},{"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.\n\n**Sizes:** `sm`, `md` (default) and `lg` set the dialog's width (never wider than the viewport).\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.overlay` 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`.","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) or `lg`, 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) or `lg`, 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"}]},{"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`focus.glowColor` the shadow, `typography.body.*` the text, `spacing.*` the\npadding and gaps, `stroke.divider` and `color.border.subtle` the dividers\nbetween drawer links. `--oh-navbar-logo-height` sets the logo height.","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"}]},{"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.track.insetShadow`. The fill is `color.brand.primary` or `color.feedback.<variant>`. Text uses `color.text.primary` and `typography.body.*`. Inverse uses `progress.inverse.trackBackground`, `progress.inverse.trackBorder`, `progress.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"}]},{"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.pressSm` (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"}]},{"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.pressSm` (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"}]},{"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 — `stroke.control` in `color.border.emphasis`\n(border), `shape.control` (trigger corners), `shape.container` (list\ncorners), `typography.control.*` (type), `elevation.offset.*` and\n`elevation.color.secondary` (shadow), `lift.hoverMd` / `lift.pressSm` (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).","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"}]},{"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.raised`, `color.text.linkRaised`\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"}]},{"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).","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":""}]},{"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**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"}]},{"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 — `stroke.control` in `color.border.emphasis`\n(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.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"}]},{"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.raised` /\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.pressSm` (movement on hover and\npress), `focus.ringColor` and `focus.glowColor` (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 }"}]},{"tagName":"oh-hero","pkg":"@orange-halo/brand-orange-halo","description":"","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"}]}],"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"]},"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-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-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","info","instagram","linkedin","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"]},"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-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), `hood` (Hood). 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`, `hood`). 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- 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-raised)`, `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.linkRaised` is `--oh-color-text-link-raised`.\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.linkRaised` 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` and `oh-toggle`. `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- 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: `item-N`\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- 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-dismiss and hides the alert.\n - `live`: boolean = false — When true, adds role=\"alert\" for screen reader announcement.\n- Events: `oh-dismiss`\n- Slots: `default`\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- 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- Slots: `default`, `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- 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- 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: `default`, `icon-left`, `icon-right`\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- 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 - `interactive`: boolean = false — Makes the whole card one button: focusable, role=\"button\", firing oh-click on click, Enter or Space.\n - `padding`: \"lg\" | \"md\" | \"none\" | \"sm\" = \"md\" — The content padding, which the header and footer match: none, sm, md (default) or lg.\n- Events: `oh-click`\n- Slots: `default`, `header`, `footer`\n- Parts: `card`, `header`, `content`, `footer`\n\n### <oh-checkbox>\n\nA single checkbox with its label, for turning one option on or off.\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- 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- 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: `default`\n\n### <oh-container>\n\nA centred wrapper that limits content to a maximum width and adds side padding.\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: `default`\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- 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: `default`\n\n### <oh-footer>\n\nA site footer with a logo, copyright line, social links and columns of links.\n\n- Attributes:\n - `copyright`: string — Copyright text\n- Slots: `logo`, `social`, `default`\n\n### <oh-grid>\n\nA CSS grid of equal-width columns, fixed or as many as fit.\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: `default`\n\n### <oh-hero> (from @orange-halo/brand-orange-halo)\n\n(No description.)\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\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- 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\" | \"info\" | \"instagram\" | \"linkedin\" | \"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 - `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- 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- 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: `default`\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- 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\" = \"md\" — The dialog's width: sm, md (default) or lg, never wider than the viewport.\n- Events: `oh-close`\n- Slots: `default`, `footer`\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- Attributes:\n - `drawer-heading`: string = \"Menu\" — Heading shown in the mobile drawer\n- Slots: `logo`, `default`, `mobile`\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- 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- 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- 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- 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- 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- 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: `default`\n\n### <oh-tabs>\n\nA set of tabs that switches between panels of related content in the same place.\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-textarea>\n\nA multi-line text field that submits with a native form.\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.\n- Events: `oh-input`, `oh-change`\n- Parts: `label`, `textarea`, `helper`, `error`\n\n### <oh-toggle>\n\nA switch that turns a setting on or off.\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`, `highlightSubtle`\n- `color.accent`: `default`, `hover`, `active`, `subtle`, `shadow`\n- `color.feedback`: `success`, `successSubtle`, `error`, `errorHover`, `errorSubtle`, `errorShadow`, `warning`, `warningSubtle`, `info`, `infoSubtle`\n- `color.surface`: `base`, `raised`, `featured`, `inset`, `highlight`, `overlay`, `disabled`, `hover`, `activePressed`, `featuredStart`, `featuredMid`, `featuredEnd`, `headerTint`, `backdrop`\n- `color.border`: `default`, `subtle`, `emphasis`, `strong`, `hover`, `disabled`, `brand`, `brandHover`, `divider`\n- `color.text`: `primary`, `secondary`, `disabled`, `inverse`, `link`, `linkHover`, `linkRaised`, `brand`, `onBrand`, `onAccent`, `onSuccess`, `onError`, `onWarning`, `onInfo`\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`, `component.xs`, `component.sm`, `component.md`, `component.lg`, `component.xl`\n- `layout`: `container.sm`, `container.md`, `container.lg`, `container.xl`\n- `shape`: `control`, `container`, `large`, `compact`, `tight`, `pill`\n- `elevation`: `none`, `soft`, `medium`, `strong`, `glow`, `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`, `accent`, `error`, `neutral`, `neutralHover`, `overlay`, `field`\n- `lift`: `hoverSm`, `hoverMd`, `pressSm`, `pressMd`\n- `stroke`: `control`, `surface`, `divider`\n- `decoration`: `underlineThickness`, `underlineFocusThickness`, `underlineDash`, `underlinePeriod`\n- `motion`: `quick`, `snappy`, `gentle`, `relaxed`, `slow`, `easeGentle`, `easeOut`, `easeEmphasized`\n- `focus`: `ringWidth`, `ringOffset`, `ringColor`, `glowColor`\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.brand.highlightSubtle","description":""},{"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.errorShadow","description":"Error shadow color"},{"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.raised","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.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.activePressed","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.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.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.linkRaised","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":"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":"spacing.component.xs","description":""},{"path":"spacing.component.sm","description":""},{"path":"spacing.component.md","description":""},{"path":"spacing.component.lg","description":""},{"path":"spacing.component.xl","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.none","description":""},{"path":"elevation.soft","description":"Cards, raised elements"},{"path":"elevation.medium","description":"Dropdowns, popovers"},{"path":"elevation.strong","description":"Modals, dialogs"},{"path":"elevation.glow","description":"Focus ring"},{"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.accent","description":"Accent buttons"},{"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":"lift.hoverSm","description":""},{"path":"lift.hoverMd","description":""},{"path":"lift.pressSm","description":""},{"path":"lift.pressMd","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":"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.glowColor","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":{"hood":{"color.brand.primary":"#1f1f1f","color.brand.primaryHover":"#454545","color.brand.primaryActive":"#0d0d0d","color.brand.primarySubtle":"#ededed","color.brand.highlight":"#292929","color.brand.highlightSubtle":"#dedede","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.errorShadow":"#f59a9a","color.feedback.warning":"#835600","color.feedback.warningSubtle":"#fcf4e3","color.feedback.info":"#1f5cb3","color.feedback.infoSubtle":"#edf3fc","color.surface.base":"#ffffff","color.surface.raised":"#f7f7f7","color.surface.featured":"#ffffff","color.surface.inset":"#ededed","color.surface.highlight":"#ffffff","color.surface.overlay":"#00000066","color.surface.disabled":"#ededed","color.surface.hover":"#f7f7f7","color.surface.activePressed":"#dedede","color.surface.featuredStart":"#ffffff","color.surface.featuredMid":"#f7f7f7","color.surface.featuredEnd":"#ededed","color.surface.headerTint":"#ffffff00","color.surface.backdrop":"#00000080","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.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.linkRaised":"#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","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","spacing.component.xs":"0.375rem","spacing.component.sm":"0.625rem","spacing.component.md":"0.875rem","spacing.component.lg":"1.25rem","spacing.component.xl":"1.75rem","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.none":"none","elevation.soft":"none","elevation.medium":"none","elevation.strong":"0 12px 32px rgba(0, 0, 0, 0.35)","elevation.glow":"none","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.accent":"#b3cdf2","elevation.color.error":"#f59a9a","elevation.color.neutral":"#c4c4c4","elevation.color.neutralHover":"#a8a8a8","elevation.color.overlay":"#a8a8a8","elevation.color.field":"#c4c4c4","lift.hoverSm":"0px","lift.hoverMd":"0px","lift.pressSm":"0px","lift.pressMd":"0px","stroke.control":"1px","stroke.surface":"1px","stroke.divider":"1px","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.glowColor":"#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.highlightSubtle":"#fdf3d4","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.errorShadow":"#b545404d","color.feedback.warning":"#8c5e1c","color.feedback.warningSubtle":"#fefaee","color.feedback.info":"#3d5a80","color.feedback.infoSubtle":"#eef4f9","color.surface.base":"#faf7f2","color.surface.raised":"#f5f0e8","color.surface.featured":"#faf7f2","color.surface.inset":"#ede8df","color.surface.highlight":"#ffffff","color.surface.overlay":"#3d322966","color.surface.disabled":"#e2dcd2","color.surface.hover":"#fff4e6","color.surface.activePressed":"#f0ebe3","color.surface.featuredStart":"#fffbf5","color.surface.featuredMid":"#fdf6ee","color.surface.featuredEnd":"#f8efe4","color.surface.headerTint":"#ffffff80","color.surface.backdrop":"#3d322999","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.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.linkRaised":"#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","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","spacing.component.xs":"0.375rem","spacing.component.sm":"0.625rem","spacing.component.md":"0.875rem","spacing.component.lg":"1.25rem","spacing.component.xl":"1.75rem","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.none":"none","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.glow":"0 0 0 3px rgba(197, 67, 0, 0.2), 0 0 12px rgba(197, 67, 0, 0.1)","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.accent":"#a0b4c8","elevation.color.error":"#b545404d","elevation.color.neutral":"#6b5d4d26","elevation.color.neutralHover":"#6b5d4d33","elevation.color.overlay":"#6b5d4d40","elevation.color.field":"#3d322926","lift.hoverSm":"-1px","lift.hoverMd":"-2px","lift.pressSm":"1px","lift.pressMd":"2px","stroke.control":"2.5px","stroke.surface":"1px","stroke.divider":"1px","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.glowColor":"#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.base.transitionDuration","role":"motion.snappy","description":""},{"path":"button.base.transitionEasing","role":"motion.easeEmphasized","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.activePressed","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":"button.focus.ringColor","role":"focus.ringColor","description":""},{"path":"button.focus.glowColor","role":"focus.glowColor","description":""},{"path":"input.base.fontFamily","role":"typography.control.fontFamily","description":""},{"path":"input.base.fontSize","role":"typography.control.fontSize.md","description":""},{"path":"input.base.lineHeight","role":"typography.body.base.lineHeight","description":""},{"path":"input.base.borderRadius","role":"shape.control","description":""},{"path":"input.base.borderWidth","role":"stroke.control","description":""},{"path":"input.base.transitionDuration","role":"motion.snappy","description":""},{"path":"input.base.transitionEasing","role":"motion.easeGentle","description":""},{"path":"input.size.md.paddingX","role":"spacing.4","description":""},{"path":"input.size.md.paddingY","role":"spacing.3","description":""},{"path":"input.size.md.minHeight","role":"48px","description":""},{"path":"input.state.default.background","role":"color.surface.base","description":""},{"path":"input.state.default.borderColor","role":"color.border.emphasis","description":"WCAG 3:1 contrast for UI elements"},{"path":"input.state.default.color","role":"color.text.primary","description":""},{"path":"input.state.default.placeholderColor","role":"color.text.secondary","description":"WCAG readable placeholder"},{"path":"input.state.default.shadowColor","role":"elevation.color.secondary","description":""},{"path":"input.state.hover.borderColor","role":"color.border.hover","description":""},{"path":"input.state.focus.background","role":"color.surface.highlight","description":""},{"path":"input.state.focus.borderColor","role":"focus.ringColor","description":""},{"path":"input.state.focus.focusRingColor","role":"focus.ringColor","description":""},{"path":"input.state.error.borderColor","role":"color.feedback.error","description":""},{"path":"input.state.error.background","role":"color.feedback.errorSubtle","description":""},{"path":"input.state.error.shadowColor","role":"elevation.color.error","description":""},{"path":"card.base.background","role":"color.surface.raised","description":""},{"path":"card.base.borderRadius","role":"shape.large","description":""},{"path":"card.base.borderWidth","role":"stroke.surface","description":""},{"path":"card.base.borderColor","role":"color.border.default","description":""},{"path":"card.base.shadow","role":"elevation.soft","description":""},{"path":"card.base.padding","role":"spacing.5","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.raised","description":""},{"path":"card.variant.default.borderColor","role":"color.border.default","description":""},{"path":"card.variant.featured.background","role":"linear-gradient(180deg, {color.surface.featuredStart} 0%, {color.surface.featuredMid} 30%, {color.surface.featuredEnd} 100%)","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.featured.borderColorHover","role":"color.border.brandHover","description":""},{"path":"card.variant.featured.shadow","role":"elevation.medium","description":""},{"path":"card.variant.subtle.gradientStart","role":"color.surface.base","description":""},{"path":"card.variant.subtle.gradientEnd","role":"color.surface.raised","description":""},{"path":"card.variant.subtle.borderColor","role":"color.border.default","description":""},{"path":"card.interactive.transitionDuration","role":"motion.gentle","description":""},{"path":"card.interactive.transitionEasing","role":"motion.easeGentle","description":""},{"path":"card.interactive.backgroundHover","role":"color.surface.base","description":""},{"path":"card.interactive.borderColorHover","role":"color.border.brand","description":""},{"path":"card.interactive.shadowHover","role":"elevation.medium","description":""},{"path":"card.section.dividerColor","role":"color.border.divider","description":""},{"path":"card.section.headerGradientStart","role":"color.surface.headerTint","description":""},{"path":"card.section.headerGradientEnd","role":"rgba(255, 255, 255, 0)","description":""},{"path":"progress.track.insetShadow","role":"rgba(0, 0, 0, 0.06)","description":"Neutral, so it works on every track colour"},{"path":"progress.inverse.trackBackground","role":"rgba(255, 255, 255, 0.15)","description":""},{"path":"progress.inverse.trackBorder","role":"rgba(255, 255, 255, 0.3)","description":""},{"path":"progress.inverse.fill","role":"color.text.inverse","description":""},{"path":"badge.base.fontFamily","role":"typography.label.fontFamily","description":""},{"path":"badge.base.fontSize","role":"typography.body.base.fontSize","description":""},{"path":"badge.base.fontWeight","role":"typography.label.base.fontWeight","description":""},{"path":"badge.base.letterSpacing","role":"typography.label.base.letterSpacing","description":""},{"path":"badge.base.borderRadius","role":"shape.compact","description":""},{"path":"badge.base.paddingX","role":"spacing.2-5","description":""},{"path":"badge.base.paddingY","role":"spacing.1","description":""},{"path":"badge.variant.brand.background","role":"color.brand.primarySubtle","description":""},{"path":"badge.variant.brand.color","role":"color.brand.primary","description":""},{"path":"badge.variant.accent.background","role":"color.accent.subtle","description":""},{"path":"badge.variant.accent.color","role":"color.accent.default","description":""},{"path":"badge.variant.success.background","role":"color.feedback.successSubtle","description":""},{"path":"badge.variant.success.color","role":"color.feedback.success","description":""},{"path":"badge.variant.error.background","role":"color.feedback.errorSubtle","description":""},{"path":"badge.variant.error.color","role":"color.feedback.error","description":""},{"path":"badge.variant.warning.background","role":"color.feedback.warningSubtle","description":""},{"path":"badge.variant.warning.color","role":"color.feedback.warning","description":""},{"path":"badge.variant.neutral.background","role":"color.surface.inset","description":""},{"path":"badge.variant.neutral.color","role":"color.text.secondary","description":""},{"path":"link.inverse.focusBackground","role":"rgba(0, 0, 0, 0.1)","description":"Focus tint — paired with the underline, which is the indicator"},{"path":"modal.overlay","role":"color.surface.backdrop","description":""},{"path":"closeButton.backgroundHover","role":"rgba(0, 0, 0, 0.08)","description":"Neutral tint that works on every alert variant"},{"path":"closeButton.shadowHover","role":"rgba(0, 0, 0, 0.15)","description":"Offset shadow colour on hover and press. Neutral, like the background, so it works on every alert variant"}]}
package/package.json CHANGED
@@ -1,6 +1,37 @@
1
1
  {
2
2
  "name": "@orange-halo/mcp",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "1.0.0",
4
+ "description": "An MCP server that answers questions about the Orange Halo Design System: every component and its API, every tier 2 token with each brand's value, the rules and the recipes. Runs anywhere with npx; its data is bundled.",
5
+ "type": "module",
6
+ "bin": {
7
+ "ohds-mcp": "./server.mjs"
8
+ },
9
+ "files": [
10
+ "server.mjs",
11
+ "index.json",
12
+ "README.md"
13
+ ],
14
+ "keywords": [
15
+ "mcp",
16
+ "design-system",
17
+ "web-components",
18
+ "design-tokens"
19
+ ],
20
+ "license": "MIT",
21
+ "publishConfig": {
22
+ "access": "public"
23
+ },
24
+ "dependencies": {
25
+ "@modelcontextprotocol/sdk": "1.32.2",
26
+ "zod": "3.25.76"
27
+ },
28
+ "devDependencies": {
29
+ "@orange-halo/brand-orange-halo": "2.0.2",
30
+ "@orange-halo/components": "3.2.1",
31
+ "@orange-halo/tokens": "3.0.0"
32
+ },
33
+ "scripts": {
34
+ "build": "node build-index.mjs",
35
+ "test": "node test.mjs"
36
+ }
6
37
  }
package/server.mjs ADDED
@@ -0,0 +1,303 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * OHDS MCP server (stdio). Read-only answers about the design system, from
4
+ * index.json beside this file (written by build-index.mjs). See README.md.
5
+ */
6
+ import { existsSync, readFileSync } from "node:fs";
7
+ import { fileURLToPath } from "node:url";
8
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
9
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
10
+ import { z } from "zod";
11
+
12
+ const indexFile = fileURLToPath(new URL("./index.json", import.meta.url));
13
+ if (!existsSync(indexFile)) {
14
+ console.error(
15
+ "OHDS MCP: index.json is missing. In the OHDS repo, run `pnpm build` (it writes packages/mcp/index.json)."
16
+ );
17
+ process.exit(1);
18
+ }
19
+ const { versions, brands, elements, apiValues, llms, tier2, values, tier3 } =
20
+ JSON.parse(readFileSync(indexFile, "utf8"));
21
+ const { version } = JSON.parse(
22
+ readFileSync(
23
+ fileURLToPath(new URL("./package.json", import.meta.url)),
24
+ "utf8"
25
+ )
26
+ );
27
+ const text = (t) => ({ content: [{ type: "text", text: t }] });
28
+ const byTag = new Map(elements.map((e) => [e.tagName, e]));
29
+ const brandIds = brands.map((b) => b.id);
30
+ const section = (title) =>
31
+ (
32
+ llms.split(/\n(?=## )/).find((s) => s.startsWith(`## ${title}`)) ?? ""
33
+ ).trim();
34
+ const firstSentence = (t = "") =>
35
+ t
36
+ .split(/\n\s*\n/)[0]
37
+ .replace(/\s+/g, " ")
38
+ .replace(/[*`]/g, "")
39
+ .split(/(?<=\.)\s/)[0];
40
+ const cssVar = (p) =>
41
+ `--oh-${p
42
+ .split(".")
43
+ .map((s) => s.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase())
44
+ .join("-")}`;
45
+ // Words in a token path ("color.text.linkRaised" -> color, text, link, raised)
46
+ const words = (p) =>
47
+ p.split(".").flatMap((s) =>
48
+ s
49
+ .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
50
+ .toLowerCase()
51
+ .split(" ")
52
+ );
53
+ // Component words: "card" -> oh-card and the card.* tier 3 tokens; "close button" -> closeButton
54
+ const components = new Map(
55
+ [...new Set(tier3.map((t) => t.path.split(".")[0]))].map((c) => [
56
+ c.toLowerCase(),
57
+ c,
58
+ ])
59
+ );
60
+ const brandValue = (b, p) => JSON.stringify(values[b]?.[p] ?? "?");
61
+
62
+ const server = new McpServer({ name: "ohds", version });
63
+
64
+ server.registerTool(
65
+ "list_components",
66
+ {
67
+ title: "List OHDS components",
68
+ description:
69
+ "Every OHDS custom element, the package it comes from, and what it is in one sentence.",
70
+ inputSchema: {},
71
+ },
72
+ async () =>
73
+ text(
74
+ elements
75
+ .map(
76
+ (e) =>
77
+ `<${e.tagName}> (${e.pkg}): ${firstSentence(e.description) || "no description"}`
78
+ )
79
+ .join("\n")
80
+ )
81
+ );
82
+
83
+ server.registerTool(
84
+ "get_component",
85
+ {
86
+ title: "Get one OHDS component's API",
87
+ description:
88
+ "The full documentation and API of one OHDS element: when to use it, attributes with their allowed values and defaults, events, slots and CSS parts.",
89
+ inputSchema: {
90
+ tag: z.string().describe('The element name, e.g. "oh-button"'),
91
+ },
92
+ },
93
+ async ({ tag }) => {
94
+ const name = tag.trim().replace(/^<|>$/g, "");
95
+ const el = byTag.get(name) ?? byTag.get(`oh-${name}`);
96
+ if (!el)
97
+ return text(
98
+ `No element "${tag}". Elements: ${[...byTag.keys()].join(", ")}`
99
+ );
100
+ const lines = [
101
+ `# <${el.tagName}> (${el.pkg} ${versions[el.pkg] ?? ""})`.trimEnd(),
102
+ "",
103
+ el.description || "(No description.)",
104
+ "",
105
+ "## Attributes",
106
+ ];
107
+ for (const a of el.attributes ?? []) {
108
+ if (a.name === "force-state") continue;
109
+ const fixed = apiValues[el.tagName]?.[a.name];
110
+ const field = el.members?.find((m) => m.name === a.fieldName);
111
+ const about = (a.description || field?.description || "").replace(
112
+ /\s+/g,
113
+ " "
114
+ );
115
+ lines.push(
116
+ `- \`${a.name}\` (property \`${a.fieldName}\`): ${fixed ? fixed.map((v) => `"${v}"`).join(" | ") : (a.type?.text ?? "string")}${a.default ? `, default ${a.default}` : ""}${about ? ` — ${about}` : ""}`
117
+ );
118
+ }
119
+ const props = (el.members ?? []).filter(
120
+ (m) =>
121
+ m.kind === "field" &&
122
+ !m.static &&
123
+ !m.privacy &&
124
+ !(el.attributes ?? []).some((a) => a.fieldName === m.name)
125
+ );
126
+ if (props.length)
127
+ lines.push(
128
+ "",
129
+ "## Properties only (set from JavaScript)",
130
+ ...props.map(
131
+ (m) =>
132
+ `- \`${m.name}\`: ${m.type?.text ?? ""}${m.description ? ` — ${m.description.replace(/\s+/g, " ")}` : ""}`
133
+ )
134
+ );
135
+ if (el.events?.length)
136
+ lines.push(
137
+ "",
138
+ "## Events",
139
+ ...el.events.map(
140
+ (e) => `- \`${e.name}\`${e.description ? ` — ${e.description}` : ""}`
141
+ )
142
+ );
143
+ if (el.slots?.length)
144
+ lines.push(
145
+ "",
146
+ "## Slots",
147
+ ...el.slots.map(
148
+ (s) =>
149
+ `- \`${s.name || "default"}\`${s.description ? ` — ${s.description}` : ""}`
150
+ )
151
+ );
152
+ if (el.cssParts?.length)
153
+ lines.push(
154
+ "",
155
+ "## CSS parts",
156
+ ...el.cssParts.map(
157
+ (p) => `- \`${p.name}\`${p.description ? ` — ${p.description}` : ""}`
158
+ )
159
+ );
160
+ return text(lines.join("\n"));
161
+ }
162
+ );
163
+
164
+ server.registerTool(
165
+ "find_tokens",
166
+ {
167
+ title: "Find OHDS tokens",
168
+ description:
169
+ 'Tier 2 design tokens (the roles every brand sets) for a word or a few words, with the CSS custom property to use and each brand\'s value. A component word ("card", "button") also lists the roles that component reads and the recipe that covers it. Use tier 2 roles in your own CSS; never a brand\'s palette.',
170
+ inputSchema: {
171
+ query: z
172
+ .string()
173
+ .describe(
174
+ 'A token name or words, e.g. "surface", "spacing", "focus", "text.secondary", "card secondary text"'
175
+ ),
176
+ brand: z
177
+ .string()
178
+ .optional()
179
+ .describe(`One brand's values only: ${brandIds.join(", ")}`),
180
+ },
181
+ },
182
+ async ({ query, brand }) => {
183
+ const ids = brand
184
+ ? brandIds.filter((b) => b === brand.toLowerCase())
185
+ : brandIds;
186
+ if (!ids.length)
187
+ return text(`No brand "${brand}". Brands: ${brandIds.join(", ")}`);
188
+ const q = query
189
+ .trim()
190
+ .toLowerCase()
191
+ .replace(/^--oh-/, "");
192
+ const terms = q
193
+ .split(/[\s.\-_,']+/)
194
+ .filter(
195
+ (t) =>
196
+ t &&
197
+ t !== "s" &&
198
+ ![
199
+ "a",
200
+ "an",
201
+ "the",
202
+ "for",
203
+ "of",
204
+ "on",
205
+ "in",
206
+ "with",
207
+ "token",
208
+ "tokens",
209
+ "oh",
210
+ ].includes(t)
211
+ );
212
+ // A component word ("card", "close button") picks the component; the rest search tier 2
213
+ const joined = terms.join("");
214
+ const component =
215
+ components.get(joined) ??
216
+ terms.map((t) => components.get(t)).find(Boolean);
217
+ const rest = component
218
+ ? terms.filter((t) => !component.toLowerCase().includes(t))
219
+ : terms;
220
+ const exact = tier2.filter((t) =>
221
+ t.path.toLowerCase().includes(q.replace(/-/g, "."))
222
+ );
223
+ const byWords = rest.length
224
+ ? tier2.filter((t) =>
225
+ rest.every(
226
+ (w) =>
227
+ words(t.path).some((pw) => pw.startsWith(w)) ||
228
+ t.description.toLowerCase().includes(w)
229
+ )
230
+ )
231
+ : [];
232
+ const hits = [
233
+ ...new Map([...exact, ...byWords].map((t) => [t.path, t])).values(),
234
+ ].slice(0, 60);
235
+ const out = [];
236
+ if (hits.length) {
237
+ out.push(
238
+ `## Tier 2 tokens${rest.length && component ? ` for "${rest.join(" ")}"` : ""}`
239
+ );
240
+ out.push(
241
+ ...hits.map(
242
+ (t) =>
243
+ `${t.path} var(${cssVar(t.path)}) ${ids.map((b) => `${b}: ${brandValue(b, t.path)}`).join(" ")}${t.description ? ` — ${t.description}` : ""}`
244
+ )
245
+ );
246
+ }
247
+ if (component) {
248
+ const own = tier3.filter((t) => t.path.split(".")[0] === component);
249
+ const recipe = llms
250
+ .split("\n")
251
+ .filter(
252
+ (l) =>
253
+ l.startsWith("- ") &&
254
+ new RegExp(`\\b(oh-)?${component}s?\\b`, "i").test(l)
255
+ );
256
+ if (recipe.length)
257
+ out.push("", `## Recipes that mention ${component}`, ...recipe);
258
+ out.push(
259
+ "",
260
+ `## The tier 2 roles ${component} reads (its own tokens are internal: style your content with the roles)`
261
+ );
262
+ out.push(
263
+ ...own.map(
264
+ (t) =>
265
+ `${t.path} → ${/^[a-z]+(\.[a-zA-Z0-9-]+)+$/.test(t.role) ? t.role : `${t.role} (a fixed value)`}`
266
+ )
267
+ );
268
+ }
269
+ if (!out.length)
270
+ return text(
271
+ `No tier 2 token matches "${query}". Try a role (surface, text, border, brand, accent, feedback, spacing, typography, shape, elevation, motion, focus) or a component (${[...components.values()].join(", ")}).`
272
+ );
273
+ return text(out.join("\n").trim());
274
+ }
275
+ );
276
+
277
+ server.registerTool(
278
+ "get_rules",
279
+ {
280
+ title: "How to use OHDS",
281
+ description:
282
+ "How to install and load OHDS (tokens per brand, components), the rules that matter when building with it, and the recipes for text, headings, layout and forms.",
283
+ inputSchema: {},
284
+ },
285
+ async () =>
286
+ text(
287
+ [
288
+ section("Use it"),
289
+ section("Rules that matter when using it"),
290
+ section("Text, headings and layout"),
291
+ section("Forms"),
292
+ `Versions: ${Object.entries(versions)
293
+ .map(([n, v]) => `${n} ${v}`)
294
+ .join(
295
+ ", "
296
+ )}. Full rules for changing OHDS itself: DEVELOPMENT_RULES.md in the repo.`,
297
+ ]
298
+ .filter(Boolean)
299
+ .join("\n\n")
300
+ )
301
+ );
302
+
303
+ await server.connect(new StdioServerTransport());