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

package/dist/ai/manifest/components/BbSelect.json

@@ -38,7 +38,7 @@
 		{"name":"items","type":"T[] | ((context: BbSelectItemsContext) => T[] | Promise<T[]>)","required":true,"description":"The options: an array, or a provider called with a `BbSelectItemsContext` (`query`, `reason`, `modelValue`, `signal`), sync or async. Branch on `reason !== 'search'` to resolve the selection by id. A provider fails by THROWING, never by returning `[]`."},
 		{"name":"itemText","common":true},
 		{"name":"itemValue","common":true},
-		{"name":"knownItems","type":"(BbSelectKnownItem | null | undefined)[]","description":"`{ value, label }` rows naming the value the app already holds, whatever the options' shape: no request until the first open (`prefill: true` still loads). Not options; the options' accessors never run on them; slots get the row as `item` until the list brings its own."},
+		{"name":"knownItems","type":"([Known] extends [undefined] ? BbSelectKnownItems : Known)","description":"`{ value, label }` rows naming the value the app already holds, whatever the options' shape: no request until the first open (`prefill: true` still loads). Not options; the options' accessors never run on them; slots get the row as `item`, with `known: true`, until the list brings its own."},
 		{"name":"label","type":"string","required":true,"description":"Text content of the label of the element."},
 		{"name":"labelAlign","common":true},
 		{"name":"labelMode","common":true},
@@ -57,7 +57,7 @@
 		{"name":"placeholder","type":"string","description":"Text shown in the field while nothing is picked (an empty list has `emptyText`)."},
 		{"name":"prefill","type":"boolean | \"interaction\"","default":"'interaction'","description":"When the options first load: `'interaction'` on first open, `true` on mount, `false` only once the user types (on open with `disable-writing`). An array `items` or a seeded model always loads at once."},
 		{"name":"prepend:icon","common":true},
-		{"name":"pt","type":"PtItemMap<BbSelectPtPart, BbSelectOptionPtPart, BbSelectPtState, T>","description":"Passthrough, object form: the same keys as the `pt:*` attributes without the prefix. See the `pt:<part>` row."},
+		{"name":"pt","type":"({ root?: PtValue | undefined; header?: PtValue | undefined; icon?: PtValue | undefined; panel?: PtValue | undefined; \"root:open\"?: PtValue | undefined; \"header:open\"?: PtValue | undefined; \"icon:open\"?: PtValue | undefined; \"panel:open\"?: PtValue | undefined; spinner?: PtValue | undefined; clear?: PtValue | undefined; \"root:loading\"?: PtValue | undefined; \"icon:loading\"?: PtValue | undefined; \"spinner:loading\"?: PtValue | undefined; \"clear:loading\"?: PtValue | undefined; \"root:disabled\"?: PtValue | undefined; label?: PtValue | undefined; \"root:errors\"?: PtValue | undefined; \"root:warnings\"?: PtValue | undefined; \"root:readonly\"?: PtValue | undefined; \"icon:disabled\"?: PtValue | undefined; \"spinner:disabled\"?: PtValue | undefined; \"root:selected\"?: PtValue | undefined; \"header:disabled\"?: PtValue | undefined; \"header:selected\"?: PtValue | undefined; description?: PtValue | undefined; message?: PtValue | undefined; hint?: PtValue | undefined; \"icon:errors\"?: PtValue | undefined; \"icon:warnings\"?: PtValue | undefined; \"icon:readonly\"?: PtValue | undefined; \"label:disabled\"?: PtValue | undefined; \"label:errors\"?: PtValue | undefined; \"label:warnings\"?: PtValue | undefined; \"label:readonly\"?: PtValue | undefined; \"description:disabled\"?: PtValue | undefined; \"description:errors\"?: PtValue | undefined; \"description:warnings\"?: PtValue | undefined; \"description:readonly\"?: PtValue | undefined; \"message:disabled\"?: PtValue | undefined; \"message:errors\"?: PtValue | undefined; \"message:warnings\"?: PtValue | undefined; \"message:readonly\"?: PtValue | undefined; \"hint:disabled\"?: PtValue | undefined; \"hint:errors\"?: PtValue | undefined; \"hint:warnings\"?: PtValue | undefined; \"hint:readonly\"?: PtValue | undefined; input?: PtValue | undefined; list?: PtValue | undefined; \"root:hasValue\"?: PtValue | undefined; \"description:loading\"?: PtValue | undefined; \"description:hasValue\"?: PtValue | undefined; \"message:loading\"?: PtValue | undefined; \"message:hasValue\"?: PtValue | undefined; \"hint:loading\"?: PtValue | undefined; \"hint:hasValue\"?: PtValue | undefined; \"list:loading\"?: PtValue | undefined; \"list:disabled\"?: PtValue | undefined; \"list:errors\"?: PtValue | undefined; \"list:warnings\"?: PtValue | undefined; \"list:readonly\"?: PtValue | undefined; \"list:hasValue\"?: PtValue | undefined; \"icon:hasValue\"?: PtValue | undefined; \"label:loading\"?: PtValue | undefined; \"label:hasValue\"?: PtValue | undefined; \"itemDescription:loading\"?: PtValue | undefined; \"itemDescription:disabled\"?: PtValue | undefined; \"itemDescription:errors\"?: PtValue | undefined; \"itemDescription:warnings\"?: PtValue | undefined; \"itemDescription:readonly\"?: PtValue | undefined; \"itemDescription:hasValue\"?: PtValue | undefined; box?: PtValue | undefined; prefix?: PtValue | undefined; suffix?: PtValue | undefined; sheet?: PtValue | undefined; \"panel:loading\"?: PtValue | undefined; \"panel:disabled\"?: PtValue | undefined; \"panel:errors\"?: PtValue | undefined; \"panel:warnings\"?: PtValue | undefined; \"panel:readonly\"?: PtValue | undefined; \"panel:hasValue\"?: PtValue | undefined; \"spinner:errors\"?: PtValue | undefined; \"spinner:warnings\"?: PtValue | undefined; \"spinner:readonly\"?: PtValue | undefined; \"spinner:hasValue\"?: PtValue | undefined; \"clear:disabled\"?: PtValue | undefined; \"clear:errors\"?: PtValue | undefined; \"clear:warnings\"?: PtValue | undefined; \"clear:readonly\"?: PtValue | undefined; \"clear:hasValue\"?: PtValue | undefined; \"input:loading\"?: PtValue | undefined; \"input:disabled\"?: PtValue | undefined; \"input:errors\"?: PtValue | undefined; \"input:warnings\"?: PtValue | undefined; \"input:readonly\"?: PtValue | undefined; \"input:hasValue\"?: PtValue | undefined; \"box:loading\"?: PtValue | undefined; \"box:disabled\"?: PtValue | undefined; \"box:errors\"?: PtValue | undefined; \"box:warnings\"?: PtValue | undefined; \"box:readonly\"?: PtValue | undefined; \"box:hasValue\"?: PtValue | undefined; \"prefix:loading\"?: PtValue | undefined; \"prefix:disabled\"?: PtValue | undefined; \"prefix:errors\"?: PtValue | undefined; \"prefix:warnings\"?: PtValue | undefined; \"prefix:readonly\"?: PtValue | undefined; \"prefix:hasValue\"?: PtValue | undefined; \"suffix:loading\"?: PtValue | undefined; \"suffix:disabled\"?: PtValue | undefined; \"suffix:errors\"?: PtValue | undefined; \"suffix:warnings\"?: PtValue | undefined; \"suffix:readonly\"?: PtValue | undefined; \"suffix:hasValue\"?: PtValue | undefined; \"sheet:loading\"?: PtValue | undefined; \"sheet:disabled\"?: PtValue | undefined; \"sheet:errors\"?: PtValue | undefined; \"sheet:warnings\"?: PtValue | undefined; \"sheet:readonly\"?: PtValue | undefined; \"sheet:hasValue\"?: PtValue | undefined; footer?: PtValue | undefined; activator?: PtValue | undefined; \"sheet:open\"?: PtValue | undefined; \"footer:open\"?: PtValue | undefined; \"panel:selected\"?: PtValue | undefined; \"sheet:selected\"?: PtValue | undefined; \"header:loading\"?: PtValue | undefined; \"header:errors\"?: PtValue | undefined; \"header:warnings\"?: PtValue | undefined; \"header:readonly\"?: PtValue | undefined; \"header:hasValue\"?: PtValue | undefined; \"icon:selected\"?: PtValue | undefined; \"spinner:open\"?: PtValue | undefined; \"spinner:selected\"?: PtValue | undefined; \"clear:open\"?: PtValue | undefined; \"clear:selected\"?: PtValue | undefined; \"label:open\"?: PtValue | undefined; \"label:selected\"?: PtValue | undefined; \"description:open\"?: PtValue | undefined; \"description:selected\"?: PtValue | undefined; \"message:open\"?: PtValue | undefined; \"message:selected\"?: PtValue | undefined; \"hint:open\"?: PtValue | undefined; \"hint:selected\"?: PtValue | undefined; \"input:open\"?: PtValue | undefined; \"input:selected\"?: PtValue | undefined; \"box:open\"?: PtValue | undefined; \"box:selected\"?: PtValue | undefined; \"prefix:open\"?: PtValue | undefined; \"prefix:selected\"?: PtValue | undefined; \"suffix:open\"?: PtValue | undefined; \"suffix:selected\"?: PtValue | undefined; \"activator:open\"?: PtValue | undefined; \"activator:selected\"?: PtValue | undefined; \"activator:loading\"?: PtValue | undefined; \"activator:disabled\"?: PtValue | undefined; \"activator:errors\"?: PtValue | undefined; \"activator:warnings\"?: PtValue | undefined; \"activator:readonly\"?: PtValue | undefined; \"activator:hasValue\"?: PtValue | undefined; \"list:open\"?: PtValue | undefined; \"list:selected\"?: PtValue | undefined; \"itemDescription:open\"?: PtValue | undefined; \"itemDescription:selected\"?: PtValue | undefined; \"itemText:open\"?: PtValue | undefined; \"itemText:disabled\"?: PtValue | undefined; \"itemText:selected\"?: PtValue | undefined; \"footer:disabled\"?: PtValue | undefined; \"footer:selected\"?: PtValue | undefined; \"itemIcon:open\"?: PtValue | undefined; \"itemIcon:disabled\"?: PtValue | undefined; \"itemIcon:selected\"?: PtValue | undefined; \"footer:loading\"?: PtValue | undefined; \"itemText:loading\"?: PtValue | undefined; \"itemIcon:loading\"?: PtValue | undefined; \"itemText:errors\"?: PtValue | undefined; \"itemText:warnings\"?: PtValue | undefined; \"itemText:readonly\"?: PtValue | undefined; \"itemText:hasValue\"?: PtValue | undefined; \"footer:errors\"?: PtValue | undefined; \"footer:warnings\"?: PtValue | undefined; \"footer:readonly\"?: PtValue | undefined; \"footer:hasValue\"?: PtValue | undefined; \"itemIcon:errors\"?: PtValue | undefined; \"itemIcon:warnings\"?: PtValue | undefined; \"itemIcon:readonly\"?: PtValue | undefined; \"itemIcon:hasValue\"?: PtValue | undefined; \"option:open\"?: PtValue | undefined; \"option:selected\"?: PtValue | undefined; \"option:loading\"?: PtValue | undefined; \"option:disabled\"?: PtValue | undefined; \"option:errors\"?: PtValue | undefined; \"option:warnings\"?: PtValue | undefined; \"option:readonly\"?: PtValue | undefined; \"option:hasValue\"?: PtValue | undefined; \"badge:open\"?: PtValue | undefined; \"badge:selected\"?: PtValue | undefined; \"badge:loading\"?: PtValue | undefined; \"badge:disabled\"?: PtValue | undefined; \"badge:errors\"?: PtValue | undefined; \"badge:warnings\"?: PtValue | undefined; \"badge:readonly\"?: PtValue | undefined; \"badge:hasValue\"?: PtValue | undefined; \"comma:open\"?: PtValue | undefined; \"comma:selected\"?: PtValue | undefined; \"comma:loading\"?: PtValue | undefined; \"comma:disabled\"?: PtValue | undefined; \"comma:errors\"?: PtValue | undefined; \"comma:warnings\"?: PtValue | undefined; \"comma:readonly\"?: PtValue | undefined; \"comma:hasValue\"?: PtValue | undefined; } & { itemDescription?: PtValue | PtItemFn<T, BbSelectPtState, never, BbSelectSlotRow<T, Known>> | undefined; itemText?: PtValue | PtItemFn<T, BbSelectPtState, never, BbSelectSlotRow<T, Known>> | undefined; itemIcon?: PtValue | PtItemFn<T, BbSelectPtState, never, BbSelectSlotRow<T, Known>> | undefined; option?: PtValue | PtItemFn<T, BbSelectPtState, never, BbSelectSlotRow<T, Known>> | undefined; badge?: PtValue | PtItemFn<T, BbSelectPtState, never, BbSelectSlotRow<T, Known>> | undefined; comma?: PtValue | PtItemFn<T, BbSelectPtState, never, BbSelectSlotRow<T, Known>> | undefined; } & { \"root:outline\"?: PtValue | undefined; \"icon:outline\"?: PtValue | undefined; \"root:secondary\"?: PtValue | undefined; \"icon:secondary\"?: PtValue | undefined; \"spinner:outline\"?: PtValue | undefined; \"spinner:secondary\"?: PtValue | undefined; \"clear:outline\"?: PtValue | undefined; \"clear:secondary\"?: PtValue | undefined; \"root:ghost\"?: PtValue | undefined; \"icon:ghost\"?: PtValue | undefined; \"spinner:ghost\"?: PtValue | undefined; \"clear:ghost\"?: PtValue | undefined; \"label:outline\"?: PtValue | undefined; \"label:secondary\"?: PtValue | undefined; \"label:ghost\"?: PtValue | undefined; \"description:outline\"?: PtValue | undefined; \"description:secondary\"?: PtValue | undefined; \"description:ghost\"?: PtValue | undefined; \"message:outline\"?: PtValue | undefined; \"message:secondary\"?: PtValue | undefined; \"message:ghost\"?: PtValue | undefined; \"hint:outline\"?: PtValue | undefined; \"hint:secondary\"?: PtValue | undefined; \"hint:ghost\"?: PtValue | undefined; \"box:outline\"?: PtValue | undefined; \"box:secondary\"?: PtValue | undefined; \"box:ghost\"?: PtValue | undefined; \"prefix:outline\"?: PtValue | undefined; \"prefix:secondary\"?: PtValue | undefined; \"prefix:ghost\"?: PtValue | undefined; \"suffix:outline\"?: PtValue | undefined; \"suffix:secondary\"?: PtValue | undefined; \"suffix:ghost\"?: PtValue | undefined; \"activator:outline\"?: PtValue | undefined; \"activator:secondary\"?: PtValue | undefined; \"activator:ghost\"?: PtValue | undefined; })","description":"Passthrough, object form: the same keys as the `pt:*` attributes without the prefix. See the `pt:<part>` row."},
 		{"name":"queryDebounceTime","type":"number","default":"500","description":"Time to wait when the user stops writing in the input before querying data."},
 		{"name":"readonly","common":true},
 		{"name":"required","common":true},
