bitboss-ui 3.0.0-beta.63 → 3.0.0-beta.64

package/dist/types/ptComponentMap.d.ts

@@ -1,4 +1,16 @@
-import { PtDataMap } from './passthrough';
+import { PtDataMap, PtVariantDataMap } from './passthrough';
+import { AlertVariantRegistry } from './AlertVariant';
+import { BadgeVariantRegistry } from './BadgeVariant';
+import { ButtonVariantRegistry } from './ButtonVariant';
+import { CheckboxVariantRegistry } from './CheckboxVariant';
+import { ConfirmVariantRegistry } from './ConfirmVariant';
+import { DropdownItemVariantRegistry } from './DropdownItemVariant';
+import { IndicatorVariantRegistry } from './IndicatorVariant';
+import { InputVariantRegistry } from './InputVariant';
+import { RadioVariantRegistry } from './RadioVariant';
+import { TabsVariantRegistry } from './TabsVariant';
+import { ToastVariantRegistry } from './ToastVariant';
+import { TooltipVariantRegistry } from './TooltipVariant';
 /**
  * A build-time `pt` map with every component name and every `part` /
  * `part:state` key typed: what `definePt` and the plugin's `pt` /
@@ -7,41 +19,41 @@ import { PtDataMap } from './passthrough';
  */
 export interface BbPtComponentMap {
     BbAccordion?: PtDataMap<'root' | 'header' | 'title' | 'icon' | 'panel', 'open'>;
-    BbAlert?: PtDataMap<'root' | 'icon' | 'title' | 'text' | 'close', never>;
+    BbAlert?: PtDataMap<'root' | 'icon' | 'title' | 'text' | 'close', never> & PtVariantDataMap<'root' | 'icon' | 'title' | 'text' | 'close', keyof AlertVariantRegistry>;
     BbAsterisk?: PtDataMap<'root', never>;
     BbAvatar?: PtDataMap<'root' | 'icon', never>;
-    BbBadge?: PtDataMap<'root' | 'icon' | 'spinner' | 'text' | 'clear', 'loading'>;
-    BbBaseButton?: PtDataMap<'root', 'disabled'>;
+    BbBadge?: PtDataMap<'root' | 'icon' | 'spinner' | 'text' | 'clear', 'activeLink' | 'exactActiveLink' | 'loading'> & PtVariantDataMap<'root' | 'icon' | 'spinner' | 'text' | 'clear', keyof BadgeVariantRegistry>;
+    BbBaseButton?: PtDataMap<'root', 'activeLink' | 'exactActiveLink' | 'disabled'>;
     BbBaseCheckboxIcon?: PtDataMap<'root', 'checked' | 'indeterminate' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'focused' | 'focusVisible'>;
     BbBaseRadioIcon?: PtDataMap<'root', 'checked' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'focused' | 'focusVisible'>;
     BbBaseSwitchIcon?: PtDataMap<'root', 'checked' | 'indeterminate' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'focused' | 'focusVisible'>;
     BbBreadcrumbs?: PtDataMap<'root' | 'item' | 'icon' | 'text', 'disabled' | 'active'>;
-    BbButton?: PtDataMap<'root' | 'icon' | 'spinner' | 'text', 'pressed' | 'disabled' | 'loading'>;
+    BbButton?: PtDataMap<'root' | 'icon' | 'spinner' | 'text', 'activeLink' | 'exactActiveLink' | 'pressed' | 'disabled' | 'loading'> & PtVariantDataMap<'root' | 'icon' | 'spinner' | 'text', keyof ButtonVariantRegistry>;
     BbCalendar?: PtDataMap<'root' | 'header' | 'arrow' | 'month' | 'year' | 'cellColumnHeader' | 'day' | 'dayButton' | 'monthItem' | 'yearItem' | 'item', 'outside' | 'today' | 'inRange' | 'selected' | 'rangeStart' | 'rangeEnd' | 'disabled' | 'active' | 'highlighted'>;
     BbCheckbox?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'icon', 'checked' | 'indeterminate' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'focused' | 'focusVisible'>;
-    BbCheckboxGroup?: PtDataMap<'root' | 'legend' | 'description' | 'message' | 'hint' | 'list' | 'item' | 'icon' | 'label' | 'itemDescription', 'hasValue' | 'checked' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'focused' | 'focusVisible' | 'loading'>;
+    BbCheckboxGroup?: PtDataMap<'root' | 'legend' | 'description' | 'message' | 'hint' | 'list' | 'item' | 'icon' | 'label' | 'itemDescription' | 'indicator', 'hasValue' | 'checked' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'focused' | 'focusVisible' | 'loading'> & PtVariantDataMap<'root' | 'legend' | 'description' | 'message' | 'hint' | 'list' | 'item' | 'icon' | 'label' | 'itemDescription' | 'indicator', keyof CheckboxVariantRegistry>;
     BbCollapsible?: PtDataMap<'root' | 'content', 'open'>;
-    BbColorInput?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'indicator' | 'panel' | 'sheet' | 'swatch', 'hasValue' | 'selected' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'loading'>;
+    BbColorInput?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'indicator' | 'panel' | 'sheet' | 'swatch', 'hasValue' | 'selected' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'loading'> & PtVariantDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear', keyof InputVariantRegistry>;
     BbColorPalette?: PtDataMap<'root' | 'panel' | 'sheet' | 'swatch', 'selected' | 'open'>;
-    BbConfirm?: PtDataMap<'root' | 'sheet' | 'header' | 'title' | 'content' | 'text' | 'footer' | 'close' | 'action', 'open'>;
+    BbConfirm?: PtDataMap<'root' | 'sheet' | 'header' | 'title' | 'content' | 'text' | 'footer' | 'close' | 'action', 'open'> & PtVariantDataMap<'root' | 'sheet' | 'header' | 'title' | 'content' | 'text' | 'footer' | 'close' | 'action', keyof ConfirmVariantRegistry>;
     BbDatePicker?: PtDataMap<'root' | 'panel' | 'sheet' | 'header' | 'arrow' | 'month' | 'year' | 'cellColumnHeader' | 'day' | 'dayButton' | 'monthItem' | 'yearItem' | 'item', 'outside' | 'today' | 'inRange' | 'selected' | 'rangeStart' | 'rangeEnd' | 'disabled' | 'active' | 'open' | 'highlighted'>;
-    BbDatePickerInput?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'activator' | 'panel' | 'sheet' | 'header' | 'arrow' | 'month' | 'year' | 'cellColumnHeader' | 'day' | 'dayButton' | 'monthItem' | 'yearItem' | 'item', 'hasValue' | 'outside' | 'today' | 'inRange' | 'selected' | 'rangeStart' | 'rangeEnd' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'active' | 'open' | 'highlighted' | 'loading'>;
+    BbDatePickerInput?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'activator' | 'panel' | 'sheet' | 'header' | 'arrow' | 'month' | 'year' | 'cellColumnHeader' | 'day' | 'dayButton' | 'monthItem' | 'yearItem' | 'item', 'hasValue' | 'outside' | 'today' | 'inRange' | 'selected' | 'rangeStart' | 'rangeEnd' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'active' | 'open' | 'highlighted' | 'loading'> & PtVariantDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'activator', keyof InputVariantRegistry>;
     BbDialog?: PtDataMap<'root' | 'sheet' | 'header' | 'title' | 'description' | 'content' | 'footer' | 'close', 'open' | 'fullscreen'>;
-    BbDropdown?: PtDataMap<'root' | 'panel' | 'sheet' | 'header' | 'footer' | 'input' | 'list' | 'item' | 'itemText' | 'itemIcon' | 'itemDescription', 'selected' | 'disabled' | 'open'>;
-    BbDropdownButton?: PtDataMap<'root' | 'main' | 'toggle' | 'icon' | 'spinner' | 'text' | 'panel' | 'sheet' | 'header' | 'footer' | 'input' | 'item' | 'itemText' | 'itemIcon' | 'itemDescription', 'selected' | 'disabled' | 'open' | 'loading'>;
+    BbDropdown?: PtDataMap<'root' | 'panel' | 'sheet' | 'header' | 'footer' | 'input' | 'list' | 'item' | 'itemText' | 'itemIcon' | 'itemDescription', 'activeLink' | 'exactActiveLink' | 'selected' | 'disabled' | 'open'> & PtVariantDataMap<'item' | 'itemText' | 'itemIcon' | 'itemDescription', keyof DropdownItemVariantRegistry>;
+    BbDropdownButton?: PtDataMap<'root' | 'main' | 'toggle' | 'icon' | 'spinner' | 'text' | 'panel' | 'sheet' | 'header' | 'footer' | 'input' | 'item' | 'itemText' | 'itemIcon' | 'itemDescription', 'activeLink' | 'exactActiveLink' | 'selected' | 'disabled' | 'open' | 'loading'> & PtVariantDataMap<'root' | 'main' | 'toggle' | 'icon' | 'spinner' | 'text', keyof ButtonVariantRegistry> & PtVariantDataMap<'item' | 'itemText' | 'itemIcon' | 'itemDescription', keyof DropdownItemVariantRegistry>;
     BbDropzone?: PtDataMap<'root' | 'content' | 'message', 'readonly' | 'disabled' | 'warnings' | 'errors' | 'active'>;
     BbHoverCard?: PtDataMap<'root' | 'panel' | 'header' | 'content' | 'footer', 'open'>;
     BbIcon?: PtDataMap<'root', never>;
-    BbIndicator?: PtDataMap<'root' | 'bubble', never>;
-    BbNumberInput?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear', 'hasValue' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'loading'>;
+    BbIndicator?: PtDataMap<'root' | 'bubble', never> & PtVariantDataMap<'root' | 'bubble', keyof IndicatorVariantRegistry>;
+    BbNumberInput?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear', 'hasValue' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'loading'> & PtVariantDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear', keyof InputVariantRegistry>;
     BbOffCanvas?: PtDataMap<'root' | 'header' | 'title' | 'description' | 'content' | 'footer' | 'close', 'open' | 'fullscreen'>;
     BbPagination?: PtDataMap<'root' | 'item' | 'arrow' | 'ellipsis' | 'icon', 'disabled' | 'active'>;
     BbPopover?: PtDataMap<'root' | 'panel' | 'sheet' | 'header' | 'content' | 'footer', 'open'>;
     BbProgress?: PtDataMap<'root' | 'bar', 'indeterminate'>;
     BbRadio?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'icon', 'checked' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'focused' | 'focusVisible'>;
-    BbRadioGroup?: PtDataMap<'root' | 'legend' | 'description' | 'message' | 'hint' | 'list' | 'item' | 'icon' | 'label' | 'itemDescription', 'hasValue' | 'checked' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'focused' | 'focusVisible' | 'loading'>;
+    BbRadioGroup?: PtDataMap<'root' | 'legend' | 'description' | 'message' | 'hint' | 'list' | 'item' | 'icon' | 'label' | 'itemDescription' | 'indicator', 'hasValue' | 'checked' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'focused' | 'focusVisible' | 'loading'> & PtVariantDataMap<'root' | 'legend' | 'description' | 'message' | 'hint' | 'list' | 'item' | 'icon' | 'label' | 'itemDescription' | 'indicator', keyof RadioVariantRegistry>;
     BbRating?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'item', 'hasValue' | 'selected' | 'readonly' | 'disabled' | 'warnings' | 'errors'>;
-    BbSelect?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'activator' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'panel' | 'sheet' | 'header' | 'footer' | 'list' | 'option' | 'itemText' | 'itemIcon' | 'itemDescription' | 'badge' | 'comma', 'hasValue' | 'selected' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'open' | 'loading'>;
+    BbSelect?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'activator' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'panel' | 'sheet' | 'header' | 'footer' | 'list' | 'option' | 'itemText' | 'itemIcon' | 'itemDescription' | 'badge' | 'comma', 'hasValue' | 'selected' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'open' | 'loading'> & PtVariantDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'activator' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear', keyof InputVariantRegistry>;
     BbSelectPopover?: PtDataMap<'root' | 'panel' | 'sheet' | 'input' | 'clear' | 'list' | 'option' | 'itemText' | 'itemIcon' | 'itemDescription' | 'header' | 'footer', 'selected' | 'disabled' | 'open'>;
     BbSlider?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'track' | 'bar' | 'ticks' | 'tick' | 'thumb', 'inRange' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'active'>;
     BbSmoothHeight?: PtDataMap<'root', never>;
@@ -49,15 +61,15 @@ export interface BbPtComponentMap {
     BbSwitch?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'icon', 'checked' | 'indeterminate' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'focused' | 'focusVisible'>;
     BbSwitchGroup?: PtDataMap<'root' | 'legend' | 'description' | 'message' | 'hint' | 'list' | 'item' | 'icon' | 'label' | 'itemDescription', 'hasValue' | 'checked' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'focused' | 'focusVisible' | 'loading'>;
     BbTable?: PtDataMap<'root' | 'caption' | 'table' | 'head' | 'headerRow' | 'cellColumnHeader' | 'sortIcon' | 'body' | 'row' | 'cell' | 'expand' | 'firstRow' | 'lastRow' | 'selectIcon' | 'dragIcon' | 'dragHandle' | 'foot', 'value' | 'placeholder' | 'empty' | 'sorted' | 'sortedDesc' | 'selected' | 'indeterminate' | 'disabled' | 'expanded' | 'highlighted' | 'loading'>;
-    BbTabs?: PtDataMap<'root' | 'wrapper' | 'list' | 'item' | 'indicator' | 'panels' | 'panel', 'disabled' | 'active'>;
-    BbTabsList?: PtDataMap<'root' | 'list' | 'item' | 'indicator', 'disabled' | 'active'>;
+    BbTabs?: PtDataMap<'root' | 'wrapper' | 'list' | 'item' | 'indicator' | 'panels' | 'panel', 'disabled' | 'active'> & PtVariantDataMap<'wrapper' | 'list' | 'item' | 'indicator', keyof TabsVariantRegistry>;
+    BbTabsList?: PtDataMap<'root' | 'list' | 'item' | 'indicator', 'disabled' | 'active'> & PtVariantDataMap<'root' | 'list' | 'item' | 'indicator', keyof TabsVariantRegistry>;
     BbTabsPanels?: PtDataMap<'root' | 'panel', 'disabled' | 'active'>;
-    BbTag?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'badge' | 'comma', 'hasValue' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'highlighted' | 'loading'>;
-    BbTextInput?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'counter', 'hasValue' | 'nearLimit' | 'atLimit' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'loading'>;
-    BbTextarea?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'counter', 'hasValue' | 'nearLimit' | 'atLimit' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'loading'>;
+    BbTag?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'badge' | 'comma', 'hasValue' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'highlighted' | 'loading'> & PtVariantDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear', keyof InputVariantRegistry>;
+    BbTextInput?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'counter', 'hasValue' | 'nearLimit' | 'atLimit' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'loading'> & PtVariantDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear', keyof InputVariantRegistry>;
+    BbTextarea?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'counter', 'hasValue' | 'nearLimit' | 'atLimit' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'loading'> & PtVariantDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear', keyof InputVariantRegistry>;
     BbTimePicker?: PtDataMap<'root' | 'panel' | 'sheet' | 'header' | 'cellColumnHeader' | 'item', 'selected' | 'disabled' | 'open'>;
-    BbTimePickerInput?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'activator' | 'panel' | 'sheet' | 'header' | 'cellColumnHeader' | 'item', 'hasValue' | 'selected' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'open' | 'loading'>;
-    BbToast?: PtDataMap<'root' | 'panel' | 'icon' | 'content' | 'title' | 'text' | 'footer' | 'action' | 'close', 'loading'>;
-    BbTooltip?: PtDataMap<'root' | 'panel', 'open'>;
+    BbTimePickerInput?: PtDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'activator' | 'panel' | 'sheet' | 'header' | 'cellColumnHeader' | 'item', 'hasValue' | 'selected' | 'readonly' | 'disabled' | 'warnings' | 'errors' | 'open' | 'loading'> & PtVariantDataMap<'root' | 'label' | 'description' | 'message' | 'hint' | 'box' | 'input' | 'icon' | 'spinner' | 'prefix' | 'suffix' | 'clear' | 'activator', keyof InputVariantRegistry>;
+    BbToast?: PtDataMap<'root' | 'panel' | 'icon' | 'content' | 'title' | 'text' | 'footer' | 'action' | 'close', 'loading'> & PtVariantDataMap<'panel' | 'icon' | 'content' | 'title' | 'text' | 'footer' | 'action' | 'close', keyof ToastVariantRegistry>;
+    BbTooltip?: PtDataMap<'root' | 'panel', 'open'> & PtVariantDataMap<'root' | 'panel', keyof TooltipVariantRegistry>;
     BbTree?: PtDataMap<'root' | 'item', 'expanded'>;
 }

package/dist/utilities/functions/extractDomContainer.d.ts

@@ -1 +1,20 @@
-export declare function extractDomContainer(target: unknown): HTMLElement | null;
+/**
+ * What a floating surface can hang on: an HTML element, or an svg one (a raw
+ * `<svg>`, or a component whose root is one, like BbIcon — Q76.15). Spelled
+ * as the members both share rather than `HTMLElement | SVGElement`, whose
+ * overloaded `addEventListener` no typed handler can satisfy.
+ */
+export interface DomHost extends Element, HTMLOrSVGElement, ElementCSSInlineStyle {
+    addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: DomHost, ev: HTMLElementEventMap[K]) => unknown, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: DomHost, ev: HTMLElementEventMap[K]) => unknown, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+}
+/**
+ * A host as the element it really is, for APIs typed on the DOM classes
+ * (VueUse's observers); every DomHost is one of the two.
+ */
+export declare const domElement: (el: DomHost | null | undefined) => HTMLElement | SVGElement | undefined;
+export declare function extractDomContainer(target: unknown): DomHost | null;
+/** {@link extractDomContainer} for a library-owned container that is always HTML (a panel, a row, a button root). */
+export declare const extractHtmlContainer: (target: unknown) => HTMLElement | null;

