division-ds 0.2.1 → 0.3.1

package/public/docs/components/date-range-picker.md

@@ -0,0 +1,135 @@
+# DateRangePicker
+
+> A start and an end date in one field, an add-on to DatePicker. Type both, or open two months side by side: the first day you pick is the start, the band follows you to the second, which sets the end and closes the calendar. Put DatePresets in `aside` for one-click periods like Last 7 days. Installs DatePicker with it.
+
+- **Best for:** A booking, a report window, a leave request.
+- **Not for:** One day: DatePicker.
+- Molecule. Source: `src/components/molecules/date-range-picker/DateRangePicker.tsx`
+- Rendered docs page: `/components/date-range-picker`
+
+## Import
+
+```tsx
+import { DateRangePicker, EMPTY_RANGE, useDateRangePicker } from 'src/components/molecules/date-range-picker/DateRangePicker'
+```
+
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
+
+## Props
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| `label` | `string` |  | Names the field. Leave it out inside a FormField, which sets it from its own label. Outside one it is required, and `division-ds check` flags a missing one. |
+| `value` | `{ start: string; end: string }` |  | Controlled range. Each end is 'YYYY-MM-DD' or ''. |
+| `defaultValue` | `{ start: string; end: string }` | `{ start: '', end: '' }` | Starting range when the picker holds it itself. |
+| `onValueChange` | `(range: DateRange) => void` |  | Fires when either end changes. Days picked in the calendar always arrive in order. |
+| `min` | `string` |  | Earliest date, 'YYYY-MM-DD'. |
+| `max` | `string` |  | Latest date, 'YYYY-MM-DD'. |
+| `isDateDisabled` | `(date: string) => boolean` |  | Days that cannot be picked. |
+| `locale` | `string` |  | Segment order, names and first day of the week. Defaults to the browser's. |
+| `weekStartsOn` | `number` |  | 0 Sunday to 6 Saturday. Defaults to the locale's. |
+| `aside` | `ReactNode` |  | Beside the months, in the popover. DatePresets reads and sets the range by itself here. |
+| `partLabels` | `[string, string]` | `['Start date', 'End date']` | The names of the two dates. |
+| `disabled` | `boolean` | `false` | Disables both dates and the button. |
+| `invalid` | `boolean` |  | Marks the field invalid. FormField sets it. |
+| `required` | `boolean` |  | Marks both dates required. FormField sets it. |
+| `name` | `string` |  | Submits name-start and name-end with a form. |
+| `id` | `string` |  | The field's id. FormField sets it. |
+| `aria-describedby` | `string` |  | The ids of the help and error text. FormField sets it. |
+| `className` | `string` |  | Combined with the field's classes. |
+| `ref` | `Ref<HTMLDivElement>` |  | The field's group element. |
+| `useDateRangePicker()` | `() => { value: DateRange; select: (range: DateRange) => void } \| null` |  | Inside the popover: the range, and a way to set it and close. For your own aside content. |
+
+## Types and helpers
+
+Exported beside the component, from the same file. Import a type with `import type { ... }`.
+
+```ts
+/** A start and an end, each 'YYYY-MM-DD' or '' while not chosen. */
+export type DateRange = { start: IsoDate | ''; end: IsoDate | '' }
+```
+
+```ts
+export const EMPTY_RANGE: DateRange = { start: '', end: '' }
+```
+
+```ts
+/** The open picker's range, and a way to set it and close. DatePresets reads it, so a preset in
+ *  `aside` needs no wiring. null outside a DateRangePicker. */
+export const useDateRangePicker = () => useContext(Context)
+```
+
+## Examples
+
+Each is compiled and rendered on the docs page. Imports are omitted; see above.
+
+### Default
+
+```tsx
+<div className="w-full max-w-sm">
+  <DateRangePicker label="Stay" />
+</div>
+```
+
+### With DatePresets beside the months
+
+```tsx
+<div className="w-full max-w-sm">
+  <FormField label="Report period" help="Pick a preset, or two days.">
+    <DateRangePicker aside={<DatePresets />} />
+  </FormField>
+</div>
+```
+
+### Controlled: the page holds the range
+
+```tsx
+function Controlled() {
+  const [range, setRange] = useState<DateRange>({ start: '2026-11-09', end: '2026-11-13' })
+  return (
+    <div className="flex w-full max-w-sm flex-col gap-2">
+      <DateRangePicker label="Leave" value={range} onValueChange={setRange} />
+      <span className="font-mono text-xs text-[var(--color-text-secondary)]">
+        start: {range.start || '—'}, end: {range.end || '—'}
+      </span>
+    </div>
+  )
+}
+
+<Controlled />
+```
+
+### Limits: November and December only
+
+```tsx
+<div className="w-full max-w-sm">
+  <DateRangePicker label="Rental" min="2026-11-01" max="2026-12-30" defaultValue={{ start: '2026-11-20', end: '2026-11-23' }} />
+</div>
+```
+
+## Keyboard
+
+| Keys | Result |
+|---|---|
+| `0–9` `↑` `↓` | Types or steps the focused segment of either date. |
+| `←` `→` | In the field: the next segment, across both dates. In the calendar: the day before or after, moving the band. |
+| `Page Up` `Page Down` | A month earlier or later. With Shift, a year. |
+| `Enter` `Space` | Picks the start, then the end, which closes the calendar. |
+| `Esc` | Closes the calendar. A start picked without an end stays as the start. |
+
+## Do
+
+- Add DatePresets in aside when people mostly want the usual periods.
+- Validate the length yourself if a range has a limit (a 30-day report), and say so in help text.
+
+## Don't
+
+- Don't use two separate DatePickers for a start and an end: nobody sees the band.
+- Don't reorder a typed range for the user; the field marks it invalid so they can see what they typed.
+
+## Anatomy
+
+- **Field**: A group named by the label, holding two segmented dates (Start date, End date) and the calendar button. A typed end before the start marks it invalid.
+- **Calendar**: Two months, stacked on narrow screens. The ends are solid accent squares, the days between a light accent band.
+- **Hint**: "Pick the first day." or "Pick the last day.", under the months, announced when it changes.
+- **Aside**: An optional column beside the months, for DatePresets.