@@ -90,7 +90,7 @@
 	"slots": [
 		{"name":"append","type":"{ query: string; focus: () => void; close: () => Promise<void>; }","description":"Content appended inside the input field, after the value area."},
 		{"name":"append:outer","type":"{ query: string; close: () => Promise<void>; }","description":"Content appended outside the input field wrapper."},
-		{"name":"chip","type":"BbSelectChipSlotProps<T>","fields":["item: T","text: string","value: any","disabled: boolean","deselect: () => void"],"description":"Replaces the default badge rendered for each selection in `multiple` mode. Not called in `comma` mode, nor for the collapsed \"+N\" summary."},
+		{"name":"chip","type":"BbSelectChipSlotProps<T, Known>","fields":["known: boolean","item: BbSelectKnownItem | T","text: string","value: any","disabled: boolean","deselect: () => void"],"description":"Replaces the default badge rendered for each selection in `multiple` mode. Not called in `comma` mode, nor for the collapsed \"+N\" summary. With `known-items` bound, `item` is the known `{ value, label }` row (`known: true`) until the list brings the real one."},
 		{"name":"description","type":"BbSelectDescriptionSlotProps","fields":["text: string","hasErrors: boolean","hasWarnings: boolean"],"description":"Replaces the description text. Provided alone (no `description` prop) it still renders the description region and wires it into `aria-describedby`."},
 		{"name":"empty","type":"{ query: string; focus: () => void; error: unknown; }","description":"Content shown when no options match the query or the list is empty. `error` is what the latest failed load threw, untouched (`null` when none)."},
 		{"name":"footer","type":"BbSelectPanelSlotProps","fields":["close: () => Promise<void>","clear: () => void","focus: () => void","query: string","selectedOptions: BbSelectResolvedOption[]"],"description":"Content pinned to the bottom of the options panel, below the options list. Rendered in both the desktop popover and the adaptive sheet."},
@@ -98,7 +98,7 @@
 		{"name":"header","type":"BbSelectPanelSlotProps","fields":["close: () => Promise<void>","clear: () => void","focus: () => void","query: string","selectedOptions: BbSelectResolvedOption[]"],"description":"Content pinned to the top of the options panel, above the search field. Rendered in both the desktop popover and the adaptive sheet."},
 		{"name":"label","type":"BbSelectLabelSlotProps","fields":["showAsterisk?: boolean","text: string","hasErrors: boolean","hasWarnings: boolean"],"description":"Replaces the default label text rendered above the input."},
 		{"name":"loading","type":"{ query: string; }","description":"Content shown inside the options dropdown while items are loading."},
-		{"name":"option","type":"BbSelectOptionSlotProps<T>","fields":["disabled: boolean","focused: boolean","index: number","hasErrors?: boolean","item: T","loading: boolean","selected: boolean","text: string","value: any","description: string"],"description":"Replaces the default rendering of each option row in the dropdown."},
+		{"name":"option","type":"BbSelectOptionSlotProps<T, Known>","fields":["known: boolean","item: T | BbSelectKnownItem","disabled: boolean","focused: boolean","index: number","hasErrors?: boolean","loading: boolean","selected: boolean","text: string","value: any","description: string"],"description":"Replaces the default rendering of each option row in the dropdown. With `known-items` bound, a row the list has not brought yet is the known `{ value, label }` row, `known: true`: check `known` before reading an option field off `item`."},
 		{"name":"prefix","type":"object","description":"Content rendered as an inline prefix inside the input field."},
 		{"name":"prepend","type":"{ query: string; focus: () => void; close: () => Promise<void>; }","description":"Content prepended inside the input field, before the value area."},
 		{"name":"prepend:outer","type":"{ query: string; close: () => Promise<void>; }","description":"Content prepended outside the input field wrapper."},
@@ -117,23 +117,23 @@
 			{"name":"hint","common":true},
 			{"name":"box","common":true},
 			{"name":"activator","description":"The button you act on to open the options — the field's control (not a text field: `data-test` fits here, `autocomplete` does not). The chevron is chrome. It is `activator`, not the family's `input`: the field itself is a button (the date / time inputs' trigger is the same word)."},
-			{"name":"input","description":"The search field inside the options surface, when it shows one (see `disable-writing`) — handed to the `BbSelectPopover` as its own `pt:input`. Its ✕ is chrome."},
+			{"name":"input","description":"The search field inside the options surface, when it shows one (see `disable-writing`) — handed to the `BbSelectPopover` as its own `pt:input`. Its ✕ is chrome.","states":["disabled","errors","hasValue","loading","open","readonly","selected","warnings"]},
 			{"name":"icon","common":true},
 			{"name":"spinner","common":true},
 			{"name":"prefix","common":true},
 			{"name":"suffix","common":true},
 			{"name":"clear","description":"The ✕ in the field that empties the selection (`clearable`) — one node, never a chip's own ✕."},
-			{"name":"panel","description":"The options surface — the popover's painted bubble on desktop, the sheet itself on a phone."},
-			{"name":"sheet","description":"The bottom sheet the options open in on a phone only."},
-			{"name":"header","description":"The band around your `#header` slot: at the top of the flyout on desktop, the sheet's header on a phone."},
-			{"name":"footer","description":"The band around your `#footer` slot: at the bottom of the flyout on desktop, the sheet's footer on a phone."},
-			{"name":"list","description":"The `role=\"listbox\"` node that holds the options. Virtualised: its height is written inline and its rows are positioned by the list, which limits what a layout utility can do there. The listbox's groups and the chips are not parts."},
-			{"name":"option","description":"One listbox option — a broadcast resolved per option. Also takes a per-item function, called with the option's raw item.","rowType":"PtValue | ((ctx: PtItemCtx<T, BbSelectPtState>) => PtItemResult) | undefined"},
-			{"name":"itemText","description":"An option's label — resolved with that option's states. A custom `#option` slot replaces it. Also takes a per-item function.","rowType":"PtValue | ((ctx: PtItemCtx<T, BbSelectPtState>) => PtItemResult) | undefined"},
-			{"name":"itemIcon","description":"An option's prepend / append icons (`itemProps`) — resolved with that option's states. Also takes a per-item function.","rowType":"PtValue | ((ctx: PtItemCtx<T, BbSelectPtState>) => PtItemResult) | undefined"},
-			{"name":"itemDescription","description":"An option's second line (its description) — resolved with that option's states. A custom `#option` slot replaces it. Also takes a per-item function.","rowType":"PtValue | ((ctx: PtItemCtx<T, BbSelectPtState>) => PtItemResult) | undefined"},
-			{"name":"badge","description":"Each selected value's `BbBadge` root with `multiple` — a broadcast resolved per value, on the field's chips and on the phone sheet's. The badge's own ✕ is chrome, never `clear`. In the field, not rendered when the `#chip` slot replaces it, nor in `comma` mode; the sheet's chips are always badges.","rowType":"PtValue | ((ctx: PtItemCtx<T, BbSelectPtState>) => PtItemResult) | undefined"},
-			{"name":"comma","description":"Each selected value with `multiple` and `comma` — a broadcast resolved per value.","rowType":"PtValue | ((ctx: PtItemCtx<T, BbSelectPtState>) => PtItemResult) | undefined"}
+			{"name":"panel","description":"The options surface — the popover's painted bubble on desktop, the sheet itself on a phone.","states":["disabled","errors","hasValue","loading","open","readonly","selected","warnings"]},
+			{"name":"sheet","description":"The bottom sheet the options open in on a phone only.","states":["disabled","errors","hasValue","loading","open","readonly","selected","warnings"]},
+			{"name":"header","description":"The band around your `#header` slot: at the top of the flyout on desktop, the sheet's header on a phone.","states":["disabled","errors","hasValue","loading","open","readonly","selected","warnings"]},
+			{"name":"footer","description":"The band around your `#footer` slot: at the bottom of the flyout on desktop, the sheet's footer on a phone.","states":["disabled","errors","hasValue","loading","open","readonly","selected","warnings"]},
+			{"name":"list","description":"The `role=\"listbox\"` node that holds the options. Virtualised: its height is written inline and its rows are positioned by the list, which limits what a layout utility can do there. The listbox's groups and the chips are not parts.","states":["disabled","errors","hasValue","loading","open","readonly","selected","warnings"]},
+			{"name":"option","description":"One listbox option — a broadcast resolved per option. Also takes a per-item function, called with the option's raw item.","states":["disabled","errors","hasValue","loading","open","readonly","selected","warnings"],"rowType":"PtValue | ((ctx: PtItemCtx<T, BbSelectPtState, never, BbSelectSlotRow<T, Known>>) => PtItemResult) | undefined"},
+			{"name":"itemText","description":"An option's label — resolved with that option's states. A custom `#option` slot replaces it. Also takes a per-item function.","states":["disabled","errors","hasValue","loading","open","readonly","selected","warnings"],"rowType":"PtValue | ((ctx: PtItemCtx<T, BbSelectPtState, never, BbSelectSlotRow<T, Known>>) => PtItemResult) | undefined"},
+			{"name":"itemIcon","description":"An option's prepend / append icons (`itemProps`) — resolved with that option's states. Also takes a per-item function.","states":["disabled","errors","hasValue","loading","open","readonly","selected","warnings"],"rowType":"PtValue | ((ctx: PtItemCtx<T, BbSelectPtState, never, BbSelectSlotRow<T, Known>>) => PtItemResult) | undefined"},
+			{"name":"itemDescription","description":"An option's second line (its description) — resolved with that option's states. A custom `#option` slot replaces it. Also takes a per-item function.","states":["disabled","errors","hasValue","loading","open","readonly","selected","warnings"],"rowType":"PtValue | ((ctx: PtItemCtx<T, BbSelectPtState, never, BbSelectSlotRow<T, Known>>) => PtItemResult) | undefined"},
+			{"name":"badge","description":"Each selected value's `BbBadge` root with `multiple` — a broadcast resolved per value, on the field's chips and on the phone sheet's. The badge's own ✕ is chrome, never `clear`. In the field, not rendered when the `#chip` slot replaces it, nor in `comma` mode; the sheet's chips are always badges.","states":["disabled","errors","hasValue","loading","open","readonly","selected","warnings"],"rowType":"PtValue | ((ctx: PtItemCtx<T, BbSelectPtState, never, BbSelectSlotRow<T, Known>>) => PtItemResult) | undefined"},
+			{"name":"comma","description":"Each selected value with `multiple` and `comma` — a broadcast resolved per value.","states":["disabled","errors","hasValue","loading","open","readonly","selected","warnings"],"rowType":"PtValue | ((ctx: PtItemCtx<T, BbSelectPtState, never, BbSelectSlotRow<T, Known>>) => PtItemResult) | undefined"}
 		],
 		"states": [
 			{"name":"hasValue","description":"Component-wide: the control holds a value, by its own rule (`0` counts on `BbNumberInput`, `''` on `BbColorInput`)."},
@@ -143,7 +143,10 @@
 			{"name":"warnings","description":"Component-wide: the control is in its warning state (`warnings` / `has-warnings`) and not in an error state — errors win, so the two are never on together."},
 			{"name":"errors","description":"Component-wide: the control is in its error state (`errors` / `has-errors`, or its validation) — the message line and the box turn red."},
 			{"name":"open","description":"Component-wide: the options surface is showing."},
-			{"name":"loading","description":"Component-wide: `loading` is on; the box shows its `spinner`."}
+			{"name":"loading","description":"Component-wide: `loading` is on; the box shows its `spinner`."},
+			{"name":"ghost","description":"On the field's parts: `variant: 'ghost'`. Below the real states, like every variant."},
+			{"name":"outline","description":"On the field's parts: `variant: 'outline'`. Merged after the part's base entry and before its states, so the real states still win."},
+			{"name":"secondary","description":"On the field's parts: `variant: 'secondary'`. Below the real states, like every variant."}
 		]
 	},
 	"attrTargets": [
@@ -154,7 +157,7 @@
 		{"name":"BbOffCanvasProps","usedAs":["prop offCanvasProps"]},
 		{"name":"BbSelectItemProps","usedAs":["prop itemProps"],"definition":"type BbSelectItemProps<T = any> = ItemProps<T, SelectItemFields>;","fields":["description?: ItemAccessor<T, string | null | undefined>","prepend:icon?: ItemAccessor<T, string | null | undefined>","append:icon?: ItemAccessor<T, string | null | undefined>"]},
 		{"name":"BbSelectItemsContext","usedAs":["prop items"],"definition":"type BbSelectItemsContext<M = any> = BbItemsProviderContext<M> & { query: string; reason: 'search' | 'initial' | 'dependencies' | 'model' | 'reopen'; };"},
-		{"name":"BbSelectKnownItem","usedAs":["prop knownItems"],"definition":"type BbSelectKnownItem = { value: unknown; label: string; };"},
+		{"name":"BbSelectSlotRow","usedAs":["prop pt","prop pt:badge","prop pt:comma","prop pt:itemDescription","prop pt:itemIcon","prop pt:itemText","prop pt:option"],"definition":"type BbSelectSlotRow<Item, Known extends BbSelectKnownItems | undefined = BbSelectKnownItems> = [ Known ] extends [ undefined ] ? { known: false; item: Item; } : { known: true; item: BbSelectKnownItem; } | { known: false; item: Item; };"},
 		{"name":"FieldLayout","usedAs":["prop layout"],"definition":"type FieldLayout = 'auto' | 'horizontal' | 'vertical' | 'label-fill' | 'input-fill' | `${string} ${string}`;"},
 		{"name":"InputVariantType","usedAs":["prop variant"],"definition":"type InputVariantType = InputVariantFromRegistry | 'none';","values":["outline","secondary","ghost","none"],"extensibleVia":"InputVariantRegistry"},
 		{"name":"Responsive","usedAs":["prop layout"],"definition":"type Responsive<V> = V | Partial<Record<Breakpoint | 'default', V>>;"},

package/dist/ai/manifest/components/BbSelect.tree.json

@@ -17,8 +17,8 @@
 		"nodes": [
 			{"name":"CommonField","kind":"internal","vocabulary":"BbSelect","bindings":[{"part":"root","target":"div.bb-field"},{"part":"label","target":"component"},{"part":"description","target":"span.bb-field__description"},{"part":"hint","target":"span.bb-field__hint"},{"part":"counter","target":"span.bb-field__counter"},{"part":"message","target":"div.bb-field__message"}],"cssProps":[{"name":"--ctrl-line","documented":true,"readBy":["bb-field__label","bb-field__input-wrapper"]}],"children":[{"name":"BbAsterisk","kind":"public"}]},
 			{"name":"CommonFieldInput","kind":"internal","vocabulary":"BbSelect","bindings":[{"part":"box","target":"span.bb-field-input__box"},{"part":"prefix","target":"span.bb-field-input__prefix"},{"part":"icon","target":"BbIcon"},{"part":"clear","target":"ClearableButton"},{"part":"spinner","target":"BbSpinner"},{"part":"suffix","target":"span.bb-field-input__suffix"}],"cssProps":[{"name":"--bg","documented":true,"readBy":["bb-field-input","bb-field-input__box"]},{"name":"--bg-hover","documented":true,"readBy":["bb-field-input__box"]},{"name":"--bg-focus","documented":true,"readBy":["bb-field-input__box"]},{"name":"--bg-disabled","documented":true,"readBy":["bb-field-input__box"]},{"name":"--fg-disabled","documented":true,"readBy":["bb-field-input__box","bb-field-input__prefix","bb-field-input__suffix","bb-field-input__prepend-icon","bb-field-input__append-icon"]},{"name":"--border-color","documented":true,"readBy":["bb-field-input","bb-field-input__box"]},{"name":"--border-focus","documented":true,"readBy":["bb-field-input__box"]},{"name":"--ring-size","documented":true,"readBy":["bb-field-input__box"]},{"name":"--ring-color","documented":true,"readBy":["bb-field-input__box"]},{"name":"--elev","documented":true,"readBy":["bb-field-input__box"]},{"name":"--frost","documented":true,"readBy":["bb-field-input__box"]},{"name":"--inside-label-clearance","documented":true,"readBy":["bb-field-input__box","bb-field-input__prefix","bb-field-input__suffix"]}],"children":[{"name":"ErrorIcon","kind":"internal","cssProps":[{"name":"--accent","documented":false,"readBy":["bb-error-icon"]}],"children":[{"name":"BbIcon","kind":"public","cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]}]},{"name":"WarningIcon","kind":"internal","cssProps":[{"name":"--accent","documented":false,"readBy":["bb-warning-icon"]}],"children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]}]},{"name":"ClearableButton","kind":"internal","children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]}]},{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"BbSpinner","kind":"public","children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]}]}]},
