npm - @flowstack-ui/agent-tools - Versions diffs - 0.1.4 → 0.1.6 - Mend

@flowstack-ui/agent-tools 0.1.4 → 0.1.6

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 (198) hide show

package/public/packages/atom/{0.25.1 → 0.26.0}/components/select.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Select
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: select

package/public/packages/atom/{0.25.1 → 0.26.0}/components/sidebar.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Sidebar
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: sidebar

package/public/packages/atom/{0.25.1 → 0.26.0}/components/skip-link.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # SkipLink
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: skip-link

package/public/packages/atom/{0.25.1 → 0.26.0}/components/slider.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Slider
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: slider

package/public/packages/atom/{0.25.1 → 0.26.0}/components/swipeable-item.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # SwipeableItem
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: swipeable-item

package/public/packages/atom/{0.25.1 → 0.26.0}/components/switch.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Switch
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: switch

package/public/packages/atom/{0.25.1 → 0.26.0}/components/table.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Table
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: table

package/public/packages/atom/{0.25.1 → 0.26.0}/components/tabs.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Tabs
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: tabs

package/public/packages/atom/{0.25.1 → 0.26.0}/components/textarea.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Textarea
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: textarea

package/public/packages/atom/{0.25.1 → 0.26.0}/components/toast.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Toast
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: toast

package/public/packages/atom/{0.25.1 → 0.26.0}/components/toggle-group.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # ToggleGroup
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: toggle-group

package/public/packages/atom/{0.25.1 → 0.26.0}/components/toggle.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Toggle
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: toggle

package/public/packages/atom/{0.25.1 → 0.26.0}/components/toolbar.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Toolbar
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: toolbar

package/public/packages/atom/{0.25.1 → 0.26.0}/components/tooltip.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Tooltip
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: tooltip

package/public/packages/atom/{0.25.1 → 0.26.0}/components/tree-grid.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # TreeGrid
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: tree-grid

package/public/packages/atom/{0.25.1 → 0.26.0}/components/tree.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Tree
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: tree

package/public/packages/atom/{0.25.1 → 0.26.0}/components/visually-hidden.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # VisuallyHidden
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: visually-hidden

package/public/packages/atom/{0.25.1 → 0.26.0}/docs/guides/agent-knowledge.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Public document: guides/agent-knowledge
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 # Agent Knowledge

package/public/packages/atom/{0.25.1 → 0.26.0}/docs/guides/getting-started.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Public document: guides/getting-started
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 # Getting Started

package/public/packages/atom/{0.25.1 → 0.26.0}/docs/guides/imports.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Public document: guides/imports
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 # Imports

package/public/packages/atom/{0.25.1 → 0.26.0}/docs/guides/public-api.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Public document: guides/public-api
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 # Public API

package/public/packages/atom/{0.25.1 → 0.26.0}/guides/behavior-composition.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Atom behavior composition
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: guide
 ID: behavior-composition

package/public/packages/atom/{0.25.1 → 0.26.0}/guides/layer-selection.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Atom layer selection
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: guide
 ID: layer-selection

package/public/packages/atom/0.26.0/index.txt ADDED Viewed

