@brightspot/ui 1.5.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"
           }
         }
       ]
@@ -676,61 +676,218 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/icon/Icon.ts",
+      "path": "src/components/dropdown/Dropdown.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "An icon component for displaying Lucide icons.\n\nIcons inherit parent text color by default or can use gradient fills.\nAll icons are from the Lucide icon library (https://lucide.dev/icons/).\nSupports both direct SVG rendering and mask-based gradient fills.",
-          "name": "Icon",
+          "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": "Icon size (overrides size default)",
-              "name": "--Icon-size"
+              "description": "Panel background color (default: white)",
+              "name": "--dropdown-panel-background"
             },
             {
-              "description": "Icon fill color for filled icons (e.g., \"currentColor\")",
-              "name": "--Icon-fill"
+              "description": "Panel border color (default: gray-200)",
+              "name": "--dropdown-panel-border-color"
             },
             {
-              "description": "SVG data URI for mask-based rendering",
-              "name": "--Icon-svg"
+              "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": "tagName",
-              "static": true,
-              "readonly": true
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Trigger button text.",
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "size",
+              "name": "open",
               "type": {
-                "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
+                "text": "boolean"
               },
-              "default": "'md'",
-              "description": "Size of the icon.\n- 'xs': Extra small (0.75rem)\n- 'sm': Small (1rem)\n- 'md': Medium (1.25rem, default)\n- 'lg': Large (1.5rem)\n- 'xl': Extra large (1.75rem)",
-              "attribute": "size"
+              "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": "symbol",
+              "name": "placement",
               "type": {
-                "text": "string"
+                "text": "Placement"
               },
-              "default": "'circle-dashed'",
-              "description": "Lucide icon name to display.\nSee https://lucide.dev/icons/ for available icons.",
-              "attribute": "symbol"
+              "default": "'bottom-start'",
+              "description": "Panel placement: 'bottom-start', 'bottom-end', 'top-start', 'top-end'.",
+              "attribute": "placement"
             },
             {
               "kind": "field",
-              "name": "gradient",
+              "name": "size",
               "type": {
-                "text": "'ai' | 'error' | 'gray' | 'primary' | 'purple' | 'rose' | 'success' | 'teal' | 'warning' | undefined"
+                "text": "Size"
               },
-              "description": "Theme color to use for gradient fill.\nWhen set, icon displays with gradient. When undefined, icon inherits parent text color.",
-              "attribute": "gradient"
+              "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": [
@@ -739,41 +896,154 @@
                 "text": "CustomEvent"
               },
               "description": "Fired after first render and initialization",
-              "name": "btu-icon-ready"
+              "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": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
+                "text": "Size"
               },
-              "default": "'md'",
-              "description": "Size of the icon.\n- 'xs': Extra small (0.75rem)\n- 'sm': Small (1rem)\n- 'md': Medium (1.25rem, default)\n- 'lg': Large (1.5rem)\n- 'xl': Extra large (1.75rem)",
+              "default": "'medium'",
+              "description": "Button size: 'small', 'medium', 'large'.",
               "fieldName": "size",
               "attribute": "size"
             },
             {
-              "name": "symbol",
+              "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": "'circle-dashed'",
-              "description": "Lucide icon name to display.\nSee https://lucide.dev/icons/ for available icons.",
-              "fieldName": "symbol",
-              "attribute": "symbol"
+              "default": "''",
+              "description": "Lucide icon symbol for the trigger.",
+              "fieldName": "iconSymbol",
+              "attribute": "icon-symbol"
             },
             {
-              "name": "gradient",
+              "name": "icon-position",
               "type": {
-                "text": "'ai' | 'error' | 'gray' | 'primary' | 'purple' | 'rose' | 'success' | 'teal' | 'warning' | undefined"
+                "text": "'leading' | 'trailing'"
               },
-              "description": "Theme color to use for gradient fill.\nWhen set, icon displays with gradient. When undefined, icon inherits parent text color.",
-              "fieldName": "gradient",
-              "attribute": "gradient"
+              "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"
@@ -787,7 +1057,7 @@
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "btu-icon",
+          "tagName": "btu-dropdown",
           "customElement": true
         }
       ],
