@brightspot/ui 1.6.0 → 1.7.0

package/dist/custom-elements.json

@@ -295,45 +295,67 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/circular-progress/CircularProgress.ts",
+      "path": "src/components/badge/Badge.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A circular progress indicator for showing loading states or progress.",
-          "name": "CircularProgress",
+          "description": "A badge component for highlighting important information.\n\nBadges help highlight notifications, status, or new messages.\nPrimarily used for communicating secondary or additional information.",
+          "name": "Badge",
           "cssProperties": [
             {
-              "description": "Custom progress indicator color (overrides theme color)",
-              "name": "--progress-color"
+              "description": "Text color (overrides theme color)",
+              "name": "--badge-color-foreground"
             },
             {
-              "description": "Track/background color (overrides default gray-100)",
-              "name": "--track-color"
+              "description": "Background color (overrides theme color)",
+              "name": "--badge-color-background"
             },
             {
-              "description": "Custom size in pixels (overrides size preset)",
-              "name": "--progress-size"
+              "description": "Border radius size (overrides shape default, default: 999px)",
+              "name": "--badge-radius-size"
+            },
+            {
+              "description": "Horizontal padding (overrides size default)",
+              "name": "--badge-px"
+            },
+            {
+              "description": "Vertical padding (overrides size default)",
+              "name": "--badge-py"
+            },
+            {
+              "description": "Size of the dot affordance (default: 6px)",
+              "name": "--badge-dot-size"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "indeterminate",
+              "name": "variant",
+              "type": {
+                "text": "'info' | 'primary' | 'error' | 'success' | 'warning'"
+              },
+              "default": "'info'",
+              "description": "Style of the badge.\n- 'info': Informational (default)\n- 'primary': Primary action or emphasis\n- 'error': Error or danger state\n- 'success': Success or completion state\n- 'warning': Warning or caution state",
+              "attribute": "variant"
+            },
+            {
+              "kind": "field",
+              "name": "dot",
               "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"
+              "default": "false",
+              "description": "Should a dot be displayed before the label?",
+              "attribute": "dot"
             },
             {
               "kind": "field",
               "name": "size",
               "type": {
-                "text": "'sm' | 'md' | 'lg'"
+                "text": "string"
               },
               "default": "'sm'",
-              "description": "Size variant.\n- 'sm': Small (16px) - default\n- 'md': Medium (32px)\n- 'lg': Large (48px)",
+              "description": "Size variant.\n- 'sm': Small (default)\n- 'md': Medium\n- 'lg': Large",
               "attribute": "size"
             }
           ],
@@ -343,43 +365,42 @@
                 "text": "CustomEvent"
               },
               "description": "Fired after first render and initialization",
-              "name": "btu-progress-ready"
-            },
-            {
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Fired when determinate progress reaches 100",
-              "name": "btu-progress-complete"
+              "name": "btu-badge-ready"
             }
           ],
           "attributes": [
             {
-              "name": "indeterminate",
+              "name": "variant",
+              "type": {
+                "text": "'info' | 'primary' | 'error' | 'success' | 'warning'"
+              },
+              "default": "'info'",
+              "description": "Style of the badge.\n- 'info': Informational (default)\n- 'primary': Primary action or emphasis\n- 'error': Error or danger state\n- 'success': Success or completion state\n- 'warning': Warning or caution state",
+              "fieldName": "variant",
+              "attribute": "variant"
+            },
+            {
+              "name": "dot",
               "type": {
                 "text": "boolean"
               },
-              "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"
+              "default": "false",
+              "description": "Should a dot be displayed before the label?",
+              "fieldName": "dot",
+              "attribute": "dot"
             },
             {
               "name": "size",
               "type": {
-                "text": "'sm' | 'md' | 'lg'"
+                "text": "string"
               },
               "default": "'sm'",
-              "description": "Size variant.\n- 'sm': Small (16px) - default\n- 'md': Medium (32px)\n- 'lg': Large (48px)",
+              "description": "Size variant.\n- 'sm': Small (default)\n- 'md': Medium\n- 'lg': Large",
               "fieldName": "size",
               "attribute": "size"
             }
           ],
           "mixins": [
-            {
-              "name": "ProgressMixin",
-              "module": "/src/util/ProgressMixin.js"
-            },
             {
               "name": "EventEmitterMixin",
               "module": "/src/util/EventEmitterMixin.js"
@@ -393,7 +414,7 @@
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "btu-circular-progress",
+          "tagName": "btu-badge",
           "customElement": true
         }
       ],
