@misoto22/design 0.8.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (167) hide show
  1. package/dist/agent/Accordion.md +1 -1
  2. package/dist/agent/Alert.md +1 -1
  3. package/dist/agent/AppShell.md +1 -1
  4. package/dist/agent/ArchitectureFigure.md +1 -1
  5. package/dist/agent/AreaChart.md +1 -1
  6. package/dist/agent/Article.md +1 -1
  7. package/dist/agent/AspectRatio.md +1 -1
  8. package/dist/agent/Avatar.md +1 -1
  9. package/dist/agent/Badge.md +1 -1
  10. package/dist/agent/BarChart.md +1 -1
  11. package/dist/agent/BarList.md +1 -1
  12. package/dist/agent/BigNumber.md +1 -1
  13. package/dist/agent/BoxPlot.md +1 -1
  14. package/dist/agent/Breadcrumb.md +1 -1
  15. package/dist/agent/BulletChart.md +1 -1
  16. package/dist/agent/Button.md +1 -1
  17. package/dist/agent/Calendar.md +1 -1
  18. package/dist/agent/Card.md +1 -1
  19. package/dist/agent/Checkbox.md +1 -1
  20. package/dist/agent/Code.md +1 -1
  21. package/dist/agent/CodeBlock.md +1 -1
  22. package/dist/agent/Collapsible.md +1 -1
  23. package/dist/agent/ColorPicker.md +75 -0
  24. package/dist/agent/Combobox.md +1 -1
  25. package/dist/agent/Command.md +1 -1
  26. package/dist/agent/ComposedChart.md +1 -1
  27. package/dist/agent/ContextMenu.md +1 -1
  28. package/dist/agent/DataflowFigure.md +1 -1
  29. package/dist/agent/DatePicker.md +1 -1
  30. package/dist/agent/DescriptionList.md +1 -1
  31. package/dist/agent/Diagram.md +1 -1
  32. package/dist/agent/DiagramCanvas.md +1 -1
  33. package/dist/agent/DiagramExportMenu.md +1 -1
  34. package/dist/agent/DiagramInspector.md +1 -1
  35. package/dist/agent/DiagramLegend.md +1 -1
  36. package/dist/agent/DiagramMinimap.md +1 -1
  37. package/dist/agent/DiagramToolbar.md +1 -1
  38. package/dist/agent/Dialog.md +1 -1
  39. package/dist/agent/DropdownMenu.md +1 -1
  40. package/dist/agent/EmptyState.md +1 -1
  41. package/dist/agent/ErrorState.md +1 -1
  42. package/dist/agent/Facet.md +1 -1
  43. package/dist/agent/Field.md +1 -1
  44. package/dist/agent/FigureBand.md +1 -1
  45. package/dist/agent/FloatingIconButton.md +1 -1
  46. package/dist/agent/FunnelChart.md +1 -1
  47. package/dist/agent/Heading.md +1 -1
  48. package/dist/agent/Heatmap.md +1 -1
  49. package/dist/agent/Histogram.md +1 -1
  50. package/dist/agent/Input.md +1 -1
  51. package/dist/agent/Kbd.md +2 -2
  52. package/dist/agent/LifecycleFigure.md +1 -1
  53. package/dist/agent/LineChart.md +1 -1
  54. package/dist/agent/LinkArrow.md +1 -1
  55. package/dist/agent/Markdown.md +1 -1
  56. package/dist/agent/NativeSelect.md +1 -1
  57. package/dist/agent/NavItem.md +1 -1
  58. package/dist/agent/NumberField.md +72 -0
  59. package/dist/agent/Pagination.md +1 -1
  60. package/dist/agent/PieChart.md +1 -1
  61. package/dist/agent/Popover.md +1 -1
  62. package/dist/agent/Progress.md +1 -1
  63. package/dist/agent/RadarChart.md +1 -1
  64. package/dist/agent/RadialChart.md +1 -1
  65. package/dist/agent/RadioGroup.md +1 -1
  66. package/dist/agent/SankeyChart.md +1 -1
  67. package/dist/agent/ScatterChart.md +1 -1
  68. package/dist/agent/ScrollArea.md +1 -1
  69. package/dist/agent/SearchableMenu.md +1 -1
  70. package/dist/agent/Select.md +1 -1
  71. package/dist/agent/Separator.md +1 -1
  72. package/dist/agent/SequenceFigure.md +1 -1
  73. package/dist/agent/Sheet.md +1 -1
  74. package/dist/agent/Sidebar.md +193 -0
  75. package/dist/agent/Skeleton.md +1 -1
  76. package/dist/agent/Slider.md +7 -3
  77. package/dist/agent/Sparkline.md +1 -1
  78. package/dist/agent/Spinner.md +1 -1
  79. package/dist/agent/StatusDot.md +1 -1
  80. package/dist/agent/StatusPill.md +1 -1
  81. package/dist/agent/Steps.md +1 -1
  82. package/dist/agent/Switch.md +1 -1
  83. package/dist/agent/Table.md +3 -1
  84. package/dist/agent/Tabs.md +1 -1
  85. package/dist/agent/Tag.md +1 -1
  86. package/dist/agent/Text.md +1 -1
  87. package/dist/agent/Textarea.md +1 -1
  88. package/dist/agent/Timestamp.md +1 -1
  89. package/dist/agent/Toast.md +1 -1
  90. package/dist/agent/ToggleGroup.md +1 -1
  91. package/dist/agent/Toolbar.md +1 -1
  92. package/dist/agent/Tooltip.md +1 -1
  93. package/dist/agent/TreemapChart.md +1 -1
  94. package/dist/agent/WaterfallChart.md +1 -1
  95. package/dist/agent/WorkflowFigure.md +1 -1
  96. package/dist/agent/catalog.json +362 -2
  97. package/dist/agent/index.md +9 -6
  98. package/dist/charts/BulletChart/BulletChart.js +16 -2
  99. package/dist/charts/BulletChart/BulletChart.js.map +1 -1
  100. package/dist/charts/RadarChart/RadarChart.js +4 -2
  101. package/dist/charts/RadarChart/RadarChart.js.map +1 -1
  102. package/dist/charts/lib/chart.js +16 -1
  103. package/dist/charts/lib/chart.js.map +1 -1
  104. package/dist/components/AppShell/AppShell.js +2 -2
  105. package/dist/components/AppShell/AppShell.js.map +1 -1
  106. package/dist/components/Button/Button.js +3 -3
  107. package/dist/components/Button/Button.js.map +1 -1
  108. package/dist/components/ColorPicker/ColorPicker.d.ts +67 -0
  109. package/dist/components/ColorPicker/ColorPicker.js +334 -0
  110. package/dist/components/ColorPicker/ColorPicker.js.map +1 -0
  111. package/dist/components/Command/Command.js +1 -1
  112. package/dist/components/Command/Command.js.map +1 -1
  113. package/dist/components/ContextMenu/ContextMenu.js +1 -1
  114. package/dist/components/ContextMenu/ContextMenu.js.map +1 -1
  115. package/dist/components/Dialog/Dialog.js +1 -1
  116. package/dist/components/Dialog/Dialog.js.map +1 -1
  117. package/dist/components/DropdownMenu/DropdownMenu.js +1 -1
  118. package/dist/components/DropdownMenu/DropdownMenu.js.map +1 -1
  119. package/dist/components/ErrorState/ErrorState.js +1 -1
  120. package/dist/components/ErrorState/ErrorState.js.map +1 -1
  121. package/dist/components/Kbd/Kbd.d.ts +7 -0
  122. package/dist/components/Kbd/Kbd.js +1 -1
  123. package/dist/components/Kbd/Kbd.js.map +1 -1
  124. package/dist/components/NavItem/NavItem.js +1 -1
  125. package/dist/components/NavItem/NavItem.js.map +1 -1
  126. package/dist/components/NumberField/NumberField.d.ts +69 -0
  127. package/dist/components/NumberField/NumberField.js +162 -0
  128. package/dist/components/NumberField/NumberField.js.map +1 -0
  129. package/dist/components/Popover/Popover.js +1 -1
  130. package/dist/components/Popover/Popover.js.map +1 -1
  131. package/dist/components/Select/Select.js +1 -1
  132. package/dist/components/Select/Select.js.map +1 -1
  133. package/dist/components/Sheet/Sheet.js +1 -1
  134. package/dist/components/Sheet/Sheet.js.map +1 -1
  135. package/dist/components/Sidebar/Sidebar.d.ts +357 -0
  136. package/dist/components/Sidebar/Sidebar.js +455 -0
  137. package/dist/components/Sidebar/Sidebar.js.map +1 -0
  138. package/dist/components/Slider/Slider.d.ts +22 -1
  139. package/dist/components/Slider/Slider.js +72 -8
  140. package/dist/components/Slider/Slider.js.map +1 -1
  141. package/dist/components/Table/Table.d.ts +14 -0
  142. package/dist/components/Table/Table.js.map +1 -1
  143. package/dist/components/Tabs/Tabs.js +7 -1
  144. package/dist/components/Tabs/Tabs.js.map +1 -1
  145. package/dist/diagrams/lib/route.d.ts +22 -1
  146. package/dist/diagrams/lib/route.js +24 -1
  147. package/dist/diagrams/lib/route.js.map +1 -1
  148. package/dist/diagrams/lib/wires.js +9 -5
  149. package/dist/diagrams/lib/wires.js.map +1 -1
  150. package/dist/index.d.ts +3 -0
  151. package/dist/index.js +3 -0
  152. package/dist/index.js.map +1 -1
  153. package/dist/lib/color.d.ts +80 -0
  154. package/dist/lib/color.js +189 -0
  155. package/dist/lib/color.js.map +1 -0
  156. package/dist/lib/numeric.d.ts +35 -0
  157. package/dist/lib/numeric.js +29 -0
  158. package/dist/lib/numeric.js.map +1 -0
  159. package/dist/semantic.css +4 -2
  160. package/dist/styles.css +1 -1
  161. package/dist/themes.css +99 -0
  162. package/dist/tokens.css +133 -4
  163. package/dist/tokens.d.ts +5 -0
  164. package/dist/tokens.js +31 -3
  165. package/dist/tokens.json +31 -3
  166. package/package.json +1 -1
  167. package/skills/misoto22-design/rules/forms.md +3 -1
