@flowstack-ui/agent-tools 0.1.2 → 0.1.4

package/public/packages/brick/0.1.12/components/kbd.txt

@@ -0,0 +1,113 @@
+# Kbd
+
+Source: @flowstack-ui/brick@0.1.12
+Kind: component
+ID: kbd
+
+# Kbd agent guide
+
+## Purpose
+
+Render native keyboard-input notation with finished Brick sizing and visual recipes.
+
+## Use when
+
+- Copy needs to name a physical or virtual keyboard key or show a compact authored key sequence.
+
+## Choose something else when
+
+- The application must register or execute a shortcut. Use application-owned keyboard behavior.
+- The content is a technical literal rather than keyboard input. Use Code.
+
+## Required composition
+
+- Keep Kbd inside meaningful surrounding copy or repeat Kbd for each authored key in a sequence with visible separators outside the key hosts.
+
+## Rules
+
+- **MUST:** Preserve the one native kbd host and use it only for keyboard-input notation.
+- **MUST:** Do not register shortcuts, listen for keys, translate platform labels, or add interaction inside Kbd.
+- **MUST:** Select only the documented raised, outline, subtle, or plain variant and sm, md, or lg size.
+- **MUST:** Load styles.css or core.css plus kbd.css.
+
+## Common mistakes
+
+- **Avoid:** Putting an entire shortcut such as Ctrl+Shift+P inside one Kbd host without authored separation. **Instead:** Use one Kbd per key and keep visible separators in the surrounding content owner.
+
+## Validation checklist
+
+- Confirm native kbd semantics, closed recipes, readable key sequences, selection and copy, forced colors, zoom, localization, RTL, and CSS delivery.
+- Confirm Kbd adds no tab stop, role, shortcut listener, or platform detection.
+
+## Related guidance
+
+- `code`
+- `text`
+- `interface-composition`
+
+## Machine record
+
+```json
+{
+  "schema": "flowstack.agent-component.v1",
+  "id": "kbd",
+  "name": "Kbd",
+  "package": "@flowstack-ui/brick",
+  "layer": "brick",
+  "kind": "component",
+  "purpose": "Render native keyboard-input notation with finished Brick sizing and visual recipes.",
+  "useWhen": [
+    "Copy needs to name a physical or virtual keyboard key or show a compact authored key sequence."
+  ],
+  "avoidWhen": [
+    {
+      "condition": "The application must register or execute a shortcut.",
+      "useInstead": "application-owned keyboard behavior"
+    },
+    {
+      "condition": "The content is a technical literal rather than keyboard input.",
+      "useInstead": "Code"
+    }
+  ],
+  "composition": [
+    "Keep Kbd inside meaningful surrounding copy or repeat Kbd for each authored key in a sequence with visible separators outside the key hosts."
+  ],
+  "rules": [
+    {
+      "id": "kbd-native",
+      "level": "must",
+      "statement": "Preserve the one native kbd host and use it only for keyboard-input notation."
+    },
+    {
+      "id": "kbd-passive",
+      "level": "must",
+      "statement": "Do not register shortcuts, listen for keys, translate platform labels, or add interaction inside Kbd."
+    },
+    {
+      "id": "kbd-recipes",
+      "level": "must",
+      "statement": "Select only the documented raised, outline, subtle, or plain variant and sm, md, or lg size."
+    },
+    {
+      "id": "kbd-css",
+      "level": "must",
+      "statement": "Load styles.css or core.css plus kbd.css."
+    }
+  ],
+  "commonMistakes": [
+    {
+      "mistake": "Putting an entire shortcut such as Ctrl+Shift+P inside one Kbd host without authored separation.",
+      "correction": "Use one Kbd per key and keep visible separators in the surrounding content owner."
+    }
+  ],
+  "validation": [
+    "Confirm native kbd semantics, closed recipes, readable key sequences, selection and copy, forced colors, zoom, localization, RTL, and CSS delivery.",
+    "Confirm Kbd adds no tab stop, role, shortcut listener, or platform detection."
+  ],
+  "related": [
+    "code",
+    "text",
+    "interface-composition"
+  ]
+}
+```