@@ -0,0 +1,90 @@
+# @flowstack-ui/atom@0.26.0
+Archive SHA-256: `5d8593aa083017e0daabb5de2f59176e22e6ef4e131d0601aa68f98b7cd8a005`
+Coverage: 2904/2904 public surfaces; zero failures.
+## component
+- [Accordion](/packages/atom/0.26.0/components/accordion.txt)
+- [AlertDialog](/packages/atom/0.26.0/components/alert-dialog.txt)
+- [AppBar](/packages/atom/0.26.0/components/app-bar.txt)
+- [AspectRatio](/packages/atom/0.26.0/components/aspect-ratio.txt)
+- [Avatar](/packages/atom/0.26.0/components/avatar.txt)
+- [Badge](/packages/atom/0.26.0/components/badge.txt)
+- [BottomNavigation](/packages/atom/0.26.0/components/bottom-navigation.txt)
+- [Breadcrumb](/packages/atom/0.26.0/components/breadcrumb.txt)
+- [Button](/packages/atom/0.26.0/components/button.txt)
+- [Carousel](/packages/atom/0.26.0/components/carousel.txt)
+- [Checkbox](/packages/atom/0.26.0/components/checkbox.txt)
+- [CheckboxGroup](/packages/atom/0.26.0/components/checkbox-group.txt)
+- [Clipboard](/packages/atom/0.26.0/components/clipboard.txt)
+- [Collapsible](/packages/atom/0.26.0/components/collapsible.txt)
+- [Color Picker](/packages/atom/0.26.0/components/color-picker.txt)
+- [Combobox](/packages/atom/0.26.0/components/combobox.txt)
+- [ContextMenu](/packages/atom/0.26.0/components/context-menu.txt)
+- [DataGrid](/packages/atom/0.26.0/components/data-grid.txt)
+- [Dialog](/packages/atom/0.26.0/components/dialog.txt)
+- [Direction](/packages/atom/0.26.0/components/direction.txt)
+- [Divider](/packages/atom/0.26.0/components/divider.txt)
+- [DragDrop](/packages/atom/0.26.0/components/drag-drop.txt)
+- [Drawer](/packages/atom/0.26.0/components/drawer.txt)
+- [DropdownMenu](/packages/atom/0.26.0/components/dropdown-menu.txt)
+- [Feed](/packages/atom/0.26.0/components/feed.txt)
+- [Field](/packages/atom/0.26.0/components/field.txt)
+- [Fieldset](/packages/atom/0.26.0/components/fieldset.txt)
+- [FileUpload](/packages/atom/0.26.0/components/file-upload.txt)
+- [Form](/packages/atom/0.26.0/components/form.txt)
+- [Highlight](/packages/atom/0.26.0/components/highlight.txt)
+- [HoverCard](/packages/atom/0.26.0/components/hover-card.txt)
+- [Image](/packages/atom/0.26.0/components/image.txt)
+- [Input](/packages/atom/0.26.0/components/input.txt)
+- [Label](/packages/atom/0.26.0/components/label.txt)
+- [Link](/packages/atom/0.26.0/components/link.txt)
+- [List](/packages/atom/0.26.0/components/list.txt)
+- [Listbox](/packages/atom/0.26.0/components/listbox.txt)
+- [Menu](/packages/atom/0.26.0/components/menu.txt)
+- [Menubar](/packages/atom/0.26.0/components/menubar.txt)
+- [Modal](/packages/atom/0.26.0/components/modal.txt)
+- [MultiSelect](/packages/atom/0.26.0/components/multi-select.txt)
+- [NavList](/packages/atom/0.26.0/components/nav-list.txt)
+- [NavigationMenu](/packages/atom/0.26.0/components/navigation-menu.txt)
+- [NumberInput](/packages/atom/0.26.0/components/number-input.txt)
+- [OTPField](/packages/atom/0.26.0/components/otp-field.txt)
+- [Pagination](/packages/atom/0.26.0/components/pagination.txt)
+- [PasswordToggleField](/packages/atom/0.26.0/components/password-toggle-field.txt)
+- [Popover](/packages/atom/0.26.0/components/popover.txt)
+- [Pressable](/packages/atom/0.26.0/components/pressable.txt)
+- [Progress](/packages/atom/0.26.0/components/progress.txt)
+- [RadioGroup](/packages/atom/0.26.0/components/radio-group.txt)
+- [Rating](/packages/atom/0.26.0/components/rating.txt)
+- [Reorder](/packages/atom/0.26.0/components/reorder.txt)
+- [ScrollArea](/packages/atom/0.26.0/components/scroll-area.txt)
+- [Select](/packages/atom/0.26.0/components/select.txt)
+- [Sidebar](/packages/atom/0.26.0/components/sidebar.txt)
+- [SkipLink](/packages/atom/0.26.0/components/skip-link.txt)
+- [Slider](/packages/atom/0.26.0/components/slider.txt)
+- [SwipeableItem](/packages/atom/0.26.0/components/swipeable-item.txt)
+- [Switch](/packages/atom/0.26.0/components/switch.txt)
+- [Table](/packages/atom/0.26.0/components/table.txt)
+- [Tabs](/packages/atom/0.26.0/components/tabs.txt)
+- [Textarea](/packages/atom/0.26.0/components/textarea.txt)
+- [Toast](/packages/atom/0.26.0/components/toast.txt)
+- [Toggle](/packages/atom/0.26.0/components/toggle.txt)
+- [ToggleGroup](/packages/atom/0.26.0/components/toggle-group.txt)
+- [Toolbar](/packages/atom/0.26.0/components/toolbar.txt)
+- [Tooltip](/packages/atom/0.26.0/components/tooltip.txt)
+- [Tree](/packages/atom/0.26.0/components/tree.txt)
+- [TreeGrid](/packages/atom/0.26.0/components/tree-grid.txt)
+- [VisuallyHidden](/packages/atom/0.26.0/components/visually-hidden.txt)
+## document
+- [guides/agent-knowledge](/packages/atom/0.26.0/docs/guides/agent-knowledge.txt)
+- [guides/getting-started](/packages/atom/0.26.0/docs/guides/getting-started.txt)
+- [guides/imports](/packages/atom/0.26.0/docs/guides/imports.txt)
+- [guides/public-api](/packages/atom/0.26.0/docs/guides/public-api.txt)
+## guide
+- [Atom behavior composition](/packages/atom/0.26.0/guides/behavior-composition.txt)
+- [Atom layer selection](/packages/atom/0.26.0/guides/layer-selection.txt)

