@flowstack-ui/agent-tools 0.1.3 → 0.1.4

package/public/packages/brick/{0.1.11 → 0.1.12}/components/code-block.txt

@@ -1,6 +1,6 @@
 # Code Block
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: code-block
 
@@ -23,32 +23,37 @@ Present preserved multi-line technical source with native scrolling, explicit me
 
 - Pass the exact plain-text source to Root value, then place Content inside Root and give focusable Content a specific accessible label.
 - Author Header, Title, Language, Actions, CopyTrigger, CopyStatus, and CopyIndicator only when the interface needs those optional parts.
-- For syntax highlighting, generate trusted React token nodes outside Brick and pass them to Content while keeping Root value identical to the plain text that must be copied.
-- Give the Code Block a bounded parent when vertical page or panel layout requires a fixed scrolling region; Content owns the code's horizontal overflow.
+- For syntax highlighting, pass a synchronous adapter or trusted React token nodes to Content while keeping Root value identical to the plain text that must be copied.
+- Use Line for authored line numbers, highlighting, focus, additions, and removals; metadata remains independent so one line can carry more than one relevant state.
+- Use Content maxLines for a bounded scroll region. For expansion, put bounded Content in CollapsePreview, unbounded Content in CollapseContent, and author CollapseTrigger so Brick Collapsible owns the real disclosure relationship and lifecycle.
 
 ## Rules
 
 - **MUST:** Keep Root value authoritative and exactly aligned with rendered highlighted content so copy behavior never depends on rendered textContent.
-- **MUST:** Keep tokenization, language loading, and syntax palettes in a consumer adapter; Brick accepts trusted React nodes and does not bundle a highlighter or unsafe HTML path.
+- **MUST:** Keep tokenization, language loading, and syntax palettes in a pure synchronous consumer adapter; Brick accepts trusted React nodes and does not bundle a highlighter or unsafe HTML path.
 - **MUST:** Let Content own canonical pre, code, focus, and horizontal scrolling instead of rebuilding them with a separate ScrollArea or native pre element.
 - **MUST:** Give every focusable Content region a specific aria-label or aria-labelledby, especially when several examples share one page.
+- **MUST:** Author Line metadata from the authoritative source or trusted adapter output; do not infer diffs, focus, or highlighting from visual tokens.
+- **MUST:** Keep standalone maxLines content reachable through its focusable viewport; for expansion, pair CollapsePreview and CollapseContent with an accessible CollapseTrigger so only the current source view is exposed.
 - **MUST:** Load styles.css or core.css plus code-block.css and its documented component dependencies.
 
 ## Common mistakes
 
 - **Avoid:** Rendering highlighted HTML with dangerouslySetInnerHTML, copying from token text, or nesting another pre and ScrollArea inside Content. **Instead:** Render trusted React token spans, preserve the original string in Root value, and let Content own the canonical code viewport.
 - **Avoid:** Adding a header, language label, copy action, or status region merely because those parts exist. **Instead:** Author only the optional anatomy required by the surrounding interface.
+- **Avoid:** Clipping a long code block with application CSS and no reachable overflow or expansion control. **Instead:** Use Content maxLines for bounded scrolling or compose CollapsePreview, CollapseContent, and CollapseTrigger for an accessible full-source path.
 
 ## Validation checklist
 
 - Confirm the rendered tokens and copied plain text match exactly, unsafe HTML is absent, and copy success, failure, concurrency, and status wording remain truthful when copy anatomy is present.
-- Check keyboard focus, uniquely named overflow landmarks, long-line scrolling or wrapping, mobile text sizing, zoom, selection, RTL/LTR, light and dark syntax contrast, and CSS delivery.
+- Check keyboard focus, uniquely named overflow landmarks, line metadata, bounded scrolling or collapse expansion, long-line scrolling or wrapping, mobile text sizing, zoom, selection, RTL/LTR, light and dark syntax contrast, and CSS delivery.
 
 ## Related guidance
 
 - `code`
 - `scroll-area`
 - `button`
+- `collapsible`
 - `tabs`
 - `interface-composition`
 
