@brightspot/ui 6.7.1-pr.401.2026.10.22 → 6.8.0

package/dist/custom-elements.json

@@ -7845,6 +7845,846 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/radio/Radio.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A single radio option, selectable from a set of mutually exclusive choices.\n\nUses a hidden native radio input internally for accessibility and form\nparticipation. Styled via the `btu-radio` Tailwind plugin classes. Typically\nplaced inside a `btu-radio-group`, which owns the shared `name`, selection\nstate, and arrow-key navigation; a standalone radio also works but manages\nonly its own checked state. The component manages its own `className` — do not\nmodify it externally after initialization (classes present at connection time\nare preserved).",
+          "name": "Radio",
+          "cssProperties": [
+            {
+              "description": "Fill and border color when selected (default: oklch(var(--btu-theme-primary-700)))",
+              "name": "--radio-color-primary"
+            },
+            {
+              "description": "Border color in the unselected state (default: oklch(var(--btu-theme-gray-300)))",
+              "name": "--radio-color-border"
+            },
+            {
+              "description": "Border and text color in the error state (default: oklch(var(--btu-theme-error-600)))",
+              "name": "--radio-color-error"
+            },
+            {
+              "description": "Distance between the radio and the label (default: 0.75rem)",
+              "name": "--radio-label-spacing"
+            },
+            {
+              "description": "[Internal] Diameter of the radio control, set by the size variant (sm: 1rem, md: 1.25rem). Use the `size` attribute instead of overriding directly — the dot must scale in tandem.",
+              "name": "--radio-box-size"
+            },
+            {
+              "description": "[Internal] Diameter of the selected dot, set by the size variant (sm: 0.375rem, md: 0.5rem). Use the `size` attribute instead of overriding directly.",
+              "name": "--radio-dot-size"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The text label displayed next to the radio.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "description",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Optional helper text displayed below the label.",
+              "attribute": "description"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "'sm' | 'md'"
+              },
+              "default": "'sm'",
+              "description": "Controls the scale of the radio and associated typography.",
+              "attribute": "size",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "checked",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this option is currently selected.",
+              "attribute": "checked",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "If true, the radio is non-interactive and visually muted.",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "invalid",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "If true, displays error styling on the radio.",
+              "attribute": "invalid",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "error",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Error message text displayed below the radio when validation fails.\nSetting this also activates error styling without needing to set invalid.",
+              "attribute": "error"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Value submitted with the form when this option is selected.",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Name of the form control. Usually set by the parent `btu-radio-group` so\nevery option in the group shares one name.",
+              "attribute": "name"
+            },
+            {
+              "kind": "field",
+              "name": "_userInitiated",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_initialClasses",
+              "type": {
+                "text": "string[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_initialClassesCaptured",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_descId",
+              "privacy": "private",
+              "default": "`radio-desc-${crypto.randomUUID()}`"
+            },
+            {
+              "kind": "field",
+              "name": "_errorId",
+              "privacy": "private",
+              "default": "`radio-error-${crypto.randomUUID()}`"
+            },
+            {
+              "kind": "method",
+              "name": "_onInputChange",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "_handleClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_describedBy",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "tooltip",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Tooltip text content. Set to empty string to remove the tooltip.",
+              "attribute": "tooltip",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "tooltipPosition",
+              "type": {
+                "text": "'top' | 'bottom' | 'left' | 'right'"
+              },
+              "default": "'top'",
+              "description": "Position relative to the host element. Auto-flips when constrained by the viewport.",
+              "attribute": "tooltip-position",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "tooltipDelay",
+              "type": {
+                "text": "number"
+              },
+              "default": "300",
+              "description": "Show delay in milliseconds (hover trigger only).",
+              "attribute": "tooltip-delay",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "tooltipOffset",
+              "type": {
+                "text": "TooltipOffset | null"
+              },
+              "default": "null",
+              "description": "Gap between host and tooltip (sm=4px, md=8px, lg=12px, xl=16px).",
+              "attribute": "tooltip-offset",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "tooltipNoArrow",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hide the arrow pseudo-element.",
+              "attribute": "tooltip-no-arrow",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "tooltipTrigger",
+              "type": {
+                "text": "string"
+              },
+              "default": "'hover focus'",
+              "description": "Space-separated trigger types: 'hover', 'focus', 'click'.",
+              "attribute": "tooltip-trigger",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_onMouseLeave",
+              "privacy": "private",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_onFocusIn",
+              "privacy": "private",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_onFocusOut",
+              "privacy": "private",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_onClick",
+              "privacy": "private",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_onNativeToggle",
+              "privacy": "private",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_onKeyDown",
+              "privacy": "private",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_onDocumentClick",
+              "type": {
+                "text": "((e: MouseEvent) => void) | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "emit",
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  },
+                  "description": "Event name from CustomEventMap"
+                },
+                {
+                  "name": "detail",
+                  "optional": true,
+                  "type": {
+                    "text": "UnpackCustomEvent<CustomEventMap[K]>"
+                  },
+                  "description": "Optional event detail payload"
+                }
+              ],
+              "description": "Dispatches a type-safe CustomEvent with standardized configuration.\n\nAll events are configured with:\n- bubbles: true (event propagates up the DOM tree)\n- cancelable: false (event cannot be cancelled)\n- composed: true (event crosses shadow DOM boundaries)",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "inheritedFrom": {
+                "name": "EventEmitterMixin",
+                "module": "src/util/EventEmitterMixin.ts"
+              }
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired after the radio is first rendered and initialized",
+              "name": "btu-radio-ready"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<{ checked: boolean; value: string }>"
+              },
+              "description": "Fired when the user selects this option",
+              "name": "btu-radio-change"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "The text label displayed next to the radio.",
+              "fieldName": "label",
+              "attribute": "label"
+            },
+            {
+              "name": "description",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Optional helper text displayed below the label.",
+              "fieldName": "description",
+              "attribute": "description"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "'sm' | 'md'"
+              },
+              "default": "'sm'",
+              "description": "Controls the scale of the radio and associated typography.",
+              "fieldName": "size",
+              "attribute": "size"
+            },
+            {
+              "name": "checked",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this option is currently selected.",
+              "fieldName": "checked",
+              "attribute": "checked"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "If true, the radio is non-interactive and visually muted.",
+              "fieldName": "disabled",
+              "attribute": "disabled"
+            },
+            {
+              "name": "invalid",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "If true, displays error styling on the radio.",
+              "fieldName": "invalid",
+              "attribute": "invalid"
+            },
+            {
+              "name": "error",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Error message text displayed below the radio when validation fails.\nSetting this also activates error styling without needing to set invalid.",
+              "fieldName": "error",
+              "attribute": "error"
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Value submitted with the form when this option is selected.",
+              "fieldName": "value",
+              "attribute": "value"
+            },
+            {
+              "name": "name",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Name of the form control. Usually set by the parent `btu-radio-group` so\nevery option in the group shares one name.",
+              "fieldName": "name",
+              "attribute": "name"
+            },
+            {
+              "name": "tooltip",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Tooltip text content. Set to empty string to remove the tooltip.",
+              "fieldName": "tooltip",
+              "attribute": "tooltip",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "name": "tooltip-position",
+              "type": {
+                "text": "'top' | 'bottom' | 'left' | 'right'"
+              },
+              "default": "'top'",
+              "description": "Position relative to the host element. Auto-flips when constrained by the viewport.",
+              "fieldName": "tooltipPosition",
+              "attribute": "tooltip-position",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "name": "tooltip-delay",
+              "type": {
+                "text": "number"
+              },
+              "default": "300",
+              "description": "Show delay in milliseconds (hover trigger only).",
+              "fieldName": "tooltipDelay",
+              "attribute": "tooltip-delay",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "name": "tooltip-offset",
+              "type": {
+                "text": "TooltipOffset | null"
+              },
+              "default": "null",
+              "description": "Gap between host and tooltip (sm=4px, md=8px, lg=12px, xl=16px).",
+              "fieldName": "tooltipOffset",
+              "attribute": "tooltip-offset",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "name": "tooltip-no-arrow",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hide the arrow pseudo-element.",
+              "fieldName": "tooltipNoArrow",
+              "attribute": "tooltip-no-arrow",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            },
+            {
+              "name": "tooltip-trigger",
+              "type": {
+                "text": "string"
+              },
+              "default": "'hover focus'",
+              "description": "Space-separated trigger types: 'hover', 'focus', 'click'.",
+              "fieldName": "tooltipTrigger",
+              "attribute": "tooltip-trigger",
+              "inheritedFrom": {
+                "name": "TooltipMixin",
+                "module": "src/util/TooltipMixin.ts"
+              }
+            }
+          ],
+          "mixins": [
+            {
+              "name": "TooltipMixin",
+              "module": "/src/util/TooltipMixin.js"
+            },
+            {
+              "name": "EventEmitterMixin",
+              "module": "/src/util/EventEmitterMixin.js"
+            },
+            {
+              "name": "ReadyMixin",
+              "module": "/src/util/ReadyMixin.js"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "btu-radio",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "Radio",
+            "module": "src/components/radio/Radio.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "btu-radio",
+          "declaration": {
+            "name": "Radio",
+            "module": "src/components/radio/Radio.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/radio/RadioGroup.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A container that groups `btu-radio` options into a single-select control.\n\nOwns the shared form `name`, the selected `value`, and keyboard navigation\nfollowing the WAI-ARIA radio group pattern: a single roving tabstop, and\narrow keys that move focus and select in one step. Selection state and the\n`disabled` / `size` properties are propagated down to child radios.",
+          "name": "RadioGroup",
+          "members": [
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Form field name shared by every radio in the group.",
+              "attribute": "name"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Value of the currently selected option.",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "orientation",
+              "type": {
+                "text": "'vertical' | 'horizontal'"
+              },
+              "default": "'vertical'",
+              "description": "Layout direction of the options.",
+              "attribute": "orientation",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "'sm' | 'md'"
+              },
+              "default": "'sm'",
+              "description": "Controls the scale of every radio in the group.",
+              "attribute": "size",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Marks a selection as mandatory for form submission.",
+              "attribute": "required",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables every option in the group.",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "emit",
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  },
+                  "description": "Event name from CustomEventMap"
+                },
+                {
+                  "name": "detail",
+                  "optional": true,
+                  "type": {
+                    "text": "UnpackCustomEvent<CustomEventMap[K]>"
+                  },
+                  "description": "Optional event detail payload"
+                }
+              ],
+              "description": "Dispatches a type-safe CustomEvent with standardized configuration.\n\nAll events are configured with:\n- bubbles: true (event propagates up the DOM tree)\n- cancelable: false (event cannot be cancelled)\n- composed: true (event crosses shadow DOM boundaries)",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "inheritedFrom": {
+                "name": "EventEmitterMixin",
+                "module": "src/util/EventEmitterMixin.ts"
+              }
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired after first render and initialization",
+              "name": "btu-radio-group-ready"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<{ value: string }>"
+              },
+              "description": "Fired when the selected value changes",
+              "name": "btu-radio-group-change"
+            },
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when a child radio finishes initialization (bubbles from btu-radio)",
+              "name": "btu-radio-ready"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<{ checked: boolean; value: string }>"
+              },
+              "description": "Fired when a child radio is selected (bubbles from btu-radio)",
+              "name": "btu-radio-change"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "name",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Form field name shared by every radio in the group.",
+              "fieldName": "name",
+              "attribute": "name"
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Value of the currently selected option.",
+              "fieldName": "value",
+              "attribute": "value"
+            },
+            {
+              "name": "orientation",
+              "type": {
+                "text": "'vertical' | 'horizontal'"
+              },
+              "default": "'vertical'",
+              "description": "Layout direction of the options.",
+              "fieldName": "orientation",
+              "attribute": "orientation"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "'sm' | 'md'"
+              },
+              "default": "'sm'",
+              "description": "Controls the scale of every radio in the group.",
+              "fieldName": "size",
+              "attribute": "size"
+            },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Marks a selection as mandatory for form submission.",
+              "fieldName": "required",
+              "attribute": "required"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables every option in the group.",
+              "fieldName": "disabled",
+              "attribute": "disabled"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "RovingTabindexMixin",
+              "module": "/src/util/RovingTabindexMixin.js"
+            },
+            {
+              "name": "EventEmitterMixin",
+              "module": "/src/util/EventEmitterMixin.js"
+            },
+            {
+              "name": "ReadyMixin",
+              "module": "/src/util/ReadyMixin.js"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "btu-radio-group",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "RadioGroup",
+            "module": "src/components/radio/RadioGroup.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "btu-radio-group",
+          "declaration": {
+            "name": "RadioGroup",
+            "module": "src/components/radio/RadioGroup.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/switch/Switch.ts",