sparkdesign 0.4.5 → 0.4.6

package/dist/src/components/basic/Resizable/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (ResizablePanelGroupProps | ResizablePanelProps | ResizableHandleProps)
- * [OUTPUT]: (JSX.Element) - 可调整面板，基于 Registry 单一来源
- * [POS]: components/foundation/Resizable - 从 registry 再导出
+ * [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]: src/components/basic/Resizable/index.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.
  */
 export { ResizablePanelGroup, ResizablePanel, ResizableHandle, } from '../../../../registry/basic/resizable';
 export type { ResizablePanelGroupProps, ResizablePanelProps, ResizableHandleProps, } from '../../../../registry/basic/resizable';

package/dist/src/components/basic/Scrollbar/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (ScrollbarProps)
- * [OUTPUT]: (JSX.Element) - 带美化滚动条的容器，基于 Registry 单一来源
- * [POS]: components/foundation/Scrollbar - 从 registry 再导出
+ * [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]: src/components/basic/Scrollbar/index.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.
  */
 export { Scrollbar } from '../../../../registry/basic/scrollbar';
 export type { ScrollbarProps, ScrollbarVisibility } from '../../../../registry/basic/scrollbar';

package/dist/src/components/basic/Select/index.d.ts

@@ -1,10 +1,13 @@
 /**
- * [INPUT]: (SelectProps, SelectTriggerProps 等)
- * [OUTPUT]: (JSX.Element) - 下拉选择器，基于 Registry 单一来源
- * [POS]: components/foundation/Select - 从 registry 再导出，Content 注入 useThemeStyle 使 Portal 随 ThemeStyleProvider
+ * [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]: src/components/basic/Select/index.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 实现来自根目录 registry/basic/select.tsx；主库 SelectContent 注入 useThemeStyle
+ * 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 { Select, SelectGroup, SelectValue, SelectTrigger, SelectLabel, SelectItem, SelectSeparator, SelectScrollUpButton, SelectScrollDownButton } from '../../../../registry/basic/select';

package/dist/src/components/basic/ShimmeringText/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (ShimmeringTextProps)
- * [OUTPUT]: (JSX.Element) - 带渐变闪烁效果的动画文本组件，基于 Registry 单一来源
- * [POS]: components/basic/ShimmeringText - 从 registry 再导出
+ * [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]: src/components/basic/ShimmeringText/index.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.
  */
 export { ShimmeringText } from '../../../../registry/basic/shimmering-text';
 export type { ShimmeringTextProps } from '../../../../registry/basic/shimmering-text';

package/dist/src/components/basic/Skeleton/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (SkeletonProps)
- * [OUTPUT]: (JSX.Element) - 骨架屏，基于 Registry 单一来源
- * [POS]: components/foundation/Skeleton - 从 registry 再导出
+ * [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]: src/components/basic/Skeleton/index.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.
  */
 export { Skeleton, skeletonVariants } from '../../../../registry/basic/skeleton';
 export type { SkeletonProps } from '../../../../registry/basic/skeleton';

package/dist/src/components/basic/Slider/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (SliderProps)
- * [OUTPUT]: (JSX.Element) - 滑块，基于 Registry 单一来源
- * [POS]: components/foundation/Slider - 从 registry 再导出
+ * [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]: src/components/basic/Slider/index.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.
  */
 export { Slider } from '../../../../registry/basic/slider';
 export type { SliderProps } from '../../../../registry/basic/slider';

package/dist/src/components/basic/Spinner/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (SpinnerProps)
- * [OUTPUT]: (JSX.Element) - 加载指示器，基于 Registry 单一来源
- * [POS]: components/foundation/Spinner - 从 registry 再导出
+ * [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]: src/components/basic/Spinner/index.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.
  */
 export { Spinner } from '../../../../registry/basic/spinner';
 export type { SpinnerProps } from '../../../../registry/basic/spinner';

package/dist/src/components/basic/Switch/index.d.ts

