bestax-mcp 1.2.2 → 1.2.4

package/README.md

@@ -96,4 +96,4 @@ One per skill, so a task can start from the library's own guidance:
 - [Documentation](https://bestax.io)
 - [GitHub](https://github.com/allxsmith/bestax)
 
-MIT © Alex Smith
+Source code licensed MIT

package/data/catalog.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "generatedFrom": {
     "package": "@allxsmith/bestax-bulma",
-    "version": "5.11.5"
+    "version": "5.15.0"
   },
   "docsBase": "https://bestax.io/docs",
   "categories": [
@@ -206,7 +206,7 @@
       "import": "import { Button } from '@allxsmith/bestax-bulma';",
       "compound": false,
       "propCount": 23,
-      "exampleCount": 24
+      "exampleCount": 25
     },
     {
       "name": "Buttons",
@@ -216,8 +216,8 @@
       "slug": "elements/buttons",
       "import": "import { Buttons } from '@allxsmith/bestax-bulma';",
       "compound": true,
-      "propCount": 52,
-      "exampleCount": 7
+      "propCount": 53,
+      "exampleCount": 8
     },
     {
       "name": "Card",
@@ -403,8 +403,8 @@
       "slug": "components/dialog",
       "import": "import { Dialog, DialogContainer, dialog } from '@allxsmith/bestax-bulma';",
       "compound": false,
-      "propCount": 12,
-      "exampleCount": 5
+      "propCount": 13,
+      "exampleCount": 6
     },
     {
       "name": "Divider",
@@ -425,8 +425,8 @@
       "slug": "components/dropdown",
       "import": "import { Dropdown } from '@allxsmith/bestax-bulma';",
       "compound": true,
-      "propCount": 16,
-      "exampleCount": 7
+      "propCount": 17,
+      "exampleCount": 8
     },
     {
       "name": "Emphasis",
@@ -513,8 +513,8 @@
       "slug": "elements/icon",
       "import": "import { Icon } from '@allxsmith/bestax-bulma';",
       "compound": false,
-      "propCount": 14,
-      "exampleCount": 11
+      "propCount": 15,
+      "exampleCount": 12
     },
     {
       "name": "IconText",
@@ -524,7 +524,7 @@
       "slug": "elements/icontext",
       "import": "import { IconText } from '@allxsmith/bestax-bulma';",
       "compound": true,
-      "propCount": 21,
+      "propCount": 22,
       "exampleCount": 11
     },
     {
@@ -580,7 +580,7 @@
       "import": "import { LinkButton } from '@allxsmith/bestax-bulma';",
       "compound": false,
       "propCount": 21,
-      "exampleCount": 9
+      "exampleCount": 10
     },
     {
       "name": "ListItem",
@@ -634,7 +634,7 @@
       "slug": "components/message",
       "import": "import { Message } from '@allxsmith/bestax-bulma';",
       "compound": true,
-      "propCount": 11,
+      "propCount": 12,
       "exampleCount": 8
     },
     {
@@ -645,8 +645,8 @@
       "slug": "components/modal",
       "import": "import { Modal } from '@allxsmith/bestax-bulma';",
       "compound": true,
-      "propCount": 20,
-      "exampleCount": 8
+      "propCount": 23,
+      "exampleCount": 10
     },
     {
       "name": "Navbar",
@@ -656,8 +656,8 @@
       "slug": "components/navbar",
       "import": "import { Navbar } from '@allxsmith/bestax-bulma';",
       "compound": true,
-      "propCount": 54,
-      "exampleCount": 16
+      "propCount": 55,
+      "exampleCount": 17
     },
     {
       "name": "Notification",
@@ -711,7 +711,7 @@
       "slug": "components/panel",
       "import": "import { Panel } from '@allxsmith/bestax-bulma';",
       "compound": true,
-      "propCount": 34,
+      "propCount": 35,
       "exampleCount": 3
     },
     {
@@ -949,12 +949,12 @@
       "name": "Tags",
       "kind": "component",
       "category": "elements",
-      "purpose": "The `Tags` component groups multiple `Tag` components together in a horizontal (or multiline) Bulma-styled container.",
+      "purpose": "The `Tags` component groups multiple `Tag` components together in a Bulma-styled container that wraps onto multiple lines by default.",
       "slug": "elements/tags",
       "import": "import { Tags } from '@allxsmith/bestax-bulma';",
       "compound": true,
-      "propCount": 13,
-      "exampleCount": 7
+      "propCount": 14,
+      "exampleCount": 8
     },
     {
       "name": "TextArea",
@@ -1064,7 +1064,7 @@
       "import": "import { useBulmaClasses } from '@allxsmith/bestax-bulma';",
       "compound": false,
       "propCount": 0,
-      "exampleCount": 40
+      "exampleCount": 43
     },
     {
       "name": "usePrefixedClassNames",

package/data/components/Button.json

@@ -91,6 +91,10 @@
     {
       "title": "Polymorphic `as` (Router Links)",
       "code": "import { Link as RouterLink } from 'react-router-dom';\nimport { Button } from '@allxsmith/bestax-bulma';\n\n<Button as={RouterLink} to=\"/visit\" color=\"primary\">\n  Book a visit\n</Button>;"
+    },
+    {
+      "title": "Forwarded ref",
+      "code": "function example() {\n  const buttonRef = React.useRef(null);\n  const [tag, setTag] = React.useState(null);\n\n  return (\n    <>\n      <Button color=\"primary\" ref={buttonRef}>\n        Target\n      </Button>\n      <Button ml=\"2\" onClick={() => setTag(buttonRef.current?.tagName)}>\n        Read the tag from its ref\n      </Button>\n      <p>Rendered element: {tag ?? '—'}</p>\n    </>\n  );\n}"
     }
   ],
   "accessibility": "- **Labeling:** Always provide descriptive content for buttons for screen readers.\n- **States:** The `isDisabled` and `disabled` props ensure correct `aria-disabled` and `disabled` attributes.\n- **Keyboard:** When rendered as `<a>`, disabled buttons are not focusable.\n- **Focus:** Use `isFocused` and `isActive` for visual feedback, but rely on browser focus for actual accessibility.\n\n:::note\nIf your button has only an icon, use `aria-label` to provide accessible text.\n:::",
@@ -317,7 +321,17 @@
           "deprecated": false
         }
       ],