package/public/packages/brick/{0.1.12 → 0.2.0}/components/accordion.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Accordion
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: accordion

package/public/packages/brick/{0.1.12 → 0.2.0}/components/alert-dialog.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # AlertDialog
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: alert-dialog

package/public/packages/brick/{0.1.12 → 0.2.0}/components/app-bar.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # AppBar
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: app-bar

package/public/packages/brick/{0.1.12 → 0.2.0}/components/appearance.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Appearance
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: appearance

package/public/packages/brick/{0.1.12 → 0.2.0}/components/aspect-ratio.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # AspectRatio
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: aspect-ratio

package/public/packages/brick/{0.1.12 → 0.2.0}/components/avatar.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Avatar
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: avatar

package/public/packages/brick/{0.1.12 → 0.2.0}/components/badge.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Badge
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: badge

package/public/packages/brick/{0.1.12 → 0.2.0}/components/bleed.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Bleed
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: bleed

package/public/packages/brick/{0.1.12 → 0.2.0}/components/blockquote.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Blockquote
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: blockquote

package/public/packages/brick/{0.1.12 → 0.2.0}/components/bottom-navigation.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # BottomNavigation
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: bottom-navigation

package/public/packages/brick/{0.1.12 → 0.2.0}/components/breadcrumb.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Breadcrumb
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: breadcrumb

package/public/packages/brick/{0.1.12 → 0.2.0}/components/button.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Button
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: button

package/public/packages/brick/{0.1.12 → 0.2.0}/components/card.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Card
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: card

package/public/packages/brick/{0.1.12 → 0.2.0}/components/carousel.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Carousel
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: carousel

package/public/packages/brick/{0.1.12 → 0.2.0}/components/checkbox-group.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Checkbox Group
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: checkbox-group

package/public/packages/brick/{0.1.12 → 0.2.0}/components/checkbox.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Checkbox
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: checkbox

package/public/packages/brick/{0.1.12 → 0.2.0}/components/chip.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Chip
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: chip