@@ -1,10 +1,13 @@
 /**
- * [INPUT]: (SwitchProps) - toggle 用 registry；segment 主库保留（含 FunctionSwitch）
- * [OUTPUT]: (JSX.Element) - 布尔开关或分段切换
- * [POS]: components/foundation/Switch
+ * [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]: src/components/basic/Switch/index.tsx — Spark Design source; keep aligned with the main library.
  *
- * variant=toggle：从 registry 再导出并包一层 data-style/data-theme。
- * variant=segment：主库实现，默认图标用 registry icons-inline。
+ * [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 * as React from 'react';
 import type { SwitchProps as RegistrySwitchProps } from '../../../../registry/basic/switch';

package/dist/src/components/basic/Table/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (TableProps, TableHeaderProps 等)
- * [OUTPUT]: (JSX.Element) - 表格，基于 Registry 单一来源
- * [POS]: components/foundation/Table - 从 registry 再导出
+ * [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]: src/components/basic/Table/index.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.
  */
 export { Table, TableHeader, TableBody, TableFooter, TableHead, TableRow, TableCell, TableCaption, } from '../../../../registry/basic/table';
 export type { TableProps, TableHeaderProps, TableBodyProps, TableFooterProps, TableRowProps, TableHeadProps, TableCellProps, TableCaptionProps, } from '../../../../registry/basic/table';

package/dist/src/components/basic/Tabs/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (TabsProps, TabsListProps, TabsTriggerProps, TabsContentProps)
- * [OUTPUT]: (JSX.Element) - 标签页，基于 Registry 单一来源
- * [POS]: components/foundation/Tabs - 从 registry 再导出
+ * [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]: src/components/basic/Tabs/index.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.
  */
 export { Tabs, TabsList, TabsTrigger, TabsContent, tabsListVariants, tabsTriggerVariants, } from '../../../../registry/basic/tabs';
 export type { TabsProps, TabsListProps, TabsTriggerProps, TabsContentProps, } from '../../../../registry/basic/tabs';

package/dist/src/components/basic/Tag/index.d.ts

@@ -1,10 +1,13 @@
 /**
- * [INPUT]: (TagProps)
- * [OUTPUT]: (JSX.Element) - 标签，基于 Registry 单一来源
- * [POS]: components/foundation/Tag - 从 registry 再导出
+ * [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]: src/components/basic/Tag/index.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 实现来自根目录 registry/basic/tag.tsx，主库仅 re-export
+ * 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 { Tag, tagVariants } from '../../../../registry/basic/tag';
 export type { TagProps } from '../../../../registry/basic/tag';

package/dist/src/components/basic/Toggle/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (ToggleProps, ToggleGroupProps, ToggleGroupItemProps)
- * [OUTPUT]: (JSX.Element) - Toggle / ToggleGroup，基于 Registry 单一来源
- * [POS]: components/foundation/Toggle - 从 registry 再导出
+ * [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]: src/components/basic/Toggle/index.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.
  */
 export { Toggle, ToggleGroup, ToggleGroupItem, toggleVariants, } from '../../../../registry/basic/toggle';
 export type { ToggleProps, ToggleGroupProps, ToggleGroupItemProps, } from '../../../../registry/basic/toggle';

package/dist/src/components/basic/Tooltip/index.d.ts

@@ -1,10 +1,13 @@
 /**
- * [INPUT]: (TooltipProps，兼容 placement 与 side)
- * [OUTPUT]: (JSX.Element) - 工具提示，基于 Registry 单一来源
- * [POS]: components/foundation/Tooltip - 从 registry 再导出并兼容 placement
+ * [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]: src/components/basic/Tooltip/index.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 实现来自根目录 registry/basic/tooltip.tsx；主库注入 useThemeStyle 使 Portal 随 ThemeStyleProvider
+ * 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 { TooltipProvider, TooltipRoot, TooltipTrigger, TooltipContent } from '../../../../registry/basic/tooltip';
 import type { TooltipProps as RegistryTooltipProps } from '../../../../registry/basic/tooltip';

package/dist/src/components/basic/Typography/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (Typography*Props)
- * [OUTPUT]: (JSX.Element) - 排版组件，基于 Registry 单一来源
- * [POS]: components/foundation/Typography - 从 registry 再导出
+ * [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]: src/components/basic/Typography/index.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.
  */
 export { TypographyH1, TypographyH2, TypographyH3, TypographyH4, TypographyP, TypographyBlockquote, TypographyTable, TypographyList, TypographyInlineCode, TypographyLead, TypographyLarge, TypographySmall, TypographyMuted, } from '../../../../registry/basic/typography';
 export type { TypographyH1Props, TypographyH2Props, TypographyH3Props, TypographyH4Props, TypographyPProps, TypographyBlockquoteProps, TypographyTableProps, TypographyListProps, TypographyInlineCodeProps, TypographyLeadProps, TypographyLargeProps, TypographySmallProps, TypographyMutedProps, } from '../../../../registry/basic/typography';