-			{"name":"BbBadge","kind":"public","vocabulary":"BbBadge","bindings":[{"part":"spinner","target":"BbSpinner"},{"part":"icon","target":"BbIcon"},{"part":"clear","target":"button.bb-badge__clear"}],"cssProps":[{"name":"--bg","documented":true,"readBy":["bb-badge"]},{"name":"--fg","documented":true,"readBy":["bb-badge","bb-badge__clear"]},{"name":"--bw","documented":true,"readBy":["bb-badge","bb-badge__clear"]},{"name":"--border-color","documented":false,"readBy":["bb-badge"]},{"name":"--ring-color","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--ring-size","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--min-size-md","documented":true,"readBy":["bb-badge"]},{"name":"--min-size","documented":true,"readBy":["bb-badge"]},{"name":"--elev","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--r","documented":true,"readBy":["bb-badge","bb-badge__body","bb-badge__trailing","bb-badge__clear"]},{"name":"--fs","documented":true,"readBy":["bb-badge"]},{"name":"--icon-size","documented":true,"readBy":["bb-badge__icon","bb-badge__prepend-icon","bb-badge__append-icon","bb-badge__clear"]},{"name":"--gap","documented":true,"readBy":["bb-badge","bb-badge__body","bb-badge__trailing","bb-badge__clear"]},{"name":"--px","documented":true,"readBy":["bb-badge","bb-badge--icon","bb-badge__prepend-icon","bb-badge__append-icon","bb-badge--clearable"]},{"name":"--clear-size","documented":true,"readBy":["bb-badge__clear","bb-icon"]},{"name":"--bg-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--fg-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--border-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--pad-left","documented":true,"readBy":["bb-badge__body"]},{"name":"--pad-right","documented":false,"readBy":["bb-badge__body","bb-badge__clear"]},{"name":"--size","documented":false}],"children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"BbSpinner","kind":"public","repeated":true},{"name":"BadgeBodyContent","kind":"internal","children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"BbSpinner","kind":"public","repeated":true}]}]},
-			{"name":"BbSelectPopover","kind":"public","vocabulary":"BbSelectPopover","bindings":[{"part":"input","target":"input.bb-select-popover__input"},{"part":"clear","target":"ClearableButton"},{"part":"panel","target":"CommonPopover"},{"part":"root","target":"CommonPopover"},{"part":"header","target":"div.bb-select-popover__header"},{"part":"footer","target":"div.bb-select-popover__footer"}],"forwards":[{"to":"BbOffCanvas","mapping":"{ header: 'header', footer: 'footer', panel: 'root', sheet: 'root' }"}],"cssProps":[{"name":"--bg","documented":false,"readBy":["bb-listbox__outer-container"]},{"name":"--min-size","documented":false},{"name":"--px","documented":false},{"name":"--clear-size","documented":false}],"children":[{"name":"BbBadge","kind":"public","repeated":true,"cssProps":[{"name":"--bg","documented":true,"readBy":["bb-badge"]},{"name":"--fg","documented":true,"readBy":["bb-badge","bb-badge__clear"]},{"name":"--bw","documented":true,"readBy":["bb-badge","bb-badge__clear"]},{"name":"--border-color","documented":false,"readBy":["bb-badge"]},{"name":"--ring-color","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--ring-size","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--min-size-md","documented":true,"readBy":["bb-badge"]},{"name":"--min-size","documented":true,"readBy":["bb-badge"]},{"name":"--elev","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--r","documented":true,"readBy":["bb-badge","bb-badge__body","bb-badge__trailing","bb-badge__clear"]},{"name":"--fs","documented":true,"readBy":["bb-badge"]},{"name":"--icon-size","documented":true,"readBy":["bb-badge__icon","bb-badge__prepend-icon","bb-badge__append-icon","bb-badge__clear"]},{"name":"--gap","documented":true,"readBy":["bb-badge","bb-badge__body","bb-badge__trailing","bb-badge__clear"]},{"name":"--px","documented":true,"readBy":["bb-badge","bb-badge--icon","bb-badge__prepend-icon","bb-badge__append-icon","bb-badge--clearable"]},{"name":"--clear-size","documented":true,"readBy":["bb-badge__clear","bb-icon"]},{"name":"--bg-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--fg-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--border-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--pad-left","documented":true,"readBy":["bb-badge__body"]},{"name":"--pad-right","documented":false,"readBy":["bb-badge__body","bb-badge__clear"]},{"name":"--size","documented":false}]},{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"BbOffCanvas","kind":"public","vocabulary":"BbOffCanvas","bindings":[{"part":"header","target":"div.bb-offcanvas__header"},{"part":"title","target":"span.bb-offcanvas__title"},{"part":"description","target":"p.bb-offcanvas__description"},{"part":"close","target":"CloseButton"},{"part":"content","target":"div.bb-offcanvas__content"},{"part":"footer","target":"div.bb-offcanvas__footer"}],"cssProps":[{"name":"--translate-x","documented":false,"readBy":["bb-offcanvas"]},{"name":"--translate-y","documented":false,"readBy":["bb-offcanvas"]},{"name":"--translate","documented":false,"readBy":["bb-offcanvas"]},{"name":"--stack-x","documented":true,"readBy":["bb-offcanvas"]},{"name":"--stack-y","documented":false,"readBy":["bb-offcanvas"]},{"name":"--snap-y","documented":true,"readBy":["bb-offcanvas","bb-offcanvas__footer","bb-offcanvas--snap","bb-offcanvas--bottom"]},{"name":"--snap-floor","documented":false,"readBy":["bb-offcanvas__footer"]},{"name":"--stack-fill","documented":true,"readBy":["bb-offcanvas","bb-offcanvas--right","bb-offcanvas--left","bb-offcanvas--top","bb-offcanvas--bottom"]},{"name":"--stack-transition-duration","documented":true,"readBy":["bb-offcanvas"]},{"name":"--px","documented":true,"readBy":["bb-offcanvas__header","bb-close-button","bb-offcanvas__content","bb-offcanvas__footer"]},{"name":"--py","documented":false,"readBy":["bb-offcanvas__footer","bb-offcanvas__content","bb-offcanvas__header","bb-close-button"]},{"name":"--handle-w","documented":true,"readBy":["bb-offcanvas__handle"]},{"name":"--handle-h","documented":true,"readBy":["bb-offcanvas__handle"]},{"name":"--handle-bg","documented":true,"readBy":["bb-offcanvas__handle"]},{"name":"--transition-timing-function","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--open"]},{"name":"--bg","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--snap","bb-offcanvas--bottom"]},{"name":"--fg","documented":false,"readBy":["bb-offcanvas"]},{"name":"--safe-top","documented":true,"readBy":["bb-offcanvas","bb-offcanvas--left","bb-offcanvas--right","bb-offcanvas--top","bb-offcanvas--fullscreen"]},{"name":"--safe-right","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--right","bb-offcanvas--top","bb-offcanvas--bottom","bb-offcanvas--fullscreen"]},{"name":"--safe-bottom","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--left","bb-offcanvas--right","bb-offcanvas--bottom","bb-offcanvas--fullscreen"]},{"name":"--safe-left","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--left","bb-offcanvas--top","bb-offcanvas--bottom","bb-offcanvas--fullscreen"]},{"name":"--inset-top","documented":false,"readBy":["bb-offcanvas__content","bb-offcanvas__header"]},{"name":"--inset-right","documented":false,"readBy":["bb-offcanvas__header","bb-offcanvas__content","bb-offcanvas__footer"]},{"name":"--inset-bottom","documented":false,"readBy":["bb-offcanvas__footer","bb-offcanvas__content"]},{"name":"--inset-left","documented":false,"readBy":["bb-offcanvas__header","bb-offcanvas__content","bb-offcanvas__footer"]},{"name":"--close-size","documented":true,"readBy":["bb-close-button"]},{"name":"--gap","documented":false,"readBy":["bb-offcanvas__footer"]}],"children":[{"name":"CloseButton","kind":"internal","cssProps":[{"name":"--size","documented":true,"readBy":["bb-close-button"]},{"name":"--p","documented":true,"readBy":["bb-close-button"]}]}]},{"name":"ClearableButton","kind":"internal","repeated":true},{"name":"CommonPopover","kind":"internal"},{"name":"ErrorIcon","kind":"internal","repeated":true,"cssProps":[{"name":"--accent","documented":false,"readBy":["bb-error-icon"]}]},{"name":"WarningIcon","kind":"internal","repeated":true,"cssProps":[{"name":"--accent","documented":false,"readBy":["bb-warning-icon"]}]},{"name":"ListBox","kind":"internal","children":[{"name":"FlatListBox","kind":"internal","vocabulary":"BbSelectPopover","bindings":[{"part":"list","target":"span.bb-listbox__list"},{"part":"option","target":"span.bb-listbox__option"},{"part":"itemIcon","target":"BbIcon"},{"part":"itemText","target":"span.bb-listbox__item-text"},{"part":"itemDescription","target":"span.bb-listbox__item-description"}],"children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"ErrorIcon","kind":"internal","repeated":true,"cssProps":[{"name":"--accent","documented":false,"readBy":["bb-error-icon"]}]}]},{"name":"GroupedListBox","kind":"internal","vocabulary":"BbSelectPopover","bindings":[{"part":"list","target":"span.bb-listbox__list"},{"part":"option","target":"span.bb-listbox__option"},{"part":"itemIcon","target":"BbIcon"},{"part":"itemText","target":"span.bb-listbox__item-text"},{"part":"itemDescription","target":"span.bb-listbox__item-description"}],"children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"ErrorIcon","kind":"internal","repeated":true,"cssProps":[{"name":"--accent","documented":false,"readBy":["bb-error-icon"]}]}]}]},{"name":"BbSmoothHeight","kind":"public"}]}
+			{"name":"BbBadge","kind":"public","vocabulary":"BbBadge","bindings":[{"part":"spinner","target":"BbSpinner"},{"part":"icon","target":"span.bb-badge__append-icon"},{"part":"icon","target":"BbIcon"},{"part":"clear","target":"button.bb-badge__clear"}],"cssProps":[{"name":"--bg","documented":true,"readBy":["bb-badge"]},{"name":"--fg","documented":true,"readBy":["bb-badge","bb-badge__clear"]},{"name":"--bw","documented":true,"readBy":["bb-badge","bb-badge__clear"]},{"name":"--border-color","documented":false,"readBy":["bb-badge"]},{"name":"--ring-color","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--ring-size","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--min-size-md","documented":true,"readBy":["bb-badge"]},{"name":"--min-size","documented":true,"readBy":["bb-badge"]},{"name":"--elev","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--r","documented":true,"readBy":["bb-badge","bb-badge__body","bb-badge__trailing","bb-badge__clear"]},{"name":"--fs","documented":true,"readBy":["bb-badge"]},{"name":"--icon-size","documented":true,"readBy":["bb-badge__icon","bb-badge__prepend-icon","bb-badge__append-icon","bb-badge__icon-slot","bb-icon","bb-badge__clear"]},{"name":"--gap","documented":true,"readBy":["bb-badge","bb-badge__body","bb-badge__trailing","bb-badge__clear"]},{"name":"--px","documented":true,"readBy":["bb-badge","bb-badge--icon","bb-badge__prepend-icon","bb-badge__append-icon","bb-badge--clearable"]},{"name":"--clear-size","documented":true,"readBy":["bb-badge__clear","bb-icon"]},{"name":"--bg-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--fg-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--border-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--pad-left","documented":true,"readBy":["bb-badge__body"]},{"name":"--pad-right","documented":false,"readBy":["bb-badge__body","bb-badge__clear"]},{"name":"--size","documented":false}],"children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"BbSpinner","kind":"public","repeated":true},{"name":"BadgeBodyContent","kind":"internal","children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"BbSpinner","kind":"public","repeated":true}]}]},
+			{"name":"BbSelectPopover","kind":"public","vocabulary":"BbSelectPopover","bindings":[{"part":"input","target":"input.bb-select-popover__input"},{"part":"clear","target":"ClearableButton"},{"part":"panel","target":"CommonPopover"},{"part":"root","target":"CommonPopover"},{"part":"header","target":"div.bb-select-popover__header"},{"part":"footer","target":"div.bb-select-popover__footer"}],"forwards":[{"to":"BbOffCanvas","mapping":"{ header: 'header', footer: 'footer', panel: 'root', sheet: 'root' }"}],"cssProps":[{"name":"--bg","documented":false,"readBy":["bb-listbox__outer-container"]},{"name":"--min-size","documented":false},{"name":"--px","documented":false},{"name":"--clear-size","documented":false}],"children":[{"name":"BbBadge","kind":"public","repeated":true,"cssProps":[{"name":"--bg","documented":true,"readBy":["bb-badge"]},{"name":"--fg","documented":true,"readBy":["bb-badge","bb-badge__clear"]},{"name":"--bw","documented":true,"readBy":["bb-badge","bb-badge__clear"]},{"name":"--border-color","documented":false,"readBy":["bb-badge"]},{"name":"--ring-color","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--ring-size","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--min-size-md","documented":true,"readBy":["bb-badge"]},{"name":"--min-size","documented":true,"readBy":["bb-badge"]},{"name":"--elev","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--r","documented":true,"readBy":["bb-badge","bb-badge__body","bb-badge__trailing","bb-badge__clear"]},{"name":"--fs","documented":true,"readBy":["bb-badge"]},{"name":"--icon-size","documented":true,"readBy":["bb-badge__icon","bb-badge__prepend-icon","bb-badge__append-icon","bb-badge__icon-slot","bb-icon","bb-badge__clear"]},{"name":"--gap","documented":true,"readBy":["bb-badge","bb-badge__body","bb-badge__trailing","bb-badge__clear"]},{"name":"--px","documented":true,"readBy":["bb-badge","bb-badge--icon","bb-badge__prepend-icon","bb-badge__append-icon","bb-badge--clearable"]},{"name":"--clear-size","documented":true,"readBy":["bb-badge__clear","bb-icon"]},{"name":"--bg-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--fg-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--border-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--pad-left","documented":true,"readBy":["bb-badge__body"]},{"name":"--pad-right","documented":false,"readBy":["bb-badge__body","bb-badge__clear"]},{"name":"--size","documented":false}]},{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"BbOffCanvas","kind":"public","vocabulary":"BbOffCanvas","bindings":[{"part":"header","target":"div.bb-offcanvas__header"},{"part":"title","target":"span.bb-offcanvas__title"},{"part":"description","target":"p.bb-offcanvas__description"},{"part":"close","target":"CloseButton"},{"part":"content","target":"div.bb-offcanvas__content"},{"part":"footer","target":"div.bb-offcanvas__footer"}],"cssProps":[{"name":"--translate-x","documented":false,"readBy":["bb-offcanvas"]},{"name":"--translate-y","documented":false,"readBy":["bb-offcanvas"]},{"name":"--translate","documented":false,"readBy":["bb-offcanvas"]},{"name":"--stack-x","documented":true,"readBy":["bb-offcanvas"]},{"name":"--stack-y","documented":false,"readBy":["bb-offcanvas"]},{"name":"--snap-y","documented":true,"readBy":["bb-offcanvas","bb-offcanvas__footer","bb-offcanvas--snap","bb-offcanvas--bottom"]},{"name":"--snap-floor","documented":false,"readBy":["bb-offcanvas__footer"]},{"name":"--stack-fill","documented":true,"readBy":["bb-offcanvas","bb-offcanvas--right","bb-offcanvas--left","bb-offcanvas--top","bb-offcanvas--bottom"]},{"name":"--stack-transition-duration","documented":true,"readBy":["bb-offcanvas"]},{"name":"--px","documented":true,"readBy":["bb-offcanvas__header","bb-close-button","bb-offcanvas__content","bb-offcanvas__footer"]},{"name":"--py","documented":false,"readBy":["bb-offcanvas__footer","bb-offcanvas__content","bb-offcanvas__header","bb-close-button"]},{"name":"--handle-w","documented":true,"readBy":["bb-offcanvas__handle"]},{"name":"--handle-h","documented":true,"readBy":["bb-offcanvas__handle"]},{"name":"--handle-bg","documented":true,"readBy":["bb-offcanvas__handle"]},{"name":"--transition-timing-function","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--open"]},{"name":"--bg","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--snap","bb-offcanvas--bottom"]},{"name":"--fg","documented":false,"readBy":["bb-offcanvas"]},{"name":"--safe-top","documented":true,"readBy":["bb-offcanvas","bb-offcanvas--left","bb-offcanvas--right","bb-offcanvas--top","bb-offcanvas--fullscreen"]},{"name":"--safe-right","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--right","bb-offcanvas--top","bb-offcanvas--bottom","bb-offcanvas--fullscreen"]},{"name":"--safe-bottom","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--left","bb-offcanvas--right","bb-offcanvas--bottom","bb-offcanvas--fullscreen"]},{"name":"--safe-left","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--left","bb-offcanvas--top","bb-offcanvas--bottom","bb-offcanvas--fullscreen"]},{"name":"--inset-top","documented":false,"readBy":["bb-offcanvas__content","bb-offcanvas__header"]},{"name":"--inset-right","documented":false,"readBy":["bb-offcanvas__header","bb-offcanvas__content","bb-offcanvas__footer"]},{"name":"--inset-bottom","documented":false,"readBy":["bb-offcanvas__footer","bb-offcanvas__content"]},{"name":"--inset-left","documented":false,"readBy":["bb-offcanvas__header","bb-offcanvas__content","bb-offcanvas__footer"]},{"name":"--close-size","documented":true,"readBy":["bb-close-button"]},{"name":"--gap","documented":false,"readBy":["bb-offcanvas__footer"]}],"children":[{"name":"CloseButton","kind":"internal","cssProps":[{"name":"--size","documented":true,"readBy":["bb-close-button"]},{"name":"--p","documented":true,"readBy":["bb-close-button"]}]}]},{"name":"ClearableButton","kind":"internal","repeated":true},{"name":"CommonPopover","kind":"internal"},{"name":"ErrorIcon","kind":"internal","repeated":true,"cssProps":[{"name":"--accent","documented":false,"readBy":["bb-error-icon"]}]},{"name":"WarningIcon","kind":"internal","repeated":true,"cssProps":[{"name":"--accent","documented":false,"readBy":["bb-warning-icon"]}]},{"name":"ListBox","kind":"internal","children":[{"name":"FlatListBox","kind":"internal","vocabulary":"BbSelectPopover","bindings":[{"part":"list","target":"span.bb-listbox__list"},{"part":"option","target":"span.bb-listbox__option"},{"part":"itemIcon","target":"BbIcon"},{"part":"itemText","target":"span.bb-listbox__item-text"},{"part":"itemDescription","target":"span.bb-listbox__item-description"}],"children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"ErrorIcon","kind":"internal","repeated":true,"cssProps":[{"name":"--accent","documented":false,"readBy":["bb-error-icon"]}]}]},{"name":"GroupedListBox","kind":"internal","vocabulary":"BbSelectPopover","bindings":[{"part":"list","target":"span.bb-listbox__list"},{"part":"option","target":"span.bb-listbox__option"},{"part":"itemIcon","target":"BbIcon"},{"part":"itemText","target":"span.bb-listbox__item-text"},{"part":"itemDescription","target":"span.bb-listbox__item-description"}],"children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"ErrorIcon","kind":"internal","repeated":true,"cssProps":[{"name":"--accent","documented":false,"readBy":["bb-error-icon"]}]}]}]},{"name":"BbSmoothHeight","kind":"public"}]}
 		]
 	},
 	"css": {

package/dist/ai/manifest/components/BbSelectPopover.json

@@ -35,7 +35,7 @@
 		{"name":"items","type":"Item[] | ((context: BbSelectPopoverItemsContext) => Item[] | Promise<Item[]>)","required":true,"default":"[]","description":"The options: an array, or a sync or async provider given a `BbSelectPopoverItemsContext` (`query`, `reason`, `modelValue`, `signal`). Branch on `reason !== 'search'` to resolve the selection by id. A provider fails by THROWING, never by returning `[]`."},
 		{"name":"itemText","type":"ItemAccessor<Item, string>","default":"own `label`, else `text`, else `JSON.stringify(item)`","description":"Path to item property for display text or function to extract it.\n\nUnset: own `label`, else `text` (`{ label, value }` needs no accessor)."},
 		{"name":"itemValue","type":"ItemAccessor<Item>","default":"own `value`, else the whole item","description":"Path to item property for value or function to extract it.\n\nUnset: own `value`, even `null`."},
-		{"name":"knownItems","type":"(BbSelectKnownItem | null | undefined)[]","description":"`{ value, label }` rows naming the value the app already holds, whatever the options' shape: the activator's `text` with no request until the first open (`prefill: true` still loads). Not options; the options' accessors never run on them; slots get the row as `item` until the list brings its own."},
+		{"name":"knownItems","type":"([Known] extends [undefined] ? BbSelectKnownItems : Known)","description":"`{ value, label }` rows naming the value the app already holds, whatever the options' shape: the activator's `text` with no request until the first open (`prefill: true` still loads). Not options: accessors never run on them; slots get one as `item`, `known: true`, until the list brings its own."},
 		{"name":"loading","type":"boolean","default":"false","description":"Display the loading state styles."},
 		{"name":"loadingText","type":"string","description":"Message shown while items are being loaded."},
 		{"name":"max","type":"number","default":"Infinity","description":"Maximum number of selectable items (limits selection when `multiple` is true)."},
@@ -47,7 +47,7 @@
 		{"name":"padding","type":"number","default":"10","description":"Minimum page padding used by floating shift middleware."},
 		{"name":"placement","type":"Placement","default":"\"bottom\"","values":["top","bottom","left","right","top-start","top-end","right-start","right-end","bottom-start","bottom-end","left-start","left-end"],"description":"Floating placement of the popover."},
 		{"name":"prefill","type":"boolean | \"interaction\"","default":"\"interaction\"","description":"When the options first load: `'interaction'` on first open, `true` on mount (and in SSR), `false` once the user types (on open with `disable-writing` or a non-empty model). An array `items` always resolves on mount; else a seeded model's text waits for the first open."},
-		{"name":"pt","type":"PtItemMap<BbSelectPopoverPtPart, BbSelectPopoverOptionPtPart, BbSelectPopoverPtState, Item>","description":"Passthrough, object form: the same keys as the `pt:*` attributes without the prefix. See the `pt:<part>` row."},
+		{"name":"pt","type":"PtItemMap<BbSelectPopoverPtPart, BbSelectPopoverOptionPtPart, BbSelectPopoverPtState, Item, never, BbSelectSlotRow<Item, Known>>","description":"Passthrough, object form: the same keys as the `pt:*` attributes without the prefix. See the `pt:<part>` row."},
 		{"name":"queryDebounceTime","type":"number","default":"500","description":"Debounce delay (ms) before triggering search queries after user input stops."},
 		{"name":"readonly","type":"boolean","default":"false","description":"Prevents opening the popover while keeping the activator accessible."},
 		{"name":"searchInputAriaLabel","type":"string","default":"`t('select.searchLabel')` (`'Search options'`)","description":"Accessible label used by the search input rendered inside the popover. Falls back to the localized `select.searchLabel` key when omitted."},
@@ -74,11 +74,11 @@
 	"slots": [
 		{"name":"activator","type":"BbSelectPopoverActivatorSlotProps","fields":["clear: () => void","close: () => Promise<void>","focus: () => void","disabled: boolean","loading: boolean","open: () => Promise<void>","props: { ref: (reference: unknown) => void; }","query: string","readonly: boolean","selectedOptions: BbSelectResolvedOption<any>[]","shown: boolean","text: string","toggle: () => Promise<void>"],"description":"Replaces the default trigger element that opens the select popover."},
 		{"name":"empty","type":"{ query: string; focus: () => void; error: unknown; }","description":"Content shown when no options match the query or the list is empty. `error` is what the latest failed load threw, untouched (`null` when none)."},
-		{"name":"footer","type":"BbSelectPopoverPanelSlotProps","fields":["close: () => Promise<void>","clear: () => void","focus: () => void","query: string","selectedOptions: BbSelectResolvedOption<any>[]"],"description":"Content pinned to the bottom of the panel, below the options list. Rendered in both the desktop popover and the adaptive sheet."},
+		{"name":"footer","type":"BbSelectPopoverPanelSlotProps","fields":["close: () => Promise<void>","clear: () => void","focus: () => void","query: string","selectedOptions: BbSelectResolvedOption<any>[]","titleId: string"],"description":"Content pinned to the bottom of the panel, below the options list. Rendered in both the desktop popover and the adaptive sheet."},
 		{"name":"group","type":"BbSelectPopoverGroupSlotProps<Item>","fields":["disabled: boolean","index: number","item: Item","length: number","text: string"],"description":"Replaces the default group header rendered above grouped options. Not called for rows with no group (`group-by` gives `null`/`undefined`, known rows): they are listed without a header."},
-		{"name":"header","type":"BbSelectPopoverPanelSlotProps","fields":["close: () => Promise<void>","clear: () => void","focus: () => void","query: string","selectedOptions: BbSelectResolvedOption<any>[]"],"description":"Content pinned to the top of the panel, above the search field. Rendered in both the desktop popover and the adaptive sheet."},
+		{"name":"header","type":"BbSelectPopoverPanelSlotProps","fields":["close: () => Promise<void>","clear: () => void","focus: () => void","query: string","selectedOptions: BbSelectResolvedOption<any>[]","titleId: string"],"description":"Content pinned to the top of the panel, above the search field. Rendered in both the desktop popover and the adaptive sheet."},
 		{"name":"loading","type":"{ query: string; }","description":"Content shown inside the options dropdown while items are loading."},
-		{"name":"option","type":"BbSelectPopoverOptionSlotProps<Item>","fields":["disabled: boolean","focused: boolean","index: number","item: Item","loading: boolean","selected: boolean","text: string","value: any","description: string"],"description":"Replaces the default rendering of each option row in the dropdown."}
+		{"name":"option","type":"BbSelectPopoverOptionSlotProps<Item, Known>","fields":["known: boolean","item: BbSelectKnownItem | Item","disabled: boolean","focused: boolean","index: number","loading: boolean","selected: boolean","text: string","value: any","description: string"],"description":"Replaces the default rendering of each option row in the dropdown. With `known-items` bound, a row the list has not brought yet is the known `{ value, label }` row, `known: true`: check `known` before reading an option field off `item`."}
 	],
 	"exposed": [],
 	"models": [
@@ -92,10 +92,10 @@
 			{"name":"input","description":"The search field."},
 			{"name":"clear","description":"The ✕ that empties the search field."},
 			{"name":"list","description":"The `role=\"listbox\"` node that holds the options. Virtualised: its height is written inline and its rows are positioned by the list, which limits what a layout utility can do there. The listbox's groups and the chips are not parts."},
-			{"name":"option","description":"One listbox option — a broadcast resolved per option. Also takes a per-item function, called with the option's raw item.","rowType":"PtValue | ((ctx: PtItemCtx<Item, BbSelectPopoverPtState>) => PtItemResult) | undefined"},
-			{"name":"itemText","description":"An option's label — resolved with that option's states. A custom `#option` slot replaces it. Also takes a per-item function.","rowType":"PtValue | ((ctx: PtItemCtx<Item, BbSelectPopoverPtState>) => PtItemResult) | undefined"},
-			{"name":"itemIcon","description":"An option's prepend / append icons (`itemProps`) — resolved with that option's states. Also takes a per-item function.","rowType":"PtValue | ((ctx: PtItemCtx<Item, BbSelectPopoverPtState>) => PtItemResult) | undefined"},
-			{"name":"itemDescription","description":"An option's second line (its description) — resolved with that option's states. A custom `#option` slot replaces it. Also takes a per-item function.","rowType":"PtValue | ((ctx: PtItemCtx<Item, BbSelectPopoverPtState>) => PtItemResult) | undefined"},
+			{"name":"option","description":"One listbox option — a broadcast resolved per option. Also takes a per-item function, called with the option's raw item.","rowType":"PtValue | ((ctx: PtItemCtx<Item, BbSelectPopoverPtState, never, BbSelectSlotRow<Item, Known>>) => PtItemResult) | undefined"},
+			{"name":"itemText","description":"An option's label — resolved with that option's states. A custom `#option` slot replaces it. Also takes a per-item function.","rowType":"PtValue | ((ctx: PtItemCtx<Item, BbSelectPopoverPtState, never, BbSelectSlotRow<Item, Known>>) => PtItemResult) | undefined"},
+			{"name":"itemIcon","description":"An option's prepend / append icons (`itemProps`) — resolved with that option's states. Also takes a per-item function.","rowType":"PtValue | ((ctx: PtItemCtx<Item, BbSelectPopoverPtState, never, BbSelectSlotRow<Item, Known>>) => PtItemResult) | undefined"},
+			{"name":"itemDescription","description":"An option's second line (its description) — resolved with that option's states. A custom `#option` slot replaces it. Also takes a per-item function.","rowType":"PtValue | ((ctx: PtItemCtx<Item, BbSelectPopoverPtState, never, BbSelectSlotRow<Item, Known>>) => PtItemResult) | undefined"},
 			{"name":"header","description":"The flyout's header band."},
 			{"name":"footer","description":"The flyout's footer band."}
 		],
@@ -108,8 +108,8 @@
 	"types": [
 		{"name":"BbOffCanvasProps","usedAs":["prop offCanvasProps"]},
 		{"name":"BbSelectItemProps","usedAs":["prop itemProps"],"definition":"type BbSelectItemProps<T = any> = ItemProps<T, SelectItemFields>;","fields":["description?: ItemAccessor<T, string | null | undefined>","prepend:icon?: ItemAccessor<T, string | null | undefined>","append:icon?: ItemAccessor<T, string | null | undefined>"]},
-		{"name":"BbSelectKnownItem","usedAs":["prop knownItems"],"definition":"type BbSelectKnownItem = { value: unknown; label: string; };"},
 		{"name":"BbSelectPopoverItemsContext","usedAs":["prop items"],"definition":"type BbSelectPopoverItemsContext<M = any> = BbSelectItemsContext<M>;"},
+		{"name":"BbSelectSlotRow","usedAs":["prop pt","prop pt:itemDescription","prop pt:itemIcon","prop pt:itemText","prop pt:option"],"definition":"type BbSelectSlotRow<Item, Known extends BbSelectKnownItems | undefined = BbSelectKnownItems> = [ Known ] extends [ undefined ] ? { known: false; item: Item; } : { known: true; item: BbSelectKnownItem; } | { known: false; item: Item; };"},
 		{"name":"Placement","usedAs":["prop placement"],"definition":"type Placement = 'top' | 'top-start' | 'top-end' | 'right' | 'right-start' | 'right-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end';","values":["top","bottom","left","right","top-start","top-end","right-start","right-end","bottom-start","bottom-end","left-start","left-end"]}
 	]
 }