@@ -79,8 +84,9 @@ Present preserved multi-line technical source with native scrolling, explicit me
   "composition": [
     "Pass the exact plain-text source to Root value, then place Content inside Root and give focusable Content a specific accessible label.",
     "Author Header, Title, Language, Actions, CopyTrigger, CopyStatus, and CopyIndicator only when the interface needs those optional parts.",
-    "For syntax highlighting, generate trusted React token nodes outside Brick and pass them to Content while keeping Root value identical to the plain text that must be copied.",
-    "Give the Code Block a bounded parent when vertical page or panel layout requires a fixed scrolling region; Content owns the code's horizontal overflow."
+    "For syntax highlighting, pass a synchronous adapter or trusted React token nodes to Content while keeping Root value identical to the plain text that must be copied.",
+    "Use Line for authored line numbers, highlighting, focus, additions, and removals; metadata remains independent so one line can carry more than one relevant state.",
+    "Use Content maxLines for a bounded scroll region. For expansion, put bounded Content in CollapsePreview, unbounded Content in CollapseContent, and author CollapseTrigger so Brick Collapsible owns the real disclosure relationship and lifecycle."
   ],
   "rules": [
     {
@@ -91,7 +97,7 @@ Present preserved multi-line technical source with native scrolling, explicit me
     {
       "id": "code-block-highlighting-owner",
       "level": "must",
-      "statement": "Keep tokenization, language loading, and syntax palettes in a consumer adapter; Brick accepts trusted React nodes and does not bundle a highlighter or unsafe HTML path."
+      "statement": "Keep tokenization, language loading, and syntax palettes in a pure synchronous consumer adapter; Brick accepts trusted React nodes and does not bundle a highlighter or unsafe HTML path."
     },
     {
       "id": "code-block-scroll-owner",
@@ -103,6 +109,16 @@ Present preserved multi-line technical source with native scrolling, explicit me
       "level": "must",
       "statement": "Give every focusable Content region a specific aria-label or aria-labelledby, especially when several examples share one page."
     },
+    {
+      "id": "code-block-line-metadata",
+      "level": "must",
+      "statement": "Author Line metadata from the authoritative source or trusted adapter output; do not infer diffs, focus, or highlighting from visual tokens."
+    },
+    {
+      "id": "code-block-bounded-access",
+      "level": "must",
+      "statement": "Keep standalone maxLines content reachable through its focusable viewport; for expansion, pair CollapsePreview and CollapseContent with an accessible CollapseTrigger so only the current source view is exposed."
+    },
     {
       "id": "code-block-css",
       "level": "must",
@@ -117,16 +133,21 @@ Present preserved multi-line technical source with native scrolling, explicit me
     {
       "mistake": "Adding a header, language label, copy action, or status region merely because those parts exist.",
       "correction": "Author only the optional anatomy required by the surrounding interface."
+    },
+    {
+      "mistake": "Clipping a long code block with application CSS and no reachable overflow or expansion control.",
+      "correction": "Use Content maxLines for bounded scrolling or compose CollapsePreview, CollapseContent, and CollapseTrigger for an accessible full-source path."
     }
   ],
   "validation": [
     "Confirm the rendered tokens and copied plain text match exactly, unsafe HTML is absent, and copy success, failure, concurrency, and status wording remain truthful when copy anatomy is present.",
-    "Check keyboard focus, uniquely named overflow landmarks, long-line scrolling or wrapping, mobile text sizing, zoom, selection, RTL/LTR, light and dark syntax contrast, and CSS delivery."
+    "Check keyboard focus, uniquely named overflow landmarks, line metadata, bounded scrolling or collapse expansion, long-line scrolling or wrapping, mobile text sizing, zoom, selection, RTL/LTR, light and dark syntax contrast, and CSS delivery."
   ],
   "related": [
     "code",
     "scroll-area",
     "button",
+    "collapsible",
     "tabs",
     "interface-composition"
   ]

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

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

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

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

package/public/packages/brick/{0.1.11 → 0.1.12}/components/color-picker.txt

@@ -1,6 +1,6 @@
 # Color Picker
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: color-picker
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/color-swatch.txt

@@ -1,6 +1,6 @@
 # Color Swatch
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: color-swatch
 

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

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

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

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

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

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

package/public/packages/brick/{0.1.11 → 0.1.12}/components/data-grid.txt

@@ -1,6 +1,6 @@
 # Data Grid
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: data-grid
 

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,107 @@
+# Em
+
+Source: @flowstack-ui/brick@0.1.12
+Kind: component
+ID: em
+
+# Em agent guide
+
+## Purpose
+
+Apply native stress emphasis while preserving the surrounding Brick typography and foreground.
+
+## Use when
+
+- Words in a sentence need semantic stress emphasis that changes the meaning or cadence when spoken.
+
+## Choose something else when
+
+- Text only needs an italic visual treatment without stress emphasis. Use a deliberate application-owned visual recipe.
+- Text needs importance rather than stress emphasis. Use native strong inside the surrounding text owner.
+
+## Required composition
+
+- Keep Em inside the Text, heading, link, or component content owner whose sentence it completes.
+
+## Rules
+
+- **MUST:** Use Em only for native stress emphasis and preserve its one em host; do not select it merely for italic paint.
+- **MUST:** Let Em inherit the surrounding typography and foreground rather than introducing a separate size, tone, or weight recipe.
+- **MUST:** Load styles.css or core.css plus em.css.
+
+## Common mistakes
+
+- **Avoid:** Using Em as a decorative italic label or replacing a sentence-level text owner with Em. **Instead:** Keep Em inside meaningful surrounding copy and use it only when stress emphasis is semantically intended.
+
+## Validation checklist
+
+- Confirm one native em element, inherited metrics and foreground, readable forced colors, normal selection and copy, and no tab stop or role.
+- Check nested sentence flow, localization, zoom, RTL, and CSS delivery.
+
+## Related guidance
+
+- `text`
+- `link`
+- `interface-composition`
+
+## Machine record
+
+```json
+{
+  "schema": "flowstack.agent-component.v1",
+  "id": "em",
+  "name": "Em",
+  "package": "@flowstack-ui/brick",
+  "layer": "brick",
+  "kind": "component",
+  "purpose": "Apply native stress emphasis while preserving the surrounding Brick typography and foreground.",
+  "useWhen": [
+    "Words in a sentence need semantic stress emphasis that changes the meaning or cadence when spoken."
+  ],
+  "avoidWhen": [
+    {
+      "condition": "Text only needs an italic visual treatment without stress emphasis.",
+      "useInstead": "a deliberate application-owned visual recipe"
+    },
+    {
+      "condition": "Text needs importance rather than stress emphasis.",
+      "useInstead": "native strong inside the surrounding text owner"
+    }
+  ],
+  "composition": [
+    "Keep Em inside the Text, heading, link, or component content owner whose sentence it completes."
+  ],
+  "rules": [
+    {
+      "id": "em-native-semantics",
+      "level": "must",
+      "statement": "Use Em only for native stress emphasis and preserve its one em host; do not select it merely for italic paint."
+    },
+    {
+      "id": "em-inheritance",
+      "level": "must",
+      "statement": "Let Em inherit the surrounding typography and foreground rather than introducing a separate size, tone, or weight recipe."
+    },
+    {
+      "id": "em-css",
+      "level": "must",
+      "statement": "Load styles.css or core.css plus em.css."
+    }
+  ],
+  "commonMistakes": [
+    {
+      "mistake": "Using Em as a decorative italic label or replacing a sentence-level text owner with Em.",
+      "correction": "Keep Em inside meaningful surrounding copy and use it only when stress emphasis is semantically intended."
+    }
+  ],
+  "validation": [
+    "Confirm one native em element, inherited metrics and foreground, readable forced colors, normal selection and copy, and no tab stop or role.",
+    "Check nested sentence flow, localization, zoom, RTL, and CSS delivery."
+  ],
+  "related": [
+    "text",
+    "link",
+    "interface-composition"
+  ]
+}
+```

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

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

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

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

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

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

package/public/packages/brick/{0.1.11 → 0.1.12}/components/file-upload.txt

@@ -1,6 +1,6 @@
 # FileUpload
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: file-upload
 

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,127 @@
+# Highlight
+
+Source: @flowstack-ui/brick@0.1.12
+Kind: component
+ID: highlight
+
+# Highlight agent guide
+
+## Purpose
+
+Discover literal queries in plain text through exact Atom behavior and render finished semantic match styling.
+
+## Use when
+
+- One plain text string needs deterministic visible query matches without recreating escaping, overlap, case, or whole-word behavior.
+
+## Choose something else when
+
+- The relevant passage is already selected by the author. Use Mark.
+- Content is arbitrary React nodes or the application needs active result navigation. Use application-owned rich-content traversal or search navigation.
+
+## Required composition
+
+- Pass plain text through text and literal query values through query; keep surrounding sentence typography on Text or another content owner.
+- Let Highlight delegate all matching to Atom and keep search input, active result, counters, and navigation in the application.
+
+## Rules
+
+- **MUST:** Use exact Atom Highlight behavior; do not copy or replace its segmentation, escaping, overlap, or exact-match logic.
+- **MUST:** Use Highlight only for plain text and literal queries, never by flattening or cloning arbitrary React content.
+- **MUST:** Preserve Brick's fixed native span root and Atom-generated native mark matches.
+- **MUST:** Select only the documented subtle, solid, or underline variant and accent or neutral tone.
+- **MUST:** Keep search state, active-result navigation, counts, keyboard commands, and announcements outside Highlight.
+- **MUST:** Load styles.css or core.css plus highlight.css.
+
+## Common mistakes
+
+- **Avoid:** Using Mark or a consumer regular expression to discover query matches. **Instead:** Pass the plain string and literal query to Highlight so exact Atom behavior owns segmentation.
+
+## Validation checklist
+
+- Confirm literal, empty, repeated, overlapping, punctuation, Unicode, case-sensitive, whole-word, and first-match-only inputs preserve original text and copy order.
+- Confirm native span and mark output, closed recipes, forced colors, wrap, zoom, text spacing, localization, RTL, SSR, refs, and CSS delivery without focus or interaction.
+
+## Related guidance
+
+- `mark`
+- `text`
+- `interface-composition`
+
+## Machine record
+
+```json
+{
+  "schema": "flowstack.agent-component.v1",
+  "id": "highlight",
+  "name": "Highlight",
+  "package": "@flowstack-ui/brick",
+  "layer": "brick",
+  "kind": "component",
+  "purpose": "Discover literal queries in plain text through exact Atom behavior and render finished semantic match styling.",
+  "useWhen": [
+    "One plain text string needs deterministic visible query matches without recreating escaping, overlap, case, or whole-word behavior."
+  ],
+  "avoidWhen": [
+    {
+      "condition": "The relevant passage is already selected by the author.",
+      "useInstead": "Mark"
+    },
+    {
+      "condition": "Content is arbitrary React nodes or the application needs active result navigation.",
+      "useInstead": "application-owned rich-content traversal or search navigation"
+    }
+  ],
+  "composition": [
+    "Pass plain text through text and literal query values through query; keep surrounding sentence typography on Text or another content owner.",
+    "Let Highlight delegate all matching to Atom and keep search input, active result, counters, and navigation in the application."
+  ],
+  "rules": [
+    {
+      "id": "highlight-atom",
+      "level": "must",
+      "statement": "Use exact Atom Highlight behavior; do not copy or replace its segmentation, escaping, overlap, or exact-match logic."
+    },
+    {
+      "id": "highlight-plain-text",
+      "level": "must",
+      "statement": "Use Highlight only for plain text and literal queries, never by flattening or cloning arbitrary React content."
+    },
+    {
+      "id": "highlight-native",
+      "level": "must",
+      "statement": "Preserve Brick's fixed native span root and Atom-generated native mark matches."
+    },
+    {
+      "id": "highlight-recipes",
+      "level": "must",
+      "statement": "Select only the documented subtle, solid, or underline variant and accent or neutral tone."
+    },
+    {
+      "id": "highlight-state",
+      "level": "must",
+      "statement": "Keep search state, active-result navigation, counts, keyboard commands, and announcements outside Highlight."
+    },
+    {
+      "id": "highlight-css",
+      "level": "must",
+      "statement": "Load styles.css or core.css plus highlight.css."
+    }
+  ],
+  "commonMistakes": [
+    {
+      "mistake": "Using Mark or a consumer regular expression to discover query matches.",
+      "correction": "Pass the plain string and literal query to Highlight so exact Atom behavior owns segmentation."
+    }
+  ],
+  "validation": [
+    "Confirm literal, empty, repeated, overlapping, punctuation, Unicode, case-sensitive, whole-word, and first-match-only inputs preserve original text and copy order.",
+    "Confirm native span and mark output, closed recipes, forced colors, wrap, zoom, text spacing, localization, RTL, SSR, refs, and CSS delivery without focus or interaction."
+  ],
+  "related": [
+    "mark",
+    "text",
+    "interface-composition"
+  ]
+}
+```

package/public/packages/brick/{0.1.11 → 0.1.12}/components/hover-card.txt

@@ -1,6 +1,6 @@
 # HoverCard
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: hover-card
 

package/public/packages/brick/{0.1.11 → 0.1.12}/components/icon-button.txt

@@ -1,6 +1,6 @@
 # IconButton
 
-Source: @flowstack-ui/brick@0.1.11
+Source: @flowstack-ui/brick@0.1.12
 Kind: component
 ID: icon-button
 

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

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

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

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

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

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