bitboss-ui 3.0.0-beta.2 → 3.0.0-beta.21

package/dist/ai/FlatListBox.md

@@ -12,16 +12,16 @@
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `compact` | `boolean \| undefined` |  |  | Sets the listbox in a compact state. |
+| `compact` | `boolean \| undefined` | `false` |  | Sets the listbox in a compact state. |
 | `id` | `string \| undefined` |  |  | Id applied to the `role="listbox"` element itself (not the wrapper), so a combobox's `aria-controls` reference resolves to the listbox role. |
-| `loading` | `boolean \| undefined` |  |  | Shows the listbox in a loading state. |
+| `loading` | `boolean \| undefined` | `false` |  | Shows the listbox in a loading state. |
 | `loadingText` | `string \| undefined` |  |  | Text shown while options are loading. |
-| `multiple` | `boolean \| undefined` |  |  | Allows multiple options to be selected simultaneously. |
+| `multiple` | `boolean \| undefined` | `false` |  | Allows multiple options to be selected simultaneously. |
 | `noDataText` | `string \| undefined` |  |  | Text shown when no options are available. |
-| `open` | `boolean \| undefined` |  |  | Whether the listbox is open (visible). |
+| `open` | `boolean \| undefined` | `false` |  | Whether the listbox is open (visible). |
 | `optionHeight` | `number \| undefined` |  |  | Fixed height (in px) for each option row. Defaults to 28px (24px compact; 44px / 36px on mobile viewports). An explicit value wins on every viewport. |
 | `options` | `Option<Item>[]` |  | yes | List of options to display. |
-| `transitionDuration` | `number \| undefined` | `transitions.medium` |  | Duration of open/close transition in milliseconds. |
+| `transitionDuration` | `number \| undefined` | `250` |  | Duration of open/close transition in milliseconds. |
 
 ## Events
 

package/dist/ai/GroupedListBox.md

@@ -12,17 +12,17 @@
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `compact` | `boolean \| undefined` |  |  | Sets the listbox in a compact state. |
+| `compact` | `boolean \| undefined` | `false` |  | Sets the listbox in a compact state. |
 | `groups` | `GroupedOptions[]` |  | yes | List of option groups to display. |
 | `headerHeight` | `number \| undefined` |  |  | Height of group headers (px). Defaults to 32px (24px compact; 36px / 32px on mobile viewports). An explicit value wins on every viewport. |
 | `id` | `string \| undefined` |  |  | Id applied to the `role="listbox"` element itself (not the wrapper), so a combobox's `aria-controls` reference resolves to the listbox role. |
-| `loading` | `boolean \| undefined` |  |  | Shows the listbox in a loading state. |
+| `loading` | `boolean \| undefined` | `false` |  | Shows the listbox in a loading state. |
 | `loadingText` | `string \| undefined` |  |  | Text shown while options are loading. |
-| `multiple` | `boolean \| undefined` |  |  | Allows multiple options to be selected simultaneously. |
+| `multiple` | `boolean \| undefined` | `false` |  | Allows multiple options to be selected simultaneously. |
 | `noDataText` | `string \| undefined` |  |  | Text shown when no options are available. |
-| `open` | `boolean \| undefined` |  |  | Whether the listbox is open (visible). |
+| `open` | `boolean \| undefined` | `false` |  | Whether the listbox is open (visible). |
 | `optionHeight` | `number \| undefined` |  |  | Fixed height (in px) for each option row. Defaults to 28px (24px compact; 44px / 36px on mobile viewports). An explicit value wins on every viewport. |
-| `transitionDuration` | `number \| undefined` | `transitions.medium` |  | Duration of open/close transition in milliseconds. |
+| `transitionDuration` | `number \| undefined` | `250` |  | Duration of open/close transition in milliseconds. |
 
 ## Events
 

package/dist/ai/ListBox.md

@@ -12,15 +12,15 @@
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `compact` | `boolean \| undefined` |  |  | Sets the listbox in a compact state. |
+| `compact` | `boolean \| undefined` | `false` |  | Sets the listbox in a compact state. |
 | `groups` | `GroupedOptions[] \| undefined` |  |  | Grouped option list. When provided, the grouped listbox is rendered. |
 | `headerHeight` | `number \| undefined` |  |  | Height of group headers in the listbox (px). |
 | `id` | `string \| undefined` |  |  | Id applied to the `role="listbox"` element itself (not the wrapper), so a combobox's `aria-controls` reference resolves to the listbox role. |