package/dist/utilities/functions/extractDomContainer.js

@@ -1,6 +1,11 @@
 //#region src/utilities/functions/extractDomContainer.ts
-function e(e) {
-	return e ? e instanceof HTMLElement ? e : typeof e == "object" && "$el" in e && e.$el instanceof HTMLElement ? e.$el : typeof e == "object" && "el" in e && e.el instanceof HTMLElement ? e.el : null : null;
+var e = (e) => e ?? void 0, t = (e) => e instanceof HTMLElement || e instanceof SVGElement;
+function n(e) {
+	return e ? t(e) ? e : typeof e == "object" && "$el" in e && t(e.$el) ? e.$el : typeof e == "object" && "el" in e && t(e.el) ? e.el : null : null;
 }
+var r = (e) => {
+	let t = n(e);
+	return t instanceof HTMLElement ? t : null;
+};
 //#endregion
-export { e as extractDomContainer };
+export { e as domElement, n as extractDomContainer, r as extractHtmlContainer };

package/dist/utils/focusVisibility.d.ts

@@ -7,3 +7,9 @@ export declare const focusVisibly: (el: HTMLElement | null | undefined, options?
  * on the focused element changes nothing.
  */
 export declare const focusQuietly: (el: HTMLElement | null | undefined, options?: FocusOptions) => void;
+/**
+ * The first match of `selector` inside `root` that a script `focus()` can
+ * land on: an HTMLElement that is not disabled. A focusable `<svg>` (or a
+ * disabled button) first in line is passed over, not a dead end (Q76.16).
+ */
+export declare const firstFocusableMatch: (root: ParentNode | null | undefined, selector: string) => HTMLElement | null;

package/dist/utils/focusVisibility.js

@@ -7,6 +7,9 @@ var e = (e, t) => e?.focus({
 		...t,
 		focusVisible: !1
 	}));
+}, n = (e, t) => {
+	for (let n of e?.querySelectorAll(t) ?? []) if (n instanceof HTMLElement && !n.matches(":disabled")) return n;
+	return null;
 };
 //#endregion
