sparkdesign 0.0.1 → 0.2.6

package/dist/registry/chat/mermaid-part.d.ts

@@ -0,0 +1,17 @@
+/**
+ * [INPUT]: (MermaidPartProps) - content (Mermaid 源码)；可选 headerIcon，未指定则用内联 SVG
+ * [OUTPUT]: (JSX.Element)
+ * [POS]: registry/chat - 从 QodeChatPanel 移植，全 token 化；mermaid 动态 import，未安装时降级提示
+ */
+import { type ReactNode } from 'react';
+export interface MermaidPartProps {
+    content?: string;
+    className?: string;
+    headerIcon?: ReactNode;
+    /** 布局风格，与 data-style 一致（如 soft/neutral/sharp），用于图表节点圆角等；不传则从 document 读取 */
+    dataStyle?: string;
+}
+export declare function MermaidPart({ content, className, headerIcon, dataStyle }: MermaidPartProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace MermaidPart {
+    var displayName: string;
+}

package/dist/registry/chat/permission-card.d.ts

@@ -0,0 +1,24 @@
+import type { HTMLAttributes, ButtonHTMLAttributes } from 'react';
+import type { ReactNode } from 'react';
+export interface PermissionCardAction extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children'> {
+    label: string;
+}
+export interface PermissionCardProps extends HTMLAttributes<HTMLDivElement> {
+    title?: string;
+    description?: string;
+    command: string;
+    commandIntent?: string;
+    isLoadingIntent?: boolean;
+    onClose?: () => void;
+    actions?: {
+        deny?: PermissionCardAction;
+        allowOnce?: PermissionCardAction;
+    };
+    closeIcon?: ReactNode;
+    warningIcon?: ReactNode;
+    /** 主库 i18n：展开/折叠按钮文案 */
+    expandLabel?: string;
+    collapseLabel?: string;
+    commaLabel?: string;
+}
+export declare const PermissionCard: import("react").ForwardRefExoticComponent<PermissionCardProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/registry/chat/plan-part.d.ts

