sparkdesign 0.4.5 → 0.4.7

package/dist/registry/chat/hint-banner.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (HintBannerProps) - 提示横幅
- * [OUTPUT]: (JSX.Element)
- * [POS]: registry/chat - 唯一来源，主库再导出并注入图标
+ * [WHO]: Public exports from this file (see implementation below).
+ * [FROM]: See the import block immediately after this header.
+ * [TO]: sparkdesign package consumers; output of CLI `add` when applicable.
+ * [HERE]: registry/chat/hint-banner.tsx — Spark Design source; keep aligned with the main library.
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 import type { ReactNode } from 'react';
 export interface HintBannerProps {

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

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (MermaidPartProps) - content (Mermaid 源码)；可选 headerIcon，未指定则用内联 SVG
- * [OUTPUT]: (JSX.Element)
- * [POS]: registry/chat - 从 QodeChatPanel 移植，全 token 化；mermaid 动态 import，未安装时降级提示
+ * [WHO]: Output: (JSX.Element); Inputs: (MermaidPartProps) - content (Mermaid source); optional headerIcon; falls back to inline SVG when omitted
+ * [FROM]: react; rel:../basic/collapsible-card; rel:../basic/button; rel:../basic/icons-inline; rel:../basic/scrollbar; rel:../lib/use-mermaid-render
+ * [TO]: CLI `add` copy target; canonical implementation in `src/components`
+ * [HERE]: registry/chat - Ported from QodeChatPanel; tokenized; dynamic mermaid import with fallback when the dependency is missing
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when behavior changes
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when needed
+ * 3. Follow repository conventions for tokens and exports
  */
 import { type ReactNode } from 'react';
 export interface MermaidPartProps {

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

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (PlanPartProps) - title、description、content、View/Build/Built；可选 headerIcon/downloadIcon/builtIcon，未指定则用内联 SVG
- * [OUTPUT]: (JSX.Element)
- * [POS]: registry/chat - 从 QodeChatPanel 移植，全 token 化
+ * [WHO]: Public exports from this file (see implementation below).
+ * [FROM]: See the import block immediately after this header.
+ * [TO]: sparkdesign package consumers; output of CLI `add` when applicable.
+ * [HERE]: registry/chat/plan-part.tsx — Spark Design source; keep aligned with the main library.
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 import type { ReactNode } from 'react';
 export interface PlanPartProps {

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

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: ReasoningStepProps
- * [OUTPUT]: ReasoningStep compound component
- * [POS]: registry/chat/reasoning-step - ReasoningStep 复合组件主入口
+ * [WHO]: Public exports from this file (see implementation below).
+ * [FROM]: See the import block immediately after this header.
+ * [TO]: sparkdesign package consumers; output of CLI `add` when applicable.
+ * [HERE]: registry/chat/reasoning-step/index.tsx — Spark Design source; keep aligned with the main library.
  *
- * 设计模式：shadcn 风格复合组件
- * - ReasoningStep = 便捷导出（Root + DefaultLayout）
- * - ReasoningStep.Root/Header/Details/DetailRow = 复合子组件
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 import { useReasoningStepContext } from './context';
 import type { ReasoningStepProps, ReasoningStepCompound, ReasoningStepDetail, ReasoningStepStatus } from './types';

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

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: N/A
- * [OUTPUT]: Type definitions for ReasoningStep compound component
- * [POS]: registry/chat/reasoning-step - ReasoningStep 组件类型定义
+ * [WHO]: Public exports from this file (see implementation below).
+ * [FROM]: See the import block immediately after this header.
+ * [TO]: sparkdesign package consumers; output of CLI `add` when applicable.
+ * [HERE]: registry/chat/reasoning-step/types.ts — Spark Design source; keep aligned with the main library.
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 import type { ReactNode } from 'react';
 export type ReasoningStepDetail = {

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

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (RelatedPromptsProps) - 推荐 prompt 列表
- * [OUTPUT]: (JSX.Element) - 输入框上方的相关推荐 prompt 列表
- * [POS]: registry/chat - 唯一来源，主库可注入 defaultIcon
+ * [WHO]: Public exports from this file (see implementation below).
+ * [FROM]: See the import block immediately after this header.
+ * [TO]: sparkdesign package consumers; output of CLI `add` when applicable.
+ * [HERE]: registry/chat/related-prompts.tsx — Spark Design source; keep aligned with the main library.
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 import type { ReactNode } from 'react';
 export interface RelatedPromptItem {

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

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: ResponseProps
- * [OUTPUT]: Response compound component
- * [POS]: registry/chat/response - Response 复合组件主入口
+ * [WHO]: Public exports from this file (see implementation below).
+ * [FROM]: See the import block immediately after this header.
+ * [TO]: sparkdesign package consumers; output of CLI `add` when applicable.
+ * [HERE]: registry/chat/response/index.tsx — Spark Design source; keep aligned with the main library.
  *
- * 设计模式：shadcn 风格复合组件
- * - Response = 便捷导出（Root + DefaultLayout）
- * - Response.Root/Thinking/Steps/Step/Content/ImageGenerating = 复合子组件
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 import type { HTMLAttributes } from 'react';
 import { useResponseContext, DEMO_ROUNDS, DEMO_FINAL_MD } from './context';

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

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: N/A
- * [OUTPUT]: Type definitions for Response compound component
- * [POS]: registry/chat/response - Response 组件类型定义
+ * [WHO]: Public exports from this file (see implementation below).
+ * [FROM]: See the import block immediately after this header.
+ * [TO]: sparkdesign package consumers; output of CLI `add` when applicable.
+ * [HERE]: registry/chat/response/types.ts — Spark Design source; keep aligned with the main library.
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 import type { HTMLAttributes, ReactNode } from 'react';
 import type { ReasoningStepDetail } from '../reasoning-step';

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

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (TaskPartProps) - tasks、title、currentTaskId；可选 headerIcon/circleIcon/completedIcon/skippedIcon/loaderIcon，未指定则用内联 SVG
- * [OUTPUT]: (JSX.Element)
- * [POS]: registry/chat - 从 QodeChatPanel 移植，全 token 化
+ * [WHO]: Public exports from this file (see implementation below).
+ * [FROM]: See the import block immediately after this header.
+ * [TO]: sparkdesign package consumers; output of CLI `add` when applicable.
+ * [HERE]: registry/chat/task-part.tsx — Spark Design source; keep aligned with the main library.
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 import type { ReactNode } from 'react';
 export type TaskStatus = 'completed' | 'uncompleted' | 'skipped' | 'cancelled';

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

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (TerminalCodeBlockPartProps) - command、output、autoRanCommand；可选 headerIcon/externalLinkIcon，未指定则用内联 SVG
- * [OUTPUT]: (JSX.Element)
- * [POS]: registry/chat - 从 QodeChatPanel 移植，全 token 化；不依赖 prism，纯样式
+ * [WHO]: Public exports from this file (see implementation below).
+ * [FROM]: See the import block immediately after this header.
+ * [TO]: sparkdesign package consumers; output of CLI `add` when applicable.
+ * [HERE]: registry/chat/terminal-code-block-part.tsx — Spark Design source; keep aligned with the main library.
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 import type { ReactNode } from 'react';
 export interface TerminalCodeBlockPartProps {

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

@@ -12,6 +12,8 @@ export interface ToolInvocationCardProps {
     checkboxCircleIcon?: ReactNode;
     closeCircleIcon?: ReactNode;
     arrowDownIcon?: ReactNode;
+    /** @deprecated Use arrowDownIcon. */
+    arrowRightIcon?: ReactNode;
     runningText?: string;
     ranText?: string;
     failedText?: string;

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

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: 单题数据、answers/customInputs、handlers、labels、当前题/焦点/禁用状态
- * [OUTPUT]: (JSX.Element) - 单题区块（题干 + OptionList + 自定义输入）
- * [POS]: registry/chat/user-question
+ * [WHO]: Public exports from this file (see implementation below).
+ * [FROM]: See the import block immediately after this header.
+ * [TO]: sparkdesign package consumers; output of CLI `add` when applicable.
+ * [HERE]: registry/chat/user-question/UserQuestionCard.tsx — Spark Design source; keep aligned with the main library.
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 import type { Dispatch, MutableRefObject, SetStateAction } from 'react';
 import type { UserQuestionItem, UserQuestionLabels } from './types';

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

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: labels、推荐/跳过/继续 handlers、disabled、sparklingIcon
- * [OUTPUT]: (JSX.Element) - 底部操作区
- * [POS]: registry/chat/user-question
+ * [WHO]: Public exports from this file (see implementation below).
+ * [FROM]: See the import block immediately after this header.
+ * [TO]: sparkdesign package consumers; output of CLI `add` when applicable.
+ * [HERE]: registry/chat/user-question/UserQuestionFooter.tsx — Spark Design source; keep aligned with the main library.
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 import type { ReactNode } from 'react';
 import type { UserQuestionLabels } from './types';

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

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: 当前题、题数、labels、图标、上一/下一、disabled
- * [OUTPUT]: (JSX.Element) - 顶部标题与题号切换
- * [POS]: registry/chat/user-question
+ * [WHO]: Public exports from this file (see implementation below).
+ * [FROM]: See the import block immediately after this header.
+ * [TO]: sparkdesign package consumers; output of CLI `add` when applicable.
+ * [HERE]: registry/chat/user-question/UserQuestionHeader.tsx — Spark Design source; keep aligned with the main library.
+ *
+ * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 import type { ReactNode } from 'react';
 import type { UserQuestionItem } from './types';

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

@@ -1,10 +1,13 @@
 /**
- * [INPUT]: 无（类型定义模块）
- * [OUTPUT]: 导出 UserQuestion 相关类型与常量
- * [POS]: registry/chat/user-question - 唯一类型来源
+ * [WHO]: Output: exports UserQuestion types and constants; Inputs: none (type-only module)
+ * [FROM]: react
+ * [TO]: CLI `add` copy target; canonical implementation in `src/components`
+ * [HERE]: registry/chat/user-question - single source for types
  *
- * [PROTOCOL]:
- * 1. 类型/常量变更时同步更新 index 的 re-export
+  * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 import type { ReactNode } from 'react';
 /** 单个问题的选项 */

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

@@ -1,13 +1,13 @@
 /**
- * [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 等）。
+ * [WHO]: Public exports from this file (see implementation below).
+ * [FROM]: See the import block immediately after this header.
+ * [TO]: sparkdesign package consumers; output of CLI `add` when applicable.
+ * [HERE]: registry/lib/file-icon-maps.ts — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 新增文件类型须同时更新 SETI_CHAR_MAP、SETI_COLOR_MAP、FILE_TYPE_MAP
- * 2. 使用 Seti 时需加载 qoder-seti.woff 并 @font-face font-family: 'Seti'（与 QodeChatPanel 同源字体）
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 export declare const SETI_CHAR_MAP: Record<string, string>;
 export declare const SETI_COLOR_MAP: Record<string, string>;

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

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (ClassValue[])
- * [OUTPUT]: (string) - 合并后的 class 名
- * [POS]: registry/lib/utils - 注册表工具函数，复制到用户项目后可自由修改
+ * [WHO]: Output: (string) - merged class names; Inputs: (ClassValue[])
+ * [FROM]: clsx; tailwind-merge
+ * [TO]: CLI `add` copy target; canonical implementation in `src/components`
+ * [HERE]: registry/lib/utils - registry helpers; safe to edit after CLI copy
  *
- * [PROTOCOL]:
- * 1. 用户可自由修改此文件
- * 2. 更新时使用 npx sparkdesign diff utils 查看差异
+  * [PROTOCOL]:
+ * 1. Keep this P3 header in sync when the public contract changes.
+ * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
+ * 3. Follow design tokens and explicit type exports.
  */
 import { type ClassValue } from 'clsx';
 export declare function cn(...inputs: ClassValue[]): string;

package/dist/scale/presets/compact.css

@@ -1,6 +1,6 @@
 /* ============================================
  * Preset: Compact - 紧凑风格
- * 优化效率，适合信息密集场景
+ * 小幅压缩控件节奏，适合效率型工作台
  * ============================================ */
 
 [data-style="compact"] {
@@ -15,14 +15,25 @@
   --radius-2xl: 12px;
   --radius-3xl: 16px;
 
-  /* Font Size (略小) */
-  --font-size-sm: 12px;
-  --font-size-lg: 14px;
-  --font-size-xl: 16px;
+  /* Font Size (略小但保持阅读舒适) */
+  --font-size-xs: 12px;
+  --font-size-xs--line-height: 16px;
+  --font-size-sm: 13px;
+  --font-size-sm--line-height: 18px;
+  --font-size-base: 14px;
+  --font-size-base--line-height: 20px;
+  --font-size-lg: 15px;
+  --font-size-lg--line-height: 22px;
+  --font-size-xl: 17px;
+  --font-size-xl--line-height: 24px;
   --font-size-2xl: 18px;
+  --font-size-2xl--line-height: 24px;
   --font-size-3xl: 22px;
+  --font-size-3xl--line-height: 28px;
   --font-size-4xl: 28px;
+  --font-size-4xl--line-height: 32px;
   --font-size-5xl: 34px;
+  --font-size-5xl--line-height: 36px;
   --font-size-6xl: 44px;
   --font-size-7xl: 56px;
   --font-size-8xl: 64px;

package/dist/scale/presets/dense.css

@@ -49,14 +49,25 @@
   /* ChatInput 特殊配置 */
   --chat-status-overlap: 4px;
 
-  /* Font Size (更小) */
-  --font-size-base: 12px;
+  /* Font Size (信息密集：主力 text-sm 也压缩) */
+  --font-size-xs: 11px;
+  --font-size-xs--line-height: 14px;
+  --font-size-sm: 12px;
+  --font-size-sm--line-height: 16px;
+  --font-size-base: 13px;
+  --font-size-base--line-height: 18px;
   --font-size-lg: 14px;
+  --font-size-lg--line-height: 20px;
   --font-size-xl: 14px;
+  --font-size-xl--line-height: 20px;
   --font-size-2xl: 16px;
+  --font-size-2xl--line-height: 22px;
   --font-size-3xl: 18px;
+  --font-size-3xl--line-height: 24px;
   --font-size-4xl: 22px;
+  --font-size-4xl--line-height: 28px;
   --font-size-5xl: 28px;
+  --font-size-5xl--line-height: 32px;
   --font-size-6xl: 36px;
   --font-size-7xl: 44px;
   --font-size-8xl: 56px;

package/dist/scale/presets/sharp.css

@@ -1,12 +1,14 @@
 /* ============================================
  * Preset: Sharp - 锐利风格
- * 几何精度，无圆角 + 等宽字体
+ * 几何精度，无圆角 + 等宽字体 + 硬朗节奏
  * ============================================ */
 
 [data-style="sharp"] {
-  /* Spacing (与 compact 相同) */
+  /* Spacing (方正、克制，少量压缩) */
   --spacing-3: 10px;
   --spacing-4: 14px;
+  --spacing-5: 18px;
+  --spacing-6: 22px;
   --spacing-9: 32px;
   --spacing-11: 40px;
 
@@ -25,13 +27,23 @@
   --font-sans: var(--config-font-mono);
   font-family: var(--font-sans);
 
-  /* Font Size (与 compact 相同) */
-  --font-size-sm: 12px;
-  --font-size-lg: 14px;
-  --font-size-xl: 16px;
+  /* Font Size (工程感：略紧、等宽、层级清楚) */
+  --font-size-xs: 12px;
+  --font-size-xs--line-height: 16px;
+  --font-size-sm: 13px;
+  --font-size-sm--line-height: 18px;
+  --font-size-base: 14px;
+  --font-size-base--line-height: 20px;
+  --font-size-lg: 15px;
+  --font-size-lg--line-height: 22px;
+  --font-size-xl: 17px;
+  --font-size-xl--line-height: 24px;
   --font-size-2xl: 18px;
+  --font-size-2xl--line-height: 24px;
   --font-size-3xl: 22px;
+  --font-size-3xl--line-height: 28px;
   --font-size-4xl: 28px;
+  --font-size-4xl--line-height: 32px;
   --font-size-5xl: 34px;
   --font-size-6xl: 44px;
   --font-size-7xl: 56px;

package/dist/scale/presets/soft.css

@@ -4,7 +4,17 @@
  * ============================================ */
 
 [data-style="soft"] {
-  /* 只覆盖 Radius (大圆角) */
+  /* Spacing (舒展留白) */
+  --spacing-3: 14px;
+  --spacing-4: 18px;
+  --spacing-5: 24px;
+  --spacing-6: 28px;
+  --spacing-8: 36px;
+  --spacing-9: 40px;
+  --spacing-11: 48px;
+  --spacing-12: 56px;
+
+  /* Radius (大圆角) */
   --radius-sm: 8px;
   --radius-DEFAULT: 12px;
   --radius-md: 12px;
@@ -13,4 +23,16 @@
   --radius-2xl: 24px;
   --radius-3xl: 28px;
   --radius: var(--radius-DEFAULT);
+
+  /* Font Size (阅读舒适，行高更松) */
+  --font-size-sm: 14px;
+  --font-size-sm--line-height: 22px;
+  --font-size-base: 15px;
+  --font-size-base--line-height: 24px;
+  --font-size-lg: 17px;
+  --font-size-lg--line-height: 26px;
+  --font-size-xl: 20px;
+  --font-size-xl--line-height: 28px;
+  --font-size-2xl: 22px;
+  --font-size-2xl--line-height: 30px;
 }