{
  "synthcssVersion": "0.9.0",
  "contractVersion": "1.4.0",
  "tokens": {
    "--color-background": "page background",
    "--color-surface": "subtle background for panels, table heads, footers",
    "--color-surface-elevated": "background of raised surfaces (cards, buttons)",
    "--color-text": "main text",
    "--color-text-secondary": "body text of cards and panels",
    "--color-text-muted": "hints, metadata, placeholders",
    "--color-border": "default border color",
    "--color-primary": "brand accent; main actions",
    "--color-primary-hover": "hover state of primary elements",
    "--color-on-primary": "text on primary or danger fills",
    "--color-success": "success status",
    "--color-warning": "warning status",
    "--color-danger": "errors and destructive actions",
    "--color-info": "neutral informational status",
    "--color-accent": "decorative violet with no status meaning (avatar tiles)",
    "--space-1": "0.25rem spacing step",
    "--space-2": "0.5rem spacing step (-sm gaps)",
    "--space-3": "0.75rem spacing step",
    "--space-4": "1rem spacing step (default gap)",
    "--space-5": "1.5rem spacing step",
    "--space-6": "2rem spacing step (-lg gaps)",
    "--font-sans": "UI font stack",
    "--font-mono": "code font stack",
    "--text-sm": "small text",
    "--text-base": "body text size",
    "--text-lg": "large text, card titles",
    "--text-xl": "small headings",
    "--text-2xl": "section headings",
    "--text-3xl": "page titles",
    "--weight-normal": "regular weight",
    "--weight-medium": "labels and buttons",
    "--weight-semibold": "headings",
    "--weight-bold": "strong emphasis",
    "--leading-tight": "line height for headings and controls",
    "--leading-normal": "line height for body text",
    "--leading-relaxed": "line height for long-form text",
    "--radius-sm": "small corner radius",
    "--radius-md": "default radius (controls, panels)",
    "--radius-lg": "card radius",
    "--radius-full": "pills and circles",
    "--border-width": "default border width",
    "--border-color": "default border color (follows --color-border)",
    "--shadow-sm": "subtle elevation",
    "--shadow-md": "card elevation",
    "--shadow-lg": "overlay elevation",
    "--control-height": "button height",
    "--input-height": "text input height",
    "--container-width": "max width of .container",
    "--content-width": "readable text width (.center)",
    "--sidebar-width": "sidebar basis in .sidebar",
    "--grid-min": "minimum column width in .grid; override inline per grid",
    "--focus-color": "focus ring color",
    "--focus-width": "focus ring width",
    "--focus-offset": "focus ring offset",
    "--duration-fast": "hover and state transitions",
    "--duration-normal": "standard transitions",
    "--duration-slow": "larger movements; spinner speed",
    "--ease-standard": "default easing curve"
  },
  "baseStyles": {
    "note": "Base styles apply --font-sans, --color-text and --color-background to the page and the --text-* scale to h1–h4. Override the tokens to restyle.",
    "rules": {
      "html": {
        "font-family": "var(--font-sans)",
        "font-size": "100%",
        "line-height": "var(--leading-normal)",
        "color": "var(--color-text)",
        "background": "var(--color-background)"
      },
      "h1, h2, h3, h4": { "line-height": "var(--leading-tight)", "font-weight": "var(--weight-semibold)" },
      "h1": { "font-size": "var(--text-3xl)" },
      "h2": { "font-size": "var(--text-2xl)" },
      "h3": { "font-size": "var(--text-xl)" },
      "h4": { "font-size": "var(--text-lg)" },
      "code, kbd, pre, samp": { "font-family": "var(--font-mono)" }
    }
  },
  "layouts": {
    "container": "centered page-width wrapper with side padding",
    "stack": "vertical flow with tokenized spacing",
    "stack-sm": "stack with a tighter gap",
    "stack-lg": "stack with a looser gap",
    "cluster": "wrapping row of small items (tags, buttons, links)",
    "cluster-sm": "cluster with a tighter gap",
    "cluster-lg": "cluster with a looser gap",
    "grid": "responsive equal columns, as many as fit (min --grid-min)",
    "grid-sm": "grid with a tighter gap",
    "grid-lg": "grid with a looser gap",
    "sidebar": "1st child narrow side panel, 2nd child main area; stacks when narrow",
    "sidebar-sm": "sidebar with a tighter gap",
    "sidebar-lg": "sidebar with a looser gap",
    "sidebar-end": "with a sidebar class: last child is the narrow column (right), 1st child the main area",
    "split": "two groups pushed to opposite ends of a row; wraps when tight",
    "split-sm": "split with a tighter gap",
    "split-lg": "split with a looser gap",
    "center": "readable, horizontally centered column of text",
    "cover": "full-viewport-height section, main child vertically centered",
    "cover-main": "the child of .cover that is vertically centered"
  },
  "primitives": {
    "container": {
      "variants": [],
      "responsive": "full width of its parent below --container-width, then stops growing and is centered; side padding grows from --space-4 to --space-6",
      "composition": [
        "Wrap the page's main content, or each full-width band, and put .stack or .stack-lg on the same element.",
        "Never nest a .container in another; narrow text with .center instead."
      ],
      "example": "<main class=\"container stack-lg\">\n  <h1>Settings</h1>\n  <p>…</p>\n</main>"
    },
    "stack": {
      "variants": ["stack-sm", "stack-lg"],
      "responsive": "a column at every width; spacing comes from the gap, children keep their normal width",
      "composition": [
        "Form fields, card and panel content, page sections.",
        "Wrap a button in a .cluster inside the stack to keep it at its content width."
      ],
      "example": "<section class=\"stack\">\n  <h2>Profile</h2>\n  <p>…</p>\n</section>"
    },
    "cluster": {
      "variants": ["cluster-sm", "cluster-lg"],
      "responsive": "items stay in one row while they fit, then wrap; items keep their own width",
      "composition": [
        "Rows of buttons, tags, badges or inline links.",
        "Use .cluster-sm for the actions of a form, a .card-footer or a .split header."
      ],
      "example": "<div class=\"cluster-sm\">\n  <button type=\"button\" class=\"button button-primary\">Save</button>\n  <button type=\"button\" class=\"button\">Cancel</button>\n</div>"
    },
    "grid": {
      "variants": ["grid-sm", "grid-lg"],
      "responsive": "as many equal columns as fit, each at least --grid-min wide; one column on a phone, never overflows its parent",
      "composition": [
        "A <ul role=\"list\"> of .card items for collections.",
        "Set the column width per grid with an inline token override: style=\"--grid-min: 12rem\"."
      ],
      "example": "<ul class=\"grid\" role=\"list\" style=\"--grid-min: 14rem\">\n  <li class=\"card\">…</li>\n  <li class=\"card\">…</li>\n</ul>"
    },
    "sidebar": {
      "variants": ["sidebar-sm", "sidebar-lg"],
      "modifiers": ["sidebar-end"],
      "responsive": "the narrow column keeps --sidebar-width and the main area grows (at least half); both stack when the layout itself gets narrow, with no media queries",
      "composition": [
        "Exactly two children: the narrow column (navigation, filters) first, then the main area.",
        "Add .sidebar-end to put the narrow column last, on the right; override --sidebar-width inline per layout."
      ],
      "example": "<div class=\"sidebar\">\n  <nav class=\"stack-sm\" aria-label=\"Settings\">…</nav>\n  <main class=\"stack\">…</main>\n</div>"
    },
    "split": {
      "variants": ["split-sm", "split-lg"],
      "responsive": "first and last child pushed to opposite ends and vertically centered; the second group wraps under the first when they no longer fit",
      "composition": [
        "Page, card and panel headers: a title and a .cluster-sm of actions.",
        "Toolbars and footers with two groups, e.g. class=\"card-footer split-sm\"."
      ],
      "example": "<header class=\"split\">\n  <h1>Projects</h1>\n  <button type=\"button\" class=\"button button-primary\">New project</button>\n</header>"
    },
    "center": {
      "variants": [],
      "responsive": "fills its parent up to --content-width, then is centered; it centers the box, not the text",
      "composition": [
        "Articles, long-form text and narrow forms.",
        "Add .stack on the same element for vertical rhythm."
      ],
      "example": "<article class=\"center stack\">\n  <h1>Release notes</h1>\n  <p>…</p>\n</article>"
    },
    "cover": {
      "variants": [],
      "parts": ["cover-main"],
      "placement": { "cover-main": "child" },
      "responsive": "at least the viewport height (100dvh) and grows with its content; .cover-main is vertically centered, other children sit at the top and bottom",
      "composition": [
        "Sign-in, onboarding and error pages.",
        "Put .center and .stack on the .cover-main child."
      ],
      "example": "<main class=\"cover\">\n  <form class=\"cover-main center stack\">…</form>\n</main>"
    }
  },
  "components": {
    "button": {
      "intent": "an action, on <button> or <a href>",
      "parts": {},
      "variants": {
        "button-primary": "main action of a form or page",
        "button-secondary": "alternative or cancel action",
        "button-danger": "destructive action (delete, remove)",
        "button-sm": "smaller button",
        "button-lg": "larger button",
        "button-icon": "square icon-only button; needs aria-label"
      },
      "behaviors": [
        {
          "intent": "open a modal dialog",
          "attribute": "data-synth-open",
          "target": "the id of a <dialog> element",
          "requiredMarkup": "<button type=\"button\" class=\"button button-danger\" data-synth-open=\"confirm-delete\">Delete project</button>\n<dialog id=\"confirm-delete\" aria-labelledby=\"confirm-delete-title\">\n  <div class=\"stack\">\n    <h2 id=\"confirm-delete-title\">Delete project?</h2>\n    <div class=\"cluster-sm\">\n      <button type=\"button\" class=\"button button-danger\">Delete</button>\n      <button type=\"button\" class=\"button\" data-synth-dismiss>Cancel</button>\n    </div>\n  </div>\n</dialog>",
          "accessibility": [
            "showModal(): the page behind is inert and Escape closes the dialog natively",
            "focus returns to the opening button when the dialog closes",
            "label the <dialog> with aria-labelledby pointing at its heading"
          ]
        },
        {
          "intent": "show or hide a section (collapse, disclosure, show more)",
          "attribute": "data-synth-toggle",
          "target": "the id of any element; its hidden attribute is the state",
          "requiredMarkup": "<button type=\"button\" class=\"button\" data-synth-toggle=\"filters\">Filters</button>\n<div id=\"filters\" class=\"panel\" hidden>…</div>",
          "accessibility": [
            "aria-expanded on the button follows the target's hidden state, starting from the markup",
            "aria-controls is added to the button when missing",
            "the target stays in the DOM; hidden removes it from the accessibility tree"
          ]
        }
      ],
      "accessibility": [
        { "expectation": "Put .button on a native <button type> or an <a href>.", "class": "button", "elements": ["button", "a"], "severity": "error" },
        { "expectation": "An icon-only .button-icon needs an accessible name: aria-label or aria-labelledby.", "class": "button-icon", "attributes": ["aria-label", "aria-labelledby"], "severity": "error" }
      ],
      "example": "<button type=\"button\" class=\"button button-primary\">Save</button>"
    },
    "field": {
      "intent": "one labeled form control with help or error text",
      "parts": {
        "field-label": "the <label> of the control",
        "field-help": "hint text under the control",
        "field-error": "error message; pair with aria-invalid=\"true\""
      },
      "variants": {},
      "accessibility": [
        { "expectation": ".field-label must be a <label> element.", "class": "field-label", "elements": ["label"], "severity": "error" },
        { "expectation": ".field-label names its control with for=\"<id>\".", "class": "field-label", "attributes": ["for"], "severity": "warning" }
      ],
      "example": "<div class=\"field\">\n  <label class=\"field-label\" for=\"name\">Name</label>\n  <input id=\"name\" type=\"text\" aria-describedby=\"name-help\">\n  <p class=\"field-help\" id=\"name-help\">Shown on your profile.</p>\n</div>"
    },
    "switch": {
      "intent": "on/off toggle: <label class=\"switch\"><input type=\"checkbox\" role=\"switch\"> Text</label>; state from checked / disabled",
      "parts": {},
      "variants": {},
      "accessibility": [
        { "expectation": ".switch must be a <label> around <input type=\"checkbox\" role=\"switch\">.", "class": "switch", "elements": ["label"], "severity": "error" }
      ],
      "example": "<label class=\"switch\"><input type=\"checkbox\" role=\"switch\" checked> Email alerts</label>"
    },
    "input-group": {
      "intent": "one <input> joined with .button and/or <select> children; shared borders, outer corners rounded; put in .field for a label",
      "parts": {},
      "variants": {},
      "accessibility": [],
      "example": "<div class=\"input-group\"><input type=\"search\" aria-label=\"Search\"><button type=\"submit\" class=\"button\">Search</button></div>"
    },
    "card": {
      "intent": "raised self-contained item (project, product, user)",
      "parts": {
        "card-header": "title area",
        "card-body": "main content; grows to align footers",
        "card-footer": "bottom bar on the surface color",
        "card-media": "full-width image or video",
        "card-actions": "wrapping row of buttons or links"
      },
      "variants": {},
      "accessibility": [],
      "example": "<article class=\"card\">\n  <div class=\"card-header\"><h2>Atlas</h2></div>\n  <div class=\"card-body\">Design system migration.</div>\n  <div class=\"card-footer split-sm\"><span class=\"badge badge-success\">Active</span></div>\n</article>"
    },
    "badge": {
      "intent": "short status label",
      "parts": {},
      "variants": {
        "badge-success": "positive status",
        "badge-warning": "needs attention",
        "badge-danger": "failed or blocked",
        "badge-info": "neutral information"
      },
      "accessibility": [],
      "example": "<span class=\"badge badge-success\">Active</span>"
    },
    "alert": {
      "intent": "message box; role=\"status\" or role=\"alert\"",
      "parts": {
        "alert-icon": "leading <svg aria-hidden=\"true\"> as a direct child; sits left of the content, top-aligned"
      },
      "variants": {
        "alert-info": "neutral information",
        "alert-success": "action succeeded",
        "alert-warning": "needs attention",
        "alert-danger": "error"
      },
      "behaviors": [
        {
          "intent": "dismiss a message, or close the dialog it is in",
          "attribute": "data-synth-dismiss",
          "target": "none: the closest <dialog>, otherwise the closest [data-synth-dismissible] ancestor",
          "requiredMarkup": "<div class=\"alert alert-success\" role=\"status\" data-synth-dismissible>\n  <p>Settings saved.</p>\n  <button type=\"button\" class=\"button button-sm\" data-synth-dismiss>Dismiss</button>\n</div>",
          "accessibility": [
            "a dismissible element gets the hidden attribute and stays in the DOM",
            "the button needs a visible text label, or aria-label when it shows only an icon",
            "inside a <dialog> it closes the dialog and focus returns to the opener"
          ]
        }
      ],
      "placement": { "alert-icon": "child" },
      "accessibility": [
        { "expectation": ".alert needs role=\"status\" (polite) or role=\"alert\" (urgent).", "class": "alert", "attributes": ["role"], "values": ["status", "alert"], "severity": "error" },
        { "expectation": ".alert-icon is decorative and needs aria-hidden=\"true\".", "class": "alert-icon", "attributes": ["aria-hidden"], "values": ["true"], "severity": "error" }
      ],
      "example": "<div class=\"alert alert-warning\" role=\"status\">\n  <p>Your trial ends in 3 days.</p>\n</div>"
    },
    "panel": {
      "intent": "flat bordered group of secondary content",
      "parts": {
        "panel-header": "title area with a bottom border",
        "panel-body": "content area"
      },
      "variants": {},
      "accessibility": [],
      "example": "<section class=\"panel\">\n  <div class=\"panel-header\"><h2>Activity</h2></div>\n  <div class=\"panel-body\">…</div>\n</section>"
    },
    "table": {
      "intent": "tabular data on a native <table>",
      "parts": {
        "table-wrap": "bordered wrapper that scrolls wide tables; add tabindex=\"0\"",
        "numeric": "right-aligned tabular-number cell"
      },
      "variants": {
        "table-hover": "highlight the hovered row"
      },
      "placement": { "table-wrap": "wraps" },
      "accessibility": [
        { "expectation": ".table must be on a native <table>.", "class": "table", "elements": ["table"], "severity": "error" },
        { "expectation": ".table-wrap needs tabindex=\"0\" so keyboard users can scroll it.", "class": "table-wrap", "attributes": ["tabindex"], "values": ["0"], "severity": "warning" }
      ],
      "example": "<div class=\"table-wrap\" tabindex=\"0\">\n  <table class=\"table\">\n    <thead><tr><th>Plan</th><th class=\"numeric\">Price</th></tr></thead>\n    <tbody><tr><td>Team</td><td class=\"numeric\">$12</td></tr></tbody>\n  </table>\n</div>"
    },
    "empty-state": {
      "intent": "nothing to show yet: icon, heading, text, action",
      "parts": {},
      "variants": {},
      "accessibility": [],
      "example": "<div class=\"empty-state\">\n  <h2>No projects yet</h2>\n  <p>Create a project to get started.</p>\n  <button type=\"button\" class=\"button button-primary\">New project</button>\n</div>"
    },
    "nav": {
      "intent": "list reset for navigation links on <ul>; add .stack-sm (vertical) or .cluster-sm (horizontal)",
      "parts": {
        "nav-link": "an <a href> in .nav, optional leading <svg>; current page: aria-current=\"page\""
      },
      "variants": {},
      "behaviors": [
        {
          "intent": "dropdown of links behind a button (account menu, overflow actions)",
          "attribute": "data-synth-dropdown",
          "target": "a wrapper holding the trigger ([data-synth-dropdown-trigger], else the first <button>) and the menu ([data-synth-dropdown-menu], else [role=\"menu\"])",
          "requiredMarkup": "<div data-synth-dropdown>\n  <button type=\"button\" class=\"button\" data-synth-dropdown-trigger>Account</button>\n  <ul class=\"nav stack-sm\" role=\"list\" data-synth-dropdown-menu hidden>\n    <li><a class=\"nav-link\" href=\"/profile\">Profile</a></li>\n    <li><a class=\"nav-link\" href=\"/logout\">Sign out</a></li>\n  </ul>\n</div>",
          "accessibility": [
            "aria-expanded on the trigger follows the menu's hidden state",
            "a click outside or Escape closes the menu; Escape returns focus to the trigger",
            "a disclosure list of links: no role=\"menu\", which promises arrow-key navigation SynthJS does not add"
          ]
        }
      ],
      "accessibility": [
        { "expectation": ".nav must be on a list, <ul> or <ol>, with role=\"list\".", "class": "nav", "elements": ["ul", "ol"], "severity": "error" },
        { "expectation": "Each .nav-link must be an <a href>; the current page gets aria-current=\"page\".", "class": "nav-link", "elements": ["a"], "severity": "error" }
      ],
      "example": "<ul class=\"nav stack-sm\" role=\"list\">\n  <li><a class=\"nav-link\" href=\"/\" aria-current=\"page\">Home</a></li>\n  <li><a class=\"nav-link\" href=\"/team\">Team</a></li>\n</ul>"
    },
    "tabs": {
      "intent": "tab list or segmented filter; role=\"tablist\" + aria-label; wraps when narrow. Arrow keys and panel switching: data-synth-tabs (SynthJS, see behaviors)",
      "parts": {
        "tabs-item": "<button role=\"tab\">; selected: aria-selected=\"true\", others aria-selected=\"false\""
      },
      "variants": {},
      "behaviors": [
        {
          "intent": "switch between panels of content",
          "attribute": "data-synth-tabs",
          "target": "a container of the .tabs tablist and its role=\"tabpanel\" elements; each tab names its panel with aria-controls",
          "requiredMarkup": "<div class=\"stack\" data-synth-tabs>\n  <div class=\"tabs\" role=\"tablist\" aria-label=\"Range\">\n    <button type=\"button\" class=\"tabs-item\" role=\"tab\" id=\"tab-week\" aria-controls=\"panel-week\" aria-selected=\"true\">Week</button>\n    <button type=\"button\" class=\"tabs-item\" role=\"tab\" id=\"tab-month\" aria-controls=\"panel-month\" aria-selected=\"false\">Month</button>\n  </div>\n  <div role=\"tabpanel\" id=\"panel-week\" aria-labelledby=\"tab-week\">…</div>\n  <div role=\"tabpanel\" id=\"panel-month\" aria-labelledby=\"tab-month\" hidden>…</div>\n</div>",
          "accessibility": [
            "click, ArrowLeft / ArrowRight (wrapping), Home and End select a tab and move focus to it",
            "the selected tab gets aria-selected=\"true\" and tabindex=\"0\", the others aria-selected=\"false\" and tabindex=\"-1\"",
            "panels of unselected tabs get hidden; label each panel with aria-labelledby"
          ]
        }
      ],
      "accessibility": [
        { "expectation": ".tabs needs role=\"tablist\".", "class": "tabs", "attributes": ["role"], "values": ["tablist"], "severity": "error" },
        { "expectation": ".tabs needs a label: aria-label or aria-labelledby.", "class": "tabs", "attributes": ["aria-label", "aria-labelledby"], "severity": "error" },
        { "expectation": "Each .tabs-item needs role=\"tab\".", "class": "tabs-item", "attributes": ["role"], "values": ["tab"], "severity": "error" },
        { "expectation": "Each .tabs-item needs aria-selected=\"true\" or \"false\"; never aria-pressed.", "class": "tabs-item", "attributes": ["aria-selected"], "values": ["true", "false"], "severity": "error" }
      ],
      "example": "<div class=\"tabs\" role=\"tablist\" aria-label=\"Range\">\n  <button type=\"button\" class=\"tabs-item\" role=\"tab\" aria-selected=\"true\">Week</button>\n  <button type=\"button\" class=\"tabs-item\" role=\"tab\" aria-selected=\"false\">Month</button>\n</div>"
    },
    "avatar": {
      "intent": "fixed square for initials, a photo or an icon, on <span>, <div> or <img>",
      "parts": {},
      "variants": {
        "avatar-round": "circle; usual for people",
        "avatar-sm": "smaller (0.75× --control-height)",
        "avatar-lg": "larger (1.5× --control-height)",
        "avatar-primary": "primary tint",
        "avatar-success": "success tint",
        "avatar-warning": "warning tint",
        "avatar-danger": "danger tint",
        "avatar-info": "info tint",
        "avatar-accent": "violet tint with no status meaning"
      },
      "accessibility": [],
      "example": "<span class=\"avatar avatar-round\" aria-hidden=\"true\">AL</span>"
    }
  },
  "synthjs": {
    "attributes": {
      "data-synth-open": { "behavior": "data-synth-open", "value": "id", "purpose": "on a button: the id of the <dialog> it opens", "targetElements": ["dialog"] },
      "data-synth-dismiss": { "behavior": "data-synth-dismiss", "value": "none", "purpose": "on a button: closes the closest <dialog>, otherwise hides the closest [data-synth-dismissible]", "closest": ["dialog", "[data-synth-dismissible]"] },
      "data-synth-dismissible": { "behavior": "data-synth-dismiss", "value": "none", "purpose": "marks the element a data-synth-dismiss button inside it hides" },
      "data-synth-toggle": { "behavior": "data-synth-toggle", "value": "id", "purpose": "on a button: the id of the element whose hidden attribute it toggles" },
      "data-synth-tabs": { "behavior": "data-synth-tabs", "value": "none", "purpose": "on the container of a role=\"tablist\" and its role=\"tabpanel\" elements", "contains": [["[role=\"tab\"]"]] },
      "data-synth-dropdown": { "behavior": "data-synth-dropdown", "value": "none", "purpose": "on the wrapper of a trigger button and a menu", "contains": [["[data-synth-dropdown-trigger]", "button"], ["[data-synth-dropdown-menu]", "[role=\"menu\"]"]] },
      "data-synth-dropdown-trigger": { "behavior": "data-synth-dropdown", "value": "none", "purpose": "marks the trigger button of a dropdown (default: its first <button>)", "closest": ["[data-synth-dropdown]"] },
      "data-synth-dropdown-menu": { "behavior": "data-synth-dropdown", "value": "none", "purpose": "marks the menu of a dropdown (default: its [role=\"menu\"])", "closest": ["[data-synth-dropdown]"] }
    }
  },
  "internal": {
    "note": "Markers SynthCSS or SynthJS set themselves. Never write them in markup.",
    "classes": [],
    "attributes": ["data-synth"]
  },
  "intentMap": [
    { "intent": "Page or section wrapper", "use": ".container" },
    { "intent": "Vertical list of blocks", "use": ".stack" },
    { "intent": "Row of tags, buttons or links", "use": ".cluster" },
    { "intent": "Responsive cards or tiles", "use": ".grid (+ style=\"--grid-min: …\")" },
    { "intent": "Side navigation next to content", "use": ".sidebar" },
    { "intent": "Main content with a narrow side column on the right", "use": ".sidebar (or -sm/-lg) + .sidebar-end" },
    { "intent": "Header or toolbar with two ends", "use": ".split" },
    { "intent": "Readable text column", "use": ".center" },
    { "intent": "Full-screen centered page", "use": ".cover + .cover-main" },
    { "intent": "Tighter or looser spacing", "use": "-sm / -lg on stack, cluster, grid, sidebar, split" },
    { "intent": "Main action", "use": ".button button-primary" },
    { "intent": "Destructive action", "use": ".button button-danger" },
    { "intent": "Labeled input with help or error", "use": ".field + .field-label + .field-help / .field-error" },
    { "intent": "On/off setting", "use": ".switch on a <label> around <input type=\"checkbox\" role=\"switch\">" },
    { "intent": "Input with an attached button or select", "use": ".input-group" },
    { "intent": "Self-contained item", "use": ".card + parts" },
    { "intent": "Status label", "use": ".badge + .badge-success / -warning / -danger / -info" },
    { "intent": "Message or notification", "use": ".alert + .alert-info / -success / -warning / -danger; optional .alert-icon" },
    { "intent": "Secondary grouped content", "use": ".panel + .panel-header / .panel-body" },
    { "intent": "Tabular data", "use": ".table-wrap > .table; .table-hover, .numeric" },
    { "intent": "No data yet", "use": ".empty-state" },
    { "intent": "Navigation links", "use": ".nav + .nav-link" },
    { "intent": "Tabs or segmented filter", "use": ".tabs + .tabs-item" },
    { "intent": "Person initials or photo", "use": ".avatar / .avatar-round" },
    { "intent": "Icon on a tinted tile", "use": ".avatar + .avatar-primary / -success / -warning / -danger / -info / -accent" },
    { "intent": "Tabs that switch panels", "use": "data-synth-tabs around .tabs + role=\"tabpanel\" panels (SynthJS)" },
    { "intent": "Modal dialog", "use": "<dialog> opened by a .button with data-synth-open (SynthJS)" },
    { "intent": "Show or hide a section", "use": ".button with data-synth-toggle (SynthJS)" },
    { "intent": "Dropdown of links", "use": "data-synth-dropdown around a .button and a .nav list (SynthJS)" },
    { "intent": "Dismissible message", "use": ".alert with data-synth-dismissible and a data-synth-dismiss .button (SynthJS)" }
  ],
  "intents": [
    { "class": "container", "reason": "Centered page-width wrapper with side padding.", "keywords": ["container", "wrapper", "page wrapper", "page width", "max width", "centered page", "section wrapper"] },
    { "class": "stack", "reason": "Vertical flow of blocks with an even gap.", "keywords": ["stack", "vertical", "vertically", "one below another", "below each other", "on top of each other", "vertical list", "vertical spacing", "list of blocks", "form fields"] },
    { "class": "cluster", "reason": "Wrapping row of small items (buttons, tags, links) that keep their own width.", "keywords": ["cluster", "row", "wrap", "wraps", "wrapping", "item", "inline", "horizontal", "tag", "chip", "button group", "button row", "row of links"] },
    { "class": "grid", "reason": "Responsive equal columns, as many as fit; set --grid-min per grid.", "keywords": ["grid", "tile", "gallery", "column", "as many as fit", "responsive card", "card grid", "grid of card", "collection"] },
    { "class": "sidebar", "reason": "Narrow side column next to the main area; stacks when narrow.", "keywords": ["sidebar", "side nav", "side navigation", "side panel", "next to", "beside", "main content", "main area", "aside", "two column", "filter panel"] },
    { "class": "sidebar-end", "with": ["sidebar"], "reason": "Main area first, narrow column on the right.", "keywords": ["right column", "right sidebar", "sidebar on the right", "narrow column on the right", "side column on the right", "secondary column"] },
    { "class": "split", "reason": "Two groups pushed to opposite ends of a row; wraps when tight.", "keywords": ["split", "two ends", "opposite ends", "opposite sides", "space between", "left and right", "header", "header bar", "toolbar", "title and actions", "push apart"] },
    { "class": "center", "reason": "Readable, horizontally centered column of text.", "keywords": ["center", "centered", "readable", "text column", "article", "prose", "long text", "long form", "reading width"] },
    { "class": "cover", "reason": "Full-viewport-height section with its .cover-main child vertically centered.", "keywords": ["cover", "full screen", "fullscreen", "full height", "full page", "viewport height", "hero", "vertically centered", "sign in page", "login page", "splash"] },
    { "class": "button", "reason": "An action on a native <button> or <a href>.", "keywords": ["button", "action", "click"] },
    { "class": "button-primary", "with": ["button"], "reason": "The main action of a form or page.", "keywords": ["primary", "main action", "call to action", "cta", "submit", "save button", "primary button"] },
    { "class": "button-secondary", "with": ["button"], "reason": "An alternative or cancel action.", "keywords": ["secondary", "cancel", "secondary button", "alternative action"] },
    { "class": "button-danger", "with": ["button"], "reason": "A destructive action (delete, remove).", "keywords": ["danger", "destructive", "delete", "remove", "delete button", "red button"] },
    { "class": "button-icon", "with": ["button"], "reason": "Square icon-only button; give it aria-label.", "keywords": ["icon button", "icon only", "close icon", "icon-only button"] },
    { "class": "field", "reason": "One labeled form control with .field-label, .field-help and .field-error.", "keywords": ["field", "form field", "input", "text field", "label", "help text", "error message", "validation", "form control"] },
    { "class": "switch", "reason": "On/off setting: a <label> around <input type=\"checkbox\" role=\"switch\">.", "keywords": ["switch", "toggle switch", "on off", "setting toggle", "checkbox toggle"] },
    { "class": "input-group", "reason": "An input joined with a .button or <select>.", "keywords": ["input group", "attached button", "search box", "input with button", "copy link", "inline form"] },
    { "class": "card", "reason": "Raised self-contained item with .card-header, .card-body and .card-footer.", "keywords": ["card", "self contained", "product card", "project card", "profile card"] },
    { "class": "badge", "reason": "Short status label; pick .badge-success / -warning / -danger / -info by meaning.", "keywords": ["badge", "pill", "status", "status label", "count"] },
    { "class": "alert", "reason": "Message box with role=\"status\" or role=\"alert\".", "keywords": ["alert", "message", "notification", "banner", "warning", "info box", "callout", "toast"] },
    { "class": "panel", "reason": "Flat bordered group of secondary content.", "keywords": ["panel", "box", "secondary content", "group of content", "bordered section"] },
    { "class": "table", "reason": "Tabular data on a native <table>, wrapped in .table-wrap.", "keywords": ["table", "tabular", "data table", "rows and columns", "spreadsheet", "list of records"] },
    { "class": "empty-state", "reason": "Nothing to show yet: icon, heading, text and an action.", "keywords": ["empty", "empty state", "no data", "nothing yet", "no results", "blank slate", "zero state"] },
    { "class": "nav", "reason": "Navigation links: .nav on a list with .nav-link anchors.", "keywords": ["nav", "navigation", "nav links", "menu links", "site navigation", "current page"] },
    { "class": "tabs", "reason": "Tab list or segmented filter with .tabs-item buttons.", "keywords": ["tabs", "tab", "segmented", "segmented control", "filter tabs", "tab list"] },
    { "class": "tabs", "attribute": "data-synth-tabs", "reason": "Tabs that switch panels: data-synth-tabs around .tabs and role=\"tabpanel\" panels (SynthJS).", "keywords": ["switch between", "tab panel", "switch panel", "tabbed content"] },
    { "class": "avatar", "reason": "Square for initials or a photo; add .avatar-round for people.", "keywords": ["avatar", "initials", "profile picture", "user photo", "person"] },
    { "class": "avatar-accent", "with": ["avatar"], "reason": "Icon on a tinted tile; pick the tint by meaning.", "keywords": ["icon tile", "tinted icon", "icon background"] },
    { "class": "button", "attribute": "data-synth-open", "reason": "A .button with data-synth-open opens a <dialog> (SynthJS).", "keywords": ["modal", "dialog", "popup", "confirm", "confirmation", "lightbox", "overlay"] },
    { "class": "button", "attribute": "data-synth-toggle", "reason": "A .button with data-synth-toggle shows or hides a section (SynthJS).", "keywords": ["collapse", "expand", "collapsible", "disclosure", "accordion", "hide", "reveal", "toggle section"] },
    { "class": "nav", "attribute": "data-synth-dropdown", "reason": "data-synth-dropdown around a .button and a .nav list of links (SynthJS).", "keywords": ["dropdown", "drop down", "menu", "account menu", "user menu", "overflow menu"] },
    { "class": "alert", "attribute": "data-synth-dismiss", "reason": "An .alert with data-synth-dismissible and a data-synth-dismiss .button (SynthJS).", "keywords": ["dismiss", "dismissible", "dismissable", "closable", "close message"] }
  ],
  "compositionRules": {
    "recommended": [
      "Wrap each page in .container and give it a .stack or .stack-lg.",
      "Nest primitives: .split for headers, .cluster for button rows, .grid of .card for collections.",
      "Combine a component part with a layout primitive on one element, e.g. class=\"card-footer split\".",
      "Put components on native elements: <button>, <a href>, <table>, <label> + <input>.",
      "Wrap every .table in .table-wrap."
    ],
    "avoid": [
      "Margins between siblings; spacing comes from gap variants.",
      "Wrapper <div>s that add no layout intent.",
      "Restyling a component with extra CSS; override tokens on :root instead.",
      "Classes for state (is-active, disabled); use attributes.",
      "Visual reordering (order, *-reverse); DOM order is visual order.",
      "aria-pressed or classes for the current link or selected tab; use aria-current=\"page\" on .nav-link, aria-selected=\"true\" on .tabs-item."
    ]
  },
  "generationRules": [
    "Use only the classes and tokens in this contract; never invent class names.",
    "Build structure from layout primitives and nest them; never write custom flex or grid CSS.",
    "Set spacing with the -sm / -lg gap variants, never with margins or utility classes.",
    "Never use inline styles except a token override such as style=\"--grid-min: 12rem\".",
    "Write custom CSS only by the extension rule: [data-ui] selectors inside @layer synth.ext, var() token values only; never hard-code colors, px/rem sizes, shadows or durations.",
    "Put components on semantic native elements and keep one component per element.",
    "Express state with attributes: disabled, checked, aria-disabled=\"true\", aria-busy=\"true\", aria-invalid=\"true\", aria-current=\"page\" (nav), aria-selected=\"true\" (tabs).",
    "Pick variants by meaning, not look: button-danger for destructive actions, badge-success for success.",
    "Write no media queries or breakpoint classes; primitives adapt to the space they get.",
    "Keep it accessible: aria-label on .button-icon, role=\"status\" or role=\"alert\" on .alert, a <label for> on every control."
  ],
  "extension": {
    "rule": "When no class or composition fits: mark your own element with data-ui=\"<name>\" and style it only inside @layer synth.ext, with var(--…) token values only. This is the only legal custom CSS.",
    "steps": [
      "Compose the pattern from layout primitives and existing components first (see notCovered).",
      "Otherwise mark the element with data-ui=\"<name>\" (lowercase, dashed) and style it only with [data-ui=\"<name>\"] selectors inside @layer synth.ext { … }.",
      "Use only var(--…) token values; the only bare words allowed are the keywords. No px, rem, %, hex, numbers or !important.",
      "Add no class names; data-ui is the only hook.",
      "Do not override internals of SynthCSS classes: never select a class, and on an element that has SynthCSS classes set only properties those classes leave alone (unlayered SynthCSS rules beat synth.ext)."
    ],
    "attribute": "data-ui",
    "layer": "synth.ext",
    "values": "tokens only: every value is var(--…), optionally with the keywords; never a hard-coded length, color, shadow or duration",
    "properties": ["color", "background", "background-color", "border", "border-color", "border-width", "border-style", "border-radius", "border-block-start", "border-block-end", "border-inline-start", "border-inline-end", "box-shadow", "padding", "padding-block", "padding-inline", "padding-block-start", "padding-block-end", "padding-inline-start", "padding-inline-end", "font-family", "font-size", "font-weight", "line-height", "inline-size", "min-inline-size", "max-inline-size", "block-size", "min-block-size"],
    "keywords": ["solid", "none"],
    "notCovered": [
      {
        "pattern": "Avatar or initials",
        "use": ".avatar, plus .avatar-round for people",
        "html": "<span class=\"avatar avatar-round\" aria-hidden=\"true\">AL</span>"
      },
      {
        "pattern": "Icon tile",
        "use": ".avatar with a tint variant around an <svg aria-hidden=\"true\">",
        "html": "<span class=\"avatar avatar-accent\"><svg aria-hidden=\"true\" viewBox=\"0 0 24 24\">…</svg></span>"
      },
      {
        "pattern": "Nav link with current state",
        "use": ".nav + .nav-link, aria-current=\"page\" on the current one",
        "html": "<ul class=\"nav stack-sm\" role=\"list\"><li><a class=\"nav-link\" href=\"/\" aria-current=\"page\">Home</a></li><li><a class=\"nav-link\" href=\"/team\">Team</a></li></ul>"
      },
      {
        "pattern": "Tabs or segmented control",
        "use": ".tabs + .tabs-item, aria-selected on every tab",
        "html": "<div class=\"tabs\" role=\"tablist\" aria-label=\"Range\"><button type=\"button\" class=\"tabs-item\" role=\"tab\" aria-selected=\"true\">Week</button><button type=\"button\" class=\"tabs-item\" role=\"tab\" aria-selected=\"false\">Month</button></div>"
      },
      {
        "pattern": "Switch",
        "use": ".switch on a <label> around <input type=\"checkbox\" role=\"switch\">",
        "html": "<label class=\"switch\"><input type=\"checkbox\" role=\"switch\" checked> Email alerts</label>"
      },
      {
        "pattern": "Input with attached button",
        "use": ".input-group around one <input> and a .button",
        "html": "<div class=\"input-group\"><input type=\"search\" aria-label=\"Search\"><button type=\"submit\" class=\"button\">Search</button></div>"
      },
      {
        "pattern": "Narrow right column",
        "use": ".sidebar + .sidebar-end, width from --sidebar-width",
        "html": "<div class=\"sidebar sidebar-end\" style=\"--sidebar-width: 18rem\"><main>…</main><aside>…</aside></div>"
      },
      {
        "pattern": "Timeline",
        "use": "fallback, a .stack of items marked data-ui=\"timeline-item\" for the rail",
        "html": "<ol class=\"stack\" role=\"list\">\n  <li class=\"stack-sm\" data-ui=\"timeline-item\"><time datetime=\"2026-10-01\">Oct 1</time><p>Ana merged #42</p></li>\n  <li class=\"stack-sm\" data-ui=\"timeline-item\"><time datetime=\"2026-09-28\">Sep 28</time><p>Ben joined</p></li>\n</ol>",
        "css": "@layer synth.ext {\n  [data-ui=\"timeline-item\"] {\n    border-inline-start: var(--border-width) solid var(--color-border);\n    padding-inline-start: var(--space-4);\n  }\n}"
      }
    ]
  },
  "examples": {
    "valid": [
      {
        "html": "<main class=\"container stack-lg\">\n  <header class=\"split\">\n    <h1>Projects</h1>\n    <nav aria-label=\"Main\">\n      <ul class=\"nav cluster-sm\" role=\"list\">\n        <li><a class=\"nav-link\" href=\"/projects\" aria-current=\"page\">Projects</a></li>\n        <li><a class=\"nav-link\" href=\"/team\">Team</a></li>\n      </ul>\n    </nav>\n  </header>\n  <div class=\"split\">\n    <div class=\"tabs\" role=\"tablist\" aria-label=\"Filter projects\">\n      <button type=\"button\" class=\"tabs-item\" role=\"tab\" aria-selected=\"true\">Active</button>\n      <button type=\"button\" class=\"tabs-item\" role=\"tab\" aria-selected=\"false\">Archived</button>\n    </div>\n    <button type=\"button\" class=\"button button-primary\">New project</button>\n  </div>\n  <ul class=\"grid\" role=\"list\">\n    <li class=\"card\">\n      <div class=\"card-header\"><h2>Atlas</h2></div>\n      <div class=\"card-body\">Design system migration.</div>\n      <div class=\"card-footer split-sm\"><span class=\"badge badge-success\">Active</span></div>\n    </li>\n  </ul>\n</main>",
        "note": "Page: container + stack, split header with nav, tabs filter beside the main action, grid of cards with a status badge."
      },
      {
        "html": "<form class=\"card\">\n  <div class=\"field\">\n    <label class=\"field-label\" for=\"email\">Email</label>\n    <input id=\"email\" type=\"email\" aria-invalid=\"true\" aria-describedby=\"email-error\">\n    <p class=\"field-error\" id=\"email-error\">Enter a full email address.</p>\n  </div>\n  <div class=\"field\">\n    <label class=\"field-label\" for=\"invite\">Invite link</label>\n    <div class=\"input-group\"><input id=\"invite\" type=\"url\" readonly value=\"https://example.com/i/4f2a\"><button type=\"button\" class=\"button\">Copy</button></div>\n  </div>\n  <label class=\"switch\"><input type=\"checkbox\" role=\"switch\" checked> Require admin approval</label>\n  <div class=\"cluster-sm\">\n    <button type=\"submit\" class=\"button button-primary\">Save</button>\n    <button type=\"button\" class=\"button\">Cancel</button>\n  </div>\n</form>",
        "note": "Form: field with an error from aria-invalid, an invite link with a Copy button, a switch, actions in a cluster."
      },
      {
        "html": "<section class=\"stack\">\n  <header class=\"split\">\n    <h3>Team</h3>\n    <button type=\"button\" class=\"button button-primary\">Invite</button>\n  </header>\n  <div class=\"table-wrap\" tabindex=\"0\">\n    <table class=\"table\">\n      <thead><tr><th>Name</th><th>Role</th><th>Status</th></tr></thead>\n      <tbody>\n        <tr><td>Ana</td><td>Admin</td><td><span class=\"badge badge-success\">Active</span></td></tr>\n        <tr><td>Ben</td><td>Editor</td><td><span class=\"badge badge-warning\">Invited</span></td></tr>\n      </tbody>\n    </table>\n  </div>\n</section>",
        "note": "Data view: split header with an action, scrollable table with status badges."
      },
      {
        "html": "<div class=\"sidebar-lg sidebar-end\" style=\"--sidebar-width: 20rem\">\n  <main class=\"stack\">\n    <h1>Dashboard</h1>\n    <div class=\"alert alert-info\" role=\"status\">\n      <svg class=\"alert-icon\" aria-hidden=\"true\" viewBox=\"0 0 24 24\">…</svg>\n      <p>Billing moves to the 1st of each month.</p>\n    </div>\n    <div class=\"grid\">\n      <div class=\"card\">\n        <div class=\"cluster-sm\"><span class=\"avatar avatar-accent\"><svg aria-hidden=\"true\" viewBox=\"0 0 24 24\">…</svg></span><h2>Revenue</h2></div>\n        <p>$12,400 this month.</p>\n      </div>\n      <div class=\"card\">…</div>\n    </div>\n  </main>\n  <aside class=\"panel\">\n    <div class=\"panel-header\"><h2>Activity</h2></div>\n    <ul class=\"panel-body stack-sm\" role=\"list\">\n      <li class=\"cluster-sm\"><span class=\"avatar avatar-round avatar-sm avatar-primary\" aria-hidden=\"true\">AL</span><span>Ana merged #42</span></li>\n      <li class=\"cluster-sm\"><img class=\"avatar avatar-round avatar-sm\" src=\"/ben.jpg\" alt=\"\"><span>Ben joined</span></li>\n    </ul>\n  </aside>\n</div>",
        "note": "Dashboard: main content first, narrow column on the right; an alert with an icon, an icon tile in a card, and people as avatars."
      },
      {
        "html": "<!doctype html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"utf-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n  <title>Overview · Acme</title>\n  <link rel=\"stylesheet\" href=\"synthcss.min.css\">\n  <style>\n    @layer synth.ext {\n      [data-ui=\"app\"] { font-family: var(--font-sans); font-size: var(--text-base); color: var(--color-text); background: var(--color-surface); }\n    }\n  </style>\n</head>\n<body data-ui=\"app\">\n  <div class=\"sidebar-lg\" style=\"--sidebar-width: 14rem\">\n    <nav class=\"panel\" aria-label=\"Main\">\n      <strong>Acme</strong>\n      <ul class=\"nav stack-sm\" role=\"list\">\n        <li><a class=\"nav-link\" href=\"/\" aria-current=\"page\">Overview</a></li>\n        <li><a class=\"nav-link\" href=\"/projects\">Projects</a></li>\n        <li><a class=\"nav-link\" href=\"/settings\">Settings</a></li>\n      </ul>\n    </nav>\n    <main class=\"container stack-lg\">\n      <header class=\"split\">\n        <h1>Overview</h1>\n        <button type=\"button\" class=\"button button-primary\">New project</button>\n      </header>\n      <ul class=\"grid\" role=\"list\" style=\"--grid-min: 12rem\">\n        <li class=\"card\"><p>Revenue</p><strong>$12,400</strong></li>\n        <li class=\"card\"><p>Active projects</p><strong>8</strong></li>\n        <li class=\"card\"><p>Open issues</p><strong>23</strong></li>\n      </ul>\n      <div class=\"sidebar-lg sidebar-end\">\n        <section class=\"card\">\n          <div class=\"card-header\"><h2>Recent projects</h2></div>\n          <div class=\"table-wrap\" tabindex=\"0\">\n            <table class=\"table\">\n              <thead><tr><th>Name</th><th>Status</th></tr></thead>\n              <tbody><tr><td>Atlas</td><td><span class=\"badge badge-success\">Active</span></td></tr></tbody>\n            </table>\n          </div>\n        </section>\n        <aside class=\"panel\">\n          <div class=\"panel-header\"><h2>Team</h2></div>\n          <ul class=\"panel-body stack-sm\" role=\"list\">\n            <li class=\"cluster-sm\"><span class=\"avatar avatar-round avatar-sm\" aria-hidden=\"true\">AL</span><span>Ana Lee</span></li>\n          </ul>\n        </aside>\n      </div>\n    </main>\n  </div>\n</body>\n</html>",
        "note": "App shell: a full page with .sidebar navigation, a .container stack-lg main area, a .split header with the main action, a .grid of stat cards and a main/side row. Body font setup uses the extension rule with tokens only."
      }
    ],
    "invalid": [
      {
        "html": "<div class=\"flex-row-gap-large-center\">…</div>",
        "note": "Invented class. Use .cluster-lg."
      },
      {
        "html": "<div style=\"display:flex; gap:16px\">…</div>",
        "note": "Inline flex and gap. Use .cluster."
      },
      {
        "html": "<button class=\"btn btn-primary\">Save</button>",
        "note": "Another framework's names. Use .button and .button-primary."
      },
      {
        "html": "<span class=\"badge badge-red\">Failed</span>",
        "note": "Color-named variant. Use .badge and .badge-danger."
      },
      {
        "html": "<p class=\"mt-4\">Saved.</p>",
        "note": "Spacing utility. Use .stack on the parent."
      },
      {
        "html": "<a class=\"nav-link active\" href=\"/team\">Team</a>",
        "note": "State class. Use .nav-link with aria-current=\"page\"."
      },
      {
        "html": "<button class=\"tabs-item\" aria-pressed=\"true\">Week</button>",
        "note": "aria-pressed for a tab. Use .tabs-item with role=\"tab\" and aria-selected=\"true\"."
      },
      {
        "html": "<span class=\"user-avatar rounded-full\">AL</span>",
        "note": "Invented classes. Use .avatar and .avatar-round."
      }
    ],
    "patterns": {
      "dashboard-header": {
        "html": "<header class=\"split\">\n  <div class=\"stack-sm\">\n    <h1>Dashboard</h1>\n    <p>Updated 5 minutes ago.</p>\n  </div>\n  <div class=\"cluster-sm\">\n    <button type=\"button\" class=\"button\">Export</button>\n    <button type=\"button\" class=\"button button-primary\">New report</button>\n  </div>\n</header>",
        "note": "Page header: .split puts the title group and the actions at opposite ends; the actions sit in a .cluster-sm with the main action last."
      },
      "settings-form": {
        "html": "<form class=\"stack\">\n  <div class=\"field\">\n    <label class=\"field-label\" for=\"workspace\">Workspace name</label>\n    <input id=\"workspace\" type=\"text\" aria-describedby=\"workspace-help\">\n    <p class=\"field-help\" id=\"workspace-help\">Shown to everyone you invite.</p>\n  </div>\n  <div class=\"field\">\n    <label class=\"field-label\" for=\"timezone\">Time zone</label>\n    <select id=\"timezone\"><option>UTC</option><option>Europe/Berlin</option></select>\n  </div>\n  <label class=\"switch\"><input type=\"checkbox\" role=\"switch\" checked> Email notifications</label>\n  <div class=\"cluster-sm\">\n    <button type=\"submit\" class=\"button button-primary\">Save changes</button>\n    <button type=\"button\" class=\"button\">Cancel</button>\n  </div>\n</form>",
        "note": "Settings form: a .stack of .field controls with labels and help text, a .switch, and the actions in a .cluster-sm."
      },
      "card-grid": {
        "html": "<ul class=\"grid\" role=\"list\" style=\"--grid-min: 16rem\">\n  <li class=\"card\">\n    <div class=\"card-header\"><h2>Atlas</h2></div>\n    <div class=\"card-body\">Design system migration.</div>\n    <div class=\"card-footer split-sm\"><span class=\"badge badge-success\">Active</span><a href=\"/projects/atlas\">Open</a></div>\n  </li>\n  <li class=\"card\">\n    <div class=\"card-header\"><h2>Beacon</h2></div>\n    <div class=\"card-body\">Status page rewrite.</div>\n    <div class=\"card-footer split-sm\"><span class=\"badge badge-warning\">Paused</span><a href=\"/projects/beacon\">Open</a></div>\n  </li>\n</ul>",
        "note": "Collection: a .grid list of .card items with header, body and a .split-sm footer; --grid-min sets the column width."
      },
      "dialog": {
        "html": "<button type=\"button\" class=\"button button-danger\" data-synth-open=\"delete-dialog\">Delete project</button>\n<dialog id=\"delete-dialog\" aria-labelledby=\"delete-dialog-title\">\n  <div class=\"stack\">\n    <h2 id=\"delete-dialog-title\">Delete project?</h2>\n    <p>This removes the project and its history for everyone.</p>\n    <div class=\"cluster-sm\">\n      <button type=\"button\" class=\"button button-danger\">Delete</button>\n      <button type=\"button\" class=\"button\" data-synth-dismiss>Cancel</button>\n    </div>\n  </div>\n</dialog>",
        "note": "Modal dialog (SynthJS): data-synth-open names the <dialog> id, data-synth-dismiss closes it, aria-labelledby labels it."
      },
      "tabs": {
        "html": "<div class=\"stack\" data-synth-tabs>\n  <div class=\"tabs\" role=\"tablist\" aria-label=\"Report range\">\n    <button type=\"button\" class=\"tabs-item\" role=\"tab\" id=\"tab-week\" aria-controls=\"panel-week\" aria-selected=\"true\">Week</button>\n    <button type=\"button\" class=\"tabs-item\" role=\"tab\" id=\"tab-month\" aria-controls=\"panel-month\" aria-selected=\"false\">Month</button>\n  </div>\n  <div role=\"tabpanel\" id=\"panel-week\" aria-labelledby=\"tab-week\">…</div>\n  <div role=\"tabpanel\" id=\"panel-month\" aria-labelledby=\"tab-month\" hidden>…</div>\n</div>",
        "note": "Tabs that switch panels (SynthJS): data-synth-tabs around a labeled .tabs list; each .tabs-item names its panel with aria-controls."
      },
      "empty-state": {
        "html": "<div class=\"empty-state\">\n  <svg aria-hidden=\"true\" viewBox=\"0 0 24 24\">…</svg>\n  <h2>No projects yet</h2>\n  <p>Projects group your reports and your team.</p>\n  <button type=\"button\" class=\"button button-primary\">Create project</button>\n</div>",
        "note": "Nothing to show yet: an .empty-state with a decorative icon, a heading, one sentence and the main action."
      }
    }
  }
}
