@flowstack-ui/agent-tools 0.1.4 → 0.1.6

package/public/llms.txt

@@ -4,8 +4,8 @@ Version-aware public Agent Knowledge. Start with a task or exact package; then l
 
 ## Packages
 
-- [@flowstack-ui/atom@0.25.1](/packages/atom/0.25.1/index.txt) — 71 components, 0 operations
-- [@flowstack-ui/brick@0.1.12](/packages/brick/0.1.12/index.txt) — 95 components, 0 operations
+- [@flowstack-ui/atom@0.26.0](/packages/atom/0.26.0/index.txt) — 71 components, 0 operations
+- [@flowstack-ui/brick@0.2.0](/packages/brick/0.2.0/index.txt) — 95 components, 0 operations
 - [@flowstack-ui/colors@0.1.1](/packages/colors/0.1.1/index.txt) — 0 components, 6 operations
 - [@flowstack-ui/theme@0.1.1](/packages/theme/0.1.1/index.txt) — 0 components, 7 operations
 

package/public/packages/atom/{0.25.1 → 0.26.0}/components/accordion.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/alert-dialog.txt

@@ -1,6 +1,6 @@
 # AlertDialog
 
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: alert-dialog
 

package/public/packages/atom/{0.25.1 → 0.26.0}/components/app-bar.txt

@@ -1,6 +1,6 @@
 # AppBar
 
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: app-bar
 

package/public/packages/atom/{0.25.1 → 0.26.0}/components/aspect-ratio.txt

@@ -1,6 +1,6 @@
 # AspectRatio
 
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: aspect-ratio
 

package/public/packages/atom/{0.25.1 → 0.26.0}/components/avatar.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/badge.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/bottom-navigation.txt

@@ -1,6 +1,6 @@
 # BottomNavigation
 
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: bottom-navigation
 

package/public/packages/atom/{0.25.1 → 0.26.0}/components/breadcrumb.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/button.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/carousel.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/checkbox-group.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/checkbox.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/clipboard.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/collapsible.txt

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

package/public/packages/atom/0.26.0/components/color-picker.txt

@@ -0,0 +1,147 @@
+# Color Picker
+
+Source: @flowstack-ui/atom@0.26.0
+Kind: component
+ID: color-picker
+
+# Color Picker agent guide
+
+## Purpose
+
+Provide complete headless color selection with one shared color model, accessible area and channel interaction, alpha, format conversion, presets, optional positioned content, form submission, and progressive screen sampling.
+
+## Use when
+
+- A form, editor, or settings surface needs one selectable and editable color.
+
+## Choose something else when
+
+- The interface only previews a color. Use Brick Color Swatch.
+- The product needs saved palettes, automatic names, contrast analysis, gradients, or persistence. Use application or dedicated higher-layer state composed around Color Picker.
+
+## Required composition
+
+- Place Label and the editable controls inside Root; include HiddenInput when a named value must submit.
+- For an inline picker set inline and compose Area plus channel controls directly; for a popup compose Trigger, Positioner, and Content.
+- Build each ChannelSlider from Track and Thumb; optional Label and ValueText inherit the parent channel.
+- Build presets from SwatchGroup, SwatchTrigger, Swatch, and optional SwatchIndicator; Brick owns the visible checkmark.
+
+## Rules
+
+- **MUST:** Keep color value, format, area, channels, alpha, and presets on the same ColorPicker.Root model.
+- **MUST:** Give the picker, channel controls, and presets meaningful accessible names and never communicate selection by color alone.
+- **MUST:** Use onValueChangeEnd for expensive work that should wait for a pointer drag, committed channel input, or eyedropper completion; area and slider keyboard steps use the ordinary value-change event.
+- **MUST:** Merge Atom-provided inline styles and CSS variables instead of replacing area, slider, thumb, positioning, or color-math styles.
+- **MUST:** Treat EyeDropper and NativeInput as progressive platform features; NativeInput is opaque-only and unsupported or cancelled EyeDropper use is a no-op.
+- **SHOULD:** Use visual swatch shapes through Brick Color Swatch styling rather than adding shape behavior to Atom Root.
+
+## Common mistakes
+
+- **Avoid:** Reimplementing color conversion or pointer math in Brick or an application. **Instead:** Compose the Atom area, channel, and format parts.
+- **Avoid:** Storing saved colors inside Color Picker. **Instead:** Store the palette in application state and render it through SwatchTrigger.
+- **Avoid:** Presenting NativeInput as the full picker. **Instead:** Label it as the browser-owned opaque chooser or use the complete area/channel anatomy.
+
+## Validation checklist
+
+- Test pointer, touch, arrow/Page/Home/End keys, pointer-drag completion, LTR/RTL, alpha, all formats, controlled/uncontrolled state, popup dismissal, swatch selection, disabled/read-only behavior, external form association, and reset.
+- Verify EyeDropper support, success, cancellation, and unsupported behavior in a secure browser context without claiming unavailable engines.
+- Verify the styled layer in narrow, zoomed, light/dark, and forced-color modes.
+
+## Related guidance
+
+- `field`
+- `form`
+- `input`
+- `popover`
+- `slider`
+
+## Machine record
+
+```json
+{
+  "schema": "flowstack.agent-component.v1",
+  "id": "color-picker",
+  "name": "Color Picker",
+  "package": "@flowstack-ui/atom",
+  "layer": "atom",
+  "kind": "component",
+  "purpose": "Provide complete headless color selection with one shared color model, accessible area and channel interaction, alpha, format conversion, presets, optional positioned content, form submission, and progressive screen sampling.",
+  "useWhen": [
+    "A form, editor, or settings surface needs one selectable and editable color."
+  ],
+  "avoidWhen": [
+    {
+      "condition": "The interface only previews a color.",
+      "useInstead": "Brick Color Swatch"
+    },
+    {
+      "condition": "The product needs saved palettes, automatic names, contrast analysis, gradients, or persistence.",
+      "useInstead": "application or dedicated higher-layer state composed around Color Picker"
+    }
+  ],
+  "composition": [
+    "Place Label and the editable controls inside Root; include HiddenInput when a named value must submit.",
+    "For an inline picker set inline and compose Area plus channel controls directly; for a popup compose Trigger, Positioner, and Content.",
+    "Build each ChannelSlider from Track and Thumb; optional Label and ValueText inherit the parent channel.",
+    "Build presets from SwatchGroup, SwatchTrigger, Swatch, and optional SwatchIndicator; Brick owns the visible checkmark."
+  ],
+  "rules": [
+    {
+      "id": "color-picker-one-model",
+      "level": "must",
+      "statement": "Keep color value, format, area, channels, alpha, and presets on the same ColorPicker.Root model."
+    },
+    {
+      "id": "color-picker-accessible-names",
+      "level": "must",
+      "statement": "Give the picker, channel controls, and presets meaningful accessible names and never communicate selection by color alone."
+    },
+    {
+      "id": "color-picker-completion",
+      "level": "must",
+      "statement": "Use onValueChangeEnd for expensive work that should wait for a pointer drag, committed channel input, or eyedropper completion; area and slider keyboard steps use the ordinary value-change event."
+    },
+    {
+      "id": "color-picker-style-merge",
+      "level": "must",
+      "statement": "Merge Atom-provided inline styles and CSS variables instead of replacing area, slider, thumb, positioning, or color-math styles."
+    },
+    {
+      "id": "color-picker-platform-progressive",
+      "level": "must",
+      "statement": "Treat EyeDropper and NativeInput as progressive platform features; NativeInput is opaque-only and unsupported or cancelled EyeDropper use is a no-op."
+    },
+    {
+      "id": "color-picker-swatch-shape",
+      "level": "should",
+      "statement": "Use visual swatch shapes through Brick Color Swatch styling rather than adding shape behavior to Atom Root."
+    }
+  ],
+  "commonMistakes": [
+    {
+      "mistake": "Reimplementing color conversion or pointer math in Brick or an application.",
+      "correction": "Compose the Atom area, channel, and format parts."
+    },
+    {
+      "mistake": "Storing saved colors inside Color Picker.",
+      "correction": "Store the palette in application state and render it through SwatchTrigger."
+    },
+    {
+      "mistake": "Presenting NativeInput as the full picker.",
+      "correction": "Label it as the browser-owned opaque chooser or use the complete area/channel anatomy."
+    }
+  ],
+  "validation": [
+    "Test pointer, touch, arrow/Page/Home/End keys, pointer-drag completion, LTR/RTL, alpha, all formats, controlled/uncontrolled state, popup dismissal, swatch selection, disabled/read-only behavior, external form association, and reset.",
+    "Verify EyeDropper support, success, cancellation, and unsupported behavior in a secure browser context without claiming unavailable engines.",
+    "Verify the styled layer in narrow, zoomed, light/dark, and forced-color modes."
+  ],
+  "related": [
+    "field",
+    "form",
+    "input",
+    "popover",
+    "slider"
+  ]
+}
+```