-| `loading` | `boolean \| undefined` |  |  | Shows the listbox in a loading state. |
+| `loading` | `boolean \| undefined` | `false` |  | Shows the listbox in a loading state. |
 | `loadingText` | `string \| undefined` |  |  | Text shown while options are loading. |
-| `multiple` | `boolean \| undefined` |  |  | Allows multiple options to be selected simultaneously. |
+| `multiple` | `boolean \| undefined` | `false` |  | Allows multiple options to be selected simultaneously. |
 | `noDataText` | `string \| undefined` |  |  | Text shown when no options are available. |
-| `open` | `boolean \| undefined` |  |  | Whether the listbox is open (visible). |
+| `open` | `boolean \| undefined` | `false` |  | Whether the listbox is open (visible). |
 | `optionHeight` | `number \| undefined` |  |  | Fixed height (in px) for each option row. Defaults to 28px (24px compact; 44px / 36px on mobile viewports). An explicit value wins on every viewport. |
 | `options` | `Option<Item>[] \| undefined` |  |  | Flat option list. Used when `groups` is not provided. |
 | `transitionDuration` | `number \| undefined` |  |  | Duration of open/close transition in milliseconds. |

package/dist/ai/OptionsContainer.md

@@ -14,10 +14,10 @@
 | --- | --- | --- | --- | --- |
 | `classPrefix` | `string` |  | yes | Base class prefix applied to the root element and all internal elements. The parent passes its own BEM block name so the generated markup uses parent-scoped class names instead of the container's own namespace. |
 | `direction` | `"horizontal" \| "vertical" \| undefined` |  |  | Direction of the layout of the inputs inside the fieldset. |
-| `hasErrors` | `boolean \| undefined` |  |  | Define if the component should be in an error state. It usually attaches a CSS class for styling purposes. |
-| `hasWarning` | `boolean \| undefined` |  |  | Define if the component should be in a warning state. Attaches a `--warnings` CSS class; suppressed when `hasErrors` is true. |
-| `hideLabel` | `boolean \| undefined` |  |  | Visually hides the label of the input while maintaining accessibility. |
-| `loading` | `boolean \| undefined` |  |  | Shows the container in a loading state. |
+| `hasErrors` | `boolean \| undefined` | `false` |  | Define if the component should be in an error state. It usually attaches a CSS class for styling purposes. |
+| `hasWarning` | `boolean \| undefined` | `false` |  | Define if the component should be in a warning state. Attaches a `--warnings` CSS class; suppressed when `hasErrors` is true. |
+| `hideLabel` | `boolean \| undefined` | `false` |  | Visually hides the label of the input while maintaining accessibility. |
+| `loading` | `boolean \| undefined` | `false` |  | Shows the container in a loading state. |
 | `loadingText` | `string \| undefined` |  |  | String displayed while items are being loaded. |
 | `noDataText` | `string \| undefined` |  |  | String displayed when there are no items to display. |
 | `options` | `Option<T>[]` |  | yes | List of options to render. |

package/dist/ai/changelog.json