@@ -4,7 +4,7 @@ Disclosure rows that open in place.
4
4
 
5
5
  - Group: Navigation
6
6
  - Import: `import { Accordion } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/accordion/
9
9
  - Related: tabs
10
10
 
@@ -4,7 +4,7 @@ A message about the page, in place.
4
4
 
5
5
  - Group: Feedback
6
6
  - Import: `import { Alert } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/alert/
9
9
  - Related: toast, error-state
10
10
 
@@ -4,7 +4,7 @@ Two columns on a desktop, a drawer on a phone.
4
4
 
5
5
  - Group: Surfaces
6
6
  - Import: `import { AppShell } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/app-shell/
9
9
  - Related: nav-item
10
10
 
@@ -4,7 +4,7 @@ A component map: services, datastores, trust boundaries, and what talks to what.
4
4
 
5
5
  - Group: Diagrams
6
6
  - Import: `import { ArchitectureFigure } from '@misoto22/design/diagrams'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/architecture-figure/
9
9
  - Related: dataflow-figure, diagram, diagram-canvas
10
10
 
@@ -4,7 +4,7 @@ A filled series over a continuous axis, where the area means something.
4
4
 
5
5
  - Group: Charts
6
6
  - Import: `import { AreaChart } from '@misoto22/design/charts'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/area-chart/
9
9
  - Related: line-chart, bar-chart, composed-chart
10
10
 
@@ -4,7 +4,7 @@ The long-form reading surface — everything a Markdown pipeline emits, in this
4
4
 
5
5
  - Group: Surfaces
6
6
  - Import: `import { Article } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/article/
