sparkdesign 0.4.4 → 0.4.6

package/cli/registry/tokens/themes/light-parchment.css

@@ -1,123 +1,124 @@
 /* ============================================
- * Theme: Light Parchment (羊皮纸亮色)
- * 复制此文件作为自定义主题模板
+ * Theme: Light Parchment (羊皮纸亮色 - Figma 导入)
+ * 用户可复制此文件作为自定义主题模板
  * ============================================ */
 
 [data-theme="light-parchment"] {
   /* --- Primary --- */
-  --color-primary: #202116;
-  --color-primary-hover: #3D3930;
-  --color-primary-active: #3D3930;
-  --color-primary-bg: #F0EDE7;
-  --color-primary-bg-hover: #E8E4DC;
-  --color-primary-border: #D4CFC6;
-  --color-primary-border-hover: #C4BEB4;
-  --color-primary-text: #202116;
-  --color-primary-text-hover: #3D3930;
-  --color-primary-text-active: #3D3930;
-  --color-text-on-primary: #FAF9F6;
+  --token-color-primary: #202116;
+  --token-color-primary-hover: #3D3930;
+  --token-color-primary-active: #3D3930;
+  --token-color-primary-bg: #F0EDE7;
+  --token-color-primary-bg-hover: #E8E4DC;
+  --token-color-primary-border: #D4CFC6;
+  --token-color-primary-border-hover: #C4BEB4;
+  --token-color-primary-text: #202116;
+  --token-color-primary-text-hover: #3D3930;
+  --token-color-primary-text-active: #3D3930;
+  --token-color-text-on-primary: #FAF9F6;
 
   /* --- Text --- */
-  --color-text: #202116;
-  --color-text-secondary: #4A463C;
-  --color-text-tertiary: #6B665C;
-  --color-text-quaternary: #8A857A;
-  --color-text-base: #202116;
+  --token-color-text: #202116;
+  --token-color-text-secondary: #4A463C;
+  --token-color-text-tertiary: #6B665C;
+  --token-color-text-quaternary: #8A857A;
+  --token-color-text-base: #202116;
 
   /* --- Border --- */
-  --color-border: #D4CFC6;
-  --color-border-secondary: #E5E1D9;
-  --color-border-tertiary: #EDE9E2;
+  --token-color-border: #D4CFC6;
+  --token-color-border-secondary: #E5E1D9;
+  --token-color-border-tertiary: #EDE9E2;
 
   /* --- Fill --- */
-  --color-fill: #F5F0E7;
-  --color-fill-secondary: #EDE8E0;
-  --color-fill-tertiary: #F7F4EF;
-  --color-fill-quaternary: #FAF9F6;
-  --color-fill-disable: #E0DCD4;
+  --token-color-fill: #F5F0E7;
+  --token-color-fill-secondary: #EDE8E0;
+  --token-color-fill-tertiary: #F7F4EF;
+  --token-color-fill-quaternary: #FAF9F6;
+  --token-color-fill-disable: #E0DCD4;
 
   /* --- Background --- */
-  --color-bg-container: #FAF9F6;
-  --color-bg-elevated: #F7F4EF;
-  --color-bg-layout: #FDFCFA;
-  --color-bg-spotlight: #FAF9F6;
-  --color-bg-mask: rgba(0, 0, 0, 0.5);
-  --color-mask-shimmer-weak: rgba(0, 0, 0, 0.3);
-  --color-mask-shimmer-strong: rgba(0, 0, 0, 0.8);
-  --color-mask-shimmer-full: rgba(0, 0, 0, 1);
-  --color-bg-base: #FFFFFF;
-  --color-bg-highlight: #202116;
-  --color-bg-highlight-hover: #2D2A22;
+  --token-color-bg-container: #FAF9F6;
+  --token-color-bg-elevated: #F7F4EF;
+  --token-color-bg-layout: #FDFCFA;
+  --token-color-bg-spotlight: #FAF9F6;
+  --token-color-bg-mask: rgba(0, 0, 0, 0.5);
+  /* PlanPart 点阵高亮遮罩渐变（随主题） */
+  --token-color-mask-shimmer-weak: rgba(0, 0, 0, 0.3);
+  --token-color-mask-shimmer-strong: rgba(0, 0, 0, 0.8);
+  --token-color-mask-shimmer-full: rgba(0, 0, 0, 1);
+  --token-color-bg-base: #FFFFFF;
+  --token-color-bg-highlight: #202116;
+  --token-color-bg-highlight-hover: #2D2A22;
 
   /* --- Semantic Colors --- */
-  --color-link: #5B4A3A;
-  --color-error: #FF4D4F;
-  --color-error-hover: #FF7875;
-  --color-error-bg: #FFF2F0;
-  --color-error-bg-hover: #FFF1F0;
-  --color-error-border: #FFCCC7;
-  --color-info: #0B83F1;
-  --color-info-hover: #5EBCFF;
-  --color-info-bg: #E6F7FF;
-  --color-info-bg-hover: #D0EFFF;
-  --color-info-border: #B0E3FF;
-  --color-success: #5A7A5E;
-  --color-success-hover: #6B8F71;
-  --color-success-bg: #EEF2ED;
-  --color-success-bg-hover: #E4EBE2;
-  --color-success-border: #C5D4C4;
-  --color-warning: #FAAD14;
-  --color-warning-hover: #FFD666;
-  --color-warning-bg: #FFFBE6;
-  --color-warning-bg-hover: #FFF3CF;
-  --color-warning-border: #FFE5BF;
+  --token-color-link: #5B4A3A;
+  --token-color-error: #FF4D4F;
+  --token-color-error-hover: #FF7875;
+  --token-color-error-bg: #FFF2F0;
+  --token-color-error-bg-hover: #FFF1F0;
+  --token-color-error-border: #FFCCC7;
+  --token-color-info: #0B83F1;
+  --token-color-info-hover: #5EBCFF;
+  --token-color-info-bg: #E6F7FF;
+  --token-color-info-bg-hover: #D0EFFF;
+  --token-color-info-border: #B0E3FF;
+  --token-color-success: #5A7A5E;
+  --token-color-success-hover: #6B8F71;
+  --token-color-success-bg: #EEF2ED;
+  --token-color-success-bg-hover: #E4EBE2;
+  --token-color-success-border: #C5D4C4;
+  --token-color-warning: #FAAD14;
+  --token-color-warning-hover: #FFD666;
+  --token-color-warning-bg: #FFFBE6;
+  --token-color-warning-bg-hover: #FFF3CF;
+  --token-color-warning-border: #FFE5BF;
 
   /* --- Accent Colors --- */
-  --color-pink: #EC4899;
-  --color-pink-bg: #F9E3F3;
-  --color-pink-bg-hover: #F5D4EB;
-  --color-purple: #615CED;
-  --color-purple-bg: #EBE9FF;
-  --color-purple-bg-hover: #DDDAFF;
-  --color-yellow: #FAC414;
-  --color-yellow-bg: #FFF3CF;
-  --color-yellow-bg-hover: #FFE9A8;
-  --color-orange: #FA8125;
-  --color-orange-bg: #FFEFDE;
-  --color-orange-bg-hover: #FFE3C7;
-  --color-teal: #14B8A6;
-  --color-teal-bg: #DEF7F1;
-  --color-teal-bg-hover: #CAF0E8;
-  --color-blue: #0090FF;
-  --color-blue-bg: #DEEDFF;
-  --color-blue-bg-hover: #C8E3FF;
-  --color-mauve: #8E8C99;
-  --color-mauve-bg: #F1F2F3;
-  --color-mauve-bg-hover: #E4E5E7;
-  --color-slate: #1E293B;
-  --color-slate-bg: #E2E8F0;
-  --color-slate-bg-hover: #EFEFEF;
-  --color-lavender: #B99DFF;
-  --color-lavender-bg: #ECE4FF;
-  --color-lavender-bg-hover: #E0D4FF;
-  --color-sage: #6BB394;
-  --color-sage-bg: #EFF3F2;
-  --color-sage-bg-hover: #E2EAE8;
+  --token-color-pink: #EC4899;
+  --token-color-pink-bg: #F9E3F3;
+  --token-color-pink-bg-hover: #F5D4EB;
+  --token-color-purple: #615CED;
+  --token-color-purple-bg: #EBE9FF;
+  --token-color-purple-bg-hover: #DDDAFF;
+  --token-color-yellow: #FAC414;
+  --token-color-yellow-bg: #FFF3CF;
+  --token-color-yellow-bg-hover: #FFE9A8;
+  --token-color-orange: #FA8125;
+  --token-color-orange-bg: #FFEFDE;
+  --token-color-orange-bg-hover: #FFE3C7;
+  --token-color-teal: #14B8A6;
+  --token-color-teal-bg: #DEF7F1;
+  --token-color-teal-bg-hover: #CAF0E8;
+  --token-color-blue: #0090FF;
+  --token-color-blue-bg: #DEEDFF;
+  --token-color-blue-bg-hover: #C8E3FF;
+  --token-color-mauve: #8E8C99;
+  --token-color-mauve-bg: #F1F2F3;
+  --token-color-mauve-bg-hover: #E4E5E7;
+  --token-color-slate: #1E293B;
+  --token-color-slate-bg: #E2E8F0;
+  --token-color-slate-bg-hover: #EFEFEF;
+  --token-color-lavender: #B99DFF;
+  --token-color-lavender-bg: #ECE4FF;
+  --token-color-lavender-bg-hover: #E0D4FF;
+  --token-color-sage: #6BB394;
+  --token-color-sage-bg: #EFF3F2;
+  --token-color-sage-bg-hover: #E2EAE8;
 
-  /* --- Component aliases --- */
-  --color-input: var(--color-border-tertiary);
-  --color-ring: var(--color-primary-border);
-  --color-popover: var(--color-bg-container);
-  --color-popover-foreground: var(--color-text);
-  --color-accent: var(--color-fill-secondary);
-  --color-accent-foreground: var(--color-text);
-  --color-muted: var(--color-fill-tertiary);
-  --color-muted-foreground: var(--color-text-secondary);
-  --color-background: var(--color-bg-base);
+  /* --- Select 等组件 (input/ring/popover 等) --- */
+  --token-color-input: var(--token-color-border-tertiary);
+  --token-color-ring: var(--token-color-primary-border);
+  --token-color-popover: var(--token-color-bg-container);
+  --token-color-popover-foreground: var(--token-color-text);
+  --token-color-accent: var(--token-color-fill-secondary);
+  --token-color-accent-foreground: var(--token-color-text);
+  --token-color-muted: var(--token-color-fill-tertiary);
+  --token-color-muted-foreground: var(--token-color-text-secondary);
+  --token-color-background: var(--token-color-bg-base);
 
   /* --- Diff --- */
-  --color-diff-insert: #A6DCBA;
-  --color-diff-insert-bg: #D9EBE0;
-  --color-diff-remove: #FC6B83;
-  --color-diff-remove-bg: #E3D1D5;
+  --token-color-diff-insert: #A6DCBA;
+  --token-color-diff-insert-bg: #D9EBE0;
+  --token-color-diff-remove: #FC6B83;
+  --token-color-diff-remove-bg: #E3D1D5;
 }