@@ -0,0 +1,30 @@
+/**
+ * [INPUT]: (PlanPartProps) - title、description、content、View/Build/Built；可选 headerIcon/downloadIcon/builtIcon，未指定则用内联 SVG
+ * [OUTPUT]: (JSX.Element)
+ * [POS]: registry/chat - 从 QodeChatPanel 移植，全 token 化
+ */
+import type { ReactNode } from 'react';
+export interface PlanPartProps {
+    title?: string;
+    description?: string;
+    content: string;
+    viewText?: string;
+    buildText?: string;
+    builtText?: string;
+    isBuilt?: boolean;
+    isGenerating?: boolean;
+    onView?: () => void;
+    onBuild?: () => void;
+    onDownload?: () => void;
+    defaultExpanded?: boolean;
+    contentMaxHeight?: number;
+    collapsible?: boolean;
+    className?: string;
+    headerIcon?: ReactNode;
+    downloadIcon?: ReactNode;
+    builtIcon?: ReactNode;
+}
+export declare function PlanPart({ title, description, content, viewText, buildText, builtText, isBuilt, isGenerating, onView, onBuild, onDownload, defaultExpanded, contentMaxHeight, collapsible, className, headerIcon, downloadIcon, builtIcon, }: PlanPartProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace PlanPart {
+    var displayName: string;
+}

package/dist/registry/chat/question-part.d.ts

@@ -0,0 +1,24 @@
+/**
+ * [INPUT]: (QuestionPartProps) - title、question、skipText/runText；可选 headerIcon，未指定则用内联 SVG
+ * [OUTPUT]: (JSX.Element)
+ * [POS]: registry/chat - 从 QodeChatPanel 移植，全 token 化
+ */
+import type { ReactNode } from 'react';
+export interface QuestionPartProps {
+    title?: string;
+    question: string;
+    skipText?: string;
+    runText?: string;
+    askTimeText?: string;
+    onSkip?: () => void;
+    onRun?: () => void;
+    onAskTimeChange?: (value: string) => void;
+    contentMaxHeight?: number;
+    collapsible?: boolean;
+    className?: string;
+    headerIcon?: ReactNode;
+}
+export declare function QuestionPart({ title, question, skipText, runText, askTimeText, onSkip, onRun, contentMaxHeight, collapsible, className, headerIcon, }: QuestionPartProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace QuestionPart {
+    var displayName: string;
+}

package/dist/registry/chat/queue-indicator.d.ts

@@ -0,0 +1,27 @@
+import type { ReactNode } from 'react';
+export interface QueueIndicatorItem {
+    id: string;
+    label: ReactNode;
+    attachmentCount?: number;
+}
+export interface QueueIndicatorLabels {
+    title?: string;
+    sendNowTip?: string;
+    removeTip?: string;
+    fileLabel?: string;
+    filesLabel?: string;
+}
+export interface QueueIndicatorProps {
+    items: QueueIndicatorItem[];
+    onRemoveItem?: (itemId: string) => void;
+    onSendNow?: (itemId: string) => void;
+    isStreaming?: boolean;
+    hasStatusCardBelow?: boolean;
+    labels?: QueueIndicatorLabels;
+    defaultExpanded?: boolean;
+    storageKey?: string;
+    arrowUpIcon?: ReactNode;
+    closeIcon?: ReactNode;
+    arrowDownSIcon?: ReactNode;
+}
+export declare const QueueIndicator: import("react").NamedExoticComponent<QueueIndicatorProps>;

package/dist/registry/chat/reasoning-step.d.ts

@@ -0,0 +1,35 @@
+import type { ReactNode } from 'react';
+export type ReasoningStepDetail = {
+    type: 'action';
+    action: string;
+    desc?: string;
+    details?: ReasoningStepDetail[];
+} | {
+    type: 'file';
+    filename: string;
+    lines?: string;
+    path?: string;
+    fileType?: string;
+    details?: ReasoningStepDetail[];
+};
+export interface ReasoningStepProps {
+    text: ReactNode;
+    description?: string;
+    status?: 'completed' | 'in-progress';
+    icon?: ReactNode;
+    showIcon?: boolean;
+    details?: ReasoningStepDetail[];
+    children?: ReactNode;
+    duration?: number;
+    spread?: number;
+    disableExpandAnimation?: boolean;
+    defaultExpanded?: boolean;
+    expanded?: boolean;
+    onExpandedChange?: (expanded: boolean) => void;
+    eyeIcon?: ReactNode;
+    arrowRightIcon?: ReactNode;
+}
+export declare function ReasoningStep({ text, description, status, icon, showIcon, details, children, duration, spread, disableExpandAnimation, defaultExpanded, expanded: expandedProp, onExpandedChange, eyeIcon, arrowRightIcon, }: ReasoningStepProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace ReasoningStep {
+    var displayName: string;
+}

package/dist/registry/chat/related-prompts.d.ts

@@ -0,0 +1,23 @@
+/**
+ * [INPUT]: (RelatedPromptsProps) - 推荐 prompt 列表
+ * [OUTPUT]: (JSX.Element) - 输入框上方的相关推荐 prompt 列表
+ * [POS]: registry/chat - 唯一来源，主库可注入 defaultIcon
+ */
+import type { ReactNode } from 'react';
+export interface RelatedPromptItem {
+    text: string;
+    prompt: string;
+    icon?: ReactNode;
+}
+export interface RelatedPromptsProps {
+    items: RelatedPromptItem[];
+    onSelect?: (item: RelatedPromptItem) => void;
+    singleLineText?: boolean;
+    className?: string;
+    /** 主库可注入 useIcon('chat3')；不传则用 Chat3Line */
+    defaultIcon?: ReactNode;
+}
+export declare function RelatedPrompts({ items, onSelect, singleLineText, className, defaultIcon, }: RelatedPromptsProps): import("react/jsx-runtime").JSX.Element | null;
+export declare namespace RelatedPrompts {
+    var displayName: string;
+}

package/dist/registry/chat/request.d.ts

@@ -0,0 +1,6 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+export interface RequestProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    children: ReactNode;
+    maxWidth?: string | number;
+}
+export declare const Request: import("react").ForwardRefExoticComponent<RequestProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/registry/chat/response.d.ts

@@ -0,0 +1,28 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+import type { ReasoningStepDetail } from './reasoning-step';
+export type ResponsePhase = 'thinking' | 'streaming' | 'done' | 'imageGenerating';
+export type ResponseStepToolType = 'read' | 'edit' | 'search';
+export interface ResponseStep {
+    text: string;
+    description?: string;
+    details?: ReasoningStepDetail[];
+    toolType?: ResponseStepToolType;
+}
+export interface ResponseRound {
+    step: ResponseStep;
+    simpleMd: string;
+}
+export interface ResponseProps extends HTMLAttributes<HTMLDivElement> {
+    simulate?: boolean;
+    phase?: ResponsePhase;
+    rounds?: ResponseRound[];
+    finalMarkdown?: string;
+    onSimulateComplete?: () => void;
+    onStepChange?: (text: string, toolType?: ResponseStepToolType) => void;
+    /** 主库可注入带 Lottie 的 ThinkingIndicator，与独立 ThinkingIndicator 动效一致 */
+    thinkingIndicator?: ReactNode;
+}
+export declare function Response({ simulate, phase, rounds, finalMarkdown, onSimulateComplete, onStepChange, thinkingIndicator, className, ...props }: ResponseProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Response {
+    var displayName: string;
+}

package/dist/registry/chat/send-button.d.ts

@@ -0,0 +1,17 @@
+import type { ButtonHTMLAttributes, ReactNode } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+declare const sendButtonVariants: (props?: ({
+    status?: "normal" | "generating" | "recording" | "stopRecording" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare const sendButtonIconVariants: (props?: ({
+    status?: "normal" | "generating" | "recording" | "stopRecording" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface SendButtonProps extends ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof sendButtonVariants> {
+    status?: 'normal' | 'generating' | 'recording' | 'stopRecording';
+    /** 主库可注入 useIcon('send')；不传则用 registry 内联图标 */
+    sendIcon?: ReactNode;
+    stopIcon?: ReactNode;
+    micIcon?: ReactNode;
+}
+export declare const SendButton: import("react").ForwardRefExoticComponent<SendButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
+export { sendButtonVariants, sendButtonIconVariants };

package/dist/registry/chat/sidebar-menu.d.ts

@@ -0,0 +1,23 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+export interface SidebarMenuItemAction {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    onClick?: () => void;
+    destructive?: boolean;
+}
+export interface SidebarMenuItem {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    disabled?: boolean;
+    actions?: SidebarMenuItemAction[];
+}
+export interface SidebarMenuProps extends HTMLAttributes<HTMLDivElement> {
+    items: SidebarMenuItem[];
+    selectedId?: string;
+    onItemClick?: (item: SidebarMenuItem) => void;
+    width?: string;
+    moreIcon?: ReactNode;
+}
+export declare const SidebarMenu: import("react").ForwardRefExoticComponent<SidebarMenuProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/registry/chat/streaming-markdown-block.d.ts

@@ -0,0 +1,8 @@
+export interface StreamingMarkdownBlockProps {
+    content: string;
+    isActive: boolean;
+    onStreamComplete?: () => void;
+    tokenDelayMs?: number;
+    className?: string;
+}
+export declare function StreamingMarkdownBlock({ content, isActive, onStreamComplete, tokenDelayMs, className, }: StreamingMarkdownBlockProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/registry/chat/suggestion-part.d.ts

@@ -0,0 +1,28 @@
+/**
+ * [INPUT]: (SuggestionPartProps) - 建议横幅
+ * [OUTPUT]: (JSX.Element)
+ * [POS]: registry/chat - 唯一来源，主库再导出并注入图标
+ */
+import type { ReactNode } from 'react';
+export interface SuggestionPartProps {
+    type?: 'wiki' | 'credits';
+    title?: string;
+    description?: string;
+    highlightText?: string;
+    language?: string;
+    rechargeText?: string;
+    onClose?: () => void;
+    onGenerate?: () => void;
+    onRecharge?: () => void;
+    onLanguageChange?: (language: string) => void;
+    closeIcon?: ReactNode;
+    arrowDownSIcon?: ReactNode;
+    suggestionIcon?: ReactNode;
+    /** 供 Portal 浮层继承（与 ChatInput FolderButton 一致），不传则由 dropdown-menu 使用 getThemeFromDocument() 兜底 */
+    dataStyle?: string;
+    dataTheme?: string;
+}
+export declare function SuggestionPart({ type, title, description, highlightText, language, rechargeText, onClose, onGenerate, onRecharge, onLanguageChange, closeIcon, arrowDownSIcon, suggestionIcon, dataStyle, dataTheme, }: SuggestionPartProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace SuggestionPart {
+    var displayName: string;
+}

package/dist/registry/chat/task-part.d.ts

@@ -0,0 +1,28 @@
+/**
+ * [INPUT]: (TaskPartProps) - tasks、title、currentTaskId；可选 headerIcon/circleIcon/completedIcon/skippedIcon/loaderIcon，未指定则用内联 SVG
+ * [OUTPUT]: (JSX.Element)
+ * [POS]: registry/chat - 从 QodeChatPanel 移植，全 token 化
+ */
+import type { ReactNode } from 'react';
+export type TaskStatus = 'completed' | 'uncompleted' | 'skipped' | 'cancelled';
+export interface TaskPartTask {
+    id?: string;
+    text: string;
+    status?: TaskStatus;
+}
+export interface TaskPartProps {
+    tasks?: TaskPartTask[];
+    title?: string;
+    currentTaskId?: string;
+    defaultExpanded?: boolean;
+    className?: string;
+    headerIcon?: ReactNode;
+    uncompletedIcon?: ReactNode;
+    completedIcon?: ReactNode;
+    skippedIcon?: ReactNode;
+    loaderIcon?: ReactNode;
+}
+export declare function TaskPart({ tasks, title, currentTaskId, defaultExpanded, className, headerIcon, uncompletedIcon, completedIcon, skippedIcon, loaderIcon, }: TaskPartProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace TaskPart {
+    var displayName: string;
+}

package/dist/registry/chat/terminal-code-block-part.d.ts

@@ -0,0 +1,18 @@
+/**
+ * [INPUT]: (TerminalCodeBlockPartProps) - command、output、autoRanCommand；可选 headerIcon/externalLinkIcon，未指定则用内联 SVG
+ * [OUTPUT]: (JSX.Element)
+ * [POS]: registry/chat - 从 QodeChatPanel 移植，全 token 化；不依赖 prism，纯样式
+ */
+import type { ReactNode } from 'react';
+export interface TerminalCodeBlockPartProps {
+    command?: string;
+    output?: string;
+    autoRanCommand?: string;
+    className?: string;
+    headerIcon?: ReactNode;
+    externalLinkIcon?: ReactNode;
+}
+export declare function TerminalCodeBlockPart({ command, output, autoRanCommand, className, headerIcon, externalLinkIcon, }: TerminalCodeBlockPartProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace TerminalCodeBlockPart {
+    var displayName: string;
+}

package/dist/registry/chat/thinking-indicator.d.ts

@@ -0,0 +1,14 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+export interface ThinkingIndicatorProps extends HTMLAttributes<HTMLDivElement> {
+    text?: string;
+    textClassName?: string;
+    shimmer?: boolean;
+    shimmerDuration?: number;
+    shimmerSpread?: number;
+    /** 主库可注入 Lottie 等自定义动画；不传则用 CSS 三点脉动 */
+    loader?: ReactNode;
+}
+export declare function ThinkingIndicator({ text, textClassName, shimmer, shimmerDuration, shimmerSpread, className, loader, ...props }: ThinkingIndicatorProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace ThinkingIndicator {
+    var displayName: string;
+}

package/dist/registry/chat/tool-invocation-card.d.ts

@@ -0,0 +1,20 @@
+import type { ReactNode } from 'react';
+export type ToolInvocationStatus = 'running' | 'success' | 'error';
+export interface ToolInvocationCardProps {
+    toolName: string;
+    params?: string;
+    status: ToolInvocationStatus;
+    response?: string;
+    defaultExpanded?: boolean;
+    statusText?: string;
+    className?: string;
+    timeIcon?: ReactNode;
+    checkboxCircleIcon?: ReactNode;
+    closeCircleIcon?: ReactNode;
+    arrowRightIcon?: ReactNode;
+    runningText?: string;
+    ranText?: string;
+    failedText?: string;
+    responseLabel?: string;
+}
+export declare const ToolInvocationCard: import("react").NamedExoticComponent<ToolInvocationCardProps>;

package/dist/registry/chat/user-question/UserQuestionCard.d.ts

@@ -0,0 +1,30 @@
+/**
+ * [INPUT]: 单题数据、answers/customInputs、handlers、labels、当前题/焦点/禁用状态
+ * [OUTPUT]: (JSX.Element) - 单题区块（题干 + OptionList + 自定义输入）
+ * [POS]: registry/chat/user-question
+ */
+import type { Dispatch, MutableRefObject, SetStateAction } from 'react';
+import type { UserQuestionItem, UserQuestionLabels } from './types';
+export interface UserQuestionCardProps {
+    question: UserQuestionItem;
+    qIndex: number;
+    labels: Required<UserQuestionLabels>;
+    answers: Record<string, string[]>;
+    customInputs: Record<string, string>;
+    focusedOptionIndex: number;
+    isCurrentQuestion: boolean;
+    isSubmitting: boolean;
+    allQuestionsAnswered: boolean;
+    questionsLength: number;
+    questionRefs: MutableRefObject<Map<number, HTMLDivElement>>;
+    customInputRefs: MutableRefObject<Map<string, HTMLInputElement>>;
+    setCurrentQuestionIndex: (i: number) => void;
+    setFocusedOptionIndex: (i: number) => void;
+    setAnswers: Dispatch<SetStateAction<Record<string, string[]>>>;
+    setCustomInputs: Dispatch<SetStateAction<Record<string, string>>>;
+    getSelectedOptionIndex: (i: number) => number;
+    shouldScrollToQuestionRef: MutableRefObject<boolean>;
+    onOptionClick: (questionText: string, optionLabel: string, questionIndex: number) => void;
+    onContinue: () => void;
+}
+export declare function UserQuestionCard({ question, qIndex, labels, answers, customInputs, focusedOptionIndex, isCurrentQuestion, isSubmitting, allQuestionsAnswered, questionsLength, questionRefs, customInputRefs, setCurrentQuestionIndex, setFocusedOptionIndex, setAnswers, setCustomInputs, getSelectedOptionIndex, shouldScrollToQuestionRef, onOptionClick, onContinue, }: UserQuestionCardProps): import("react/jsx-runtime").JSX.Element;

package/dist/registry/chat/user-question/UserQuestionFooter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * [INPUT]: labels、推荐/跳过/继续 handlers、disabled、sparklingIcon
+ * [OUTPUT]: (JSX.Element) - 底部操作区
+ * [POS]: registry/chat/user-question
+ */
+import type { ReactNode } from 'react';
+import type { UserQuestionLabels } from './types';
+export interface UserQuestionFooterProps {
+    labels: Required<UserQuestionLabels>;
+    sparklingIcon: ReactNode;
+    isSubmitting: boolean;
+    hasCustomText: boolean;
+    allQuestionsAnswered: boolean;
+    onRecommend: () => void;
+    onSkip: () => void;
+    onContinue: () => void;
+}
+export declare function UserQuestionFooter({ labels, sparklingIcon, isSubmitting, hasCustomText, allQuestionsAnswered, onRecommend, onSkip, onContinue, }: UserQuestionFooterProps): import("react/jsx-runtime").JSX.Element;

package/dist/registry/chat/user-question/UserQuestionHeader.d.ts

@@ -0,0 +1,20 @@
+/**
+ * [INPUT]: 当前题、题数、labels、图标、上一/下一、disabled
+ * [OUTPUT]: (JSX.Element) - 顶部标题与题号切换
+ * [POS]: registry/chat/user-question
+ */
+import type { ReactNode } from 'react';
+import type { UserQuestionItem } from './types';
+import type { UserQuestionLabels } from './types';
+export interface UserQuestionHeaderProps {
+    currentQuestion: UserQuestionItem | undefined;
+    questionsLength: number;
+    labels: Required<UserQuestionLabels>;
+    chat4Icon: ReactNode;
+    arrowUpSIcon: ReactNode;
+    arrowDownSIcon: ReactNode;
+    currentQuestionIndex: number;
+    onPrevious: () => void;
+    onNext: () => void;
+}
+export declare function UserQuestionHeader({ currentQuestion, questionsLength, labels, chat4Icon, arrowUpSIcon, arrowDownSIcon, currentQuestionIndex, onPrevious, onNext, }: UserQuestionHeaderProps): import("react/jsx-runtime").JSX.Element;

package/dist/registry/chat/user-question/index.d.ts

@@ -0,0 +1,7 @@
+import { type UserQuestionProps, type UserQuestionHandle } from './types';
+export type { UserQuestionOption, UserQuestionItem, UserQuestionLabels, UserQuestionProps, UserQuestionHandle, } from './types';
+export { DEFAULT_LABELS, NO_PREFERENCE_VALUE } from './types';
+export { UserQuestionHeader } from './UserQuestionHeader';
+export { UserQuestionCard } from './UserQuestionCard';
+export { UserQuestionFooter } from './UserQuestionFooter';
+export declare const UserQuestion: import("react").NamedExoticComponent<UserQuestionProps & import("react").RefAttributes<UserQuestionHandle>>;

package/dist/registry/chat/user-question/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * [INPUT]: 无（类型定义模块）
+ * [OUTPUT]: 导出 UserQuestion 相关类型与常量
+ * [POS]: registry/chat/user-question - 唯一类型来源
+ *
+ * [PROTOCOL]:
+ * 1. 类型/常量变更时同步更新 index 的 re-export
+ */
+import type { ReactNode } from 'react';
+/** 单个问题的选项 */
+export interface UserQuestionOption {
+    label: string;
+    description?: string;
+}
+/** 单个问题 */
+export interface UserQuestionItem {
+    question: string;
+    header?: string;
+    options: UserQuestionOption[];
+    multiSelect?: boolean;
+    /** 是否允许用户自定义输入（默认 true） */
+    allowCustomInput?: boolean;
+}
+export interface UserQuestionLabels {
+    multiSelect?: string;
+    singleSelect?: string;
+    questionHeader?: string;
+    skipAll?: string;
+    continue?: string;
+    submit?: string;
+    sending?: string;
+    customInputPlaceholder?: string;
+    recommend?: string;
+}
+export declare const DEFAULT_LABELS: Required<UserQuestionLabels>;
+/** 跳过问题时填充的默认值 */
+export declare const NO_PREFERENCE_VALUE = "[No preference]";
+export interface UserQuestionProps {
+    questions: UserQuestionItem[];
+    resetKey?: string;
+    onAnswer: (answers: Record<string, string>) => void;
+    onSkip: () => void;
+    hasCustomText?: boolean;
+    labels?: UserQuestionLabels;
+    chat4Icon?: ReactNode;
+    arrowUpSIcon?: ReactNode;
+    arrowDownSIcon?: ReactNode;
+    sparklingIcon?: ReactNode;
+}
+export interface UserQuestionHandle {
+    getAnswers: () => Record<string, string>;
+}

package/dist/registry/chat/user-question/useUserQuestionKeyboard.d.ts

@@ -0,0 +1,18 @@
+import type { MutableRefObject } from 'react';
+import type { UserQuestionItem, UserQuestionOption } from './types';
+export interface UseUserQuestionKeyboardProps {
+    isSubmitting: boolean;
+    currentQuestion: UserQuestionItem | undefined;
+    currentOptions: UserQuestionOption[];
+    currentQuestionIndex: number;
+    questions: UserQuestionItem[];
+    focusedOptionIndex: number;
+    setFocusedOptionIndex: (n: number) => void;
+    currentQuestionHasAnswer: boolean;
+    getSelectedOptionIndex: (i: number) => number;
+    shouldScrollToQuestionRef: MutableRefObject<boolean>;
+    setCurrentQuestionIndex: (i: number) => void;
+    handleOptionClick: (questionText: string, optionLabel: string, questionIndex: number) => void;
+    handleContinue: () => void;
+}
+export declare function useUserQuestionKeyboard({ isSubmitting, currentQuestion, currentOptions, currentQuestionIndex, questions, focusedOptionIndex, setFocusedOptionIndex, currentQuestionHasAnswer, getSelectedOptionIndex, shouldScrollToQuestionRef, setCurrentQuestionIndex, handleOptionClick, handleContinue, }: UseUserQuestionKeyboardProps): void;

package/dist/registry/chat/user-question/useUserQuestionState.d.ts

@@ -0,0 +1,26 @@
+import type { Ref } from 'react';
+import type { UserQuestionItem, UserQuestionHandle } from './types';
+export interface UseUserQuestionStateProps {
+    questions: UserQuestionItem[];
+    resetKey?: string;
+    onAnswer: (answers: Record<string, string>) => void;
+    ref: Ref<UserQuestionHandle | null>;
+}
+export declare function useUserQuestionState({ questions, resetKey, ref, }: UseUserQuestionStateProps): {
+    currentQuestionIndex: number;
+    setCurrentQuestionIndex: import("react").Dispatch<import("react").SetStateAction<number>>;
+    answers: Record<string, string[]>;
+    setAnswers: import("react").Dispatch<import("react").SetStateAction<Record<string, string[]>>>;
+    customInputs: Record<string, string>;
+    setCustomInputs: import("react").Dispatch<import("react").SetStateAction<Record<string, string>>>;
+    focusedOptionIndex: number;
+    setFocusedOptionIndex: import("react").Dispatch<import("react").SetStateAction<number>>;
+    isSubmitting: boolean;
+    setIsSubmitting: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    maxQuestionHeight: number | undefined;
+    scrollContainerRef: import("react").RefObject<HTMLDivElement | null>;
+    questionRefs: import("react").RefObject<Map<number, HTMLDivElement>>;
+    shouldScrollToQuestionRef: import("react").RefObject<boolean>;
+    customInputRefs: import("react").RefObject<Map<string, HTMLInputElement>>;
+    getSelectedOptionIndex: (questionIndex: number) => number;
+};

package/dist/registry/chat/user-question-answer.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from 'react';
+export interface UserQuestionAnswerLabels {
+    answer?: string;
+    answers?: string;
+}
+export interface UserQuestionAnswerProps {
+    answers: Record<string, string>;
+    showHeader?: boolean;
+    labels?: UserQuestionAnswerLabels;
+    className?: string;
+    questionAnswerIcon?: ReactNode;
+}
+export declare const UserQuestionAnswer: import("react").NamedExoticComponent<UserQuestionAnswerProps>;

package/dist/registry/lib/file-icon-maps.d.ts

@@ -0,0 +1,20 @@
+/**
+ * [INPUT]: (无) - 文件图标映射配置
+ * [OUTPUT]: FILE_TYPE_MAP, SETI_CHAR_MAP, SETI_COLOR_MAP, getSetiIconType, getSetiIcon, getSetiIconColor, getFileIconColorClass
+ * [POS]: registry/lib - 与 QodeChatPanel utils/fileIconMaps 一致，供 FileReviewPart、ReasoningStep 等使用
+ *
+ * SETI_CHAR_MAP 与 QodeChatPanel 一致（qoder-seti.woff 使用 E054=js、E059=json 等）。
+ *
+ * [PROTOCOL]:
+ * 1. 新增文件类型须同时更新 SETI_CHAR_MAP、SETI_COLOR_MAP、FILE_TYPE_MAP
+ * 2. 使用 Seti 时需加载 qoder-seti.woff 并 @font-face font-family: 'Seti'（与 QodeChatPanel 同源字体）
+ */
+export declare const SETI_CHAR_MAP: Record<string, string>;
+export declare const SETI_COLOR_MAP: Record<string, string>;
+export declare const FILE_TYPE_MAP: Record<string, string>;
+export declare const TYPE_TO_TOKEN_CLASS: Record<string, string>;
+export declare function getSetiIconType(fileType?: string, filename?: string): string;
+export declare function getSetiIcon(fileType?: string, filename?: string): string;
+export declare function getSetiIconColor(fileType?: string, filename?: string): string;
+/** 返回 Tailwind token 类名，用于通用文件图标（非 Seti 字体） */
+export declare function getFileIconColorClass(fileType?: string, filename?: string): string;

package/dist/registry/lib/use-mermaid-render.d.ts

@@ -0,0 +1,5 @@
+export interface UseMermaidRenderResult {
+    svg: string;
+    error: string;
+}
+export declare function useMermaidRender(content: string, id: string, dataStyle?: string): UseMermaidRenderResult;

package/dist/registry/lib/utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * [INPUT]: (ClassValue[])
+ * [OUTPUT]: (string) - 合并后的 class 名
+ * [POS]: registry/lib/utils - 注册表工具函数，复制到用户项目后可自由修改
+ *
+ * [PROTOCOL]:
+ * 1. 用户可自由修改此文件
+ * 2. 更新时使用 npx sparkdesign diff utils 查看差异
+ */
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;