sparkdesign 0.4.3 → 0.4.5

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/compound.d.ts

@@ -0,0 +1,37 @@
+import type { ReactNode } from 'react';
+import type { UserQuestionItem } from './types';
+export interface UserQuestionHeaderProps {
+    className?: string;
+}
+export declare function UserQuestionHeader({ className }: UserQuestionHeaderProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace UserQuestionHeader {
+    var displayName: string;
+}
+export interface UserQuestionCardProps {
+    question: UserQuestionItem;
+    qIndex: number;
+    className?: string;
+}
+export declare function UserQuestionCard({ question, qIndex, className }: UserQuestionCardProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace UserQuestionCard {
+    var displayName: string;
+}
+export interface UserQuestionCardsProps {
+    className?: string;
+    children?: ReactNode;
+}
+export declare function UserQuestionCards({ className, children }: UserQuestionCardsProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace UserQuestionCards {
+    var displayName: string;
+}
+export interface UserQuestionFooterProps {
+    className?: string;
+}
+export declare function UserQuestionFooter({ className }: UserQuestionFooterProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace UserQuestionFooter {
+    var displayName: string;
+}
+export declare function UserQuestionDefaultLayout(): import("react/jsx-runtime").JSX.Element;
+export declare namespace UserQuestionDefaultLayout {
+    var displayName: string;
+}

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

@@ -0,0 +1,55 @@
+import type { ReactNode, MutableRefObject, Dispatch, SetStateAction } from 'react';
+import { type UserQuestionItem, type UserQuestionLabels, type UserQuestionHandle } from './types';
+export interface UserQuestionContextValue {
+    questions: UserQuestionItem[];
+    labels: Required<UserQuestionLabels>;
+    currentQuestionIndex: number;
+    setCurrentQuestionIndex: (i: number) => void;
+    answers: Record<string, string[]>;
+    setAnswers: Dispatch<SetStateAction<Record<string, string[]>>>;
+    customInputs: Record<string, string>;
+    setCustomInputs: Dispatch<SetStateAction<Record<string, string>>>;
+    focusedOptionIndex: number;
+    setFocusedOptionIndex: (i: number) => void;
+    isSubmitting: boolean;
+    setIsSubmitting: (v: boolean) => void;
+    maxQuestionHeight: number | undefined;
+    scrollContainerRef: MutableRefObject<HTMLDivElement | null>;
+    questionRefs: MutableRefObject<Map<number, HTMLDivElement>>;
+    customInputRefs: MutableRefObject<Map<string, HTMLInputElement>>;
+    setShouldScrollToQuestion: (v: boolean) => void;
+    currentQuestion: UserQuestionItem | undefined;
+    currentOptions: {
+        label: string;
+        description?: string;
+    }[];
+    allQuestionsAnswered: boolean;
+    currentQuestionHasAnswer: boolean;
+    getSelectedOptionIndex: (i: number) => number;
+    handleOptionClick: (questionText: string, optionLabel: string, questionIndex: number) => void;
+    handlePrevious: () => void;
+    handleNext: () => void;
+    handleContinue: () => void;
+    handleSkip: () => void;
+    handleRecommend: () => void;
+    chat4Icon: ReactNode;
+    arrowUpSIcon: ReactNode;
+    arrowDownSIcon: ReactNode;
+    sparklingIcon: ReactNode;
+    hasCustomText: boolean;
+}
+export declare function useUserQuestionContext(): UserQuestionContextValue;
+export interface UserQuestionRootProps {
+    questions: UserQuestionItem[];
+    resetKey?: string;
+    onAnswer: (answers: Record<string, string>) => void;
+    onSkip: () => void;
+    hasCustomText?: boolean;
+    labels?: UserQuestionLabels;
+    chat4Icon?: ReactNode;
+    arrowUpSIcon?: ReactNode;
+    arrowDownSIcon?: ReactNode;
+    sparklingIcon?: ReactNode;
+    children?: ReactNode;
+}
+export declare const UserQuestionRootProvider: import("react").ForwardRefExoticComponent<UserQuestionRootProps & import("react").RefAttributes<UserQuestionHandle>>;

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

@@ -0,0 +1,15 @@
+import { useUserQuestionContext, type UserQuestionRootProps } from './context';
+import { UserQuestionHeader, UserQuestionCard, UserQuestionCards, UserQuestionFooter, UserQuestionDefaultLayout } from './compound';
+import type { UserQuestionProps, UserQuestionHandle } from './types';
+export type { UserQuestionOption, UserQuestionItem, UserQuestionLabels, UserQuestionProps, UserQuestionHandle, } from './types';
+export { DEFAULT_LABELS, NO_PREFERENCE_VALUE } from './types';
+export interface UserQuestionCompound {
+    Root: React.ForwardRefExoticComponent<UserQuestionRootProps & React.RefAttributes<UserQuestionHandle>>;
+    Header: typeof UserQuestionHeader;
+    Card: typeof UserQuestionCard;
+    Cards: typeof UserQuestionCards;
+    Footer: typeof UserQuestionFooter;
+    DefaultLayout: typeof UserQuestionDefaultLayout;
+}
+export declare const UserQuestion: React.ForwardRefExoticComponent<UserQuestionProps & React.RefAttributes<UserQuestionHandle>> & UserQuestionCompound;
+export { useUserQuestionContext, UserQuestionDefaultLayout };

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,17 @@
+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;
+    setShouldScrollToQuestion: (v: boolean) => void;
+    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, setShouldScrollToQuestion, 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;