npm - @brightspot/ui - Versions diffs - 5.0.3-toggleable-fix.0 → 5.1.0 - Mend

@brightspot/ui 5.0.3-toggleable-fix.0 → 5.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (208) hide show

package/dist/util/onFind.js CHANGED Viewed

@@ -204,6 +204,18 @@ function onFind(rootOrSelectors, selectorsOrFn, fn) {
     const callback = new Callback(root, selectors, fn);
     callback.trigger();
     getState().callbacks.push(callback);
+    // Returns a disposer so callers with a lifecycle (e.g. web components) can
+    // remove their callback on teardown — otherwise it lives for the page and
+    // keeps `root` reachable. Re-reads state and guards the index so it is safe
+    // to call multiple times. The disposer only ever runs from a caller's own
+    // teardown (synchronous), never while `triggerCallbacks` is iterating the
+    // array (async via the observer / rAF), so the splice cannot corrupt a loop.
+    return () => {
+        const { callbacks } = getState();
+        const i = callbacks.indexOf(callback);
+        if (i !== -1)
+            callbacks.splice(i, 1);
+    };
 }
 onFind.triggerCallbacks = triggerCallbacks;
 onFind.pause = () => {

package/dist/util/onFind.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"onFind.js","sourceRoot":"","sources":["../../src/util/onFind.ts"],"names":[],"mappings":"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~~AAMD~~,SAAS,MAAM,CACb,eAAuC,EACvC,aAA8C,EAC9C,EAAwB;IAExB,iBAAiB,EAAE,CAAA;IAEnB,IAAI,IAAgB,CAAA;IACpB,IAAI,SAAoB,CAAA;IAExB,IAAI,OAAO,EAAE,KAAK,WAAW,EAAE,CAAC;QAC9B,IAAI,GAAG,eAA0B,CAAA;QACjC,SAAS,GAAG,aAA0B,CAAA;IACxC,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,QAAQ,CAAA;QACf,SAAS,GAAG,eAA4B,CAAA;QACxC,EAAE,GAAG,aAAoC,CAAA;IAC3C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,~~CAAC~~,CAAA;~~IAClD~~,QAAQ,CAAC,OAAO,EAAE,CAAA;IAClB,QAAQ,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,~~QAA6B~~,CAAC,CAAA;~~AAC1D~~,CAAC;AAED,MAAM,CAAC,gBAAgB,GAAG,gBAAgB,CAAA;AAE1C,MAAM,CAAC,KAAK,GAAG,GAAG,EAAE;IAClB,QAAQ,EAAE,CAAC,aAAa,GAAG,IAAI,CAAA;AACjC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE;IACnB,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAA;IACxB,KAAK,CAAC,aAAa,GAAG,KAAK,CAAA;IAE3B,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,KAAK,CAAC,eAAe,GAAG,KAAK,CAAA;QAC7B,UAAU,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAA;IACnC,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,SAAmB,EAAE,EAAE;IACzC,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE,CAAA;IAChC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACnB,CAAC;IACH,CAAC;AACH,CAAC,CAAA;AAED,eAAe,MAAM,CAAA"}
1	+ {"version":3,"file":"onFind.js","sourceRoot":"","sources":["../../src/util/onFind.ts"],"names":[],"mappings":"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"}

package/docs/components/ButtonGroup.md CHANGED Viewed

@@ -15,6 +15,7 @@
 | `RovingTabindexMixin`  | /src/util/RovingTabindexMixin.js  |         |
 | `ComponentStatesMixin` | /src/util/ComponentStatesMixin.js |         |
 | `EventEmitterMixin`    | /src/util/EventEmitterMixin.js    |         |
+| `OnFindMixin`          | /src/util/OnFindMixin.js          |         |
 | `ReadyMixin`           | /src/util/ReadyMixin.js           |         |
 ### Static Fields
@@ -35,12 +36,15 @@
 | `selection`   |         | `'none' \| 'single' \| 'multiple'` | `'none'`       | Enables toggle/selection behavior.&#xA;\`single\` allows one active button; \`multiple\` allows many.                                                               |                |
 | `value`       |         | `string`                           | `''`           | Reflects the currently selected button value(s).&#xA;For \`single\`, the value of the active button.&#xA;For \`multiple\`, a comma-delimited list of active values. |                |
 | `name`        |         | `string`                           | `''`           | When set, creates hidden input(s) for native form participation.                                                                                                    |                |