-      "extraProps": [],
+      "extraProps": [
+        {
+          "name": "ref",
+          "type": "React.Ref<HTMLButtonElement | HTMLAnchorElement>",
+          "default": null,
+          "description": "Ref forwarded to the rendered button or anchor element.",
+          "required": false,
+          "inherited": false,
+          "deprecated": false
+        }
+      ],
       "catchAll": "All standard <button> attributes and Bulma helper props",
       "types": []
     }

package/data/components/Buttons.json

@@ -17,6 +17,10 @@
       "title": "All Sizes Group",
       "code": "<Buttons>\n  {['small', 'normal', 'medium', 'large'].map(size => (\n    <Button key={size} size={size}>\n      {size.charAt(0).toUpperCase() + size.slice(1)}\n    </Button>\n  ))}\n</Buttons>"
     },
+    {
+      "title": "Group Size",
+      "code": "<>\n  <Buttons size=\"small\">\n    <Button color=\"primary\">Small</Button>\n    <Button color=\"info\">Small</Button>\n  </Buttons>\n  <Buttons size=\"medium\">\n    <Button color=\"primary\">Medium</Button>\n    <Button color=\"info\">Medium</Button>\n  </Buttons>\n  <Buttons size=\"large\">\n    <Button color=\"primary\">Large</Button>\n    <Button color=\"info\">Large</Button>\n  </Buttons>\n</>"
+    },
     {
       "title": "Add-ons (No Spacing Between Buttons)",
       "code": "<Buttons hasAddons>\n  <Button color=\"primary\">Left</Button>\n  <Button color=\"primary\">Center</Button>\n  <Button color=\"primary\">Right</Button>\n</Buttons>"
@@ -112,6 +116,15 @@
           "inherited": false,
           "deprecated": false
         },