package/public/docs/components/description-list.md

@@ -13,7 +13,7 @@
 import { DescriptionList } from 'src/components/molecules/description-list/DescriptionList'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/dialog.md

@@ -13,7 +13,7 @@
 import { Dialog, DialogClose, DialogContent, DialogFooter, DialogTrigger } from 'src/components/organisms/dialog/Dialog'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/divider.md

@@ -13,7 +13,7 @@
 import { Divider } from 'src/components/atoms/divider/Divider'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/dropdown-menu.md

@@ -13,7 +13,7 @@
 import { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger } from 'src/components/molecules/dropdown-menu/DropdownMenu'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/empty-state.md

@@ -13,7 +13,7 @@
 import { EmptyState } from 'src/components/molecules/empty-state/EmptyState'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/footer.md

@@ -13,7 +13,7 @@
 import { Footer } from 'src/components/organisms/footer/Footer'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/form-field.md

@@ -15,7 +15,7 @@ import { FormField } from 'src/components/molecules/form-field/FormField'
 import { ErrorSummary } from 'src/components/molecules/form-field/ErrorSummary'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 
@@ -25,7 +25,7 @@ Paths are from the Division DS repository root. Installed with shadcn they start
 | `help` | `string` |  | Instruction text, read out before any error. |
 | `error` | `string` |  | Sets invalid on the control and adds the error line. |
 | `required` | `boolean` | `false` | Adds the asterisk (hidden from screen readers) and the built-in required attribute on the control. That attribute is what assistive technology actually announces. |
-| `children` | `ReactElement` |  | Exactly one control: Input, Textarea, Select or QuantityStepper. A label set on a Select or QuantityStepper child is replaced by the FormField label. An id you give the control is kept (point an ErrorSummary entry at it); without one, FormField makes one up. |
+| `children` | `ReactElement` |  | Exactly one control: Input, Textarea, Select, MultiSelect, QuantityStepper, DatePicker, DateRangePicker or TimeField. The controls that name themselves (all but Input and Textarea) take the FormField label, so leave their own label out. An id you give the control is kept (point an ErrorSummary entry at it); without one, FormField makes one up. |
 | `className` | `string` |  | Extra CSS classes, merged with the outer element's own. When two Tailwind classes clash, the later one wins. |
 | `ref` | `Ref<HTMLDivElement>` |  | Passed through to the outer element. |
 | `errors (ErrorSummary)` | `{ fieldId: string; message: string }[]` |  | What stopped the form from submitting, in the order of the fields. Each entry links to its field and moves focus there. An empty list shows nothing. |

package/public/docs/components/icon-button.md

