@workerdeck/ui 0.6.0

package/build/index.d.mts

@@ -0,0 +1,927 @@
+import * as _$react from "react";
+import { ButtonHTMLAttributes, FunctionComponent, HTMLAttributes, InputHTMLAttributes, ReactNode, TextareaHTMLAttributes } from "react";
+import { VariantProps } from "class-variance-authority";
+import { ClassValue } from "clsx";
+import * as _$_base_ui_react_select0 from "@base-ui/react/select";
+import { Select as Select$1 } from "@base-ui/react/select";
+import * as _$_base_ui_react_alert_dialog0 from "@base-ui/react/alert-dialog";
+import { AlertDialog as AlertDialog$1 } from "@base-ui/react/alert-dialog";
+import * as _$_base_ui_react_tooltip0 from "@base-ui/react/tooltip";
+import { Tooltip } from "@base-ui/react/tooltip";
+import { toast } from "sonner";
+import { ModelOption, PermissionMode, PermissionRequest, QuestionBehavior, SessionInfo, SessionStatus, SlashCommandInfo, UserQuestion } from "@workerdeck/protocol";
+import { TranscriptItem, TranscriptState } from "@workerdeck/react";
+import * as _$class_variance_authority_types0 from "class-variance-authority/types";
+import { WorkerDeckClient } from "@workerdeck/client";
+
+//#region src/components/ui/Button.d.ts
+declare const buttonVariants: (props?: ({
+  variant?: "default" | "outline" | "secondary" | "ghost" | "destructive" | "link" | null | undefined;
+  size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-sm" | null | undefined;
+} & _$class_variance_authority_types0.ClassProp) | undefined) => string;
+interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {}
+declare const Button: _$react.ForwardRefExoticComponent<ButtonProps & _$react.RefAttributes<HTMLButtonElement>>;
+//#endregion
+//#region src/components/ui/Badge.d.ts
+declare const badgeVariants: (props?: ({
+  variant?: "neutral" | "accent" | "success" | "warning" | "danger" | "info" | null | undefined;
+  mono?: boolean | null | undefined;
+} & _$class_variance_authority_types0.ClassProp) | undefined) => string;
+interface BadgeProps extends HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
+  /** Render a leading status dot in the variant's color. */
+  dot?: boolean;
+}
+declare function Badge({
+  className,
+  variant,
+  mono,
+  dot,
+  children,
+  ...props
+}: BadgeProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/ui/Card.d.ts
+declare function Card({
+  className,
+  ...props
+}: HTMLAttributes<HTMLDivElement>): _$react.JSX.Element;
+declare function CardHeader({
+  className,
+  ...props
+}: HTMLAttributes<HTMLDivElement>): _$react.JSX.Element;
+declare function CardTitle({
+  className,
+  ...props
+}: HTMLAttributes<HTMLHeadingElement>): _$react.JSX.Element;
+declare function CardContent({
+  className,
+  ...props
+}: HTMLAttributes<HTMLDivElement>): _$react.JSX.Element;
+//#endregion
+//#region src/components/ui/Input.d.ts
+declare const Input: _$react.ForwardRefExoticComponent<InputHTMLAttributes<HTMLInputElement> & _$react.RefAttributes<HTMLInputElement>>;
+//#endregion
+//#region src/components/ui/Textarea.d.ts
+declare const Textarea: _$react.ForwardRefExoticComponent<TextareaHTMLAttributes<HTMLTextAreaElement> & _$react.RefAttributes<HTMLTextAreaElement>>;
+//#endregion
+//#region src/components/ui/Select.d.ts
+declare const Select: typeof Select$1.Root;
+declare const SelectValue: _$react.ForwardRefExoticComponent<Omit<_$_base_ui_react_select0.SelectValueProps, "ref"> & _$react.RefAttributes<HTMLSpanElement>>;
+declare const SelectItemText: _$react.NamedExoticComponent<Omit<_$_base_ui_react_select0.SelectItemTextProps, "ref"> & _$react.RefAttributes<HTMLDivElement>>;
+declare const SelectTrigger: FunctionComponent<Select$1.Trigger.Props>;
+declare const SelectContent: FunctionComponent<Select$1.Popup.Props & Pick<Select$1.Positioner.Props, 'align' | 'alignItemWithTrigger' | 'side' | 'sideOffset'>>;
+declare const SelectItem: FunctionComponent<Select$1.Item.Props>;
+//#endregion
+//#region src/components/ui/AlertDialog.d.ts
+declare const AlertDialog: typeof AlertDialog$1.Root;
+declare const AlertDialogTrigger: AlertDialog$1.Trigger;
+declare const AlertDialogClose: _$react.ForwardRefExoticComponent<Omit<_$_base_ui_react_alert_dialog0.AlertDialogCloseProps, "ref"> & _$react.RefAttributes<HTMLButtonElement>>;
+declare const AlertDialogContent: FunctionComponent<AlertDialog$1.Popup.Props>;
+declare const AlertDialogTitle: FunctionComponent<AlertDialog$1.Title.Props>;
+declare const AlertDialogDescription: FunctionComponent<AlertDialog$1.Description.Props>;
+//#endregion
+//#region src/components/ui/Tooltip.d.ts
+declare const TooltipProvider: _$react.FC<_$_base_ui_react_tooltip0.TooltipProviderProps>;
+declare const TooltipContent: FunctionComponent<Tooltip.Popup.Props & Pick<Tooltip.Positioner.Props, 'side' | 'sideOffset'>>;
+/** Convenience wrapper: <Tip content="..."><Button/></Tip> */
+declare function Tip({
+  content,
+  children
+}: {
+  content: ReactNode;
+  children: ReactNode;
+}): _$react.JSX.Element;
+//#endregion
+//#region src/components/ui/Sonner.d.ts
+/** Token-themed toaster; relies on the [data-theme] swap, so no `theme` prop needed. */
+declare function Toaster(): _$react.JSX.Element;
+//#endregion
+//#region src/components/ui/CopyButton.d.ts
+interface CopyButtonProps extends Omit<ButtonProps, 'onClick' | 'children'> {
+  value: string;
+}
+declare function CopyButton({
+  value,
+  className,
+  variant,
+  size,
+  ...props
+}: CopyButtonProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/ui/Spinner.d.ts
+declare function Spinner({
+  className
+}: {
+  className?: string;
+}): _$react.JSX.Element;
+//#endregion
+//#region src/components/ui/CodeBlock.d.ts
+interface CodeBlockProps {
+  code: string;
+  /** Header label, e.g. a language or "Parameters". */
+  label?: ReactNode;
+  copyable?: boolean;
+  className?: string;
+}
+/** Plain (unhighlighted) code panel for structured data like tool inputs. Markdown code
+ * inside assistant responses is highlighted by <Response> instead. */
+declare function CodeBlock({
+  code,
+  label,
+  copyable,
+  className
+}: CodeBlockProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/ui/ProgressRing.d.ts
+interface ProgressRingProps {
+  /** Filled share, 0–100 (clamped). */
+  value: number;
+  /** Outer diameter in px. */
+  size?: number;
+  strokeWidth?: number;
+  className?: string;
+}
+/** Tiny SVG progress circle; stroke color comes from `currentColor` so callers set it
+ * via text color classes (e.g. warning/danger past thresholds). */
+declare function ProgressRing({
+  value,
+  size,
+  strokeWidth,
+  className
+}: ProgressRingProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/prompt-area/types.d.ts
+/**
+ * PromptArea component types
+ *
+ * A lightweight contentEditable-based text input that supports:
+ * - Trigger characters (/, @, #) that activate handlers
+ * - Immutable chips for resolved mentions/commands
+ * - Configurable trigger behavior (dropdown vs callback)
+ * - Simple inline markdown rendering
+ */
+/**
+ * A segment of content within the editable text.
+ * The document model is an ordered array of these segments.
+ */
+type TextSegment = {
+  type: 'text';
+  text: string;
+};
+type ChipSegment = {
+  type: 'chip'; /** The trigger character that created this chip (e.g., '@', '#') */
+  trigger: string; /** The resolved value/ID (e.g., user ID, file ID) */
+  value: string; /** The display text shown in the chip */
+  displayText: string; /** Optional data payload attached to the chip */
+  data?: unknown;
+  /**
+   * True when this chip was auto-created by pressing space (resolveOnSpace).
+   * Backspace on an auto-resolved chip reverts it to plain text instead of deleting.
+   */
+  autoResolved?: boolean;
+};
+type Segment = TextSegment | ChipSegment;
+/**
+ * Determines where a trigger character is valid.
+ * - 'start': Only valid at the very start of input or after a newline (e.g., slash commands)
+ * - 'any': Valid after any whitespace boundary (e.g., @mentions)
+ */
+type TriggerPosition = 'start' | 'any';
+/**
+ * Defines how a trigger behaves when activated.
+ * - 'dropdown': Shows a popover with suggestions from `onSearch`
+ * - 'callback': Inserts the char, then fires `onActivate` with the typed query
+ * - 'launch': Fires `onActivate` on keydown and SUPPRESSES the char (it never
+ *   enters the editor) — for opening an external surface (dialog, palette) where
+ *   no in-editor text should appear. Honors `position` like the other modes.
+ */
+type TriggerMode = 'dropdown' | 'callback' | 'launch';
+/**
+ * Visual style for rendered chips.
+ * - 'pill': Button-like pill with background color, padding, border-radius (default)
+ * - 'inline': Bold inline text that flows naturally with surrounding content
+ */
+type ChipStyle = 'pill' | 'inline';
+/**
+ * A suggestion item shown in the trigger dropdown.
+ */
+type TriggerSuggestion = {
+  /** Unique value/ID for this suggestion */value: string; /** Display label shown in the dropdown */
+  label: string; /** Optional description shown below the label */
+  description?: string; /** Optional icon element rendered before the label */
+  icon?: React.ReactNode; /** Optional arbitrary data passed through on selection */
+  data?: unknown;
+};
+/**
+ * Configuration for a trigger character.
+ */
+type TriggerConfig = {
+  /** The trigger character (e.g., '/', '@', '#') */char: string; /** Where this trigger is valid */
+  position: TriggerPosition; /** How this trigger behaves */
+  mode: TriggerMode;
+  /**
+   * For 'dropdown' mode: called with the current query to fetch suggestions.
+   * Should return a list of suggestions to display.
+   *
+   * Receives an options object with an `AbortSignal` that is aborted when a
+   * newer search supersedes this one. Pass it to `fetch()` or other async
+   * APIs to cancel in-flight work automatically.
+   */
+  onSearch?: (query: string, options: {
+    signal: AbortSignal;
+  }) => TriggerSuggestion[] | Promise<TriggerSuggestion[]>;
+  /**
+   * For 'dropdown' mode: called when a suggestion is selected.
+   * Return the display text for the chip, or void to use `suggestion.label`.
+   */
+  onSelect?: (suggestion: TriggerSuggestion) => string | void;
+  /**
+   * For 'callback' and 'launch' modes: called when the trigger is activated.
+   * Receives the full input text and cursor position. For 'launch' it fires on
+   * keydown (before the char would insert); for 'callback' it fires after.
+   */
+  onActivate?: (context: TriggerActivateContext) => void;
+  /**
+   * When true, pressing space while this trigger is active (with a non-empty query)
+   * auto-resolves the typed text into a chip without selecting from the dropdown.
+   * The auto-resolved chip can be reverted to plain text with backspace.
+   * Useful for free-form tags (e.g., #hashtag).
+   */
+  resolveOnSpace?: boolean;
+  /**
+   * For 'dropdown' mode: when true, clicking a chip created by this trigger
+   * reopens the suggestion dropdown anchored to the chip, and selecting a
+   * suggestion replaces the chip in place. The empty-query suggestions are
+   * shown with the chip's current value preselected. `onChipClick` still
+   * fires, so side effects (analytics, etc.) keep working.
+   */
+  reopenOnChipClick?: boolean;
+  /**
+   * Visual style for chips created by this trigger.
+   * - 'pill' (default): Button-like pill with background, padding, border-radius
+   * - 'inline': Bold inline text without pill styling
+   */
+  chipStyle?: ChipStyle; /** CSS class name(s) applied to chips created by this trigger */
+  chipClassName?: string; /** Label used for accessibility (e.g., "mention", "command") */
+  accessibilityLabel?: string;
+  /**
+   * Debounce delay in milliseconds before calling `onSearch`.
+   * Defaults to 0 (immediate). The initial empty-query search always fires
+   * immediately regardless of this setting so the dropdown appears instantly.
+   */
+  searchDebounceMs?: number;
+  /**
+   * Called when `onSearch` rejects or throws (non-abort errors only).
+   * Use this to log errors or show toast notifications.
+   */
+  onSearchError?: (error: unknown) => void;
+  /**
+   * Message shown in the dropdown when `onSearch` returns an empty array.
+   * If omitted, the popover hides when there are no results (current behavior).
+   */
+  emptyMessage?: string;
+};
+/**
+ * Context passed to callback-mode trigger handlers.
+ */
+type TriggerActivateContext = {
+  /** The full plain text content at the time of activation */text: string; /** The cursor offset position */
+  cursorPosition: number; /** Function to insert a chip at the current cursor position */
+  insertChip: (chip: Omit<ChipSegment, 'type'>) => void;
+};
+/**
+ * An image attachment displayed in the prompt area.
+ * State is managed externally by the parent component.
+ */
+type PromptAreaImage = {
+  /** Unique identifier for this image */id: string; /** URL to display (CDN URL or temporary blob URL for preview) */
+  url: string; /** Optional alt text for accessibility */
+  alt?: string; /** When true, shows a loading indicator over the thumbnail */
+  loading?: boolean;
+};
+/**
+ * A file attachment displayed in the prompt area.
+ * State is managed externally by the parent component.
+ */
+type PromptAreaFile = {
+  /** Unique identifier for this file */id: string; /** Display filename (e.g., "report.pdf") */
+  name: string; /** File size in bytes */
+  size?: number; /** MIME type (used for icon selection, e.g., "application/pdf") */
+  type?: string; /** When true, shows a loading indicator over the file card */
+  loading?: boolean;
+};
+/**
+ * Props for the PromptArea component.
+ */
+type PromptAreaProps = {
+  /** The document segments (controlled) */value: Segment[]; /** Called when the content changes */
+  onChange: (segments: Segment[]) => void; /** Trigger configurations */
+  triggers?: TriggerConfig[]; /** Placeholder text when empty. Pass an array of strings to animate between them. */
+  placeholder?: string | string[]; /** Additional CSS class for the container */
+  className?: string; /** Whether the input is disabled */
+  disabled?: boolean; /** Whether to render simple inline markdown (bold, italic, URLs, lists) */
+  markdown?: boolean;
+  /**
+   * When markdown is on, the editor rewrites typed list markers (`- ` / `* `)
+   * to a `•` bullet glyph in the model. Set to `false` to keep the original
+   * marker in the value/`onChange` text — needed when a host renders the output
+   * as real markdown, where `•` is not a valid list marker. Default `true`.
+   */
+  normalizeBullets?: boolean; /** Called when Enter is pressed (without Shift) */
+  onSubmit?: (segments: Segment[]) => void; /** Called when Escape is pressed */
+  onEscape?: () => void; /** Called when a chip element is clicked. Receives the chip's segment data. */
+  onChipClick?: (chip: ChipSegment) => void; /** Called when a new chip is added (dropdown selection, auto-resolve, paste, or imperative insert) */
+  onChipAdd?: (chip: ChipSegment) => void; /** Called when a chip is deleted (backspace or forward delete) */
+  onChipDelete?: (chip: ChipSegment) => void; /** Called when a URL link is clicked. Receives the URL string. */
+  onLinkClick?: (url: string) => void; /** Called after content is pasted. Receives the resulting segments and the paste source. */
+  onPaste?: (data: {
+    segments: Segment[];
+    source: 'internal' | 'external';
+  }) => void; /** Called after an undo operation. Receives the restored segments. */
+  onUndo?: (segments: Segment[]) => void; /** Called after a redo operation. Receives the restored segments. */
+  onRedo?: (segments: Segment[]) => void; /** Minimum height in pixels */
+  minHeight?: number; /** Maximum height in pixels */
+  maxHeight?: number;
+  /**
+   * Maximum number of plain-text characters allowed, enforced on typed input:
+   * once the editor exceeds the cap it is truncated back to this length, with
+   * the caret kept where the edit happened. Chips count as their
+   * `trigger + displayText` length.
+   *
+   * The cap applies to typing only. Paste is not capped — divert it via
+   * `onRawPaste` if needed — and the imperative `setText` / `appendText` also
+   * bypass it, so a programmatic write can exceed the cap until the next
+   * keystroke truncates.
+   */
+  maxLength?: number; /** Auto-focus on mount */
+  autoFocus?: boolean; /** When true, the area auto-grows to fit content on focus and shrinks on blur */
+  autoGrow?: boolean; /** Accessible label for the input */
+  'aria-label'?: string; /** data-test-id for e2e testing */
+  'data-test-id'?: string; /** Array of image attachments to display */
+  images?: PromptAreaImage[]; /** Where to render the image strip relative to the text area. Defaults to 'above'. */
+  imagePosition?: 'above' | 'below'; /** Called when the user pastes an image from clipboard. Receives the File object. */
+  onImagePaste?: (file: File) => void; /** Called when the user clicks the remove button on an image */
+  onImageRemove?: (image: PromptAreaImage) => void; /** Called when the user clicks an image thumbnail */
+  onImageClick?: (image: PromptAreaImage) => void; /** Array of file attachments to display */
+  files?: PromptAreaFile[]; /** Where to render the file strip relative to the text area. Defaults to 'above'. */
+  filePosition?: 'above' | 'below'; /** Called when the user clicks the remove button on a file */
+  onFileRemove?: (file: PromptAreaFile) => void; /** Called when the user clicks a file attachment */
+  onFileClick?: (file: PromptAreaFile) => void;
+  /**
+   * Called on keydown before PromptArea's own handling. Call `preventDefault()`
+   * to suppress the built-in behaviour (submit, trigger navigation, etc.) for
+   * that key and take over entirely.
+   */
+  onKeyDown?: (e: React.KeyboardEvent<HTMLDivElement>) => void;
+  /**
+   * Called on blur with the native FocusEvent, so consumers can inspect
+   * `relatedTarget` (e.g. to retain focus when a composer toolbar is clicked).
+   */
+  onBlur?: (e: React.FocusEvent<HTMLDivElement>) => void;
+  /**
+   * Called at the start of a paste, before PromptArea reads the clipboard. Call
+   * `preventDefault()` to take over the paste completely — e.g. to divert large
+   * text or non-image files to an upload pipeline. The built-in segment/image
+   * paste handling is skipped when the event's default is prevented.
+   */
+  onRawPaste?: (e: React.ClipboardEvent<HTMLDivElement>) => void;
+  /**
+   * Whether pressing Enter (without Shift) submits. Defaults to true. Set false
+   * to make Enter insert a newline instead (e.g. on touch devices where submit
+   * is a dedicated button).
+   */
+  submitOnEnter?: boolean; /** Forwarded to the editable element. */
+  spellCheck?: boolean; /** Forwarded to the editable element as `aria-describedby`. */
+  'aria-describedby'?: string;
+};
+/**
+ * Ref handle exposed by PromptArea via useImperativeHandle.
+ */
+type PromptAreaHandle = {
+  /** Focus the editable area */focus: () => void; /** Blur the editable area */
+  blur: () => void; /** Insert a chip at the current cursor position */
+  insertChip: (chip: Omit<ChipSegment, 'type'>) => void; /** Get the current plain text (without chip markup) */
+  getPlainText: () => string; /** Clear all content */
+  clear: () => void;
+  /**
+   * Replace all content with plain text (chips dropped), caret moved to the
+   * end. Not capped by `maxLength` (see its docs); undoable.
+   */
+  setText: (text: string) => void;
+  /**
+   * Append plain text at the end (existing chips preserved), caret moved to the
+   * end. Not capped by `maxLength` (see its docs); undoable.
+   */
+  appendText: (text: string) => void; /** Caret offset in plain-text characters, or null when unavailable. */
+  getCursorPosition: () => number | null; /** Move the caret to a plain-text offset. */
+  setCursorPosition: (offset: number) => void; /** Move the caret to the end of the content. */
+  setCursorToEnd: () => void; /** Current selection as plain-text offsets, or null when there is none. */
+  getSelection: () => {
+    start: number;
+    end: number;
+  } | null; /** Set the selection between two plain-text offsets. */
+  setSelection: (start: number, end: number) => void;
+};
+//#endregion
+//#region src/components/prompt-area/prompt-area.d.ts
+/**
+ * PromptArea - A lightweight rich text input with trigger support.
+ *
+ * Uses contentEditable to support inline chips (immutable pills) for
+ * mentions, commands, and other triggered tokens. Each trigger character
+ * can be configured to show a dropdown or fire a callback.
+ *
+ * @example
+ * ```tsx
+ * const [segments, setSegments] = useState<Segment[]>([])
+ *
+ * <PromptArea
+ *   value={segments}
+ *   onChange={setSegments}
+ *   triggers={[
+ *     { char: '@', position: 'any', mode: 'dropdown', onSearch: searchUsers },
+ *     { char: '/', position: 'start', mode: 'dropdown', onSearch: searchCommands },
+ *     { char: '#', position: 'any', mode: 'dropdown', onSearch: searchTags },
+ *   ]}
+ *   placeholder="Type a message..."
+ *   onSubmit={handleSubmit}
+ *   autoGrow
+ * />
+ * ```
+ */
+declare function PromptArea({
+  value,
+  onChange,
+  triggers,
+  placeholder,
+  className,
+  disabled,
+  markdown,
+  normalizeBullets,
+  onSubmit,
+  onEscape,
+  onChipClick,
+  onChipAdd,
+  onChipDelete,
+  onLinkClick,
+  onPaste,
+  onUndo,
+  onRedo,
+  minHeight,
+  maxHeight,
+  autoFocus,
+  autoGrow,
+  'aria-label': ariaLabel,
+  'data-test-id': dataTestId,
+  images,
+  imagePosition,
+  onImagePaste,
+  onImageRemove,
+  onImageClick,
+  files,
+  filePosition,
+  onFileRemove,
+  onFileClick,
+  onKeyDown,
+  onBlur,
+  onRawPaste,
+  submitOnEnter,
+  spellCheck,
+  maxLength,
+  'aria-describedby': ariaDescribedBy,
+  ref
+}: PromptAreaProps & {
+  ref?: React.Ref<PromptAreaHandle>;
+}): _$react.JSX.Element;
+//#endregion
+//#region src/components/prompt-area/use-prompt-area-state.d.ts
+type UsePromptAreaStateOptions = {
+  /** Initial segment value. Defaults to `[]`. */initialValue?: Segment[];
+};
+type PromptAreaBind = {
+  /** Ref to attach to PromptArea — gives access to imperative methods. */ref: React.RefObject<PromptAreaHandle | null>; /** Current segment array — pass as `value` prop. */
+  value: Segment[]; /** Setter — pass as `onChange` prop. */
+  onChange: (segments: Segment[]) => void;
+};
+type PromptAreaState = {
+  /** Props to spread directly onto `<PromptArea {...bind} />`. Contains ref, value, and onChange. */bind: PromptAreaBind; /** Derived plain text representation of the current value. */
+  plainText: string; /** `true` when the value is empty or whitespace-only. */
+  isEmpty: boolean; /** `true` when the value contains at least one chip. */
+  hasChips: boolean; /** All chip segments in the current value. */
+  chips: ChipSegment[]; /** Clear all content (both state and the editor DOM). */
+  clear: () => void; /** Focus the editor. */
+  focus: () => void; /** Blur the editor. */
+  blur: () => void; /** Insert a chip at the current cursor position. */
+  insertChip: (chip: Omit<ChipSegment, 'type'>) => void;
+};
+declare function usePromptAreaState(options?: UsePromptAreaStateOptions): PromptAreaState;
+//#endregion
+//#region src/components/prompt-area/trigger-presets.d.ts
+type TriggerPresetOptions = Omit<Partial<TriggerConfig>, 'char' | 'position' | 'mode'>;
+type MentionTriggerOptions = TriggerPresetOptions & {
+  /** Override the trigger character. Defaults to `'@'`. */char?: string;
+};
+/**
+ * Creates a **mention** trigger (`@`).
+ *
+ * Defaults: `position: 'any'`, `mode: 'dropdown'`, `chipStyle: 'pill'`,
+ * accessible label `"mention"`.
+ */
+declare function mentionTrigger(opts?: MentionTriggerOptions): TriggerConfig;
+type CommandTriggerOptions = TriggerPresetOptions & {
+  /** Override the trigger character. Defaults to `'/'`. */char?: string;
+  /**
+   * Where the command trigger is valid. Defaults to `'any'`, so commands fire
+   * anywhere a `/` follows whitespace — not just at the start of a line.
+   * Set to `'start'` to restrict the dropdown to the very start of the input
+   * or immediately after a newline (the classic slash-command behavior).
+   */
+  position?: TriggerPosition;
+};
+/**
+ * Creates a **command** trigger (`/`).
+ *
+ * Defaults: `position: 'any'`, `mode: 'dropdown'`, `chipStyle: 'inline'`,
+ * accessible label `"command"`.
+ *
+ * By default commands work everywhere in the input. Pass `position: 'start'`
+ * to limit them to the start of a line.
+ */
+declare function commandTrigger(opts?: CommandTriggerOptions): TriggerConfig;
+type HashtagTriggerOptions = TriggerPresetOptions & {
+  /** Override the trigger character. Defaults to `'#'`. */char?: string;
+};
+/**
+ * Creates a **hashtag / tag** trigger (`#`).
+ *
+ * Defaults: `position: 'any'`, `mode: 'dropdown'`, `chipStyle: 'pill'`,
+ * `resolveOnSpace: true`, accessible label `"tag"`.
+ */
+declare function hashtagTrigger(opts?: HashtagTriggerOptions): TriggerConfig;
+//#endregion
+//#region src/components/prompt-area/prompt-area-engine.d.ts
+/**
+ * Converts an array of segments to a plain text string.
+ * Chips are represented as `{trigger}{displayText}` (e.g., "@Alice").
+ */
+declare function segmentsToPlainText(segments: Segment[]): string;
+/**
+ * Converts plain text into a single text segment.
+ * Used for initial value conversion from plain strings.
+ */
+declare function plainTextToSegments(text: string): Segment[];
+//#endregion
+//#region src/components/prompt-area/segment-helpers.d.ts
+/** Returns `true` when the segment array is empty or contains only whitespace text. */
+declare function isSegmentsEmpty(segments: Segment[]): boolean;
+/** Extracts chips matching a specific trigger character. */
+declare function getChipsByTrigger(segments: Segment[], trigger: string): ChipSegment[];
+//#endregion
+//#region src/components/agent/SessionPanel.d.ts
+interface SessionPanelProps {
+  client: WorkerDeckClient;
+  sessionId: string | undefined;
+  /** Optional slot rendered at the top, above the status bar. */
+  header?: ReactNode;
+  className?: string;
+}
+/**
+ * The all-in-one embeddable session surface: status bar, streaming transcript,
+ * permission prompts, composer. Attaches via useClaudeSession; remount (key) to switch
+ * sessions.
+ */
+declare function SessionPanel({
+  client,
+  sessionId,
+  header,
+  className
+}: SessionPanelProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/agent/Transcript.d.ts
+interface TranscriptProps {
+  state: TranscriptState;
+  /** Builds the download URL for a delivered file (see FileCard). Typically
+   * `(path) => client.sessionFileUrl(sessionId, path)`. */
+  fileUrl?: (path: string) => string;
+  className?: string;
+}
+declare function Transcript({
+  state,
+  fileUrl,
+  className
+}: TranscriptProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/agent/Conversation.d.ts
+interface ConversationProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+  children: ReactNode;
+}
+/** Scroll container that stays pinned to the bottom while streaming, unless the user
+ * scrolls up — plus a floating scroll-to-bottom button. */
+declare function Conversation({
+  className,
+  children,
+  ...props
+}: ConversationProps): _$react.JSX.Element;
+declare function ConversationContent({
+  className,
+  children,
+  ...props
+}: HTMLAttributes<HTMLDivElement> & {
+  children: ReactNode;
+}): _$react.JSX.Element;
+declare function ConversationScrollButton({
+  className
+}: {
+  className?: string;
+}): _$react.JSX.Element | null;
+//#endregion
+//#region src/components/agent/Message.d.ts
+interface MessageProps extends HTMLAttributes<HTMLDivElement> {
+  from: 'user' | 'assistant';
+}
+/** One chat turn row. User messages sit right in a bubble; assistant content is flat,
+ * full-width (the AI-chat convention — assistant output is the page, user input is quoted). */
+declare function Message({
+  from,
+  className,
+  ...props
+}: MessageProps): _$react.JSX.Element;
+declare function MessageContent({
+  className,
+  ...props
+}: HTMLAttributes<HTMLDivElement>): _$react.JSX.Element;
+//#endregion
+//#region src/components/agent/Response.d.ts
+interface ResponseProps {
+  children: string;
+  /** Streaming text: tolerate incomplete markdown (unclosed fences, half links). */
+  streaming?: boolean;
+  className?: string;
+}
+/** Markdown renderer for assistant output — streaming-safe via streamdown, code
+ * highlighted with shiki (dual theme follows [data-theme] through the dark: variant). */
+declare const Response: _$react.MemoExoticComponent<({
+  children,
+  streaming,
+  className
+}: ResponseProps) => _$react.JSX.Element>;
+//#endregion
+//#region src/components/agent/Reasoning.d.ts
+interface ReasoningProps {
+  children: string;
+  /** Auto-opens while true, auto-closes shortly after it flips false. */
+  isStreaming?: boolean;
+  defaultOpen?: boolean;
+  className?: string;
+}
+/** Collapsible extended-thinking block: open while the model is thinking, tucks itself
+ * away once the thought is finished (unless the user toggled it manually). */
+declare function Reasoning({
+  children,
+  isStreaming,
+  defaultOpen,
+  className
+}: ReasoningProps): _$react.JSX.Element | null;
+//#endregion
+//#region src/components/agent/Loader.d.ts
+/** Three-dot pulse shown while the assistant hasn't produced output yet. */
+declare function Loader({
+  label,
+  className
+}: {
+  label?: string;
+  className?: string;
+}): _$react.JSX.Element;
+//#endregion
+//#region src/components/agent/ToolCallCard.d.ts
+type ToolCallItem = Extract<TranscriptItem, {
+  kind: 'tool_call';
+}>;
+interface ToolCallCardProps {
+  item: ToolCallItem;
+  className?: string;
+}
+declare function ToolCallCard({
+  item,
+  className
+}: ToolCallCardProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/agent/FileCard.d.ts
+type FileDeliveredItem = Extract<TranscriptItem, {
+  kind: 'file_delivered';
+}>;
+interface FileCardProps {
+  item: FileDeliveredItem;
+  /** Download URL for the delivered path (the server's session file route).
+   * Without it the card renders informational only. */
+  href?: string;
+  className?: string;
+}
+/** A file the agent handed over (`file_delivered`): name, size, download link.
+ * The file lives in the session's in-memory VFS — the link works while the
+ * session lives. */
+declare function FileCard({
+  item,
+  href,
+  className
+}: FileCardProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/agent/PermissionPrompt.d.ts
+interface PermissionPromptProps {
+  request: PermissionRequest;
+  onApprove: (requestId: string) => void;
+  onDeny: (requestId: string, message?: string) => void;
+  className?: string;
+}
+declare function PermissionPrompt({
+  request,
+  onApprove,
+  onDeny,
+  className
+}: PermissionPromptProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/agent/QuestionPrompt.d.ts
+type QuestionBehaviorMeta = {
+  value: QuestionBehavior;
+  label: string;
+  description: string;
+};
+/** The AskUserQuestion policies surfaced on job/session creation forms. */
+declare const QUESTION_BEHAVIORS: QuestionBehaviorMeta[];
+/** Extract well-formed questions from an AskUserQuestion permission request's input. */
+declare function parseUserQuestions(input: Record<string, unknown>): UserQuestion[];
+interface QuestionPromptProps {
+  /** A pending permission whose toolName is 'AskUserQuestion'. */
+  request: PermissionRequest;
+  /** Allow the tool with `updatedInput` (the original input plus `answers`). */
+  onAnswer: (requestId: string, updatedInput: Record<string, unknown>) => void;
+  /** Deny the tool — the model proceeds without an answer. */
+  onDismiss: (requestId: string, message?: string) => void;
+  className?: string;
+}
+/** Interactive form for the AskUserQuestion tool: option buttons per question
+ * (multi-select where the question allows it), a free-text "Other" escape hatch,
+ * and the focused option's preview. Falls back to nothing renderable → the caller
+ * should show a generic PermissionPrompt if `parseUserQuestions` finds no questions. */
+declare function QuestionPrompt({
+  request,
+  onAnswer,
+  onDismiss,
+  className
+}: QuestionPromptProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/agent/Composer.d.ts
+interface ComposerProps {
+  onSend: (text: string) => void;
+  onInterrupt: () => void;
+  busy: boolean;
+  /** Disable input entirely (session failed/closed). */
+  disabled?: boolean;
+  placeholder?: string;
+  /** Slash commands offered as autocomplete; picked ones render as chips. */
+  commands?: SlashCommandInfo[];
+  /** Left side of the toolbar row (mode selects, attachments, …). */
+  toolbar?: ReactNode;
+  className?: string;
+}
+/** Framed prompt input built on prompt-area's contentEditable: typing "/" — at the
+ * start or after whitespace — opens a suggestion dropdown fed by `commands`, and a
+ * picked command becomes an inline chip. Submit button flips to stop while a turn
+ * is running (messages still queue while busy). */
+declare function Composer({
+  onSend,
+  onInterrupt,
+  busy,
+  disabled,
+  placeholder,
+  commands,
+  toolbar,
+  className
+}: ComposerProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/agent/ModelSelect.d.ts
+interface ModelSelectProps {
+  /** Models the session can switch to (TranscriptState.models). */
+  models: ModelOption[];
+  /** The session's current model id (TranscriptState.model), possibly decorated
+   * (e.g. "claude-fable-5[1m]") — matched leniently against the options.
+   * `undefined` selects the list's default row, if it has one. */
+  model?: string;
+  /** `undefined` = back to the CLI's default model. */
+  onModelChange: (model?: string) => void;
+  /** 'toolbar' (default) is the composer's compact borderless trigger;
+   * 'form' is a standard field-sized Select for create/settings forms. */
+  variant?: 'toolbar' | 'form';
+  disabled?: boolean;
+  className?: string;
+}
+/** Compact model switcher for the composer toolbar; fed by the `capabilities` event.
+ * Rows render CLI-style: bold display name with the model's description beneath. */
+declare function ModelSelect({
+  models,
+  model,
+  onModelChange,
+  variant,
+  disabled,
+  className
+}: ModelSelectProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/agent/PermissionModeSelect.d.ts
+type PermissionModeMeta = {
+  value: PermissionMode;
+  label: string;
+  description: string;
+  dangerous?: boolean;
+};
+/** The modes surfaced across UI surfaces (session creation, in-session switcher). */
+declare const PERMISSION_MODES: PermissionModeMeta[];
+interface PermissionModeSelectProps {
+  /** The session's current mode (TranscriptState.permissionMode). */
+  mode?: PermissionMode;
+  onModeChange: (mode: PermissionMode) => void;
+  /** Restrict what is offered — most of {@link PERMISSION_MODES} is Claude Code
+   * vocabulary the provider engine has no meaning for. Defaults to all of them;
+   * pass `PROVIDER_PERMISSION_MODES` for a provider session. */
+  modes?: readonly PermissionMode[];
+  /** 'toolbar' (default) is the composer's compact borderless trigger;
+   * 'form' is a standard field-sized Select for create/settings forms. */
+  variant?: 'toolbar' | 'form';
+  disabled?: boolean;
+  className?: string;
+}
+/** Permission-mode switcher: compact in the composer toolbar, field-sized in forms. */
+declare function PermissionModeSelect({
+  mode,
+  onModeChange,
+  modes,
+  variant,
+  disabled,
+  className
+}: PermissionModeSelectProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/agent/StatusBar.d.ts
+interface StatusBarProps {
+  state: TranscriptState;
+  connected: boolean;
+  className?: string;
+}
+declare function StatusBar({
+  state,
+  connected,
+  className
+}: StatusBarProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/agent/SessionList.d.ts
+interface SessionListItemProps {
+  session: SessionInfo;
+  active?: boolean;
+  onSelect?: (id: string) => void;
+  onDelete?: (id: string) => void;
+}
+declare function SessionListItem({
+  session,
+  active,
+  onSelect,
+  onDelete
+}: SessionListItemProps): _$react.JSX.Element;
+interface SessionListProps {
+  sessions: SessionInfo[];
+  activeId?: string;
+  onSelect?: (id: string) => void;
+  onDelete?: (id: string) => void;
+  emptyText?: string;
+  className?: string;
+}
+declare function SessionList({
+  sessions,
+  activeId,
+  onSelect,
+  onDelete,
+  emptyText,
+  className
+}: SessionListProps): _$react.JSX.Element;
+//#endregion
+//#region src/components/agent/status.d.ts
+declare const STATUS_META: Record<SessionStatus, {
+  label: string;
+  variant: NonNullable<BadgeProps['variant']>;
+  busy: boolean;
+}>;
+//#endregion
+//#region src/lib/utils.d.ts
+declare function cn(...inputs: ClassValue[]): string;
+//#endregion
+//#region src/lib/format.d.ts
+declare function formatCost(usd: number | undefined): string;
+declare function formatDuration(ms: number): string;
+/** Compact token count, Claude Code-style: 850 → "850", 359_000 → "359.0k", 1_200_000 → "1.2M". */
+declare function formatTokens(tokens: number): string;
+declare function formatBytes(bytes: number): string;
+/** Countdown to an epoch-ms deadline: "2h 18m", "12m", "<1m"; "now" once passed. */
+declare function formatCountdown(untilEpochMs: number, now?: number): string;
+declare function formatRelativeTime(epochMs: number | undefined, now?: number): string;
+/** Compact one-line preview of a tool input for card headers. */
+declare function toolInputPreview(input: unknown, max?: number): string;
+//#endregion
+export { AlertDialog, AlertDialogClose, AlertDialogContent, AlertDialogDescription, AlertDialogTitle, AlertDialogTrigger, Badge, type BadgeProps, Button, type ButtonProps, Card, CardContent, CardHeader, CardTitle, type ChipSegment, CodeBlock, type CodeBlockProps, Composer, type ComposerProps, Conversation, ConversationContent, type ConversationProps, ConversationScrollButton, CopyButton, type CopyButtonProps, FileCard, type FileCardProps, type FileDeliveredItem, Input, Loader, Message, MessageContent, type MessageProps, ModelSelect, type ModelSelectProps, PERMISSION_MODES, type PermissionModeMeta, PermissionModeSelect, type PermissionModeSelectProps, PermissionPrompt, type PermissionPromptProps, ProgressRing, type ProgressRingProps, PromptArea, type PromptAreaHandle, type PromptAreaProps, QUESTION_BEHAVIORS, type QuestionBehaviorMeta, QuestionPrompt, type QuestionPromptProps, Reasoning, type ReasoningProps, Response, type ResponseProps, STATUS_META, type Segment, Select, SelectContent, SelectItem, SelectItemText, SelectTrigger, SelectValue, SessionList, SessionListItem, type SessionListItemProps, type SessionListProps, SessionPanel, type SessionPanelProps, Spinner, StatusBar, type StatusBarProps, type TextSegment, Textarea, Tip, Toaster, ToolCallCard, type ToolCallCardProps, type ToolCallItem, TooltipContent, TooltipProvider, Transcript, type TranscriptProps, type TriggerConfig, type TriggerSuggestion, badgeVariants, buttonVariants, cn, commandTrigger, formatBytes, formatCost, formatCountdown, formatDuration, formatRelativeTime, formatTokens, getChipsByTrigger, hashtagTrigger, isSegmentsEmpty, mentionTrigger, parseUserQuestions, plainTextToSegments, segmentsToPlainText, toast, toolInputPreview, usePromptAreaState };
+//# sourceMappingURL=index.d.mts.map