bitboss-ui 3.0.0-beta.66 → 3.0.0-beta.67

package/README.md

@@ -631,8 +631,9 @@ library field or select with a static `hide-label` and no `placeholder`:
 
 An `aria-labelledby`, a `#prefix` slot and an object `v-bind` count as
 legible; a field inside a `BbTable` / `BbTree` slot (its column header labels
-it) and one at the root of a component's template (the parent lays out its
-label) are not judged. `bitboss-ui check` reports the same as
+it), one at the root of a component's template (the parent lays out its
+label), a `variant="ghost"` cell editor and a single select that is neither
+`clearable` nor `multiple` (it always shows its pick) are not judged. `bitboss-ui check` reports the same as
 `hidden-label-placeholder`, as a warning.
 
 #### A dialog opened through a ref: `prefer-v-bb-dialog`

package/bin/bitboss-ui-mcp.mjs

@@ -15,14 +15,13 @@
  * loaded by nothing else. `bin/bitboss-ui.mjs` catches the resolution failure
  * and names them; `missingMcpPeers()` warns at registration time.
  *
- * `zod`'s declared range is `^3.25 || ^4.0` — copied verbatim from the SDK's
- * own dependency range, NOT invented. Do not "simplify" it to `>=` or to a
- * single major: the schemas built here are validated by the SDK's OWN copy of
- * zod, so a consumer hoisting a different MAJOR fails the SDK's brand checks
- * while npm stays silent (both ranges are independently satisfied). Mirroring
- * the range means it moves when the SDK's does. Everything used here
- * (`z.string`, `z.enum`, `z.number`, `.describe`, `.int`, `.min`, `.optional`)
- * is stable across zod 3 and 4, so the lower bound costs nothing.
+ * `zod`'s declared range is `^4.0`: the SDK's own dependency range
+ * (`^3.25 || ^4.0`) without zod 3, which carries an unpatched advisory and
+ * which nothing here needs. Never `>=`: the schemas
+ * built here are validated by the SDK's OWN copy of zod, so a consumer
+ * hoisting a different MAJOR fails the SDK's brand checks while npm stays
+ * silent (both ranges are independently satisfied). Keep it inside the SDK's
+ * range when that moves.
  *
  * Run standalone: `npx bitboss-ui mcp` (delegated from bin/bitboss-ui.mjs).
  * Registered with every MCP-capable harness by `npx bitboss-ui ai-init`
@@ -981,6 +980,38 @@ function historyWithCss(entry, manifest) {
 	];
 }
 