+| `#stopFns`    | private | `Array<() => void>`                | `[]`           |                                                                                                                                                                     | OnFindMixin    |
 ### Methods
-| 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 |
+| 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 |
+| `onFindRegistration` |         |                                                                                                                                                                                                                                                                                    |                                                         | `OnFindRegistration \| OnFindRegistration[] \| null` | OnFindMixin       |
+| `#armFind`           | private |                                                                                                                                                                                                                                                                                    |                                                         |                                                      | OnFindMixin       |
 ### Events
@@ -65,21 +69,24 @@
 ### CSS Properties
-| Name                               | Default | Description                                                             |
-| ---------------------------------- | ------- | ----------------------------------------------------------------------- |
-| `--button-group-gap`               |         | Space between buttons when variant="spaced" (default: spacing.sm)       |
-| `--button-group-border-radius`     |         | Corner radius of outer edges when variant="connected" (default: 0.5rem) |
-| `--button-group-border-color`      |         | Internal divider color between connected buttons (default: gray-300)    |
-| `--button-group-selection-bg`      |         | Background of a toggled/selected child (default: primary-50)            |
-| `--button-group-selection-color`   |         | Text/icon color of a toggled/selected child (default: primary-700)      |
-| `--button-group-shimmer-highlight` |         | Highlight color of the selection shimmer effect (default: primary-200)  |
+| Name                               | Default | Description                                                                                                                                                                                                                               |
+| ---------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--button-group-gap`               |         | Space between buttons when variant="spaced" (default: spacing.sm)                                                                                                                                                                         |
+| `--button-group-border-radius`     |         | Corner radius of outer edges when variant="connected" (default: 0.5rem)                                                                                                                                                                   |
+| `--button-group-border-color`      |         | Internal divider color between connected buttons (default: gray-300)                                                                                                                                                                      |
+| `--button-group-selection-bg`      |         | Background of a toggled/selected child (default: child's --button-tint-subtle)                                                                                                                                                            |
+| `--button-group-selection-color`   |         | Text/icon color of a toggled/selected child (default: child's --button-tint-strong)                                                                                                                                                       |
+| `--button-group-shimmer-highlight` |         | Highlight color of the selection shimmer effect (default: child's --button-tint-highlight) Reads the following CSS custom properties from each child button (set by the button plugin per color variant — see tailwind-plugin-button.ts): |
+| `--button-tint-subtle`             |         | Subtle tint of the child button's color family (read-only here)                                                                                                                                                                           |
+| `--button-tint-strong`             |         | Strong tint of the child button's color family (read-only here)                                                                                                                                                                           |
+| `--button-tint-highlight`          |         | Highlight tint of the child button's color family (read-only here)                                                                                                                                                                        |
 ### Slots
-| Name  | Description                                                                                    |
-| ----- | ---------------------------------------------------------------------------------------------- |
-|       | One or more btu-button or btu-icon-button elements to display in the group                     |
-| `end` | Pushes the child to the end of the group via auto-margin (vertical: bottom, horizontal: right) |
+| Name  | Description                                                                                                                                                                                                                                                                                                          |
+| ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+|       | One or more \`\<button class="btu-button …">\` or \`\<btu-icon-button>\` elements to display in the group. The \`connected\` variant rounds the outer corners on the real \`\<button>\`, so anchors styled as \`.btu-button\` slotted directly will not get rounded corners. Use \`\<button>\` for grouped controls. |
+| `end` | Pushes the child to the end of the group via auto-margin (vertical: bottom, horizontal: right)                                                                                                                                                                                                                       |
 <hr/>

package/docs/components/Card.md ADDED Viewed

@@ -0,0 +1,83 @@
+# `src/components/card/Card.ts`:
+## class: `Card`, `btu-card`
+### Superclass
+| Name         | Module | Package |
+| ------------ | ------ | ------- |
+| `LitElement` |        | lit     |
+### Mixins
+| Name                | Module                         | Package |
+| ------------------- | ------------------------------ | ------- |
+| `EventEmitterMixin` | /src/util/EventEmitterMixin.js |         |
+| `OnFindMixin`       | /src/util/OnFindMixin.js       |         |
+| `ReadyMixin`        | /src/util/ReadyMixin.js        |         |
+### Fields
+| Name           | Privacy | Type                  | Default | Description                                                                                                                                         | Inherited From |
+| -------------- | ------- | --------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
+| `heading`      |         | `string`              | `''`    | Heading text displayed on the card.                                                                                                                 |                |
+| `headingLevel` |         | `number`              | `2`     | Heading level (1-6) for the card heading element. Drives the semantic h1–h6 tag.&#xA;Invalid values log a warning and fall back to the default (2). |                |
+| `description`  |         | `string \| undefined` |         | Supporting body text. Truncated to 3 lines via CSS.                                                                                                 |                |
+| `compact`      |         | `boolean`             | `false` | Renders the card as a compact quick-start tile.&#xA;Badge, image, fields, and secondary-action children are ignored in this case.                   |                |
+| `disabled`     |         | `boolean`             | `false` | Whether the card is disabled.                                                                                                                       |                |
+| `href`         |         | `string \| undefined` |         | Navigation URL for the entire card surface.&#xA;When set, the card renders as a link.                                                               |                |
+| `#stopFns`     | private | `Array<() => void>`   | `[]`    |                                                                                                                                                     | OnFindMixin    |
+### Methods
+| 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 |
+| `onFindRegistration` |         |                                                                                                                                                                                                                                                                                    |                                                         | `OnFindRegistration \| OnFindRegistration[] \| null` | OnFindMixin       |
+| `#armFind`           | private |                                                                                                                                                                                                                                                                                    |                                                         |                                                      | OnFindMixin       |
+### Events
+| Name             | Type          | Description                                 | Inherited From |
+| ---------------- | ------------- | ------------------------------------------- | -------------- |
+| `btu-card-ready` | `CustomEvent` | Fired after first render and initialization |                |
+### Attributes
+| Name            | Field        | Inherited From |
+| --------------- | ------------ | -------------- |
+| `heading`       | heading      |                |
+| `heading-level` | headingLevel |                |
+| `description`   | description  |                |
+| `compact`       | compact      |                |
+| `disabled`      | disabled     |                |
+| `href`          | href         |                |
+### CSS Properties
+| Name                     | Default | Description                                                                                           |
+| ------------------------ | ------- | ----------------------------------------------------------------------------------------------------- |
+| `--card-min-width`       |         | Minimum width of the card (default: 160px)                                                            |
+| `--card-background`      |         | Background color (default: var(--btu-theme-white))                                                    |
+| `--card-border`          |         | Border style (default: 1px solid gray-200)                                                            |
+| `--card-radius`          |         | Corner rounding (default: 8px)                                                                        |
+| `--card-img-ratio`       |         | Fixed aspect ratio for the thumbnail when an \`\<img>\` child is present (default: 16 / 9)            |
+| `--card-img-fit`         |         | Object-fit mode for the \`\<img>\` child thumbnail (default: contain)                                 |
+| `--card-icon-background` |         | Background color behind the composed icon (compact card and media-image fallback) (default: gray-100) |
+### Slots
+| Name               | Description                                                                     |
+| ------------------ | ------------------------------------------------------------------------------- |
+| `action`           | Intended for a single action in the top-right corner of the card.               |
+| `secondary-action` | Intended for a single action next to the title.                                 |
+| `fields`           | Intended for additional metadata fields displayed below the title & description |
+<hr/>
+## Exports
+| Kind                        | Name       | Declaration | Module                      | Package |
+| --------------------------- | ---------- | ----------- | --------------------------- | ------- |
+| `js`                        | `default`  | Card        | src/components/card/Card.ts |         |
+| `custom-element-definition` | `btu-card` | Card        | src/components/card/Card.ts |         |

package/docs/components/EmptyState.md CHANGED Viewed

@@ -13,6 +13,7 @@
 | Name                | Module                         | Package |
 | ------------------- | ------------------------------ | ------- |
 | `EventEmitterMixin` | /src/util/EventEmitterMixin.js |         |
+| `OnFindMixin`       | /src/util/OnFindMixin.js       |         |
 | `ReadyMixin`        | /src/util/ReadyMixin.js        |         |
 ### Fields
@@ -24,15 +25,18 @@
 | `size`           |         | `'sm' \| 'md' \| 'lg'` | `'md'`  | Size variant of the empty state. Affects spacing, description text, graphic size,&#xA;and — when \`heading-level\` is unset — the default heading level (sm→5, md→4, lg→3).                                                                                                        |                |
 | `headingLevel`   |         | `number \| undefined`  |         | Heading level (1-6). When set to a valid integer 1-6, overrides the size-based&#xA;default and drives both the semantic h1-h6 tag and the visual heading size&#xA;(btu-heading-1 through btu-heading-6). Invalid values log a warning and fall&#xA;back to the size-based default. |                |
 | `initialClasses` | private | `string[]`             | `[]`    |                                                                                                                                                                                                                                                                                    |                |
+| `#stopFns`       | private | `Array<() => void>`    | `[]`    |                                                                                                                                                                                                                                                                                    | OnFindMixin    |
 ### Methods