package/dist/ai/manifest/components/BbSelectPopover.tree.json

@@ -13,7 +13,7 @@
 			{"to":"BbOffCanvas","mapping":"{ header: 'header', footer: 'footer', panel: 'root', sheet: 'root' }"}
 		],
 		"nodes": [
-			{"name":"BbBadge","kind":"public","vocabulary":"BbBadge","bindings":[{"part":"spinner","target":"BbSpinner"},{"part":"icon","target":"BbIcon"},{"part":"clear","target":"button.bb-badge__clear"}],"cssProps":[{"name":"--bg","documented":true,"readBy":["bb-badge"]},{"name":"--fg","documented":true,"readBy":["bb-badge","bb-badge__clear"]},{"name":"--bw","documented":true,"readBy":["bb-badge","bb-badge__clear"]},{"name":"--border-color","documented":false,"readBy":["bb-badge"]},{"name":"--ring-color","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--ring-size","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--min-size-md","documented":true,"readBy":["bb-badge"]},{"name":"--min-size","documented":true,"readBy":["bb-badge"]},{"name":"--elev","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--r","documented":true,"readBy":["bb-badge","bb-badge__body","bb-badge__trailing","bb-badge__clear"]},{"name":"--fs","documented":true,"readBy":["bb-badge"]},{"name":"--icon-size","documented":true,"readBy":["bb-badge__icon","bb-badge__prepend-icon","bb-badge__append-icon","bb-badge__clear"]},{"name":"--gap","documented":true,"readBy":["bb-badge","bb-badge__body","bb-badge__trailing","bb-badge__clear"]},{"name":"--px","documented":true,"readBy":["bb-badge","bb-badge--icon","bb-badge__prepend-icon","bb-badge__append-icon","bb-badge--clearable"]},{"name":"--clear-size","documented":true,"readBy":["bb-badge__clear","bb-icon"]},{"name":"--bg-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--fg-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--border-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--pad-left","documented":true,"readBy":["bb-badge__body"]},{"name":"--pad-right","documented":false,"readBy":["bb-badge__body","bb-badge__clear"]},{"name":"--size","documented":false}],"children":[{"name":"BbIcon","kind":"public","cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"BbSpinner","kind":"public","children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]}]},{"name":"BadgeBodyContent","kind":"internal","children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"BbSpinner","kind":"public","repeated":true}]}]},
+			{"name":"BbBadge","kind":"public","vocabulary":"BbBadge","bindings":[{"part":"spinner","target":"BbSpinner"},{"part":"icon","target":"span.bb-badge__append-icon"},{"part":"icon","target":"BbIcon"},{"part":"clear","target":"button.bb-badge__clear"}],"cssProps":[{"name":"--bg","documented":true,"readBy":["bb-badge"]},{"name":"--fg","documented":true,"readBy":["bb-badge","bb-badge__clear"]},{"name":"--bw","documented":true,"readBy":["bb-badge","bb-badge__clear"]},{"name":"--border-color","documented":false,"readBy":["bb-badge"]},{"name":"--ring-color","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--ring-size","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--min-size-md","documented":true,"readBy":["bb-badge"]},{"name":"--min-size","documented":true,"readBy":["bb-badge"]},{"name":"--elev","documented":true,"readBy":["bb-badge","bb-badge__clear","bb-badge__body","bb-badge--highlighted"]},{"name":"--r","documented":true,"readBy":["bb-badge","bb-badge__body","bb-badge__trailing","bb-badge__clear"]},{"name":"--fs","documented":true,"readBy":["bb-badge"]},{"name":"--icon-size","documented":true,"readBy":["bb-badge__icon","bb-badge__prepend-icon","bb-badge__append-icon","bb-badge__icon-slot","bb-icon","bb-badge__clear"]},{"name":"--gap","documented":true,"readBy":["bb-badge","bb-badge__body","bb-badge__trailing","bb-badge__clear"]},{"name":"--px","documented":true,"readBy":["bb-badge","bb-badge--icon","bb-badge__prepend-icon","bb-badge__append-icon","bb-badge--clearable"]},{"name":"--clear-size","documented":true,"readBy":["bb-badge__clear","bb-icon"]},{"name":"--bg-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--fg-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--border-disabled","documented":true,"readBy":["bb-badge__body","bb-base-button--disabled","bb-badge--loading"]},{"name":"--pad-left","documented":true,"readBy":["bb-badge__body"]},{"name":"--pad-right","documented":false,"readBy":["bb-badge__body","bb-badge__clear"]},{"name":"--size","documented":false}],"children":[{"name":"BbIcon","kind":"public","cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"BbSpinner","kind":"public","children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]}]},{"name":"BadgeBodyContent","kind":"internal","children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},{"name":"BbSpinner","kind":"public","repeated":true}]}]},
 			{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]},
 			{"name":"BbOffCanvas","kind":"public","vocabulary":"BbOffCanvas","bindings":[{"part":"header","target":"div.bb-offcanvas__header"},{"part":"title","target":"span.bb-offcanvas__title"},{"part":"description","target":"p.bb-offcanvas__description"},{"part":"close","target":"CloseButton"},{"part":"content","target":"div.bb-offcanvas__content"},{"part":"footer","target":"div.bb-offcanvas__footer"}],"cssProps":[{"name":"--translate-x","documented":false,"readBy":["bb-offcanvas"]},{"name":"--translate-y","documented":false,"readBy":["bb-offcanvas"]},{"name":"--translate","documented":false,"readBy":["bb-offcanvas"]},{"name":"--stack-x","documented":true,"readBy":["bb-offcanvas"]},{"name":"--stack-y","documented":false,"readBy":["bb-offcanvas"]},{"name":"--snap-y","documented":true,"readBy":["bb-offcanvas","bb-offcanvas__footer","bb-offcanvas--snap","bb-offcanvas--bottom"]},{"name":"--snap-floor","documented":false,"readBy":["bb-offcanvas__footer"]},{"name":"--stack-fill","documented":true,"readBy":["bb-offcanvas","bb-offcanvas--right","bb-offcanvas--left","bb-offcanvas--top","bb-offcanvas--bottom"]},{"name":"--stack-transition-duration","documented":true,"readBy":["bb-offcanvas"]},{"name":"--px","documented":true,"readBy":["bb-offcanvas__header","bb-close-button","bb-offcanvas__content","bb-offcanvas__footer"]},{"name":"--py","documented":false,"readBy":["bb-offcanvas__footer","bb-offcanvas__content","bb-offcanvas__header","bb-close-button"]},{"name":"--handle-w","documented":true,"readBy":["bb-offcanvas__handle"]},{"name":"--handle-h","documented":true,"readBy":["bb-offcanvas__handle"]},{"name":"--handle-bg","documented":true,"readBy":["bb-offcanvas__handle"]},{"name":"--transition-timing-function","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--open"]},{"name":"--bg","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--snap","bb-offcanvas--bottom"]},{"name":"--fg","documented":false,"readBy":["bb-offcanvas"]},{"name":"--safe-top","documented":true,"readBy":["bb-offcanvas","bb-offcanvas--left","bb-offcanvas--right","bb-offcanvas--top","bb-offcanvas--fullscreen"]},{"name":"--safe-right","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--right","bb-offcanvas--top","bb-offcanvas--bottom","bb-offcanvas--fullscreen"]},{"name":"--safe-bottom","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--left","bb-offcanvas--right","bb-offcanvas--bottom","bb-offcanvas--fullscreen"]},{"name":"--safe-left","documented":false,"readBy":["bb-offcanvas","bb-offcanvas--left","bb-offcanvas--top","bb-offcanvas--bottom","bb-offcanvas--fullscreen"]},{"name":"--inset-top","documented":false,"readBy":["bb-offcanvas__content","bb-offcanvas__header"]},{"name":"--inset-right","documented":false,"readBy":["bb-offcanvas__header","bb-offcanvas__content","bb-offcanvas__footer"]},{"name":"--inset-bottom","documented":false,"readBy":["bb-offcanvas__footer","bb-offcanvas__content"]},{"name":"--inset-left","documented":false,"readBy":["bb-offcanvas__header","bb-offcanvas__content","bb-offcanvas__footer"]},{"name":"--close-size","documented":true,"readBy":["bb-close-button"]},{"name":"--gap","documented":false,"readBy":["bb-offcanvas__footer"]}],"children":[{"name":"CloseButton","kind":"internal","cssProps":[{"name":"--size","documented":true,"readBy":["bb-close-button"]},{"name":"--p","documented":true,"readBy":["bb-close-button"]}]}]},
 			{"name":"ClearableButton","kind":"internal","children":[{"name":"BbIcon","kind":"public","repeated":true,"cssProps":[{"name":"--w","documented":true,"readBy":["bb-icon"]},{"name":"--size","documented":false,"readBy":["bb-icon"]}]}]},