9
9
  - Related: diagram, card
10
10
 
@@ -4,7 +4,7 @@ A box that keeps its shape whatever is inside it.
4
4
 
5
5
  - Group: Surfaces
6
6
  - Import: `import { AspectRatio } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/aspect-ratio/
9
9
  - Related: skeleton, card
10
10
 
@@ -4,7 +4,7 @@ A person, as a circle, with initials until the image lands.
4
4
 
5
5
  - Group: Display
6
6
  - Import: `import { Avatar } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/avatar/
9
9
 
10
10
  ## Anatomy
@@ -4,7 +4,7 @@ A count or a state, set in mono so it reads as metadata.
4
4
 
5
5
  - Group: Display
6
6
  - Import: `import { Badge } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/badge/
9
9
  - Related: tag, status-pill
10
10
 
@@ -4,7 +4,7 @@ Discrete categories compared by length.
4
4
 
5
5
  - Group: Charts
6
6
  - Import: `import { BarChart } from '@misoto22/design/charts'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/bar-chart/
9
9
  - Related: area-chart, composed-chart, radial-chart
10
10
 
@@ -4,7 +4,7 @@ A ranked list, with the bar behind the name rather than beside it.
4
4
 
5
5
  - Group: Data
6
6
  - Import: `import { BarList } from '@misoto22/design/charts'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/bar-list/
9
9
  - Related: bar-chart, table
10
10
 
@@ -4,7 +4,7 @@ One number, at the size of a headline.
4
4
 
5
5
  - Group: Data
6
6
  - Import: `import { BigNumber } from '@misoto22/design/charts'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/big-number/
