{
  "generatedAt": "2026-11-10T19:37:14.916Z",
  "product": "Forma",
  "componentCount": 170,
  "iconGalleryUrl": "icons/",
  "newIconGalleryUrl": "icons/new/",
  "iconRelease": "0.6.0",
  "icons": [
    {
      "name": "add",
      "label": "Add",
      "category": "actions",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/add/"
    },
    {
      "name": "agent",
      "label": "Agent",
      "category": "agents",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/agent/"
    },
    {
      "name": "archive",
      "label": "Archive",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/archive/"
    },
    {
      "name": "arrow-left",
      "label": "Back",
      "category": "navigation",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/arrow-left/"
    },
    {
      "name": "arrow-right",
      "label": "Forward",
      "category": "navigation",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/arrow-right/"
    },
    {
      "name": "attachment",
      "label": "Attachment",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/attachment/"
    },
    {
      "name": "bell",
      "label": "Notifications",
      "category": "status",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/bell/"
    },
    {
      "name": "bookmark",
      "label": "Bookmark",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/bookmark/"
    },
    {
      "name": "bug",
      "label": "Bug",
      "category": "diagnostics",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/bug/"
    },
    {
      "name": "calendar",
      "label": "Calendar",
      "category": "documents",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/calendar/"
    },
    {
      "name": "camera",
      "label": "Camera",
      "category": "documents",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/camera/"
    },
    {
      "name": "chart",
      "label": "Chart",
      "category": "documents",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/chart/"
    },
    {
      "name": "chat",
      "label": "Chat",
      "category": "documents",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/chat/"
    },
    {
      "name": "chevron-down",
      "label": "Expand downward",
      "category": "navigation",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/chevron-down/"
    },
    {
      "name": "chevron-left",
      "label": "Chevron left",
      "category": "navigation",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/chevron-left/"
    },
    {
      "name": "chevron-right",
      "label": "Chevron right",
      "category": "navigation",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/chevron-right/"
    },
    {
      "name": "chevron-up",
      "label": "Expand upward",
      "category": "navigation",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/chevron-up/"
    },
    {
      "name": "clipboard",
      "label": "Clipboard",
      "category": "documents",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/clipboard/"
    },
    {
      "name": "clock",
      "label": "Time",
      "category": "status",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/clock/"
    },
    {
      "name": "close",
      "label": "Close",
      "category": "actions",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/close/"
    },
    {
      "name": "code",
      "label": "Code",
      "category": "diagnostics",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/code/"
    },
    {
      "name": "compass",
      "label": "Compass",
      "category": "navigation",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/compass/"
    },
    {
      "name": "copy",
      "label": "Copy",
      "category": "actions",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/copy/"
    },
    {
      "name": "database",
      "label": "Database",
      "category": "diagnostics",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/database/"
    },
    {
      "name": "download",
      "label": "Download",
      "category": "actions",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/download/"
    },
    {
      "name": "edit",
      "label": "Edit",
      "category": "actions",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/edit/"
    },
    {
      "name": "email",
      "label": "Email",
      "category": "documents",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/email/"
    },
    {
      "name": "email-open",
      "label": "Opened email",
      "category": "documents",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/email-open/"
    },
    {
      "name": "error",
      "label": "Error",
      "category": "status",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/error/"
    },
    {
      "name": "external-link",
      "label": "Open external link",
      "category": "navigation",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/external-link/"
    },
    {
      "name": "eye",
      "label": "Show",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/eye/"
    },
    {
      "name": "eye-off",
      "label": "Hide",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/eye-off/"
    },
    {
      "name": "file",
      "label": "Document",
      "category": "documents",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/file/"
    },
    {
      "name": "file-text",
      "label": "Text document",
      "category": "documents",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/file-text/"
    },
    {
      "name": "filter",
      "label": "Filter",
      "category": "actions",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/filter/"
    },
    {
      "name": "folder",
      "label": "Folder",
      "category": "documents",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/folder/"
    },
    {
      "name": "forward",
      "label": "Forward message",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/forward/"
    },
    {
      "name": "globe",
      "label": "Globe",
      "category": "navigation",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/globe/"
    },
    {
      "name": "help-circle",
      "label": "Help",
      "category": "status",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/help-circle/"
    },
    {
      "name": "home",
      "label": "Home",
      "category": "navigation",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/home/"
    },
    {
      "name": "image",
      "label": "Image",
      "category": "documents",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/image/"
    },
    {
      "name": "inbox",
      "label": "Inbox",
      "category": "documents",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/inbox/"
    },
    {
      "name": "info",
      "label": "Information",
      "category": "status",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/info/"
    },
    {
      "name": "link",
      "label": "Link",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/link/"
    },
    {
      "name": "lock",
      "label": "Locked",
      "category": "status",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/lock/"
    },
    {
      "name": "map-pin",
      "label": "Location",
      "category": "navigation",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/map-pin/"
    },
    {
      "name": "maximize",
      "label": "Maximize",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/maximize/"
    },
    {
      "name": "menu",
      "label": "Menu",
      "category": "navigation",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/menu/"
    },
    {
      "name": "message",
      "label": "Message",
      "category": "documents",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/message/"
    },
    {
      "name": "microphone",
      "label": "Microphone",
      "category": "documents",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/microphone/"
    },
    {
      "name": "minimize",
      "label": "Minimize",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/minimize/"
    },
    {
      "name": "minus",
      "label": "Remove",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/minus/"
    },
    {
      "name": "more-horizontal",
      "label": "More options",
      "category": "actions",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/more-horizontal/"
    },
    {
      "name": "more-vertical",
      "label": "More options vertical",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/more-vertical/"
    },
    {
      "name": "pending",
      "label": "Pending",
      "category": "status",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/pending/"
    },
    {
      "name": "phone",
      "label": "Phone",
      "category": "documents",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/phone/"
    },
    {
      "name": "print",
      "label": "Print",
      "category": "documents",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/print/"
    },
    {
      "name": "refresh",
      "label": "Refresh",
      "category": "actions",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/refresh/"
    },
    {
      "name": "reply",
      "label": "Reply",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/reply/"
    },
    {
      "name": "reply-all",
      "label": "Reply all",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/reply-all/"
    },
    {
      "name": "save",
      "label": "Save",
      "category": "actions",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/save/"
    },
    {
      "name": "search",
      "label": "Search",
      "category": "actions",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/search/"
    },
    {
      "name": "send",
      "label": "Send",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/send/"
    },
    {
      "name": "server",
      "label": "Server",
      "category": "diagnostics",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/server/"
    },
    {
      "name": "settings",
      "label": "Settings",
      "category": "actions",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/settings/"
    },
    {
      "name": "share",
      "label": "Share",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/share/"
    },
    {
      "name": "shield",
      "label": "Security",
      "category": "status",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/shield/"
    },
    {
      "name": "sort",
      "label": "Sort",
      "category": "actions",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/sort/"
    },
    {
      "name": "star",
      "label": "Favorite",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/star/"
    },
    {
      "name": "success",
      "label": "Success",
      "category": "status",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/success/"
    },
    {
      "name": "trash",
      "label": "Delete",
      "category": "actions",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/trash/"
    },
    {
      "name": "unlink",
      "label": "Unlink",
      "category": "actions",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/unlink/"
    },
    {
      "name": "upload",
      "label": "Upload",
      "category": "actions",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/upload/"
    },
    {
      "name": "user",
      "label": "User",
      "category": "agents",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/user/"
    },
    {
      "name": "users",
      "label": "Team",
      "category": "agents",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/users/"
    },
    {
      "name": "video",
      "label": "Video",
      "category": "documents",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/video/"
    },
    {
      "name": "video-call",
      "label": "Video call",
      "category": "documents",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/video-call/"
    },
    {
      "name": "warning",
      "label": "Warning",
      "category": "status",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/warning/"
    },
    {
      "name": "wifi-off",
      "label": "Offline",
      "category": "status",
      "introducedIn": "0.6.0",
      "docsUrl": "icons/wifi-off/"
    },
    {
      "name": "workflow",
      "label": "Workflow",
      "category": "workflow",
      "introducedIn": "0.5.0",
      "docsUrl": "icons/workflow/"
    }
  ],
  "categoryCount": 18,
  "exampleCount": 738,
  "exampleMinimum": 3,
  "categories": [
    {
      "id": "actions",
      "name": "Actions",
      "summary": "Buttons and grouped commands that start work. Forma styles the native control; the application decides what an action does and whether it is currently legal.",
      "docsUrl": "components/actions/",
      "components": [
        "button",
        "command-group",
        "mobile-action-bar",
        "overflow-command-disclosure"
      ]
    },
    {
      "id": "forms",
      "name": "Form inputs",
      "summary": "Native text, date, numeric, range, file and toggle inputs with delegated labels, help text and form participation left to the browser.",
      "docsUrl": "components/forms/",
      "components": [
        "checkbox",
        "combobox",
        "date-time-field",
        "date-range",
        "file-upload",
        "form",
        "numeric-stepper",
        "range-entry",
        "rule-builder",
        "search",
        "select",
        "slider",
        "switch",
        "text-field",
        "textarea"
      ]
    },
    {
      "id": "selection",
      "name": "Selection and choice",
      "summary": "Radio- and checkbox-backed choice structures: segmented controls, choice cards, multi-select guidance and hierarchical selection.",
      "docsUrl": "components/selection/",
      "components": [
        "choice-group",
        "hierarchical-choice",
        "hierarchical-multi-choice",
        "image-choice",
        "multi-choice",
        "segmented-control"
      ]
    },
    {
      "id": "assessment",
      "name": "Assessment and survey",
      "summary": "Question shells and response scales that keep Unanswered distinct, keep radio semantics per row, and never compute scores.",
      "docsUrl": "components/assessment/",
      "components": [
        "allocation",
        "best-worst",
        "binary-choice",
        "ordinal-scale",
        "pairwise-choice",
        "question",
        "ranking",
        "semantic-differential",
        "matrix-single",
        "special-choice",
        "survey-progress",
        "symbol-rating"
      ]
    },
    {
      "id": "navigation",
      "name": "Navigation",
      "summary": "Where am I and where can I go: shells, tabs, pagination, scope trails, trees, wizards and skip links.",
      "docsUrl": "components/navigation/",
      "components": [
        "hierarchy-tree",
        "navigation-shell",
        "pagination",
        "scope-trail",
        "skip-link",
        "tabs",
        "wizard"
      ]
    },
    {
      "id": "feedback",
      "name": "Feedback and status",
      "summary": "Alerts, notifications, validation, loading and progress, and explicit operation states that never collapse unknown into failure.",
      "docsUrl": "components/feedback/",
      "components": [
        "alert",
        "conflict-review",
        "empty-state",
        "freshness",
        "obligation-panel",
        "operation-status",
        "progress-bar",
        "readiness-checklist",
        "scroll-progress",
        "skeleton",
        "spinner",
        "startup",
        "state-survivability",
        "status-lozenge",
        "toast",
        "validation-message",
        "validation-summary"
      ]
    },
    {
      "id": "faults",
      "name": "Faults and recovery",
      "summary": "The Aegis fault presentation family: safe inline, notification, banner and blocking faults with application-authorized recovery.",
      "docsUrl": "components/faults/",
      "components": [
        "diagnostic-status",
        "fault",
        "fault-banner",
        "fault-blocking",
        "fault-details",
        "fault-inline",
        "fault-notification",
        "fault-reference",
        "fault-summary",
        "recovery-actions"
      ]
    },
    {
      "id": "overlays",
      "name": "Overlays and disclosure",
      "summary": "Native dialog, Popover API and details/summary surfaces: modal dialogs, edge flyouts, popovers, tooltips, menus and disclosure.",
      "docsUrl": "components/overlays/",
      "components": [
        "menu",
        "dialog",
        "disclosure",
        "flyout",
        "overview-disclosure",
        "popover",
        "tooltip"
      ]
    },
    {
      "id": "layout",
      "name": "Layout primitives",
      "summary": "Intrinsic, container-aware composition primitives that recompose by available space without reordering source.",
      "docsUrl": "components/layout/",
      "components": [
        "bounded-overflow",
        "cluster",
        "container",
        "form-row",
        "frame",
        "grid",
        "landmark-region",
        "measure",
        "mosaic",
        "priority-stack",
        "rail",
        "responsive-grid",
        "section",
        "sidebar",
        "split",
        "stack",
        "surface",
        "switcher"
      ]
    },
    {
      "id": "workspaces",
      "name": "Workspaces and shells",
      "summary": "Multi-region application compositions: workspace shells, master/detail, split panes, dashboards and record headers.",
      "docsUrl": "components/workspaces/",
      "components": [
        "app-identity",
        "dashboard-grid",
        "focus-stage",
        "master-detail",
        "preview-surface",
        "record-header",
        "resizable-split-pane",
        "split-pane",
        "workspace-shell"
      ]
    },
    {
      "id": "data",
      "name": "Data display",
      "summary": "Tables, ledgers, key-value lists, metrics, timelines, diffs, collections and relationship displays.",
      "docsUrl": "components/data/",
      "components": [
        "active-filter-summary",
        "collection-toolbar",
        "comparison-grid",
        "comparison-pairs",
        "data-grid",
        "dense-ledger",
        "diff-viewer",
        "evidence-relationship",
        "feed-item",
        "identifier",
        "key-value-list",
        "metric-card",
        "metric-value-change",
        "path-summary",
        "provenance-trail",
        "relationship-index",
        "reorder-states",
        "timeline",
        "work-queue"
      ]
    },
    {
      "id": "workflow",
      "name": "Workflow and diagrams",
      "summary": "Presentation-only building blocks for boards, diagrams and spatial canvases; geometry, routing and editing stay in the application.",
      "docsUrl": "components/workflow/",
      "components": [
        "diagram",
        "lane-board",
        "spatial-canvas"
      ]
    },
    {
      "id": "keyboard",
      "name": "Command and keyboard-first",
      "summary": "Command palette and the CharacterGrid terminal family for keyboard-driven, fixed-cell interfaces.",
      "docsUrl": "components/keyboard/",
      "components": [
        "character-grid",
        "character-grid-3270",
        "character-grid-field",
        "character-grid-keys",
        "character-grid-reveal",
        "character-grid-selection",
        "character-grid-status",
        "character-grid-workflow",
        "command-palette"
      ]
    },
    {
      "id": "assisted",
      "name": "Human–agent interaction",
      "summary": "Composer, conversation, understanding review and handoff surfaces that keep agent proposals inspectable and human authority explicit.",
      "docsUrl": "components/assisted/",
      "components": [
        "composer",
        "conversation",
        "handoff-summary",
        "understanding"
      ]
    },
    {
      "id": "verification",
      "name": "Attention and verification",
      "summary": "Visual Engineering contracts for first-glance priority, bounded emphasis, and recognize-verify-act flows.",
      "docsUrl": "components/verification/",
      "components": [
        "attention-path",
        "emphasis-budget",
        "verification-frame"
      ]
    },
    {
      "id": "security",
      "name": "Security posture",
      "summary": "Security results, evidence, exceptions and unknowns presented with explicit text state rather than color-only pass/fail.",
      "docsUrl": "components/security/",
      "components": [
        "security-blockers",
        "security-evidence-age",
        "security-evidence-chain",
        "security-exception",
        "security-invariant-result",
        "security-posture",
        "security-state-matrix",
        "security-trend",
        "security-unknown"
      ]
    },
    {
      "id": "site",
      "name": "Site and editorial",
      "summary": "The brand-neutral marketing and documentation presentation family: shell, header, hero, sections, cards, prose and footer.",
      "docsUrl": "components/site/",
      "components": [
        "badge",
        "cta",
        "callout",
        "card-grid",
        "code-sample",
        "documentation-layout",
        "entry-index",
        "facts",
        "hero",
        "marketing-shell",
        "prose",
        "section-heading",
        "site-footer",
        "site-header",
        "steps"
      ]
    },
    {
      "id": "utilities",
      "name": "Utilities",
      "summary": "Small structural helpers: visually hidden text, text roles and other composition aids.",
      "docsUrl": "components/utilities/",
      "components": [
        "icon",
        "text-roles",
        "visually-hidden"
      ]
    }
  ],
  "components": [
    {
      "slug": "menu",
      "title": "Action menu",
      "tag": "forma-menu",
      "category": "overlays",
      "behavior": "Native HTML",
      "summary": "A Popover-backed ordinary action list with light physics-derived motion; full ARIA menu behavior remains application-owned.",
      "docsUrl": "components/menu/",
      "pattern": "patterns/menu.html",
      "minimalHtml": "<forma-menu class=\"forma-component-tag\">\n<button type=\"button\" popovertarget=\"record-actions\">More actions</button>\n<div class=\"forma-menu\" id=\"record-actions\" popover data-forma-motion-weight=\"light\">\n  <ul class=\"forma-menu__list\">\n    <li><button type=\"button\">Duplicate record</button></li>\n    <li><button type=\"button\">Export record</button></li>\n    <li><button type=\"button\">Archive record</button></li>\n  </ul>\n</div>\n</forma-menu>",
      "attributes": [
        {
          "name": "popover",
          "on": ".forma-menu",
          "values": "auto (empty) | manual",
          "default": "auto",
          "description": "Makes the menu a popover. Keep auto so outside click and Escape close it."
        },
        {
          "name": "popovertarget",
          "on": "trigger button",
          "values": "id of the menu",
          "default": "—",
          "description": "Connects the trigger to the menu; toggles it."
        },
        {
          "name": "aria-label",
          "on": ".forma-menu__list",
          "values": "string",
          "default": "—",
          "description": "Optional name for the list, usually the trigger's label."
        },
        {
          "name": "disabled",
          "on": "item button",
          "values": "boolean",
          "default": "absent",
          "description": "Native disabled command: skipped by Tab and not activatable. No additional styling is applied."
        },
        {
          "name": "data-forma-motion-weight",
          "on": ".forma-menu",
          "values": "light | standard | heavy",
          "default": "light",
          "description": "Presentation-only perceived mass for entry and exit."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-menu",
          "elements": [
            "forma-menu__list"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Enter / Space on the trigger",
          "action": "Opens or closes the menu. Focus stays on the trigger."
        },
        {
          "keys": "Tab / Shift+Tab",
          "action": "From the trigger, moves through the menu items in order, then onward to the page. There is no arrow-key navigation unless the application adds it."
        },
        {
          "keys": "Enter / Space on an item",
          "action": "Activates the button or follows the link."
        },
        {
          "keys": "Escape",
          "action": "Closes the menu and returns focus to the trigger if focus was inside."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "row-actions-mixed",
          "title": "Row actions mixing links and commands",
          "mobile": false,
          "raw": "components/menu/row-actions-mixed.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior",
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "unavailable-and-long-labels",
          "title": "Unavailable action and long labels",
          "mobile": false,
          "raw": "components/menu/unavailable-and-long-labels.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-record-menu",
          "title": "Record menu on a phone",
          "mobile": true,
          "raw": "components/menu/mobile-record-menu.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior",
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "popover",
        "overflow-command-disclosure",
        "command-group",
        "command-palette",
        "select"
      ]
    },
    {
      "slug": "active-filter-summary",
      "title": "Active filter summary",
      "tag": "forma-active-filter-summary",
      "category": "data",
      "behavior": "Application content",
      "summary": "Keeps active query refinements and scope visible while filter controls recompose.",
      "docsUrl": "components/active-filter-summary/",
      "pattern": "patterns/active-filter-summary.html",
      "minimalHtml": "<forma-active-filter-summary class=\"forma-component-tag\">\n<section class=\"forma-active-filter-summary\" aria-labelledby=\"active-filters-title\">\n  <div class=\"forma-active-filter-summary__heading\">\n    <h2 id=\"active-filters-title\">Active filters</h2>\n    <button type=\"button\">Clear all</button>\n  </div>\n  <ul class=\"forma-active-filter-summary__items\">\n    <li><span>Status: Open</span><button type=\"button\" aria-label=\"Remove Status: Open filter\">Remove</button></li>\n    <li><span>Owner: Me</span><button type=\"button\" aria-label=\"Remove Owner: Me filter\">Remove</button></li>\n  </ul>\n</section>\n</forma-active-filter-summary>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-active-filter-summary",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the summary region."
        },
        {
          "name": "aria-label",
          "on": "remove button",
          "values": "\"Remove <filter> filter\"",
          "default": "—",
          "description": "Identifies which filter a Remove button removes; the visible label alone is ambiguous."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Remove and Clear all are native buttons handled by the application."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-active-filter-summary",
          "elements": [
            "forma-active-filter-summary__heading",
            "forma-active-filter-summary__items"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through Clear all and each remove button in order."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused button (native). The application removes the filter and re-queries."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "fixed-scope",
          "title": "Fixed scope with removable filters",
          "mobile": false,
          "raw": "components/active-filter-summary/fixed-scope.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "no-active-filters",
          "title": "No filters applied",
          "mobile": false,
          "raw": "components/active-filter-summary/no-active-filters.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-many-filters",
          "title": "Mobile summary with many filters",
          "mobile": true,
          "raw": "components/active-filter-summary/mobile-many-filters.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "collection-toolbar",
        "scope-trail",
        "empty-state",
        "status-lozenge"
      ]
    },
    {
      "slug": "alert",
      "title": "Alert",
      "tag": "forma-alert",
      "category": "feedback",
      "behavior": "Application state",
      "summary": "An in-page status or warning block with an icon, a heading, explanatory text and an optional action, readable without color.",
      "docsUrl": "components/alert/",
      "pattern": "patterns/alert.html",
      "minimalHtml": "<forma-alert class=\"forma-component-tag\">\n<aside class=\"forma-alert\" role=\"status\" data-tone=\"attention\" data-forma-motion-weight=\"standard\" data-forma-motion-entry>\n  <div class=\"forma-alert__icon\" aria-hidden=\"true\">!</div>\n  <div>\n    <h3 class=\"forma-alert__title\">Review required</h3>\n    <p>Two values changed since this view was loaded. No update has been applied.</p>\n  </div>\n  <button type=\"button\">Review changes</button>\n</aside>\n</forma-alert>",
      "attributes": [
        {
          "name": "role",
          "on": "aside.forma-alert",
          "values": "status | alert",
          "default": "—",
          "description": "Live-region semantics chosen by the application. `status` is polite; `alert` interrupts and should be rare. Either role replaces the aside's complementary landmark role."
        },
        {
          "name": "aria-labelledby",
          "on": "aside.forma-alert",
          "values": "id of .forma-alert__title",
          "default": "—",
          "description": "Names the region by its heading."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-alert__icon",
          "values": "true",
          "default": "—",
          "description": "Hides the decorative glyph so it is not read before the heading."
        },
        {
          "name": "data-tone",
          "on": "aside.forma-alert",
          "values": "application-defined",
          "default": "—",
          "description": "Used by the canonical pattern as an application data hook. Forma CSS does not style it; the alert looks the same for every value."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Keeps actions from submitting a surrounding form."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-alert",
          "elements": [
            "forma-alert__icon",
            "forma-alert__title"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-entry",
              "values": []
            },
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the alert's buttons or links. The alert itself is not focusable."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused action button (native button behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "stale-data-warning",
          "title": "Stale data warning",
          "mobile": false,
          "raw": "components/alert/stale-data-warning.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "confirmed-save",
          "title": "Confirmed outcome without an action",
          "mobile": false,
          "raw": "components/alert/confirmed-save.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "urgent-session-expiry",
          "title": "Urgent interruption",
          "mobile": false,
          "raw": "components/alert/urgent-session-expiry.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-review-alert",
          "title": "Mobile review prompt",
          "mobile": true,
          "raw": "components/alert/mobile-review-alert.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "toast",
        "callout",
        "operation-status",
        "fault-banner"
      ]
    },
    {
      "slug": "allocation",
      "title": "Allocation",
      "tag": "forma-allocation",
      "category": "assessment",
      "behavior": "Application / Limen",
      "summary": "Distribute a bounded amount across multiple choices while preserving direct numeric entry.",
      "docsUrl": "components/allocation/",
      "pattern": "patterns/allocation.html",
      "minimalHtml": "<forma-allocation class=\"forma-component-tag\">\n<fieldset class=\"forma-allocation\">\n  <legend class=\"forma-allocation__legend\">Distribute 10 points across these priorities.</legend>\n\n  <div class=\"forma-allocation__items\">\n    <label class=\"forma-allocation__item\">\n      <span>Reliability</span>\n      <input type=\"number\" name=\"reliability\" min=\"0\" max=\"10\" step=\"1\" value=\"4\" inputmode=\"numeric\">\n    </label>\n    <label class=\"forma-allocation__item\">\n      <span>Delivery speed</span>\n      <input type=\"number\" name=\"delivery-speed\" min=\"0\" max=\"10\" step=\"1\" value=\"3\" inputmode=\"numeric\">\n    </label>\n    <label class=\"forma-allocation__item\">\n      <span>Cost efficiency</span>\n      <input type=\"number\" name=\"cost-efficiency\" min=\"0\" max=\"10\" step=\"1\" value=\"3\" inputmode=\"numeric\">\n    </label>\n  </div>\n\n  <div class=\"forma-allocation__total\" data-forma-state=\"valid\" aria-live=\"polite\" aria-atomic=\"true\">\n    <span>Total</span>\n    <output>10 / 10</output>\n  </div>\n  <p class=\"forma-field__description\">Limen validates the aggregate total and renders the authoritative state.</p>\n</fieldset>\n</forma-allocation>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "number",
          "default": "—",
          "description": "Required. Direct numeric entry is the baseline interaction."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Field name for each item's value."
        },
        {
          "name": "min",
          "on": "input",
          "values": "number",
          "default": "—",
          "description": "Native lower bound for one item. It cannot express the aggregate total."
        },
        {
          "name": "max",
          "on": "input",
          "values": "number",
          "default": "—",
          "description": "Native upper bound for one item, usually the whole budget."
        },
        {
          "name": "step",
          "on": "input",
          "values": "number",
          "default": "\"1\"",
          "description": "Native granularity; arrow keys step by this amount."
        },
        {
          "name": "value",
          "on": "input",
          "values": "number",
          "default": "—",
          "description": "Initial or saved value for the item."
        },
        {
          "name": "inputmode",
          "on": "input",
          "values": "numeric",
          "default": "—",
          "description": "Requests a numeric keypad on touch devices."
        },
        {
          "name": "aria-live",
          "on": ".forma-allocation__total",
          "values": "polite",
          "default": "—",
          "description": "Announces total updates written by the application."
        },
        {
          "name": "aria-atomic",
          "on": ".forma-allocation__total",
          "values": "true",
          "default": "—",
          "description": "Reads label and value together."
        },
        {
          "name": "aria-describedby",
          "on": "fieldset",
          "values": "id list",
          "default": "—",
          "description": "Associates the total error message with the group."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-allocation",
          "elements": [
            "forma-allocation__item",
            "forma-allocation__items",
            "forma-allocation__legend",
            "forma-allocation__total"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-state",
              "values": [
                "invalid"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between the number fields."
        },
        {
          "keys": "Arrow Up / Arrow Down",
          "action": "Native number input stepping by `step`, clamped to min and max."
        },
        {
          "keys": "Digits",
          "action": "Direct entry of a value."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "over-allocated",
          "title": "Over-allocated total",
          "mobile": false,
          "raw": "components/allocation/over-allocated.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "percentage-in-progress",
          "title": "Percentage split in progress",
          "mobile": false,
          "raw": "components/allocation/percentage-in-progress.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-stacked-fields",
          "title": "Allocation on a phone",
          "mobile": true,
          "raw": "components/allocation/mobile-stacked-fields.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "ranking",
        "numeric-stepper",
        "validation-message"
      ]
    },
    {
      "slug": "app-identity",
      "title": "Application identity",
      "tag": "forma-app-identity",
      "category": "workspaces",
      "behavior": "Native HTML",
      "summary": "An application's own mark and name: an inline SVG mark that takes the theme accent, or an external mark with light and dark variants and a text monogram the browser shows natively when the asset fails to load.",
      "docsUrl": "components/app-identity/",
      "pattern": "patterns/app-identity.html",
      "minimalHtml": "<forma-app-identity class=\"forma-component-tag\">\n<a class=\"forma-app-identity\" href=\"./\">\n  <span class=\"forma-app-identity__mark\">\n    <svg viewBox=\"0 0 32 32\" aria-hidden=\"true\" focusable=\"false\"><path fill=\"currentColor\" fill-rule=\"evenodd\" d=\"M6 0h20a6 6 0 0 1 6 6v20a6 6 0 0 1-6 6H6a6 6 0 0 1-6-6V6a6 6 0 0 1 6-6Zm10 8-8 14h16Z\"/></svg>\n  </span>\n  <span class=\"forma-app-identity__name\">Northwind Ledger</span>\n</a>\n</forma-app-identity>",
      "attributes": [
        {
          "name": "href",
          "on": "a.forma-app-identity",
          "values": "URL",
          "default": "—",
          "description": "Makes the identity the home link. Use a span when it is not a link, such as on a start-up screen."
        },
        {
          "name": "data-forma-size",
          "on": ".forma-app-identity",
          "values": "16 | 24 | 32 | 64",
          "default": "32",
          "description": "Mark size in CSS pixels. 64 also enlarges the name, for start-up and about surfaces."
        },
        {
          "name": "focusable",
          "on": "svg (inline mark)",
          "values": "false",
          "default": "—",
          "description": "Preferred mark: an inline SVG drawn with fill=\"currentColor\", with aria-hidden=\"true\" and focusable=\"false\" so it is neither announced nor focused. It takes the theme accent and needs no request."
        },
        {
          "name": "type",
          "on": "object",
          "values": "image/svg+xml | image/png | image/webp",
          "default": "—",
          "description": "The mark asset's media type. Serve a trusted, same-origin, script-free asset: an object element renders SVG as a document."
        },
        {
          "name": "data",
          "on": "object",
          "values": "URL",
          "default": "—",
          "description": "The mark asset. When it cannot be loaded the browser renders the object's content, the monogram."
        },
        {
          "name": "aria-hidden",
          "on": "object and .forma-app-identity__monogram",
          "values": "true",
          "default": "—",
          "description": "Hides the mark; the name is the accessible name."
        },
        {
          "name": "tabindex",
          "on": "object",
          "values": "-1",
          "default": "—",
          "description": "Keeps the embedded mark out of the tab order."
        },
        {
          "name": "data-forma-scheme",
          "on": ".forma-app-identity__variant",
          "values": "light | dark",
          "default": "absent (shown in every theme)",
          "description": "Marks a variant for one color scheme. Forma shows the variant that matches the active theme."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-app-identity",
          "elements": [
            "forma-app-identity__context",
            "forma-app-identity__mark",
            "forma-app-identity__monogram",
            "forma-app-identity__name",
            "forma-app-identity__variant"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-scheme",
              "values": [
                "dark",
                "light"
              ]
            },
            {
              "name": "data-forma-size",
              "values": [
                "16",
                "24",
                "32",
                "64"
              ]
            }
          ],
          "customProperties": [
            {
              "name": "--forma-app-identity-size",
              "default": "2rem"
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab",
          "action": "Reaches the link root once; the embedded mark is not focusable."
        },
        {
          "keys": "Enter",
          "action": "Follows the home link."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "header-with-context",
          "title": "Application header with a context line",
          "mobile": false,
          "raw": "components/app-identity/header-with-context.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "missing-asset",
          "title": "External mark that fails to load",
          "mobile": false,
          "raw": "components/app-identity/missing-asset.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "light-and-dark-marks",
          "title": "Separate light and dark marks",
          "mobile": false,
          "raw": "components/app-identity/light-and-dark-marks.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "sizes",
          "title": "Small-size legibility (16, 24, 32 and 64 pixels)",
          "mobile": false,
          "raw": "components/app-identity/sizes.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-compact-header",
          "title": "Compact phone header, mark only",
          "mobile": true,
          "raw": "components/app-identity/mobile-compact-header.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "startup",
        "navigation-shell",
        "site-header"
      ]
    },
    {
      "slug": "attention-path",
      "title": "Attention path",
      "tag": "forma-attention-path",
      "category": "verification",
      "behavior": "Application content",
      "summary": "Declares an intended first-glance priority path while preserving semantic source order and explicit text when visual emphasis channels are removed.",
      "docsUrl": "components/attention-path/",
      "pattern": "patterns/attention-path.html",
      "minimalHtml": "<forma-attention-path class=\"forma-component-tag\">\n<main class=\"forma-attention-path\" aria-labelledby=\"attention-title\">\n  <header>\n    <p class=\"forma-component-kicker\">Release verification</p>\n    <h2 id=\"attention-title\">Human review required</h2>\n  </header>\n  <section class=\"forma-attention-path__primary\" data-attention-step=\"1\" aria-labelledby=\"attention-primary\">\n    <span class=\"forma-status-lozenge\" data-state=\"unknown\">Unknown consumer outcome</span>\n    <h3 id=\"attention-primary\">Reconcile the consumer smoke test before publishing</h3>\n    <p>The package build passed, but the consuming application has not reported a current verification result.</p>\n    <div class=\"forma-cluster\">\n      <button type=\"button\">Reconcile consumer</button>\n      <button type=\"button\">Inspect evidence</button>\n    </div>\n  </section>\n  <div class=\"forma-attention-path__support\">\n    <section data-attention-step=\"2\" aria-labelledby=\"attention-evidence\">\n      <h3 id=\"attention-evidence\">Evidence</h3>\n      <p>CI run 1042 passed 148 checks. Package contents were generated successfully.</p>\n    </section>\n    <section data-attention-step=\"3\" aria-labelledby=\"attention-context\">\n      <h3 id=\"attention-context\">Context</h3>\n      <p>Release 1.4.0 changes comparison and verification presentation contracts.</p>\n    </section>\n    <section data-attention-step=\"4\" aria-labelledby=\"attention-history\">\n      <h3 id=\"attention-history\">Recent history</h3>\n      <p>Two previous releases completed without reconciliation work.</p>\n    </section>\n  </div>\n</main>\n</forma-attention-path>",
      "attributes": [
        {
          "name": "data-attention-step",
          "on": "primary and supporting regions",
          "values": "positive integer",
          "default": "absent",
          "description": "Declares the region's place in the intended attention path and renders a visible \"Priority N\" label. Must follow source order; descriptive only, never severity or authority."
        },
        {
          "name": "aria-labelledby",
          "on": "root and each region",
          "values": "id of the region heading",
          "default": "—",
          "description": "Names each region by its heading so the path is navigable by headings and regions."
        },
        {
          "name": "data-state",
          "on": ".forma-status-lozenge",
          "values": "ok | attention | blocked | unknown",
          "default": "absent",
          "description": "Adds a status symbol to the text status in the primary region."
        },
        {
          "name": "lang",
          "on": "root or regions",
          "values": "BCP 47 tag",
          "default": "inherited",
          "description": "Declare the language of localized content so wrapping and pronunciation are correct."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-attention-path",
          "elements": [
            "forma-attention-path__primary",
            "forma-attention-path__support"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through actions in source order, which is also the declared attention order. No added keyboard behavior."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "payment-release",
          "title": "Blocked payment release",
          "mobile": false,
          "raw": "components/attention-path/payment-release.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "reconciling-state",
          "title": "Reconciling state with long localized text",
          "mobile": false,
          "raw": "components/attention-path/reconciling-state.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-review",
          "title": "Mobile review path",
          "mobile": true,
          "raw": "components/attention-path/mobile-review.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "emphasis-budget",
        "verification-frame",
        "overview-disclosure",
        "priority-stack"
      ]
    },
    {
      "slug": "badge",
      "title": "Badge",
      "tag": "forma-badge",
      "category": "site",
      "behavior": "Site content",
      "summary": "Compact labels and metadata; status badges carry meaning in text with a redundant colored edge.",
      "docsUrl": "components/badge/",
      "pattern": "patterns/badge.html",
      "minimalHtml": "<forma-badge class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <ul class=\"forma-badge-list\" aria-label=\"Product facts\">\n    <li><span class=\"forma-badge\">F#</span></li>\n    <li><span class=\"forma-badge\">Zero runtime</span></li>\n    <li><span class=\"forma-badge\" data-forma-status=\"success\">Stable</span></li>\n    <li><span class=\"forma-badge\" data-forma-status=\"warning\">Preview</span></li>\n    <li><a class=\"forma-badge\" href=\"#changelog\">Changelog</a></li>\n  </ul>\n</div>\n</forma-badge>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "ul.forma-badge-list",
          "values": "string",
          "default": "—",
          "description": "Names the list (\"Release facts\", \"Topics\")."
        },
        {
          "name": "href",
          "on": "a.forma-badge",
          "values": "URL",
          "default": "—",
          "description": "Makes a badge a link. Use an `a`, never a clickable `span`."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-badge",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-status",
              "values": [
                "danger",
                "info",
                "success",
                "warning"
              ]
            }
          ],
          "customProperties": []
        },
        {
          "root": "forma-badge-list",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between linked badges; span badges are not focusable."
        },
        {
          "keys": "Enter",
          "action": "Follows a linked badge (native link behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "release-status",
          "title": "Release status in a hero",
          "mobile": false,
          "raw": "components/badge/release-status.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "lifecycle-statuses",
          "title": "Lifecycle statuses",
          "mobile": false,
          "raw": "components/badge/lifecycle-statuses.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-topic-links",
          "title": "Phone topic links",
          "mobile": true,
          "raw": "components/badge/mobile-topic-links.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Accessibility",
                "expect": {
                  "url": "#badge-mobile-topic-links-end"
                }
              },
              {
                "role": "link",
                "name": "Design tokens",
                "expect": {
                  "url": "#badge-mobile-topic-links-end"
                }
              },
              {
                "role": "link",
                "name": "Forced colors",
                "expect": {
                  "url": "#badge-mobile-topic-links-end"
                }
              },
              {
                "role": "link",
                "name": "Release engineering",
                "expect": {
                  "url": "#badge-mobile-topic-links-end"
                }
              },
              {
                "role": "link",
                "name": "Typography",
                "expect": {
                  "url": "#badge-mobile-topic-links-end"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "status-lozenge",
        "facts",
        "hero"
      ]
    },
    {
      "slug": "best-worst",
      "title": "Best–Worst",
      "tag": "forma-best-worst",
      "category": "assessment",
      "behavior": "Application / Limen",
      "summary": "Capture distinct strongest and weakest choices without hiding the two-selection constraint.",
      "docsUrl": "components/best-worst/",
      "pattern": "patterns/best-worst.html",
      "minimalHtml": "<forma-best-worst class=\"forma-component-tag\">\n<fieldset class=\"forma-best-worst\">\n  <legend class=\"forma-best-worst__legend\">Choose the most important and least important item.</legend>\n  <p class=\"forma-field__description\">One item must be Best and a different item must be Worst. Limen enforces the cross-column constraint.</p>\n\n  <div class=\"forma-best-worst__header\" aria-hidden=\"true\">\n    <span>Option</span><span>Best</span><span>Worst</span>\n  </div>\n\n  <div class=\"forma-best-worst__row\">\n    <span id=\"bw-reliability\">Reliability</span>\n    <label><input type=\"radio\" name=\"best\" value=\"reliability\" aria-labelledby=\"bw-reliability bw-best-label\"><span class=\"forma-sr-only\" id=\"bw-best-label\">Best</span></label>\n    <label><input type=\"radio\" name=\"worst\" value=\"reliability\" aria-labelledby=\"bw-reliability bw-worst-label\"><span class=\"forma-sr-only\" id=\"bw-worst-label\">Worst</span></label>\n  </div>\n  <div class=\"forma-best-worst__row\">\n    <span id=\"bw-speed\">Delivery speed</span>\n    <label><input type=\"radio\" name=\"best\" value=\"speed\" aria-label=\"Delivery speed, Best\"></label>\n    <label><input type=\"radio\" name=\"worst\" value=\"speed\" aria-label=\"Delivery speed, Worst\"></label>\n  </div>\n\n  <p class=\"forma-best-worst__status\" data-forma-state=\"incomplete\" aria-live=\"polite\">Choose one Best and one Worst.</p>\n</fieldset>\n</forma-best-worst>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "radio",
          "default": "—",
          "description": "Radios: one group for Best, one for Worst."
        },
        {
          "name": "name",
          "on": "input",
          "values": "one name for all Best radios, another for all Worst radios",
          "default": "—",
          "description": "The two names make Best and Worst each single-select. Unique per question."
        },
        {
          "name": "value",
          "on": "input",
          "values": "item identifier",
          "default": "—",
          "description": "The item chosen for that role."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Restores saved Best and Worst choices."
        },
        {
          "name": "aria-label",
          "on": "input",
          "values": "\"<item>, Best\" or \"<item>, Worst\"",
          "default": "—",
          "description": "Required. The radios have no visible text of their own, so each needs a name that combines item and role. aria-labelledby pointing at the item text and a role label is equivalent."
        },
        {
          "name": "aria-labelledby",
          "on": "input",
          "values": "ids of item text and role label",
          "default": "—",
          "description": "Alternative to aria-label used by the canonical pattern."
        },
        {
          "name": "aria-invalid",
          "on": "inputs",
          "values": "true",
          "default": "absent",
          "description": "Set by the application when the same item holds both roles or a role is missing on submit."
        },
        {
          "name": "aria-live",
          "on": ".forma-best-worst__status",
          "values": "polite",
          "default": "—",
          "description": "Announces the application's status text when it changes."
        },
        {
          "name": "data-forma-state",
          "on": ".forma-best-worst__status",
          "values": "incomplete | invalid | complete (application-defined)",
          "default": "—",
          "description": "Application state marker for the status line. Forma currently applies no styling for it; the text carries the meaning."
        },
        {
          "name": "aria-describedby",
          "on": "fieldset",
          "values": "id list",
          "default": "—",
          "description": "Associates the rule or column explanation with the group."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-best-worst",
          "elements": [
            "forma-best-worst__header",
            "forma-best-worst__legend",
            "forma-best-worst__row",
            "forma-best-worst__status"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Visits the Best group, then the Worst group (each is one tab stop), in source order."
        },
        {
          "keys": "Arrow keys",
          "action": "Native radio behavior within the focused group: moves down or up the column and selects."
        },
        {
          "keys": "Space",
          "action": "Selects the focused radio when that group has no selection."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "conflict",
          "title": "Same item chosen as Best and Worst",
          "mobile": false,
          "raw": "components/best-worst/conflict.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "complete",
          "title": "Completed set with long item names",
          "mobile": false,
          "raw": "components/best-worst/complete.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-compact-columns",
          "title": "Best–Worst on a phone",
          "mobile": true,
          "raw": "components/best-worst/mobile-compact-columns.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "pairwise-choice",
        "ranking",
        "matrix-single"
      ]
    },
    {
      "slug": "binary-choice",
      "title": "Binary choice",
      "tag": "forma-binary-choice",
      "category": "assessment",
      "behavior": "Native HTML",
      "summary": "A two-option radio-backed answer that preserves Unanswered as distinct from false.",
      "docsUrl": "components/binary-choice/",
      "pattern": "patterns/binary-choice.html",
      "minimalHtml": "<forma-binary-choice class=\"forma-component-tag\">\n<fieldset class=\"forma-binary-choice\">\n  <legend class=\"forma-binary-choice__legend\">Is automated deployment currently in use?</legend>\n  <p class=\"forma-field__description\" id=\"binary-choice-help\">Choose one response. An unanswered question remains distinct from No.</p>\n\n  <div class=\"forma-binary-choice__options\" aria-describedby=\"binary-choice-help\">\n    <label class=\"forma-binary-option\">\n      <input type=\"radio\" name=\"automated-deployment\" value=\"yes\" required>\n      <span>Yes</span>\n    </label>\n    <label class=\"forma-binary-option\">\n      <input type=\"radio\" name=\"automated-deployment\" value=\"no\">\n      <span>No</span>\n    </label>\n  </div>\n</fieldset>\n</forma-binary-choice>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "radio",
          "default": "—",
          "description": "Required. Radios, not a checkbox, so Unanswered stays representable."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string shared by both options",
          "default": "—",
          "description": "Groups the options so only one can be checked. Must be unique per question on the page."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Submitted answer. The application maps it to meaning; Forma attaches none."
        },
        {
          "name": "required",
          "on": "first input",
          "values": "boolean",
          "default": "absent",
          "description": "Native required-group validation: the form cannot submit while the question is Unanswered."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Restores a previously saved answer. Leave both unchecked for Unanswered."
        },
        {
          "name": "disabled",
          "on": "fieldset or input",
          "values": "boolean",
          "default": "absent",
          "description": "Locks the answer; disabled radios are not focusable or submitted."
        },
        {
          "name": "aria-describedby",
          "on": "fieldset or input",
          "values": "id list",
          "default": "—",
          "description": "Associates help or error text with the question."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-binary-choice",
          "elements": [
            "forma-binary-choice__legend",
            "forma-binary-choice__options"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-binary-option",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus into the group (to the checked radio, or the first radio when Unanswered) and out of it."
        },
        {
          "keys": "Arrow keys",
          "action": "Native radio group behavior: moves between options and selects the one that receives focus."
        },
        {
          "keys": "Space",
          "action": "Selects the focused option when none is checked."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "true-false-with-unknown",
          "title": "True/false with a Don't know answer",
          "mobile": false,
          "raw": "components/binary-choice/true-false-with-unknown.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "answered-with-error-cleared",
          "title": "Answered No after a validation error",
          "mobile": false,
          "raw": "components/binary-choice/answered-with-error-cleared.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "locked-answer",
          "title": "Answer locked after sign-off",
          "mobile": false,
          "raw": "components/binary-choice/locked-answer.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-agree-disagree",
          "title": "Agree or disagree on a phone",
          "mobile": true,
          "raw": "components/binary-choice/mobile-agree-disagree.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "switch",
        "special-choice",
        "ordinal-scale",
        "pairwise-choice"
      ]
    },
    {
      "slug": "bounded-overflow",
      "title": "Bounded overflow",
      "tag": "forma-bounded-overflow",
      "category": "layout",
      "behavior": "Native CSS",
      "summary": "A contained scroll region for genuinely wide content so the page itself never scrolls horizontally.",
      "docsUrl": "components/bounded-overflow/",
      "pattern": "patterns/bounded-overflow.html",
      "minimalHtml": "<forma-bounded-overflow class=\"forma-component-tag\">\n<div class=\"forma-bounded-overflow\" role=\"region\" aria-label=\"Quarterly totals by region\" tabindex=\"0\">\n  <table>\n    <thead><tr><th scope=\"col\">Region</th><th scope=\"col\">Q1</th><th scope=\"col\">Q2</th><th scope=\"col\">Q3</th><th scope=\"col\">Q4</th><th scope=\"col\">Year</th></tr></thead>\n    <tbody>\n      <tr><th scope=\"row\">North America</th><td>1,204,000</td><td>1,318,500</td><td>1,402,250</td><td>1,511,000</td><td>5,435,750</td></tr>\n      <tr><th scope=\"row\">Europe</th><td>904,100</td><td>931,000</td><td>1,010,400</td><td>1,120,900</td><td>3,966,400</td></tr>\n    </tbody>\n  </table>\n</div>\n</forma-bounded-overflow>",
      "attributes": [
        {
          "name": "tabindex",
          "on": ".forma-bounded-overflow",
          "values": "0",
          "default": "—",
          "description": "Makes the scroll region focusable so keyboard users can scroll it. Required when the content has no focusable elements."
        },
        {
          "name": "role",
          "on": ".forma-bounded-overflow",
          "values": "region",
          "default": "—",
          "description": "Exposes the focusable scroll region as a named region, so focus lands on something with a role and name."
        },
        {
          "name": "aria-label",
          "on": ".forma-bounded-overflow",
          "values": "string",
          "default": "—",
          "description": "Names the region when there is no caption to reference."
        },
        {
          "name": "aria-labelledby",
          "on": ".forma-bounded-overflow",
          "values": "id of the table caption",
          "default": "—",
          "description": "Names the region from the table caption."
        },
        {
          "name": "style",
          "on": ".forma-bounded-overflow",
          "values": "max-block-size: <length>",
          "default": "—",
          "description": "Caps the height to make the region scroll vertically as well."
        },
        {
          "name": "scope",
          "on": "th",
          "values": "col | row",
          "default": "—",
          "description": "Associates header cells with their column or row so scrolled cells stay understandable."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-bounded-overflow",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus to the region (when tabindex=\"0\") and then into any focusable content."
        },
        {
          "keys": "Arrow keys",
          "action": "Scroll the focused region horizontally and vertically. Native browser behavior."
        },
        {
          "keys": "Page Up / Page Down, Home / End",
          "action": "Scroll the focused region by a page or to its start or end. Native browser behavior."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "wide-ledger",
          "title": "Wide ledger table",
          "mobile": false,
          "raw": "components/bounded-overflow/wide-ledger.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "bounded-log",
          "title": "Bounded deployment log",
          "mobile": false,
          "raw": "components/bounded-overflow/bounded-log.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-table-scroll",
          "title": "Mobile table scroll",
          "mobile": true,
          "raw": "components/bounded-overflow/mobile-table-scroll.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "dense-ledger",
        "comparison-grid",
        "data-grid",
        "code-sample"
      ]
    },
    {
      "slug": "button",
      "title": "Button",
      "tag": "forma-button",
      "category": "actions",
      "behavior": "Native HTML",
      "summary": "Native button (or a link styled as one) with a 44px minimum target and perceptual hover/press feedback; .forma-actions groups actions that wrap.",
      "docsUrl": "components/button/",
      "pattern": "patterns/button.html",
      "minimalHtml": "<forma-button class=\"forma-component-tag\">\n<div class=\"forma-actions\">\n  <button type=\"submit\">Save changes</button>\n  <button type=\"button\">Cancel</button>\n  <a class=\"forma-button\" href=\"#button-help\">Read the help article</a>\n</div>\n</forma-button>",
      "attributes": [
        {
          "name": "type",
          "on": "button",
          "values": "button | submit | reset",
          "default": "submit (inside a form)",
          "description": "Always write it. Omitting it inside a form makes the button submit the form."
        },
        {
          "name": "disabled",
          "on": "button",
          "values": "boolean",
          "default": "absent",
          "description": "Natively disables the button: not focusable, not activatable, not submitted. In the application layer it only removes hover and press feedback; inside `.forma-site` it also gets the dashed treatment."
        },
        {
          "name": "href",
          "on": "a.forma-button",
          "values": "URL",
          "default": "—",
          "description": "A link styled as a button. It keeps link semantics: Enter activates it, Space scrolls the page."
        },
        {
          "name": "aria-disabled",
          "on": "button or a.forma-button inside .forma-site",
          "values": "true",
          "default": "absent",
          "description": "Marks an unavailable action that must stay focusable (for example to expose its reason). It does not block activation; the application must ignore it."
        },
        {
          "name": "aria-busy",
          "on": "button or a.forma-button",
          "values": "true",
          "default": "absent",
          "description": "Marks an action whose work is in flight. Forma draws a busy ring before the label (static under reduced motion) and removes hover and press feedback. Pair it with `aria-disabled=\"true\"` and ignore repeated activation in the application; Forma cannot block a keyboard submission."
        },
        {
          "name": "aria-describedby",
          "on": "button",
          "values": "id",
          "default": "—",
          "description": "Links a visible explanation, such as why an aria-disabled action is unavailable."
        },
        {
          "name": "data-forma-variant",
          "on": "a.forma-button or button.forma-button inside .forma-site",
          "values": "primary",
          "default": "absent (outlined)",
          "description": "Marketing-only filled primary treatment. Has no effect outside a `.forma-site` shell."
        },
        {
          "name": "aria-hidden",
          "on": "decorative glyph span",
          "values": "true",
          "default": "—",
          "description": "Hides a decorative icon or glyph so the visually hidden text is the whole accessible name."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-button",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "aria-busy",
              "values": [
                "true"
              ]
            },
            {
              "name": "aria-disabled",
              "values": [
                "true"
              ]
            },
            {
              "name": "data-forma-variant",
              "values": [
                "primary"
              ]
            }
          ],
          "customProperties": []
        },
        {
          "root": "forma-actions",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus to and from the button. Natively disabled buttons are skipped; aria-disabled ones are not."
        },
        {
          "keys": "Enter",
          "action": "Activates a button or follows a button-styled link."
        },
        {
          "keys": "Space",
          "action": "Activates a `button` on key release. On a button-styled link Space scrolls the page, as for any link."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior",
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "unavailable-submit",
          "title": "Unavailable submit with a stated reason",
          "mobile": false,
          "raw": "components/button/unavailable-submit.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "pending-save",
          "title": "Save in progress",
          "mobile": false,
          "raw": "components/button/pending-save.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "icon-with-hidden-label",
          "title": "Icon button with a visually hidden label",
          "mobile": false,
          "raw": "components/button/icon-with-hidden-label.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "marketing-primary",
          "title": "Marketing call to action",
          "mobile": false,
          "raw": "components/button/marketing-primary.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile-wrapping-actions",
          "title": "Wrapping action row on a phone",
          "mobile": true,
          "raw": "components/button/mobile-wrapping-actions.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior",
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "command-group",
        "overflow-command-disclosure",
        "menu",
        "mobile-action-bar",
        "cta"
      ]
    },
    {
      "slug": "cta",
      "title": "Call to action",
      "tag": "forma-cta",
      "category": "site",
      "behavior": "Site content",
      "summary": "Closing call to action with one primary action, optionally on an inverse surface tone.",
      "docsUrl": "components/cta/",
      "pattern": "patterns/cta.html",
      "minimalHtml": "<forma-cta class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <section class=\"forma-section\" aria-labelledby=\"cta-title\">\n    <div class=\"forma-cta\" data-forma-tone=\"inverse\">\n      <div class=\"forma-cta__text\">\n        <p class=\"forma-eyebrow\">Start here</p>\n        <h2 id=\"cta-title\">Bring the problem that matters</h2>\n        <p>One primary action per call to action; secondary actions stay visibly lower in the hierarchy.</p>\n      </div>\n      <div class=\"forma-actions\"><a class=\"forma-button\" data-forma-variant=\"primary\" href=\"#contact\">Start a diagnostic</a><a class=\"forma-button\" href=\"#about\">Meet the team</a></div>\n    </div>\n  </section>\n</div>\n</forma-cta>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section",
          "values": "id of the CTA heading",
          "default": "—",
          "description": "Names the section that contains the CTA."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-cta",
          "elements": [
            "forma-cta__text"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-tone",
              "values": []
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through any links in the text, then the actions, in source order."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link; a `button` also activates with Space."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "page-tone",
          "title": "Page-tone closing action",
          "mobile": false,
          "raw": "components/cta/page-tone.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Install",
                "expect": {
                  "url": "#cta-page-tone-title"
                }
              },
              {
                "role": "link",
                "name": "Read the upgrade guide",
                "expect": {
                  "url": "#cta-page-tone-title"
                }
              }
            ]
          }
        },
        {
          "id": "surface-single-action",
          "title": "Surface panel with a single action",
          "mobile": false,
          "raw": "components/cta/surface-single-action.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Read past issues",
                "expect": {
                  "url": "#cta-surface-single-action-title"
                }
              },
              {
                "role": "link",
                "name": "Subscribe",
                "expect": {
                  "url": "#cta-surface-single-action-title"
                }
              }
            ]
          }
        },
        {
          "id": "mobile-inverse",
          "title": "Phone inverse CTA",
          "mobile": true,
          "raw": "components/cta/mobile-inverse.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Start a diagnostic",
                "expect": {
                  "url": "#cta-mobile-inverse-title"
                }
              },
              {
                "role": "link",
                "name": "Meet the team",
                "expect": {
                  "url": "#cta-mobile-inverse-title"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "hero",
        "button",
        "section"
      ]
    },
    {
      "slug": "callout",
      "title": "Callout",
      "tag": "forma-callout",
      "category": "site",
      "behavior": "Site content",
      "summary": "Labelled note, caution, evidence, or decision inside prose; a visible label and rule pattern carry the kind without relying on color.",
      "docsUrl": "components/callout/",
      "pattern": "patterns/callout.html",
      "minimalHtml": "<forma-callout class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <article class=\"forma-prose\">\n    <h2>Callouts mark supporting material, not ordinary emphasis</h2>\n    <p>Most prose needs no callout. Use one only when a reader must notice a note, a caution, cited evidence, or a recorded decision.</p>\n    <aside class=\"forma-callout\" data-forma-callout=\"note\" aria-labelledby=\"callout-note\">\n      <p class=\"forma-callout__label\" id=\"callout-note\">Note</p>\n      <p>Supporting context that a reader can skip without losing the argument.</p>\n    </aside>\n    <aside class=\"forma-callout\" data-forma-callout=\"caution\" aria-labelledby=\"callout-caution\">\n      <p class=\"forma-callout__label\" id=\"callout-caution\">Caution</p>\n      <p>A consequence the reader must weigh before acting on the surrounding text.</p>\n    </aside>\n    <figure class=\"forma-callout\" data-forma-callout=\"evidence\" aria-labelledby=\"callout-evidence\">\n      <p class=\"forma-callout__label\" id=\"callout-evidence\">Evidence</p>\n      <blockquote><p>Quoted or cited source material stays a quotation in the document outline.</p></blockquote>\n      <figcaption>Source: the measurement it came from</figcaption>\n    </figure>\n    <aside class=\"forma-callout\" data-forma-callout=\"decision\" aria-labelledby=\"callout-decision\">\n      <p class=\"forma-callout__label\" id=\"callout-decision\">Decision</p>\n      <p>The outcome that was settled, stated once so later sections can refer to it.</p>\n    </aside>\n  </article>\n</div>\n</forma-callout>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": ".forma-callout",
          "values": "id of .forma-callout__label",
          "default": "—",
          "description": "Required. Names the aside or figure by its visible label, so it is announced as, for example, a \"Caution\" complementary region."
        },
        {
          "name": "id",
          "on": ".forma-callout__label",
          "values": "string",
          "default": "—",
          "description": "Referenced by the callout's aria-labelledby."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-callout",
          "elements": [
            "forma-callout__label"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-callout",
              "values": [
                "caution",
                "decision",
                "evidence"
              ]
            }
          ],
          "customProperties": [
            {
              "name": "--forma-callout-rule",
              "default": "var(--forma-tone-rule-strong)"
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "—",
          "action": "Not interactive. Links inside follow native link behavior."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "caution-before-upgrade",
          "title": "Caution before an upgrade step",
          "mobile": false,
          "raw": "components/callout/caution-before-upgrade.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "evidence-and-decision",
          "title": "Evidence followed by a decision",
          "mobile": false,
          "raw": "components/callout/evidence-and-decision.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-note",
          "title": "Phone note in an article",
          "mobile": true,
          "raw": "components/callout/mobile-note.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "prose",
        "alert",
        "cta"
      ]
    },
    {
      "slug": "card-grid",
      "title": "Card grid",
      "tag": "forma-card-grid",
      "category": "site",
      "behavior": "Site content",
      "summary": "Ruled grid of cards with a column cap and content-driven column dropping; card links stretch without making the whole card the accessible name.",
      "docsUrl": "components/card-grid/",
      "pattern": "patterns/card-grid.html",
      "minimalHtml": "<forma-card-grid class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <ul class=\"forma-card-grid\" data-forma-columns=\"3\" aria-label=\"Capabilities\">\n    <li>\n      <article class=\"forma-card\">\n        <p class=\"forma-eyebrow\">Diagnose</p>\n        <h3 class=\"forma-card__title\"><a class=\"forma-card__link\" href=\"#diagnose\">Prove what is wrong before changing it</a></h3>\n        <p>Observations stay separate from explanations until evidence removes the alternatives.</p>\n        <p class=\"forma-card__footer\">Outcome: a defensible root cause</p>\n      </article>\n    </li>\n    <li>\n      <article class=\"forma-card\">\n        <p class=\"forma-eyebrow\">Constrain</p>\n        <h3 class=\"forma-card__title\">Make valid work explicit</h3>\n        <p>Domain state and legal transitions are modeled instead of implied.</p>\n      </article>\n    </li>\n    <li>\n      <article class=\"forma-card\" data-forma-tone=\"inverse\">\n        <h3 class=\"forma-card__title\">Verify what people receive</h3>\n        <p>Accessibility, responsiveness, and meaning are checked as executable contracts.</p>\n      </article>\n    </li>\n  </ul>\n</div>\n</forma-card-grid>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "ul.forma-card-grid",
          "values": "string",
          "default": "—",
          "description": "Names the list when no visible heading introduces it."
        },
        {
          "name": "href",
          "on": "a.forma-card__link",
          "values": "URL",
          "default": "—",
          "description": "Destination of the card. Use at most one card link per card."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-card-grid",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-columns",
              "values": [
                "2",
                "3",
                "4",
                "5"
              ]
            }
          ],
          "customProperties": []
        },
        {
          "root": "forma-card",
          "elements": [
            "forma-card__footer",
            "forma-card__link",
            "forma-card__title"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-tone",
              "values": [
                "elevated"
              ]
            }
          ],
          "customProperties": [
            {
              "name": "--forma-card-rule",
              "default": "var(--forma-tone-rule)"
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between card links; unlinked cards are not focusable."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused card link (native link behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "linked-services",
          "title": "Two-column linked services",
          "mobile": false,
          "raw": "components/card-grid/linked-services.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Find the cause of a recurring failure",
                "expect": {
                  "url": "#card-grid-linked-services-diagnostic"
                }
              },
              {
                "role": "link",
                "name": "Model the rules your system must keep",
                "expect": {
                  "url": "#card-grid-linked-services-architecture"
                }
              }
            ]
          }
        },
        {
          "id": "product-family",
          "title": "Five-column product family",
          "mobile": false,
          "raw": "components/card-grid/product-family.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-single-column",
          "title": "Phone single column",
          "mobile": true,
          "raw": "components/card-grid/mobile-single-column.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Prove what is wrong before changing it",
                "expect": {
                  "url": "#card-grid-mobile-single-column-verify"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "facts",
        "entry-index",
        "metric-card",
        "surface"
      ]
    },
    {
      "slug": "character-grid",
      "title": "Character grid",
      "tag": "forma-character-grid",
      "category": "keyboard",
      "behavior": "Application / Limen",
      "summary": "Fixed rows-by-columns grid of equal-width cells where every run declares its cell coordinates and source order is row-major order; contained horizontal scroll by default.",
      "docsUrl": "components/character-grid/",
      "pattern": "patterns/character-grid.html",
      "minimalHtml": "<forma-character-grid class=\"forma-component-tag\">\n<div class=\"forma-character-grid\" data-forma-rows=\"8\" data-forma-columns=\"40\" data-forma-narrow=\"contained\">\n  <div class=\"forma-character-grid__viewport\" role=\"region\" aria-labelledby=\"character-grid-title\" tabindex=\"0\">\n    <div class=\"forma-character-grid__surface\">\n      <h2 class=\"forma-character-grid__text\" id=\"character-grid-title\" data-forma-row=\"1\" data-forma-col=\"13\" data-forma-len=\"15\" data-forma-emphasis=\"intensified\">SYSTEM OVERVIEW</h2>\n      <p class=\"forma-character-grid__text\" data-forma-row=\"3\" data-forma-col=\"2\" data-forma-len=\"37\">Positioned protected text, row-major.</p>\n      <dl class=\"forma-character-grid__group\">\n        <dt class=\"forma-character-grid__text\" data-forma-row=\"5\" data-forma-col=\"2\" data-forma-len=\"11\">Region  . :</dt>\n        <dd class=\"forma-character-grid__value\" data-forma-row=\"5\" data-forma-col=\"14\" data-forma-len=\"10\">NORTH-EAST</dd>\n        <dt class=\"forma-character-grid__text\" data-forma-row=\"6\" data-forma-col=\"2\" data-forma-len=\"11\">Nodes . . :</dt>\n        <dd class=\"forma-character-grid__value\" data-forma-row=\"6\" data-forma-col=\"14\" data-forma-len=\"4\" data-forma-align=\"end\">12</dd>\n        <dt class=\"forma-character-grid__text\" data-forma-row=\"7\" data-forma-col=\"2\" data-forma-len=\"11\">Updated . :</dt>\n        <dd class=\"forma-character-grid__value\" data-forma-row=\"7\" data-forma-col=\"14\" data-forma-len=\"10\">2026-09-27</dd>\n      </dl>\n    </div>\n  </div>\n</div>\n</forma-character-grid>",
      "attributes": [
        {
          "name": "role",
          "on": ".forma-character-grid__viewport",
          "values": "region",
          "default": "—",
          "description": "Required. Makes the contained scroller a named landmark region."
        },
        {
          "name": "aria-labelledby",
          "on": ".forma-character-grid__viewport",
          "values": "id of the screen title run",
          "default": "—",
          "description": "Required. Names the region after the screen title so each screen is identifiable."
        },
        {
          "name": "tabindex",
          "on": ".forma-character-grid__viewport",
          "values": "0",
          "default": "—",
          "description": "Required. Lets keyboard users focus and scroll the contained region. Positive values are prohibited everywhere in the grid (CG-11)."
        },
        {
          "name": "scope",
          "on": "th in a table run",
          "values": "col | row",
          "default": "—",
          "description": "Native table header scope. Row headers read as data (no underline)."
        },
        {
          "name": "aria-label",
          "on": ".forma-character-grid__group",
          "values": "string",
          "default": "—",
          "description": "Names a semantic group such as a `dl` or `role=\"group\"` when it has no visible heading."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-character-grid",
          "elements": [
            "forma-character-grid__field",
            "forma-character-grid__group",
            "forma-character-grid__indicator",
            "forma-character-grid__key",
            "forma-character-grid__label",
            "forma-character-grid__leader",
            "forma-character-grid__message",
            "forma-character-grid__severity",
            "forma-character-grid__status",
            "forma-character-grid__surface",
            "forma-character-grid__table",
            "forma-character-grid__text",
            "forma-character-grid__value",
            "forma-character-grid__viewport"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "aria-invalid",
              "values": [
                "true"
              ]
            },
            {
              "name": "data-forma-align",
              "values": [
                "end"
              ]
            },
            {
              "name": "data-forma-columns",
              "values": [
                "1",
                "10",
                "100",
                "101",
                "102",
                "103",
                "104",
                "105",
                "106",
                "107",
                "108",
                "109",
                "11",
                "110",
                "111",
                "112",
                "113",
                "114",
                "115",
                "116",
                "117",
                "118",
                "119",
                "12",
                "120",
                "121",
                "122",
                "123",
                "124",
                "125",
                "126",
                "127",
                "128",
                "129",
                "13",
                "130",
                "131",
                "132",
                "14",
                "15",
                "16",
                "17",
                "18",
                "19",
                "2",
                "20",
                "21",
                "22",
                "23",
                "24",
                "25",
                "26",
                "27",
                "28",
                "29",
                "3",
                "30",
                "31",
                "32",
                "33",
                "34",
                "35",
                "36",
                "37",
                "38",
                "39",
                "4",
                "40",
                "41",
                "42",
                "43",
                "44",
                "45",
                "46",
                "47",
                "48",
                "49",
                "5",
                "50",
                "51",
                "52",
                "53",
                "54",
                "55",
                "56",
                "57",
                "58",
                "59",
                "6",
                "60",
                "61",
                "62",
                "63",
                "64",
                "65",
                "66",
                "67",
                "68",
                "69",
                "7",
                "70",
                "71",
                "72",
                "73",
                "74",
                "75",
                "76",
                "77",
                "78",
                "79",
                "8",
                "80",
                "81",
                "82",
                "83",
                "84",
                "85",
                "86",
                "87",
                "88",
                "89",
                "9",
                "90",
                "91",
                "92",
                "93",
                "94",
                "95",
                "96",
                "97",
                "98",
                "99"
              ]
            },
            {
              "name": "data-forma-emphasis",
              "values": [
                "intensified",
                "muted"
              ]
            },
            {
              "name": "data-forma-narrow",
              "values": [
                "reflow"
              ]
            },
            {
              "name": "data-forma-profile",
              "values": [
                "ibm-3270"
              ]
            },
            {
              "name": "data-forma-reveal",
              "values": [
                "sequential"
              ]
            },
            {
              "name": "data-forma-reveal-rows",
              "values": [
                "1",
                "10",
                "11",
                "12",
                "13",
                "14",
                "15",
                "16",
                "17",
                "18",
                "19",
                "2",
                "20",
                "21",
                "22",
                "23",
                "24",
                "25",
                "26",
                "27",
                "28",
                "29",
                "3",
                "30",
                "31",
                "32",
                "33",
                "34",
                "35",
                "36",
                "37",
                "38",
                "39",
                "4",
                "40",
                "41",
                "42",
                "43",
                "44",
                "45",
                "46",
                "47",
                "48",
                "49",
                "5",
                "50",
                "6",
                "7",
                "8",
                "9"
              ]
            },
            {
              "name": "data-forma-reveal-run",
              "values": []
            },
            {
              "name": "data-forma-rows",
              "values": [
                "1",
                "10",
                "11",
                "12",
                "13",
                "14",
                "15",
                "16",
                "17",
                "18",
                "19",
                "2",
                "20",
                "21",
                "22",
                "23",
                "24",
                "25",
                "26",
                "27",
                "28",
                "29",
                "3",
                "30",
                "31",
                "32",
                "33",
                "34",
                "35",
                "36",
                "37",
                "38",
                "39",
                "4",
                "40",
                "41",
                "42",
                "43",
                "44",
                "45",
                "46",
                "47",
                "48",
                "49",
                "5",
                "50",
                "6",
                "7",
                "8",
                "9"
              ]
            },
            {
              "name": "data-forma-severity",
              "values": [
                "error",
                "success",
                "validation",
                "warning"
              ]
            },
            {
              "name": "data-forma-state",
              "values": [
                "inhibited",
                "missing"
              ]
            },
            {
              "name": "data-forma-status-rows",
              "values": [
                "1",
                "2"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves to the viewport, then through fields and keys in source order, which is row-major order. Tab can always leave the grid."
        },
        {
          "keys": "Arrow keys",
          "action": "Scroll the contained viewport while it has focus (native scrolling of a focusable overflow region)."
        },
        {
          "keys": "F1-F24, Escape, Pause and other function keys",
          "action": "No built-in behavior. The application or Limen maps physical keys to the presented key buttons."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "print-queue",
          "title": "Print queue with repeated rows",
          "mobile": false,
          "raw": "components/character-grid/print-queue.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "supplier-profile",
          "title": "Missing data and grouped values",
          "mobile": false,
          "raw": "components/character-grid/supplier-profile.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "build-summary",
          "title": "Reflow for a modern tool",
          "mobile": false,
          "raw": "components/character-grid/build-summary.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "node-list-mobile",
          "title": "Contained node list on a phone",
          "mobile": true,
          "raw": "components/character-grid/node-list-mobile.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "character-grid-field",
        "character-grid-keys",
        "character-grid-status",
        "character-grid-3270",
        "data-grid"
      ]
    },
    {
      "slug": "character-grid-3270",
      "title": "Character grid 3270 profile",
      "tag": "forma-character-grid-3270",
      "category": "keyboard",
      "behavior": "Application / Limen",
      "summary": "IBM 3270-inspired reference profile built only from public CharacterGrid contracts: a 24x80 operations menu with 3279-style palette tokens and block caret, verified at 32x80.",
      "docsUrl": "components/character-grid-3270/",
      "pattern": "patterns/character-grid-3270.html",
      "minimalHtml": "<forma-character-grid-3270 class=\"forma-component-tag\">\n<div class=\"forma-character-grid\" data-forma-profile=\"ibm-3270\" data-forma-rows=\"24\" data-forma-status-rows=\"1\" data-forma-columns=\"80\" data-forma-narrow=\"contained\">\n  <div class=\"forma-character-grid__viewport\" role=\"region\" aria-labelledby=\"character-grid-3270-title\" tabindex=\"0\">\n    <form class=\"forma-character-grid__surface\">\n      <span class=\"forma-character-grid__text\" data-forma-row=\"1\" data-forma-col=\"2\" data-forma-len=\"4\">OPSM</span>\n      <h2 class=\"forma-character-grid__text\" id=\"character-grid-3270-title\" data-forma-row=\"1\" data-forma-col=\"33\" data-forma-len=\"15\" data-forma-emphasis=\"intensified\">OPERATIONS MENU</h2>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"1\" data-forma-col=\"64\" data-forma-len=\"5\">Date:</span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"1\" data-forma-col=\"70\" data-forma-len=\"10\">2026-09-27</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"2\" data-forma-col=\"2\" data-forma-len=\"7\">System:</span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"2\" data-forma-col=\"10\" data-forma-len=\"8\">ECHT01</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"2\" data-forma-col=\"60\" data-forma-len=\"9\">Operator:</span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"2\" data-forma-col=\"70\" data-forma-len=\"8\">OP0142</span>\n      <p class=\"forma-character-grid__text\" data-forma-row=\"4\" data-forma-col=\"2\" data-forma-len=\"33\">Select an option and press Enter.</p>\n      <dl class=\"forma-character-grid__group\" aria-label=\"Options\">\n        <dt class=\"forma-character-grid__value\" data-forma-row=\"6\" data-forma-col=\"6\" data-forma-len=\"1\">1</dt>\n        <dd class=\"forma-character-grid__text\" data-forma-row=\"6\" data-forma-col=\"10\" data-forma-len=\"16\">Customer inquiry</dd>\n        <dt class=\"forma-character-grid__value\" data-forma-row=\"7\" data-forma-col=\"6\" data-forma-len=\"1\">2</dt>\n        <dd class=\"forma-character-grid__text\" data-forma-row=\"7\" data-forma-col=\"10\" data-forma-len=\"19\">Account maintenance</dd>\n        <dt class=\"forma-character-grid__value\" data-forma-row=\"8\" data-forma-col=\"6\" data-forma-len=\"1\">3</dt>\n        <dd class=\"forma-character-grid__text\" data-forma-row=\"8\" data-forma-col=\"10\" data-forma-len=\"19\">Transaction history</dd>\n        <dt class=\"forma-character-grid__value\" data-forma-row=\"9\" data-forma-col=\"6\" data-forma-len=\"1\">4</dt>\n        <dd class=\"forma-character-grid__text\" data-forma-row=\"9\" data-forma-col=\"10\" data-forma-len=\"7\">Reports</dd>\n        <dt class=\"forma-character-grid__value\" data-forma-row=\"10\" data-forma-col=\"6\" data-forma-len=\"1\">X</dt>\n        <dd class=\"forma-character-grid__text\" data-forma-row=\"10\" data-forma-col=\"10\" data-forma-len=\"4\">Exit</dd>\n      </dl>\n      <label class=\"forma-character-grid__label\" for=\"character-grid-3270-option\" data-forma-row=\"13\" data-forma-col=\"2\" data-forma-len=\"11\">Option<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> ===&gt;</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-3270-option\" name=\"option\" type=\"text\" maxlength=\"2\" required aria-describedby=\"character-grid-3270-option-hint\" autocomplete=\"off\" data-forma-row=\"13\" data-forma-col=\"15\" data-forma-len=\"2\">\n      <span class=\"forma-character-grid__text\" id=\"character-grid-3270-option-hint\" data-forma-row=\"13\" data-forma-col=\"20\" data-forma-len=\"18\" data-forma-emphasis=\"muted\">(1-4 or X to exit)</span>\n      <p class=\"forma-character-grid__message\" role=\"status\" data-forma-severity=\"information\" data-forma-row=\"21\" data-forma-col=\"2\" data-forma-len=\"78\"><span class=\"forma-character-grid__severity\"><span>INFO</span></span> OPSM000I Session started 2026-09-27 08:15.</p>\n      <div class=\"forma-character-grid__group\" role=\"group\" aria-label=\"Function keys\">\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"enter\" data-forma-action=\"enter\" data-forma-row=\"22\" data-forma-col=\"2\" data-forma-len=\"12\"><kbd>Enter</kbd>=Select</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf1\" formnovalidate data-forma-action=\"pf1\" data-forma-row=\"22\" data-forma-col=\"16\" data-forma-len=\"8\"><kbd>PF1</kbd>=Help</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf3\" formnovalidate data-forma-action=\"pf3\" data-forma-row=\"22\" data-forma-col=\"26\" data-forma-len=\"8\"><kbd>PF3</kbd>=Exit</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf12\" formnovalidate data-forma-action=\"pf12\" data-forma-row=\"22\" data-forma-col=\"36\" data-forma-len=\"11\"><kbd>PF12</kbd>=Cancel</button>\n        <button class=\"forma-character-grid__key\" type=\"button\" data-forma-action=\"reset\" data-forma-row=\"23\" data-forma-col=\"2\" data-forma-len=\"12\"><kbd>Reset</kbd>=Unlock</button>\n      </div>\n      <p class=\"forma-character-grid__status\" role=\"status\" data-forma-row=\"25\" data-forma-col=\"2\" data-forma-len=\"78\"><span class=\"forma-character-grid__indicator\"><span>READY</span></span></p>\n    </form>\n  </div>\n</div>\n</forma-character-grid-3270>",
      "attributes": [],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Native, in row-major order. The profile does not add 3270 wraparound Tab or autoskip; those are optional application behavior."
        },
        {
          "keys": "PF1-PF24, PA1-PA3, Clear, Reset",
          "action": "Presented as key buttons; mapping physical keys to them is application or Limen behavior."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior",
          "form-handling"
        ]
      },
      "examples": [
        {
          "id": "host-error",
          "title": "Host error with input inhibited",
          "mobile": false,
          "raw": "components/character-grid-3270/host-error.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "field-states",
          "title": "Field states in the 3279 palette",
          "mobile": false,
          "raw": "components/character-grid-3270/field-states.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "without-profile",
          "title": "Same screen without the profile",
          "mobile": false,
          "raw": "components/character-grid-3270/without-profile.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "menu-mobile",
          "title": "3270 menu on a phone",
          "mobile": true,
          "raw": "components/character-grid-3270/menu-mobile.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        }
      ],
      "related": [
        "character-grid",
        "character-grid-workflow",
        "character-grid-status"
      ]
    },
    {
      "slug": "character-grid-field",
      "title": "Character grid field",
      "tag": "forma-character-grid-field",
      "category": "keyboard",
      "behavior": "Native HTML",
      "summary": "Protected text and native editable fields placed on a character grid with explicit capacity, preceding labels, and shape-based required, invalid, disabled, and read-only cues.",
      "docsUrl": "components/character-grid-field/",
      "pattern": "patterns/character-grid-field.html",
      "minimalHtml": "<forma-character-grid-field class=\"forma-component-tag\">\n<div class=\"forma-character-grid\" data-forma-rows=\"10\" data-forma-columns=\"60\" data-forma-narrow=\"contained\">\n  <div class=\"forma-character-grid__viewport\" role=\"region\" aria-labelledby=\"character-grid-field-title\" tabindex=\"0\">\n    <form class=\"forma-character-grid__surface\">\n      <h2 class=\"forma-character-grid__text\" id=\"character-grid-field-title\" data-forma-row=\"1\" data-forma-col=\"23\" data-forma-len=\"14\" data-forma-emphasis=\"intensified\">PAYMENT ENTRY</h2>\n      <label class=\"forma-character-grid__label\" for=\"character-grid-field-account\" data-forma-row=\"3\" data-forma-col=\"2\" data-forma-len=\"16\">Account<span class=\"forma-character-grid__leader\" aria-hidden=\"true\">  . . . :</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-field-account\" name=\"account\" type=\"text\" inputmode=\"numeric\" pattern=\"[0-9]*\" maxlength=\"12\" required aria-describedby=\"character-grid-field-account-hint\" autocomplete=\"off\" data-forma-row=\"3\" data-forma-col=\"20\" data-forma-len=\"12\">\n      <span class=\"forma-character-grid__text\" id=\"character-grid-field-account-hint\" data-forma-row=\"3\" data-forma-col=\"34\" data-forma-len=\"21\" data-forma-emphasis=\"muted\">(required, 12 digits)</span>\n      <label class=\"forma-character-grid__label\" for=\"character-grid-field-reference\" data-forma-row=\"4\" data-forma-col=\"2\" data-forma-len=\"16\">Reference<span class=\"forma-character-grid__leader\" aria-hidden=\"true\">  . . :</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-field-reference\" name=\"reference\" type=\"text\" maxlength=\"20\" value=\"INV-1042\" autocomplete=\"off\" data-forma-row=\"4\" data-forma-col=\"20\" data-forma-len=\"20\">\n      <label class=\"forma-character-grid__label\" for=\"character-grid-field-amount\" data-forma-row=\"5\" data-forma-col=\"2\" data-forma-len=\"16\">Amount<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . . . :</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-field-amount\" name=\"amount\" type=\"text\" inputmode=\"decimal\" maxlength=\"12\" value=\"12,48O.55\" aria-invalid=\"true\" aria-describedby=\"character-grid-field-error\" autocomplete=\"off\" data-forma-row=\"5\" data-forma-col=\"20\" data-forma-len=\"12\">\n      <label class=\"forma-character-grid__label\" for=\"character-grid-field-branch\" data-forma-row=\"6\" data-forma-col=\"2\" data-forma-len=\"16\">Branch<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . . . :</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-field-branch\" name=\"branch\" type=\"text\" maxlength=\"8\" value=\"NORTH\" disabled data-forma-row=\"6\" data-forma-col=\"20\" data-forma-len=\"8\">\n      <span class=\"forma-character-grid__text\" data-forma-row=\"7\" data-forma-col=\"2\" data-forma-len=\"16\">Opened<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . . . :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"7\" data-forma-col=\"20\" data-forma-len=\"10\">2014-03-11</span>\n      <label class=\"forma-character-grid__label\" for=\"character-grid-field-session\" data-forma-row=\"8\" data-forma-col=\"2\" data-forma-len=\"16\">Session<span class=\"forma-character-grid__leader\" aria-hidden=\"true\">  . . . :</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-field-session\" name=\"session\" type=\"text\" maxlength=\"16\" value=\"S-20260927-01\" readonly data-forma-row=\"8\" data-forma-col=\"20\" data-forma-len=\"16\">\n      <p class=\"forma-character-grid__text\" id=\"character-grid-field-error\" data-forma-row=\"10\" data-forma-col=\"2\" data-forma-len=\"54\">Error: Amount must contain digits only, e.g. 12480.55</p>\n    </form>\n  </div>\n</div>\n</forma-character-grid-field>",
      "attributes": [
        {
          "name": "for",
          "on": "label.forma-character-grid__label",
          "values": "id of the field",
          "default": "—",
          "description": "Required (CG-8). The label run must precede its field in source order."
        },
        {
          "name": "type",
          "on": "input",
          "values": "text | password",
          "default": "text",
          "description": "Native input type. Keep `password` for secrets so the browser masks and protects the value."
        },
        {
          "name": "maxlength",
          "on": "input",
          "values": "integer",
          "default": "—",
          "description": "Required. Must equal `data-forma-len`, so visible capacity and real capacity agree (CG-8)."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Form field name submitted with the screen."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "empty",
          "description": "Initial value rendered by the application."
        },
        {
          "name": "required",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Native requirement; draws a double underline. Also say \"required\" in the label or hint."
        },
        {
          "name": "aria-invalid",
          "on": "input",
          "values": "true",
          "default": "absent",
          "description": "Set by the application after validation; draws dashed rules above and below. The field must also reference its message."
        },
        {
          "name": "aria-describedby",
          "on": "input",
          "values": "one or more ids",
          "default": "—",
          "description": "Hint and, when invalid, the message ID: `aria-describedby=\"hint message\"`."
        },
        {
          "name": "disabled",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Removes the field from Tab order and submission; dotted underline and muted text."
        },
        {
          "name": "readonly",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Only for genuine read-only form values the application reads back; thin underline, no surface. Otherwise use protected text."
        },
        {
          "name": "inputmode",
          "on": "input",
          "values": "numeric | decimal | …",
          "default": "—",
          "description": "Chooses the on-screen keyboard without changing validation."
        },
        {
          "name": "pattern",
          "on": "input",
          "values": "regular expression",
          "default": "—",
          "description": "Optional native constraint. Forma does not style `:invalid`; the application reports errors."
        },
        {
          "name": "autocomplete",
          "on": "input",
          "values": "token",
          "default": "—",
          "description": "Use real tokens (`username`, `current-password`) or `off` for host codes."
        }
      ],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between fields in row-major order, skipping disabled fields natively."
        },
        {
          "keys": "Typing",
          "action": "Native text entry, stopped at `maxlength`."
        },
        {
          "keys": "Enter",
          "action": "Native implicit submission through the form's first submit button (the Enter key in [[character-grid-keys]])."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "sign-on",
          "title": "Sign-on with required fields",
          "mobile": false,
          "raw": "components/character-grid-field/sign-on.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "address-validation",
          "title": "Validation error after Enter",
          "mobile": false,
          "raw": "components/character-grid-field/address-validation.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "short-codes",
          "title": "Short codes and touch spacing",
          "mobile": false,
          "raw": "components/character-grid-field/short-codes.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "payment-mobile",
          "title": "Payment entry on a phone",
          "mobile": true,
          "raw": "components/character-grid-field/payment-mobile.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        }
      ],
      "related": [
        "character-grid",
        "character-grid-selection",
        "character-grid-status",
        "text-field"
      ]
    },
    {
      "slug": "character-grid-keys",
      "title": "Character grid keys",
      "tag": "forma-character-grid-keys",
      "category": "keyboard",
      "behavior": "Application / Limen",
      "summary": "Enter, Clear, Reset, PF1-PF24, and named action affordances as native buttons with visible key names; the application owns what each key does.",
      "docsUrl": "components/character-grid-keys/",
      "pattern": "patterns/character-grid-keys.html",
      "minimalHtml": "<forma-character-grid-keys class=\"forma-component-tag\">\n<div class=\"forma-character-grid\" data-forma-rows=\"6\" data-forma-columns=\"80\" data-forma-narrow=\"contained\">\n  <div class=\"forma-character-grid__viewport\" role=\"region\" aria-labelledby=\"character-grid-keys-title\" tabindex=\"0\">\n    <form class=\"forma-character-grid__surface\">\n      <h2 class=\"forma-character-grid__text\" id=\"character-grid-keys-title\" data-forma-row=\"1\" data-forma-col=\"33\" data-forma-len=\"14\" data-forma-emphasis=\"intensified\">RECORD LOOKUP</h2>\n      <label class=\"forma-character-grid__label\" for=\"character-grid-keys-record\" data-forma-row=\"2\" data-forma-col=\"2\" data-forma-len=\"16\">Record<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . . . :</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-keys-record\" name=\"record\" type=\"text\" maxlength=\"10\" required autocomplete=\"off\" data-forma-row=\"2\" data-forma-col=\"20\" data-forma-len=\"10\">\n      <div class=\"forma-character-grid__group\" role=\"group\" aria-label=\"Function keys\">\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"enter\" data-forma-action=\"enter\" data-forma-row=\"5\" data-forma-col=\"2\" data-forma-len=\"12\"><kbd>Enter</kbd>=Search</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"clear\" formnovalidate data-forma-action=\"clear\" data-forma-row=\"5\" data-forma-col=\"16\" data-forma-len=\"11\"><kbd>Clear</kbd>=Erase</button>\n        <button class=\"forma-character-grid__key\" type=\"button\" data-forma-action=\"reset\" data-forma-row=\"5\" data-forma-col=\"29\" data-forma-len=\"12\"><kbd>Reset</kbd>=Unlock</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf1\" formnovalidate data-forma-action=\"pf1\" data-forma-row=\"5\" data-forma-col=\"43\" data-forma-len=\"8\"><kbd>PF1</kbd>=Help</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf3\" formnovalidate data-forma-action=\"pf3\" data-forma-row=\"5\" data-forma-col=\"53\" data-forma-len=\"8\"><kbd>PF3</kbd>=Exit</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf12\" formnovalidate data-forma-action=\"pf12\" data-forma-row=\"5\" data-forma-col=\"63\" data-forma-len=\"11\"><kbd>PF12</kbd>=Cancel</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf7\" formnovalidate data-forma-action=\"pf7\" disabled data-forma-row=\"6\" data-forma-col=\"2\" data-forma-len=\"8\"><kbd>PF7</kbd>=Back</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf8\" formnovalidate data-forma-action=\"pf8\" data-forma-row=\"6\" data-forma-col=\"12\" data-forma-len=\"11\"><kbd>PF8</kbd>=Forward</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"export\" data-forma-action=\"export\" data-forma-row=\"6\" data-forma-col=\"25\" data-forma-len=\"15\"><kbd>F10</kbd>=Export CSV</button>\n      </div>\n    </form>\n  </div>\n</div>\n</forma-character-grid-keys>",
      "attributes": [
        {
          "name": "type",
          "on": "button.forma-character-grid__key",
          "values": "submit | button",
          "default": "—",
          "description": "Required (CG-14). `submit` for Enter, Clear, PF, PA and named actions; `button` for Reset. Never `reset`."
        },
        {
          "name": "name",
          "on": "submit keys",
          "values": "string, e.g. action",
          "default": "—",
          "description": "Submitted with `value` so the application can read the key from the form data as well as from the submitter."
        },
        {
          "name": "value",
          "on": "submit keys",
          "values": "enter | clear | pf3 | …",
          "default": "—",
          "description": "The action submitted by this key."
        },
        {
          "name": "formnovalidate",
          "on": "submit keys",
          "values": "boolean",
          "default": "absent",
          "description": "Lets Exit, Cancel, Help, paging and Clear submit while native validation would block Enter."
        },
        {
          "name": "disabled",
          "on": "button",
          "values": "boolean",
          "default": "absent",
          "description": "Unavailable key: skipped by Tab, struck through and muted. Prefer omitting keys that are never available."
        },
        {
          "name": "aria-label",
          "on": ".forma-character-grid__group",
          "values": "e.g. Function keys",
          "default": "—",
          "description": "Names the group of keys."
        }
      ],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through enabled keys in row-major order after the fields above them."
        },
        {
          "keys": "Enter / Space on a focused key",
          "action": "Activates the button natively."
        },
        {
          "keys": "Enter in a field",
          "action": "Native implicit submission through the first submit key, which must be the Enter key."
        },
        {
          "keys": "F1-F24, Escape, Pause",
          "action": "No built-in behavior. The application or Limen may map them to the presented buttons, calling the same activation path, and may then add `aria-keyshortcuts`."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior",
          "form-handling"
        ]
      },
      "examples": [
        {
          "id": "work-with-f-keys",
          "title": "5250-style F-key bar",
          "mobile": false,
          "raw": "components/character-grid-keys/work-with-f-keys.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "input-inhibited",
          "title": "Input inhibited while waiting",
          "mobile": false,
          "raw": "components/character-grid-keys/input-inhibited.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "named-actions",
          "title": "Modern named actions",
          "mobile": false,
          "raw": "components/character-grid-keys/named-actions.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "key-bar-mobile",
          "title": "Key bar on a phone",
          "mobile": true,
          "raw": "components/character-grid-keys/key-bar-mobile.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        }
      ],
      "related": [
        "character-grid",
        "character-grid-status",
        "command-group",
        "command-palette"
      ]
    },
    {
      "slug": "character-grid-reveal",
      "title": "Character grid reveal",
      "tag": "forma-character-grid-reveal",
      "category": "keyboard",
      "behavior": "Application / Limen",
      "summary": "Optional SequentialReveal presentation: a row-major clip mask over protected text already in the DOM, static by default and under reduced motion; orchestration stays in the application.",
      "docsUrl": "components/character-grid-reveal/",
      "pattern": "patterns/character-grid-reveal.html",
      "minimalHtml": "<forma-character-grid-reveal class=\"forma-component-tag\">\n<div class=\"forma-character-grid\" data-forma-rows=\"8\" data-forma-columns=\"60\" data-forma-narrow=\"contained\" data-forma-reveal=\"sequential\" data-forma-reveal-rows=\"3\">\n  <div class=\"forma-character-grid__viewport\" role=\"region\" aria-labelledby=\"character-grid-reveal-title\" tabindex=\"0\">\n    <form class=\"forma-character-grid__surface\">\n      <h2 class=\"forma-character-grid__text\" id=\"character-grid-reveal-title\" data-forma-reveal-run data-forma-row=\"1\" data-forma-col=\"23\" data-forma-len=\"15\" data-forma-emphasis=\"intensified\">EXAMPLE SYSTEMS</h2>\n      <p class=\"forma-character-grid__text\" data-forma-reveal-run data-forma-row=\"2\" data-forma-col=\"21\" data-forma-len=\"18\">OPERATIONS NETWORK</p>\n      <p class=\"forma-character-grid__text\" data-forma-reveal-run data-forma-row=\"3\" data-forma-col=\"20\" data-forma-len=\"20\" data-forma-emphasis=\"muted\">Authorized use only.</p>\n      <label class=\"forma-character-grid__label\" for=\"character-grid-reveal-operator\" data-forma-row=\"5\" data-forma-col=\"2\" data-forma-len=\"16\">Operator<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . . :</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-reveal-operator\" name=\"operator\" type=\"text\" maxlength=\"8\" required autocomplete=\"username\" data-forma-row=\"5\" data-forma-col=\"20\" data-forma-len=\"8\">\n      <p class=\"forma-character-grid__message\" role=\"status\" data-forma-severity=\"information\" data-forma-row=\"7\" data-forma-col=\"2\" data-forma-len=\"58\"><span class=\"forma-character-grid__severity\"><span>INFO</span></span> Enter your operator ID and press Enter.</p>\n      <div class=\"forma-character-grid__group\" role=\"group\" aria-label=\"Function keys\">\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"enter\" data-forma-action=\"enter\" data-forma-row=\"8\" data-forma-col=\"2\" data-forma-len=\"13\"><kbd>Enter</kbd>=Sign on</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf3\" formnovalidate data-forma-action=\"pf3\" data-forma-row=\"8\" data-forma-col=\"17\" data-forma-len=\"8\"><kbd>PF3</kbd>=Exit</button>\n      </div>\n    </form>\n  </div>\n</div>\n</forma-character-grid-reveal>",
      "attributes": [],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "Any key",
          "action": "No built-in behavior. The application completes the reveal by setting `data-forma-reveal=\"complete\"` without consuming the key, so the key still does its normal job."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "form-handling"
        ]
      },
      "examples": [
        {
          "id": "title-only",
          "title": "Title-only reveal on a data screen",
          "mobile": false,
          "raw": "components/character-grid-reveal/title-only.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "banner-capped",
          "title": "Multi-line banner within the cap",
          "mobile": false,
          "raw": "components/character-grid-reveal/banner-capped.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "completed-by-input",
          "title": "Reveal completed by input",
          "mobile": false,
          "raw": "components/character-grid-reveal/completed-by-input.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "banner-mobile",
          "title": "Sign-on banner on a phone",
          "mobile": true,
          "raw": "components/character-grid-reveal/banner-mobile.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        }
      ],
      "related": [
        "character-grid",
        "character-grid-workflow",
        "skeleton"
      ]
    },
    {
      "slug": "character-grid-selection",
      "title": "Character grid selection",
      "tag": "forma-character-grid-selection",
      "category": "keyboard",
      "behavior": "Application / Limen",
      "summary": "Per-row selection fields in positioned repeated rows (a 5250-style option column): native text inputs named by their column and row headers and described by the option legend; the application owns what each option does.",
      "docsUrl": "components/character-grid-selection/",
      "pattern": "patterns/character-grid-selection.html",
      "minimalHtml": "<forma-character-grid-selection class=\"forma-component-tag\">\n<div class=\"forma-character-grid\" data-forma-rows=\"14\" data-forma-columns=\"80\" data-forma-narrow=\"contained\">\n  <div class=\"forma-character-grid__viewport\" role=\"region\" aria-labelledby=\"character-grid-selection-title\" tabindex=\"0\">\n    <form class=\"forma-character-grid__surface\">\n      <h2 class=\"forma-character-grid__text\" id=\"character-grid-selection-title\" data-forma-row=\"1\" data-forma-col=\"31\" data-forma-len=\"18\" data-forma-emphasis=\"intensified\">WORK WITH ACCOUNTS</h2>\n      <p class=\"forma-character-grid__text\" data-forma-row=\"3\" data-forma-col=\"2\" data-forma-len=\"26\">Type options, press Enter.</p>\n      <p class=\"forma-character-grid__text\" id=\"character-grid-selection-legend\" data-forma-row=\"4\" data-forma-col=\"4\" data-forma-len=\"28\">2=Change  4=Close  5=Display</p>\n      <div class=\"forma-character-grid__table\" data-forma-row=\"6\" data-forma-col=\"2\" data-forma-len=\"77\" data-forma-height=\"6\">\n        <table data-forma-gutter=\"2\">\n          <caption>Accounts, with a selection option per row</caption>\n          <thead><tr><th scope=\"col\" id=\"character-grid-selection-opt\" data-forma-len=\"3\">Opt</th><th scope=\"col\" data-forma-len=\"14\">Account</th><th scope=\"col\" data-forma-len=\"24\">Name</th><th scope=\"col\" data-forma-len=\"10\">Type</th><th scope=\"col\" data-forma-len=\"12\" data-forma-align=\"end\">Balance</th></tr></thead>\n          <tbody>\n          <tr><td><input class=\"forma-character-grid__field\" id=\"character-grid-selection-opt-1\" name=\"opt-00417-2231-09\" type=\"text\" inputmode=\"numeric\" pattern=\"[245]\" maxlength=\"1\" autocomplete=\"off\" aria-labelledby=\"character-grid-selection-opt character-grid-selection-row-1\" aria-describedby=\"character-grid-selection-legend\" data-forma-len=\"1\"></td><th scope=\"row\" id=\"character-grid-selection-row-1\">00417-2231-09</th><td>RIVERA, ALEX</td><td>CHECKING</td><td data-forma-align=\"end\">12,480.55</td></tr>\n          <tr><td><input class=\"forma-character-grid__field\" id=\"character-grid-selection-opt-2\" name=\"opt-00417-5518-02\" type=\"text\" inputmode=\"numeric\" pattern=\"[245]\" maxlength=\"1\" autocomplete=\"off\" value=\"5\" aria-labelledby=\"character-grid-selection-opt character-grid-selection-row-2\" aria-describedby=\"character-grid-selection-legend\" data-forma-len=\"1\"></td><th scope=\"row\" id=\"character-grid-selection-row-2\">00417-5518-02</th><td>RIVERA, ALEX</td><td>SAVINGS</td><td data-forma-align=\"end\">8,215.00</td></tr>\n          <tr><td><input class=\"forma-character-grid__field\" id=\"character-grid-selection-opt-3\" name=\"opt-00902-1177-40\" type=\"text\" inputmode=\"numeric\" pattern=\"[245]\" maxlength=\"1\" autocomplete=\"off\" value=\"9\" aria-invalid=\"true\" aria-labelledby=\"character-grid-selection-opt character-grid-selection-row-3\" aria-describedby=\"character-grid-selection-legend character-grid-selection-message\" data-forma-len=\"1\"></td><th scope=\"row\" id=\"character-grid-selection-row-3\">00902-1177-40</th><td>OKAFOR, CHIDI</td><td>LOAN</td><td data-forma-align=\"end\">-4,100.00</td></tr>\n          <tr><td><input class=\"forma-character-grid__field\" id=\"character-grid-selection-opt-4\" name=\"opt-01233-0040-11\" type=\"text\" inputmode=\"numeric\" pattern=\"[245]\" maxlength=\"1\" autocomplete=\"off\" aria-labelledby=\"character-grid-selection-opt character-grid-selection-row-4\" aria-describedby=\"character-grid-selection-legend\" data-forma-len=\"1\"></td><th scope=\"row\" id=\"character-grid-selection-row-4\">01233-0040-11</th><td>NAKAMURA, YUKI</td><td>CHECKING</td><td data-forma-align=\"end\">310.72</td></tr>\n          <tr><td><input class=\"forma-character-grid__field\" id=\"character-grid-selection-opt-5\" name=\"opt-01233-0040-12\" type=\"text\" inputmode=\"numeric\" pattern=\"[245]\" maxlength=\"1\" autocomplete=\"off\" disabled aria-labelledby=\"character-grid-selection-opt character-grid-selection-row-5\" aria-describedby=\"character-grid-selection-legend\" data-forma-len=\"1\"></td><th scope=\"row\" id=\"character-grid-selection-row-5\">01233-0040-12</th><td>NAKAMURA, YUKI</td><td>CLOSED</td><td data-forma-align=\"end\">0.00</td></tr>\n          </tbody>\n        </table>\n      </div>\n      <p class=\"forma-character-grid__text\" data-forma-row=\"12\" data-forma-col=\"72\" data-forma-len=\"6\">Bottom</p>\n      <p class=\"forma-character-grid__message\" id=\"character-grid-selection-message\" role=\"status\" data-forma-severity=\"validation\" data-forma-row=\"13\" data-forma-col=\"2\" data-forma-len=\"78\"><span class=\"forma-character-grid__severity\"><span>CHECK</span></span> Option 9 is not valid for 00902-1177-40. Type 2, 4, or 5.</p>\n      <div class=\"forma-character-grid__group\" role=\"group\" aria-label=\"Function keys\">\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"enter\" data-forma-action=\"enter\" data-forma-row=\"14\" data-forma-col=\"2\" data-forma-len=\"13\"><kbd>Enter</kbd>=Process</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf3\" formnovalidate data-forma-action=\"pf3\" data-forma-row=\"14\" data-forma-col=\"17\" data-forma-len=\"8\"><kbd>PF3</kbd>=Exit</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf5\" formnovalidate data-forma-action=\"pf5\" data-forma-row=\"14\" data-forma-col=\"27\" data-forma-len=\"11\"><kbd>PF5</kbd>=Refresh</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf12\" formnovalidate data-forma-action=\"pf12\" data-forma-row=\"14\" data-forma-col=\"40\" data-forma-len=\"11\"><kbd>PF12</kbd>=Cancel</button>\n      </div>\n    </form>\n  </div>\n</div>\n</forma-character-grid-selection>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "option input",
          "values": "column th id, then row th id",
          "default": "—",
          "description": "Required (CG-17). Names the field by its column and row headers, for example \"Opt 00417-2231-09\"."
        },
        {
          "name": "aria-describedby",
          "on": "option input",
          "values": "legend id, plus message id when invalid",
          "default": "—",
          "description": "The option legend describes every field; an invalid field also references the message."
        },
        {
          "name": "maxlength",
          "on": "option input",
          "values": "integer",
          "default": "—",
          "description": "Required. Equals the field's `data-forma-len`, which must fit its column."
        },
        {
          "name": "scope",
          "on": "th",
          "values": "col | row",
          "default": "—",
          "description": "Column headers name the option column; each row header names its record."
        },
        {
          "name": "pattern",
          "on": "option input",
          "values": "e.g. [245]",
          "default": "—",
          "description": "Optional native expression of the valid codes. Which codes are valid is application policy."
        },
        {
          "name": "aria-invalid",
          "on": "option input",
          "values": "true",
          "default": "absent",
          "description": "Set by the application on rows it rejected after Enter."
        },
        {
          "name": "disabled",
          "on": "option input",
          "values": "boolean",
          "default": "absent",
          "description": "A row that cannot take options, such as a closed account. Skipped by Tab."
        },
        {
          "name": "colspan",
          "on": "td",
          "values": "integer",
          "default": "—",
          "description": "Lets an explicit empty-result row span the table; it wraps normally."
        }
      ],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves down and up the option column in row-major order, skipping disabled rows natively, then on to the keys."
        },
        {
          "keys": "Typing",
          "action": "Enters an option code, stopped at `maxlength`."
        },
        {
          "keys": "Enter",
          "action": "Native implicit submission through the first submit key; the application processes the changed rows."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "form-handling"
        ]
      },
      "examples": [
        {
          "id": "work-with-jobs",
          "title": "Options typed before Enter",
          "mobile": false,
          "raw": "components/character-grid-selection/work-with-jobs.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "empty-list",
          "title": "Empty result",
          "mobile": false,
          "raw": "components/character-grid-selection/empty-list.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "selection-mobile",
          "title": "Option column on a phone",
          "mobile": true,
          "raw": "components/character-grid-selection/selection-mobile.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        }
      ],
      "related": [
        "character-grid-field",
        "character-grid",
        "data-grid"
      ]
    },
    {
      "slug": "character-grid-status",
      "title": "Character grid status",
      "tag": "forma-character-grid-status",
      "category": "keyboard",
      "behavior": "Application state",
      "summary": "Message and system-status live regions on a character grid with a visible severity word and shape cues that survive forced colors.",
      "docsUrl": "components/character-grid-status/",
      "pattern": "patterns/character-grid-status.html",
      "minimalHtml": "<forma-character-grid-status class=\"forma-component-tag\">\n<div class=\"forma-character-grid\" data-forma-rows=\"6\" data-forma-columns=\"80\" data-forma-narrow=\"contained\">\n  <div class=\"forma-character-grid__viewport\" role=\"region\" aria-labelledby=\"character-grid-status-title\" tabindex=\"0\">\n    <div class=\"forma-character-grid__surface\">\n      <h2 class=\"forma-character-grid__text\" id=\"character-grid-status-title\" data-forma-row=\"1\" data-forma-col=\"33\" data-forma-len=\"14\" data-forma-emphasis=\"intensified\">BATCH TRANSFER</h2>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"3\" data-forma-col=\"2\" data-forma-len=\"16\">Records<span class=\"forma-character-grid__leader\" aria-hidden=\"true\">  . . . :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"3\" data-forma-col=\"20\" data-forma-len=\"6\" data-forma-align=\"end\">1,204</span>\n      <p class=\"forma-character-grid__message\" role=\"alert\" data-forma-severity=\"error\" data-forma-row=\"5\" data-forma-col=\"2\" data-forma-len=\"78\"><span class=\"forma-character-grid__severity\"><span>ERROR</span></span> BTX009E Transfer service did not respond. Press Reset, then Enter.</p>\n      <p class=\"forma-character-grid__status\" role=\"status\" data-forma-row=\"6\" data-forma-col=\"2\" data-forma-len=\"78\"><span class=\"forma-character-grid__indicator\" data-forma-state=\"inhibited\"><span>X SYSTEM</span></span>  Input inhibited</p>\n    </div>\n  </div>\n</div>\n</forma-character-grid-status>",
      "attributes": [
        {
          "name": "role",
          "on": ".forma-character-grid__message / .forma-character-grid__status",
          "values": "status | alert",
          "default": "—",
          "description": "`status` for information, success and warning and for the system status line; `alert` for validation and error that need immediate attention. The element must exist before its text changes."
        },
        {
          "name": "id",
          "on": ".forma-character-grid__message",
          "values": "string",
          "default": "—",
          "description": "Lets invalid fields reference the message with `aria-describedby`."
        }
      ],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "None",
          "action": "Messages and status are not focusable. Live regions are announced without moving focus."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "update-success",
          "title": "Success after an update",
          "mobile": false,
          "raw": "components/character-grid-status/update-success.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "report-warning",
          "title": "Warning that does not block",
          "mobile": false,
          "raw": "components/character-grid-status/report-warning.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "long-error",
          "title": "Long error in reserved rows",
          "mobile": false,
          "raw": "components/character-grid-status/long-error.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "status-mobile",
          "title": "Status line on a phone",
          "mobile": true,
          "raw": "components/character-grid-status/status-mobile.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "character-grid",
        "character-grid-field",
        "character-grid-keys",
        "alert"
      ]
    },
    {
      "slug": "character-grid-workflow",
      "title": "Character grid workflow",
      "tag": "forma-character-grid-workflow",
      "category": "keyboard",
      "behavior": "Application / Limen / Ordo",
      "summary": "Customer Inquiry, Account Detail, and Transaction History built only from public CharacterGrid contracts; transitions stay in the application.",
      "docsUrl": "components/character-grid-workflow/",
      "pattern": "patterns/character-grid-workflow.html",
      "minimalHtml": "<forma-character-grid-workflow class=\"forma-component-tag\">\n<div class=\"forma-stack\">\n<div class=\"forma-character-grid\" data-forma-profile=\"ibm-3270\" data-forma-rows=\"24\" data-forma-status-rows=\"1\" data-forma-columns=\"80\" data-forma-narrow=\"contained\" data-forma-reveal=\"sequential\" data-forma-reveal-rows=\"1\">\n  <div class=\"forma-character-grid__viewport\" role=\"region\" aria-labelledby=\"character-grid-workflow-cinq-title\" tabindex=\"0\">\n    <form class=\"forma-character-grid__surface\">\n      <span class=\"forma-character-grid__text\" data-forma-row=\"1\" data-forma-col=\"2\" data-forma-len=\"4\">CINQ</span>\n      <h2 class=\"forma-character-grid__text\" id=\"character-grid-workflow-cinq-title\" data-forma-reveal-run data-forma-emphasis=\"intensified\" data-forma-row=\"1\" data-forma-col=\"33\" data-forma-len=\"16\">CUSTOMER INQUIRY</h2>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"1\" data-forma-col=\"64\" data-forma-len=\"5\">Date:</span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"1\" data-forma-col=\"70\" data-forma-len=\"10\">2026-09-27</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"2\" data-forma-col=\"2\" data-forma-len=\"7\">System:</span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"2\" data-forma-col=\"10\" data-forma-len=\"8\">ECHT01</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"2\" data-forma-col=\"60\" data-forma-len=\"9\">Operator:</span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"2\" data-forma-col=\"70\" data-forma-len=\"8\">OP0142</span>\n      <p class=\"forma-character-grid__text\" data-forma-row=\"4\" data-forma-col=\"2\" data-forma-len=\"52\">Enter one or more search criteria, then press Enter.</p>\n      <label class=\"forma-character-grid__label\" for=\"character-grid-workflow-cinq-custno\" data-forma-row=\"6\" data-forma-col=\"2\" data-forma-len=\"23\">Customer number<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . . .</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-workflow-cinq-custno\" name=\"custno\" type=\"text\" maxlength=\"10\" autocomplete=\"off\" inputmode=\"numeric\" data-forma-row=\"6\" data-forma-col=\"26\" data-forma-len=\"10\">\n      <label class=\"forma-character-grid__label\" for=\"character-grid-workflow-cinq-last\" data-forma-row=\"7\" data-forma-col=\"2\" data-forma-len=\"23\">Last name<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . . . . . .</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-workflow-cinq-last\" name=\"last\" type=\"text\" maxlength=\"20\" autocomplete=\"off\" data-forma-row=\"7\" data-forma-col=\"26\" data-forma-len=\"20\">\n      <label class=\"forma-character-grid__label\" for=\"character-grid-workflow-cinq-first\" data-forma-row=\"8\" data-forma-col=\"2\" data-forma-len=\"23\">First name<span class=\"forma-character-grid__leader\" aria-hidden=\"true\">  . . . . . .</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-workflow-cinq-first\" name=\"first\" type=\"text\" maxlength=\"15\" autocomplete=\"off\" data-forma-row=\"8\" data-forma-col=\"26\" data-forma-len=\"15\">\n      <label class=\"forma-character-grid__label\" for=\"character-grid-workflow-cinq-dob\" data-forma-row=\"9\" data-forma-col=\"2\" data-forma-len=\"23\">Date of birth<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . . . .</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-workflow-cinq-dob\" name=\"dob\" type=\"text\" maxlength=\"10\" autocomplete=\"off\" aria-describedby=\"character-grid-workflow-cinq-dob-hint\" data-forma-row=\"9\" data-forma-col=\"26\" data-forma-len=\"10\">\n      <span class=\"forma-character-grid__text\" id=\"character-grid-workflow-cinq-dob-hint\" data-forma-emphasis=\"muted\" data-forma-row=\"9\" data-forma-col=\"38\" data-forma-len=\"12\">(YYYY-MM-DD)</span>\n      <label class=\"forma-character-grid__label\" for=\"character-grid-workflow-cinq-postal\" data-forma-row=\"10\" data-forma-col=\"2\" data-forma-len=\"23\">Postal code<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . . . . .</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-workflow-cinq-postal\" name=\"postal\" type=\"text\" maxlength=\"10\" autocomplete=\"off\" data-forma-row=\"10\" data-forma-col=\"26\" data-forma-len=\"10\">\n      <label class=\"forma-character-grid__label\" for=\"character-grid-workflow-cinq-acct\" data-forma-row=\"11\" data-forma-col=\"2\" data-forma-len=\"23\">Account number<span class=\"forma-character-grid__leader\" aria-hidden=\"true\">  . . . .</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-workflow-cinq-acct\" name=\"acct\" type=\"text\" maxlength=\"14\" autocomplete=\"off\" data-forma-row=\"11\" data-forma-col=\"26\" data-forma-len=\"14\">\n      <p class=\"forma-character-grid__text\" data-forma-row=\"13\" data-forma-col=\"2\" data-forma-len=\"75\">At least one criterion is required. Last names match from the first letter.</p>\n      <p class=\"forma-character-grid__message\" id=\"character-grid-workflow-cinq-message\" role=\"status\" data-forma-severity=\"information\" data-forma-row=\"21\" data-forma-col=\"2\" data-forma-len=\"78\"><span class=\"forma-character-grid__severity\"><span>INFO</span></span> CINQ000I Type search criteria and press Enter.</p>\n      <div class=\"forma-character-grid__group\" role=\"group\" aria-label=\"Function keys\">\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"enter\" data-forma-action=\"enter\" data-forma-row=\"22\" data-forma-col=\"2\" data-forma-len=\"12\"><kbd>Enter</kbd>=Search</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"clear\" formnovalidate data-forma-action=\"clear\" data-forma-row=\"22\" data-forma-col=\"16\" data-forma-len=\"11\"><kbd>Clear</kbd>=Erase</button>\n        <button class=\"forma-character-grid__key\" type=\"button\" data-forma-action=\"reset\" data-forma-row=\"22\" data-forma-col=\"29\" data-forma-len=\"12\"><kbd>Reset</kbd>=Unlock</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf1\" formnovalidate data-forma-action=\"pf1\" data-forma-row=\"22\" data-forma-col=\"43\" data-forma-len=\"8\"><kbd>PF1</kbd>=Help</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf3\" formnovalidate data-forma-action=\"pf3\" data-forma-row=\"22\" data-forma-col=\"53\" data-forma-len=\"8\"><kbd>PF3</kbd>=Exit</button>\n      </div>\n      <p class=\"forma-character-grid__status\" role=\"status\" data-forma-row=\"25\" data-forma-col=\"2\" data-forma-len=\"78\"><span class=\"forma-character-grid__indicator\"><span>READY</span></span></p>\n    </form>\n  </div>\n</div>\n<div class=\"forma-character-grid\" data-forma-profile=\"ibm-3270\" data-forma-rows=\"24\" data-forma-status-rows=\"1\" data-forma-columns=\"80\" data-forma-narrow=\"contained\">\n  <div class=\"forma-character-grid__viewport\" role=\"region\" aria-labelledby=\"character-grid-workflow-accd-title\" tabindex=\"0\">\n    <form class=\"forma-character-grid__surface\">\n      <span class=\"forma-character-grid__text\" data-forma-row=\"1\" data-forma-col=\"2\" data-forma-len=\"4\">ACCD</span>\n      <h2 class=\"forma-character-grid__text\" id=\"character-grid-workflow-accd-title\" data-forma-emphasis=\"intensified\" data-forma-row=\"1\" data-forma-col=\"34\" data-forma-len=\"14\">ACCOUNT DETAIL</h2>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"1\" data-forma-col=\"64\" data-forma-len=\"5\">Date:</span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"1\" data-forma-col=\"70\" data-forma-len=\"10\">2026-09-27</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"2\" data-forma-col=\"2\" data-forma-len=\"7\">System:</span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"2\" data-forma-col=\"10\" data-forma-len=\"8\">ECHT01</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"2\" data-forma-col=\"60\" data-forma-len=\"9\">Operator:</span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"2\" data-forma-col=\"70\" data-forma-len=\"8\">OP0142</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"4\" data-forma-col=\"2\" data-forma-len=\"17\">Customer<span class=\"forma-character-grid__leader\" aria-hidden=\"true\">  . . . :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"4\" data-forma-col=\"20\" data-forma-len=\"10\">0001042778</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"4\" data-forma-col=\"34\" data-forma-len=\"12\">Name<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . . :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"4\" data-forma-col=\"47\" data-forma-len=\"30\">RIVERA, ALEX J</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"5\" data-forma-col=\"2\" data-forma-len=\"17\">Address<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . . . :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"5\" data-forma-col=\"20\" data-forma-len=\"40\">1200 HARBOR VIEW DRIVE APT 4B</span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"6\" data-forma-col=\"20\" data-forma-len=\"40\">PORTLAND OR 97209-3311</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"7\" data-forma-col=\"2\" data-forma-len=\"17\">Phone<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . . . . :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-state=\"missing\" data-forma-row=\"7\" data-forma-col=\"20\" data-forma-len=\"14\">not on file</span>\n      <h3 class=\"forma-character-grid__text\" data-forma-emphasis=\"intensified\" data-forma-row=\"9\" data-forma-col=\"2\" data-forma-len=\"7\">ACCOUNT</h3>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"10\" data-forma-col=\"2\" data-forma-len=\"17\">Account number<span class=\"forma-character-grid__leader\" aria-hidden=\"true\">  :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"10\" data-forma-col=\"20\" data-forma-len=\"14\">00417-2231-09</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"10\" data-forma-col=\"42\" data-forma-len=\"12\">Type<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . . :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"10\" data-forma-col=\"55\" data-forma-len=\"12\">CHECKING</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"11\" data-forma-col=\"2\" data-forma-len=\"17\">Status<span class=\"forma-character-grid__leader\" aria-hidden=\"true\">  . . . . :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"11\" data-forma-col=\"20\" data-forma-len=\"10\">ACTIVE</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"11\" data-forma-col=\"42\" data-forma-len=\"12\">Opened<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"11\" data-forma-col=\"55\" data-forma-len=\"10\">2014-03-11</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"12\" data-forma-col=\"2\" data-forma-len=\"17\">Currency<span class=\"forma-character-grid__leader\" aria-hidden=\"true\">  . . . :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"12\" data-forma-col=\"20\" data-forma-len=\"3\">USD</span>\n      <h3 class=\"forma-character-grid__text\" data-forma-emphasis=\"intensified\" data-forma-row=\"14\" data-forma-col=\"2\" data-forma-len=\"8\">BALANCES</h3>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"15\" data-forma-col=\"2\" data-forma-len=\"17\">Ledger balance<span class=\"forma-character-grid__leader\" aria-hidden=\"true\">  :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-align=\"end\" data-forma-row=\"15\" data-forma-col=\"20\" data-forma-len=\"15\">12,480.55</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"15\" data-forma-col=\"42\" data-forma-len=\"11\">Available<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-align=\"end\" data-forma-row=\"15\" data-forma-col=\"55\" data-forma-len=\"15\">12,230.55</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"16\" data-forma-col=\"2\" data-forma-len=\"17\">Holds<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . . . . . :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-align=\"end\" data-forma-row=\"16\" data-forma-col=\"20\" data-forma-len=\"15\">250.00</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"16\" data-forma-col=\"42\" data-forma-len=\"11\">Overdraft<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-align=\"end\" data-forma-row=\"16\" data-forma-col=\"55\" data-forma-len=\"15\">1,000.00</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"18\" data-forma-col=\"2\" data-forma-len=\"17\">Last statement<span class=\"forma-character-grid__leader\" aria-hidden=\"true\">  :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"18\" data-forma-col=\"20\" data-forma-len=\"10\">2026-08-31</span>\n      <p class=\"forma-character-grid__message\" id=\"character-grid-workflow-accd-message\" role=\"status\" data-forma-severity=\"information\" data-forma-row=\"21\" data-forma-col=\"2\" data-forma-len=\"78\"><span class=\"forma-character-grid__severity\"><span>INFO</span></span> ACCD000I Account 00417-2231-09 displayed.</p>\n      <div class=\"forma-character-grid__group\" role=\"group\" aria-label=\"Function keys\">\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"enter\" data-forma-action=\"enter\" data-forma-row=\"22\" data-forma-col=\"2\" data-forma-len=\"13\"><kbd>Enter</kbd>=Refresh</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf3\" formnovalidate data-forma-action=\"pf3\" data-forma-row=\"22\" data-forma-col=\"17\" data-forma-len=\"10\"><kbd>PF3</kbd>=Return</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf5\" formnovalidate data-forma-action=\"pf5\" data-forma-row=\"22\" data-forma-col=\"29\" data-forma-len=\"16\"><kbd>PF5</kbd>=Transactions</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf12\" formnovalidate data-forma-action=\"pf12\" data-forma-row=\"22\" data-forma-col=\"47\" data-forma-len=\"12\"><kbd>PF12</kbd>=Inquiry</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf1\" formnovalidate data-forma-action=\"pf1\" data-forma-row=\"22\" data-forma-col=\"61\" data-forma-len=\"8\"><kbd>PF1</kbd>=Help</button>\n      </div>\n      <p class=\"forma-character-grid__status\" role=\"status\" data-forma-row=\"25\" data-forma-col=\"2\" data-forma-len=\"78\"><span class=\"forma-character-grid__indicator\"><span>READY</span></span></p>\n    </form>\n  </div>\n</div>\n<div class=\"forma-character-grid\" data-forma-profile=\"ibm-3270\" data-forma-rows=\"24\" data-forma-status-rows=\"1\" data-forma-columns=\"80\" data-forma-narrow=\"contained\">\n  <div class=\"forma-character-grid__viewport\" role=\"region\" aria-labelledby=\"character-grid-workflow-trnh-title\" tabindex=\"0\">\n    <form class=\"forma-character-grid__surface\">\n      <span class=\"forma-character-grid__text\" data-forma-row=\"1\" data-forma-col=\"2\" data-forma-len=\"4\">TRNH</span>\n      <h2 class=\"forma-character-grid__text\" id=\"character-grid-workflow-trnh-title\" data-forma-emphasis=\"intensified\" data-forma-row=\"1\" data-forma-col=\"31\" data-forma-len=\"19\">TRANSACTION HISTORY</h2>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"1\" data-forma-col=\"64\" data-forma-len=\"5\">Date:</span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"1\" data-forma-col=\"70\" data-forma-len=\"10\">2026-09-27</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"2\" data-forma-col=\"2\" data-forma-len=\"7\">System:</span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"2\" data-forma-col=\"10\" data-forma-len=\"8\">ECHT01</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"2\" data-forma-col=\"60\" data-forma-len=\"9\">Operator:</span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"2\" data-forma-col=\"70\" data-forma-len=\"8\">OP0142</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"3\" data-forma-col=\"2\" data-forma-len=\"11\">Account<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> . :</span></span>\n      <span class=\"forma-character-grid__value\" data-forma-row=\"3\" data-forma-col=\"14\" data-forma-len=\"14\">00417-2231-09</span>\n      <label class=\"forma-character-grid__label\" for=\"character-grid-workflow-trnh-from\" data-forma-row=\"3\" data-forma-col=\"32\" data-forma-len=\"11\">From<span class=\"forma-character-grid__leader\" aria-hidden=\"true\">  . . :</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-workflow-trnh-from\" name=\"from\" type=\"text\" maxlength=\"10\" autocomplete=\"off\" value=\"2026-08-01\" required data-forma-row=\"3\" data-forma-col=\"44\" data-forma-len=\"10\">\n      <label class=\"forma-character-grid__label\" for=\"character-grid-workflow-trnh-to\" data-forma-row=\"3\" data-forma-col=\"57\" data-forma-len=\"4\">To<span class=\"forma-character-grid__leader\" aria-hidden=\"true\"> :</span></label>\n      <input class=\"forma-character-grid__field\" id=\"character-grid-workflow-trnh-to\" name=\"to\" type=\"text\" maxlength=\"10\" autocomplete=\"off\" value=\"2026-09-27\" required data-forma-row=\"3\" data-forma-col=\"62\" data-forma-len=\"10\">\n      <div class=\"forma-character-grid__table\" data-forma-row=\"5\" data-forma-col=\"2\" data-forma-len=\"77\" data-forma-height=\"13\">\n        <table data-forma-gutter=\"2\">\n          <caption>Transactions for account 00417-2231-09, newest first</caption>\n          <thead><tr><th scope=\"col\" data-forma-len=\"10\">Date</th><th scope=\"col\" data-forma-len=\"27\">Description</th><th scope=\"col\" data-forma-len=\"12\" data-forma-align=\"end\">Amount</th><th scope=\"col\" data-forma-len=\"12\" data-forma-align=\"end\">Balance</th><th scope=\"col\" data-forma-len=\"8\">Status</th></tr></thead>\n          <tbody>\n          <tr><td>2026-09-26</td><td>PAYROLL DEPOSIT ACME CORP</td><td data-forma-align=\"end\">2,450.00</td><td data-forma-align=\"end\">12,480.55</td><td>POSTED</td></tr>\n          <tr><td>2026-09-25</td><td>CARD 4411 CITY MARKET</td><td data-forma-align=\"end\">-86.12</td><td data-forma-align=\"end\">10,030.55</td><td>POSTED</td></tr>\n          <tr><td>2026-09-25</td><td>CARD 4411 FUEL STOP 118</td><td data-forma-align=\"end\">-52.40</td><td data-forma-align=\"end\">10,116.67</td><td>POSTED</td></tr>\n          <tr><td>2026-09-24</td><td>TRANSFER TO SAVINGS 7710</td><td data-forma-align=\"end\">-500.00</td><td data-forma-align=\"end\">10,169.07</td><td>POSTED</td></tr>\n          <tr><td>2026-09-23</td><td>CHECK 1043</td><td data-forma-align=\"end\">-1,200.00</td><td data-forma-align=\"end\">10,669.07</td><td>POSTED</td></tr>\n          <tr><td>2026-09-22</td><td>ACH ELECTRIC UTILITY</td><td data-forma-align=\"end\">-143.88</td><td data-forma-align=\"end\">11,869.07</td><td>POSTED</td></tr>\n          <tr><td>2026-09-22</td><td>CARD 4411 BOOKSHOP</td><td data-forma-align=\"end\">-24.99</td><td data-forma-align=\"end\">12,012.95</td><td>PENDING</td></tr>\n          <tr><td>2026-09-20</td><td>ATM WITHDRAWAL 0931</td><td data-forma-align=\"end\">-200.00</td><td data-forma-align=\"end\">12,037.94</td><td>POSTED</td></tr>\n          <tr><td>2026-09-19</td><td>CHECK 1041</td><td data-forma-align=\"end\">-310.00</td><td data-forma-align=\"end\">12,237.94</td><td>RETURNED</td></tr>\n          <tr><td>2026-09-18</td><td>ONLINE PAYMENT CREDIT CARD</td><td data-forma-align=\"end\">-640.00</td><td data-forma-align=\"end\">12,547.94</td><td>POSTED</td></tr>\n          <tr><td>2026-09-17</td><td>INTEREST CREDIT</td><td data-forma-align=\"end\">1.37</td><td data-forma-align=\"end\">13,187.94</td><td>POSTED</td></tr>\n          <tr><td>2026-09-15</td><td>CARD 4411 PHARMACY</td><td data-forma-align=\"end\">-18.45</td><td data-forma-align=\"end\">13,186.57</td><td>REVERSED</td></tr>\n          </tbody>\n        </table>\n      </div>\n      <span class=\"forma-character-grid__text\" id=\"character-grid-workflow-trnh-position\" data-forma-row=\"19\" data-forma-col=\"2\" data-forma-len=\"15\">Rows 1-12 of 37</span>\n      <span class=\"forma-character-grid__text\" data-forma-row=\"19\" data-forma-col=\"72\" data-forma-len=\"7\">More: +</span>\n      <p class=\"forma-character-grid__message\" id=\"character-grid-workflow-trnh-message\" role=\"status\" data-forma-severity=\"information\" data-forma-row=\"21\" data-forma-col=\"2\" data-forma-len=\"78\"><span class=\"forma-character-grid__severity\"><span>INFO</span></span> TRNH000I 37 transactions from 2026-08-01 to 2026-09-27.</p>\n      <div class=\"forma-character-grid__group\" role=\"group\" aria-label=\"Function keys\">\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"enter\" data-forma-action=\"enter\" data-forma-row=\"22\" data-forma-col=\"2\" data-forma-len=\"17\"><kbd>Enter</kbd>=Apply dates</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf3\" formnovalidate data-forma-action=\"pf3\" data-forma-row=\"22\" data-forma-col=\"21\" data-forma-len=\"10\"><kbd>PF3</kbd>=Return</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf7\" formnovalidate data-forma-action=\"pf7\" data-forma-row=\"22\" data-forma-col=\"33\" data-forma-len=\"8\"><kbd>PF7</kbd>=Back</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf8\" formnovalidate data-forma-action=\"pf8\" data-forma-row=\"22\" data-forma-col=\"43\" data-forma-len=\"11\"><kbd>PF8</kbd>=Forward</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf12\" formnovalidate data-forma-action=\"pf12\" data-forma-row=\"22\" data-forma-col=\"56\" data-forma-len=\"12\"><kbd>PF12</kbd>=Inquiry</button>\n        <button class=\"forma-character-grid__key\" type=\"button\" data-forma-action=\"reset\" data-forma-row=\"23\" data-forma-col=\"2\" data-forma-len=\"12\"><kbd>Reset</kbd>=Unlock</button>\n        <button class=\"forma-character-grid__key\" type=\"submit\" name=\"action\" value=\"pf1\" formnovalidate data-forma-action=\"pf1\" data-forma-row=\"23\" data-forma-col=\"17\" data-forma-len=\"8\"><kbd>PF1</kbd>=Help</button>\n      </div>\n      <p class=\"forma-character-grid__status\" role=\"status\" data-forma-row=\"25\" data-forma-col=\"2\" data-forma-len=\"78\"><span class=\"forma-character-grid__indicator\"><span>READY</span></span></p>\n    </form>\n  </div>\n</div>\n</div>\n</forma-character-grid-workflow>",
      "attributes": [
        {
          "name": "value",
          "on": "submit keys named action",
          "values": "enter | clear | pf3 | pf5 | pf7 | pf8 | pf12",
          "default": "—",
          "description": "The submitter value the application reads to choose the next screen."
        },
        {
          "name": "aria-invalid",
          "on": "field",
          "values": "true",
          "default": "absent",
          "description": "Set by the application on a field it rejected, together with the message ID in `aria-describedby`."
        },
        {
          "name": "colspan",
          "on": "td",
          "values": "5",
          "default": "—",
          "description": "Full-width empty or unavailable row in the history table."
        }
      ],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "CINQ: region, six fields, then keys. ACCD (no fields): region straight to its keys. TRNH: region, two date fields, keys. Tab can always leave each grid."
        },
        {
          "keys": "Enter in a field",
          "action": "Implicit submission through the Enter key of that screen."
        },
        {
          "keys": "PF keys",
          "action": "Present as buttons; physical F-key mapping is application or Limen behavior."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior",
          "form-handling"
        ]
      },
      "examples": [
        {
          "id": "inquiry-validation",
          "title": "Inquiry validation",
          "mobile": false,
          "raw": "components/character-grid-workflow/inquiry-validation.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior",
              "form-handling"
            ]
          }
        },
        {
          "id": "history-empty",
          "title": "History with no transactions",
          "mobile": false,
          "raw": "components/character-grid-workflow/history-empty.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "history-error-mobile",
          "title": "Service error on a phone",
          "mobile": true,
          "raw": "components/character-grid-workflow/history-error-mobile.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior",
              "form-handling"
            ]
          }
        }
      ],
      "related": [
        "character-grid-3270",
        "character-grid-keys",
        "character-grid-status",
        "wizard"
      ]
    },
    {
      "slug": "checkbox",
      "title": "Checkbox",
      "tag": "forma-checkbox",
      "category": "forms",
      "behavior": "Native HTML",
      "summary": "A native checkbox with a delegated touch target, non-color checked cue, and physics-derived CSS state motion.",
      "docsUrl": "components/checkbox/",
      "pattern": "patterns/checkbox.html",
      "minimalHtml": "<forma-checkbox class=\"forma-component-tag\">\n<label class=\"forma-checkbox\" data-forma-motion-weight=\"standard\">\n  <input\n    class=\"forma-checkbox__input\"\n    type=\"checkbox\"\n    name=\"audit-log\"\n    value=\"enabled\"\n    aria-describedby=\"audit-log-description\">\n  <span class=\"forma-checkbox__box\" aria-hidden=\"true\"></span>\n  <span class=\"forma-checkbox__text\">\n    <span class=\"forma-checkbox__label\">Record audit events</span>\n    <span class=\"forma-checkbox__description\" id=\"audit-log-description\">Include this action in the audit trail.</span>\n  </span>\n</label>\n</forma-checkbox>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "checkbox",
          "default": "—",
          "description": "Required. The control is a native checkbox."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Form field name. Checkboxes in a set can share a name to submit several values."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "\"on\"",
          "description": "Submitted value when checked."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Initial checked state. The live state is the browser-owned checked property."
        },
        {
          "name": "required",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "The form will not submit until this checkbox is checked. Say \"required\" in the label."
        },
        {
          "name": "disabled",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Removes the checkbox from focus and submission and dims the whole row."
        },
        {
          "name": "aria-describedby",
          "on": "input",
          "values": "id of .forma-checkbox__description",
          "default": "—",
          "description": "Links the supporting description."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-checkbox",
          "elements": [
            "forma-checkbox__box",
            "forma-checkbox__description",
            "forma-checkbox__input",
            "forma-checkbox__label",
            "forma-checkbox__text"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus to and from the checkbox (skipped when disabled)."
        },
        {
          "keys": "Space",
          "action": "Toggles the checkbox (native)."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "terms-consent",
          "title": "Required consent",
          "mobile": false,
          "raw": "components/checkbox/terms-consent.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "export-options",
          "title": "Export options",
          "mobile": false,
          "raw": "components/checkbox/export-options.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "light-weight-long-label",
          "title": "Light motion weight with a long label",
          "mobile": false,
          "raw": "components/checkbox/light-weight-long-label.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-filter-list",
          "title": "Mobile filter list",
          "mobile": true,
          "raw": "components/checkbox/mobile-filter-list.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "switch",
        "multi-choice",
        "binary-choice",
        "choice-group"
      ]
    },
    {
      "slug": "choice-group",
      "title": "Choice group",
      "tag": "forma-choice-group",
      "category": "selection",
      "behavior": "Native HTML",
      "summary": "Semantic single-choice option cards with a bold primary label and optional supporting text, backed by native radios.",
      "docsUrl": "components/choice-group/",
      "pattern": "patterns/choice-group.html",
      "minimalHtml": "<forma-choice-group class=\"forma-component-tag\">\n<fieldset class=\"forma-choice-group\">\n  <legend class=\"forma-choice-group__legend\">Which environment is most representative?</legend>\n\n  <label class=\"forma-choice\">\n    <input type=\"radio\" name=\"environment\" value=\"cloud\" required>\n    <span class=\"forma-choice__content\">\n      <strong>Cloud</strong>\n      <span>Primarily hosted cloud infrastructure.</span>\n    </span>\n  </label>\n\n  <label class=\"forma-choice\">\n    <input type=\"radio\" name=\"environment\" value=\"hybrid\">\n    <span class=\"forma-choice__content\">\n      <strong>Hybrid</strong>\n      <span>Cloud and on-premises infrastructure.</span>\n    </span>\n  </label>\n\n  <label class=\"forma-choice\">\n    <input type=\"radio\" name=\"environment\" value=\"on-premises\">\n    <span class=\"forma-choice__content\">\n      <strong>On-premises</strong>\n      <span>Primarily locally hosted infrastructure.</span>\n    </span>\n  </label>\n</fieldset>\n</forma-choice-group>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "radio",
          "default": "—",
          "description": "Single choice uses radios. (Checkbox cards are documented on [[multi-choice]].)"
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Shared by every radio in the group; unique per group on the page."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "\"on\"",
          "description": "Submitted value for the chosen option."
        },
        {
          "name": "required",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Native constraint on the group; set it on one radio."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Initial selection."
        },
        {
          "name": "disabled",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Makes an option unselectable and dims its card."
        },
        {
          "name": "aria-describedby",
          "on": "fieldset",
          "values": "id",
          "default": "—",
          "description": "Links guidance or a validation message to the whole group."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-choice-group",
          "elements": [
            "forma-choice-group__legend"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-choice",
          "elements": [
            "forma-choice__content",
            "forma-choice__media"
          ],
          "modifiers": [
            "forma-choice--exclusive",
            "forma-choice--media"
          ],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves into the group (to the checked option, or the first) and out of it; the group is one tab stop."
        },
        {
          "keys": "Arrow Down / Arrow Right",
          "action": "Selects the next enabled option, wrapping at the end (native radio behavior)."
        },
        {
          "keys": "Arrow Up / Arrow Left",
          "action": "Selects the previous enabled option."
        },
        {
          "keys": "Space",
          "action": "Selects the focused option when none is selected."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "validation-error",
          "title": "Validation error",
          "mobile": false,
          "raw": "components/choice-group/validation-error.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "unavailable-option",
          "title": "Selected plan with an unavailable option",
          "mobile": false,
          "raw": "components/choice-group/unavailable-option.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-long-options",
          "title": "Long options on a phone",
          "mobile": true,
          "raw": "components/choice-group/mobile-long-options.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "multi-choice",
        "image-choice",
        "segmented-control",
        "ordinal-scale",
        "binary-choice"
      ]
    },
    {
      "slug": "cluster",
      "title": "Cluster",
      "tag": "forma-cluster",
      "category": "layout",
      "behavior": "Native CSS",
      "summary": "Wraps related inline items while preserving semantic source order.",
      "docsUrl": "components/cluster/",
      "pattern": "patterns/cluster.html",
      "minimalHtml": "<forma-cluster class=\"forma-component-tag\">\n<div class=\"forma-cluster\" aria-label=\"Related actions\">\n  <button type=\"button\">Primary action</button>\n  <button type=\"button\">Secondary action</button>\n  <a href=\"#details\">View details</a>\n</div>\n</forma-cluster>",
      "attributes": [
        {
          "name": "role",
          "on": ".forma-cluster",
          "values": "group | toolbar",
          "default": "none",
          "description": "Optional. Use group with aria-label to name a set of related controls. toolbar implies arrow-key navigation, which the application must implement; Forma does not."
        },
        {
          "name": "aria-label",
          "on": ".forma-cluster",
          "values": "string",
          "default": "—",
          "description": "Names the group when a role is present."
        },
        {
          "name": "style",
          "on": ".forma-cluster",
          "values": "--forma-cluster-space: <length>",
          "default": "—",
          "description": "Inline override of the cluster gap for one instance."
        },
        {
          "name": "data-density",
          "on": "surrounding .forma-stack",
          "values": "relaxed | standard | compact | analytical",
          "default": "—",
          "description": "Appears on the surrounding stack in the metadata example. It does not change the cluster gap."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-cluster",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": [
            {
              "name": "--forma-cluster-gap",
              "default": null
            },
            {
              "name": "--forma-cluster-space",
              "default": "var(--forma-primitive-spacing-3, 0.75rem)"
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through focusable items in source order, which matches the wrapped visual order."
        },
        {
          "keys": "Arrow keys",
          "action": "No built-in behavior. If the cluster is marked role=\"toolbar\", the application must implement roving focus."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior",
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "form-actions",
          "title": "Form actions",
          "mobile": false,
          "raw": "components/cluster/form-actions.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "record-metadata",
          "title": "Record metadata line",
          "mobile": false,
          "raw": "components/cluster/record-metadata.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "custom-gap",
          "title": "Tight filter chips",
          "mobile": false,
          "raw": "components/cluster/custom-gap.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile-toolbar",
          "title": "Mobile toolbar",
          "mobile": true,
          "raw": "components/cluster/mobile-toolbar.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "stack",
        "command-group",
        "status-lozenge",
        "switcher"
      ]
    },
    {
      "slug": "code-sample",
      "title": "Code sample",
      "tag": "forma-code-sample",
      "category": "site",
      "behavior": "Site content",
      "summary": "Technical sample in a captioned, keyboard-scrollable region that never widens the page.",
      "docsUrl": "components/code-sample/",
      "pattern": "patterns/code-sample.html",
      "minimalHtml": "<forma-code-sample class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <figure class=\"forma-code-figure\">\n    <figcaption id=\"code-caption\">Pin Forma in forma.lock</figcaption>\n    <pre class=\"forma-code\" tabindex=\"0\" aria-labelledby=\"code-caption\"><code>forma 0.3.0\nrepository kemiller2002/forma\ndestination assets/forma\nasset forma-marketing.css sha256:&lt;digest&gt;</code></pre>\n  </figure>\n</div>\n</forma-code-sample>",
      "attributes": [
        {
          "name": "tabindex",
          "on": "pre.forma-code",
          "values": "0",
          "default": "—",
          "description": "Makes the scroll region focusable so keyboard users can scroll overflowing lines."
        },
        {
          "name": "aria-labelledby",
          "on": "pre.forma-code",
          "values": "id of the figcaption",
          "default": "—",
          "description": "Gives the focusable region the caption as its name, so focus does not land on an unnamed stop."
        },
        {
          "name": "id",
          "on": "figcaption",
          "values": "string",
          "default": "—",
          "description": "Referenced by the pre's aria-labelledby."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-code",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-code-figure",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Focuses the code block (tabindex=0); the shell's focus ring surrounds it."
        },
        {
          "keys": "Arrow keys, Page Up / Page Down, Home / End",
          "action": "Native scrolling of the focused block when its content overflows."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "long-command",
          "title": "Long command line",
          "mobile": false,
          "raw": "components/code-sample/long-command.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "workflow-file",
          "title": "Deployment workflow file",
          "mobile": false,
          "raw": "components/code-sample/workflow-file.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-lock-file",
          "title": "Phone lock file",
          "mobile": true,
          "raw": "components/code-sample/mobile-lock-file.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "prose",
        "steps",
        "diff-viewer",
        "identifier"
      ]
    },
    {
      "slug": "collection-toolbar",
      "title": "Collection toolbar",
      "tag": "forma-collection-toolbar",
      "category": "data",
      "behavior": "Application / Limen",
      "summary": "A responsive composition for search, filters, sort, saved views, and result counts.",
      "docsUrl": "components/collection-toolbar/",
      "pattern": "patterns/collection-toolbar.html",
      "minimalHtml": "<forma-collection-toolbar class=\"forma-component-tag\">\n<section class=\"forma-collection-toolbar\" aria-label=\"Collection controls\">\n  <form class=\"forma-search forma-collection-toolbar__search\" role=\"search\">\n    <label class=\"forma-search__label\" for=\"collection-search\">Search records</label>\n    <input id=\"collection-search\" type=\"search\" placeholder=\"Search\">\n  </form>\n  <div class=\"forma-collection-toolbar__controls\">\n    <details class=\"forma-collection-toolbar__filters\">\n      <summary>Filters <span class=\"forma-status-lozenge\">2 active</span></summary>\n      <div class=\"forma-collection-toolbar__filter-panel\">\n        <label>Status <select><option>Any status</option><option>Needs attention</option><option>Complete</option></select></label>\n        <label>Owner <select><option>Anyone</option><option>Me</option></select></label>\n      </div>\n    </details>\n    <label class=\"forma-collection-toolbar__sort\">Sort\n      <select><option>Most recent</option><option>Oldest</option><option>Name</option></select>\n    </label>\n    <label class=\"forma-collection-toolbar__view\">Saved view\n      <select><option>All records</option><option>Needs my attention</option></select>\n    </label>\n  </div>\n  <p class=\"forma-collection-toolbar__count\" role=\"status\">24 records</p>\n</section>\n</forma-collection-toolbar>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "section.forma-collection-toolbar",
          "values": "string",
          "default": "—",
          "description": "Names the toolbar region after the collection it controls."
        },
        {
          "name": "role",
          "on": "form / .forma-collection-toolbar__count",
          "values": "search / status",
          "default": "—",
          "description": "`search` makes the form a search landmark; `status` makes the count a polite live region so result changes are announced."
        },
        {
          "name": "for",
          "on": "label.forma-search__label",
          "values": "id of the search input",
          "default": "—",
          "description": "Associates the visible label with the search input."
        },
        {
          "name": "type",
          "on": "input",
          "values": "search",
          "default": "—",
          "description": "Native search field with platform clear affordances."
        },
        {
          "name": "open",
          "on": "details.forma-collection-toolbar__filters",
          "values": "boolean",
          "default": "absent (closed)",
          "description": "Native disclosure state of the filter panel; the browser toggles it."
        },
        {
          "name": "name",
          "on": "input / select",
          "values": "string",
          "default": "—",
          "description": "Field names used when the application serializes the query, for example into the URL."
        },
        {
          "name": "selected",
          "on": "option",
          "values": "boolean",
          "default": "—",
          "description": "Initial selected filter, sort or view."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-collection-toolbar",
          "elements": [
            "forma-collection-toolbar__controls",
            "forma-collection-toolbar__count",
            "forma-collection-toolbar__filter-panel",
            "forma-collection-toolbar__filters",
            "forma-collection-toolbar__search"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through search, the filters summary, each select and any buttons in order."
        },
        {
          "keys": "Enter / Space on summary",
          "action": "Opens or closes the filter panel (native `details`). Escape does not close it natively."
        },
        {
          "keys": "Enter in search",
          "action": "Submits the search form; the application runs the query."
        },
        {
          "keys": "Arrow keys / Alt+Down on select",
          "action": "Native select behavior."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "disclosure",
            "name": "Filters 2 active",
            "expect": {
              "open": true
            }
          }
        ]
      },
      "examples": [
        {
          "id": "active-filters",
          "title": "Search term with active filters",
          "mobile": false,
          "raw": "components/collection-toolbar/active-filters.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "no-results",
          "title": "Search with no results",
          "mobile": false,
          "raw": "components/collection-toolbar/no-results.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Filters None active",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        },
        {
          "id": "mobile-toolbar",
          "title": "Mobile collection toolbar",
          "mobile": true,
          "raw": "components/collection-toolbar/mobile-toolbar.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Filters 1 active",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        }
      ],
      "related": [
        "active-filter-summary",
        "search",
        "data-grid",
        "flyout",
        "pagination"
      ]
    },
    {
      "slug": "combobox",
      "title": "Combobox",
      "tag": "forma-combobox",
      "category": "forms",
      "behavior": "Native baseline / Limen enhancement",
      "summary": "Searchable selection baseline that preserves direct text entry and native semantics.",
      "docsUrl": "components/combobox/",
      "pattern": "patterns/combobox.html",
      "minimalHtml": "<forma-combobox class=\"forma-component-tag\">\n<div class=\"forma-combobox\">\n  <label for=\"combo-project\">Project</label>\n  <div class=\"forma-combobox__control\">\n    <input id=\"combo-project\" name=\"project\" list=\"project-options\" autocomplete=\"off\" placeholder=\"Search projects\">\n    <span class=\"forma-combobox__indicator\" aria-hidden=\"true\">⌄</span>\n  </div>\n  <datalist id=\"project-options\">\n    <option value=\"Architecture assessment\"></option>\n    <option value=\"Signal research\"></option>\n    <option value=\"Platform modernization\"></option>\n  </datalist>\n  <p class=\"forma-combobox__help\">Type to filter available projects.</p>\n</div>\n</forma-combobox>",
      "attributes": [
        {
          "name": "list",
          "on": "input",
          "values": "id of a datalist",
          "default": "—",
          "description": "Connects the native suggestion list. Required for the no-script baseline."
        },
        {
          "name": "for",
          "on": "label",
          "values": "id of the input",
          "default": "—",
          "description": "Associates the visible label."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Form field name; the typed text is what is submitted."
        },
        {
          "name": "autocomplete",
          "on": "input",
          "values": "off",
          "default": "browser heuristic",
          "description": "Stops the browser's form history from mixing with the datalist suggestions."
        },
        {
          "name": "value",
          "on": "option",
          "values": "string",
          "default": "—",
          "description": "Suggested value inside the datalist."
        },
        {
          "name": "placeholder",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Optional example text; never a replacement for the label."
        },
        {
          "name": "required",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Native constraint against an empty value; does not require a listed value."
        },
        {
          "name": "aria-describedby",
          "on": "input",
          "values": "id list",
          "default": "—",
          "description": "Links the help text and any validation message."
        },
        {
          "name": "aria-invalid",
          "on": "input",
          "values": "true",
          "default": "absent",
          "description": "Set by the application when the typed value is not accepted."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-combobox",
          "elements": [
            "forma-combobox__control",
            "forma-combobox__help",
            "forma-combobox__indicator"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Typing",
          "action": "Filters the native suggestion list (matching rules are browser-owned)."
        },
        {
          "keys": "ArrowDown / ArrowUp",
          "action": "Opens and moves through suggestions in browsers that show a datalist popup."
        },
        {
          "keys": "Enter",
          "action": "Accepts the highlighted suggestion; with no suggestion open, submits the form natively."
        },
        {
          "keys": "Escape",
          "action": "Closes the suggestion popup in most browsers."
        },
        {
          "keys": "Limen enhancement",
          "action": "A custom listbox must implement the WAI-ARIA combobox pattern (aria-expanded, aria-activedescendant, Home/End) in application code; Forma provides none of it."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "free-entry-labels",
          "title": "Label with new values allowed",
          "mobile": false,
          "raw": "components/combobox/free-entry-labels.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "unrecognized-value",
          "title": "Unrecognized value",
          "mobile": false,
          "raw": "components/combobox/unrecognized-value.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-assignee",
          "title": "Mobile assignee field",
          "mobile": true,
          "raw": "components/combobox/mobile-assignee.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "select",
        "search",
        "text-field",
        "command-palette"
      ]
    },
    {
      "slug": "command-group",
      "title": "Command group",
      "tag": "forma-command-group",
      "category": "actions",
      "behavior": "Application content",
      "summary": "Groups related commands under an explicit, visible task label without owning command authority.",
      "docsUrl": "components/command-group/",
      "pattern": "patterns/command-group.html",
      "minimalHtml": "<forma-command-group class=\"forma-component-tag\">\n<section class=\"forma-command-group\" aria-labelledby=\"edit-commands\">\n  <h2 class=\"forma-command-group__label\" id=\"edit-commands\">Edit</h2>\n  <div class=\"forma-command-group__commands\">\n    <button type=\"button\">Cut</button><button type=\"button\">Copy</button><button type=\"button\">Paste</button>\n  </div>\n</section>\n</forma-command-group>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-command-group",
          "values": "id of .forma-command-group__label",
          "default": "—",
          "description": "Required. Names the group from its visible heading so the region and its commands are announced with their task context."
        },
        {
          "name": "id",
          "on": ".forma-command-group__label",
          "values": "unique id",
          "default": "—",
          "description": "Target of aria-labelledby. Must be unique on the page."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Commands are ordinary buttons; set type=\"button\" so they never submit an enclosing form."
        },
        {
          "name": "disabled",
          "on": "button",
          "values": "boolean",
          "default": "absent",
          "description": "Renders an application-decided unavailable command. Pair it with visible text explaining why."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-command-group",
          "elements": [
            "forma-command-group__commands",
            "forma-command-group__label"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the commands one by one in source order. Forma adds no arrow-key toolbar navigation; an ARIA toolbar with roving focus is application/Limen behavior."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused command (native button behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "document-toolbar",
          "title": "Document toolbar with two groups",
          "mobile": false,
          "raw": "components/command-group/document-toolbar.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "unavailable-command",
          "title": "Command unavailable with a visible reason",
          "mobile": false,
          "raw": "components/command-group/unavailable-command.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-record-commands",
          "title": "Record commands on a phone",
          "mobile": true,
          "raw": "components/command-group/mobile-record-commands.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "button",
        "overflow-command-disclosure",
        "menu",
        "collection-toolbar",
        "command-palette"
      ]
    },
    {
      "slug": "command-palette",
      "title": "Command palette",
      "tag": "forma-command-palette",
      "category": "keyboard",
      "behavior": "Application / Limen",
      "summary": "Keyboard-first command discovery that can become a full-screen mobile surface.",
      "docsUrl": "components/command-palette/",
      "pattern": "patterns/command-palette.html",
      "minimalHtml": "<forma-command-palette class=\"forma-component-tag\">\n<dialog class=\"forma-command-palette\" open aria-labelledby=\"command-title\" data-forma-motion-weight=\"heavy\">\n  <header class=\"forma-command-palette__header\">\n    <h3 id=\"command-title\">Commands</h3>\n    <kbd>Esc</kbd>\n  </header>\n  <label class=\"forma-visually-hidden\" for=\"command-search\">Find a command</label>\n  <input id=\"command-search\" type=\"search\" placeholder=\"Type a command or record\">\n  <div class=\"forma-command-palette__group\">\n    <h4>Suggested</h4>\n    <button type=\"button\"><span>Create invoice</span><kbd>⌘ I</kbd></button>\n    <button type=\"button\"><span>Show items needing attention</span></button>\n    <button type=\"button\" disabled><span>Publish report</span><small>Unavailable until validation passes</small></button>\n  </div>\n</dialog>\n</forma-command-palette>",
      "attributes": [
        {
          "name": "open",
          "on": "dialog",
          "values": "boolean",
          "default": "absent (closed)",
          "description": "Native open state. Written in markup it shows the palette non-modally, as in the canonical pattern; for real use open it modally with an invoker or `showModal()` so focus is contained."
        },
        {
          "name": "commandfor",
          "on": "invoker button",
          "values": "id of the dialog",
          "default": "—",
          "description": "Native invoker target. Pair with `command`."
        },
        {
          "name": "command",
          "on": "invoker button",
          "values": "show-modal | close",
          "default": "—",
          "description": "`show-modal` opens the palette as a modal; `close` closes it. No script needed."
        },
        {
          "name": "aria-labelledby",
          "on": "dialog",
          "values": "id of the header heading",
          "default": "—",
          "description": "Names the dialog after its visible title."
        },
        {
          "name": "aria-describedby",
          "on": "search input",
          "values": "id of the result status",
          "default": "—",
          "description": "Optionally links the result-count or empty-result message to the search field."
        },
        {
          "name": "type",
          "on": "input / button",
          "values": "search / button",
          "default": "—",
          "description": "Use a search input and `type=\"button\"` commands so nothing submits a form by accident."
        },
        {
          "name": "disabled",
          "on": "command button",
          "values": "boolean",
          "default": "absent",
          "description": "Command is known but blocked now; put the reason in a `small` inside the button."
        },
        {
          "name": "role",
          "on": "result message",
          "values": "status",
          "default": "—",
          "description": "Announces result counts and empty results without moving focus."
        },
        {
          "name": "data-forma-motion-weight",
          "on": "dialog",
          "values": "light | standard | heavy",
          "default": "heavy (by CSS default)",
          "description": "Presentation-only mass for the entry and exit motion. See hooks."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-command-palette",
          "elements": [
            "forma-command-palette__group",
            "forma-command-palette__header"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            },
            {
              "name": "open",
              "values": []
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between the search input, the Close button and each enabled command button; disabled commands are skipped natively."
        },
        {
          "keys": "Enter / Space on a command",
          "action": "Activates the command button natively; the application runs the command and closes the dialog."
        },
        {
          "keys": "Escape",
          "action": "Closes the palette natively when it was opened modally and returns focus to the invoker. A non-modal `open` palette does not close on Escape unless the application handles it."
        },
        {
          "keys": "Ctrl+K, arrow keys, type-ahead",
          "action": "Not built in. The opening shortcut, arrow-key movement between results and filtering as you type are application or Limen behavior."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "toolbar-invoker",
          "title": "Opened from a toolbar button",
          "mobile": false,
          "raw": "components/command-palette/toolbar-invoker.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "no-results",
          "title": "No matching commands",
          "mobile": false,
          "raw": "components/command-palette/no-results.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "unavailable-commands",
          "title": "Unavailable commands with reasons",
          "mobile": false,
          "raw": "components/command-palette/unavailable-commands.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-full-screen",
          "title": "Full-screen palette on a phone",
          "mobile": true,
          "raw": "components/command-palette/mobile-full-screen.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "dialog",
        "menu",
        "combobox",
        "search"
      ]
    },
    {
      "slug": "comparison-grid",
      "title": "Comparison grid",
      "tag": "forma-comparison-grid",
      "category": "data",
      "behavior": "Application content",
      "summary": "Preserves cross-item comparison relationships in a bounded two-dimensional surface.",
      "docsUrl": "components/comparison-grid/",
      "pattern": "patterns/comparison-grid.html",
      "minimalHtml": "<forma-comparison-grid class=\"forma-component-tag\">\n<div class=\"forma-comparison-grid\" role=\"region\" aria-label=\"Plan comparison\" tabindex=\"0\">\n  <table>\n    <caption>Plan comparison</caption>\n    <thead><tr><th scope=\"col\">Capability</th><th scope=\"col\">Standard</th><th scope=\"col\">Advanced</th></tr></thead>\n    <tbody><tr><th scope=\"row\">Evidence history</th><td>30 days</td><td>Unlimited</td></tr><tr><th scope=\"row\">Exports</th><td>Manual</td><td>Automated</td></tr></tbody>\n  </table>\n</div>\n</forma-comparison-grid>",
      "attributes": [
        {
          "name": "role",
          "on": ".forma-comparison-grid",
          "values": "region",
          "default": "—",
          "description": "Makes the scroll container a named landmark."
        },
        {
          "name": "aria-label",
          "on": ".forma-comparison-grid",
          "values": "string",
          "default": "—",
          "description": "Names the region, usually the same as the table caption."
        },
        {
          "name": "tabindex",
          "on": ".forma-comparison-grid",
          "values": "0",
          "default": "—",
          "description": "Lets keyboard users focus and scroll the region."
        },
        {
          "name": "scope",
          "on": "th",
          "values": "col | row",
          "default": "—",
          "description": "`col` on item headers, `row` on attribute headers, so each cell is announced with both."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-comparison-grid",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab",
          "action": "Focuses the region."
        },
        {
          "keys": "Arrow keys",
          "action": "Scroll the focused region natively. There is no cell navigation."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "not-included-and-unknown",
          "title": "Not included and unknown values",
          "mobile": false,
          "raw": "components/comparison-grid/not-included-and-unknown.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "wide-vendor-comparison",
          "title": "Wide vendor comparison",
          "mobile": false,
          "raw": "components/comparison-grid/wide-vendor-comparison.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-release-comparison",
          "title": "Mobile release comparison",
          "mobile": true,
          "raw": "components/comparison-grid/mobile-release-comparison.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "comparison-pairs",
        "dense-ledger",
        "bounded-overflow",
        "data-grid"
      ]
    },
    {
      "slug": "comparison-pairs",
      "title": "Comparison pairs",
      "tag": "forma-comparison-pairs",
      "category": "data",
      "behavior": "Application content",
      "summary": "Before/after or peer comparison that repeats labels and preserves the comparison task when columns collapse on narrow screens.",
      "docsUrl": "components/comparison-pairs/",
      "pattern": "patterns/comparison-pairs.html",
      "minimalHtml": "<forma-comparison-pairs class=\"forma-component-tag\">\n<section class=\"forma-comparison-pairs\" aria-labelledby=\"comparison-pairs-title\">\n  <h3 id=\"comparison-pairs-title\">Configuration change</h3>\n  <div class=\"forma-comparison-pairs__item\">\n    <div class=\"forma-comparison-pairs__label\">Retention</div>\n    <div class=\"forma-comparison-pairs__value\" data-side=\"before\" data-label=\"Before\">30 days</div>\n    <div class=\"forma-comparison-pairs__value\" data-side=\"after\" data-label=\"After\">Unlimited</div>\n  </div>\n  <div class=\"forma-comparison-pairs__item\">\n    <div class=\"forma-comparison-pairs__label\">Export</div>\n    <div class=\"forma-comparison-pairs__value\" data-side=\"before\" data-label=\"Before\">Manual</div>\n    <div class=\"forma-comparison-pairs__value\" data-side=\"after\" data-label=\"After\">Automated after approval</div>\n  </div>\n</section>\n</forma-comparison-pairs>",
      "attributes": [
        {
          "name": "data-side",
          "on": ".forma-comparison-pairs__value",
          "values": "before | after",
          "default": "—",
          "description": "Position of the value in the pair. Required for the caption to render; both values look the same."
        },
        {
          "name": "data-label",
          "on": ".forma-comparison-pairs__value",
          "values": "string",
          "default": "—",
          "description": "Caption printed above the value (Before, After, Current, Proposed or a peer name). Keep it identical for every value in the same position."
        },
        {
          "name": "aria-labelledby",
          "on": "section.forma-comparison-pairs",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the comparison."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO date",
          "default": "—",
          "description": "Machine-readable form of date values."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-comparison-pairs",
          "elements": [
            "forma-comparison-pairs__item",
            "forma-comparison-pairs__label",
            "forma-comparison-pairs__value"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-side",
              "values": [
                "after",
                "before"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "None",
          "action": "Static content; links inside values are reached with Tab as usual."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "access-change",
          "title": "Access change awaiting approval",
          "mobile": false,
          "raw": "components/comparison-pairs/access-change.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "peer-regions",
          "title": "Two regions compared, with an unknown value",
          "mobile": false,
          "raw": "components/comparison-pairs/peer-regions.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-plan-change",
          "title": "Mobile plan change",
          "mobile": true,
          "raw": "components/comparison-pairs/mobile-plan-change.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "diff-viewer",
        "comparison-grid",
        "conflict-review",
        "verification-frame"
      ]
    },
    {
      "slug": "composer",
      "title": "Composer",
      "tag": "forma-composer",
      "category": "assisted",
      "behavior": "Application / Limen",
      "summary": "Natural-language composition surface for type, dictate, paste, and attach workflows without embedding agent behavior.",
      "docsUrl": "components/composer/",
      "pattern": "patterns/composer.html",
      "minimalHtml": "<forma-composer class=\"forma-component-tag\">\n<section class=\"forma-composer\" aria-labelledby=\"composer-title\">\n  <div class=\"forma-composer__context\">\n    <span class=\"forma-component-kicker\">Capture</span>\n    <h2 id=\"composer-title\">What do you want this record to know?</h2>\n    <p id=\"composer-help\">Type, dictate, paste, or attach information in your own words. The application decides how it is interpreted and whether follow-up is required.</p>\n  </div>\n  <label class=\"forma-composer__field\">\n    <span class=\"forma-sr-only\">Tell the application what happened</span>\n    <textarea rows=\"4\" aria-describedby=\"composer-help\" placeholder=\"Tell me what happened…\"></textarea>\n  </label>\n  <div class=\"forma-composer__actions\">\n    <div class=\"forma-composer__input-actions\" aria-label=\"Additional input methods\">\n      <button type=\"button\">Attach</button>\n      <button type=\"button\">Dictate</button>\n    </div>\n    <button type=\"submit\" class=\"forma-composer__submit\">Continue</button>\n  </div>\n  <p class=\"forma-composer__status\" role=\"status\">Nothing is added to the record until the application confirms the transition.</p>\n</section>\n</forma-composer>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "root form or section",
          "values": "id of the context heading",
          "default": "—",
          "description": "Names the composer by its visible question or purpose."
        },
        {
          "name": "aria-describedby",
          "on": "textarea",
          "values": "id(s) of help and attachment text",
          "default": "—",
          "description": "Announces the help text (and attachment list) with the field."
        },
        {
          "name": "name",
          "on": "textarea",
          "values": "string",
          "default": "—",
          "description": "Form field name when the composer is a native form."
        },
        {
          "name": "rows",
          "on": "textarea",
          "values": "number",
          "default": "2",
          "description": "Initial visible lines; Forma also sets an 8rem minimum height."
        },
        {
          "name": "placeholder",
          "on": "textarea",
          "values": "string",
          "default": "—",
          "description": "Optional example phrasing. Never a substitute for the label or help."
        },
        {
          "name": "role",
          "on": "input-actions group, status",
          "values": "group | status",
          "default": "—",
          "description": "`group` names the secondary input methods together; `status` makes the status line a polite live region."
        },
        {
          "name": "aria-label",
          "on": "input-actions group",
          "values": "string",
          "default": "—",
          "description": "Names the group, for example \"Additional input methods\"."
        },
        {
          "name": "aria-pressed",
          "on": "Dictate button",
          "values": "true | false",
          "default": "—",
          "description": "Exposes whether dictation is active when the button toggles recording."
        },
        {
          "name": "type",
          "on": "buttons",
          "values": "submit | button",
          "default": "submit inside a form",
          "description": "Only the continuation action submits; input-method buttons must be type=\"button\"."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-composer",
          "elements": [
            "forma-composer__actions",
            "forma-composer__context",
            "forma-composer__field",
            "forma-composer__input-actions",
            "forma-composer__status",
            "forma-composer__submit"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves from the textarea to input-method buttons and the submit button."
        },
        {
          "keys": "Enter in the textarea",
          "action": "Inserts a new line (native textarea). Submitting on Enter or Ctrl+Enter is application behavior if wanted."
        },
        {
          "keys": "Enter / Space on a button",
          "action": "Activates it natively. The submit button submits the form."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "no-assistance",
          "title": "Assistance unavailable",
          "mobile": false,
          "raw": "components/composer/no-assistance.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior",
              "form-handling"
            ]
          }
        },
        {
          "id": "dictating-with-attachment",
          "title": "Dictating with an attachment",
          "mobile": false,
          "raw": "components/composer/dictating-with-attachment.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior",
              "form-handling"
            ]
          }
        },
        {
          "id": "mobile-capture",
          "title": "Mobile capture",
          "mobile": true,
          "raw": "components/composer/mobile-capture.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior",
              "form-handling"
            ]
          }
        }
      ],
      "related": [
        "conversation",
        "understanding",
        "textarea",
        "file-upload"
      ]
    },
    {
      "slug": "conflict-review",
      "title": "Conflict review",
      "tag": "forma-conflict-review",
      "category": "feedback",
      "behavior": "Ordo / application",
      "summary": "Explains an optimistic-concurrency conflict, shows what changed, and offers only application-supplied recovery actions.",
      "docsUrl": "components/conflict-review/",
      "pattern": "patterns/conflict-review.html",
      "minimalHtml": "<forma-conflict-review class=\"forma-component-tag\">\n<article class=\"forma-conflict-review\" aria-labelledby=\"conflict-title\">\n  <header class=\"forma-conflict-review__header\">\n    <span class=\"forma-status-lozenge\" data-state=\"attention\">Conflict</span>\n    <h3 id=\"conflict-title\">This record changed while you were reviewing it</h3>\n    <p>No changes were applied. Review the current version before choosing a legal recovery action.</p>\n  </header>\n  <div class=\"forma-diff-viewer\">\n    <div class=\"forma-diff-viewer__grid\">\n      <section class=\"forma-diff-viewer__side\"><h4>You reviewed</h4><p>Outstanding balance: $5,000</p></section>\n      <section class=\"forma-diff-viewer__side\"><h4>Current</h4><p>Outstanding balance: $2,500</p></section>\n    </div>\n  </div>\n  <footer class=\"forma-conflict-review__actions\">\n    <button type=\"button\">Reload current</button>\n    <button type=\"button\">Cancel</button>\n  </footer>\n</article>\n</forma-conflict-review>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "article.forma-conflict-review",
          "values": "id of the header heading",
          "default": "—",
          "description": "Names the article from its heading."
        },
        {
          "name": "aria-label",
          "on": ".forma-diff-viewer__side",
          "values": "string",
          "default": "—",
          "description": "Names each side of the comparison (the version reviewed and the current version)."
        },
        {
          "name": "data-state",
          "on": ".forma-status-lozenge",
          "values": "attention | blocked",
          "default": "—",
          "description": "Glyph for the conflict lozenge."
        },
        {
          "name": "data-change",
          "on": ".forma-diff-row",
          "values": "changed",
          "default": "absent",
          "description": "Marks a row whose value differs between versions. See [[diff-viewer]]."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-conflict-review",
          "elements": [
            "forma-conflict-review__actions",
            "forma-conflict-review__header"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the recovery actions. The comparison itself is static content."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused action (native button behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "multiple-fields",
          "title": "Several fields changed",
          "mobile": false,
          "raw": "components/conflict-review/multiple-fields.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "record-deleted",
          "title": "Record deleted by someone else",
          "mobile": false,
          "raw": "components/conflict-review/record-deleted.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-balance-conflict",
          "title": "Mobile balance conflict",
          "mobile": true,
          "raw": "components/conflict-review/mobile-balance-conflict.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "diff-viewer",
        "operation-status",
        "recovery-actions"
      ]
    },
    {
      "slug": "container",
      "title": "Container",
      "tag": "forma-container",
      "category": "layout",
      "behavior": "Native CSS",
      "summary": "Marketing-layer width container (narrow, default, wide, max) with a breakout escape for full-bleed media.",
      "docsUrl": "components/container/",
      "pattern": "patterns/container.html",
      "minimalHtml": "<forma-container class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <div class=\"forma-container\" data-forma-width=\"narrow\">\n    <h2>Privacy notice</h2>\n    <p>Narrow containers keep reading-focused regions at a comfortable measure while the page background stays full width.</p>\n  </div>\n</div>\n</forma-container>",
      "attributes": [
        {
          "name": "data-forma-width",
          "on": ".forma-container",
          "values": "narrow | wide | max",
          "default": "absent (standard, 64rem)",
          "description": "Selects a width preset from the layout role tokens."
        },
        {
          "name": "style",
          "on": ".forma-container / .forma-breakout",
          "values": "--forma-container-width / --forma-breakout-max / --forma-frame-ratio",
          "default": "—",
          "description": "Per-instance width override, or the frame ratio in the figure example."
        },
        {
          "name": "aria-labelledby",
          "on": "form",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the sign-up form by its heading."
        },
        {
          "name": "data-forma-columns",
          "on": ".forma-card-grid",
          "values": "3",
          "default": "—",
          "description": "Card grid column preference, used in the wide container example."
        },
        {
          "name": "aria-label",
          "on": ".forma-card-grid",
          "values": "string",
          "default": "—",
          "description": "Names the card collection."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-container",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-width",
              "values": [
                "max",
                "narrow",
                "wide"
              ]
            }
          ],
          "customProperties": [
            {
              "name": "--forma-container-width",
              "default": "var(--forma-layout-width-narrow)"
            }
          ]
        },
        {
          "root": "forma-breakout",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": [
            {
              "name": "--forma-breakout-max",
              "default": null
            }
          ]
        }
      ],
      "keyboard": [],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "narrow-article-wide-figure",
          "title": "Narrow article with a wide figure",
          "mobile": false,
          "raw": "components/container/narrow-article-wide-figure.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "wide-grid-region",
          "title": "Wide container for a card grid",
          "mobile": false,
          "raw": "components/container/wide-grid-region.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "custom-width",
          "title": "Custom width for a sign-up form",
          "mobile": false,
          "raw": "components/container/custom-width.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "mobile-container",
          "title": "Mobile page width",
          "mobile": true,
          "raw": "components/container/mobile-container.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "measure",
        "section",
        "marketing-shell",
        "prose"
      ]
    },
    {
      "slug": "conversation",
      "title": "Conversation",
      "tag": "forma-conversation",
      "category": "assisted",
      "behavior": "Application / Limen",
      "summary": "Inspectable user/application turns with explicit speakers and no consumer-chat authority assumptions.",
      "docsUrl": "components/conversation/",
      "pattern": "patterns/conversation.html",
      "minimalHtml": "<forma-conversation class=\"forma-component-tag\">\n<section class=\"forma-conversation\" aria-labelledby=\"conversation-title\">\n  <header class=\"forma-conversation__header\">\n    <span class=\"forma-component-kicker\">Conversation</span>\n    <h2 id=\"conversation-title\">Record assistant</h2>\n  </header>\n  <ol class=\"forma-conversation__turns\">\n    <li class=\"forma-turn\" data-forma-speaker=\"user\">\n      <p class=\"forma-turn__speaker\">You</p>\n      <div class=\"forma-turn__content\">\n        <p>Dad saw Dr. Smith yesterday. He increased the medication to 40 mg because the ankle swelling returned.</p>\n      </div>\n    </li>\n    <li class=\"forma-turn\" data-forma-speaker=\"assistant\">\n      <p class=\"forma-turn__speaker\">Record assistant</p>\n      <div class=\"forma-turn__content\">\n        <p>I found a medication change, a returning symptom, and a visit. One detail may need clarification before the medication change can be recorded precisely.</p>\n      </div>\n      <div class=\"forma-turn__actions\">\n        <button type=\"button\">Review understanding</button>\n      </div>\n    </li>\n  </ol>\n</section>\n</forma-conversation>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "root section",
          "values": "id of the conversation heading",
          "default": "—",
          "description": "Names the conversation region."
        },
        {
          "name": "data-forma-speaker",
          "on": ".forma-turn",
          "values": "assistant | user",
          "default": "absent",
          "description": "Speaker category for presentation. `assistant` tints the turn; `user` (or absent) is untinted. The visible speaker label is the authoritative cue."
        },
        {
          "name": "data-state",
          "on": ".forma-status-lozenge",
          "values": "ok | attention | blocked | unknown",
          "default": "absent",
          "description": "Adds a symbol to a text status inside a turn."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-conversation",
          "elements": [
            "forma-conversation__header",
            "forma-conversation__turns"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-turn",
          "elements": [
            "forma-turn__actions",
            "forma-turn__content",
            "forma-turn__speaker"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-speaker",
              "values": [
                "assistant"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through links and action buttons in turn order. No added keyboard behavior."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "multi-party",
          "title": "Multi-party care conversation",
          "mobile": false,
          "raw": "components/conversation/multi-party.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "failed-turn",
          "title": "Application turn that could not complete",
          "mobile": false,
          "raw": "components/conversation/failed-turn.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-history",
          "title": "Mobile history",
          "mobile": true,
          "raw": "components/conversation/mobile-history.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "composer",
        "understanding",
        "handoff-summary",
        "timeline"
      ]
    },
    {
      "slug": "dashboard-grid",
      "title": "Dashboard grid",
      "tag": "forma-dashboard-grid",
      "category": "workspaces",
      "behavior": "Application content",
      "summary": "Responsive operational dashboard composition for metrics, status, and attention-first blocks.",
      "docsUrl": "components/dashboard-grid/",
      "pattern": "patterns/dashboard-grid.html",
      "minimalHtml": "<forma-dashboard-grid class=\"forma-component-tag\">\n<section class=\"forma-dashboard-grid\" aria-label=\"Operational dashboard\">\n  <article class=\"forma-metric-card\"><div class=\"forma-metric-card__label\">Needs attention</div><div class=\"forma-metric-card__value\">7</div><p>Items requiring action.</p></article>\n  <article class=\"forma-metric-card\"><div class=\"forma-metric-card__label\">Open work</div><div class=\"forma-metric-card__value\">18</div><p>Currently active records.</p></article>\n  <article class=\"forma-metric-card\"><div class=\"forma-metric-card__label\">Completed</div><div class=\"forma-metric-card__value\">42</div><p>Completed this month.</p></article>\n</section>\n</forma-dashboard-grid>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "root section",
          "values": "string",
          "default": "—",
          "description": "Names the dashboard region when it has no visible heading."
        },
        {
          "name": "aria-labelledby",
          "on": "root section, metric article",
          "values": "id of a visible heading or label",
          "default": "—",
          "description": "Names the region or an individual block by its visible text."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-dashboard-grid",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through links in the blocks in source order. The grid adds no keyboard behavior."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "attention-first",
          "title": "Attention-first operations overview",
          "mobile": false,
          "raw": "components/dashboard-grid/attention-first.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "unknown-and-stale",
          "title": "Unavailable and stale values",
          "mobile": false,
          "raw": "components/dashboard-grid/unknown-and-stale.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-single-column",
          "title": "Mobile single column",
          "mobile": true,
          "raw": "components/dashboard-grid/mobile-single-column.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "metric-card",
        "responsive-grid",
        "mosaic",
        "work-queue"
      ]
    },
    {
      "slug": "data-grid",
      "title": "Data grid",
      "tag": "forma-data-grid",
      "category": "data",
      "behavior": "Application / Limen",
      "summary": "Semantic tabular records with sortable-column affordances, contained horizontal overflow and a labeled record projection on phones.",
      "docsUrl": "components/data-grid/",
      "pattern": "patterns/data-grid.html",
      "minimalHtml": "<forma-data-grid class=\"forma-component-tag\">\n<div class=\"forma-data-grid\" role=\"region\" tabindex=\"0\" aria-label=\"Invoice records\">\n  <table>\n    <caption class=\"forma-visually-hidden\">Invoice records</caption>\n    <thead>\n      <tr>\n        <th scope=\"col\" aria-sort=\"ascending\"><button type=\"button\">Invoice</button></th>\n        <th scope=\"col\"><button type=\"button\">Customer</button></th>\n        <th scope=\"col\"><button type=\"button\">Due</button></th>\n        <th scope=\"col\"><button type=\"button\">Status</button></th>\n        <th scope=\"col\"><span class=\"forma-visually-hidden\">Actions</span></th>\n      </tr>\n    </thead>\n    <tbody>\n      <tr>\n        <td data-label=\"Invoice\">INV-1042</td>\n        <td data-label=\"Customer\">Acme Manufacturing</td>\n        <td data-label=\"Due\">Oct 4, 2026</td>\n        <td data-label=\"Status\"><span class=\"forma-status-lozenge\" data-state=\"attention\">Overdue</span></td>\n        <td data-label=\"Actions\"><button type=\"button\">Open</button></td>\n      </tr>\n      <tr>\n        <td data-label=\"Invoice\">INV-1043</td>\n        <td data-label=\"Customer\">Northstar Labs</td>\n        <td data-label=\"Due\">Oct 18, 2026</td>\n        <td data-label=\"Status\"><span class=\"forma-status-lozenge\" data-state=\"ok\">Current</span></td>\n        <td data-label=\"Actions\"><button type=\"button\">Open</button></td>\n      </tr>\n    </tbody>\n  </table>\n</div>\n</forma-data-grid>",
      "attributes": [
        {
          "name": "role",
          "on": ".forma-data-grid",
          "values": "region",
          "default": "—",
          "description": "Makes the scroll container a named landmark so keyboard and screen-reader users can find and scroll it."
        },
        {
          "name": "tabindex",
          "on": ".forma-data-grid",
          "values": "0",
          "default": "—",
          "description": "Lets keyboard users focus the region and scroll overflowing columns with the arrow keys."
        },
        {
          "name": "aria-label",
          "on": ".forma-data-grid",
          "values": "string",
          "default": "—",
          "description": "Names the region. Use a distinct name per grid on the page."
        },
        {
          "name": "scope",
          "on": "th",
          "values": "col",
          "default": "—",
          "description": "Associates each header with its column on wide layouts."
        },
        {
          "name": "aria-sort",
          "on": "th",
          "values": "ascending | descending",
          "default": "absent (unsorted)",
          "description": "Written by the application on the one sorted column. Forma appends ↑ or ↓ to the header button from this value."
        },
        {
          "name": "data-label",
          "on": "td",
          "values": "column name",
          "default": "—",
          "description": "Required on every cell. Printed as the cell's label at 30rem and below, when the header row is hidden. `Actions` also stretches the cell's children to full width."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Header sort buttons and row actions are native buttons; `type=\"button\"` prevents accidental form submission."
        },
        {
          "name": "aria-label",
          "on": "row action button",
          "values": "string",
          "default": "—",
          "description": "Names the record a repeated action applies to, such as \"Open INV-1042\"."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO date",
          "default": "—",
          "description": "Machine-readable date for date cells; the visible text stays human-formatted."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-data-grid",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the region, the header sort buttons and row actions in document order."
        },
        {
          "keys": "Arrow keys",
          "action": "Scroll the focused region horizontally and vertically (native scrolling). There is no cell-by-cell navigation."
        },
        {
          "keys": "Enter / Space",
          "action": "Activate a focused sort button or row action. What sorting does is application behavior."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "descending-sort",
          "title": "Sorted by due date, newest first",
          "mobile": false,
          "raw": "components/data-grid/descending-sort.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "empty-result",
          "title": "Empty result",
          "mobile": false,
          "raw": "components/data-grid/empty-result.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "wide-record-set",
          "title": "Many columns and long values",
          "mobile": false,
          "raw": "components/data-grid/wide-record-set.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-record-projection",
          "title": "Mobile record projection",
          "mobile": true,
          "raw": "components/data-grid/mobile-record-projection.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "dense-ledger",
        "collection-toolbar",
        "comparison-grid",
        "pagination",
        "bounded-overflow"
      ]
    },
    {
      "slug": "date-time-field",
      "title": "Date and time field",
      "tag": "forma-date-time-field",
      "category": "forms",
      "behavior": "Native HTML",
      "summary": "Native date, time and datetime-local inputs in the .forma-field structure, keeping the platform picker and direct typed entry.",
      "docsUrl": "components/date-time-field/",
      "pattern": "patterns/date-time-field.html",
      "minimalHtml": "<forma-date-time-field class=\"forma-component-tag\">\n<div class=\"forma-field\">\n  <label class=\"forma-field__label\" for=\"date-time-field-due\">Due date</label>\n  <span class=\"forma-field__description\" id=\"date-time-field-due-description\">The browser supplies its own date picker; typing the date also works.</span>\n  <input id=\"date-time-field-due\" name=\"due\" type=\"date\" aria-describedby=\"date-time-field-due-description\">\n</div>\n</forma-date-time-field>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "date | time | datetime-local",
          "default": "—",
          "description": "Selects the native control and its value format (YYYY-MM-DD, HH:MM[:SS], YYYY-MM-DDTHH:MM)."
        },
        {
          "name": "for",
          "on": "label.forma-field__label",
          "values": "id of the input",
          "default": "—",
          "description": "Associates the visible label."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Form field name; the submitted value is always in ISO form."
        },
        {
          "name": "value",
          "on": "input",
          "values": "ISO date/time string",
          "default": "empty",
          "description": "Initial value in the machine format for the type, not a localized string."
        },
        {
          "name": "min",
          "on": "input",
          "values": "ISO date/time string",
          "default": "—",
          "description": "Earliest allowed value. Pickers typically grey out earlier values; typed earlier values fail validation."
        },
        {
          "name": "max",
          "on": "input",
          "values": "ISO date/time string",
          "default": "—",
          "description": "Latest allowed value."
        },
        {
          "name": "step",
          "on": "input",
          "values": "seconds (time, datetime-local) or days (date)",
          "default": "60 for time, 1 for date",
          "description": "Allowed increment; 900 means 15-minute slots. Values off the step fail validation."
        },
        {
          "name": "required",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Native constraint: the form will not submit while empty."
        },
        {
          "name": "aria-describedby",
          "on": "input",
          "values": "id list",
          "default": "—",
          "description": "Links the description (state bounds and time zone there) and any validation message."
        },
        {
          "name": "aria-invalid",
          "on": "input",
          "values": "true",
          "default": "absent",
          "description": "Set by the application while a linked validation message is shown."
        }
      ],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus to the input; in most browsers Tab also moves between the day, month, year, hour and minute segments."
        },
        {
          "keys": "ArrowUp / ArrowDown",
          "action": "Increments or decrements the focused segment (native, browser-dependent)."
        },
        {
          "keys": "Digits",
          "action": "Types directly into the focused segment."
        },
        {
          "keys": "Browser picker shortcut",
          "action": "Opening the picker from the keyboard (for example Alt+ArrowDown or Space) varies by browser; typed entry never requires it."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "appointment-slot",
          "title": "Appointment date and time",
          "mobile": false,
          "raw": "components/date-time-field/appointment-slot.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "maintenance-window",
          "title": "Scheduled maintenance start",
          "mobile": false,
          "raw": "components/date-time-field/maintenance-window.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "date-out-of-range",
          "title": "Date outside the allowed range",
          "mobile": false,
          "raw": "components/date-time-field/date-out-of-range.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-delivery-window",
          "title": "Mobile delivery booking",
          "mobile": true,
          "raw": "components/date-time-field/mobile-delivery-window.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "date-range",
        "text-field",
        "numeric-stepper"
      ]
    },
    {
      "slug": "date-range",
      "title": "Date range",
      "tag": "forma-date-range",
      "category": "forms",
      "behavior": "Native HTML / application",
      "summary": "Paired direct date entry with reusable preset affordances and mobile stacking.",
      "docsUrl": "components/date-range/",
      "pattern": "patterns/date-range.html",
      "minimalHtml": "<forma-date-range class=\"forma-component-tag\">\n<fieldset class=\"forma-date-range\">\n  <legend>Date range</legend>\n  <div class=\"forma-date-range__fields\">\n    <label>From <input type=\"date\" name=\"from\"></label>\n    <span class=\"forma-date-range__separator\" aria-hidden=\"true\">→</span>\n    <label>To <input type=\"date\" name=\"to\"></label>\n  </div>\n  <div class=\"forma-date-range__presets\" aria-label=\"Common ranges\">\n    <button type=\"button\">This month</button>\n    <button type=\"button\">Last 30 days</button>\n    <button type=\"button\">Year to date</button>\n  </div>\n</fieldset>\n</forma-date-range>",
      "attributes": [
        {
          "name": "type",
          "on": "input / button",
          "values": "date on inputs; button on presets",
          "default": "—",
          "description": "Native date inputs; presets are type=button so they never submit the form."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Separate names for the start and end dates; values submit in ISO YYYY-MM-DD form."
        },
        {
          "name": "value",
          "on": "input",
          "values": "YYYY-MM-DD",
          "default": "empty",
          "description": "Initial dates in machine format."
        },
        {
          "name": "min",
          "on": "input",
          "values": "YYYY-MM-DD",
          "default": "—",
          "description": "Earliest allowed date for that input."
        },
        {
          "name": "max",
          "on": "input",
          "values": "YYYY-MM-DD",
          "default": "—",
          "description": "Latest allowed date for that input. Native constraints do not relate From to To."
        },
        {
          "name": "required",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Blocks submission while that date is empty."
        },
        {
          "name": "role",
          "on": ".forma-date-range__presets",
          "values": "group",
          "default": "—",
          "description": "Gives the preset container a role so its aria-label is exposed."
        },
        {
          "name": "aria-label",
          "on": ".forma-date-range__presets",
          "values": "string",
          "default": "—",
          "description": "Names the preset group."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-date-range__separator",
          "values": "true",
          "default": "—",
          "description": "The arrow is decorative."
        },
        {
          "name": "aria-describedby",
          "on": "fieldset / input",
          "values": "id",
          "default": "—",
          "description": "Links range limits to the fieldset, or an error message to the input that needs correcting."
        },
        {
          "name": "aria-invalid",
          "on": "input",
          "values": "true",
          "default": "absent",
          "description": "Set by the application on the date that needs correcting."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-date-range",
          "elements": [
            "forma-date-range__fields",
            "forma-date-range__presets",
            "forma-date-range__separator"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through From, To and each preset button in source order (and through date segments in most browsers)."
        },
        {
          "keys": "ArrowUp / ArrowDown",
          "action": "Changes the focused date segment (native, browser-dependent)."
        },
        {
          "keys": "Enter / Space on a preset",
          "action": "Activates the button; the application fills both dates."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "bounded-report",
          "title": "Report period with limits",
          "mobile": false,
          "raw": "components/date-range/bounded-report.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "end-before-start",
          "title": "End date before start date",
          "mobile": false,
          "raw": "components/date-range/end-before-start.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-activity-filter",
          "title": "Mobile activity filter",
          "mobile": true,
          "raw": "components/date-range/mobile-activity-filter.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "date-time-field",
        "range-entry",
        "segmented-control"
      ]
    },
    {
      "slug": "dense-ledger",
      "title": "Dense ledger",
      "tag": "forma-dense-ledger",
      "category": "data",
      "behavior": "Application content",
      "summary": "Compact expert-work table with bounded overflow, stable relationships, and explicit text state.",
      "docsUrl": "components/dense-ledger/",
      "pattern": "patterns/dense-ledger.html",
      "minimalHtml": "<forma-dense-ledger class=\"forma-component-tag\">\n<div class=\"forma-bounded-overflow\" role=\"region\" aria-label=\"Operational ledger\" tabindex=\"0\">\n  <table class=\"forma-dense-ledger\">\n    <caption>Recent operational entries</caption>\n    <thead><tr><th scope=\"col\">Reference</th><th scope=\"col\">Status</th><th scope=\"col\">Owner</th><th scope=\"col\">Amount</th></tr></thead>\n    <tbody><tr><th scope=\"row\">INV-1042</th><td>Needs review</td><td>Billing</td><td>$5,000</td></tr><tr><th scope=\"row\">INV-1043</th><td>Ready</td><td>Billing</td><td>$2,750</td></tr></tbody>\n  </table>\n</div>\n</forma-dense-ledger>",
      "attributes": [
        {
          "name": "role",
          "on": ".forma-bounded-overflow",
          "values": "region",
          "default": "—",
          "description": "Names the scroll container as a landmark so it can be found and scrolled."
        },
        {
          "name": "aria-label",
          "on": ".forma-bounded-overflow",
          "values": "string",
          "default": "—",
          "description": "Accessible name of the scroll region; usually the table's caption."
        },
        {
          "name": "tabindex",
          "on": ".forma-bounded-overflow",
          "values": "0",
          "default": "—",
          "description": "Makes the region keyboard-focusable so overflowing columns can be scrolled with arrow keys."
        },
        {
          "name": "scope",
          "on": "th",
          "values": "col | row",
          "default": "—",
          "description": "`col` on header cells, `row` on the reference cell that identifies each row."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO date-time",
          "default": "—",
          "description": "Machine-readable timestamp for time columns."
        },
        {
          "name": "style",
          "on": "table.forma-dense-ledger",
          "values": "--forma-ledger-cell-space",
          "default": "—",
          "description": "Optional inline override of cell padding, or set the property from application CSS."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-dense-ledger",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab",
          "action": "Focuses the scroll region (and any links or buttons inside cells)."
        },
        {
          "keys": "Arrow keys",
          "action": "Scroll the focused region natively. There is no cell-by-cell navigation."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "explicit-unknowns",
          "title": "Unknown and missing values",
          "mobile": false,
          "raw": "components/dense-ledger/explicit-unknowns.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "wide-audit-ledger",
          "title": "Wide audit ledger",
          "mobile": false,
          "raw": "components/dense-ledger/wide-audit-ledger.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "tighter-cells",
          "title": "Tighter cells for a side panel",
          "mobile": false,
          "raw": "components/dense-ledger/tighter-cells.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-bounded-ledger",
          "title": "Mobile ledger with contained scroll",
          "mobile": true,
          "raw": "components/dense-ledger/mobile-bounded-ledger.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "data-grid",
        "bounded-overflow",
        "comparison-grid",
        "key-value-list"
      ]
    },
    {
      "slug": "diagnostic-status",
      "title": "Diagnostic status",
      "tag": "forma-diagnostic-status",
      "category": "faults",
      "behavior": "Aegis / Application",
      "summary": "Text-first presentation of synchronized, queued, unavailable, or failed diagnostic persistence state.",
      "docsUrl": "components/diagnostic-status/",
      "pattern": "patterns/diagnostic-status.html",
      "minimalHtml": "<forma-diagnostic-status class=\"forma-component-tag\">\n<div class=\"forma-diagnostic-status\" data-forma-state=\"queued\" role=\"status\">\n  <span class=\"forma-diagnostic-status__marker\" aria-hidden=\"true\">↥</span>\n  <span class=\"forma-diagnostic-status__body\">\n    <strong>Diagnostics queued</strong>\n    <span>3 reports are waiting to synchronize.</span>\n  </span>\n</div>\n</forma-diagnostic-status>",
      "attributes": [
        {
          "name": "data-forma-state",
          "on": ".forma-diagnostic-status",
          "values": "synchronized | queued | unavailable | last-synchronization-failed",
          "default": "—",
          "description": "The Aegis persistence state. unavailable and last-synchronization-failed get a 2px border; the text must still state the state."
        },
        {
          "name": "role",
          "on": ".forma-diagnostic-status",
          "values": "status",
          "default": "absent",
          "description": "Use when the application updates the status in place so changes are announced politely. Omit for a static one-time render."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-diagnostic-status__marker",
          "values": "true",
          "default": "—",
          "description": "Hides the decorative glyph."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-diagnostic-status",
          "elements": [
            "forma-diagnostic-status__body",
            "forma-diagnostic-status__marker"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-state",
              "values": [
                "last-synchronization-failed",
                "unavailable"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "—",
          "action": "Not interactive. It is never focusable; any related recovery button is a separate native button."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "synchronized",
          "title": "All diagnostics delivered",
          "mobile": false,
          "raw": "components/diagnostic-status/synchronized.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "last-sync-failed",
          "title": "Last synchronization failed",
          "mobile": false,
          "raw": "components/diagnostic-status/last-sync-failed.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "unavailable-with-recovery",
          "title": "Diagnostics unavailable with a recovery action",
          "mobile": false,
          "raw": "components/diagnostic-status/unavailable-with-recovery.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-queued",
          "title": "Queued reports on a phone",
          "mobile": true,
          "raw": "components/diagnostic-status/mobile-queued.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "operation-status",
        "freshness",
        "fault-banner"
      ]
    },
    {
      "slug": "diagram",
      "title": "Diagram",
      "tag": "forma-diagram",
      "category": "workflow",
      "behavior": "Application content",
      "summary": "Presentation-only diagram nodes, connectors, metadata and key; the consumer owns geometry, routing, semantics and color mapping.",
      "docsUrl": "components/diagram/",
      "pattern": "patterns/diagram.html",
      "minimalHtml": "<forma-diagram class=\"forma-component-tag\">\n<figure class=\"forma-diagram\" aria-labelledby=\"diagram-title\">\n  <figcaption id=\"diagram-title\">Publication workflow</figcaption>\n  <p>Fill colors show the owning team through a consumer-defined mapping (see the key). They say nothing about state: each item states its kind and state in text.</p>\n  <div class=\"forma-diagram__viewport\" tabindex=\"0\" role=\"group\" aria-label=\"Publication workflow canvas, scroll to see all items\">\n    <div class=\"forma-diagram__canvas\" style=\"--forma-diagram-canvas-w: 720px; --forma-diagram-canvas-h: 330px;\">\n      <svg class=\"forma-diagram__wires\" viewBox=\"0 0 720 330\" aria-hidden=\"true\" focusable=\"false\">\n        <defs>\n          <marker id=\"diagram-arrow\" class=\"forma-diagram-marker\" viewBox=\"0 0 10 10\" refX=\"9\" refY=\"5\" markerWidth=\"8\" markerHeight=\"8\" orient=\"auto-start-reverse\"><path d=\"M0 0 L10 5 L0 10 z\"/></marker>\n        </defs>\n        <path class=\"forma-diagram-connector\" d=\"M216 70 H258\" marker-end=\"url(#diagram-arrow)\"/>\n        <path class=\"forma-diagram-connector\" d=\"M460 70 H502\" marker-end=\"url(#diagram-arrow)\"/>\n        <path class=\"forma-diagram-connector\" data-forma-line=\"dashed\" d=\"M360 150 V198\" marker-end=\"url(#diagram-arrow)\"/>\n        <path class=\"forma-diagram-connector\" data-forma-line=\"dotted\" d=\"M260 260 H116 V152\" marker-end=\"url(#diagram-arrow)\"/>\n      </svg>\n      <article class=\"forma-diagram-node\" data-forma-shape=\"rounded\" aria-labelledby=\"node-draft\" style=\"--forma-diagram-x: 16px; --forma-diagram-y: 24px; --forma-diagram-w: 200px; --forma-diagram-fill: #e8f0ff; --forma-diagram-accent: #2f5fb3; --forma-diagram-foreground: #1d1d1b;\">\n        <p class=\"forma-diagram-node__kind\">Task</p>\n        <h3 class=\"forma-diagram-node__label\" id=\"node-draft\">Draft article</h3>\n        <dl class=\"forma-diagram-node__meta\"><dt>State</dt><dd>Done</dd><dt>Team</dt><dd>Editorial</dd></dl>\n      </article>\n      <article class=\"forma-diagram-node\" aria-labelledby=\"node-review\" style=\"--forma-diagram-x: 260px; --forma-diagram-y: 24px; --forma-diagram-w: 200px; --forma-diagram-fill: #fff1d6; --forma-diagram-accent: #8a5300; --forma-diagram-foreground: #1d1d1b;\">\n        <p class=\"forma-diagram-node__kind\">Decision</p>\n        <h3 class=\"forma-diagram-node__label\" id=\"node-review\">Legal review</h3>\n        <dl class=\"forma-diagram-node__meta\"><dt>State</dt><dd>Active</dd><dt>Team</dt><dd>Legal</dd></dl>\n      </article>\n      <article class=\"forma-diagram-node\" data-forma-shape=\"pill\" aria-labelledby=\"node-publish\" style=\"--forma-diagram-x: 504px; --forma-diagram-y: 24px; --forma-diagram-w: 200px; --forma-diagram-fill: #e8f0ff; --forma-diagram-accent: #2f5fb3; --forma-diagram-foreground: #1d1d1b;\">\n        <p class=\"forma-diagram-node__kind\">End</p>\n        <h3 class=\"forma-diagram-node__label\" id=\"node-publish\"><a href=\"#diagram-title\">Publish</a></h3>\n        <dl class=\"forma-diagram-node__meta\"><dt>State</dt><dd>Waiting</dd><dt>Team</dt><dd>Editorial</dd></dl>\n      </article>\n      <article class=\"forma-diagram-node\" data-forma-shape=\"rounded\" aria-labelledby=\"node-rework\" style=\"--forma-diagram-x: 260px; --forma-diagram-y: 200px; --forma-diagram-w: 200px;\">\n        <p class=\"forma-diagram-node__kind\">Task</p>\n        <h3 class=\"forma-diagram-node__label\" id=\"node-rework\">Rework</h3>\n        <dl class=\"forma-diagram-node__meta\"><dt>State</dt><dd>Not started</dd></dl>\n      </article>\n      <span class=\"forma-diagram-connector__label\" style=\"--forma-diagram-x: 372px; --forma-diagram-y: 164px;\">changes requested</span>\n    </div>\n  </div>\n  <ol class=\"forma-diagram__relations\" aria-label=\"Relationships\">\n    <li>Draft article leads to Legal review (solid line).</li>\n    <li>Legal review leads to Publish when approved (solid line).</li>\n    <li>Legal review leads to Rework when changes are requested (dashed line).</li>\n    <li>Rework returns to Draft article (dotted line).</li>\n  </ol>\n  <dl class=\"forma-diagram-legend\" aria-label=\"Key: fill color by owning team\">\n    <div><dt><span class=\"forma-diagram-legend__swatch\" style=\"--forma-diagram-fill: #e8f0ff; --forma-diagram-accent: #2f5fb3;\"></span> Editorial</dt><dd>blue fill</dd></div>\n    <div><dt><span class=\"forma-diagram-legend__swatch\" style=\"--forma-diagram-fill: #fff1d6; --forma-diagram-accent: #8a5300;\"></span> Legal</dt><dd>amber fill</dd></div>\n    <div><dt><span class=\"forma-diagram-legend__swatch\"></span> Unassigned</dt><dd>Forma default</dd></div>\n  </dl>\n</figure>\n</forma-diagram>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "figure, node article",
          "values": "id of the caption or node label",
          "default": "—",
          "description": "Names the diagram by its caption and each node by its label heading."
        },
        {
          "name": "tabindex",
          "on": ".forma-diagram__viewport",
          "values": "0",
          "default": "—",
          "description": "Makes the scrolling canvas reachable by keyboard so it can be scrolled without a pointer."
        },
        {
          "name": "role",
          "on": ".forma-diagram__viewport",
          "values": "group",
          "default": "—",
          "description": "Gives the focusable viewport a role so its name is announced."
        },
        {
          "name": "aria-label",
          "on": "viewport, relations list, legend",
          "values": "string",
          "default": "—",
          "description": "Names the canvas (say that it scrolls), the relationship list and the key."
        },
        {
          "name": "aria-hidden",
          "on": "svg.forma-diagram__wires",
          "values": "true",
          "default": "—",
          "description": "Hides the drawn connectors; the relationship list is their text equivalent."
        },
        {
          "name": "focusable",
          "on": "svg.forma-diagram__wires",
          "values": "false",
          "default": "—",
          "description": "Keeps legacy browsers from putting the SVG in the tab order."
        },
        {
          "name": "marker-end",
          "on": "path.forma-diagram-connector",
          "values": "url(#marker-id)",
          "default": "—",
          "description": "Attaches the arrowhead. Marker ids must be unique in the document."
        },
        {
          "name": "style",
          "on": "canvas, node, group, connector, label, swatch",
          "values": "custom property declarations",
          "default": "—",
          "description": "Where the consumer writes resolved geometry and authored color values."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-diagram",
          "elements": [
            "forma-diagram__canvas",
            "forma-diagram__membership",
            "forma-diagram__relations",
            "forma-diagram__viewport",
            "forma-diagram__wires"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": [
            {
              "name": "--forma-diagram-canvas-h",
              "default": null
            },
            {
              "name": "--forma-diagram-canvas-w",
              "default": null
            }
          ]
        },
        {
          "root": "forma-diagram-connector",
          "elements": [
            "forma-diagram-connector__label"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-line",
              "values": [
                "dashed",
                "dotted"
              ]
            }
          ],
          "customProperties": [
            {
              "name": "--forma-diagram-connector-stroke",
              "default": null
            },
            {
              "name": "--forma-diagram-connector-width",
              "default": null
            }
          ]
        },
        {
          "root": "forma-diagram-group",
          "elements": [
            "forma-diagram-group__header",
            "forma-diagram-group__kind",
            "forma-diagram-group__label"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-group",
              "values": [
                "lane"
              ]
            },
            {
              "name": "data-forma-line",
              "values": [
                "dashed",
                "dotted"
              ]
            }
          ],
          "customProperties": [
            {
              "name": "--forma-diagram-group-accent",
              "default": "var(--forma-diagram-accent, var(--forma-diagram-group-stroke))"
            },
            {
              "name": "--forma-diagram-group-fill",
              "default": "var(--forma-diagram-fill, transparent)"
            },
            {
              "name": "--forma-diagram-group-foreground",
              "default": "var(--forma-diagram-foreground, var(--forma-color-text-primary, #161616))"
            },
            {
              "name": "--forma-diagram-group-stroke",
              "default": "var(--forma-diagram-stroke, var(--forma-color-border-functional, #555555))"
            }
          ]
        },
        {
          "root": "forma-diagram-legend",
          "elements": [
            "forma-diagram-legend__swatch"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-diagram-marker",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-diagram-node",
          "elements": [
            "forma-diagram-node__description",
            "forma-diagram-node__kind",
            "forma-diagram-node__label",
            "forma-diagram-node__meta"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-shape",
              "values": [
                "diamond",
                "ellipse",
                "pill",
                "rounded"
              ]
            },
            {
              "name": "data-forma-status",
              "values": [
                "active",
                "blocked",
                "cancelled",
                "failed",
                "pending",
                "skipped",
                "waiting"
              ]
            }
          ],
          "customProperties": [
            {
              "name": "--forma-diagram-node-accent",
              "default": "var(--forma-diagram-accent, var(--forma-diagram-node-stroke))"
            },
            {
              "name": "--forma-diagram-node-fill",
              "default": "var(--forma-diagram-fill, var(--forma-color-surface-primary, #fafafa))"
            },
            {
              "name": "--forma-diagram-node-foreground",
              "default": "var(--forma-diagram-foreground, var(--forma-color-text-primary, #161616))"
            },
            {
              "name": "--forma-diagram-node-stroke",
              "default": "var(--forma-diagram-stroke, var(--forma-color-border-functional, #555555))"
            }
          ]
        },
        {
          "root": "forma-diagram-port",
          "elements": [
            "forma-diagram-port__label"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-direction",
              "values": [
                "in",
                "inout"
              ]
            },
            {
              "name": "data-forma-side",
              "values": [
                "bottom",
                "left",
                "right",
                "top"
              ]
            }
          ],
          "customProperties": [
            {
              "name": "--forma-diagram-port-offset",
              "default": null
            }
          ]
        },
        {
          "root": "forma-diagram-value-state",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-value-state",
              "values": [
                "invalid",
                "source-bound",
                "unavailable",
                "unknown"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves to the canvas viewport, then to any links inside nodes in source order."
        },
        {
          "keys": "Arrow keys, Page Up / Page Down (viewport focused)",
          "action": "Scrolls the canvas. Native scrolling of a focused overflow region."
        },
        {
          "keys": "Selection, moving or connecting nodes",
          "action": "Not provided. Editing interactions belong to the consuming editor and must not reuse `forma-diagram*` classes."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "link",
            "name": "Publish",
            "expect": {
              "url": "#diagram-title"
            }
          }
        ]
      },
      "examples": [
        {
          "id": "portable-workflow",
          "title": "Generated from a portable workflow, with ports and status",
          "mobile": false,
          "raw": "components/diagram/portable-workflow.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "default-appearance",
          "title": "Approval chain with default styling",
          "mobile": false,
          "raw": "components/diagram/default-appearance.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "authored-color",
          "title": "Authored color by owning team",
          "mobile": false,
          "raw": "components/diagram/authored-color.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "workflow-lanes-and-decision",
          "title": "Budget approval across two lanes",
          "mobile": false,
          "raw": "components/diagram/workflow-lanes-and-decision.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "metadata-value-states",
          "title": "Metadata with default, derived and missing values",
          "mobile": false,
          "raw": "components/diagram/metadata-value-states.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-scrolling-canvas",
          "title": "Mobile scrolling canvas",
          "mobile": true,
          "raw": "components/diagram/mobile-scrolling-canvas.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "lane-board",
        "spatial-canvas",
        "provenance-trail",
        "relationship-index"
      ]
    },
    {
      "slug": "dialog",
      "title": "Dialog",
      "tag": "forma-dialog",
      "category": "overlays",
      "behavior": "Native HTML",
      "summary": "Modal presentation built on the platform dialog element and declarative invoker commands.",
      "docsUrl": "components/dialog/",
      "pattern": "patterns/dialog.html",
      "minimalHtml": "<forma-dialog class=\"forma-component-tag\">\n<button type=\"button\" commandfor=\"example-dialog\" command=\"show-modal\">Open modal</button>\n<dialog\n  class=\"forma-dialog\"\n  id=\"example-dialog\"\n  data-forma-motion-weight=\"heavy\"\n  aria-labelledby=\"example-dialog-title\"\n  aria-describedby=\"example-dialog-description\">\n  <div class=\"forma-dialog__body\">\n    <h2 id=\"example-dialog-title\">Confirm action</h2>\n    <p id=\"example-dialog-description\">The browser owns modal focus, inertness, Escape behavior, and focus restoration.</p>\n  </div>\n  <div class=\"forma-dialog__actions\">\n    <button type=\"button\" commandfor=\"example-dialog\" command=\"close\">Cancel</button>\n  </div>\n</dialog>\n</forma-dialog>",
      "attributes": [
        {
          "name": "commandfor",
          "on": "invoker button",
          "values": "id of the dialog",
          "default": "—",
          "description": "Connects a button to the dialog it controls. Works without script in browsers with invoker commands."
        },
        {
          "name": "command",
          "on": "invoker button",
          "values": "show-modal | close | request-close",
          "default": "—",
          "description": "`show-modal` opens the dialog as a modal; `close` closes it. Forma's pattern uses these instead of script."
        },
        {
          "name": "aria-labelledby",
          "on": "dialog",
          "values": "id of the dialog heading",
          "default": "—",
          "description": "Required. Names the dialog from its visible title."
        },
        {
          "name": "aria-describedby",
          "on": "dialog",
          "values": "id",
          "default": "—",
          "description": "Links the key explanatory sentence so it is announced on open. Keep it short."
        },
        {
          "name": "closedby",
          "on": "dialog",
          "values": "any | closerequest | none",
          "default": "closerequest for modals",
          "description": "Which user actions close the dialog. `any` adds backdrop click (light dismiss) where supported."
        },
        {
          "name": "method",
          "on": "form inside the dialog",
          "values": "dialog",
          "default": "—",
          "description": "Submitting closes the dialog and sets `returnValue` to the submitter's value, without a network request."
        },
        {
          "name": "autofocus",
          "on": "a control inside the dialog",
          "values": "boolean",
          "default": "absent",
          "description": "Chooses which element receives focus when the dialog opens; otherwise the first focusable element does."
        },
        {
          "name": "data-forma-motion-weight",
          "on": "dialog",
          "values": "light | standard | heavy",
          "default": "heavy",
          "description": "Presentation-only perceived mass for entry and exit."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-dialog",
          "elements": [
            "forma-dialog__actions",
            "forma-dialog__body"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            },
            {
              "name": "open",
              "values": []
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Enter / Space on the invoker",
          "action": "Opens the dialog; focus moves to the autofocus element or the first focusable element inside."
        },
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves among focusable elements in the dialog; the page behind is inert and cannot receive focus."
        },
        {
          "keys": "Escape",
          "action": "Closes the dialog (fires cancel, then close) unless `closedby=\"none\"`."
        },
        {
          "keys": "Enter in a field",
          "action": "Submits a `method=\"dialog\"` form with its default (first) submit button, closing the dialog."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "button",
            "name": "Open modal",
            "expect": {
              "open": true
            }
          },
          {
            "role": "button",
            "name": "Cancel",
            "expect": {
              "open": false
            }
          }
        ]
      },
      "examples": [
        {
          "id": "destructive-confirmation",
          "title": "Destructive confirmation",
          "mobile": false,
          "raw": "components/dialog/destructive-confirmation.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Delete project…",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Keep project",
                "expect": {
                  "open": false
                }
              },
              {
                "role": "button",
                "name": "Delete project…",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Delete project",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        },
        {
          "id": "light-dismiss-long-content",
          "title": "Long release notes with light dismiss",
          "mobile": false,
          "raw": "components/dialog/light-dismiss-long-content.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "What's new in 4.2",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Close",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        },
        {
          "id": "mobile-short-form",
          "title": "Short form on a phone",
          "mobile": true,
          "raw": "components/dialog/mobile-short-form.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Rename board",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Cancel",
                "expect": {
                  "open": false
                }
              },
              {
                "role": "button",
                "name": "Rename board",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Save name",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        }
      ],
      "related": [
        "flyout",
        "popover",
        "fault-blocking",
        "button",
        "toast"
      ]
    },
    {
      "slug": "diff-viewer",
      "title": "Diff viewer",
      "tag": "forma-diff-viewer",
      "category": "data",
      "behavior": "Application content",
      "summary": "Before/after structured differences with explicit changed-field cues and stacked mobile comparison.",
      "docsUrl": "components/diff-viewer/",
      "pattern": "patterns/diff-viewer.html",
      "minimalHtml": "<forma-diff-viewer class=\"forma-component-tag\">\n<section class=\"forma-diff-viewer\" aria-labelledby=\"diff-title\">\n  <header class=\"forma-diff-viewer__header\">\n    <h3 id=\"diff-title\">Version comparison</h3>\n    <p>2 fields changed</p>\n  </header>\n  <div class=\"forma-diff-viewer__grid\">\n    <section class=\"forma-diff-viewer__side\" aria-label=\"Previous version\">\n      <h4>Before</h4>\n      <dl>\n        <div class=\"forma-diff-row\" data-change=\"changed\"><dt>Status</dt><dd>Draft</dd></div>\n        <div class=\"forma-diff-row\"><dt>Owner</dt><dd>Operations</dd></div>\n      </dl>\n    </section>\n    <section class=\"forma-diff-viewer__side\" aria-label=\"Current version\">\n      <h4>After</h4>\n      <dl>\n        <div class=\"forma-diff-row\" data-change=\"changed\"><dt>Status</dt><dd>Ready for review</dd></div>\n        <div class=\"forma-diff-row\"><dt>Owner</dt><dd>Operations</dd></div>\n      </dl>\n    </section>\n  </div>\n</section>\n</forma-diff-viewer>",
      "attributes": [
        {
          "name": "data-change",
          "on": ".forma-diff-row",
          "values": "changed",
          "default": "absent (unchanged)",
          "description": "Marks a field row as different between versions. Written by the application on the row on both sides."
        },
        {
          "name": "aria-labelledby",
          "on": ".forma-diff-viewer",
          "values": "id of the header heading",
          "default": "—",
          "description": "Names the comparison."
        },
        {
          "name": "aria-label",
          "on": ".forma-diff-viewer__side",
          "values": "string",
          "default": "—",
          "description": "Names each side (Previous version, Current version) when the visible heading is short."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-diff-viewer",
          "elements": [
            "forma-diff-viewer__grid",
            "forma-diff-viewer__header",
            "forma-diff-viewer__side"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-diff-row",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-change",
              "values": [
                "changed"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab",
          "action": "Reaches links or controls inside values. The viewer itself has no keyboard behavior; navigation between changes is application behavior."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "added-and-removed",
          "title": "Added and removed fields",
          "mobile": false,
          "raw": "components/diff-viewer/added-and-removed.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "long-values",
          "title": "Long values",
          "mobile": false,
          "raw": "components/diff-viewer/long-values.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-stacked-diff",
          "title": "Mobile stacked comparison",
          "mobile": true,
          "raw": "components/diff-viewer/mobile-stacked-diff.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "comparison-pairs",
        "conflict-review",
        "timeline",
        "key-value-list"
      ]
    },
    {
      "slug": "disclosure",
      "title": "Disclosure",
      "tag": "forma-disclosure",
      "category": "overlays",
      "behavior": "Native HTML",
      "summary": "Expandable content built on details and summary with no runtime behavior layer; where interpolate-size is supported the panel settles to its intrinsic height, otherwise it opens instantly.",
      "docsUrl": "components/disclosure/",
      "pattern": "patterns/disclosure.html",
      "minimalHtml": "<forma-disclosure class=\"forma-component-tag\">\n<details class=\"forma-disclosure\" data-forma-motion-weight=\"light\">\n  <summary>Advanced options</summary>\n  <div class=\"forma-disclosure__content\">\n    <p>Additional controls or explanatory content go here.</p>\n  </div>\n</details>\n</forma-disclosure>",
      "attributes": [
        {
          "name": "open",
          "on": "details",
          "values": "boolean",
          "default": "absent (closed)",
          "description": "Initial open state. The browser adds and removes it as the user toggles."
        },
        {
          "name": "name",
          "on": "details",
          "values": "string",
          "default": "absent",
          "description": "Groups disclosures into an exclusive accordion: opening one closes the others with the same name. Supported in current browsers; elsewhere each opens independently."
        },
        {
          "name": "data-forma-motion-weight",
          "on": "details",
          "values": "light | standard | heavy",
          "default": "light",
          "description": "Presentation-only perceived mass for the indicator and content settle."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-disclosure",
          "elements": [
            "forma-disclosure__content"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            },
            {
              "name": "open",
              "values": []
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus to the summary, then into the open content."
        },
        {
          "keys": "Enter / Space",
          "action": "Toggles the disclosure (native summary behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "disclosure",
            "name": "Advanced options",
            "expect": {
              "open": true
            }
          }
        ]
      },
      "examples": [
        {
          "id": "exclusive-faq",
          "title": "Exclusive FAQ list",
          "mobile": false,
          "raw": "components/disclosure/exclusive-faq.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Can I change my plan later?",
                "expect": {
                  "open": false
                }
              },
              {
                "role": "disclosure",
                "name": "What happens to my data if I cancel?",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "disclosure",
                "name": "Do you offer discounts for non-profits?",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        },
        {
          "id": "advanced-fields-open",
          "title": "Advanced settings open with fields",
          "mobile": false,
          "raw": "components/disclosure/advanced-fields-open.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Advanced delivery settings",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        },
        {
          "id": "mobile-long-summary",
          "title": "Long summary on a phone",
          "mobile": true,
          "raw": "components/disclosure/mobile-long-summary.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Pourquoi certaines transactions apparaissent-elles deux fois sur mon relevé mensuel ?",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        }
      ],
      "related": [
        "overview-disclosure",
        "overflow-command-disclosure",
        "tabs",
        "popover"
      ]
    },
    {
      "slug": "documentation-layout",
      "title": "Documentation layout",
      "tag": "forma-documentation-layout",
      "category": "site",
      "behavior": "Site content",
      "summary": "Documentation page: navigation rail, prose article, and optional outline; navigation compacts to a wrapping list in narrow containers.",
      "docsUrl": "components/documentation-layout/",
      "pattern": "patterns/documentation-layout.html",
      "minimalHtml": "<forma-documentation-layout class=\"forma-component-tag\">\n<div class=\"forma-site\" data-forma-layout=\"documentation\">\n  <div class=\"forma-site__main\">\n  <div class=\"forma-doc\">\n    <nav class=\"forma-doc__nav\" aria-label=\"Documentation\">\n      <p class=\"forma-eyebrow forma-doc__heading\">Guides</p>\n      <ul><li><a href=\"#install\" aria-current=\"page\">Install</a></li><li><a href=\"#configure\">Configure</a></li><li><a href=\"#upgrade\">Upgrade</a></li></ul>\n    </nav>\n    <article class=\"forma-doc__content forma-prose\" id=\"install\">\n      <h1>Install</h1>\n      <p>Documentation pages pair a navigation rail with a prose article and an optional page outline.</p>\n    </article>\n    <nav class=\"forma-doc__aside\" aria-label=\"On this page\">\n      <p class=\"forma-eyebrow forma-doc__heading\">On this page</p>\n      <ul><li><a href=\"#install\">Requirements</a></li><li><a href=\"#install\">Verify</a></li></ul>\n    </nav>\n  </div>\n  </div>\n</div>\n</forma-documentation-layout>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "nav.forma-doc__nav, nav.forma-doc__aside",
          "values": "string",
          "default": "—",
          "description": "Names each navigation landmark distinctly, for example \"Documentation\" and \"On this page\"."
        },
        {
          "name": "aria-current",
          "on": "a in .forma-doc__nav",
          "values": "page",
          "default": "absent",
          "description": "Marks the current page in the navigation with a strong rule and bold text."
        },
        {
          "name": "data-forma-layout",
          "on": ".forma-site",
          "values": "documentation",
          "default": "—",
          "description": "Declares the page type on the shell; the layout itself does not depend on it."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-doc",
          "elements": [
            "forma-doc__aside",
            "forma-doc__content",
            "forma-doc__heading",
            "forma-doc__nav"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through navigation links, then the article, then the outline, in source order at every width."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link; outline links jump to headings in the article."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "article-without-outline",
          "title": "Article without an outline",
          "mobile": false,
          "raw": "components/documentation-layout/article-without-outline.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Tokens",
                "expect": {
                  "url": "#documentation-layout-article-without-outline-tokens"
                }
              },
              {
                "role": "link",
                "name": "Surface tones",
                "expect": {
                  "url": "#documentation-layout-article-without-outline-tones"
                }
              },
              {
                "role": "link",
                "name": "Breakpoints",
                "expect": {
                  "url": "#documentation-layout-article-without-outline-tokens"
                }
              }
            ]
          }
        },
        {
          "id": "long-guide",
          "title": "Long guide with outline",
          "mobile": false,
          "raw": "components/documentation-layout/long-guide.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Install",
                "expect": {
                  "url": "#documentation-layout-long-guide-article"
                }
              },
              {
                "role": "link",
                "name": "Upgrade",
                "expect": {
                  "url": "#documentation-layout-long-guide-article"
                }
              },
              {
                "role": "link",
                "name": "Local CSS policy",
                "expect": {
                  "url": "#documentation-layout-long-guide-article"
                }
              },
              {
                "role": "link",
                "name": "Deploy to GitHub Pages",
                "expect": {
                  "url": "#documentation-layout-long-guide-article"
                }
              },
              {
                "role": "link",
                "name": "Test before deployment",
                "expect": {
                  "url": "#documentation-layout-long-guide-article"
                }
              },
              {
                "role": "link",
                "name": "Read the release notes",
                "expect": {
                  "url": "#documentation-layout-long-guide-notes"
                }
              },
              {
                "role": "link",
                "name": "Update the lock",
                "expect": {
                  "url": "#documentation-layout-long-guide-lock"
                }
              },
              {
                "role": "link",
                "name": "Verify",
                "expect": {
                  "url": "#documentation-layout-long-guide-verify"
                }
              }
            ]
          }
        },
        {
          "id": "mobile-compact-nav",
          "title": "Phone compact navigation",
          "mobile": true,
          "raw": "components/documentation-layout/mobile-compact-nav.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Install",
                "expect": {
                  "url": "#documentation-layout-mobile-compact-nav-article"
                }
              },
              {
                "role": "link",
                "name": "Configure",
                "expect": {
                  "url": "#documentation-layout-mobile-compact-nav-article"
                }
              },
              {
                "role": "link",
                "name": "Upgrade",
                "expect": {
                  "url": "#documentation-layout-mobile-compact-nav-article"
                }
              },
              {
                "role": "link",
                "name": "Deploy",
                "expect": {
                  "url": "#documentation-layout-mobile-compact-nav-article"
                }
              },
              {
                "role": "link",
                "name": "Verify",
                "expect": {
                  "url": "#documentation-layout-mobile-compact-nav-verify"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "prose",
        "marketing-shell",
        "sidebar",
        "rail"
      ]
    },
    {
      "slug": "emphasis-budget",
      "title": "Emphasis budget",
      "tag": "forma-emphasis-budget",
      "category": "verification",
      "behavior": "Application content",
      "summary": "Declares bounded primary, secondary, and supporting emphasis so competing regions cannot all claim the strongest visual priority.",
      "docsUrl": "components/emphasis-budget/",
      "pattern": "patterns/emphasis-budget.html",
      "minimalHtml": "<forma-emphasis-budget class=\"forma-component-tag\">\n<main class=\"forma-emphasis-budget\" data-emphasis-budget=\"one-primary\" aria-labelledby=\"emphasis-budget-title\">\n  <header>\n    <p class=\"forma-component-kicker\">Deployment review</p>\n    <h2 id=\"emphasis-budget-title\">Release decision</h2>\n  </header>\n  <section data-emphasis=\"primary\" aria-labelledby=\"emphasis-primary\">\\n    <p class=\"forma-emphasis-label\">Primary</p>\n    <span class=\"forma-status-lozenge\" data-state=\"unknown\">Unknown consumer outcome</span>\n    <h3 id=\"emphasis-primary\">Reconcile before publishing</h3>\n    <p>The consuming application has not supplied current verification evidence.</p>\n    <button type=\"button\">Reconcile consumer</button>\n  </section>\n  <section data-emphasis=\"secondary\" aria-labelledby=\"emphasis-secondary\">\\n    <p class=\"forma-emphasis-label\">Secondary</p>\n    <h3 id=\"emphasis-secondary\">Verification evidence</h3>\n    <p>Package build and repository checks passed. Consumer verification remains unresolved.</p>\n  </section>\n  <div class=\"forma-emphasis-budget__support\">\n    <section data-emphasis=\"supporting\"><p class=\"forma-emphasis-label\">Supporting</p><h3>History</h3><p>The previous release completed successfully.</p></section>\n    <section data-emphasis=\"supporting\"><p class=\"forma-emphasis-label\">Supporting</p><h3>Package</h3><p>Version 1.4.0 with provenance enabled.</p></section>\n    <section data-emphasis=\"supporting\"><p class=\"forma-emphasis-label\">Supporting</p><h3>Activity</h3><p>Recent repository work includes presentation and browser-test changes.</p></section>\n  </div>\n</main>\n</forma-emphasis-budget>",
      "attributes": [
        {
          "name": "data-emphasis-budget",
          "on": "root",
          "values": "one-primary",
          "default": "absent",
          "description": "Declares the budget: exactly one direct child region may claim primary. Checked by tests and review; CSS does not enforce it."
        },
        {
          "name": "data-emphasis",
          "on": "regions inside the budget",
          "values": "primary | secondary | supporting",
          "default": "absent",
          "description": "The region's claimed emphasis level. Chosen by the application from domain state; never implies severity, authority or legality."
        },
        {
          "name": "aria-labelledby",
          "on": "root and regions",
          "values": "id of a heading",
          "default": "—",
          "description": "Names the budget and its main regions by their headings."
        },
        {
          "name": "data-state",
          "on": ".forma-status-lozenge",
          "values": "ok | attention | blocked | unknown",
          "default": "absent",
          "description": "Adds a status symbol to a text status inside a region."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-emphasis-budget",
          "elements": [
            "forma-emphasis-budget__support"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-emphasis-label",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through actions in source order. Emphasis never changes focus order."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "access-request",
          "title": "Access request decision",
          "mobile": false,
          "raw": "components/emphasis-budget/access-request.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "nested-budgets",
          "title": "Nested independent budgets",
          "mobile": false,
          "raw": "components/emphasis-budget/nested-budgets.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-decision",
          "title": "Mobile decision",
          "mobile": true,
          "raw": "components/emphasis-budget/mobile-decision.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "attention-path",
        "verification-frame",
        "priority-stack",
        "callout"
      ]
    },
    {
      "slug": "empty-state",
      "title": "Empty state",
      "tag": "forma-empty-state",
      "category": "feedback",
      "behavior": "Application content",
      "summary": "Explains an empty result and offers a useful recovery action without treating absence as failure.",
      "docsUrl": "components/empty-state/",
      "pattern": "patterns/empty-state.html",
      "minimalHtml": "<forma-empty-state class=\"forma-component-tag\">\n<section class=\"forma-empty-state\" aria-labelledby=\"empty-title\">\n  <div class=\"forma-empty-state__symbol\" aria-hidden=\"true\">□</div>\n  <h3 id=\"empty-title\">No results match these filters</h3>\n  <p>Clear one or more filters or broaden the search to see records.</p>\n  <button type=\"button\">Clear filters</button>\n</section>\n</forma-empty-state>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-empty-state",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the section so it is exposed as a labelled region."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-empty-state__symbol",
          "values": "true",
          "default": "—",
          "description": "Hides the decorative symbol."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Keeps recovery actions from submitting a surrounding form."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-empty-state",
          "elements": [
            "forma-empty-state__symbol"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the recovery actions. The empty state itself is not focusable."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "first-use",
          "title": "First use",
          "mobile": false,
          "raw": "components/empty-state/first-use.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "search-no-matches",
          "title": "Search with no matches",
          "mobile": false,
          "raw": "components/empty-state/search-no-matches.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "queue-complete",
          "title": "Work queue cleared",
          "mobile": false,
          "raw": "components/empty-state/queue-complete.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-filtered-list",
          "title": "Mobile filtered list",
          "mobile": true,
          "raw": "components/empty-state/mobile-filtered-list.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "skeleton",
        "alert",
        "collection-toolbar",
        "active-filter-summary"
      ]
    },
    {
      "slug": "entry-index",
      "title": "Entry index",
      "tag": "forma-entry-index",
      "category": "site",
      "behavior": "Site content",
      "summary": "Ordered linked entries (research areas, products) that regroup from four columns to one by container width.",
      "docsUrl": "components/entry-index/",
      "pattern": "patterns/entry-index.html",
      "minimalHtml": "<forma-entry-index class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <ol class=\"forma-index\" aria-label=\"Research areas\">\n    <li class=\"forma-index__item\">\n      <p class=\"forma-index__marker\">R / 01</p>\n      <div class=\"forma-index__heading\"><p class=\"forma-eyebrow\">Intelligent systems</p><h3 class=\"forma-index__title\">AI Engineering</h3></div>\n      <p class=\"forma-index__summary\">Dependable practice, evaluation, human oversight, and workflow design.</p>\n      <a class=\"forma-index__link\" href=\"#ai\">Visit AI Engineering</a>\n    </li>\n    <li class=\"forma-index__item\">\n      <p class=\"forma-index__marker\">R / 02</p>\n      <div class=\"forma-index__heading\"><p class=\"forma-eyebrow\">Perception &amp; composition</p><h3 class=\"forma-index__title\">Visual Engineering</h3></div>\n      <p class=\"forma-index__summary\">Evidence-led hierarchy, typography, color, composition, and interaction.</p>\n      <a class=\"forma-index__link\" href=\"#visual\">Visit Visual Engineering</a>\n    </li>\n  </ol>\n</div>\n</forma-entry-index>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "ol.forma-index",
          "values": "string",
          "default": "—",
          "description": "Names the list when no visible heading introduces it."
        },
        {
          "name": "href",
          "on": "a.forma-index__link",
          "values": "URL",
          "default": "—",
          "description": "Destination of the entry."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-index",
          "elements": [
            "forma-index__heading",
            "forma-index__item",
            "forma-index__link",
            "forma-index__marker",
            "forma-index__summary",
            "forma-index__title"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between entry links in list order."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link (native link behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "product-family",
          "title": "Product family index",
          "mobile": false,
          "raw": "components/entry-index/product-family.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Visit Ordo",
                "expect": {
                  "url": "#entry-index-product-family-ordo"
                }
              },
              {
                "role": "link",
                "name": "Visit Limen",
                "expect": {
                  "url": "#entry-index-product-family-limen"
                }
              },
              {
                "role": "link",
                "name": "Visit Dokimos",
                "expect": {
                  "url": "#entry-index-product-family-dokimos"
                }
              },
              {
                "role": "link",
                "name": "Visit Forma",
                "expect": {
                  "url": "#entry-index-product-family-forma"
                }
              }
            ]
          }
        },
        {
          "id": "long-titles",
          "title": "Long titles and summaries",
          "mobile": false,
          "raw": "components/entry-index/long-titles.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile-single-column",
          "title": "Phone single column",
          "mobile": true,
          "raw": "components/entry-index/mobile-single-column.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Visit AI Engineering",
                "expect": {
                  "url": "#entry-index-mobile-single-column-visual"
                }
              },
              {
                "role": "link",
                "name": "Visit Visual Engineering",
                "expect": {
                  "url": "#entry-index-mobile-single-column-visual"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "card-grid",
        "steps",
        "relationship-index"
      ]
    },
    {
      "slug": "evidence-relationship",
      "title": "Evidence relationship",
      "tag": "forma-evidence-relationship",
      "category": "data",
      "behavior": "Application content",
      "summary": "Makes claim-to-evidence relationship type and scope explicit rather than relying on proximity alone.",
      "docsUrl": "components/evidence-relationship/",
      "pattern": "patterns/evidence-relationship.html",
      "minimalHtml": "<forma-evidence-relationship class=\"forma-component-tag\">\n<article class=\"forma-evidence-relationship\" aria-labelledby=\"relationship-claim\"><header><p class=\"forma-component-kicker\">Supports</p><h2 id=\"relationship-claim\">Claim: deployment is ready</h2></header><div class=\"forma-evidence-relationship__body\"><p><strong>Evidence:</strong> Required checks passed.</p><p><strong>Source:</strong> CI run 1042</p><p><strong>Scope:</strong> commit abc123</p></div><footer><span class=\"forma-status-lozenge\">Current</span></footer></article>\n</forma-evidence-relationship>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "article.forma-evidence-relationship",
          "values": "id of the claim heading",
          "default": "—",
          "description": "Names the article by its claim."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-evidence-relationship",
          "elements": [
            "forma-evidence-relationship__body"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "None",
          "action": "Static content; links inside the body are reached with Tab."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "contradicting-evidence",
          "title": "Contradicting evidence",
          "mobile": false,
          "raw": "components/evidence-relationship/contradicting-evidence.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "partial-scope",
          "title": "Evidence covering part of the scope",
          "mobile": false,
          "raw": "components/evidence-relationship/partial-scope.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-evidence",
          "title": "Mobile evidence relationship",
          "mobile": true,
          "raw": "components/evidence-relationship/mobile-evidence.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "provenance-trail",
        "relationship-index",
        "security-evidence-chain",
        "freshness"
      ]
    },
    {
      "slug": "facts",
      "title": "Facts",
      "tag": "forma-facts",
      "category": "site",
      "behavior": "Site content",
      "summary": "Short claims with supporting detail as a description list in a ruled, auto-fitting grid.",
      "docsUrl": "components/facts/",
      "pattern": "patterns/facts.html",
      "minimalHtml": "<forma-facts class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <dl class=\"forma-facts\">\n    <div class=\"forma-facts__item\"><dt>Version 0.3.0</dt><dd>Pinned in the site's forma.lock</dd></div>\n    <div class=\"forma-facts__item\"><dt>Zero runtime</dt><dd>HTML and CSS only</dd></div>\n    <div class=\"forma-facts__item\"><dt>WCAG 2.2 AA</dt><dd>Target for stable patterns</dd></div>\n  </dl>\n</div>\n</forma-facts>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section",
          "values": "id of a heading",
          "default": "—",
          "description": "Names the region that contains the facts when the facts are introduced by a heading."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-facts",
          "elements": [
            "forma-facts__item"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "—",
          "action": "Not interactive. Facts are read in source order."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "engagement-outcomes",
          "title": "Engagement outcomes",
          "mobile": false,
          "raw": "components/facts/engagement-outcomes.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "inverse-surface",
          "title": "Facts on an inverse section",
          "mobile": false,
          "raw": "components/facts/inverse-surface.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-stacked",
          "title": "Phone stacked facts",
          "mobile": true,
          "raw": "components/facts/mobile-stacked.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "card-grid",
        "key-value-list",
        "metric-card",
        "hero"
      ]
    },
    {
      "slug": "fault",
      "title": "Fault",
      "tag": "forma-fault",
      "category": "faults",
      "behavior": "Aegis / Ordo / Application",
      "summary": "Common safe presentation shell for an Aegis Presentation.T without exposing raw fault diagnostics.",
      "docsUrl": "components/fault/",
      "pattern": "patterns/fault.html",
      "minimalHtml": "<forma-fault class=\"forma-component-tag\">\n<section\n  class=\"forma-fault\"\n  data-forma-intent=\"inline\"\n  data-forma-severity=\"error\"\n  aria-labelledby=\"fault-title\"\n  aria-describedby=\"fault-message\">\n  <div class=\"forma-fault__marker\" aria-hidden=\"true\">!</div>\n  <div class=\"forma-fault__body\">\n    <p class=\"forma-fault__severity\">Error</p>\n    <h3 class=\"forma-fault__title\" id=\"fault-title\">Could not save changes</h3>\n    <p class=\"forma-fault__message\" id=\"fault-message\">The update did not complete. Your current values are still available.</p>\n    <p class=\"forma-fault-reference\">Reference <code>AG-4F82C</code></p>\n  </div>\n  <div class=\"forma-recovery-actions\" role=\"group\" aria-label=\"Recovery actions\">\n    <button type=\"button\" data-forma-aegis-capability=\"CanRetry\">Try again</button>\n  </div>\n</section>\n</forma-fault>",
      "attributes": [
        {
          "name": "data-forma-severity",
          "on": ".forma-fault",
          "values": "diagnostic | warning | error | critical",
          "default": "absent (solid error-style border)",
          "description": "The Aegis severity, lowercased. Changes the start-border style; it must always be paired with the visible severity text."
        },
        {
          "name": "data-forma-intent",
          "on": ".forma-fault",
          "values": "inline | notification | banner | blocking",
          "default": "—",
          "description": "Records the Aegis intent the application mapped. Descriptive only; Forma CSS does not style it."
        },
        {
          "name": "aria-labelledby",
          "on": ".forma-fault",
          "values": "id of .forma-fault__title",
          "default": "—",
          "description": "Names the fault region by its title."
        },
        {
          "name": "aria-describedby",
          "on": ".forma-fault",
          "values": "id of .forma-fault__message",
          "default": "—",
          "description": "Associates the safe user-facing message as the region's description."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-fault__marker",
          "values": "true",
          "default": "—",
          "description": "Required. The marker glyph repeats the severity visually and must not be read aloud."
        },
        {
          "name": "role",
          "on": ".forma-recovery-actions",
          "values": "group",
          "default": "—",
          "description": "Groups the recovery buttons so assistive technology announces them together."
        },
        {
          "name": "aria-label",
          "on": ".forma-recovery-actions",
          "values": "string",
          "default": "—",
          "description": "Names the recovery group, for example \"Recovery actions\"."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Required on every recovery button so it never submits an enclosing form."
        },
        {
          "name": "data-forma-aegis-capability",
          "on": "button",
          "values": "Aegis capability case name, e.g. CanRetry",
          "default": "—",
          "description": "The exact Aegis capability the button represents. Describes intent to application code; it is not authority and must be revalidated on activation."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-fault",
          "elements": [
            "forma-fault__body",
            "forma-fault__marker",
            "forma-fault__message",
            "forma-fault__severity",
            "forma-fault__title"
          ],
          "modifiers": [
            "forma-fault--inline"
          ],
          "attributes": [
            {
              "name": "data-forma-severity",
              "values": [
                "critical",
                "diagnostic",
                "warning"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between recovery buttons. The fault region itself is not focusable and never takes focus when it appears."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused recovery button (native button behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "warning-two-actions",
          "title": "Session expired with two recovery paths",
          "mobile": false,
          "raw": "components/fault/warning-two-actions.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "critical-reload",
          "title": "Critical fault in a side panel",
          "mobile": false,
          "raw": "components/fault/critical-reload.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "diagnostic-no-actions",
          "title": "Diagnostic notice without recovery",
          "mobile": false,
          "raw": "components/fault/diagnostic-no-actions.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-long-content",
          "title": "Long title and reference on a phone",
          "mobile": true,
          "raw": "components/fault/mobile-long-content.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "fault-inline",
        "fault-notification",
        "fault-banner",
        "fault-blocking",
        "recovery-actions",
        "alert"
      ]
    },
    {
      "slug": "fault-banner",
      "title": "Fault banner",
      "tag": "forma-fault-banner",
      "category": "faults",
      "behavior": "Application / Limen",
      "summary": "Persistent page/application banner for degraded or critical Aegis conditions.",
      "docsUrl": "components/fault-banner/",
      "pattern": "patterns/fault-banner.html",
      "minimalHtml": "<forma-fault-banner class=\"forma-component-tag\">\n<aside\n  class=\"forma-alert forma-fault-banner\"\n  role=\"status\"\n  data-forma-intent=\"banner\"\n  data-forma-severity=\"critical\"\n  data-forma-motion-weight=\"standard\"\n  data-forma-motion-entry\n  aria-labelledby=\"fault-banner-title\">\n  <div class=\"forma-alert__icon forma-fault-banner__marker\" aria-hidden=\"true\">!!</div>\n  <div class=\"forma-fault-banner__body\">\n    <p class=\"forma-fault__severity\">Critical</p>\n    <h2 class=\"forma-alert__title\" id=\"fault-banner-title\">Diagnostics storage is unavailable</h2>\n    <p>The application is running in a degraded state. New diagnostics are queued locally.</p>\n    <p class=\"forma-fault-reference\">Reference <code>AG-22K8M</code></p>\n  </div>\n  <div class=\"forma-recovery-actions\" role=\"group\" aria-label=\"Recovery actions\">\n    <button type=\"button\" data-forma-aegis-capability=\"CanRestoreSink\">Reconnect diagnostics</button>\n  </div>\n</aside>\n</forma-fault-banner>",
      "attributes": [
        {
          "name": "role",
          "on": "aside.forma-fault-banner",
          "values": "status",
          "default": "absent",
          "description": "Use for the first insertion only. Omit it when the same banner is re-rendered so it does not announce again."
        },
        {
          "name": "aria-labelledby",
          "on": "aside.forma-fault-banner",
          "values": "id of .forma-alert__title",
          "default": "—",
          "description": "Names the complementary region by the banner title."
        },
        {
          "name": "data-forma-severity",
          "on": "aside.forma-fault-banner",
          "values": "diagnostic | warning | error | critical",
          "default": "—",
          "description": "Aegis severity. critical thickens the block borders; always paired with visible severity text."
        },
        {
          "name": "data-forma-intent",
          "on": "aside.forma-fault-banner",
          "values": "banner",
          "default": "—",
          "description": "Records the Aegis intent. Descriptive only."
        },
        {
          "name": "data-forma-motion-entry",
          "on": "aside.forma-fault-banner",
          "values": "boolean",
          "default": "absent",
          "description": "Opts into the insertion fade and settle. Add it only on the first render."
        },
        {
          "name": "data-forma-motion-weight",
          "on": "aside.forma-fault-banner",
          "values": "light | standard | heavy",
          "default": "standard",
          "description": "Presentation-only perceived mass for the entry settle. Keep the standard default; it never reflects severity."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-alert__icon",
          "values": "true",
          "default": "—",
          "description": "Hides the decorative marker glyph."
        },
        {
          "name": "aria-label",
          "on": ".forma-recovery-actions",
          "values": "string",
          "default": "—",
          "description": "Names the recovery group."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Required on recovery buttons."
        },
        {
          "name": "data-forma-aegis-capability",
          "on": "button",
          "values": "Aegis capability name",
          "default": "—",
          "description": "Exact Aegis capability identity; the application revalidates it on click."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-fault-banner",
          "elements": [
            "forma-fault-banner__body"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-entry",
              "values": []
            },
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            },
            {
              "name": "data-forma-severity",
              "values": [
                "critical"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Reaches the recovery buttons in source order. The banner never takes focus when it appears."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused recovery button (native button behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "read-only-mode",
          "title": "Degraded read-only mode",
          "mobile": false,
          "raw": "components/fault-banner/read-only-mode.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "rerendered-warning",
          "title": "Persisting warning after rerender",
          "mobile": false,
          "raw": "components/fault-banner/rerendered-warning.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "critical-two-actions",
          "title": "Critical condition with two recovery paths",
          "mobile": false,
          "raw": "components/fault-banner/critical-two-actions.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-diagnostics",
          "title": "Diagnostics banner on a phone",
          "mobile": true,
          "raw": "components/fault-banner/mobile-diagnostics.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "alert",
        "fault-notification",
        "fault-blocking",
        "diagnostic-status"
      ]
    },
    {
      "slug": "fault-blocking",
      "title": "Fault blocking",
      "tag": "forma-fault-blocking",
      "category": "faults",
      "behavior": "Application / Limen",
      "summary": "Native-dialog surface for Aegis Blocking intent with only application-supplied recovery actions.",
      "docsUrl": "components/fault-blocking/",
      "pattern": "patterns/fault-blocking.html",
      "minimalHtml": "<forma-fault-blocking class=\"forma-component-tag\">\n<button type=\"button\" commandfor=\"blocking-fault-dialog\" command=\"show-modal\">Preview blocking fault</button>\n<dialog\n  class=\"forma-dialog forma-fault-blocking\"\n  id=\"blocking-fault-dialog\"\n  data-forma-intent=\"blocking\"\n  data-forma-severity=\"critical\"\n  data-forma-motion-weight=\"heavy\"\n  aria-labelledby=\"blocking-fault-title\"\n  aria-describedby=\"blocking-fault-message\">\n  <div class=\"forma-dialog__body\">\n    <div class=\"forma-fault-blocking__heading\">\n      <div class=\"forma-fault-blocking__marker\" aria-hidden=\"true\">!!</div>\n      <div>\n        <p class=\"forma-fault__severity\">Critical</p>\n        <h2 id=\"blocking-fault-title\">This application cannot continue safely</h2>\n      </div>\n    </div>\n    <p id=\"blocking-fault-message\">The current state cannot be verified. Use one of the recovery actions below before continuing.</p>\n    <p class=\"forma-fault-reference\">Reference <code>AG-7P2DX</code></p>\n  </div>\n  <div class=\"forma-dialog__actions forma-recovery-actions\" role=\"group\" aria-label=\"Recovery actions\">\n    <button type=\"button\" data-forma-aegis-capability=\"CanOpenReadOnly\">Open read-only</button>\n    <button type=\"button\" data-forma-aegis-capability=\"CanReload\">Reload</button>\n  </div>\n</dialog>\n</forma-fault-blocking>",
      "attributes": [
        {
          "name": "id",
          "on": "dialog",
          "values": "unique id",
          "default": "—",
          "description": "Target for the invoker's commandfor, or for application code that calls showModal()."
        },
        {
          "name": "commandfor",
          "on": "invoker button",
          "values": "dialog id",
          "default": "—",
          "description": "Preview only: associates a native invoker with the dialog. Applications normally open the dialog from Limen when Aegis intent is Blocking."
        },
        {
          "name": "command",
          "on": "invoker button",
          "values": "show-modal",
          "default": "—",
          "description": "Opens the dialog modally without script. Never use a non-modal open for a blocking fault."
        },
        {
          "name": "aria-labelledby",
          "on": "dialog",
          "values": "id of the heading",
          "default": "—",
          "description": "Required. Gives the dialog its accessible name."
        },
        {
          "name": "aria-describedby",
          "on": "dialog",
          "values": "id of the message",
          "default": "—",
          "description": "Announces the safe message when the dialog opens."
        },
        {
          "name": "data-forma-severity",
          "on": "dialog",
          "values": "diagnostic | warning | error | critical",
          "default": "—",
          "description": "Records the Aegis severity. The dialog surface is not restyled by it; the visible severity text carries the level."
        },
        {
          "name": "data-forma-intent",
          "on": "dialog",
          "values": "blocking",
          "default": "—",
          "description": "Records the Aegis intent. Descriptive only."
        },
        {
          "name": "data-forma-motion-weight",
          "on": "dialog",
          "values": "light | standard | heavy",
          "default": "heavy",
          "description": "Presentation-only perceived mass for the open transition. Heavy is the default for this surface; never map it to severity."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-fault-blocking__marker",
          "values": "true",
          "default": "—",
          "description": "Hides the decorative marker glyph."
        },
        {
          "name": "role",
          "on": ".forma-recovery-actions",
          "values": "group",
          "default": "—",
          "description": "Groups the recovery buttons in the dialog footer."
        },
        {
          "name": "aria-label",
          "on": ".forma-recovery-actions",
          "values": "string",
          "default": "—",
          "description": "Names the recovery group."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Required on every button."
        },
        {
          "name": "data-forma-aegis-capability",
          "on": "recovery button",
          "values": "Aegis capability name",
          "default": "—",
          "description": "Exact Aegis capability identity; revalidated on activation."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-fault-blocking",
          "elements": [
            "forma-fault-blocking__heading",
            "forma-fault-blocking__marker"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "While open modally, focus cycles among the recovery buttons (and any disclosure) inside the dialog; the page behind is inert."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused recovery button."
        },
        {
          "keys": "Escape",
          "action": "The browser fires cancel and, by default, closes a modal dialog. When dismissal is not legal the application must handle cancel and keep the dialog open."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "sign-in-required",
          "title": "Sign-in required to continue",
          "mobile": false,
          "raw": "components/fault-blocking/sign-in-required.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "corrupt-local-copy",
          "title": "Unverifiable local copy with safe details",
          "mobile": false,
          "raw": "components/fault-blocking/corrupt-local-copy.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-reload",
          "title": "Blocking fault on a phone",
          "mobile": true,
          "raw": "components/fault-blocking/mobile-reload.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "dialog",
        "fault-banner",
        "recovery-actions",
        "fault-details"
      ]
    },
    {
      "slug": "fault-details",
      "title": "Fault details",
      "tag": "forma-fault-details",
      "category": "faults",
      "behavior": "Application / Limen",
      "summary": "Optional disclosure for explicitly approved and already-sanitized diagnostic values only.",
      "docsUrl": "components/fault-details/",
      "pattern": "patterns/fault-details.html",
      "minimalHtml": "<forma-fault-details class=\"forma-component-tag\">\n<details class=\"forma-fault-details\">\n  <summary>Safe diagnostic details</summary>\n  <div class=\"forma-fault-details__content\">\n    <dl class=\"forma-fault-details__list\">\n      <div><dt>Reference</dt><dd><code>AG-4F82C</code></dd></div>\n      <div><dt>Application</dt><dd>Chrona</dd></div>\n      <div><dt>Recovery state</dt><dd>Retry available</dd></div>\n    </dl>\n    <p class=\"forma-fault-details__boundary\">Only explicitly approved, already-sanitized diagnostic values belong in this surface.</p>\n  </div>\n</details>\n</forma-fault-details>",
      "attributes": [
        {
          "name": "open",
          "on": "details",
          "values": "boolean",
          "default": "absent (collapsed)",
          "description": "Initial expanded state. The live state is owned by the browser; the user can always toggle it."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-fault-details",
          "elements": [
            "forma-fault-details__boundary",
            "forma-fault-details__content",
            "forma-fault-details__list"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus to and from the summary."
        },
        {
          "keys": "Enter / Space",
          "action": "Toggles the disclosure (native details behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "disclosure",
            "name": "Safe diagnostic details",
            "expect": {
              "open": true
            }
          }
        ]
      },
      "examples": [
        {
          "id": "support-view",
          "title": "Support view, open by default",
          "mobile": false,
          "raw": "components/fault-details/support-view.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Safe diagnostic details",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        },
        {
          "id": "inside-inline-fault",
          "title": "Collapsed details under an inline fault",
          "mobile": false,
          "raw": "components/fault-details/inside-inline-fault.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-stacked-values",
          "title": "Stacked values on a phone",
          "mobile": true,
          "raw": "components/fault-details/mobile-stacked-values.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Safe diagnostic details",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        }
      ],
      "related": [
        "disclosure",
        "key-value-list",
        "fault-reference"
      ]
    },
    {
      "slug": "fault-inline",
      "title": "Fault inline",
      "tag": "forma-fault-inline",
      "category": "faults",
      "behavior": "Application / Limen",
      "summary": "Operation-local Aegis fault presentation with reference and legal recovery actions.",
      "docsUrl": "components/fault-inline/",
      "pattern": "patterns/fault-inline.html",
      "minimalHtml": "<forma-fault-inline class=\"forma-component-tag\">\n<div\n  class=\"forma-fault forma-fault--inline\"\n  id=\"profile-save-fault\"\n  data-forma-intent=\"inline\"\n  data-forma-severity=\"error\"\n  aria-labelledby=\"profile-save-fault-title\">\n  <div class=\"forma-fault__marker\" aria-hidden=\"true\">!</div>\n  <div class=\"forma-fault__body\">\n    <p class=\"forma-fault__severity\">Error</p>\n    <p class=\"forma-fault__title\" id=\"profile-save-fault-title\"><strong>Profile was not saved.</strong></p>\n    <p class=\"forma-fault__message\">Check your connection and try again.</p>\n    <p class=\"forma-fault-reference\">Reference <code>AG-4F82C</code></p>\n  </div>\n  <div class=\"forma-recovery-actions\" role=\"group\" aria-label=\"Recovery actions\">\n    <button type=\"button\" data-forma-aegis-capability=\"CanRetry\">Try again</button>\n  </div>\n</div>\n</forma-fault-inline>",
      "attributes": [
        {
          "name": "id",
          "on": ".forma-fault",
          "values": "unique id",
          "default": "—",
          "description": "Lets the affected control or region reference the fault with aria-describedby."
        },
        {
          "name": "aria-describedby",
          "on": "affected control or region",
          "values": "id of the .forma-fault",
          "default": "—",
          "description": "Associates the fault with the control it is about. Append it after any existing help-text id."
        },
        {
          "name": "role",
          "on": ".forma-fault / .forma-recovery-actions",
          "values": "group",
          "default": "—",
          "description": "A group role makes the fault container nameable with aria-labelledby; the recovery container is also a group."
        },
        {
          "name": "aria-labelledby",
          "on": ".forma-fault",
          "values": "id of .forma-fault__title",
          "default": "—",
          "description": "Names the fault group by its title."
        },
        {
          "name": "data-forma-severity",
          "on": ".forma-fault",
          "values": "diagnostic | warning | error | critical",
          "default": "absent (error style)",
          "description": "Aegis severity; selects the start-border style. Always paired with visible text."
        },
        {
          "name": "data-forma-intent",
          "on": ".forma-fault",
          "values": "inline",
          "default": "—",
          "description": "Records that Aegis chose the Inline intent. Descriptive only."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-fault__marker",
          "values": "true",
          "default": "—",
          "description": "Hides the decorative marker glyph from assistive technology."
        },
        {
          "name": "aria-label",
          "on": ".forma-recovery-actions",
          "values": "string",
          "default": "—",
          "description": "Names the recovery group; include the affected object when several inline faults are on one page."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Required so recovery buttons inside a form never submit it."
        },
        {
          "name": "data-forma-aegis-capability",
          "on": "button",
          "values": "Aegis capability name",
          "default": "—",
          "description": "Exact Aegis capability identity. Not authorization; revalidate on click."
        }
      ],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the affected control and then the recovery buttons in source order. The fault never receives focus by itself."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused recovery button (native button behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "field-save",
          "title": "Field that failed to save",
          "mobile": false,
          "raw": "components/fault-inline/field-save.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "import-row",
          "title": "Import batch that could not be processed",
          "mobile": false,
          "raw": "components/fault-inline/import-row.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "no-recovery",
          "title": "Failure with no legal recovery",
          "mobile": false,
          "raw": "components/fault-inline/no-recovery.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-upload",
          "title": "Upload failure on a phone",
          "mobile": true,
          "raw": "components/fault-inline/mobile-upload.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "fault",
        "validation-message",
        "fault-summary",
        "fault-notification"
      ]
    },
    {
      "slug": "fault-notification",
      "title": "Fault notification",
      "tag": "forma-fault-notification",
      "category": "faults",
      "behavior": "Application / Limen",
      "summary": "Persistent, dismissible notification surface for Aegis Notification intent; lifecycle remains application-owned.",
      "docsUrl": "components/fault-notification/",
      "pattern": "patterns/fault-notification.html",
      "minimalHtml": "<forma-fault-notification class=\"forma-component-tag\">\n<aside\n  class=\"forma-toast forma-fault-notification\"\n  role=\"status\"\n  data-forma-intent=\"notification\"\n  data-forma-severity=\"warning\"\n  data-forma-motion-weight=\"standard\"\n  data-forma-motion-entry\n  aria-labelledby=\"fault-notification-title\">\n  <div class=\"forma-fault-notification__marker\" aria-hidden=\"true\">!</div>\n  <div class=\"forma-fault-notification__body\">\n    <p class=\"forma-fault__severity\">Warning</p>\n    <h3 class=\"forma-toast__title\" id=\"fault-notification-title\">GitHub is temporarily unavailable</h3>\n    <p>Your work is still local. You can retry the synchronization.</p>\n    <p class=\"forma-fault-reference\">Reference <code>AG-91B7Q</code></p>\n    <div class=\"forma-recovery-actions\" role=\"group\" aria-label=\"Recovery actions\">\n      <button type=\"button\" data-forma-aegis-capability=\"CanRetry\">Try again</button>\n    </div>\n  </div>\n  <button type=\"button\" class=\"forma-fault-notification__dismiss\" data-forma-action=\"dismiss\" aria-label=\"Dismiss notification\">Close</button>\n</aside>\n</forma-fault-notification>",
      "attributes": [
        {
          "name": "role",
          "on": "aside.forma-fault-notification",
          "values": "status",
          "default": "absent",
          "description": "Use only when the application inserts a genuinely new notification. Omit it when re-rendering an existing notification so it is not announced twice."
        },
        {
          "name": "aria-labelledby",
          "on": "aside.forma-fault-notification",
          "values": "id of the title",
          "default": "—",
          "description": "Names the complementary region by the notification title."
        },
        {
          "name": "data-forma-severity",
          "on": "aside.forma-fault-notification",
          "values": "diagnostic | warning | error | critical",
          "default": "—",
          "description": "Records the Aegis severity. The notification surface does not restyle by severity; the visible severity text is the cue."
        },
        {
          "name": "data-forma-intent",
          "on": "aside.forma-fault-notification",
          "values": "notification",
          "default": "—",
          "description": "Records the Aegis intent. Descriptive only."
        },
        {
          "name": "data-forma-motion-weight",
          "on": "aside.forma-fault-notification",
          "values": "light | standard | heavy",
          "default": "standard",
          "description": "Presentation-only perceived mass for the entry settle. Keep the standard default; never map it to severity."
        },
        {
          "name": "data-forma-motion-entry",
          "on": "aside.forma-fault-notification",
          "values": "boolean",
          "default": "absent",
          "description": "Opts into the entry fade and settle when the element is first rendered. Omit it when re-rendering an existing notification."
        },
        {
          "name": "data-forma-action",
          "on": ".forma-fault-notification__dismiss",
          "values": "dismiss",
          "default": "—",
          "description": "Marks the dismiss button for application code. Forma attaches no behavior to it."
        },
        {
          "name": "aria-label",
          "on": ".forma-fault-notification__dismiss / .forma-recovery-actions",
          "values": "string",
          "default": "—",
          "description": "On the dismiss button, start with the visible label and add which notification it dismisses. On the recovery group, name the group."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-fault-notification__marker",
          "values": "true",
          "default": "—",
          "description": "Hides the decorative marker glyph."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Required on dismiss and recovery buttons."
        },
        {
          "name": "data-forma-aegis-capability",
          "on": "recovery button",
          "values": "Aegis capability name",
          "default": "—",
          "description": "Exact Aegis capability identity; revalidated by the application on click."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-fault-notification",
          "elements": [
            "forma-fault-notification__body",
            "forma-fault-notification__dismiss",
            "forma-fault-notification__marker"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-entry",
              "values": []
            },
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Reaches recovery buttons and then the dismiss button in source order. Focus is not moved into the notification when it appears."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused button. Dismissal happens only when application code handles the click."
        },
        {
          "keys": "Escape",
          "action": "No built-in effect: the surface is not a popover or dialog. The application may add an Escape shortcut if its policy allows dismissal."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "reauthenticate",
          "title": "Background sync needs sign-in",
          "mobile": false,
          "raw": "components/fault-notification/reauthenticate.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "informational-rerender",
          "title": "Restored notification without re-announcement",
          "mobile": false,
          "raw": "components/fault-notification/informational-rerender.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "not-dismissible",
          "title": "Critical notification that cannot be dismissed",
          "mobile": false,
          "raw": "components/fault-notification/not-dismissible.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-sync",
          "title": "Sync failure on a phone",
          "mobile": true,
          "raw": "components/fault-notification/mobile-sync.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "toast",
        "fault-banner",
        "fault-inline",
        "fault"
      ]
    },
    {
      "slug": "fault-reference",
      "title": "Fault reference",
      "tag": "forma-fault-reference",
      "category": "faults",
      "behavior": "Application / Limen",
      "summary": "Short quotable Aegis reference with an optional application-owned copy action.",
      "docsUrl": "components/fault-reference/",
      "pattern": "patterns/fault-reference.html",
      "minimalHtml": "<forma-fault-reference class=\"forma-component-tag\">\n<p class=\"forma-fault-reference\">\n  <span>Reference</span>\n  <code>AG-4F82C</code>\n  <button type=\"button\" data-forma-action=\"copy-reference\" aria-label=\"Copy fault reference AG-4F82C\">Copy</button>\n</p>\n</forma-fault-reference>",
      "attributes": [
        {
          "name": "data-forma-action",
          "on": "button",
          "values": "copy-reference",
          "default": "—",
          "description": "Marks the copy button for application code. Forma attaches no clipboard behavior."
        },
        {
          "name": "aria-label",
          "on": "button",
          "values": "string",
          "default": "—",
          "description": "Start with the visible label and include the reference, for example \"Copy fault reference AG-4F82C\"."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Required so the copy button never submits a form."
        },
        {
          "name": "lang",
          "on": ".forma-fault-reference",
          "values": "BCP 47 tag",
          "default": "inherited",
          "description": "Set when the label is localized differently from the page."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-fault-reference",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Reaches the copy button when present. The reference text itself is not focusable."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the copy button; the application performs the copy."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "text-only",
          "title": "Reference without a copy action",
          "mobile": false,
          "raw": "components/fault-reference/text-only.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "localized-with-copy",
          "title": "Localized label with copy action",
          "mobile": false,
          "raw": "components/fault-reference/localized-with-copy.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-long-reference",
          "title": "Long reference on a phone",
          "mobile": true,
          "raw": "components/fault-reference/mobile-long-reference.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "identifier",
        "fault-details",
        "fault"
      ]
    },
    {
      "slug": "fault-summary",
      "title": "Fault summary",
      "tag": "forma-fault-summary",
      "category": "faults",
      "behavior": "Aegis / Application",
      "summary": "Focusable grouped presentation of unresolved faults after upstream fingerprinting and deduplication.",
      "docsUrl": "components/fault-summary/",
      "pattern": "patterns/fault-summary.html",
      "minimalHtml": "<forma-fault-summary class=\"forma-component-tag\">\n<section class=\"forma-fault-summary\" tabindex=\"-1\" aria-labelledby=\"fault-summary-title\">\n  <div class=\"forma-fault-summary__heading\">\n    <div class=\"forma-fault-summary__marker\" aria-hidden=\"true\">!</div>\n    <div>\n      <p class=\"forma-fault__severity\">2 unresolved faults</p>\n      <h2 id=\"fault-summary-title\">Some work needs your attention</h2>\n      <p>Repeated occurrences are grouped by the application before rendering.</p>\n    </div>\n  </div>\n  <ol class=\"forma-fault-summary__list\">\n    <li data-forma-severity=\"error\">\n      <a href=\"#customer-name\">Customer name could not be saved</a>\n      <span class=\"forma-fault-summary__meta\">Error · AG-4F82C · occurred 3 times</span>\n    </li>\n    <li data-forma-severity=\"warning\">\n      <a href=\"#sync-status\">Synchronization is waiting for GitHub</a>\n      <span class=\"forma-fault-summary__meta\">Warning · AG-91B7Q</span>\n    </li>\n  </ol>\n</section>\n</forma-fault-summary>",
      "attributes": [
        {
          "name": "tabindex",
          "on": "section.forma-fault-summary",
          "values": "-1",
          "default": "—",
          "description": "Required. Lets the application move focus to the summary after a failed operation without adding a tab stop."
        },
        {
          "name": "aria-labelledby",
          "on": "section.forma-fault-summary",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the region so focus lands on a named landmark."
        },
        {
          "name": "data-forma-severity",
          "on": "li",
          "values": "diagnostic | warning | error | critical",
          "default": "—",
          "description": "Records each entry's Aegis severity. critical makes the entry bold; the severity must also be written in the metadata line."
        },
        {
          "name": "href",
          "on": "a",
          "values": "#id of the affected region",
          "default": "—",
          "description": "Links an entry to the field or region it concerns. Omit the link when there is no affected region."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-fault-summary__marker",
          "values": "true",
          "default": "—",
          "description": "Hides the decorative marker glyph."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-fault-summary",
          "elements": [
            "forma-fault-summary__heading",
            "forma-fault-summary__list",
            "forma-fault-summary__marker",
            "forma-fault-summary__meta"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between entry links. The summary itself is not in the tab order (tabindex=-1)."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link to the affected region (native link behavior). The target should be focusable or a form control so focus moves with it."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "failed-submit",
          "title": "After a failed submit",
          "mobile": false,
          "raw": "components/fault-summary/failed-submit.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Payee account could not be verified",
                "expect": {
                  "url": "#fault-summary-failed-submit-payee"
                }
              },
              {
                "role": "link",
                "name": "Receipt upload failed",
                "expect": {
                  "url": "#fault-summary-failed-submit-receipt"
                }
              },
              {
                "role": "link",
                "name": "Exchange rate is from yesterday",
                "expect": {
                  "url": "#fault-summary-failed-submit-rate"
                }
              }
            ]
          }
        },
        {
          "id": "grouped-repeats",
          "title": "One grouped fault with many occurrences",
          "mobile": false,
          "raw": "components/fault-summary/grouped-repeats.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-summary",
          "title": "Fault summary on a phone",
          "mobile": true,
          "raw": "components/fault-summary/mobile-summary.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Delivery instructions for the north warehouse loading dock could not be saved",
                "expect": {
                  "url": "#fault-summary-mobile-summary-title"
                }
              },
              {
                "role": "link",
                "name": "Synchronization is waiting for the carrier service",
                "expect": {
                  "url": "#fault-summary-mobile-summary-title"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "validation-summary",
        "fault-inline",
        "fault"
      ]
    },
    {
      "slug": "feed-item",
      "title": "Feed item",
      "tag": "forma-feed-item",
      "category": "data",
      "behavior": "Application content",
      "summary": "Compact chronological item with explicit identity, state, metadata, and owned actions.",
      "docsUrl": "components/feed-item/",
      "pattern": "patterns/feed-item.html",
      "minimalHtml": "<forma-feed-item class=\"forma-component-tag\">\n<article class=\"forma-feed-item\" aria-labelledby=\"feed-item-title\">\n  <div class=\"forma-feed-item__primary\">\n    <p class=\"forma-feed-item__source\">Build system</p>\n    <h2 id=\"feed-item-title\">Deployment requires review</h2>\n  </div>\n  <div class=\"forma-feed-item__meta\">\n    <span class=\"forma-status-lozenge\" data-state=\"warning\">Needs review</span>\n    <time datetime=\"2026-09-25T18:30:00Z\">18:30</time>\n  </div>\n  <p class=\"forma-feed-item__summary\">Production approval is still unresolved.</p>\n  <div class=\"forma-feed-item__actions\"><button type=\"button\">Review</button></div>\n</article>\n</forma-feed-item>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "article.forma-feed-item",
          "values": "id of the item heading",
          "default": "—",
          "description": "Names the article by its title so it can be found in a list of articles."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO date-time",
          "default": "—",
          "description": "Machine-readable time of the item."
        },
        {
          "name": "aria-label",
          "on": "action button",
          "values": "string",
          "default": "—",
          "description": "Names the item an action applies to when the visible label is generic."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Actions are native buttons that the application wires to its own handlers."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-feed-item",
          "elements": [
            "forma-feed-item__actions",
            "forma-feed-item__meta",
            "forma-feed-item__primary",
            "forma-feed-item__summary"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab",
          "action": "Moves to each action button in the item. The item itself is not focusable."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates a focused action button (native)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "mention-with-actions",
          "title": "Mention with several actions",
          "mobile": false,
          "raw": "components/feed-item/mention-with-actions.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "resolved-without-actions",
          "title": "Resolved item without actions",
          "mobile": false,
          "raw": "components/feed-item/resolved-without-actions.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "feed-list-long-title",
          "title": "Feed list with a long title",
          "mobile": false,
          "raw": "components/feed-item/feed-list-long-title.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-feed-item",
          "title": "Mobile feed item",
          "mobile": true,
          "raw": "components/feed-item/mobile-feed-item.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "timeline",
        "work-queue",
        "toast",
        "status-lozenge"
      ]
    },
    {
      "slug": "file-upload",
      "title": "File upload queue",
      "tag": "forma-file-upload",
      "category": "forms",
      "behavior": "Native HTML / Limen",
      "summary": "Native file selection plus a reusable upload queue for progress, success, cancellation, failure, and unknown outcomes.",
      "docsUrl": "components/file-upload/",
      "pattern": "patterns/file-upload.html",
      "minimalHtml": "<forma-file-upload class=\"forma-component-tag\">\n<section class=\"forma-file-upload\" aria-labelledby=\"upload-title\">\n  <div class=\"forma-file-upload__drop\">\n    <h3 id=\"upload-title\">Add evidence files</h3>\n    <p>Choose files. Drag and drop may be provided as an optional enhancement.</p>\n    <label class=\"forma-button\">Choose files <input type=\"file\" multiple></label>\n  </div>\n  <ul class=\"forma-file-upload__queue\">\n    <li>\n      <div><strong>survey-results.csv</strong><small>1.8 MB</small></div>\n      <progress value=\"100\" max=\"100\" aria-label=\"survey-results.csv upload progress\">100%</progress>\n      <span class=\"forma-status-lozenge\" data-state=\"ok\">Uploaded</span>\n    </li>\n    <li>\n      <div><strong>evidence.pdf</strong><small>4.2 MB</small></div>\n      <progress value=\"64\" max=\"100\" aria-label=\"evidence.pdf upload progress\">64%</progress>\n      <button type=\"button\">Cancel</button>\n    </li>\n  </ul>\n</section>\n</forma-file-upload>",
      "attributes": [
        {
          "name": "type",
          "on": "input / button",
          "values": "file on the chooser; button on queue actions",
          "default": "—",
          "description": "The native file chooser; queue actions are type=button so they never submit a form."
        },
        {
          "name": "multiple",
          "on": "input[type=file]",
          "values": "boolean",
          "default": "absent",
          "description": "Allows selecting several files at once."
        },
        {
          "name": "accept",
          "on": "input[type=file]",
          "values": "extensions or MIME types",
          "default": "any",
          "description": "Filters the chooser. It is a hint, not enforcement: the application must still validate type and size."
        },
        {
          "name": "name",
          "on": "input[type=file]",
          "values": "string",
          "default": "—",
          "description": "Field name when the files are submitted with a form."
        },
        {
          "name": "aria-labelledby",
          "on": "section.forma-file-upload",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the upload region with its visible heading."
        },
        {
          "name": "value",
          "on": "progress",
          "values": "number",
          "default": "absent (indeterminate)",
          "description": "Current progress. Omit it for waiting or unknown-size transfers."
        },
        {
          "name": "max",
          "on": "progress",
          "values": "number",
          "default": "1",
          "description": "Scale of the progress value."
        },
        {
          "name": "aria-label",
          "on": "progress",
          "values": "string",
          "default": "—",
          "description": "Names each progress bar with its file so rows are distinguishable."
        },
        {
          "name": "data-state",
          "on": ".forma-status-lozenge",
          "values": "ok | attention | unknown | blocked",
          "default": "—",
          "description": "Outcome glyph for the file's status lozenge; always paired with text."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-file-upload",
          "elements": [
            "forma-file-upload__drop",
            "forma-file-upload__queue"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab",
          "action": "Moves to the file input inside the Choose files label, then through queue action buttons in order."
        },
        {
          "keys": "Enter / Space",
          "action": "Opens the native file chooser from the focused file input, or activates a queue action."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "mixed-outcomes",
          "title": "Failed, unknown and waiting files",
          "mobile": false,
          "raw": "components/file-upload/mixed-outcomes.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "single-image",
          "title": "Single profile photo",
          "mobile": false,
          "raw": "components/file-upload/single-image.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-evidence",
          "title": "Mobile evidence upload",
          "mobile": true,
          "raw": "components/file-upload/mobile-evidence.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "status-lozenge",
        "progress-bar",
        "operation-status",
        "composer"
      ]
    },
    {
      "slug": "flyout",
      "title": "Flyout",
      "tag": "forma-flyout",
      "category": "overlays",
      "behavior": "Native HTML",
      "summary": "Left/right edge modal surface built on native dialog semantics with reciprocal physics-derived motion.",
      "docsUrl": "components/flyout/",
      "pattern": "patterns/flyout.html",
      "minimalHtml": "<forma-flyout class=\"forma-component-tag\">\n<button type=\"button\" commandfor=\"left-flyout\" command=\"show-modal\">Open left flyout</button>\n<dialog\n  class=\"forma-flyout\"\n  id=\"left-flyout\"\n  data-forma-side=\"left\"\n  data-forma-motion-weight=\"heavy\"\n  aria-labelledby=\"left-flyout-title\"\n  aria-describedby=\"left-flyout-description\">\n  <div class=\"forma-flyout__surface\">\n    <header class=\"forma-flyout__header\">\n      <div>\n        <p class=\"forma-component-kicker\">Filters</p>\n        <h2 id=\"left-flyout-title\">Refine results</h2>\n      </div>\n      <button\n        class=\"forma-flyout__close\"\n        type=\"button\"\n        commandfor=\"left-flyout\"\n        command=\"close\"\n        aria-label=\"Close left flyout\">Close</button>\n    </header>\n    <div class=\"forma-flyout__body\">\n      <p id=\"left-flyout-description\">A left-edge modal surface for contextual controls or navigation.</p>\n      <label class=\"forma-checkbox\" data-forma-motion-weight=\"standard\">\n        <input class=\"forma-checkbox__input\" type=\"checkbox\" name=\"open-only\" value=\"yes\">\n        <span class=\"forma-checkbox__box\" aria-hidden=\"true\"></span>\n        <span class=\"forma-checkbox__text\">\n          <span class=\"forma-checkbox__label\">Open items only</span>\n        </span>\n      </label>\n    </div>\n    <footer class=\"forma-flyout__actions\">\n      <button type=\"button\" commandfor=\"left-flyout\" command=\"close\">Apply</button>\n    </footer>\n  </div>\n</dialog>\n\n<button type=\"button\" commandfor=\"right-flyout\" command=\"show-modal\">Open right flyout</button>\n<dialog\n  class=\"forma-flyout\"\n  id=\"right-flyout\"\n  data-forma-side=\"right\"\n  data-forma-motion-weight=\"heavy\"\n  aria-labelledby=\"right-flyout-title\"\n  aria-describedby=\"right-flyout-description\">\n  <div class=\"forma-flyout__surface\">\n    <header class=\"forma-flyout__header\">\n      <div>\n        <p class=\"forma-component-kicker\">Details</p>\n        <h2 id=\"right-flyout-title\">Record context</h2>\n      </div>\n      <button\n        class=\"forma-flyout__close\"\n        type=\"button\"\n        commandfor=\"right-flyout\"\n        command=\"close\"\n        aria-label=\"Close right flyout\">Close</button>\n    </header>\n    <div class=\"forma-flyout__body\">\n      <p id=\"right-flyout-description\">A right-edge modal surface for detail, inspection, or contextual work.</p>\n      <dl>\n        <dt>Status</dt>\n        <dd>Needs review</dd>\n        <dt>Owner</dt>\n        <dd>Application supplied</dd>\n      </dl>\n    </div>\n    <footer class=\"forma-flyout__actions\">\n      <button type=\"button\" commandfor=\"right-flyout\" command=\"close\">Done</button>\n    </footer>\n  </div>\n</dialog>\n</forma-flyout>",
      "attributes": [
        {
          "name": "commandfor",
          "on": "invoker and close buttons",
          "values": "id of the flyout dialog",
          "default": "—",
          "description": "Connects a button to the flyout."
        },
        {
          "name": "command",
          "on": "invoker and close buttons",
          "values": "show-modal | close",
          "default": "—",
          "description": "Always open with `show-modal`; a non-modal `show()` is not a supported flyout state."
        },
        {
          "name": "data-forma-side",
          "on": "dialog",
          "values": "left | right",
          "default": "—",
          "description": "Required. Which viewport edge the panel attaches to and enters from. Without it the panel is not attached to an edge (the browser centers it horizontally) but still slides in from the right."
        },
        {
          "name": "aria-labelledby",
          "on": "dialog",
          "values": "id of the header title",
          "default": "—",
          "description": "Required. Names the flyout."
        },
        {
          "name": "aria-describedby",
          "on": "dialog",
          "values": "id",
          "default": "—",
          "description": "Optional short summary announced on open."
        },
        {
          "name": "aria-label",
          "on": ".forma-flyout__close",
          "values": "string",
          "default": "—",
          "description": "Names the close button with its object (\"Close filters\") so several flyouts are distinguishable."
        },
        {
          "name": "closedby",
          "on": "dialog",
          "values": "any | closerequest | none",
          "default": "closerequest",
          "description": "`any` adds light dismiss on backdrop click where supported."
        },
        {
          "name": "method",
          "on": "form.forma-flyout__surface",
          "values": "dialog",
          "default": "—",
          "description": "Lets footer submit buttons close the flyout and report their value."
        },
        {
          "name": "data-forma-motion-weight",
          "on": "dialog",
          "values": "light | standard | heavy",
          "default": "heavy",
          "description": "Presentation-only perceived mass for the slide."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-flyout",
          "elements": [
            "forma-flyout__actions",
            "forma-flyout__body",
            "forma-flyout__close",
            "forma-flyout__header",
            "forma-flyout__surface"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            },
            {
              "name": "data-forma-side",
              "values": [
                "left",
                "right"
              ]
            },
            {
              "name": "open",
              "values": []
            }
          ],
          "customProperties": [
            {
              "name": "--forma-flyout-closed-x",
              "default": "100%"
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Enter / Space on the invoker",
          "action": "Opens the flyout; focus moves to the first focusable element (normally Close) or an autofocus element."
        },
        {
          "keys": "Tab / Shift+Tab",
          "action": "Cycles through controls inside the flyout; the page behind is inert."
        },
        {
          "keys": "Escape",
          "action": "Closes the flyout and returns focus to the invoker (native modal dialog)."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "button",
            "name": "Open left flyout",
            "expect": {
              "open": true
            }
          },
          {
            "role": "button",
            "name": "Close left flyout",
            "expect": {
              "open": false
            }
          },
          {
            "role": "button",
            "name": "Open left flyout",
            "expect": {
              "open": true
            }
          },
          {
            "role": "button",
            "name": "Apply",
            "expect": {
              "open": false
            }
          },
          {
            "role": "button",
            "name": "Open right flyout",
            "expect": {
              "open": true
            }
          },
          {
            "role": "button",
            "name": "Close right flyout",
            "expect": {
              "open": false
            }
          },
          {
            "role": "button",
            "name": "Open right flyout",
            "expect": {
              "open": true
            }
          },
          {
            "role": "button",
            "name": "Done",
            "expect": {
              "open": false
            }
          }
        ]
      },
      "examples": [
        {
          "id": "filters-with-pinned-actions",
          "title": "Filters with a long, scrolling body",
          "mobile": false,
          "raw": "components/flyout/filters-with-pinned-actions.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Filters",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Close filters",
                "expect": {
                  "open": false
                }
              },
              {
                "role": "button",
                "name": "Filters",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Clear all",
                "expect": {
                  "open": false
                }
              },
              {
                "role": "button",
                "name": "Filters",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Show results",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        },
        {
          "id": "quick-view-light-dismiss",
          "title": "Quick view that closes on outside click",
          "mobile": false,
          "raw": "components/flyout/quick-view-light-dismiss.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Recent activity",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Close recent activity",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        },
        {
          "id": "mobile-record-detail",
          "title": "Record detail on a phone",
          "mobile": true,
          "raw": "components/flyout/mobile-record-detail.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "View order 58213",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Close order 58213",
                "expect": {
                  "open": false
                }
              },
              {
                "role": "button",
                "name": "View order 58213",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Done",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        }
      ],
      "related": [
        "dialog",
        "sidebar",
        "split-pane",
        "popover",
        "mobile-action-bar"
      ]
    },
    {
      "slug": "focus-stage",
      "title": "Focus stage",
      "tag": "forma-focus-stage",
      "category": "workspaces",
      "behavior": "Application content",
      "summary": "Dominant primary work surface with subordinate supporting context that stacks without semantic reordering.",
      "docsUrl": "components/focus-stage/",
      "pattern": "patterns/focus-stage.html",
      "minimalHtml": "<forma-focus-stage class=\"forma-component-tag\">\n<section class=\"forma-focus-stage\" aria-label=\"Focused work\">\n  <main class=\"forma-focus-stage__primary forma-surface\"><h2>Primary artifact</h2><p>The dominant work surface receives available space.</p></main>\n  <aside class=\"forma-focus-stage__support forma-stack\"><h2>Inspector</h2><label>Title <input value=\"Primary artifact\"></label><button type=\"button\">Apply</button></aside>\n</section>\n</forma-focus-stage>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "root, support aside",
          "values": "string",
          "default": "—",
          "description": "Names the stage and the support landmark when they have no visible heading."
        },
        {
          "name": "aria-labelledby",
          "on": "primary and support regions",
          "values": "id of a visible heading",
          "default": "—",
          "description": "Names each region by its heading."
        },
        {
          "name": "style",
          "on": "root",
          "values": "--forma-focus-stage-support, --forma-focus-stage-space",
          "default": "—",
          "description": "Per-instance override of the support track and gap."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-focus-stage",
          "elements": [
            "forma-focus-stage__primary",
            "forma-focus-stage__support"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": [
            {
              "name": "--forma-focus-stage-space",
              "default": "var(--forma-primitive-spacing-5, 1.5rem)"
            },
            {
              "name": "--forma-focus-stage-support",
              "default": "minmax(14rem, 20rem)"
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the primary region first, then the support region. No added keyboard behavior."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "article-editor",
          "title": "Article editor with publishing checklist",
          "mobile": false,
          "raw": "components/focus-stage/article-editor.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "narrow-support",
          "title": "Compact support column",
          "mobile": false,
          "raw": "components/focus-stage/narrow-support.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-stacked",
          "title": "Mobile stacked support",
          "mobile": true,
          "raw": "components/focus-stage/mobile-stacked.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        }
      ],
      "related": [
        "split-pane",
        "rail",
        "workspace-shell",
        "preview-surface"
      ]
    },
    {
      "slug": "form",
      "title": "Form",
      "tag": "forma-form",
      "category": "forms",
      "behavior": "Native HTML",
      "summary": "A semantic, responsive native form contract with aligned fields, explicit submit/reset commands, native validation and observable script-free feedback.",
      "docsUrl": "components/form/",
      "pattern": "patterns/form.html",
      "minimalHtml": "<forma-form class=\"forma-component-tag\">\n<form class=\"forma-form\" id=\"nasa-mission-customer\" method=\"get\" action=\"#nasa-mission-customer-saved\" aria-labelledby=\"nasa-mission-customer-title\">\n<h2 id=\"nasa-mission-customer-title\">Artemis mission customer contact</h2>\n<div class=\"forma-form-row\" data-forma-form-layout=\"grid\">\n  <div class=\"forma-field\">\n  <label class=\"forma-field__label\" for=\"nasa-mission-contact-name\">Mission contact name (required)</label>\n  <span class=\"forma-field__description\" id=\"nasa-mission-contact-name-description\">Primary contact for Artemis II payload coordination.</span>\n  <input type=\"text\" id=\"nasa-mission-contact-name\" name=\"contact-name\" required autocomplete=\"name\" value=\"Reid Wiseman\" aria-describedby=\"nasa-mission-contact-name-description nasa-mission-contact-name-error\">\n  <p class=\"forma-validation-message forma-validation-message--when-invalid\" id=\"nasa-mission-contact-name-error\"><span class=\"forma-validation-message__mark\" aria-hidden=\"true\">!</span>Enter the mission contact name.</p>\n  </div>\n  <div class=\"forma-field\">\n  <label class=\"forma-field__label\" for=\"nasa-mission-contact-email\">Mission contact email (required)</label>\n  <span class=\"forma-field__description\" id=\"nasa-mission-contact-email-description\">Use the monitored address for launch-window updates.</span>\n  <input type=\"email\" id=\"nasa-mission-contact-email\" name=\"contact-email\" required autocomplete=\"email\" inputmode=\"email\" value=\"artemis-ii@nasa.gov\" aria-describedby=\"nasa-mission-contact-email-description nasa-mission-contact-email-error\">\n  <p class=\"forma-validation-message forma-validation-message--when-invalid\" id=\"nasa-mission-contact-email-error\"><span class=\"forma-validation-message__mark\" aria-hidden=\"true\">!</span>Enter an email address such as name@nasa.gov.</p>\n  </div>\n</div>\n<div class=\"forma-actions\"><button type=\"submit\">Save customer</button><button type=\"reset\">Reset form</button></div>\n<p class=\"forma-form__outcome\" id=\"nasa-mission-customer-saved\" role=\"status\" aria-label=\"Save status\">Mission customer contact saved.</p>\n</form>\n</forma-form>",
      "attributes": [
        {
          "name": "method",
          "on": "form.forma-form",
          "values": "get | post",
          "default": "get",
          "description": "Native form submission method. Static documentation uses GET so its result is observable in the URL."
        },
        {
          "name": "action",
          "on": "form.forma-form",
          "values": "URL or #feedback-id",
          "default": "current URL",
          "description": "Real submission destination. A local fragment may expose `.forma-form__outcome`; production persistence belongs to the application endpoint."
        },
        {
          "name": "type",
          "on": "button",
          "values": "submit | reset | button",
          "default": "submit",
          "description": "Write the native command explicitly. Design-contract standard mode binds submit and reset only."
        },
        {
          "name": "required",
          "on": "native form control",
          "values": "boolean",
          "default": "absent",
          "description": "Participates in native constraint validation. Also state required status in visible text."
        },
        {
          "name": "aria-describedby",
          "on": "native form control",
          "values": "description and validation ids",
          "default": "—",
          "description": "Associates guidance and recovery text in reading order."
        },
        {
          "name": "role",
          "on": ".forma-form__outcome",
          "values": "status",
          "default": "—",
          "description": "Announces newly navigated save feedback without moving focus."
        },
        {
          "name": "aria-busy",
          "on": "form.forma-form",
          "values": "true",
          "default": "absent",
          "description": "Marks a submission in flight: progress cursor on the form. Pair it with `<fieldset disabled>` around the fields (the browser then refuses edits and resubmission) and a pending submit button; the application removes all three when the work finishes."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-form",
          "elements": [
            "forma-form__outcome"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "aria-busy",
              "values": [
                "true"
              ]
            }
          ],
          "customProperties": [
            {
              "name": "--forma-form-gap",
              "default": null
            },
            {
              "name": "--forma-form-max",
              "default": null
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through native controls and actions in DOM order."
        },
        {
          "keys": "Enter",
          "action": "In a single-line field, invokes the form's default submit action when constraints pass."
        },
        {
          "keys": "Space or Enter",
          "action": "Activates the focused Save or Reset button through native button behavior."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "button",
            "name": "Reset form",
            "prepare": {
              "kind": "fill",
              "target": {
                "role": "textbox",
                "name": "Mission contact name (required)"
              },
              "value": "Victor Glover"
            },
            "expect": {
              "value": "Reid Wiseman"
            }
          },
          {
            "role": "button",
            "name": "Save customer",
            "expect": {
              "url": "#nasa-mission-customer-saved"
            }
          }
        ]
      },
      "examples": [
        {
          "id": "orion-communications-handoff",
          "title": "Orion communications handoff",
          "mobile": false,
          "raw": "components/form/orion-communications-handoff.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Reset handoff",
                "prepare": {
                  "kind": "fill",
                  "target": {
                    "role": "textbox",
                    "name": "Handoff note"
                  },
                  "value": "Use alternate Goldstone pass."
                },
                "expect": {
                  "value": "Confirm Deep Space Network coverage before launch."
                }
              },
              {
                "role": "button",
                "name": "Save handoff",
                "expect": {
                  "url": "#orion-handoff-saved"
                }
              }
            ]
          }
        },
        {
          "id": "pending-submission",
          "title": "Submission pending",
          "mobile": false,
          "raw": "components/form/pending-submission.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "customer-email-validation",
          "title": "Customer email validation",
          "mobile": false,
          "raw": "components/form/customer-email-validation.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Reset contact",
                "prepare": {
                  "kind": "fill",
                  "target": {
                    "role": "textbox",
                    "name": "Customer email (required)"
                  },
                  "value": "changed@nasa.gov"
                },
                "expect": {
                  "value": "gateway@nasa.gov"
                }
              },
              {
                "role": "button",
                "name": "Save contact",
                "expect": {
                  "url": "#gateway-contact-saved"
                }
              }
            ]
          }
        },
        {
          "id": "mobile-mission-customer",
          "title": "Mobile mission customer",
          "mobile": true,
          "raw": "components/form/mobile-mission-customer.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Reset mobile form",
                "prepare": {
                  "kind": "fill",
                  "target": {
                    "role": "textbox",
                    "name": "Mission customer name (required)"
                  },
                  "value": "NASA Gateway"
                },
                "expect": {
                  "value": "Artemis II"
                }
              },
              {
                "role": "button",
                "name": "Save mobile customer",
                "expect": {
                  "url": "#mobile-mission-customer-saved"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "form-row",
        "validation-message",
        "validation-summary",
        "button"
      ]
    },
    {
      "slug": "form-row",
      "title": "Form row",
      "tag": "forma-form-row",
      "category": "layout",
      "behavior": "Native HTML",
      "summary": "Peer form fields side by side whose controls share one top edge however long their labels, descriptions or validation messages are; fields wrap to new rows by available width.",
      "docsUrl": "components/form-row/",
      "pattern": "patterns/form-row.html",
      "minimalHtml": "<forma-form-row class=\"forma-component-tag\">\n<div class=\"forma-form-row\">\n  <div class=\"forma-field\">\n    <label class=\"forma-field__label\" for=\"form-row-given-name\">Given name</label>\n    <input id=\"form-row-given-name\" name=\"given-name\" type=\"text\" autocomplete=\"given-name\">\n  </div>\n  <div class=\"forma-field\">\n    <label class=\"forma-field__label\" for=\"form-row-family-name\">Family name</label>\n    <span class=\"forma-field__description\" id=\"form-row-family-name-description\">As printed on your passport or national identity card.</span>\n    <input id=\"form-row-family-name\" name=\"family-name\" type=\"text\" autocomplete=\"family-name\" aria-describedby=\"form-row-family-name-description\">\n  </div>\n  <div class=\"forma-field\">\n    <label class=\"forma-field__label\" for=\"form-row-birth-date\">Date of birth</label>\n    <input id=\"form-row-birth-date\" name=\"birth-date\" type=\"date\" autocomplete=\"bday\">\n  </div>\n</div>\n</forma-form-row>",
      "attributes": [
        {
          "name": "class=\"forma-field\"",
          "on": "each direct child",
          "values": "—",
          "description": "Each peer is an ordinary [[text-field]] structure: label, optional description, one control and an optional [[validation-message]]."
        },
        {
          "name": "for",
          "on": "label.forma-field__label",
          "values": "id of the control",
          "default": "—",
          "description": "Associates the visible label with its control."
        },
        {
          "name": "aria-describedby",
          "on": "the control",
          "values": "id list",
          "default": "—",
          "description": "Links the description and, when shown, the validation message, in reading order."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-form-row",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": [
            {
              "name": "--forma-form-row-gap",
              "default": null
            },
            {
              "name": "--forma-form-row-min",
              "default": "14rem"
            }
          ]
        }
      ],
      "keyboard": [],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "error-on-one-field",
          "title": "Validation message on one field",
          "mobile": false,
          "raw": "components/form-row/error-on-one-field.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "translated-labels",
          "title": "Long translated labels",
          "mobile": false,
          "raw": "components/form-row/translated-labels.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-stacked-row",
          "title": "Stacked on a phone",
          "mobile": true,
          "raw": "components/form-row/mobile-stacked-row.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "text-field",
        "date-time-field",
        "grid",
        "stack",
        "validation-message"
      ]
    },
    {
      "slug": "frame",
      "title": "Frame",
      "tag": "forma-frame",
      "category": "layout",
      "behavior": "Native CSS",
      "summary": "Constrains media to an explicit aspect ratio while keeping content contained.",
      "docsUrl": "components/frame/",
      "pattern": "patterns/frame.html",
      "minimalHtml": "<forma-frame class=\"forma-component-tag\">\n<figure class=\"forma-frame\">\n  <div class=\"forma-frame__media\"><img src=\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='800' height='450'%3E%3Crect width='100%25' height='100%25' fill='%23ddd'/%3E%3C/svg%3E\" alt=\"\"></div>\n  <figcaption>Frame preserves a declared media proportion without making the content itself a component.</figcaption>\n</figure>\n</forma-frame>",
      "attributes": [
        {
          "name": "style",
          "on": ".forma-frame",
          "values": "--forma-frame-ratio: <ratio>",
          "default": "16 / 9",
          "description": "Per-instance aspect ratio, for example 1 / 1 or 4 / 3."
        },
        {
          "name": "alt",
          "on": "img",
          "values": "string",
          "default": "—",
          "description": "Required on images. Describe the content; use alt=\"\" only when the image is decorative and the caption carries the meaning."
        },
        {
          "name": "role",
          "on": "svg",
          "values": "img",
          "default": "—",
          "description": "Makes an inline SVG a single named image."
        },
        {
          "name": "aria-labelledby",
          "on": "svg",
          "values": "id of the SVG title",
          "default": "—",
          "description": "Names the SVG image from its title element."
        },
        {
          "name": "aria-label",
          "on": "list wrapper",
          "values": "string",
          "default": "—",
          "description": "Names a grid of framed images."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-frame",
          "elements": [
            "forma-frame__media"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": [
            {
              "name": "--forma-frame-ratio",
              "default": "16 / 9"
            }
          ]
        }
      ],
      "keyboard": [],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "square-thumbnails",
          "title": "Square product thumbnails",
          "mobile": false,
          "raw": "components/frame/square-thumbnails.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "inline-svg-banner",
          "title": "Wide banner with inline SVG",
          "mobile": false,
          "raw": "components/frame/inline-svg-banner.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-article-image",
          "title": "Mobile article image",
          "mobile": true,
          "raw": "components/frame/mobile-article-image.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "grid",
        "diagram",
        "image-choice"
      ]
    },
    {
      "slug": "freshness",
      "title": "Freshness",
      "tag": "forma-freshness",
      "category": "feedback",
      "behavior": "Application state",
      "summary": "States when evidence or data was last verified, with a machine-readable time and an explicit current or stale label.",
      "docsUrl": "components/freshness/",
      "pattern": "patterns/freshness.html",
      "minimalHtml": "<forma-freshness class=\"forma-component-tag\">\n<p class=\"forma-freshness\"><span class=\"forma-freshness__label\">Last verified</span> <time datetime=\"2026-09-26T04:30:00Z\">04:30 UTC</time> <span class=\"forma-freshness__state\">Current</span></p>\n</forma-freshness>",
      "attributes": [
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO 8601 date or date-time",
          "default": "—",
          "description": "The exact time the evidence was verified. Include a timezone offset or Z."
        },
        {
          "name": "data-state",
          "on": ".forma-status-lozenge",
          "values": "ok | attention | unknown | blocked",
          "default": "—",
          "description": "Glyph for the lozenge that names the freshness state."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-freshness",
          "elements": [
            "forma-freshness__label"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "—",
          "action": "Not focusable or interactive."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "stale-balance",
          "title": "Stale balance",
          "mobile": false,
          "raw": "components/freshness/stale-balance.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "never-verified",
          "title": "Never verified",
          "mobile": false,
          "raw": "components/freshness/never-verified.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "record-facts",
          "title": "Freshness per value",
          "mobile": false,
          "raw": "components/freshness/record-facts.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-scan-age",
          "title": "Mobile scan age",
          "mobile": true,
          "raw": "components/freshness/mobile-scan-age.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "security-evidence-age",
        "state-survivability",
        "provenance-trail",
        "status-lozenge"
      ]
    },
    {
      "slug": "grid",
      "title": "Grid",
      "tag": "forma-grid",
      "category": "layout",
      "behavior": "Native CSS",
      "summary": "Foundation auto-fit grid that fills columns by a minimum track width and collapses to one column without media queries.",
      "docsUrl": "components/grid/",
      "pattern": "patterns/grid.html",
      "minimalHtml": "<forma-grid class=\"forma-component-tag\">\n<ul class=\"forma-grid\" aria-label=\"Environments\" role=\"list\">\n  <li class=\"forma-surface\"><h3>Production</h3><p>12 services, all reporting.</p></li>\n  <li class=\"forma-surface\"><h3>Staging</h3><p>12 services, 1 deploying.</p></li>\n  <li class=\"forma-surface\"><h3>Development</h3><p>9 services, 3 idle.</p></li>\n</ul>\n</forma-grid>",
      "attributes": [
        {
          "name": "role",
          "on": "ul.forma-grid",
          "values": "list",
          "default": "—",
          "description": "Restores list semantics that some browsers drop when list styling is removed. Keep it when the grid is a ul or ol."
        },
        {
          "name": "aria-label",
          "on": ".forma-grid",
          "values": "string",
          "default": "—",
          "description": "Names the collection so screen-reader users know what the list contains."
        },
        {
          "name": "data-density",
          "on": ".forma-grid",
          "values": "relaxed | standard | compact | analytical",
          "default": "absent (1rem gap)",
          "description": "Contextual density posture. Sets the gap to 1.5rem, 1rem, or 0.5rem (compact and analytical). Not a data-forma-* hook; it changes spacing only."
        },
        {
          "name": "style",
          "on": ".forma-grid",
          "values": "--forma-grid-min / --forma-grid-gap",
          "default": "—",
          "description": "Per-instance override of the minimum track width or the gap."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-grid",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-density",
              "values": []
            }
          ],
          "customProperties": [
            {
              "name": "--forma-grid-gap",
              "default": null
            },
            {
              "name": "--forma-grid-min",
              "default": null
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through focusable content row by row in source order. The grid is not an ARIA grid and has no arrow-key navigation."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "plan-comparison",
          "title": "Plan comparison",
          "mobile": false,
          "raw": "components/grid/plan-comparison.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "analytical-density",
          "title": "Analytical monitoring tiles",
          "mobile": false,
          "raw": "components/grid/analytical-density.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "single-item",
          "title": "Single result",
          "mobile": false,
          "raw": "components/grid/single-item.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-environments",
          "title": "Mobile environment list",
          "mobile": true,
          "raw": "components/grid/mobile-environments.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "responsive-grid",
        "mosaic",
        "dashboard-grid",
        "card-grid",
        "character-grid"
      ]
    },
    {
      "slug": "handoff-summary",
      "title": "Handoff summary",
      "tag": "forma-handoff-summary",
      "category": "assisted",
      "behavior": "Application / Ordo",
      "summary": "Exposes agent identity, proposal, uncertainty, evidence scope, and retained human authority.",
      "docsUrl": "components/handoff-summary/",
      "pattern": "patterns/handoff-summary.html",
      "minimalHtml": "<forma-handoff-summary class=\"forma-component-tag\">\n<section class=\"forma-handoff-summary\" aria-labelledby=\"handoff-title\"><header><p class=\"forma-component-kicker\">Agent proposal</p><h2 id=\"handoff-title\">Publish release</h2><p>Agent: OpenAI implementation agent</p></header><dl><div><dt>Proposed consequence</dt><dd>Publish version 1.4.0</dd></div><div><dt>Evidence</dt><dd>Tests and validation passed</dd></div><div><dt>Uncertainty</dt><dd>Production consumer smoke test not observed</dd></div><div><dt>Human authority</dt><dd>Approval required before publication</dd></div></dl><div class=\"forma-cluster\"><button type=\"button\">Approve</button><button type=\"button\">Reject</button><button type=\"button\">Request changes</button></div></section>\n</forma-handoff-summary>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "root section",
          "values": "id of the proposal heading",
          "default": "—",
          "description": "Names the handoff region by the proposed consequence."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-handoff-summary",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves to the decision actions after the facts. No added keyboard behavior."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused native button; the decision is performed by the application after checking authority."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "database-migration",
          "title": "Database migration proposal",
          "mobile": false,
          "raw": "components/handoff-summary/database-migration.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "review-only",
          "title": "Reviewer without approval authority",
          "mobile": false,
          "raw": "components/handoff-summary/review-only.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-approval",
          "title": "Mobile approval",
          "mobile": true,
          "raw": "components/handoff-summary/mobile-approval.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "understanding",
        "verification-frame",
        "conversation",
        "facts"
      ]
    },
    {
      "slug": "hero",
      "title": "Hero",
      "tag": "forma-hero",
      "category": "site",
      "behavior": "Site content",
      "summary": "A page's first region: one promise, one primary action, and optional supporting context that stacks below it in source order.",
      "docsUrl": "components/hero/",
      "pattern": "patterns/hero.html",
      "minimalHtml": "<forma-hero class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <section class=\"forma-hero\" aria-labelledby=\"hero-title\">\n    <div class=\"forma-hero__content\">\n      <p class=\"forma-eyebrow\">Applied research</p>\n      <h1 class=\"forma-hero__title\" id=\"hero-title\">State the promise before the proof</h1>\n      <p class=\"forma-lead\">The hero carries one primary recognition path: what this is, why it matters, and the one action most visitors should take.</p>\n      <div class=\"forma-actions\"><a class=\"forma-button\" data-forma-variant=\"primary\" href=\"#start\">Book a working session</a><a class=\"forma-button\" href=\"#work\">See the body of work</a></div>\n      <dl class=\"forma-facts\">\n        <div class=\"forma-facts__item\"><dt>40%+ throughput</dt><dd>Delivery flow realigned</dd></div>\n        <div class=\"forma-facts__item\"><dt>Hours to minutes</dt><dd>Reconciliation stabilized</dd></div>\n      </dl>\n    </div>\n    <div class=\"forma-hero__aside\">\n      <blockquote class=\"forma-statement\"><p>Supporting context sits beside the promise on wide screens and below it on narrow ones, in source order.</p></blockquote>\n    </div>\n  </section>\n</div>\n</forma-hero>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-hero",
          "values": "id of the hero title",
          "default": "—",
          "description": "Names the hero region by its title so it is exposed as a labelled region."
        },
        {
          "name": "id",
          "on": ".forma-hero__title",
          "values": "string",
          "default": "—",
          "description": "Referenced by the section's aria-labelledby."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-hero",
          "elements": [
            "forma-hero__aside",
            "forma-hero__content",
            "forma-hero__title"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the hero's links and buttons in source order: content actions before anything in the aside."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "product-release",
          "title": "Product release hero",
          "mobile": false,
          "raw": "components/hero/product-release.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Install",
                "expect": {
                  "url": "#hero-product-release-title"
                }
              },
              {
                "role": "link",
                "name": "Read the documentation",
                "expect": {
                  "url": "#hero-product-release-title"
                }
              }
            ]
          }
        },
        {
          "id": "promise-only",
          "title": "Promise without supporting context",
          "mobile": false,
          "raw": "components/hero/promise-only.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Book a working session",
                "expect": {
                  "url": "#hero-promise-only-title"
                }
              }
            ]
          }
        },
        {
          "id": "mobile-stacked",
          "title": "Phone hero with statement",
          "mobile": true,
          "raw": "components/hero/mobile-stacked.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Book a working session",
                "expect": {
                  "url": "#hero-mobile-stacked-title"
                }
              },
              {
                "role": "link",
                "name": "See the body of work",
                "expect": {
                  "url": "#hero-mobile-stacked-title"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "section-heading",
        "facts",
        "text-roles",
        "split"
      ]
    },
    {
      "slug": "hierarchical-choice",
      "title": "Hierarchical choice",
      "tag": "forma-hierarchical-choice",
      "category": "selection",
      "behavior": "Native baseline / application semantics",
      "summary": "Nested native disclosure and radio structure for choosing one item from a hierarchy, without assigning parent-child domain meaning.",
      "docsUrl": "components/hierarchical-choice/",
      "pattern": "patterns/hierarchical-choice.html",
      "minimalHtml": "<forma-hierarchical-choice class=\"forma-component-tag\">\n<fieldset class=\"forma-hierarchy\">\n  <legend class=\"forma-hierarchy__legend\">Choose the affected service.</legend>\n  <p class=\"forma-field__description\">Published hierarchy data is immutable. Limen coordinates expansion/cascading behavior when needed.</p>\n\n  <ul class=\"forma-hierarchy__tree\">\n    <li>\n      <details open>\n        <summary>Platform</summary>\n        <ul>\n          <li><label><input type=\"radio\" name=\"service\" value=\"identity\"> Identity</label></li>\n          <li><label><input type=\"radio\" name=\"service\" value=\"billing\"> Billing</label></li>\n        </ul>\n      </details>\n    </li>\n    <li>\n      <details>\n        <summary>Data</summary>\n        <ul>\n          <li><label><input type=\"radio\" name=\"service\" value=\"warehouse\"> Warehouse</label></li>\n          <li><label><input type=\"radio\" name=\"service\" value=\"analytics\"> Analytics</label></li>\n        </ul>\n      </details>\n    </li>\n  </ul>\n</fieldset>\n</forma-hierarchical-choice>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "radio",
          "default": "—",
          "description": "Single choice across the whole hierarchy."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "One name for every radio in the tree, so only one can be checked. Unique per question on the page."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "\"on\"",
          "description": "The application's immutable option identity, submitted for the chosen option."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Initial or restored selection. Open the branches that contain it."
        },
        {
          "name": "open",
          "on": "details",
          "values": "boolean",
          "default": "absent (collapsed)",
          "description": "Initial expanded state of a branch. The browser toggles it afterwards."
        },
        {
          "name": "aria-live",
          "on": ".forma-selection-status",
          "values": "polite",
          "default": "—",
          "description": "Optional. Announces an application-written summary of the current selection."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-hierarchy",
          "elements": [
            "forma-hierarchy__legend",
            "forma-hierarchy__tree"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between summaries and into the radio group (to the checked radio, or the first rendered one)."
        },
        {
          "keys": "Enter / Space on a summary",
          "action": "Expands or collapses that branch (native details behavior)."
        },
        {
          "keys": "Arrow keys in the radio group",
          "action": "Move to and select the previous or next radio of the same name in document order (native radio behavior). This is not tree navigation; radios inside collapsed branches are not rendered and cannot be reached until their branch is opened."
        },
        {
          "keys": "Space on a radio",
          "action": "Selects the focused radio when none is selected."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "disclosure",
            "name": "Platform",
            "expect": {
              "open": false
            }
          },
          {
            "role": "disclosure",
            "name": "Data",
            "expect": {
              "open": true
            }
          }
        ]
      },
      "examples": [
        {
          "id": "parent-level-option",
          "title": "Category-level option",
          "mobile": false,
          "raw": "components/hierarchical-choice/parent-level-option.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Data",
                "expect": {
                  "open": false
                }
              },
              {
                "role": "disclosure",
                "name": "Platform",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        },
        {
          "id": "restored-deep-selection",
          "title": "Restored selection three levels deep",
          "mobile": false,
          "raw": "components/hierarchical-choice/restored-deep-selection.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Germany",
                "expect": {
                  "open": false
                }
              },
              {
                "role": "disclosure",
                "name": "Ireland",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "disclosure",
                "name": "Europe",
                "expect": {
                  "open": false
                }
              },
              {
                "role": "disclosure",
                "name": "North America",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        },
        {
          "id": "mobile-nested-tree",
          "title": "Nested tree on a phone",
          "mobile": true,
          "raw": "components/hierarchical-choice/mobile-nested-tree.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Reporting and analytics workspace",
                "expect": {
                  "open": false
                }
              },
              {
                "role": "disclosure",
                "name": "Administration",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        }
      ],
      "related": [
        "hierarchical-multi-choice",
        "hierarchy-tree",
        "choice-group",
        "disclosure"
      ]
    },
    {
      "slug": "hierarchical-multi-choice",
      "title": "Hierarchical multi-choice",
      "tag": "forma-hierarchical-multi-choice",
      "category": "selection",
      "behavior": "Application / Limen",
      "summary": "Multi-selection across a hierarchy with application-owned propagation and selection rules.",
      "docsUrl": "components/hierarchical-multi-choice/",
      "pattern": "patterns/hierarchical-multi-choice.html",
      "minimalHtml": "<forma-hierarchical-multi-choice class=\"forma-component-tag\">\n<fieldset class=\"forma-hierarchy\">\n  <legend class=\"forma-hierarchy__legend\">Choose affected services.</legend>\n  <p class=\"forma-field__description\">Parent/descendant selection semantics are supplied by the application. The design system does not infer whether selecting a parent includes its children.</p>\n\n  <ul class=\"forma-hierarchy__tree\">\n    <li>\n      <details open>\n        <summary>Platform</summary>\n        <ul>\n          <li><label><input type=\"checkbox\" name=\"services\" value=\"identity\"> Identity</label></li>\n          <li><label><input type=\"checkbox\" name=\"services\" value=\"billing\"> Billing</label></li>\n        </ul>\n      </details>\n    </li>\n    <li>\n      <details>\n        <summary>Data</summary>\n        <ul>\n          <li><label><input type=\"checkbox\" name=\"services\" value=\"warehouse\"> Warehouse</label></li>\n          <li><label><input type=\"checkbox\" name=\"services\" value=\"analytics\"> Analytics</label></li>\n        </ul>\n      </details>\n    </li>\n  </ul>\n\n  <p class=\"forma-selection-status\" data-forma-state=\"valid\" aria-live=\"polite\">2 services selected</p>\n</fieldset>\n</forma-hierarchical-multi-choice>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "checkbox",
          "default": "—",
          "description": "Each item is an independent native checkbox."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Usually shared so the form submits one field with several values."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "\"on\"",
          "description": "Immutable item identity supplied by the application."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Initial selection. The application sets it for children when its rules say a parent includes them."
        },
        {
          "name": "disabled",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Used by the application for items that are implied by a parent choice or unavailable; disabled items are not submitted."
        },
        {
          "name": "open",
          "on": "details",
          "values": "boolean",
          "default": "absent",
          "description": "Initial expanded state of a branch."
        },
        {
          "name": "aria-describedby",
          "on": "fieldset",
          "values": "id",
          "default": "—",
          "description": "Links the application's selection rule to the group."
        },
        {
          "name": "aria-live",
          "on": ".forma-selection-status",
          "values": "polite",
          "default": "—",
          "description": "Announces the application's updated count."
        },
        {
          "name": "data-forma-state",
          "on": ".forma-selection-status",
          "values": "application vocabulary (for example valid, incomplete)",
          "default": "—",
          "description": "Unstyled marker of the application's selection state; the text carries the meaning."
        }
      ],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through summaries and each rendered checkbox in document order. Items in collapsed branches are skipped until opened."
        },
        {
          "keys": "Enter / Space on a summary",
          "action": "Expands or collapses the branch (native)."
        },
        {
          "keys": "Space on a checkbox",
          "action": "Toggles that item only. Any cascade to other items is application behavior."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "disclosure",
            "name": "Platform",
            "expect": {
              "open": false
            }
          },
          {
            "role": "disclosure",
            "name": "Data",
            "expect": {
              "open": true
            }
          }
        ]
      },
      "examples": [
        {
          "id": "category-includes-children",
          "title": "Category option that includes its children",
          "mobile": false,
          "raw": "components/hierarchical-multi-choice/category-includes-children.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Platform",
                "expect": {
                  "open": false
                }
              },
              {
                "role": "disclosure",
                "name": "Data",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        },
        {
          "id": "partial-branch-in-text",
          "title": "Partial selection stated in the summary",
          "mobile": false,
          "raw": "components/hierarchical-multi-choice/partial-branch-in-text.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Sales (1 of 3 selected)",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "disclosure",
                "name": "Support (none selected)",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        },
        {
          "id": "mobile-notification-areas",
          "title": "Notification areas on a phone",
          "mobile": true,
          "raw": "components/hierarchical-multi-choice/mobile-notification-areas.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Projects I own",
                "expect": {
                  "open": false
                }
              },
              {
                "role": "disclosure",
                "name": "Projects I follow",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        }
      ],
      "related": [
        "hierarchical-choice",
        "multi-choice",
        "checkbox",
        "hierarchy-tree"
      ]
    },
    {
      "slug": "hierarchy-tree",
      "title": "Hierarchy tree",
      "tag": "forma-hierarchy-tree",
      "category": "navigation",
      "behavior": "Native HTML / application",
      "summary": "Uses semantic nesting and native disclosure for parent-child navigation without inventing tree behavior.",
      "docsUrl": "components/hierarchy-tree/",
      "pattern": "patterns/hierarchy-tree.html",
      "minimalHtml": "<forma-hierarchy-tree class=\"forma-component-tag\">\n<nav class=\"forma-hierarchy-tree\" aria-label=\"Repository hierarchy\">\n  <ul>\n    <li><details open><summary>Application</summary><ul>\n      <li><details open><summary>Billing</summary><ul>\n        <li><a href=\"#invoices\" aria-current=\"page\">Invoices</a></li>\n        <li><a href=\"#customers\">Customers</a></li>\n      </ul></details></li>\n      <li><details><summary>Operations</summary><ul><li><a href=\"#runs\">Runs</a></li></ul></details></li>\n    </ul></details></li>\n  </ul>\n</nav>\n</forma-hierarchy-tree>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "nav",
          "values": "string",
          "default": "—",
          "description": "Names the navigation landmark."
        },
        {
          "name": "open",
          "on": "details",
          "values": "boolean",
          "default": "absent (collapsed)",
          "description": "Initial expanded state set by the application, typically on the ancestors of the current page. The browser toggles it afterwards."
        },
        {
          "name": "aria-current",
          "on": "link",
          "values": "page",
          "default": "absent",
          "description": "Marks the current page; Forma renders it bold."
        },
        {
          "name": "href",
          "on": "links",
          "values": "URL",
          "default": "—",
          "description": "Destination for each leaf or branch overview."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-hierarchy-tree",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through visible summaries and links in document order; content inside collapsed branches is skipped."
        },
        {
          "keys": "Enter / Space on a summary",
          "action": "Expands or collapses that branch (native details behavior)."
        },
        {
          "keys": "Enter on a link",
          "action": "Follows the link."
        },
        {
          "keys": "Arrow keys",
          "action": "No tree navigation. Forma does not implement role=\"tree\"; arrow keys scroll the page as usual."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "collapsed-siblings",
          "title": "Current page deep in the tree",
          "mobile": false,
          "raw": "components/hierarchy-tree/collapsed-siblings.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "branch-overview-links",
          "title": "Branches that are also destinations",
          "mobile": false,
          "raw": "components/hierarchy-tree/branch-overview-links.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile-reduced-indent",
          "title": "Deep tree on a phone",
          "mobile": true,
          "raw": "components/hierarchy-tree/mobile-reduced-indent.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "scope-trail",
        "hierarchical-choice",
        "disclosure",
        "navigation-shell"
      ]
    },
    {
      "slug": "icon",
      "title": "Icon",
      "tag": "forma-icon",
      "category": "utilities",
      "behavior": "Static presentation",
      "summary": "Brand-neutral, zero-runtime inline SVG icons compiled from Forma's reviewed registry, with explicit decorative and accessible use.",
      "docsUrl": "components/icon/",
      "pattern": "patterns/icon.html",
      "minimalHtml": "<forma-icon class=\"forma-component-tag\">\n<forma-icon class=\"forma-component-tag\"><span class=\"forma-icon\" data-forma-icon=\"search\"><svg xmlns=\"http://www.w3.org/2000/svg\" class=\"forma-icon__svg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.8\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\" focusable=\"false\"><circle cx=\"10.3\" cy=\"10.3\" r=\"6.2\"/><path d=\"M15 15L20.5 20.5\"/></svg></span></forma-icon>\n</forma-icon>",
      "attributes": [
        {
          "name": "data-forma-icon",
          "on": "span.forma-icon",
          "values": "registered name",
          "default": "source icon ID",
          "description": "Stable metadata used for inspection and tooling, not an executable icon-loading mechanism."
        },
        {
          "name": "aria-hidden",
          "on": "svg.forma-icon__svg",
          "values": "true",
          "default": "true in pre-rendered HTML",
          "description": "The generated inline SVG is decorative; consumers supply the accessible label on a containing control or via nearby text."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-icon",
          "elements": [
            "forma-icon__svg"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": [
            {
              "name": "--forma-icon-size",
              "default": null
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "None",
          "action": "An icon is inert; keyboard operation belongs to a native button, link or other named host control."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "toolbar-search",
          "title": "Search command with visible label",
          "mobile": false,
          "raw": "components/icon/toolbar-search.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "explicit-warning",
          "title": "Warning accompanied by text",
          "mobile": false,
          "raw": "components/icon/explicit-warning.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-icon-action",
          "title": "Icon action on a narrow screen",
          "mobile": true,
          "raw": "components/icon/mobile-icon-action.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "button",
        "status-lozenge",
        "visually-hidden"
      ]
    },
    {
      "slug": "identifier",
      "title": "Identifier & critical value",
      "tag": "forma-identifier",
      "category": "data",
      "behavior": "Application content",
      "summary": "Low-context identifiers, codes, numeric values, and consequential values with stronger glyph distinction and verification cues.",
      "docsUrl": "components/identifier/",
      "pattern": "patterns/identifier.html",
      "minimalHtml": "<forma-identifier class=\"forma-component-tag\">\n<section class=\"forma-stack\" aria-labelledby=\"identifier-title\">\n  <h3 id=\"identifier-title\">Reference values</h3>\n  <dl class=\"forma-key-value-list\">\n    <div><dt>Invoice</dt><dd><span class=\"forma-identifier\">INV-10O2-7B51</span></dd></div>\n    <div><dt>Execution</dt><dd><span class=\"forma-identifier\">EXE-20260926T045512Z-0O1I</span></dd></div>\n    <div><dt>Amount to verify</dt><dd><span class=\"forma-critical-value\" data-forma-verify=\"true\">$10,001.00</span></dd></div>\n  </dl>\n  <p>Low-context values use stronger glyph distinction and remain selectable text. Labels and surrounding prose still carry the meaning.</p>\n</section>\n</forma-identifier>",
      "attributes": [
        {
          "name": "data-forma-verify",
          "on": ".forma-critical-value",
          "values": "true",
          "default": "absent",
          "description": "Adds the deliberate-verification cue (inline padding and a double bottom border). Descriptive presentation only; it does not assert validity."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-identifier",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-critical-value",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-verify",
              "values": [
                "true"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "None",
          "action": "Plain inline text; not focusable. Standard text selection and copy apply."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "confusable-codes",
          "title": "Codes with confusable characters",
          "mobile": false,
          "raw": "components/identifier/confusable-codes.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "transfer-verification",
          "title": "Transfer amount and destination to verify",
          "mobile": false,
          "raw": "components/identifier/transfer-verification.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "long-hash",
          "title": "Long hash in a narrow column",
          "mobile": false,
          "raw": "components/identifier/long-hash.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-execution-id",
          "title": "Mobile execution reference",
          "mobile": true,
          "raw": "components/identifier/mobile-execution-id.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "verification-frame",
        "key-value-list",
        "code-sample",
        "text-roles"
      ]
    },
    {
      "slug": "image-choice",
      "title": "Image choice",
      "tag": "forma-image-choice",
      "category": "selection",
      "behavior": "Native HTML",
      "summary": "Choice cards that pair media with visible text while keeping the native radio or checkbox as the input.",
      "docsUrl": "components/image-choice/",
      "pattern": "patterns/image-choice.html",
      "minimalHtml": "<forma-image-choice class=\"forma-component-tag\">\n<fieldset class=\"forma-choice-group\">\n  <legend class=\"forma-choice-group__legend\">Which layout is easiest to scan?</legend>\n\n  <label class=\"forma-choice forma-choice--media\">\n    <input type=\"radio\" name=\"layout-choice\" value=\"compact\" required>\n    <span class=\"forma-choice__media\">\n      <img width=\"160\" height=\"90\" src=\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 160 90'%3E%3Crect width='160' height='90' fill='%23e3e0d7'/%3E%3Crect x='10' y='10' width='140' height='8' fill='%23686d68'/%3E%3Crect x='10' y='21' width='140' height='8' fill='%23686d68'/%3E%3Crect x='10' y='32' width='140' height='8' fill='%23686d68'/%3E%3Crect x='10' y='43' width='140' height='8' fill='%23686d68'/%3E%3Crect x='10' y='54' width='140' height='8' fill='%23686d68'/%3E%3Crect x='10' y='65' width='140' height='8' fill='%23686d68'/%3E%3Crect x='10' y='76' width='140' height='8' fill='%23686d68'/%3E%3C/svg%3E\" alt=\"\">\n    </span>\n    <span class=\"forma-choice__content\">\n      <strong>Compact layout</strong>\n      <span>Dense rows with minimal whitespace.</span>\n    </span>\n  </label>\n\n  <label class=\"forma-choice forma-choice--media\">\n    <input type=\"radio\" name=\"layout-choice\" value=\"spacious\">\n    <span class=\"forma-choice__media\">\n      <img width=\"160\" height=\"90\" src=\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 160 90'%3E%3Crect width='160' height='90' fill='%23e3e0d7'/%3E%3Crect x='10' y='10' width='140' height='8' fill='%23686d68'/%3E%3Crect x='10' y='34' width='140' height='8' fill='%23686d68'/%3E%3Crect x='10' y='58' width='140' height='8' fill='%23686d68'/%3E%3C/svg%3E\" alt=\"\">\n    </span>\n    <span class=\"forma-choice__content\">\n      <strong>Spacious layout</strong>\n      <span>More separation and larger grouping regions.</span>\n    </span>\n  </label>\n</fieldset>\n</forma-image-choice>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "radio | checkbox",
          "default": "—",
          "description": "Radio for one answer, checkbox for several. The media variant draws no indicator for either."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Shared by the options of one question; unique per question on the page."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "\"on\"",
          "description": "Submitted value for each chosen option."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Initial selection."
        },
        {
          "name": "required",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Native constraint for radio groups."
        },
        {
          "name": "disabled",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Makes an option unavailable and dims the whole card."
        },
        {
          "name": "alt",
          "on": "img",
          "values": "\"\" or text",
          "default": "—",
          "description": "Use `alt=\"\"` when the visible text fully names the option, so the name is not announced twice. Give real alt text only when the image adds information the text does not."
        },
        {
          "name": "aria-hidden",
          "on": "inline svg",
          "values": "true",
          "default": "—",
          "description": "Hides decorative inline SVG previews from assistive technology."
        }
      ],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Radios: the group is one tab stop. Checkboxes: each option is a tab stop."
        },
        {
          "keys": "Arrow keys",
          "action": "Radios only: move to and select the next or previous option (native behavior)."
        },
        {
          "keys": "Space",
          "action": "Toggles a checkbox, or selects the focused radio when none is selected."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "chart-type-checkboxes",
          "title": "Chart types, several allowed",
          "mobile": false,
          "raw": "components/image-choice/chart-type-checkboxes.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "theme-preselected",
          "title": "Preselected theme with an unavailable option",
          "mobile": false,
          "raw": "components/image-choice/theme-preselected.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-stacked-media",
          "title": "Stacked media on a phone",
          "mobile": true,
          "raw": "components/image-choice/mobile-stacked-media.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "choice-group",
        "multi-choice",
        "segmented-control",
        "select"
      ]
    },
    {
      "slug": "key-value-list",
      "title": "Key-value list",
      "tag": "forma-key-value-list",
      "category": "data",
      "behavior": "Native HTML",
      "summary": "Description-list presentation of labelled values that stacks label above value on narrow screens.",
      "docsUrl": "components/key-value-list/",
      "pattern": "patterns/key-value-list.html",
      "minimalHtml": "<forma-key-value-list class=\"forma-component-tag\">\n<dl class=\"forma-key-value-list\">\n  <div><dt>Account</dt><dd>Northwind Logistics</dd></div>\n  <div><dt>Plan</dt><dd>Team, billed annually</dd></div>\n  <div><dt>Renewal</dt><dd><time datetime=\"2027-03-01\">1 March 2027</time></dd></div>\n</dl>\n</forma-key-value-list>",
      "attributes": [
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO date or date-time",
          "default": "—",
          "description": "Machine-readable form of a date value; the visible text stays human-formatted."
        },
        {
          "name": "aria-labelledby",
          "on": "wrapping section",
          "values": "id of a heading",
          "default": "—",
          "description": "Names the section that contains the list when the list has a visible heading."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-key-value-list",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab",
          "action": "Only interactive content inside values (links, buttons) is focusable; the list itself is not."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "record-details",
          "title": "Record details with status and links",
          "mobile": false,
          "raw": "components/key-value-list/record-details.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "long-labels-missing-values",
          "title": "Long labels and missing values",
          "mobile": false,
          "raw": "components/key-value-list/long-labels-missing-values.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-account-summary",
          "title": "Mobile account summary",
          "mobile": true,
          "raw": "components/key-value-list/mobile-account-summary.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "facts",
        "relationship-index",
        "comparison-pairs",
        "data-grid",
        "record-header"
      ]
    },
    {
      "slug": "landmark-region",
      "title": "Landmark region",
      "tag": "forma-landmark-region",
      "category": "layout",
      "behavior": "Native HTML",
      "summary": "Creates a labeled semantic region for orientation and task ownership.",
      "docsUrl": "components/landmark-region/",
      "pattern": "patterns/landmark-region.html",
      "minimalHtml": "<forma-landmark-region class=\"forma-component-tag\">\n<aside class=\"forma-landmark-region\" aria-label=\"Workspace context\">\n  <nav aria-label=\"Primary\"><a href=\"#overview\" aria-current=\"page\">Overview</a><a href=\"#activity\">Activity</a></nav>\n  <p class=\"forma-landmark-region__status\" role=\"status\">System ready</p>\n</aside>\n</forma-landmark-region>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "aside / nav / section",
          "values": "string",
          "default": "—",
          "description": "Accessible name. A section only becomes a region landmark when it is named; name every nav when there is more than one."
        },
        {
          "name": "aria-labelledby",
          "on": "section",
          "values": "id of the band heading",
          "default": "—",
          "description": "Names the region from its visible heading."
        },
        {
          "name": "aria-current",
          "on": "nav link",
          "values": "page",
          "default": "—",
          "description": "Marks the current location in the band's navigation."
        },
        {
          "name": "role",
          "on": "status element",
          "values": "status",
          "default": "—",
          "description": "Makes status text a polite live region, so application updates are announced without moving focus."
        },
        {
          "name": "style",
          "on": ".forma-landmark-region",
          "values": "--forma-landmark-space: <length>",
          "default": "—",
          "description": "Per-instance spacing override."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-landmark-region",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through links and controls in the band in source order."
        },
        {
          "keys": "Screen-reader landmark navigation",
          "action": "Named aside, nav and section elements appear in the landmark list; this is native browser and assistive technology behavior."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "project-context",
          "title": "Project context band",
          "mobile": false,
          "raw": "components/landmark-region/project-context.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "review-status",
          "title": "Review status aside",
          "mobile": false,
          "raw": "components/landmark-region/review-status.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-wrapped-band",
          "title": "Mobile wrapped band",
          "mobile": true,
          "raw": "components/landmark-region/mobile-wrapped-band.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "workspace-shell",
        "navigation-shell",
        "site-header",
        "alert"
      ]
    },
    {
      "slug": "lane-board",
      "title": "Lane board",
      "tag": "forma-lane-board",
      "category": "workflow",
      "behavior": "Application content",
      "summary": "Preserves item-to-lane membership in a bounded board with narrow-screen containment.",
      "docsUrl": "components/lane-board/",
      "pattern": "patterns/lane-board.html",
      "minimalHtml": "<forma-lane-board class=\"forma-component-tag\">\n<section class=\"forma-lane-board\" aria-label=\"Work board\">\n  <section class=\"forma-lane-board__lane\" aria-labelledby=\"lane-ready\">\n    <header class=\"forma-lane-board__header\"><h2 id=\"lane-ready\">Ready</h2><span>2 items</span></header>\n    <ol class=\"forma-lane-board__items\"><li><article class=\"forma-surface\"><h3>Prepare release</h3><p>Owner: Build team</p></article></li></ol>\n  </section>\n  <section class=\"forma-lane-board__lane\" aria-labelledby=\"lane-review\">\n    <header class=\"forma-lane-board__header\"><h2 id=\"lane-review\">Review</h2><span>1 item</span></header>\n    <ol class=\"forma-lane-board__items\"><li><article class=\"forma-surface\"><h3>Verify evidence</h3><p>State: blocked</p></article></li></ol>\n  </section>\n</section>\n</forma-lane-board>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "root section",
          "values": "string",
          "default": "—",
          "description": "Names the board."
        },
        {
          "name": "tabindex",
          "on": "root section",
          "values": "0",
          "default": "—",
          "description": "Makes the horizontally scrolling board focusable so keyboard users can scroll it; Forma draws a focus outline for it."
        },
        {
          "name": "aria-labelledby",
          "on": "lane section",
          "values": "id of the lane heading",
          "default": "—",
          "description": "Names each lane by its heading, which is what makes lane membership announced."
        },
        {
          "name": "data-forma-drop",
          "on": "lane or item",
          "values": "candidate | accepted | rejected",
          "default": "absent",
          "description": "Shared drop presentation written by the application during a move: dashed, solid or dashed-with-fill outline. See [[reorder-states]]."
        },
        {
          "name": "data-forma-motion-weight",
          "on": "root",
          "values": "light | standard | heavy",
          "default": "standard",
          "description": "Presentation-only mass for settling of items the application is moving inside the board."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-lane-board",
          "elements": [
            "forma-lane-board__header",
            "forma-lane-board__items",
            "forma-lane-board__lane"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves to the board, then through links and buttons inside items, lane by lane in source order."
        },
        {
          "keys": "Arrow keys (board focused)",
          "action": "Scroll the board. Native scrolling of a focused overflow region."
        },
        {
          "keys": "Moving items",
          "action": "Not provided. The application must offer buttons or a menu to move items between lanes; drag must never be the only path."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "release-board",
          "title": "Release board with an empty lane",
          "mobile": false,
          "raw": "components/lane-board/release-board.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "move-without-drag",
          "title": "Moving an item without dragging",
          "mobile": false,
          "raw": "components/lane-board/move-without-drag.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-scrolling-lanes",
          "title": "Mobile scrolling lanes",
          "mobile": true,
          "raw": "components/lane-board/mobile-scrolling-lanes.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "work-queue",
        "ranking",
        "reorder-states",
        "diagram"
      ]
    },
    {
      "slug": "marketing-shell",
      "title": "Marketing shell",
      "tag": "forma-marketing-shell",
      "category": "site",
      "behavior": "Site content",
      "summary": "Reusable marketing-site frame: skip link, identity header with wrapping navigation, main content, and footer. Sites own content; the shell owns structure, focus, and responsive behavior.",
      "docsUrl": "components/marketing-shell/",
      "pattern": "patterns/marketing-shell.html",
      "minimalHtml": "<forma-marketing-shell class=\"forma-component-tag\">\n<div class=\"forma-site\" data-forma-layout=\"marketing\">\n  <a class=\"forma-skip-link\" href=\"#shell-main\">Skip to main content</a>\n  <header class=\"forma-site-header\">\n    <div class=\"forma-site-header__inner\">\n      <div class=\"forma-site-header__identity\">\n        <a class=\"forma-site-header__brand\" href=\"#shell-main\"><span class=\"forma-site-header__mark\" aria-hidden=\"true\">EX</span><span class=\"forma-site-header__name\">Example / Product</span></a>\n        <p class=\"forma-site-header__tagline\">Evidence-driven engineering systems</p>\n      </div>\n      <nav class=\"forma-site-nav\" aria-label=\"Primary\">\n        <ul class=\"forma-site-nav__list\">\n          <li><a class=\"forma-site-nav__link\" href=\"#shell-main\" aria-current=\"page\">Overview</a></li>\n          <li><a class=\"forma-site-nav__link\" href=\"#shell-cta\">Documentation</a></li>\n          <li><a class=\"forma-site-nav__link\" data-forma-variant=\"action\" href=\"#shell-cta\">Get started</a></li>\n        </ul>\n      </nav>\n    </div>\n  </header>\n  <main class=\"forma-site__main\" id=\"shell-main\" tabindex=\"-1\">\n    <section class=\"forma-hero\" aria-labelledby=\"shell-title\">\n      <div class=\"forma-hero__content\">\n        <p class=\"forma-eyebrow\">Product overview</p>\n        <h1 class=\"forma-hero__title\" id=\"shell-title\">A clear promise in one sentence</h1>\n        <p class=\"forma-lead\">Sites supply content. The shell supplies structure, rhythm, focus, and responsive behavior.</p>\n        <div class=\"forma-actions\"><a class=\"forma-button\" data-forma-variant=\"primary\" href=\"#shell-cta\">Get started</a><a class=\"forma-button\" href=\"#shell-cta\">Read the documentation</a></div>\n      </div>\n    </section>\n    <section class=\"forma-section\" id=\"shell-cta\" aria-labelledby=\"shell-cta-title\">\n      <div class=\"forma-cta\">\n        <div class=\"forma-cta__text\"><h2 id=\"shell-cta-title\">Start with a pinned Forma release</h2><p>Every site consumes the same versioned presentation layer.</p></div>\n        <div class=\"forma-actions\"><a class=\"forma-button\" data-forma-variant=\"primary\" href=\"#shell-main\">Install</a></div>\n      </div>\n    </section>\n  </main>\n  <footer class=\"forma-site-footer\" data-forma-tone=\"inverse\">\n    <div class=\"forma-site-footer__inner\">\n      <div class=\"forma-site-footer__main\"><div><p class=\"forma-eyebrow\">Example / Product</p><p>One sentence that says what the product is for.</p></div></div>\n      <p class=\"forma-site-footer__note\"><span>&copy; 2026 Example</span><span>Built with Forma</span></p>\n    </div>\n  </footer>\n</div>\n</forma-marketing-shell>",
      "attributes": [
        {
          "name": "tabindex",
          "on": "main.forma-site__main",
          "values": "-1",
          "default": "—",
          "description": "Required on the main region so activating the skip link moves focus into it; -1 keeps it out of the Tab order."
        },
        {
          "name": "id",
          "on": "main.forma-site__main",
          "values": "string",
          "default": "—",
          "description": "Skip-link target. The reference sites use `main-content`."
        },
        {
          "name": "href",
          "on": "a.forma-skip-link",
          "values": "#id of the main region",
          "default": "—",
          "description": "Must point at the main region's id."
        },
        {
          "name": "aria-label",
          "on": "nav.forma-site-nav",
          "values": "string",
          "default": "—",
          "description": "Names the primary navigation landmark (\"Primary\" on a real page)."
        },
        {
          "name": "aria-current",
          "on": "a.forma-site-nav__link",
          "values": "page | true",
          "default": "absent",
          "description": "Marks exactly one navigation link as the current location."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-site",
          "elements": [
            "forma-site__main"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": [
            {
              "name": "--forma-site-backdrop",
              "default": null
            },
            {
              "name": "--forma-site-backdrop-opacity",
              "default": null
            },
            {
              "name": "--forma-site-backdrop-size",
              "default": null
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab (first press)",
          "action": "Focuses the skip link, which becomes visible at the top of the viewport."
        },
        {
          "keys": "Enter on the skip link",
          "action": "Native link activation: scrolls to the main region and moves focus into it; the next Tab continues inside main."
        },
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through header, main and footer links in source order."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "link",
            "name": "Skip to main content",
            "expect": {
              "url": "#shell-main"
            }
          },
          {
            "role": "link",
            "name": "Example / Product",
            "expect": {
              "url": "#shell-main"
            }
          },
          {
            "role": "link",
            "name": "Overview",
            "expect": {
              "url": "#shell-main"
            }
          },
          {
            "role": "link",
            "name": "Documentation",
            "expect": {
              "url": "#shell-cta"
            }
          },
          {
            "role": "link",
            "name": "Get started",
            "within": {
              "role": "navigation",
              "name": "Primary"
            },
            "expect": {
              "url": "#shell-cta"
            }
          },
          {
            "role": "link",
            "name": "Get started",
            "within": {
              "role": "main"
            },
            "expect": {
              "url": "#shell-cta"
            }
          },
          {
            "role": "link",
            "name": "Read the documentation",
            "expect": {
              "url": "#shell-cta"
            }
          },
          {
            "role": "link",
            "name": "Install",
            "expect": {
              "url": "#shell-main"
            }
          }
        ]
      },
      "examples": [
        {
          "id": "product-page",
          "title": "Product page frame",
          "mobile": false,
          "raw": "components/marketing-shell/product-page.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Skip to main content",
                "expect": {
                  "url": "#marketing-shell-product-page-main"
                }
              },
              {
                "role": "link",
                "name": "Harbor / Ordo",
                "expect": {
                  "url": "#marketing-shell-product-page-main"
                }
              },
              {
                "role": "link",
                "name": "Overview",
                "expect": {
                  "url": "#marketing-shell-product-page-main"
                }
              },
              {
                "role": "link",
                "name": "Documentation",
                "expect": {
                  "url": "#marketing-shell-product-page-cta"
                }
              },
              {
                "role": "link",
                "name": "Install",
                "within": {
                  "role": "navigation",
                  "name": "Ordo"
                },
                "expect": {
                  "url": "#marketing-shell-product-page-cta"
                }
              },
              {
                "role": "link",
                "name": "Install",
                "within": {
                  "role": "region",
                  "name": "Make every legal transition explicit"
                },
                "expect": {
                  "url": "#marketing-shell-product-page-cta"
                }
              },
              {
                "role": "link",
                "name": "Read the quick start",
                "expect": {
                  "url": "#marketing-shell-product-page-main"
                }
              },
              {
                "role": "link",
                "name": "Privacy",
                "expect": {
                  "url": "#marketing-shell-product-page-main"
                }
              },
              {
                "role": "link",
                "name": "Source",
                "expect": {
                  "url": "#marketing-shell-product-page-main"
                }
              },
              {
                "role": "link",
                "name": "Release notes",
                "expect": {
                  "url": "#marketing-shell-product-page-main"
                }
              }
            ]
          }
        },
        {
          "id": "single-offer",
          "title": "Single-offer page",
          "mobile": false,
          "raw": "components/marketing-shell/single-offer.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Example Harbor",
                "expect": {
                  "url": "#marketing-shell-single-offer-main"
                }
              },
              {
                "role": "link",
                "name": "Diagnostic",
                "expect": {
                  "url": "#marketing-shell-single-offer-main"
                }
              },
              {
                "role": "link",
                "name": "Book a session",
                "expect": {
                  "url": "#marketing-shell-single-offer-main"
                }
              },
              {
                "role": "link",
                "name": "Book a working session",
                "expect": {
                  "url": "#marketing-shell-single-offer-main"
                }
              }
            ]
          }
        },
        {
          "id": "mobile-frame",
          "title": "Phone-width frame",
          "mobile": true,
          "raw": "components/marketing-shell/mobile-frame.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Skip to main content",
                "expect": {
                  "url": "#marketing-shell-mobile-frame-main"
                }
              },
              {
                "role": "link",
                "name": "Example Harbor",
                "expect": {
                  "url": "#marketing-shell-mobile-frame-main"
                }
              },
              {
                "role": "link",
                "name": "Overview",
                "expect": {
                  "url": "#marketing-shell-mobile-frame-main"
                }
              },
              {
                "role": "link",
                "name": "Research",
                "expect": {
                  "url": "#marketing-shell-mobile-frame-main"
                }
              },
              {
                "role": "link",
                "name": "Products",
                "expect": {
                  "url": "#marketing-shell-mobile-frame-main"
                }
              },
              {
                "role": "link",
                "name": "Get in touch",
                "expect": {
                  "url": "#marketing-shell-mobile-frame-main"
                }
              },
              {
                "role": "link",
                "name": "Book a session",
                "expect": {
                  "url": "#marketing-shell-mobile-frame-main"
                }
              },
              {
                "role": "link",
                "name": "See the work",
                "expect": {
                  "url": "#marketing-shell-mobile-frame-main"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "site-header",
        "site-footer",
        "skip-link",
        "documentation-layout",
        "workspace-shell"
      ]
    },
    {
      "slug": "master-detail",
      "title": "Master/detail workspace",
      "tag": "forma-master-detail",
      "category": "workspaces",
      "behavior": "Application / Limen",
      "summary": "List-and-detail composition that collapses cleanly from multi-pane desktop to mobile navigation.",
      "docsUrl": "components/master-detail/",
      "pattern": "patterns/master-detail.html",
      "minimalHtml": "<forma-master-detail class=\"forma-component-tag\">\n<section class=\"forma-master-detail\" aria-label=\"Record workspace\">\n  <nav class=\"forma-master-detail__master\" aria-label=\"Records\">\n    <a href=\"#record-1\" aria-current=\"page\"><strong>INV-1042</strong><span>Acme Manufacturing</span></a>\n    <a href=\"#record-2\"><strong>INV-1043</strong><span>Northstar Labs</span></a>\n    <a href=\"#record-3\"><strong>INV-1044</strong><span>Atlas Works</span></a>\n  </nav>\n  <article class=\"forma-master-detail__detail\" id=\"record-1\">\n    <span class=\"forma-status-lozenge\" data-state=\"attention\">Overdue</span>\n    <h3>INV-1042</h3>\n    <dl class=\"forma-key-value-list\">\n      <div><dt>Customer</dt><dd>Acme Manufacturing</dd></div>\n      <div><dt>Outstanding</dt><dd>$5,000</dd></div>\n      <div><dt>Due</dt><dd>October 4, 2026</dd></div>\n    </dl>\n  </article>\n</section>\n</forma-master-detail>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "section, nav",
          "values": "string",
          "default": "—",
          "description": "Names the workspace and the record list so the list landmark is distinguishable from site navigation."
        },
        {
          "name": "aria-current",
          "on": "list link",
          "values": "page",
          "default": "absent",
          "description": "Marks the selected record and draws the selected-row cue. Set by the application when the route changes."
        },
        {
          "name": "href",
          "on": "list link",
          "values": "record URL",
          "default": "—",
          "description": "Each record is a real link so it can be opened, bookmarked and restored with browser history."
        },
        {
          "name": "id",
          "on": "detail",
          "values": "string",
          "default": "—",
          "description": "Optional fragment target for the selected record."
        },
        {
          "name": "aria-labelledby",
          "on": "detail",
          "values": "id of the detail heading",
          "default": "—",
          "description": "Names the detail region by its record heading."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-master-detail",
          "elements": [
            "forma-master-detail__detail",
            "forma-master-detail__master"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the record links, then into the detail. Native link behavior."
        },
        {
          "keys": "Enter",
          "action": "Follows the record link. The application loads the record and decides where focus goes."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "nothing-selected",
          "title": "No record selected",
          "mobile": false,
          "raw": "components/master-detail/nothing-selected.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "blocked-record",
          "title": "Blocked record with long names",
          "mobile": false,
          "raw": "components/master-detail/blocked-record.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior",
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile-record-switcher",
          "title": "Mobile record switcher",
          "mobile": true,
          "raw": "components/master-detail/mobile-record-switcher.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "data-grid",
        "work-queue",
        "split-pane",
        "record-header"
      ]
    },
    {
      "slug": "measure",
      "title": "Measure",
      "tag": "forma-measure",
      "category": "layout",
      "behavior": "Native CSS",
      "summary": "Constrains readable line measure without changing semantic structure.",
      "docsUrl": "components/measure/",
      "pattern": "patterns/measure.html",
      "minimalHtml": "<forma-measure class=\"forma-component-tag\">\n<article class=\"forma-measure\">\n  <h2>Readable content measure</h2>\n  <p>Measure constrains line length while allowing the surrounding composition to determine placement and available space.</p>\n</article>\n</forma-measure>",
      "attributes": [
        {
          "name": "style",
          "on": ".forma-measure",
          "values": "--forma-measure: <length>",
          "default": "—",
          "description": "Per-instance line length, for example 45ch for short notes."
        },
        {
          "name": "aria-labelledby",
          "on": "section / article",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the constrained region by its heading."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-measure",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "settings-help",
          "title": "Help text in a wide settings page",
          "mobile": false,
          "raw": "components/measure/settings-help.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "narrow-measure",
          "title": "Short measure for a confirmation note",
          "mobile": false,
          "raw": "components/measure/narrow-measure.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-measure",
          "title": "Mobile reading width",
          "mobile": true,
          "raw": "components/measure/mobile-measure.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "prose",
        "container",
        "stack"
      ]
    },
    {
      "slug": "metric-card",
      "title": "Metric card",
      "tag": "forma-metric-card",
      "category": "data",
      "behavior": "Application content",
      "summary": "A compact labeled value with context and optional action, without inventing metric meaning.",
      "docsUrl": "components/metric-card/",
      "pattern": "patterns/metric-card.html",
      "minimalHtml": "<forma-metric-card class=\"forma-component-tag\">\n<article class=\"forma-metric-card\">\n  <div class=\"forma-metric-card__label\">Outstanding AR</div>\n  <div class=\"forma-metric-card__value\">$42,500</div>\n  <div class=\"forma-metric-card__context\"><span class=\"forma-status-lozenge\" data-state=\"attention\">$12,500 overdue</span></div>\n  <a href=\"#details\">View receivables</a>\n</article>\n</forma-metric-card>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "article.forma-metric-card",
          "values": "id of .forma-metric-card__label",
          "default": "—",
          "description": "Names the card by its label when several cards appear together."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO date-time",
          "default": "—",
          "description": "Machine-readable update time in freshness context."
        },
        {
          "name": "href",
          "on": "a",
          "values": "URL",
          "default": "—",
          "description": "Optional link to the records behind the value."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-metric-card",
          "elements": [
            "forma-metric-card__label",
            "forma-metric-card__value"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab",
          "action": "Reaches the optional link or button in the card. The card itself is not focusable."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "unknown-value",
          "title": "Value not available",
          "mobile": false,
          "raw": "components/metric-card/unknown-value.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "stale-with-freshness",
          "title": "Value with freshness and period",
          "mobile": false,
          "raw": "components/metric-card/stale-with-freshness.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "dashboard-row",
          "title": "Dashboard row with long labels",
          "mobile": false,
          "raw": "components/metric-card/dashboard-row.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-metric-stack",
          "title": "Mobile metric stack",
          "mobile": true,
          "raw": "components/metric-card/mobile-metric-stack.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "metric-value-change",
        "dashboard-grid",
        "freshness",
        "key-value-list",
        "progress-bar"
      ]
    },
    {
      "slug": "metric-value-change",
      "title": "Metric value change",
      "tag": "forma-metric-value-change",
      "category": "data",
      "behavior": "Application state",
      "summary": "A metric whose authoritative value updates immediately; a neutral perceptual tint marks the update without counting through invented numbers or implying direction.",
      "docsUrl": "components/metric-value-change/",
      "pattern": "patterns/metric-value-change.html",
      "minimalHtml": "<forma-metric-value-change class=\"forma-component-tag\">\n<article class=\"forma-metric-card\" aria-labelledby=\"metric-ar-label\">\n  <div class=\"forma-metric-card__label\" id=\"metric-ar-label\">Outstanding AR</div>\n  <!-- The application replaced this element with the new authoritative value\n       and marked it data-forma-value-change; the text is current immediately. -->\n  <div class=\"forma-metric-card__value\" data-forma-value-change>$38,200</div>\n  <div class=\"forma-metric-card__context\"><span class=\"forma-status-lozenge\" data-state=\"attention\">$8,200 overdue</span></div>\n  <p class=\"forma-visually-hidden\" aria-live=\"polite\">Outstanding AR updated to $38,200, down from $42,500.</p>\n  <a href=\"#details\">View receivables</a>\n</article>\n</forma-metric-value-change>",
      "attributes": [
        {
          "name": "data-forma-value-change",
          "on": "the replaced value element",
          "values": "present (no value)",
          "default": "absent",
          "description": "Marks a freshly inserted value element as an update. Add it only to the new element the application inserts, never on first render."
        },
        {
          "name": "aria-live",
          "on": "a visually hidden paragraph",
          "values": "polite",
          "default": "—",
          "description": "Application-owned announcement stating the new value and, where useful, the previous one."
        },
        {
          "name": "aria-labelledby",
          "on": "article.forma-metric-card",
          "values": "id of the label",
          "default": "—",
          "description": "Names the card so the announcement and value are associated with a metric."
        }
      ],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "None",
          "action": "The update is not interactive and does not move focus."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "status-change",
          "title": "Status value changed",
          "mobile": false,
          "raw": "components/metric-value-change/status-change.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "detail-value-update",
          "title": "Updated value in a detail list",
          "mobile": false,
          "raw": "components/metric-value-change/detail-value-update.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-updated-metric",
          "title": "Mobile updated metric",
          "mobile": true,
          "raw": "components/metric-value-change/mobile-updated-metric.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "metric-card",
        "progress-bar",
        "operation-status",
        "freshness"
      ]
    },
    {
      "slug": "mobile-action-bar",
      "title": "Mobile action bar",
      "tag": "forma-mobile-action-bar",
      "category": "actions",
      "behavior": "Application / Limen",
      "summary": "Safe-area-aware mobile action region that keeps one to three critical contextual actions reachable at the bottom of a narrow screen.",
      "docsUrl": "components/mobile-action-bar/",
      "pattern": "patterns/mobile-action-bar.html",
      "minimalHtml": "<forma-mobile-action-bar class=\"forma-component-tag\">\n<nav class=\"forma-mobile-action-bar\" aria-label=\"Record actions\">\n  <button type=\"button\" class=\"forma-mobile-action-bar__secondary\">Cancel</button>\n  <button type=\"button\" class=\"forma-mobile-action-bar__primary\">Save changes</button>\n</nav>\n</forma-mobile-action-bar>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "nav.forma-mobile-action-bar",
          "values": "string",
          "default": "—",
          "description": "Names the region after the task (\"Record actions\"), so it is distinguishable from the site navigation landmark."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button | submit | reset",
          "default": "—",
          "description": "Use submit when the bar is the form's action row, button otherwise."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-mobile-action-bar",
          "elements": [
            "forma-mobile-action-bar__primary"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the bar's buttons in source order. Sticky positioning does not change focus order."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused button (native behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "single-primary",
          "title": "Single submit action",
          "mobile": false,
          "raw": "components/mobile-action-bar/single-primary.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "three-actions",
          "title": "Three actions with long labels",
          "mobile": false,
          "raw": "components/mobile-action-bar/three-actions.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-sticky-form",
          "title": "Sticky under a long form",
          "mobile": true,
          "raw": "components/mobile-action-bar/mobile-sticky-form.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        }
      ],
      "related": [
        "button",
        "command-group",
        "overflow-command-disclosure",
        "flyout"
      ]
    },
    {
      "slug": "mosaic",
      "title": "Mosaic",
      "tag": "forma-mosaic",
      "category": "layout",
      "behavior": "Application content",
      "summary": "Asymmetric editorial composition using explicit spans and deterministic narrow-screen reflow.",
      "docsUrl": "components/mosaic/",
      "pattern": "patterns/mosaic.html",
      "minimalHtml": "<forma-mosaic class=\"forma-component-tag\">\n<section class=\"forma-mosaic\" aria-label=\"Editorial collection\">\n  <article class=\"forma-surface\" data-span=\"2\"><h2>Featured story</h2><p>Visual emphasis through span, without semantic reordering.</p></article>\n  <article class=\"forma-surface\"><h2>Research</h2><p>Supporting item.</p></article>\n  <article class=\"forma-surface\"><h2>Example</h2><p>Supporting item.</p></article>\n  <article class=\"forma-surface\" data-span=\"full\"><h2>Next step</h2><p>Full-width region returns to one column on narrow screens.</p></article>\n</section>\n</forma-mosaic>",
      "attributes": [
        {
          "name": "data-span",
          "on": "direct child of .forma-mosaic",
          "values": "2 | full",
          "default": "absent (one column)",
          "description": "Visual width of an item. Not a data-forma-* hook; it is presentation only."
        },
        {
          "name": "aria-label",
          "on": ".forma-mosaic",
          "values": "string",
          "default": "—",
          "description": "Names the composed section."
        },
        {
          "name": "aria-labelledby",
          "on": "items",
          "values": "id of the item heading",
          "default": "—",
          "description": "Names each article by its heading."
        },
        {
          "name": "style",
          "on": ".forma-mosaic",
          "values": "--forma-mosaic-space: <length>",
          "default": "—",
          "description": "Per-instance gap override."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-mosaic",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": [
            {
              "name": "--forma-mosaic-space",
              "default": "var(--forma-primitive-spacing-4, 1rem)"
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through items in source order; spans never change focus order."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "quarterly-report",
          "title": "Quarterly report overview",
          "mobile": false,
          "raw": "components/mosaic/quarterly-report.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "two-features",
          "title": "Two featured stories",
          "mobile": false,
          "raw": "components/mosaic/two-features.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-single-column",
          "title": "Mobile single column",
          "mobile": true,
          "raw": "components/mosaic/mobile-single-column.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "responsive-grid",
        "grid",
        "card-grid"
      ]
    },
    {
      "slug": "multi-choice",
      "title": "Multi-choice",
      "tag": "forma-multi-choice",
      "category": "selection",
      "behavior": "Native HTML",
      "summary": "Checkbox-backed selection with explicit guidance for minimum, maximum, or exclusive choices.",
      "docsUrl": "components/multi-choice/",
      "pattern": "patterns/multi-choice.html",
      "minimalHtml": "<forma-multi-choice class=\"forma-component-tag\">\n<fieldset class=\"forma-choice-group\" aria-describedby=\"multi-choice-guidance\">\n  <legend class=\"forma-choice-group__legend\">Select exactly two priorities.</legend>\n  <p class=\"forma-selection-guidance\" id=\"multi-choice-guidance\">Choose exactly 2 options. “None of these” cannot be combined with another option.</p>\n\n  <label class=\"forma-choice\">\n    <input type=\"checkbox\" name=\"priorities\" value=\"reliability\">\n    <span class=\"forma-choice__content\"><strong>Reliability</strong></span>\n  </label>\n  <label class=\"forma-choice\">\n    <input type=\"checkbox\" name=\"priorities\" value=\"speed\">\n    <span class=\"forma-choice__content\"><strong>Delivery speed</strong></span>\n  </label>\n  <label class=\"forma-choice\">\n    <input type=\"checkbox\" name=\"priorities\" value=\"cost\">\n    <span class=\"forma-choice__content\"><strong>Cost efficiency</strong></span>\n  </label>\n  <label class=\"forma-choice forma-choice--exclusive\">\n    <input type=\"checkbox\" name=\"priorities\" value=\"none\">\n    <span class=\"forma-choice__content\"><strong>None of these</strong><span>Exclusive option</span></span>\n  </label>\n\n  <p class=\"forma-selection-status\" data-forma-state=\"incomplete\" aria-live=\"polite\">0 of 2 selected</p>\n</fieldset>\n</forma-multi-choice>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "checkbox",
          "default": "—",
          "description": "Required. Each option is a native checkbox; the card draws a square indicator for checkboxes."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Usually shared by all options so the form submits one name with several values."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "\"on\"",
          "description": "Submitted value for each checked option."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Initial selection."
        },
        {
          "name": "disabled",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Used by the application to prevent exceeding a maximum; dims the card."
        },
        {
          "name": "aria-describedby",
          "on": "fieldset",
          "values": "id of .forma-selection-guidance",
          "default": "—",
          "description": "Associates the selection rule with the group so it is announced on entry."
        },
        {
          "name": "aria-live",
          "on": ".forma-selection-status",
          "values": "polite",
          "default": "—",
          "description": "Announces the application's updated count without interrupting."
        },
        {
          "name": "data-forma-state",
          "on": ".forma-selection-status",
          "values": "incomplete | valid (application vocabulary)",
          "default": "—",
          "description": "Records the application's cardinality state for tests and integrations. Forma does not style it; the text carries the meaning."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-selection-guidance",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-selection-status",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through each checkbox in turn; every enabled option is its own tab stop."
        },
        {
          "keys": "Space",
          "action": "Toggles the focused checkbox (native behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "maximum-reached",
          "title": "Maximum reached",
          "mobile": false,
          "raw": "components/multi-choice/maximum-reached.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "exclusive-selected",
          "title": "Exclusive option chosen",
          "mobile": false,
          "raw": "components/multi-choice/exclusive-selected.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-range-rule",
          "title": "Between-two-and-four rule on a phone",
          "mobile": true,
          "raw": "components/multi-choice/mobile-range-rule.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "choice-group",
        "checkbox",
        "hierarchical-multi-choice",
        "image-choice",
        "special-choice"
      ]
    },
    {
      "slug": "navigation-shell",
      "title": "Navigation shell",
      "tag": "forma-navigation-shell",
      "category": "navigation",
      "behavior": "Application / Limen",
      "summary": "Preserves current location and destination identity across persistent and compact navigation modes.",
      "docsUrl": "components/navigation-shell/",
      "pattern": "patterns/navigation-shell.html",
      "minimalHtml": "<forma-navigation-shell class=\"forma-component-tag\">\n<div class=\"forma-navigation-shell\">\n  <details class=\"forma-navigation-shell__compact\">\n    <summary>Navigation</summary>\n    <nav aria-label=\"Primary\"><a href=\"#overview\" aria-current=\"page\">Overview</a><a href=\"#activity\">Activity</a><a href=\"#settings\">Settings</a></nav>\n  </details>\n  <nav class=\"forma-navigation-shell__persistent\" aria-label=\"Primary\"><a href=\"#overview\" aria-current=\"page\">Overview</a><a href=\"#activity\">Activity</a><a href=\"#settings\">Settings</a></nav>\n  <main class=\"forma-navigation-shell__content\" id=\"overview\"><h1>Overview</h1></main>\n</div>\n</forma-navigation-shell>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "both nav elements",
          "values": "the same string",
          "default": "—",
          "description": "Names the navigation landmark. Use the same label on both, because only one is displayed at a time."
        },
        {
          "name": "aria-current",
          "on": "link",
          "values": "page",
          "default": "absent",
          "description": "Marks the current destination. Set it identically in both lists."
        },
        {
          "name": "open",
          "on": "details.forma-navigation-shell__compact",
          "values": "boolean",
          "default": "absent (closed)",
          "description": "Native disclosure state in compact mode. The browser toggles it; the application may close it after navigation."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-navigation-shell",
          "elements": [
            "forma-navigation-shell__compact",
            "forma-navigation-shell__content",
            "forma-navigation-shell__persistent"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the visible navigation links, then into the content."
        },
        {
          "keys": "Enter / Space on summary",
          "action": "Opens or closes the compact disclosure (native details behavior)."
        },
        {
          "keys": "Enter on a link",
          "action": "Follows the link (native)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "project-settings",
          "title": "Project settings area",
          "mobile": false,
          "raw": "components/navigation-shell/project-settings.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "narrow-rail",
          "title": "Narrower navigation column",
          "mobile": false,
          "raw": "components/navigation-shell/narrow-rail.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile-compact-open",
          "title": "Compact navigation on a phone",
          "mobile": true,
          "raw": "components/navigation-shell/mobile-compact-open.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "workspace-shell",
        "sidebar",
        "flyout",
        "skip-link"
      ]
    },
    {
      "slug": "numeric-stepper",
      "title": "Numeric stepper",
      "tag": "forma-numeric-stepper",
      "category": "forms",
      "behavior": "Native HTML",
      "summary": "Bounded numeric entry using the native number input and explicit constraints.",
      "docsUrl": "components/numeric-stepper/",
      "pattern": "patterns/numeric-stepper.html",
      "minimalHtml": "<forma-numeric-stepper class=\"forma-component-tag\">\n<label class=\"forma-numeric-stepper\">\n  <span class=\"forma-numeric-stepper__label\">Target deployments per week</span>\n  <input type=\"number\" name=\"deployments-per-week\" min=\"0\" max=\"50\" step=\"1\" inputmode=\"numeric\" required>\n  <span class=\"forma-field__description\">Enter a whole number from 0 through 50.</span>\n</label>\n</forma-numeric-stepper>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "number",
          "default": "—",
          "description": "Required. Native number entry and stepping."
        },
        {
          "name": "min",
          "on": "input",
          "values": "number",
          "default": "—",
          "description": "Lower bound; stepping stops here and lower typed values are invalid."
        },
        {
          "name": "max",
          "on": "input",
          "values": "number",
          "default": "—",
          "description": "Upper bound."
        },
        {
          "name": "step",
          "on": "input",
          "values": "number | any",
          "default": "1",
          "description": "Increment for ArrowUp/ArrowDown and allowed granularity; off-step values are invalid unless step=any."
        },
        {
          "name": "value",
          "on": "input",
          "values": "number",
          "default": "empty",
          "description": "Initial value."
        },
        {
          "name": "inputmode",
          "on": "input",
          "values": "numeric | decimal",
          "default": "from type",
          "description": "Chooses a digit or decimal keypad on touch devices."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Form field name."
        },
        {
          "name": "required",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Blocks submission while empty."
        },
        {
          "name": "readonly",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Focusable and submitted but not editable or steppable."
        },
        {
          "name": "for",
          "on": "label.forma-numeric-stepper__label",
          "values": "id of the input",
          "default": "—",
          "description": "Use when the root is not the label, so the description can stay out of the accessible name."
        },
        {
          "name": "aria-describedby",
          "on": "input",
          "values": "id list",
          "default": "—",
          "description": "Links the range description and any validation message."
        },
        {
          "name": "aria-invalid",
          "on": "input",
          "values": "true",
          "default": "absent",
          "description": "Set by the application while a validation message is shown."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-numeric-stepper",
          "elements": [
            "forma-numeric-stepper__label"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "ArrowUp / ArrowDown",
          "action": "Increments or decrements by step, clamped to min and max (native)."
        },
        {
          "keys": "Digits, minus, decimal separator",
          "action": "Types the value directly."
        },
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus to and from the input."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "decimal-hours",
          "title": "Hours in half-hour steps",
          "mobile": false,
          "raw": "components/numeric-stepper/decimal-hours.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "out-of-range",
          "title": "Value above the maximum",
          "mobile": false,
          "raw": "components/numeric-stepper/out-of-range.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "fixed-by-contract",
          "title": "Fixed by contract",
          "mobile": false,
          "raw": "components/numeric-stepper/fixed-by-contract.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-quantities",
          "title": "Mobile order quantities",
          "mobile": true,
          "raw": "components/numeric-stepper/mobile-quantities.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "slider",
        "range-entry",
        "text-field",
        "allocation"
      ]
    },
    {
      "slug": "obligation-panel",
      "title": "Obligation panel",
      "tag": "forma-obligation-panel",
      "category": "feedback",
      "behavior": "Application state",
      "summary": "Presents unresolved work, evidence needs and blocking status without making the design system authoritative.",
      "docsUrl": "components/obligation-panel/",
      "pattern": "patterns/obligation-panel.html",
      "minimalHtml": "<forma-obligation-panel class=\"forma-component-tag\">\n<aside class=\"forma-obligation-panel\" aria-labelledby=\"obligation-panel-title\">\n  <header class=\"forma-obligation-panel__header\">\n    <div>\n      <h2 id=\"obligation-panel-title\">3 obligations require attention</h2>\n      <p>These must be resolved before finalization.</p>\n    </div>\n    <span class=\"forma-obligation-panel__count\" aria-hidden=\"true\">3</span>\n  </header>\n\n  <ul class=\"forma-obligation-list\">\n    <li class=\"forma-obligation\" data-forma-severity=\"blocking\">\n      <span class=\"forma-obligation__status\">Blocking</span>\n      <div>\n        <strong>Reconcile unknown storage outcome</strong>\n        <p>Verify whether the report snapshot write completed before retrying.</p>\n      </div>\n      <a href=\"#reconcile-storage\">Review</a>\n    </li>\n    <li class=\"forma-obligation\" data-forma-severity=\"warning\">\n      <span class=\"forma-obligation__status\">Required</span>\n      <div>\n        <strong>Rebuild stale aggregate</strong>\n        <p>The current aggregate does not include every accepted contribution.</p>\n      </div>\n      <a href=\"#aggregate-health\">Review</a>\n    </li>\n    <li class=\"forma-obligation\" data-forma-severity=\"information\">\n      <span class=\"forma-obligation__status\">Evidence</span>\n      <div>\n        <strong>Supply publication evidence</strong>\n        <p>A required validation fixture has not yet been recorded.</p>\n      </div>\n      <a href=\"#publication-evidence\">Review</a>\n    </li>\n  </ul>\n</aside>\n</forma-obligation-panel>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "aside.forma-obligation-panel",
          "values": "id of the panel heading",
          "default": "—",
          "description": "Names the complementary region."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-obligation-panel__count",
          "values": "true",
          "default": "—",
          "description": "Hides the visual count, which duplicates the number in the heading."
        },
        {
          "name": "data-forma-severity",
          "on": "li.forma-obligation",
          "values": "blocking | warning | information",
          "default": "absent (neutral border)",
          "description": "Border treatment matching the written status label. Presentation only; Ordo owns severity."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-obligation-panel",
          "elements": [
            "forma-obligation-panel__count",
            "forma-obligation-panel__header"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-obligation",
          "elements": [
            "forma-obligation__status"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-severity",
              "values": [
                "blocking",
                "information",
                "warning"
              ]
            }
          ],
          "customProperties": []
        },
        {
          "root": "forma-obligation-list",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through each obligation's link or button. The panel itself is not focusable."
        },
        {
          "keys": "Enter",
          "action": "Follows a link or activates a button (Space also activates buttons)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "single-blocking",
          "title": "One blocking obligation",
          "mobile": false,
          "raw": "components/obligation-panel/single-blocking.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "unknown-and-evidence",
          "title": "Unreconciled and evidence obligations",
          "mobile": false,
          "raw": "components/obligation-panel/unknown-and-evidence.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Check archive",
                "expect": {
                  "url": "#obligation-panel-unknown-and-evidence-title"
                }
              },
              {
                "role": "link",
                "name": "Upload",
                "expect": {
                  "url": "#obligation-panel-unknown-and-evidence-title"
                }
              }
            ]
          }
        },
        {
          "id": "mobile-finalization",
          "title": "Mobile finalization",
          "mobile": true,
          "raw": "components/obligation-panel/mobile-finalization.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Go to question",
                "expect": {
                  "url": "#obligation-panel-mobile-finalization-title"
                }
              },
              {
                "role": "link",
                "name": "Add justification",
                "expect": {
                  "url": "#obligation-panel-mobile-finalization-title"
                }
              },
              {
                "role": "link",
                "name": "Upload",
                "expect": {
                  "url": "#obligation-panel-mobile-finalization-title"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "readiness-checklist",
        "work-queue",
        "operation-status",
        "validation-summary"
      ]
    },
    {
      "slug": "operation-status",
      "title": "Operation status",
      "tag": "forma-operation-status",
      "category": "feedback",
      "behavior": "Ordo / application",
      "summary": "Presents pending, confirmed, failed, conflict, unknown, reconciling, stale, blocked, unavailable or insufficient outcomes with explanation and recovery actions.",
      "docsUrl": "components/operation-status/",
      "pattern": "patterns/operation-status.html",
      "minimalHtml": "<forma-operation-status class=\"forma-component-tag\">\n<section class=\"forma-operation-status\" aria-labelledby=\"operation-title\">\n  <div class=\"forma-operation-status__symbol\" aria-hidden=\"true\">↻</div>\n  <div>\n    <span class=\"forma-status-lozenge\" data-state=\"unknown\">Unknown outcome</span>\n    <h3 id=\"operation-title\">We cannot confirm whether the save completed</h3>\n    <p>Reconcile the operation before retrying. Retrying immediately could create a duplicate effect.</p>\n  </div>\n  <div class=\"forma-operation-status__actions\">\n    <button type=\"button\">Reconcile</button>\n    <button type=\"button\">View details</button>\n  </div>\n</section>\n</forma-operation-status>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-operation-status",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the region by its heading."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-operation-status__symbol",
          "values": "true",
          "default": "—",
          "description": "Hides the decorative symbol; the lozenge and heading carry the state."
        },
        {
          "name": "data-state",
          "on": ".forma-status-lozenge",
          "values": "ok | attention | unknown | blocked",
          "default": "—",
          "description": "Glyph for the lozenge that names the outcome. See [[status-lozenge]]."
        },
        {
          "name": "role",
          "on": "an inner status element",
          "values": "status",
          "default": "—",
          "description": "Optional. Use a status region (for example a [[spinner]]) for text that changes while the operation is reconciling."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-operation-status",
          "elements": [
            "forma-operation-status__actions",
            "forma-operation-status__symbol"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the recovery actions. The region is not focusable."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused action (native button behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "payment-failed",
          "title": "Payment declined",
          "mobile": false,
          "raw": "components/operation-status/payment-failed.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "reconciling",
          "title": "Reconciling after a timeout",
          "mobile": false,
          "raw": "components/operation-status/reconciling.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "blocked-by-permission",
          "title": "Blocked by a missing approval",
          "mobile": false,
          "raw": "components/operation-status/blocked-by-permission.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-unknown-save",
          "title": "Mobile unknown outcome",
          "mobile": true,
          "raw": "components/operation-status/mobile-unknown-save.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "alert",
        "conflict-review",
        "state-survivability",
        "recovery-actions"
      ]
    },
    {
      "slug": "ordinal-scale",
      "title": "Ordinal scale",
      "tag": "forma-ordinal-scale",
      "category": "assessment",
      "behavior": "Native HTML",
      "summary": "One radio-backed contract for ordered Likert, agreement, confidence, frequency, and similar scales.",
      "docsUrl": "components/ordinal-scale/",
      "pattern": "patterns/ordinal-scale.html",
      "minimalHtml": "<forma-ordinal-scale class=\"forma-component-tag\">\n<fieldset class=\"forma-ordinal-scale forma-ordinal-scale--5\">\n  <legend class=\"forma-ordinal-scale__legend\">Our deployment process is predictable.</legend>\n\n  <div class=\"forma-ordinal-scale__options\">\n    <label class=\"forma-ordinal-option\">\n      <input type=\"radio\" name=\"deployment-predictability\" value=\"0\" required>\n      <span class=\"forma-ordinal-option__marker\" aria-hidden=\"true\">1</span>\n      <span class=\"forma-ordinal-option__label\">Strongly disagree</span>\n    </label>\n    <label class=\"forma-ordinal-option\">\n      <input type=\"radio\" name=\"deployment-predictability\" value=\"1\">\n      <span class=\"forma-ordinal-option__marker\" aria-hidden=\"true\">2</span>\n      <span class=\"forma-ordinal-option__label\">Disagree</span>\n    </label>\n    <label class=\"forma-ordinal-option\">\n      <input type=\"radio\" name=\"deployment-predictability\" value=\"2\">\n      <span class=\"forma-ordinal-option__marker\" aria-hidden=\"true\">3</span>\n      <span class=\"forma-ordinal-option__label\">Neither agree nor disagree</span>\n    </label>\n    <label class=\"forma-ordinal-option\">\n      <input type=\"radio\" name=\"deployment-predictability\" value=\"3\">\n      <span class=\"forma-ordinal-option__marker\" aria-hidden=\"true\">4</span>\n      <span class=\"forma-ordinal-option__label\">Agree</span>\n    </label>\n    <label class=\"forma-ordinal-option\">\n      <input type=\"radio\" name=\"deployment-predictability\" value=\"4\">\n      <span class=\"forma-ordinal-option__marker\" aria-hidden=\"true\">5</span>\n      <span class=\"forma-ordinal-option__label\">Strongly agree</span>\n    </label>\n  </div>\n\n  <div class=\"forma-special-choices\" aria-label=\"Other responses\">\n    <label class=\"forma-special-choice\">\n      <input type=\"radio\" name=\"deployment-predictability\" value=\"unknown\">\n      <span>Don't know</span>\n    </label>\n    <label class=\"forma-special-choice\">\n      <input type=\"radio\" name=\"deployment-predictability\" value=\"na\">\n      <span>Not applicable</span>\n    </label>\n  </div>\n</fieldset>\n</forma-ordinal-scale>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "radio",
          "default": "—",
          "description": "Required. One radio per scale position."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string shared by all positions",
          "default": "—",
          "description": "Groups the positions (and any special choices) into one exclusive answer. Unique per question."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Submitted value. The application maps values to meaning and scoring; visual order carries none."
        },
        {
          "name": "required",
          "on": "first input",
          "values": "boolean",
          "default": "absent",
          "description": "Native required-group validation."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Restores a saved answer."
        },
        {
          "name": "disabled",
          "on": "input or fieldset",
          "values": "boolean",
          "default": "absent",
          "description": "Removes a position (or the whole scale) from focus and submission and dims it."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-ordinal-option__marker",
          "values": "true",
          "default": "—",
          "description": "The numbered marker is decorative; the label supplies the accessible name."
        },
        {
          "name": "aria-label",
          "on": ".forma-special-choices",
          "values": "string",
          "default": "—",
          "description": "Names the group of non-scale answers, for example Other responses."
        },
        {
          "name": "aria-describedby",
          "on": "fieldset",
          "values": "id list",
          "default": "—",
          "description": "Associates help or error text with the scale."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-ordinal-scale",
          "elements": [
            "forma-ordinal-scale__legend",
            "forma-ordinal-scale__options"
          ],
          "modifiers": [
            "forma-ordinal-scale--10",
            "forma-ordinal-scale--11",
            "forma-ordinal-scale--3",
            "forma-ordinal-scale--4",
            "forma-ordinal-scale--5",
            "forma-ordinal-scale--6",
            "forma-ordinal-scale--7"
          ],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": []
        },
        {
          "root": "forma-ordinal-option",
          "elements": [
            "forma-ordinal-option__label",
            "forma-ordinal-option__marker"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus into the group (checked radio, or the first when unanswered) and out of it."
        },
        {
          "keys": "Arrow keys",
          "action": "Native radio behavior: moves to and selects the previous or next position, including special choices that share the name."
        },
        {
          "keys": "Space",
          "action": "Selects the focused position when none is checked."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "nps-eleven-point",
          "title": "0 to 10 likelihood (NPS-style)",
          "mobile": false,
          "raw": "components/ordinal-scale/nps-eleven-point.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "four-point-maturity",
          "title": "Four-point maturity with a saved answer",
          "mobile": false,
          "raw": "components/ordinal-scale/four-point-maturity.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "frequency-with-disabled-option",
          "title": "Frequency scale with one unavailable position",
          "mobile": false,
          "raw": "components/ordinal-scale/frequency-with-disabled-option.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-seven-point",
          "title": "Seven-point agreement on a phone",
          "mobile": true,
          "raw": "components/ordinal-scale/mobile-seven-point.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "special-choice",
        "semantic-differential",
        "matrix-single",
        "symbol-rating",
        "slider"
      ]
    },
    {
      "slug": "overflow-command-disclosure",
      "title": "Overflow command disclosure",
      "tag": "forma-overflow-command-disclosure",
      "category": "actions",
      "behavior": "Native HTML",
      "summary": "Moves secondary commands into explicit native disclosure without shrinking targets or hiding group meaning.",
      "docsUrl": "components/overflow-command-disclosure/",
      "pattern": "patterns/overflow-command-disclosure.html",
      "minimalHtml": "<forma-overflow-command-disclosure class=\"forma-component-tag\">\n<details class=\"forma-overflow-commands\">\n  <summary>More commands</summary>\n  <div class=\"forma-overflow-commands__panel\" role=\"group\" aria-label=\"More commands\">\n    <button type=\"button\">Duplicate</button><button type=\"button\">Archive</button>\n  </div>\n</details>\n</forma-overflow-command-disclosure>",
      "attributes": [
        {
          "name": "open",
          "on": "details",
          "values": "boolean",
          "default": "absent (closed)",
          "description": "Initial expanded state. The browser toggles it as the user opens and closes the disclosure."
        },
        {
          "name": "role",
          "on": ".forma-overflow-commands__panel",
          "values": "group",
          "default": "—",
          "description": "Exposes the revealed commands as one named group."
        },
        {
          "name": "aria-label",
          "on": ".forma-overflow-commands__panel",
          "values": "string",
          "default": "—",
          "description": "Names the group; normally the same text as the summary so the context is repeated when focus enters the commands."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Commands are ordinary buttons that must not submit an enclosing form."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-overflow-commands",
          "elements": [
            "forma-overflow-commands__panel"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves to the summary, then into the revealed commands when open."
        },
        {
          "keys": "Enter / Space",
          "action": "On the summary, toggles the disclosure (native details behavior). On a command, activates it."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "record-toolbar-overflow",
          "title": "Record toolbar with overflow",
          "mobile": false,
          "raw": "components/overflow-command-disclosure/record-toolbar-overflow.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "open-by-default",
          "title": "Open on arrival with many commands",
          "mobile": false,
          "raw": "components/overflow-command-disclosure/open-by-default.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-overflow",
          "title": "Overflow on a phone",
          "mobile": true,
          "raw": "components/overflow-command-disclosure/mobile-overflow.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "command-group",
        "menu",
        "disclosure",
        "mobile-action-bar"
      ]
    },
    {
      "slug": "overview-disclosure",
      "title": "Overview disclosure",
      "tag": "forma-overview-disclosure",
      "category": "overlays",
      "behavior": "Application content",
      "summary": "Keeps consequential state, scope, uncertainty, and unresolved work visible while secondary evidence uses native disclosure.",
      "docsUrl": "components/overview-disclosure/",
      "pattern": "patterns/overview-disclosure.html",
      "minimalHtml": "<forma-overview-disclosure class=\"forma-component-tag\">\n<section class=\"forma-overview-disclosure\" aria-labelledby=\"overview-title\">\n  <div class=\"forma-overview-disclosure__overview\">\n    <h3 id=\"overview-title\">Verification still required</h3>\n    <p><strong>State:</strong> Evidence is stale. One unresolved item remains before the application can confirm the transition.</p>\n  </div>\n  <details class=\"forma-disclosure\" data-forma-motion-weight=\"light\">\n    <summary>Inspect secondary evidence</summary>\n    <div class=\"forma-disclosure__content\">\n      <p>Last verified 3 hours ago. Source B has not responded to reconciliation.</p>\n    </div>\n  </details>\n</section>\n</forma-overview-disclosure>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-overview-disclosure",
          "values": "id of the overview heading",
          "default": "—",
          "description": "Names the section from its overview heading so it is exposed as a named region."
        },
        {
          "name": "data-forma-motion-weight",
          "on": "details.forma-disclosure",
          "values": "light | standard | heavy",
          "default": "light",
          "description": "Motion weight of each evidence disclosure; see [[disclosure]]."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO 8601",
          "default": "—",
          "description": "Machine-readable freshness when the overview states when something was verified."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-overview-disclosure",
          "elements": [
            "forma-overview-disclosure__overview"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves to each evidence summary (and any links in the overview)."
        },
        {
          "keys": "Enter / Space on a summary",
          "action": "Opens or closes that evidence section (native details)."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "disclosure",
            "name": "Inspect secondary evidence",
            "expect": {
              "open": true
            }
          }
        ]
      },
      "examples": [
        {
          "id": "reconciliation-unknown",
          "title": "Reconciliation with an unknown source",
          "mobile": false,
          "raw": "components/overview-disclosure/reconciliation-unknown.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Per-source results",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "disclosure",
                "name": "Request timestamps",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        },
        {
          "id": "verified-nothing-outstanding",
          "title": "Verified with nothing outstanding",
          "mobile": false,
          "raw": "components/overview-disclosure/verified-nothing-outstanding.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Reviewer decisions",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        },
        {
          "id": "mobile-stale-evidence",
          "title": "Stale evidence on a phone",
          "mobile": true,
          "raw": "components/overview-disclosure/mobile-stale-evidence.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Last known result",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        }
      ],
      "related": [
        "disclosure",
        "verification-frame",
        "state-survivability",
        "status-lozenge",
        "freshness"
      ]
    },
    {
      "slug": "pagination",
      "title": "Pagination",
      "tag": "forma-pagination",
      "category": "navigation",
      "behavior": "Application / Limen",
      "summary": "Page navigation with explicit current-page semantics and compact mobile presentation.",
      "docsUrl": "components/pagination/",
      "pattern": "patterns/pagination.html",
      "minimalHtml": "<forma-pagination class=\"forma-component-tag\">\n<nav class=\"forma-pagination\" aria-label=\"Pagination\">\n  <a class=\"forma-pagination__control\" href=\"?page=2\" rel=\"prev\">Previous</a>\n  <ol class=\"forma-pagination__pages\">\n    <li><a href=\"?page=1\">1</a></li>\n    <li><a href=\"?page=2\">2</a></li>\n    <li><a href=\"?page=3\" aria-current=\"page\">3</a></li>\n    <li><a href=\"?page=4\">4</a></li>\n    <li><a href=\"?page=5\">5</a></li>\n  </ol>\n  <a class=\"forma-pagination__control\" href=\"?page=4\" rel=\"next\">Next</a>\n  <span class=\"forma-pagination__summary\">Page 3 of 12</span>\n</nav>\n</forma-pagination>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "nav",
          "values": "string",
          "default": "—",
          "description": "Names the landmark. Make it specific when a page has more than one pagination nav."
        },
        {
          "name": "aria-current",
          "on": "current page link",
          "values": "page",
          "default": "absent",
          "description": "Marks the current page. Forma draws the inverse surface from it and keeps it visible in compact mode."
        },
        {
          "name": "rel",
          "on": "Previous / Next links",
          "values": "prev | next",
          "default": "—",
          "description": "Declares the relationship between pages for user agents and crawlers."
        },
        {
          "name": "href",
          "on": "links",
          "values": "URL",
          "default": "—",
          "description": "Every page is a real, addressable URL supplied by the application."
        },
        {
          "name": "aria-hidden",
          "on": "ellipsis list item",
          "values": "true",
          "default": "—",
          "description": "Hides decorative gap markers from assistive technology."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-pagination",
          "elements": [
            "forma-pagination__pages",
            "forma-pagination__summary"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through Previous, the page links and Next in source order."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link (native)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "first-page",
          "title": "First page of results",
          "mobile": false,
          "raw": "components/pagination/first-page.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "gapped-range",
          "title": "Long result set with gaps",
          "mobile": false,
          "raw": "components/pagination/gapped-range.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "cursor-unknown-total",
          "title": "Cursor-based paging with an unknown total",
          "mobile": false,
          "raw": "components/pagination/cursor-unknown-total.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile-compact",
          "title": "Compact pagination on a phone",
          "mobile": true,
          "raw": "components/pagination/mobile-compact.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "collection-toolbar",
        "data-grid",
        "wizard"
      ]
    },
    {
      "slug": "pairwise-choice",
      "title": "Pairwise choice",
      "tag": "forma-pairwise-choice",
      "category": "assessment",
      "behavior": "Native HTML",
      "summary": "A focused two-alternative comparison using ordinary choice semantics.",
      "docsUrl": "components/pairwise-choice/",
      "pattern": "patterns/pairwise-choice.html",
      "minimalHtml": "<forma-pairwise-choice class=\"forma-component-tag\">\n<fieldset class=\"forma-pairwise\">\n  <legend class=\"forma-pairwise__legend\">Which is more important for this decision?</legend>\n\n  <div class=\"forma-pairwise__options\">\n    <label class=\"forma-pairwise__option\">\n      <input type=\"radio\" name=\"priority-comparison\" value=\"reliability\" required>\n      <span class=\"forma-pairwise__eyebrow\">Option A</span>\n      <strong>Reliability</strong>\n      <span>Prefer predictable operation and recovery.</span>\n    </label>\n\n    <span class=\"forma-pairwise__versus\" aria-hidden=\"true\">or</span>\n\n    <label class=\"forma-pairwise__option\">\n      <input type=\"radio\" name=\"priority-comparison\" value=\"speed\">\n      <span class=\"forma-pairwise__eyebrow\">Option B</span>\n      <strong>Delivery speed</strong>\n      <span>Prefer faster change and deployment.</span>\n    </label>\n  </div>\n</fieldset>\n</forma-pairwise-choice>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "radio",
          "default": "—",
          "description": "Required. Two radios sharing one name."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Groups the two alternatives. Unique per comparison."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Submitted choice. The application derives preferences; Forma attaches no meaning to A or B."
        },
        {
          "name": "required",
          "on": "first input",
          "values": "boolean",
          "default": "absent",
          "description": "Native required-group validation."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Restores a saved choice."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-pairwise__versus",
          "values": "true",
          "default": "—",
          "description": "Keeps the decorative \"or\" out of the accessibility tree."
        },
        {
          "name": "aria-describedby",
          "on": "fieldset",
          "values": "id list",
          "default": "—",
          "description": "Associates help text such as the comparison position."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-pairwise",
          "elements": [
            "forma-pairwise__eyebrow",
            "forma-pairwise__legend",
            "forma-pairwise__option",
            "forma-pairwise__options",
            "forma-pairwise__versus"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus into and out of the comparison."
        },
        {
          "keys": "Arrow keys",
          "action": "Native radio behavior: switches and selects between the two alternatives (and any shared special answer)."
        },
        {
          "keys": "Space",
          "action": "Selects the focused alternative when none is checked."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "option-b-selected",
          "title": "Second option chosen",
          "mobile": false,
          "raw": "components/pairwise-choice/option-b-selected.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "no-preference",
          "title": "Comparison with a No preference answer",
          "mobile": false,
          "raw": "components/pairwise-choice/no-preference.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-stacked",
          "title": "Stacked comparison on a phone",
          "mobile": true,
          "raw": "components/pairwise-choice/mobile-stacked.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "binary-choice",
        "best-worst",
        "choice-group"
      ]
    },
    {
      "slug": "path-summary",
      "title": "Path summary",
      "tag": "forma-path-summary",
      "category": "data",
      "behavior": "Application content",
      "summary": "Provides an ordered textual representation of a selected relationship or evidence path.",
      "docsUrl": "components/path-summary/",
      "pattern": "patterns/path-summary.html",
      "minimalHtml": "<forma-path-summary class=\"forma-component-tag\">\n<section class=\"forma-path-summary\" aria-labelledby=\"path-title\">\n  <header><h2 id=\"path-title\">Selected path</h2><p>3 relationships</p></header>\n  <ol class=\"forma-path-summary__steps\">\n    <li><a href=\"#chrona\">Chrona</a><span>provides time entries to</span></li>\n    <li><a href=\"#billing\">Billing</a><span>creates billable charges for</span></li>\n    <li aria-current=\"step\"><a href=\"#summa\">Summa</a><span>records the invoice</span></li>\n  </ol>\n</section>\n</forma-path-summary>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-path-summary",
          "values": "id of the header heading",
          "default": "—",
          "description": "Names the path."
        },
        {
          "name": "aria-current",
          "on": "li",
          "values": "step",
          "default": "absent",
          "description": "Optionally marks the selected or final step for assistive technology. Not styled by Forma."
        },
        {
          "name": "href",
          "on": "a",
          "values": "URL or fragment",
          "default": "—",
          "description": "Links each entity to its view or node."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-path-summary",
          "elements": [
            "forma-path-summary__steps"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab",
          "action": "Moves through the entity links in path order."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link (native)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "evidence-path",
          "title": "Evidence path from claim to source",
          "mobile": false,
          "raw": "components/path-summary/evidence-path.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "broken-path",
          "title": "Path with an unknown link",
          "mobile": false,
          "raw": "components/path-summary/broken-path.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile-path",
          "title": "Mobile data flow path",
          "mobile": true,
          "raw": "components/path-summary/mobile-path.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "relationship-index",
        "provenance-trail",
        "evidence-relationship",
        "diagram"
      ]
    },
    {
      "slug": "popover",
      "title": "Popover",
      "tag": "forma-popover",
      "category": "overlays",
      "behavior": "Native HTML",
      "summary": "Top-layer supplemental content built on the Popover API, opened by a native button with no script.",
      "docsUrl": "components/popover/",
      "pattern": "patterns/popover.html",
      "minimalHtml": "<forma-popover class=\"forma-component-tag\">\n<button type=\"button\" popovertarget=\"example-popover\">Show options</button>\n<div class=\"forma-popover\" id=\"example-popover\" popover data-forma-motion-weight=\"light\">\n  <strong>Options</strong>\n  <p>This surface is controlled entirely by declarative HTML.</p>\n  <button type=\"button\" popovertarget=\"example-popover\" popovertargetaction=\"hide\">Close</button>\n</div>\n</forma-popover>",
      "attributes": [
        {
          "name": "popover",
          "on": "the surface",
          "values": "auto (empty) | manual",
          "default": "auto",
          "description": "Makes the element a popover. `auto` light-dismisses and closes other auto popovers; `manual` stays open until explicitly hidden."
        },
        {
          "name": "popovertarget",
          "on": "button",
          "values": "id of the popover",
          "default": "—",
          "description": "Connects an invoker button to the popover."
        },
        {
          "name": "popovertargetaction",
          "on": "button",
          "values": "toggle | show | hide",
          "default": "toggle",
          "description": "What the button does to the popover. Use `hide` on an in-popover Close button."
        },
        {
          "name": "aria-labelledby",
          "on": "the surface",
          "values": "id of a heading inside",
          "default": "—",
          "description": "Names the popover content from its heading."
        },
        {
          "name": "data-forma-motion-weight",
          "on": "the surface",
          "values": "light | standard | heavy",
          "default": "light",
          "description": "Presentation-only perceived mass for entry and exit."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-popover",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Enter / Space on the invoker",
          "action": "Toggles the popover. Focus stays on the invoker."
        },
        {
          "keys": "Tab",
          "action": "From the invoker, moves into the open popover's focusable content next, then back to the page after it (native popover focus order)."
        },
        {
          "keys": "Escape",
          "action": "Closes an auto popover and returns focus to the invoker if focus was inside. Does nothing for `popover=\"manual\"`."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "button",
            "name": "Show options",
            "expect": {
              "open": true
            }
          },
          {
            "role": "button",
            "name": "Close",
            "expect": {
              "open": false
            }
          }
        ]
      },
      "examples": [
        {
          "id": "manual-reference-panel",
          "title": "Keyboard shortcuts panel that stays open",
          "mobile": false,
          "raw": "components/popover/manual-reference-panel.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Keyboard shortcuts",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Close shortcuts",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        },
        {
          "id": "long-change-history",
          "title": "Long change history that scrolls",
          "mobile": false,
          "raw": "components/popover/long-change-history.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Change history (12)",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Close history",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        },
        {
          "id": "mobile-field-help",
          "title": "Field help on a phone",
          "mobile": true,
          "raw": "components/popover/mobile-field-help.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Where do I find my IBAN?",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Close help",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        }
      ],
      "related": [
        "tooltip",
        "menu",
        "dialog",
        "disclosure"
      ]
    },
    {
      "slug": "preview-surface",
      "title": "Preview surface",
      "tag": "forma-preview-surface",
      "category": "workspaces",
      "behavior": "Application content",
      "summary": "A bounded review surface for consequential content before an application commits or publishes it.",
      "docsUrl": "components/preview-surface/",
      "pattern": "patterns/preview-surface.html",
      "minimalHtml": "<forma-preview-surface class=\"forma-component-tag\">\n<section class=\"forma-preview-surface\" aria-labelledby=\"preview-title\">\n  <header class=\"forma-preview-surface__header\">\n    <div><span class=\"forma-status-lozenge\">Preview</span><h3 id=\"preview-title\">Customer invoice</h3></div>\n    <div class=\"forma-preview-surface__controls\"><button type=\"button\">Desktop</button><button type=\"button\">Mobile</button></div>\n  </header>\n  <div class=\"forma-preview-surface__canvas\">\n    <article>\n      <p class=\"forma-record-header__type\">Preview content</p>\n      <h2>Architecture assessment</h2>\n      <p>This surface shows the exact material the user is expected to review before a consequential operation.</p>\n    </article>\n  </div>\n  <footer class=\"forma-preview-surface__footer\"><span>Not yet committed</span><button type=\"button\">Continue review</button></footer>\n</section>\n</forma-preview-surface>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "root section, article",
          "values": "id of the preview title",
          "default": "—",
          "description": "Names the preview region by what is being previewed."
        },
        {
          "name": "aria-pressed",
          "on": "view control buttons",
          "values": "true | false",
          "default": "—",
          "description": "Marks which preview width or mode is active. The application toggles it and changes the preview."
        },
        {
          "name": "role",
          "on": "controls container",
          "values": "group",
          "default": "—",
          "description": "Groups the view controls under one name."
        },
        {
          "name": "aria-label",
          "on": "controls container",
          "values": "string",
          "default": "—",
          "description": "Names the control group, for example \"Preview width\"."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-preview-surface",
          "elements": [
            "forma-preview-surface__canvas",
            "forma-preview-surface__controls",
            "forma-preview-surface__footer",
            "forma-preview-surface__header"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through header controls, any links inside the previewed content, then footer actions."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused button. Native button behavior; the effect is application-owned."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "announcement-before-send",
          "title": "Announcement before sending",
          "mobile": false,
          "raw": "components/preview-surface/announcement-before-send.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "blocked-publish",
          "title": "Preview with a blocking problem",
          "mobile": false,
          "raw": "components/preview-surface/blocked-publish.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-invoice",
          "title": "Mobile invoice preview",
          "mobile": true,
          "raw": "components/preview-surface/mobile-invoice.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "diff-viewer",
        "readiness-checklist",
        "verification-frame",
        "focus-stage"
      ]
    },
    {
      "slug": "priority-stack",
      "title": "Priority stack",
      "tag": "forma-priority-stack",
      "category": "layout",
      "behavior": "Application content",
      "summary": "Responsive composition where priority changes space allocation but never DOM or semantic order.",
      "docsUrl": "components/priority-stack/",
      "pattern": "patterns/priority-stack.html",
      "minimalHtml": "<forma-priority-stack class=\"forma-component-tag\">\n<section class=\"forma-priority-stack\" aria-label=\"Responsive priority composition\">\n  <main class=\"forma-surface\" data-priority=\"primary\"><h2>Primary task</h2><p>Receives more space when available and stacks first when space contracts.</p></main>\n  <aside class=\"forma-surface\"><h2>Supporting context</h2><p>Secondary context remains in semantic order.</p></aside>\n</section>\n</forma-priority-stack>",
      "attributes": [
        {
          "name": "data-priority",
          "on": "direct child",
          "values": "primary",
          "default": "absent",
          "description": "Marks the region that receives extra space (flex-grow 2). Not a data-forma-* hook; presentation only."
        },
        {
          "name": "data-density",
          "on": ".forma-priority-stack",
          "values": "relaxed | standard | compact | analytical",
          "default": "absent (1rem gap)",
          "description": "Contextual density posture. Sets the gap to 1.5rem, 1rem, or 0.5rem (compact and analytical). Not a data-forma-* hook."
        },
        {
          "name": "aria-labelledby",
          "on": "regions",
          "values": "id of the region heading",
          "default": "—",
          "description": "Names each region by its heading."
        },
        {
          "name": "name",
          "on": "checkbox inputs",
          "values": "string",
          "default": "—",
          "description": "Form field names used in the review example."
        },
        {
          "name": "checked",
          "on": "checkbox inputs",
          "values": "boolean",
          "default": "absent",
          "description": "Initial checked state in the review example."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-priority-stack",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-density",
              "values": []
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through regions in source order, regardless of which is primary."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "review-workspace",
          "title": "Review workspace",
          "mobile": false,
          "raw": "components/priority-stack/review-workspace.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "supporting-first",
          "title": "Alerts before the primary task",
          "mobile": false,
          "raw": "components/priority-stack/supporting-first.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-stacked-priority",
          "title": "Mobile stacked priority",
          "mobile": true,
          "raw": "components/priority-stack/mobile-stacked-priority.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "focus-stage",
        "responsive-grid",
        "switcher",
        "stack"
      ]
    },
    {
      "slug": "progress-bar",
      "title": "Progress bar",
      "tag": "forma-progress-bar",
      "category": "feedback",
      "behavior": "Native HTML",
      "summary": "Native determinate progress projected directly from the authoritative value (never overshoots), plus a browser-owned indeterminate variant with explicit text.",
      "docsUrl": "components/progress-bar/",
      "pattern": "patterns/progress-bar.html",
      "minimalHtml": "<forma-progress-bar class=\"forma-component-tag\">\n<div class=\"forma-progress\">\n  <div class=\"forma-progress__header\">\n    <span class=\"forma-progress__label\" id=\"export-progress-label\">Exporting audit log</span>\n    <span class=\"forma-progress__value\">420 of 1,000 records</span>\n  </div>\n  <progress class=\"forma-progress__bar\" value=\"420\" max=\"1000\" aria-labelledby=\"export-progress-label\">42%</progress>\n</div>\n\n<div class=\"forma-progress\">\n  <div class=\"forma-progress__header\">\n    <span class=\"forma-progress__label\" id=\"index-progress-label\">Preparing search index</span>\n    <span class=\"forma-progress__value\">Total not yet known</span>\n  </div>\n  <progress class=\"forma-progress__bar\" aria-labelledby=\"index-progress-label\">Preparing</progress>\n</div>\n</forma-progress-bar>",
      "attributes": [
        {
          "name": "value",
          "on": "progress",
          "values": "number from 0 to max",
          "default": "absent (indeterminate)",
          "description": "The authoritative amount done. Omit it for the indeterminate state."
        },
        {
          "name": "max",
          "on": "progress",
          "values": "positive number",
          "default": "1",
          "description": "The total. Use the real unit (records, bytes) so value and header text agree."
        },
        {
          "name": "aria-labelledby",
          "on": "progress",
          "values": "id of .forma-progress__label",
          "default": "—",
          "description": "Names the progressbar from the visible label."
        },
        {
          "name": "id",
          "on": ".forma-progress__label",
          "values": "unique id",
          "default": "—",
          "description": "Target for aria-labelledby."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-progress",
          "elements": [
            "forma-progress__bar",
            "forma-progress__header",
            "forma-progress__label",
            "forma-progress__value"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "—",
          "action": "Not focusable and not interactive. Screen readers expose it as a progressbar with its value."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "upload-complete",
          "title": "Completed upload",
          "mobile": false,
          "raw": "components/progress-bar/upload-complete.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "import-stages",
          "title": "Multi-stage import",
          "mobile": false,
          "raw": "components/progress-bar/import-stages.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "reconciled-decrease",
          "title": "Progress revised downward",
          "mobile": false,
          "raw": "components/progress-bar/reconciled-decrease.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-backup",
          "title": "Mobile backup",
          "mobile": true,
          "raw": "components/progress-bar/mobile-backup.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "spinner",
        "measure",
        "survey-progress",
        "steps"
      ]
    },
    {
      "slug": "prose",
      "title": "Prose",
      "tag": "forma-prose",
      "category": "site",
      "behavior": "Site content",
      "summary": "Long-form content constrained to the reading measure with underlined links and consistent heading rhythm.",
      "docsUrl": "components/prose/",
      "pattern": "patterns/prose.html",
      "minimalHtml": "<forma-prose class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <article class=\"forma-prose\">\n    <h2>Long-form content stays inside the reading measure</h2>\n    <p>Prose regions keep line length readable, preserve underlined links such as <a href=\"#measure\">the measure contract</a>, and give headings consistent rhythm.</p>\n    <h3>Supporting detail</h3>\n    <ul><li>Lists inherit the same measure.</li><li>Inline <code>code</code> stays legible.</li></ul>\n    <blockquote><p>Quotations use the display face without a second emphasis channel.</p></blockquote>\n  </article>\n</div>\n</forma-prose>",
      "attributes": [],
      "cssHooks": [
        {
          "root": "forma-prose",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through links and focusable code blocks in source order."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "guide-with-code",
          "title": "Guide with a code sample and callout",
          "mobile": false,
          "raw": "components/prose/guide-with-code.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "the release notes",
                "expect": {
                  "url": "#prose-guide-with-code-caption"
                }
              }
            ]
          }
        },
        {
          "id": "release-notes",
          "title": "Release notes with nested lists",
          "mobile": false,
          "raw": "components/prose/release-notes.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-article",
          "title": "Phone article with long inline code",
          "mobile": true,
          "raw": "components/prose/mobile-article.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "the token contract",
                "expect": {
                  "url": "#prose-mobile-article-end"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "callout",
        "code-sample",
        "documentation-layout",
        "measure"
      ]
    },
    {
      "slug": "provenance-trail",
      "title": "Provenance trail",
      "tag": "forma-provenance-trail",
      "category": "data",
      "behavior": "Application content",
      "summary": "Trace displayed output through source, aggregate, analysis, and presentation stages.",
      "docsUrl": "components/provenance-trail/",
      "pattern": "patterns/provenance-trail.html",
      "minimalHtml": "<forma-provenance-trail class=\"forma-component-tag\">\n<section class=\"forma-provenance-trail\" aria-labelledby=\"provenance-title\">\n  <h3 id=\"provenance-title\">How this value was produced</h3>\n  <ol>\n    <li><span class=\"forma-provenance-trail__kind\">Source</span><strong>42 accepted responses</strong><small>Result set hash 9D2…A7</small></li>\n    <li><span class=\"forma-provenance-trail__kind\">Aggregate</span><strong>Governance section</strong><small>Scoring model v3</small></li>\n    <li><span class=\"forma-provenance-trail__kind\">Analysis</span><strong>Weighted mean</strong><small>Analysis expression v1</small></li>\n    <li><span class=\"forma-provenance-trail__kind\">Presentation</span><strong>Metric card</strong><small>Report definition v4</small></li>\n  </ol>\n</section>\n</forma-provenance-trail>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-provenance-trail",
          "values": "id of the h3",
          "default": "—",
          "description": "Names the trail after the value it explains."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-provenance-trail",
          "elements": [
            "forma-provenance-trail__kind"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "None",
          "action": "Static content; links inside stages are reached with Tab as usual."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "stale-source",
          "title": "Trail with a stale source",
          "mobile": false,
          "raw": "components/provenance-trail/stale-source.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "unknown-stage",
          "title": "Derivation with an unknown step",
          "mobile": false,
          "raw": "components/provenance-trail/unknown-stage.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-provenance",
          "title": "Mobile provenance trail",
          "mobile": true,
          "raw": "components/provenance-trail/mobile-provenance.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "security-evidence-chain",
        "metric-card",
        "evidence-relationship",
        "timeline"
      ]
    },
    {
      "slug": "question",
      "title": "Question shell",
      "tag": "forma-question",
      "category": "assessment",
      "behavior": "Application content",
      "summary": "A stable prompt, help, selector, and validation structure for assessment questions.",
      "docsUrl": "components/question/",
      "pattern": "patterns/question.html",
      "minimalHtml": "<forma-question class=\"forma-component-tag\">\n<section class=\"forma-question\" aria-labelledby=\"question-example-title\">\n  <header class=\"forma-question__header\">\n    <span class=\"forma-question__number\" aria-hidden=\"true\">7</span>\n    <div>\n      <h2 class=\"forma-question__prompt\" id=\"question-example-title\">How consistently is this practice followed?</h2>\n      <p class=\"forma-question__help\" id=\"question-example-help\">Choose the response that best describes the current state.</p>\n    </div>\n  </header>\n\n  <div class=\"forma-question__body\" aria-describedby=\"question-example-help\">\n    <!-- Insert a selector pattern here. -->\n  </div>\n</section>\n</forma-question>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-question",
          "values": "id of .forma-question__prompt",
          "default": "—",
          "description": "Names the question region by its prompt. The same id can label the inner fieldset when the prompt replaces a visible legend."
        },
        {
          "name": "aria-describedby",
          "on": "selector fieldset or input",
          "values": "ids of help and error text",
          "default": "—",
          "description": "Associates help and validation text with the control that receives focus. Put it on the fieldset or inputs; a plain div does not reliably expose a description."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-question__number",
          "values": "true",
          "default": "—",
          "description": "Keeps the decorative number badge out of the accessibility tree; the heading already names the question."
        },
        {
          "name": "aria-invalid",
          "on": "inputs",
          "values": "true",
          "default": "absent",
          "description": "Set by the application when the question fails validation so assistive technology reports the error state."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-question",
          "elements": [
            "forma-question__body",
            "forma-question__header",
            "forma-question__help",
            "forma-question__number",
            "forma-question__prompt"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves into and out of the selector inside the body. The shell itself adds no focus stops."
        },
        {
          "keys": "Selector keys",
          "action": "Whatever the embedded selector provides natively, for example arrow keys within a radio group."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "required-with-error",
          "title": "Required question with a validation error",
          "mobile": false,
          "raw": "components/question/required-with-error.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "identifier-and-binary",
          "title": "Long prompt with a binary answer",
          "mobile": false,
          "raw": "components/question/identifier-and-binary.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "free-text-answer",
          "title": "Optional free-text follow-up",
          "mobile": false,
          "raw": "components/question/free-text-answer.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-stacked-scale",
          "title": "Question on a phone",
          "mobile": true,
          "raw": "components/question/mobile-stacked-scale.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "ordinal-scale",
        "validation-message",
        "survey-progress",
        "text-field"
      ]
    },
    {
      "slug": "rail",
      "title": "Rail",
      "tag": "forma-rail",
      "category": "layout",
      "behavior": "Application content",
      "summary": "Supporting rail plus flexible primary region with start/end placement and single-column reflow.",
      "docsUrl": "components/rail/",
      "pattern": "patterns/rail.html",
      "minimalHtml": "<forma-rail class=\"forma-component-tag\">\n<section class=\"forma-rail\" aria-label=\"Content with supporting rail\">\n  <aside class=\"forma-surface\"><h2>Context</h2><p>Supporting navigation, evidence, or controls.</p></aside>\n  <main><h2>Primary work</h2><p>The primary region keeps semantic source order and absorbs remaining space.</p></main>\n</section>\n</forma-rail>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "rail and primary regions",
          "values": "id of the region heading",
          "default": "—",
          "description": "Names aside and article regions by their visible headings."
        },
        {
          "name": "data-side",
          "on": ".forma-rail",
          "values": "end",
          "default": "absent (start)",
          "description": "Moves the rail track to the inline end. Author the primary content first in the source when using it."
        },
        {
          "name": "data-density",
          "on": "nested .forma-stack",
          "values": "compact",
          "default": "—",
          "description": "Used on stacks inside the rail; it does not affect the rail grid."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-rail",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-side",
              "values": [
                "end"
              ]
            }
          ],
          "customProperties": [
            {
              "name": "--forma-rail-content-min",
              "default": "50%"
            },
            {
              "name": "--forma-rail-measure",
              "default": "minmax(12rem, 18rem)"
            },
            {
              "name": "--forma-rail-space",
              "default": "var(--forma-primitive-spacing-5, 1.5rem)"
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Follows source order, which is also the visual order for correctly authored start and end rails."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "case-context-rail",
          "title": "Case record with context rail",
          "mobile": false,
          "raw": "components/rail/case-context-rail.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "end-rail-evidence",
          "title": "End rail with evidence",
          "mobile": false,
          "raw": "components/rail/end-rail-evidence.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-collapsed-rail",
          "title": "Mobile collapsed rail",
          "mobile": true,
          "raw": "components/rail/mobile-collapsed-rail.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "sidebar",
        "focus-stage",
        "switcher",
        "workspace-shell"
      ]
    },
    {
      "slug": "range-entry",
      "title": "Range entry",
      "tag": "forma-range-entry",
      "category": "forms",
      "behavior": "Native HTML",
      "summary": "Direct lower/upper endpoint entry; graphical dual-thumb behavior is an optional application enhancement.",
      "docsUrl": "components/range-entry/",
      "pattern": "patterns/range-entry.html",
      "minimalHtml": "<forma-range-entry class=\"forma-component-tag\">\n<fieldset class=\"forma-range-entry\">\n  <legend class=\"forma-range-entry__legend\">Acceptable response-time range</legend>\n  <p class=\"forma-field__description\">Enter both endpoints. A graphical range slider may be added by Limen as an enhancement, but direct entry remains available.</p>\n\n  <div class=\"forma-range-entry__inputs\">\n    <label>\n      <span>Minimum</span>\n      <input type=\"number\" name=\"response-time-min\" min=\"0\" max=\"5000\" step=\"50\" value=\"500\" inputmode=\"decimal\">\n    </label>\n    <span class=\"forma-range-entry__separator\" aria-hidden=\"true\">to</span>\n    <label>\n      <span>Maximum</span>\n      <input type=\"number\" name=\"response-time-max\" min=\"0\" max=\"5000\" step=\"50\" value=\"1500\" inputmode=\"decimal\">\n    </label>\n  </div>\n\n  <p class=\"forma-range-entry__status\" data-forma-state=\"valid\" aria-live=\"polite\">500 to 1500 milliseconds</p>\n</fieldset>\n</forma-range-entry>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "number",
          "default": "—",
          "description": "Both endpoints are native number inputs."
        },
        {
          "name": "min",
          "on": "input",
          "values": "number",
          "default": "—",
          "description": "Lowest allowed value for each endpoint."
        },
        {
          "name": "max",
          "on": "input",
          "values": "number",
          "default": "—",
          "description": "Highest allowed value for each endpoint. Native constraints do not relate the two inputs to each other."
        },
        {
          "name": "step",
          "on": "input",
          "values": "number",
          "default": "1",
          "description": "Allowed increment."
        },
        {
          "name": "value",
          "on": "input",
          "values": "number",
          "default": "empty",
          "description": "Initial endpoint value."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Separate field names for the lower and upper bound."
        },
        {
          "name": "inputmode",
          "on": "input",
          "values": "numeric | decimal",
          "default": "from type",
          "description": "Keypad hint for touch devices."
        },
        {
          "name": "aria-live",
          "on": ".forma-range-entry__status",
          "values": "polite",
          "default": "—",
          "description": "Announces the application's updated range or error text."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-range-entry__separator",
          "values": "true",
          "default": "—",
          "description": "The visual \"to\" is not read; each input has its own label."
        },
        {
          "name": "aria-invalid",
          "on": "input",
          "values": "true",
          "default": "absent",
          "description": "Set by the application on the endpoint that needs correcting."
        },
        {
          "name": "aria-describedby",
          "on": "input",
          "values": "id of the status",
          "default": "—",
          "description": "Links the error text in the status line to the invalid endpoint."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-range-entry",
          "elements": [
            "forma-range-entry__inputs",
            "forma-range-entry__legend",
            "forma-range-entry__separator",
            "forma-range-entry__status"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between the minimum and maximum inputs."
        },
        {
          "keys": "ArrowUp / ArrowDown",
          "action": "Steps the focused endpoint within its own min and max (native)."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "price-band",
          "title": "Price filter",
          "mobile": false,
          "raw": "components/range-entry/price-band.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "reversed-endpoints",
          "title": "Minimum above maximum",
          "mobile": false,
          "raw": "components/range-entry/reversed-endpoints.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-age-range",
          "title": "Mobile age range",
          "mobile": true,
          "raw": "components/range-entry/mobile-age-range.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "date-range",
        "numeric-stepper",
        "slider"
      ]
    },
    {
      "slug": "ranking",
      "title": "Ranking",
      "tag": "forma-ranking",
      "category": "assessment",
      "behavior": "Application / Limen",
      "summary": "Ordered-choice presentation with non-drag movement controls and visible positions.",
      "docsUrl": "components/ranking/",
      "pattern": "patterns/ranking.html",
      "minimalHtml": "<forma-ranking class=\"forma-component-tag\">\n<fieldset class=\"forma-ranking\">\n  <legend class=\"forma-ranking__legend\">Rank the priorities from most to least important.</legend>\n  <p class=\"forma-field__description\">Use the move controls to change the order. Drag-and-drop may be added only as an optional Limen enhancement.</p>\n\n  <ol class=\"forma-ranking__list\">\n    <li class=\"forma-ranking__item\" data-forma-rank=\"1\">\n      <span class=\"forma-ranking__position\" aria-hidden=\"true\">1</span>\n      <span class=\"forma-ranking__label\">Reliability</span>\n      <span class=\"forma-ranking__actions\">\n        <button type=\"button\" disabled aria-label=\"Move Reliability up\">↑</button>\n        <button type=\"button\" aria-label=\"Move Reliability down\">↓</button>\n      </span>\n    </li>\n    <li class=\"forma-ranking__item\" data-forma-rank=\"2\">\n      <span class=\"forma-ranking__position\" aria-hidden=\"true\">2</span>\n      <span class=\"forma-ranking__label\">Delivery speed</span>\n      <span class=\"forma-ranking__actions\">\n        <button type=\"button\" aria-label=\"Move Delivery speed up\">↑</button>\n        <button type=\"button\" aria-label=\"Move Delivery speed down\">↓</button>\n      </span>\n    </li>\n    <li class=\"forma-ranking__item\" data-forma-rank=\"3\">\n      <span class=\"forma-ranking__position\" aria-hidden=\"true\">3</span>\n      <span class=\"forma-ranking__label\">Cost efficiency</span>\n      <span class=\"forma-ranking__actions\">\n        <button type=\"button\" aria-label=\"Move Cost efficiency up\">↑</button>\n        <button type=\"button\" disabled aria-label=\"Move Cost efficiency down\">↓</button>\n      </span>\n    </li>\n  </ol>\n  <p class=\"forma-ranking__announcement\" aria-live=\"polite\" aria-atomic=\"true\"></p>\n</fieldset>\n</forma-ranking>",
      "attributes": [
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Required so move buttons never submit the surrounding form."
        },
        {
          "name": "aria-label",
          "on": "button",
          "values": "\"Move <item> up\" / \"Move <item> down\"",
          "default": "—",
          "description": "Required. The arrow glyph is not a name; the label states item and direction."
        },
        {
          "name": "disabled",
          "on": "button",
          "values": "boolean",
          "default": "absent",
          "description": "Set by the application on Move up for the first item and Move down for the last."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-ranking__position",
          "values": "true",
          "default": "—",
          "description": "The badge is visual; list semantics and announcements carry position."
        },
        {
          "name": "aria-live",
          "on": ".forma-ranking__announcement",
          "values": "polite",
          "default": "—",
          "description": "Announces the application's movement messages."
        },
        {
          "name": "aria-atomic",
          "on": ".forma-ranking__announcement",
          "values": "true",
          "default": "—",
          "description": "Reads the whole message each time it changes."
        },
        {
          "name": "data-forma-rank",
          "on": ".forma-ranking__item",
          "values": "integer",
          "default": "—",
          "description": "Authoritative position written by the application for its own use. Forma does not style it."
        },
        {
          "name": "aria-describedby",
          "on": "fieldset",
          "values": "id list",
          "default": "—",
          "description": "Associates instructions with the ranking."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-ranking",
          "elements": [
            "forma-ranking__actions",
            "forma-ranking__announcement",
            "forma-ranking__item",
            "forma-ranking__label",
            "forma-ranking__legend",
            "forma-ranking__list",
            "forma-ranking__position"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the enabled move buttons in order; disabled buttons are skipped."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused move button (native button behavior). The application performs the move and should keep focus on the moved item's corresponding button."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "after-keyboard-move",
          "title": "After moving an item up",
          "mobile": false,
          "raw": "components/ranking/after-keyboard-move.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "long-labels-heavy",
          "title": "Long item labels with heavy motion weight",
          "mobile": false,
          "raw": "components/ranking/long-labels-heavy.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-full-width-controls",
          "title": "Ranking on a phone",
          "mobile": true,
          "raw": "components/ranking/mobile-full-width-controls.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "reorder-states",
        "best-worst",
        "allocation"
      ]
    },
    {
      "slug": "readiness-checklist",
      "title": "Readiness checklist",
      "tag": "forma-readiness-checklist",
      "category": "feedback",
      "behavior": "Ordo / application",
      "summary": "Explicit complete, incomplete and blocking prerequisites shown before a consequential transition.",
      "docsUrl": "components/readiness-checklist/",
      "pattern": "patterns/readiness-checklist.html",
      "minimalHtml": "<forma-readiness-checklist class=\"forma-component-tag\">\n<section class=\"forma-readiness-checklist\" aria-labelledby=\"readiness-title\">\n  <header>\n    <span class=\"forma-status-lozenge\" data-state=\"attention\">5 of 7 complete</span>\n    <h3 id=\"readiness-title\">Ready to close September</h3>\n  </header>\n  <ul class=\"forma-readiness-checklist__items\">\n    <li data-state=\"complete\"><span aria-hidden=\"true\">✓</span><span>All invoices posted</span></li>\n    <li data-state=\"complete\"><span aria-hidden=\"true\">✓</span><span>Payments allocated</span></li>\n    <li data-state=\"incomplete\"><span aria-hidden=\"true\">○</span><span>Bank reconciliation</span><button type=\"button\">Review</button></li>\n    <li data-state=\"blocked\"><span aria-hidden=\"true\">!</span><span>CPA adjustment review</span><span>Blocking</span></li>\n  </ul>\n</section>\n</forma-readiness-checklist>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-readiness-checklist",
          "values": "id of the header heading",
          "default": "—",
          "description": "Names the checklist from its heading."
        },
        {
          "name": "data-state",
          "on": "li",
          "values": "complete | incomplete | blocked",
          "default": "—",
          "description": "Item state supplied by the application. `complete` bolds the glyph; `blocked` adds a thick inline-start border. `incomplete` has no special styling."
        },
        {
          "name": "aria-hidden",
          "on": "glyph span",
          "values": "true",
          "default": "—",
          "description": "Hides the ✓ / ○ / ! glyph; state must also be available as text."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-readiness-checklist",
          "elements": [
            "forma-readiness-checklist__items"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through item actions (buttons or links). Items themselves are not focusable."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused action (native behavior; Space applies to buttons only)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "ready-to-publish",
          "title": "All prerequisites met",
          "mobile": false,
          "raw": "components/readiness-checklist/ready-to-publish.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "blocked-submission",
          "title": "Several blocking items",
          "mobile": false,
          "raw": "components/readiness-checklist/blocked-submission.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Add",
                "expect": {
                  "url": "#readiness-checklist-blocked-submission-title"
                }
              }
            ]
          }
        },
        {
          "id": "mobile-month-close",
          "title": "Mobile month-end close",
          "mobile": true,
          "raw": "components/readiness-checklist/mobile-month-close.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "obligation-panel",
        "wizard",
        "state-survivability"
      ]
    },
    {
      "slug": "record-header",
      "title": "Record header",
      "tag": "forma-record-header",
      "category": "workspaces",
      "behavior": "Application content",
      "summary": "Persistent record identity, status, context, breadcrumbs, and legal actions with mobile action collapse.",
      "docsUrl": "components/record-header/",
      "pattern": "patterns/record-header.html",
      "minimalHtml": "<forma-record-header class=\"forma-component-tag\">\n<header class=\"forma-record-header\">\n  <div class=\"forma-record-header__main\">\n    <nav aria-label=\"Breadcrumb\"><a href=\"#home\">Home</a> <span aria-hidden=\"true\">/</span> <a href=\"#records\">Records</a></nav>\n    <div class=\"forma-record-header__title\">\n      <div><span class=\"forma-record-header__type\">Invoice</span><h2>INV-1042</h2></div>\n      <span class=\"forma-status-lozenge\" data-state=\"attention\">Overdue</span>\n    </div>\n    <p>Acme Manufacturing · Due October 4, 2026</p>\n  </div>\n  <div class=\"forma-record-header__actions\">\n    <button type=\"button\">Primary action</button>\n    <details>\n      <summary>More</summary>\n      <div class=\"forma-record-header__menu\"><button type=\"button\">Export</button><button type=\"button\">View history</button></div>\n    </details>\n  </div>\n</header>\n</forma-record-header>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "breadcrumb nav",
          "values": "string",
          "default": "—",
          "description": "Names the breadcrumb navigation, for example \"Breadcrumb\"; keep it unique on the page."
        },
        {
          "name": "aria-hidden",
          "on": "breadcrumb separators",
          "values": "true",
          "default": "—",
          "description": "Hides the decorative slash separators from assistive technology."
        },
        {
          "name": "data-state",
          "on": ".forma-status-lozenge",
          "values": "ok | attention | blocked | unknown",
          "default": "absent",
          "description": "Adds the status symbol to the lozenge; the text remains the status."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-record-header",
          "elements": [
            "forma-record-header__actions",
            "forma-record-header__main",
            "forma-record-header__menu",
            "forma-record-header__title",
            "forma-record-header__type"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through breadcrumb links, actions and the More summary in source order."
        },
        {
          "keys": "Enter / Space on More",
          "action": "Opens or closes the secondary actions. Native details behavior."
        },
        {
          "keys": "Tab inside the panel",
          "action": "Moves through the secondary action buttons. There is no arrow-key navigation or Escape handling; the panel is not a menu widget."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior",
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "blocked-case",
          "title": "Blocked case with restricted actions",
          "mobile": false,
          "raw": "components/record-header/blocked-case.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior",
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "long-identity",
          "title": "Long identifier and several secondary actions",
          "mobile": false,
          "raw": "components/record-header/long-identity.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior",
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile-actions",
          "title": "Mobile record with collapsed actions",
          "mobile": true,
          "raw": "components/record-header/mobile-actions.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior",
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "section-heading",
        "menu",
        "mobile-action-bar",
        "master-detail",
        "status-lozenge"
      ]
    },
    {
      "slug": "recovery-actions",
      "title": "Recovery actions",
      "tag": "forma-recovery-actions",
      "category": "faults",
      "behavior": "Aegis / Ordo / Application",
      "summary": "Native buttons annotated with Aegis capability identity; current authority is revalidated on activation.",
      "docsUrl": "components/recovery-actions/",
      "pattern": "patterns/recovery-actions.html",
      "minimalHtml": "<forma-recovery-actions class=\"forma-component-tag\">\n<div class=\"forma-recovery-actions\" role=\"group\" aria-label=\"Recovery actions\">\n  <button type=\"button\" data-forma-aegis-capability=\"CanRetry\">Try again</button>\n  <button type=\"button\" data-forma-aegis-capability=\"CanReauthenticate\">Sign in</button>\n  <button type=\"button\" data-forma-aegis-capability=\"CanOpenReadOnly\">Open read-only</button>\n</div>\n</forma-recovery-actions>",
      "attributes": [
        {
          "name": "role",
          "on": ".forma-recovery-actions",
          "values": "group",
          "default": "—",
          "description": "Exposes the buttons as one named set."
        },
        {
          "name": "aria-label",
          "on": ".forma-recovery-actions",
          "values": "string",
          "default": "—",
          "description": "Names the group, for example \"Recovery actions\". Include the affected object when several groups share a page."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Required so a recovery button never submits an enclosing form."
        },
        {
          "name": "data-forma-aegis-capability",
          "on": "button",
          "values": "CanRetry | CanReauthenticate | CanReload | CanQuarantine | CanReprocess | CanOpenReadOnly | CanRestoreSink",
          "default": "—",
          "description": "The exact Aegis capability case name. Intent only, never authorization: the application revalidates the capability and domain state on every activation."
        },
        {
          "name": "lang",
          "on": ".forma-recovery-actions or button",
          "values": "BCP 47 tag",
          "default": "inherited",
          "description": "Set when labels are in a different language from the page so they are pronounced correctly."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-recovery-actions",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between recovery buttons in source order."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused button (native button behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "localized-labels",
          "title": "Localized labels",
          "mobile": false,
          "raw": "components/recovery-actions/localized-labels.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "import-recovery",
          "title": "Recovery for a failed import",
          "mobile": false,
          "raw": "components/recovery-actions/import-recovery.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-stacked",
          "title": "Stacked actions on a phone",
          "mobile": true,
          "raw": "components/recovery-actions/mobile-stacked.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "button",
        "command-group",
        "fault",
        "fault-blocking"
      ]
    },
    {
      "slug": "relationship-index",
      "title": "Relationship index",
      "tag": "forma-relationship-index",
      "category": "data",
      "behavior": "Application content",
      "summary": "Provides a semantic non-spatial index of entity relationships and their direction.",
      "docsUrl": "components/relationship-index/",
      "pattern": "patterns/relationship-index.html",
      "minimalHtml": "<forma-relationship-index class=\"forma-component-tag\">\n<section class=\"forma-relationship-index\" aria-labelledby=\"relationships-title\">\n  <header><h2 id=\"relationships-title\">Relationships</h2><p>Selected entity: Billing</p></header>\n  <dl class=\"forma-relationship-index__list\">\n    <div><dt>Depends on</dt><dd><a href=\"#chrona\">Chrona</a></dd></div>\n    <div><dt>Publishes to</dt><dd><a href=\"#summa\">Summa</a></dd></div>\n    <div><dt>Owned by</dt><dd><a href=\"#finance\">Finance domain</a></dd></div>\n  </dl>\n</section>\n</forma-relationship-index>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-relationship-index",
          "values": "id of the header heading",
          "default": "—",
          "description": "Names the index, ideally including the selected entity."
        },
        {
          "name": "href",
          "on": "a",
          "values": "URL or fragment",
          "default": "—",
          "description": "Each related entity links to its own view or to its node."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-relationship-index",
          "elements": [
            "forma-relationship-index__list"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab",
          "action": "Moves through the links to related entities."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link (native)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "incoming-and-outgoing",
          "title": "Incoming and outgoing relationships",
          "mobile": false,
          "raw": "components/relationship-index/incoming-and-outgoing.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "diagram-equivalent",
          "title": "Text equivalent of a diagram selection",
          "mobile": false,
          "raw": "components/relationship-index/diagram-equivalent.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile-relationships",
          "title": "Mobile relationship index",
          "mobile": true,
          "raw": "components/relationship-index/mobile-relationships.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "path-summary",
        "diagram",
        "key-value-list",
        "hierarchy-tree"
      ]
    },
    {
      "slug": "reorder-states",
      "title": "Reorder states",
      "tag": "forma-reorder-states",
      "category": "data",
      "behavior": "Application / Limen",
      "summary": "Presentation hooks for dragging, displaced siblings, drop candidates, accepted/rejected drops and post-release settling.",
      "docsUrl": "components/reorder-states/",
      "pattern": "patterns/reorder-states.html",
      "minimalHtml": "<forma-reorder-states class=\"forma-component-tag\">\n<fieldset class=\"forma-ranking\">\n  <legend class=\"forma-ranking__legend\">Reorder presentation states</legend>\n  <p class=\"forma-field__description\">Static illustration of the hooks an application sets while reordering. The move buttons remain the non-drag path.</p>\n  <ol class=\"forma-ranking__list\">\n    <li class=\"forma-ranking__item\" data-forma-rank=\"1\" data-forma-manipulation=\"dragging\" style=\"--forma-drag-y: 0.75rem\">\n      <span class=\"forma-ranking__position\" aria-hidden=\"true\">1</span>\n      <span class=\"forma-ranking__label\">Reliability (dragging: tracks the pointer directly)</span>\n      <span class=\"forma-ranking__actions\">\n        <button type=\"button\" disabled aria-label=\"Move Reliability up\">↑</button>\n        <button type=\"button\" aria-label=\"Move Reliability down\">↓</button>\n      </span>\n    </li>\n    <li class=\"forma-ranking__item\" data-forma-rank=\"2\" data-forma-drop=\"candidate\" data-forma-manipulation=\"displaced\">\n      <span class=\"forma-ranking__position\" aria-hidden=\"true\">2</span>\n      <span class=\"forma-ranking__label\">Delivery speed (drop candidate)</span>\n      <span class=\"forma-ranking__actions\">\n        <button type=\"button\" aria-label=\"Move Delivery speed up\">↑</button>\n        <button type=\"button\" aria-label=\"Move Delivery speed down\">↓</button>\n      </span>\n    </li>\n    <li class=\"forma-ranking__item\" data-forma-rank=\"3\" data-forma-drop=\"rejected\" data-forma-manipulation=\"settling\">\n      <span class=\"forma-ranking__position\" aria-hidden=\"true\">3</span>\n      <span class=\"forma-ranking__label\">Cost efficiency (rejected: settles back)</span>\n      <span class=\"forma-ranking__actions\">\n        <button type=\"button\" aria-label=\"Move Cost efficiency up\">↑</button>\n        <button type=\"button\" disabled aria-label=\"Move Cost efficiency down\">↓</button>\n      </span>\n    </li>\n  </ol>\n  <p class=\"forma-ranking__announcement\" aria-live=\"polite\" aria-atomic=\"true\">Cost efficiency cannot move above Delivery speed. Order unchanged.</p>\n</fieldset>\n</forma-reorder-states>",
      "attributes": [
        {
          "name": "data-forma-manipulation",
          "on": "the moving or affected item",
          "values": "dragging | resizing | displaced | settling",
          "default": "absent",
          "description": "Motion phase written by the application. `dragging`/`resizing` track directly; `displaced`/`settling` return with damped settling. Remove it when the item is at rest."
        },
        {
          "name": "data-forma-drop",
          "on": "a drop target or dropped item",
          "values": "candidate | accepted | rejected",
          "default": "absent",
          "description": "Drop presentation written by the application once it knows the target and the result. Remove it when the interaction ends."
        },
        {
          "name": "style",
          "on": "the moving item",
          "values": "--forma-drag-x / --forma-drag-y lengths",
          "default": "0px",
          "description": "Application-written live offset of the item from its authoritative position. Reset to 0 on release so the item settles home."
        },
        {
          "name": "data-forma-motion-weight",
          "on": ".forma-ranking or another motion scope",
          "values": "light | standard | heavy",
          "default": "standard",
          "description": "Perceived mass for settling within the scope. Presentation only; never encodes importance."
        },
        {
          "name": "data-forma-rank",
          "on": ".forma-ranking__item",
          "values": "integer",
          "default": "—",
          "description": "Current position, maintained by the application as items move."
        },
        {
          "name": "disabled",
          "on": "move button",
          "values": "boolean",
          "default": "absent",
          "description": "Disables a move that is not possible (first item up, last item down)."
        },
        {
          "name": "aria-live",
          "on": ".forma-ranking__announcement",
          "values": "polite",
          "default": "—",
          "description": "Application-written text reporting each move, rejection or cancellation."
        },
        {
          "name": "aria-atomic",
          "on": ".forma-ranking__announcement",
          "values": "true",
          "default": "—",
          "description": "Announces the whole message on each change."
        }
      ],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between the native move buttons of each item."
        },
        {
          "keys": "Enter / Space on a move button",
          "action": "Activates the button; the application moves the item, writes the settling hooks and announces the result."
        },
        {
          "keys": "Escape during a drag",
          "action": "Not native: if the application supports keyboard-initiated drags, it must implement cancel and restore the authoritative order."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "accepted-drop",
          "title": "Accepted drop settling into place",
          "mobile": false,
          "raw": "components/reorder-states/accepted-drop.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "keyboard-move-light",
          "title": "Keyboard move with a light motion weight",
          "mobile": false,
          "raw": "components/reorder-states/keyboard-move-light.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-drag-in-progress",
          "title": "Mobile drag in progress",
          "mobile": true,
          "raw": "components/reorder-states/mobile-drag-in-progress.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "ranking",
        "lane-board",
        "resizable-split-pane",
        "allocation"
      ]
    },
    {
      "slug": "resizable-split-pane",
      "title": "Resizable split pane",
      "tag": "forma-resizable-split-pane",
      "category": "workspaces",
      "behavior": "Application / Limen",
      "summary": "Split pane whose application-supplied size tracks drag or keys directly, settles without overshoot, and is clamped to legal bounds in CSS.",
      "docsUrl": "components/resizable-split-pane/",
      "pattern": "patterns/resizable-split-pane.html",
      "minimalHtml": "<forma-resizable-split-pane class=\"forma-component-tag\">\n<section class=\"forma-split-pane\" data-forma-resizable aria-label=\"Inspector workspace\" style=\"--forma-split-size: 62%\">\n  <div class=\"forma-split-pane__primary\" id=\"resizable-primary\">\n    <h2>Working surface</h2>\n    <p>The application owns the primary size and writes it to <code>--forma-split-size</code>; CSS clamps it to the legal bounds.</p>\n  </div>\n  <div class=\"forma-split-pane__separator\" role=\"separator\" tabindex=\"0\" aria-orientation=\"vertical\" aria-controls=\"resizable-primary\" aria-label=\"Resize working surface\" aria-valuemin=\"30\" aria-valuemax=\"80\" aria-valuenow=\"62\"></div>\n  <aside class=\"forma-split-pane__secondary\" aria-label=\"Inspector\">\n    <h3>Inspector</h3>\n    <p>Pointer drag and Arrow keys are Limen/application behavior. Both write the same size, so they end in the same state.</p>\n  </aside>\n</section>\n</forma-resizable-split-pane>",
      "attributes": [
        {
          "name": "data-forma-resizable",
          "on": "root .forma-split-pane",
          "values": "boolean",
          "default": "absent",
          "description": "Required. Switches the split to the three-track resizable layout."
        },
        {
          "name": "style",
          "on": "root",
          "values": "--forma-split-size (and optional --forma-split-min, --forma-split-max)",
          "default": "--forma-split-size: 60%",
          "description": "The application writes the authoritative primary size here, usually restored from saved preferences."
        },
        {
          "name": "role",
          "on": "separator",
          "values": "separator",
          "default": "—",
          "description": "Required. A focusable separator is announced as a window splitter with a value."
        },
        {
          "name": "tabindex",
          "on": "separator",
          "values": "0",
          "default": "—",
          "description": "Makes the separator focusable so keyboard users can resize."
        },
        {
          "name": "aria-orientation",
          "on": "separator",
          "values": "vertical",
          "default": "horizontal for separator",
          "description": "The separator line runs vertically between side-by-side panes."
        },
        {
          "name": "aria-controls",
          "on": "separator",
          "values": "id of the primary region",
          "default": "—",
          "description": "Identifies the region whose size the separator changes."
        },
        {
          "name": "aria-label",
          "on": "separator",
          "values": "string",
          "default": "—",
          "description": "Names what is being resized, for example \"Resize working surface\"."
        },
        {
          "name": "aria-valuenow",
          "on": "separator",
          "values": "number",
          "default": "—",
          "description": "Current primary size in the application's unit (usually percent). The application must update it together with `--forma-split-size`."
        },
        {
          "name": "aria-valuemin",
          "on": "separator",
          "values": "number",
          "default": "—",
          "description": "Smallest legal size. Keep it consistent with `--forma-split-min`."
        },
        {
          "name": "aria-valuemax",
          "on": "separator",
          "values": "number",
          "default": "—",
          "description": "Largest legal size. Keep it consistent with `--forma-split-max`."
        },
        {
          "name": "aria-valuetext",
          "on": "separator",
          "values": "string",
          "default": "—",
          "description": "Optional human wording such as \"Collapsed\" when a number alone is unclear."
        },
        {
          "name": "data-forma-manipulation",
          "on": "root",
          "values": "resizing",
          "default": "absent",
          "description": "Set by the application only while a drag is in progress; removed on release so the pane settles."
        },
        {
          "name": "data-forma-collapsed",
          "on": "root",
          "values": "boolean",
          "default": "absent",
          "description": "Set by the application to pin the primary region to its minimum."
        },
        {
          "name": "data-forma-motion-weight",
          "on": "root",
          "values": "light | standard | heavy",
          "default": "standard",
          "description": "Presentation-only settle weight."
        }
      ],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus to and from the separator. This is the only native behavior; the separator is a focusable div."
        },
        {
          "keys": "Left / Right Arrow",
          "action": "Application or Limen must implement: step the size down or up and write `--forma-split-size` and aria-valuenow."
        },
        {
          "keys": "Home / End",
          "action": "Application or Limen should implement: jump to the minimum or maximum legal size."
        },
        {
          "keys": "Enter",
          "action": "Application or Limen may implement: toggle `data-forma-collapsed` and restore the previous size."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "collapsed-editor",
          "title": "Collapsed to the minimum",
          "mobile": false,
          "raw": "components/resizable-split-pane/collapsed-editor.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "active-drag",
          "title": "Mid-drag with custom bounds",
          "mobile": false,
          "raw": "components/resizable-split-pane/active-drag.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "heavy-settle",
          "title": "Heavy settling weight",
          "mobile": false,
          "raw": "components/resizable-split-pane/heavy-settle.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-stacked",
          "title": "Mobile without a separator",
          "mobile": true,
          "raw": "components/resizable-split-pane/mobile-stacked.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "split-pane",
        "reorder-states",
        "workspace-shell",
        "flyout"
      ]
    },
    {
      "slug": "responsive-grid",
      "title": "Responsive grid",
      "tag": "forma-responsive-grid",
      "category": "layout",
      "behavior": "Application content",
      "summary": "Auto-fitting composition grid with optional visual spans that collapse without changing source order.",
      "docsUrl": "components/responsive-grid/",
      "pattern": "patterns/responsive-grid.html",
      "minimalHtml": "<forma-responsive-grid class=\"forma-component-tag\">\n<section class=\"forma-responsive-grid\" aria-label=\"Responsive summary grid\">\n  <article class=\"forma-surface forma-span-2\"><h2>Priority summary</h2><p>A priority region may span columns without changing source order.</p></article>\n  <article class=\"forma-surface\"><h2>Evidence</h2><p>Supporting information.</p></article>\n  <article class=\"forma-surface\"><h2>Actions</h2><p>Related actions remain reachable.</p></article>\n</section>\n</forma-responsive-grid>",
      "attributes": [
        {
          "name": "data-density",
          "on": ".forma-responsive-grid",
          "values": "relaxed | standard | compact | analytical",
          "default": "absent (1rem gap)",
          "description": "Contextual density posture. Sets the gap to 1.5rem, 1rem, or 0.5rem (compact and analytical). Not a data-forma-* hook."
        },
        {
          "name": "aria-label",
          "on": ".forma-responsive-grid",
          "values": "string",
          "default": "—",
          "description": "Names the composed region when the grid element is a section."
        },
        {
          "name": "aria-labelledby",
          "on": "grid items",
          "values": "id of the item heading",
          "default": "—",
          "description": "Names each article by its visible heading."
        },
        {
          "name": "style",
          "on": ".forma-responsive-grid",
          "values": "--forma-responsive-grid-min / --forma-responsive-grid-space",
          "default": "—",
          "description": "Per-instance override of the minimum track or gap."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-responsive-grid",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-density",
              "values": []
            }
          ],
          "customProperties": [
            {
              "name": "--forma-responsive-grid-min",
              "default": "16rem"
            },
            {
              "name": "--forma-responsive-grid-space",
              "default": "var(--forma-primitive-spacing-4, 1rem)"
            }
          ]
        },
        {
          "root": "forma-span-2",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-span-full",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through focusable content in source order. Spans never change focus order."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "operations-overview",
          "title": "Operations overview",
          "mobile": false,
          "raw": "components/responsive-grid/operations-overview.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "compact-wide-tracks",
          "title": "Compact report tiles",
          "mobile": false,
          "raw": "components/responsive-grid/compact-wide-tracks.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-collapsed-span",
          "title": "Mobile collapsed span",
          "mobile": true,
          "raw": "components/responsive-grid/mobile-collapsed-span.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "grid",
        "mosaic",
        "priority-stack",
        "dashboard-grid"
      ]
    },
    {
      "slug": "rule-builder",
      "title": "Rule builder",
      "tag": "forma-rule-builder",
      "category": "forms",
      "behavior": "Application / Limen",
      "summary": "Field/operator/value clauses for typed rule editing while the application owns expression semantics.",
      "docsUrl": "components/rule-builder/",
      "pattern": "patterns/rule-builder.html",
      "minimalHtml": "<forma-rule-builder class=\"forma-component-tag\">\n<section class=\"forma-rule-builder\" aria-labelledby=\"rule-builder-title\">\n  <header class=\"forma-rule-builder__header\">\n    <div>\n      <h2 id=\"rule-builder-title\">Applicability rule</h2>\n      <p>Define when this section is shown.</p>\n    </div>\n    <button type=\"button\">Add condition</button>\n  </header>\n\n  <div class=\"forma-rule-group\" data-forma-operator=\"and\">\n    <div class=\"forma-rule-group__operator\" aria-label=\"All conditions must be true\">AND</div>\n\n    <div class=\"forma-rule-clause\">\n      <label>\n        <span>Field</span>\n        <select>\n          <option>Answer: Q1</option>\n        </select>\n      </label>\n      <label>\n        <span>Operator</span>\n        <select>\n          <option>is equal to</option>\n        </select>\n      </label>\n      <label>\n        <span>Value</span>\n        <select>\n          <option>Yes</option>\n        </select>\n      </label>\n      <button type=\"button\" aria-label=\"Remove condition\">Remove</button>\n    </div>\n  </div>\n\n  <p class=\"forma-rule-builder__summary\"><strong>Meaning:</strong> Show this section when Answer(Q1) = Yes.</p>\n</section>\n</forma-rule-builder>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-rule-builder",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the rule builder region with its visible heading."
        },
        {
          "name": "data-forma-operator",
          "on": ".forma-rule-group",
          "values": "and | or",
          "default": "—",
          "description": "Application-owned record of the group's logic, used by the pattern. Forma does not style it; the operator badge text is what users see."
        },
        {
          "name": "role",
          "on": ".forma-rule-group",
          "values": "group",
          "default": "—",
          "description": "Exposes the group and its accessible name to assistive technology."
        },
        {
          "name": "aria-label",
          "on": ".forma-rule-group / remove button",
          "values": "string",
          "default": "—",
          "description": "Names each group by its logic and each Remove button by its clause; keep the visible word Remove in the name."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-rule-group__operator",
          "values": "true",
          "default": "—",
          "description": "Hides the visual badge when the group's aria-label already states the logic."
        },
        {
          "name": "aria-invalid",
          "on": "clause control",
          "values": "true",
          "default": "absent",
          "description": "Set by the application on an incomplete or invalid clause control."
        },
        {
          "name": "aria-describedby",
          "on": "clause control",
          "values": "id of the validation message",
          "default": "—",
          "description": "Links the clause error to the control."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-rule-builder",
          "elements": [
            "forma-rule-builder__header",
            "forma-rule-builder__summary"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-rule-clause",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-rule-group",
          "elements": [
            "forma-rule-group__operator"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the header action, each clause's controls and Remove buttons in source order."
        },
        {
          "keys": "Native control keys",
          "action": "Selects and inputs keep their native keyboard behavior."
        },
        {
          "keys": "Application",
          "action": "After Add or Remove, the application must move focus to the new clause's first control or to a sensible neighbor; Forma provides no focus management."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "nested-any-group",
          "title": "Routing rule with a nested OR group",
          "mobile": false,
          "raw": "components/rule-builder/nested-any-group.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "incomplete-clause",
          "title": "Incomplete condition",
          "mobile": false,
          "raw": "components/rule-builder/incomplete-clause.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-audience-rule",
          "title": "Mobile audience rule",
          "mobile": true,
          "raw": "components/rule-builder/mobile-audience-rule.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "collection-toolbar",
        "active-filter-summary",
        "select",
        "validation-message"
      ]
    },
    {
      "slug": "scope-trail",
      "title": "Scope trail",
      "tag": "forma-scope-trail",
      "category": "navigation",
      "behavior": "Application content",
      "summary": "Keeps parent and current scope explicit as users move through nested or scaled representations.",
      "docsUrl": "components/scope-trail/",
      "pattern": "patterns/scope-trail.html",
      "minimalHtml": "<forma-scope-trail class=\"forma-component-tag\">\n<nav class=\"forma-scope-trail\" aria-label=\"Current scope\"><ol><li><a href=\"#system\">System</a></li><li><a href=\"#billing\">Billing</a></li><li aria-current=\"page\">Invoice 1042</li></ol></nav>\n</forma-scope-trail>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "nav",
          "values": "string",
          "default": "—",
          "description": "Names the landmark, for example Current scope. Use a distinct label if a page has several trails."
        },
        {
          "name": "aria-current",
          "on": "last li",
          "values": "page",
          "default": "absent",
          "description": "Marks the current scope. Put it on the plain-text item, not on a link to the same page."
        },
        {
          "name": "href",
          "on": "ancestor links",
          "values": "URL",
          "default": "—",
          "description": "Real URLs for each ancestor scope, supplied by the application."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-scope-trail",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the ancestor links; the current scope is text and is not focusable."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link (native)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "deep-record",
          "title": "Deeply nested record with long names",
          "mobile": false,
          "raw": "components/scope-trail/deep-record.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "zoomed-diagram",
          "title": "Scope of a zoomed diagram",
          "mobile": false,
          "raw": "components/scope-trail/zoomed-diagram.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile-wrapping-trail",
          "title": "Scope trail on a phone",
          "mobile": true,
          "raw": "components/scope-trail/mobile-wrapping-trail.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "hierarchy-tree",
        "spatial-canvas",
        "provenance-trail",
        "pagination"
      ]
    },
    {
      "slug": "scroll-progress",
      "title": "Scroll progress",
      "tag": "forma-scroll-progress",
      "category": "feedback",
      "behavior": "Native HTML",
      "summary": "Decorative reading-progress bar driven directly by the scroll timeline: no smoothing or lag, absent without scroll timelines or under reduced motion.",
      "docsUrl": "components/scroll-progress/",
      "pattern": "patterns/scroll-progress.html",
      "minimalHtml": "<forma-scroll-progress class=\"forma-component-tag\">\n<div class=\"forma-scroll-progress\" aria-hidden=\"true\"></div>\n<article class=\"forma-stack\">\n  <h2>Release notes</h2>\n  <p>The reading-progress bar above is a decorative projection of the page's scroll position. It adds no lag, triggers nothing, and is absent where scroll timelines are unsupported or reduced motion is requested.</p>\n  <p>The scrollbar and the headings remain the authoritative way to know where you are in the document.</p>\n</article>\n</forma-scroll-progress>",
      "attributes": [
        {
          "name": "aria-hidden",
          "on": "div.forma-scroll-progress",
          "values": "true",
          "default": "—",
          "description": "Required. The bar is decorative and must not be exposed to assistive technology."
        },
        {
          "name": "dir",
          "on": "an ancestor",
          "values": "rtl | ltr",
          "default": "inherited",
          "description": "In right-to-left contexts the bar fills from the right."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-scroll-progress",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "—",
          "action": "Not focusable. Keyboard scrolling (Space, Page Down, arrow keys) moves the page and the bar follows."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "documentation-article",
          "title": "Documentation article",
          "mobile": false,
          "raw": "components/scroll-progress/documentation-article.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "right-to-left",
          "title": "Right-to-left document",
          "mobile": false,
          "raw": "components/scroll-progress/right-to-left.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-release-notes",
          "title": "Mobile release notes",
          "mobile": true,
          "raw": "components/scroll-progress/mobile-release-notes.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "progress-bar",
        "entry-index",
        "documentation-layout"
      ]
    },
    {
      "slug": "search",
      "title": "Search",
      "tag": "forma-search",
      "category": "forms",
      "behavior": "Application / Limen",
      "summary": "Search entry, clearing, and result-count feedback with asynchronous behavior owned by the application.",
      "docsUrl": "components/search/",
      "pattern": "patterns/search.html",
      "minimalHtml": "<forma-search class=\"forma-component-tag\">\n<form class=\"forma-search\" role=\"search\">\n  <label class=\"forma-search__label\" for=\"search-query\">Search</label>\n  <div class=\"forma-search__control\">\n    <input id=\"search-query\" name=\"q\" type=\"search\" placeholder=\"Search records\" autocomplete=\"off\">\n    <button type=\"button\" class=\"forma-search__clear\">Clear</button>\n  </div>\n  <p class=\"forma-search__status\" role=\"status\">24 results</p>\n</form>\n</forma-search>",
      "attributes": [
        {
          "name": "role",
          "on": "form",
          "values": "search",
          "default": "—",
          "description": "Makes the form a search landmark. Add aria-label when a page has more than one search."
        },
        {
          "name": "aria-label",
          "on": "form",
          "values": "string",
          "default": "—",
          "description": "Names the search landmark (for example \"Customers\") so several searches can be told apart."
        },
        {
          "name": "type",
          "on": "input / button",
          "values": "search on the input; button on Clear",
          "default": "—",
          "description": "type=search gives the search keyboard and native clearing affordances; type=button keeps Clear from submitting the form."
        },
        {
          "name": "for",
          "on": "label.forma-search__label",
          "values": "id of the input",
          "default": "—",
          "description": "Associates the visible label."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Query parameter name on submission."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "empty",
          "description": "The current query when the page renders results for it."
        },
        {
          "name": "autocomplete",
          "on": "input",
          "values": "off",
          "default": "browser heuristic",
          "description": "Stops browser form history from competing with application suggestions."
        },
        {
          "name": "placeholder",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Optional hint about searchable fields; not a label."
        },
        {
          "name": "role",
          "on": ".forma-search__status",
          "values": "status",
          "default": "—",
          "description": "Polite live region so result-count and pending text are announced."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-search",
          "elements": [
            "forma-search__clear",
            "forma-search__control",
            "forma-search__label",
            "forma-search__status"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Enter",
          "action": "Submits the search form (native implicit submission)."
        },
        {
          "keys": "Escape",
          "action": "Clears a type=search input in browsers that support it (native, browser-dependent)."
        },
        {
          "keys": "Tab",
          "action": "Moves from the input to the Clear button."
        },
        {
          "keys": "Space / Enter on Clear",
          "action": "Activates the button; the application must clear the input, update results and return focus to the input."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "no-results",
          "title": "No matching records",
          "mobile": false,
          "raw": "components/search/no-results.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "pending-search",
          "title": "Search in progress",
          "mobile": false,
          "raw": "components/search/pending-search.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-library-search",
          "title": "Mobile document search",
          "mobile": true,
          "raw": "components/search/mobile-library-search.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "collection-toolbar",
        "combobox",
        "command-palette",
        "active-filter-summary"
      ]
    },
    {
      "slug": "section",
      "title": "Section",
      "tag": "forma-section",
      "category": "layout",
      "behavior": "Native CSS",
      "summary": "Vertical page-section spacing primitive; inside the marketing shell it also carries tone and child rhythm.",
      "docsUrl": "components/section/",
      "pattern": "patterns/section.html",
      "minimalHtml": "<forma-section class=\"forma-component-tag\">\n<section class=\"forma-section\" aria-labelledby=\"section-title\">\n  <h2 id=\"section-title\">Recent activity</h2>\n  <p>Sections separate page regions with a consistent block rhythm.</p>\n</section>\n</forma-section>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-section",
          "values": "id of the section heading",
          "default": "—",
          "description": "Names the section so it is exposed as a region landmark. Always label sections."
        },
        {
          "name": "data-forma-tone",
          "on": "section.forma-section",
          "values": "page | surface | elevated | inverse",
          "default": "absent (page)",
          "description": "Marketing surface tone. Non-page tones inside .forma-site add band padding and switch text, link and rule colors."
        },
        {
          "name": "style",
          "on": "section.forma-section",
          "values": "--forma-section-space: <length>",
          "default": "—",
          "description": "Per-instance block padding outside the marketing shell."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-section",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-tone",
              "values": []
            }
          ],
          "customProperties": [
            {
              "name": "--forma-section-space",
              "default": null
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through focusable content in source order. Sections themselves are not focusable."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "toned-band",
          "title": "Surface-toned band on a marketing page",
          "mobile": false,
          "raw": "components/section/toned-band.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "inverse-band",
          "title": "Inverse band for a key statement",
          "mobile": false,
          "raw": "components/section/inverse-band.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "application-sections",
          "title": "Application page regions",
          "mobile": false,
          "raw": "components/section/application-sections.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-sections",
          "title": "Mobile marketing sections",
          "mobile": true,
          "raw": "components/section/mobile-sections.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "section-heading",
        "container",
        "hero",
        "surface"
      ]
    },
    {
      "slug": "section-heading",
      "title": "Section heading",
      "tag": "forma-section-heading",
      "category": "site",
      "behavior": "Site content",
      "summary": "Labels a page section with an eyebrow, heading, framing sentence, and optional aside that wraps on narrow screens.",
      "docsUrl": "components/section-heading/",
      "pattern": "patterns/section-heading.html",
      "minimalHtml": "<forma-section-heading class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <section class=\"forma-section\" aria-labelledby=\"services-title\">\n    <header class=\"forma-section-heading\">\n      <div class=\"forma-section-heading__text\">\n        <p class=\"forma-eyebrow\">Service lines</p>\n        <h2 id=\"services-title\">Name the section in plain language</h2>\n        <p>An optional sentence frames what follows and why it matters.</p>\n      </div>\n      <div class=\"forma-section-heading__aside\"><a class=\"forma-button\" href=\"#services\">Explore the services</a></div>\n    </header>\n  </section>\n</div>\n</forma-section-heading>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-section",
          "values": "id of the h2",
          "default": "—",
          "description": "Names the section by its visible heading."
        },
        {
          "name": "id",
          "on": "h2",
          "values": "string",
          "default": "—",
          "description": "Referenced by the section's aria-labelledby."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-section-heading",
          "elements": [
            "forma-section-heading__aside",
            "forma-section-heading__note",
            "forma-section-heading__text"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab",
          "action": "Reaches any link or button in the aside in source order, after the heading text."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "with-note",
          "title": "Heading with an update note",
          "mobile": false,
          "raw": "components/section-heading/with-note.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "title-only",
          "title": "Title only, followed by cards",
          "mobile": false,
          "raw": "components/section-heading/title-only.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-long-title",
          "title": "Long title with an action on a phone",
          "mobile": true,
          "raw": "components/section-heading/mobile-long-title.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Compare the engagements",
                "expect": {
                  "url": "#section-heading-mobile-long-title-title"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "hero",
        "section",
        "text-roles"
      ]
    },
    {
      "slug": "security-blockers",
      "title": "Security blockers",
      "tag": "forma-security-blockers",
      "category": "security",
      "behavior": "Aegis / application",
      "summary": "Presents security conditions that block a transition without inventing remediation authority.",
      "docsUrl": "components/security-blockers/",
      "pattern": "patterns/security-blockers.html",
      "minimalHtml": "<forma-security-blockers class=\"forma-component-tag\">\n<section class=\"forma-security-blockers\" aria-labelledby=\"security-blockers-title\"><h2 id=\"security-blockers-title\">Release blockers</h2>\n<ul><li data-kind=\"violation\"><a href=\"#SEC-INV-014\">SEC-INV-014</a><span>Authorization invariant violated.</span></li>\n<li data-kind=\"unknown\"><a href=\"#SEC-UNK-003\">SEC-UNK-003</a><span>Runtime egress behavior has not been established.</span></li></ul></section>\n</forma-security-blockers>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-security-blockers",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the region by its heading."
        },
        {
          "name": "data-kind",
          "on": "li",
          "values": "violation | unknown | stale | expired-exception",
          "default": "—",
          "description": "The Tutela blocker kind as machine state. Not styled by Forma CSS; write the kind in the entry text as well."
        },
        {
          "name": "href",
          "on": "a",
          "values": "stable record URL or #ID",
          "default": "—",
          "description": "Deep link to the blocking record."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO 8601 date",
          "default": "—",
          "description": "Machine-readable date, for example when an exception expired."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-security-blockers",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between blocker links."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link to the record."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "four-kinds",
          "title": "Every kind of release blocker",
          "mobile": false,
          "raw": "components/security-blockers/four-kinds.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "none",
          "title": "No blockers for this scope",
          "mobile": false,
          "raw": "components/security-blockers/none.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-long",
          "title": "Blockers on a phone",
          "mobile": true,
          "raw": "components/security-blockers/mobile-long.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "security-posture",
        "security-unknown",
        "security-invariant-result",
        "obligation-panel"
      ]
    },
    {
      "slug": "security-evidence-age",
      "title": "Security evidence age",
      "tag": "forma-security-evidence-age",
      "category": "security",
      "behavior": "Aegis / application",
      "summary": "Makes security evidence freshness and staleness explicit.",
      "docsUrl": "components/security-evidence-age/",
      "pattern": "patterns/security-evidence-age.html",
      "minimalHtml": "<forma-security-evidence-age class=\"forma-component-tag\">\n<section class=\"forma-evidence-age\" aria-labelledby=\"evidence-age-title\"><h2 id=\"evidence-age-title\">Evidence freshness</h2><ul><li data-state=\"current\"><a href=\"#SEC-EVD-042\">SEC-EVD-042</a><span>Current · observed 24 Sep 2026</span></li><li data-state=\"stale\"><a href=\"#SEC-EVD-031\">SEC-EVD-031</a><span>Stale · invalidated by boundary change</span></li></ul></section>\n</forma-security-evidence-age>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-evidence-age",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the region by its heading."
        },
        {
          "name": "data-state",
          "on": "li",
          "values": "current | stale | unknown",
          "default": "—",
          "description": "Machine freshness state from Tutela. Not styled by Forma CSS; the entry text must state it."
        },
        {
          "name": "href",
          "on": "a",
          "values": "stable record URL or #ID",
          "default": "—",
          "description": "Deep link to the evidence record."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO 8601",
          "default": "—",
          "description": "Machine-readable observation or invalidation date."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-evidence-age",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between evidence links."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "mixed",
          "title": "Current, stale and never observed",
          "mobile": false,
          "raw": "components/security-evidence-age/mixed.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "all-stale",
          "title": "All evidence invalidated",
          "mobile": false,
          "raw": "components/security-evidence-age/all-stale.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile",
          "title": "Evidence freshness on a phone",
          "mobile": true,
          "raw": "components/security-evidence-age/mobile.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "freshness",
        "security-evidence-chain",
        "security-state-matrix"
      ]
    },
    {
      "slug": "security-evidence-chain",
      "title": "Security evidence chain",
      "tag": "forma-security-evidence-chain",
      "category": "security",
      "behavior": "Aegis / application",
      "summary": "Shows the provenance chain supporting a security conclusion.",
      "docsUrl": "components/security-evidence-chain/",
      "pattern": "patterns/security-evidence-chain.html",
      "minimalHtml": "<forma-security-evidence-chain class=\"forma-component-tag\">\n<figure class=\"forma-security-evidence-chain\" aria-labelledby=\"evidence-chain-title\"><figcaption id=\"evidence-chain-title\">Evidence chain for SEC-INV-014</figcaption>\n<ol><li><strong>Source</strong><span>Aegis</span></li><li><strong>Observation</strong><a href=\"#SEC-EVD-042\">SEC-EVD-042</a></li><li><strong>Invariant</strong><a href=\"#SEC-INV-014\">SEC-INV-014</a></li><li><strong>State</strong><span>Violated</span></li></ol></figure>\n</forma-security-evidence-chain>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "figure",
          "values": "id of figcaption",
          "default": "—",
          "description": "Names the figure by its caption, which should identify the conclusion the chain supports."
        },
        {
          "name": "href",
          "on": "a",
          "values": "stable record URL or #ID",
          "default": "—",
          "description": "Deep link to the observation or invariant record."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-security-evidence-chain",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between record links in chain order."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "verified",
          "title": "Chain ending in a verified state",
          "mobile": false,
          "raw": "components/security-evidence-chain/verified.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "missing-observation",
          "title": "Chain with a missing observation",
          "mobile": false,
          "raw": "components/security-evidence-chain/missing-observation.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile",
          "title": "Evidence chain on a phone",
          "mobile": true,
          "raw": "components/security-evidence-chain/mobile.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "provenance-trail",
        "evidence-relationship",
        "security-invariant-result"
      ]
    },
    {
      "slug": "security-exception",
      "title": "Security exception",
      "tag": "forma-security-exception",
      "category": "security",
      "behavior": "Aegis / application",
      "summary": "Presents an explicit security exception, its scope, status, and governing evidence.",
      "docsUrl": "components/security-exception/",
      "pattern": "patterns/security-exception.html",
      "minimalHtml": "<forma-security-exception class=\"forma-component-tag\">\n<article class=\"forma-security-exception\" id=\"SEC-EXC-002\"><header><p>Security exception</p><h3>SEC-EXC-002</h3></header>\n<dl><div><dt>Status</dt><dd>Active</dd></div><div><dt>Approver</dt><dd>Security owner</dd></div><div><dt>Expires</dt><dd><time datetime=\"2026-10-01\">1 Oct 2026</time></dd></div><div><dt>Compensating control</dt><dd>Restricted capability and enhanced audit logging.</dd></div></dl></article>\n</forma-security-exception>",
      "attributes": [
        {
          "name": "id",
          "on": "article",
          "values": "stable exception ID",
          "default": "—",
          "description": "Deep-link target. Use the stable Tutela ID (for example SEC-EXC-002) so links from postures and blockers resolve."
        },
        {
          "name": "aria-labelledby",
          "on": "article",
          "values": "id of the heading",
          "default": "—",
          "description": "Optional. Names the article by its exception ID."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO 8601 date",
          "default": "—",
          "description": "Machine-readable expiry or requested expiry."
        },
        {
          "name": "href",
          "on": "a",
          "values": "stable record URL or #ID",
          "default": "—",
          "description": "Links to the governing invariant and evidence."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-security-exception",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between links in the record."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "expired",
          "title": "Expired exception",
          "mobile": false,
          "raw": "components/security-exception/expired.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "requested",
          "title": "Requested, not yet approved",
          "mobile": false,
          "raw": "components/security-exception/requested.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile",
          "title": "Active exception on a phone",
          "mobile": true,
          "raw": "components/security-exception/mobile.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "security-blockers",
        "security-invariant-result",
        "security-unknown"
      ]
    },
    {
      "slug": "security-invariant-result",
      "title": "Security invariant result",
      "tag": "forma-security-invariant-result",
      "category": "security",
      "behavior": "Aegis / application",
      "summary": "Reports invariant evaluation outcomes with explicit state rather than color-only pass/fail cues.",
      "docsUrl": "components/security-invariant-result/",
      "pattern": "patterns/security-invariant-result.html",
      "minimalHtml": "<forma-security-invariant-result class=\"forma-component-tag\">\n<article class=\"forma-invariant-result\" id=\"SEC-INV-014\" data-state=\"violated\"><header><p>Security invariant</p><h3>SEC-INV-014</h3><strong>Violated</strong></header><p>Privileged actions require explicit authorization at the effect boundary.</p><dl><div><dt>Threats</dt><dd><a href=\"#SEC-THR-004\">SEC-THR-004</a></dd></div><div><dt>Evidence</dt><dd><a href=\"#SEC-EVD-042\">SEC-EVD-042</a></dd></div><div><dt>Independent verification</dt><dd>Required</dd></div></dl></article>\n</forma-security-invariant-result>",
      "attributes": [
        {
          "name": "id",
          "on": "article",
          "values": "stable invariant ID",
          "default": "—",
          "description": "Deep-link target; use the stable Tutela ID such as SEC-INV-014."
        },
        {
          "name": "data-state",
          "on": "article",
          "values": "verified | violated | unknown | stale | na",
          "default": "—",
          "description": "Tutela's evaluation as machine state. Not styled by Forma CSS; the bold state word is the visible cue."
        },
        {
          "name": "aria-labelledby",
          "on": "article",
          "values": "id of the heading",
          "default": "—",
          "description": "Optional. Names the article by its invariant ID."
        },
        {
          "name": "href",
          "on": "a",
          "values": "stable record URL or #ID",
          "default": "—",
          "description": "Links to threats, evidence and unknowns."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO 8601 date",
          "default": "—",
          "description": "Machine-readable verification date."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-invariant-result",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between related-record links."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "verified",
          "title": "Verified invariant",
          "mobile": false,
          "raw": "components/security-invariant-result/verified.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "unknown",
          "title": "Unknown because evidence is missing",
          "mobile": false,
          "raw": "components/security-invariant-result/unknown.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile",
          "title": "Violated invariant on a phone",
          "mobile": true,
          "raw": "components/security-invariant-result/mobile.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "security-evidence-chain",
        "security-state-matrix",
        "security-exception",
        "security-unknown"
      ]
    },
    {
      "slug": "security-posture",
      "title": "Security posture",
      "tag": "forma-security-posture",
      "category": "security",
      "behavior": "Aegis / application",
      "summary": "Summarizes security posture while preserving unresolved, unknown, and blocking conditions.",
      "docsUrl": "components/security-posture/",
      "pattern": "patterns/security-posture.html",
      "minimalHtml": "<forma-security-posture class=\"forma-component-tag\">\n<section class=\"forma-security-posture\" data-posture=\"blocked\" aria-labelledby=\"security-posture-title\">\n  <header class=\"forma-security-posture__header\">\n    <div>\n      <p class=\"forma-security-posture__eyebrow\">Tutela release posture</p>\n      <h2 id=\"security-posture-title\">Blocked</h2>\n    </div>\n    <span class=\"forma-status-lozenge\" data-state=\"danger\" aria-label=\"Release posture: blocked\">Blocked</span>\n  </header>\n  <dl class=\"forma-security-posture__meta\">\n    <div><dt>Subject</dt><dd><code>0123456789abcdef</code></dd></div>\n    <div><dt>Scope</dt><dd>Authentication, authorization, agent tools</dd></div>\n    <div><dt>Assessed</dt><dd><time datetime=\"2026-09-24T16:00:00Z\">24 Sep 2026</time></dd></div>\n  </dl>\n  <div class=\"forma-security-posture__blockers\" role=\"status\">\n    <strong>2 release blockers</strong>\n    <ul>\n      <li><a href=\"#SEC-INV-002\">SEC-INV-002</a>: authorization evidence is unknown.</li>\n      <li><a href=\"#SEC-UNK-001\">SEC-UNK-001</a>: imported-organization behavior is not established.</li>\n    </ul>\n  </div>\n  <p class=\"forma-security-posture__qualification\">This posture describes the defined assessment scope and evidence. It is not a general claim that the system is secure.</p>\n</section>\n</forma-security-posture>",
      "attributes": [
        {
          "name": "data-posture",
          "on": "section.forma-security-posture",
          "values": "pass | conditional | blocked | indeterminate",
          "default": "—",
          "description": "The Tutela posture as machine state. Not styled by Forma CSS; it keeps the input state inspectable and must match the visible heading and label."
        },
        {
          "name": "aria-labelledby",
          "on": "section.forma-security-posture",
          "values": "id of the posture heading",
          "default": "—",
          "description": "Names the region by the posture, so it is announced as, for example, \"Blocked, region\"."
        },
        {
          "name": "data-state",
          "on": ".forma-status-lozenge",
          "values": "ok | attention | unknown | blocked",
          "default": "—",
          "description": "Selects the lozenge glyph (✓, !, ?, ×). Map pass, conditional, indeterminate and blocked to these explicitly; the label text is the state."
        },
        {
          "name": "role",
          "on": ".forma-security-posture__blockers",
          "values": "status",
          "default": "absent",
          "description": "Only if the application updates the blocker list in place and wants the change announced."
        },
        {
          "name": "href",
          "on": "blocker link",
          "values": "stable record URL or #ID",
          "default": "—",
          "description": "Deep link to the stable invariant, unknown, evidence or exception record."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO 8601",
          "default": "—",
          "description": "Machine-readable assessment time."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-security-posture",
          "elements": [
            "forma-security-posture__blockers",
            "forma-security-posture__eyebrow",
            "forma-security-posture__header",
            "forma-security-posture__meta",
            "forma-security-posture__qualification"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between blocker and condition links. The posture itself is not interactive."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link to the stable record (native link behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "pass",
          "title": "Pass within a defined scope",
          "mobile": false,
          "raw": "components/security-posture/pass.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "conditional",
          "title": "Conditional on an active exception",
          "mobile": false,
          "raw": "components/security-posture/conditional.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "indeterminate",
          "title": "Indeterminate because evidence is unknown",
          "mobile": false,
          "raw": "components/security-posture/indeterminate.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile-blocked",
          "title": "Blocked posture on a phone",
          "mobile": true,
          "raw": "components/security-posture/mobile-blocked.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "security-blockers",
        "security-state-matrix",
        "security-unknown",
        "status-lozenge"
      ]
    },
    {
      "slug": "security-state-matrix",
      "title": "Security state matrix",
      "tag": "forma-security-state-matrix",
      "category": "security",
      "behavior": "Aegis / application",
      "summary": "Counts security results by explicit state (Verified, Violated, Unknown, Stale, N/A) so no state collapses into another or into a score.",
      "docsUrl": "components/security-state-matrix/",
      "pattern": "patterns/security-state-matrix.html",
      "minimalHtml": "<forma-security-state-matrix class=\"forma-component-tag\">\n<section class=\"forma-security-state-matrix\" aria-labelledby=\"security-state-title\">\n<h2 id=\"security-state-title\">Security evidence state</h2><dl class=\"forma-security-state-matrix__grid\">\n<div data-state=\"verified\"><dt>Verified</dt><dd>18</dd></div><div data-state=\"violated\"><dt>Violated</dt><dd>1</dd></div>\n<div data-state=\"unknown\"><dt>Unknown</dt><dd>3</dd></div><div data-state=\"stale\"><dt>Stale</dt><dd>2</dd></div><div data-state=\"na\"><dt>N/A</dt><dd>4</dd></div>\n</dl></section>\n</forma-security-state-matrix>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-security-state-matrix",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the region; include the scope or subject in the heading."
        },
        {
          "name": "data-state",
          "on": ".forma-security-state-matrix__grid > div",
          "values": "verified | violated | unknown | stale | na",
          "default": "—",
          "description": "Machine state name for the tile. Not styled by Forma CSS; the dt text is the visible label."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-security-state-matrix",
          "elements": [
            "forma-security-state-matrix__grid"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "—",
          "action": "Not interactive. Link to detailed lists from surrounding content if readers need to drill in."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "new-artifact",
          "title": "New artifact with nothing verified yet",
          "mobile": false,
          "raw": "components/security-state-matrix/new-artifact.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "per-scope",
          "title": "One matrix per assessed scope",
          "mobile": false,
          "raw": "components/security-state-matrix/per-scope.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile",
          "title": "State counts on a phone",
          "mobile": true,
          "raw": "components/security-state-matrix/mobile.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "security-posture",
        "data-grid",
        "metric-card",
        "security-trend"
      ]
    },
    {
      "slug": "security-trend",
      "title": "Security trend",
      "tag": "forma-security-trend",
      "category": "security",
      "behavior": "Aegis / application",
      "summary": "Presents security change over time with state and context independent of color.",
      "docsUrl": "components/security-trend/",
      "pattern": "patterns/security-trend.html",
      "minimalHtml": "<forma-security-trend class=\"forma-component-tag\">\n<section class=\"forma-security-trend\" aria-labelledby=\"security-trend-title\"><h2 id=\"security-trend-title\">Security trend</h2><p>Compared with the previous assessed artifact.</p><ul><li data-direction=\"regression\"><strong>Regression</strong><span>Unknown security effects increased from 0 to 2.</span></li><li data-direction=\"improvement\"><strong>Improvement</strong><span>Stale evidence decreased from 3 to 1.</span></li><li data-direction=\"unknown\"><strong>No measurement</strong><span>Exception aging was not measured for the previous artifact.</span></li></ul></section>\n</forma-security-trend>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-security-trend",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the region by its heading."
        },
        {
          "name": "data-direction",
          "on": "li",
          "values": "regression | improvement | unchanged | unknown",
          "default": "—",
          "description": "Machine direction supplied by Tutela. Not styled by Forma CSS; the bold direction word is the visible cue."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO 8601 date",
          "default": "—",
          "description": "Machine-readable baseline date."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-security-trend",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "—",
          "action": "Not interactive unless the application adds links in entry text."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "unchanged",
          "title": "Nothing changed since the last release",
          "mobile": false,
          "raw": "components/security-trend/unchanged.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "first-assessment",
          "title": "First assessment with no baseline",
          "mobile": false,
          "raw": "components/security-trend/first-assessment.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile",
          "title": "Security trend on a phone",
          "mobile": true,
          "raw": "components/security-trend/mobile.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "security-state-matrix",
        "metric-value-change",
        "security-evidence-age"
      ]
    },
    {
      "slug": "security-unknown",
      "title": "Security unknown",
      "tag": "forma-security-unknown",
      "category": "security",
      "behavior": "Aegis / application",
      "summary": "Represents unknown security state explicitly instead of collapsing it into failure or success.",
      "docsUrl": "components/security-unknown/",
      "pattern": "patterns/security-unknown.html",
      "minimalHtml": "<forma-security-unknown class=\"forma-component-tag\">\n<article class=\"forma-security-unknown\" id=\"SEC-UNK-003\"><header><p>Unknown security effect</p><h3>SEC-UNK-003</h3></header><p>Runtime egress behavior has not been established.</p>\n<dl><div><dt>Consequence</dt><dd>Release posture cannot be established for the network boundary.</dd></div><div><dt>Evidence needed</dt><dd>Observed egress policy test against the release artifact.</dd></div></dl></article>\n</forma-security-unknown>",
      "attributes": [
        {
          "name": "id",
          "on": "article",
          "values": "stable unknown ID",
          "default": "—",
          "description": "Deep-link target; use the stable Tutela ID such as SEC-UNK-003."
        },
        {
          "name": "aria-labelledby",
          "on": "article",
          "values": "id of the heading",
          "default": "—",
          "description": "Optional. Names the article by its unknown ID."
        },
        {
          "name": "href",
          "on": "a",
          "values": "stable record URL or #ID",
          "default": "—",
          "description": "Links to the obligation or related records."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO 8601 date",
          "default": "—",
          "description": "Machine-readable obligation due date."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-security-unknown",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves between links in the record."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "with-obligation",
          "title": "Unknown with an assigned obligation",
          "mobile": false,
          "raw": "components/security-unknown/with-obligation.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "non-blocking",
          "title": "Unknown outside the release scope",
          "mobile": false,
          "raw": "components/security-unknown/non-blocking.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile",
          "title": "Unknown effect on a phone",
          "mobile": true,
          "raw": "components/security-unknown/mobile.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "security-blockers",
        "security-invariant-result",
        "obligation-panel",
        "operation-status"
      ]
    },
    {
      "slug": "segmented-control",
      "title": "Segmented control",
      "tag": "forma-segmented-control",
      "category": "selection",
      "behavior": "Native HTML",
      "summary": "Radio-backed compact selection with visible selected and focus states; where supported, one light-inertial selection indicator travels between segments without delaying native selection.",
      "docsUrl": "components/segmented-control/",
      "pattern": "patterns/segmented-control.html",
      "minimalHtml": "<forma-segmented-control class=\"forma-component-tag\">\n<fieldset class=\"forma-field\">\n  <legend class=\"forma-field__label\">Density</legend>\n  <div class=\"forma-segmented\">\n    <label class=\"forma-segment\">\n      <input type=\"radio\" name=\"density\" value=\"comfortable\" checked>\n      <span>Comfortable</span>\n    </label>\n    <label class=\"forma-segment\">\n      <input type=\"radio\" name=\"density\" value=\"compact\">\n      <span>Compact</span>\n    </label>\n  </div>\n</fieldset>\n</forma-segmented-control>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "radio",
          "default": "—",
          "description": "Required. Each segment is a native radio."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Required and shared by every radio in one control; it makes them one exclusive group and is the submitted field name. Unique per control on the page."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "\"on\"",
          "description": "Submitted value of the selected segment."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Initial selection. Omit on all radios when the user must make an active choice."
        },
        {
          "name": "required",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Native constraint: the form cannot submit until one segment is selected. Put it on one radio of the group."
        },
        {
          "name": "aria-describedby",
          "on": "input",
          "values": "id",
          "default": "—",
          "description": "Links help text to the options."
        },
        {
          "name": "data-forma-motion-weight",
          "on": ".forma-segmented",
          "values": "light | standard | heavy",
          "default": "light",
          "description": "Perceived mass of the travelling indicator."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-segmented",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": []
        },
        {
          "root": "forma-segment",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus into the group (to the checked segment, or the first when none is checked) and out of it. The group is one tab stop."
        },
        {
          "keys": "Arrow Right / Arrow Down",
          "action": "Moves to and selects the next segment, wrapping to the first (native radio behavior)."
        },
        {
          "keys": "Arrow Left / Arrow Up",
          "action": "Moves to and selects the previous segment, wrapping to the last."
        },
        {
          "keys": "Space",
          "action": "Selects the focused segment when none is selected yet."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "calendar-range",
          "title": "Calendar range picker",
          "mobile": false,
          "raw": "components/segmented-control/calendar-range.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "no-default-heavy",
          "title": "No default selection, heavier indicator",
          "mobile": false,
          "raw": "components/segmented-control/no-default-heavy.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-wrapping-segments",
          "title": "Wrapping segments on a phone",
          "mobile": true,
          "raw": "components/segmented-control/mobile-wrapping-segments.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "choice-group",
        "tabs",
        "select",
        "switch",
        "multi-choice"
      ]
    },
    {
      "slug": "select",
      "title": "Select",
      "tag": "forma-select",
      "category": "forms",
      "behavior": "Native HTML",
      "summary": "An ordinary native select with platform picker behavior and physics-derived CSS affordance motion.",
      "docsUrl": "components/select/",
      "pattern": "patterns/select.html",
      "minimalHtml": "<forma-select class=\"forma-component-tag\">\n<label class=\"forma-select-field\">\n  <span class=\"forma-field__label\">Deployment region</span>\n  <span class=\"forma-select\" data-forma-motion-weight=\"standard\">\n    <select class=\"forma-select__input\" name=\"region\" aria-describedby=\"region-description\">\n      <option value=\"us-east\">US East</option>\n      <option value=\"us-west\">US West</option>\n      <option value=\"eu-west\">Europe West</option>\n    </select>\n    <span class=\"forma-select__indicator\" aria-hidden=\"true\"></span>\n  </span>\n  <span class=\"forma-field__description\" id=\"region-description\">Choose where this workload will run.</span>\n</label>\n</forma-select>",
      "attributes": [
        {
          "name": "name",
          "on": "select",
          "values": "string",
          "default": "—",
          "description": "Form field name used on submission."
        },
        {
          "name": "required",
          "on": "select",
          "values": "boolean",
          "default": "absent",
          "description": "With an empty-value first option, blocks submission until a real option is chosen."
        },
        {
          "name": "disabled",
          "on": "select",
          "values": "boolean",
          "default": "absent",
          "description": "Removes the select from focus and submission and dims the control."
        },
        {
          "name": "selected",
          "on": "option",
          "values": "boolean",
          "default": "first option",
          "description": "Initial selection."
        },
        {
          "name": "label",
          "on": "optgroup",
          "values": "string",
          "default": "—",
          "description": "Visible, announced group heading for a set of options."
        },
        {
          "name": "autocomplete",
          "on": "select",
          "values": "country | …",
          "default": "browser heuristic",
          "description": "Lets the browser autofill a known value."
        },
        {
          "name": "aria-describedby",
          "on": "select",
          "values": "id of the description",
          "default": "—",
          "description": "Links the `.forma-field__description` guidance."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-select__indicator",
          "values": "true",
          "default": "—",
          "description": "Required on the indicator so the decorative chevron is not announced."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-select",
          "elements": [
            "forma-select__indicator",
            "forma-select__input"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": []
        },
        {
          "root": "forma-select-field",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus to and from the select."
        },
        {
          "keys": "ArrowUp / ArrowDown",
          "action": "Changes the selection or moves within the open picker (platform-dependent)."
        },
        {
          "keys": "Alt+ArrowDown / Space / Enter",
          "action": "Opens the picker; exact keys vary by platform."
        },
        {
          "keys": "Printable characters",
          "action": "Type-ahead jumps to the first matching option."
        },
        {
          "keys": "Escape",
          "action": "Closes an open picker without changing the value."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "grouped-required",
          "title": "Required choice with grouped options",
          "mobile": false,
          "raw": "components/select/grouped-required.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "locked-by-plan",
          "title": "Locked by plan",
          "mobile": false,
          "raw": "components/select/locked-by-plan.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "heavy-weight-long-options",
          "title": "Heavy indicator weight with long option text",
          "mobile": false,
          "raw": "components/select/heavy-weight-long-options.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-country",
          "title": "Mobile country picker",
          "mobile": true,
          "raw": "components/select/mobile-country.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "combobox",
        "choice-group",
        "segmented-control",
        "multi-choice"
      ]
    },
    {
      "slug": "semantic-differential",
      "title": "Semantic differential",
      "tag": "forma-semantic-differential",
      "category": "assessment",
      "behavior": "Native HTML",
      "summary": "A bipolar textual scale that keeps the ordered response radio-backed and explicit.",
      "docsUrl": "components/semantic-differential/",
      "pattern": "patterns/semantic-differential.html",
      "minimalHtml": "<forma-semantic-differential class=\"forma-component-tag\">\n<fieldset class=\"forma-semantic-differential\">\n  <legend class=\"forma-semantic-differential__legend\">How would you characterize the current process?</legend>\n\n  <div class=\"forma-semantic-differential__endpoints\" aria-hidden=\"true\">\n    <span>Highly manual</span>\n    <span>Highly automated</span>\n  </div>\n\n  <div class=\"forma-semantic-differential__scale\">\n    <label><input type=\"radio\" name=\"automation-level\" value=\"1\" required><span aria-hidden=\"true\">1</span><span class=\"forma-sr-only\">Highly manual, position 1 of 7</span></label>\n    <label><input type=\"radio\" name=\"automation-level\" value=\"2\"><span aria-hidden=\"true\">2</span><span class=\"forma-sr-only\">Position 2 of 7</span></label>\n    <label><input type=\"radio\" name=\"automation-level\" value=\"3\"><span aria-hidden=\"true\">3</span><span class=\"forma-sr-only\">Position 3 of 7</span></label>\n    <label><input type=\"radio\" name=\"automation-level\" value=\"4\"><span aria-hidden=\"true\">4</span><span class=\"forma-sr-only\">Position 4 of 7</span></label>\n    <label><input type=\"radio\" name=\"automation-level\" value=\"5\"><span aria-hidden=\"true\">5</span><span class=\"forma-sr-only\">Position 5 of 7</span></label>\n    <label><input type=\"radio\" name=\"automation-level\" value=\"6\"><span aria-hidden=\"true\">6</span><span class=\"forma-sr-only\">Position 6 of 7</span></label>\n    <label><input type=\"radio\" name=\"automation-level\" value=\"7\"><span aria-hidden=\"true\">7</span><span class=\"forma-sr-only\">Highly automated, position 7 of 7</span></label>\n  </div>\n\n  <div class=\"forma-semantic-differential__endpoints forma-semantic-differential__endpoints--mobile\">\n    <span>1 = Highly manual</span>\n    <span>7 = Highly automated</span>\n  </div>\n</fieldset>\n</forma-semantic-differential>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "radio",
          "default": "—",
          "description": "Required. Seven radios sharing one name."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Groups the seven positions. Unique per question."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Submitted position. The application decides direction and scoring."
        },
        {
          "name": "required",
          "on": "first input",
          "values": "boolean",
          "default": "absent",
          "description": "Native required-group validation."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Restores a saved position."
        },
        {
          "name": "aria-hidden",
          "on": "desktop endpoints row and number spans",
          "values": "true",
          "default": "—",
          "description": "Hides the visual-only endpoint row and the decorative numbers; meaning is carried by the .forma-sr-only text in each label."
        },
        {
          "name": "aria-describedby",
          "on": "fieldset",
          "values": "id list",
          "default": "—",
          "description": "Associates help or error text with the scale."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-semantic-differential",
          "elements": [
            "forma-semantic-differential__endpoints",
            "forma-semantic-differential__legend",
            "forma-semantic-differential__scale"
          ],
          "modifiers": [
            "forma-semantic-differential__endpoints--mobile"
          ],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus into and out of the group."
        },
        {
          "keys": "Arrow keys",
          "action": "Native radio behavior: moves to and selects the adjacent position."
        },
        {
          "keys": "Space",
          "action": "Selects the focused position when none is checked."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "saved-response",
          "title": "Previously saved response",
          "mobile": false,
          "raw": "components/semantic-differential/saved-response.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "long-endpoints",
          "title": "Long endpoint descriptions with help text",
          "mobile": false,
          "raw": "components/semantic-differential/long-endpoints.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-endpoint-key",
          "title": "Endpoint key on a phone",
          "mobile": true,
          "raw": "components/semantic-differential/mobile-endpoint-key.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "ordinal-scale",
        "slider",
        "symbol-rating"
      ]
    },
    {
      "slug": "sidebar",
      "title": "Sidebar",
      "tag": "forma-sidebar",
      "category": "layout",
      "behavior": "Native CSS",
      "summary": "Composes a supporting region with primary content and deterministic source-order reflow.",
      "docsUrl": "components/sidebar/",
      "pattern": "patterns/sidebar.html",
      "minimalHtml": "<forma-sidebar class=\"forma-component-tag\">\n<section class=\"forma-sidebar\" aria-label=\"Workspace\">\n  <aside class=\"forma-sidebar__side\"><nav aria-label=\"Workspace navigation\"><a href=\"#overview\" aria-current=\"page\">Overview</a><a href=\"#evidence\">Evidence</a></nav></aside>\n  <main class=\"forma-sidebar__content\" id=\"overview\"><h2>Overview</h2><p>The main region grows while the sidebar preserves a useful measure.</p></main>\n</section>\n</forma-sidebar>",
      "attributes": [
        {
          "name": "aria-label",
          "on": ".forma-sidebar__side / region",
          "values": "string",
          "default": "—",
          "description": "Names a nav, aside or form in the sidebar so its landmark is distinguishable."
        },
        {
          "name": "aria-labelledby",
          "on": "regions",
          "values": "id of the region heading",
          "default": "—",
          "description": "Names a region by its visible heading."
        },
        {
          "name": "aria-current",
          "on": "navigation link",
          "values": "page",
          "default": "—",
          "description": "Marks the current section in sidebar navigation."
        },
        {
          "name": "style",
          "on": ".forma-sidebar",
          "values": "--forma-sidebar-width / --forma-sidebar-content-min / --forma-sidebar-space",
          "default": "—",
          "description": "Per-instance override of the sidebar's preferred width, content minimum or gap."
        },
        {
          "name": "data-density",
          "on": "nested .forma-stack",
          "values": "compact",
          "default": "—",
          "description": "Used on stacks inside the regions; it does not affect the sidebar itself."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-sidebar",
          "elements": [
            "forma-sidebar__content",
            "forma-sidebar__side"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": [
            {
              "name": "--forma-sidebar-content-min",
              "default": "60%"
            },
            {
              "name": "--forma-sidebar-space",
              "default": "var(--forma-primitive-spacing-5, 1.5rem)"
            },
            {
              "name": "--forma-sidebar-width",
              "default": "18rem"
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the side region and then the content region, or the reverse, following source order."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "settings-navigation",
          "title": "Settings with section navigation",
          "mobile": false,
          "raw": "components/sidebar/settings-navigation.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior",
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "article-end-sidebar",
          "title": "Article with related links after it",
          "mobile": false,
          "raw": "components/sidebar/article-end-sidebar.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile-filters",
          "title": "Mobile filters above results",
          "mobile": true,
          "raw": "components/sidebar/mobile-filters.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        }
      ],
      "related": [
        "rail",
        "switcher",
        "split-pane",
        "workspace-shell"
      ]
    },
    {
      "slug": "matrix-single",
      "title": "Single-choice matrix",
      "tag": "forma-matrix-single",
      "category": "assessment",
      "behavior": "Native HTML",
      "summary": "Repeated single-choice scales arranged as a matrix while retaining per-row radio semantics.",
      "docsUrl": "components/matrix-single/",
      "pattern": "patterns/matrix-single.html",
      "minimalHtml": "<forma-matrix-single class=\"forma-component-tag\">\n<fieldset class=\"forma-matrix\">\n  <legend class=\"forma-matrix__legend\">Rate each practice.</legend>\n  <p class=\"forma-field__description\">Each row is an independent single-choice question. On narrow screens rows stack into ordinary controls.</p>\n\n  <div class=\"forma-matrix__rows\">\n    <fieldset class=\"forma-matrix__row\">\n      <legend>Automated testing</legend>\n      <div class=\"forma-matrix__choices\">\n        <label><input type=\"radio\" name=\"testing-maturity\" value=\"1\" required><span>Initial</span></label>\n        <label><input type=\"radio\" name=\"testing-maturity\" value=\"2\"><span>Developing</span></label>\n        <label><input type=\"radio\" name=\"testing-maturity\" value=\"3\"><span>Established</span></label>\n        <label><input type=\"radio\" name=\"testing-maturity\" value=\"4\"><span>Optimized</span></label>\n      </div>\n    </fieldset>\n\n    <fieldset class=\"forma-matrix__row\">\n      <legend>Deployment automation</legend>\n      <div class=\"forma-matrix__choices\">\n        <label><input type=\"radio\" name=\"deployment-maturity\" value=\"1\" required><span>Initial</span></label>\n        <label><input type=\"radio\" name=\"deployment-maturity\" value=\"2\"><span>Developing</span></label>\n        <label><input type=\"radio\" name=\"deployment-maturity\" value=\"3\"><span>Established</span></label>\n        <label><input type=\"radio\" name=\"deployment-maturity\" value=\"4\"><span>Optimized</span></label>\n      </div>\n    </fieldset>\n  </div>\n</fieldset>\n</forma-matrix-single>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "radio",
          "default": "—",
          "description": "Required. One radio per choice in each row."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string unique per row",
          "default": "—",
          "description": "Each row has its own name, so each row is its own exclusive answer."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Submitted value for the row. Meaning and scoring stay in the application."
        },
        {
          "name": "required",
          "on": "first input of a row",
          "values": "boolean",
          "default": "absent",
          "description": "Makes that row's answer required; rows validate independently."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Restores a saved row answer."
        },
        {
          "name": "aria-invalid",
          "on": "inputs of a row",
          "values": "true",
          "default": "absent",
          "description": "Set by the application on a row that failed validation."
        },
        {
          "name": "aria-describedby",
          "on": "row fieldset",
          "values": "id of an error or help element",
          "default": "—",
          "description": "Associates a row-level error or help text with that row."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-matrix",
          "elements": [
            "forma-matrix__choices",
            "forma-matrix__legend",
            "forma-matrix__row",
            "forma-matrix__rows"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves from one row's radio group to the next; each row is one tab stop."
        },
        {
          "keys": "Arrow keys",
          "action": "Moves and selects within the current row only."
        },
        {
          "keys": "Space",
          "action": "Selects the focused choice when the row is unanswered."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "partially-answered",
          "title": "Partially answered with a row error",
          "mobile": false,
          "raw": "components/matrix-single/partially-answered.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "long-row-prompts",
          "title": "Long row prompts with Not applicable",
          "mobile": false,
          "raw": "components/matrix-single/long-row-prompts.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-decomposed",
          "title": "Matrix decomposed on a phone",
          "mobile": true,
          "raw": "components/matrix-single/mobile-decomposed.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "ordinal-scale",
        "comparison-grid",
        "question"
      ]
    },
    {
      "slug": "site-footer",
      "title": "Site footer",
      "tag": "forma-site-footer",
      "category": "site",
      "behavior": "Site content",
      "summary": "Closing identity, actions, secondary navigation, and legal note on a surface tone.",
      "docsUrl": "components/site-footer/",
      "pattern": "patterns/site-footer.html",
      "minimalHtml": "<forma-site-footer class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <footer class=\"forma-site-footer\" data-forma-tone=\"inverse\">\n    <div class=\"forma-site-footer__inner\">\n      <div class=\"forma-site-footer__main\">\n        <div><p class=\"forma-eyebrow\">Example / Product</p><p>Strategy, architecture, and delivery for consequential systems.</p></div>\n        <div class=\"forma-actions\"><a class=\"forma-button\" href=\"#contact\">Schedule a working session</a></div>\n      </div>\n      <nav class=\"forma-site-footer__nav\" aria-label=\"Footer\"><ul><li><a href=\"#privacy\">Privacy</a></li><li><a href=\"#source\">Source</a></li></ul></nav>\n      <p class=\"forma-site-footer__note\"><span>&copy; 2026 Example</span><span>Indianapolis, Indiana</span></p>\n    </div>\n  </footer>\n</div>\n</forma-site-footer>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "nav.forma-site-footer__nav",
          "values": "string",
          "default": "—",
          "description": "Names the footer navigation differently from the primary navigation."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-site-footer",
          "elements": [
            "forma-site-footer__inner",
            "forma-site-footer__main",
            "forma-site-footer__nav",
            "forma-site-footer__note"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the footer action and links in source order."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link (native link behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "surface-product-footer",
          "title": "Surface footer for a product site",
          "mobile": false,
          "raw": "components/site-footer/surface-product-footer.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Documentation",
                "expect": {
                  "url": "#site-footer-surface-product-footer-note"
                }
              },
              {
                "role": "link",
                "name": "Release notes",
                "expect": {
                  "url": "#site-footer-surface-product-footer-note"
                }
              },
              {
                "role": "link",
                "name": "Source",
                "expect": {
                  "url": "#site-footer-surface-product-footer-note"
                }
              },
              {
                "role": "link",
                "name": "Privacy",
                "expect": {
                  "url": "#site-footer-surface-product-footer-note"
                }
              }
            ]
          }
        },
        {
          "id": "legal-only",
          "title": "Minimal legal footer",
          "mobile": false,
          "raw": "components/site-footer/legal-only.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-full-footer",
          "title": "Phone footer with action and links",
          "mobile": true,
          "raw": "components/site-footer/mobile-full-footer.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Schedule a working session",
                "expect": {
                  "url": "#site-footer-mobile-full-footer-note"
                }
              },
              {
                "role": "link",
                "name": "Research",
                "expect": {
                  "url": "#site-footer-mobile-full-footer-note"
                }
              },
              {
                "role": "link",
                "name": "Products",
                "expect": {
                  "url": "#site-footer-mobile-full-footer-note"
                }
              },
              {
                "role": "link",
                "name": "Privacy",
                "expect": {
                  "url": "#site-footer-mobile-full-footer-note"
                }
              },
              {
                "role": "link",
                "name": "Source",
                "expect": {
                  "url": "#site-footer-mobile-full-footer-note"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "site-header",
        "marketing-shell",
        "cta"
      ]
    },
    {
      "slug": "site-header",
      "title": "Site header",
      "tag": "forma-site-header",
      "category": "site",
      "behavior": "Site content",
      "summary": "Identity and primary navigation that wraps instead of hiding links, keeps 44px targets, and marks the current page with a non-color rule.",
      "docsUrl": "components/site-header/",
      "pattern": "patterns/site-header.html",
      "minimalHtml": "<forma-site-header class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <header class=\"forma-site-header\">\n    <div class=\"forma-site-header__inner\">\n      <div class=\"forma-site-header__identity\">\n        <a class=\"forma-site-header__brand\" href=\"#top\"><span class=\"forma-site-header__mark\" aria-hidden=\"true\">EX</span><span class=\"forma-site-header__name\">Example / Product</span></a>\n        <p class=\"forma-site-header__tagline\">Evidence-driven engineering systems</p>\n      </div>\n      <nav class=\"forma-site-nav\" aria-label=\"Primary\">\n        <ul class=\"forma-site-nav__list\">\n          <li><a class=\"forma-site-nav__link\" href=\"#top\" aria-current=\"page\">Overview</a></li>\n          <li><a class=\"forma-site-nav__link\" href=\"#research\">Research</a></li>\n          <li><a class=\"forma-site-nav__link\" href=\"#docs\">Documentation</a></li>\n          <li><a class=\"forma-site-nav__link\" data-forma-variant=\"action\" href=\"#contact\">Get in touch</a></li>\n        </ul>\n      </nav>\n    </div>\n  </header>\n</div>\n</forma-site-header>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "nav.forma-site-nav",
          "values": "string",
          "default": "—",
          "description": "Names the navigation landmark. Use \"Primary\" and give any other nav on the page a different name."
        },
        {
          "name": "aria-current",
          "on": "a.forma-site-nav__link",
          "values": "page | true",
          "default": "absent",
          "description": "`page` for the exact current page, `true` for the current section on a subpage. Mark only one link."
        },
        {
          "name": "aria-hidden",
          "on": "span.forma-site-header__mark",
          "values": "true",
          "default": "—",
          "description": "Required. The mark is decorative; the visible name is the brand link's accessible name."
        },
        {
          "name": "href",
          "on": "a",
          "values": "URL",
          "default": "—",
          "description": "Ordinary navigation links; the site owns routing."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-site-header",
          "elements": [
            "forma-site-header__brand",
            "forma-site-header__identity",
            "forma-site-header__inner",
            "forma-site-header__mark",
            "forma-site-header__name",
            "forma-site-header__tagline"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-site-nav",
          "elements": [
            "forma-site-nav__link",
            "forma-site-nav__list"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "aria-current",
              "values": [
                "page",
                "true"
              ]
            },
            {
              "name": "data-forma-variant",
              "values": [
                "action"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the brand link and navigation links in source order."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link (native link behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "current-section",
          "title": "Current section on a subpage",
          "mobile": false,
          "raw": "components/site-header/current-section.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Harbor / Limen",
                "expect": {
                  "url": "#site-header-current-section-home"
                }
              },
              {
                "role": "link",
                "name": "Overview",
                "expect": {
                  "url": "#site-header-current-section-home"
                }
              },
              {
                "role": "link",
                "name": "Documentation",
                "expect": {
                  "url": "#site-header-current-section-home"
                }
              },
              {
                "role": "link",
                "name": "Releases",
                "expect": {
                  "url": "#site-header-current-section-home"
                }
              }
            ]
          }
        },
        {
          "id": "long-brand-name",
          "title": "Long brand name without tagline",
          "mobile": false,
          "raw": "components/site-header/long-brand-name.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Example Harbor / Tutoris Research Publications",
                "expect": {
                  "url": "#site-header-long-brand-name-top"
                }
              },
              {
                "role": "link",
                "name": "Publications",
                "expect": {
                  "url": "#site-header-long-brand-name-top"
                }
              },
              {
                "role": "link",
                "name": "Methods",
                "expect": {
                  "url": "#site-header-long-brand-name-top"
                }
              },
              {
                "role": "link",
                "name": "Datasets",
                "expect": {
                  "url": "#site-header-long-brand-name-top"
                }
              },
              {
                "role": "link",
                "name": "About",
                "expect": {
                  "url": "#site-header-long-brand-name-top"
                }
              },
              {
                "role": "link",
                "name": "Subscribe",
                "expect": {
                  "url": "#site-header-long-brand-name-top"
                }
              }
            ]
          }
        },
        {
          "id": "mobile-wrapping-nav",
          "title": "Phone navigation wraps",
          "mobile": true,
          "raw": "components/site-header/mobile-wrapping-nav.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Example Harbor",
                "expect": {
                  "url": "#site-header-mobile-wrapping-nav-top"
                }
              },
              {
                "role": "link",
                "name": "Overview",
                "expect": {
                  "url": "#site-header-mobile-wrapping-nav-top"
                }
              },
              {
                "role": "link",
                "name": "Research",
                "expect": {
                  "url": "#site-header-mobile-wrapping-nav-top"
                }
              },
              {
                "role": "link",
                "name": "Products",
                "expect": {
                  "url": "#site-header-mobile-wrapping-nav-top"
                }
              },
              {
                "role": "link",
                "name": "Writing",
                "expect": {
                  "url": "#site-header-mobile-wrapping-nav-top"
                }
              },
              {
                "role": "link",
                "name": "Get in touch",
                "expect": {
                  "url": "#site-header-mobile-wrapping-nav-top"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "marketing-shell",
        "site-footer",
        "navigation-shell",
        "skip-link"
      ]
    },
    {
      "slug": "skeleton",
      "title": "Skeleton",
      "tag": "forma-skeleton",
      "category": "feedback",
      "behavior": "Application state",
      "summary": "Low-information loading placeholder with explicit busy semantics; its shimmer is a named cadence that runs only while aria-busy is true and stops for reduced motion.",
      "docsUrl": "components/skeleton/",
      "pattern": "patterns/skeleton.html",
      "minimalHtml": "<forma-skeleton class=\"forma-component-tag\">\n<section class=\"forma-skeleton\" aria-busy=\"true\" aria-label=\"Loading content\">\n  <span class=\"forma-visually-hidden\">Loading content</span>\n  <div class=\"forma-skeleton__line forma-skeleton__line--title\"></div>\n  <div class=\"forma-skeleton__line\"></div>\n  <div class=\"forma-skeleton__line\"></div>\n  <div class=\"forma-skeleton__line forma-skeleton__line--short\"></div>\n</section>\n</forma-skeleton>",
      "attributes": [
        {
          "name": "aria-busy",
          "on": "section.forma-skeleton",
          "values": "true | false",
          "default": "—",
          "description": "Marks the region as loading. The shimmer runs only while it is true."
        },
        {
          "name": "aria-label",
          "on": "section.forma-skeleton",
          "values": "string",
          "default": "—",
          "description": "Names the busy region when no visible heading exists (\"Loading content\")."
        },
        {
          "name": "aria-labelledby",
          "on": "section.forma-skeleton",
          "values": "id of a visible heading",
          "default": "—",
          "description": "Names the region from a real heading when the heading is already known."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-skeleton",
          "elements": [
            "forma-skeleton__line"
          ],
          "modifiers": [
            "forma-skeleton__line--short",
            "forma-skeleton__line--title"
          ],
          "attributes": [
            {
              "name": "aria-busy",
              "values": [
                "true"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "—",
          "action": "A skeleton has no focusable content. Do not put interactive placeholders inside it."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "labelled-panel",
          "title": "Panel with a known heading",
          "mobile": false,
          "raw": "components/skeleton/labelled-panel.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "card-grid",
          "title": "Card grid loading",
          "mobile": false,
          "raw": "components/skeleton/card-grid.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "stalled-load",
          "title": "Stalled load with explanation",
          "mobile": false,
          "raw": "components/skeleton/stalled-load.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-message-list",
          "title": "Mobile message list",
          "mobile": true,
          "raw": "components/skeleton/mobile-message-list.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "spinner",
        "empty-state",
        "progress-bar"
      ]
    },
    {
      "slug": "skip-link",
      "title": "Skip link",
      "tag": "forma-skip-link",
      "category": "navigation",
      "behavior": "Native HTML",
      "summary": "First focusable link that jumps to main content; visually hidden until focused.",
      "docsUrl": "components/skip-link/",
      "pattern": "patterns/skip-link.html",
      "minimalHtml": "<forma-skip-link class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <a class=\"forma-skip-link\" href=\"#skip-link-main\">Skip to main content</a>\n  <main id=\"skip-link-main\" tabindex=\"-1\">\n    <h1>Account settings</h1>\n  </main>\n</div>\n</forma-skip-link>",
      "attributes": [
        {
          "name": "href",
          "on": "a.forma-skip-link",
          "values": "#id of the target",
          "default": "—",
          "description": "Fragment link to the main content (or another skip target). Native navigation moves focus there."
        },
        {
          "name": "tabindex",
          "on": "target",
          "values": "-1",
          "default": "—",
          "description": "Required on non-focusable targets such as main, so the browser can move focus to them without adding them to the Tab order."
        },
        {
          "name": "id",
          "on": "target",
          "values": "string",
          "default": "—",
          "description": "Unique fragment identifier referenced by the skip link."
        },
        {
          "name": "lang",
          "on": "shell or link",
          "values": "language tag",
          "default": "inherited",
          "description": "Declare the language when the skip link text differs from the page language."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-skip-link",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab (first press on the page)",
          "action": "Focuses the skip link and reveals it."
        },
        {
          "keys": "Enter",
          "action": "Follows the link: the browser scrolls to the target and moves focus to it (native)."
        },
        {
          "keys": "Tab after skipping",
          "action": "Continues from the first focusable element inside the target, bypassing the header."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "link",
            "name": "Skip to main content",
            "expect": {
              "url": "#skip-link-main"
            }
          }
        ]
      },
      "examples": [
        {
          "id": "before-site-header",
          "title": "Before a site header",
          "mobile": false,
          "raw": "components/skip-link/before-site-header.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Skip to main content",
                "expect": {
                  "url": "#skip-header-content"
                }
              },
              {
                "role": "link",
                "name": "Example / Docs",
                "expect": {
                  "url": "#skip-header-content"
                }
              },
              {
                "role": "link",
                "name": "Guides",
                "expect": {
                  "url": "#skip-header-content"
                }
              },
              {
                "role": "link",
                "name": "Reference",
                "expect": {
                  "url": "#skip-header-content"
                }
              },
              {
                "role": "link",
                "name": "Support",
                "expect": {
                  "url": "#skip-header-content"
                }
              }
            ]
          }
        },
        {
          "id": "multiple-targets",
          "title": "Main content and search targets",
          "mobile": false,
          "raw": "components/skip-link/multiple-targets.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Skip to main content",
                "expect": {
                  "url": "#skip-multi-content"
                }
              },
              {
                "role": "link",
                "name": "Skip to search",
                "expect": {
                  "url": "#skip-multi-search"
                }
              }
            ]
          }
        },
        {
          "id": "mobile-translated-label",
          "title": "Translated skip link on a phone",
          "mobile": true,
          "raw": "components/skip-link/mobile-translated-label.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Aller au contenu",
                "expect": {
                  "url": "#skip-mobile-content"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "marketing-shell",
        "site-header",
        "visually-hidden"
      ]
    },
    {
      "slug": "slider",
      "title": "Slider",
      "tag": "forma-slider",
      "category": "forms",
      "behavior": "Native HTML",
      "summary": "Single-value range input with accessible bounds and direct keyboard/pointer control.",
      "docsUrl": "components/slider/",
      "pattern": "patterns/slider.html",
      "minimalHtml": "<forma-slider class=\"forma-component-tag\">\n<label class=\"forma-slider\">\n  <span class=\"forma-slider__header\">\n    <span class=\"forma-slider__label\">Volume</span>\n  </span>\n  <input class=\"forma-slider__input\" type=\"range\" name=\"volume\" min=\"0\" max=\"100\" step=\"5\" value=\"25\">\n  <span class=\"forma-slider__bounds\" aria-hidden=\"true\">\n    <span>0</span>\n    <span>100</span>\n  </span>\n  <span class=\"forma-field__description\">Adjust the output level.</span>\n</label>\n</forma-slider>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "range",
          "default": "—",
          "description": "Required. Native range input."
        },
        {
          "name": "min",
          "on": "input",
          "values": "number",
          "default": "0",
          "description": "Lowest value."
        },
        {
          "name": "max",
          "on": "input",
          "values": "number",
          "default": "100",
          "description": "Highest value."
        },
        {
          "name": "step",
          "on": "input",
          "values": "number | any",
          "default": "1",
          "description": "Snap increment for pointer and keyboard."
        },
        {
          "name": "value",
          "on": "input",
          "values": "number",
          "default": "midpoint",
          "description": "Initial value."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Form field name."
        },
        {
          "name": "list",
          "on": "input",
          "values": "id of a datalist",
          "default": "—",
          "description": "Optional suggested values; many browsers draw tick marks for them."
        },
        {
          "name": "disabled",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Removes the slider from focus and submission and dims it."
        },
        {
          "name": "for",
          "on": "label.forma-slider__label",
          "values": "id of the input",
          "default": "—",
          "description": "Use with a wrapper root so a description can be linked with aria-describedby instead of joining the accessible name."
        },
        {
          "name": "aria-describedby",
          "on": "input",
          "values": "id of the description",
          "default": "—",
          "description": "Links explanatory text."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-slider__bounds",
          "values": "true",
          "default": "—",
          "description": "Hides the visual bound labels; the input already exposes its min and max."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-slider",
          "elements": [
            "forma-slider__bounds",
            "forma-slider__header",
            "forma-slider__input",
            "forma-slider__label"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "ArrowLeft / ArrowDown",
          "action": "Decreases by one step (native)."
        },
        {
          "keys": "ArrowRight / ArrowUp",
          "action": "Increases by one step (native)."
        },
        {
          "keys": "PageUp / PageDown",
          "action": "Changes by a larger increment in most browsers (native, browser-dependent)."
        },
        {
          "keys": "Home / End",
          "action": "Sets the minimum or maximum value (native)."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "named-stops",
          "title": "Alert sensitivity with tick marks",
          "mobile": false,
          "raw": "components/slider/named-stops.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "disabled-by-policy",
          "title": "Disabled by policy",
          "mobile": false,
          "raw": "components/slider/disabled-by-policy.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-brightness",
          "title": "Mobile display brightness",
          "mobile": true,
          "raw": "components/slider/mobile-brightness.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "numeric-stepper",
        "range-entry",
        "ordinal-scale",
        "allocation"
      ]
    },
    {
      "slug": "spatial-canvas",
      "title": "Spatial canvas",
      "tag": "forma-spatial-canvas",
      "category": "workflow",
      "behavior": "Application / Limen",
      "summary": "Provides a bounded spatial exploration surface with orientation and a non-spatial access path.",
      "docsUrl": "components/spatial-canvas/",
      "pattern": "patterns/spatial-canvas.html",
      "minimalHtml": "<forma-spatial-canvas class=\"forma-component-tag\">\n<section class=\"forma-spatial-canvas\" aria-labelledby=\"canvas-title\">\n  <header class=\"forma-spatial-canvas__header\">\n    <div><h2 id=\"canvas-title\">System map</h2><p class=\"forma-spatial-canvas__orientation\">Viewport: services / billing</p></div>\n    <div class=\"forma-cluster\" aria-label=\"Canvas controls\"><button type=\"button\">Zoom out</button><button type=\"button\">Reset view</button><button type=\"button\">Zoom in</button></div>\n  </header>\n  <div class=\"forma-spatial-canvas__viewport\" tabindex=\"0\" aria-label=\"Scrollable system map\">\n    <div class=\"forma-spatial-canvas__surface\">\n      <article class=\"forma-surface\" id=\"billing\"><h3>Billing</h3><p>Selected node</p></article>\n      <article class=\"forma-surface\" id=\"chrona\"><h3>Chrona</h3><p>Time source</p></article>\n    </div>\n  </div>\n  <details class=\"forma-spatial-canvas__index\"><summary>Objects in this view</summary><nav aria-label=\"Canvas objects\"><a href=\"#billing\">Billing</a><a href=\"#chrona\">Chrona</a></nav></details>\n</section>\n</forma-spatial-canvas>",
      "attributes": [
        {
          "name": "tabindex",
          "on": ".forma-spatial-canvas__viewport",
          "values": "0",
          "default": "—",
          "description": "Makes the scroll region focusable so it can be scrolled from the keyboard."
        },
        {
          "name": "role",
          "on": "viewport, control cluster",
          "values": "group",
          "default": "—",
          "description": "Gives the viewport and the control area a role so their accessible names are announced."
        },
        {
          "name": "aria-label",
          "on": "viewport, controls, index nav",
          "values": "string",
          "default": "—",
          "description": "Names the scroll region (say that it scrolls), the view controls and the object index."
        },
        {
          "name": "aria-labelledby",
          "on": "root section",
          "values": "id of the canvas heading",
          "default": "—",
          "description": "Names the whole canvas region."
        },
        {
          "name": "open",
          "on": "details.forma-spatial-canvas__index",
          "values": "boolean",
          "default": "absent",
          "description": "Initial open state of the object index. The browser owns it afterwards."
        },
        {
          "name": "aria-current",
          "on": "scope trail item",
          "values": "page",
          "default": "—",
          "description": "Marks the current scope when a [[scope-trail]] is composed in the header."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-spatial-canvas",
          "elements": [
            "forma-spatial-canvas__header",
            "forma-spatial-canvas__index",
            "forma-spatial-canvas__orientation",
            "forma-spatial-canvas__surface",
            "forma-spatial-canvas__viewport"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through view controls, the viewport, links or controls inside objects, then the index summary and links."
        },
        {
          "keys": "Arrow keys, Page Up / Page Down (viewport focused)",
          "action": "Scrolls the surface. Native scrolling of a focused overflow region."
        },
        {
          "keys": "Enter / Space on the index summary",
          "action": "Opens or closes the object index. Native details behavior."
        },
        {
          "keys": "Zoom and reset shortcuts",
          "action": "Not provided. The view buttons are native buttons; their effect and any shortcuts are application or Limen behavior."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "floor-plan-scope",
          "title": "Scoped view with a scope trail",
          "mobile": false,
          "raw": "components/spatial-canvas/floor-plan-scope.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior",
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "empty-region",
          "title": "Empty region",
          "mobile": false,
          "raw": "components/spatial-canvas/empty-region.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-index-first",
          "title": "Mobile map with object index",
          "mobile": true,
          "raw": "components/spatial-canvas/mobile-index-first.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "diagram",
        "scope-trail",
        "relationship-index",
        "bounded-overflow"
      ]
    },
    {
      "slug": "special-choice",
      "title": "Special choice",
      "tag": "forma-special-choice",
      "category": "assessment",
      "behavior": "Native HTML",
      "summary": "Unknown, not-applicable, and other non-scale answers visually separated from the primary continuum.",
      "docsUrl": "components/special-choice/",
      "pattern": "patterns/special-choice.html",
      "minimalHtml": "<forma-special-choice class=\"forma-component-tag\">\n<fieldset class=\"forma-special-choice-group\">\n  <legend class=\"forma-field__label\">Response status</legend>\n  <p class=\"forma-field__description\">Use these only when they are semantically different from the response scale.</p>\n\n  <div class=\"forma-special-choices\">\n    <label class=\"forma-special-choice\">\n      <input type=\"radio\" name=\"response-status\" value=\"unknown\">\n      <span>Don't know</span>\n    </label>\n    <label class=\"forma-special-choice\">\n      <input type=\"radio\" name=\"response-status\" value=\"na\">\n      <span>Not applicable</span>\n    </label>\n  </div>\n</fieldset>\n</forma-special-choice>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "radio",
          "default": "—",
          "description": "Radios, because special answers are mutually exclusive with each other and usually with the scale."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Share the primary question's name when the special answer replaces a scale answer; use a separate name only when both can coexist."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string such as unknown or na",
          "default": "—",
          "description": "Submitted value. The application decides how it affects scoring and completion."
        },
        {
          "name": "required",
          "on": "first input of the group",
          "values": "boolean",
          "default": "absent",
          "description": "Native required-group validation when the status must be given."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Restores a saved special answer."
        },
        {
          "name": "disabled",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Removes a special answer from focus and submission; explain why in text."
        },
        {
          "name": "aria-label",
          "on": ".forma-special-choices",
          "values": "string",
          "default": "—",
          "description": "Names the row when it sits inside a larger fieldset, for example Other responses."
        },
        {
          "name": "aria-describedby",
          "on": "fieldset",
          "values": "id list",
          "default": "—",
          "description": "Associates help text with the group."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-special-choice",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-special-choice-group",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-special-choices",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus into and out of the radio group the special answers belong to."
        },
        {
          "keys": "Arrow keys",
          "action": "Native radio behavior; when the name is shared, arrows move between scale positions and special answers in document order."
        },
        {
          "keys": "Space",
          "action": "Selects the focused answer when none is checked."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "with-choice-cards",
          "title": "Prefer not to say after choice cards",
          "mobile": false,
          "raw": "components/special-choice/with-choice-cards.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "not-applicable-selected",
          "title": "Not applicable selected",
          "mobile": false,
          "raw": "components/special-choice/not-applicable-selected.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-wrapping-pills",
          "title": "Several special answers on a phone",
          "mobile": true,
          "raw": "components/special-choice/mobile-wrapping-pills.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "ordinal-scale",
        "multi-choice",
        "choice-group"
      ]
    },
    {
      "slug": "spinner",
      "title": "Spinner",
      "tag": "forma-spinner",
      "category": "feedback",
      "behavior": "Application state",
      "summary": "Indeterminate activity with a visible label: constant-velocity cadence that stops when the application marks the activity idle, static under reduced motion.",
      "docsUrl": "components/spinner/",
      "pattern": "patterns/spinner.html",
      "minimalHtml": "<forma-spinner class=\"forma-component-tag\">\n<p class=\"forma-spinner\" role=\"status\">\n  <span class=\"forma-spinner__indicator\" aria-hidden=\"true\"></span>\n  <span class=\"forma-spinner__label\">Loading deployment history</span>\n</p>\n</forma-spinner>",
      "attributes": [
        {
          "name": "role",
          "on": "p.forma-spinner",
          "values": "status",
          "default": "—",
          "description": "Polite live region. Changes to the label are announced."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-spinner__indicator",
          "values": "true",
          "default": "—",
          "description": "Hides the decorative ring."
        },
        {
          "name": "aria-busy",
          "on": "the region being updated",
          "values": "true | false",
          "default": "—",
          "description": "Optional. Marks the container whose content is being replaced while the spinner runs."
        },
        {
          "name": "disabled",
          "on": "button",
          "values": "boolean",
          "default": "—",
          "description": "Optional. Prevents re-triggering the action that started the activity."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-spinner",
          "elements": [
            "forma-spinner__indicator"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-state",
              "values": [
                "idle"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "—",
          "action": "The spinner is not focusable and has no keyboard interaction. Any Cancel or Retry control is a separate native button."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "activity-finished",
          "title": "Activity finished",
          "mobile": false,
          "raw": "components/spinner/activity-finished.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "busy-region",
          "title": "Busy table region",
          "mobile": false,
          "raw": "components/spinner/busy-region.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "inline-with-action",
          "title": "Beside the action that started it",
          "mobile": false,
          "raw": "components/spinner/inline-with-action.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-long-label",
          "title": "Mobile long label",
          "mobile": true,
          "raw": "components/spinner/mobile-long-label.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "progress-bar",
        "skeleton",
        "operation-status"
      ]
    },
    {
      "slug": "split",
      "title": "Split",
      "tag": "forma-split",
      "category": "layout",
      "behavior": "Native CSS",
      "summary": "Marketing-layer two-part layout: a dominant primary region and a supporting region that wraps below when space runs out.",
      "docsUrl": "components/split/",
      "pattern": "patterns/split.html",
      "minimalHtml": "<forma-split class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <div class=\"forma-split\">\n    <div>\n      <h2>Install</h2>\n      <p>The primary region takes the available space. The supporting region wraps below it when the row runs out of room.</p>\n    </div>\n    <aside aria-label=\"Requirements\">\n      <h3>Requirements</h3>\n      <p>Node 22 or later.</p>\n    </aside>\n  </div>\n</div>\n</forma-split>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "article / aside",
          "values": "id of the region heading",
          "default": "—",
          "description": "Names each region by its heading."
        },
        {
          "name": "tabindex",
          "on": "pre.forma-code",
          "values": "0",
          "default": "—",
          "description": "Makes a scrollable code block keyboard-scrollable in the code sample example."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-split",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the primary region and then the supporting region, in source order."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "product-code-sample",
          "title": "Product explanation with a code sample",
          "mobile": false,
          "raw": "components/split/product-code-sample.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "narrative-with-facts",
          "title": "Narrative with key facts",
          "mobile": false,
          "raw": "components/split/narrative-with-facts.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-wrapped",
          "title": "Mobile wrapped split",
          "mobile": true,
          "raw": "components/split/mobile-wrapped.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "switcher",
        "hero",
        "split-pane",
        "container"
      ]
    },
    {
      "slug": "split-pane",
      "title": "Split pane",
      "tag": "forma-split-pane",
      "category": "workspaces",
      "behavior": "Application content",
      "summary": "Pairs related regions while preserving their semantic ownership and narrow-screen order.",
      "docsUrl": "components/split-pane/",
      "pattern": "patterns/split-pane.html",
      "minimalHtml": "<forma-split-pane class=\"forma-component-tag\">\n<section class=\"forma-split-pane\" aria-label=\"Inspector workspace\">\n  <main class=\"forma-split-pane__primary\"><h2>Working surface</h2><p>The primary task remains first in source order.</p></main>\n  <aside class=\"forma-split-pane__secondary\" aria-label=\"Inspector\"><h3>Inspector</h3><p>Contextual properties for the current selection.</p></aside>\n</section>\n</forma-split-pane>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "root section, aside",
          "values": "string",
          "default": "—",
          "description": "Names the split region and the secondary landmark when there is no visible heading to reference."
        },
        {
          "name": "aria-labelledby",
          "on": "child regions",
          "values": "id of the region heading",
          "default": "—",
          "description": "Names each region by its visible heading."
        },
        {
          "name": "style",
          "on": "root",
          "values": "custom property declarations",
          "default": "—",
          "description": "Where an application sets `--forma-split-primary`, `--forma-split-secondary` or `--forma-split-space` for one instance."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-split-pane",
          "elements": [
            "forma-split-pane__separator"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-collapsed",
              "values": []
            },
            {
              "name": "data-forma-manipulation",
              "values": [
                "resizing"
              ]
            },
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            },
            {
              "name": "data-forma-resizable",
              "values": []
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through focusable content in source order, primary region first. A fixed split adds no keyboard behavior."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "form-with-summary",
          "title": "Form beside its order summary",
          "mobile": false,
          "raw": "components/split-pane/form-with-summary.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "equal-comparison",
          "title": "Equal-width comparison",
          "mobile": false,
          "raw": "components/split-pane/equal-comparison.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-stacked",
          "title": "Mobile reading order",
          "mobile": true,
          "raw": "components/split-pane/mobile-stacked.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "resizable-split-pane",
        "sidebar",
        "switcher",
        "focus-stage",
        "workspace-shell"
      ]
    },
    {
      "slug": "stack",
      "title": "Stack",
      "tag": "forma-stack",
      "category": "layout",
      "behavior": "Native CSS",
      "summary": "Applies consistent vertical rhythm between semantic siblings.",
      "docsUrl": "components/stack/",
      "pattern": "patterns/stack.html",
      "minimalHtml": "<forma-stack class=\"forma-component-tag\">\n<section class=\"forma-stack\" aria-label=\"Stack composition\">\n  <header><h2>Section title</h2><p>Supporting context remains grouped with the heading.</p></header>\n  <article><h3>Primary content</h3><p>Stack owns only the vertical relationship between independent children.</p></article>\n  <footer><button type=\"button\">Continue</button></footer>\n</section>\n</forma-stack>",
      "attributes": [
        {
          "name": "data-density",
          "on": ".forma-stack",
          "values": "relaxed | standard | compact | analytical",
          "default": "absent (1rem gap)",
          "description": "Contextual density posture. Sets the stack gap to 1.5rem (relaxed), 1rem (standard) or 0.5rem (compact, analytical). It is not a data-forma-* hook and never changes semantics, order or target size."
        },
        {
          "name": "aria-labelledby",
          "on": "section / article / form",
          "values": "id of the group heading",
          "default": "—",
          "description": "Names a stacked region when the element is a landmark or a named group. The stack itself adds no role."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-stack",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-density",
              "values": []
            }
          ],
          "customProperties": [
            {
              "name": "--forma-stack-gap",
              "default": null
            },
            {
              "name": "--forma-stack-space",
              "default": "var(--forma-primitive-spacing-4, 1rem)"
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through focusable children in source order, which is also the visual order."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "settings-panel",
          "title": "Settings panel",
          "mobile": false,
          "raw": "components/stack/settings-panel.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "switch",
                "name": "Failed builds",
                "expect": {
                  "checked": false
                }
              },
              {
                "role": "switch",
                "name": "Mentions in review comments",
                "expect": {
                  "checked": true
                }
              }
            ]
          }
        },
        {
          "id": "compact-density",
          "title": "Compact density for an expert form",
          "mobile": false,
          "raw": "components/stack/compact-density.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "nested-grouping",
          "title": "Nested groups with relaxed outer rhythm",
          "mobile": false,
          "raw": "components/stack/nested-grouping.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-account-summary",
          "title": "Mobile account summary",
          "mobile": true,
          "raw": "components/stack/mobile-account-summary.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Manage billing",
                "expect": {
                  "url": "#stack-mobile-account-summary-title"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "cluster",
        "grid",
        "surface",
        "prose"
      ]
    },
    {
      "slug": "startup",
      "title": "Start-up screen",
      "tag": "forma-startup",
      "category": "feedback",
      "behavior": "Application state",
      "summary": "The first thing a script- or WebAssembly-driven application shows: its identity, indeterminate activity and a meaningful status, rendered from the initial HTML before any runtime exists, with slow, failed, timed-out and no-script states.",
      "docsUrl": "components/startup/",
      "pattern": "patterns/startup.html",
      "minimalHtml": "<forma-startup class=\"forma-component-tag\">\n<div class=\"forma-startup\" id=\"app-startup\" data-forma-state=\"starting\">\n  <span class=\"forma-app-identity\" data-forma-size=\"64\">\n    <span class=\"forma-app-identity__mark\">\n      <svg viewBox=\"0 0 32 32\" aria-hidden=\"true\" focusable=\"false\"><path fill=\"currentColor\" fill-rule=\"evenodd\" d=\"M6 0h20a6 6 0 0 1 6 6v20a6 6 0 0 1-6 6H6a6 6 0 0 1-6-6V6a6 6 0 0 1 6-6Zm10 8-8 14h16Z\"/></svg>\n    </span>\n    <span class=\"forma-app-identity__name\">Northwind Ledger</span>\n  </span>\n  <div class=\"forma-startup__status\" role=\"status\">\n    <p class=\"forma-spinner\">\n      <span class=\"forma-spinner__indicator\" aria-hidden=\"true\"></span>\n      <span class=\"forma-spinner__label\">Starting Northwind Ledger: preparing your workspace</span>\n    </p>\n    <p class=\"forma-startup__slow\">Still starting. A slow connection can take up to a minute.</p>\n  </div>\n  <div class=\"forma-startup__problem\" role=\"alert\">\n    <p class=\"forma-startup__problem-title\">Northwind Ledger could not start.</p>\n    <p>Your work is not affected. Reload the page to try again.</p>\n    <a class=\"forma-button\" href=\"\">Reload</a>\n  </div>\n  <p class=\"forma-startup__noscript\">Northwind Ledger needs JavaScript and WebAssembly. Turn them on in your browser settings, then reload this page.</p>\n</div>\n</forma-startup>",
      "attributes": [
        {
          "name": "data-forma-state",
          "on": ".forma-startup",
          "values": "starting | slow | failed | timed-out",
          "default": "starting",
          "description": "Set by the host page's loader. slow shows the slow-start note at once; failed and timed-out replace the status with the problem region."
        },
        {
          "name": "data-forma-extent",
          "on": ".forma-startup",
          "values": "region",
          "default": "absent (fills the viewport)",
          "description": "Sizes the screen to a 16rem region instead of the full viewport, for an embedded application or a documentation preview."
        },
        {
          "name": "role",
          "on": ".forma-startup__status",
          "values": "status",
          "default": "—",
          "description": "Polite live region that holds the activity sentence and the slow-start note."
        },
        {
          "name": "role",
          "on": ".forma-startup__problem",
          "values": "alert",
          "default": "—",
          "description": "Announces the failure or timeout when the host writes or reveals it."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-startup",
          "elements": [
            "forma-startup__noscript",
            "forma-startup__problem",
            "forma-startup__problem-title",
            "forma-startup__slow",
            "forma-startup__status"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-extent",
              "values": [
                "region"
              ]
            },
            {
              "name": "data-forma-state",
              "values": [
                "failed",
                "slow",
                "timed-out"
              ]
            },
            {
              "name": "hidden",
              "values": []
            }
          ],
          "customProperties": [
            {
              "name": "--forma-startup-slow-after",
              "default": "8s"
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab",
          "action": "Nothing is focusable while starting; focus is not trapped. In failed and timed-out states Tab reaches the recovery action."
        },
        {
          "keys": "Enter",
          "action": "Activates the recovery action."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "slow-start",
          "title": "Slow connection: still starting",
          "mobile": false,
          "raw": "components/startup/slow-start.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "failed-start",
          "title": "Runtime failed to load",
          "mobile": false,
          "raw": "components/startup/failed-start.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "timed-out-start",
          "title": "Start timed out",
          "mobile": false,
          "raw": "components/startup/timed-out-start.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-start",
          "title": "Phone start-up",
          "mobile": true,
          "raw": "components/startup/mobile-start.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "app-identity",
        "spinner",
        "fault-blocking",
        "skeleton"
      ]
    },
    {
      "slug": "state-survivability",
      "title": "State survivability",
      "tag": "forma-state-survivability",
      "category": "feedback",
      "behavior": "Ordo / application",
      "summary": "Projects explicit authoritative states with text and structural cues so unknown, stale, partial and unavailable do not collapse into one generic status.",
      "docsUrl": "components/state-survivability/",
      "pattern": "patterns/state-survivability.html",
      "minimalHtml": "<forma-state-survivability class=\"forma-component-tag\">\n<section class=\"forma-state-survivability\" aria-labelledby=\"state-survivability-title\">\n  <h3 id=\"state-survivability-title\">Authoritative state projection</h3>\n  <div class=\"forma-state-survivability__state\">\n    <span class=\"forma-status-lozenge\" data-state=\"unknown\">Unknown</span>\n    <p>Outcome has not been confirmed. Reconcile before retrying.</p>\n  </div>\n  <div class=\"forma-state-survivability__state\">\n    <span class=\"forma-status-lozenge\" data-state=\"attention\">Stale</span>\n    <p>The displayed evidence is older than the application freshness policy permits.</p>\n  </div>\n  <div class=\"forma-state-survivability__state\">\n    <span class=\"forma-status-lozenge\" data-state=\"attention\">Partial</span>\n    <p>Only the stated scope is complete. Omitted scope remains unresolved.</p>\n  </div>\n  <div class=\"forma-state-survivability__state\">\n    <span class=\"forma-status-lozenge\" data-state=\"blocked\">Unavailable</span>\n    <p>The application reports this capability is currently unavailable.</p>\n  </div>\n</section>\n</forma-state-survivability>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-state-survivability",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the region from its heading."
        },
        {
          "name": "data-state",
          "on": ".forma-status-lozenge",
          "values": "ok | attention | unknown | blocked",
          "default": "absent (neutral)",
          "description": "Glyph for each state's lozenge. The lozenge text must name the exact state."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-state-survivability",
          "elements": [
            "forma-state-survivability__state"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "—",
          "action": "No interactive content by default. Any links inside explanations follow native link behavior."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "import-scope",
          "title": "Import with scoped completeness",
          "mobile": false,
          "raw": "components/state-survivability/import-scope.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "control-verification",
          "title": "Control verification with insufficient data",
          "mobile": false,
          "raw": "components/state-survivability/control-verification.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-sync-states",
          "title": "Mobile sync states",
          "mobile": true,
          "raw": "components/state-survivability/mobile-sync-states.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "operation-status",
        "status-lozenge",
        "freshness",
        "security-state-matrix"
      ]
    },
    {
      "slug": "status-lozenge",
      "title": "Status lozenge",
      "tag": "forma-status-lozenge",
      "category": "feedback",
      "behavior": "Application state",
      "summary": "Compact textual state label with a shape glyph and border, so state never depends on color.",
      "docsUrl": "components/status-lozenge/",
      "pattern": "patterns/status-lozenge.html",
      "minimalHtml": "<forma-status-lozenge class=\"forma-component-tag\">\n<div class=\"forma-status-lozenge-set\" aria-label=\"Status examples\">\n  <span class=\"forma-status-lozenge\" data-state=\"ok\">Confirmed</span>\n  <span class=\"forma-status-lozenge\" data-state=\"attention\">Needs attention</span>\n  <span class=\"forma-status-lozenge\" data-state=\"unknown\">Unknown</span>\n  <span class=\"forma-status-lozenge\" data-state=\"blocked\">Blocked</span>\n</div>\n</forma-status-lozenge>",
      "attributes": [
        {
          "name": "data-state",
          "on": "span.forma-status-lozenge",
          "values": "ok | attention | unknown | blocked",
          "default": "absent (neutral bullet)",
          "description": "Selects the leading glyph. Presentation only; the text must name the state."
        },
        {
          "name": "role",
          "on": "div.forma-status-lozenge-set",
          "values": "group",
          "default": "—",
          "description": "Optional. Lets a set carry an accessible name when its purpose is not clear from surrounding headings."
        },
        {
          "name": "aria-label",
          "on": "div.forma-status-lozenge-set",
          "values": "string",
          "default": "—",
          "description": "Names the set. Use it together with a role such as group; a label on a plain div is ignored by many screen readers."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-status-lozenge",
          "elements": [],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-state",
              "values": [
                "attention",
                "blocked",
                "ok",
                "unknown"
              ]
            }
          ],
          "customProperties": []
        },
        {
          "root": "forma-status-lozenge-set",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "—",
          "action": "Not focusable or interactive."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "environment-table",
          "title": "Deployment environments",
          "mobile": false,
          "raw": "components/status-lozenge/environment-table.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "neutral-states",
          "title": "Neutral workflow states",
          "mobile": false,
          "raw": "components/status-lozenge/neutral-states.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-status-set",
          "title": "Mobile status set",
          "mobile": true,
          "raw": "components/status-lozenge/mobile-status-set.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "badge",
        "operation-status",
        "state-survivability",
        "diagnostic-status"
      ]
    },
    {
      "slug": "steps",
      "title": "Steps",
      "tag": "forma-steps",
      "category": "site",
      "behavior": "Site content",
      "summary": "Numbered method or process using CSS counters on a native ordered list.",
      "docsUrl": "components/steps/",
      "pattern": "patterns/steps.html",
      "minimalHtml": "<forma-steps class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <ol class=\"forma-steps\" role=\"list\" aria-label=\"Method\">\n    <li>Understand the domain and its constraints.</li>\n    <li>Identify recurring symptom patterns.</li>\n    <li>Trace the causal mechanism.</li>\n    <li>Deliver treatment and prevention.</li>\n  </ol>\n</div>\n</forma-steps>",
      "attributes": [
        {
          "name": "role",
          "on": "ol.forma-steps",
          "values": "list",
          "default": "—",
          "description": "Restores list semantics that some browsers drop when list-style is removed."
        },
        {
          "name": "aria-label",
          "on": "ol.forma-steps",
          "values": "string",
          "default": "—",
          "description": "Names the procedure when no visible heading introduces it directly."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-steps",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "—",
          "action": "Not interactive. Links placed inside a step follow native link behavior."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "install-procedure",
          "title": "Installation procedure with a code sample",
          "mobile": false,
          "raw": "components/steps/install-procedure.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "long-method",
          "title": "Ten-step method with long items",
          "mobile": false,
          "raw": "components/steps/long-method.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-method",
          "title": "Phone method",
          "mobile": true,
          "raw": "components/steps/mobile-method.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "wizard",
        "timeline",
        "entry-index",
        "code-sample"
      ]
    },
    {
      "slug": "surface",
      "title": "Surface",
      "tag": "forma-surface",
      "category": "layout",
      "behavior": "Native CSS",
      "summary": "A bounded panel with secondary surface tone, border and padding for grouping related content without inventing semantics.",
      "docsUrl": "components/surface/",
      "pattern": "patterns/surface.html",
      "minimalHtml": "<forma-surface class=\"forma-component-tag\">\n<section class=\"forma-surface\" aria-labelledby=\"surface-title\">\n  <h2 id=\"surface-title\">Billing contact</h2>\n  <p>Invoices are sent to the finance team on the first business day of each month.</p>\n</section>\n</forma-surface>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section / article",
          "values": "id of the panel heading",
          "default": "—",
          "description": "Names a surface that is a landmark or named region."
        },
        {
          "name": "aria-label",
          "on": "list",
          "values": "string",
          "default": "—",
          "description": "Names a list of surfaces."
        },
        {
          "name": "style",
          "on": ".forma-surface",
          "values": "--forma-surface-space: <length>",
          "default": "—",
          "description": "Per-instance padding override."
        },
        {
          "name": "data-density",
          "on": "surrounding .forma-stack",
          "values": "compact",
          "default": "—",
          "description": "Used on the stack that spaces surfaces in the dense list example; it does not change surface padding."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-surface",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": [
            {
              "name": "--forma-surface-accent-text-color",
              "default": "var(--forma-color-text-primary, #161616)"
            },
            {
              "name": "--forma-surface-space",
              "default": null
            }
          ]
        }
      ],
      "keyboard": [],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "billing-summary",
          "title": "Billing summary panel",
          "mobile": false,
          "raw": "components/surface/billing-summary.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "compact-padding",
          "title": "Compact panels in a dense list",
          "mobile": false,
          "raw": "components/surface/compact-padding.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "nested-content",
          "title": "Empty state inside a surface",
          "mobile": false,
          "raw": "components/surface/nested-content.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-panel",
          "title": "Mobile panel",
          "mobile": true,
          "raw": "components/surface/mobile-panel.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "card-grid",
        "callout",
        "preview-surface",
        "stack"
      ]
    },
    {
      "slug": "survey-progress",
      "title": "Survey progress",
      "tag": "forma-survey-progress",
      "category": "assessment",
      "behavior": "Native HTML",
      "summary": "Determinate progress using the native progress element plus explicit current/total text.",
      "docsUrl": "components/survey-progress/",
      "pattern": "patterns/survey-progress.html",
      "minimalHtml": "<forma-survey-progress class=\"forma-component-tag\">\n<div class=\"forma-survey-progress\">\n  <div class=\"forma-survey-progress__header\">\n    <span class=\"forma-survey-progress__label\" id=\"survey-progress-label\">Survey progress</span>\n    <span class=\"forma-survey-progress__value\">Question 3 of 12</span>\n  </div>\n  <progress class=\"forma-survey-progress__bar\" value=\"3\" max=\"12\" aria-labelledby=\"survey-progress-label\">25%</progress>\n  <p class=\"forma-survey-progress__context\">Section 1 of 4 · Governance</p>\n</div>\n</forma-survey-progress>",
      "attributes": [
        {
          "name": "value",
          "on": "progress",
          "values": "number",
          "default": "—",
          "description": "Current position supplied by the application."
        },
        {
          "name": "max",
          "on": "progress",
          "values": "number",
          "default": "1",
          "description": "Total supplied by the application; update it when branching changes the total."
        },
        {
          "name": "aria-labelledby",
          "on": "progress",
          "values": "id of .forma-survey-progress__label",
          "default": "—",
          "description": "Gives the bar its accessible name."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-survey-progress",
          "elements": [
            "forma-survey-progress__bar",
            "forma-survey-progress__context",
            "forma-survey-progress__header",
            "forma-survey-progress__label",
            "forma-survey-progress__value"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "None",
          "action": "Not interactive and not focusable."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "page-based",
          "title": "Page-based progress after branching",
          "mobile": false,
          "raw": "components/survey-progress/page-based.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "all-answered",
          "title": "All questions answered",
          "mobile": false,
          "raw": "components/survey-progress/all-answered.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-wrapping-header",
          "title": "Long section name on a phone",
          "mobile": true,
          "raw": "components/survey-progress/mobile-wrapping-header.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "progress-bar",
        "wizard",
        "question"
      ]
    },
    {
      "slug": "switch",
      "title": "Switch",
      "tag": "forma-switch",
      "category": "forms",
      "behavior": "Native HTML",
      "summary": "A checkbox-backed on/off preference control with role=switch and a visible track/thumb treatment.",
      "docsUrl": "components/switch/",
      "pattern": "patterns/switch.html",
      "minimalHtml": "<forma-switch class=\"forma-component-tag\">\n<label class=\"forma-switch\" data-forma-motion-weight=\"standard\">\n  <input\n    class=\"forma-switch__input\"\n    type=\"checkbox\"\n    role=\"switch\"\n    name=\"notifications\"\n    value=\"enabled\"\n    aria-describedby=\"notifications-description\">\n  <span class=\"forma-switch__track\" aria-hidden=\"true\"></span>\n  <span class=\"forma-switch__text\">\n    <span class=\"forma-switch__label\">Notifications</span>\n    <span class=\"forma-switch__description\" id=\"notifications-description\">Receive operational updates.</span>\n  </span>\n</label>\n</forma-switch>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "checkbox",
          "default": "—",
          "description": "Required. The switch is a native checkbox; do not substitute a button or div."
        },
        {
          "name": "role",
          "on": "input",
          "values": "switch",
          "default": "—",
          "description": "Required. Announces on/off semantics instead of checked/not checked."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent (off)",
          "description": "Initial on state. The live state is the input's checked property, owned by the browser."
        },
        {
          "name": "disabled",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Removes the switch from focus order and form submission and dims the row."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Form field name. Only submitted while the switch is on."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "\"on\"",
          "description": "Submitted value when on."
        },
        {
          "name": "aria-describedby",
          "on": "input",
          "values": "id of .forma-switch__description",
          "default": "—",
          "description": "Links the supporting description so it is announced after the label."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-switch",
          "elements": [
            "forma-switch__description",
            "forma-switch__input",
            "forma-switch__label",
            "forma-switch__text",
            "forma-switch__track"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": [
            {
              "name": "--forma-switch-gap",
              "default": "0.1875rem"
            },
            {
              "name": "--forma-switch-height",
              "default": "1.5rem"
            },
            {
              "name": "--forma-switch-thumb",
              "default": "1.125rem"
            },
            {
              "name": "--forma-switch-width",
              "default": "2.75rem"
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus to and from the switch (skipped when disabled)."
        },
        {
          "keys": "Space",
          "action": "Toggles the switch. Native checkbox behavior; Enter does not toggle."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "switch",
            "name": "Notifications Receive operational updates.",
            "expect": {
              "checked": true
            }
          }
        ]
      },
      "examples": [
        {
          "id": "notification-preferences",
          "title": "Notification preferences",
          "mobile": false,
          "raw": "components/switch/notification-preferences.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "switch",
                "name": "Deployment results Email me when a deployment I started finishes or fails.",
                "expect": {
                  "checked": false
                }
              },
              {
                "role": "switch",
                "name": "Weekly digest A Monday summary of activity across all projects.",
                "expect": {
                  "checked": true
                }
              }
            ]
          }
        },
        {
          "id": "disabled-by-policy",
          "title": "Disabled by policy",
          "mobile": false,
          "raw": "components/switch/disabled-by-policy.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "motion-weight-and-long-label",
          "title": "Heavy motion weight with a long label",
          "mobile": false,
          "raw": "components/switch/motion-weight-and-long-label.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "switch",
                "name": "Synchronisation automatique des archives de projets partagés entre tous les espaces de travail",
                "expect": {
                  "checked": true
                }
              }
            ]
          }
        },
        {
          "id": "mobile-settings-list",
          "title": "Mobile settings list",
          "mobile": true,
          "raw": "components/switch/mobile-settings-list.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "switch",
                "name": "Share location with my team",
                "expect": {
                  "checked": false
                }
              },
              {
                "role": "switch",
                "name": "Show when I'm active Colleagues see a presence dot next to your name.",
                "expect": {
                  "checked": true
                }
              },
              {
                "role": "switch",
                "name": "Send anonymous usage analytics",
                "expect": {
                  "checked": true
                }
              }
            ]
          }
        }
      ],
      "related": [
        "checkbox",
        "binary-choice",
        "segmented-control",
        "multi-choice"
      ]
    },
    {
      "slug": "switcher",
      "title": "Switcher",
      "tag": "forma-switcher",
      "category": "layout",
      "behavior": "Native CSS",
      "summary": "Keeps related regions side by side when space permits and stacks them without semantic reordering.",
      "docsUrl": "components/switcher/",
      "pattern": "patterns/switcher.html",
      "minimalHtml": "<forma-switcher class=\"forma-component-tag\">\n<section class=\"forma-switcher\" aria-label=\"Narrative and supporting material\">\n  <article class=\"forma-switcher__primary\"><h2>Primary narrative</h2><p>The main content owns most available width.</p></article>\n  <aside class=\"forma-switcher__secondary\" aria-label=\"Supporting material\"><h2>Supporting material</h2><p>Secondary content remains adjacent when space permits.</p></aside>\n</section>\n</forma-switcher>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "regions",
          "values": "id of the region heading",
          "default": "—",
          "description": "Names each region by its visible heading."
        },
        {
          "name": "aria-label",
          "on": ".forma-switcher",
          "values": "string",
          "default": "—",
          "description": "Names the pair when the switcher element is a section."
        },
        {
          "name": "style",
          "on": ".forma-switcher",
          "values": "--forma-switcher-space: <length>",
          "default": "—",
          "description": "Per-instance gap override."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-switcher",
          "elements": [
            "forma-switcher__primary",
            "forma-switcher__secondary"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": [
            {
              "name": "--forma-switcher-space",
              "default": "var(--forma-primitive-spacing-5, 1.5rem)"
            },
            {
              "name": "--forma-switcher-threshold",
              "default": "42rem"
            }
          ]
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the primary region, then the secondary, in source order."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "form-with-help",
          "title": "Form with help text",
          "mobile": false,
          "raw": "components/switcher/form-with-help.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "comparison-before-after",
          "title": "Before and after comparison",
          "mobile": false,
          "raw": "components/switcher/comparison-before-after.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-stacked",
          "title": "Mobile stacked regions",
          "mobile": true,
          "raw": "components/switcher/mobile-stacked.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "sidebar",
        "rail",
        "split",
        "cluster"
      ]
    },
    {
      "slug": "symbol-rating",
      "title": "Symbol rating",
      "tag": "forma-symbol-rating",
      "category": "assessment",
      "behavior": "Native HTML",
      "summary": "Ordinal rating presented with symbols while retaining accessible textual labels.",
      "docsUrl": "components/symbol-rating/",
      "pattern": "patterns/symbol-rating.html",
      "minimalHtml": "<forma-symbol-rating class=\"forma-component-tag\">\n<fieldset class=\"forma-symbol-rating\">\n  <legend class=\"forma-symbol-rating__legend\">How satisfied are you with the release process?</legend>\n\n  <div class=\"forma-symbol-rating__options\">\n    <label class=\"forma-symbol-rating__option\">\n      <input type=\"radio\" name=\"release-satisfaction\" value=\"1\" required>\n      <span class=\"forma-symbol-rating__symbol\" aria-hidden=\"true\">★</span>\n      <span class=\"forma-sr-only\">1 of 5, very dissatisfied</span>\n    </label>\n    <label class=\"forma-symbol-rating__option\">\n      <input type=\"radio\" name=\"release-satisfaction\" value=\"2\">\n      <span class=\"forma-symbol-rating__symbol\" aria-hidden=\"true\">★</span>\n      <span class=\"forma-sr-only\">2 of 5, dissatisfied</span>\n    </label>\n    <label class=\"forma-symbol-rating__option\">\n      <input type=\"radio\" name=\"release-satisfaction\" value=\"3\">\n      <span class=\"forma-symbol-rating__symbol\" aria-hidden=\"true\">★</span>\n      <span class=\"forma-sr-only\">3 of 5, neutral</span>\n    </label>\n    <label class=\"forma-symbol-rating__option\">\n      <input type=\"radio\" name=\"release-satisfaction\" value=\"4\">\n      <span class=\"forma-symbol-rating__symbol\" aria-hidden=\"true\">★</span>\n      <span class=\"forma-sr-only\">4 of 5, satisfied</span>\n    </label>\n    <label class=\"forma-symbol-rating__option\">\n      <input type=\"radio\" name=\"release-satisfaction\" value=\"5\">\n      <span class=\"forma-symbol-rating__symbol\" aria-hidden=\"true\">★</span>\n      <span class=\"forma-sr-only\">5 of 5, very satisfied</span>\n    </label>\n  </div>\n</fieldset>\n</forma-symbol-rating>",
      "attributes": [
        {
          "name": "type",
          "on": "input",
          "values": "radio",
          "default": "—",
          "description": "Required. One radio per symbol."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Groups the symbols into one answer. Unique per question."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Submitted rating. Meaning and scoring stay in the application."
        },
        {
          "name": "required",
          "on": "first input",
          "values": "boolean",
          "default": "absent",
          "description": "Native required-group validation."
        },
        {
          "name": "checked",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Restores a saved rating."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-symbol-rating__symbol",
          "values": "true",
          "default": "—",
          "description": "Required. The glyph is decorative and must not be the accessible name."
        },
        {
          "name": "aria-describedby",
          "on": "fieldset",
          "values": "id list",
          "default": "—",
          "description": "Associates a key or help text with the rating."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-symbol-rating",
          "elements": [
            "forma-symbol-rating__legend",
            "forma-symbol-rating__option",
            "forma-symbol-rating__options",
            "forma-symbol-rating__symbol"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus into and out of the group."
        },
        {
          "keys": "Arrow keys",
          "action": "Native radio behavior: moves to and selects the adjacent rating."
        },
        {
          "keys": "Space",
          "action": "Selects the focused rating when none is checked."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "saved-four-stars",
          "title": "Saved four-star rating",
          "mobile": false,
          "raw": "components/symbol-rating/saved-four-stars.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "effort-icons",
          "title": "Three-level effort rating with a visible key",
          "mobile": false,
          "raw": "components/symbol-rating/effort-icons.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-ten-point",
          "title": "Ten-point rating wrapping on a phone",
          "mobile": true,
          "raw": "components/symbol-rating/mobile-ten-point.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "ordinal-scale",
        "image-choice",
        "semantic-differential"
      ]
    },
    {
      "slug": "tabs",
      "title": "Tabs",
      "tag": "forma-tabs",
      "category": "navigation",
      "behavior": "Application / Limen",
      "summary": "Focused views with keyboard and deep-link integration hooks plus mobile overflow strategy.",
      "docsUrl": "components/tabs/",
      "pattern": "patterns/tabs.html",
      "minimalHtml": "<forma-tabs class=\"forma-component-tag\">\n<section class=\"forma-tabs\" data-forma-motion-weight=\"light\">\n  <div class=\"forma-tabs__list\" role=\"tablist\" aria-label=\"Record sections\">\n    <button type=\"button\" role=\"tab\" id=\"tab-overview\" aria-selected=\"true\" aria-controls=\"panel-overview\">Overview</button>\n    <button type=\"button\" role=\"tab\" id=\"tab-history\" aria-selected=\"false\" aria-controls=\"panel-history\">History</button>\n    <button type=\"button\" role=\"tab\" id=\"tab-evidence\" aria-selected=\"false\" aria-controls=\"panel-evidence\">Evidence</button>\n  </div>\n  <section class=\"forma-tabs__panel\" id=\"panel-overview\" role=\"tabpanel\" aria-labelledby=\"tab-overview\">\n    <h3>Overview</h3>\n    <p>Current record summary and legal actions supplied by the application.</p>\n  </section>\n</section>\n</forma-tabs>",
      "attributes": [
        {
          "name": "role",
          "on": "list, buttons, panels",
          "values": "tablist | tab | tabpanel",
          "default": "—",
          "description": "Required ARIA tabs roles. Forma's selectors target [role=\"tab\"] inside the list."
        },
        {
          "name": "aria-selected",
          "on": "tab",
          "values": "true | false",
          "default": "—",
          "description": "Set by the application. Forma draws the selected treatment from aria-selected=\"true\"."
        },
        {
          "name": "aria-controls",
          "on": "tab",
          "values": "id of its panel",
          "default": "—",
          "description": "Links each tab to its panel. Every referenced panel must exist in the DOM."
        },
        {
          "name": "aria-labelledby",
          "on": "tabpanel",
          "values": "id of its tab",
          "default": "—",
          "description": "Names the panel after its tab."
        },
        {
          "name": "aria-label",
          "on": "tablist",
          "values": "string",
          "default": "—",
          "description": "Names the set of tabs."
        },
        {
          "name": "tabindex",
          "on": "tab",
          "values": "-1 on unselected tabs",
          "default": "0 (native button)",
          "description": "Roving tab stop written by the application so Tab enters the list once, at the selected tab."
        },
        {
          "name": "hidden",
          "on": "tabpanel",
          "values": "boolean",
          "default": "absent",
          "description": "Hides inactive panels. The application toggles it with selection."
        },
        {
          "name": "type",
          "on": "tab",
          "values": "button",
          "default": "—",
          "description": "Prevents tabs inside a form from submitting it."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-tabs",
          "elements": [
            "forma-tabs__list",
            "forma-tabs__panel"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-entry",
              "values": []
            },
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Native: moves focus to and from the tab list. With application roving tabindex, only the selected tab is a stop; then Tab moves into the panel."
        },
        {
          "keys": "Enter / Space",
          "action": "Native button activation. The application selects the focused tab in response."
        },
        {
          "keys": "Left / Right Arrow, Home, End",
          "action": "Not native. The application must move focus between tabs and, for automatic activation, select on focus."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "history-selected",
          "title": "Second tab selected with roving focus",
          "mobile": false,
          "raw": "components/tabs/history-selected.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "overflowing-tabs",
          "title": "Many tabs overflowing the list",
          "mobile": false,
          "raw": "components/tabs/overflowing-tabs.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-scrolling-list",
          "title": "Tabs on a phone",
          "mobile": true,
          "raw": "components/tabs/mobile-scrolling-list.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "segmented-control",
        "navigation-shell",
        "wizard",
        "disclosure"
      ]
    },
    {
      "slug": "text-field",
      "title": "Text field",
      "tag": "forma-text-field",
      "category": "forms",
      "behavior": "Native HTML",
      "summary": "A labelled native text-like input (text, email, password, URL, tel, number) with optional description, using the .forma-field label/description structure.",
      "docsUrl": "components/text-field/",
      "pattern": "patterns/text-field.html",
      "minimalHtml": "<forma-text-field class=\"forma-component-tag\">\n<div class=\"forma-field\">\n  <label class=\"forma-field__label\" for=\"text-field-email\">Work email</label>\n  <span class=\"forma-field__description\" id=\"text-field-email-description\">We send sign-in links to this address.</span>\n  <input id=\"text-field-email\" name=\"email\" type=\"email\" autocomplete=\"email\" aria-describedby=\"text-field-email-description\" required>\n</div>\n</forma-text-field>",
      "attributes": [
        {
          "name": "for",
          "on": "label.forma-field__label",
          "values": "id of the input",
          "default": "—",
          "description": "Associates the visible label with the input so it becomes the accessible name and clicking the label focuses the field."
        },
        {
          "name": "type",
          "on": "input",
          "values": "text | email | password | url | tel | number",
          "default": "text",
          "description": "Chooses native validation, on-screen keyboard and autofill behavior. Use date/time types through [[date-time-field]]."
        },
        {
          "name": "name",
          "on": "input",
          "values": "string",
          "default": "—",
          "description": "Form field name used on submission."
        },
        {
          "name": "value",
          "on": "input",
          "values": "string",
          "default": "empty",
          "description": "Initial value; the live value is owned by the browser."
        },
        {
          "name": "autocomplete",
          "on": "input",
          "values": "email | username | current-password | name | tel | …",
          "default": "browser heuristic",
          "description": "Tells the browser and password managers what the field holds so they can offer saved values."
        },
        {
          "name": "required",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Native constraint: the form will not submit while the field is empty."
        },
        {
          "name": "minlength",
          "on": "input",
          "values": "integer",
          "default": "—",
          "description": "Native minimum length constraint for text-like types."
        },
        {
          "name": "min",
          "on": "input",
          "values": "number",
          "default": "—",
          "description": "Lower bound for type=number."
        },
        {
          "name": "max",
          "on": "input",
          "values": "number",
          "default": "—",
          "description": "Upper bound for type=number."
        },
        {
          "name": "step",
          "on": "input",
          "values": "number | any",
          "default": "1",
          "description": "Allowed increment for type=number; also the amount ArrowUp/ArrowDown change the value."
        },
        {
          "name": "inputmode",
          "on": "input",
          "values": "url | numeric | decimal | tel | email | …",
          "default": "from type",
          "description": "Keyboard hint for touch devices when the type alone does not select the right keyboard."
        },
        {
          "name": "spellcheck",
          "on": "input",
          "values": "false",
          "default": "browser default",
          "description": "Turns off spelling marks for identifiers and addresses."
        },
        {
          "name": "readonly",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "The value can be focused, selected and copied, and is submitted, but cannot be edited."
        },
        {
          "name": "disabled",
          "on": "input",
          "values": "boolean",
          "default": "absent",
          "description": "Removes the field from focus order and from form submission."
        },
        {
          "name": "aria-describedby",
          "on": "input",
          "values": "id list",
          "default": "—",
          "description": "Links the `.forma-field__description` and, when present, a validation message, in reading order."
        },
        {
          "name": "aria-invalid",
          "on": "input",
          "values": "true",
          "default": "absent",
          "description": "Set by the application when a submitted or checked value is rejected, together with a linked [[validation-message]]."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-field",
          "elements": [
            "forma-field__description",
            "forma-field__label"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus to and from the input. Disabled inputs are skipped; read-only inputs are focusable."
        },
        {
          "keys": "ArrowUp / ArrowDown",
          "action": "On type=number, increments or decrements by step within min and max (native behavior)."
        },
        {
          "keys": "Enter",
          "action": "Submits the owning form through native implicit submission."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "sign-in-credentials",
          "title": "Sign-in credentials",
          "mobile": false,
          "raw": "components/text-field/sign-in-credentials.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "validation-error",
          "title": "Validation error",
          "mobile": false,
          "raw": "components/text-field/validation-error.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "read-only-and-disabled",
          "title": "Read-only and disabled values",
          "mobile": false,
          "raw": "components/text-field/read-only-and-disabled.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "numeric-and-phone",
          "title": "Quantity and phone number",
          "mobile": false,
          "raw": "components/text-field/numeric-and-phone.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-contact-details",
          "title": "Mobile contact details",
          "mobile": true,
          "raw": "components/text-field/mobile-contact-details.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "textarea",
        "date-time-field",
        "numeric-stepper",
        "search",
        "validation-message"
      ]
    },
    {
      "slug": "text-roles",
      "title": "Text roles",
      "tag": "forma-text-roles",
      "category": "utilities",
      "behavior": "Native CSS",
      "summary": "Eyebrow, lead, statement and component kicker text roles that express hierarchy through type, not new semantics.",
      "docsUrl": "components/text-roles/",
      "pattern": "patterns/text-roles.html",
      "minimalHtml": "<forma-text-roles class=\"forma-component-tag\">\n<div class=\"forma-site\">\n  <p class=\"forma-eyebrow\">Release 0.3</p>\n  <h2>Faster onboarding for new teams</h2>\n  <p class=\"forma-lead\">A lead paragraph introduces the section in one or two sentences.</p>\n  <blockquote class=\"forma-statement\"><p>Forma keeps behavior in the application and presentation in the design system.</p></blockquote>\n  <span class=\"forma-component-kicker\">Component kicker</span>\n</div>\n</forma-text-roles>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section / article",
          "values": "id of the heading",
          "default": "—",
          "description": "Names the region by its heading, not by the eyebrow or kicker."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-eyebrow",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-lead",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-statement",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-component-kicker",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "None",
          "action": "Text roles are not interactive and add no keyboard behavior."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "section-introduction",
          "title": "Section introduction",
          "mobile": false,
          "raw": "components/text-roles/section-introduction.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "pull-statement",
          "title": "Pull statement in an article",
          "mobile": false,
          "raw": "components/text-roles/pull-statement.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "application-kicker",
          "title": "Kicker on an application panel",
          "mobile": false,
          "raw": "components/text-roles/application-kicker.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-hero-introduction",
          "title": "Hero introduction on a phone",
          "mobile": true,
          "raw": "components/text-roles/mobile-hero-introduction.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "section-heading",
        "hero",
        "prose",
        "callout"
      ]
    },
    {
      "slug": "textarea",
      "title": "Textarea",
      "tag": "forma-textarea",
      "category": "forms",
      "behavior": "Native HTML",
      "summary": "Multi-line native text entry with a visible label and description in the .forma-field structure; the browser owns resizing and form participation.",
      "docsUrl": "components/textarea/",
      "pattern": "patterns/textarea.html",
      "minimalHtml": "<forma-textarea class=\"forma-component-tag\">\n<div class=\"forma-field\">\n  <label class=\"forma-field__label\" for=\"textarea-summary\">Change summary</label>\n  <span class=\"forma-field__description\" id=\"textarea-summary-description\">Describe what changed and why. Plain text, up to 500 characters.</span>\n  <textarea id=\"textarea-summary\" name=\"summary\" rows=\"4\" maxlength=\"500\" aria-describedby=\"textarea-summary-description\"></textarea>\n</div>\n</forma-textarea>",
      "attributes": [
        {
          "name": "for",
          "on": "label.forma-field__label",
          "values": "id of the textarea",
          "default": "—",
          "description": "Associates the visible label so it is the accessible name."
        },
        {
          "name": "name",
          "on": "textarea",
          "values": "string",
          "default": "—",
          "description": "Form field name used on submission."
        },
        {
          "name": "rows",
          "on": "textarea",
          "values": "integer",
          "default": "2 (browser default)",
          "description": "Initial visible line count; sets the starting height."
        },
        {
          "name": "maxlength",
          "on": "textarea",
          "values": "integer",
          "default": "—",
          "description": "Native hard limit; the browser stops input at the limit without an error, so state the limit in the description."
        },
        {
          "name": "required",
          "on": "textarea",
          "values": "boolean",
          "default": "absent",
          "description": "Native constraint: the form will not submit while empty."
        },
        {
          "name": "readonly",
          "on": "textarea",
          "values": "boolean",
          "default": "absent",
          "description": "Focusable, selectable and submitted, but not editable."
        },
        {
          "name": "spellcheck",
          "on": "textarea",
          "values": "true | false",
          "default": "browser default",
          "description": "Turns spelling marks on or off."
        },
        {
          "name": "aria-describedby",
          "on": "textarea",
          "values": "id list",
          "default": "—",
          "description": "Links the description and any validation message."
        },
        {
          "name": "aria-invalid",
          "on": "textarea",
          "values": "true",
          "default": "absent",
          "description": "Set by the application while a linked validation message is shown."
        }
      ],
      "cssHooks": [],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus into and out of the textarea. Tab never inserts a tab character."
        },
        {
          "keys": "Enter",
          "action": "Inserts a line break. It does not submit the form."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "rejection-reason",
          "title": "Required rejection reason",
          "mobile": false,
          "raw": "components/textarea/rejection-reason.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "read-only-incident-note",
          "title": "Read-only incident note",
          "mobile": false,
          "raw": "components/textarea/read-only-incident-note.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "short-limited-bio",
          "title": "Short profile bio with a limit",
          "mobile": false,
          "raw": "components/textarea/short-limited-bio.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-feedback",
          "title": "Mobile feedback form",
          "mobile": true,
          "raw": "components/textarea/mobile-feedback.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        }
      ],
      "related": [
        "text-field",
        "composer",
        "validation-message"
      ]
    },
    {
      "slug": "timeline",
      "title": "Timeline",
      "tag": "forma-timeline",
      "category": "data",
      "behavior": "Application content",
      "summary": "Chronological or ordered activity with timestamps, state changes, provenance, and single-column mobile flow.",
      "docsUrl": "components/timeline/",
      "pattern": "patterns/timeline.html",
      "minimalHtml": "<forma-timeline class=\"forma-component-tag\">\n<ol class=\"forma-timeline\" aria-label=\"Activity history\">\n  <li class=\"forma-timeline__item\">\n    <div class=\"forma-timeline__marker\" aria-hidden=\"true\"></div>\n    <div class=\"forma-timeline__content\">\n      <div class=\"forma-timeline__meta\"><time datetime=\"2026-09-22T14:10:00Z\">Sep 22 · 14:10</time><span class=\"forma-status-lozenge\" data-state=\"ok\">Confirmed</span></div>\n      <h3>Invoice issued</h3>\n      <p>Invoice INV-1042 was issued after review.</p>\n      <small>Source: billing workflow</small>\n    </div>\n  </li>\n  <li class=\"forma-timeline__item\">\n    <div class=\"forma-timeline__marker\" aria-hidden=\"true\"></div>\n    <div class=\"forma-timeline__content\">\n      <div class=\"forma-timeline__meta\"><time datetime=\"2026-09-21T19:32:00Z\">Sep 21 · 19:32</time><span class=\"forma-status-lozenge\">Draft</span></div>\n      <h3>Draft updated</h3>\n      <p>Payment terms and line descriptions changed.</p>\n    </div>\n  </li>\n</ol>\n</forma-timeline>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "ol.forma-timeline",
          "values": "string",
          "default": "—",
          "description": "Names the history, for example \"Payment PAY-88122 history\"."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-timeline__marker",
          "values": "true",
          "default": "—",
          "description": "The marker is decorative; hide it from assistive technology."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO date-time",
          "default": "—",
          "description": "Machine-readable event time; the visible text can be relative or abbreviated."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-timeline",
          "elements": [
            "forma-timeline__content",
            "forma-timeline__item",
            "forma-timeline__marker",
            "forma-timeline__meta"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab",
          "action": "Reaches links, buttons or disclosure summaries inside events. The timeline itself is not focusable."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "unknown-outcome",
          "title": "History with an unknown outcome",
          "mobile": false,
          "raw": "components/timeline/unknown-outcome.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "expandable-detail",
          "title": "Event with expandable detail",
          "mobile": false,
          "raw": "components/timeline/expandable-detail.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "disclosure",
                "name": "Show changed fields",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        },
        {
          "id": "mobile-activity",
          "title": "Mobile activity history",
          "mobile": true,
          "raw": "components/timeline/mobile-activity.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "feed-item",
        "provenance-trail",
        "steps",
        "diff-viewer"
      ]
    },
    {
      "slug": "toast",
      "title": "Toast",
      "tag": "forma-toast",
      "category": "feedback",
      "behavior": "Native HTML",
      "summary": "A Popover-backed transient notification with standard perceived weight and reciprocal dismissal.",
      "docsUrl": "components/toast/",
      "pattern": "patterns/toast.html",
      "minimalHtml": "<forma-toast class=\"forma-component-tag\">\n<button type=\"button\" popovertarget=\"save-notification\" popovertargetaction=\"show\">Show notification</button>\n<aside class=\"forma-toast\" id=\"save-notification\" popover=\"manual\" role=\"status\" data-forma-motion-weight=\"standard\">\n  <div class=\"forma-toast__header\">\n    <div>\n      <h3 class=\"forma-toast__title\">Changes saved</h3>\n      <p>The current draft is stored.</p>\n    </div>\n    <button type=\"button\" popovertarget=\"save-notification\" popovertargetaction=\"hide\" aria-label=\"Dismiss notification\">Close</button>\n  </div>\n</aside>\n</forma-toast>",
      "attributes": [
        {
          "name": "popover",
          "on": "aside.forma-toast",
          "values": "manual",
          "default": "—",
          "description": "Required. Makes the toast a native manual popover: hidden by default, shown in the top layer, and never light-dismissed."
        },
        {
          "name": "id",
          "on": "aside.forma-toast",
          "values": "unique id",
          "default": "—",
          "description": "Target for invoker buttons."
        },
        {
          "name": "popovertarget",
          "on": "button",
          "values": "id of the toast",
          "default": "—",
          "description": "Native invoker. Shows, hides or toggles the toast without script."
        },
        {
          "name": "popovertargetaction",
          "on": "button",
          "values": "show | hide | toggle",
          "default": "toggle",
          "description": "What the invoker does. Use hide on the Close button inside the toast."
        },
        {
          "name": "role",
          "on": "aside.forma-toast",
          "values": "status",
          "default": "—",
          "description": "Polite live-region semantics for the notification text."
        },
        {
          "name": "aria-labelledby",
          "on": "aside.forma-toast",
          "values": "id of .forma-toast__title",
          "default": "—",
          "description": "Names the notification by its title."
        },
        {
          "name": "aria-label",
          "on": "close button",
          "values": "string",
          "default": "—",
          "description": "Gives the Close button a name that says what it dismisses."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-toast",
          "elements": [
            "forma-toast__header",
            "forma-toast__title"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Reaches the invoker and, while the toast is open, the controls inside it. Browsers place an open popover's contents after its invoker in sequential focus order."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates an invoker or the Close button, showing or hiding the toast natively."
        },
        {
          "keys": "Escape",
          "action": "Does nothing for a manual popover. If Escape dismissal is wanted, the application must implement it."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "button",
            "name": "Show notification",
            "expect": {
              "open": true
            }
          },
          {
            "role": "button",
            "name": "Dismiss notification",
            "expect": {
              "open": false
            }
          }
        ]
      },
      "examples": [
        {
          "id": "undo-archive",
          "title": "Undo after archiving",
          "mobile": false,
          "raw": "components/toast/undo-archive.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "export-ready",
          "title": "Export ready with a link",
          "mobile": false,
          "raw": "components/toast/export-ready.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Toggle export notice",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "link",
                "name": "audit-2026-09.csv",
                "expect": {
                  "url": "#toast-export-ready-notice"
                }
              },
              {
                "role": "button",
                "name": "Dismiss export notification",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        },
        {
          "id": "light-copy-confirmation",
          "title": "Lightweight copy confirmation",
          "mobile": false,
          "raw": "components/toast/light-copy-confirmation.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Copy share link",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Dismiss copy notification",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        },
        {
          "id": "mobile-saved-draft",
          "title": "Mobile draft saved",
          "mobile": true,
          "raw": "components/toast/mobile-saved-draft.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Save draft",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "Dismiss save notification",
                "expect": {
                  "open": false
                }
              }
            ]
          }
        }
      ],
      "related": [
        "alert",
        "popover",
        "fault-notification",
        "dialog"
      ]
    },
    {
      "slug": "tooltip",
      "title": "Tooltip / contextual hint",
      "tag": "forma-tooltip",
      "category": "overlays",
      "behavior": "Native HTML",
      "summary": "Supplemental hint on a native button: opens by click, tap or keyboard (popovertarget) and, where supported, on hover or focus (interestfor); light motion with a static reduced-motion substitute.",
      "docsUrl": "components/tooltip/",
      "pattern": "patterns/tooltip.html",
      "minimalHtml": "<forma-tooltip class=\"forma-component-tag\">\n<div class=\"forma-stack\">\n  <p class=\"forma-tooltip-context\">\n    Retention period: 90 days\n    <span class=\"forma-tooltip\">\n      <button class=\"forma-tooltip__trigger\" type=\"button\" popovertarget=\"tooltip-retention\" interestfor=\"tooltip-retention\">\n        <span aria-hidden=\"true\">?</span>\n        <span class=\"forma-visually-hidden\">About the retention period</span>\n      </button>\n      <span class=\"forma-tooltip__surface\" id=\"tooltip-retention\" popover>Events older than the retention period are deleted automatically. Export them first if you need a longer record.</span>\n    </span>\n  </p>\n\n  <div class=\"forma-field\">\n    <div class=\"forma-cluster\">\n      <label class=\"forma-field__label\" for=\"tooltip-window\">Maintenance window</label>\n      <span class=\"forma-tooltip\">\n        <button class=\"forma-tooltip__trigger\" type=\"button\" popovertarget=\"tooltip-window-hint\" interestfor=\"tooltip-window-hint\">\n          <span aria-hidden=\"true\">?</span>\n          <span class=\"forma-visually-hidden\">How maintenance windows are applied</span>\n        </button>\n        <span class=\"forma-tooltip__surface\" id=\"tooltip-window-hint\" popover>Times use the service region's local time zone.</span>\n      </span>\n    </div>\n    <p class=\"forma-field__description\" id=\"tooltip-window-description\">Required. Changes are scheduled, never applied immediately.</p>\n    <input id=\"tooltip-window\" name=\"window\" type=\"text\" aria-describedby=\"tooltip-window-description\" placeholder=\"Sun 02:00–04:00\">\n  </div>\n\n  <table>\n    <thead>\n      <tr>\n        <th scope=\"col\">Service</th>\n        <th scope=\"col\">\n          Error budget\n          <span class=\"forma-tooltip\">\n            <button class=\"forma-tooltip__trigger\" type=\"button\" popovertarget=\"tooltip-budget\" interestfor=\"tooltip-budget\">\n              <span aria-hidden=\"true\">?</span>\n              <span class=\"forma-visually-hidden\">About error budget</span>\n            </button>\n            <span class=\"forma-tooltip__surface\" id=\"tooltip-budget\" popover>Share of allowed unavailability left in the current 30-day window.</span>\n          </span>\n        </th>\n      </tr>\n    </thead>\n    <tbody>\n      <tr><td>Checkout</td><td>42% remaining</td></tr>\n    </tbody>\n  </table>\n</div>\n</forma-tooltip>",
      "attributes": [
        {
          "name": "popovertarget",
          "on": ".forma-tooltip__trigger",
          "values": "id of the surface",
          "default": "—",
          "description": "Required. Opens and closes the hint on click, tap, Enter and Space; the non-hover path."
        },
        {
          "name": "interestfor",
          "on": ".forma-tooltip__trigger",
          "values": "id of the surface",
          "default": "—",
          "description": "Optional enhancement. Where interest invokers are supported, hover or focus also opens the hint, with browser-owned delays. Ignored elsewhere."
        },
        {
          "name": "popover",
          "on": ".forma-tooltip__surface",
          "values": "auto (empty)",
          "default": "auto",
          "description": "Makes the surface a top-layer popover that light-dismisses on outside press or Escape."
        },
        {
          "name": "type",
          "on": ".forma-tooltip__trigger",
          "values": "button",
          "default": "—",
          "description": "Keeps the trigger from submitting a surrounding form."
        },
        {
          "name": "aria-hidden",
          "on": "the visible \"?\" glyph",
          "values": "true",
          "default": "—",
          "description": "Hides the glyph so the visually hidden text is the trigger's whole name."
        },
        {
          "name": "data-forma-motion-weight",
          "on": ".forma-tooltip",
          "values": "light | standard | heavy",
          "default": "light",
          "description": "Presentation-only perceived mass for the hint's entry and exit."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-tooltip",
          "elements": [
            "forma-tooltip__surface",
            "forma-tooltip__trigger"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-motion-weight",
              "values": [
                "heavy",
                "light",
                "standard"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves focus to the trigger. Where interest invokers are supported, keyboard focus can also show the hint after the browser's delay."
        },
        {
          "keys": "Enter / Space",
          "action": "Toggles the hint (popovertarget)."
        },
        {
          "keys": "Escape",
          "action": "Closes the open hint."
        }
      ],
      "basicInteraction": {
        "kind": "live",
        "actions": [
          {
            "role": "button",
            "name": "About the retention period",
            "expect": {
              "open": true
            }
          },
          {
            "role": "button",
            "name": "How maintenance windows are applied",
            "expect": {
              "open": true
            }
          },
          {
            "role": "button",
            "name": "About error budget",
            "expect": {
              "open": true
            }
          }
        ]
      },
      "examples": [
        {
          "id": "metric-definition",
          "title": "Metric definition in a summary",
          "mobile": false,
          "raw": "components/tooltip/metric-definition.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "What is Apdex?",
                "expect": {
                  "open": true
                }
              },
              {
                "role": "button",
                "name": "What is p95 latency?",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        },
        {
          "id": "long-hint-standard-weight",
          "title": "Long translated hint",
          "mobile": false,
          "raw": "components/tooltip/long-hint-standard-weight.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Acerca del periodo de conservación",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        },
        {
          "id": "mobile-edge-hint",
          "title": "Hint at the edge of a phone screen",
          "mobile": true,
          "raw": "components/tooltip/mobile-edge-hint.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "button",
                "name": "Why two-step sign-in is required",
                "expect": {
                  "open": true
                }
              }
            ]
          }
        }
      ],
      "related": [
        "popover",
        "text-field",
        "visually-hidden",
        "callout"
      ]
    },
    {
      "slug": "understanding",
      "title": "Understanding review",
      "tag": "forma-understanding",
      "category": "assisted",
      "behavior": "Ordo / application",
      "summary": "Review proposed understanding, unknowns, conflicts, and source actions before consequential transitions.",
      "docsUrl": "components/understanding/",
      "pattern": "patterns/understanding.html",
      "minimalHtml": "<forma-understanding class=\"forma-component-tag\">\n<section class=\"forma-understanding\" aria-labelledby=\"understanding-title\">\n  <header class=\"forma-understanding__header\">\n    <div>\n      <span class=\"forma-component-kicker\">Understanding</span>\n      <h2 id=\"understanding-title\">I found 4 things</h2>\n      <p>Review what the application understood before any consequential transition.</p>\n    </div>\n    <span class=\"forma-status-lozenge\" data-state=\"attention\">1 question</span>\n  </header>\n  <ol class=\"forma-understanding__items\">\n    <li class=\"forma-understanding__item\" data-forma-state=\"accepted\">\n      <span class=\"forma-understanding__state\">Understood</span>\n      <div><strong>Medication change</strong><p>Medication increased to 40 mg.</p></div>\n      <button type=\"button\">Source</button>\n    </li>\n    <li class=\"forma-understanding__item\" data-forma-state=\"accepted\">\n      <span class=\"forma-understanding__state\">Understood</span>\n      <div><strong>Symptom</strong><p>Ankle swelling returned.</p></div>\n      <button type=\"button\">Source</button>\n    </li>\n    <li class=\"forma-understanding__item\" data-forma-state=\"unknown\">\n      <span class=\"forma-understanding__state\">Unknown</span>\n      <div><strong>Medication frequency</strong><p>The dose frequency was not supplied.</p></div>\n      <button type=\"button\">Answer</button>\n    </li>\n    <li class=\"forma-understanding__item\" data-forma-state=\"accepted\">\n      <span class=\"forma-understanding__state\">Understood</span>\n      <div><strong>Visit</strong><p>Dr. Smith visit occurred yesterday.</p></div>\n      <button type=\"button\">Source</button>\n    </li>\n  </ol>\n</section>\n</forma-understanding>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "root section",
          "values": "id of the header heading",
          "default": "—",
          "description": "Names the review region."
        },
        {
          "name": "data-forma-state",
          "on": ".forma-understanding__item",
          "values": "accepted | unknown | conflict",
          "default": "absent",
          "description": "Presentation of an application-supplied state: adds the state symbol, and for unknown and conflict the side bar. The text in `.forma-understanding__state` must say the same thing."
        },
        {
          "name": "data-state",
          "on": ".forma-status-lozenge",
          "values": "ok | attention | blocked | unknown",
          "default": "absent",
          "description": "Adds a symbol to the header summary status."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-understanding",
          "elements": [
            "forma-understanding__header",
            "forma-understanding__item",
            "forma-understanding__items",
            "forma-understanding__state"
          ],
          "modifiers": [],
          "attributes": [
            {
              "name": "data-forma-state",
              "values": [
                "accepted",
                "conflict",
                "unknown"
              ]
            }
          ],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the item actions in list order. No added keyboard behavior."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused native button; opening sources or answering is application behavior."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "conflict-with-record",
          "title": "Conflict with the existing record",
          "mobile": false,
          "raw": "components/understanding/conflict-with-record.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "all-understood",
          "title": "Everything understood",
          "mobile": false,
          "raw": "components/understanding/all-understood.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-review",
          "title": "Mobile review with a question",
          "mobile": true,
          "raw": "components/understanding/mobile-review.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "composer",
        "conflict-review",
        "readiness-checklist",
        "handoff-summary"
      ]
    },
    {
      "slug": "validation-message",
      "title": "Validation message",
      "tag": "forma-validation-message",
      "category": "feedback",
      "behavior": "Application state",
      "summary": "Question- or field-level recovery guidance with a mark, bold text and no reliance on color.",
      "docsUrl": "components/validation-message/",
      "pattern": "patterns/validation-message.html",
      "minimalHtml": "<forma-validation-message class=\"forma-component-tag\">\n<p class=\"forma-validation-message\" id=\"question-example-error\">\n  <span class=\"forma-validation-message__mark\" aria-hidden=\"true\">!</span>\n  Choose one response before continuing.\n</p>\n</forma-validation-message>",
      "attributes": [
        {
          "name": "id",
          "on": "p.forma-validation-message",
          "values": "unique id",
          "default": "—",
          "description": "Required so the control can reference the message."
        },
        {
          "name": "aria-describedby",
          "on": "input, select, textarea or fieldset",
          "values": "id list including the message id",
          "default": "—",
          "description": "Associates the message with the control so it is read when the control is focused. Keep any existing help text id in the list."
        },
        {
          "name": "aria-invalid",
          "on": "input, select or textarea",
          "values": "true",
          "default": "absent",
          "description": "Set by the application while the value is invalid; remove it when the value is fixed."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-validation-message__mark",
          "values": "true",
          "default": "—",
          "description": "Hides the decorative glyph from assistive technology."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-validation-message",
          "elements": [
            "forma-validation-message__mark"
          ],
          "modifiers": [
            "forma-validation-message--when-invalid"
          ],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "The message is not focusable. It is read as the description of the control it is linked to when that control receives focus."
        }
      ],
      "basicInteraction": {
        "kind": "none"
      },
      "examples": [
        {
          "id": "email-format",
          "title": "Email format error",
          "mobile": false,
          "raw": "components/validation-message/email-format.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "required-choice",
          "title": "Required choice not answered",
          "mobile": false,
          "raw": "components/validation-message/required-choice.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "range-guidance",
          "title": "Out-of-range number",
          "mobile": false,
          "raw": "components/validation-message/range-guidance.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-long-message",
          "title": "Mobile long message",
          "mobile": true,
          "raw": "components/validation-message/mobile-long-message.txt",
          "interaction": {
            "kind": "none"
          }
        }
      ],
      "related": [
        "validation-summary",
        "text-field",
        "question",
        "alert"
      ]
    },
    {
      "slug": "validation-summary",
      "title": "Validation summary",
      "tag": "forma-validation-summary",
      "category": "feedback",
      "behavior": "Application state",
      "summary": "Focusable page- or form-level error summary with links back to each affected control.",
      "docsUrl": "components/validation-summary/",
      "pattern": "patterns/validation-summary.html",
      "minimalHtml": "<forma-validation-summary class=\"forma-component-tag\">\n<div class=\"forma-validation-summary\" role=\"alert\" tabindex=\"-1\" aria-labelledby=\"validation-summary-title\">\n  <div class=\"forma-validation-summary__icon\" aria-hidden=\"true\">!</div>\n  <div>\n    <h2 class=\"forma-validation-summary__title\" id=\"validation-summary-title\">There are 2 responses to review</h2>\n    <ul class=\"forma-validation-summary__list\">\n      <li><a href=\"#question-security\">Question 4 requires a response.</a></li>\n      <li><a href=\"#question-allocation\">Question 8 must total 10 points.</a></li>\n    </ul>\n  </div>\n</div>\n</forma-validation-summary>",
      "attributes": [
        {
          "name": "role",
          "on": "div.forma-validation-summary",
          "values": "alert",
          "default": "—",
          "description": "Announces the summary when the application inserts it. A summary present at page load is not announced."
        },
        {
          "name": "tabindex",
          "on": "div.forma-validation-summary",
          "values": "-1",
          "default": "—",
          "description": "Allows the application to move focus to the summary programmatically without adding it to the Tab order."
        },
        {
          "name": "aria-labelledby",
          "on": "div.forma-validation-summary",
          "values": "id of .forma-validation-summary__title",
          "default": "—",
          "description": "Names the summary by its heading, so focusing it announces the count."
        },
        {
          "name": "href",
          "on": "a",
          "values": "#id of the affected control or group",
          "default": "—",
          "description": "Takes the user to the problem. Point at the input's id, or the fieldset's id for a group."
        },
        {
          "name": "aria-hidden",
          "on": ".forma-validation-summary__icon",
          "values": "true",
          "default": "—",
          "description": "Hides the decorative mark."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-validation-summary",
          "elements": [
            "forma-validation-summary__icon",
            "forma-validation-summary__list",
            "forma-validation-summary__title"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the links. The summary container is reachable only by programmatic focus."
        },
        {
          "keys": "Enter",
          "action": "Follows the focused link to the affected control (native link behavior)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "single-error",
          "title": "One off-screen error",
          "mobile": false,
          "raw": "components/validation-summary/single-error.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Enter the contract start date.",
                "expect": {
                  "url": "#validation-summary-single-error-date"
                }
              }
            ]
          }
        },
        {
          "id": "form-with-field-errors",
          "title": "Summary above field-level messages",
          "mobile": false,
          "raw": "components/validation-summary/form-with-field-errors.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "mobile-survey-page",
          "title": "Mobile survey page",
          "mobile": true,
          "raw": "components/validation-summary/mobile-survey-page.txt",
          "interaction": {
            "kind": "live",
            "actions": [
              {
                "role": "link",
                "name": "Question 2: choose how often access reviews happen.",
                "expect": {
                  "url": "#validation-summary-mobile-survey-page-title"
                }
              },
              {
                "role": "link",
                "name": "Question 5: the allocation must total exactly 100 points.",
                "expect": {
                  "url": "#validation-summary-mobile-survey-page-title"
                }
              },
              {
                "role": "link",
                "name": "Question 9: describe the exception process in at least 20 characters.",
                "expect": {
                  "url": "#validation-summary-mobile-survey-page-title"
                }
              }
            ]
          }
        }
      ],
      "related": [
        "validation-message",
        "alert",
        "obligation-panel"
      ]
    },
    {
      "slug": "verification-frame",
      "title": "Verification frame",
      "tag": "forma-verification-frame",
      "category": "verification",
      "behavior": "Ordo / application",
      "summary": "Recognize, deliberately verify, then act without letting presentation invent authority, certainty, or legal actions.",
      "docsUrl": "components/verification-frame/",
      "pattern": "patterns/verification-frame.html",
      "minimalHtml": "<forma-verification-frame class=\"forma-component-tag\">\n<section class=\"forma-verification-frame\" aria-labelledby=\"verification-title\">\n  <header class=\"forma-verification-frame__recognize\">\n    <span class=\"forma-component-kicker\">Recognition</span>\n    <h2 id=\"verification-title\">Ready for deliberate verification</h2>\n    <p>The application reports one consequential transition is available. Verify the evidence below before acting.</p>\n  </header>\n  <section class=\"forma-verification-frame__verify\" aria-labelledby=\"verify-heading\">\n    <h3 id=\"verify-heading\">Verify</h3>\n    <dl class=\"forma-verification-frame__facts\">\n      <div><dt>Record</dt><dd><span class=\"forma-identifier\">INV-1042</span></dd></div>\n      <div><dt>Amount</dt><dd><span class=\"forma-critical-value\" data-forma-verify=\"true\">$10,001.00</span></dd></div>\n      <div><dt>Evidence</dt><dd>3 sources reviewed</dd></div>\n      <div><dt>Freshness</dt><dd>Checked 2 minutes ago</dd></div>\n    </dl>\n    <p><strong>Unresolved work:</strong> none reported for this transition.</p>\n  </section>\n  <footer class=\"forma-verification-frame__act\">\n    <p>Actions shown here must come from current application or Ordo capabilities.</p>\n    <button type=\"button\">Review sources</button>\n    <button type=\"button\">Approve transition</button>\n  </footer>\n</section>\n</forma-verification-frame>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "root and verify section",
          "values": "id of a heading",
          "default": "—",
          "description": "Names the frame by its recognition heading and the verify region by its heading."
        },
        {
          "name": "data-forma-verify",
          "on": ".forma-critical-value",
          "values": "true",
          "default": "absent",
          "description": "Adds a double underline to a value that must be read deliberately. Descriptive presentation only; it does not assert that the value was verified."
        },
        {
          "name": "data-state",
          "on": ".forma-status-lozenge",
          "values": "ok | attention | blocked | unknown",
          "default": "absent",
          "description": "Adds a symbol to an application-reported state shown in the recognize part."
        },
        {
          "name": "datetime",
          "on": "time",
          "values": "ISO date or date-time",
          "default": "—",
          "description": "Machine-readable timestamp for freshness facts."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-verification-frame",
          "elements": [
            "forma-verification-frame__act",
            "forma-verification-frame__facts",
            "forma-verification-frame__recognize",
            "forma-verification-frame__verify"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Reaches the actions only after the facts in source order. No added keyboard behavior."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused native button; the effect is application-owned."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "production-release",
          "title": "Production release with stale evidence",
          "mobile": false,
          "raw": "components/verification-frame/production-release.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "payment-approval",
          "title": "Payment approval with long identifiers",
          "mobile": false,
          "raw": "components/verification-frame/payment-approval.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-case-closure",
          "title": "Mobile case closure",
          "mobile": true,
          "raw": "components/verification-frame/mobile-case-closure.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "identifier",
        "attention-path",
        "readiness-checklist",
        "understanding"
      ]
    },
    {
      "slug": "visually-hidden",
      "title": "Visually hidden",
      "tag": "forma-visually-hidden",
      "category": "utilities",
      "behavior": "Native CSS",
      "summary": "Keeps text available to assistive technology while removing it from the visual layout.",
      "docsUrl": "components/visually-hidden/",
      "pattern": "patterns/visually-hidden.html",
      "minimalHtml": "<forma-visually-hidden class=\"forma-component-tag\">\n<button type=\"button\">\n  <span aria-hidden=\"true\">×</span>\n  <span class=\"forma-visually-hidden\">Remove filter: Region is Europe</span>\n</button>\n</forma-visually-hidden>",
      "attributes": [
        {
          "name": "aria-hidden",
          "on": "decorative glyph beside the hidden text",
          "values": "true",
          "default": "—",
          "description": "Hides the visible symbol from assistive technology so it is not announced alongside the hidden text."
        },
        {
          "name": "for",
          "on": "label.forma-visually-hidden",
          "values": "id of the field",
          "default": "—",
          "description": "A visually hidden label still labels its field and is still the click target's name."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-visually-hidden",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        },
        {
          "root": "forma-sr-only",
          "elements": [],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "None",
          "action": "The utilities add no keyboard behavior. Hidden text inside a button or label contributes to that control's name; do not put the class on a focusable element."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "row-action-context",
          "title": "Repeated actions with context",
          "mobile": false,
          "raw": "components/visually-hidden/row-action-context.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "search-label",
          "title": "Search field with a hidden label",
          "mobile": false,
          "raw": "components/visually-hidden/search-label.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "form-handling"
            ]
          }
        },
        {
          "id": "symbol-meaning",
          "title": "Trend symbols explained",
          "mobile": false,
          "raw": "components/visually-hidden/symbol-meaning.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-icon-toolbar",
          "title": "Icon toolbar on a phone",
          "mobile": true,
          "raw": "components/visually-hidden/mobile-icon-toolbar.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "skip-link",
        "tooltip",
        "text-roles"
      ]
    },
    {
      "slug": "wizard",
      "title": "Wizard",
      "tag": "forma-wizard",
      "category": "navigation",
      "behavior": "Limen / Ordo",
      "summary": "Step-by-step workflow shell with current-step state, progress, validation hooks, resume, and mobile reduction.",
      "docsUrl": "components/wizard/",
      "pattern": "patterns/wizard.html",
      "minimalHtml": "<forma-wizard class=\"forma-component-tag\">\n<section class=\"forma-wizard\" aria-labelledby=\"wizard-title\">\n  <header class=\"forma-wizard__header\">\n    <div><span class=\"forma-wizard__position\">Step 2 of 4</span><h3 id=\"wizard-title\">Review details</h3></div>\n    <progress value=\"2\" max=\"4\" aria-label=\"Workflow progress\">2 of 4</progress>\n  </header>\n  <ol class=\"forma-wizard__steps\" aria-label=\"Workflow steps\">\n    <li data-state=\"complete\"><span>1</span>Details</li>\n    <li data-state=\"current\" aria-current=\"step\"><span>2</span>Review</li>\n    <li><span>3</span>Validate</li>\n    <li><span>4</span>Publish</li>\n  </ol>\n  <div class=\"forma-wizard__body\">\n    <p>Confirm the supplied information before continuing.</p>\n  </div>\n  <footer class=\"forma-wizard__actions\">\n    <button type=\"button\">Back</button>\n    <button type=\"button\">Continue</button>\n  </footer>\n</section>\n</forma-wizard>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-wizard",
          "values": "id of the step heading",
          "default": "—",
          "description": "Names the wizard region by the current step title."
        },
        {
          "name": "value",
          "on": "progress",
          "values": "number",
          "default": "—",
          "description": "Current step number, supplied by the application."
        },
        {
          "name": "max",
          "on": "progress",
          "values": "number",
          "default": "—",
          "description": "Total number of steps; update it when branching changes the total."
        },
        {
          "name": "aria-label",
          "on": "progress and ol.forma-wizard__steps",
          "values": "string",
          "default": "—",
          "description": "Names the progress bar (Workflow progress) and the step list (Workflow steps)."
        },
        {
          "name": "data-state",
          "on": "step li",
          "values": "complete | current",
          "default": "absent (upcoming)",
          "description": "Visual step state written by the application. current also bolds the step and inverts its marker; complete adds a check glyph."
        },
        {
          "name": "aria-current",
          "on": "current step li",
          "values": "step",
          "default": "absent",
          "description": "Programmatic current step. Always pair it with data-state=\"current\"."
        },
        {
          "name": "type",
          "on": "action buttons",
          "values": "button (or submit)",
          "default": "—",
          "description": "Use type=\"button\" when the application handles the transition; type=\"submit\" when the step is a native form submission."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-wizard",
          "elements": [
            "forma-wizard__actions",
            "forma-wizard__body",
            "forma-wizard__header",
            "forma-wizard__position",
            "forma-wizard__steps"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through the step body's fields and then the footer actions. The step rail is not interactive."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused action button (native)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "validation-blocked",
          "title": "Advance blocked by validation",
          "mobile": false,
          "raw": "components/wizard/validation-blocked.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "resumed-final-step",
          "title": "Resumed at the final step",
          "mobile": false,
          "raw": "components/wizard/resumed-final-step.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "mobile-current-step",
          "title": "Wizard on a phone",
          "mobile": true,
          "raw": "components/wizard/mobile-current-step.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "survey-progress",
        "steps",
        "readiness-checklist",
        "tabs"
      ]
    },
    {
      "slug": "work-queue",
      "title": "Work queue",
      "tag": "forma-work-queue",
      "category": "data",
      "behavior": "Ordo / application",
      "summary": "Attention-first list of unresolved work with reason, context, and application-supplied legal actions.",
      "docsUrl": "components/work-queue/",
      "pattern": "patterns/work-queue.html",
      "minimalHtml": "<forma-work-queue class=\"forma-component-tag\">\n<section class=\"forma-work-queue\" aria-labelledby=\"work-queue-title\">\n  <header class=\"forma-work-queue__header\">\n    <div><span class=\"forma-component-kicker\">Attention</span><h3 id=\"work-queue-title\">Needs your attention</h3></div>\n    <span class=\"forma-status-lozenge\">3 items</span>\n  </header>\n  <ol class=\"forma-work-queue__list\">\n    <li class=\"forma-work-queue__item\">\n      <div><strong>Invoice INV-1042 is overdue</strong><p>32 days overdue · Customer follow-up is available.</p></div>\n      <button type=\"button\">Review</button>\n    </li>\n    <li class=\"forma-work-queue__item\">\n      <div><strong>Write outcome is unknown</strong><p>Reconcile before retrying or assuming failure.</p></div>\n      <button type=\"button\">Reconcile</button>\n    </li>\n    <li class=\"forma-work-queue__item\">\n      <div><strong>Publication validation has warnings</strong><p>2 warnings require review before publishing.</p></div>\n      <button type=\"button\">Inspect</button>\n    </li>\n  </ol>\n</section>\n</forma-work-queue>",
      "attributes": [
        {
          "name": "aria-labelledby",
          "on": "section.forma-work-queue",
          "values": "id of the header heading",
          "default": "—",
          "description": "Names the queue region."
        },
        {
          "name": "aria-label",
          "on": "item button",
          "values": "string",
          "default": "—",
          "description": "Names the item an action applies to when the visible verb repeats across items."
        },
        {
          "name": "type",
          "on": "button",
          "values": "button",
          "default": "—",
          "description": "Actions are native buttons handled by the application."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-work-queue",
          "elements": [
            "forma-work-queue__header",
            "forma-work-queue__item",
            "forma-work-queue__list"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through each item's action button in queue order."
        },
        {
          "keys": "Enter / Space",
          "action": "Activates the focused action (native button)."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "application-behavior"
        ]
      },
      "examples": [
        {
          "id": "mixed-states",
          "title": "Overdue, unknown and blocked work",
          "mobile": false,
          "raw": "components/work-queue/mixed-states.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        },
        {
          "id": "empty-queue",
          "title": "Queue cleared",
          "mobile": false,
          "raw": "components/work-queue/empty-queue.txt",
          "interaction": {
            "kind": "none"
          }
        },
        {
          "id": "mobile-queue",
          "title": "Mobile work queue",
          "mobile": true,
          "raw": "components/work-queue/mobile-queue.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "application-behavior"
            ]
          }
        }
      ],
      "related": [
        "feed-item",
        "obligation-panel",
        "readiness-checklist",
        "operation-status"
      ]
    },
    {
      "slug": "workspace-shell",
      "title": "Workspace shell",
      "tag": "forma-workspace-shell",
      "category": "workspaces",
      "behavior": "Application content",
      "summary": "Composes navigation, primary work, contextual inspection, and status as explicit regions.",
      "docsUrl": "components/workspace-shell/",
      "pattern": "patterns/workspace-shell.html",
      "minimalHtml": "<forma-workspace-shell class=\"forma-component-tag\">\n<main class=\"forma-workspace-shell\">\n  <header class=\"forma-workspace-shell__landmark\"><h1>Workspace</h1><p role=\"status\">Ready</p></header>\n  <nav class=\"forma-workspace-shell__navigation\" aria-label=\"Workspace\"><a href=\"#work\" aria-current=\"page\">Work</a><a href=\"#history\">History</a></nav>\n  <section class=\"forma-workspace-shell__primary\" id=\"work\"><h2>Primary work</h2></section>\n  <aside class=\"forma-workspace-shell__inspector\" aria-label=\"Inspector\"><h2>Inspector</h2></aside>\n</main>\n</forma-workspace-shell>",
      "attributes": [
        {
          "name": "aria-label",
          "on": "nav, aside",
          "values": "string",
          "default": "—",
          "description": "Names the navigation and inspector landmarks so they are distinguishable from other navigation and complementary regions on the page."
        },
        {
          "name": "aria-labelledby",
          "on": "section, aside",
          "values": "id of the region heading",
          "default": "—",
          "description": "Alternative to aria-label when the region already has a visible heading."
        },
        {
          "name": "aria-current",
          "on": "navigation link",
          "values": "page",
          "default": "absent",
          "description": "Marks the current section. The application sets it when routing changes; the shell does not style it."
        },
        {
          "name": "role",
          "on": "status element in the landmark",
          "values": "status",
          "default": "—",
          "description": "Makes the workspace status a polite live region so saves, syncs and offline changes are announced."
        },
        {
          "name": "id",
          "on": "primary region",
          "values": "string",
          "default": "—",
          "description": "Target for navigation fragment links and skip links."
        }
      ],
      "cssHooks": [
        {
          "root": "forma-workspace-shell",
          "elements": [
            "forma-workspace-shell__inspector",
            "forma-workspace-shell__landmark",
            "forma-workspace-shell__navigation",
            "forma-workspace-shell__primary"
          ],
          "modifiers": [],
          "attributes": [],
          "customProperties": []
        }
      ],
      "keyboard": [
        {
          "keys": "Tab / Shift+Tab",
          "action": "Moves through links and controls in source order: landmark, navigation, primary, inspector. The shell adds no keyboard behavior."
        },
        {
          "keys": "Screen-reader landmark navigation",
          "action": "Navigation and inspector are exposed as named landmarks, so users can jump between them directly."
        }
      ],
      "basicInteraction": {
        "kind": "static",
        "reasons": [
          "placeholder-navigation"
        ]
      },
      "examples": [
        {
          "id": "support-queue",
          "title": "Support queue with a selected ticket",
          "mobile": false,
          "raw": "components/workspace-shell/support-queue.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "nothing-selected",
          "title": "Nothing selected",
          "mobile": false,
          "raw": "components/workspace-shell/nothing-selected.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "long-labels",
          "title": "Long navigation labels and a narrow inspector",
          "mobile": false,
          "raw": "components/workspace-shell/long-labels.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        },
        {
          "id": "mobile-stacked-regions",
          "title": "Mobile stacked regions",
          "mobile": true,
          "raw": "components/workspace-shell/mobile-stacked-regions.txt",
          "interaction": {
            "kind": "static",
            "reasons": [
              "placeholder-navigation"
            ]
          }
        }
      ],
      "related": [
        "navigation-shell",
        "master-detail",
        "split-pane",
        "focus-stage",
        "landmark-region"
      ]
    }
  ],
  "compositions": [
    {
      "slug": "dashboard",
      "title": "Operations dashboard",
      "docsUrl": "compositions/dashboard/"
    },
    {
      "slug": "form-validation",
      "title": "Form with validation",
      "docsUrl": "compositions/form-validation/"
    },
    {
      "slug": "keyboard",
      "title": "Keyboard and focus",
      "docsUrl": "compositions/keyboard/"
    },
    {
      "slug": "mobile-settings",
      "title": "Mobile settings",
      "docsUrl": "compositions/mobile-settings/"
    },
    {
      "slug": "overlays",
      "title": "Overlay interaction",
      "docsUrl": "compositions/overlays/"
    }
  ]
}