+        {
+          "name": "size",
+          "type": "'small' | 'medium' | 'large'",
+          "default": null,
+          "description": "Size of the button group.",
+          "required": false,
+          "inherited": false,
+          "deprecated": false
+        },
         {
           "name": "children",
           "type": "React.ReactNode",
@@ -342,7 +355,17 @@
           "deprecated": false
         }
       ],
-      "extraProps": [],
+      "extraProps": [
+        {
+          "name": "ref",
+          "type": "React.Ref<HTMLButtonElement | HTMLAnchorElement>",
+          "default": null,
+          "description": "Ref forwarded to the rendered button or anchor element.",
+          "required": false,
+          "inherited": false,
+          "deprecated": false
+        }
+      ],
       "catchAll": "All standard <button> attributes and Bulma helper props",
       "types": []
     },
@@ -544,7 +567,17 @@
           "deprecated": false
         }
       ],
-      "extraProps": [],
+      "extraProps": [
+        {
+          "name": "ref",
+          "type": "React.Ref<HTMLButtonElement | HTMLAnchorElement>",
+          "default": null,
+          "description": "Ref forwarded to the rendered button or anchor element.",
+          "required": false,
+          "inherited": false,
+          "deprecated": false
+        }
+      ],
       "catchAll": "All standard <button> attributes and Bulma helper props",
       "types": []
     }

package/data/components/Control.json

@@ -169,18 +169,18 @@
         },
         {
           "name": "iconLeft",
-          "type": "IconProps",
+          "type": "IconProps | React.ReactNode",
           "default": null,
-          "description": "Icon props for left icon.",
+          "description": "Icon props for left icon, or a custom node (an inline SVG, a `react-icons` component, …) rendered in place of a class-based glyph.",
           "required": false,
           "inherited": true,
           "deprecated": false
         },
         {
           "name": "iconRight",
-          "type": "IconProps",
+          "type": "IconProps | React.ReactNode",
           "default": null,
-          "description": "Icon props for right icon.",
+          "description": "Icon props for right icon, or a custom node (an inline SVG, a `react-icons` component, …) rendered in place of a class-based glyph.",
           "required": false,
           "inherited": true,
           "deprecated": false

package/data/components/DateInput.json

@@ -205,7 +205,7 @@
         },
         {
           "name": "iconLeft",
-          "type": "IconProps",
+          "type": "IconProps | React.ReactNode",
           "default": null,
           "description": "Icon props for the left icon.",
           "required": false,
@@ -214,7 +214,7 @@
         },
         {
           "name": "iconRight",
-          "type": "IconProps",
+          "type": "IconProps | React.ReactNode",
           "default": null,
           "description": "Icon props for the right icon.",
           "required": false,

package/data/components/DateTimeInput.json

@@ -213,7 +213,7 @@
         },
         {
           "name": "iconLeft",
-          "type": "IconProps",
+          "type": "IconProps | React.ReactNode",
           "default": null,
           "description": "Icon props for the left icon.",
           "required": false,
@@ -222,7 +222,7 @@
         },
         {
           "name": "iconRight",
-          "type": "IconProps",
+          "type": "IconProps | React.ReactNode",
           "default": null,
           "description": "Icon props for the right icon.",
           "required": false,

package/data/components/Dialog.json

@@ -24,9 +24,13 @@
     {
       "title": "Non-cancelable Dialog",
       "code": "function example() {\n  const [showDialog, setShowDialog] = useState(false);\n  return (\n    <Block>\n      <Button color=\"warning\" onClick={() => setShowDialog(true)}>\n        Show Required Action\n      </Button>\n      <Dialog\n        isOpen={showDialog}\n        title=\"Required Action\"\n        message=\"You must complete this action to continue.\"\n        type=\"warning\"\n        canCancel={false}\n        showCancel={false}\n        confirmText=\"I Understand\"\n        onConfirm={() => setShowDialog(false)}\n      />\n    </Block>\n  );\n}"
+    },
+    {
+      "title": "Portal",
+      "code": "function example() {\n  const [showDialog, setShowDialog] = useState(false);\n  return (\n    <Block>\n      <Button onClick={() => setShowDialog(true)}>Show Portaled Dialog</Button>\n      <Dialog\n        isOpen={showDialog}\n        title=\"Rendered in document.body\"\n        message=\"This dialog is portaled, so it escapes any ancestor with overflow: hidden.\"\n        onConfirm={() => setShowDialog(false)}\n        showCancel={false}\n        portal\n      />\n    </Block>\n  );\n}"
     }
   ],