package/public/packages/brick/{0.1.11 → 0.1.12}/components/link-box.txt

@@ -1,6 +1,6 @@
 # Link Box
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: link-box
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/link.txt

@@ -1,6 +1,6 @@
 # Link
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: link
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/list.txt

@@ -1,6 +1,6 @@
 # List
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: list
 

package/public/packages/brick/0.1.12/components/mark.txt

@@ -0,0 +1,105 @@
+# Mark
+
+Source: @flowstack-ui/brick@0.1.12
+Kind: component
+ID: mark
+
+# Mark agent guide
+
+## Purpose
+
+Render a semantically marked static passage with restrained theme-aware Brick paint.
+
+## Use when
+
+- Authored content needs a static marked passage whose relevance is already known.
+
+## Choose something else when
+
+- Text must be matched from a query. Use Highlight.
+- Text needs stress emphasis. Use Em.
+
+## Required composition
+
+- Keep Mark inside the surrounding Text, heading, link, or Prose content owner.
+
+## Rules
+
+- **MUST:** Use Mark for authored static relevance; do not pass a query or implement search matching inside it.
+- **MUST:** Preserve the one native mark host and select only the documented variant and tone recipes.
+- **MUST:** Load styles.css or core.css plus mark.css.
+
+## Common mistakes
+
+- **Avoid:** Mapping every search result manually through Mark. **Instead:** Use Highlight when Atom-owned matching must segment text.
+
+## Validation checklist
+
+- Confirm native mark semantics, normal selection and copy, inherited typography, readable contrast, wrapping, forced colors, zoom, RTL, and CSS delivery.
+
+## Related guidance
+
+- `em`
+- `text`
+- `interface-composition`
+
+## Machine record
+
+```json
+{
+  "schema": "flowstack.agent-component.v1",
+  "id": "mark",
+  "name": "Mark",
+  "package": "@flowstack-ui/brick",
+  "layer": "brick",
+  "kind": "component",
+  "purpose": "Render a semantically marked static passage with restrained theme-aware Brick paint.",
+  "useWhen": [
+    "Authored content needs a static marked passage whose relevance is already known."
+  ],
+  "avoidWhen": [
+    {
+      "condition": "Text must be matched from a query.",
+      "useInstead": "Highlight"
+    },
+    {
+      "condition": "Text needs stress emphasis.",
+      "useInstead": "Em"
+    }
+  ],
+  "composition": [
+    "Keep Mark inside the surrounding Text, heading, link, or Prose content owner."
+  ],
+  "rules": [
+    {
+      "id": "mark-static",
+      "level": "must",
+      "statement": "Use Mark for authored static relevance; do not pass a query or implement search matching inside it."
+    },
+    {
+      "id": "mark-native",
+      "level": "must",
+      "statement": "Preserve the one native mark host and select only the documented variant and tone recipes."
+    },
+    {
+      "id": "mark-css",
+      "level": "must",
+      "statement": "Load styles.css or core.css plus mark.css."
+    }
+  ],
+  "commonMistakes": [
+    {
+      "mistake": "Mapping every search result manually through Mark.",
+      "correction": "Use Highlight when Atom-owned matching must segment text."
+    }
+  ],
+  "validation": [
+    "Confirm native mark semantics, normal selection and copy, inherited typography, readable contrast, wrapping, forced colors, zoom, RTL, and CSS delivery."
+  ],
+  "related": [
+    "em",
+    "text",
+    "interface-composition"
+  ]
+}
+```

package/public/packages/brick/{0.1.11 → 0.1.12}/components/menubar.txt

@@ -1,6 +1,6 @@
 # Menubar
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: menubar
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/multi-select.txt

@@ -1,6 +1,6 @@
 # MultiSelect
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: multi-select
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/nav-list.txt

@@ -1,6 +1,6 @@
 # NavList
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: nav-list
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/navigation-menu.txt

@@ -1,6 +1,6 @@
 # NavigationMenu
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: navigation-menu
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/notification-badge.txt

@@ -1,6 +1,6 @@
 # NotificationBadge
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: notification-badge
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/number-input.txt