@@ -58,7 +58,8 @@
 				"__option-check",
 				"__option-content",
 				"__option-prepend-icon",
-				"__outer-container"
+				"__outer-container",
+				"__status"
 			],
 			"bb-select-known-items": [
 				""

package/dist/ai/manifest/components/BbSwitchGroup.json

@@ -90,7 +90,7 @@
 			{"name":"description","description":"The muted line under the legend (the `description` prop).","states":["disabled","errors","hasValue","loading","readonly","warnings"]},
 			{"name":"message","description":"The errors / warnings line. A node of its own: it can show at the same time as `hint`.","states":["disabled","errors","hasValue","loading","readonly","warnings"]},
 			{"name":"hint","common":true,"states":["disabled","errors","hasValue","loading","readonly","warnings"]},
-			{"name":"list","common":true,"states":["disabled","errors","hasValue","loading","readonly","warnings"]},
+			{"name":"list","description":"The node that lays the rows out (flex + wrap, gaps on `--gap` / `--row-gap`): `pt:list=\"grid grid-cols-3\"` re-lays them, `pt:list=\"[--gap:8px]\"` tightens them. Takes the group-wide states only.","states":["disabled","errors","hasValue","loading","readonly","warnings"]},
 			{"name":"item","description":"One option row — a broadcast, resolved per option with its own `checked` / `disabled` / focus. Takes a per-item function.","rowType":"PtValue | ((ctx: PtItemCtx<T, GroupPtState>) => PtItemResult) | undefined"},
 			{"name":"icon","description":"One row's drawn glyph — the default one: a consumer `icon` slot replaces it. Takes a per-item function.","rowType":"PtValue | ((ctx: PtItemCtx<T, GroupPtState>) => PtItemResult) | undefined"},
 			{"name":"label","description":"One option's label text (the `label` slot's default). Takes a per-item function.","rowType":"PtValue | ((ctx: PtItemCtx<T, GroupPtState>) => PtItemResult) | undefined"},

package/dist/ai/manifest/components/BbSwitchGroup.tree.json

@@ -6,7 +6,7 @@
 		],
 		"nodes": [
 			{"name":"CommonField","kind":"internal","vocabulary":"BbSwitchGroup","bindings":[{"part":"root","target":"div.bb-field"},{"part":"label","target":"component"},{"part":"description","target":"span.bb-field__description"},{"part":"hint","target":"span.bb-field__hint"},{"part":"counter","target":"span.bb-field__counter"},{"part":"message","target":"div.bb-field__message"}],"cssProps":[{"name":"--ctrl-line","documented":true,"readBy":["bb-field__label","bb-field__input-wrapper"]}],"children":[{"name":"BbAsterisk","kind":"public"}]},
-			{"name":"OptionsContainer","kind":"internal","vocabulary":"BbSwitchGroup","bindings":[{"part":"list","target":"span"},{"part":"item","target":"label"},{"part":"label","target":"span"},{"part":"itemDescription","target":"span"}]},
+			{"name":"OptionsContainer","kind":"internal","vocabulary":"BbSwitchGroup","bindings":[{"part":"list","target":"span"},{"part":"item","target":"label"},{"part":"label","target":"span"},{"part":"itemDescription","target":"span"}],"cssProps":[{"name":"--list-bg","documented":true},{"name":"--list-border","documented":true},{"name":"--p","documented":true,"readBy":["bb-radio-group__list--strip","bb-checkbox-group__list--strip","bb-checkbox-group__item"]},{"name":"--list-r","documented":true,"readBy":["bb-radio-group__list--strip","bb-checkbox-group__list--strip"]},{"name":"--list-h","documented":true,"readBy":["bb-radio-group__list--strip","bb-checkbox-group__list--strip"]},{"name":"--fs","documented":true,"readBy":["bb-checkbox-group__item"]},{"name":"--trigger-gap","documented":true},{"name":"--trigger-px","documented":true,"readBy":["bb-checkbox-group__item"]},{"name":"--trigger-r","documented":true,"readBy":["bb-radio-group__list--strip","bb-checkbox-group__list--strip","bb-checkbox-group__item"]},{"name":"--trigger-min-h","documented":true,"readBy":["bb-checkbox-group__item"]},{"name":"--list-fg","documented":true,"readBy":["bb-checkbox-group__item"]},{"name":"--hover-fg","documented":true},{"name":"--active-fg","documented":true,"readBy":["bb-checkbox-group__item--selected"]},{"name":"--active-fw","documented":true,"readBy":["bb-checkbox-group__item--selected"]},{"name":"--indicator-bg","documented":true,"readBy":["bb-checkbox-group__indicator","bb-checkbox-group__item--selected"]},{"name":"--indicator-border","documented":true,"readBy":["bb-checkbox-group__indicator"]},{"name":"--indicator-r","documented":true,"readBy":["bb-checkbox-group__indicator"]},{"name":"--indicator-h","documented":true,"readBy":["bb-checkbox-group__indicator","bb-checkbox-group__item--selected"]},{"name":"--indicator-inset","documented":true,"readBy":["bb-checkbox-group__indicator"]},{"name":"--elev","documented":true,"readBy":["bb-checkbox-group__indicator","bb-checkbox-group__item--selected"]},{"name":"--indicator-shadow","documented":true,"readBy":["bb-checkbox-group__indicator","bb-checkbox-group__item--selected"]},{"name":"--list-bg","documented":false},{"name":"--list-border","documented":false},{"name":"--p","documented":false,"readBy":["bb-radio-group__list--strip","bb-checkbox-group__list--strip","bb-checkbox-group__item"]},{"name":"--list-r","documented":false,"readBy":["bb-radio-group__list--strip","bb-checkbox-group__list--strip"]},{"name":"--trigger-r","documented":false,"readBy":["bb-radio-group__list--strip","bb-checkbox-group__list--strip","bb-checkbox-group__item"]},{"name":"--active-fw","documented":false,"readBy":["bb-checkbox-group__item--selected"]},{"name":"--indicator-bg","documented":false,"readBy":["bb-checkbox-group__indicator","bb-checkbox-group__item--selected"]},{"name":"--indicator-border","documented":false,"readBy":["bb-checkbox-group__indicator"]},{"name":"--indicator-r","documented":false,"readBy":["bb-checkbox-group__indicator"]},{"name":"--indicator-h","documented":false,"readBy":["bb-checkbox-group__indicator","bb-checkbox-group__item--selected"]},{"name":"--indicator-shadow","documented":false,"readBy":["bb-checkbox-group__indicator","bb-checkbox-group__item--selected"]},{"name":"--elev","documented":false,"readBy":["bb-checkbox-group__indicator","bb-checkbox-group__item--selected"]}]},
 			{"name":"BbBaseSwitchIcon","kind":"public","cssProps":[{"name":"--accent","documented":true,"readBy":["bb-base-switch-icon","bb-base-switch-icon--errors","bb-base-switch-icon--checked","bb-base-switch-icon--indeterminate","bb-base-switch-icon--warnings","bb-base-switch-icon--disabled"]},{"name":"--bg","documented":true,"readBy":["bb-base-switch-icon"]},{"name":"--ring-color","documented":true,"readBy":["bb-base-switch-icon--focus-visible"]},{"name":"--r","documented":true,"readBy":["bb-base-switch-icon","bb-base-switch-icon__thumb"]},{"name":"--bw","documented":true,"readBy":["bb-base-switch-icon","bb-base-switch-icon__thumb"]},{"name":"--h","documented":true,"readBy":["bb-base-switch-icon"]},{"name":"--w","documented":true,"readBy":["bb-base-switch-icon"]},{"name":"--thumb","documented":true,"readBy":["bb-base-switch-icon","bb-base-switch-icon__thumb"]},{"name":"--inset","documented":true,"readBy":["bb-base-switch-icon","bb-base-switch-icon__thumb"]},{"name":"--travel","documented":true,"readBy":["bb-base-switch-icon__thumb"]}]}
 		]
 	},
