@brightspot/ui 3.0.0 → 3.0.1-cms-ui-migration.0

package/dist/custom-elements.json

@@ -1712,229 +1712,139 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/circular-progress/CircularProgress.ts",
+      "path": "src/components/button-group/ButtonGroup.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A circular progress indicator for showing loading states or progress.",
-          "name": "CircularProgress",
+          "description": "A semantic container for grouping related buttons together.\n\nSupports connected (joined) and spaced layouts, horizontal and vertical\norientation, group-level size and disabled propagation, and optional\ntoggle/selection modes (single-select or multi-select).",
+          "name": "ButtonGroup",
           "cssProperties": [
             {
-              "description": "Custom progress indicator color (overrides theme color)",
-              "name": "--progress-color"
-            },
-            {
-              "description": "Track/background color (overrides default gray-100)",
-              "name": "--track-color"
+              "description": "Space between buttons when variant=\"spaced\" (default: spacing.sm)",
+              "name": "--button-group-gap"
             },
             {
-              "description": "Custom size in pixels (overrides size preset)",
-              "name": "--progress-size"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "indeterminate",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "true",
-              "description": "Whether the progress indicator is indeterminate (animated spinner).\nWhen false, shows determinate progress based on the progress value.",
-              "attribute": "indeterminate"
+              "description": "Corner radius of outer edges when variant=\"connected\" (default: 0.5rem)",
+              "name": "--button-group-border-radius"
             },
             {
-              "kind": "field",
-              "name": "size",
-              "type": {
-                "text": "'sm' | 'md' | 'lg'"
-              },
-              "default": "'sm'",
-              "description": "Size variant.\n- 'sm': Small (16px) - default\n- 'md': Medium (32px)\n- 'lg': Large (48px)",
-              "attribute": "size"
+              "description": "Internal divider color between connected buttons (default: gray-300)",
+              "name": "--button-group-border-color"
             },
             {
-              "kind": "field",
-              "name": "color",
-              "type": {
-                "text": "ProgressColors"
-              },
-              "default": "'primary'",
-              "description": "Color theme of the progress indicator.\nSupports: black, white, primary, teal, gray, purple, rose, error, warning, success",
-              "attribute": "color",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "description": "Background of a toggled/selected child (default: primary-50)",
+              "name": "--button-group-selection-bg"
             },
             {
-              "kind": "field",
-              "name": "thickness",
-              "type": {
-                "text": "number | undefined"
-              },
-              "description": "Stroke width of the progress indicator.",
-              "attribute": "thickness",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "description": "Text/icon color of a toggled/selected child (default: primary-700)",
+              "name": "--button-group-selection-color"
             },
             {
-              "kind": "field",
-              "name": "_progress",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
-            },
+              "description": "Highlight color of the selection shimmer effect (default: primary-200)",
+              "name": "--button-group-shimmer-highlight"
+            }
+          ],
+          "slots": [
             {
-              "kind": "field",
-              "name": "progress",
-              "description": "Progress value for determinate variant. Clamped to 0–100.",
-              "attribute": "progress",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "description": "One or more btu-button or btu-icon-button elements to display in the group",
+              "name": ""
             },
             {
-              "kind": "field",
-              "name": "label",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Optional label text to display with the progress indicator.",
-              "attribute": "label",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
-            },
+              "description": "Pushes the child to the end of the group via auto-margin (vertical: bottom, horizontal: right)",
+              "name": "end"
+            }
+          ],
+          "members": [
             {
               "kind": "field",
-              "name": "initialAnimation",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "true",
-              "description": "Whether to animate progress from 0 to target value when component first becomes visible.",
-              "attribute": "initial-animation",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "name": "tagName",
+              "static": true,
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "ariaLabel",
+              "name": "label",
               "type": {
-                "text": "string | null"
+                "text": "string"
               },
-              "default": "null",
-              "description": "Optional aria-label attribute for screen readers.\nDescribes what the progress indicator represents.",
-              "attribute": "aria-label",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "default": "''",
+              "description": "Accessible name for the group, announced by assistive devices via aria-label.",
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "ariaLabelledBy",
+              "name": "orientation",
               "type": {
-                "text": "string | null"
+                "text": "'horizontal' | 'vertical'"
               },
-              "default": "null",
-              "description": "Optional aria-labelledby attribute for screen readers.\nReferences the ID of an element that labels the progress indicator.",
-              "attribute": "aria-labelledby",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "default": "'horizontal'",
+              "description": "Layout direction of the buttons.",
+              "attribute": "orientation",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "ariaValueText",
+              "name": "variant",
               "type": {
-                "text": "string | null"
+                "text": "'connected' | 'spaced'"
               },
-              "default": "null",
-              "description": "Optional aria-valuetext attribute for screen readers.\nProvides human-readable text alternative for progress value.",
-              "attribute": "aria-valuetext",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "default": "'connected'",
+              "description": "`connected` collapses shared borders for a joined appearance.\n`spaced` renders buttons with a gap.",
+              "attribute": "variant",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "completionAnnouncement",
+              "name": "size",
               "type": {
-                "text": "string | undefined"
+                "text": "'sm' | 'md' | 'lg'"
               },
-              "description": "Optional message to announce to screen readers when progress reaches 100%.\nIf not provided, no announcement will be made on completion.",
-              "attribute": "completion-announcement",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "default": "'md'",
+              "description": "Propagates a uniform size to all child buttons.",
+              "attribute": "size",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "_isAnimationInitialized",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
-              "privacy": "private",
               "default": "false",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "description": "When true, disables all child buttons as a group.",
+              "attribute": "disabled"
             },
             {
               "kind": "field",
-              "name": "_intersectionObserver",
+              "name": "selection",
               "type": {
-                "text": "IntersectionObserver | undefined"
+                "text": "'none' | 'single' | 'multiple'"
               },
-              "privacy": "private",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "default": "'none'",
+              "description": "Enables toggle/selection behavior.\n`single` allows one active button; `multiple` allows many.",
+              "attribute": "selection",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "_hasCompletedAt100",
+              "name": "value",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "privacy": "private",
-              "default": "false",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "default": "''",
+              "description": "Reflects the currently selected button value(s).\nFor `single`, the value of the active button.\nFor `multiple`, a comma-delimited list of active values.",
+              "attribute": "value",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "_hostTag",
+              "name": "name",
               "type": {
-                "text": "'btu-linear-progress' | 'btu-circular-progress'"
+                "text": "string"
               },
-              "privacy": "private",
-              "readonly": true,
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "default": "''",
+              "description": "When set, creates hidden input(s) for native form participation.",
+              "attribute": "name"
             },
             {
               "kind": "method",
@@ -1974,161 +1884,135 @@
                 "text": "CustomEvent"
               },
               "description": "Fired after first render and initialization",
-              "name": "btu-circular-progress-ready"
+              "name": "btu-button-group-ready"
             },
             {
               "type": {
-                "text": "CustomEvent"
+                "text": "CustomEvent<{value: string}>"
               },
-              "description": "Fired when determinate progress reaches 100",
-              "name": "btu-circular-progress-complete"
+              "description": "Fired when selection changes (single/multiple modes only)",
+              "name": "btu-button-group-change"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<{name: string | undefined}>"
+              },
+              "description": "Bubbles from child btu-icon-button elements when clicked",
+              "name": "btu-icon-button-click"
             }
           ],
           "attributes": [
             {
-              "name": "indeterminate",
+              "name": "label",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "true",
-              "description": "Whether the progress indicator is indeterminate (animated spinner).\nWhen false, shows determinate progress based on the progress value.",
-              "fieldName": "indeterminate",
-              "attribute": "indeterminate"
-            },
-            {
-              "name": "size",
-              "type": {
-                "text": "'sm' | 'md' | 'lg'"
-              },
-              "default": "'sm'",
-              "description": "Size variant.\n- 'sm': Small (16px) - default\n- 'md': Medium (32px)\n- 'lg': Large (48px)",
-              "fieldName": "size",
-              "attribute": "size"
+              "default": "''",
+              "description": "Accessible name for the group, announced by assistive devices via aria-label.",
+              "fieldName": "label",
+              "attribute": "label"
             },
             {
-              "name": "color",
+              "name": "orientation",
               "type": {
-                "text": "ProgressColors"
+                "text": "'horizontal' | 'vertical'"
               },
-              "default": "'primary'",
-              "description": "Color theme of the progress indicator.\nSupports: black, white, primary, teal, gray, purple, rose, error, warning, success",
-              "fieldName": "color",
-              "attribute": "color",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "default": "'horizontal'",
+              "description": "Layout direction of the buttons.",
+              "fieldName": "orientation",
+              "attribute": "orientation"
             },
             {
-              "name": "thickness",
+              "name": "variant",
               "type": {
-                "text": "number | undefined"
+                "text": "'connected' | 'spaced'"
               },
-              "description": "Stroke width of the progress indicator.",
-              "fieldName": "thickness",
-              "attribute": "thickness",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
-            },
-            {
-              "name": "progress",
-              "description": "Progress value for determinate variant. Clamped to 0–100.",
-              "fieldName": "progress",
-              "attribute": "progress",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "default": "'connected'",
+              "description": "`connected` collapses shared borders for a joined appearance.\n`spaced` renders buttons with a gap.",
+              "fieldName": "variant",
+              "attribute": "variant"
             },
             {
-              "name": "label",
+              "name": "size",
               "type": {
-                "text": "string | undefined"
+                "text": "'sm' | 'md' | 'lg'"
               },
-              "description": "Optional label text to display with the progress indicator.",
-              "fieldName": "label",
-              "attribute": "label",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "default": "'md'",
+              "description": "Propagates a uniform size to all child buttons.",
+              "fieldName": "size",
+              "attribute": "size"
             },
             {
-              "name": "initial-animation",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
-              "default": "true",
-              "description": "Whether to animate progress from 0 to target value when component first becomes visible.",
-              "fieldName": "initialAnimation",
-              "attribute": "initial-animation",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "default": "false",
+              "description": "When true, disables all child buttons as a group.",
+              "fieldName": "disabled",
+              "attribute": "disabled"
             },
             {
-              "name": "aria-label",
+              "name": "selection",
               "type": {
-                "text": "string | null"
+                "text": "'none' | 'single' | 'multiple'"
               },
-              "default": "null",
-              "description": "Optional aria-label attribute for screen readers.\nDescribes what the progress indicator represents.",
-              "fieldName": "ariaLabel",
-              "attribute": "aria-label",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "default": "'none'",
+              "description": "Enables toggle/selection behavior.\n`single` allows one active button; `multiple` allows many.",
+              "fieldName": "selection",
+              "attribute": "selection"
             },
             {
-              "name": "aria-labelledby",
+              "name": "value",
               "type": {
-                "text": "string | null"
+                "text": "string"
               },
-              "default": "null",
-              "description": "Optional aria-labelledby attribute for screen readers.\nReferences the ID of an element that labels the progress indicator.",
-              "fieldName": "ariaLabelledBy",
-              "attribute": "aria-labelledby",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "default": "''",
+              "description": "Reflects the currently selected button value(s).\nFor `single`, the value of the active button.\nFor `multiple`, a comma-delimited list of active values.",
+              "fieldName": "value",
+              "attribute": "value"
             },
             {
-              "name": "aria-valuetext",
+              "name": "name",
               "type": {
-                "text": "string | null"
+                "text": "string"
               },
-              "default": "null",
-              "description": "Optional aria-valuetext attribute for screen readers.\nProvides human-readable text alternative for progress value.",
-              "fieldName": "ariaValueText",
-              "attribute": "aria-valuetext",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "default": "''",
+              "description": "When set, creates hidden input(s) for native form participation.",
+              "fieldName": "name",
+              "attribute": "name"
+            }
+          ],
+          "cssStates": [
+            {
+              "description": "Applied when variant=\"connected\", targetable via :state(btu-connected)",
+              "name": "btu-connected"
             },
             {
-              "name": "completion-announcement",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Optional message to announce to screen readers when progress reaches 100%.\nIf not provided, no announcement will be made on completion.",
-              "fieldName": "completionAnnouncement",
-              "attribute": "completion-announcement",
-              "inheritedFrom": {
-                "name": "ProgressMixin",
-                "module": "src/util/ProgressMixin.ts"
-              }
+              "description": "Applied when variant=\"spaced\", targetable via :state(btu-spaced)",
+              "name": "btu-spaced"
+            },
+            {
+              "description": "Applied when orientation=\"horizontal\", targetable via :state(btu-horizontal)",
+              "name": "btu-horizontal"
+            },
+            {
+              "description": "Applied when orientation=\"vertical\", targetable via :state(btu-vertical)",
+              "name": "btu-vertical"
+            },
+            {
+              "description": "Applied when the group is disabled, targetable via :state(btu-disabled)",
+              "name": "btu-disabled"
             }
           ],
           "mixins": [
             {
-              "name": "ProgressMixin",
-              "module": "/src/util/ProgressMixin.js"
+              "name": "RovingTabindexMixin",
+              "module": "/src/util/RovingTabindexMixin.js"
+            },
+            {
+              "name": "ComponentStatesMixin",
+              "module": "/src/util/ComponentStatesMixin.js"
             },
             {
               "name": "EventEmitterMixin",
@@ -2143,7 +2027,7 @@
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "btu-circular-progress",
+          "tagName": "btu-button-group",
           "customElement": true
         }
       ],