-export { t as focusQuietly, e as focusVisibly };
+export { n as firstFocusableMatch, t as focusQuietly, e as focusVisibly };

package/dist/utils/passthroughDeduper.d.ts

@@ -1,2 +1,16 @@
+/**
+ * The app's own `@theme` names per tailwind-merge theme key (`text` for
+ * `--text-*` font sizes, `color` for `--color-*`, …), read by the build
+ * plugin from the app's CSS.
+ */
+export type PassthroughDeduperTheme = Partial<Record<string, string[]>>;
+/**
+ * A deduper that knows the app's theme (Q76.7 e): each of the app's token
+ * classes resolves to the property its `@theme` namespace sets, so
+ * `text-h2 text-ink` (a font size and a colour) keeps both, while two font
+ * sizes or two colours still dedupe. Without the names, tailwind-merge reads
+ * an unknown `text-*` as a colour.
+ */
+export declare const createPassthroughDeduper: (theme?: PassthroughDeduperTheme) => ((className: string) => string);
 declare const passthroughDeduper: (className: string) => string;
 export default passthroughDeduper;

package/dist/utils/versionCheck.js

@@ -9,7 +9,7 @@ function r() {
 	if (process.env.NODE_ENV === "production" || n || typeof window > "u") return;
 	n = !0;
 	let r = () => {
-		let n = t("3.0.0-beta.63", getComputedStyle(document.documentElement).getPropertyValue(e));
+		let n = t("3.0.0-beta.64", getComputedStyle(document.documentElement).getPropertyValue(e));
 		n && console.warn(n);
 	};
 	document.readyState === "complete" ? setTimeout(r, 0) : window.addEventListener("load", r, { once: !0 });

package/dist/vite-plugin.d.ts

@@ -31,6 +31,14 @@ export declare function expandIconWhitelist(whitelist: readonly string[], provid
  * silent. Best effort: an unwritable cache only loses the hint.
  */
 export declare function upgradeHint(root: string, version: string): string | null;
+/**
+ * Q76.7: an app's own variant name must not be a passthrough state of a
+ * component it styles: `pt:root:loading` could not say whether it means the
+ * `loading` state or a `loading` variant. Returns an error message, or `null`.
+ * The component's states are its declared `pt:<part>:<word>` words that are
+ * not built-in variant names.
+ */
+export declare function validateVariantNames(options: Partial<Record<string, unknown>>, path?: string | null): string | null;
 /**
  * Build-time check of the global `pt` map's component names and keys against
  * the manifest. Returns an error message, or `null` when every key names a
@@ -40,7 +48,9 @@ export declare function upgradeHint(root: string, version: string): string | nul
  */
 export declare function validatePtGlobalMapNames(pt: Record<string, Record<string, unknown>> | undefined, path?: string | null, 
 /** Where the map sits in the plugin options: `pt`, `ptScopes.webapp`. */
-label?: string): string | null;
+label?: string, 
+/** The plugin options, for the app's own variant names (Q76.7). */
+options?: Partial<Record<string, unknown>>): string | null;
 export { BUILTIN_LOCALE_KEYS };
 /**
  * Resolves the built-in locales that actually ship in the consumer bundle,
@@ -99,7 +109,30 @@ export declare function generateDayjsLocalesModule(found: ReadonlyArray<{
  * A consumer path is resolved against the project root; a bare specifier is
  * left for Vite to resolve like any import.
  */
-export declare function generatePassthroughDeduperModule(option: false | string | undefined, root: string, libraryDir?: string): string;
+export declare function generatePassthroughDeduperModule(option: false | string | undefined, root: string, libraryDir?: string, themeNames?: ThemeNames): string;
+/** Theme names per tailwind-merge theme key: `{ text: ['h2'], color: ['ink'] }`. */
+type ThemeNames = Record<string, string[]>;
+/**
+ * The `@theme` names one CSS file declares (`--text-h2` → `text: ['h2']`,
+ * `--color-ink` → `color: ['ink']`). A sub-property (`--text-h2--line-height`)
+ * and a reset (`--color-*`) are not names.
+ */
+export declare function themeNamesInCss(css: string): ThemeNames;
+/** Several files' names as one, sorted (a stable module source). */
+export declare function mergeThemeNames(all: Iterable<ThemeNames>): ThemeNames;
+/** Is `path` an app CSS file the theme scan reads (under `root`, not skipped)? */
+export declare function isAppThemeCss(root: string, path: string): boolean;
+/**
+ * The app's own CSS files that declare `@theme` names, each with its names,
+ * read from the project's folders only, a few levels deep.
+ */
+export declare function scanThemeFiles(root: string): Map<string, ThemeNames>;
+/**
+ * The app's own Tailwind `@theme` names per tailwind-merge theme key, from
+ * every CSS file of the project (see `scanThemeFiles`). In dev the plugin
+ * keeps them live: a CSS edit that changes them reloads the deduper module.
+ */
+export declare function collectThemeNames(root: string): ThemeNames;
 /** Build-time check of `passthroughDeduper`; an error message or `null`. */
 export declare function validatePassthroughDeduper(value: unknown): string | null;
 /**
@@ -204,10 +237,10 @@ export interface BitbossUiOptions extends Partial<Omit<EditableConfig, 'formCont
     /**
      * When `true`, the dev server registers the bitboss-ui MCP server in each
      * project-scoped agent-harness config on boot (`.mcp.json` for Claude Code,
-     * `.cursor/mcp.json`, `.vscode/mcp.json`), so agents can query the component
-     * knowledge base with no manual setup. The write is merge-safe and
-     * idempotent (it leaves any other servers alone and only logs when it
-     * actually changes a file).
+     * `.cursor/mcp.json`, `.vscode/mcp.json`, `.zed/settings.json`), so agents
+     * can query the component knowledge base with no manual setup. The write
+     * is merge-safe and idempotent (it leaves any other servers alone and only
+     * logs when it actually changes a file).
      *
      * The same project-scoped registration `npx bitboss-ui ai-init` performs
      * (which also installs the server's optional peers; a dev-server boot never
@@ -332,7 +365,10 @@ export interface BitbossUiOptions extends Partial<Omit<EditableConfig, 'formCont
      * `pt:icon="text-slate-400"` + `pt:icon:loading="text-red-500"` keeps only
      * `text-red-500` while loading.
      *
-     * - unset — the bundled `tailwind-merge` v3 (Tailwind v4);
+     * - unset — the bundled `tailwind-merge` v3 (Tailwind v4), taught the
+     *   `@theme` token names in the project's own CSS (live in dev), so each
+     *   dedupes by the property it sets (`text-h2` a size, `text-ink` a
+     *   colour);
      * - `false` — off: classes append, and stylesheet order decides conflicts;
      * - a module path (relative to the project root) or package name whose
      *   default export is `(className: string) => string` — pure and
@@ -477,6 +513,27 @@ export interface BitbossUiOptions extends Partial<Omit<EditableConfig, 'formCont
      * @defaultValue `['pill', 'line', 'none']`
      */
     tabsVariants?: string[];
+    /**
+     * List of radio-group variants to register as a typed union — the
+     * `variant` prop of `BbRadioGroup`, its tab-strip looks (Q76.11 d).
+     * Appends to the default set when provided. A custom name is styled
+     * through its class hook `bb-radio-group__list--<name>` by setting the
+     * strip's tokens (`--list-bg`, `--indicator-bg`, `--indicator-h`,
+     * `--active-fg`, …); the shipped variants are the same token presets.
+     *
+     * @defaultValue `['pill', 'line']`
+     */
+    radioVariants?: string[];
+    /**
+     * List of checkbox-group variants to register as a typed union — the
+     * `variant` prop of `BbCheckboxGroup`, its tab-strip looks (Q76.11 d).
+     * Appends to the default set when provided. A custom name is styled
+     * through its class hook `bb-checkbox-group__list--<name>` by setting the
+     * strip's tokens; a custom look draws pills per run, as `pill` does.
+     *
+     * @defaultValue `['pill', 'line']`
+     */
+    checkboxVariants?: string[];
 }
 export declare const REQUIRED_OPTIMIZE_DEPS_INCLUDE: string[];
 export declare const REQUIRED_OPTIMIZE_DEPS_EXCLUDE: string[];