-  "accessibility": "- Uses `role=\"alertdialog\"` for proper screen reader announcement\n- Has `aria-modal=\"true\"` to indicate modal behavior\n- Focus is trapped within the dialog when open\n- Escape key closes the dialog (when `canCancel` is true)\n- Body scroll is prevented when dialog is open\n- Confirm/cancel buttons are keyboard accessible",
+  "accessibility": "- Uses `role=\"alertdialog\"` for proper screen reader announcement\n- Has `aria-modal=\"true\"` to indicate modal behavior — note this does not make background content inert; no `inert` attribute is applied, so background content stays reachable by pointer\n- `title` is wired up as `aria-labelledby` and `message` as `aria-describedby`\n- Focus moves to the confirm (or cancel, with `focusCancel`) button when opened\n- Escape key closes the dialog (when `canCancel` is true) — handled by the underlying [`Modal`](./modal.md), which routes it to the topmost open modal only\n- Tab and Shift+Tab cycle within the dialog while it is open — also from the underlying [`Modal`](./modal.md)\n- Body scroll is prevented when dialog is open, through the ref-counted lock shared with `Modal`, `Sidebar` and `Loading`\n- Confirm/cancel buttons are keyboard accessible",
   "related": ["Modal", "Toast"],
   "storybook": "https://bestax.io/storybook/?path=/story/components-dialog",
   "summary": "The `Dialog` component provides ready-made confirm and alert dialogs, so a destructive action stays one `await dialog.confirm()` call away.",
@@ -146,6 +150,15 @@
           "required": false,
           "inherited": false,
           "deprecated": false
+        },
+        {
+          "name": "portal",
+          "type": "boolean | string | HTMLElement",
+          "default": "false",
+          "description": "Renders the dialog into a portal target instead of inline. Forwarded to the underlying `Modal`; see its `portal` prop for the accepted values.",
+          "required": false,
+          "inherited": false,
+          "deprecated": false
         }
       ],
       "extraProps": [

package/data/components/Dropdown.json

@@ -29,12 +29,16 @@
       "title": "Controlled Dropdown Example",
       "code": "function example() {\n  const [open, setOpen] = useState(false);\n\n  return (\n    <Dropdown\n      label=\"Controlled Dropdown\"\n      active={open}\n      onActiveChange={setOpen}\n    >\n      <Dropdown.Item>Item A</Dropdown.Item>\n      <Dropdown.Item>Item B</Dropdown.Item>\n    </Dropdown>\n  );\n}"
     },
+    {
+      "title": "Forwarded ref",
+      "code": "function example() {\n  const dropdownRef = React.useRef(null);\n  const [tag, setTag] = React.useState(null);\n\n  return (\n    <>\n      <Dropdown label=\"Pick one\" ref={dropdownRef}>\n        <Dropdown.Item>First</Dropdown.Item>\n        <Dropdown.Item>Second</Dropdown.Item>\n      </Dropdown>\n      <Button mt=\"3\" onClick={() => setTag(dropdownRef.current?.className)}>\n        Read the root from its ref\n      </Button>\n      <p>Root class: {tag ?? '—'}</p>\n    </>\n  );\n}"
+    },
     {
       "title": "Compound (dot-notation) usage",
       "code": "<Dropdown label=\"Dropdown Menu\" active>\n  <Dropdown.Item>First Item</Dropdown.Item>\n  <Dropdown.Item>Second Item</Dropdown.Item>\n  <Dropdown.Divider />\n  <Dropdown.Item>Third Item</Dropdown.Item>\n</Dropdown>"
     }
   ],