-| Name                  | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return                     | Inherited From    |
-| --------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | -------------------------- | ----------------- |
-| `syncGraphicIconSize` | private |                                                                                                                                                                                                                                                                                    |                                                         | `void`                     |                   |
-| `resolveHeadingLevel` | private |                                                                                                                                                                                                                                                                                    |                                                         | `HeadingLevel`             |                   |
-| `renderHeading`       | private |                                                                                                                                                                                                                                                                                    | `level: HeadingLevel, className: string`                | `TemplateResult \| 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 |
+| Name                  | Privacy | Description                                                                                                                                                                                                                                                                        | Parameters                                              | Return                                               | Inherited From    |
+| --------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ---------------------------------------------------- | ----------------- |
+| `syncGraphicIconSize` | private |                                                                                                                                                                                                                                                                                    |                                                         | `void`                                               |                   |
+| `resolveHeadingLevel` | private |                                                                                                                                                                                                                                                                                    |                                                         | `HeadingLevel`                                       |                   |
+| `renderHeading`       | private |                                                                                                                                                                                                                                                                                    | `level: HeadingLevel, className: string`                | `TemplateResult \| 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 |
+| `onFindRegistration`  |         |                                                                                                                                                                                                                                                                                    |                                                         | `OnFindRegistration \| OnFindRegistration[] \| null` | OnFindMixin       |
+| `#armFind`            | private |                                                                                                                                                                                                                                                                                    |                                                         |                                                      | OnFindMixin       |
 ### Events