9
9
  - Related: sparkline, figure-band
10
10
 
@@ -4,7 +4,7 @@ The spread of a measurement, per category.
4
4
 
5
5
  - Group: Charts
6
6
  - Import: `import { BoxPlot } from '@misoto22/design/charts'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/box-plot/
9
9
  - Related: histogram, scatter-chart
10
10
 
@@ -4,7 +4,7 @@ Where you are, as a path.
4
4
 
5
5
  - Group: Navigation
6
6
  - Import: `import { Breadcrumb } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/breadcrumb/
9
9
  - Related: pagination
10
10
 
@@ -4,7 +4,7 @@ A measure, its target, and the bands that say whether it is any good.
4
4
 
5
5
  - Group: Data
6
6
  - Import: `import { BulletChart } from '@misoto22/design/charts'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/bullet-chart/
9
9
  - Related: bar-list, big-number
10
10
 
@@ -4,7 +4,7 @@ The system’s action, on the same corner as the field beside it.
4
4
 
5
5
  - Group: Actions
6
6
  - Import: `import { Button } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/button/
9
9
  - Related: floating-icon-button, spinner
10
10
 
@@ -4,7 +4,7 @@ A month, as a grid of days.
4
4
 
5
5
  - Group: Surfaces
6
6
  - Import: `import { Calendar } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/calendar/
9
9
  - Related: date-picker
10
10
 
@@ -4,7 +4,7 @@ A bounded surface, with no shadow under it.
4
4
 
5
5
  - Group: Surfaces
6
6
  - Import: `import { Card } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/card/
9
9
  - Related: table, figure-band
10
10
 
@@ -4,7 +4,7 @@ A choice that takes effect when the form is submitted.
4
4
 
5
5
  - Group: Forms
6
6
  - Import: `import { Checkbox } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/checkbox/
9
9
  - Related: switch, radio-group
10
10
 
@@ -4,7 +4,7 @@ A function name or a flag, inside a sentence.
4
4
 
5
5
  - Group: Display
6
6
  - Import: `import { Code } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/code/
9
9
  - Related: code-block, kbd
10
10
 
@@ -4,7 +4,7 @@ A multi-line snippet, on a plate, with a way to take it away.
4
4
 
5
5
  - Group: Display
6
6
  - Import: `import { CodeBlock } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/code-block/
9
9
  - Related: code, markdown, article
10
10
 
@@ -4,7 +4,7 @@ One thing that opens, on its own.
4
4
 
5
5
  - Group: Navigation
6
6
  - Import: `import { Collapsible } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/collapsible/
9
9
  - Related: accordion
10
10
 