-  "accessibility": "- The dropdown root is a `<div class=\"dropdown\">` with ARIA roles/attributes for menu and trigger.\n- The trigger button uses `aria-haspopup`, `aria-controls`, and `aria-expanded`.\n- Menu items are focusable and use `role=\"menuitem\"`.\n- Clicking outside closes the dropdown in most cases.\n\n:::note\nFor custom keyboard navigation or focus management, add handlers as needed.\n:::",
+  "accessibility": "- The dropdown root is a `<div class=\"dropdown\">` with ARIA roles/attributes for menu and trigger.\n- The trigger button uses `aria-haspopup`, `aria-controls`, and `aria-expanded`.\n- Menu items are focusable and use `role=\"menuitem\"`.\n- Clicking outside closes the dropdown in most cases.\n\n`Dropdown` implements the [WAI-ARIA Menu Button pattern](https://www.w3.org/WAI/ARIA/apg/patterns/menu-button/)\nout of the box:\n\n- On the trigger: <kbd>ArrowDown</kbd> or <kbd>Enter</kbd>/<kbd>Space</kbd> open the menu and\n  focus the first item; <kbd>ArrowUp</kbd> opens the menu and focuses the last item;\n  <kbd>Escape</kbd> closes an open menu.\n- Inside the menu: <kbd>ArrowDown</kbd>/<kbd>ArrowUp</kbd> move between items and wrap around;\n  <kbd>Home</kbd>/<kbd>End</kbd> jump to the first/last item; <kbd>Escape</kbd> closes the menu\n  and returns focus to the trigger; <kbd>Tab</kbd> closes the menu and lets focus continue\n  naturally.\n- Disabled items (a `Dropdown.Item` rendered with a native `disabled` attribute or\n  `aria-disabled=\"true\"`) and dividers are skipped during arrow-key navigation.\n\n:::note\nThere is no typeahead and no built-in outside-click handling inside the menu beyond the\nexisting click-outside-to-close behavior — add those yourself if your use case needs them.\n:::",
   "related": ["Button", "useBulmaClasses"],
   "storybook": "https://bestax.io/storybook/?path=/story/components-dropdown--default",
   "summary": "The `Dropdown` component provides Bulma's versatile dropdown menu for your Bulma React UI.",
@@ -156,7 +160,17 @@
           "deprecated": false
         }
       ],
-      "extraProps": [],
+      "extraProps": [
+        {
+          "name": "ref",
+          "type": "React.Ref<HTMLDivElement>",
+          "default": null,
+          "description": "Ref forwarded to the root dropdown element.",
+          "required": false,
+          "inherited": false,
+          "deprecated": false
+        }
+      ],
       "catchAll": "All standard <div> attributes and Bulma helper props",
       "types": []
     },
@@ -192,6 +206,15 @@
           "inherited": false,
           "deprecated": false
         },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "default": "false",
+          "description": "Marks the item as disabled; disabled items are skipped during keyboard navigation. Use with `as=\"button\"` for a native disabled control, or pair with `aria-disabled` on a link.",
+          "required": false,
+          "inherited": false,
+          "deprecated": false
+        },
         {
           "name": "children",
           "type": "React.ReactNode",

package/data/components/Field.json

@@ -446,18 +446,18 @@
         },
         {
           "name": "iconLeft",
-          "type": "IconProps",
+          "type": "IconProps | React.ReactNode",
           "default": null,
-          "description": "Icon props for left icon.",
+          "description": "Icon props for left icon, or a custom node (an inline SVG, a `react-icons` component, …) rendered in place of a class-based glyph.",
           "required": false,
           "inherited": true,
           "deprecated": false
         },
         {
           "name": "iconRight",
-          "type": "IconProps",
+          "type": "IconProps | React.ReactNode",
           "default": null,
-          "description": "Icon props for right icon.",
+          "description": "Icon props for right icon, or a custom node (an inline SVG, a `react-icons` component, …) rendered in place of a class-based glyph.",
           "required": false,
           "inherited": true,
           "deprecated": false

package/data/components/Icon.json

@@ -48,9 +48,13 @@
     {
       "title": "Ionicons",
       "code": "<Icon library=\"ion\" name=\"settings\" ariaLabel=\"Ionicons settings icon\" />"
+    },
+    {
+      "title": "Custom node",
+      "code": "<Icon ariaLabel=\"Custom SVG icon\" textColor=\"primary\">\n  <svg viewBox=\"0 0 16 16\" width=\"1em\" height=\"1em\" fill=\"currentColor\">\n    <circle cx=\"8\" cy=\"8\" r=\"6\" />\n  </svg>\n</Icon>"
     }
   ],