@@ -796,74 +1066,1264 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "Icon",
-            "module": "src/components/icon/Icon.ts"
+            "name": "Dropdown",
+            "module": "src/components/dropdown/Dropdown.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "btu-icon",
+          "name": "btu-dropdown",
           "declaration": {
-            "name": "Icon",
-            "module": "src/components/icon/Icon.ts"
+            "name": "Dropdown",
+            "module": "src/components/dropdown/Dropdown.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/linear-progress/LinearProgress.ts",
+      "path": "src/components/dropdown/DropdownItem.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A horizontal linear progress bar for showing task completion.",
-          "name": "LinearProgress",
-          "cssProperties": [
+          "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": [
             {
-              "description": "Custom progress bar color (overrides theme color)",
-              "name": "--progress-color"
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Display text for the item.",
+              "attribute": "label"
             },
             {
-              "description": "Track/background color (overrides default gray-100)",
-              "name": "--track-color"
-            }
-          ],
-          "members": [],
-          "events": [
+              "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": "CustomEvent"
+                "text": "string"
               },
-              "description": "Fired after first render and initialization",
-              "name": "btu-progress-ready"
+              "default": "''",
+              "description": "Lucide icon symbol.",
+              "attribute": "icon-symbol"
             },
             {
+              "kind": "field",
+              "name": "shortcut",
               "type": {
-                "text": "CustomEvent"
+                "text": "string"
               },
-              "description": "Fired when progress reaches 100",
-              "name": "btu-progress-complete"
-            }
-          ],
-          "mixins": [
+              "default": "''",
+              "description": "Keyboard shortcut display text.",
+              "attribute": "shortcut"
+            },
             {
-              "name": "ProgressMixin",
-              "module": "/src/util/ProgressMixin.js"
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the item is disabled.",
+              "attribute": "disabled"
             },
             {
-              "name": "EventEmitterMixin",
-              "module": "/src/util/EventEmitterMixin.js"
+              "kind": "field",
+              "name": "selected",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the item is selected/checked.",
+              "attribute": "selected",
+              "reflects": true
             },
             {
-              "name": "ReadyMixin",
-              "module": "/src/util/ReadyMixin.js"
+              "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"
+                }
+              }
             }
           ],