@@ -402,83 +423,61 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "CircularProgress",
-            "module": "src/components/circular-progress/CircularProgress.ts"
+            "name": "Badge",
+            "module": "src/components/badge/Badge.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "btu-circular-progress",
+          "name": "btu-badge",
           "declaration": {
-            "name": "CircularProgress",
-            "module": "src/components/circular-progress/CircularProgress.ts"
+            "name": "Badge",
+            "module": "src/components/badge/Badge.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/badge/Badge.ts",
+      "path": "src/components/circular-progress/CircularProgress.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A badge component for highlighting important information.\n\nBadges help highlight notifications, status, or new messages.\nPrimarily used for communicating secondary or additional information.",
-          "name": "Badge",
+          "description": "A circular progress indicator for showing loading states or progress.",
+          "name": "CircularProgress",
           "cssProperties": [
             {
-              "description": "Text color (overrides theme color)",
-              "name": "--badge-color-foreground"
-            },
-            {
-              "description": "Background color (overrides theme color)",
-              "name": "--badge-color-background"
-            },
-            {
-              "description": "Border radius size (overrides shape default, default: 999px)",
-              "name": "--badge-radius-size"
-            },
-            {
-              "description": "Horizontal padding (overrides size default)",
-              "name": "--badge-px"
+              "description": "Custom progress indicator color (overrides theme color)",
+              "name": "--progress-color"
             },
             {
-              "description": "Vertical padding (overrides size default)",
-              "name": "--badge-py"
+              "description": "Track/background color (overrides default gray-100)",
+              "name": "--track-color"
             },
             {
-              "description": "Size of the dot affordance (default: 6px)",
-              "name": "--badge-dot-size"
+              "description": "Custom size in pixels (overrides size preset)",
+              "name": "--progress-size"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "variant",
-              "type": {
-                "text": "'info' | 'primary' | 'error' | 'success' | 'warning'"
-              },
-              "default": "'info'",
-              "description": "Style of the badge.\n- 'info': Informational (default)\n- 'primary': Primary action or emphasis\n- 'error': Error or danger state\n- 'success': Success or completion state\n- 'warning': Warning or caution state",
-              "attribute": "variant"
-            },
-            {
-              "kind": "field",
-              "name": "dot",
+              "name": "indeterminate",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "Should a dot be displayed before the label?",
-              "attribute": "dot"
+              "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": "size",
               "type": {
-                "text": "string"
+                "text": "'sm' | 'md' | 'lg'"
               },
               "default": "'sm'",
-              "description": "Size variant.\n- 'sm': Small (default)\n- 'md': Medium\n- 'lg': Large",
+              "description": "Size variant.\n- 'sm': Small (16px) - default\n- 'md': Medium (32px)\n- 'lg': Large (48px)",
               "attribute": "size"
             }
           ],
@@ -488,42 +487,43 @@
                 "text": "CustomEvent"
               },
               "description": "Fired after first render and initialization",
-              "name": "btu-badge-ready"
-            }
-          ],
-          "attributes": [
+              "name": "btu-progress-ready"
+            },
             {
-              "name": "variant",
               "type": {
-                "text": "'info' | 'primary' | 'error' | 'success' | 'warning'"
+                "text": "CustomEvent"
               },
-              "default": "'info'",
-              "description": "Style of the badge.\n- 'info': Informational (default)\n- 'primary': Primary action or emphasis\n- 'error': Error or danger state\n- 'success': Success or completion state\n- 'warning': Warning or caution state",
-              "fieldName": "variant",
-              "attribute": "variant"
-            },
+              "description": "Fired when determinate progress reaches 100",
+              "name": "btu-progress-complete"
+            }
+          ],
+          "attributes": [
             {
-              "name": "dot",
+              "name": "indeterminate",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "Should a dot be displayed before the label?",
-              "fieldName": "dot",
-              "attribute": "dot"
+              "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": "string"
+                "text": "'sm' | 'md' | 'lg'"
               },
               "default": "'sm'",
-              "description": "Size variant.\n- 'sm': Small (default)\n- 'md': Medium\n- 'lg': Large",
+              "description": "Size variant.\n- 'sm': Small (16px) - default\n- 'md': Medium (32px)\n- 'lg': Large (48px)",
               "fieldName": "size",
               "attribute": "size"
             }
           ],
           "mixins": [
+            {
+              "name": "ProgressMixin",
+              "module": "/src/util/ProgressMixin.js"
+            },
             {
               "name": "EventEmitterMixin",
               "module": "/src/util/EventEmitterMixin.js"
@@ -537,7 +537,7 @@
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "btu-badge",
+          "tagName": "btu-circular-progress",
           "customElement": true
         }
       ],
