@flowstack-ui/brick 0.1.9 → 0.1.12

package/dist/agents/layer-selection.json

@@ -15,49 +15,1287 @@
   ],
   "selection": [
     {
-      "intent": "text with Brick typography",
+      "intent": "headings, paragraphs, captions, and eyebrows",
+      "use": "Heading, Paragraph, Caption, or Eyebrow",
+      "note": "Give Heading an explicit semantic level and choose its visual variant independently.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "text"
+        }
+      ]
+    },
+    {
+      "intent": "other text with Brick typography",
       "use": "Text",
-      "note": "Choose the semantic rendered element through its public API."
+      "note": "Choose the semantic rendered element through its public API and author the intended letter case in content.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "text"
+        }
+      ]
+    },
+    {
+      "intent": "stress emphasis inside meaningful copy",
+      "use": "Em",
+      "note": "Keep Em inside the surrounding Text or component content owner and do not use it only for decorative italics.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "em"
+        },
+        {
+          "kind": "component",
+          "id": "text"
+        }
+      ]
+    },
+    {
+      "intent": "static authored relevance inside meaningful copy",
+      "use": "Mark",
+      "note": "Choose Highlight when a query must discover and segment matches; use Mark only when the author already knows the relevant passage.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "mark"
+        },
+        {
+          "kind": "component",
+          "id": "highlight"
+        },
+        {
+          "kind": "component",
+          "id": "text"
+        }
+      ]
+    },
+    {
+      "intent": "literal query matches inside one plain text string",
+      "use": "Highlight",
+      "note": "Pass plain text and literal queries to exact Atom-backed matching; keep rich-content traversal, search state, and active-result navigation in the application.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "highlight"
+        },
+        {
+          "kind": "component",
+          "id": "mark"
+        },
+        {
+          "kind": "component",
+          "id": "text"
+        }
+      ]
+    },
+    {
+      "intent": "trusted long-form React content with coherent descendant typography",
+      "use": "Prose",
+      "note": "Sanitize and parse external content before it reaches Prose; keep document semantics and trust policy in the application, and use direct Brick components for richer anatomy.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "prose"
+        },
+        {
+          "kind": "component",
+          "id": "text"
+        },
+        {
+          "kind": "component",
+          "id": "link"
+        },
+        {
+          "kind": "component",
+          "id": "list"
+        },
+        {
+          "kind": "component",
+          "id": "blockquote"
+        },
+        {
+          "kind": "component",
+          "id": "code-block"
+        },
+        {
+          "kind": "component",
+          "id": "table"
+        },
+        {
+          "kind": "component",
+          "id": "image"
+        }
+      ]
+    },
+    {
+      "intent": "keyboard-input notation inside meaningful copy",
+      "use": "Kbd",
+      "note": "Repeat one Kbd per authored key and keep visible separators outside; shortcut behavior and platform-label policy remain application-owned.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "kbd"
+        },
+        {
+          "kind": "component",
+          "id": "text"
+        },
+        {
+          "kind": "component",
+          "id": "code"
+        }
+      ]
+    },
+    {
+      "intent": "extended quotation with visible attribution",
+      "use": "Blockquote",
+      "note": "Keep Content and Caption as siblings in Root, put the source URL on Content, and use Cite for a referenced work or source rather than merely a person's name.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "blockquote"
+        },
+        {
+          "kind": "component",
+          "id": "text"
+        }
+      ]
     },
     {
       "intent": "one-dimensional alignment",
       "use": "Stack, HStack, or VStack",
-      "note": "Use Grid for two-dimensional track relationships."
+      "note": "Use Grid for two-dimensional track relationships.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "stack"
+        },
+        {
+          "kind": "component",
+          "id": "grid"
+        }
+      ]
     },
     {
       "intent": "bounded page width",
       "use": "Container",
-      "note": "Use Surface or Card when the region also needs a visual boundary."
+      "note": "Use Surface or Card when the region also needs a visual boundary.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "container"
+        },
+        {
+          "kind": "component",
+          "id": "surface"
+        },
+        {
+          "kind": "component",
+          "id": "card"
+        }
+      ]
     },
     {
       "intent": "top application or page bar",
       "use": "AppBar",
-      "note": "Compose navigation and action components inside its sections."
+      "note": "Compose navigation and action components inside its sections.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "app-bar"
+        }
+      ]
     },
     {
       "intent": "responsive presence",
       "use": "Show or Hide",
-      "note": "Use CSS media visibility rather than rendering two JavaScript-controlled trees."
+      "note": "Use CSS media visibility rather than rendering two JavaScript-controlled trees.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "show"
+        },
+        {
+          "kind": "component",
+          "id": "hide"
+        }
+      ]
     },
     {
       "intent": "image with resilient loading",
       "use": "Image",
-      "note": "Use an adapter only when a framework image optimizer provides a measured capability Brick lacks."
+      "note": "Use an adapter only when a framework image optimizer provides a measured capability Brick lacks.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "image"
+        }
+      ]
+    },
+    {
+      "intent": "stable media or embed geometry before its content loads",
+      "use": "AspectRatio",
+      "note": "Choose Image when the asset owns resilient loading, Surface for a general visual boundary, and Skeleton for a temporary loading placeholder.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "aspect-ratio"
+        },
+        {
+          "kind": "component",
+          "id": "image"
+        },
+        {
+          "kind": "component",
+          "id": "surface"
+        },
+        {
+          "kind": "component",
+          "id": "skeleton"
+        }
+      ]
+    },
+    {
+      "intent": "preserved multi-line technical source",
+      "use": "Code Block",
+      "note": "Keep syntax tokenization in a consumer adapter, pass the exact plain source separately for copy behavior, author line metadata explicitly, and use the bounded/collapse contract for long source.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "code-block"
+        },
+        {
+          "kind": "component",
+          "id": "collapsible"
+        }
+      ]
     },
     {
       "intent": "navigation destination",
       "use": "Link or Button with href",
-      "note": "Use Link for ordinary navigation and Button only for an emphasized destination."
+      "note": "Use Link for ordinary navigation and Button only for an emphasized destination.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "link"
+        },
+        {
+          "kind": "component",
+          "id": "button"
+        }
+      ]
     },
     {
       "intent": "grouped disclosure sections",
       "use": "Accordion",
-      "note": "Choose Collapsible for one independent disclosure and Tabs for one shared switching panel."
+      "note": "Choose Collapsible for one independent disclosure and Tabs for one shared switching panel.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "accordion"
+        },
+        {
+          "kind": "component",
+          "id": "collapsible"
+        },
+        {
+          "kind": "component",
+          "id": "tabs"
+        }
+      ]
+    },
+    {
+      "intent": "ordinary blocking task, form, settings flow, or focused information",
+      "use": "Dialog",
+      "note": "Choose AlertDialog for one urgent consequential decision and Drawer when the temporary task belongs at a screen edge.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "dialog"
+        },
+        {
+          "kind": "component",
+          "id": "alert-dialog"
+        },
+        {
+          "kind": "component",
+          "id": "drawer"
+        }
+      ]
+    },
+    {
+      "intent": "urgent or consequential decision that requires an explicit response",
+      "use": "AlertDialog",
+      "note": "Keep a safe Cancel before Action; choose Dialog for ordinary forms and information.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "alert-dialog"
+        },
+        {
+          "kind": "component",
+          "id": "dialog"
+        }
+      ]
+    },
+    {
+      "intent": "compact anchored interactive panel",
+      "use": "Popover",
+      "note": "Choose Tooltip or HoverCard for noninteractive context, DropdownMenu for commands, Select or Combobox for option selection, and Dialog for a larger blocking task.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "popover"
+        },
+        {
+          "kind": "component",
+          "id": "tooltip"
+        },
+        {
+          "kind": "component",
+          "id": "hover-card"
+        },
+        {
+          "kind": "component",
+          "id": "dropdown-menu"
+        },
+        {
+          "kind": "component",
+          "id": "select"
+        },
+        {
+          "kind": "component",
+          "id": "combobox"
+        },
+        {
+          "kind": "component",
+          "id": "dialog"
+        }
+      ]
+    },
+    {
+      "intent": "commands or settings opened from one visible button",
+      "use": "DropdownMenu",
+      "note": "Choose ContextMenu for contextual invocation, Menubar for persistent application command categories, Select for a form value, and NavigationMenu or NavList for navigation.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "dropdown-menu"
+        },
+        {
+          "kind": "component",
+          "id": "context-menu"
+        },
+        {
+          "kind": "component",
+          "id": "menubar"
+        },
+        {
+          "kind": "component",
+          "id": "select"
+        },
+        {
+          "kind": "component",
+          "id": "navigation-menu"
+        },
+        {
+          "kind": "component",
+          "id": "nav-list"
+        }
+      ]
+    },
+    {
+      "intent": "target-specific commands invoked by secondary click, keyboard context action, or supported long press",
+      "use": "ContextMenu",
+      "note": "Keep a visible Button or DropdownMenu route to every important command.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "context-menu"
+        },
+        {
+          "kind": "component",
+          "id": "button"
+        },
+        {
+          "kind": "component",
+          "id": "dropdown-menu"
+        }
+      ]
+    },
+    {
+      "intent": "persistent desktop-like application command categories",
+      "use": "Menubar",
+      "note": "Choose DropdownMenu for one temporary command menu, NavigationMenu or NavList for routes, Toolbar for immediately executable controls, and Drawer only as an application-selected mobile alternative.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "menubar"
+        },
+        {
+          "kind": "component",
+          "id": "dropdown-menu"
+        },
+        {
+          "kind": "component",
+          "id": "navigation-menu"
+        },
+        {
+          "kind": "component",
+          "id": "nav-list"
+        },
+        {
+          "kind": "component",
+          "id": "toolbar"
+        },
+        {
+          "kind": "component",
+          "id": "drawer"
+        }
+      ]
+    },
+    {
+      "intent": "redundant passive preview for a genuine link or focusable subject",
+      "use": "HoverCard",
+      "note": "Choose Tooltip for one short hint, Popover for interaction, Dialog for a larger task, and visible Text when the information is essential.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "hover-card"
+        },
+        {
+          "kind": "component",
+          "id": "tooltip"
+        },
+        {
+          "kind": "component",
+          "id": "popover"
+        },
+        {
+          "kind": "component",
+          "id": "dialog"
+        },
+        {
+          "kind": "component",
+          "id": "text"
+        }
+      ]
+    },
+    {
+      "intent": "brief supplemental description for an already named control",
+      "use": "Tooltip",
+      "note": "Choose HoverCard for a richer passive preview, Popover for interaction, and visible Text for essential information.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "tooltip"
+        },
+        {
+          "kind": "component",
+          "id": "hover-card"
+        },
+        {
+          "kind": "component",
+          "id": "popover"
+        },
+        {
+          "kind": "component",
+          "id": "text"
+        }
+      ]
+    },
+    {
+      "intent": "exactly one form choice from a short visible set",
+      "use": "RadioGroup",
+      "note": "Choose CheckboxGroup for independent choices, Select for a compact longer list, and ToggleGroup for pressed commands.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "radio-group"
+        },
+        {
+          "kind": "component",
+          "id": "checkbox-group"
+        },
+        {
+          "kind": "component",
+          "id": "select"
+        },
+        {
+          "kind": "component",
+          "id": "toggle-group"
+        }
+      ]
+    },
+    {
+      "intent": "any number of related form choices",
+      "use": "CheckboxGroup",
+      "note": "Choose Checkbox for one independent choice, RadioGroup for exactly one choice, and ToggleGroup for pressed commands.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "checkbox-group"
+        },
+        {
+          "kind": "component",
+          "id": "checkbox"
+        },
+        {
+          "kind": "component",
+          "id": "radio-group"
+        },
+        {
+          "kind": "component",
+          "id": "toggle-group"
+        }
+      ]
+    },
+    {
+      "intent": "immediately applied on or off setting",
+      "use": "Switch",
+      "note": "Choose Checkbox for a deferred form answer and Toggle for a persistent pressed command.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "switch"
+        },
+        {
+          "kind": "component",
+          "id": "checkbox"
+        },
+        {
+          "kind": "component",
+          "id": "toggle"
+        }
+      ]
+    },
+    {
+      "intent": "one command with persistent pressed state",
+      "use": "Toggle",
+      "note": "Choose Button for a momentary action, Switch for an immediate setting, Checkbox for a submitted choice, and ToggleGroup for related pressed commands.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "toggle"
+        },
+        {
+          "kind": "component",
+          "id": "button"
+        },
+        {
+          "kind": "component",
+          "id": "switch"
+        },
+        {
+          "kind": "component",
+          "id": "checkbox"
+        },
+        {
+          "kind": "component",
+          "id": "toggle-group"
+        }
+      ]
+    },
+    {
+      "intent": "related keyboard-navigable pressed commands",
+      "use": "ToggleGroup",
+      "note": "Choose Toggle for one command, RadioGroup or CheckboxGroup for form choices, Switch for immediate settings, and Tabs for switching panels.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "toggle-group"
+        },
+        {
+          "kind": "component",
+          "id": "toggle"
+        },
+        {
+          "kind": "component",
+          "id": "radio-group"
+        },
+        {
+          "kind": "component",
+          "id": "checkbox-group"
+        },
+        {
+          "kind": "component",
+          "id": "switch"
+        },
+        {
+          "kind": "component",
+          "id": "tabs"
+        }
+      ]
+    },
+    {
+      "intent": "exact numeric value with typing and step actions",
+      "use": "NumberInput",
+      "note": "Choose Slider for approximate spatial adjustment, Input for numeric-looking identifiers, Select or RadioGroup for a small fixed set, and Progress for read-only completion.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "number-input"
+        },
+        {
+          "kind": "component",
+          "id": "slider"
+        },
+        {
+          "kind": "component",
+          "id": "input"
+        },
+        {
+          "kind": "component",
+          "id": "select"
+        },
+        {
+          "kind": "component",
+          "id": "radio-group"
+        },
+        {
+          "kind": "component",
+          "id": "progress"
+        }
+      ]
+    },
+    {
+      "intent": "one predefined form value from a compact collapsed collection",
+      "use": "Select",
+      "note": "Choose RadioGroup for a short visible set, Combobox for editable filtering, MultiSelect for several values, DropdownMenu for commands, and Link for navigation.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "select"
+        },
+        {
+          "kind": "component",
+          "id": "radio-group"
+        },
+        {
+          "kind": "component",
+          "id": "combobox"
+        },
+        {
+          "kind": "component",
+          "id": "multi-select"
+        },
+        {
+          "kind": "component",
+          "id": "dropdown-menu"
+        },
+        {
+          "kind": "component",
+          "id": "link"
+        }
+      ]
+    },
+    {
+      "intent": "several predefined form values from a compact collapsed collection",
+      "use": "MultiSelect",
+      "note": "Choose CheckboxGroup for a short visible set, Select for one value, and Combobox only when its single-value editable model fits; record a Brick gap for unsupported tag creation or other specialized multi-value behavior.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "multi-select"
+        },
+        {
+          "kind": "component",
+          "id": "checkbox-group"
+        },
+        {
+          "kind": "component",
+          "id": "select"
+        },
+        {
+          "kind": "component",
+          "id": "combobox"
+        }
+      ]
+    },
+    {
+      "intent": "editable filtering and one committed option value",
+      "use": "Combobox",
+      "note": "Choose Input when any text is valid without options, Select for a compact noneditable list, RadioGroup for a short visible set, MultiSelect for several predefined values, and DropdownMenu for commands.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "combobox"
+        },
+        {
+          "kind": "component",
+          "id": "input"
+        },
+        {
+          "kind": "component",
+          "id": "select"
+        },
+        {
+          "kind": "component",
+          "id": "radio-group"
+        },
+        {
+          "kind": "component",
+          "id": "multi-select"
+        },
+        {
+          "kind": "component",
+          "id": "dropdown-menu"
+        }
+      ]
+    },
+    {
+      "intent": "persistently visible composite option collection",
+      "use": "record a Brick gap before application-owned implementation",
+      "note": "Brick has no public owner for this job. Do not import Atom directly; first reconsider RadioGroup or CheckboxGroup for visible form choices, Select or MultiSelect for collapsed choices, and Combobox for editable filtering.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "radio-group"
+        },
+        {
+          "kind": "component",
+          "id": "checkbox-group"
+        },
+        {
+          "kind": "component",
+          "id": "select"
+        },
+        {
+          "kind": "component",
+          "id": "multi-select"
+        },
+        {
+          "kind": "component",
+          "id": "combobox"
+        }
+      ]
+    },
+    {
+      "intent": "short one-time verification, recovery, or pairing code",
+      "use": "OTPField",
+      "note": "Choose PasswordToggleField for a reusable secret, NumberInput for a quantity, and Input for an ordinary identifier or variable-length value.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "otp-field"
+        },
+        {
+          "kind": "component",
+          "id": "password-toggle-field"
+        },
+        {
+          "kind": "component",
+          "id": "number-input"
+        },
+        {
+          "kind": "component",
+          "id": "input"
+        }
+      ]
+    },
+    {
+      "intent": "password entry with an allowed reveal action",
+      "use": "PasswordToggleField",
+      "note": "Choose Input with type=password when reveal is forbidden or unwanted and OTPField for a one-time code.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "password-toggle-field"
+        },
+        {
+          "kind": "component",
+          "id": "input"
+        },
+        {
+          "kind": "component",
+          "id": "otp-field"
+        }
+      ]
+    },
+    {
+      "intent": "local file picking, optional drop, review, and removal before application processing",
+      "use": "FileUpload",
+      "note": "Choose Input for a textual path or URL, Progress for transfer progress, Toast for a transient result, and Image for a rendered asset; keep server validation and upload transport in the application.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "file-upload"
+        },
+        {
+          "kind": "component",
+          "id": "input"
+        },
+        {
+          "kind": "component",
+          "id": "progress"
+        },
+        {
+          "kind": "component",
+          "id": "toast"
+        },
+        {
+          "kind": "component",
+          "id": "image"
+        }
+      ]
+    },
+    {
+      "intent": "short non-blocking application outcome or process update",
+      "use": "Toast",
+      "note": "Choose Field or Form feedback for validation, Progress for numeric completion, AlertDialog for a required response, and persistent application content for essential or durable information.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "toast"
+        },
+        {
+          "kind": "component",
+          "id": "field"
+        },
+        {
+          "kind": "component",
+          "id": "form"
+        },
+        {
+          "kind": "component",
+          "id": "progress"
+        },
+        {
+          "kind": "component",
+          "id": "alert-dialog"
+        }
+      ]
+    },
+    {
+      "intent": "touch-enhanced quick actions for a list-like row with an obvious click alternative",
+      "use": "SwipeableItem",
+      "note": "Choose DropdownMenu for a larger command set, Button or IconButton for continuously visible actions, and Link when the row navigates.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "swipeable-item"
+        },
+        {
+          "kind": "component",
+          "id": "dropdown-menu"
+        },
+        {
+          "kind": "component",
+          "id": "button"
+        },
+        {
+          "kind": "component",
+          "id": "icon-button"
+        },
+        {
+          "kind": "component",
+          "id": "link"
+        }
+      ]
+    },
+    {
+      "intent": "one independent in-flow disclosure region",
+      "use": "Collapsible",
+      "note": "Choose Accordion for coordinated peer sections, Dialog or Drawer for a modal task, Popover for an anchored layer, and Show or Hide for responsive presence.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "collapsible"
+        },
+        {
+          "kind": "component",
+          "id": "accordion"
+        },
+        {
+          "kind": "component",
+          "id": "dialog"
+        },
+        {
+          "kind": "component",
+          "id": "drawer"
+        },
+        {
+          "kind": "component",
+          "id": "popover"
+        },
+        {
+          "kind": "component",
+          "id": "show"
+        },
+        {
+          "kind": "component",
+          "id": "hide"
+        }
+      ]
+    },
+    {
+      "intent": "one-column hierarchical navigation and optional selection",
+      "use": "Tree",
+      "note": "Choose TreeGrid for hierarchical rows with navigable columns, Accordion or Collapsible for arbitrary disclosure content, DataGrid for flat interactive tabular data, and List for static hierarchy.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "tree"
+        },
+        {
+          "kind": "component",
+          "id": "tree-grid"
+        },
+        {
+          "kind": "component",
+          "id": "accordion"
+        },
+        {
+          "kind": "component",
+          "id": "collapsible"
+        },
+        {
+          "kind": "component",
+          "id": "data-grid"
+        },
+        {
+          "kind": "component",
+          "id": "list"
+        }
+      ]
+    },
+    {
+      "intent": "hierarchical rows with several navigable columns",
+      "use": "TreeGrid",
+      "note": "Choose Tree for one primary hierarchy column, DataGrid for flat interactive rows, Table for read-oriented tabular relationships, and an application-owned data tool for editing or independent cell controls.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "tree-grid"
+        },
+        {
+          "kind": "component",
+          "id": "tree"
+        },
+        {
+          "kind": "component",
+          "id": "data-grid"
+        },
+        {
+          "kind": "component",
+          "id": "table"
+        }
+      ]
+    },
+    {
+      "intent": "flat tabular data with composite cell navigation or row selection",
+      "use": "DataGrid",
+      "note": "Choose Table for read-oriented comparison, TreeGrid for hierarchical rows, and an application-owned data tool for editing, column management, or an enterprise data engine.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "data-grid"
+        },
+        {
+          "kind": "component",
+          "id": "table"
+        },
+        {
+          "kind": "component",
+          "id": "tree-grid"
+        }
+      ]
+    },
+    {
+      "intent": "read-oriented row and column comparison",
+      "use": "Table",
+      "note": "Choose DataGrid for composite cell navigation or row selection, TreeGrid for hierarchical interactive rows, and List when meaningful column relationships are absent.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "table"
+        },
+        {
+          "kind": "component",
+          "id": "data-grid"
+        },
+        {
+          "kind": "component",
+          "id": "tree-grid"
+        },
+        {
+          "kind": "component",
+          "id": "list"
+        }
+      ]
+    },
+    {
+      "intent": "changing stream of focusable articles with article-to-article keyboard movement",
+      "use": "Feed",
+      "note": "Choose List for a static sequence, Table or DataGrid for tabular relationships, Tree for hierarchy, and Stack or Grid for purely visual arrangement.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "feed"
+        },
+        {
+          "kind": "component",
+          "id": "list"
+        },
+        {
+          "kind": "component",
+          "id": "table"
+        },
+        {
+          "kind": "component",
+          "id": "data-grid"
+        },
+        {
+          "kind": "component",
+          "id": "tree"
+        },
+        {
+          "kind": "component",
+          "id": "stack"
+        },
+        {
+          "kind": "component",
+          "id": "grid"
+        }
+      ]
+    },
+    {
+      "intent": "linear read-only task completion or indeterminate work",
+      "use": "Progress",
+      "note": "Choose ProgressCircle when compact circular geometry is important, Slider for editable values, Toast for a transient outcome, and Skeleton for unknown content loading.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "progress"
+        },
+        {
+          "kind": "component",
+          "id": "progress-circle"
+        },
+        {
+          "kind": "component",
+          "id": "slider"
+        },
+        {
+          "kind": "component",
+          "id": "toast"
+        },
+        {
+          "kind": "component",
+          "id": "skeleton"
+        }
+      ]
+    },
+    {
+      "intent": "compact circular read-only task completion or indeterminate work",
+      "use": "ProgressCircle",
+      "note": "Choose Progress for linear completion, Slider for editable values, and Skeleton for unknown content loading.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "progress-circle"
+        },
+        {
+          "kind": "component",
+          "id": "progress"
+        },
+        {
+          "kind": "component",
+          "id": "slider"
+        },
+        {
+          "kind": "component",
+          "id": "skeleton"
+        }
+      ]
+    },
+    {
+      "intent": "visual count or presence dot over one owning element",
+      "use": "NotificationBadge",
+      "note": "Choose Badge for an in-flow passive label or count, Status for a named state, Button for an actionable count, and visible Text when the value must be announced or understood without the owner; NotificationBadge does not announce changes.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "notification-badge"
+        },
+        {
+          "kind": "component",
+          "id": "badge"
+        },
+        {
+          "kind": "component",
+          "id": "status"
+        },
+        {
+          "kind": "component",
+          "id": "button"
+        },
+        {
+          "kind": "component",
+          "id": "text"
+        }
+      ]
+    },
+    {
+      "intent": "compact identity for a named person, organization, or entity",
+      "use": "Avatar",
+      "note": "Choose Image for a larger editorial portrait and NotificationBadge only when the owning Avatar needs a separate visual count or presence indicator.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "avatar"
+        },
+        {
+          "kind": "component",
+          "id": "image"
+        },
+        {
+          "kind": "component",
+          "id": "notification-badge"
+        }
+      ]
+    },
+    {
+      "intent": "short passive in-flow label, category, status, or count",
+      "use": "Badge",
+      "note": "Choose NotificationBadge for an overlaid count or dot, Status for richer named state semantics, and Button when the label is actionable.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "badge"
+        },
+        {
+          "kind": "component",
+          "id": "notification-badge"
+        },
+        {
+          "kind": "component",
+          "id": "status"
+        },
+        {
+          "kind": "component",
+          "id": "button"
+        }
+      ]
+    },
+    {
+      "intent": "editable, selectable, or submitted opaque hexadecimal color",
+      "use": "ColorPicker",
+      "note": "Choose ColorSwatch for a passive preview; richer alpha, gradient, channel, eyedropper, and color-space editing remains an Atom-first gap.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "color-picker"
+        },
+        {
+          "kind": "component",
+          "id": "color-swatch"
+        }
+      ]
+    },
+    {
+      "intent": "passive preview of one color or a compact color mix",
+      "use": "ColorSwatch",
+      "note": "Choose ColorPicker when the user must edit, select, or submit the value; keep interaction on a semantic owner.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "color-swatch"
+        },
+        {
+          "kind": "component",
+          "id": "color-picker"
+        }
+      ]
+    },
+    {
+      "intent": "short assistive-only equivalent for meaning already conveyed visually",
+      "use": "VisuallyHidden",
+      "note": "Choose visible Text for essential instructions, state, errors, or announcements, and keep an IconButton or Button itself visible while placing the hidden equivalent inside it.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "visually-hidden"
+        },
+        {
+          "kind": "component",
+          "id": "text"
+        },
+        {
+          "kind": "component",
+          "id": "icon-button"
+        },
+        {
+          "kind": "component",
+          "id": "button"
+        }
+      ]
+    },
+    {
+      "intent": "approximate numeric value or ordered range through spatial manipulation",
+      "use": "Slider",
+      "note": "Choose NumberInput for exact entry, Progress for read-only completion, and Rating for a short ordered score.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "slider"
+        },
+        {
+          "kind": "component",
+          "id": "number-input"
+        },
+        {
+          "kind": "component",
+          "id": "progress"
+        },
+        {
+          "kind": "component",
+          "id": "rating"
+        }
+      ]
+    },
+    {
+      "intent": "short ordered score input or recognizable passive score aggregate",
+      "use": "Rating",
+      "note": "Choose Slider for a general numeric setting and RadioGroup when choices have distinct categorical meanings.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "rating"
+        },
+        {
+          "kind": "component",
+          "id": "slider"
+        },
+        {
+          "kind": "component",
+          "id": "radio-group"
+        }
+      ]
     },
     {
       "intent": "ordered or unordered content",
       "use": "List",
-      "note": "Choose NavList, an interactive collection, Table, or DataGrid when rows navigate, select, activate, or expose data relationships."
+      "note": "Choose NavList, an interactive collection, Table, or DataGrid when rows navigate, select, activate, or expose data relationships.",
+      "destinations": [
+        {
+          "kind": "component",
+          "id": "list"
+        },
+        {
+          "kind": "component",
+          "id": "nav-list"
+        },
+        {
+          "kind": "component",
+          "id": "table"
+        },
+        {
+          "kind": "component",
+          "id": "data-grid"
+        }
+      ]
     }
   ],
   "rules": [
@@ -110,10 +1348,55 @@
     "stack",
     "grid",
     "text",
+    "em",
+    "mark",
+    "highlight",
+    "kbd",
+    "blockquote",
     "image",
+    "aspect-ratio",
+    "code-block",
     "show",
     "hide",
     "accordion",
-    "list"
+    "collapsible",
+    "list",
+    "feed",
+    "tree",
+    "tree-grid",
+    "table",
+    "data-grid",
+    "dialog",
+    "alert-dialog",
+    "popover",
+    "dropdown-menu",
+    "context-menu",
+    "menubar",
+    "hover-card",
+    "tooltip",
+    "radio-group",
+    "checkbox-group",
+    "switch",
+    "toggle",
+    "toggle-group",
+    "number-input",
+    "select",
+    "multi-select",
+    "combobox",
+    "otp-field",
+    "password-toggle-field",
+    "file-upload",
+    "toast",
+    "swipeable-item",
+    "progress",
+    "progress-circle",
+    "notification-badge",
+    "avatar",
+    "badge",
+    "color-picker",
+    "color-swatch",
+    "visually-hidden",
+    "slider",
+    "rating"
   ]
 }