sparkdesign 0.4.4 → 0.4.6

package/dist/registry/basic/tooltip.d.ts

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (TooltipProps)
- * [OUTPUT]: (JSX.Element) - 工具提示组件
- * [POS]: registry/basic/tooltip - 注册表模板，复制到用户项目后可自由修改
+ * [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/basic/tooltip.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 用户可自由修改此文件
- * 2. 更新时使用 npx sparkdesign diff tooltip 查看差异
+ * 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 * as React from 'react';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';

package/dist/registry/basic/typography.d.ts

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (Typography*Props)
- * [OUTPUT]: (JSX.Element) - 排版组件（H1–H4, P, Blockquote 等）
- * [POS]: registry/basic/typography - 注册表模板，复制到用户项目后可自由修改
+ * [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/basic/typography.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 用户可自由修改此文件
- * 2. 更新时使用 npx sparkdesign diff typography 查看差异
+ * 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 * as React from 'react';
 export type TypographyH1Props = React.ComponentProps<'h1'>;

package/dist/registry/chat/ask-user-part.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (AskUserPartProps) - title、question、skipText/runText；可选 headerIcon，未指定则用内联 SVG
- * [OUTPUT]: (JSX.Element)
- * [POS]: registry/chat - AI 向用户询问确认的卡片组件
+ * [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/ask-user-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 AskUserPartProps {

package/dist/registry/chat/browser-action-part.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (BrowserActionPartProps) - description、content、status；可选 normalIcon/failedIcon/skippedIcon，未指定则用内联 SVG
- * [OUTPUT]: (JSX.Element)
- * [POS]: registry/chat - AI Agent 浏览器操作卡片组件
+ * [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/browser-action-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 BrowserActionStatus = 'normal' | 'failed' | 'skipped';

package/dist/registry/chat/chat-input/compound.d.ts

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: 各复合组件的 props，或从 Context 消费
- * [OUTPUT]: ChatInput.Above / Box / Attachments / Input / Actions / ActionsLeft / ActionsRight / ExpandButton / FolderButton / MoreButton / SendButton / DefaultLayout
- * [POS]: registry/chat/chat-input - 四层结构复合组件，见 docs/ChatInput四层结构设计.md
+ * [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/chat-input/compound.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 所有子组件必须在 ChatInput.Root 内使用
- * 2. 布局与层级与设计文档一一对应
+ * 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 React from 'react';
 import type { ReactNode } from 'react';

package/dist/registry/chat/chat-input/context.d.ts

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (ChatInputContextValue) - 由 Root 注入
- * [OUTPUT]: Context + Provider + Hook
- * [POS]: registry/chat/chat-input - 复合组件共享状态
+ * [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/chat-input/context.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 仅被 Root 与复合子组件使用
- * 2. 新增/删除状态时同步更新 ChatInputContextValue 与 Root 中的初值
+ * 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 React from 'react';
 import type { ReactNode } from 'react';

package/dist/registry/chat/chat-input/index.d.ts

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (ChatInputProps) 或 复合用法 ChatInputRoot + Above/Box/…（主 API）
- * [OUTPUT]: (JSX.Element)
- * [POS]: registry/chat/chat-input - 依赖 send-button, generation-status-bar, icon-button, 子组件
+ * [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/chat-input/index.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 主 API 为复合组件（Root/Above/Box/Input/Actions/SendButton 等）；ChatInput 仅为默认组合的便捷导出。
- * 2. 文件逻辑变更时同步更新 Header、types.ts；见 docs/ChatInput四层结构设计.md
+ * 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 React from 'react';
 import { ChatInputRootProvider } from './context';

package/dist/registry/chat/chat-input/types.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: 无
- * [OUTPUT]: 类型导出
- * [POS]: registry/chat/chat-input - ChatInput 类型定义
+ * [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/chat-input/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 { TextareaHTMLAttributes, ReactNode } from 'react';
 export type InputPropsWithWebkitDirectory = React.InputHTMLAttributes<HTMLInputElement> & {

package/dist/registry/chat/chat-input/useAutoResizeTextarea.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (textareaRef, value, maxRows)
- * [OUTPUT]: void
- * [POS]: registry/chat/chat-input
+ * [WHO]: Output: void; Inputs: (textareaRef, value, maxRows)
+ * [FROM]: react
+ * [TO]: CLI `add` copy target; canonical implementation in `src/components`
+ * [HERE]: registry/chat/chat-input
+ *
+ * [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 RefObject } from 'react';
 export declare function useAutoResizeTextarea(textareaRef: RefObject<HTMLTextAreaElement | null>, value: string, maxRows: number): void;

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

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (CodeBlockPartProps) - language、code、filename、diffType、isGenerating；可选 headerIcon/getFileIcon
- * [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/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 type CodeBlockDiffType = 'add' | 'remove';

package/dist/registry/chat/file-attachment.d.ts

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (FileAttachmentProps) - filename、onRemove、icon / getFileIcon
- * [OUTPUT]: (JSX.Element) - 带左图标（文件类型）的可关闭 Tag 样式附件
- * [POS]: registry/chat - 唯一来源，主库再导出并注入 getFileIcon
+ * [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/file-attachment.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * - 仅依赖 registry ui（tag、icons-inline）；不依赖 useIcons
- * - 可选 getFileIcon(filename, className) 或 icon；不传则用 FileLine
+ * 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';
 export interface FileAttachmentProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'children'> {

package/dist/registry/chat/file-review-part.d.ts

@@ -1,8 +1,13 @@
 /**
- * [INPUT]: (FileReviewPartProps) - files、defaultExpanded；可选 headerIcon/acceptIcon/rejectIcon/getFileIcon
- * [OUTPUT]: (JSX.Element)
- * [POS]: registry/chat - 从 QodeChatPanel 移植，全 token 化；默认用 Seti 字体图标（需加载 qoder-seti.woff），hover 显示对号/错号
- * Seti 映射与逻辑与 QodeChatPanel FileReviewPart.jsx 内联保持一致，避免模块解析差异导致图形与后缀对不上。
+ * [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/file-review-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 FileReviewFile {

package/dist/registry/chat/generated-images-grid.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (GeneratedImagesGridProps) - 多图网格
- * [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/generated-images-grid.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 GeneratedImagesGridProps {

package/dist/registry/chat/generation-status-bar.d.ts

@@ -1,9 +1,13 @@
 /**
- * [INPUT]: (GenerationStatusBarProps)
- * [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/generation-status-bar.tsx — Spark Design source; keep aligned with the main library.
  *
- * [PROTOCOL]: 样式使用 design token（h-9、text-sm、px-3、rounded-t-xl），随 data-style 变化，与 ChatInputAbove 一致。
+ * [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 GenerationStatusBarProps {

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/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;