@repobit/dex-system-design 0.25.12 → 1.0.0

package/schemas/component-manifest.json

@@ -1,7 +1,7 @@
 {
   "manifestVersion": 1,
   "package": "@repobit/dex-system-design",
-  "packageVersion": "0.23.11",
+  "packageVersion": "1.0.0",
   "generatedFrom": [
     "package.json exports",
     "Lit static properties",
@@ -10,32 +10,606 @@
   "notes": [
     "Import the package export once, then any tag registered by that module can be used in the rendered page.",
     "Props are expressed as component property names. When attributeName exists, a string-to-HTML renderer should emit that explicit attribute name.",
-    "Private or state-only Lit properties were intentionally omitted."
+    "Private or state-only Lit properties were intentionally omitted.",
+    "Prop values for colours, sizes and spacing should be token references (var(--…)) rather than literals; see the per-prop description.",
+    "Run `npm run check:manifest` to verify this file against the components."
   ],
   "components": [
     {
-      "tag": "bd-h",
-      "packageExport": "./heading",
-      "module": "./src/components/heading/heading.js",
+      "tag": "bd-accordion-bg",
+      "packageExport": "./accordion-bg",
+      "module": "./src/components/accordion/accordion-bg.js",
+      "role": "container",
+      "contentModel": "children",
+      "children": [
+        "bd-accordion-bg-item"
+      ],
+      "props": [
+        {
+          "name": "title",
+          "type": "string"
+        },
+        {
+          "name": "noBg",
+          "type": "boolean"
+        },
+        {
+          "name": "noPadding",
+          "type": "boolean"
+        }
+      ]
+    },
+    {
+      "tag": "bd-accordion-bg-item",
+      "packageExport": "./accordion-bg",
+      "module": "./src/components/accordion/accordion-bg.js",
+      "role": "item",
+      "contentModel": "children",
+      "props": [
+        {
+          "name": "title",
+          "type": "string"
+        },
+        {
+          "name": "open",
+          "type": "boolean"
+        },
+        {
+          "name": "noBg",
+          "type": "boolean"
+        },
+        {
+          "name": "noPadding",
+          "type": "boolean"
+        }
+      ]
+    },
+    {
+      "tag": "bd-accordion-item",
+      "packageExport": "./accordion",
+      "module": "./src/components/accordion/accordion.js",
+      "role": "item",
+      "contentModel": "children",
+      "props": [
+        {
+          "name": "title",
+          "type": "string"
+        },
+        {
+          "name": "open",
+          "type": "boolean"
+        },
+        {
+          "name": "chevron",
+          "type": "boolean"
+        }
+      ]
+    },
+    {
+      "tag": "bd-accordion-section",
+      "packageExport": "./accordion",
+      "module": "./src/components/accordion/accordion.js",
+      "role": "container",
+      "contentModel": "children",
+      "children": [
+        "bd-accordion-item"
+      ],
+      "props": [
+        {
+          "name": "title",
+          "type": "string"
+        },
+        {
+          "name": "variant",
+          "type": "string"
+        },
+        {
+          "name": "guideIcon",
+          "type": "string"
+        },
+        {
+          "name": "guideLabel",
+          "type": "string"
+        },
+        {
+          "name": "guideHref",
+          "type": "string"
+        },
+        {
+          "name": "chevron",
+          "type": "boolean"
+        }
+      ]
+    },
+    {
+      "tag": "bd-ai-icon",
+      "packageExport": "./marks",
+      "module": "./src/components/icons/marks.js",
+      "role": "decoration",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Pixel width. A wordmark rather than an icon on a square grid, so it takes no size step."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Pixel height. The aspect ratio matches the artwork at 524.8:62.6."
+        }
+      ]
+    },
+    {
+      "tag": "bd-arrow-icon",
+      "packageExport": "./icons",
+      "module": "./src/components/icons/icons.js",
+      "role": "decoration",
+      "contentModel": "none",
+      "props": []
+    },
+    {
+      "tag": "bd-circle-info-icon",
+      "packageExport": "./icons",
+      "module": "./src/components/icons/icons.js",
+      "role": "decoration",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl"
+          ],
+          "description": "A step on the icon scale. Resolves to var(--icon-*-size); an off-scale value falls back to the size the artwork was drawn at."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "description": "Optional. The artwork is drawn in currentColor, so an icon follows the text it sits beside unless this overrides it."
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        }
+      ]
+    },
+    {
+      "tag": "bd-custom-input-clipboard",
+      "packageExport": "./input",
+      "module": "./src/components/input/input-clipboard.js",
+      "role": "form",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ],
+          "description": "Field size. All three fields share shared/form-field.css.js, so a field of a given size matches a bd-button of the same size on height and radius."
+        },
+        {
+          "name": "label",
+          "type": "string"
+        },
+        {
+          "name": "type",
+          "type": "string"
+        },
+        {
+          "name": "kind",
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ],
+          "description": "Field size. Shares shared/form-field.css.js with bd-custom-input and bd-custom-dropdown, so all three are the same height and radius at a given size."
+        },
+        {
+          "name": "placeholder",
+          "type": "string"
+        },
+        {
+          "name": "required",
+          "type": "boolean"
+        },
+        {
+          "name": "focused",
+          "type": "boolean"
+        },
+        {
+          "name": "tooltip",
+          "type": "string"
+        },
+        {
+          "name": "invalid",
+          "type": "boolean"
+        },
+        {
+          "name": "validated",
+          "type": "boolean"
+        },
+        {
+          "name": "disabled",
+          "type": "boolean"
+        },
+        {
+          "name": "value",
+          "type": "string",
+          "description": "The field contents. A paste button sits over the right-hand end and fills it from the clipboard."
+        }
+      ]
+    },
+    {
+      "tag": "bd-alert",
+      "packageExport": "./alert",
+      "module": "./src/components/alert/alert.js",
       "role": "content",
       "contentModel": "text-or-children",
       "props": [
-        { "name": "as", "type": "string", "enum": ["h1", "h2", "h3", "h4", "h5", "h6"] },
-        { "name": "ariaLevel", "type": "number", "attributeName": "aria-level" },
-        { "name": "padding", "type": "string" },
-        { "name": "paddingBottom", "type": "string" },
-        { "name": "fontWeight", "type": "string", "enum": ["", "100", "200", "300", "400", "500", "600", "700", "800", "900", "normal", "bold", "lighter", "bolder"] },
-        { "name": "color", "type": "string" }
+        {
+          "name": "tone",
+          "type": "string",
+          "enum": [
+            "info",
+            "success",
+            "warning",
+            "error",
+            "neutral"
+          ]
+        },
+        {
+          "name": "variant",
+          "type": "string",
+          "enum": [
+            "tint",
+            "outline"
+          ]
+        },
+        {
+          "name": "heading",
+          "type": "string"
+        },
+        {
+          "name": "dismissible",
+          "type": "boolean"
+        },
+        {
+          "name": "dismisslabel",
+          "type": "string"
+        }
       ]
     },
     {
-      "tag": "bd-p",
-      "packageExport": "./paragraph",
-      "module": "./src/components/paragraph/paragraph.js",
+      "tag": "bd-analysis-icon",
+      "packageExport": "./icons",
+      "module": "./src/components/icons/icons.js",
+      "role": "decoration",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl"
+          ],
+          "description": "A step on the icon scale. Resolves to var(--icon-*-size); an off-scale value falls back to the size the artwork was drawn at."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "description": "Optional. The artwork is drawn in currentColor, so an icon follows the text it sits beside unless this overrides it."
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        }
+      ]
+    },
+    {
+      "tag": "bd-anchor-nav",
+      "packageExport": "./anchor",
+      "module": "./src/components/anchor/anchor-nav.js",
+      "role": "navigation",
+      "contentModel": "children",
+      "children": [
+        "bd-anchor-nav-item"
+      ],
+      "props": [
+        {
+          "name": "navLabel",
+          "type": "string",
+          "attributeName": "aria-label"
+        },
+        {
+          "name": "stickyTop",
+          "type": "string",
+          "attributeName": "sticky-top",
+          "description": "Offset from the top of the viewport while the bar is sticky, e.g. the height of a fixed header above it. A CSS length; default 0px."
+        }
+      ]
+    },
+    {
+      "tag": "bd-anchor-nav-item",
+      "packageExport": "./anchor",
+      "module": "./src/components/anchor/anchor-nav.js",
+      "role": "item",
+      "contentModel": "text-or-children",
+      "props": []
+    },
+    {
+      "tag": "bd-arrow-down-icon",
+      "packageExport": "./icons",
+      "module": "./src/components/icons/icons.js",
+      "role": "decoration",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl"
+          ],
+          "description": "A step on the icon scale. Resolves to var(--icon-*-size); an off-scale value falls back to the size the artwork was drawn at."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "description": "Optional. The artwork is drawn in currentColor, so an icon follows the text it sits beside unless this overrides it."
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        }
+      ]
+    },
+    {
+      "tag": "bd-arrow-up-icon",
+      "packageExport": "./icons",
+      "module": "./src/components/icons/icons.js",
+      "role": "decoration",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl"
+          ],
+          "description": "A step on the icon scale. Resolves to var(--icon-*-size); an off-scale value falls back to the size the artwork was drawn at."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "description": "Optional. The artwork is drawn in currentColor, so an icon follows the text it sits beside unless this overrides it."
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        }
+      ]
+    },
+    {
+      "tag": "bd-av-comparatives-icon",
+      "packageExport": "./marks",
+      "module": "./src/components/icons/marks.js",
+      "role": "decoration",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Rendered width in pixels. Defaults differ per icon, so set it explicitly."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Rendered height in pixels. Defaults differ per icon, so set it explicitly."
+        }
+      ]
+    },
+    {
+      "tag": "bd-avatar",
+      "packageExport": "./avatar",
+      "module": "./src/components/avatar/avatar.js",
+      "role": "media",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "src",
+          "type": "string"
+        },
+        {
+          "name": "name",
+          "type": "string"
+        },
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "small",
+            "default",
+            "large"
+          ]
+        }
+      ]
+    },
+    {
+      "tag": "bd-back",
+      "packageExport": "./back",
+      "module": "./src/components/back/back.js",
+      "role": "navigation",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "href",
+          "type": "string",
+          "description": "Destination of the back link."
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "description": "Link text. Defaults to \"Back\"."
+        },
+        {
+          "name": "ariaLabel",
+          "type": "string",
+          "description": "Accessible name for the control, forwarded to the button. Required when label is empty, because an arrow alone is not a name."
+        }
+      ]
+    },
+    {
+      "tag": "bd-badge",
+      "packageExport": "./badge",
+      "module": "./src/components/badge/badge.js",
+      "role": "content",
+      "contentModel": "text-or-children",
+      "props": [
+        {
+          "name": "mode",
+          "type": "string",
+          "enum": [
+            "text",
+            "dot",
+            "count"
+          ],
+          "description": "What the badge carries. \"dot\" renders a bare dot and ignores size."
+        },
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ],
+          "description": "Type size and padding. No effect when mode is \"dot\"."
+        },
+        {
+          "name": "tone",
+          "type": "string",
+          "enum": [
+            "neutral",
+            "brand",
+            "success",
+            "warning",
+            "error",
+            "info"
+          ],
+          "description": "Semantic colour pairing, shared with bd-tag and bd-alert and drawn from the --status-* roles. The earlier names default and primary still map onto neutral and brand."
+        },
+        {
+          "name": "variant",
+          "type": "string",
+          "enum": [
+            "shade",
+            "fill"
+          ],
+          "description": "\"shade\" tints the background and keeps dark text; \"fill\" saturates it."
+        },
+        {
+          "name": "icon",
+          "type": "string",
+          "enum": [
+            "",
+            "individual",
+            "family"
+          ],
+          "description": "Optional leading icon. Follows the tone via currentColor."
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "description": "Accessible name used when mode is \"dot\", which renders no text. Falls back to the tone name."
+        }
+      ]
+    },
+    {
+      "tag": "bd-best-brands-icon",
+      "packageExport": "./marks",
+      "module": "./src/components/icons/marks.js",
+      "role": "decoration",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Rendered width in pixels. Defaults differ per icon, so set it explicitly."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Rendered height in pixels. Defaults differ per icon, so set it explicitly."
+        }
+      ]
+    },
+    {
+      "tag": "bd-blockquote",
+      "packageExport": "./blockquote",
+      "module": "./src/components/blockquote/blockquote.js",
       "role": "content",
       "contentModel": "text-or-children",
       "props": [
-        { "name": "kind", "type": "string" }
+        {
+          "name": "cite",
+          "type": "string"
+        },
+        {
+          "name": "attribution",
+          "type": "string"
+        }
       ]
     },
     {
@@ -44,16 +618,143 @@
       "module": "./src/components/button/button.js",
       "role": "action",
       "contentModel": "text-or-children",
-      "events": ["custom-click"],
+      "events": [
+        "custom-click"
+      ],
       "props": [
-        { "name": "label", "type": "string" },
-        { "name": "size", "type": "string", "enum": ["sm", "md", "lg"] },
-        { "name": "kind", "type": "string", "enum": ["primary", "primary-outline", "outline", "secondary", "danger"] },
-        { "name": "customClass", "type": "string" },
-        { "name": "fullWidth", "type": "boolean" },
-        { "name": "strong", "type": "boolean" },
-        { "name": "fontSize", "type": "string", "attributeName": "font-size" },
-        { "name": "fontWeight", "type": "string", "attributeName": "font-weight" }
+        {
+          "name": "variant",
+          "type": "string",
+          "enum": [
+            "primary",
+            "secondary",
+            "tertiary",
+            "ghost",
+            "accent",
+            "white",
+            "outline-white"
+          ],
+          "description": "Visual variant. Replaces kind, which meant appearance here and size or marker elsewhere; kind still resolves. tertiary is a blue outline, ghost a dark outline, accent the red conversion fill — red is not a danger signal in this system. white and outline-white are fixed presets for a solid-colour banner and ignore surface on purpose."
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "description": "Accessible name only, never the visible text. Leave unset so the slotted content names the control. Required with iconOnly, where it is the only name: say what happens (\"Open menu\"), not what the icon shows."
+        },
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ]
+        },
+        {
+          "name": "kind",
+          "type": "string",
+          "enum": [
+            "primary",
+            "secondary",
+            "tertiary",
+            "ghost",
+            "accent",
+            "white",
+            "outline-white"
+          ],
+          "description": "Visual variant. tertiary is a blue outline, ghost a dark outline, accent the red conversion fill (Buy now and the like) — red is not a danger signal in this system, and there is no danger variant. The earlier values outline, primary-outline, danger and destructive still map onto ghost, tertiary and accent. white and outline-white are fixed presets for a solid-colour banner — they ignore surface on purpose, so do not reach for them on a light page."
+        },
+        {
+          "name": "align",
+          "type": "string",
+          "enum": [
+            "left",
+            "center",
+            "right"
+          ]
+        },
+        {
+          "name": "fullWidth",
+          "type": "boolean"
+        },
+        {
+          "name": "strong",
+          "type": "boolean",
+          "description": "Steps the weight up to semibold."
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "description": "On the link this drops the href and sets aria-disabled, since a link has no native disabled state."
+        },
+        {
+          "name": "loading",
+          "type": "boolean",
+          "description": "Shows a spinner in the variant colour and sets aria-busy. Blocks interaction."
+        },
+        {
+          "name": "fontSize",
+          "type": "string",
+          "enum": [
+            "xxs",
+            "xs",
+            "sm",
+            "base",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl",
+            "4xl",
+            "5xl",
+            "6xl",
+            "7xl",
+            "8xl",
+            "9xl"
+          ],
+          "description": "A type-scale step. Resolves to var(--typography-fontSize-*)."
+        },
+        {
+          "name": "fontWeight",
+          "type": "string",
+          "enum": [
+            "light",
+            "normal",
+            "medium",
+            "semibold",
+            "bold"
+          ],
+          "description": "A weight step. Resolves to var(--typography-fontWeight-*)."
+        },
+        {
+          "name": "surface",
+          "type": "string",
+          "enum": [
+            "light",
+            "dark"
+          ],
+          "description": "The surface the button sits on. Use \"dark\" inside a hero or panel that has a full background colour — on a light page every variant is legible, on a coloured one most are not."
+        },
+        {
+          "name": "shape",
+          "type": "string",
+          "enum": [
+            "default",
+            "rounded"
+          ],
+          "description": "Corner shape. rounded takes --radius-3xl whatever the size; default keeps the size band's radius."
+        },
+        {
+          "name": "noArrow",
+          "type": "boolean",
+          "attributeName": "no-arrow",
+          "description": "The accent variant reveals a trailing arrow on hover and focus; this opts out. No effect on other variants, or while disabled or loading."
+        },
+        {
+          "name": "iconOnly",
+          "type": "boolean",
+          "attributeName": "icon-only",
+          "description": "A circle around one icon instead of a visible label. Slot a bd-*-icon, or leave the slot empty for the arrow. label is required with it, since it is the only accessible name the control has. Every variant, size and surface applies; fullWidth is ignored."
+        }
       ]
     },
     {
@@ -62,19 +763,388 @@
       "module": "./src/components/button/button.js",
       "role": "action",
       "contentModel": "text-or-children",
-      "events": ["custom-click"],
+      "events": [
+        "custom-click"
+      ],
       "props": [
-        { "name": "label", "type": "string" },
-        { "name": "href", "type": "string" },
-        { "name": "size", "type": "string", "enum": ["sm", "md", "lg"] },
-        { "name": "kind", "type": "string", "enum": ["primary", "primary-outline", "outline", "secondary", "danger"] },
-        { "name": "customClass", "type": "string" },
-        { "name": "fullWidth", "type": "boolean" },
-        { "name": "strong", "type": "boolean" },
-        { "name": "fontSize", "type": "string", "attributeName": "font-size" },
-        { "name": "fontWeight", "type": "string", "attributeName": "font-weight" },
-        { "name": "buyLink", "type": "boolean" },
-        { "name": "shadow", "type": "boolean" }
+        {
+          "name": "variant",
+          "type": "string",
+          "enum": [
+            "primary",
+            "secondary",
+            "tertiary",
+            "ghost",
+            "accent",
+            "white",
+            "outline-white"
+          ],
+          "description": "Visual variant. Replaces kind, which meant appearance here and size or marker elsewhere; kind still resolves. tertiary is a blue outline, ghost a dark outline, accent the red conversion fill — red is not a danger signal in this system. white and outline-white are fixed presets for a solid-colour banner and ignore surface on purpose."
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "description": "Accessible name only, never the visible text. Leave unset so the slotted content names the control. Required with iconOnly, where it is the only name: say what happens (\"Open menu\"), not what the icon shows."
+        },
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ]
+        },
+        {
+          "name": "kind",
+          "type": "string",
+          "enum": [
+            "primary",
+            "secondary",
+            "tertiary",
+            "ghost",
+            "accent",
+            "white",
+            "outline-white"
+          ],
+          "description": "Visual variant. tertiary is a blue outline, ghost a dark outline, accent the red conversion fill (Buy now and the like) — red is not a danger signal in this system, and there is no danger variant. The earlier values outline, primary-outline, danger and destructive still map onto ghost, tertiary and accent. white and outline-white are fixed presets for a solid-colour banner — they ignore surface on purpose, so do not reach for them on a light page."
+        },
+        {
+          "name": "align",
+          "type": "string",
+          "enum": [
+            "left",
+            "center",
+            "right"
+          ]
+        },
+        {
+          "name": "fullWidth",
+          "type": "boolean"
+        },
+        {
+          "name": "strong",
+          "type": "boolean",
+          "description": "Steps the weight up to semibold."
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "description": "On the link this drops the href and sets aria-disabled, since a link has no native disabled state."
+        },
+        {
+          "name": "loading",
+          "type": "boolean",
+          "description": "Shows a spinner in the variant colour and sets aria-busy. Blocks interaction."
+        },
+        {
+          "name": "fontSize",
+          "type": "string",
+          "enum": [
+            "xxs",
+            "xs",
+            "sm",
+            "base",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl",
+            "4xl",
+            "5xl",
+            "6xl",
+            "7xl",
+            "8xl",
+            "9xl"
+          ],
+          "description": "A type-scale step. Resolves to var(--typography-fontSize-*)."
+        },
+        {
+          "name": "fontWeight",
+          "type": "string",
+          "enum": [
+            "light",
+            "normal",
+            "medium",
+            "semibold",
+            "bold"
+          ],
+          "description": "A weight step. Resolves to var(--typography-fontWeight-*)."
+        },
+        {
+          "name": "href",
+          "type": "string",
+          "description": "Destination. Omitted from the rendered anchor when empty, disabled or loading."
+        },
+        {
+          "name": "buyLink",
+          "type": "boolean",
+          "description": "Emits the data-store-render and data-store-buy-link hooks."
+        },
+        {
+          "name": "target",
+          "type": "string",
+          "description": "Anchor target. \"_blank\" opens a new tab, and rel then defaults to \"noopener noreferrer\"."
+        },
+        {
+          "name": "rel",
+          "type": "string",
+          "description": "Anchor rel. Overrides the default that target=\"_blank\" supplies."
+        },
+        {
+          "name": "surface",
+          "type": "string",
+          "enum": [
+            "light",
+            "dark"
+          ],
+          "description": "The surface the button sits on. Use \"dark\" inside a hero or panel that has a full background colour — on a light page every variant is legible, on a coloured one most are not."
+        },
+        {
+          "name": "shape",
+          "type": "string",
+          "enum": [
+            "default",
+            "rounded"
+          ],
+          "description": "Corner shape. rounded takes --radius-3xl whatever the size; default keeps the size band's radius."
+        },
+        {
+          "name": "noArrow",
+          "type": "boolean",
+          "attributeName": "no-arrow",
+          "description": "The accent variant reveals a trailing arrow on hover and focus; this opts out. No effect on other variants, or while disabled or loading."
+        },
+        {
+          "name": "iconOnly",
+          "type": "boolean",
+          "attributeName": "icon-only",
+          "description": "A circle around one icon instead of a visible label. Slot a bd-*-icon, or leave the slot empty for the arrow. label is required with it, since it is the only accessible name the control has. Every variant, size and surface applies; fullWidth is ignored."
+        }
+      ]
+    },
+    {
+      "tag": "bd-caption",
+      "packageExport": "./caption",
+      "module": "./src/components/caption/caption.js",
+      "role": "content",
+      "contentModel": "text-or-children",
+      "props": [
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "default",
+            "small"
+          ]
+        }
+      ]
+    },
+    {
+      "tag": "bd-carousel-item",
+      "packageExport": "./carousel",
+      "module": "./src/components/carousel/carousel.js",
+      "role": "item",
+      "contentModel": "children",
+      "props": [
+        {
+          "name": "icon",
+          "type": "string"
+        },
+        {
+          "name": "title",
+          "type": "string"
+        },
+        {
+          "name": "headingLevel",
+          "type": "number",
+          "attributeName": "heading-level",
+          "enum": [
+            1,
+            2,
+            3,
+            4,
+            5,
+            6
+          ],
+          "description": "Semantic heading level for this component's title. The type scale does not follow it: level is a document-outline decision that belongs to page composition. Sections default to 2, items to 3."
+        },
+        {
+          "name": "modalText",
+          "type": "string"
+        }
+      ]
+    },
+    {
+      "tag": "bd-carousel-section",
+      "packageExport": "./carousel",
+      "module": "./src/components/carousel/carousel.js",
+      "role": "container",
+      "contentModel": "children",
+      "children": [
+        "bd-carousel-item"
+      ],
+      "props": [
+        {
+          "name": "title",
+          "type": "string"
+        },
+        {
+          "name": "headingLevel",
+          "type": "number",
+          "attributeName": "heading-level",
+          "enum": [
+            1,
+            2,
+            3,
+            4,
+            5,
+            6
+          ],
+          "description": "Semantic heading level for this component's title. The type scale does not follow it: level is a document-outline decision that belongs to page composition. Sections default to 2, items to 3."
+        },
+        {
+          "name": "selectedItem",
+          "type": "object"
+        }
+      ]
+    },
+    {
+      "tag": "bd-checkbox",
+      "packageExport": "./checkbox",
+      "module": "./src/components/checkbox/checkbox.js",
+      "role": "form",
+      "contentModel": "text-or-children",
+      "props": [
+        {
+          "name": "name",
+          "type": "string",
+          "description": "Carried on the change event only. This element does NOT participate in form submission — a form containing it yields no FormData entry."
+        },
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Emitted in the change event detail when checked, null when not. Not submitted with a form."
+        },
+        {
+          "name": "checked",
+          "type": "boolean",
+          "description": "Draws a tick. Ignored while indeterminate is set."
+        },
+        {
+          "name": "indeterminate",
+          "type": "boolean",
+          "description": "The mixed state, announced as aria-checked=\"mixed\". Takes precedence over checked. Clicking resolves it to checked, as a native checkbox does."
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "description": "Blocks interaction, greys the box and label, and sets tabindex=\"-1\"."
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "description": "Label text, and the fallback for the default slot — slotted content wins, so markup such as a link can go inside the label."
+        }
+      ]
+    },
+    {
+      "tag": "bd-citation",
+      "packageExport": "./annotation",
+      "module": "./src/components/annotation/annotation.js",
+      "role": "content",
+      "contentModel": "text-or-children",
+      "props": [
+        {
+          "name": "href",
+          "type": "string"
+        }
+      ]
+    },
+    {
+      "tag": "bd-close-icon",
+      "packageExport": "./icons",
+      "module": "./src/components/icons/icons.js",
+      "role": "decoration",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl"
+          ],
+          "description": "A step on the icon scale. Resolves to var(--icon-*-size); an off-scale value falls back to the size the artwork was drawn at."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "description": "Optional. The artwork is drawn in currentColor, so an icon follows the text it sits beside unless this overrides it."
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        }
+      ]
+    },
+    {
+      "tag": "bd-code",
+      "packageExport": "./code",
+      "module": "./src/components/code/code.js",
+      "role": "content",
+      "contentModel": "text-or-children",
+      "props": [
+        {
+          "name": "block",
+          "type": "boolean",
+          "description": "Renders a <pre><code> block instead of inline <code>. The block scrolls horizontally and is focusable so it can be scrolled from the keyboard."
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "description": "Accessible name for the scrollable block, announced on focus. Defaults to \"Code\". Only used when block is set."
+        }
+      ]
+    },
+    {
+      "tag": "bd-compare-section",
+      "packageExport": "./compare",
+      "module": "./src/components/compare/compare.js",
+      "role": "container",
+      "contentModel": "children",
+      "children": [
+        "compare-card",
+        "compare-bar"
+      ],
+      "props": [
+        {
+          "name": "title",
+          "type": "string"
+        },
+        {
+          "name": "subtitle",
+          "type": "string"
+        },
+        {
+          "name": "columns",
+          "type": "number"
+        },
+        {
+          "name": "gap",
+          "type": "string",
+          "description": "Use a token reference from the spacing scale, e.g. var(--spacing-16)."
+        }
       ]
     },
     {
@@ -84,58 +1154,519 @@
       "role": "action",
       "contentModel": "none",
       "props": [
-        { "name": "label", "type": "string" },
-        { "name": "href", "type": "string" }
+        {
+          "name": "variant",
+          "type": "string",
+          "enum": [
+            "primary",
+            "secondary",
+            "tertiary",
+            "ghost",
+            "accent",
+            "white",
+            "outline-white"
+          ],
+          "description": "Visual variant. Replaces kind, which meant appearance here and size or marker elsewhere; kind still resolves. tertiary is a blue outline, ghost a dark outline, accent the red conversion fill — red is not a danger signal in this system. white and outline-white are fixed presets for a solid-colour banner and ignore surface on purpose."
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "description": "Both the visible text and the accessible name for this preset."
+        },
+        {
+          "name": "href",
+          "type": "string"
+        },
+        {
+          "name": "align",
+          "type": "string",
+          "enum": [
+            "left",
+            "center",
+            "right"
+          ]
+        },
+        {
+          "name": "shape",
+          "type": "string",
+          "enum": [
+            "default",
+            "rounded"
+          ],
+          "description": "Corner shape. rounded takes --radius-3xl whatever the size; default keeps the size band's radius."
+        }
       ]
     },
     {
-      "tag": "bd-link",
-      "packageExport": "./link",
-      "module": "./src/components/link/link.js",
+      "tag": "bd-custom-dropdown",
+      "packageExport": "./dropdown",
+      "module": "./src/components/dropdown/dropdown.js",
+      "role": "form",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ],
+          "description": "Field size. All three fields share shared/form-field.css.js, so a field of a given size matches a bd-button of the same size on height and radius."
+        },
+        {
+          "name": "label",
+          "type": "string"
+        },
+        {
+          "name": "options",
+          "type": "array"
+        },
+        {
+          "name": "kind",
+          "type": "string"
+        },
+        {
+          "name": "required",
+          "type": "boolean"
+        },
+        {
+          "name": "tooltip",
+          "type": "string"
+        },
+        {
+          "name": "invalid",
+          "type": "boolean"
+        },
+        {
+          "name": "validated",
+          "type": "boolean"
+        },
+        {
+          "name": "disabled",
+          "type": "boolean"
+        }
+      ]
+    },
+    {
+      "tag": "bd-custom-input",
+      "packageExport": "./input",
+      "module": "./src/components/input/input.js",
+      "role": "form",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ],
+          "description": "Field size. All three fields share shared/form-field.css.js, so a field of a given size matches a bd-button of the same size on height and radius."
+        },
+        {
+          "name": "label",
+          "type": "string"
+        },
+        {
+          "name": "type",
+          "type": "string"
+        },
+        {
+          "name": "kind",
+          "type": "string"
+        },
+        {
+          "name": "placeholder",
+          "type": "string"
+        },
+        {
+          "name": "required",
+          "type": "boolean"
+        },
+        {
+          "name": "focused",
+          "type": "boolean"
+        },
+        {
+          "name": "tooltip",
+          "type": "string"
+        },
+        {
+          "name": "invalid",
+          "type": "boolean"
+        },
+        {
+          "name": "validated",
+          "type": "boolean"
+        },
+        {
+          "name": "disabled",
+          "type": "boolean"
+        },
+        {
+          "name": "value",
+          "type": "string",
+          "description": "The field contents. Read it here or from the bd-input / bd-change event detail — a native input event retargets to the host, so e.target.value is undefined."
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "description": "Carried on the bd-input and bd-change event detail. NOT submitted with a form — the input lives in a shadow root."
+        },
+        {
+          "name": "inputmode",
+          "type": "string",
+          "enum": [
+            "none",
+            "text",
+            "decimal",
+            "numeric",
+            "tel",
+            "search",
+            "email",
+            "url"
+          ],
+          "description": "Picks the mobile keyboard without changing the field semantics. Prefer inputmode=\"numeric\" on a text field over type=\"number\" for digit strings such as codes and postal codes."
+        },
+        {
+          "name": "autocomplete",
+          "type": "string",
+          "description": "Native autocomplete token, e.g. email, tel, one-time-code, current-password, postal-code. The single biggest usability saving on a phone."
+        },
+        {
+          "name": "enterkeyhint",
+          "type": "string",
+          "enum": [
+            "enter",
+            "done",
+            "go",
+            "next",
+            "previous",
+            "search",
+            "send"
+          ],
+          "description": "Labels the Enter key on a mobile keyboard."
+        }
+      ]
+    },
+    {
+      "tag": "bd-display",
+      "packageExport": "./display",
+      "module": "./src/components/display/display.js",
       "role": "content",
       "contentModel": "text-or-children",
       "props": [
-        { "name": "href", "type": "string" },
-        { "name": "target", "type": "string" },
-        { "name": "kind", "type": "string" },
-        { "name": "underline", "type": "boolean" },
-        { "name": "disabled", "type": "boolean" },
-        { "name": "fontSize", "type": "string", "attributeName": "font-size" },
-        { "name": "color", "type": "string" }
+        {
+          "name": "variant",
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "xxl",
+            "xxxl"
+          ],
+          "description": "Which display role to render. Larger than the heading scale — for hero and marketing type. Defaults to md, and an unrecognised value lands on md too. md and sm are fluid, clamping to a 30px floor at a 320px viewport; lg (60), xl (72), xxl (96) and xxxl (128) are DESKTOP-ONLY by decision — they render their full size at every width, so a phone breaks the word instead. Pick the step per breakpoint in the composing page. There is no hero value: it and --typography-display-hero-* were retired in a1589e0f."
+        },
+        {
+          "name": "kind",
+          "type": "string",
+          "deprecated": true,
+          "enum": [
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "xxl",
+            "xxxl"
+          ],
+          "description": "Deprecated alias for `variant`, still resolved so existing markup keeps working. New markup should use `variant`."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "enum": [
+            "primary",
+            "strong",
+            "muted",
+            "subtle",
+            "inverse",
+            "success",
+            "warning",
+            "error"
+          ],
+          "description": "A semantic colour role, not a CSS colour. Resolves to a palette token; anything else is dropped."
+        },
+        {
+          "name": "align",
+          "type": "string",
+          "enum": [
+            "left",
+            "center",
+            "right"
+          ],
+          "description": "Text alignment."
+        }
       ]
     },
     {
-      "tag": "bd-img",
-      "packageExport": "./image",
-      "module": "./src/components/image/image.js",
-      "role": "media",
+      "tag": "bd-divider-horizontal",
+      "packageExport": "./divider-horizontal",
+      "module": "./src/components/divider/divider-horizontal.js",
+      "role": "layout",
       "contentModel": "none",
       "props": [
-        { "name": "src", "type": "string" },
-        { "name": "alt", "type": "string" },
-        { "name": "width", "type": "number" },
-        { "name": "height", "type": "number" },
-        { "name": "loading", "type": "string" },
-        { "name": "fit", "type": "string" },
-        { "name": "radius", "type": "string" },
-        { "name": "shadow", "type": "string" }
+        {
+          "name": "width",
+          "type": "string",
+          "description": "Layout length for how far the rule spans, e.g. \"100%\". Not a design-token decision."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "enum": [
+            "primary",
+            "strong",
+            "muted",
+            "subtle",
+            "inverse",
+            "success",
+            "warning",
+            "error"
+          ],
+          "description": "A semantic colour role, not a CSS colour. Resolves to a palette token."
+        },
+        {
+          "name": "opacity",
+          "type": "string"
+        }
       ]
     },
     {
-      "tag": "bd-picture",
-      "packageExport": "./picture",
-      "module": "./src/components/picture/picture.js",
-      "role": "media",
+      "tag": "bd-divider-vertical",
+      "packageExport": "./divider-vertical",
+      "module": "./src/components/divider/divider-vertical.js",
+      "role": "layout",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "height",
+          "type": "string",
+          "enum": [
+            "0",
+            "1",
+            "2",
+            "4",
+            "6",
+            "8",
+            "10",
+            "12",
+            "14",
+            "16",
+            "18",
+            "20",
+            "22",
+            "24",
+            "28",
+            "32",
+            "36",
+            "40",
+            "44",
+            "48",
+            "52",
+            "56",
+            "64",
+            "80",
+            "96",
+            "112",
+            "128"
+          ],
+          "description": "A spacing step. Resolves to var(--spacing-N)."
+        },
+        {
+          "name": "thickness",
+          "type": "string"
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "enum": [
+            "primary",
+            "strong",
+            "muted",
+            "subtle",
+            "inverse",
+            "success",
+            "warning",
+            "error"
+          ],
+          "description": "A semantic colour role, not a CSS colour. Resolves to a palette token."
+        },
+        {
+          "name": "opacity",
+          "type": "string"
+        }
+      ]
+    },
+    {
+      "tag": "bd-family-icon",
+      "packageExport": "./icons",
+      "module": "./src/components/icons/icons.js",
+      "role": "decoration",
       "contentModel": "none",
       "props": [
-        { "name": "sources", "type": "array" },
-        { "name": "fallbackSrc", "type": "string" },
-        { "name": "alt", "type": "string" },
-        { "name": "width", "type": "number" },
-        { "name": "height", "type": "number" },
-        { "name": "loading", "type": "string" },
-        { "name": "fit", "type": "string" },
-        { "name": "radius", "type": "string" }
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl"
+          ],
+          "description": "A step on the icon scale. Resolves to var(--icon-*-size); an off-scale value falls back to the size the artwork was drawn at."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "description": "Optional. The artwork is drawn in currentColor, so an icon follows the text it sits beside unless this overrides it."
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        }
+      ]
+    },
+    {
+      "tag": "bd-fieldset",
+      "packageExport": "./fieldset",
+      "module": "./src/components/fieldset/fieldset.js",
+      "role": "container",
+      "contentModel": "children",
+      "props": [
+        {
+          "name": "legend",
+          "type": "string"
+        }
+      ]
+    },
+    {
+      "tag": "bd-footer",
+      "packageExport": "./footer",
+      "module": "./src/components/footer/footer.js",
+      "role": "section",
+      "contentModel": "children",
+      "props": [
+        {
+          "name": "currentLocale",
+          "type": "string"
+        },
+        {
+          "name": "maxColumnsPerRow",
+          "type": "number"
+        }
+      ]
+    },
+    {
+      "tag": "bd-footer-links-group",
+      "packageExport": "./footer-links-group",
+      "module": "./src/components/footer/footer-links-group.js",
+      "role": "item",
+      "contentModel": "children",
+      "props": [
+        {
+          "name": "title",
+          "type": "string"
+        }
+      ]
+    },
+    {
+      "tag": "bd-footer-lp",
+      "packageExport": "./footer-lp",
+      "module": "./src/components/footer/footer-lp.js",
+      "role": "section",
+      "contentModel": "children",
+      "props": [
+        {
+          "name": "currentLocale",
+          "type": "string"
+        }
+      ]
+    },
+    {
+      "tag": "bd-footer-nav",
+      "packageExport": "./footer-nav-menu",
+      "module": "./src/components/footer/footer-nav-menu.js",
+      "role": "item",
+      "contentModel": "children",
+      "props": [
+        {
+          "name": "bold",
+          "type": "boolean"
+        }
+      ]
+    },
+    {
+      "tag": "bd-footnote",
+      "packageExport": "./annotation",
+      "module": "./src/components/annotation/annotation.js",
+      "role": "content",
+      "contentModel": "text-or-children",
+      "props": [
+        {
+          "name": "href",
+          "type": "string"
+        }
+      ]
+    },
+    {
+      "tag": "bd-globe-icon",
+      "packageExport": "./icons",
+      "module": "./src/components/icons/icons.js",
+      "role": "decoration",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl"
+          ],
+          "description": "A step on the icon scale. Resolves to var(--icon-*-size); an off-scale value falls back to the size the artwork was drawn at."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "description": "Optional. The artwork is drawn in currentColor, so an icon follows the text it sits beside unless this overrides it."
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        }
       ]
     },
     {
@@ -145,28 +1676,514 @@
       "role": "layout",
       "contentModel": "children",
       "props": [
-        { "name": "cols", "type": "number" },
-        { "name": "colsSm", "type": "number" },
-        { "name": "colsMd", "type": "number" },
-        { "name": "colsLg", "type": "number" },
-        { "name": "gap", "type": "string" },
-        { "name": "align", "type": "string" },
-        { "name": "justify", "type": "string" },
-        { "name": "padding", "type": "string" }
+        {
+          "name": "cols",
+          "type": "number"
+        },
+        {
+          "name": "colsSm",
+          "type": "number"
+        },
+        {
+          "name": "colsMd",
+          "type": "number"
+        },
+        {
+          "name": "colsLg",
+          "type": "number"
+        },
+        {
+          "name": "gap",
+          "type": "string",
+          "enum": [
+            "none",
+            "4xs",
+            "3xs",
+            "2xs",
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl",
+            "4xl",
+            "5xl"
+          ]
+        },
+        {
+          "name": "align",
+          "type": "string"
+        },
+        {
+          "name": "justify",
+          "type": "string"
+        },
+        {
+          "name": "padding",
+          "type": "string",
+          "enum": [
+            "none",
+            "4xs",
+            "3xs",
+            "2xs",
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl",
+            "4xl",
+            "5xl"
+          ]
+        }
+      ],
+      "notes": [
+        "gap and padding are interpolated into a token name as var(--space-<value>), so only the values listed in enum resolve."
       ]
     },
     {
-      "tag": "bd-list",
-      "packageExport": "./list",
-      "module": "./src/components/list/list.js",
+      "tag": "bd-guide-icon",
+      "packageExport": "./icons",
+      "module": "./src/components/icons/icons.js",
+      "role": "decoration",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl"
+          ],
+          "description": "A step on the icon scale. Resolves to var(--icon-*-size); an off-scale value falls back to the size the artwork was drawn at."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "description": "Optional. The artwork is drawn in currentColor, so an icon follows the text it sits beside unless this overrides it."
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        }
+      ]
+    },
+    {
+      "tag": "bd-h",
+      "packageExport": "./heading",
+      "module": "./src/components/heading/heading.js",
       "role": "content",
+      "contentModel": "text-or-children",
+      "props": [
+        {
+          "name": "as",
+          "type": "string",
+          "enum": [
+            "h1",
+            "h2",
+            "h3",
+            "h4",
+            "h5",
+            "h6"
+          ]
+        },
+        {
+          "name": "visualLevel",
+          "type": "string",
+          "attributeName": "visual-level",
+          "enum": [
+            "h1",
+            "h2",
+            "h3",
+            "h4",
+            "h5",
+            "h6"
+          ],
+          "description": "Which step of the heading type scale to render, when it must differ from the semantic level in `as`. Defaults to following `as`."
+        },
+        {
+          "name": "ariaLevel",
+          "type": "number",
+          "attributeName": "aria-level"
+        },
+        {
+          "name": "padding",
+          "type": "string",
+          "enum": [
+            "0",
+            "1",
+            "2",
+            "4",
+            "6",
+            "8",
+            "10",
+            "12",
+            "14",
+            "16",
+            "18",
+            "20",
+            "22",
+            "24",
+            "28",
+            "32",
+            "36",
+            "40",
+            "44",
+            "48",
+            "52",
+            "56",
+            "64",
+            "80",
+            "96",
+            "112",
+            "128"
+          ],
+          "description": "One to four spacing steps, e.g. \"10 0\". Resolves to var(--spacing-N) per part; off-scale values are dropped."
+        },
+        {
+          "name": "paddingBottom",
+          "type": "string",
+          "enum": [
+            "0",
+            "1",
+            "2",
+            "4",
+            "6",
+            "8",
+            "10",
+            "12",
+            "14",
+            "16",
+            "18",
+            "20",
+            "22",
+            "24",
+            "28",
+            "32",
+            "36",
+            "40",
+            "44",
+            "48",
+            "52",
+            "56",
+            "64",
+            "80",
+            "96",
+            "112",
+            "128"
+          ],
+          "description": "A spacing step. Resolves to var(--spacing-N)."
+        },
+        {
+          "name": "fontWeight",
+          "type": "string",
+          "enum": [
+            "light",
+            "normal",
+            "medium",
+            "semibold",
+            "bold"
+          ],
+          "description": "A weight step. Resolves to var(--typography-fontWeight-*)."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "enum": [
+            "primary",
+            "strong",
+            "muted",
+            "subtle",
+            "inverse",
+            "success",
+            "warning",
+            "error"
+          ],
+          "description": "A semantic colour role, not a CSS colour. Resolves to a palette token."
+        }
+      ]
+    },
+    {
+      "tag": "bd-header",
+      "packageExport": "./header",
+      "module": "./src/components/header/header.js",
+      "role": "section",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "title",
+          "type": "string"
+        },
+        {
+          "name": "subtitle",
+          "type": "string"
+        },
+        {
+          "name": "description",
+          "type": "string"
+        },
+        {
+          "name": "ctaLabel",
+          "type": "string",
+          "attributeName": "cta-label",
+          "default": "Buy now",
+          "description": "Visible label on the primary CTA. Defaults to the string this component has always rendered; Header / v2 reads \u201cGet Protection\u201d. Which words sell a subscription is purchase-funnel copy, so the page sets it. The primary CTA's destination is not a prop \u2014 it carries buyLink, and @repobit/dex-store injects the buy URL at runtime."
+        },
+        {
+          "name": "ctaSecondaryLabel",
+          "type": "string",
+          "attributeName": "cta-secondary-label",
+          "default": "View more plans",
+          "description": "Visible label on the secondary CTA. Defaults to the string this component has always rendered; Header / v2 reads \u201cStart your 30-day trial\u201d."
+        },
+        {
+          "name": "ctaSecondaryHref",
+          "type": "string",
+          "attributeName": "cta-secondary-href",
+          "description": "Destination for the secondary CTA. NO DEFAULT, and until a page sets one the control is dead: bd-button-link drops the href attribute when this is empty, so the anchor is not focusable, is not a link in the accessibility tree, and does nothing when clicked. It has rendered that way since the component was written. Set it."
+        },
+        {
+          "name": "headingLevel",
+          "type": "string",
+          "attributeName": "heading-level",
+          "enum": [
+            "h1",
+            "h2",
+            "h3",
+            "h4",
+            "h5",
+            "h6"
+          ],
+          "description": "The outline level of the headline. Defaults to h1, which is what a product hero is on the page it leads. The type role is pinned to heading-h1 regardless, so changing this moves the heading in the document outline and does not change how it looks. Anything off the enum falls back to h2 in bd-h."
+        },
+        {
+          "name": "productId",
+          "type": "string",
+          "attributeName": "product-id"
+        },
+        {
+          "name": "devices",
+          "type": "string"
+        },
+        {
+          "name": "subscription",
+          "type": "string"
+        },
+        {
+          "name": "shadow",
+          "type": "boolean",
+          "description": "Reflects as an attribute so @repobit/dex-store-elements will walk this component's shadow root for [data-store-render] and [data-store-hide] nodes \u2014 its SHADOW_HOST_SELECTOR is '[shadow], [data-bd-watch-shadow]'. NOT a styling flag, despite the name. Load-bearing: without it the store-driven price zones never render. Defaults to true; leave it set."
+        },
+        {
+          "name": "dataLayerEvent",
+          "type": "string"
+        }
+      ]
+    },
+    {
+      "tag": "bd-help-text",
+      "packageExport": "./help-text",
+      "module": "./src/components/help-text/help-text.js",
+      "role": "form",
+      "contentModel": "text-or-children",
+      "props": [
+        {
+          "name": "tone",
+          "type": "string",
+          "enum": [
+            "default",
+            "error",
+            "success"
+          ]
+        }
+      ]
+    },
+    {
+      "tag": "bd-highlight",
+      "packageExport": "./highlight",
+      "module": "./src/components/highlight/highlight.js",
+      "role": "section",
       "contentModel": "children",
       "props": [
-        { "name": "type", "type": "string" },
-        { "name": "spacing", "type": "string" },
-        { "name": "variant", "type": "string" },
-        { "name": "start", "type": "number" },
-        { "name": "orientation", "type": "string" }
+        {
+          "name": "highlightText",
+          "type": "string",
+          "attributeName": "highlight-text"
+        },
+        {
+          "name": "subTitle",
+          "type": "string",
+          "attributeName": "sub-title"
+        }
+      ]
+    },
+    {
+      "tag": "bd-img",
+      "packageExport": "./image",
+      "module": "./src/components/image/image.js",
+      "role": "media",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "src",
+          "type": "string"
+        },
+        {
+          "name": "alt",
+          "type": "string"
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Intrinsic pixel width for the img element's width attribute — an aspect-ratio hint to the browser, not CSS styling. Omitted when unset."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Intrinsic pixel height for the img element's height attribute — an aspect-ratio hint to the browser, not CSS styling. Omitted when unset."
+        },
+        {
+          "name": "loading",
+          "type": "string"
+        },
+        {
+          "name": "fit",
+          "type": "string"
+        },
+        {
+          "name": "radius",
+          "type": "string",
+          "enum": [
+            "none",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl",
+            "full"
+          ],
+          "description": "A radius step. Applied as a class; off-scale values fall back to \"none\"."
+        },
+        {
+          "name": "shadow",
+          "type": "string"
+        }
+      ]
+    },
+    {
+      "tag": "bd-individual-icon",
+      "packageExport": "./icons",
+      "module": "./src/components/icons/icons.js",
+      "role": "decoration",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl"
+          ],
+          "description": "A step on the icon scale. Resolves to var(--icon-*-size); an off-scale value falls back to the size the artwork was drawn at."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "description": "Optional. The artwork is drawn in currentColor, so an icon follows the text it sits beside unless this overrides it."
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        }
+      ]
+    },
+    {
+      "tag": "bd-label",
+      "packageExport": "./label",
+      "module": "./src/components/label/label.js",
+      "role": "form",
+      "contentModel": "text-or-children",
+      "props": [
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "small",
+            "default",
+            "large"
+          ]
+        },
+        {
+          "name": "for",
+          "type": "string"
+        },
+        {
+          "name": "required",
+          "type": "boolean"
+        }
+      ]
+    },
+    {
+      "tag": "bd-laurel-icon",
+      "packageExport": "./icons",
+      "module": "./src/components/icons/icons.js",
+      "role": "decoration",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl"
+          ],
+          "description": "A step on the icon scale. Resolves to var(--icon-*-size); an off-scale value falls back to the size the artwork was drawn at."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "description": "Optional. The artwork is drawn in currentColor, so an icon follows the text it sits beside unless this overrides it."
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        }
       ]
     },
     {
@@ -176,103 +2193,320 @@
       "role": "content",
       "contentModel": "text-or-children",
       "props": [
-        { "name": "kind", "type": "string" },
-        { "name": "size", "type": "string" },
-        { "name": "icon", "type": "string" }
+        {
+          "name": "variant",
+          "type": "string",
+          "enum": [
+            "bullet",
+            "number",
+            "check",
+            "none"
+          ],
+          "description": "The marker this item draws. Replaces kind, which still resolves."
+        },
+        {
+          "name": "kind",
+          "type": "string"
+        },
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ],
+          "description": "A size step. Applied as a class; off-scale values fall back to \"md\"."
+        },
+        {
+          "name": "icon",
+          "type": "string"
+        },
+        {
+          "name": "color",
+          "type": "string"
+        }
       ]
     },
     {
-      "tag": "bd-badge",
-      "packageExport": "./badge",
-      "module": "./src/components/badge/badge.js",
-      "role": "content",
-      "contentModel": "text-or-children",
+      "tag": "bd-light-carousel-item",
+      "packageExport": "./light-carousel",
+      "module": "./src/components/light-carousel/light-carousel.js",
+      "role": "item",
+      "contentModel": "children",
       "props": [
-        { "name": "color", "type": "string" },
-        { "name": "variant", "type": "string" },
-        { "name": "size", "type": "string" },
-        { "name": "fontsize", "type": "string" },
-        { "name": "icon", "type": "string" }
+        {
+          "name": "title",
+          "type": "string"
+        },
+        {
+          "name": "headingLevel",
+          "type": "number",
+          "attributeName": "heading-level",
+          "enum": [
+            1,
+            2,
+            3,
+            4,
+            5,
+            6
+          ],
+          "description": "Semantic heading level for this component's title. The type scale does not follow it: level is a document-outline decision that belongs to page composition. Sections default to 2, items to 3."
+        },
+        {
+          "name": "badge",
+          "type": "string"
+        },
+        {
+          "name": "icon",
+          "type": "string"
+        },
+        {
+          "name": "variant",
+          "type": "string",
+          "enum": [
+            "standard",
+            "simple"
+          ],
+          "default": "standard",
+          "description": "Which value set the stylesheet uses. \"simple\" is four columns with a larger icon, a column-direction header, a centred title and different section padding; it is not \"standard without a badge\". These were two element pairs until P6E.1 -- bd-light-carousel-simple-section and -item -- and are now one pair with this attribute."
+        }
       ]
     },
     {
-      "tag": "bd-checkbox",
-      "packageExport": "./checkbox",
-      "module": "./src/components/checkbox/checkbox.js",
-      "role": "form",
-      "contentModel": "none",
+      "tag": "bd-light-carousel-section",
+      "packageExport": "./light-carousel",
+      "module": "./src/components/light-carousel/light-carousel.js",
+      "role": "container",
+      "contentModel": "children",
+      "children": [
+        "bd-light-carousel-item"
+      ],
       "props": [
-        { "name": "name", "type": "string" },
-        { "name": "value", "type": "string" },
-        { "name": "checked", "type": "boolean" },
-        { "name": "disabled", "type": "boolean" },
-        { "name": "label", "type": "string" }
+        {
+          "name": "title",
+          "type": "string"
+        },
+        {
+          "name": "headingLevel",
+          "type": "number",
+          "attributeName": "heading-level",
+          "enum": [
+            1,
+            2,
+            3,
+            4,
+            5,
+            6
+          ],
+          "description": "Semantic heading level for this component's title. The type scale does not follow it: level is a document-outline decision that belongs to page composition. Sections default to 2, items to 3."
+        },
+        {
+          "name": "variant",
+          "type": "string",
+          "enum": [
+            "standard",
+            "simple"
+          ],
+          "default": "standard",
+          "description": "Which value set the stylesheet uses. \"simple\" is four columns with a larger icon, a column-direction header, a centred title and different section padding; it is not \"standard without a badge\". These were two element pairs until P6E.1 -- bd-light-carousel-simple-section and -item -- and are now one pair with this attribute."
+        }
       ]
     },
     {
-      "tag": "bd-radio",
-      "packageExport": "./radio",
-      "module": "./src/components/radio/radio.js",
-      "role": "form",
-      "contentModel": "none",
-      "events": ["change"],
+      "tag": "bd-link",
+      "packageExport": "./link",
+      "module": "./src/components/link/link.js",
+      "role": "content",
+      "contentModel": "text-or-children",
       "props": [
-        { "name": "name", "type": "string" },
-        { "name": "value", "type": "string" },
-        { "name": "checked", "type": "boolean" },
-        { "name": "disabled", "type": "boolean" },
-        { "name": "label", "type": "string" }
+        {
+          "name": "variant",
+          "type": "string",
+          "enum": [
+            "primary",
+            "secondary",
+            "subtle",
+            "bold",
+            "danger"
+          ],
+          "description": "Visual variant. Replaces kind, which still resolves. The earlier light value maps onto surface=\"dark\"."
+        },
+        {
+          "name": "surface",
+          "type": "string",
+          "enum": [
+            "light",
+            "dark"
+          ],
+          "description": "The surface the link sits on, as on bd-button. Replaces the earlier kind=\"light\", which described the surface rather than the link and could not be combined with a real kind; that value still maps onto surface=\"dark\"."
+        },
+        {
+          "name": "href",
+          "type": "string"
+        },
+        {
+          "name": "target",
+          "type": "string"
+        },
+        {
+          "name": "kind",
+          "type": "string"
+        },
+        {
+          "name": "underline",
+          "type": "boolean"
+        },
+        {
+          "name": "disabled",
+          "type": "boolean"
+        },
+        {
+          "name": "inline",
+          "type": "boolean",
+          "description": "The link is a run of text inside a sentence, and takes its size, leading, tracking and family from that sentence -- the --typography-link-default-* role, whose values are all inherit. Without it the link uses the standalone role and renders 1rem whatever surrounds it. Mutually exclusive with fontSize, which is not emitted when this is set."
+        },
+        {
+          "name": "fontSize",
+          "type": "string",
+          "enum": [
+            "xxs",
+            "xs",
+            "sm",
+            "base",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl",
+            "4xl",
+            "5xl",
+            "6xl",
+            "7xl",
+            "8xl",
+            "9xl"
+          ],
+          "description": "A type-scale step. Resolves to var(--typography-fontSize-*). For a link standing on its own; an inline link takes the sentence's size instead, so this is ignored when inline is set."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "enum": [
+            "primary",
+            "strong",
+            "muted",
+            "subtle",
+            "inverse",
+            "success",
+            "warning",
+            "error"
+          ],
+          "description": "A semantic colour role, not a CSS colour. Resolves to a palette token."
+        }
       ]
     },
     {
-      "tag": "bd-toggle-radio",
-      "packageExport": "./radio",
-      "module": "./src/components/radio/radio.js",
-      "role": "form",
-      "contentModel": "none",
-      "events": ["change"],
+      "tag": "bd-list",
+      "packageExport": "./list",
+      "module": "./src/components/list/list.js",
+      "role": "content",
+      "contentModel": "children",
       "props": [
-        { "name": "name", "type": "string" },
-        { "name": "value", "type": "string" },
-        { "name": "checked", "type": "boolean" },
-        { "name": "disabled", "type": "boolean" },
-        { "name": "label", "type": "string" }
+        {
+          "name": "type",
+          "type": "string"
+        },
+        {
+          "name": "spacing",
+          "type": "string"
+        },
+        {
+          "name": "variant",
+          "type": "string"
+        },
+        {
+          "name": "start",
+          "type": "number"
+        },
+        {
+          "name": "orientation",
+          "type": "string"
+        }
       ]
     },
     {
-      "tag": "bd-custom-input",
-      "packageExport": "./input",
-      "module": "./src/components/input/input.js",
-      "role": "form",
+      "tag": "bd-machine-learning-icon",
+      "packageExport": "./icons",
+      "module": "./src/components/icons/icons.js",
+      "role": "decoration",
       "contentModel": "none",
       "props": [
-        { "name": "label", "type": "string" },
-        { "name": "type", "type": "string" },
-        { "name": "kind", "type": "string" },
-        { "name": "placeholder", "type": "string" },
-        { "name": "required", "type": "boolean" },
-        { "name": "focused", "type": "boolean" },
-        { "name": "tooltip", "type": "string" },
-        { "name": "invalid", "type": "boolean" },
-        { "name": "validated", "type": "boolean" },
-        { "name": "disabled", "type": "boolean" }
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl"
+          ],
+          "description": "A step on the icon scale. Resolves to var(--icon-*-size); an off-scale value falls back to the size the artwork was drawn at."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "description": "Optional. The artwork is drawn in currentColor, so an icon follows the text it sits beside unless this overrides it."
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        }
       ]
     },
     {
-      "tag": "bd-custom-dropdown",
-      "packageExport": "./dropdown",
-      "module": "./src/components/dropdown/dropdown.js",
-      "role": "form",
+      "tag": "bd-minus-icon",
+      "packageExport": "./icons",
+      "module": "./src/components/icons/icons.js",
+      "role": "decoration",
       "contentModel": "none",
       "props": [
-        { "name": "label", "type": "string" },
-        { "name": "options", "type": "array" },
-        { "name": "kind", "type": "string" },
-        { "name": "required", "type": "boolean" },
-        { "name": "tooltip", "type": "string" },
-        { "name": "invalid", "type": "boolean" },
-        { "name": "validated", "type": "boolean" },
-        { "name": "disabled", "type": "boolean" }
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl"
+          ],
+          "description": "A step on the icon scale. Resolves to var(--icon-*-size); an off-scale value falls back to the size the artwork was drawn at."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "description": "Optional. The artwork is drawn in currentColor, so an icon follows the text it sits beside unless this overrides it."
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        }
       ]
     },
     {
@@ -282,316 +2516,850 @@
       "role": "overlay",
       "contentModel": "children",
       "props": [
-        { "name": "open", "type": "boolean" },
-        { "name": "title", "type": "string" },
-        { "name": "icon", "type": "string" },
-        { "name": "modalText", "type": "string" }
+        {
+          "name": "open",
+          "type": "boolean"
+        },
+        {
+          "name": "title",
+          "type": "string"
+        },
+        {
+          "name": "icon",
+          "type": "string"
+        },
+        {
+          "name": "modalText",
+          "type": "string"
+        }
       ]
     },
     {
-      "tag": "bd-divider-horizontal",
-      "packageExport": "./divider-horizontal",
-      "module": "./src/components/divider/divider-horizontal.js",
-      "role": "layout",
-      "contentModel": "none",
+      "tag": "bd-p",
+      "packageExport": "./paragraph",
+      "module": "./src/components/paragraph/paragraph.js",
+      "role": "content",
+      "contentModel": "text-or-children",
       "props": [
-        { "name": "width", "type": "string" },
-        { "name": "color", "type": "string" },
-        { "name": "opacity", "type": "string" }
+        {
+          "name": "variant",
+          "type": "string",
+          "enum": [
+            "xsmall",
+            "small",
+            "regular",
+            "large",
+            "lead"
+          ],
+          "description": "Body type role. Replaces kind, which still resolves."
+        },
+        {
+          "name": "kind",
+          "type": "string",
+          "enum": [
+            "xsmall",
+            "small",
+            "regular",
+            "large",
+            "lead"
+          ],
+          "description": "Type scale step. The stylesheet carries all five; this list had only three."
+        },
+        {
+          "name": "fontFamily",
+          "type": "string",
+          "attributeName": "font-family",
+          "enum": [
+            "sans",
+            "mono"
+          ],
+          "description": "A family step, not a CSS font stack. Resolves to var(--typography-fontFamily-*); an off-scale value is dropped."
+        },
+        {
+          "name": "fontWeight",
+          "type": "string",
+          "attributeName": "font-weight",
+          "enum": [
+            "light",
+            "normal",
+            "medium",
+            "semibold",
+            "bold"
+          ],
+          "description": "A weight step. Resolves to var(--typography-fontWeight-*)."
+        },
+        {
+          "name": "padding",
+          "type": "string",
+          "description": "One to four spacing steps, e.g. \"10 0\". Resolves to var(--spacing-N) per part."
+        },
+        {
+          "name": "paddingTop",
+          "type": "string",
+          "description": "A spacing step. Resolves to var(--spacing-N)."
+        },
+        {
+          "name": "paddingBottom",
+          "type": "string",
+          "description": "A spacing step. Resolves to var(--spacing-N)."
+        },
+        {
+          "name": "fontSize",
+          "type": "string",
+          "enum": [
+            "xxs",
+            "xs",
+            "sm",
+            "base",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl",
+            "4xl",
+            "5xl",
+            "6xl",
+            "7xl",
+            "8xl",
+            "9xl"
+          ],
+          "attributeName": "font-size",
+          "description": "A type-scale step. Resolves to var(--typography-fontSize-*). Prefer variant."
+        },
+        {
+          "name": "letterSpacing",
+          "type": "string",
+          "enum": [
+            "tighter",
+            "tight",
+            "normal",
+            "wide",
+            "wider",
+            "widest"
+          ],
+          "attributeName": "letter-spacing",
+          "description": "A tracking step. Resolves to var(--typography-letterSpacing-*)."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "enum": [
+            "primary",
+            "strong",
+            "muted",
+            "subtle",
+            "inverse",
+            "success",
+            "warning",
+            "error"
+          ],
+          "description": "A text colour role, the same vocabulary as bd-h. Anything else is dropped."
+        }
       ]
     },
     {
-      "tag": "bd-divider-vertical",
-      "packageExport": "./divider-vertical",
-      "module": "./src/components/divider/divider-vertical.js",
-      "role": "layout",
+      "tag": "bd-pc-mag-2024-icon",
+      "packageExport": "./marks",
+      "module": "./src/components/icons/marks.js",
+      "role": "decoration",
       "contentModel": "none",
       "props": [
-        { "name": "height", "type": "string" },
-        { "name": "thickness", "type": "string" },
-        { "name": "color", "type": "string" },
-        { "name": "opacity", "type": "string" }
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Rendered width in pixels. Defaults differ per icon, so set it explicitly."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Rendered height in pixels. Defaults differ per icon, so set it explicitly."
+        }
       ]
     },
     {
-      "tag": "bd-accordion-section",
-      "packageExport": "./accordion",
-      "module": "./src/components/accordion/accordion.js",
-      "role": "container",
-      "contentModel": "children",
-      "children": ["bd-accordion-item"],
+      "tag": "bd-pc-mag-business-icon",
+      "packageExport": "./marks",
+      "module": "./src/components/icons/marks.js",
+      "role": "decoration",
+      "contentModel": "none",
       "props": [
-        { "name": "title", "type": "string" },
-        { "name": "variant", "type": "string" },
-        { "name": "guideIcon", "type": "string" },
-        { "name": "guideLabel", "type": "string" },
-        { "name": "guideHref", "type": "string" }
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Rendered width in pixels. Defaults differ per icon, so set it explicitly."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Rendered height in pixels. Defaults differ per icon, so set it explicitly."
+        }
       ]
     },
     {
-      "tag": "bd-accordion-item",
-      "packageExport": "./accordion",
-      "module": "./src/components/accordion/accordion.js",
-      "role": "item",
-      "contentModel": "children",
+      "tag": "bd-pc-mag-icon",
+      "packageExport": "./marks",
+      "module": "./src/components/icons/marks.js",
+      "role": "decoration",
+      "contentModel": "none",
       "props": [
-        { "name": "title", "type": "string" },
-        { "name": "open", "type": "boolean" }
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Rendered width in pixels. Defaults differ per icon, so set it explicitly."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Rendered height in pixels. Defaults differ per icon, so set it explicitly."
+        }
       ]
     },
     {
-      "tag": "bd-accordion-bg",
-      "packageExport": "./accordion-bg",
-      "module": "./src/components/accordion/accordion-bg.js",
-      "role": "container",
-      "contentModel": "children",
-      "children": ["bd-accordion-bg-item"],
+      "tag": "bd-pc-mag-readers-icon",
+      "packageExport": "./marks",
+      "module": "./src/components/icons/marks.js",
+      "role": "decoration",
+      "contentModel": "none",
       "props": [
-        { "name": "title", "type": "string" },
-        { "name": "noBg", "type": "boolean" }
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Rendered width in pixels. Defaults differ per icon, so set it explicitly."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Rendered height in pixels. Defaults differ per icon, so set it explicitly."
+        }
       ]
     },
     {
-      "tag": "bd-accordion-bg-item",
-      "packageExport": "./accordion-bg",
-      "module": "./src/components/accordion/accordion-bg.js",
-      "role": "item",
-      "contentModel": "children",
+      "tag": "bd-picture",
+      "packageExport": "./picture",
+      "module": "./src/components/picture/picture.js",
+      "role": "media",
+      "contentModel": "none",
       "props": [
-        { "name": "title", "type": "string" },
-        { "name": "open", "type": "boolean" },
-        { "name": "noBg", "type": "boolean" }
+        {
+          "name": "sources",
+          "type": "array"
+        },
+        {
+          "name": "fallbackSrc",
+          "type": "string"
+        },
+        {
+          "name": "alt",
+          "type": "string"
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Intrinsic pixel width for the img element's width attribute — an aspect-ratio hint to the browser, not CSS styling. Omitted when unset."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Intrinsic pixel height for the img element's height attribute — an aspect-ratio hint to the browser, not CSS styling. Omitted when unset."
+        },
+        {
+          "name": "loading",
+          "type": "string"
+        },
+        {
+          "name": "fit",
+          "type": "string"
+        },
+        {
+          "name": "radius",
+          "type": "string",
+          "enum": [
+            "none",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl",
+            "full"
+          ],
+          "description": "A radius step. Applied as a class; off-scale values fall back to \"none\"."
+        },
+        {
+          "name": "referrerPolicy",
+          "type": "string",
+          "attributeName": "referrer-policy",
+          "description": "Passed to the img's referrerpolicy attribute."
+        }
       ]
     },
     {
-      "tag": "bd-header",
-      "packageExport": "./header",
-      "module": "./src/components/header/header.js",
-      "role": "section",
+      "tag": "bd-plus-icon",
+      "packageExport": "./icons",
+      "module": "./src/components/icons/icons.js",
+      "role": "decoration",
       "contentModel": "none",
       "props": [
-        { "name": "title", "type": "string" },
-        { "name": "subtitle", "type": "string" },
-        { "name": "description", "type": "string" },
-        { "name": "fullPrice", "type": "string" },
-        { "name": "discount", "type": "string" },
-        { "name": "finalPrice", "type": "string" },
-        { "name": "productId", "type": "string" },
-        { "name": "devices", "type": "string" },
-        { "name": "subscription", "type": "string" },
-        { "name": "shadow", "type": "boolean" },
-        { "name": "dataLayerEvent", "type": "string" }
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl",
+            "2xl",
+            "3xl"
+          ],
+          "description": "A step on the icon scale. Resolves to var(--icon-*-size); an off-scale value falls back to the size the artwork was drawn at."
+        },
+        {
+          "name": "color",
+          "type": "string",
+          "description": "Optional. The artwork is drawn in currentColor, so an icon follows the text it sits beside unless this overrides it."
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Deprecated — pass size. An explicit pixel size, honoured for callers that still use it."
+        }
       ]
     },
     {
-      "tag": "bd-footer",
-      "packageExport": "./footer",
-      "module": "./src/components/footer/footer.js",
-      "role": "section",
+      "tag": "bd-pricing-container",
+      "packageExport": "./pricing-cards",
+      "module": "./src/components/pricing-cards/pricing-card.js",
+      "role": "container",
       "contentModel": "children",
+      "children": [
+        "pricing-switch",
+        "pricing-card",
+        "pricing-card-family"
+      ],
       "props": [
-        { "name": "currentLocale", "type": "string" },
-        { "name": "maxColumnsPerRow", "type": "number" }
+        {
+          "name": "planType",
+          "type": "string"
+        },
+        {
+          "name": "locale",
+          "type": "string"
+        },
+        {
+          "name": "currency",
+          "type": "string"
+        },
+        {
+          "name": "shadow",
+          "type": "boolean"
+        }
       ]
     },
     {
-      "tag": "bd-footer-lp",
-      "packageExport": "./footer-lp",
-      "module": "./src/components/footer/footer-lp.js",
-      "role": "section",
-      "contentModel": "children",
+      "tag": "bd-progress",
+      "packageExport": "./progress",
+      "module": "./src/components/progress/progress.js",
+      "role": "content",
+      "contentModel": "none",
       "props": [
-        { "name": "currentLocale", "type": "string" }
+        {
+          "name": "value",
+          "type": "number"
+        },
+        {
+          "name": "max",
+          "type": "number"
+        },
+        {
+          "name": "label",
+          "type": "string"
+        },
+        {
+          "name": "tone",
+          "type": "string",
+          "enum": [
+            "info",
+            "success",
+            "error"
+          ]
+        }
       ]
     },
     {
-      "tag": "bd-footer-links-group",
-      "packageExport": "./footer-links-group",
-      "module": "./src/components/footer/footer-links-group.js",
-      "role": "item",
-      "contentModel": "children",
+      "tag": "bd-radio",
+      "packageExport": "./radio",
+      "module": "./src/components/radio/radio.js",
+      "role": "form",
+      "contentModel": "text-or-children",
+      "events": [
+        "change"
+      ],
       "props": [
-        { "name": "title", "type": "string" }
+        {
+          "name": "name",
+          "type": "string",
+          "description": "Groups the radios: selecting one clears every other bd-radio with the same name in the same root. Carried on the change event. NOT submitted with a form."
+        },
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Emitted in the change event detail when selected. Not submitted with a form."
+        },
+        {
+          "name": "checked",
+          "type": "boolean",
+          "description": "Whether this option is selected. Exactly one radio per name should be checked."
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "description": "Blocks selection, greys the circle and label, and removes it from the tab order and from arrow navigation."
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "description": "Label text, and the fallback for the default slot — slotted content wins, so markup such as a link can go inside the label."
+        }
       ]
     },
     {
-      "tag": "bd-footer-nav",
-      "packageExport": "./footer-nav-menu",
-      "module": "./src/components/footer/footer-nav-menu.js",
-      "role": "item",
-      "contentModel": "children",
+      "tag": "bd-skeleton",
+      "packageExport": "./skeleton",
+      "module": "./src/components/skeleton/skeleton.js",
+      "role": "content",
+      "contentModel": "none",
       "props": [
-        { "name": "bold", "type": "boolean" }
+        {
+          "name": "lines",
+          "type": "number"
+        },
+        {
+          "name": "shape",
+          "type": "string",
+          "enum": [
+            "line",
+            "title",
+            "circle"
+          ]
+        }
       ]
     },
     {
-      "tag": "bd-highlight",
-      "packageExport": "./highlight",
-      "module": "./src/components/highlight/highlight.js",
-      "role": "section",
-      "contentModel": "children",
+      "tag": "bd-spinner",
+      "packageExport": "./spinner",
+      "module": "./src/components/spinner/spinner.js",
+      "role": "content",
+      "contentModel": "none",
       "props": [
-        { "name": "highlightText", "type": "string", "attributeName": "highlight-text" },
-        { "name": "subTitle", "type": "string", "attributeName": "sub-title" }
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "small",
+            "default",
+            "large"
+          ]
+        },
+        {
+          "name": "surface",
+          "type": "string",
+          "enum": [
+            "light",
+            "dark"
+          ],
+          "description": "The surface the spinner sits on. Use \"dark\" on a filled panel: the default arc and track are both chosen against a white page."
+        },
+        {
+          "name": "label",
+          "type": "string"
+        }
       ]
     },
     {
-      "tag": "bd-anchor-nav",
-      "packageExport": "./anchor",
-      "module": "./src/components/anchor/anchor-nav.js",
-      "role": "navigation",
-      "contentModel": "children",
-      "children": ["bd-anchor-nav-item"],
-      "props": [
-        { "name": "navLabel", "type": "string", "attributeName": "aria-label" }
-      ]
+      "tag": "bd-sub",
+      "packageExport": "./annotation",
+      "module": "./src/components/annotation/annotation.js",
+      "role": "content",
+      "contentModel": "text-or-children",
+      "props": []
     },
     {
-      "tag": "bd-anchor-nav-item",
-      "packageExport": "./anchor",
-      "module": "./src/components/anchor/anchor-nav.js",
-      "role": "item",
+      "tag": "bd-sup",
+      "packageExport": "./annotation",
+      "module": "./src/components/annotation/annotation.js",
+      "role": "content",
       "contentModel": "text-or-children",
       "props": []
     },
     {
-      "tag": "bd-carousel-section",
-      "packageExport": "./carousel",
-      "module": "./src/components/carousel/carousel.js",
-      "role": "container",
-      "contentModel": "children",
-      "children": ["bd-carousel-item"],
+      "tag": "bd-switch",
+      "packageExport": "./switch",
+      "module": "./src/components/switch/switch.js",
+      "role": "form",
+      "contentModel": "text-or-children",
+      "events": [
+        "bd-change"
+      ],
       "props": [
-        { "name": "title", "type": "string" },
-        { "name": "selectedItem", "type": "object" }
+        {
+          "name": "checked",
+          "type": "boolean"
+        },
+        {
+          "name": "disabled",
+          "type": "boolean"
+        },
+        {
+          "name": "label",
+          "type": "string"
+        },
+        {
+          "name": "name",
+          "type": "string"
+        }
       ]
     },
     {
-      "tag": "bd-carousel-item",
-      "packageExport": "./carousel",
-      "module": "./src/components/carousel/carousel.js",
-      "role": "item",
-      "contentModel": "children",
+      "tag": "bd-tab-list",
+      "packageExport": "./tab-list",
+      "module": "./src/components/tab-list/tab-list.js",
+      "role": "navigation",
+      "contentModel": "empty",
+      "events": [
+        "bd-tab-select"
+      ],
       "props": [
-        { "name": "icon", "type": "string" },
-        { "name": "title", "type": "string" },
-        { "name": "modalText", "type": "string" }
+        {
+          "name": "tabs",
+          "type": "array"
+        },
+        {
+          "name": "selected",
+          "type": "number"
+        },
+        {
+          "name": "label",
+          "type": "string"
+        },
+        {
+          "name": "panelId",
+          "type": "string"
+        },
+        {
+          "name": "idPrefix",
+          "type": "string"
+        },
+        {
+          "name": "appearance",
+          "type": "string",
+          "enum": [
+            "switcher"
+          ],
+          "description": "The skin. Omitted draws the underlined tab strip; \"switcher\" draws the Content Switcher, a pill track with the selected option on a white pill. Same control underneath — role, ARIA and the keyboard pattern are identical."
+        }
       ]
     },
     {
-      "tag": "bd-light-carousel-section",
-      "packageExport": "./light-carousel",
-      "module": "./src/components/light-carousel/light-carousel.js",
-      "role": "container",
-      "contentModel": "children",
-      "children": ["bd-light-carousel-item"],
+      "tag": "bd-tag",
+      "packageExport": "./tag",
+      "module": "./src/components/tag/tag.js",
+      "role": "content",
+      "contentModel": "text-or-children",
       "props": [
-        { "name": "title", "type": "string" }
+        {
+          "name": "tone",
+          "type": "string",
+          "enum": [
+            "neutral",
+            "brand",
+            "success",
+            "warning",
+            "error",
+            "info"
+          ],
+          "description": "Semantic colour pairing, shared with bd-badge and bd-alert and drawn from the --status-* roles."
+        }
       ]
     },
     {
-      "tag": "bd-light-carousel-item",
-      "packageExport": "./light-carousel",
-      "module": "./src/components/light-carousel/light-carousel.js",
-      "role": "item",
-      "contentModel": "children",
+      "tag": "bd-terms-section",
+      "packageExport": "./terms",
+      "module": "./src/components/termsOfUse/terms.js",
+      "role": "section",
+      "contentModel": "none",
       "props": [
-        { "name": "title", "type": "string" },
-        { "name": "badge", "type": "string" },
-        { "name": "icon", "type": "string" }
+        {
+          "name": "faqs",
+          "type": "array"
+        }
       ]
     },
     {
-      "tag": "bd-compare-section",
-      "packageExport": "./compare",
-      "module": "./src/components/compare/compare.js",
-      "role": "container",
-      "contentModel": "children",
-      "children": ["compare-card", "compare-bar"],
+      "tag": "bd-textarea",
+      "packageExport": "./textarea",
+      "module": "./src/components/textarea/textarea.js",
+      "role": "form",
+      "contentModel": "none",
+      "events": [
+        "bd-input",
+        "bd-change"
+      ],
       "props": [
-        { "name": "title", "type": "string" },
-        { "name": "subtitle", "type": "string" },
-        { "name": "columns", "type": "number" },
-        { "name": "gap", "type": "string" }
+        {
+          "name": "label",
+          "type": "string",
+          "description": "The field's own label. Empty renders no label element at all."
+        },
+        {
+          "name": "size",
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ],
+          "description": "Sets padding, type step and radius to match a button or input of the same size. Height still comes from `rows`."
+        },
+        {
+          "name": "value",
+          "type": "string"
+        },
+        {
+          "name": "placeholder",
+          "type": "string"
+        },
+        {
+          "name": "rows",
+          "type": "number"
+        },
+        {
+          "name": "required",
+          "type": "boolean"
+        },
+        {
+          "name": "tooltip",
+          "type": "string",
+          "description": "Help text rendered below the control, and the field's accessible description."
+        },
+        {
+          "name": "invalid",
+          "type": "boolean"
+        },
+        {
+          "name": "validated",
+          "type": "boolean"
+        },
+        {
+          "name": "disabled",
+          "type": "boolean"
+        },
+        {
+          "name": "name",
+          "type": "string"
+        }
       ]
     },
     {
-      "tag": "compare-card",
-      "packageExport": "./compare",
-      "module": "./src/components/compare/compare.js",
-      "role": "item",
+      "tag": "bd-toggle-radio",
+      "packageExport": "./radio",
+      "module": "./src/components/radio/radio.js",
+      "role": "form",
+      "contentModel": "text-or-children",
+      "events": [
+        "change"
+      ],
+      "props": [
+        {
+          "name": "name",
+          "type": "string",
+          "description": "Carried on the change event only. Unlike bd-radio this element does not group or enforce exclusivity. NOT submitted with a form."
+        },
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Emitted in the change event detail when selected. Not submitted with a form."
+        },
+        {
+          "name": "checked",
+          "type": "boolean",
+          "description": "Whether it is on. Toggles independently of any sibling."
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "description": "Blocks selection, greys the circle and label, and removes it from the tab order and from arrow navigation."
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "description": "Label text, and the fallback for the default slot — slotted content wins, so markup such as a link can go inside the label."
+        }
+      ],
+      "deprecated": "Circular styling with role=\"checkbox\" and independent toggling — it looks exclusive but is not. Use bd-checkbox."
+    },
+    {
+      "tag": "bd-tooltip",
+      "packageExport": "./tooltip",
+      "module": "./src/components/tooltip/tooltip.js",
+      "role": "overlay",
       "contentModel": "children",
       "props": [
-        { "name": "title", "type": "string" },
-        { "name": "description", "type": "string" },
-        { "name": "footnote", "type": "string" },
-        { "name": "footnoteHref", "type": "string", "attributeName": "footnote-href" },
-        { "name": "iconSrc", "type": "string", "attributeName": "icon-src" },
-        { "name": "barStretch", "type": "boolean", "attributeName": "bar-stretch" },
-        { "name": "barFillMin", "type": "number", "attributeName": "bar-fill-min" },
-        { "name": "barStretchGamma", "type": "number", "attributeName": "bar-stretch-gamma" },
-        { "name": "chartScale", "type": "number", "attributeName": "chart-scale" }
+        {
+          "name": "text",
+          "type": "string"
+        }
       ]
     },
     {
-      "tag": "compare-bar",
-      "packageExport": "./compare",
-      "module": "./src/components/compare/compare.js",
-      "role": "item",
+      "tag": "bd-top-product-icon",
+      "packageExport": "./marks",
+      "module": "./src/components/icons/marks.js",
+      "role": "decoration",
       "contentModel": "none",
       "props": [
-        { "name": "label", "type": "string" },
-        { "name": "score", "type": "number" },
-        { "name": "maxScore", "type": "number", "attributeName": "max-score" },
-        { "name": "variant", "type": "string" },
-        { "name": "scoreLabel", "type": "string", "attributeName": "score-label" },
-        { "name": "referenceScore", "type": "number", "attributeName": "reference-score" },
-        { "name": "scale", "type": "number" }
+        {
+          "name": "width",
+          "type": "number",
+          "description": "Rendered width in pixels. Defaults differ per icon, so set it explicitly."
+        },
+        {
+          "name": "height",
+          "type": "number",
+          "description": "Rendered height in pixels. Defaults differ per icon, so set it explicitly."
+        }
       ]
     },
     {
-      "tag": "bd-tabs-component",
-      "packageExport": "./tabs",
-      "module": "./src/components/tabs/tabs.js",
-      "role": "navigation",
+      "tag": "bd-video",
+      "packageExport": "./video",
+      "module": "./src/components/video/video.js",
+      "role": "media",
       "contentModel": "children",
       "props": [
-        { "name": "selectedTab", "type": "number" }
+        {
+          "name": "src",
+          "type": "string"
+        },
+        {
+          "name": "poster",
+          "type": "string"
+        },
+        {
+          "name": "controls",
+          "type": "boolean"
+        },
+        {
+          "name": "muted",
+          "type": "boolean"
+        },
+        {
+          "name": "loop",
+          "type": "boolean"
+        }
       ]
     },
     {
-      "tag": "bd-terms-section",
-      "packageExport": "./terms",
-      "module": "./src/components/termsOfUse/terms.js",
-      "role": "section",
-      "contentModel": "none",
-      "props": [
-        { "name": "faqs", "type": "array" }
-      ]
+      "tag": "bd-visually-hidden",
+      "packageExport": "./visually-hidden",
+      "module": "./src/components/visually-hidden/visually-hidden.js",
+      "role": "content",
+      "contentModel": "text-or-children",
+      "props": []
     },
     {
-      "tag": "bd-pricing-container",
-      "packageExport": "./pricing-cards",
-      "module": "./src/components/pricing-cards/pricing-card.js",
-      "role": "container",
-      "contentModel": "children",
-      "children": ["pricing-switch", "pricing-card", "pricing-card-family"],
+      "tag": "compare-bar",
+      "packageExport": "./compare",
+      "module": "./src/components/compare/compare.js",
+      "role": "item",
+      "contentModel": "none",
       "props": [
-        { "name": "planType", "type": "string" },
-        { "name": "locale", "type": "string" },
-        { "name": "currency", "type": "string" },
-        { "name": "shadow", "type": "boolean" }
+        {
+          "name": "label",
+          "type": "string"
+        },
+        {
+          "name": "score",
+          "type": "number"
+        },
+        {
+          "name": "maxScore",
+          "type": "number",
+          "attributeName": "max-score"
+        },
+        {
+          "name": "variant",
+          "type": "string"
+        },
+        {
+          "name": "scoreLabel",
+          "type": "string",
+          "attributeName": "score-label"
+        },
+        {
+          "name": "referenceScore",
+          "type": "number",
+          "attributeName": "reference-score"
+        },
+        {
+          "name": "scale",
+          "type": "number"
+        }
       ]
     },
     {
-      "tag": "pricing-switch",
-      "packageExport": "./pricing-cards",
-      "module": "./src/components/pricing-cards/pricing-card.js",
-      "role": "control",
-      "contentModel": "none",
+      "tag": "compare-card",
+      "packageExport": "./compare",
+      "module": "./src/components/compare/compare.js",
+      "role": "item",
+      "contentModel": "children",
       "props": [
-        { "name": "planType", "type": "string" },
-        { "name": "shadow", "type": "boolean" }
+        {
+          "name": "title",
+          "type": "string"
+        },
+        {
+          "name": "description",
+          "type": "string"
+        },
+        {
+          "name": "footnote",
+          "type": "string"
+        },
+        {
+          "name": "footnoteHref",
+          "type": "string",
+          "attributeName": "footnote-href"
+        },
+        {
+          "name": "iconSrc",
+          "type": "string",
+          "attributeName": "icon-src"
+        },
+        {
+          "name": "barStretch",
+          "type": "boolean",
+          "attributeName": "bar-stretch"
+        },
+        {
+          "name": "barFillMin",
+          "type": "number",
+          "attributeName": "bar-fill-min"
+        },
+        {
+          "name": "barStretchGamma",
+          "type": "number",
+          "attributeName": "bar-stretch-gamma"
+        },
+        {
+          "name": "chartScale",
+          "type": "number",
+          "attributeName": "chart-scale"
+        }
       ]
     },
     {
@@ -601,18 +3369,55 @@
       "role": "item",
       "contentModel": "children",
       "props": [
-        { "name": "title", "type": "string" },
-        { "name": "features", "type": "boolean" },
-        { "name": "privacy", "type": "boolean" },
-        { "name": "highlight", "type": "boolean" },
-        { "name": "identity", "type": "boolean" },
-        { "name": "identityExtended", "type": "boolean" },
-        { "name": "parentalControl", "type": "boolean" },
-        { "name": "planType", "type": "string" },
-        { "name": "productId", "type": "string", "attributeName": "product-id" },
-        { "name": "locale", "type": "string" },
-        { "name": "currency", "type": "string" },
-        { "name": "shadow", "type": "boolean" }
+        {
+          "name": "title",
+          "type": "string"
+        },
+        {
+          "name": "features",
+          "type": "boolean"
+        },
+        {
+          "name": "privacy",
+          "type": "boolean"
+        },
+        {
+          "name": "highlight",
+          "type": "boolean"
+        },
+        {
+          "name": "identity",
+          "type": "boolean"
+        },
+        {
+          "name": "identityExtended",
+          "type": "boolean"
+        },
+        {
+          "name": "parentalControl",
+          "type": "boolean"
+        },
+        {
+          "name": "planType",
+          "type": "string"
+        },
+        {
+          "name": "productId",
+          "type": "string",
+          "attributeName": "product-id"
+        },
+        {
+          "name": "locale",
+          "type": "string"
+        },
+        {
+          "name": "currency",
+          "type": "string"
+        },
+        {
+          "name": "shadow",
+          "type": "boolean"
+        }
       ]
     },
     {
@@ -622,18 +3427,55 @@
       "role": "item",
       "contentModel": "children",
       "props": [
-        { "name": "title", "type": "string" },
-        { "name": "features", "type": "boolean" },
-        { "name": "privacy", "type": "boolean" },
-        { "name": "highlight", "type": "boolean" },
-        { "name": "identity", "type": "boolean" },
-        { "name": "identityExtended", "type": "boolean" },
-        { "name": "parentalControl", "type": "boolean" },
-        { "name": "planType", "type": "string" },
-        { "name": "productId", "type": "string", "attributeName": "product-id" },
-        { "name": "locale", "type": "string" },
-        { "name": "currency", "type": "string" },
-        { "name": "shadow", "type": "boolean" }
+        {
+          "name": "title",
+          "type": "string"
+        },
+        {
+          "name": "features",
+          "type": "boolean"
+        },
+        {
+          "name": "privacy",
+          "type": "boolean"
+        },
+        {
+          "name": "highlight",
+          "type": "boolean"
+        },
+        {
+          "name": "identity",
+          "type": "boolean"
+        },
+        {
+          "name": "identityExtended",
+          "type": "boolean"
+        },
+        {
+          "name": "parentalControl",
+          "type": "boolean"
+        },
+        {
+          "name": "planType",
+          "type": "string"
+        },
+        {
+          "name": "productId",
+          "type": "string",
+          "attributeName": "product-id"
+        },
+        {
+          "name": "locale",
+          "type": "string"
+        },
+        {
+          "name": "currency",
+          "type": "string"
+        },
+        {
+          "name": "shadow",
+          "type": "boolean"
+        }
       ]
     },
     {
@@ -643,52 +3485,99 @@
       "role": "subcomponent",
       "contentModel": "none",
       "props": [
-        { "name": "features", "type": "array" },
-        { "name": "shadow", "type": "boolean" }
+        {
+          "name": "features",
+          "type": "array"
+        },
+        {
+          "name": "shadow",
+          "type": "boolean"
+        }
       ]
     },
     {
-      "tag": "pricing-card-privacy",
+      "tag": "pricing-card-identity",
       "packageExport": "./pricing-cards",
       "module": "./src/components/pricing-cards/pricing-card.js",
       "role": "subcomponent",
       "contentModel": "none",
       "props": [
-        { "name": "privacy", "type": "array" },
-        { "name": "shadow", "type": "boolean" }
+        {
+          "name": "identity",
+          "type": "array"
+        },
+        {
+          "name": "shadow",
+          "type": "boolean"
+        }
       ]
     },
     {
-      "tag": "pricing-card-identity",
+      "tag": "pricing-card-identity-extended",
       "packageExport": "./pricing-cards",
       "module": "./src/components/pricing-cards/pricing-card.js",
       "role": "subcomponent",
       "contentModel": "none",
       "props": [
-        { "name": "identity", "type": "array" },
-        { "name": "shadow", "type": "boolean" }
+        {
+          "name": "identity",
+          "type": "array"
+        },
+        {
+          "name": "shadow",
+          "type": "boolean"
+        }
       ]
     },
     {
-      "tag": "pricing-card-identity-extended",
+      "tag": "pricing-card-parental-control",
       "packageExport": "./pricing-cards",
       "module": "./src/components/pricing-cards/pricing-card.js",
       "role": "subcomponent",
       "contentModel": "none",
       "props": [
-        { "name": "identity", "type": "array" },
-        { "name": "shadow", "type": "boolean" }
+        {
+          "name": "parentalControl",
+          "type": "array"
+        },
+        {
+          "name": "shadow",
+          "type": "boolean"
+        }
       ]
     },
     {
-      "tag": "pricing-card-parental-control",
+      "tag": "pricing-card-privacy",
       "packageExport": "./pricing-cards",
       "module": "./src/components/pricing-cards/pricing-card.js",
       "role": "subcomponent",
       "contentModel": "none",
       "props": [
-        { "name": "parentalControl", "type": "array" },
-        { "name": "shadow", "type": "boolean" }
+        {
+          "name": "privacy",
+          "type": "array"
+        },
+        {
+          "name": "shadow",
+          "type": "boolean"
+        }
+      ]
+    },
+    {
+      "tag": "pricing-switch",
+      "packageExport": "./pricing-cards",
+      "module": "./src/components/pricing-cards/pricing-card.js",
+      "role": "control",
+      "contentModel": "none",
+      "props": [
+        {
+          "name": "planType",
+          "type": "string"
+        },
+        {
+          "name": "shadow",
+          "type": "boolean"
+        }
       ]
     }
   ]