package/docs/components/README.md CHANGED Viewed

@@ -10,6 +10,7 @@ This directory contains auto-generated API documentation for all Brightspot UI w
 - [`<btu-avatar-group>` - AvatarGroup](AvatarGroup.md)
 - [`<btu-badge>` - Badge](Badge.md)
 - [`<btu-button-group>` - ButtonGroup](ButtonGroup.md)
+- [`<btu-card>` - Card](Card.md)
 - [`<btu-checkbox>` - Checkbox](Checkbox.md)
 - [`<btu-circular-progress>` - CircularProgress](CircularProgress.md)
 - [`<btu-copy-to-clipboard>` - CopyToClipboard](CopyToClipboard.md)

package/docs/components/Widget.md CHANGED Viewed

@@ -13,6 +13,7 @@
 | Name                | Module                         | Package |
 | ------------------- | ------------------------------ | ------- |
 | `EventEmitterMixin` | /src/util/EventEmitterMixin.js |         |
+| `OnFindMixin`       | /src/util/OnFindMixin.js       |         |
 | `ReadyMixin`        | /src/util/ReadyMixin.js        |         |
 ### Static Fields
@@ -23,23 +24,26 @@
 ### Fields
-| Name                 | Privacy | Type      | Default                                                                                                                                                                                                     | Description                                                                                                                          | Inherited From |
-| -------------------- | ------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -------------- |
-| `_internals`         | private |           |                                                                                                                                                                                                             |                                                                                                                                      |                |
-| `heading`            |         | `string`  | `''`                                                                                                                                                                                                        | Heading text displayed in the header.                                                                                                |                |
-| `collapsible`        |         | `boolean` | `false`                                                                                                                                                                                                     | Whether the widget can be collapsed/expanded.&#xA;When true, a chevron toggle button appears in the header.                          |                |
-| `collapsed`          |         | `boolean` | `false`                                                                                                                                                                                                     | Whether the widget is currently collapsed.&#xA;When true, body and footer are hidden. Implies collapsible.                           |                |
-| `fullscreenable`     |         | `boolean` | `false`                                                                                                                                                                                                     | Whether the widget can enter fullscreen mode.&#xA;When true, a fullscreen toggle button appears in the header.                       |                |
-| `_isFullscreen`      | private | `boolean` | `false`                                                                                                                                                                                                     |                                                                                                                                      |                |
-| `_collapseTooltip`   | private |           | `new TooltipController(this, { target: 'button[data-tooltip="collapse"]', text: () => (this.collapsed ? 'Expand' : 'Collapse'), position: 'bottom', noArrow: true, offset: 'sm', })`                        |                                                                                                                                      |                |
-| `_fullscreenTooltip` | private |           | `new TooltipController(this, { target: 'button[data-tooltip="fullscreen"]', text: () => (this._isFullscreen ? 'Exit fullscreen' : 'Enter fullscreen'), position: 'bottom', noArrow: true, offset: 'sm', })` |                                                                                                                                      |                |
-| `isFullscreen`       |         | `boolean` |                                                                                                                                                                                                             | Whether the widget is currently in fullscreen mode (read-only).&#xA;Use \`btu-widget-fullscreen-changed\` event to react to changes. |                |
+| Name                 | Privacy | Type                | Default                                                                                                                                                                                                     | Description                                                                                                                          | Inherited From |
+| -------------------- | ------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -------------- |
+| `_internals`         | private |                     |                                                                                                                                                                                                             |                                                                                                                                      |                |
+| `heading`            |         | `string`            | `''`                                                                                                                                                                                                        | Heading text displayed in the header.                                                                                                |                |
+| `collapsible`        |         | `boolean`           | `false`                                                                                                                                                                                                     | Whether the widget can be collapsed/expanded.&#xA;When true, a chevron toggle button appears in the header.                          |                |
+| `collapsed`          |         | `boolean`           | `false`                                                                                                                                                                                                     | Whether the widget is currently collapsed.&#xA;When true, body and footer are hidden. Implies collapsible.                           |                |
+| `fullscreenable`     |         | `boolean`           | `false`                                                                                                                                                                                                     | Whether the widget can enter fullscreen mode.&#xA;When true, a fullscreen toggle button appears in the header.                       |                |
+| `_isFullscreen`      | private | `boolean`           | `false`                                                                                                                                                                                                     |                                                                                                                                      |                |
+| `_collapseTooltip`   | private |                     | `new TooltipController(this, { target: 'button[data-tooltip="collapse"]', text: () => (this.collapsed ? 'Expand' : 'Collapse'), position: 'bottom', noArrow: true, offset: 'sm', })`                        |                                                                                                                                      |                |
+| `_fullscreenTooltip` | private |                     | `new TooltipController(this, { target: 'button[data-tooltip="fullscreen"]', text: () => (this._isFullscreen ? 'Exit fullscreen' : 'Enter fullscreen'), position: 'bottom', noArrow: true, offset: 'sm', })` |                                                                                                                                      |                |
+| `isFullscreen`       |         | `boolean`           |                                                                                                                                                                                                             | Whether the widget is currently in fullscreen mode (read-only).&#xA;Use \`btu-widget-fullscreen-changed\` event to react to changes. |                |
+| `#stopFns`           | private | `Array<() => void>` | `[]`                                                                                                                                                                                                        |                                                                                                                                      | OnFindMixin    |
 ### Methods