package/dist/src/components/chat/GeneratedImagesGrid/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (GeneratedImagesGridProps)
- * [OUTPUT]: (JSX.Element) - 多图网格
- * [POS]: components/chat/GeneratedImagesGrid - 从 registry 再导出
+ * [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]: src/components/chat/GeneratedImagesGrid/index.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.
  */
 export { GeneratedImagesGrid } from '../../../../registry/chat/generated-images-grid';
 export type { GeneratedImagesGridProps } from '../../../../registry/chat/generated-images-grid';

package/dist/src/components/chat/GenerationStatusBar/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (GenerationStatusBarProps)
- * [OUTPUT]: (JSX.Element) - 生成状态条
- * [POS]: components/chat/GenerationStatusBar - 从 registry 再导出
+ * [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]: src/components/chat/GenerationStatusBar/index.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.
  */
 export { GenerationStatusBar } from '../../../../registry/chat/generation-status-bar';
 export type { GenerationStatusBarProps } from '../../../../registry/chat/generation-status-bar';

package/dist/src/components/chat/Markdown/demo-content.d.ts

@@ -1 +1 @@
-export declare const MARKDOWN_DEMO_CONTENT = "# What is Qoder Work\n\n**Qoder Work** is Anthropic\u2019s AI assistant that works alongside you in the same workspace. It\u2019s not just chat\u2014it actually participates in docs, code, and workflows as a real **coworker**.\n\n## Core capabilities\n\n- **Context-aware**: Understands your needs from open files and the current project\n- **Multimodal**: Handles text, code, diagrams, and structured output\n- **Executable**: Runs code and tools in a controlled environment, from $0 \\rightarrow 1$\n\n---\n\n## Why \u201CCowork\u201D\n\n> Traditional conversational AI is more like \u201Cadvice over the shoulder\u201D\u2014you describe the problem, it suggests steps.  \n> Cowork aims to **sit at the same table**: edit docs together, write code together, move tasks forward together.\n\nUsing a blockquote like this separates \u201Cthinking / context\u201D from \u201Cfinal answer\u201D and keeps long replies easy to scan.\n\n### How it differs from regular Claude\n\n| Dimension  | Regular Claude       | Qoder Work                 |\n|-----------|----------------------|--------------------------------|\n| Mode      | Turn-by-turn Q&A     | Ongoing edit in one workspace |\n| Context   | Mostly the thread   | Docs, code, and project        |\n| Output    | Text and code blocks | Direct edits in your files    |\n\nThe table above is **responsive**: on narrow screens it scrolls horizontally via `overflow-x: auto` (inline code here) so the layout doesn\u2019t break.\n\n### Typical use cases (ordered list)\n\n1. **Clarify requirements**: Turn PRDs or notes into concrete, executable steps\n2. **Code together**: Complete, refactor, or fix bugs in real projects instead of \u201Cpaste an example\u201D\n3. **Docs and knowledge**: Draft specs, API docs, meeting notes\n4. **Task flow**: From idea to deliverable, $\\frac{idea}{time} \\rightarrow deliverable$\n\n---\n\n## What happens in a session (H4 subheadings)\n\n#### Execution-log style (H4 / H5)\n\nUse smaller weight and muted color so \u201Cprocess\u201D doesn\u2019t compete with the main answer.\n\n##### View steps (H5)\n\n- [x] Permission and context checks\n- [x] Resolve workspace path and open files\n- [ ] Generate or edit according to your instructions\n\nAbove is a **task list**: checked = done, unchecked = in progress\u2014good for steps and checklists.\n\n---\n\n## Code and math examples\n\nInline code like `cowork.plan()` and `cowork.edit(file, diff)` sits in the sentence; fenced code keeps monospace and line height for readability:\n\n```python\n# Qoder Work concept (pseudo-code)\ndef cowork_session(context: WorkspaceContext, user_goal: str):\n    plan = cowork.plan(goal=user_goal, context=context)\n    for step in plan.steps:\n        if step.kind == \"edit_file\":\n            cowork.edit(step.target, step.diff)\n        elif step.kind == \"run_command\":\n            cowork.run(step.command, cwd=context.root)\n    return cowork.summary()\n```\n\nInline math: from idea to delivery can be written as $\\mathbb{E}[delivery] = f(idea, context, time)$.  \nDisplay math (when KaTeX is enabled) can be centered and on its own line for longer derivations.\n\n---\n\n## Summary\n\n- Use **H1** only for the main title; **H2 / H3** for sections; **H4\u2013H6** for steps or log-style subheadings.\n- **Blockquotes** for \u201Cthinking / premise\u201D; body text for the actual answer.\n- **Task lists** for progress and checklists; **tables** for structured comparison; **code** and **math** for clarity and rigor.\n\n*Qoder Work is designed so the AI moves from \u201Cthe other end of the chat\u201D into \u201Cthis file and this project you\u2019re editing\u201D\u2014as a real Coworker.*\n";
+export declare const MARKDOWN_DEMO_CONTENT = "# What is Spark Design\n\n**Spark Design** is a React design system for AI-native interfaces. It provides production-ready primitives, chat patterns, and theme tokens that fit into the same workspace as your app.\n\n## Core capabilities\n\n- **Context-aware**: Understands your needs from open files and the current project\n- **Multimodal**: Handles text, code, diagrams, and structured output\n- **Executable**: Runs code and tools in a controlled environment, from $0 \\rightarrow 1$\n\n---\n\n## Why \u201CCowork\u201D\n\n> Traditional conversational AI is more like \u201Cadvice over the shoulder\u201D\u2014you describe the problem, it suggests steps.  \n> Cowork aims to **sit at the same table**: edit docs together, write code together, move tasks forward together.\n\nUsing a blockquote like this separates \u201Cthinking / context\u201D from \u201Cfinal answer\u201D and keeps long replies easy to scan.\n\n### How it differs from regular Claude\n\n| Dimension  | Regular Claude       | Spark Design              |\n|-----------|----------------------|--------------------------------|\n| Mode      | Turn-by-turn Q&A     | Ongoing edit in one workspace |\n| Context   | Mostly the thread   | Docs, code, and project        |\n| Output    | Text and code blocks | Direct edits in your files    |\n\nThe table above is **responsive**: on narrow screens it scrolls horizontally via `overflow-x: auto` (inline code here) so the layout doesn\u2019t break.\n\n### Typical use cases (ordered list)\n\n1. **Clarify requirements**: Turn PRDs or notes into concrete, executable steps\n2. **Code together**: Complete, refactor, or fix bugs in real projects instead of \u201Cpaste an example\u201D\n3. **Docs and knowledge**: Draft specs, API docs, meeting notes\n4. **Task flow**: From idea to deliverable, $\\frac{idea}{time} \\rightarrow deliverable$\n\n---\n\n## What happens in a session (H4 subheadings)\n\n#### Execution-log style (H4 / H5)\n\nUse smaller weight and muted color so \u201Cprocess\u201D doesn\u2019t compete with the main answer.\n\n##### View steps (H5)\n\n- [x] Permission and context checks\n- [x] Resolve workspace path and open files\n- [ ] Generate or edit according to your instructions\n\nAbove is a **task list**: checked = done, unchecked = in progress\u2014good for steps and checklists.\n\n---\n\n## Code and math examples\n\nInline code like `cowork.plan()` and `cowork.edit(file, diff)` sits in the sentence; fenced code keeps monospace and line height for readability:\n\n```python\n# Spark Design concept (pseudo-code)\ndef cowork_session(context: WorkspaceContext, user_goal: str):\n    plan = cowork.plan(goal=user_goal, context=context)\n    for step in plan.steps:\n        if step.kind == \"edit_file\":\n            cowork.edit(step.target, step.diff)\n        elif step.kind == \"run_command\":\n            cowork.run(step.command, cwd=context.root)\n    return cowork.summary()\n```\n\nInline math: from idea to delivery can be written as $\\mathbb{E}[delivery] = f(idea, context, time)$.  \nDisplay math (when KaTeX is enabled) can be centered and on its own line for longer derivations.\n\n---\n\n## Summary\n\n- Use **H1** only for the main title; **H2 / H3** for sections; **H4\u2013H6** for steps or log-style subheadings.\n- **Blockquotes** for \u201Cthinking / premise\u201D; body text for the actual answer.\n- **Task lists** for progress and checklists; **tables** for structured comparison; **code** and **math** for clarity and rigor.\n\n*Spark Design is designed so AI-native UI moves from \u201Ca generic chat demo\u201D into \u201Cthis file and this product you are editing\u201D with production-ready tokens and components.*\n";