@@ -13,7 +13,7 @@
 import { IconButton } from 'src/components/atoms/icon-button/IconButton'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/input.md

@@ -13,7 +13,7 @@
 import { Input, inputVariants } from 'src/components/atoms/input/Input'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Requires
 

package/public/docs/components/kanban-board.md

@@ -13,7 +13,7 @@
 import { KanbanBoard, applyKanbanMove, groupKanbanItems, kanbanDragOver, kanbanDrop, kanbanMessages, kanbanPosition } from 'src/components/organisms/kanban-board/KanbanBoard'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Requires
 

package/public/docs/components/kbd.md

@@ -13,7 +13,7 @@
 import { Kbd } from 'src/components/atoms/kbd/Kbd'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/link.md

@@ -13,7 +13,7 @@
 import { Link, linkVariants } from 'src/components/atoms/link/Link'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/list-item.md

@@ -14,7 +14,7 @@
 import { List, ListItem } from 'src/components/molecules/list-item/ListItem'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Requires
 

package/public/docs/components/loading-animation.md

@@ -13,7 +13,7 @@
 import { LoadingAnimation } from 'src/components/atoms/loading-animation/LoadingAnimation'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/multi-select.md

@@ -13,7 +13,7 @@
 import { MultiSelect } from 'src/components/molecules/multi-select/MultiSelect'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Requires
 
@@ -23,7 +23,7 @@ Paths are from the Division DS repository root. Installed with shadcn they start
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `label` | `string` |  | Required. The name screen readers give the text field and the list. FormField replaces it with its own label. |
+| `label` | `string` |  | The name screen readers give the text field and the list. Leave it out inside a FormField, which sets it from its own label. Outside one it is required, and `division-ds check` flags a missing one. |
 | `options` | `SelectOption[]` |  | { value, label, disabled? }, the same rows Select takes. |
 | `value` | `string[]` |  | The current selection when the page keeps track of it (controlled), as option values in the order they were chosen. |
 | `defaultValue` | `string[]` |  | The starting selection when the component keeps track itself (uncontrolled). |