package/dist/registry/basic/alert-dialog.d.ts

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

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

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (AvatarProps, AvatarImageProps, AvatarFallbackProps, AvatarBadgeProps, AvatarGroupProps)
- * [OUTPUT]: (JSX.Element) - 用户头像组件（含 badge/group）
- * [POS]: registry/basic/avatar - 注册表模板，复制到用户项目后可自由修改
+ * [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/avatar.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 用户可自由修改此文件
- * 2. 更新时使用 npx sparkdesign diff avatar 查看差异
+ * 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 AvatarPrimitive from '@radix-ui/react-avatar';

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

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (Collapse*Props)
- * [OUTPUT]: (JSX.Element) - 折叠面板组件（Accordion）
- * [POS]: registry/basic/collapse - 注册表模板，复制到用户项目后可自由修改
+ * [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/collapse.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 用户可自由修改此文件
- * 2. 更新时使用 npx sparkdesign diff collapse 查看差异
+ * 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 AccordionPrimitive from '@radix-ui/react-accordion';

package/dist/registry/basic/collapsible-card.d.ts

@@ -1,12 +1,13 @@
 /**
- * [INPUT]: (CollapsibleCardProps) - 可折叠卡片：headerIcon/headerTitle/headerRight、children、footer、defaultExpanded、contentPadding、collapsible、showExpandAllBar、maxHeight
- * [OUTPUT]: (JSX.Element)
- * [POS]: registry/basic - 对话流内 Part 组件共用卡片容器
+ * [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/collapsible-card.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 文件逻辑变更时必须同步更新此 Header
- * 2. 所有样式使用 design token 类名
- * 3. showExpandAllBar：内容超过 maxHeight 时显示底部展开/收起栏，与 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.
  */
 import { type ReactNode } from 'react';
 export interface CollapsibleCardProps {

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

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

package/dist/registry/basic/dropdown-menu.d.ts

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

package/dist/registry/basic/icons-inline.d.ts

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (InlineIconProps)
- * [OUTPUT]: (JSX.Element) - 内联 SVG 图标组件（Remix Icon 风格）
- * [POS]: registry/basic/icons-inline - 注册表默认图标，无 useIcon 依赖
+ * [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/icons-inline.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 用于 registry 组件的默认图标
- * 2. 用户可通过 IconsProvider 注入自定义图标替换
+ * 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 interface InlineIconProps extends React.SVGAttributes<SVGSVGElement> {

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

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (KbdProps, KbdGroupProps)
- * [OUTPUT]: (JSX.Element) - 键盘按键展示组件
- * [POS]: registry/basic/kbd - 注册表模板，复制到用户项目后可自由修改
+ * [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/kbd.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 用户可自由修改此文件
- * 2. 更新时使用 npx sparkdesign diff kbd 查看差异
+ * 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 KbdProps = React.ComponentProps<'kbd'>;

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

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (Pagination*Props)
- * [OUTPUT]: (JSX.Element) - 分页导航组件
- * [POS]: registry/basic/pagination - 注册表模板，复制到用户项目后可自由修改
+ * [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/pagination.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 用户可自由修改此文件
- * 2. 更新时使用 npx sparkdesign diff pagination 查看差异
+ * 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';
 declare const Pagination: {

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

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

package/dist/registry/basic/radio-group.d.ts

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

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

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (ResizablePanelGroupProps, ResizablePanelProps, ResizableHandleProps)
- * [OUTPUT]: (JSX.Element) - 可调整大小面板组件
- * [POS]: registry/basic/resizable - 注册表模板，复制到用户项目后可自由修改
+ * [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/resizable.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 用户可自由修改此文件
- * 2. 更新时使用 npx sparkdesign diff resizable 查看差异
+ * 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 { GroupProps, PanelProps, SeparatorProps } from 'react-resizable-panels';

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

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

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

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

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

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (ToasterProps) - sonner Toaster 配置，可选 dataStyle/dataTheme
- * [OUTPUT]: (JSX.Element) - Portal 到 body 的 Toast 容器，样式通过 design tokens
- * [POS]: registry/basic/sonner - Toaster 唯一来源；主库再导出并注入 useIcon、buttonVariants
+ * [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/sonner.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 修改样式时需同步更新 defaultToastOptions 中的 CSS 变量
- * 2. 主库组件从 registry 导入，注入 data-style/data-theme 上下文
+ * 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 { ToasterProps as SonnerToasterProps } from 'sonner';

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

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (SwitchProps)
- * [OUTPUT]: (JSX.Element) - 开关组件（toggle only，无 segment 变体）
- * [POS]: registry/basic/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]: registry/basic/switch.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 用户可自由修改此文件
- * 2. 更新时使用 npx sparkdesign diff switch 查看差异
+ * 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 SwitchPrimitives from '@radix-ui/react-switch';

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

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

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

@@ -1,11 +1,13 @@
 /**
- * [INPUT]: (TagProps)
- * [OUTPUT]: (JSX.Element) - 标签/徽章组件
- * [POS]: registry/basic/tag - 注册表模板，复制到用户项目后可自由修改
+ * [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/tag.tsx — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 用户可自由修改此文件
- * 2. 更新时使用 npx sparkdesign diff tag 查看差异
+ * 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 VariantProps } from 'class-variance-authority';

package/dist/registry/basic/theme-from-document.d.ts

@@ -1,10 +1,12 @@
 /**
- * [INPUT]: (N/A) - 从 document.documentElement 读取
- * [OUTPUT]: (Record<string, string>) - 包含 data-theme / data-style 属性
- * [POS]: registry/basic/theme-from-document - 注册表工具函数
+ * [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/theme-from-document.ts — Spark Design source; keep aligned with the main library.
  *
  * [PROTOCOL]:
- * 1. 用于 Portal 根节点继承主题，无 Context 依赖
- * 2. 更新时使用 npx sparkdesign diff theme-from-document 查看差异
+ * 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 function getThemeFromDocument(): Record<string, string>;