@@ -1,6 +1,6 @@
 # NumberInput
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: number-input
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/otp-field.txt

@@ -1,6 +1,6 @@
 # OTPField
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: otp-field
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/pagination.txt

@@ -1,6 +1,6 @@
 # Pagination
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: pagination
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/password-toggle-field.txt

@@ -1,6 +1,6 @@
 # PasswordToggleField
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: password-toggle-field
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/popover.txt

@@ -1,6 +1,6 @@
 # Popover
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: popover
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/progress-circle.txt

@@ -1,6 +1,6 @@
 # ProgressCircle
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: progress-circle
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/progress.txt

@@ -1,6 +1,6 @@
 # Progress
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: progress
 

package/public/packages/brick/0.1.12/components/prose.txt

@@ -0,0 +1,143 @@
+# Prose
+
+Source: @flowstack-ui/brick@0.1.12
+Kind: component
+ID: prose
+
+# Prose agent guide
+
+## Purpose
+
+Apply finished descendant typography, rhythm, and readable measure to trusted React content.
+
+## Use when
+
+- An application, CMS adapter, or Markdown renderer already produced trusted React children that need coherent editorial typography.
+
+## Choose something else when
+
+- Content is untrusted or still needs HTML or Markdown parsing. Use an application-owned sanitizer and parser before Prose.
+- A small explicit piece of interface copy needs one recipe. Use Text.
+- Content needs editing behavior. Use a source-installed editor composition.
+
+## Required composition
+
+- Pass trusted native React descendants to Prose and let the application own document structure, trust, and data loading.
+- Use direct Brick components when richer anatomy or behavior is needed; their classes intentionally override Prose's low-specificity descendant styles.
+
+## Rules
+
+- **MUST:** Sanitize and parse untrusted external content before it becomes Prose children; Prose never makes raw HTML safe.
+- **MUST:** Keep heading hierarchy, landmark choice, link destinations, table headers, language, and alternative text application-owned.
+- **MUST:** Use the narrow, default, wide, or none reading measure intentionally rather than adding duplicate width CSS.
+- **MUST:** Use direct Link, List, Blockquote, Code Block, Table, or Image components when their richer public contract is required, including accessible preserved horizontal scrolling for source or complex tables.
+- **MUST:** Load styles.css or core.css plus prose.css.
+
+## Common mistakes
+
+- **Avoid:** Passing unsanitized HTML through dangerouslySetInnerHTML inside Prose. **Instead:** Keep trust and sanitization in the application, then render trusted React children.
+- **Avoid:** Using Prose as a generic spacing wrapper around interface controls. **Instead:** Use Stack and Text for interface composition; reserve Prose for editorial descendants.
+
+## Validation checklist
+
+- Confirm native descendant semantics and source order remain unchanged.
+- Confirm size and measure, headings, lists, links, quotes, tables, code, media, dark appearance, forced colors, narrow widths, zoom, text spacing, localization, RTL, SSR, refs, and modular CSS delivery.
+
+## Related guidance
+
+- `text`
+- `link`
+- `list`
+- `blockquote`
+- `code`
+- `code-block`
+- `table`
+- `image`
+- `interface-composition`
+
+## Machine record
+
+```json
+{
+  "schema": "flowstack.agent-component.v1",
+  "id": "prose",
+  "name": "Prose",
+  "package": "@flowstack-ui/brick",
+  "layer": "brick",
+  "kind": "component",
+  "purpose": "Apply finished descendant typography, rhythm, and readable measure to trusted React content.",
+  "useWhen": [
+    "An application, CMS adapter, or Markdown renderer already produced trusted React children that need coherent editorial typography."
+  ],
+  "avoidWhen": [
+    {
+      "condition": "Content is untrusted or still needs HTML or Markdown parsing.",
+      "useInstead": "an application-owned sanitizer and parser before Prose"
+    },
+    {
+      "condition": "A small explicit piece of interface copy needs one recipe.",
+      "useInstead": "Text"
+    },
+    {
+      "condition": "Content needs editing behavior.",
+      "useInstead": "a source-installed editor composition"
+    }
+  ],
+  "composition": [
+    "Pass trusted native React descendants to Prose and let the application own document structure, trust, and data loading.",
+    "Use direct Brick components when richer anatomy or behavior is needed; their classes intentionally override Prose's low-specificity descendant styles."
+  ],
+  "rules": [
+    {
+      "id": "prose-trust",
+      "level": "must",
+      "statement": "Sanitize and parse untrusted external content before it becomes Prose children; Prose never makes raw HTML safe."
+    },
+    {
+      "id": "prose-semantics",
+      "level": "must",
+      "statement": "Keep heading hierarchy, landmark choice, link destinations, table headers, language, and alternative text application-owned."
+    },
+    {
+      "id": "prose-measure",
+      "level": "must",
+      "statement": "Use the narrow, default, wide, or none reading measure intentionally rather than adding duplicate width CSS."
+    },
+    {
+      "id": "prose-components",
+      "level": "must",
+      "statement": "Use direct Link, List, Blockquote, Code Block, Table, or Image components when their richer public contract is required, including accessible preserved horizontal scrolling for source or complex tables."
+    },
+    {
+      "id": "prose-css",
+      "level": "must",
+      "statement": "Load styles.css or core.css plus prose.css."
+    }
+  ],
+  "commonMistakes": [
+    {
+      "mistake": "Passing unsanitized HTML through dangerouslySetInnerHTML inside Prose.",
+      "correction": "Keep trust and sanitization in the application, then render trusted React children."
+    },
+    {
+      "mistake": "Using Prose as a generic spacing wrapper around interface controls.",
+      "correction": "Use Stack and Text for interface composition; reserve Prose for editorial descendants."
+    }
+  ],
+  "validation": [
+    "Confirm native descendant semantics and source order remain unchanged.",
+    "Confirm size and measure, headings, lists, links, quotes, tables, code, media, dark appearance, forced colors, narrow widths, zoom, text spacing, localization, RTL, SSR, refs, and modular CSS delivery."
+  ],
+  "related": [
+    "text",
+    "link",
+    "list",
+    "blockquote",
+    "code",
+    "code-block",
+    "table",
+    "image",
+    "interface-composition"
+  ]
+}
+```