-  "accessibility": "- **ARIA label:** Always set a meaningful `ariaLabel` for screen readers (default `'icon'`).\n- **Keyboard:** Icon is decorative by default. If interactive, use with `Button` or `a` and add ARIA as needed.\n- **Color and size:** Use `textColor`, `bgColor`, and `size` for accessible, themeable icons.\n\n:::note\nFor purely decorative icons, you can use `aria-hidden=\"true\"` via the `...rest` props.\n:::",
+  "accessibility": "- **ARIA label:** `ariaLabel` defaults to `'icon'` and is applied to the container span **unconditionally** — an `Icon` that never sets it still renders `aria-label=\"icon\"`. For an icon-only control, put the real `aria-label` on the control (e.g. `Button`) and set `aria-hidden` on the `Icon`; for a decorative icon beside visible text, set `aria-hidden` on the `Icon` so it doesn't add `\"icon\"` to the accessible name.\n- **Keyboard:** If interactive, use with `Button` or `a` and put the ARIA (`aria-label`, roles) on that control.\n- **Color and size:** Use `textColor`, `bgColor`, and `size` for accessible, themeable icons.\n\n:::note\nFor purely decorative icons, you can use `aria-hidden=\"true\"` via the `...rest` props.\n:::",
   "related": ["Button", "Card", "IconText", "useBulmaClasses"],
   "storybook": "https://bestax.io/storybook/?path=/story/elements-icon--default",
   "summary": "The `Icon` component is a Bulma-styled wrapper for displaying icons from various libraries (Font Awesome, Material Design Icons, Ionicons, Google Material Icons, Material Symbols, etc.).",
@@ -63,13 +67,31 @@
       "summary": "The `Icon` component is a Bulma-styled wrapper for displaying icons from various libraries (Font Awesome, Material Design Icons, Ionicons, Google Material Icons, Material Symbols, etc.).",
       "component": null,
       "props": [
+        {
+          "name": "name",
+          "type": "string | undefined",
+          "default": null,
+          "description": "The icon name, with or without its library prefix (e.g. `'star'` or `'fa-star'`). Mutually exclusive with `children`.",
+          "required": false,
+          "inherited": true,
+          "deprecated": false
+        },
+        {
+          "name": "children",
+          "type": "Exclude<React.ReactNode, undefined>",
+          "default": null,
+          "description": "A custom node (an inline SVG, a `react-icons` component, …) rendered inside the icon container in place of a class-based glyph. Mutually exclusive with `name`.",
+          "required": false,
+          "inherited": true,
+          "deprecated": false
+        },
         {
           "name": "className",
           "type": "string",
           "default": null,
           "description": "Additional CSS classes to apply.",
           "required": false,
-          "inherited": false,
+          "inherited": true,
           "deprecated": false
         },
         {
@@ -78,7 +100,7 @@
           "default": null,
           "description": "Text color helper.",
           "required": false,
-          "inherited": false,
+          "inherited": true,
           "deprecated": false,
           "valuesRef": "helpers/valid-values"
         },
@@ -88,7 +110,7 @@
           "default": null,
           "description": "Bulma color modifier for the icon.",
           "required": false,
-          "inherited": false,
+          "inherited": true,
           "deprecated": false
         },
         {
@@ -97,53 +119,44 @@
           "default": null,
           "description": "Background color helper.",
           "required": false,
-          "inherited": false,
+          "inherited": true,
           "deprecated": false,
           "valuesRef": "helpers/valid-values"
         },