@@ -60,7 +60,7 @@ const LOADOUT = [
 
 <div className="w-full max-w-md">
   <FormField label="Loadout">
-    <MultiSelect label="Loadout" options={LOADOUT} placeholder="Choose your kit…" />
+    <MultiSelect options={LOADOUT} placeholder="Choose your kit…" />
   </FormField>
 </div>
 ```
@@ -84,7 +84,7 @@ function ControlledExample() {
   return (
     <div className="flex flex-col gap-2 w-full max-w-md">
       <FormField label="Loadout" help="Remove a tag and watch the others close the gap.">
-        <MultiSelect label="Loadout" options={LOADOUT} value={kit} onValueChange={setKit} />
+        <MultiSelect options={LOADOUT} value={kit} onValueChange={setKit} />
       </FormField>
       <span className="font-mono text-xs text-[var(--color-text-secondary)]">value: [{kit.join(', ')}]</span>
     </div>
@@ -110,7 +110,7 @@ const LOADOUT = [
 
 <div className="w-full max-w-md">
   <FormField label="Loadout" error="Pick eye protection.">
-    <MultiSelect label="Loadout" options={LOADOUT} defaultValue={['mags']} />
+    <MultiSelect options={LOADOUT} defaultValue={['mags']} />
   </FormField>
 </div>
 ```

package/public/docs/components/navbar.md

@@ -13,7 +13,7 @@
 import { Navbar } from 'src/components/organisms/navbar/Navbar'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/newsletter-form.md

@@ -13,7 +13,7 @@
 import { NewsletterForm } from 'src/components/organisms/newsletter-form/NewsletterForm'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/page-header.md

@@ -13,7 +13,7 @@
 import { PageHeader } from 'src/components/molecules/page-header/PageHeader'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/pagination.md

@@ -13,7 +13,7 @@
 import { Pagination, paginationRange } from 'src/components/molecules/pagination/Pagination'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/product-card.md

@@ -14,7 +14,7 @@
 import { ProductCard, ProductGrid } from 'src/components/organisms/product-card/ProductCard'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/progress.md

@@ -13,7 +13,7 @@
 import { Progress } from 'src/components/atoms/progress/Progress'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/prompt-input.md

@@ -13,7 +13,7 @@
 import { PromptInput } from 'src/components/molecules/prompt-input/PromptInput'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Requires
 

package/public/docs/components/quantity-stepper.md

@@ -13,13 +13,13 @@
 import { QuantityStepper, clampQuantity, gridMax } from 'src/components/molecules/quantity-stepper/QuantityStepper'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `label` | `string` |  | Required. Names the field and both buttons ("Decrease Speed loader quantity"). |
+| `label` | `string` |  | Names the field and both buttons ("Decrease Speed loader quantity"). Leave it out inside a FormField, which sets it from its own label. Outside one it is required, and `division-ds check` flags a missing one. |
 | `value` | `number` |  | Controlled value (your page holds it). |
 | `defaultValue` | `number` | `min` | Starting value when the component holds the value itself (uncontrolled). |
 | `onValueChange` | `(value: number) => void` |  | Fires with the final value, pulled inside the limits: after a button click, an arrow key, Home/End, or when typing is finished by leaving the field or pressing Enter. |

package/public/docs/components/radio.md

@@ -13,7 +13,7 @@
 import { Radio, RadioGroup } from 'src/components/atoms/radio/Radio'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/rating.md

@@ -13,7 +13,7 @@
 import { Rating, RatingInput } from 'src/components/molecules/rating/Rating'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/score-ring.md

@@ -13,7 +13,7 @@
 import { ScoreRing, scoreBand } from 'src/components/atoms/score-ring/ScoreRing'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/search.md

@@ -13,7 +13,7 @@
 import { Search } from 'src/components/molecules/search/Search'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/section-heading.md

@@ -13,7 +13,7 @@
 import { SectionHeading } from 'src/components/molecules/section-heading/SectionHeading'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/segmented-control.md

@@ -13,7 +13,7 @@
 import { SegmentedControl } from 'src/components/molecules/segmented-control/SegmentedControl'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/select.md

@@ -13,7 +13,7 @@
 import { Select } from 'src/components/atoms/select/Select'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Requires
 
@@ -23,7 +23,7 @@ Paths are from the Division DS repository root. Installed with shadcn they start
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `label` | `string` |  | Required. The trigger’s accessible name, the name a screen reader announces for it. |
+| `label` | `string` |  | The trigger’s accessible name, the name a screen reader announces for it. Leave it out inside a FormField, which sets it from its own label. Outside one it is required, and `division-ds check` flags a missing one. |
 | `options` | `SelectOptionWithIcon[]` |  | { value, label, disabled?, icon? } rows shown in the listbox. Pass this or groups, never both. |
 | `groups` | `SelectGroup[]` |  | { label, options }[]: rows under headings. Pass this or options, never both. |
 | `placeholder` | `string` | `'Select…'` | Shown until a value is chosen. |

package/public/docs/components/sheet.md

@@ -13,7 +13,7 @@
 import { Sheet, SheetClose, SheetContent, SheetTrigger } from 'src/components/organisms/sheet/Sheet'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/sidebar.md

@@ -13,7 +13,7 @@
 import { Sidebar } from 'src/components/organisms/sidebar/Sidebar'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/skeleton.md

@@ -13,7 +13,7 @@
 import { Skeleton, SkeletonGroup } from 'src/components/atoms/skeleton/Skeleton'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/slider.md

@@ -13,7 +13,7 @@
 import { Slider } from 'src/components/atoms/slider/Slider'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/sparkline.md

@@ -13,7 +13,7 @@
 import { Sparkline } from 'src/components/atoms/sparkline/Sparkline'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/spinner.md

@@ -13,7 +13,7 @@
 import { Spinner, spinnerVariants } from 'src/components/atoms/spinner/Spinner'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/stat.md

@@ -13,7 +13,7 @@
 import { Stat } from 'src/components/molecules/stat/Stat'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/status-tracker.md

@@ -13,7 +13,7 @@
 import { StatusTracker, statusTrackerText } from 'src/components/molecules/status-tracker/StatusTracker'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Requires
 

package/public/docs/components/stepper.md

@@ -13,7 +13,7 @@
 import { Stepper } from 'src/components/molecules/stepper/Stepper'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Props
 

package/public/docs/components/switch.md

@@ -13,7 +13,7 @@
 import { Switch } from 'src/components/atoms/switch/Switch'
 ```
 
-Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file.
+Paths are from the Division DS repository root. Installed with shadcn they start `src/division-ds/` instead of `src/` (`src/division-ds/components/...`); import them relative to your file. An install has no index barrels: import each component from its own file, never from `components/molecules`.
 
 ## Requires