@@ -38,6 +38,8 @@
 				"__list",
 				"__list--*",
 				"__list--errors",
+				"__list--no-transition",
+				"__list--strip",
 				"__list--tiles",
 				"__list--warnings",
 				"__loading"

package/dist/ai/manifest/components/BbTable.tree.json

@@ -20,6 +20,9 @@
 	},
 	"css": {
 		"classes": {
+			"bb-ruler-line": [
+				""
+			],
 			"bb-sr-only": [
 				""
 			],
@@ -54,10 +57,16 @@
 				"__cell--edge-end",
 				"__cell--edge-start",
 				"__cell--fluid",
+				"__cell--line",
 				"__cell--nowrap",
+				"__cell--outlier",
+				"__cell--placeholder",
 				"__cell--resized",
 				"__cell--row-drag",
 				"__cell--select",
+				"__cell--token",
+				"__cell--value",
+				"__cell--word",
 				"__cell-column-header",
 				"__cell-column-header--*",
 				"__cell-column-header--actions",
@@ -98,7 +107,8 @@
 				"__row-reorder-status",
 				"__select-icon",
 				"__sort-icon",
-				"__table"
+				"__table",
+				"__table--hold-*"
 			],
 			"bb-table-check": [
 				"",
@@ -149,6 +159,9 @@
 			"bb-table-row-ghost": [
 				""
 			],
+			"bb-table-ruler": [
+				""
+			],
 			"bb-table-skeleton": [
 				"__avatar",
 				"__avatar-text",

package/dist/ai/manifest/components/BbTabs.json

@@ -30,7 +30,7 @@
 		{"name":"onSuccess","type":"(() => void)","description":"Inertia lifecycle hook — fired when the visit completes successfully."},
 		{"name":"preserveScroll","type":"boolean | ((props: Record<string, unknown>) => boolean)","description":"Controls whether Inertia preserves the scroll position after navigation. Only meaningful in an Inertia context."},
 		{"name":"preserveState","type":"boolean | ((props: Record<string, unknown>) => boolean) | null","description":"Controls whether Inertia preserves the current component state after navigation. Only meaningful in an Inertia context."},
-		{"name":"pt","type":"PtItemMap<BbTabsPtPart, \"item\", BbTabsPtState, BbTabsItem<K>>","description":"Passthrough, object form: the same keys as the `pt:*` attributes without the prefix. See the `pt:<part>` row."},
+		{"name":"pt","type":"({ root?: PtValue | undefined; panel?: PtValue | undefined; \"root:disabled\"?: PtValue | undefined; \"root:active\"?: PtValue | undefined; \"item:disabled\"?: PtValue | undefined; \"item:active\"?: PtValue | undefined; list?: PtValue | undefined; indicator?: PtValue | undefined; \"list:disabled\"?: PtValue | undefined; \"indicator:disabled\"?: PtValue | undefined; \"item:pill\"?: PtValue | undefined; \"item:line\"?: PtValue | undefined; \"panel:disabled\"?: PtValue | undefined; \"panel:active\"?: PtValue | undefined; wrapper?: PtValue | undefined; panels?: PtValue | undefined; \"list:active\"?: PtValue | undefined; \"indicator:active\"?: PtValue | undefined; \"wrapper:disabled\"?: PtValue | undefined; \"wrapper:active\"?: PtValue | undefined; \"panels:disabled\"?: PtValue | undefined; \"panels:active\"?: PtValue | undefined; \"item:none\"?: PtValue | undefined; } & { item?: PtValue | PtItemFn<BbTabsItem<K>, BbTabsPtState, \"none\" | \"pill\" | \"line\", { readonly item: BbTabsItem<K>; }> | undefined; } & { \"indicator:pill\"?: PtValue | undefined; \"indicator:line\"?: PtValue | undefined; \"item:pill\"?: PtValue | undefined; \"item:line\"?: PtValue | undefined; \"list:pill\"?: PtValue | undefined; \"list:line\"?: PtValue | undefined; \"item:none\"?: PtValue | undefined; \"list:none\"?: PtValue | undefined; \"indicator:none\"?: PtValue | undefined; \"wrapper:none\"?: PtValue | undefined; \"wrapper:pill\"?: PtValue | undefined; \"wrapper:line\"?: PtValue | undefined; })","description":"Passthrough, object form: the same keys as the `pt:*` attributes without the prefix. See the `pt:<part>` row."},
 		{"name":"queryKey","type":"string","default":"\"tab\"","description":"Defines the query key used for URL-based navigation."},
 		{"name":"replace","type":"boolean","default":"false","description":"Replaces the history entry instead of pushing one when the tab changes. Recommended with `navigation`: the query keeps the tab while Back leaves the page. Leave it off when a tab is a destination of its own (a `server` visit)."},
 		{"name":"server","type":"boolean","default":"false","description":"When true and in an Inertia context, triggers a real server-side Inertia visit instead of a client-only `history.pushState`."},
@@ -52,17 +52,20 @@
 	],
 	"pt": {
 		"parts": [
-			{"name":"root","description":"The tabs' outer element, around the strip and the panels."},
+			{"name":"root","description":"The tabs' outer element, around the strip and the panels.","states":["active","disabled"]},
 			{"name":"wrapper","description":"The strip's outer element: the `wrapper:prepend` slot, the triggers, the `wrapper:append` slot. `BbTabsList`'s root in a split layout."},
 			{"name":"list","description":"The `role=\"tablist\"` row the triggers sit in — it scrolls when they overflow, and the indicator slides inside it."},
-			{"name":"item","description":"One tab trigger — a broadcast resolved per tab with its own `active` / `disabled`. Also takes a per-item function, called with the tab's descriptor.","rowType":"PtValue | ((ctx: PtItemCtx<BbTabsItem<K>, BbTabsPtState>) => PtItemResult) | undefined"},
+			{"name":"item","description":"One tab trigger — a broadcast resolved per tab with its own `active` / `disabled`. Also takes a per-item function, called with the tab's descriptor.","rowType":"PtValue | ((ctx: PtItemCtx<BbTabsItem<K>, BbTabsPtState, \"none\" | \"pill\" | \"line\">) => PtItemResult) | undefined"},
 			{"name":"indicator","description":"The marker sliding under the active trigger: the pill, or the bar of the `line` variant. Its position and size are measured."},
-			{"name":"panels","description":"The element around the panels. `BbTabsPanels`'s root in a split layout."},
-			{"name":"panel","description":"One tab panel — a broadcast; `panel:active` is the panel on show. Takes no function."}
+			{"name":"panels","description":"The element around the panels. `BbTabsPanels`'s root in a split layout.","states":["active","disabled"]},
+			{"name":"panel","description":"One tab panel — a broadcast; `panel:active` is the panel on show. Takes no function.","states":["active","disabled"]}
 		],
 		"states": [
 			{"name":"disabled","description":"On every part while the whole tabs is `disabled`; per node on `item`: a tab that is disabled."},
-			{"name":"active","description":"Per node, on `item` and `panel`: the selected tab's trigger and its shown panel."}
+			{"name":"active","description":"Per node, on `item` and `panel`: the selected tab's trigger and its shown panel."},
+			{"name":"line","description":"On the strip's parts: `variant: 'line'`. Below the real states, like every variant."},
+			{"name":"none","description":"On the strip's parts: `variant: 'none'`. Below the real states, like every variant."},
+			{"name":"pill","description":"On the strip's parts: `variant: 'pill'`. Merged after the part's base entry and before its states, so the real states still win."}
 		]
 	},
 	"attrTargets": [

package/dist/ai/manifest/components/BbTabs.tree.json

@@ -2,7 +2,7 @@
 	"name": "BbTabs",
 	"tree": {
 		"forwards": [
-			{"to":"BbTabsList","mapping":"passthrough.forwardInstance(LIST_PARTS)"},
+			{"to":"BbTabsList","mapping":"passthrough.forwardInstance(LIST_PARTS, LIST_STATES)"},
 			{"to":"BbTabsPanels","mapping":"passthrough.forwardInstance(PANELS_PARTS)"}
 		],
 		"nodes": [

package/dist/ai/manifest/components/BbTabsList.json

@@ -7,7 +7,7 @@
 	"contract": "ai/BbTabsList.md",
 	"source": "ai/source/BbTabsList.md",
 	"props": [
-		{"name":"pt","type":"PtItemMap<BbTabsListPtPart, \"item\", BbTabsPtState, BbTabsItem<string>>","description":"Passthrough, object form: the same keys as the `pt:*` attributes without the prefix. See the `pt:<part>` row."},
+		{"name":"pt","type":"({ root?: PtValue | undefined; \"root:disabled\"?: PtValue | undefined; \"root:active\"?: PtValue | undefined; \"item:disabled\"?: PtValue | undefined; \"item:active\"?: PtValue | undefined; list?: PtValue | undefined; indicator?: PtValue | undefined; \"list:disabled\"?: PtValue | undefined; \"indicator:disabled\"?: PtValue | undefined; \"item:pill\"?: PtValue | undefined; \"item:line\"?: PtValue | undefined; \"list:active\"?: PtValue | undefined; \"indicator:active\"?: PtValue | undefined; \"item:none\"?: PtValue | undefined; } & { item?: PtValue | PtItemFn<BbTabsItem<string>, BbTabsPtState, \"none\" | \"pill\" | \"line\", { readonly item: BbTabsItem<string>; }> | undefined; } & { \"indicator:pill\"?: PtValue | undefined; \"indicator:line\"?: PtValue | undefined; \"root:pill\"?: PtValue | undefined; \"root:line\"?: PtValue | undefined; \"item:pill\"?: PtValue | undefined; \"item:line\"?: PtValue | undefined; \"list:pill\"?: PtValue | undefined; \"list:line\"?: PtValue | undefined; \"item:none\"?: PtValue | undefined; \"list:none\"?: PtValue | undefined; \"indicator:none\"?: PtValue | undefined; \"root:none\"?: PtValue | undefined; })","description":"Passthrough, object form: the same keys as the `pt:*` attributes without the prefix. See the `pt:<part>` row."},
 		{"name":"variant","type":"keyof TabsVariantRegistry","values":["none","pill","line"],"description":"Look of this strip — the `variant` of the owning `BbTabs` / `BbTabsRoot` unless set here. See `BbTabsProps.variant` for the values."}
 	],
 	"events": [],
@@ -23,12 +23,15 @@
 		"parts": [
 			{"name":"root","description":"The strip's outer element: the `wrapper:prepend` slot, the triggers, the `wrapper:append` slot (`BbTabs`'s `wrapper`)."},
 			{"name":"list","description":"The `role=\"tablist\"` row the triggers sit in."},
-			{"name":"item","description":"One tab trigger, per tab with its own `active` / `disabled`. Also takes a per-item function, called with the tab's descriptor.","rowType":"PtValue | ((ctx: PtItemCtx<BbTabsItem<string>, BbTabsPtState>) => PtItemResult) | undefined"},
+			{"name":"item","description":"One tab trigger, per tab with its own `active` / `disabled`. Also takes a per-item function, called with the tab's descriptor.","rowType":"PtValue | ((ctx: PtItemCtx<BbTabsItem<string>, BbTabsPtState, \"none\" | \"pill\" | \"line\">) => PtItemResult) | undefined"},
 			{"name":"indicator","description":"The marker sliding under the active trigger."}
 		],
 		"states": [
 			{"name":"disabled","description":"On every part while the whole tabs is `disabled`; per node on `item`: a tab that is disabled."},
-			{"name":"active","description":"Per node, on `item` and `panel`: the selected tab's trigger and its shown panel."}
+			{"name":"active","description":"Per node, on `item` and `panel`: the selected tab's trigger and its shown panel."},
+			{"name":"line","description":"On the strip's parts: `variant: 'line'`. Below the real states, like every variant."},
+			{"name":"none","description":"On the strip's parts: `variant: 'none'`. Below the real states, like every variant."},
+			{"name":"pill","description":"On the strip's parts: `variant: 'pill'`. Merged after the part's base entry and before its states, so the real states still win."}
 		]
 	},
 	"attrTargets": [