@hex-core/components 1.4.0 → 1.5.0

package/dist/schemas.js

@@ -4638,6 +4638,854 @@ var sidebarSchema = {
   tags: ["sidebar", "navigation", "app-shell", "layout"]
 };
 
-export { accordionSchema, alertDialogSchema, alertSchema, aspectRatioSchema, avatarSchema, badgeSchema, breadcrumbSchema, buttonSchema, calendarSchema, cardSchema, checkboxSchema, clusterSchema, collapsibleSchema, colorPickerSchema, comboboxSchema, commandSchema, containerSchema, contextMenuSchema, dataTableSchema, datePickerSchema, dialogSchema, drawerSchema, dropdownMenuSchema, dropzoneSchema, fileTreeSchema, formSchema, gridSchema, hoverCardSchema, inputOTPSchema, inputSchema, labelSchema, menubarSchema, multiComboboxSchema, navigationMenuSchema, paginationSchema, popoverSchema, progressSchema, radioGroupSchema, resizableSchema, scrollAreaSchema, selectSchema, separatorSchema, sheetSchema, sidebarSchema, skeletonSchema, sliderSchema, sonnerSchema, spacerSchema, stackSchema, stepperSchema, switchSchema, tableSchema, tabsSchema, textareaSchema, timePickerSchema, timelineSchema, toggleGroupSchema, toggleSchema, tooltipSchema };
+// src/ai/message/message.schema.ts
+var messageSchema = {
+  name: "message",
+  displayName: "Message",
+  description: "Single chat-message row scoped to one speaker (user / assistant / system / tool). Headless content slot \u2014 pair with Markdown, CodeBlock, or ToolCall children.",
+  category: "ai",
+  subcategory: "chat",
+  props: [
+    {
+      name: "role",
+      type: "enum",
+      required: true,
+      description: "Speaker. Drives variant styling and the data-role attribute.",
+      enumValues: ["user", "assistant", "system", "tool"]
+    },
+    {
+      name: "children",
+      type: "ReactNode",
+      required: true,
+      description: "Message content. Strings, Markdown, CodeBlock, ToolCall, or any composition."
+    },
+    {
+      name: "className",
+      type: "string",
+      required: false,
+      description: "Additional CSS classes merged onto the row."
+    }
+  ],
+  variants: [
+    {
+      name: "role",
+      description: "Visual treatment per speaker.",
+      values: [
+        { value: "user", description: "Tinted secondary background \u2014 user turns.", useWhen: "The author is the human." },
+        { value: "assistant", description: "Card background \u2014 model output.", useWhen: "The author is the LLM/agent." },
+        { value: "system", description: "Muted, italic \u2014 system instructions.", useWhen: "Rendering a visible system prompt or framing message." },
+        { value: "tool", description: "Accent left-border \u2014 tool messages distinct from assistant text.", useWhen: "Showing raw tool/function output as its own turn." }
+      ],
+      default: "assistant"
+    }
+  ],
+  slots: [
+    {
+      name: "children",
+      description: "Message body. Compose with Markdown, CodeBlock, ToolCall, or plain text.",
+      required: true,
+      acceptedTypes: ["ReactNode"]
+    }
+  ],
+  dependencies: {
+    npm: ["class-variance-authority", "clsx", "tailwind-merge"],
+    internal: ["lib/utils", "ai/types"],
+    peer: ["react", "react-dom"]
+  },
+  tokensUsed: ["secondary", "foreground", "card", "card-foreground", "muted", "muted-foreground", "accent", "accent-foreground"],
+  examples: [
+    {
+      title: "User and assistant turns",
+      description: "Two messages alternating roles.",
+      code: `<>
+  <Message role="user">What's the capital of France?</Message>
+  <Message role="assistant">Paris.</Message>
+</>`,
+      composition: ["chat", "turns"]
+    },
+    {
+      title: "Composed assistant turn",
+      description: "Markdown + ToolCall inside one assistant message.",
+      code: '<Message role="assistant">\n  <Markdown>{response}</Markdown>\n  <ToolCall name="search" state="result" result={hits} />\n</Message>',
+      composition: ["chat", "agent", "tool-use"]
+    }
+  ],
+  ai: {
+    whenToUse: "Wrap every conversation turn \u2014 user, assistant, system, or tool. Pair with MessageList for the scrolling viewport. Compose Markdown, CodeBlock, and ToolCall as children for rich assistant turns.",
+    whenNotToUse: "Don't use for non-conversational text (use Card or plain elements). Don't put streaming logic here \u2014 the consumer drives state, Message just renders.",
+    commonMistakes: [
+      "Adding streaming/fetch logic inside Message \u2014 keep it pure",
+      'Using `role="tool"` for assistant text that mentions a tool \u2014 `tool` is for the actual tool turn',
+      "Hard-coding markdown rendering inside Message \u2014 pass <Markdown>{...}</Markdown> as a child instead"
+    ],
+    relatedComponents: ["message-list", "markdown", "code-block", "tool-call", "message-actions"],
+    accessibilityNotes: 'Renders as a div with `data-role`. For screen-reader chat semantics, wrap MessageList in `role="log"` and consider `aria-live="polite"` on the streaming container.',
+    tokenBudget: 220
+  },
+  tags: ["ai", "chat", "message", "turn", "conversation"]
+};
+
+// src/ai/message-list/message-list.schema.ts
+var messageListSchema = {
+  name: "message-list",
+  displayName: "MessageList",
+  description: "Auto-scrolling viewport for a chat stream. Pins to the bottom during streaming unless the user scrolls up to read history.",
+  category: "ai",
+  subcategory: "chat",
+  props: [
+    {
+      name: "autoScroll",
+      type: "boolean",
+      required: false,
+      default: true,
+      description: "Pin to bottom on content change (when the user is already near the bottom)."
+    },
+    {
+      name: "children",
+      type: "ReactNode",
+      required: true,
+      description: "Sequence of <Message> elements."
+    },
+    {
+      name: "className",
+      type: "string",
+      required: false,
+      description: "Additional CSS classes (e.g. height, padding)."
+    }
+  ],
+  variants: [],
+  slots: [
+    {
+      name: "children",
+      description: "Messages to render in order.",
+      required: true,
+      acceptedTypes: ["ReactNode"]
+    }
+  ],
+  dependencies: {
+    npm: ["clsx", "tailwind-merge"],
+    internal: ["lib/utils"],
+    peer: ["react", "react-dom"]
+  },
+  tokensUsed: [],
+  examples: [
+    {
+      title: "Basic chat",
+      description: "Map messages from useChat into a viewport with bottom-pin behavior.",
+      code: '<MessageList className="h-96">\n  {messages.map((m) => (\n    <Message key={m.id} role={m.role}>{m.content}</Message>\n  ))}\n</MessageList>',
+      composition: ["chat", "scroll"]
+    }
+  ],
+  ai: {
+    whenToUse: "Wrap a list of <Message> components when you want auto-scroll-on-stream behavior. Always set an explicit height (h-*, max-h-*) on the className so the viewport actually scrolls.",
+    whenNotToUse: "Don't use for static FAQs or non-streaming layouts (use a normal Stack). Don't use as a generic scroll container \u2014 its bottom-pin behavior is opinionated.",
+    commonMistakes: [
+      "Forgetting to set a height \u2014 the viewport won't scroll without `h-*` or `max-h-*`",
+      "Disabling autoScroll while still expecting bottom-pin behavior \u2014 they're the same flag",
+      "Putting non-Message children inside \u2014 a divider or banner breaks the role=log semantics"
+    ],
+    relatedComponents: ["message", "composer", "loading-indicator"],
+    accessibilityNotes: 'Renders as `role="log"` with `aria-live="polite"` and `aria-relevant="additions"` so assistive tech announces new turns. If you replace turns wholesale (e.g. on regenerate), pass `aria-relevant="additions removals"` as a prop \u2014 props spread onto the underlying div and override the default.',
+    tokenBudget: 240
+  },
+  tags: ["ai", "chat", "scroll", "viewport", "streaming"]
+};
+
+// src/ai/composer/composer.schema.ts
+var composerSchema = {
+  name: "composer",
+  displayName: "Composer",
+  description: "Multi-line input + submission shell for chat. Submits on Enter (Shift+Enter inserts newline). Trailing slot for attachment + send buttons.",
+  category: "ai",
+  subcategory: "input",
+  props: [
+    {
+      name: "value",
+      type: "string",
+      required: true,
+      description: "Controlled textarea value."
+    },
+    {
+      name: "onValueChange",
+      type: "function",
+      required: true,
+      description: "Called with the new value on each keystroke."
+    },
+    {
+      name: "onSubmit",
+      type: "function",
+      required: true,
+      description: "Called with the trimmed value on Enter or form submit."
+    },
+    {
+      name: "disabled",
+      type: "boolean",
+      required: false,
+      default: false,
+      description: "Lock the input and suppress submission (e.g. during streaming)."
+    },
+    {
+      name: "placeholder",
+      type: "string",
+      required: false,
+      description: "Textarea placeholder copy."
+    },
+    {
+      name: "submitOnEnter",
+      type: "boolean",
+      required: false,
+      default: true,
+      description: "Submit when Enter is pressed without Shift. Disable to require button click."
+    },
+    {
+      name: "children",
+      type: "ReactNode",
+      required: false,
+      description: "Trailing slot \u2014 attachment buttons, voice toggle, send button, etc."
+    },
+    {
+      name: "className",
+      type: "string",
+      required: false,
+      description: "Additional CSS classes on the form wrapper."
+    }
+  ],
+  variants: [],
+  slots: [
+    {
+      name: "children",
+      description: "Trailing action buttons rendered after the textarea.",
+      required: false,
+      acceptedTypes: ["ReactNode"]
+    }
+  ],
+  dependencies: {
+    npm: ["clsx", "tailwind-merge"],
+    internal: ["lib/utils"],
+    peer: ["react", "react-dom"]
+  },
+  tokensUsed: ["background", "ring", "muted-foreground"],
+  examples: [
+    {
+      title: "Basic composer",
+      description: "Controlled input + send button.",
+      code: 'const [value, setValue] = useState("");\n<Composer\n  value={value}\n  onValueChange={setValue}\n  onSubmit={(v) => { send(v); setValue(""); }}\n  placeholder="Ask anything\u2026"\n>\n  <Button type="submit" disabled={!value.trim()}>Send</Button>\n</Composer>',
+      composition: ["chat", "form"]
+    },
+    {
+      title: "With attachment slot",
+      description: "Attach button on the leading edge of the trailing slot.",
+      code: '<Composer value={v} onValueChange={setV} onSubmit={send}>\n  <Button variant="ghost" size="icon" onClick={pickFile}><Paperclip /></Button>\n  <Button type="submit">Send</Button>\n</Composer>',
+      composition: ["chat", "form", "attachment"]
+    }
+  ],
+  ai: {
+    whenToUse: "Wrap any user-input surface in an AI app \u2014 chatbots, AI editors, agent prompts. Pair with `useChat` from @ai-sdk/react or any equivalent state hook.",
+    whenNotToUse: "Don't use for non-chat forms (use Form + Textarea). Don't bake fetch/streaming logic into onSubmit \u2014 keep the network call in the consumer.",
+    commonMistakes: [
+      "Calling onSubmit with the raw event instead of the value \u2014 onSubmit receives the trimmed string already",
+      "Forgetting to clear `value` after submit \u2014 Composer is fully controlled",
+      "Wrapping the component in <form> \u2014 Composer renders its own form element"
+    ],
+    relatedComponents: ["message-list", "suggestion", "loading-indicator"],
+    accessibilityNotes: "Renders a real <form> + <textarea>, so Enter submission and screen-reader announcements work without extra ARIA. Pass `aria-label` on the wrapper if there's no visible label.",
+    tokenBudget: 280
+  },
+  tags: ["ai", "input", "chat", "form", "composer", "textarea"]
+};
+
+// src/ai/loading-indicator/loading-indicator.schema.ts
+var loadingIndicatorSchema = {
+  name: "loading-indicator",
+  displayName: "LoadingIndicator",
+  description: "Streaming/typing feedback with three motion variants \u2014 dots, pulse, bar.",
+  category: "ai",
+  subcategory: "feedback",
+  props: [
+    {
+      name: "variant",
+      type: "enum",
+      required: false,
+      default: "dots",
+      description: "Animation style.",
+      enumValues: ["dots", "pulse", "bar"]
+    },
+    {
+      name: "size",
+      type: "enum",
+      required: false,
+      default: "md",
+      description: "Text/icon scale.",
+      enumValues: ["sm", "md"]
+    },
+    {
+      name: "label",
+      type: "string",
+      required: false,
+      description: 'Optional adjacent text label (e.g. "Thinking\u2026").'
+    },
+    {
+      name: "className",
+      type: "string",
+      required: false,
+      description: "Additional CSS classes."
+    }
+  ],
+  variants: [
+    {
+      name: "variant",
+      description: "Motion style.",
+      values: [
+        { value: "dots", description: "Three bouncing dots \u2014 classic typing indicator.", useWhen: "You want a familiar chat-style loading affordance." },
+        { value: "pulse", description: "Single throbbing circle \u2014 minimal.", useWhen: "Tight inline space; one-character signal." },
+        { value: "bar", description: "Horizontal sweep \u2014 implies progress without claiming a percentage.", useWhen: "Longer-running task (search, retrieval) where dots feel too perpetual." }
+      ],
+      default: "dots"
+    }
+  ],
+  slots: [],
+  dependencies: {
+    npm: ["class-variance-authority", "clsx", "tailwind-merge"],
+    internal: ["lib/utils"],
+    peer: ["react", "react-dom"]
+  },
+  tokensUsed: ["muted-foreground"],
+  examples: [
+    {
+      title: "Inline typing dots",
+      description: "Render while waiting for the first token.",
+      code: '{isLoading && <LoadingIndicator label="Thinking\u2026" />}',
+      composition: ["chat", "loading"]
+    }
+  ],
+  ai: {
+    whenToUse: "Show during the gap between submitting a prompt and the first streamed token, or while a long-running tool call is in flight.",
+    whenNotToUse: "Don't use for known-percent progress (use Progress). Don't keep visible after the first token streams in \u2014 stream itself signals activity.",
+    commonMistakes: [
+      "Leaving the indicator visible while content streams \u2014 overlap looks broken",
+      "Using `bar` for sub-second waits \u2014 the sweep can't complete a cycle"
+    ],
+    relatedComponents: ["message", "composer"],
+    accessibilityNotes: 'Renders as `role="status"` with `aria-live="polite"` and an `aria-label`. Pass a meaningful label so screen readers announce "Searching docs" rather than the default "Loading".',
+    tokenBudget: 200
+  },
+  tags: ["ai", "loading", "spinner", "typing", "indicator", "streaming"]
+};
+
+// src/ai/suggestion/suggestion.schema.ts
+var suggestionSchema = {
+  name: "suggestion",
+  displayName: "Suggestion",
+  description: "Clickable prompt pill / quick-action chip. Forwards a payload to onSelect on click.",
+  category: "ai",
+  subcategory: "input",
+  props: [
+    {
+      name: "value",
+      type: "string",
+      required: false,
+      description: "Payload sent to onSelect. Defaults to the rendered children when they are a string."
+    },
+    {
+      name: "onSelect",
+      type: "function",
+      required: true,
+      description: "Called with the payload when the chip is clicked."
+    },
+    {
+      name: "children",
+      type: "ReactNode",
+      required: true,
+      description: "Visible label."
+    },
+    {
+      name: "className",
+      type: "string",
+      required: false,
+      description: "Additional CSS classes."
+    }
+  ],
+  variants: [],
+  slots: [
+    {
+      name: "children",
+      description: "Visible label of the chip.",
+      required: true,
+      acceptedTypes: ["ReactNode"]
+    }
+  ],
+  dependencies: {
+    npm: ["clsx", "tailwind-merge"],
+    internal: ["lib/utils"],
+    peer: ["react", "react-dom"]
+  },
+  tokensUsed: ["background", "secondary", "ring", "foreground"],
+  examples: [
+    {
+      title: "Starter prompts",
+      description: "Render onboarding suggestions and drop into the composer on click.",
+      code: '<Cluster gap="sm">\n  {STARTERS.map((s) => (\n    <Suggestion key={s} value={s} onSelect={setInput}>{s}</Suggestion>\n  ))}\n</Cluster>',
+      composition: ["chat", "onboarding", "prompts"]
+    }
+  ],
+  ai: {
+    whenToUse: "Show 3\u20136 starter prompts before the first turn, or follow-up prompts after an assistant turn. Combine with Cluster for wrap-friendly layout.",
+    whenNotToUse: "Don't use for navigation (use Button or a link). Don't auto-send on click without showing the user what's about to be sent \u2014 set the value into Composer first.",
+    commonMistakes: [
+      "Auto-firing onSelect into useChat.append without populating the input first \u2014 feels surprising",
+      "Long labels \u2014 these are pills, keep under ~40 chars"
+    ],
+    relatedComponents: ["composer", "cluster", "button"],
+    accessibilityNotes: "Real <button>, so keyboard activation and screen-reader announcement work natively. If the label is non-text, set `aria-label`.",
+    tokenBudget: 220
+  },
+  tags: ["ai", "suggestion", "prompt", "pill", "chip", "quick-action"]
+};
+
+// src/ai/tool-call/tool-call.schema.ts
+var toolCallSchema = {
+  name: "tool-call",
+  displayName: "ToolCall",
+  description: "Collapsible card showing a tool/function invocation \u2014 name, lifecycle state badge, expandable args + result body.",
+  category: "ai",
+  subcategory: "agent",
+  props: [
+    {
+      name: "name",
+      type: "string",
+      required: true,
+      description: "Tool / function name (e.g. searchDocs, getWeather)."
+    },
+    {
+      name: "state",
+      type: "enum",
+      required: true,
+      description: "Lifecycle of the invocation.",
+      enumValues: ["pending", "running", "result", "error"]
+    },
+    {
+      name: "args",
+      type: "object",
+      required: false,
+      description: "JSON-stringifiable input passed to the tool."
+    },
+    {
+      name: "result",
+      type: "object",
+      required: false,
+      description: "JSON-stringifiable output returned by the tool. May be a string for plain-text results."
+    },
+    {
+      name: "defaultOpen",
+      type: "boolean",
+      required: false,
+      default: false,
+      description: "Start expanded. Default collapsed to keep the chat clean."
+    },
+    {
+      name: "className",
+      type: "string",
+      required: false,
+      description: "Additional CSS classes on the outer Collapsible root."
+    }
+  ],
+  variants: [],
+  slots: [],
+  dependencies: {
+    npm: ["@radix-ui/react-collapsible", "clsx", "tailwind-merge"],
+    internal: ["lib/utils", "ai/types"],
+    peer: ["react", "react-dom"]
+  },
+  tokensUsed: ["card", "card-foreground", "muted", "muted-foreground", "primary", "accent", "accent-foreground", "destructive", "ring", "background"],
+  examples: [
+    {
+      title: "Done invocation",
+      description: "Map an AI SDK `tool-*` part to a ToolCall.",
+      code: '<ToolCall\n  name="searchDocs"\n  state="result"\n  args={{ query: "auth" }}\n  result={{ hits: docs.length }}\n/>',
+      composition: ["agent", "tool-use"]
+    },
+    {
+      title: "Streaming run",
+      description: "While the tool is executing, show running state without args.",
+      code: '<ToolCall name="getWeather" state="running" args={{ city: "NYC" }} />',
+      composition: ["agent", "tool-use", "streaming"]
+    }
+  ],
+  ai: {
+    whenToUse: "Render every tool/function invocation in an agent UI. Map AI SDK v5 `tool-TOOLNAME` parts (state: input-streaming|input-available|output-available|output-error) or LangChain `AIMessage.tool_calls` directly.",
+    whenNotToUse: "Don't use for plain assistant text (use Message). Don't render the tool's actual UI here \u2014 ToolCall is a debug/transparency card; for a rich tool UI, render that as a sibling node inside the Message.",
+    commonMistakes: [
+      "Passing the entire AI SDK part object as `result` \u2014 extract the output payload first",
+      "Setting `defaultOpen` for every call \u2014 quickly clutters the chat",
+      'Using `state="result"` for an error \u2014 use `error` so the user sees red'
+    ],
+    relatedComponents: ["message", "reasoning", "loading-indicator"],
+    accessibilityNotes: "Built on Radix Collapsible \u2014 keyboard expand/collapse with Enter/Space works natively. Add `aria-label` on the trigger if the tool name is opaque.",
+    tokenBudget: 320
+  },
+  tags: ["ai", "agent", "tool-call", "function-call", "collapsible", "transparency"]
+};
+
+// src/ai/reasoning/reasoning.schema.ts
+var reasoningSchema = {
+  name: "reasoning",
+  displayName: "Reasoning",
+  description: "Collapsible thinking-trace block for Anthropic-style reasoning or chain-of-thought scratchpads. Optional duration in the header.",
+  category: "ai",
+  subcategory: "agent",
+  props: [
+    {
+      name: "children",
+      type: "ReactNode",
+      required: true,
+      description: "Reasoning content. Wrap with Markdown for formatted thinking traces."
+    },
+    {
+      name: "defaultOpen",
+      type: "boolean",
+      required: false,
+      default: false,
+      description: "Start expanded. Default collapsed."
+    },
+    {
+      name: "durationMs",
+      type: "number",
+      required: false,
+      description: 'Time spent thinking in ms \u2014 renders "Thought for 4.2s" in the header.'
+    },
+    {
+      name: "label",
+      type: "string",
+      required: false,
+      description: "Override the default header label."
+    },
+    {
+      name: "className",
+      type: "string",
+      required: false,
+      description: "Additional CSS classes."
+    }
+  ],
+  variants: [],
+  slots: [
+    {
+      name: "children",
+      description: "Reasoning trace body.",
+      required: true,
+      acceptedTypes: ["ReactNode"]
+    }
+  ],
+  dependencies: {
+    npm: ["@radix-ui/react-collapsible", "clsx", "tailwind-merge"],
+    internal: ["lib/utils"],
+    peer: ["react", "react-dom"]
+  },
+  tokensUsed: ["foreground", "muted", "muted-foreground", "ring"],
+  examples: [
+    {
+      title: "Thinking trace with duration",
+      description: 'Header reads "Thought for 4.2s" \u2014 body reveals the full trace on click.',
+      code: "<Reasoning durationMs={4200}>\n  <Markdown>{thinkingMarkdown}</Markdown>\n</Reasoning>",
+      composition: ["agent", "reasoning", "anthropic"]
+    }
+  ],
+  ai: {
+    whenToUse: "Render Anthropic `thinking` blocks, chain-of-thought scratchpads, or any model-internal reasoning the user can optionally inspect.",
+    whenNotToUse: "Don't use for the assistant's actual answer (use Message). Don't auto-open for routine turns \u2014 only worth expanding for debug or trust-building UX.",
+    commonMistakes: [
+      "Showing reasoning that wasn't actually produced \u2014 fabricating thinking blocks erodes trust",
+      "`durationMs` measured from request start instead of model thinking time \u2014 use the model's reported duration when available"
+    ],
+    relatedComponents: ["message", "tool-call", "markdown"],
+    accessibilityNotes: "Radix Collapsible \u2014 keyboard expand/collapse via Enter/Space. The italic header is decorative; use the visible label for screen readers.",
+    tokenBudget: 280
+  },
+  tags: ["ai", "agent", "reasoning", "thinking", "chain-of-thought", "collapsible"]
+};
+
+// src/ai/message-actions/message-actions.schema.ts
+var messageActionsSchema = {
+  name: "message-actions",
+  displayName: "MessageActions",
+  description: "Inline action-button row beneath a message \u2014 copy, regenerate, thumbs-up/down. Pure container; consumer supplies the buttons + handlers.",
+  category: "ai",
+  subcategory: "chat",
+  props: [
+    {
+      name: "children",
+      type: "ReactNode",
+      required: true,
+      description: 'Action buttons (typically Button variant="ghost" size="icon").'
+    },
+    {
+      name: "className",
+      type: "string",
+      required: false,
+      description: "Additional CSS classes."
+    }
+  ],
+  variants: [],
+  slots: [
+    {
+      name: "children",
+      description: "Action buttons rendered in a horizontal row.",
+      required: true,
+      acceptedTypes: ["ReactNode"]
+    }
+  ],
+  dependencies: {
+    npm: ["clsx", "tailwind-merge"],
+    internal: ["lib/utils"],
+    peer: ["react", "react-dom"]
+  },
+  tokensUsed: [],
+  examples: [
+    {
+      title: "Copy + regenerate",
+      description: "Two ghost icon buttons under an assistant message.",
+      code: '<MessageActions>\n  <Button variant="ghost" size="icon" onClick={() => navigator.clipboard.writeText(text)}><CopyIcon /></Button>\n  <Button variant="ghost" size="icon" onClick={onRegenerate}><RetryIcon /></Button>\n</MessageActions>',
+      composition: ["chat", "actions"]
+    }
+  ],
+  ai: {
+    whenToUse: "Render after assistant turns where the user might want to copy, regenerate, or rate the response. Combine with `group/message` on the parent Message to enable hover-reveal.",
+    whenNotToUse: "Don't use under user turns (no actions to take). Don't put primary CTAs here \u2014 actions row is for secondary, optional follow-ups.",
+    commonMistakes: [
+      "Forgetting `group/message` on the parent Message \u2014 hover-reveal won't trigger",
+      "Stacking too many buttons (more than ~4) \u2014 overwhelms the chat"
+    ],
+    relatedComponents: ["message", "button"],
+    accessibilityNotes: "Pure layout container. Each child button must carry its own `aria-label` since icon-only buttons have no accessible text.",
+    tokenBudget: 180
+  },
+  tags: ["ai", "chat", "actions", "row", "container"]
+};
+
+// src/ai/citation/citation.schema.ts
+var citationSchema = {
+  name: "citation",
+  displayName: "Citation",
+  description: "Source attribution chip \u2014 renders a citation for a RAG hit, search result, or any external reference. Becomes a focusable link when url is provided.",
+  category: "ai",
+  subcategory: "rag",
+  props: [
+    {
+      name: "title",
+      type: "string",
+      required: true,
+      description: 'Source title or filename (e.g. "auth-overview.md").'
+    },
+    {
+      name: "url",
+      type: "string",
+      required: false,
+      description: "If provided, the chip becomes an anchor opening in a new tab."
+    },
+    {
+      name: "page",
+      type: "number",
+      required: false,
+      description: 'Optional page number (renders "p.3").'
+    },
+    {
+      name: "index",
+      type: "number",
+      required: false,
+      description: 'Optional inline footnote number (renders "[1]").'
+    },
+    {
+      name: "children",
+      type: "ReactNode",
+      required: false,
+      description: "Trailing slot \u2014 extra metadata (e.g. relevance score)."
+    },
+    {
+      name: "className",
+      type: "string",
+      required: false,
+      description: "Additional CSS classes."
+    }
+  ],
+  variants: [],
+  slots: [
+    {
+      name: "children",
+      description: "Trailing extras \u2014 relevance score, badge, etc.",
+      required: false,
+      acceptedTypes: ["ReactNode"]
+    }
+  ],
+  dependencies: {
+    npm: ["clsx", "tailwind-merge"],
+    internal: ["lib/utils"],
+    peer: ["react", "react-dom"]
+  },
+  tokensUsed: ["card", "secondary", "ring", "foreground", "muted-foreground"],
+  examples: [
+    {
+      title: "Footnote-style citations",
+      description: "Numbered citations after an assistant turn.",
+      code: '<Cluster gap="xs">\n  {sources.map((s, i) => (\n    <Citation key={s.id} title={s.title} url={s.url} index={i + 1} />\n  ))}\n</Cluster>',
+      composition: ["rag", "citations"]
+    }
+  ],
+  ai: {
+    whenToUse: "Surface RAG/search-result sources after an assistant message. Use `index` for footnote-style numbering tied to inline `[1]` markers in the answer.",
+    whenNotToUse: "Don't use for general external links in chat (use Markdown). Don't fabricate sources \u2014 only render Citation for retrievals the model actually used.",
+    commonMistakes: [
+      "Showing the URL twice (in `title` AND `url`) \u2014 pick a human title separately",
+      'Skipping `target="_blank"` \u2014 handled automatically when url is set; don\'t override'
+    ],
+    relatedComponents: ["message", "cluster"],
+    accessibilityNotes: 'With `url`, renders a real anchor (`rel="noreferrer noopener"`). Without `url`, renders a static span. Add `aria-label` on the wrapper if title alone lacks context.',
+    tokenBudget: 240
+  },
+  tags: ["ai", "rag", "citation", "source", "footnote", "chip"]
+};
+
+// src/ai/markdown/markdown.schema.ts
+var markdownSchema = {
+  name: "markdown",
+  displayName: "Markdown",
+  description: "Streaming-safe markdown renderer wrapping Vercel's streamdown. Handles partial input mid-stream without throwing.",
+  category: "ai",
+  subcategory: "content",
+  props: [
+    {
+      name: "children",
+      type: "string",
+      required: true,
+      description: "Raw markdown. May be a partial chunk during streaming."
+    },
+    {
+      name: "className",
+      type: "string",
+      required: false,
+      description: "Additional CSS classes on the root element."
+    }
+  ],
+  variants: [],
+  slots: [
+    {
+      name: "children",
+      description: "Markdown source as a string.",
+      required: true,
+      acceptedTypes: ["string"]
+    }
+  ],
+  dependencies: {
+    npm: ["streamdown", "clsx", "tailwind-merge"],
+    internal: ["lib/utils"],
+    peer: ["react", "react-dom"]
+  },
+  tokensUsed: ["foreground", "primary"],
+  examples: [
+    {
+      title: "Streaming assistant turn",
+      description: "Render the in-flight assistant message as it arrives.",
+      code: '<Message role="assistant">\n  <Markdown>{message.content}</Markdown>\n</Message>',
+      composition: ["chat", "streaming", "markdown"]
+    },
+    {
+      title: "Custom rendering: drop down to Streamdown",
+      description: "For per-element overrides, use streamdown directly with our CodeBlock primitive.",
+      code: 'import { Streamdown } from "streamdown";\nimport { CodeBlock } from "@hex-core/components";\n\n<Streamdown components={{ pre: ({ children }) => <CodeBlock code={extractCode(children)} /> }}>\n  {markdown}\n</Streamdown>',
+      composition: ["chat", "code", "override"]
+    }
+  ],
+  ai: {
+    whenToUse: "Render any markdown content from an LLM \u2014 assistant turns, system messages with formatting, RAG citations with inline links. Required for streaming because raw markdown parsers throw on unfinished input.",
+    whenNotToUse: "Don't use for plain text without formatting (just render the string). Don't bypass it for streamed content \u2014 partial input WILL break a non-streaming parser.",
+    commonMistakes: [
+      "Passing JSX children instead of a markdown string \u2014 Markdown only accepts strings",
+      "Trying to override per-element renderers via Markdown \u2014 drop down to `Streamdown` directly for that (we keep our public surface minimal so the DTS bundle doesn't drag in shiki's giant language union)",
+      "Forgetting Tailwind Typography (`prose`) classes are required to style the output"
+    ],
+    relatedComponents: ["message", "code-block", "citation"],
+    accessibilityNotes: "Inherits semantics from streamdown: real headings, lists, links. Verify Tailwind Typography (prose) is enabled in your CSS \u2014 without it, output renders unstyled.",
+    tokenBudget: 280
+  },
+  tags: ["ai", "markdown", "streaming", "content", "renderer"]
+};
+
+// src/ai/code-block/code-block.schema.ts
+var codeBlockSchema = {
+  name: "code-block",
+  displayName: "CodeBlock",
+  description: "Server-rendered, syntax-highlighted code block with a language-label header and a copy button. Dual-theme via Shiki \u2014 same HTML for light + dark.",
+  category: "ai",
+  subcategory: "content",
+  props: [
+    {
+      name: "code",
+      type: "string",
+      required: true,
+      description: "The code to display. Plain text \u2014 no markdown fences."
+    },
+    {
+      name: "label",
+      type: "string",
+      required: false,
+      description: 'Header label (e.g. "pnpm", "tsx"). Inferred from `language` if omitted.'
+    },
+    {
+      name: "language",
+      type: "enum",
+      required: false,
+      description: "Shiki grammar key. Overrides inference from `label`.",
+      enumValues: ["bash", "ts", "tsx", "js", "jsx", "json", "css", "html", "md", "py", "text"]
+    },
+    {
+      name: "themes",
+      type: "object",
+      required: false,
+      default: { light: "github-light", dark: "github-dark" },
+      description: "Override the default theme pair. Keys: `light`, `dark` \u2014 values are Shiki theme IDs."
+    },
+    {
+      name: "className",
+      type: "string",
+      required: false,
+      description: "Additional CSS classes on the outer card."
+    }
+  ],
+  variants: [],
+  slots: [],
+  dependencies: {
+    npm: ["shiki", "clsx", "tailwind-merge"],
+    internal: ["lib/utils", "ai/code-block-copy"],
+    peer: ["react", "react-dom"]
+  },
+  tokensUsed: ["card", "card-foreground", "muted", "muted-foreground", "border"],
+  examples: [
+    {
+      title: "Install command",
+      description: "Header label drives both the visible chip and Shiki grammar inference.",
+      code: '<CodeBlock label="pnpm" code="pnpm add @hex-core/components" />',
+      composition: ["docs", "install"]
+    },
+    {
+      title: "Inline TS sample",
+      description: "Explicit language overrides label inference.",
+      code: '<CodeBlock language="tsx" code={`<Button>Click</Button>`} />',
+      composition: ["docs", "code"]
+    }
+  ],
+  ai: {
+    whenToUse: "Render any code snippet in docs, copy-to-clipboard install commands, or static AI chat output where server rendering is acceptable. Pair with Markdown's `components.pre` override to take over markdown code fences.",
+    whenNotToUse: "Don't use for streaming chat where the code grows mid-render \u2014 async Server Components can't update token-by-token. Use Streamdown's built-in client CodeBlock for that.",
+    commonMistakes: [
+      "Passing markdown-fenced code (with ```) \u2014 strip the fences first",
+      "Forgetting that this is async \u2014 must be awaited or rendered as RSC",
+      "Using a Shiki theme that isn't bundled \u2014 fails with a runtime fetch error"
+    ],
+    relatedComponents: ["markdown", "message"],
+    accessibilityNotes: "Highlighted output is plain text inside a `<pre>` \u2014 screen readers read it normally. The copy button has its own `aria-label`. Add a meaningful `aria-label` on the wrapper if the label alone isn't descriptive.",
+    tokenBudget: 320
+  },
+  tags: ["ai", "code", "shiki", "highlight", "copy", "rsc"]
+};
+
+export { accordionSchema, alertDialogSchema, alertSchema, aspectRatioSchema, avatarSchema, badgeSchema, breadcrumbSchema, buttonSchema, calendarSchema, cardSchema, checkboxSchema, citationSchema, clusterSchema, codeBlockSchema, collapsibleSchema, colorPickerSchema, comboboxSchema, commandSchema, composerSchema, containerSchema, contextMenuSchema, dataTableSchema, datePickerSchema, dialogSchema, drawerSchema, dropdownMenuSchema, dropzoneSchema, fileTreeSchema, formSchema, gridSchema, hoverCardSchema, inputOTPSchema, inputSchema, labelSchema, loadingIndicatorSchema, markdownSchema, menubarSchema, messageActionsSchema, messageListSchema, messageSchema, multiComboboxSchema, navigationMenuSchema, paginationSchema, popoverSchema, progressSchema, radioGroupSchema, reasoningSchema, resizableSchema, scrollAreaSchema, selectSchema, separatorSchema, sheetSchema, sidebarSchema, skeletonSchema, sliderSchema, sonnerSchema, spacerSchema, stackSchema, stepperSchema, suggestionSchema, switchSchema, tableSchema, tabsSchema, textareaSchema, timePickerSchema, timelineSchema, toggleGroupSchema, toggleSchema, toolCallSchema, tooltipSchema };
 //# sourceMappingURL=schemas.js.map
 //# sourceMappingURL=schemas.js.map