package/public/packages/brick/{0.1.12 → 0.2.0}/components/code-block.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Code Block
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: code-block

package/public/packages/brick/{0.1.12 → 0.2.0}/components/code.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Code
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: code

package/public/packages/brick/{0.1.12 → 0.2.0}/components/collapsible.txt RENAMED Viewed

@@ -1,6 +1,6 @@
 # Collapsible
-Source: @flowstack-ui/brick@0.1.12
+Source: @flowstack-ui/brick@0.2.0
 Kind: component
 ID: collapsible

package/public/packages/brick/0.2.0/components/color-picker.txt ADDED Viewed

@@ -0,0 +1,156 @@
+# Color Picker
+Source: @flowstack-ui/brick@0.2.0
+Kind: component
+ID: color-picker
+# Color Picker agent guide
+## Purpose
+Edit, inspect, choose, and submit one color through a finished popup or inline editor with area, channel, format, preset, native chooser, and EyeDropper paths.
+## Use when
+- A form, editor, or settings surface needs one color value with a finished visual editor.
+- Users need alpha, RGB, HSL, HSB, channel sliders, named presets, or a progressive platform color-picking path.
+## Choose something else when
+- The interface only previews a color. Use Color Swatch.
+- The task requires gradients, automatic color naming, contrast scoring, palette persistence, or a color wheel. Use application-owned specialist behavior composed around Color Picker.
+## Required composition
+- Place Label and Control inside Root; include HiddenInput when the value participates in native form submission.
+- For a popup, compose Trigger, Positioner, and Content. For an always-visible editor, set Root inline and render Content directly.
+- Build the visual editor from Area, ChannelSlider, format controls, channel inputs, and SwatchGroup; ValueSwatch and ValueText expose the current value.
+- Place SwatchIndicator inside Swatch or ValueSwatch whenever selection needs a visible non-color cue.
+## Rules
+- **MUST:** Use Brick parts for the finished interface and keep parsing, format conversion, selection, focus, dismissal, and form state in the exact Atom-backed machine.
+- **MUST:** Give the primary editable or native input an accessible name through Label or an explicit aria-label.
+- **MUST:** Provide name to Root and render exactly one HiddenInput when the color must submit.
+- **MUST:** Wrap popup Content in Positioner; do not recreate positioning, focus restoration, or outside dismissal.
+- **MUST:** Name every SwatchTrigger and render SwatchIndicator or an equivalent visible non-color selected cue.
+- **MUST:** Load styles.css, or core.css plus color-picker.css for modular delivery.
+- **SHOULD:** Treat NativeInput and EyeDropperTrigger as optional platform enhancements, not the only way to edit the color.
+## Common mistakes
+- **Avoid:** Reimplementing color conversion, pointer math, keyboard state, or popup behavior in Brick or application code. **Instead:** Compose the released ColorPicker anatomy and controlled callbacks.
+- **Avoid:** Putting popup Content beside Root without Positioner. **Instead:** Use Trigger, Positioner, and Content as the released popup composition.
+- **Avoid:** Naming both visible inputs and HiddenInput for submission. **Instead:** Put name on Root and render one HiddenInput.
+- **Avoid:** Using raw color alone to show the selected preset. **Instead:** Render SwatchIndicator and an accessible preset name.
+## Validation checklist
+- Test area and channel synchronization, alpha, RGB/HSL/HSB format changes, presets, text/native/EyeDropper paths, controlled state, popup focus and dismissal, disabled/read-only/invalid, form submit/reset, light/dark, forced colors, reduced motion, narrow/zoom, RTL, and non-color selection cues.
+## Related guidance
+- `color-swatch`
+- `field`
+- `form`
+- `input`
+- `popover`
+## Machine record
+```json
+{
+  "schema": "flowstack.agent-component.v1",
+  "id": "color-picker",
+  "name": "Color Picker",
+  "package": "@flowstack-ui/brick",
+  "layer": "brick",
+  "kind": "component",
+  "purpose": "Edit, inspect, choose, and submit one color through a finished popup or inline editor with area, channel, format, preset, native chooser, and EyeDropper paths.",
+  "useWhen": [
+    "A form, editor, or settings surface needs one color value with a finished visual editor.",
+    "Users need alpha, RGB, HSL, HSB, channel sliders, named presets, or a progressive platform color-picking path."
+  ],
+  "avoidWhen": [
+    {
+      "condition": "The interface only previews a color.",
+      "useInstead": "Color Swatch"
+    },
+    {
+      "condition": "The task requires gradients, automatic color naming, contrast scoring, palette persistence, or a color wheel.",
+      "useInstead": "application-owned specialist behavior composed around Color Picker"
+    }
+  ],
+  "composition": [
+    "Place Label and Control inside Root; include HiddenInput when the value participates in native form submission.",
+    "For a popup, compose Trigger, Positioner, and Content. For an always-visible editor, set Root inline and render Content directly.",
+    "Build the visual editor from Area, ChannelSlider, format controls, channel inputs, and SwatchGroup; ValueSwatch and ValueText expose the current value.",
+    "Place SwatchIndicator inside Swatch or ValueSwatch whenever selection needs a visible non-color cue."
+  ],
+  "rules": [
+    {
+      "id": "color-picker-ownership",
+      "level": "must",
+      "statement": "Use Brick parts for the finished interface and keep parsing, format conversion, selection, focus, dismissal, and form state in the exact Atom-backed machine."
+    },
+    {
+      "id": "color-picker-label",
+      "level": "must",
+      "statement": "Give the primary editable or native input an accessible name through Label or an explicit aria-label."
+    },
+    {
+      "id": "color-picker-form",
+      "level": "must",
+      "statement": "Provide name to Root and render exactly one HiddenInput when the color must submit."
+    },
+    {
+      "id": "color-picker-popup",
+      "level": "must",
+      "statement": "Wrap popup Content in Positioner; do not recreate positioning, focus restoration, or outside dismissal."
+    },
+    {
+      "id": "color-picker-selection",
+      "level": "must",
+      "statement": "Name every SwatchTrigger and render SwatchIndicator or an equivalent visible non-color selected cue."
+    },
+    {
+      "id": "color-picker-css",
+      "level": "must",
+      "statement": "Load styles.css, or core.css plus color-picker.css for modular delivery."
+    },
+    {
+      "id": "color-picker-platform",
+      "level": "should",
+      "statement": "Treat NativeInput and EyeDropperTrigger as optional platform enhancements, not the only way to edit the color."
+    }
+  ],
+  "commonMistakes": [
+    {
+      "mistake": "Reimplementing color conversion, pointer math, keyboard state, or popup behavior in Brick or application code.",
+      "correction": "Compose the released ColorPicker anatomy and controlled callbacks."
+    },
+    {
+      "mistake": "Putting popup Content beside Root without Positioner.",
+      "correction": "Use Trigger, Positioner, and Content as the released popup composition."
+    },
+    {
+      "mistake": "Naming both visible inputs and HiddenInput for submission.",
+      "correction": "Put name on Root and render one HiddenInput."
+    },
+    {
+      "mistake": "Using raw color alone to show the selected preset.",
+      "correction": "Render SwatchIndicator and an accessible preset name."
+    }
+  ],
+  "validation": [
+    "Test area and channel synchronization, alpha, RGB/HSL/HSB format changes, presets, text/native/EyeDropper paths, controlled state, popup focus and dismissal, disabled/read-only/invalid, form submit/reset, light/dark, forced colors, reduced motion, narrow/zoom, RTL, and non-color selection cues."
+  ],
+  "related": [
+    "color-swatch",
+    "field",
+    "form",
+    "input",
+    "popover"
+  ]
+}
+```