package/dist/src/components/chat/Markdown/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (MarkdownBodyProps)
- * [OUTPUT]: (JSX.Element) - Markdown 渲染
- * [POS]: components/chat/Markdown - 从 registry 再导出
+ * [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]: src/components/chat/Markdown/index.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.
  */
 export { MarkdownBody } from '../../../../registry/chat/markdown';
 export type { MarkdownBodyProps } from '../../../../registry/chat/markdown';

package/dist/src/components/chat/Response/StreamingMarkdownBlock.d.ts

@@ -1,6 +1,12 @@
 /**
- * [INPUT]: (StreamingMarkdownBlockProps)
- * [OUTPUT]: (JSX.Element)
- * [POS]: components/chat/Response - 从 registry 再导出
+ * [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]: src/components/chat/Response/StreamingMarkdownBlock.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.
  */
 export { StreamingMarkdownBlock, type StreamingMarkdownBlockProps, } from '../../../../registry/chat/streaming-markdown-block';

package/dist/src/components/chat/Response/index.d.ts

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (ResponseProps)
- * [OUTPUT]: (JSX.Element)
- * [POS]: components/chat/Response - 从 registry 再导出，注入带 Lottie 的 ThinkingIndicator
+ * [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]: src/components/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 as useRegistryResponseContext, DEMO_ROUNDS, DEMO_FINAL_MD } from '../../../../registry/chat/response/context';

