bitboss-ui 3.0.0-beta.60 → 3.0.0-beta.61

package/dist/ai/BbSelect.md

@@ -1617,7 +1617,11 @@ const createLabel = (text: string) => {
 Set `group-by` to a field path (or a function) to bucket options under headers.
 The `#group` slot styles the header and receives
 `{ text, item, index, length, disabled }` — `length` is the number of options
-in the group, `index` the list index of its first option.
+in the group, `index` the list index of its first option. A row whose
+`group-by` gives `null` or `undefined` has no group: those rows are listed
+without a header, and `#group` is not called for them (a known row is listed
+the same way). Rows in the middle of the list with no header read as part of
+the group above, so give them a group of their own (`row.team ?? 'Other'`).
 
 A grouped list virtualizes **whole groups, not rows**: a group mounts only
 when it scrolls into range, but all of its rows mount together. Many
@@ -2346,7 +2350,7 @@ States are listed in precedence order: when two are on at once and their entries
 - `description` — scope: `BbSelectDescriptionSlotProps` `{ text: string; hasErrors: boolean; hasWarnings: boolean }` — Replaces the description text. Provided alone (no `description` prop) it still renders the description region and wires it into `aria-describedby`.
 - `empty` — scope: `{ query: string; focus: () => void; error: unknown; }` — 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).
 - `footer` — scope: `BbSelectPanelSlotProps` `{ close: () => Promise<void>; clear: () => void; focus: () => void; query: string; selectedOptions: BbSelectResolvedOption[] }` — Content pinned to the bottom of the options panel, below the options list. Rendered in both the desktop popover and the adaptive sheet.
-- `group` — scope: `BbSelectGroupSlotProps<T>` `{ text: string; item: T; index: number; length: number; disabled: boolean }` — Replaces the default group header rendered above grouped options.
+- `group` — scope: `BbSelectGroupSlotProps<T>` `{ text: string; item: T; index: number; length: number; disabled: boolean }` — 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.
 - `header` — scope: `BbSelectPanelSlotProps` `{ close: () => Promise<void>; clear: () => void; focus: () => void; query: string; selectedOptions: BbSelectResolvedOption[] }` — Content pinned to the top of the options panel, above the search field. Rendered in both the desktop popover and the adaptive sheet.
 - `label` — scope: `BbSelectLabelSlotProps` `{ showAsterisk?: boolean; text: string; hasErrors: boolean; hasWarnings: boolean }` — Replaces the default label text rendered above the input.
 - `loading` — scope: `{ query: string; }` — Content shown inside the options dropdown while items are loading.

package/dist/ai/BbSelectPopover.md

@@ -1916,7 +1916,7 @@ States are listed in precedence order: when two are on at once and their entries
 - `activator` — scope: `BbSelectPopoverActivatorSlotProps` `{ 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> }` — Replaces the default trigger element that opens the select popover.
 - `empty` — scope: `{ query: string; focus: () => void; error: unknown; }` — 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).
 - `footer` — scope: `BbSelectPopoverPanelSlotProps` `{ close: () => Promise<void>; clear: () => void; focus: () => void; query: string; selectedOptions: BbSelectResolvedOption<any>[] }` — Content pinned to the bottom of the panel, below the options list. Rendered in both the desktop popover and the adaptive sheet.
-- `group` — scope: `BbSelectPopoverGroupSlotProps<Item>` `{ disabled: boolean; index: number; item: Item; length: number; text: string }` — Replaces the default group header rendered above grouped options.
+- `group` — scope: `BbSelectPopoverGroupSlotProps<Item>` `{ disabled: boolean; index: number; item: Item; length: number; text: string }` — 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.
 - `header` — scope: `BbSelectPopoverPanelSlotProps` `{ close: () => Promise<void>; clear: () => void; focus: () => void; query: string; selectedOptions: BbSelectResolvedOption<any>[] }` — Content pinned to the top of the panel, above the search field. Rendered in both the desktop popover and the adaptive sheet.
 - `loading` — scope: `{ query: string; }` — Content shown inside the options dropdown while items are loading.
 - `option` — scope: `BbSelectPopoverOptionSlotProps<Item>` `{ disabled: boolean; focused: boolean; index: number; item: Item; loading: boolean; selected: boolean; text: string; value: any; description: string }` — Replaces the default rendering of each option row in the dropdown.

package/dist/ai/GroupedListBox.md

@@ -53,7 +53,7 @@
 ## Slots
 
 - `empty` — scope: `object` — Content shown when no options are available (replaces the default "no data" text).
-- `group` — scope: `GroupedListBoxGroupSlotProps<Item>` `{ text: string; item: Item; index: number; length: number; disabled: boolean }` — Replaces the default group header rendered above each group of options.
+- `group` — scope: `GroupedListBoxGroupSlotProps<Item>` `{ text: string; item: Item; index: number; length: number; disabled: boolean }` — Replaces the default group header rendered above each group of options. A group whose `data` is `null`/`undefined` has no header, so no call.
 - `loading` — scope: `object` — Content shown while items are loading (replaces the default loading text).
 - `option` — scope: `GroupedListBoxOptionSlotProps<Item>` `{ disabled: boolean; focused: boolean; index: number; item: Item; selected: boolean; text: string; value: any; description: string }` — Replaces the default rendering of each option row within a group.
 - `options:append` — scope: `object` — Content appended inside the options list, after the last group.

package/dist/ai/changelog.json

@@ -1,7 +1,7 @@
 {
 	"schemaVersion": 3,
 	"library": "bitboss-ui",
-	"version": "3.0.0-beta.60",
+	"version": "3.0.0-beta.61",
 	"upgrade": "v2-to-v3",
 	"guide": "ai/guides/migration/v2-to-v3.md",
 	"legend": {
@@ -70,7 +70,8 @@
 		"3.0.0-beta.57",
 		"3.0.0-beta.58",
 		"3.0.0-beta.59",
-		"3.0.0-beta.60"
+		"3.0.0-beta.60",
+		"3.0.0-beta.61"
 	],
 	"unpublished": [
 		"3.0.0-alpha.2",