@@ -0,0 +1,75 @@
1
+ # ColorPicker
2
+
3
+ A colour, chosen or typed.
4
+
5
+ - Group: Forms
6
+ - Import: `import { ColorPicker } from '@misoto22/design'`
7
+ - Version: 0.10.0
8
+ - Docs: https://ui.misoto22.com/components/color-picker/
9
+ - Related: field, input, popover
10
+
11
+ ## When to reach for it
12
+
13
+ A person is choosing the colour. A colour that is merely being SHOWN is a swatch, and a set of fixed brand colours is a RadioGroup — a picker offers sixteen million answers to a question with six.
14
+
15
+ ## Anatomy
16
+
17
+ - **Trigger** (required) — The closed control: a swatch, then the value as text, in the same box as Input and Select. Named by its label AND by its own value, so a reader hears “Brand colour, #a78bfa” rather than either half.
18
+ - **Swatch** — The colour over a checkerboard, so a half-transparent value reads as transparent rather than as a paler colour.
19
+ - **Notation strip** — Hex, OKLCH and Display P3, as a single-value ToggleGroup. It changes what onValueChange emits, not what the colour is — and hex and P3 are bounded, so switching to one of them fits the colour to that gamut on the way out.
20
+ - **Field** (required) — The plane: chroma across, lightness up. Each ROW is normalised to the most chroma that exists at that lightness and hue, so the whole surface is reachable instead of a lens of colour inside bands of clipped duplicates. Underneath it are two real sliders rather than key handlers on a canvas, which is what gives it arrows, Home, End and an announced position.
21
+ - **Hue track** — A ramp taken at the lightness and chroma already chosen, not a generic rainbow — so the strip shows the hues of THIS colour rather than of some other one.
22
+ - **Opacity track** — Transparent to the current colour, over the same checkerboard as the swatch.
23
+ - **CSS box** — The value as text. Accepts hex, rgb(), hsl(), oklch() and color(display-p3 …) in both syntaxes, and paints itself invalid on anything else.
24
+
25
+ ## Best practices
26
+
27
+ ### Do
28
+
29
+ - Wrap it in a Field. The trigger is a button, which a label binds to and clicks through — one of the few composites where that works without help.
30
+ - Pass the notation you want back. The panel emits in whatever notation the value arrived in until somebody changes it in the strip, so a defaultValue of "#a78bfa" keeps a consumer in hex.
31
+ - Reach for this over <input type="color"> when the colours are being TUNED. The native picker works in HSV, where a row of constant lightness visibly darkens as it saturates — so a reader building a palette is fighting the instrument. OKLCH is the space where two colours at the same height genuinely match.
32
+
33
+ ### Don’t
34
+
35
+ - Do not pass a named colour. Hex, rgb(), hsl(), oklch() and color(display-p3 …) parse; "rebeccapurple" does not, and the box will show it as invalid. Resolving names needs a table of every CSS keyword or a live DOM, and a picker that takes some names and not others is worse than one that takes none.
36
+ - Do not read the emitted string as a fixed notation. It is whatever the strip is set to, so a consumer that slices a "#" off the front breaks the first time a reader picks OKLCH.
37
+ - Do not use it to pick text or background colour and call the result accessible. Nothing here measures contrast; a picker that lets a reader choose #eeeeee for body copy is doing exactly what it was asked.
38
+
39
+ ## Accessibility
40
+
41
+ - label is required. The trigger shows a value, and a value is not a name.
42
+ - The plane is a group of two real sliders — Chroma and Lightness — each announced with a percentage, so the 2D surface is operable and reported rather than merely clickable.
43
+ - The focus ring is drawn on the plane, because the sliders that take the focus are visually hidden and the browser’s own ring is clipped away with them.
44
+ - Alpha is doubled by a checkerboard everywhere it is shown, so transparency is not carried by lightness alone.
45
+
46
+ ## Keyboard
47
+
48
+ - Enter / Space — Opens the panel.
49
+ - ← / → — Moves the focused axis or track by one step.
50
+ - Home / End — Jumps that axis or track to its ends.
51
+ - Escape — Closes the panel; focus returns to the trigger.
52
+
53
+ ## ColorPicker
54
+
55
+ A colour, chosen or typed. The panel works in OKLCH, and that is the reason to reach for this rather than `<input type="color">`. In HSV — which is what the native picker and most libraries use — dragging along a row of constant "lightness" walks through colours the eye reads as getting darker, so a reader tuning a palette is fighting the instrument. OKLCH's lightness is the one a person sees, so two colours at the same height on the plane genuinely match, and the hue strip stays at the lightness already chosen instead of showing a rainbow that belongs to some other colour. The plane is normalised to the gamut ROW BY ROW: its right edge is the most chroma that exists at that lightness and hue, so the whole surface is reachable rather than a lens of colour inside a field of clipped duplicates. **What it accepts.** Hex, `rgb()`, `hsl()`, `oklch()` and `color(display-p3 …)`, in both syntaxes. Named colours are not accepted: resolving them needs a table of every CSS name or a live DOM, and a box that takes "rebeccapurple" but not "papayawhip" is worse than one that takes neither. **Keyboard.** The plane is a group of two real sliders — chroma across, lightness up — so the arrows move it and a screen reader announces where it is. That is the part a 2D canvas usually leaves out, and leaving it out makes the control unusable rather than merely awkward.
56
+
57
+ ### Props
58
+
59
+ - `label` (required) — `string`. Names the control. Required — the trigger shows a colour, and a colour is not a name. Announced together with the value, the way `Select`'s is: a reader hears "Brand colour, #a78bfa". Inside a `Field` with a label, that label is used and this one is not repeated.
60
+ - `value` — `string`. The colour, as any absolute CSS colour string.
61
+ - `defaultValue` — `string` default `'#000000'`.
62
+ - `onValueChange` — `(value: string) => void`. Fires with a CSS colour string in whichever notation the panel is set to — so the notation a caller passes in is the notation they get back until somebody changes it in the panel.
63
+ - `disabled` — `boolean`.
64
+ - `invalid` — `boolean`. Paints the resting border with `--danger` and reflects `aria-invalid`.
65
+ - `className` — `string`.
66
+ - `id` — `string`. The TRIGGER's id — the element a label points at. A `Field` sets it.
67
+ - `aria-describedby` — `string`. Ids of the copy describing the control. A `Field` sets it from hint, error and description.
68
+ - `aria-invalid` — `boolean | 'true' | 'false'`. The spelling a form library sets; read together with `invalid`.
69
+ - `aria-required` — `boolean`. Announced on the trigger. A `Field` sets it from `required`.
70
+
71
+ ## Examples
72
+
73
+ ```tsx
74
+ <Field label="Brand colour"><ColorPicker label="Brand colour" defaultValue="#a78bfa" /></Field>
75
+ ```
@@ -4,7 +4,7 @@ A select you can type into.
4
4
 