package/public/packages/atom/{0.25.1 → 0.26.0}/components/combobox.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/context-menu.txt

@@ -1,6 +1,6 @@
 # ContextMenu
 
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: context-menu
 

package/public/packages/atom/{0.25.1 → 0.26.0}/components/data-grid.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/dialog.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/direction.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/divider.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/drag-drop.txt

@@ -1,6 +1,6 @@
 # DragDrop
 
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: drag-drop
 

package/public/packages/atom/{0.25.1 → 0.26.0}/components/drawer.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/dropdown-menu.txt

@@ -1,6 +1,6 @@
 # DropdownMenu
 
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: dropdown-menu
 

package/public/packages/atom/{0.25.1 → 0.26.0}/components/feed.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/field.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/fieldset.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/file-upload.txt

@@ -1,6 +1,6 @@
 # FileUpload
 
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: file-upload
 

package/public/packages/atom/{0.25.1 → 0.26.0}/components/form.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/highlight.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/hover-card.txt

@@ -1,6 +1,6 @@
 # HoverCard
 
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: hover-card
 

package/public/packages/atom/{0.25.1 → 0.26.0}/components/image.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/input.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/label.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/link.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/list.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/listbox.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/menu.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/menubar.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/modal.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/multi-select.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/nav-list.txt

@@ -1,6 +1,6 @@
 # NavList
 
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: nav-list
 

package/public/packages/atom/{0.25.1 → 0.26.0}/components/navigation-menu.txt

@@ -1,6 +1,6 @@
 # NavigationMenu
 
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: navigation-menu
 

package/public/packages/atom/{0.25.1 → 0.26.0}/components/number-input.txt

@@ -1,6 +1,6 @@
 # NumberInput
 
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: number-input
 

package/public/packages/atom/{0.25.1 → 0.26.0}/components/otp-field.txt

@@ -1,6 +1,6 @@
 # OTPField
 
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: otp-field
 

package/public/packages/atom/{0.25.1 → 0.26.0}/components/pagination.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/password-toggle-field.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/popover.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/pressable.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/progress.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/radio-group.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/rating.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/reorder.txt

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

package/public/packages/atom/{0.25.1 → 0.26.0}/components/scroll-area.txt

@@ -1,6 +1,6 @@
 # ScrollArea
 
-Source: @flowstack-ui/atom@0.25.1
+Source: @flowstack-ui/atom@0.26.0
 Kind: component
 ID: scroll-area