division-ds 0.3.0 → 0.4.0

package/AGENTS.md

@@ -1,6 +1,6 @@
 # Division DS: instructions for coding agents
 
-A React 19 + Tailwind 4 + Radix design system: 72 components, tokens in three layers, light and
+A React 19 + Tailwind 4 + Radix design system: 74 components, tokens in three layers, light and
 dark themes, WCAG 2.2 AA. This file is the entry point. It is short on purpose; everything it
 points to is generated from the code, so it is current.
 
@@ -51,7 +51,7 @@ installs these rules into that project's `AGENTS.md`, `GEMINI.md` and Cursor rul
 `.claude/skills/` (Claude Code).
 
 An agent that supports MCP can have the docs and the same checks as tools instead:
-`claude mcp add division-ds -- npx -y division-ds@0.3.0 mcp` (`list_components`, `get_component`,
+`claude mcp add division-ds -- npx -y division-ds@0.3.1 mcp` (`list_components`, `get_component`,
 `search`, `get_tokens`, `validate_code`, `check_contrast`, `get_add_command`,
 `get_review_checklist`).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "division-ds",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Checks a project that uses Division DS components (raw colours, invented tokens, touching buttons, unknown props), and serves the docs and the same checks to agents over MCP.",
   "license": "MIT",
   "author": "Victor Ilioiu",

package/public/docs/components/accordion.md

@@ -13,7 +13,7 @@
 import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from 'src/components/molecules/accordion/Accordion'
 ```
 
-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/ai-label.md

@@ -13,7 +13,7 @@
 import { AiLabel } from 'src/components/atoms/ai-label/AiLabel'
 ```
 
-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/alert-dialog.md

@@ -13,7 +13,7 @@
 import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogFooter, AlertDialogTrigger } from 'src/components/organisms/alert-dialog/AlertDialog'
 ```
 
-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/alert.md

@@ -13,7 +13,7 @@
 import { Alert } from 'src/components/molecules/alert/Alert'
 ```
 
-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/approval-request.md

@@ -13,7 +13,7 @@
 import { ApprovalRequest } from 'src/components/molecules/approval-request/ApprovalRequest'
 ```
 
-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/auth-form.md

@@ -13,7 +13,7 @@
 import { AuthForm } from 'src/components/organisms/auth-form/AuthForm'
 ```
 
-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/avatar-group.md

@@ -13,7 +13,7 @@
 import { AvatarGroup } from 'src/components/molecules/avatar-group/AvatarGroup'
 ```
 
-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/avatar.md

@@ -13,7 +13,7 @@
 import { Avatar, avatarVariants, initialsFrom } from 'src/components/atoms/avatar/Avatar'
 ```
 
-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/badge.md

@@ -13,7 +13,7 @@
 import { Badge, badgeVariants } from 'src/components/atoms/badge/Badge'
 ```
 
-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/breadcrumbs.md

@@ -13,7 +13,7 @@
 import { Breadcrumbs, collapseCrumbs } from 'src/components/molecules/breadcrumbs/Breadcrumbs'
 ```
 
-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/button.md

@@ -13,7 +13,7 @@
 import { Button, buttonVariants } from 'src/components/atoms/button/Button'
 ```
 
-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/card.md

@@ -13,7 +13,7 @@
 import { Card, CardActions, CardBody, CardDescription, CardFooter, CardHeader, CardMedia, CardTitle, cardLinkClass } from 'src/components/molecules/card/Card'
 ```
 
-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/carousel.md

@@ -13,7 +13,7 @@
 import { Carousel } from 'src/components/organisms/carousel/Carousel'
 ```
 
-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/cart.md

@@ -13,7 +13,7 @@
 import { Cart } from 'src/components/organisms/cart/Cart'
 ```
 
-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/chart-panel.md