5
5
  - Group: Forms
6
6
  - Import: `import { Combobox } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/combobox/
9
9
  - Related: select, command
10
10
 
@@ -4,7 +4,7 @@ A filterable list of actions — the ⌘K surface.
4
4
 
5
5
  - Group: Overlays
6
6
  - Import: `import { Command } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/command/
9
9
  - Related: combobox, dialog
10
10
 
@@ -4,7 +4,7 @@ Bars and lines over one axis — the volume, and the rate it moved at.
4
4
 
5
5
  - Group: Charts
6
6
  - Import: `import { ComposedChart } from '@misoto22/design/charts'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/composed-chart/
9
9
  - Related: bar-chart, line-chart
10
10
 
@@ -4,7 +4,7 @@ The menu a right-click opens.
4
4
 
5
5
  - Group: Overlays
6
6
  - Import: `import { ContextMenu } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/context-menu/
9
9
  - Related: dropdown-menu
10
10
 
@@ -4,7 +4,7 @@ A pipeline: where data comes from, what happens to it, and who ends up with it.
4
4
 
5
5
  - Group: Diagrams
6
6
  - Import: `import { DataflowFigure } from '@misoto22/design/diagrams'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/dataflow-figure/
9
9
  - Related: architecture-figure, lifecycle-figure
10
10
 
@@ -4,7 +4,7 @@ A date — or a span of them — chosen from a calendar.
4
4
 
5
5
  - Group: Forms
6
6
  - Import: `import { DatePicker } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/date-picker/
9
9
  - Related: calendar, field
10
10
 
