@redsift/ds-mcp-server 12.5.3-alpha.5 → 12.5.3-alpha.7

package/data/docs/components/design-system/Button.json

@@ -398,5 +398,14 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "The `theme` prop is optional — components inherit theme from the nearest ThemeProvider or AppContainer ancestor. Do NOT pass `theme` to every component; wrap the app at the root instead.",
+    "Variants: check with get_component_props — they differ from other UI libraries (no \"primary\", no \"secondary\")."
+  ],
+  "keywords": [
+    "action button",
+    "cta",
+    "submit"
+  ]
 }

package/data/docs/components/design-system/Card.json

@@ -324,5 +324,19 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Card only accepts Card.Header, Card.Body, and Card.Actions as children. Other elements are silently ignored.",
+    "Card.Header has a fixed design. Use Card.Body for content and Card.Actions for button rows.",
+    "For collapsible cards, pass `isCollapsible` to Card. Use `isCollapsed`/`onCollapse` for controlled mode, or `defaultCollapsed` for uncontrolled."
+  ],
+  "disambiguation": "Card is a generic container with Header/Body/Actions. Do NOT use for KPI/metric tiles — use DataCard from @redsift/dashboard instead.",
+  "antiPatterns": [
+    "❌ Using Card with inline styles for KPI tiles → ✅ Use DataCard from @redsift/dashboard for metric/KPI tiles."
+  ],
+  "keywords": [
+    "container",
+    "card panel",
+    "content card"
+  ]
 }

package/data/docs/components/design-system/CardActions.json

@@ -427,5 +427,12 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Must be a direct child of <Card>."
+  ],
+  "keywords": [
+    "card footer",
+    "card buttons"
+  ]
 }

package/data/docs/components/design-system/CardBody.json

@@ -427,5 +427,11 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Must be a direct child of <Card>."
+  ],
+  "keywords": [
+    "card content"
+  ]
 }

package/data/docs/components/design-system/CardHeader.json

@@ -424,5 +424,12 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Must be a direct child of <Card>."
+  ],
+  "keywords": [
+    "card title",
+    "card heading"
+  ]
 }

package/data/docs/components/design-system/DetailedCard.json

@@ -397,5 +397,16 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Content children (after DetailedCard.Header) must be DetailedCard.Section components. Other elements will not receive collapse/expand state injection via cloneElement.",
+    "DetailedCard.Header is extracted via partitionComponents — it must be a direct child, not wrapped.",
+    "DetailedCard.CollapsibleSectionItems must be a child of DetailedCard.Section for auto-detection of collapsible state."
+  ],
+  "disambiguation": "DetailedCard is a complex card with collapsible sections. Use for rich detail panels, not KPI tiles. For KPI tiles use DataCard from @redsift/dashboard.",
+  "keywords": [
+    "expandable card",
+    "collapsible card",
+    "detail panel"
+  ]
 }

package/data/docs/components/design-system/DetailedCardHeader.json

@@ -33,5 +33,8 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Must be a direct child of <DetailedCard>."
+  ]
 }

package/data/docs/components/design-system/DetailedCardSection.json

@@ -86,5 +86,8 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Must be a direct child of <DetailedCard>. Do not wrap in a <div> — the parent injects `isCollapsed` and `theme` via cloneElement."
+  ]
 }

package/data/docs/components/design-system/Flexbox.json

@@ -519,5 +519,18 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "antiPatterns": [
+    "❌ gap={4} → ✅ gap=\"4px\" — gap is a string prop (CSS value), not a number.",
+    "❌ style={{ display: \"flex\", gap: 4 }} → ✅ <Flexbox gap=\"4px\"> — use the Flexbox component instead of inline styles."
+  ],
+  "keywords": [
+    "flex container",
+    "row",
+    "column",
+    "stack",
+    "box",
+    "hstack",
+    "vstack"
+  ]
 }

package/data/docs/components/design-system/Grid.json

@@ -539,5 +539,10 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "keywords": [
+    "grid layout",
+    "css grid",
+    "grid container"
+  ]
 }

package/data/docs/components/design-system/Heading.json

@@ -386,5 +386,20 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "The `theme` prop is optional — inherited from context. Do NOT pass `theme` to every component.",
+    "Valid `color` values come from NeutralColorPalette (\"black\", \"x-dark-grey\", \"dark-grey\", \"mid-grey\", \"light-grey\", \"x-light-grey\", \"white\") and NotificationsColorPalette (\"error\", \"warning\", \"success\", \"info\", \"question\", \"no-data\"). You can also pass hex/rgb strings."
+  ],
+  "antiPatterns": [
+    "❌ color=\"#22c55e\" or color=\"var(--rs-color-green-500)\" → ✅ color=\"success\" — use semantic color values from NeutralColorPalette / NotificationsColorPalette."
+  ],
+  "keywords": [
+    "title",
+    "header text",
+    "section heading",
+    "h1",
+    "h2",
+    "h3"
+  ]
 }