-        {
-          "name": "name",
-          "type": "string",
-          "default": null,
-          "description": "The icon name, with or without its library prefix (e.g. `'star'` or `'fa-star'`).",
-          "required": false,
-          "inherited": false,
-          "deprecated": false
-        },
         {
           "name": "icon",
           "type": "string",
           "default": null,
           "description": "DEPRECATED: Legacy prop, use `name` instead.",
           "required": false,
-          "inherited": false,
+          "inherited": true,
           "deprecated": false
         },
         {
           "name": "library",
           "type": "'fa' | 'mdi' | 'ion' | 'material-icons' | 'material-symbols'",
           "default": "'fa'",
-          "description": "The icon library to use ('fa' = Font Awesome, 'mdi' = Material Design Icons, 'ion' = Ionicons Web Components, 'material-icons' = Google Material Icons, 'material-symbols' = Google Material Symbols). Defaults to the value set in ConfigProvider or 'fa' if not configured.",
+          "description": "The icon library to use ('fa' = Font Awesome, 'mdi' = Material Design Icons, 'ion' = Ionicons Web Components, 'material-icons' = Google Material Icons, 'material-symbols' = Google Material Symbols). Defaults to the value set in ConfigProvider or 'fa' if not configured. Ignored when `children` supplies the glyph instead of `name`.",
           "required": false,
-          "inherited": false,
+          "inherited": true,
           "deprecated": false
         },
         {
           "name": "variant",
           "type": "string",
           "default": null,
-          "description": "Icon style variant (e.g. `'solid'`, `'outlined'`, `'rounded'`).",
+          "description": "Icon style variant (e.g. `'solid'`, `'outlined'`, `'rounded'`). Ignored when `children` supplies the glyph instead of `name`.",
           "required": false,
-          "inherited": false,
+          "inherited": true,
           "deprecated": false
         },
         {
           "name": "features",
           "type": "string | string[]",
           "default": null,
-          "description": "Additional modifiers (e.g. `'fa-lg'`, `'fa-spin'`, `'is-size-1'`).",
+          "description": "Additional modifiers (e.g. `'fa-lg'`, `'fa-spin'`, `'is-size-1'`). Ignored when `children` supplies the glyph instead of `name`.",
           "required": false,
-          "inherited": false,
+          "inherited": true,
           "deprecated": false
         },
         {
@@ -152,7 +165,7 @@
           "default": null,
           "description": "**DEPRECATED:** Use `variant` and `features` instead.",
           "required": false,
-          "inherited": false,
+          "inherited": true,
           "deprecated": false
         },
         {
@@ -161,16 +174,16 @@
           "default": null,
           "description": "Size modifier for the icon container.",
           "required": false,
-          "inherited": false,
+          "inherited": true,
           "deprecated": false
         },
         {
           "name": "ariaLabel",
           "type": "string",
           "default": "'icon'",
-          "description": "ARIA label for accessibility (default: 'icon').",
+          "description": "ARIA label for accessibility. Applied unconditionally to the container span, so an icon that never sets it still renders `aria-label=\"icon\"`. For an icon-only control, put the real `aria-label` on the control (e.g. `Button`) and set `aria-hidden` here instead — otherwise the control's accessible name is announced as just \"icon\". For a decorative icon beside visible text, set `aria-hidden` here rather than leaving the default, so it doesn't add \"icon\" to the text's accessible name.",
           "required": false,
-          "inherited": false,
+          "inherited": true,
           "deprecated": false
         },
         {
@@ -179,7 +192,7 @@
           "default": null,
           "description": "Inline style object.",
           "required": false,
-          "inherited": false,
+          "inherited": true,
           "deprecated": false
         },
         {
@@ -188,7 +201,7 @@
           "default": null,
           "description": "Override the default `'icon'` container class (e.g., `'panel-icon'`).",
           "required": false,
-          "inherited": false,
+          "inherited": true,
           "deprecated": false
         }
       ],