@@ -4,7 +4,7 @@ One record’s fields, as a real <dl> rather than a grid of divs.
4
4
 
5
5
  - Group: Surfaces
6
6
  - Import: `import { DescriptionList } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/description-list/
9
9
  - Related: table, card, timestamp
10
10
 
@@ -4,7 +4,7 @@ A flow or architecture figure, drawn out of the system’s own parts.
4
4
 
5
5
  - Group: Display
6
6
  - Import: `import { Diagram } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/diagram/
9
9
  - Related: card, figure-band
10
10
 
@@ -4,7 +4,7 @@ A frame that a picture larger than it can be panned and zoomed inside.
4
4
 
5
5
  - Group: Diagrams
6
6
  - Import: `import { DiagramCanvas } from '@misoto22/design/diagrams'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/diagram-canvas/
9
9
  - Related: diagram-minimap, architecture-figure, scroll-area
10
10
 
@@ -4,7 +4,7 @@ Taking the figure off the page: PNG, JPEG, WebP, SVG and a 1200×630 share card.
4
4
 
5
5
  - Group: Diagrams
6
6
  - Import: `import { DiagramExportMenu } from '@misoto22/design/diagrams'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/diagram-export-menu/
9
9
  - Related: dropdown-menu, diagram-toolbar
10
10
 
@@ -4,7 +4,7 @@ What the reader just picked, written out beside the picture.
4
4
 
5
5
  - Group: Diagrams
6
6
  - Import: `import { DiagramInspector } from '@misoto22/design/diagrams'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/diagram-inspector/
9
9
  - Related: card, diagram-canvas
10
10
 
@@ -4,7 +4,7 @@ The key: which drawn form means which kind of thing.
4
4
 
5
5
  - Group: Diagrams
6
6
  - Import: `import { DiagramLegend } from '@misoto22/design/diagrams'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/diagram-legend/
9
9
  - Related: architecture-figure, lifecycle-figure
10
10
 
@@ -4,7 +4,7 @@ Where you are in something bigger than the window.
4
4
 
5
5
  - Group: Diagrams
6
6
  - Import: `import { DiagramMinimap } from '@misoto22/design/diagrams'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/diagram-minimap/
9
9
  - Related: diagram-canvas
10
10
 
@@ -4,7 +4,7 @@ A bar of actions belonging to the surface underneath them.
4
4
 
5
5
  - Group: Diagrams
6
6
  - Import: `import { DiagramToolbar } from '@misoto22/design/diagrams'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/diagram-toolbar/
9
9
  - Related: floating-icon-button, diagram-export-menu
10
10
 
@@ -4,7 +4,7 @@ A modal surface: portal, scrim, centred panel.
4
4
 
5
5
  - Group: Overlays
6
6
  - Import: `import { Dialog } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/dialog/
9
9
  - Related: dropdown-menu, tooltip
10
10
 
@@ -4,7 +4,7 @@ A menu of actions.
4
4
 
5
5
  - Group: Overlays
6
6
  - Import: `import { DropdownMenu } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/dropdown-menu/
9
9
  - Related: dialog, select
10
10
 
@@ -4,7 +4,7 @@ A collection with nothing in it — yet.
4
4
 
5
5
  - Group: Feedback
6
6
  - Import: `import { EmptyState } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/empty-state/
9
9
  - Related: error-state, skeleton
10
10
 
@@ -4,7 +4,7 @@ A page that could not be shown.
4
4
 
5
5
  - Group: Feedback
6
6
  - Import: `import { ErrorState } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/error-state/
9
9
  - Related: empty-state, alert
10
10
 
@@ -4,7 +4,7 @@ The same chart once per group, on one shared scale.
4
4
 
5
5
  - Group: Charts
6
6
  - Import: `import { Facet } from '@misoto22/design/charts'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/facet/
9
9
  - Related: line-chart, sparkline
10
10
 
@@ -4,7 +4,7 @@ A labelled form row: label, control, and the one message below it — and, in ro
4
4
 
5
5
  - Group: Forms
6
6
  - Import: `import { Field } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/field/
9
9
  - Related: input, select, switch
10
10
 
@@ -4,7 +4,7 @@ A row of counted facts, divided by hairlines and nothing else.
4
4
 