-| 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 |
+| 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 |
+| `onFindRegistration` |         |                                                                                                                                                                                                                                                                                    |                                                         | `OnFindRegistration \| OnFindRegistration[] \| null` | OnFindMixin       |
+| `#armFind`           | private |                                                                                                                                                                                                                                                                                    |                                                         |                                                      | OnFindMixin       |
 ### Events

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@brightspot/ui",
-  "version": "5.0.3-toggleable-fix.0",
+  "version": "5.1.0",
   "type": "module",
   "license": "UNLICENSED",
   "description": "A UI library for building Brightspot CMS components.",
@@ -25,6 +25,7 @@
     "storybook": "yarn cem && storybook dev -p 6006",
     "build-storybook": "yarn cem && storybook build -o ./dist/storybook",
     "test:storybook": "vitest --project=storybook",
+    "test:css-bloat": "vitest run --project=css-bloat",
     "check:conventions": "yarn cem && node scripts/check-conventions-all.mjs",
     "check:conventions:fast": "node scripts/check-conventions.mjs",
     "prepare": "husky && (cd src/legacy/tool-ui && yarn install)",
@@ -40,7 +41,6 @@
     "@storybook/addon-themes": "10.2.12",
     "@storybook/addon-vitest": "10.2.12",
     "@storybook/web-components-vite": "10.2.12",