@@ -13,7 +13,7 @@
 import { ChartPanel } from 'src/components/organisms/chart-panel/ChartPanel'
 ```
 
-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
 
@@ -59,20 +59,26 @@ Each is compiled and rendered on the docs page. Imports are omitted; see above.
 type Week = { week: string; online: number; store: number }
 
 const WEEKS: Week[] = [
-  { week: 'W1', online: 120, store: 160 },
-  { week: 'W2', online: 131, store: 158 },
-  { week: 'W3', online: 142, store: 163 },
-  { week: 'W4', online: 150, store: 155 },
-  { week: 'W5', online: 171, store: 162 },
-  { week: 'W6', online: 188, store: 159 },
-  { week: 'W7', online: 197, store: 166 },
-  { week: 'W8', online: 214, store: 161 },
+  { week: 'W1', online: 118, store: 150 },
+  { week: 'W2', online: 149, store: 172 },
+  { week: 'W3', online: 168, store: 158 },
+  { week: 'W4', online: 141, store: 131 },
+  { week: 'W5', online: 126, store: 128 },
+  { week: 'W6', online: 174, store: 150 },
+  { week: 'W7', online: 231, store: 141 },
+  { week: 'W8', online: 183, store: 122 },
+  { week: 'W9', online: 139, store: 149 },
+  { week: 'W10', online: 162, store: 185 },
+  { week: 'W11', online: 196, store: 163 },
+  { week: 'W12', online: 170, store: 140 },
 ]
 
 <ChartPanel<Week>
   title="Weekly orders"
-  summary="Online orders rose from 120 to 214 over eight weeks and passed in-store orders in week 5."
+  summary="Online orders peaked three times in twelve weeks, highest at 231 in week 7; in-store orders peaked highest at 185 in week 10."
   kind="line"
+  area
+  curve="smooth"
   data={WEEKS}
   xKey="week"
   xLabel="Week"
@@ -116,17 +122,17 @@ type Day = { day: string; visits: number; orders: number }
 
 const DAYS: Day[] = [
   { day: 'Mon', visits: 1840, orders: 61 },
-  { day: 'Tue', visits: 2210, orders: 74 },
-  { day: 'Wed', visits: 1960, orders: 58 },
-  { day: 'Thu', visits: 2650, orders: 92 },
-  { day: 'Fri', visits: 3120, orders: 118 },
+  { day: 'Tue', visits: 2960, orders: 104 },
+  { day: 'Wed', visits: 2210, orders: 74 },
+  { day: 'Thu', visits: 1720, orders: 55 },
+  { day: 'Fri', visits: 2650, orders: 92 },
   { day: 'Sat', visits: 3890, orders: 141 },
-  { day: 'Sun', visits: 3370, orders: 126 },
+  { day: 'Sun', visits: 3120, orders: 118 },
 ]
 
 <ChartPanel<Day>
   title="Visits this week"
-  summary="Visits climbed from 1,840 on Monday to a Saturday peak of 3,890."
+  summary="Visits peaked on Tuesday at 2,960, fell to a Thursday low of 1,720, then peaked higher on Saturday at 3,890."
   kind="line"
   area
   curve="smooth"
@@ -134,7 +140,7 @@ const DAYS: Day[] = [
   xKey="day"
   xLabel="Day"
   series={[{ key: 'visits', label: 'Visits' }]}
-  headline="19,040"
+  headline="18,390"
   headingLevel={4}
 />
 ```