@@ -1,12 +1,12 @@
 {
 	"schemaVersion": 1,
 	"library": "bitboss-ui",
-	"version": "3.0.0-beta.2",
+	"version": "3.0.0-beta.21",
 	"upgrade": "v2-to-v3",
 	"guide": "ai/guides/migration/v2-to-v3.md",
 	"summary": {
 		"renames": 9,
-		"behaviourBreaks": 29
+		"behaviourBreaks": 50
 	},
 	"breaking": [
 		{
@@ -238,6 +238,12 @@
 			"ruling": "F#/tag-unions",
 			"guide": "components/bb-popover.md, components/bb-dropdown.md"
 		},
+		{
+			"kind": "behaviour",
+			"description": "BbPopover panel PARTS <span> → <div> (__panel, __header, __content, __footer) — finishes the wrapper change one level in",
+			"ruling": "Q18.14",
+			"guide": "components/bb-popover.md"
+		},
 		{
 			"kind": "behaviour",
 			"description": "BbSmoothHeight inner measuring element mirrors tag (was always <div>) — span now yields span-in-span",
@@ -250,6 +256,18 @@
 			"ruling": "F#/badge-sides",
 			"guide": "components/bb-badge.md"
 		},
+		{
+			"kind": "behaviour",
+			"description": "Checkbox/radio/switch **groups**: disabled and selectable: false now disable a SELECTED option too (it was interactive, so the selection could be cleared)",
+			"ruling": "Q18.1",
+			"guide": "components/bb-checkbox-group.md"
+		},
+		{
+			"kind": "behaviour",
+			"description": "bitbossUiPlugin takes per-app config overrides (app.use(plugin, { locale })); setConfig from module scope now warns — it can only reach the build-time defaults",
+			"ruling": "Q18.2",
+			"guide": "v2-to-v3.md"
+		},
 		{
 			"kind": "behaviour",
 			"description": "Segmented-field anatomy uses ONE neutral element family, bb-segmented-field__*, on BOTH the date and time inputs — __fields(--empty/--range), __placeholder, __field-sizer, __field (+ all segment modifiers), __separator(--range), __calendar-btn→__trigger-btn(--active), __calendar-icon→__trigger-icon. **Breaking for the DATE input**, whose element classes were previously bb-base-date-picker-input__*. Block names are unchanged (.bb-base-date-picker-input / .bb-base-time-picker-input are still the roots), so single-control rules stay expressible. Dropped: __calendar/__calendar--shown and __clock-btn (all styled nowhere)",
@@ -279,6 +297,114 @@
 			"description": "BbTable #no-data fills the table's own full-width <td> (was: the slot replaced the empty-state <tr>)",
 			"ruling": "F#/no-data-shell",
 			"guide": "components/bb-table.md"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable row events click:row / contextmenu:row / dblclick:row emit (event, item) with item the RAW record (was the internal row wrapper with the record at row.item) and no trailing selected boolean",
+			"ruling": "owner 2026-08-25, plans/BBTABLE-GRID.md",
+			"guide": "components/bb-table.md § Row events"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable: hiding a column with thClass/tdClass + display: none (the v2/early-v3 narrow-screen recipe) no longer works — a hidden grid item keeps its track and shifts the following cells; set hidden: true on the column instead (filtering it out of columns was the beta.20 doctrine and lost the key from a partial order — DECISIONS § Column visibility, 2026-09-07)",
+			"ruling": "grid substrate, plans/BBTABLE-GRID.md",
+			"guide": "components/bb-table.md § Do not override; guide § Narrow screens"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable actions prop removed — the #actions slot creates the column (a prop without the slot rendered an empty column; now it renders nothing)",
+			"ruling": "DECISIONS § Column pins, 2026-09-07",
+			"guide": "components/bb-table.md § The #actions slot creates the actions column"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable fixedColumns (rendered-slot indices) removed — fixed: 'left' \\",
+			"ruling": "'right' on the column definition + fixed-select / fixed-actions; pins follow the column through a reorder, sticky in place as before",
+			"guide": "DECISIONS § Column pins, 2026-09-07"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable column snap takes the PARENT's column key ('select' / 'actions' by name, inclusive pairs, 'key.5' fractions) instead of a gridline index; --table-{id}-track-{index} became --table-{id}-track-{key} (slot-name spelling). Numeric snaps are ignored at runtime",
+			"ruling": "DECISIONS § Keyed snap, 2026-09-07",
+			"guide": "components/bb-table.md § snap names the parent column"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable highlight is opt-in: with highlighted unbound (or bound as undefined) clicking a row no longer applies bb-table-data__row--highlighted / aria-current — the table used to drive defineModel's local fallback, an unreadable state the app could not clear. Bind ref(null), not ref(); a context seed counts. click:row is unaffected",
+			"ruling": "owner 2026-08-27",
+			"guide": "components/bb-table.md § Highlight is opt-in"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable renders a CSS grid of divs with ARIA roles, not a <table>: every element selector under .bb-table (table/thead/tbody/tfoot/caption/tr/th/td/colgroup/col) matches nothing. Every .bb-table* class survives; .bb-table__table/__head/__body/__foot + [role=row]/[role=columnheader]/[role=cell] are the blessed translation (no data-* hooks, no shim classes)",
+			"ruling": "plans/BBTABLE-GRID.md § Migration & ecosystem",
+			"guide": "components/bb-table.md § Selector translation"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable #thead / #tbody / #tfoot inner markup: role-complete <div role=\"row\"> holding <div role=\"columnheader\\",
+			"ruling": "cell\"> — never <tr>/<th>/<td>; #tfoot's columnCount now feeds grid-column: span N / 1 / -1 (+ aria-colspan), not colspan. A custom #thead over an empty table publishes no tracks",
+			"guide": "plans/BBTABLE-GRID.md § Non-negotiables (exception 1)"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable --fill custom property removed (not republished) — it fed the fixed-layout self-correction loop the grid does not have",
+			"ruling": "plans/BBTABLE-GRID.md § Tracks (RULED 2026-08-26)",
+			"guide": "components/bb-table.md § --fill and --natural-width are removed"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable --natural-width custom property removed (not republished) — republishing the resolved-track sum would publish the container width under a \"natural\" name",
+			"ruling": "plans/BBTABLE-GRID.md § Tracks (RULED 2026-08-26)",
+			"guide": "components/bb-table.md § --fill and --natural-width are removed"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable track-distribution drift: surplus split equally among auto columns (748/52 → 544/256), constrained wrapping grows tracks by equal increments (~22% narrower long column, taller rows), frozen+auto ≤ ~19px/column, all-frozen tables no longer inflate the select/actions columns, scroll-container cells no longer floor the column (max-width: 0 ellipsis trick breaks), % widths in an overflowing table resolve against min-content (30%: 181 → 303px), expand-row content never widens parent columns, orphan snap → auto. Overflow threshold, wrap floor, frozen px and fixed equal split are exact",
+			"ruling": "plans/BBTABLE-GRID.md § Tracks + § v2.1",
+			"guide": "components/bb-table.md § Column widths: what holds and what drifts"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable copy-to-spreadsheet degrades: Chrome's selection serializer keys off computed display, so a selected grid pastes one value per line (was one cell per column). Accepted; sanctioned path = app-level \"copy as TSV from the items model\" recipe (queued, not shipped)",
+			"ruling": "plans/BBTABLE-GRID.md § Migration & ecosystem (7)",
+			"guide": "components/bb-table.md § Copy-to-spreadsheet degrades"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable print header repetition lost — <thead> page-repetition has no grid equivalent; data rows get break-inside: avoid",
+			"ruling": "plans/BBTABLE-GRID.md § Migration & ecosystem (8)",
+			"guide": "components/bb-table.md § Print: header repetition is gone"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable: global element CSS (table/td resets, .prose table, stray td { padding }) silently stops reaching the table — immunity benefit AND a silent look change on pages that leaned on it",
+			"ruling": "plans/BBTABLE-GRID.md § Migration & ecosystem (9)",
+			"guide": "components/bb-table.md § Global element CSS no longer reaches the table"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable browser floor raised to subgrid engines (Chrome/Edge 117, Firefox 71, Safari 16), block align-content centring from Chrome 123 / Safari 17.4 / Firefox 125; no @supports fallback",
+			"ruling": "plans/BBTABLE-GRID.md § Non-negotiables + § CSS port rules",
+			"guide": "components/bb-table.md § Browser floor"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable contain: inline-size (+ min-width: 0, grid-column: 1 / -1) on the expand / no-data / loading cells is load-bearing — overriding it lets full-span content resize the tracks (runaway loop with a nested inheriting table); joins gap: 0 on the root and nowrap on the actions cell in the do-not-override list",
+			"ruling": "plans/BBTABLE-GRID.md § Measurement & track publishing",
+			"guide": "components/bb-table.md § Do not override"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable caption reading-order micro-drift: .bb-table-caption is a div before the role=table root (named via aria-labelledby), no longer the table's first child",
+			"ruling": "plans/BBTABLE-GRID.md § Accessibility",
+			"guide": "components/bb-table.md § Small semantic and visual changes"
+		},
+		{
+			"kind": "behaviour",
+			"description": "BbTable busy bar now rides with the stuck header under fixed-headers (sticky moved to the .bb-table__head rowgroup; multi-row #thead heads stack instead of overlapping; aria-rowcount = totalItems + 1)",
+			"ruling": "plans/BBTABLE-GRID.md § Sticky + § v2.1",
+			"guide": "components/bb-table.md § Small semantic and visual changes"
 		}
 	]
 }