package/data/docs/components/design-system/Icon.json

@@ -321,5 +321,10 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "disambiguation": "Icon renders an SVG icon from a path string. Always import mdi* icons from @redsift/icons. NEVER use unicode glyphs (✓, ✕, ⚠, ›) and NEVER import from @mdi/js.",
+  "antiPatterns": [
+    "❌ Unicode characters (✓, ✕, ⚠, ›) → ✅ <Icon path={mdiCheck} /> from @redsift/icons.",
+    "❌ import { mdiPlus } from \"@mdi/js\" → ✅ import { mdiPlus } from \"@redsift/icons\"."
+  ]
 }

package/data/docs/components/design-system/IconButton.json

@@ -367,5 +367,18 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "The `theme` prop is optional — inherited from context. Do NOT pass `theme` to every component.",
+    "Requires `icon` prop (SVG path string from @redsift/icons). Import icons from @redsift/icons, not @mdi/js."
+  ],
+  "disambiguation": "IconButton renders a clickable icon. Requires icon prop (SVG path string). Import icons from @redsift/icons, not @mdi/js.",
+  "antiPatterns": [
+    "❌ Unicode characters as icon content → ✅ icon={mdiPlus} prop with mdi imports from @redsift/icons.",
+    "❌ import { mdiPlus } from \"@mdi/js\" → ✅ import { mdiPlus } from \"@redsift/icons\"."
+  ],
+  "keywords": [
+    "icon action",
+    "toolbar button"
+  ]
 }

package/data/docs/components/design-system/Pill.json

@@ -374,5 +374,19 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Content via `children`, NOT a `label` prop. Usage: `<Pill color=\"blue\" size=\"small\">Active</Pill>`",
+    "The `theme` prop is optional — inherited from context."
+  ],
+  "antiPatterns": [
+    "❌ <Pill label=\"Active\" /> → ✅ <Pill color=\"success\">Active</Pill> — Pill uses children for content, NOT a label prop."
+  ],
+  "keywords": [
+    "chip",
+    "tag",
+    "badge",
+    "label",
+    "status pill"
+  ]
 }

package/data/docs/components/design-system/Skeleton.json

@@ -334,5 +334,14 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "disambiguation": "Always use Skeleton from @redsift/design-system. NEVER import Skeleton from @mui/material — it will not match the DS theme.",
+  "antiPatterns": [
+    "❌ import { Skeleton } from \"@mui/material\" → ✅ import { Skeleton } from \"@redsift/design-system\" — always use the DS Skeleton."
+  ],
+  "keywords": [
+    "loading placeholder",
+    "shimmer",
+    "skeleton loader"
+  ]
 }

package/data/docs/components/design-system/SkeletonCircle.json

@@ -334,5 +334,10 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "disambiguation": "Use SkeletonCircle from @redsift/design-system for avatar/icon-shaped loading placeholders.",
+  "keywords": [
+    "avatar placeholder",
+    "circle skeleton"
+  ]
 }

package/data/docs/components/design-system/SkeletonText.json

@@ -367,5 +367,10 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "disambiguation": "Use SkeletonText from @redsift/design-system for paragraph-shaped loading placeholders.",
+  "keywords": [
+    "text placeholder",
+    "paragraph skeleton"
+  ]
 }

package/data/docs/components/design-system/Tab.json

@@ -525,5 +525,13 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Must be a child of <Tabs>. Requires TabsContext — rendering outside <Tabs> will silently fail (no selection, no keyboard navigation).",
+    "Always provide a `value` prop that matches a corresponding TabPanel."
+  ],
+  "keywords": [
+    "tab item",
+    "tab button"
+  ]
 }

package/data/docs/components/design-system/TabPanel.json

@@ -291,5 +291,14 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Must be used within a <Tabs> provider. Requires TabsContext — rendering outside <Tabs> will silently fail (panel never shown).",
+    "The `value` prop must match a corresponding Tab `value`.",
+    "Use `keepMounted` to keep panel content in DOM when inactive (useful for preserving form state)."
+  ],
+  "keywords": [
+    "tab content",
+    "tab panel"
+  ]
 }

package/data/docs/components/design-system/Tabs.json

@@ -354,5 +354,16 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Accepts <Tab> and <TabPanel> children. Tabs must have a `value` prop that matches a TabPanel `value`.",
+    "For navigation tabs, use the `as` prop on Tab (e.g. as=\"a\" href=\"/path\") instead of onClick.",
+    "Supports controlled (`value`/`onChange`) and uncontrolled (`defaultValue`) modes."
+  ],
+  "keywords": [
+    "tab bar",
+    "segmented control",
+    "tab navigation",
+    "tab group"
+  ]
 }