package/dist/src/components/chat/UserMessage/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (UserMessageProps)
- * [OUTPUT]: (JSX.Element) - 用户消息气泡容器
- * [POS]: components/chat/UserMessage - 从 registry 再导出
+ * [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]: src/components/chat/UserMessage/index.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.
  */
 export { UserMessage } from '../../../../registry/chat/user-message';
 export type { UserMessageProps } from '../../../../registry/chat/user-message';

package/dist/src/components/index.d.ts

@@ -1,15 +1,13 @@
 /**
- * [INPUT]: (N/A) - 此为导出入口文件，不接收输入
- * [OUTPUT]: (Component & Type Exports) - 统一导出所有组件及其类型定义
- * [POS]: components/index.ts - 组件库统一导出入口
+ * [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]: src/components/index.ts — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 文件逻辑变更时必须同步更新此 Header
- * 2. 更新后必须上浮检查 L2、L1 文档
- * 3. 导出完整性检查：新增组件是否同步添加到导出列表
- * 4. 类型导出检查：每个组件是否同时导出 Props 类型
- *
- * 注意：样式通过 Vite 构建配置自动处理，无需在此引入
+ * 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 { Button } from './basic/Button';
 export type { ButtonProps } from './basic/Button';

package/dist/src/icons/context.d.ts

@@ -1,12 +1,13 @@
 /**
- * [INPUT]: (IconsProviderProps) - 图标映射与可选 getFileIcon
- * [OUTPUT]: (JSX.Element) - Provider 包裹子节点；useIcon 无配置时返回 undefined，便于 ?? 走内置 fallback
- * [POS]: icons/context - 图标注入层，组件通过 useIcons() 取图标，用户可替换为 Lucide/Remix 等
+ * [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]: src/icons/context.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 新增 IconKey 时同步 types.ts
- * 2. 不依赖 @ali/qoder-icon，主库零图标依赖
- * 3. useIcon 无图标时返回 undefined，主库直接渲染处需 ?? 内置 SVG（如 CollapsibleSection、Toast）
+ * 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 { IconKey, IconComponent } from './types';

package/dist/src/icons/types.d.ts

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: N/A - 类型定义
- * [OUTPUT]: IconKey, IconComponent 等类型
- * [POS]: icons/types - 图标抽象层类型，供 IconsContext 与组件使用
+ * [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]: src/icons/types.ts — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 新增组件使用图标时在此补充语义化 key
- * 2. 与 IconsContext 的默认实现（若有）保持同步
+ * 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 { ComponentType } from 'react';
 /** 图标组件通用 props（支持 className 与无障碍） */