-    "@tailwindcss/container-queries": "^0.1.1",
     "@types/node": "^24.10.0",
     "@types/postcss-import": "^14.0.3",
     "@types/uuid": "^8.3.0",
@@ -76,6 +76,7 @@
     "webpack-merge": "^5.8.0"
   },
   "dependencies": {
+    "@tailwindcss/container-queries": "^0.1.1",
     "broadcast-channel": "^4.13.0",
     "loglevel": "^1.8.0",
     "lucide-static": "0.508.0",
@@ -114,6 +115,6 @@
       "node scripts/generate-docs.mjs",
       "git add docs/components/"
     ],
-    "*": "yarn format"
+    "*": "prettier --write --ignore-unknown"
   }
 }

package/src/legacy/tool-ui/src/AIInline.css CHANGED Viewed

@@ -43,7 +43,7 @@
     @apply m-0 p-0;
     > button {
-      @apply flex w-full cursor-pointer items-center gap-1 rounded px-3 py-2 text-start text-sm text-gray-900 hover:bg-gray-100;
+      @apply flex w-full cursor-pointer items-center gap-1 px-3 py-2 text-start text-sm text-gray-900 hover:bg-gray-100;
     }
   }
 }
@@ -78,7 +78,7 @@
   > button {
     all: unset;
-    @apply box-border block w-full cursor-pointer text-start;
+    @apply box-border blokk w-full cursor-pointer text-start;
     &:disabled,
     &.is-disabled {

package/src/legacy/tool-ui/src/Admin.css CHANGED Viewed

@@ -188,7 +188,7 @@
   }
   .Admin-nav {
-    @apply overflow-auto border-r border-r-gray-200 [grid-area:nav];
+    @apply overflow-auto border-e border-e-gray-200 [grid-area:nav];
   }
   .Admin-main {
@@ -206,7 +206,7 @@
       @apply min-w-[--miller-columns-w] grow overflow-auto [grid-auto-rows:max-content];
       &:not(:first-child) {
-        @apply border-l border-solid border-gray-100;
+        @apply border-s border-solid border-gray-100;
       }
       h1.Widget-title {

package/src/legacy/tool-ui/src/Base.css CHANGED Viewed

@@ -74,7 +74,7 @@ textarea,
 form {
   &.is-submitting {
     button.is-clicked {
-      @apply btu-button-disabled before:btu-loader before:block before:size-[1.2rem];
+      @apply btu-button-disabled before:btu-loader before:blokk before:size-[1.2rem];
     }
   }
 }

package/src/legacy/tool-ui/src/BulkUpload.css CHANGED Viewed

@@ -32,7 +32,7 @@
   }
   .loaded & {
-    @apply block;
+    @apply blokk;
   }
   .loading & {

package/src/legacy/tool-ui/src/CIGCluster.css CHANGED Viewed

@@ -1,5 +1,5 @@
 btu-cig-cluster {
-  @apply block flex-grow basis-full contain-layout contain-style;
+  @apply blokk flex-grow basis-full contain-layout contain-style;
 }
 btu-cig-cluster:state(btu-error) {

package/src/legacy/tool-ui/src/Card.css CHANGED Viewed

@@ -11,7 +11,7 @@
 }
 .Card-media img {
-  @apply block h-auto w-full;
+  @apply blokk h-auto w-full;
 }
 /* Supply a max size because in some instances the image is not constrained by a wrapping element. */

package/src/legacy/tool-ui/src/CodeMirror.css CHANGED Viewed

@@ -20,7 +20,7 @@
 }
 .CodeMirror-gutters {
-  @apply border-r-gray-300 bg-gray-50;
+  @apply border-e-gray-300 bg-gray-50;
 }
 .CodeMirror-linenumber {
@@ -36,11 +36,11 @@
 }
 .CodeMirror-cursor {
-  @apply border-l-[2px] border-l-primary-600;
+  @apply border-s-[2px] border-s-primary-600;
 }
 .CodeMirror div.CodeMirror-secondarycursor {
-  @apply border-l-gray-200;
+  @apply border-s-gray-200;
 }
 .cm-fat-cursor .CodeMirror-cursor {
@@ -56,7 +56,7 @@
 }
 .CodeMirror-ruler {
-  @apply border-l-gray-200;
+  @apply border-s-gray-200;
 }
 .cm-s-default .cm-header {

package/src/legacy/tool-ui/src/ColorInputSpectrum.css CHANGED Viewed

@@ -29,7 +29,7 @@
 }
 .sp-preview-inner {
-  @apply absolute bottom-0 left-0 right-0 top-0 block h-5 w-5 rounded-full;
+  @apply absolute bottom-0 left-0 right-0 top-0 blokk h-5 w-5 rounded-full;
 }
 .sp-preview:not([data-placeholder^='#']) {
@@ -117,7 +117,7 @@
 }
 .sp-palette .sp-thumb-inner {
-  @apply block h-full w-full overflow-hidden rounded-full;
+  @apply blokk h-full w-full overflow-hidden rounded-full;
 }
 .sp-button-container {

package/src/legacy/tool-ui/src/ComboInput.css CHANGED Viewed

@@ -78,7 +78,7 @@
         :not([data-create], [data-sublist])
       ) {
       .ComboInput-check {
-        @apply block scale-50 opacity-0 transition-[opacity_scale] duration-250 [transition-timing-function:theme(transitionTimingFunction[spring-stiff])] before:btu-icon before:btu-icon-check before:text-inherit;
+        @apply blokk scale-50 opacity-0 transition-[opacity_scale] duration-250 [transition-timing-function:theme(transitionTimingFunction[spring-stiff])] before:btu-icon before:btu-icon-check before:text-inherit;
       }
       &[aria-selected='true'] {
@@ -153,7 +153,7 @@ select {
 /***** "Create New" Options *****/
 /********************************/
 .ComboInput-option > a[data-create='true'] {
-  @apply btu-heading-6 block px-4 py-2 no-underline before:btu-icon before:btu-icon-plus before:me-2;
+  @apply btu-heading-6 blokk px-4 py-2 no-underline before:btu-icon before:btu-icon-plus before:me-2;
 }
 .ComboInput-option[data-create='true'],
@@ -195,7 +195,7 @@ select {
 .ComboInput-option-favorite:not(.is-unstarred)
   .ComboInput-option-favorite-icon {
-  @apply block size-4 bg-primary-800 [clip-path:theme(shape.starFilled)];
+  @apply blokk size-4 bg-primary-800 [clip-path:theme(shape.starFilled)];
 }
 /*****************************/

package/src/legacy/tool-ui/src/Compat.css CHANGED Viewed

@@ -197,7 +197,7 @@
     @apply pointer-events-none;
     &:not(.Link) {
-      @apply btu-button-disabled before:btu-loader before:block before:size-[1.2rem];
+      @apply btu-button-disabled before:btu-loader before:blokk before:size-[1.2rem];
     }
   }
 }
@@ -247,15 +247,17 @@ suggests. Example use case "pin" icon button in live blog posts */
   @apply btu-button-gray;
 }
-.Label:is(.is-green) {
+/* Doubled `.Label` (0,3,0) is intentional — keeps v4 colors ahead of Label.css's (0,2,0) status colors. */
+.Label.Label.is-green {
   @apply btu-badge-success;
 }
-.Label:is(.is-orange, .is-yellow) {
+.Label.Label.is-orange,
+.Label.Label.is-yellow {
   @apply btu-badge-warning;
 }
-.Label:is(.is-red) {
+.Label.Label.is-red {
   @apply btu-badge-error;
 }