+/**
+ * `; states: a, b; c on x, y` — the states every part takes, then each state
+ * that reaches some parts only, with them (a group's `checked` is a row's,
+ * never the legend's). Read off the declared `pt:*` rows, so it cannot drift
+ * from what type-checks.
+ */
+function ptStatesLine(entry) {
+	const states = (entry.pt.states ?? []).map((x) => x.name);
+	if (!states.length) return '';
+	const parts = entry.pt.parts.map((x) => x.name);
+	const declared = new Set((entry.props ?? []).map((p) => p.name));
+	const wide = [];
+	const scoped = new Map();
+	for (const state of states) {
+		const on = parts.filter((part) => declared.has(`pt:${part}:${state}`));
+		if (on.length === parts.length) wide.push(state);
+		else if (on.length) {
+			// The shorter spelling: the parts it reaches, or the ones it does not.
+			const off = parts.filter((part) => !on.includes(part));
+			const key =
+				off.length < on.length
+					? `(not ${off.join(', ')})`
+					: `on ${on.join(', ')}`;
+			scoped.set(key, [...(scoped.get(key) ?? []), state]);
+		}
+	}
+	const some = [...scoped].map(
+		([where, list]) => `${list.join(', ')} ${where}`
+	);
+	return `; states: ${[wide.join(', '), ...some].filter(Boolean).join('; ')}`;
+}
+
 /** The compact `component` of the summary answer. */
 function summarizeComponent(entry, manifest) {
 	const shared = sharedProps(manifest);
@@ -1016,7 +1047,7 @@ function summarizeComponent(entry, manifest) {
 			: {}),
 		...(entry.pt?.parts?.length
 			? {
-					pt: `parts: ${entry.pt.parts.map((x) => x.name).join(', ')}${entry.pt.states?.length ? `; states: ${entry.pt.states.map((x) => x.name).join(', ')}` : ''}. Each is a \`pt:<part>\` / \`pt:<part>:<state>\` prop; the \`pt\` object takes the same keys WITHOUT the \`pt:\` prefix: { ${ptExample(entry)} }. What a part or state is: members: ['<part>'].`,
+					pt: `parts: ${entry.pt.parts.map((x) => x.name).join(', ')}${ptStatesLine(entry)}. Each a \`pt:<part>[:<state>]\` prop; \`pt\` object: the same keys WITHOUT the \`pt:\` prefix: { ${ptExample(entry)} }. Meanings: members: ['<part>'].`,
 				}
 			: {}),
 		...(entry.cssProps?.length

package/dist/_virtual/_plugin-vue_export-helper.js

@@ -1,8 +1,7 @@
-//#region \0plugin-vue:export-helper
+// \0plugin-vue:export-helper
 var e = (e, t) => {
 	let n = e.__vccOpts || e;
 	for (let [e, r] of t) n[e] = r;
 	return n;
 };
-//#endregion
 export { e as default };

package/dist/ai/BbAlert.md

@@ -99,7 +99,7 @@ The default variant is `outline`. `warning` and `destructive` are treated as
 high-priority for accessibility (see below).
 
 There is no built-in `success` (or `positive`) variant, and none will be added — the
-shared status vocabulary is closed to `danger`/`warn` by ruling, see
+shared status vocabulary is closed to `danger`/`warn` by design, see
 [Design Tokens § Brand knobs](./guides/design-tokens.md#brand-knobs-what-a-theme-builder-sets)
 ("state colors are project-owned"). Reach for `primary` for a positive
 confirmation, or register your own project variant (below) if you need a

package/dist/ai/BbAvatar.md

@@ -626,7 +626,7 @@ Set these on the element, or on a class you put on it, to retune this component
 | `--fg` | `.bb-avatar` | `var(--bb-primary-fg)` | Initials; the built-in icon is an 80/20 mix of this toward --bg |
 | `--default-icon-size` | `.bb-avatar` | `clamp(14px, calc(var(--size) * 0.7), 48px)` | Built-in fallback icon: 70% of the avatar, floored at 14px and capped at 48px. `--size` is the avatar's own box, set inline from the `size` prop. |
 | `--fs` | `.bb-avatar` | `max(8px, calc(var(--size) * 0.4))` | Initials: 40% of the avatar, floored at 8px |
-| `--elev` | `.bb-avatar` | `var(--bb-elev-sm)` | The theme's resting lift on small chrome (Q44.15), declared here so an ancestor's `--elev` cannot reach in; `--elev: none` flattens one. |
+| `--elev` | `.bb-avatar` | `var(--bb-elev-sm)` | The theme's resting lift on small chrome, declared here so an ancestor's `--elev` cannot reach in; `--elev: none` flattens one. |
 | `--size` | `.bb-avatar__default-icon` | `var(--default-icon-size)` |  |
 
 ## Component tree

package/dist/ai/BbBadge.md

@@ -955,7 +955,7 @@ Set these on the element, or on a class you put on it, to retune this component
 | `--min-size` | `.bb-badge` | `var(--min-size-md)` | pill min height and min width |
 | `--elev` | `.bb-badge` | `var(--bb-elev-sm)` | Resting lift. Invisible while `--bb-elev` is its default transparent layer. A chip is small enough that a theme wanting a different lift here than on a button sets `--elev` on this class. |
 | `--r` | `.bb-badge` | `calc(var(--bb-radius) * 0.5)` | Pill corners; the body and trailing wrappers round their outer edges to match |
-| `--fs` | `.bb-badge` | `calc(var(--bb-fs) - 2px)` | 12px at the default (Q49.25) |
+| `--fs` | `.bb-badge` | `calc(var(--bb-fs) - 2px)` | 12px at the default |
 | `--icon-size` | `.bb-badge` | `12px` | leading/append icons (passed to BbIcon as --size) |
 | `--gap` | `.bb-badge` | `3px` | space between label, icons and the trailing side |
 | `--px` | `.bb-badge` | `6px` | base side padding; the modifiers below scale it per side |

package/dist/ai/BbBadgeButton.md

@@ -50,7 +50,7 @@
 | `replace` | `boolean \| undefined` | `false` |  | Uses history replacement instead of push navigation. - With Vue Router (`to`), calls `router.replace`. - With Inertia (`href`), performs a replace visit. |
 | `tag` | `'button'` \| `'div'` \| `'span'` \| `'label'` | `'button'` |  | Element of the plain (non-link) button: `'button'` (default), `'div'` / `'span'` (a clickable box inside a button or link) or `'label'` (a file-upload trigger). Ignored with `href` / `to`. Off `button`, native `type` / `disabled` drop (disabled stays a class). |
 | `target` | `string \| undefined` |  |  | Target browsing context for anchor/Inertia links (e.g. `_self`, `_blank`). Ignored when rendering as a native button. |
-| `to` | `string \| wt \| bt \| undefined` |  |  | Route location to navigate to. When provided (and not disabled), the component renders as a Vue Router link. |
+| `to` | `string \| et \| X \| undefined` |  |  | Route location to navigate to. When provided (and not disabled), the component renders as a Vue Router link. |
 | `type` | `"button" \| "reset" \| "submit" \| undefined` | `'button'` |  | Native `type` attribute used when rendering as a button (e.g. `button`, `submit`, `reset`). |
 | `viewTransition` | `boolean \| undefined` | `false` |  | Inertia: run the page swap inside a View Transition, where the browser supports one. |
 
@@ -94,7 +94,7 @@ Set these on the element, or on a class you put on it, to retune this component
 | `--min-size` | `.bb-badge` | `var(--min-size-md)` | pill min height and min width |
 | `--elev` | `.bb-badge` | `var(--bb-elev-sm)` | Resting lift. Invisible while `--bb-elev` is its default transparent layer. A chip is small enough that a theme wanting a different lift here than on a button sets `--elev` on this class. |
 | `--r` | `.bb-badge` | `calc(var(--bb-radius) * 0.5)` | Pill corners; the body and trailing wrappers round their outer edges to match |
-| `--fs` | `.bb-badge` | `calc(var(--bb-fs) - 2px)` | 12px at the default (Q49.25) |
+| `--fs` | `.bb-badge` | `calc(var(--bb-fs) - 2px)` | 12px at the default |
 | `--icon-size` | `.bb-badge` | `12px` | leading/append icons (passed to BbIcon as --size) |
 | `--gap` | `.bb-badge` | `3px` | space between label, icons and the trailing side |
 | `--px` | `.bb-badge` | `6px` | base side padding; the modifiers below scale it per side |

package/dist/ai/BbBaseButton.md

@@ -587,7 +587,7 @@ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
 | `tag` | `'button'` \| `'div'` \| `'span'` \| `'label'` | `'button'` |  | Element of the plain (non-link) button: `'button'` (default), `'div'` / `'span'` (a clickable box inside a button or link) or `'label'` (a file-upload trigger). Ignored with `href` / `to`. Off `button`, native `type` / `disabled` drop (disabled stays a class). |
 | `target` | `string \| undefined` |  |  | Target browsing context for anchor/Inertia links (e.g. `_self`, `_blank`). Ignored when rendering as a native button. |
 | `text` | `string \| undefined` |  |  | Fallback text content rendered when no default slot is provided. |
-| `to` | `string \| wt \| bt \| undefined` |  |  | Route location to navigate to. When provided (and not disabled), the component renders as a Vue Router link. |
+| `to` | `string \| et \| X \| undefined` |  |  | Route location to navigate to. When provided (and not disabled), the component renders as a Vue Router link. |
 | `type` | `"button" \| "reset" \| "submit" \| undefined` | `"button"` |  | Native `type` attribute used when rendering as a button (e.g. `button`, `submit`, `reset`). |
 | `viewTransition` | `boolean \| undefined` | `false` |  | Inertia: run the page swap inside a View Transition, where the browser supports one. |
 

package/dist/ai/BbBreadcrumbs.md

@@ -717,7 +717,7 @@ States are listed in precedence order: when two are on at once and their entries
 | State | When it is on |
 | --- | --- |
 | `disabled` | Per node: a crumb that is disabled on its own; component-wide while the whole component is `disabled`. |
-| `active` | Per node, on each crumb's `item` / `text`: the current page — the last crumb, when it has no target (`href` / `to` / `onClick`). |
+| `active` | Per node, on each crumb's `item` / `text` / `icon`: the current page — the last crumb, when it has no target (`href` / `to` / `onClick`). |
 
 ## Events
 

package/dist/ai/BbButton.md

@@ -1234,6 +1234,12 @@ Anti-patterns:
 
 ### Accessibility
 
+- On a touch screen (`pointer: coarse`) an invisible hit area takes a button
+  to 44×44 without moving anything you see. It stops short of a neighbour: the
+  full 44px with no element beside the button, 4px a side when one sits next
+  to it (keep 8px between touch controls and the areas meet in the gap), none
+  across a `group`'s shared edge, a table cell's padding in a table, and none
+  on `variant="link"`. A mouse gets the visual box only.
 - Icon-only buttons still need an accessible name, but it works like any other
   button: put it in the default slot (or `text`) and it renders visually hidden (`bb-sr-only`) when
   `icon` is set — not removed. Use `aria-label` only to override that name, not
@@ -1311,7 +1317,7 @@ Anti-patterns:
 | `tag` | `'button'` \| `'div'` \| `'span'` \| `'label'` | `'button'` |  | Element to render for the plain (non-link, non-router) button: `'button'` (default), `'div'`/`'span'` when nesting inside another button or link, or `'label'` for a file-upload trigger. Ignored when `href`/`to` make the button render as a link. |
 | `target` | `string \| undefined` |  |  | Sets or retrieves the window or frame at which to target content. |
 | `text` | `string \| undefined` |  |  | Text content of the component. |
-| `to` | `string \| wt \| bt \| undefined` |  |  | Route Location the link should navigate to when clicked on. |
+| `to` | `string \| et \| X \| undefined` |  |  | Route Location the link should navigate to when clicked on. |
 | `trueValue` | `any` | `true` |  | Value emitted when the toggle is activated. |
 | `type` | `"button" \| "reset" \| "submit" \| undefined` |  |  | Gets the classification and default behavior of the button. |
 | `variant` | `'outline'` \| `'primary'` \| `'destructive'` \| `'secondary'` \| `'none'` \| `'ghost'` \| `'link'` | `"primary"` |  | Visual variant of the button: colours and surface only, never spacing or size. `'none'` takes no look (you own hover, focus and disabled); register a real one with the plugin's `buttonVariants` and style `.bb-button--<name>` (no CSS ships for it). |

package/dist/ai/BbCalendar.md

@@ -242,14 +242,73 @@ One prop decides the grid and the shape of the emitted string:
 | ------------------ | -------------------- | --------------------- | ------------- |
 | `date` _(default)_ | the day grid         | `2026-08-14`          | ISO instant   |
 | `datetime`         | day grid + time rail | `2026-08-14` + `time` | ISO instant   |
+| `week`             | day grid, week rows  | `2026-W44`            | —             |
 | `month`            | the 12-month grid    | `2026-08`             | —             |
 | `year`             | the year list        | `2026`                | —             |
 
-`month` and `year` are **calendar labels, not instants**: they force
+`week`, `month` and `year` are **calendar labels, not instants**: they force
 `floating`, ignore `utc` (with a DEV warning), and take `min` / `max` /
 `selectable` in their own shape (`min="2026-03"`). A bound finer than the
 unit is rounded outward, never silently truncated.
 
+#### Weeks
+
+`type="week"` picks ISO 8601 weeks (Monday to Sunday, numbered by the year
+that owns the week's Thursday) and emits `YYYY-Www`: `2026-W44`, and
+`2026-W53` for the week that runs into January 2027. The grid stays the day
+grid, with three differences:
+
+- a **week-number column** heads every row (its header names it for screen
+  readers only), and the grid always starts on Monday (`first-day-of-week` is
+  ignored: a week cannot straddle two rows);
+- **any day picks its week**: the whole row is the selection, one band from
+  Monday to Sunday. Hovering a row (or moving the keyboard cursor into it)
+  outlines the week a click would pick;
+- `min` / `max` take a week (`min="2026-W44"`) or a date, and a week is
+  selectable only when **all seven days** are inside them: `min="2026-10-28"`
+  (a Wednesday) leaves that week out. `selectable` receives the week value.
+
+`range` gives `['2026-W41', '2026-W43']` (solid ends, a wash between),
+`multiple` a sorted list of weeks. The day buttons and the keyboard are the
+day grid's; each day's accessible name adds its week and the week's dates
+("…, week 44, October 26 – November 1, 2026"), which are never shown.
+
+**A delivery week — type=week**
+
+```vue
+<template>
+	<div class="grid w-fit gap-3 rounded-(--bb-radius) border p-4">
+		<div>
+			<p class="m-0 text-sm font-medium">Delivery week</p>
+			<p class="m-0 text-xs text-(--bb-text-muted)">
+				{{ week ?? 'Any day picks its week' }}
+			</p>
+		</div>
+		<BbCalendar
+			v-model="week"
+			aria-label="Delivery week"
+			max="2026-W52"
+			min="2026-W40"
+			type="week"
+		/>
+	</div>
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue';
+import { BbCalendar } from 'bitboss-ui';
+
+/**
+ * `type="week"`: any day of a row picks its ISO week, and the value is the
+ * label `YYYY-Www` — no day, no zone. `min` / `max` take the same shape.
+ */
+const week = ref<string | null>('2026-W45');
+</script>
+```
+
+`week` (the row) and `weekNumber` (its number) restyle the rows: see
+[Restyling with passthrough](#restyling-with-passthrough).
+
 **A reporting period — type=month + range**
 
 ```vue
@@ -568,7 +627,8 @@ weekday headers follow, and so does a locale switch at runtime. Pass
 `first-day-of-week` (`0` = Sunday … `6` = Saturday) when the app's week is not
 its language's — an `en` app for a European audience takes
 `:first-day-of-week="1"`. `BbDatePicker` and `BbDatePickerInput` take the same
-prop and the same default.
+prop and the same default. Under `type="week"` the grid starts on Monday
+whatever the prop says (ISO weeks).
 
 ### Keyboard and accessibility
 
@@ -597,8 +657,9 @@ tokens, so `pt:root="[--px:2px]"` tightens the padding and the grid width
 follows), `header` (the navigation bar), `arrow` (the previous / next
 buttons), `month` and `year` (the heading buttons), `cellColumnHeader` (each
 weekday letter), `day` (one whole day cell) and `dayButton` (the button
-inside it), `monthItem` and `yearItem` (one button of the month / year
-panel).
+inside it), `week` (one row of seven days with `type="week"`) and
+`weekNumber` (its ISO week number), `monthItem` and `yearItem` (one button of
+the month / year panel).
 
 States: `root` is `disabled` while the calendar is; `arrow` is `disabled` at a
 `min` / `max` bound; `month` and `year` are `active` while their panel is
@@ -606,7 +667,10 @@ open. The cells resolve per node — on `day` and `dayButton`: `selected`,
 `disabled`, `today`, `outside` (a day of the previous or next month),
 `rangeStart` / `rangeEnd` / `inRange` (a committed range) and `highlighted`
 (the keyboard cursor). The panel items carry the same set without `today` and
-`outside`.
+`outside`. The week rows resolve per row — on `week` and `weekNumber`:
+`selected` (a chosen week; under `range` its two ends, as on their days),
+`rangeStart` / `rangeEnd` / `inRange`, and `disabled` only while the whole
+calendar is.
 
 `day` is the whole cell and `dayButton` the rounded mark inside it: a
 background on `pt:day` paints the full cell square, so restyle the mark on
@@ -626,6 +690,19 @@ bound's time on the day `min` / `max` falls on), and `header` /
 />
 ```
 
+Under `type="week"` the row and its number take the same grammar:
+
+```vue
+<BbCalendar
+	v-model="sprint"
+	pt:week-number="text-(--bb-text-muted)"
+	pt:week-number:selected="font-semibold"
+	pt:week:in-range="italic"
+	range
+	type="week"
+/>
+```
+
 `BbDatePicker` and `BbDatePickerInput` forward every one of these parts to
 the calendar they host: `pt:day` written on the picker, on the input or on a
 calendar in place lands on the same node, with the same states. The full
@@ -655,25 +732,25 @@ the page is `BbDatePicker`.
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `pt:<part>`, `pt:<part>:<state>`, `pt` | `PtValue` | | | Passthrough — a class list, or `{ class, style, attrs }`, bound to one named part of the component; the state form applies only while that state is on. Parts: `arrow`, `cellColumnHeader`, `day`, `dayButton`, `header`, `item`, `month`, `monthItem`, `root`, `year`, `yearItem`. States: `active`, `disabled`, `highlighted`, `inRange`, `outside`, `rangeEnd`, `rangeStart`, `selected`, `today`. What each one is: _Passthrough parts and states_ below. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. In `<script>` a `pt` value is typed `BbCalendarProps['pt']` (`PtValue` is not exported): § Typing `pt` in `<script>`. |
+| `pt:<part>`, `pt:<part>:<state>`, `pt` | `PtValue` | | | Passthrough — a class list, or `{ class, style, attrs }`, bound to one named part of the component; the state form applies only while that state is on. Parts: `arrow`, `cellColumnHeader`, `day`, `dayButton`, `header`, `item`, `month`, `monthItem`, `root`, `week`, `weekNumber`, `year`, `yearItem`. States: `disabled`, `highlighted`, `inRange`, `outside`, `rangeEnd`, `rangeStart`, `selected`, `today`, `active`. What each one is: _Passthrough parts and states_ below. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. In `<script>` a `pt` value is typed `BbCalendarProps['pt']` (`PtValue` is not exported): § Typing `pt` in `<script>`. |
 | `activeSegment` | `'start'` \| `'end'` |  |  | Which end the time rail edits in range + `type="datetime"` (`v-model:active-segment`). Standalone use manages this internally; an embedding host (the date input) drives it from its focused field. Ignored outside range + datetime. |
 | `ampm` | `boolean \| undefined` | `false` |  | 12-hour display with an AM/PM column (requires `type="datetime"`); emits stay 24h. |
 | `disabled` | `boolean \| undefined` | `false` |  | Disables every cell, the navigation and the time rail. |
-| `firstDayOfWeek` | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6 \| undefined` | `the locale's week start` |  | First day of the week (0 = Sunday … 6 = Saturday). Omitted, the active locale's week start: Monday for `it`, `de`, `fr`, `en-gb`…, Sunday for bare `en` (US) and `pt` (Brazil). |
-| `floating` | `boolean \| undefined` | `false` |  | Emit plain calendar strings instead of zoned ISO instants. Implied (and forced) by `type="month"` and `type="year"`. |
-| `max` | `string \| undefined` |  |  | Maximum selectable value, in this `type`'s shape. A finer bound is accepted and ceiled to the unit, with a warning. With `datetime`, on its own day the time rail disables the times after it. |
-| `min` | `string \| undefined` |  |  | Minimum selectable value in this `type`'s shape (`YYYY-MM-DD`; `YYYY-MM-DDTHH:mm` with `datetime`, `YYYY-MM` with `month`, `YYYY` with `year`). A finer bound is floored to the unit, with a warning. With `datetime` the rail also disables the earlier times on its day. |
-| `modelValue` | `string \| string[] \| null` |  | yes | v-model: `null` when empty, a string, a `[start, end]` pair with `range`, or a sorted array with `multiple`. The string is `YYYY-MM-DD` when `floating` (`YYYY-MM` / `YYYY` for `month` / `year`), otherwise a zoned ISO instant (carrying the time under `datetime`). |
-| `multiple` | `boolean` | `false` |  | Multi-selection: each pick toggles a value in a sorted array (days, months or years). Needs an array `modelValue` (`[]` when empty, never `null`). Throws with `range` or `type="datetime"`. |
+| `firstDayOfWeek` | `0 \| 1 \| 2 \| 3 \| 4 \| 5 \| 6 \| undefined` | `the locale's week start` |  | First day of the week (0 = Sunday … 6 = Saturday). Omitted, the active locale's week start: Monday for `it`, `de`, `fr`, `en-gb`…, Sunday for bare `en` (US) and `pt` (Brazil). Ignored under `type="week"`: ISO weeks run Monday to Sunday, so a week grid always starts on Monday. |
+| `floating` | `boolean \| undefined` | `false` |  | Emit plain calendar strings instead of zoned ISO instants. Implied (and forced) by `type="week"`, `type="month"` and `type="year"`. |
+| `max` | `string \| undefined` |  |  | Maximum selectable value, in this `type`'s shape (as `min`). A finer bound is ceiled to the unit, with a warning. With `datetime`, on its own day the time rail disables the times after it. |
+| `min` | `string \| undefined` |  |  | Minimum selectable value in this `type`'s shape (`YYYY-MM-DD`, `…THH:mm` with `datetime`, `YYYY-MM` / `YYYY` with `month` / `year`; a week or a date with `week`, whole weeks only). A finer bound is floored to the unit, with a warning. With `datetime` the rail disables the earlier times on its day. |
+| `modelValue` | `string \| string[] \| null` |  | yes | v-model: `null` when empty, a string, a `[start, end]` pair with `range`, or a sorted array with `multiple`. The string is `YYYY-MM-DD` when `floating` (`YYYY-Www` / `YYYY-MM` / `YYYY` for `week` / `month` / `year`), otherwise a zoned ISO instant (carrying the time under `datetime`). |
+| `multiple` | `boolean` | `false` |  | Multi-selection: each pick toggles a value in a sorted array (days, weeks, months or years). Needs an array `modelValue` (`[]` when empty, never `null`). Throws with `range` or `type="datetime"`. |
 | `numberOfMonths` | `number \| undefined` | `1` |  | How many months show side by side (day grids only). The keyboard crosses from one month into the next, and the arrows page all of them at once. Too narrow for them all, the months wrap onto the next row. |
 | `range` | `boolean` | `false` |  | Enables range selection (`[start, end]`). |
 | `readonly` | `boolean \| undefined` | `false` |  | Shows the calendar and lets the user page through it, but no pick changes the value. |
 | `seconds` | `boolean \| undefined` | `false` |  | Adds the seconds column (requires `type="datetime"`). |
-| `selectable` | `((date: string) => boolean) \| undefined` |  |  | Predicate invoked per candidate; return `false` to disable it. Receives the value in this `type`'s shape — `YYYY-MM` under `month`, `YYYY` under `year`. |
+| `selectable` | `((date: string) => boolean) \| undefined` |  |  | Predicate invoked per candidate; return `false` to disable it. Receives the value in this `type`'s shape — `YYYY-Www` under `week` (so a week is enabled or disabled whole), `YYYY-MM` under `month`, `YYYY` under `year`. |
 | `step` | `number \| undefined` | `1` |  | Minute-column granularity and arrow stepping (requires `type="datetime"`). |
 | `time` | `string \| string[] \| null \| undefined` |  |  | Companion time model (`v-model:time`), 24-hour `HH:mm` / `HH:mm:ss`. With `floating` it is the only carrier of the time; otherwise it mirrors the time inside `modelValue`. Requires `type="datetime"`. |
-| `type` | `'date'` \| `'month'` \| `'year'` \| `'datetime'` | `"date"` |  | What the calendar selects and emits: `date` (a day), `datetime` (a day plus a time rail), `month` (`YYYY-MM`) or `year` (`YYYY`). `month` / `year` force `floating`, ignore `utc`, and leave the time props inert. |
-| `utc` | `boolean \| undefined` | `false` |  | Emit UTC (`...Z`) instead of the local offset. Ignored with `floating`, and therefore with `type="month"`/`type="year"`. |
+| `type` | `'date'` \| `'month'` \| `'year'` \| `'week'` \| `'datetime'` | `"date"` |  | What the calendar selects and emits: `date` (a day), `datetime` (a day plus a time rail), `week` (an ISO week, `YYYY-Www`: any day picks its row), `month` (`YYYY-MM`) or `year` (`YYYY`). `week` / `month` / `year` force `floating`, ignore `utc`, and leave the time props inert. |
+| `utc` | `boolean \| undefined` | `false` |  | Emit UTC (`...Z`) instead of the local offset. Ignored with `floating`, and therefore with `type="week"`/`type="month"`/`type="year"`. |
 
 ## Passthrough parts and states
 
@@ -687,6 +764,8 @@ the page is `BbDatePicker`.
 | `month` | The month heading button; it opens the month panel. |
 | `year` | The year heading button; it opens the year panel. |
 | `cellColumnHeader` | Each weekday letter above the grid — a broadcast. |
+| `week` | One row of seven days with `type="week"` — the band a picked week paints and the hover outline. A broadcast resolved per row. |
+| `weekNumber` | The ISO week number heading each row with `type="week"` — a broadcast resolved per row. |
 | `day` | One whole day cell — a broadcast resolved per day. A background here paints the full cell square; restyle the round mark on `dayButton`. |
 | `dayButton` | The button inside a day cell — the mark that shows selection. A broadcast resolved per day. |
 | `monthItem` | One month button of the month panel (the home grid of `type="month"`) — a broadcast resolved per month. |
@@ -699,11 +778,11 @@ States are listed in precedence order: when two are on at once and their entries
 | --- | --- |
 | `outside` | Per node, on `day` / `dayButton`: a day of the previous or next month, shown to fill the grid. |
 | `today` | Per node, on `day` / `dayButton`: today. |
-| `inRange` | Per node, on the cells (`day`, `dayButton`, `monthItem`, `yearItem`): inside a committed range, between its ends. |
-| `selected` | Per node, on the cells: a chosen day, month or year; on `item`, the picked time's entry in each column. |
-| `rangeStart` | Per node, on the cells: a committed range's first day, month or year. |
-| `rangeEnd` | Per node, on the cells: a committed range's last day, month or year. |
-| `disabled` | Component-wide while the calendar is `disabled`. Also per node: on the cells, one outside `min` / `max` or refused by `selectable`; on `arrow`, at a bound or while the month / year panel is open; on `item`, a time entry outside the bound's time on the day `min` / `max` falls on. |
+| `inRange` | Per node, on the cells (`day`, `dayButton`, `monthItem`, `yearItem`) and the week rows (`week`, `weekNumber`): inside a committed range, between its ends. |
+| `selected` | Per node, on the cells: a chosen day, month or year; on `week` / `weekNumber`, a chosen week (a range's ends too, as on its days); on `item`, the picked time's entry in each column. |
+| `rangeStart` | Per node, on the cells and the week rows: a committed range's first day, week, month or year. |
+| `rangeEnd` | Per node, on the cells and the week rows: a committed range's last day, week, month or year. |
+| `disabled` | Component-wide while the calendar is `disabled`. Also per node: on the cells, one outside `min` / `max` or refused by `selectable`; on `arrow`, at a bound or while the month / year panel is open; on `year`, while the year panel cannot open; on `item`, a time entry outside the bound's time on the day `min` / `max` falls on. |
 | `active` | Per node, on `month` / `year`: its panel is open. |
 | `highlighted` | Per node, on the cells: the keyboard cursor. |
 
@@ -736,6 +815,7 @@ Set these on the element, or on a class you put on it, to retune this component
 | `--unit-row` | `.bb-calendar` | `calc(var(--cell) * 1.25)` | Row pitch for the coarse grids (month/year), where a "row" is one of four month rows rather than a week. Roomier than --cell because twelve months in a 4×3 grid have space the 6×7 day grid does not. |
 | `--ring-t` | `.bb-calendar__arrow` | `var(--bb-transition-medium)` |  |
 | `--ring-t` | `.bb-calendar__heading-btn` | `var(--bb-transition-medium)` |  |
+| `--wk` | `.bb-calendar--week` | `calc(var(--cell) * 0.6)` | Two tabular digits at 11px, with air: the column holds numbers only. |
 
 ## Component tree
 
@@ -746,7 +826,7 @@ Set these on the element, or on a class you put on it, to retune this component
 - **CSS custom properties** listed on a node are declared on THAT node's root and read by elements inside it. Set one on that node's root or on the element inside it that reads it — the pt part that lands there is how you reach it (`pt:box="[--border-color:…]"` on a text input) — never on `BbCalendar`'s root, where the node's own declaration masks it (design-tokens guide, _Overriding one from a consumer app_, rule 0).
 - Listed nodes are the ones `BbCalendar`'s API reaches or that declare a documented CSS variable; the rest fold into "also mounts". The complete tree, repeats and undocumented locals included, is `manifest/components/BbCalendar.tree.json`.
 
-- `BbCalendar` _(this component)_ — its own template binds: `header` → `div.bb-calendar__header`, `arrow` → `BbBaseButton`, `month` → `BbBaseButton`, `year` → `BbBaseButton`, `day` → `div.bb-calendar__day`, `dayButton` → `button.bb-calendar__day-button`
+- `BbCalendar` _(this component)_ — its own template binds: `header` → `div.bb-calendar__header`, `arrow` → `BbBaseButton`, `month` → `BbBaseButton`, `year` → `BbBaseButton`, `week` → `div.bb-calendar__week`, `weekNumber` → `div.bb-calendar__week-number`, `day` → `div.bb-calendar__day`, `dayButton` → `button.bb-calendar__day-button`
   - `BbBaseButton` _(public — [contract](./BbBaseButton.md))_ — its own pt parts (`BbBaseButton`): `root` → `RouterComponent`, `root` → `a`, `root` → `component`; also mounts `RouterComponent`
   - `CommonTimeSelector` _(internal — not importable, reach it through `BbCalendar`)_ — `BbCalendar`'s pt parts land here: `header` → `div.bb-time-selector__header`, `cellColumnHeader` → `div.bb-time-selector__cell-column-header`, `item` → `BbBaseButton`; documented CSS variables: `--time-mark`; also mounts `BbBaseButton`
   - Also mounts `ScaleFade`, `Slide`, `CalendarMonthPanel`, `CalendarYearPanel`

package/dist/ai/BbCheckbox.md

@@ -685,6 +685,10 @@ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
 
 ### Accessibility
 
+- On a touch screen a lone checkbox's row gets an invisible hit area up to 44px
+  tall, centred, with nothing moving: the full 44px with no element beside the
+  field, 4px a side with one (8px apart, the areas meet in the gap). A group
+  component spaces its own rows for this.
 - Always pass a `label` (or `label` slot) — never rely on nearby text alone.
 - `errors`, `warnings`, `description` and `hint` are all wired to the input through
   `aria-describedby`, in that order: the reason the field is invalid is spoken

package/dist/ai/BbCheckboxGroup.md

@@ -1116,7 +1116,7 @@ for a preset that fits any row type (never `<any>`), not an imported
 | `selectable` | `boolean \| ((item: T) => boolean) \| undefined` | `true` |  | Defines whether options are selectable. Can be a global boolean that affects all options or a function that accepts an item and returns a boolean that only affects that item. Non-selectable options are rendered disabled. |
 | `validationLabel` | `string \| undefined` |  |  | The field's name in validation messages (`{field}`): "Email is not valid". Defaults to the `label` (or `legend`), then "This field"; never the `name`. Set it when the label is hidden or reads badly in a sentence (icon-only, a question). `BbForm` only. |
 | `validationMode` | `'aggressive'` \| `'balanced'` \| `'lazy'` \| `'submit-only'` \| `'submit-live'` |  |  | When the field validates: `aggressive` (each change), `balanced` (on leave, then live while in error), `lazy` (on leave), `submit-only`, `submit-live`. Unset: the `BbForm`'s `validation-mode`, then `formControls.validationMode` (`'balanced'`). `BbForm` only. |
-| `variant` | `'pill'` \| `'line'` |  |  | A tab-strip look (Q76.11 d): `'pill'` (a pill per run of adjacent picks) or `'line'` (a bar under each pick). `list-layout="vertical"` stacks it. Register more with `checkboxVariants`. Unset: the group's own rows. |
+| `variant` | `'pill'` \| `'line'` |  |  | A tab-strip look: `'pill'` (a pill per run of adjacent picks) or `'line'` (a bar under each pick). `list-layout="vertical"` stacks it. Register more with `checkboxVariants`. Unset: the group's own rows. |
 | `warnings` | `string \| string[] \| undefined` |  |  | Warning messages under the field, a string or array: amber, in their own `aria-live` region and in the control's `aria-describedby` after the errors. Non-empty turns on the warning state; errors win when both are set. |
 
 ## Passthrough parts and states

package/dist/ai/BbColorInput.md

@@ -43,7 +43,7 @@
 | `--border-focus` | `pt:box` | `CommonFieldInput` | frame while focused, or --active |
 | `--ring-size` | `pt:box` | `CommonFieldInput` | ring width; 0 is a variant declining the ring |
 | `--ring-color` | `pt:box` | `CommonFieldInput` | ring colour; state owns it, not variants |
-| `--elev` | `pt:box` | `CommonFieldInput` | Resting lift, alone in `box-shadow`: the ring is the box's outline (Q81.6), so a theme's `--elev: none` never takes the ring with it. |
+| `--elev` | `pt:box` | `CommonFieldInput` | Resting lift, alone in `box-shadow`: the ring is the box's outline, so a theme's `--elev: none` never takes the ring with it. |
 | `--frost` | `pt:box` | `CommonFieldInput` | Plate frost — a full `backdrop-filter` value (see --bb-surface-filter). Routed through a local rather than read from the token directly, so a chrome-less variant can decline it: frosting a ghost field gives it the plate it is contractually not supposed to have. |
 | `--inside-label-clearance` | `pt:box`, `pt:prefix`, `pt:suffix` | `CommonFieldInput` | Height and top padding added above the text for a label rendered inside the box. Zero here; the `--inside-label` rules at the bottom of this file raise it to one label line, or two with a description. |
 | `--w` | `pt:icon` | `BbIcon` | `--w` is set inline by BbIcon from the size prop. The `initial` default seals it: without it an ancestor's `--w` (e.g. a dropdown's width bridge) would inherit in and size the icon. The `--size` indirection stays so higher-specificity rules (e.g. `.bb-badge .bb-icon`) can re-point it. |
@@ -682,7 +682,7 @@ A `pt` value written in `<script>` (a constant, a preset, a wrapper's
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `pt:<part>`, `pt:<part>:<state>`, `pt` | `PtValue` | | | Passthrough — a class list, or `{ class, style, attrs }`, bound to one named part of the component; the state form applies only while that state is on. Parts: `box`, `clear`, `description`, `hint`, `icon`, `indicator`, `input`, `label`, `message`, `panel`, `prefix`, `root`, `sheet`, `spinner`, `suffix`, `swatch`. States: `disabled`, `errors`, `ghost`, `hasValue`, `loading`, `outline`, `readonly`, `secondary`, `warnings`, `selected`. What each one is: _Passthrough parts and states_ below. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. In `<script>` a `pt` value is typed `BbColorInputProps['pt']` (`PtValue` is not exported): § Typing `pt` in `<script>`. |
+| `pt:<part>`, `pt:<part>:<state>`, `pt` | `PtValue` | | | Passthrough — a class list, or `{ class, style, attrs }`, bound to one named part of the component; the state form applies only while that state is on. Parts: `box`, `clear`, `description`, `hint`, `icon`, `indicator`, `input`, `label`, `message`, `panel`, `prefix`, `root`, `sheet`, `spinner`, `suffix`, `swatch`. States: `disabled`, `errors`, `ghost`, `hasValue`, `loading`, `open`, `outline`, `readonly`, `secondary`, `warnings`, `selected`. What each one is: _Passthrough parts and states_ below. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. In `<script>` a `pt` value is typed `BbColorInputProps['pt']` (`PtValue` is not exported): § Typing `pt` in `<script>`. |
 | `adaptive` | `boolean \| undefined` | ``config.adaptive` (`true`)` |  | When `true`, the color palette opens as a bottom off-canvas sheet on mobile viewports instead of a floating popover; on desktop it stays a popover. Mirrors the adaptive behaviour of `BbSelect`/`BbDatePickerInput`. When unset, falls back to the global `config.adaptive`. |
 | `alpha` | `boolean \| undefined` | `false` |  | Enable the alpha channel. Shows an opacity slider and uses `#RRGGBBAA` hex8 format. |
 | `append:icon` | `string \| undefined` |  |  | Name of the icon to be added at the end of the input. |
@@ -756,6 +756,7 @@ States are listed in precedence order: when two are on at once and their entries
 | `disabled` | Component-wide: the control is `disabled`. |
 | `warnings` | 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. |
 | `errors` | Component-wide: the control is in its error state (`errors` / `has-errors`, or its validation) — the message line and the box turn red. |
+| `open` | Component-wide: the palette is showing — `pt:indicator:open` styles the swatch button while it is. |
 | `loading` | Component-wide: `loading` is on; the box shows its `spinner`. |
 | `ghost` | On the field's parts: `variant: 'ghost'`. Below the real states, like every variant. |
 | `outline` | On the field's parts: `variant: 'outline'`. Merged after the part's base entry and before its states, so the real states still win. |

package/dist/ai/BbConfirm.md

@@ -759,7 +759,7 @@ The map is typed where you write it by `definePt`, never with an imported
 
 | Prop | Type | Default | Required | Description |
 | --- | --- | --- | --- | --- |
-| `pt:<part>`, `pt:<part>:<state>`, `pt` | `PtValue` | | | Passthrough — a class list, or `{ class, style, attrs }`, bound to one named part of the component; the state form applies only while that state is on. Parts: `action`, `close`, `content`, `footer`, `header`, `root`, `sheet`, `text`, `title`. States: `default`, `destructive`, `open`. What each one is: _Passthrough parts and states_ below. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. In `<script>` a `pt` value is typed `BbConfirmProps['pt']` (`PtValue` is not exported): § Typing `pt` in `<script>`. |
+| `pt:<part>`, `pt:<part>:<state>`, `pt` | `PtValue` | | | Passthrough — a class list, or `{ class, style, attrs }`, bound to one named part of the component; the state form applies only while that state is on. Parts: `action`, `close`, `content`, `footer`, `header`, `root`, `sheet`, `text`, `title`. States: `default`, `destructive`, `fullscreen`, `open`. What each one is: _Passthrough parts and states_ below. `pt` is the object form with the same keys minus the prefix (`{ icon: '…', 'icon:loading': '…' }`). See `guides/passthrough.md`. In `<script>` a `pt` value is typed `BbConfirmProps['pt']` (`PtValue` is not exported): § Typing `pt` in `<script>`. |
 
 ## Passthrough parts and states
 
@@ -782,6 +782,7 @@ States are listed in precedence order: when two are on at once and their entries
 | State | When it is on |
 | --- | --- |
 | `open` | Component-wide: a confirm is showing. |
+| `fullscreen` | Component-wide: the showing confirm is fullscreen (its `fullscreen` option, or `'mobile'` on a phone). |
 | `default` | Component-wide, from the message: `variant: 'default'`. Merged after the part's base entry and before its states, so the real states still win. |
 | `destructive` | Component-wide, from the message: `variant: 'destructive'`. Below the real states, like every variant. |