package/data/docs/components/design-system/Text.json

@@ -414,5 +414,18 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "The `theme` prop is optional — inherited from context. Do NOT pass `theme` to every component.",
+    "The `slot` prop is NOT supported. Do not pass slot=\"heading\" or similar — use Heading component or compound sub-component API instead."
+  ],
+  "antiPatterns": [
+    "❌ color=\"#22c55e\" or color=\"var(--rs-color-green-500)\" → ✅ color=\"success\" — use semantic color values from NeutralColorPalette / NotificationsColorPalette."
+  ],
+  "keywords": [
+    "paragraph",
+    "body text",
+    "caption",
+    "label text"
+  ]
 }

package/data/docs/components/design-system/TextField.json

@@ -535,5 +535,10 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "keywords": [
+    "text input",
+    "input field",
+    "form input"
+  ]
 }

package/data/docs/components/pickers/Combobox.json

@@ -316,5 +316,16 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Must use compound sub-components: <Combobox.Trigger> and <Combobox.Content>.",
+    "Combobox.Trigger requires a TextField or TextArea as its child. Custom inputs must forward refs correctly or focus management will break.",
+    "Combobox.Content accepts ComboboxContent.Header, .Listbox, and .Footer as children."
+  ],
+  "keywords": [
+    "autocomplete",
+    "searchable select",
+    "typeahead",
+    "search input"
+  ]
 }

package/data/docs/components/pickers/ComboboxContent.json

@@ -449,5 +449,10 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Only accepts ComboboxContent.Header, ComboboxContent.Listbox, and ComboboxContent.Footer as children. Other elements are silently ignored.",
+    "Children are reordered internally (Header → Listbox → Footer) regardless of JSX order.",
+    "Must be used inside a <Combobox> — requires popover and combobox context."
+  ]
 }

package/data/docs/components/pickers/MenuButton.json

@@ -236,5 +236,14 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Must use compound sub-components: <MenuButton.Trigger> and <MenuButton.Content>.",
+    "MenuButton.Content accepts MenuButtonContent.Header, .Menu, and .Footer or plain Menu items."
+  ],
+  "keywords": [
+    "dropdown menu",
+    "action menu",
+    "context menu"
+  ]
 }

package/data/docs/components/pickers/MenuButtonContent.json

@@ -438,5 +438,9 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Only accepts MenuButtonContent.Header, MenuButtonContent.Menu, and MenuButtonContent.Footer as children. If none are provided, all children are wrapped in a Menu automatically.",
+    "Must be used inside a <MenuButton> — requires popover and menu button context."
+  ]
 }

package/data/docs/components/pickers/Select.json

@@ -254,5 +254,15 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Must use compound sub-components: <Select.Trigger> and <Select.Content>.",
+    "Select.Content accepts <Item> components as children for options.",
+    "For searchable/filterable lists, use Combobox instead of Select."
+  ],
+  "keywords": [
+    "dropdown",
+    "select menu",
+    "picker"
+  ]
 }

package/data/docs/components/popovers/Dialog.json

@@ -110,5 +110,14 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Must use compound sub-components: <Dialog.Trigger>, <Dialog.Content>, <Dialog.Title>, etc. Do not pass content as a string prop."
+  ],
+  "keywords": [
+    "modal",
+    "popup",
+    "dialog box",
+    "confirmation dialog"
+  ]
 }

package/data/docs/components/popovers/Toggletip.json

@@ -180,5 +180,15 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Must use compound sub-components: <Toggletip.Trigger> and <Toggletip.Content>.",
+    "Trigger and Content sub-components must not be used outside <Toggletip> — they throw if ToggletipContext is missing.",
+    "Use Toggletip instead of Tooltip when content should be triggered by click (not hover) for touch/keyboard accessibility."
+  ],
+  "keywords": [
+    "click tooltip",
+    "info popover",
+    "toggleable tip"
+  ]
 }

package/data/docs/components/popovers/Tooltip.json

@@ -117,5 +117,13 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "usageRules": [
+    "Must use compound sub-components: <Tooltip.Trigger> and <Tooltip.Content>. Do not pass content as a string prop.",
+    "Trigger and Content sub-components must not be used outside <Tooltip> — they throw if TooltipContext is missing."
+  ],
+  "keywords": [
+    "hover tip",
+    "info tooltip"
+  ]
 }

package/data/docs/components/table/DataGrid.json

@@ -89,5 +89,13 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "keywords": [
+    "data grid",
+    "data table",
+    "table",
+    "grid view",
+    "list view",
+    "spreadsheet"
+  ]
 }

package/data/docs/components/table/StatefulDataGrid.json

@@ -113,5 +113,10 @@
     }
   ],
   "examples": [],
-  "tags": {}
+  "tags": {},
+  "keywords": [
+    "stateful table",
+    "managed grid",
+    "server grid"
+  ]
 }