@@ -2152,16 +2036,16 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "CircularProgress",
-            "module": "src/components/circular-progress/CircularProgress.ts"
+            "name": "ButtonGroup",
+            "module": "src/components/button-group/ButtonGroup.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "btu-circular-progress",
+          "name": "btu-button-group",
           "declaration": {
-            "name": "CircularProgress",
-            "module": "src/components/circular-progress/CircularProgress.ts"
+            "name": "ButtonGroup",
+            "module": "src/components/button-group/ButtonGroup.ts"
           }
         }
       ]
@@ -2592,70 +2476,228 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/copy-to-clipboard/CopyToClipboard.ts",
+      "path": "src/components/circular-progress/CircularProgress.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A button component that copies text to the system clipboard.\n\nProvides visual feedback when text is successfully copied by applying\na temporary state that can be styled with CSS.\n\nButton styling is inherited from `btu-button-*` classes. Override appearance\nby passing custom classes via the `buttonClasses` attribute.",
-          "name": "CopyToClipboard",
+          "description": "A circular progress indicator for showing loading states or progress.",
+          "name": "CircularProgress",
+          "cssProperties": [
+            {
+              "description": "Custom progress indicator color (overrides theme color)",
+              "name": "--progress-color"
+            },
+            {
+              "description": "Track/background color (overrides default gray-100)",
+              "name": "--track-color"
+            },
+            {
+              "description": "Custom size in pixels (overrides size preset)",
+              "name": "--progress-size"
+            }
+          ],
           "members": [
             {
               "kind": "field",
-              "name": "copydata",
+              "name": "indeterminate",
               "type": {
-                "text": "string | undefined"
+                "text": "boolean"
               },
-              "description": "The text to be copied to the system clipboard.",
-              "attribute": "copydata"
+              "default": "true",
+              "description": "Whether the progress indicator is indeterminate (animated spinner).\nWhen false, shows determinate progress based on the progress value.",
+              "attribute": "indeterminate"
             },
             {
               "kind": "field",
-              "name": "buttonClasses",
+              "name": "size",
               "type": {
-                "text": "string | undefined"
+                "text": "'sm' | 'md' | 'lg'"
               },
-              "description": "Custom CSS classes for the button. If provided, replaces the default classes.",
-              "attribute": "buttonClasses"
+              "default": "'sm'",
+              "description": "Size variant.\n- 'sm': Small (16px) - default\n- 'md': Medium (32px)\n- 'lg': Large (48px)",
+              "attribute": "size"
             },
             {
-              "kind": "method",
-              "name": "copy",
-              "return": {
-                "type": {
-                  "text": ""
-                }
+              "kind": "field",
+              "name": "color",
+              "type": {
+                "text": "ProgressColors"
               },
-              "parameters": [
-                {
-                  "name": "text",
-                  "type": {
-                    "text": "string"
-                  },
-                  "description": "The text to copy to clipboard"
-                },
-                {
-                  "name": "timeout",
-                  "default": "3000",
-                  "description": "Duration in milliseconds to show success state (default: 3000)"
-                }
-              ],
-              "description": "Copies the copydata to the system clipboard.\nDisplays a success state for 3 seconds after copying.",
+              "default": "'primary'",
+              "description": "Color theme of the progress indicator.\nSupports: black, white, primary, teal, gray, purple, rose, error, warning, success",
+              "attribute": "color",
               "inheritedFrom": {
-                "name": "ClipboardMixin",
-                "module": "src/util/ClipboardMixin.ts"
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
               }
             },
             {
               "kind": "field",
-              "name": "copiedStateKey",
+              "name": "thickness",
               "type": {
-                "text": "'btu-copy-to-clipboard-copied'"
+                "text": "number | undefined"
               },
-              "description": "Custom state applied briefly after a successful copy; also emitted as an event.",
+              "description": "Stroke width of the progress indicator.",
+              "attribute": "thickness",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_progress",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "progress",
+              "description": "Progress value for determinate variant. Clamped to 0–100.",
+              "attribute": "progress",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Optional label text to display with the progress indicator.",
+              "attribute": "label",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "initialAnimation",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether to animate progress from 0 to target value when component first becomes visible.",
+              "attribute": "initial-animation",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "Optional aria-label attribute for screen readers.\nDescribes what the progress indicator represents.",
+              "attribute": "aria-label",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "ariaLabelledBy",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "Optional aria-labelledby attribute for screen readers.\nReferences the ID of an element that labels the progress indicator.",
+              "attribute": "aria-labelledby",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "ariaValueText",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "Optional aria-valuetext attribute for screen readers.\nProvides human-readable text alternative for progress value.",
+              "attribute": "aria-valuetext",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "completionAnnouncement",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Optional message to announce to screen readers when progress reaches 100%.\nIf not provided, no announcement will be made on completion.",
+              "attribute": "completion-announcement",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_isAnimationInitialized",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_intersectionObserver",
+              "type": {
+                "text": "IntersectionObserver | undefined"
+              },
+              "privacy": "private",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_hasCompletedAt100",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_hostTag",
+              "type": {
+                "text": "'btu-linear-progress' | 'btu-circular-progress'"
+              },
+              "privacy": "private",
               "readonly": true,
               "inheritedFrom": {
-                "name": "ClipboardMixin",
-                "module": "src/util/ClipboardMixin.ts"
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
               }
             },
             {
@@ -2696,222 +2738,265 @@
                 "text": "CustomEvent"
               },
               "description": "Fired after first render and initialization",
-              "name": "btu-copy-to-clipboard-ready"
+              "name": "btu-circular-progress-ready"
             },
             {
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when text is successfully copied to clipboard",
-              "name": "btu-copy-to-clipboard-copied"
+              "description": "Fired when determinate progress reaches 100",
+              "name": "btu-circular-progress-complete"
             }
           ],
           "attributes": [
             {
-              "name": "copydata",
+              "name": "indeterminate",
               "type": {
-                "text": "string | undefined"
+                "text": "boolean"
               },
-              "description": "The text to be copied to the system clipboard.",
-              "fieldName": "copydata",
-              "attribute": "copydata"
+              "default": "true",
+              "description": "Whether the progress indicator is indeterminate (animated spinner).\nWhen false, shows determinate progress based on the progress value.",
+              "fieldName": "indeterminate",
+              "attribute": "indeterminate"
             },
             {
-              "name": "buttonClasses",
+              "name": "size",
               "type": {
-                "text": "string | undefined"
+                "text": "'sm' | 'md' | 'lg'"
               },
-              "description": "Custom CSS classes for the button. If provided, replaces the default classes.",
-              "fieldName": "buttonClasses",
-              "attribute": "buttonClasses"
-            }
-          ],
-          "cssStates": [
-            {
-              "description": "Applied briefly after a successful copy, targetable via :state(btu-copy-to-clipboard-copied)",
-              "name": "btu-copy-to-clipboard-copied"
-            }
-          ],
-          "mixins": [
-            {
-              "name": "ClipboardMixin",
-              "module": "/src/util/ClipboardMixin.js"
-            },
-            {
-              "name": "ComponentStatesMixin",
-              "module": "/src/util/ComponentStatesMixin.js"
-            },
-            {
-              "name": "EventEmitterMixin",
-              "module": "/src/util/EventEmitterMixin.js"
-            },
-            {
-              "name": "ReadyMixin",
-              "module": "/src/util/ReadyMixin.js"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "btu-copy-to-clipboard",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "CopyToClipboard",
-            "module": "src/components/copy-to-clipboard/CopyToClipboard.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "btu-copy-to-clipboard",
-          "declaration": {
-            "name": "CopyToClipboard",
-            "module": "src/components/copy-to-clipboard/CopyToClipboard.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/button-group/ButtonGroup.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "A semantic container for grouping related buttons together.\n\nSupports connected (joined) and spaced layouts, horizontal and vertical\norientation, group-level size and disabled propagation, and optional\ntoggle/selection modes (single-select or multi-select).",
-          "name": "ButtonGroup",
-          "cssProperties": [
-            {
-              "description": "Space between buttons when variant=\"spaced\" (default: spacing.sm)",
-              "name": "--button-group-gap"
+              "default": "'sm'",
+              "description": "Size variant.\n- 'sm': Small (16px) - default\n- 'md': Medium (32px)\n- 'lg': Large (48px)",
+              "fieldName": "size",
+              "attribute": "size"
             },
             {
-              "description": "Corner radius of outer edges when variant=\"connected\" (default: 0.5rem)",
-              "name": "--button-group-border-radius"
+              "name": "color",
+              "type": {
+                "text": "ProgressColors"
+              },
+              "default": "'primary'",
+              "description": "Color theme of the progress indicator.\nSupports: black, white, primary, teal, gray, purple, rose, error, warning, success",
+              "fieldName": "color",
+              "attribute": "color",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
             },
             {
-              "description": "Internal divider color between connected buttons (default: gray-300)",
-              "name": "--button-group-border-color"
+              "name": "thickness",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "Stroke width of the progress indicator.",
+              "fieldName": "thickness",
+              "attribute": "thickness",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
             },
             {
-              "description": "Background of a toggled/selected child (default: primary-50)",
-              "name": "--button-group-selection-bg"
+              "name": "progress",
+              "description": "Progress value for determinate variant. Clamped to 0–100.",
+              "fieldName": "progress",
+              "attribute": "progress",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
             },
             {
-              "description": "Text/icon color of a toggled/selected child (default: primary-700)",
-              "name": "--button-group-selection-color"
+              "name": "label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Optional label text to display with the progress indicator.",
+              "fieldName": "label",
+              "attribute": "label",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
             },
             {
-              "description": "Highlight color of the selection shimmer effect (default: primary-200)",
-              "name": "--button-group-shimmer-highlight"
-            }
-          ],
-          "slots": [
-            {
-              "description": "One or more btu-button or btu-icon-button elements to display in the group",
-              "name": ""
+              "name": "initial-animation",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether to animate progress from 0 to target value when component first becomes visible.",
+              "fieldName": "initialAnimation",
+              "attribute": "initial-animation",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
             },
             {
-              "description": "Pushes the child to the end of the group via auto-margin (vertical: bottom, horizontal: right)",
-              "name": "end"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "tagName",
-              "static": true,
-              "readonly": true
+              "name": "aria-label",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "Optional aria-label attribute for screen readers.\nDescribes what the progress indicator represents.",
+              "fieldName": "ariaLabel",
+              "attribute": "aria-label",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
             },
             {
-              "kind": "field",
-              "name": "label",
+              "name": "aria-labelledby",
               "type": {
-                "text": "string"
+                "text": "string | null"
               },
-              "default": "''",
-              "description": "Accessible name for the group, announced by assistive devices via aria-label.",
-              "attribute": "label"
+              "default": "null",
+              "description": "Optional aria-labelledby attribute for screen readers.\nReferences the ID of an element that labels the progress indicator.",
+              "fieldName": "ariaLabelledBy",
+              "attribute": "aria-labelledby",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
             },
             {
-              "kind": "field",
-              "name": "orientation",
+              "name": "aria-valuetext",
               "type": {
-                "text": "'horizontal' | 'vertical'"
+                "text": "string | null"
               },
-              "default": "'horizontal'",
-              "description": "Layout direction of the buttons.",
-              "attribute": "orientation",
-              "reflects": true
+              "default": "null",
+              "description": "Optional aria-valuetext attribute for screen readers.\nProvides human-readable text alternative for progress value.",
+              "fieldName": "ariaValueText",
+              "attribute": "aria-valuetext",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
             },
             {
-              "kind": "field",
-              "name": "variant",
+              "name": "completion-announcement",
               "type": {
-                "text": "'connected' | 'spaced'"
+                "text": "string | undefined"
               },
-              "default": "'connected'",
-              "description": "`connected` collapses shared borders for a joined appearance.\n`spaced` renders buttons with a gap.",
-              "attribute": "variant",
-              "reflects": true
+              "description": "Optional message to announce to screen readers when progress reaches 100%.\nIf not provided, no announcement will be made on completion.",
+              "fieldName": "completionAnnouncement",
+              "attribute": "completion-announcement",
+              "inheritedFrom": {
+                "name": "ProgressMixin",
+                "module": "src/util/ProgressMixin.ts"
+              }
+            }
+          ],
+          "mixins": [
+            {
+              "name": "ProgressMixin",
+              "module": "/src/util/ProgressMixin.js"
             },
             {
-              "kind": "field",
-              "name": "size",
-              "type": {
-                "text": "'sm' | 'md' | 'lg'"
-              },
-              "default": "'md'",
-              "description": "Propagates a uniform size to all child buttons.",
-              "attribute": "size",
-              "reflects": true
+              "name": "EventEmitterMixin",
+              "module": "/src/util/EventEmitterMixin.js"
             },
+            {
+              "name": "ReadyMixin",
+              "module": "/src/util/ReadyMixin.js"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "btu-circular-progress",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "CircularProgress",
+            "module": "src/components/circular-progress/CircularProgress.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "btu-circular-progress",
+          "declaration": {
+            "name": "CircularProgress",
+            "module": "src/components/circular-progress/CircularProgress.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/copy-to-clipboard/CopyToClipboard.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A button component that copies text to the system clipboard.\n\nProvides visual feedback when text is successfully copied by applying\na temporary state that can be styled with CSS.\n\nButton styling is inherited from `btu-button-*` classes. Override appearance\nby passing custom classes via the `buttonClasses` attribute.",
+          "name": "CopyToClipboard",
+          "members": [
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "copydata",
               "type": {
-                "text": "boolean"
+                "text": "string | undefined"
               },
-              "default": "false",
-              "description": "When true, disables all child buttons as a group.",
-              "attribute": "disabled"
+              "description": "The text to be copied to the system clipboard.",
+              "attribute": "copydata"
             },
             {
               "kind": "field",
-              "name": "selection",
+              "name": "buttonClasses",
               "type": {
-                "text": "'none' | 'single' | 'multiple'"
+                "text": "string | undefined"
               },
-              "default": "'none'",
-              "description": "Enables toggle/selection behavior.\n`single` allows one active button; `multiple` allows many.",
-              "attribute": "selection",
-              "reflects": true
+              "description": "Custom CSS classes for the button. If provided, replaces the default classes.",
+              "attribute": "buttonClasses"
             },
             {
-              "kind": "field",
-              "name": "value",
-              "type": {
-                "text": "string"
+              "kind": "method",
+              "name": "copy",
+              "return": {
+                "type": {
+                  "text": ""
+                }
               },
-              "default": "''",
-              "description": "Reflects the currently selected button value(s).\nFor `single`, the value of the active button.\nFor `multiple`, a comma-delimited list of active values.",
-              "attribute": "value",
-              "reflects": true
+              "parameters": [
+                {
+                  "name": "text",
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "The text to copy to clipboard"
+                },
+                {
+                  "name": "timeout",
+                  "default": "3000",
+                  "description": "Duration in milliseconds to show success state (default: 3000)"
+                }
+              ],
+              "description": "Copies the copydata to the system clipboard.\nDisplays a success state for 3 seconds after copying.",
+              "inheritedFrom": {
+                "name": "ClipboardMixin",
+                "module": "src/util/ClipboardMixin.ts"
+              }
             },
             {
               "kind": "field",
-              "name": "name",
+              "name": "copiedStateKey",
               "type": {
-                "text": "string"
+                "text": "'btu-copy-to-clipboard-copied'"
               },
-              "default": "''",
-              "description": "When set, creates hidden input(s) for native form participation.",
-              "attribute": "name"
+              "description": "Custom state applied briefly after a successful copy; also emitted as an event.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "ClipboardMixin",
+                "module": "src/util/ClipboardMixin.ts"
+              }
             },
             {
               "kind": "method",
@@ -2951,131 +3036,46 @@
                 "text": "CustomEvent"
               },
               "description": "Fired after first render and initialization",
-              "name": "btu-button-group-ready"
-            },
-            {
-              "type": {
-                "text": "CustomEvent<{value: string}>"
-              },
-              "description": "Fired when selection changes (single/multiple modes only)",
-              "name": "btu-button-group-change"
+              "name": "btu-copy-to-clipboard-ready"
             },
             {
               "type": {
-                "text": "CustomEvent<{name: string | undefined}>"
+                "text": "CustomEvent"
               },
-              "description": "Bubbles from child btu-icon-button elements when clicked",
-              "name": "btu-icon-button-click"
+              "description": "Fired when text is successfully copied to clipboard",
+              "name": "btu-copy-to-clipboard-copied"
             }
           ],
           "attributes": [
             {
-              "name": "label",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Accessible name for the group, announced by assistive devices via aria-label.",
-              "fieldName": "label",
-              "attribute": "label"
-            },
-            {
-              "name": "orientation",
-              "type": {
-                "text": "'horizontal' | 'vertical'"
-              },
-              "default": "'horizontal'",
-              "description": "Layout direction of the buttons.",
-              "fieldName": "orientation",
-              "attribute": "orientation"
-            },
-            {
-              "name": "variant",
-              "type": {
-                "text": "'connected' | 'spaced'"
-              },
-              "default": "'connected'",
-              "description": "`connected` collapses shared borders for a joined appearance.\n`spaced` renders buttons with a gap.",
-              "fieldName": "variant",
-              "attribute": "variant"
-            },
-            {
-              "name": "size",
-              "type": {
-                "text": "'sm' | 'md' | 'lg'"
-              },
-              "default": "'md'",
-              "description": "Propagates a uniform size to all child buttons.",
-              "fieldName": "size",
-              "attribute": "size"
-            },
-            {
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "When true, disables all child buttons as a group.",
-              "fieldName": "disabled",
-              "attribute": "disabled"
-            },
-            {
-              "name": "selection",
-              "type": {
-                "text": "'none' | 'single' | 'multiple'"
-              },
-              "default": "'none'",
-              "description": "Enables toggle/selection behavior.\n`single` allows one active button; `multiple` allows many.",
-              "fieldName": "selection",
-              "attribute": "selection"
-            },
-            {
-              "name": "value",
+              "name": "copydata",
               "type": {
-                "text": "string"
+                "text": "string | undefined"
               },
-              "default": "''",
-              "description": "Reflects the currently selected button value(s).\nFor `single`, the value of the active button.\nFor `multiple`, a comma-delimited list of active values.",
-              "fieldName": "value",
-              "attribute": "value"
+              "description": "The text to be copied to the system clipboard.",
+              "fieldName": "copydata",
+              "attribute": "copydata"
             },
             {
-              "name": "name",
+              "name": "buttonClasses",
               "type": {
-                "text": "string"
+                "text": "string | undefined"
               },
-              "default": "''",
-              "description": "When set, creates hidden input(s) for native form participation.",
-              "fieldName": "name",
-              "attribute": "name"
+              "description": "Custom CSS classes for the button. If provided, replaces the default classes.",
+              "fieldName": "buttonClasses",
+              "attribute": "buttonClasses"
             }
           ],
           "cssStates": [
             {
-              "description": "Applied when variant=\"connected\", targetable via :state(btu-connected)",
-              "name": "btu-connected"
-            },
-            {
-              "description": "Applied when variant=\"spaced\", targetable via :state(btu-spaced)",
-              "name": "btu-spaced"
-            },
-            {
-              "description": "Applied when orientation=\"horizontal\", targetable via :state(btu-horizontal)",
-              "name": "btu-horizontal"
-            },
-            {
-              "description": "Applied when orientation=\"vertical\", targetable via :state(btu-vertical)",
-              "name": "btu-vertical"
-            },
-            {
-              "description": "Applied when the group is disabled, targetable via :state(btu-disabled)",
-              "name": "btu-disabled"
+              "description": "Applied briefly after a successful copy, targetable via :state(btu-copy-to-clipboard-copied)",
+              "name": "btu-copy-to-clipboard-copied"
             }
           ],
           "mixins": [
             {
-              "name": "RovingTabindexMixin",
-              "module": "/src/util/RovingTabindexMixin.js"
+              "name": "ClipboardMixin",
+              "module": "/src/util/ClipboardMixin.js"
             },
             {
               "name": "ComponentStatesMixin",
@@ -3094,7 +3094,7 @@
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "btu-button-group",
+          "tagName": "btu-copy-to-clipboard",
           "customElement": true
         }
       ],
@@ -3103,16 +3103,16 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "ButtonGroup",
-            "module": "src/components/button-group/ButtonGroup.ts"
+            "name": "CopyToClipboard",
+            "module": "src/components/copy-to-clipboard/CopyToClipboard.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "btu-button-group",
+          "name": "btu-copy-to-clipboard",
           "declaration": {
-            "name": "ButtonGroup",
-            "module": "src/components/button-group/ButtonGroup.ts"
+            "name": "CopyToClipboard",
+            "module": "src/components/copy-to-clipboard/CopyToClipboard.ts"
           }
         }
       ]