-          "superclass": {
-            "name": "LitElement",
+          "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",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "An icon component for displaying Lucide icons.\n\nIcons inherit parent text color by default or can use gradient fills.\nAll icons are from the Lucide icon library (https://lucide.dev/icons/).\nSupports both direct SVG rendering and mask-based gradient fills.",
+          "name": "Icon",
+          "cssProperties": [
+            {
+              "description": "Icon size (overrides size default)",
+              "name": "--Icon-size"
+            },
+            {
+              "description": "Icon fill color for filled icons (e.g., \"currentColor\")",
+              "name": "--Icon-fill"
+            },
+            {
+              "description": "SVG data URI for mask-based rendering",
+              "name": "--Icon-svg"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "tagName",
+              "static": true,
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
+              },
+              "default": "'md'",
+              "description": "Size of the icon.\n- 'xs': Extra small (0.75rem)\n- 'sm': Small (1rem)\n- 'md': Medium (1.25rem, default)\n- 'lg': Large (1.5rem)\n- 'xl': Extra large (1.75rem)",
+              "attribute": "size"
+            },
+            {
+              "kind": "field",
+              "name": "symbol",
+              "type": {
+                "text": "string"
+              },
+              "default": "'circle-dashed'",
+              "description": "Lucide icon name to display.\nSee https://lucide.dev/icons/ for available icons.",
+              "attribute": "symbol"
+            },
+            {
+              "kind": "field",
+              "name": "gradient",
+              "type": {
+                "text": "'ai' | 'error' | 'gray' | 'primary' | 'purple' | 'rose' | 'success' | 'teal' | 'warning' | undefined"
+              },
+              "description": "Theme color to use for gradient fill.\nWhen set, icon displays with gradient. When undefined, icon inherits parent text color.",
+              "attribute": "gradient"
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired after first render and initialization",
+              "name": "btu-icon-ready"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "size",
+              "type": {
+                "text": "'xs' | 'sm' | 'md' | 'lg' | 'xl'"
+              },
+              "default": "'md'",
+              "description": "Size of the icon.\n- 'xs': Extra small (0.75rem)\n- 'sm': Small (1rem)\n- 'md': Medium (1.25rem, default)\n- 'lg': Large (1.5rem)\n- 'xl': Extra large (1.75rem)",
+              "fieldName": "size",
+              "attribute": "size"
+            },
+            {
+              "name": "symbol",
+              "type": {
+                "text": "string"
+              },
+              "default": "'circle-dashed'",
+              "description": "Lucide icon name to display.\nSee https://lucide.dev/icons/ for available icons.",
+              "fieldName": "symbol",
+              "attribute": "symbol"
+            },
+            {
+              "name": "gradient",
+              "type": {
+                "text": "'ai' | 'error' | 'gray' | 'primary' | 'purple' | 'rose' | 'success' | 'teal' | 'warning' | undefined"
+              },
+              "description": "Theme color to use for gradient fill.\nWhen set, icon displays with gradient. When undefined, icon inherits parent text color.",
+              "fieldName": "gradient",
+              "attribute": "gradient"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "EventEmitterMixin",
+              "module": "/src/util/EventEmitterMixin.js"
+            },
+            {
+              "name": "ReadyMixin",
+              "module": "/src/util/ReadyMixin.js"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "btu-icon",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "Icon",
+            "module": "src/components/icon/Icon.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "btu-icon",
+          "declaration": {
+            "name": "Icon",
+            "module": "src/components/icon/Icon.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/linear-progress/LinearProgress.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A horizontal linear progress bar for showing task completion.",
+          "name": "LinearProgress",
+          "cssProperties": [
+            {
+              "description": "Custom progress bar color (overrides theme color)",
+              "name": "--progress-color"
+            },
+            {
+              "description": "Track/background color (overrides default gray-100)",
+              "name": "--track-color"
+            }
+          ],
+          "members": [],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired after first render and initialization",
+              "name": "btu-progress-ready"
+            },
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when progress reaches 100",
+              "name": "btu-progress-complete"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "ProgressMixin",
+              "module": "/src/util/ProgressMixin.js"
+            },
+            {
+              "name": "EventEmitterMixin",
+              "module": "/src/util/EventEmitterMixin.js"
+            },
+            {
+              "name": "ReadyMixin",
+              "module": "/src/util/ReadyMixin.js"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "btu-linear-progress",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "LinearProgress",
+            "module": "src/components/linear-progress/LinearProgress.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "btu-linear-progress",
+          "declaration": {
+            "name": "LinearProgress",
+            "module": "src/components/linear-progress/LinearProgress.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/pagination/Pagination.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A pagination component for navigating through paged content.\n\nSupports multiple layout variants (Search, Widget, Widget Small, Calendar)\nthrough configurable props and pseudo-slots.",
+          "name": "Pagination",
+          "cssProperties": [
+            {
+              "description": "Background color for select, buttons, and jumper",
+              "name": "--pagination-color-background"
+            },
+            {
+              "description": "Text/icon color",
+              "name": "--pagination-color-foreground"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Custom page-size selector (replaces built-in select)",
+              "name": "page-size"
+            },
+            {
+              "description": "Custom jumper content (e.g., page dropdown, \"Today\" button)",
+              "name": "jumper"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "page",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "Current page number (1-based)",
+              "attribute": "page"
+            },
+            {
+              "kind": "field",
+              "name": "pageSize",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Number of items per page",
+              "attribute": "page-size"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables all pagination controls",
+              "attribute": "disabled"
+            },
+            {
+              "kind": "field",
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows loading spinner and dims controls",
+              "attribute": "loading"
+            },
+            {
+              "kind": "field",
+              "name": "hideOnSinglePage",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Hide controls when there is only one page",
+              "attribute": "hide-on-single-page"
+            },
+            {
+              "kind": "field",
+              "name": "pageSizeChanger",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Show the page size dropdown",
+              "attribute": "page-size-changer"
+            },
+            {
+              "kind": "field",
+              "name": "pageSizeOptions",
+              "type": {
+                "text": "string"
+              },
+              "default": "'10, 20, 50'",
+              "description": "Comma-separated page size options",
+              "attribute": "page-size-options"
+            },
+            {
+              "kind": "field",
+              "name": "totalItems",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Total number of items across all pages",
+              "attribute": "total-items"
+            },
+            {
+              "kind": "field",
+              "name": "boundaryButtons",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Show first and last page buttons",
+              "attribute": "boundary-buttons"
+            },
+            {
+              "kind": "field",
+              "name": "hideTotalCount",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hide the item count display (e.g., \"1-10 of 200\")",
+              "attribute": "hide-total-count"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Accessible label for the pagination nav landmark",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "_parsedPageSizeOptions",
+              "type": {
+                "text": "number[]"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_totalPages",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_startItem",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_endItem",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "_setupSlots",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_goToFirstPage",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_goToPreviousPage",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_goToNextPage",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_goToLastPage",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_manageBoundaryFocus",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "clickedButton",
+                  "type": {
+                    "text": "HTMLButtonElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_onPageSizeChange",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired after first render",
+              "name": "btu-pagination-ready"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<{page: number, pageSize: number}>"
+              },
+              "description": "Fired on page navigation",
+              "name": "btu-pagination-change"
+            },
+            {
+              "type": {
+                "text": "CustomEvent<{page: number, pageSize: number}>"
+              },
+              "description": "Fired on page size change",
+              "name": "btu-pagination-page-size-change"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "page",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "Current page number (1-based)",
+              "fieldName": "page",
+              "attribute": "page"
+            },
+            {
+              "name": "page-size",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Number of items per page",
+              "fieldName": "pageSize",
+              "attribute": "page-size"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables all pagination controls",
+              "fieldName": "disabled",
+              "attribute": "disabled"
+            },
+            {
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows loading spinner and dims controls",
+              "fieldName": "loading",
+              "attribute": "loading"
+            },
+            {
+              "name": "hide-on-single-page",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Hide controls when there is only one page",
+              "fieldName": "hideOnSinglePage",
+              "attribute": "hide-on-single-page"
+            },
+            {
+              "name": "page-size-changer",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Show the page size dropdown",
+              "fieldName": "pageSizeChanger",
+              "attribute": "page-size-changer"
+            },
+            {
+              "name": "page-size-options",
+              "type": {
+                "text": "string"
+              },
+              "default": "'10, 20, 50'",
+              "description": "Comma-separated page size options",
+              "fieldName": "pageSizeOptions",
+              "attribute": "page-size-options"
+            },
+            {
+              "name": "total-items",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Total number of items across all pages",
+              "fieldName": "totalItems",
+              "attribute": "total-items"
+            },
+            {
+              "name": "boundary-buttons",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Show first and last page buttons",
+              "fieldName": "boundaryButtons",
+              "attribute": "boundary-buttons"
+            },
+            {
+              "name": "hide-total-count",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hide the item count display (e.g., \"1-10 of 200\")",
+              "fieldName": "hideTotalCount",
+              "attribute": "hide-total-count"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Accessible label for the pagination nav landmark",
+              "fieldName": "label",
+              "attribute": "label"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "EventEmitterMixin",
+              "module": "/src/util/EventEmitterMixin.js"
+            },
+            {
+              "name": "ReadyMixin",
+              "module": "/src/util/ReadyMixin.js"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "btu-linear-progress",
+          "tagName": "btu-pagination",
           "customElement": true
         }
       ],
@@ -872,16 +2332,16 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "LinearProgress",
-            "module": "src/components/linear-progress/LinearProgress.ts"
+            "name": "Pagination",
+            "module": "src/components/pagination/Pagination.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "btu-linear-progress",
+          "name": "btu-pagination",
           "declaration": {
-            "name": "LinearProgress",
-            "module": "src/components/linear-progress/LinearProgress.ts"
+            "name": "Pagination",
+            "module": "src/components/pagination/Pagination.ts"
           }
         }
       ]