package/public/packages/brick/{0.1.11 → 0.1.12}/components/radio-group.txt

@@ -1,6 +1,6 @@
 # RadioGroup
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: radio-group
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/rating.txt

@@ -1,6 +1,6 @@
 # Rating
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: rating
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/reorderable-list.txt

@@ -1,6 +1,6 @@
 # Reorderable List
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: reorderable-list
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/scroll-area.txt

@@ -1,6 +1,6 @@
 # ScrollArea
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: scroll-area
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/section.txt

@@ -1,6 +1,6 @@
 # Section
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: section
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/segment-group.txt

@@ -1,6 +1,6 @@
 # SegmentGroup
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: segment-group
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/select.txt

@@ -1,6 +1,6 @@
 # Select
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: select
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/show.txt

@@ -1,6 +1,6 @@
 # Show
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: show
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/sidebar.txt

@@ -1,6 +1,6 @@
 # Sidebar
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: sidebar
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/skeleton.txt

@@ -1,6 +1,6 @@
 # Skeleton
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: skeleton
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/skip-link.txt

@@ -1,6 +1,6 @@
 # SkipLink
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: skip-link
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/slider.txt

@@ -1,6 +1,6 @@
 # Slider
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: slider
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/stack.txt

@@ -1,6 +1,6 @@
 # Stack
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: stack
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/status.txt

@@ -1,6 +1,6 @@
 # Status
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: status
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/surface.txt

@@ -1,6 +1,6 @@
 # Surface
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: surface
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/swipeable-item.txt

@@ -1,6 +1,6 @@
 # SwipeableItem
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: swipeable-item
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/switch.txt

@@ -1,6 +1,6 @@
 # Switch
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: switch
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/table.txt

@@ -1,6 +1,6 @@
 # Table
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: table
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/tabs.txt

@@ -1,6 +1,6 @@
 # Tabs
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: tabs