5
5
  - Group: Display
6
6
  - Import: `import { FigureBand } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/figure-band/
9
9
  - Related: table
10
10
 
@@ -4,7 +4,7 @@ A round action pinned to a screen corner.
4
4
 
5
5
  - Group: Actions
6
6
  - Import: `import { FloatingIconButton } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/floating-icon-button/
9
9
  - Related: button
10
10
 
@@ -4,7 +4,7 @@ Stages that only ever narrow.
4
4
 
5
5
  - Group: Charts
6
6
  - Import: `import { FunnelChart } from '@misoto22/design/charts'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/funnel-chart/
9
9
  - Related: sankey-chart, bar-chart
10
10
 
@@ -4,7 +4,7 @@ A heading whose element and whose size are two decisions.
4
4
 
5
5
  - Group: Display
6
6
  - Import: `import { Heading } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/heading/
9
9
  - Related: text, article, markdown
10
10
 
@@ -4,7 +4,7 @@ A grid of values read by weight.
4
4
 
5
5
  - Group: Data
6
6
  - Import: `import { Heatmap } from '@misoto22/design/charts'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/heatmap/
9
9
  - Related: table, scatter-chart
10
10
 
@@ -4,7 +4,7 @@ The shape of one distribution.
4
4
 
5
5
  - Group: Charts
6
6
  - Import: `import { Histogram } from '@misoto22/design/charts'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/histogram/
9
9
  - Related: box-plot, bar-chart
10
10
 
@@ -4,7 +4,7 @@ A single line of text entry.
4
4
 
5
5
  - Group: Forms
6
6
  - Import: `import { Input } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/input/
9
9
  - Related: field, textarea
10
10
 
package/dist/agent/Kbd.md CHANGED
@@ -4,7 +4,7 @@ A key on a keyboard, set as one.
4
4
 
5
5
  - Group: Display
6
6
  - Import: `import { Kbd } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/kbd/
9
9
  - Related: badge
10
10
 
@@ -32,7 +32,7 @@ A key on a keyboard, set as one.
32
32
 
33
33
  ## Kbd
34
34
 
35
- A key on a keyboard, set as one. Renders a `<kbd>`, which is the element that means this — a `<span>` styled to look like a key tells a screen reader nothing. Sized in `em` so it tracks whatever type it sits beside rather than fixing itself at one px value, which is how the same shortcut ended up three different sizes across a page.
35
+ A key on a keyboard, set as one. Renders a `<kbd>`, which is the element that means this — a `<span>` styled to look like a key tells a screen reader nothing. Sized in `em` so it tracks whatever type it sits beside rather than fixing itself at one px value, which is how the same shortcut ended up three different sizes across a page. Every dimension here tracked its context except the leading, which was a literal `1.6` — the body's READING leading, on a chip that is never a paragraph. Inside a control it therefore stood proud of the label beside it and pushed the whole box past its own height token: the masthead's search field measured 39px against a 36px `sm`, and it was this keycap doing it. `--control-lh` is the leading a one-line box gets, and this is one.
36
36
 
37
37
  ### Props
38
38
 
@@ -4,7 +4,7 @@ A state machine: what something can be, and what moves it between states.
4
4
 
5
5
  - Group: Diagrams
6
6
  - Import: `import { LifecycleFigure } from '@misoto22/design/diagrams'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/lifecycle-figure/
9
9
  - Related: workflow-figure, steps
10
10
 
@@ -4,7 +4,7 @@ Several series compared over a continuous axis.
4
4
 
5
5
  - Group: Charts
6
6
  - Import: `import { LineChart } from '@misoto22/design/charts'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/line-chart/
9
9
  - Related: area-chart, composed-chart
10
10
 
@@ -4,7 +4,7 @@ The mark on a link that leaves the page.
4
4
 
5
5
  - Group: Display
6
6
  - Import: `import { LinkArrow } from '@misoto22/design'`
7
- - Version: 0.8.0
7
+ - Version: 0.10.0
8
8
  - Docs: https://ui.misoto22.com/components/link-arrow/
9
9
 
10
10
  ## Anatomy