package/dist/src/lib/ThemeStyleContext.d.ts

@@ -1,19 +1,19 @@
 /**
- * [INPUT]: (N/A) - Context 由上层 Provider 注入
- * [OUTPUT]: (React Context) - 供 Portal 浮层继承 data-style / data-theme
- * [POS]: lib/ThemeStyleContext
+ * [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]: src/lib/ThemeStyleContext.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 用于 DropdownMenu、Tooltip 等挂到 body 的浮层，使其与当前页面的 data-style/data-theme 一致
- * 2. 应用层在根节点用 ThemeStyleProvider 包裹并传入 appearance/theme/style
- * 3. 三维度独立设计：appearance(亮暗) × theme(颜色) × style(尺度)
- * 4. 支持预设字符串或自定义对象
+ * 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 Appearance = 'light' | 'dark';
 /** 颜色主题预设 */
-export type ThemePreset = 'qoder' | 'parchment';
+export type ThemePreset = 'mint' | 'parchment';
 /** 自定义颜色主题 */
 export interface CustomTheme {
     name: string;
@@ -120,7 +120,7 @@ export interface ThemeStyleProviderProps {
     children: ReactNode;
     /** 亮暗色，默认 'light' */
     appearance?: Appearance;
-    /** 颜色主题，默认 'qoder' */
+    /** 颜色主题，默认 'mint' */
     theme?: Theme;
     /** 布局尺度，默认 'neutral' */
     style?: Style;

package/dist/src/lib/file-icon.d.ts

@@ -1,12 +1,13 @@
 /**
- * [INPUT]: (filename: string, className?: string) - 文件名、图标样式类
- * [OUTPUT]: (ReactNode) - 对应文件类型的图标（默认通用占位；可通过 IconsProvider.getFileIcon 注入自定义）
- * [POS]: lib/file-icon - 文件图标工具，用于 FileCard 等
+ * [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]: src/lib/file-icon.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 文件逻辑变更时必须同步更新此 Header
- * 2. 使用方通过 IconsProvider 的 getFileIcon 注入时可实现按扩展名映射（如 Lucide/Remix）
- * 3. 主库不依赖任何闭源图标包
+ * 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/src/lib/i18n.d.ts

@@ -1,12 +1,13 @@
 /**
- * [INPUT]: () - 无输入
- * [OUTPUT]: (void) - 初始化 i18next 实例，供 react-i18next 使用
- * [POS]: lib/i18n.ts - 在应用入口最早导入，确保 useTranslation 可用
+ * [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]: src/lib/i18n.ts — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 文件逻辑变更时必须同步更新此 Header
- * 2. 新增语言或翻译时在此扩展 resources
- * 3. 当前仅英文：lng/fallbackLng 为 en；业务侧可通过 props 传入 t() 做多语言
+ * 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 i18n from 'i18next';
 export default i18n;

package/dist/src/lib/index.d.ts

@@ -1,7 +1,13 @@
 /**
- * [INPUT]: (N/A) - Lib 工具函数导出入口
- * [OUTPUT]: (Utility Exports) - 统一导出所有工具函数
- * [POS]: lib/index.ts
+ * [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]: src/lib/index.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.
  */
 export { getFileIconByFilename } from './file-icon';
 export { FILE_TYPE_MAP, SETI_CHAR_MAP, SETI_COLOR_MAP, TYPE_TO_TOKEN_CLASS, getSetiIconType, getSetiIcon, getSetiIconColor, getFileIconColorClass, } from '../../registry/lib/file-icon-maps';

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

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (ClassValue[])
- * [OUTPUT]: (string) - 合并后的 class 名
- * [POS]: lib/utils.ts - 从 registry 重导出，避免重复
+ * [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]: src/lib/utils.ts — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 唯一来源为 registry/lib/utils.ts
- * 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.
  */
 export { cn } from '../../registry/lib/utils';
 export type { ClassValue } from 'clsx';