@@ -145,19 +151,23 @@ const DAYS: Day[] = [
 type Week = { week: string; online: number; store: number }
 
 const WEEKS: Week[] = [
-  { week: 'W1', online: 120, store: 160 },
-  { week: 'W2', online: 131, store: 158 },
-  { week: 'W3', online: 142, store: 163 },
-  { week: 'W4', online: 150, store: 155 },
-  { week: 'W5', online: 171, store: 162 },
-  { week: 'W6', online: 188, store: 159 },
-  { week: 'W7', online: 197, store: 166 },
-  { week: 'W8', online: 214, store: 161 },
+  { week: 'W1', online: 118, store: 150 },
+  { week: 'W2', online: 149, store: 172 },
+  { week: 'W3', online: 168, store: 158 },
+  { week: 'W4', online: 141, store: 131 },
+  { week: 'W5', online: 126, store: 128 },
+  { week: 'W6', online: 174, store: 150 },
+  { week: 'W7', online: 231, store: 141 },
+  { week: 'W8', online: 183, store: 122 },
+  { week: 'W9', online: 139, store: 149 },
+  { week: 'W10', online: 162, store: 185 },
+  { week: 'W11', online: 196, store: 163 },
+  { week: 'W12', online: 170, store: 140 },
 ]
 
 <ChartPanel<Week>
   title="Weekly orders, gridless"
-  summary="Online orders rose from 120 to 214 over eight weeks and passed in-store orders in week 5."
+  summary="Online orders peaked three times in twelve weeks, highest at 231 in week 7; in-store orders peaked highest at 185 in week 10."
   kind="line"
   area
   curve="smooth"
@@ -206,30 +216,34 @@ type Week = { week: string; online: number; store: number }
 type Day = { day: string; visits: number; orders: number }
 
 const WEEKS: Week[] = [
-  { week: 'W1', online: 120, store: 160 },
-  { week: 'W2', online: 131, store: 158 },
-  { week: 'W3', online: 142, store: 163 },
-  { week: 'W4', online: 150, store: 155 },
-  { week: 'W5', online: 171, store: 162 },
-  { week: 'W6', online: 188, store: 159 },
-  { week: 'W7', online: 197, store: 166 },
-  { week: 'W8', online: 214, store: 161 },
+  { week: 'W1', online: 118, store: 150 },
+  { week: 'W2', online: 149, store: 172 },
+  { week: 'W3', online: 168, store: 158 },
+  { week: 'W4', online: 141, store: 131 },
+  { week: 'W5', online: 126, store: 128 },
+  { week: 'W6', online: 174, store: 150 },
+  { week: 'W7', online: 231, store: 141 },
+  { week: 'W8', online: 183, store: 122 },
+  { week: 'W9', online: 139, store: 149 },
+  { week: 'W10', online: 162, store: 185 },
+  { week: 'W11', online: 196, store: 163 },
+  { week: 'W12', online: 170, store: 140 },
 ]
 
 const DAYS: Day[] = [
   { day: 'Mon', visits: 1840, orders: 61 },
-  { day: 'Tue', visits: 2210, orders: 74 },
-  { day: 'Wed', visits: 1960, orders: 58 },
-  { day: 'Thu', visits: 2650, orders: 92 },
-  { day: 'Fri', visits: 3120, orders: 118 },
+  { day: 'Tue', visits: 2960, orders: 104 },
+  { day: 'Wed', visits: 2210, orders: 74 },
+  { day: 'Thu', visits: 1720, orders: 55 },
+  { day: 'Fri', visits: 2650, orders: 92 },
   { day: 'Sat', visits: 3890, orders: 141 },
-  { day: 'Sun', visits: 3370, orders: 126 },
+  { day: 'Sun', visits: 3120, orders: 118 },
 ]
 
 <ChartPanel<Day>
   title="Visits"
-  headline="19,040"
-  summary="Up every day but Wednesday and Sunday."
+  headline="18,390"
+  summary="Two peaks: Tuesday, then a higher Saturday."
   kind="line"
   area
   curve="smooth"
@@ -254,9 +268,10 @@ const DAYS: Day[] = [
 />
 <ChartPanel<Week>
   title="Online orders"
-  headline="214"
-  summary="Eight weeks of growth, from 120 a week."
+  headline="170"
+  summary="Three peaks in twelve weeks; the highest, 231, in week 7."
   kind="line"
+  area
   curve="smooth"
   size="sm"
   data={WEEKS}

package/public/docs/components/chat-message.md

@@ -15,7 +15,7 @@ import { ChatMessage } from 'src/components/molecules/chat-message/ChatMessage'
 import { ResponseFeedback } from 'src/components/molecules/chat-message/ResponseFeedback'
 ```
 
-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/chat-thread.md

@@ -13,7 +13,7 @@
 import { ChatThread } from 'src/components/organisms/chat-thread/ChatThread'
 ```
 
-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/checkbox.md

@@ -13,7 +13,7 @@
 import { Checkbox } from 'src/components/atoms/checkbox/Checkbox'
 ```
 
-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/checkout-form.md

@@ -13,7 +13,7 @@
 import { CheckoutForm, DELIVERY_OPTIONS } from 'src/components/organisms/checkout-form/CheckoutForm'
 ```
 
-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/code-block.md

@@ -0,0 +1,106 @@
+# CodeBlock
+
+> Code or a command in a panel, with a title bar that names the file or language and a button that copies the text. Long lines scroll sideways inside it, and code longer than one line gets line numbers.
+
+- **Best for:** Showing code or a command someone will read or copy: an install step, a config file, an example.
+- **Not for:** A word of code inside a sentence: use a code element. A key to press: use Kbd.
+- Molecule. Source: `src/components/molecules/code-block/CodeBlock.tsx`
+- Rendered docs page: `/components/code-block`
+
+## Import
+
+```tsx
+import { CodeBlock } from 'src/components/molecules/code-block/CodeBlock'
+```
+
+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
+
+- The app’s one Toaster at the root: the copy is confirmed with a toast.
+
+## Props
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| `code` | `string` |  | The text shown and copied, exactly. |
+| `label` | `string` |  | What the code is, in a few words ("the theme CSS"). Names the region and the copy button ("Copy the theme CSS"). |
+| `title` | `string` |  | Shown in the title bar: a file name ("index.css") or a language ("bash"). |
+| `language` | `'css' \| 'text'` | `'text'` | css colours comments, at-rules, selectors and property names; text is plain. |
+| `lineNumbers` | `boolean` |  | Line numbers in a gutter. Unset, they show when the code has more than one line. |
+| `copyable` | `boolean` | `true` | The copy button. Turn it off for code nobody should paste, such as a wrong example. |
+| `wrap` | `boolean` | `false` | Wraps long lines instead of scrolling them sideways. For prose, such as a prompt; leave code unwrapped. |
+| `className` | `string` |  | Merged onto the frame. Use it for width (max-w-3xl) and spacing. |
+| `ref` | `Ref<HTMLDivElement>` |  | Passed through to the frame. |
+
+## Examples
+
+Each is compiled and rendered on the docs page. Imports are omitted; see above.
+
+### A command
+
+```tsx
+<CodeBlock title="bash" label="the check command" code="npx division-ds check src" className="max-w-3xl" />
+```
+
+### A file, with CSS colours and line numbers
+
+```tsx
+<CodeBlock
+  title="index.css"
+  language="css"
+  label="the theme CSS"
+  className="max-w-3xl"
+  code={'@import "./division-ds/styles/division-ds.css";\n\n/* Square corners */\n:root {\n  --shape-bevel: 0;\n  --shape-radius: 4px;\n}\n'}
+/>
+```
+
+### Not copyable, for code nobody should paste
+
+```tsx
+<CodeBlock title="Wrong" label="a bare pre" copyable={false} code={'<pre>{command}</pre>'} className="max-w-3xl" />
+```
+
+## Keyboard
+
+| Keys | Result |
+|---|---|
+| `Tab` | Moves to the copy button, then to the code region. |
+| `←` `→` | In the focused code region: scrolls a long line sideways. |
+| `Enter` | On the copy button: copies the code. |
+
+## Do
+
+- Write a label that says what the code is, so the copy button reads "Copy the install command".
+- Give it a title: the file name it belongs in, or the language.
+- Set a max width with className; long lines scroll inside it, so it never widens the page.
+
+## Don't
+
+- Don’t put several unrelated commands in one block. One block per thing to copy.
+- Don’t set copyable on an example of what not to write.
+- Don’t wrap it in another bordered panel; it brings its own frame.
+
+## Common mistakes
+
+Wrong:
+
+```tsx
+<pre className="font-mono text-sm">{command}</pre>
+```
+
+Right:
+
+```tsx
+<CodeBlock code={command} label="the install command" title="bash" />
+```
+
+A bare pre has no copy button, no name, and cannot be scrolled with a keyboard when a line runs past the edge.
+
+## Anatomy
+
+- **Frame**: A thin border around a surface.base fill. The syntax colours are measured for contrast on surface.base.
+- **Title bar**: The title on the left, in 12px uppercase mono, and the copy button on the right, above a thin line.
+- **Code region**: A pre with role region, named by the title and the label, focusable so a keyboard can scroll it. Up to 32rem tall, then it scrolls.
+- **Line numbers**: A gutter in text.muted, hidden from screen readers and from text selection.
+- **Copy button**: An IconButton named "Copy" plus the label. After copying, its icon turns into a tick for a moment and a toast confirms it.

package/public/docs/components/command-palette.md

@@ -13,7 +13,7 @@
 import { CommandPalette, filterCommands, groupCommands } from 'src/components/organisms/command-palette/CommandPalette'
 ```
 
-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/data-table.md

@@ -13,7 +13,7 @@
 import { DataTable, sortRows } from 'src/components/organisms/data-table/DataTable'
 ```
 
-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/date-picker.md

@@ -16,13 +16,13 @@ import { DateField } from 'src/components/molecules/date-picker/DateField'
 import { DatePicker } from 'src/components/molecules/date-picker/DatePicker'
 ```
 
-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. Inside a FormField, FormField sets it from its own label. |
+| `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` | `string ('YYYY-MM-DD' \| '')` |  | Controlled value (your page holds it). |
 | `defaultValue` | `string` | `''` | Starting value when the picker holds the value itself. |
 | `onValueChange` | `(value: string) => void` |  | Fires with a whole, real date, or '' when the field is emptied. A half-typed date does not fire. |
@@ -78,7 +78,7 @@ Each is compiled and rendered on the docs page. Imports are omitted; see above.
 ```tsx
 <div className="w-full max-w-xs">
   <FormField label="Trip date" help="Type it, or open the calendar.">
-    <DatePicker label="Trip date" />
+    <DatePicker />
   </FormField>
 </div>
 ```

package/public/docs/components/date-presets.md

@@ -13,7 +13,7 @@
 import { DatePresets, defaultPresets } from 'src/components/molecules/date-presets/DatePresets'
 ```
 
-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/date-range-picker.md

@@ -13,13 +13,13 @@
 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.
+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. Inside a FormField, FormField sets it. |
+| `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. |
@@ -76,7 +76,7 @@ Each is compiled and rendered on the docs page. Imports are omitted; see above.
 ```tsx
 <div className="w-full max-w-sm">
   <FormField label="Report period" help="Pick a preset, or two days.">
-    <DateRangePicker label="Report period" aside={<DatePresets />} />
+    <DateRangePicker aside={<DatePresets />} />
   </FormField>
 </div>
 ```

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