@brightspot/ui 6.8.1 → 6.8.3-rc.1

package/dist/storybook/llms.txt

@@ -0,0 +1,65 @@
+# Brightspot UI
+
+> `@brightspot/ui` 6.8.3-rc.1: Lit web components (`btu-*` tags) and a TailwindCSS v3 preset for building Brightspot CMS screens and plugins.
+
+These docs describe 6.8.3-rc.1. Prefer them over what you remember about this library, because component APIs change between minor versions. For the version a project actually uses, read `node_modules/@brightspot/ui/llms.txt` in that project. Releases without that file still have their manifest at `https://cdn.jsdelivr.net/npm/@brightspot/ui@<version>/dist/custom-elements.json`.
+
+Components render in the light DOM, not a shadow root. In HTML, use the attribute names from each component page: many differ from the JavaScript property names, for example `heading-level` for `headingLevel`.
+
+The guide and component pages linked below are markdown.
+
+## Getting started
+
+- [README](https://ui.brightspot.com/README.md): install, the Tailwind preset and importing components
+- [Using components in a CMS plugin](https://ui.brightspot.com/docs/components/README.md): the CMS defines only `btu-badge`, `btu-copy-to-clipboard`, `btu-icon` and `btu-widget`; import every other element you use
+- [Rendering components from Java](https://ui.brightspot.com/docs/dari-elements.md): the generated `com.brightspot.ui.dari` classes
+
+## Components
+
+- [`<btu-action-bar>`](https://ui.brightspot.com/docs/components/ActionBar.md): A persistent container for primary, secondary, tertiary, and destructive actions within an interface, typically anchored to the bottom of a view
+- [`<btu-action-item>`](https://ui.brightspot.com/docs/components/ActionItem.md): An action item button for use within `btu-action-bar`
+- [`<btu-ai-sparkle>`](https://ui.brightspot.com/docs/components/AiSparkle.md): The animated AI-branding sparkle
+- [`<btu-avatar>`](https://ui.brightspot.com/docs/components/Avatar.md): An avatar component for displaying user profile images with fallback support
+- [`<btu-avatar-group>`](https://ui.brightspot.com/docs/components/AvatarGroup.md): A container component for grouping multiple avatars with consistent styling
+- [`<btu-badge>`](https://ui.brightspot.com/docs/components/Badge.md): A badge component for highlighting important information
+- [`<btu-banner>`](https://ui.brightspot.com/docs/components/Banner.md): A full-width container that pins a `<btu-message>` to the top of the CMS or a content edit page
+- [`<btu-button-group>`](https://ui.brightspot.com/docs/components/ButtonGroup.md): A semantic container for grouping related buttons together
+- [`<btu-card>`](https://ui.brightspot.com/docs/components/Card.md): A flexible content container for presenting and organizing information
+- [`<btu-checkbox>`](https://ui.brightspot.com/docs/components/Checkbox.md): A checkbox component for selecting one or more options from a set
+- [`<btu-circular-progress>`](https://ui.brightspot.com/docs/components/CircularProgress.md): A circular progress indicator for showing loading states or progress
+- [`<btu-copy-to-clipboard>`](https://ui.brightspot.com/docs/components/CopyToClipboard.md): A button component that copies text to the system clipboard
+- [`<btu-dropdown>`](https://ui.brightspot.com/docs/components/Dropdown.md): A dropdown component that renders a trigger button and manages a floating panel containing a `btu-dropdown-menu`
+- [`<btu-dropdown-item>`](https://ui.brightspot.com/docs/components/DropdownItem.md): A menu item component for use inside `btu-dropdown-menu`
+- [`<btu-dropdown-menu>`](https://ui.brightspot.com/docs/components/DropdownMenu.md): A menu container component that provides keyboard navigation and ARIA menu semantics
+- [`<btu-empty-state>`](https://ui.brightspot.com/docs/components/EmptyState.md): An empty state component for displaying placeholder content when no data is available
+- [`<btu-esca-avatar>`](https://ui.brightspot.com/docs/components/EscaAvatar.md): The animated avatar for the Esca AI assistant, driven entirely by its `state` attribute so the same element works wherever the assistant appears
+- [`<btu-icon>`](https://ui.brightspot.com/docs/components/Icon.md): An icon component for displaying Lucide icons
+- [`<btu-icon-button>`](https://ui.brightspot.com/docs/components/IconButton.md): Surfaces the different actions someone can perform in an interface where space is limited
+- [`<btu-linear-progress>`](https://ui.brightspot.com/docs/components/LinearProgress.md): A horizontal linear progress bar for showing task completion
+- [`<btu-message>`](https://ui.brightspot.com/docs/components/Message.md): A message for communicating high-visibility content that is not tied to the user's current task — alerts, breaking news, and persistent status
+- [`<btu-pagination>`](https://ui.brightspot.com/docs/components/Pagination.md): A pagination component for navigating through paged content
+- [`<btu-popover>`](https://ui.brightspot.com/docs/components/Popover.md): A popover component for displaying rich interactive content anchored to a trigger element
+- [`<btu-radio>`](https://ui.brightspot.com/docs/components/Radio.md): A single radio option, selectable from a set of mutually exclusive choices
+- [`<btu-radio-group>`](https://ui.brightspot.com/docs/components/RadioGroup.md): A container that groups `btu-radio` options into a single-select control
+- [`<btu-switch>`](https://ui.brightspot.com/docs/components/Switch.md): A toggle switch component for binary on/off states
+- [`<btu-tab>`](https://ui.brightspot.com/docs/components/Tab.md): An individual tab within a tab group
+- [`<btu-tabs>`](https://ui.brightspot.com/docs/components/Tabs.md): A container component for managing a group of tabs
+- [`<btu-upload>`](https://ui.brightspot.com/docs/components/Upload.md): A file upload component with drop zone and file list
+- [`<btu-upload-item>`](https://ui.brightspot.com/docs/components/UploadItem.md): Internal upload item sub-component for displaying individual file upload state
+- [`<btu-widget>`](https://ui.brightspot.com/docs/components/Widget.md): A widget component for displaying content with header, body, and footer sections
+
+## Tailwind classes
+
+Each link is a plugin source file; its header comment lists the classes.
+
+- [Button](https://cdn.jsdelivr.net/npm/@brightspot/ui@6.8.3-rc.1/dist/tailwind-plugin-button.ts): Buttons communicate actions that users can take such as submit a form, begin a new task, trigger a new UI element to appear or take a new or next step in some process
+- [Heading](https://cdn.jsdelivr.net/npm/@brightspot/ui@6.8.3-rc.1/dist/tailwind-plugin-heading.ts): Headings are a combination of font-size, line-height and weight
+- [Scroll Shadow](https://cdn.jsdelivr.net/npm/@brightspot/ui@6.8.3-rc.1/dist/tailwind-plugin-scroll-shadow.ts): This plugin adds shadows to the edges of a scrollable container when the content of the container overflows
+- [Icon](https://cdn.jsdelivr.net/npm/@brightspot/ui@6.8.3-rc.1/dist/tailwind-plugin-icon.ts): Lucide icons as classes, for example `before:btu-icon before:btu-icon-heart`, plus size and gradient modifiers
+
+## Optional
+
+- [All component pages in one file](https://ui.brightspot.com/llms-full.txt)
+- [Custom Elements Manifest](https://ui.brightspot.com/custom-elements.json): the machine-readable API of every element
+- [Changelog](https://ui.brightspot.com/CHANGELOG.md): what changed in each release
+- [Storybook](https://ui.brightspot.com/): interactive examples; needs JavaScript, so fetching it returns no content

package/dist/storybook/project.json

@@ -1 +1 @@
-{"generatedAt":1793392614358,"hasCustomBabel":false,"hasCustomWebpack":false,"hasStaticDirs":true,"hasStorybookEslint":true,"refCount":0,"knownPackages":{"testPackages":{"@storybook/addon-vitest":"10.2.12","@vitest/browser-playwright":"4.1.11","playwright":"1.58.2","vitest":"4.1.11"},"stylingPackages":{"tailwindcss":"^3.4.13","autoprefixer":"10.4.21"}},"hasRouterPackage":false,"packageManager":{"type":"yarn","agent":"yarn","nodeLinker":"undefined"},"preview":{"usesGlobals":true},"framework":{"name":"@storybook/web-components-vite","options":{}},"builder":"@storybook/builder-vite","renderer":"@storybook/web-components","portableStoriesFileCount":0,"applicationFileCount":6,"storybookVersion":"10.2.12","storybookVersionSpecifier":"10.2.12","language":"typescript","storybookPackages":{"@storybook/addon-themes":{"version":"10.2.12"},"@storybook/web-components-vite":{"version":"10.2.12"},"@wc-toolkit/storybook-helpers":{"version":"10.0.0"},"eslint-plugin-storybook":{"version":"10.0.7"},"storybook":{}},"addons":{"@storybook/addon-docs":{"version":"10.2.12"},"@storybook/addon-vitest":{"version":"10.2.12"}},"packageJsonType":"module"}
+{"generatedAt":1793991007946,"hasCustomBabel":false,"hasCustomWebpack":false,"hasStaticDirs":true,"hasStorybookEslint":true,"refCount":0,"knownPackages":{"testPackages":{"@storybook/addon-vitest":"10.2.12","@vitest/browser-playwright":"4.1.11","playwright":"1.58.2","vitest":"4.1.11"},"stylingPackages":{"tailwindcss":"^3.4.13","autoprefixer":"10.4.21"}},"hasRouterPackage":false,"packageManager":{"type":"yarn","agent":"yarn","nodeLinker":"undefined"},"preview":{"usesGlobals":true},"framework":{"name":"@storybook/web-components-vite","options":{}},"builder":"@storybook/builder-vite","renderer":"@storybook/web-components","portableStoriesFileCount":0,"applicationFileCount":6,"storybookVersion":"10.2.12","storybookVersionSpecifier":"10.2.12","language":"typescript","storybookPackages":{"@storybook/addon-themes":{"version":"10.2.12"},"@storybook/web-components-vite":{"version":"10.2.12"},"@wc-toolkit/storybook-helpers":{"version":"10.0.0"},"eslint-plugin-storybook":{"version":"10.0.7"},"storybook":{}},"addons":{"@storybook/addon-docs":{"version":"10.2.12"},"@storybook/addon-vitest":{"version":"10.2.12"}},"packageJsonType":"module"}

package/dist/storybook/robots.txt

@@ -0,0 +1,7 @@
+# Agent-readable docs: https://ui.brightspot.com/llms.txt
+
+User-agent: *
+Allow: /
+Content-Signal: search=yes, ai-input=yes, ai-train=yes
+
+Sitemap: https://ui.brightspot.com/sitemap.xml

package/dist/storybook/sb-addons/storybook-3/manager-bundle.js

@@ -1,3 +1,3 @@
 try{
-(()=>{var h=__STORYBOOK_API__,{ActiveTabs:_,Consumer:B,ManagerContext:C,Provider:g,RequestResponseError:T,Tag:b,addons:a,combineParameters:v,controlOrMetaKey:x,controlOrMetaSymbol:y,eventMatchesShortcut:A,eventToShortcut:E,experimental_MockUniversalStore:O,experimental_UniversalStore:P,experimental_getStatusStore:f,experimental_getTestProviderStore:k,experimental_requestResponse:R,experimental_useStatusStore:M,experimental_useTestProviderStore:D,experimental_useUniversalStore:N,internal_checklistStore:I,internal_fullStatusStore:H,internal_fullTestProviderStore:K,internal_universalChecklistStore:G,internal_universalStatusStore:U,internal_universalTestProviderStore:w,isMacLike:Y,isShortcutTaken:L,keyToSymbol:q,merge:V,mockChannel:j,optionOrAltSymbol:Q,shortcutMatchesShortcut:W,shortcutToAriaKeyshortcuts:z,shortcutToHumanString:J,types:X,useAddonState:Z,useArgTypes:$,useArgs:ee,useChannel:re,useGlobalTypes:te,useGlobals:oe,useParameter:ae,useSharedState:se,useStoryPrepared:ne,useStorybookApi:le,useStorybookState:ie}=__STORYBOOK_API__;var Fe=__STORYBOOK_THEMING__,{CacheProvider:me,ClassNames:Se,Global:he,ThemeProvider:_e,background:Be,color:Ce,convert:ge,create:o,createCache:Te,createGlobal:be,createReset:ve,css:xe,darken:ye,ensure:Ae,getPreferredColorScheme:Ee,ignoreSsrWarning:Oe,isPropValid:Pe,jsx:fe,keyframes:ke,lighten:Re,styled:Me,themes:De,tokens:Ne,typography:Ie,useTheme:He,withTheme:Ke}=__STORYBOOK_THEMING__;var s={brandTitle:"Brightspot UI",brandImage:"./brightspot-logo.svg",brandTarget:"_self"},n=o({base:"light",...s,colorPrimary:"#F0433E",colorSecondary:"#144CEB",appBg:"#FCFCFD",appContentBg:"#FFFFFF",appPreviewBg:"#FFFFFF",appBorderColor:"#EAECF0",appBorderRadius:6,textColor:"#101828",textInverseColor:"#FFFFFF",textMutedColor:"#667085",barTextColor:"#667085",barHoverColor:"#1D2939",barSelectedColor:"#144CEB",barBg:"#F9FAFB",inputBg:"#FFFFFF",inputBorder:"#D0D5DD",inputTextColor:"#101828",inputBorderRadius:4,fontBase:'"Noto Sans", "Helvetica Neue", Arial, sans-serif',fontCode:"monospace"}),l=o({base:"dark",...s,colorPrimary:"#FDA398",colorSecondary:"#235CEF",appBg:"#1E1F21",appContentBg:"#1E1F21",appPreviewBg:"#1E1F21",appBorderColor:"#3E3E40",appBorderRadius:6,textColor:"#FAFAFA",textInverseColor:"#1E1F21",textMutedColor:"#B9B7B9",barTextColor:"#B9B7B9",barHoverColor:"#F5F5F5",barSelectedColor:"#D1E0FF",barBg:"#2A2B2D",inputBg:"#1E1F21",inputBorder:"#464648",inputTextColor:"#FAFAFA",inputBorderRadius:4,fontBase:'"Noto Sans", "Helvetica Neue", Arial, sans-serif',fontCode:"monospace"});var i=window.matchMedia("(prefers-color-scheme: dark)"),p=()=>{a.setConfig({theme:i.matches?l:n})};p();i.addEventListener("change",p);})();
+(()=>{var B=__STORYBOOK_API__,{ActiveTabs:_,Consumer:g,ManagerContext:C,Provider:T,RequestResponseError:b,Tag:v,addons:a,combineParameters:x,controlOrMetaKey:y,controlOrMetaSymbol:A,eventMatchesShortcut:E,eventToShortcut:O,experimental_MockUniversalStore:P,experimental_UniversalStore:f,experimental_getStatusStore:k,experimental_getTestProviderStore:R,experimental_requestResponse:M,experimental_useStatusStore:D,experimental_useTestProviderStore:I,experimental_useUniversalStore:N,internal_checklistStore:H,internal_fullStatusStore:K,internal_fullTestProviderStore:U,internal_universalChecklistStore:w,internal_universalStatusStore:G,internal_universalTestProviderStore:L,isMacLike:Y,isShortcutTaken:q,keyToSymbol:V,merge:W,mockChannel:j,optionOrAltSymbol:Q,shortcutMatchesShortcut:$,shortcutToAriaKeyshortcuts:z,shortcutToHumanString:J,types:X,useAddonState:Z,useArgTypes:ee,useArgs:re,useChannel:te,useGlobalTypes:oe,useGlobals:ae,useParameter:se,useSharedState:ne,useStoryPrepared:ie,useStorybookApi:le,useStorybookState:ue}=__STORYBOOK_API__;var Fe=__STORYBOOK_THEMING__,{CacheProvider:Se,ClassNames:he,Global:Be,ThemeProvider:_e,background:ge,color:Ce,convert:Te,create:o,createCache:be,createGlobal:ve,createReset:xe,css:ye,darken:Ae,ensure:Ee,getPreferredColorScheme:Oe,ignoreSsrWarning:Pe,isPropValid:fe,jsx:ke,keyframes:Re,lighten:Me,styled:De,themes:Ie,tokens:Ne,typography:He,useTheme:Ke,withTheme:Ue}=__STORYBOOK_THEMING__;var s={brandTitle:"Brightspot UI",brandImage:"./brightspot-logo.svg",brandTarget:"_self"},n=o({base:"light",...s,colorPrimary:"#F0433E",colorSecondary:"#144CEB",appBg:"#FCFCFD",appContentBg:"#FFFFFF",appPreviewBg:"#FFFFFF",appBorderColor:"#EAECF0",appBorderRadius:6,textColor:"#101828",textInverseColor:"#FFFFFF",textMutedColor:"#667085",barTextColor:"#667085",barHoverColor:"#1D2939",barSelectedColor:"#144CEB",barBg:"#F9FAFB",inputBg:"#FFFFFF",inputBorder:"#D0D5DD",inputTextColor:"#101828",inputBorderRadius:4,fontBase:'"Noto Sans", "Helvetica Neue", Arial, sans-serif',fontCode:"monospace"}),i=o({base:"dark",...s,colorPrimary:"#FDA398",colorSecondary:"#235CEF",appBg:"#1E1F21",appContentBg:"#1E1F21",appPreviewBg:"#1E1F21",appBorderColor:"#3E3E40",appBorderRadius:6,textColor:"#FAFAFA",textInverseColor:"#1E1F21",textMutedColor:"#B9B7B9",barTextColor:"#B9B7B9",barHoverColor:"#F5F5F5",barSelectedColor:"#D1E0FF",barBg:"#2A2B2D",inputBg:"#1E1F21",inputBorder:"#464648",inputTextColor:"#FAFAFA",inputBorderRadius:4,fontBase:'"Noto Sans", "Helvetica Neue", Arial, sans-serif',fontCode:"monospace"});var l=window.matchMedia("(prefers-color-scheme: dark)"),u=()=>{a.setConfig({theme:l.matches?i:n})};u();l.addEventListener("change",u);var p=document.querySelector("title");new MutationObserver(()=>{document.title.endsWith(" \u22C5 Storybook")&&(document.title=document.title.replace(/ ⋅ Storybook$/," \u22C5 Brightspot UI"))}).observe(p,{childList:!0,characterData:!0,subtree:!0});})();
 }catch(e){ console.error("[Storybook] One of your manager-entries failed: " + import.meta.url, e); }

package/dist/storybook/sitemap.xml

@@ -0,0 +1,90 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url><loc>https://ui.brightspot.com/</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/welcome--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-action-bar--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-action-bar-action-item--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-ai-sparkle--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-avatar--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-avatar-group--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-badge--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-banner--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/css-plugins-button--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-button-group--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-card--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/effects-celebrate--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-checkbox--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-circular-progress--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/mixins-clipboard--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/design-system-colors--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/effects-combined-effects--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/mixins-component-states--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-copy-to-clipboard--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/utilities-debounce--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-dropdown--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-empty-state--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-esca-avatar--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/mixins-events--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/css-plugins-heading--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/effects-hue-ripple--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-icon--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-icon-button--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-linear-progress--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-message--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/mixins-onfind-mixin--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-pagination--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-popover--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-radio--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-radio-group--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/mixins-ready-mixin--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/mixins-roving-tabindex--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/utilities-rtc--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/css-plugins-scroll-shadow--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-switch--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-tabs--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-tabs-tab--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/utilities-throttle--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/mixins-tooltip--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-upload--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-upload-upload-item--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/components-widget--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/utilities-onfind--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/utilities-onremove--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/?path=/docs/utilities-onvisible--docs</loc></url>
+  <url><loc>https://ui.brightspot.com/llms.txt</loc></url>
+  <url><loc>https://ui.brightspot.com/llms-full.txt</loc></url>
+  <url><loc>https://ui.brightspot.com/README.md</loc></url>
+  <url><loc>https://ui.brightspot.com/CHANGELOG.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/dari-elements.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/ActionBar.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/ActionItem.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/AiSparkle.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Avatar.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/AvatarGroup.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Badge.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Banner.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/ButtonGroup.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Card.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Checkbox.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/CircularProgress.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/CopyToClipboard.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Dropdown.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/DropdownItem.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/DropdownMenu.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/EmptyState.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/EscaAvatar.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Icon.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/IconButton.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/LinearProgress.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Message.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Pagination.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Popover.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Radio.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/RadioGroup.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Switch.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Tab.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Tabs.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Upload.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/UploadItem.md</loc></url>
+  <url><loc>https://ui.brightspot.com/docs/components/Widget.md</loc></url>
+</urlset>

package/docs/components/ActionBar.md

@@ -1,78 +1,55 @@
-# `src/components/action-bar/ActionBar.ts`:
+# `<btu-action-bar>`
 
-## class: `ActionBar`, `btu-action-bar`
+A persistent container for primary, secondary, tertiary, and destructive actions
+within an interface, typically anchored to the bottom of a view.
 
-### Superclass
+Uses a two-zone layout: destructive actions on the left (start zone),
+main actions on the right (end zone). Both zones maintain their position
+even when the other zone is empty (BSP-18087).
 
-| Name         | Module | Package |
-| ------------ | ------ | ------- |
-| `LitElement` |        | lit     |
+**Positioning:** Uses `margin-top: auto` to push to bottom of flex/grid parents.
+In block layout parents, the bar sits after content (a console warning is emitted).
 
-### Mixins
+**Overflow:** When items don't fit, the least important overflow into a "More" dropdown.
+Items are auto-sorted by variant priority (tertiary → secondary → primary).
+With `compact`, compactable items progressively hide labels one-by-one before overflowing.
 
-| Name                  | Module                           | Package |
-| --------------------- | -------------------------------- | ------- |
-| `RovingTabindexMixin` | /src/util/RovingTabindexMixin.js |         |
-| `EventEmitterMixin`   | /src/util/EventEmitterMixin.js   |         |
-| `ReadyMixin`          | /src/util/ReadyMixin.js          |         |
+```js
+import '@brightspot/ui/components/action-bar/ActionBar.js'
+```
 
-### Fields
+Interactive examples: https://ui.brightspot.com/?path=/docs/components-action-bar--docs
 
-| Name                      | Privacy | Type        | Default     | Description                                                                                                                                                                                                     | Inherited From |
-| ------------------------- | ------- | ----------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
-| `position`                |         | `Position`  | `'bottom'`  | Bar position: 'top' or 'bottom' (default).                                                                                                                                                                      |                |
-| `sticky`                  |         | `boolean`   | `false`     | Enables CSS sticky positioning. When combined with position='top',&#xA;the bar sticks to the top of the scroll container. With position='bottom'&#xA;(default), it sticks to the bottom.                        |                |
-| `alignment`               |         | `Alignment` | `'default'` | Content alignment: 'default' (two-zone), 'start', 'center', 'end'.&#xA;Non-default alignments disable two-zone layout.                                                                                          |                |
-| `shadow`                  |         | `boolean`   | `false`     | Adds a box-shadow to the bar.                                                                                                                                                                                   |                |
-| `label`                   |         | `string`    | `''`        | Accessible label for the toolbar region.                                                                                                                                                                        |                |
-| `compact`                 |         | `boolean`   | `false`     | Enables progressive label compacting. When space shrinks, items marked&#xA;\`compactable\` (with icons) have their labels hidden one-by-one&#xA;from least to most important before items overflow into "More". |                |
-| `_initialClassesCaptured` | private | `boolean`   | `false`     |                                                                                                                                                                                                                 |                |
+## Attributes
 
-### Methods
+| Attribute | Property | Type | Default | Description |
+| --- | --- | --- | --- | --- |
+| `position` | `position` | `'top' \| 'bottom'` | `'bottom'` | Bar position: 'top' or 'bottom' (default). |
+| `sticky` | `sticky` | `boolean` | `false` | Enables CSS sticky positioning. When combined with position='top', the bar sticks to the top of the scroll container. With position='bottom' (default), it sticks to the bottom. |
+| `item-alignment` | `alignment` | `'default' \| 'start' \| 'center' \| 'end'` | `'default'` | Content alignment: 'default' (two-zone), 'start', 'center', 'end'. Non-default alignments disable two-zone layout. |
+| `shadow` | `shadow` | `boolean` | `false` | Adds a box-shadow to the bar. |
+| `label` | `label` | `string` | `''` | Accessible label for the toolbar region. |
+| `compact` | `compact` | `boolean` | `false` | Enables progressive label compacting. When space shrinks, items marked `compactable` (with icons) have their labels hidden one-by-one from least to most important before items overflow into "More". |
 
-| Name   | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return    | Inherited From    |
-| ------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | --------- | ----------------- |
-| `emit` |         | Dispatches a type-safe CustomEvent with standardized configuration.&#xA;&#xA;All events are configured with:&#xA;- bubbles: true (event propagates up the DOM tree)&#xA;- cancelable: false (event cannot be cancelled)&#xA;- composed: true (event crosses shadow DOM boundaries) | `type: K, detail: UnpackCustomEvent<CustomEventMap[K]>` | `boolean` | EventEmitterMixin |
+## Events
 
-### Events
+| Event | Detail | Description |
+| --- | --- | --- |
+| `btu-action-bar-ready` |  | Fired after first render and initialization |
+| `btu-action-item-click` | `{label: string}` | Fired when an action item is clicked (bubbles from btu-action-item) |
 
-| Name                    | Type                           | Description                                                         | Inherited From |
-| ----------------------- | ------------------------------ | ------------------------------------------------------------------- | -------------- |
-| `btu-action-bar-ready`  | `CustomEvent`                  | Fired after first render and initialization                         |                |
-| `btu-action-item-click` | `CustomEvent<{label: string}>` | Fired when an action item is clicked (bubbles from btu-action-item) |                |
+## Slots
 
-### Attributes
+| Slot | Description |
+| --- | --- |
+| (default) | One or more `btu-action-item` elements |
 
-| Name             | Field     | Inherited From |
-| ---------------- | --------- | -------------- |
-| `position`       | position  |                |
-| `sticky`         | sticky    |                |
-| `item-alignment` | alignment |                |
-| `shadow`         | shadow    |                |
-| `label`          | label     |                |
-| `compact`        | compact   |                |
+## CSS custom properties
 
-### CSS Properties
-
-| Name                        | Default | Description                          |
-| --------------------------- | ------- | ------------------------------------ |
-| `--action-bar-gap`          |         | Gap between items (default: 0.75rem) |
-| `--action-bar-padding`      |         | Bar padding (default: 1.5rem)        |
-| `--action-bar-background`   |         | Background color (default: white)    |
-| `--action-bar-border-color` |         | Border color (default: gray-200)     |
-| `--action-bar-z-index`      |         | Z-index (default: 100)               |
-
-### Slots
-
-| Name | Description                              |
-| ---- | ---------------------------------------- |
-|      | One or more \`btu-action-item\` elements |
-
-<hr/>
-
-## Exports
-
-| Kind                        | Name             | Declaration | Module                                 | Package |
-| --------------------------- | ---------------- | ----------- | -------------------------------------- | ------- |
-| `js`                        | `default`        | ActionBar   | src/components/action-bar/ActionBar.ts |         |
-| `custom-element-definition` | `btu-action-bar` | ActionBar   | src/components/action-bar/ActionBar.ts |         |
+| Property | Description |
+| --- | --- |
+| `--action-bar-gap` | Gap between items (default: 0.75rem) |
+| `--action-bar-padding` | Bar padding (default: 1.5rem) |
+| `--action-bar-background` | Background color (default: white) |
+| `--action-bar-border-color` | Border color (default: gray-200) |
+| `--action-bar-z-index` | Z-index (default: 100) |

package/docs/components/ActionItem.md

@@ -1,96 +1,50 @@
-# `src/components/action-bar/ActionItem.ts`:
-
-## class: `ActionItem`, `btu-action-item`
-
-### Superclass
-
-| Name         | Module | Package |
-| ------------ | ------ | ------- |
-| `LitElement` |        | lit     |
-
-### Mixins
-
-| Name                | Module                         | Package |
-| ------------------- | ------------------------------ | ------- |
-| `TooltipMixin`      | /src/util/TooltipMixin.js      |         |
-| `EventEmitterMixin` | /src/util/EventEmitterMixin.js |         |
-| `ReadyMixin`        | /src/util/ReadyMixin.js        |         |
-
-### Fields
-
-| Name               | Privacy | Type                                     | Default         | Description                                                                                                                                                                                                                                                                                               | Inherited From |
-| ------------------ | ------- | ---------------------------------------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
-| `label`            |         | `string`                                 | `''`            | Button label text.                                                                                                                                                                                                                                                                                        |                |
-| `variant`          |         | `ActionItemVariant`                      | `'secondary'`   | Visual variant: 'primary', 'secondary', 'tertiary', 'destructive'.                                                                                                                                                                                                                                        |                |
-| `symbol`           |         | `string`                                 | `''`            | Lucide icon symbol for the leading icon.                                                                                                                                                                                                                                                                  |                |
-| `iconOnly`         |         | `boolean`                                | `false`         | Show icon only, hiding the label. Tooltip activates automatically with the label text.                                                                                                                                                                                                                    |                |
-| `disabled`         |         | `boolean`                                | `false`         | Disables the action item. The button remains focusable for accessibility
but click events are suppressed.                                                                                                                                                                                             |                |
-| `loading`          |         | `boolean`                                | `false`         | Shows a loading spinner and prevents interaction.                                                                                                                                                                                                                                                         |                |
-| `zone`             |         | `'start' \| 'end' \| ''`                 | `''`            | Zone placement: 'start' or 'end'. Used by ActionBar for two-zone layout.
If unset, auto-detected from variant (destructive → start, others → end).                                                                                                                                                    |                |
-| `compactable`      |         | `boolean`                                | `false`         | Opt-in for progressive label compacting. When the parent bar has \`compact\`
enabled and space shrinks, compactable items with icons have their labels
hidden one-by-one (least important first) before overflowing.
Items without an icon ignore this attribute and go directly to overflow. |                |
-| `tooltip`          |         | `string`                                 | `''`            | Tooltip text content. Set to empty string to remove the tooltip.                                                                                                                                                                                                                                          | TooltipMixin   |
-| `tooltipPosition`  |         | `'top' \| 'bottom' \| 'left' \| 'right'` | `'top'`         | Position relative to the host element. Auto-flips when constrained by the viewport.                                                                                                                                                                                                                       | TooltipMixin   |
-| `tooltipDelay`     |         | `number`                                 | `300`           | Show delay in milliseconds (hover trigger only).                                                                                                                                                                                                                                                          | TooltipMixin   |
-| `tooltipOffset`    |         | `TooltipOffset \| null`                  | `null`          | Gap between host and tooltip (sm=4px, md=8px, lg=12px, xl=16px).                                                                                                                                                                                                                                          | TooltipMixin   |
-| `tooltipNoArrow`   |         | `boolean`                                | `false`         | Hide the arrow pseudo-element.                                                                                                                                                                                                                                                                            | TooltipMixin   |
-| `tooltipTrigger`   |         | `string`                                 | `'hover focus'` | Space-separated trigger types: 'hover', 'focus', 'click'.                                                                                                                                                                                                                                                 | TooltipMixin   |
-| `_onMouseLeave`    | private |                                          |                 |                                                                                                                                                                                                                                                                                                           | TooltipMixin   |
-| `_onFocusIn`       | private |                                          |                 |                                                                                                                                                                                                                                                                                                           | TooltipMixin   |
-| `_onFocusOut`      | private |                                          |                 |                                                                                                                                                                                                                                                                                                           | TooltipMixin   |
-| `_onClick`         | private |                                          |                 |                                                                                                                                                                                                                                                                                                           | TooltipMixin   |
-| `_onNativeToggle`  | private |                                          |                 |                                                                                                                                                                                                                                                                                                           | TooltipMixin   |
-| `_onKeyDown`       | private |                                          |                 |                                                                                                                                                                                                                                                                                                           | TooltipMixin   |
-| `_onDocumentClick` | private | `((e: MouseEvent) => void) \| null`      | `null`          |                                                                                                                                                                                                                                                                                                           | TooltipMixin   |
-
-### Methods
-
-| Name                  | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return                   | Inherited From    |
-| --------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ------------------------ | ----------------- |
-| `_relayTooltipAttrs`  | private |                                                                                                                                                                                                                                                                                    |                                                         | `void`                   |                   |
-| `_handleClick`        | private |                                                                                                                                                                                                                                                                                    |                                                         | `void`                   |                   |
-| `_getSpinnerColor`    | private |                                                                                                                                                                                                                                                                                    |                                                         | `string`                 |                   |
-| `_buildButtonClasses` | private |                                                                                                                                                                                                                                                                                    |                                                         | `string`                 |                   |
-| `_getButtonStyles`    | private |                                                                                                                                                                                                                                                                                    |                                                         | `Record<string, string>` |                   |
-| `emit`                |         | Dispatches a type-safe CustomEvent with standardized configuration.&#xA;&#xA;All events are configured with:&#xA;- bubbles: true (event propagates up the DOM tree)&#xA;- cancelable: false (event cannot be cancelled)&#xA;- composed: true (event crosses shadow DOM boundaries) | `type: K, detail: UnpackCustomEvent<CustomEventMap[K]>` | `boolean`                | EventEmitterMixin |
-
-### Events
-
-| Name                    | Type                           | Description                                                                | Inherited From |
-| ----------------------- | ------------------------------ | -------------------------------------------------------------------------- | -------------- |
-| `btu-action-item-click` | `CustomEvent<{label: string}>` | Fired when the action item is clicked (not fired when disabled or loading) |                |
-
-### Attributes
-
-| Name               | Field           | Inherited From |
-| ------------------ | --------------- | -------------- |
-| `label`            | label           |                |
-| `variant`          | variant         |                |
-| `symbol`           | symbol          |                |
-| `icon-only`        | iconOnly        |                |
-| `disabled`         | disabled        |                |
-| `loading`          | loading         |                |
-| `zone`             | zone            |                |
-| `compactable`      | compactable     |                |
-| `tooltip`          | tooltip         | TooltipMixin   |
-| `tooltip-position` | tooltipPosition | TooltipMixin   |
-| `tooltip-delay`    | tooltipDelay    | TooltipMixin   |
-| `tooltip-offset`   | tooltipOffset   | TooltipMixin   |
-| `tooltip-no-arrow` | tooltipNoArrow  | TooltipMixin   |
-| `tooltip-trigger`  | tooltipTrigger  | TooltipMixin   |
-
-### CSS Properties
-
-| Name                     | Default | Description                      |
-| ------------------------ | ------- | -------------------------------- |
-| `--button-color`         |         | Override button background color |
-| `--button-text-color`    |         | Override button text color       |
-| `--button-border-radius` |         | Override button border radius    |
-
-<hr/>
-
-## Exports
-
-| Kind                        | Name              | Declaration | Module                                  | Package |
-| --------------------------- | ----------------- | ----------- | --------------------------------------- | ------- |
-| `js`                        | `default`         | ActionItem  | src/components/action-bar/ActionItem.ts |         |
-| `custom-element-definition` | `btu-action-item` | ActionItem  | src/components/action-bar/ActionItem.ts |         |
+# `<btu-action-item>`
+
+An action item button for use within `btu-action-bar`.
+
+Renders a styled button using existing `btu-button-*` classes. Supports
+primary, secondary, tertiary, and destructive variants. When `iconOnly`
+is set, the label is hidden and a tooltip is shown instead.
+
+**Button styling:** Set `--button-*` CSS custom properties on `<btu-action-item>`
+or a parent element to customize via CSS inheritance. See
+`tailwind-plugin-button.ts` for available props.
+
+```js
+import '@brightspot/ui/components/action-bar/ActionItem.js'
+```
+
+Interactive examples: https://ui.brightspot.com/?path=/docs/components-action-bar-action-item--docs
+
+## Attributes
+
+| Attribute | Property | Type | Default | Description |
+| --- | --- | --- | --- | --- |
+| `label` | `label` | `string` | `''` | Button label text. |
+| `variant` | `variant` | `'primary' \| 'secondary' \| 'tertiary' \| 'destructive'` | `'secondary'` | Visual variant: 'primary', 'secondary', 'tertiary', 'destructive'. |
+| `symbol` | `symbol` | `string` | `''` | Lucide icon symbol for the leading icon. |
+| `icon-only` | `iconOnly` | `boolean` | `false` | Show icon only, hiding the label. Tooltip activates automatically with the label text. |
+| `disabled` | `disabled` | `boolean` | `false` | Disables the action item. The button remains focusable for accessibility but click events are suppressed. |
+| `loading` | `loading` | `boolean` | `false` | Shows a loading spinner and prevents interaction. |
+| `zone` | `zone` | `'start' \| 'end' \| ''` | `''` | Zone placement: 'start' or 'end'. Used by ActionBar for two-zone layout. If unset, auto-detected from variant (destructive → start, others → end). |
+| `compactable` | `compactable` | `boolean` | `false` | Opt-in for progressive label compacting. When the parent bar has `compact` enabled and space shrinks, compactable items with icons have their labels hidden one-by-one (least important first) before overflowing. Items without an icon ignore this attribute and go directly to overflow. |
+| `tooltip` | `tooltip` | `string` | `''` | Tooltip text content. Set to empty string to remove the tooltip. |
+| `tooltip-position` | `tooltipPosition` | `'top' \| 'bottom' \| 'left' \| 'right'` | `'top'` | Position relative to the host element. Auto-flips when constrained by the viewport. |
+| `tooltip-delay` | `tooltipDelay` | `number` | `300` | Show delay in milliseconds (hover trigger only). |
+| `tooltip-offset` | `tooltipOffset` | `'sm' \| 'md' \| 'lg' \| 'xl' \| null` | `null` | Gap between host and tooltip (sm=4px, md=8px, lg=12px, xl=16px). |
+| `tooltip-no-arrow` | `tooltipNoArrow` | `boolean` | `false` | Hide the arrow pseudo-element. |
+| `tooltip-trigger` | `tooltipTrigger` | `string` | `'hover focus'` | Space-separated trigger types: 'hover', 'focus', 'click'. |
+
+## Events
+
+| Event | Detail | Description |
+| --- | --- | --- |
+| `btu-action-item-click` | `{label: string}` | Fired when the action item is clicked (not fired when disabled or loading) |
+
+## CSS custom properties
+
+| Property | Description |
+| --- | --- |
+| `--button-color` | Override button background color |
+| `--button-text-color` | Override button text color |
+| `--button-border-radius` | Override button border radius |