@@ -546,16 +546,16 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "Badge",
-            "module": "src/components/badge/Badge.ts"
+            "name": "CircularProgress",
+            "module": "src/components/circular-progress/CircularProgress.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "btu-badge",
+          "name": "btu-circular-progress",
           "declaration": {
-            "name": "Badge",
-            "module": "src/components/badge/Badge.ts"
+            "name": "CircularProgress",
+            "module": "src/components/circular-progress/CircularProgress.ts"
           }
         }
       ]
@@ -674,6 +674,1002 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/dropdown/Dropdown.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A dropdown component that renders a trigger button and manages a floating panel\ncontaining a `btu-dropdown-menu`.\n\nUses the native Popover API and CSS anchor positioning for panel management.\nThe trigger button is built with existing `btu-button-*` classes.\n\n**Trigger button styling:** Set `--button-*` CSS custom properties on `<btu-dropdown>`\nor a parent element to customize the trigger via CSS inheritance (e.g.,\n`--button-border-radius`, `--button-color-background`). See\n`tailwind-plugin-button.ts` for available props.",
+          "name": "Dropdown",
+          "cssProperties": [
+            {
+              "description": "Panel background color (default: white)",
+              "name": "--dropdown-panel-background"
+            },
+            {
+              "description": "Panel border color (default: gray-200)",
+              "name": "--dropdown-panel-border-color"
+            },
+            {
+              "description": "Panel border radius (default: borderRadius.lg)",
+              "name": "--dropdown-panel-border-radius"
+            },
+            {
+              "description": "Panel minimum width (default: max(12rem, anchor-size(width)))",
+              "name": "--dropdown-panel-min-width"
+            },
+            {
+              "description": "Item background color (default: transparent)",
+              "name": "--dropdown-item-background"
+            },
+            {
+              "description": "Item text color (default: gray-700)",
+              "name": "--dropdown-item-color"
+            },
+            {
+              "description": "Item hover background (default: gray-100)",
+              "name": "--dropdown-item-hover-background"
+            },
+            {
+              "description": "Item hover text color (default: gray-900)",
+              "name": "--dropdown-item-hover-color"
+            },
+            {
+              "description": "Selected item background (default: primary-50)",
+              "name": "--dropdown-item-selected-background"
+            },
+            {
+              "description": "Selected item text color (default: primary-700)",
+              "name": "--dropdown-item-selected-color"
+            },
+            {
+              "description": "Item font size (default: fontSize.sm)",
+              "name": "--dropdown-item-font-size"
+            },
+            {
+              "description": "Divider line color (default: gray-200)",
+              "name": "--dropdown-divider-color"
+            },
+            {
+              "description": "Empty state text color (default: gray-400)",
+              "name": "--dropdown-empty-color"
+            }
+          ],
+          "slots": [
+            {
+              "description": "A `btu-dropdown-menu` element containing `btu-dropdown-item` children",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Trigger button text.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Panel visibility state. Can be set programmatically (e.g., for tour UIs)\n— syncs to `showPopover()`/`hidePopover()` in `updated()`.",
+              "attribute": "open",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "placement",
+              "type": {
+                "text": "Placement"
+              },
+              "default": "'bottom-start'",
+              "description": "Panel placement: 'bottom-start', 'bottom-end', 'top-start', 'top-end'.",
+              "attribute": "placement"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "Size"
+              },
+              "default": "'medium'",
+              "description": "Button size: 'small', 'medium', 'large'.",
+              "attribute": "size"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Prevents opening.",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "type": {
+                "text": "Variant"
+              },
+              "default": "'secondary'",
+              "description": "Button variant: 'primary', 'secondary', 'tertiary', 'primary-clear', 'secondary-clear', 'tertiary-clear'.",
+              "attribute": "variant"
+            },
+            {
+              "kind": "field",
+              "name": "iconSymbol",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Lucide icon symbol for the trigger.",
+              "attribute": "icon-symbol"
+            },
+            {
+              "kind": "field",
+              "name": "iconPosition",
+              "type": {
+                "text": "'leading' | 'trailing'"
+              },
+              "default": "'leading'",
+              "description": "Icon position: 'leading' or 'trailing'.",
+              "attribute": "icon-position"
+            },
+            {
+              "kind": "field",
+              "name": "iconOnly",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hides label, shows icon only.",
+              "attribute": "icon-only"
+            },
+            {
+              "kind": "field",
+              "name": "stayOpenOnSelect",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Keeps panel open on item click.",
+              "attribute": "stay-open-on-select"
+            },
+            {
+              "kind": "field",
+              "name": "noChevron",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hides the chevron icon on the trigger button.",
+              "attribute": "no-chevron",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "_getButtonClasses",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "description": "Build the button class string based on variant and size"
+            },
+            {
+              "kind": "method",
+              "name": "_showPanel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Show the dropdown panel"
+            },
+            {
+              "kind": "method",
+              "name": "_hidePanel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Hide the dropdown panel"
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired after first render and initialization",
+              "name": "btu-dropdown-ready"
+            },
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when the dropdown panel opens",
+              "name": "btu-dropdown-show"
+            },
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when the dropdown panel closes",
+              "name": "btu-dropdown-hide"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<{label: string, selected: boolean}>"
+              },
+              "description": "Fired when a menu item is activated (bubbles from btu-dropdown-item)",
+              "name": "btu-dropdown-item-select"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<{label: string, favorited: boolean}>"
+              },
+              "description": "Fired when a menu item's favorite is toggled (bubbles from btu-dropdown-item)",
+              "name": "btu-dropdown-item-favorite"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Trigger button text.",
+              "fieldName": "label",
+              "attribute": "label"
+            },
+            {
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Panel visibility state. Can be set programmatically (e.g., for tour UIs)\n— syncs to `showPopover()`/`hidePopover()` in `updated()`.",
+              "fieldName": "open",
+              "attribute": "open"
+            },
+            {
+              "name": "placement",
+              "type": {
+                "text": "Placement"
+              },
+              "default": "'bottom-start'",
+              "description": "Panel placement: 'bottom-start', 'bottom-end', 'top-start', 'top-end'.",
+              "fieldName": "placement",
+              "attribute": "placement"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "Size"
+              },
+              "default": "'medium'",
+              "description": "Button size: 'small', 'medium', 'large'.",
+              "fieldName": "size",
+              "attribute": "size"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Prevents opening.",
+              "fieldName": "disabled",
+              "attribute": "disabled"
+            },
+            {
+              "name": "variant",
+              "type": {
+                "text": "Variant"
+              },
+              "default": "'secondary'",
+              "description": "Button variant: 'primary', 'secondary', 'tertiary', 'primary-clear', 'secondary-clear', 'tertiary-clear'.",
+              "fieldName": "variant",
+              "attribute": "variant"
+            },
+            {
+              "name": "icon-symbol",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Lucide icon symbol for the trigger.",
+              "fieldName": "iconSymbol",
+              "attribute": "icon-symbol"
+            },
+            {
+              "name": "icon-position",
+              "type": {
+                "text": "'leading' | 'trailing'"
+              },
+              "default": "'leading'",
+              "description": "Icon position: 'leading' or 'trailing'.",
+              "fieldName": "iconPosition",
+              "attribute": "icon-position"
+            },
+            {
+              "name": "icon-only",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hides label, shows icon only.",
+              "fieldName": "iconOnly",
+              "attribute": "icon-only"
+            },
+            {
+              "name": "stay-open-on-select",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Keeps panel open on item click.",
+              "fieldName": "stayOpenOnSelect",
+              "attribute": "stay-open-on-select"
+            },
+            {
+              "name": "no-chevron",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hides the chevron icon on the trigger button.",
+              "fieldName": "noChevron",
+              "attribute": "no-chevron"
+            }
+          ],
+          "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-dropdown",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "Dropdown",
+            "module": "src/components/dropdown/Dropdown.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "btu-dropdown",
+          "declaration": {
+            "name": "Dropdown",
+            "module": "src/components/dropdown/Dropdown.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/dropdown/DropdownItem.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A menu item component for use inside `btu-dropdown-menu`.\n\nRenders as a menu item, divider, or subhead depending on the `type` property.\nSupports checkbox mode (inherited from parent menu), icons, keyboard shortcuts,\nand favorite toggles.",
+          "name": "DropdownItem",
+          "members": [
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Display text for the item.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "type": {
+                "text": "'default' | 'divider' | 'subhead'"
+              },
+              "default": "'default'",
+              "description": "Item type: 'default', 'divider', or 'subhead'.",
+              "attribute": "type"
+            },
+            {
+              "kind": "field",
+              "name": "iconSymbol",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Lucide icon symbol.",
+              "attribute": "icon-symbol"
+            },
+            {
+              "kind": "field",
+              "name": "shortcut",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Keyboard shortcut display text.",
+              "attribute": "shortcut"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the item is disabled.",
+              "attribute": "disabled"
+            },
+            {
+              "kind": "field",
+              "name": "selected",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the item is selected/checked.",
+              "attribute": "selected",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "favorited",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the item is favorited.",
+              "attribute": "favorited"
+            },
+            {
+              "kind": "method",
+              "name": "_toggleFavorite",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Toggle favorite state"
+            },
+            {
+              "kind": "method",
+              "name": "_handleClick",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired after first render",
+              "name": "btu-dropdown-item-ready"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<{label: string, selected: boolean}>"
+              },
+              "description": "Fired when item is activated",
+              "name": "btu-dropdown-item-select"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<{label: string, favorited: boolean}>"
+              },
+              "description": "Fired when favorite is toggled",
+              "name": "btu-dropdown-item-favorite"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Display text for the item.",
+              "fieldName": "label",
+              "attribute": "label"
+            },
+            {
+              "name": "type",
+              "type": {
+                "text": "'default' | 'divider' | 'subhead'"
+              },
+              "default": "'default'",
+              "description": "Item type: 'default', 'divider', or 'subhead'.",
+              "fieldName": "type",
+              "attribute": "type"
+            },
+            {
+              "name": "icon-symbol",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Lucide icon symbol.",
+              "fieldName": "iconSymbol",
+              "attribute": "icon-symbol"
+            },
+            {
+              "name": "shortcut",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Keyboard shortcut display text.",
+              "fieldName": "shortcut",
+              "attribute": "shortcut"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the item is disabled.",
+              "fieldName": "disabled",
+              "attribute": "disabled"
+            },
+            {
+              "name": "selected",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the item is selected/checked.",
+              "fieldName": "selected",
+              "attribute": "selected"
+            },
+            {
+              "name": "favorited",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the item is favorited.",
+              "fieldName": "favorited",
+              "attribute": "favorited"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "EventEmitterMixin",
+              "module": "/src/util/EventEmitterMixin.js"
+            },
+            {
+              "name": "ReadyMixin",
+              "module": "/src/util/ReadyMixin.js"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "btu-dropdown-item",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "DropdownItem",
+            "module": "src/components/dropdown/DropdownItem.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "btu-dropdown-item",
+          "declaration": {
+            "name": "DropdownItem",
+            "module": "src/components/dropdown/DropdownItem.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/dropdown/DropdownMenu.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A menu container component that provides keyboard navigation and ARIA menu semantics.\n\nContains `btu-dropdown-item` children and manages roving tabindex, typeahead search,\nand keyboard navigation following the WAI-ARIA Menu Button Pattern.",
+          "name": "DropdownMenu",
+          "cssProperties": [
+            {
+              "description": "Empty state text color (default: gray-400)",
+              "name": "--dropdown-empty-color"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Menu items (`btu-dropdown-item` elements)",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible name for the menu, displayed in header when header is true.",
+              "attribute": "name"
+            },
+            {
+              "kind": "field",
+              "name": "header",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show header bar with menu name.",
+              "attribute": "header"
+            },
+            {
+              "kind": "field",
+              "name": "checkbox",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Enable checkbox mode for items (menuitemcheckbox role).",
+              "attribute": "checkbox"
+            },
+            {
+              "kind": "field",
+              "name": "icon",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show icons before each item.",
+              "attribute": "icon"
+            },
+            {
+              "kind": "field",
+              "name": "iconSymbol",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Fallback Lucide icon symbol for items without their own.",
+              "attribute": "icon-symbol"
+            },
+            {
+              "kind": "field",
+              "name": "favorites",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show favorite toggle on each item.",
+              "attribute": "favorites"
+            },
+            {
+              "kind": "field",
+              "name": "shortcuts",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show keyboard shortcut text on each item.",
+              "attribute": "shortcuts"
+            },
+            {
+              "kind": "field",
+              "name": "emptyMessage",
+              "type": {
+                "text": "string"
+              },
+              "default": "'No items available'",
+              "description": "Message displayed when the menu has no focusable items.",
+              "attribute": "empty-message"
+            },
+            {
+              "kind": "method",
+              "name": "_configureItems",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Configure all child items with menu-level settings"
+            },
+            {
+              "kind": "method",
+              "name": "_getAllItems",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "DropdownItem[]"
+                }
+              },
+              "description": "Get all btu-dropdown-item children"
+            },
+            {
+              "kind": "method",
+              "name": "_getFocusableItems",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "DropdownItem[]"
+                }
+              },
+              "description": "Get only focusable items (default type, skip dividers/subheads)"
+            },
+            {
+              "kind": "method",
+              "name": "_getCurrentFocusIndex",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "focusable",
+                  "type": {
+                    "text": "DropdownItem[]"
+                  }
+                }
+              ],
+              "description": "Find the current focused item index"
+            },
+            {
+              "kind": "method",
+              "name": "_findNextIndex",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "focusable",
+                  "type": {
+                    "text": "DropdownItem[]"
+                  }
+                },
+                {
+                  "name": "current",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "direction",
+                  "type": {
+                    "text": "1 | -1"
+                  }
+                }
+              ],
+              "description": "Find next index wrapping around, moving in direction (+1 or -1)"
+            },
+            {
+              "kind": "method",
+              "name": "_handleTypeahead",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "char",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "focusable",
+                  "type": {
+                    "text": "DropdownItem[]"
+                  }
+                }
+              ],
+              "description": "Typeahead character matching with 500ms accumulation"
+            },
+            {
+              "kind": "field",
+              "name": "_isEmpty",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "Check whether the menu has zero focusable items",
+              "readonly": true
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired after first render",
+              "name": "btu-dropdown-menu-ready"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible name for the menu, displayed in header when header is true.",
+              "fieldName": "name",
+              "attribute": "name"
+            },
+            {
+              "name": "header",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show header bar with menu name.",
+              "fieldName": "header",
+              "attribute": "header"
+            },
+            {
+              "name": "checkbox",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Enable checkbox mode for items (menuitemcheckbox role).",
+              "fieldName": "checkbox",
+              "attribute": "checkbox"
+            },
+            {
+              "name": "icon",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show icons before each item.",
+              "fieldName": "icon",
+              "attribute": "icon"
+            },
+            {
+              "name": "icon-symbol",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Fallback Lucide icon symbol for items without their own.",
+              "fieldName": "iconSymbol",
+              "attribute": "icon-symbol"
+            },
+            {
+              "name": "favorites",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show favorite toggle on each item.",
+              "fieldName": "favorites",
+              "attribute": "favorites"
+            },
+            {
+              "name": "shortcuts",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show keyboard shortcut text on each item.",
+              "fieldName": "shortcuts",
+              "attribute": "shortcuts"
+            },
+            {
+              "name": "empty-message",
+              "type": {
+                "text": "string"
+              },
+              "default": "'No items available'",
+              "description": "Message displayed when the menu has no focusable items.",
+              "fieldName": "emptyMessage",
+              "attribute": "empty-message"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "EventEmitterMixin",
+              "module": "/src/util/EventEmitterMixin.js"
+            },
+            {
+              "name": "ReadyMixin",
+              "module": "/src/util/ReadyMixin.js"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "btu-dropdown-menu",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "DropdownMenu",
+            "module": "src/components/dropdown/DropdownMenu.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "btu-dropdown-menu",
+          "declaration": {
+            "name": "DropdownMenu",
+            "module": "src/components/dropdown/DropdownMenu.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/icon/Icon.ts",