sparkdesign 0.4.7 → 0.4.9

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

@@ -0,0 +1,13 @@
+/**
+ * [WHO]: Accordion and sub-parts re-export from registry.
+ * [FROM]: registry/basic/accordion.
+ * [TO]: sparkdesign package consumers; src/components barrel.
+ * [HERE]: src/components/basic/Accordion/index.tsx — published Accordion wrapper.
+ *
+ * [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 { Accordion, AccordionItem, AccordionTrigger, AccordionContent, } from '../../../../registry/basic/accordion';
+export type { AccordionProps, AccordionItemProps, AccordionTriggerProps, AccordionContentProps, } from '../../../../registry/basic/accordion';

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

@@ -0,0 +1,13 @@
+/**
+ * [WHO]: Badge re-export from registry.
+ * [FROM]: registry/basic/badge.
+ * [TO]: sparkdesign package consumers; src/components barrel.
+ * [HERE]: src/components/basic/Badge/index.tsx — published Badge wrapper.
+ *
+ * [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 { Badge, badgeVariants } from '../../../../registry/basic/badge';
+export type { BadgeProps } from '../../../../registry/basic/badge';

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

@@ -1,45 +1,13 @@
 /**
  * [WHO]: Public exports from this file (see implementation below).
- * [FROM]: See the import block immediately after this header.
+ * [FROM]: registry/basic/ellipsis-text.
  * [TO]: sparkdesign package consumers; output of CLI `add` when applicable.
- * [HERE]: src/components/basic/EllipsisText/index.tsx — Spark Design source; keep aligned with the main library.
+ * [HERE]: src/components/basic/EllipsisText/index.tsx — packaged wrapper for EllipsisText.
  *
  * [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, type CSSProperties } from 'react';
-export interface EllipsisTextProps {
-    /** 要显示的文本内容 */
-    children: ReactNode;
-    /**
-     * 最大显示行数，超出会显示省略号
-     * @default 1
-     */
-    lines?: number;
-    /** 容器额外类名 */
-    className?: string;
-    /**
-     * Tooltip 弹出方向
-     * @default 'top'
-     */
-    placement?: 'top' | 'bottom' | 'left' | 'right';
-    /** Tooltip 内容额外类名 */
-    tooltipClassName?: string;
-    /** 自定义 tooltip 内容，默认使用 children */
-    tooltipContent?: ReactNode;
-    /**
-     * 是否禁用 tooltip
-     * @default false
-     */
-    disabled?: boolean;
-    /** 容器行内样式 */
-    style?: CSSProperties;
-    /**
-     * 文本元素的标签类型
-     * @default 'span'
-     */
-    as?: 'span' | 'div' | 'p';
-}
-export declare const EllipsisText: import("react").ForwardRefExoticComponent<EllipsisTextProps & import("react").RefAttributes<HTMLElement>>;
+export { EllipsisText } from '../../../../registry/basic/ellipsis-text';
+export type { EllipsisTextProps } from '../../../../registry/basic/ellipsis-text';

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

@@ -0,0 +1,12 @@
+/**
+ * [WHO]: Form helpers re-export from registry.
+ * [FROM]: registry/basic/form.
+ * [TO]: sparkdesign package consumers; src/components barrel.
+ * [HERE]: src/components/basic/Form/index.tsx — published React Hook Form helper wrapper.
+ *
+ * [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 { useFormField, Form, FormItem, FormLabel, FormControl, FormDescription, FormMessage, FormField, } from '../../../../registry/basic/form';

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

@@ -0,0 +1,13 @@
+/**
+ * [WHO]: Sidebar primitives re-export from registry.
+ * [FROM]: registry/basic/sidebar.
+ * [TO]: sparkdesign package consumers; src/components barrel.
+ * [HERE]: src/components/basic/Sidebar/index.tsx — published Sidebar wrapper.
+ *
+ * [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 { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, sidebarMenuButtonVariants, useSidebar, } from '../../../../registry/basic/sidebar';
+export { SidebarMenu as SidebarNavMenu, SidebarMenuItem as SidebarNavMenuItem, } from '../../../../registry/basic/sidebar';

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

@@ -13,6 +13,8 @@ export { Button } from './basic/Button';
 export type { ButtonProps } from './basic/Button';
 export { ButtonGroup, ButtonGroupText, ButtonGroupSeparator, buttonGroupVariants, } from './basic/ButtonGroup';
 export type { ButtonGroupProps, ButtonGroupTextProps, ButtonGroupSeparatorProps, } from './basic/ButtonGroup';
+export { Badge, badgeVariants } from './basic/Badge';
+export type { BadgeProps } from './basic/Badge';
 export { IconButton } from './basic/IconButton';
 export type { IconButtonProps } from './basic/IconButton';
 export { Tooltip } from './basic/Tooltip';
@@ -33,8 +35,6 @@ export { Toggle, ToggleGroup, ToggleGroupItem } from './basic/Toggle';
 export type { ToggleProps, ToggleGroupProps, ToggleGroupItemProps } from './basic/Toggle';
 export { RadioGroup, RadioGroupItem } from './basic/RadioGroup';
 export type { RadioGroupProps, RadioGroupItemProps } from './basic/RadioGroup';
-export { CollapsibleSection } from './basic/CollapsibleSection';
-export type { CollapsibleSectionProps } from './basic/CollapsibleSection';
 export { Collapsible, CollapsibleTrigger, CollapsibleContent } from './basic/Collapsible';
 export { ResizablePanelGroup, ResizablePanel, ResizableHandle, } from './basic/Resizable';
 export type { ResizablePanelGroupProps, ResizablePanelProps, ResizableHandleProps, } from './basic/Resizable';
@@ -56,6 +56,8 @@ export { Select, SelectTrigger, SelectValue, SelectContent, SelectLabel, SelectS
 export type { SelectProps, SelectTriggerProps, SelectValueProps, SelectContentProps, SelectLabelProps, SelectSeparatorProps, SelectGroupProps, SelectItemProps, } from './basic/Select';
 export { Tabs, TabsList, TabsTrigger, TabsContent, } from './basic/Tabs';
 export type { TabsProps, TabsListProps, TabsTriggerProps, TabsContentProps, } from './basic/Tabs';
+export { Accordion, AccordionItem, AccordionTrigger, AccordionContent, } from './basic/Accordion';
+export type { AccordionProps, AccordionItemProps, AccordionTriggerProps, AccordionContentProps, } from './basic/Accordion';
 export { Collapse, CollapseItem, CollapseTrigger, CollapseContent, } from './basic/Collapse';
 export type { CollapseProps, CollapseItemProps, CollapseTriggerProps, CollapseContentProps, } from './basic/Collapse';
 export { TypographyH1, TypographyH2, TypographyH3, TypographyH4, TypographyP, TypographyBlockquote, TypographyTable, TypographyList, TypographyInlineCode, TypographyLead, TypographyLarge, TypographySmall, TypographyMuted, } from './basic/Typography';
@@ -72,6 +74,7 @@ export { CollapsibleCard } from './basic/CollapsibleCard';
 export type { CollapsibleCardProps } from './basic/CollapsibleCard';
 export { SidebarMenu } from './basic/SidebarMenu';
 export type { SidebarMenuProps, SidebarMenuItem, SidebarMenuItemAction } from './basic/SidebarMenu';
+export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, SidebarNavMenu, SidebarNavMenuItem, sidebarMenuButtonVariants, useSidebar, } from './basic/Sidebar';
 export { Input } from './basic/Input';
 export type { InputProps } from './basic/Input';
 export { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupTextarea, InputGroupText, } from './basic/InputGroup';
@@ -79,6 +82,7 @@ export { InputOTP, InputOTPGroup, InputOTPSlot, InputOTPSeparator, } from './bas
 export { Textarea } from './basic/Textarea';
 export type { TextareaProps } from './basic/Textarea';
 export { Field, FieldLabel, FieldDescription, FieldError, FieldContent, FieldTitle, FieldSeparator, FieldSet, FieldLegend, FieldGroup, } from './basic/Field';
+export { useFormField, Form, FormItem, FormLabel, FormControl, FormDescription, FormMessage, FormField, } from './basic/Form';
 export { Label } from './basic/Label';
 export type { LabelProps } from './basic/Label';
 export { Checkbox, checkboxVariants } from './basic/Checkbox';
@@ -189,5 +193,5 @@ export { IconsProvider, useIcons, useIcon } from '../icons/context';
 export type { IconKey, IconComponent, IconProps } from '../icons/types';
 export type { IconsContextValue } from '../icons/context';
 export { ThemeStyleProvider, useThemeStyle, type Appearance, type ThemePreset, type CustomTheme, type Theme, type StylePreset, type CustomStyle, type Style, type ThemeStyleContextValue, type ThemeStyleProviderProps, type ThemeStyleValue, } from '../lib/ThemeStyleContext';
-export { MOTION_DURATION, MOTION_EASE, MOTION_SPRING } from '../lib/motion';
+export { MOTION_DURATION, MOTION_EASE, MOTION_SPRING, MOTION_FADE, MOTION_SLIDE_UP, MOTION_SCALE_IN, MOTION_EXPAND, getReducedMotion, getMotionMultiplier, } from '../lib/motion';
 export { FILE_TYPE_MAP, SETI_CHAR_MAP, SETI_COLOR_MAP, TYPE_TO_TOKEN_CLASS, getSetiIconType, getSetiIcon, getSetiIconColor, getFileIconColorClass, } from '../lib';

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

@@ -13,4 +13,4 @@ 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';
 export { default as i18n } from './i18n';
 export { ThemeStyleProvider, useThemeStyle, type Appearance, type ThemePreset, type CustomTheme, type Theme, type StylePreset, type CustomStyle, type Style, type ThemeStyleContextValue, type ThemeStyleProviderProps, type ThemeStyleValue, } from './ThemeStyleContext';
-export { MOTION_DURATION, MOTION_EASE, MOTION_SPRING } from './motion';
+export { MOTION_DURATION, MOTION_EASE, MOTION_SPRING, MOTION_FADE, MOTION_SLIDE_UP, MOTION_SCALE_IN, MOTION_EXPAND, getReducedMotion, getMotionMultiplier, } from './motion';

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

@@ -20,3 +20,82 @@ export declare const MOTION_SPRING: {
         readonly mass: 0.7;
     };
 };
+/** Overlay fade (dialog masks, backdrops) */
+export declare const MOTION_FADE: {
+    readonly initial: {
+        readonly opacity: 0;
+    };
+    readonly animate: {
+        readonly opacity: 1;
+    };
+    readonly exit: {
+        readonly opacity: 0;
+    };
+    readonly transition: {
+        readonly duration: 0.15;
+    };
+};
+/** Content slide-up (dialogs, alert-dialogs) */
+export declare const MOTION_SLIDE_UP: {
+    readonly initial: {
+        readonly opacity: 0;
+        readonly y: 8;
+    };
+    readonly animate: {
+        readonly opacity: 1;
+        readonly y: 0;
+    };
+    readonly exit: {
+        readonly opacity: 0;
+        readonly y: 8;
+    };
+    readonly transition: {
+        readonly duration: 0.2;
+        readonly ease: readonly [0.16, 1, 0.3, 1];
+    };
+};
+/** Scale-in (tooltips, popovers, dropdowns, context menus, hover cards) */
+export declare const MOTION_SCALE_IN: {
+    readonly initial: {
+        readonly opacity: 0;
+        readonly scale: 0.96;
+    };
+    readonly animate: {
+        readonly opacity: 1;
+        readonly scale: 1;
+    };
+    readonly exit: {
+        readonly opacity: 0;
+        readonly scale: 0.96;
+    };
+    readonly transition: {
+        readonly duration: 0.15;
+        readonly ease: readonly [0.16, 1, 0.3, 1];
+    };
+};
+/** Expand (collapsible sections, accordion-like reveals) */
+export declare const MOTION_EXPAND: {
+    readonly initial: {
+        readonly opacity: 0;
+        readonly height: 0;
+    };
+    readonly animate: {
+        readonly opacity: 1;
+        readonly height: "auto";
+    };
+    readonly exit: {
+        readonly opacity: 0;
+        readonly height: 0;
+    };
+    readonly transition: {
+        readonly duration: 0.2;
+        readonly ease: readonly [0.2, 0.8, 0.2, 1];
+    };
+};
+/** Check if user prefers reduced motion (SSR-safe) */
+export declare function getReducedMotion(): boolean;
+/**
+ * Read the --motion-multiplier CSS variable from the DOM (SSR-safe).
+ * Presets override this value to make motion faster or slower.
+ */
+export declare function getMotionMultiplier(): number;

package/dist/theme-base.css

@@ -146,6 +146,14 @@
   --color-shadow-tertiary: var(--token-color-shadow-tertiary);
   --color-shadow-quaternary: var(--token-color-shadow-quaternary);
 
+  /* Elevation — 完整 box-shadow value token，Tailwind shadow-* 类自动消费 */
+  --shadow-xs: 0 1px 2px var(--color-shadow-primary);
+  --shadow-sm: 0 1px 3px var(--color-shadow-secondary), 0 1px 2px var(--color-shadow-primary);
+  --shadow-md: 0 4px 6px var(--color-shadow-secondary), 0 2px 4px var(--color-shadow-primary);
+  --shadow-lg: 0 10px 15px var(--color-shadow-tertiary), 0 4px 6px var(--color-shadow-secondary);
+  --shadow-xl: 0 20px 25px var(--color-shadow-tertiary), 0 8px 10px var(--color-shadow-secondary);
+  --shadow-2xl: 0 25px 50px var(--color-shadow-quaternary);
+
   /* Semantic */
   --color-link: var(--token-color-link);
   --color-error: var(--token-color-error);
@@ -254,6 +262,20 @@
   }
 }
 
+/* ============================================
+   Reduced motion — 全局无障碍
+   ============================================ */
+@media (prefers-reduced-motion: reduce) {
+  *,
+  *::before,
+  *::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+    scroll-behavior: auto !important;
+  }
+}
+
 /* ============================================
    Seti 文件图标字体（与 QodeChatPanel 一致；需将 qoder-seti.woff 置于 public/ 或根路径）
    ============================================ */

package/dist/themes/dark-mint.css

@@ -51,6 +51,12 @@
   --token-color-bg-highlight: #d0d0d0;
   --token-color-bg-highlight-hover: #e0e0e0;
 
+  /* --- Shadow (暗色需要更强的阴影以在深色背景上可见) --- */
+  --token-color-shadow-primary: rgba(0, 0, 0, 0.08);
+  --token-color-shadow-secondary: rgba(0, 0, 0, 0.14);
+  --token-color-shadow-tertiary: rgba(0, 0, 0, 0.22);
+  --token-color-shadow-quaternary: rgba(0, 0, 0, 0.30);
+
   /* --- Semantic Colors --- */
   --token-color-link: #8EE5A1;
   --token-color-error: #FF4D4F;

package/dist/themes/dark-parchment.css

@@ -51,6 +51,12 @@
   --token-color-bg-highlight: #C9C4B8;
   --token-color-bg-highlight-hover: #D4C9BC;
 
+  /* --- Shadow (暗色羊皮纸，需要更强的阴影) --- */
+  --token-color-shadow-primary: rgba(0, 0, 0, 0.08);
+  --token-color-shadow-secondary: rgba(0, 0, 0, 0.14);
+  --token-color-shadow-tertiary: rgba(0, 0, 0, 0.22);
+  --token-color-shadow-quaternary: rgba(0, 0, 0, 0.30);
+
   /* --- Semantic Colors --- */
   --token-color-link: #C4B8A8;
   --token-color-error: #FF6B6B;

package/dist/themes/light-parchment.css

@@ -50,6 +50,12 @@
   --token-color-bg-highlight: #202116;
   --token-color-bg-highlight-hover: #2D2A22;
 
+  /* --- Shadow (暖色基底，匹配羊皮纸调性) --- */
+  --token-color-shadow-primary: rgba(30, 25, 15, 0.025);
+  --token-color-shadow-secondary: rgba(30, 25, 15, 0.045);
+  --token-color-shadow-tertiary: rgba(30, 25, 15, 0.07);
+  --token-color-shadow-quaternary: rgba(30, 25, 15, 0.09);
+
   /* --- Semantic Colors --- */
   --token-color-link: #5B4A3A;
   --token-color-error: #FF4D4F;

package/dist/tokens/scale/computed.css

@@ -100,4 +100,15 @@
   --motion-ease-standard: var(--config-motion-ease-standard);
   --motion-ease-emphasized: var(--config-motion-ease-emphasized);
   --motion-ease-out: var(--config-motion-ease-out);
+
+  /* ============================================
+     Motion Multiplier (从配置映射)
+     ============================================ */
+  --motion-multiplier: var(--config-motion-multiplier);
+
+  /* ============================================
+     Border Width (从配置映射)
+     ============================================ */
+  --border-width: var(--config-border-width);
+  --border-width-thick: var(--config-border-width-thick);
 }

package/dist/tokens/scale/config.css

@@ -102,6 +102,17 @@
   --config-motion-ease-emphasized: cubic-bezier(0.2, 0.8, 0.2, 1);
   --config-motion-ease-out: cubic-bezier(0, 0, 0.2, 1);
 
+  /* ============================================
+     Motion Multiplier (preset 可覆盖，<1 更快，>1 更慢)
+     ============================================ */
+  --config-motion-multiplier: 1;
+
+  /* ============================================
+     Border Width 配置
+     ============================================ */
+  --config-border-width: 1px;
+  --config-border-width-thick: 2px;
+
   /* ============================================
      Font Family 配置
      ============================================ */

package/dist/tokens/scale/presets/compact.css

@@ -38,4 +38,11 @@
   --font-size-7xl: 56px;
   --font-size-8xl: 64px;
   --font-size-9xl: 88px;
+
+  /* Motion (略快) */
+  --motion-multiplier: 0.9;
+
+  /* Border */
+  --border-width: 1px;
+  --border-width-thick: 1px;
 }

package/dist/tokens/scale/presets/dense.css

@@ -72,4 +72,11 @@
   --font-size-7xl: 44px;
   --font-size-8xl: 56px;
   --font-size-9xl: 72px;
+
+  /* Motion (快速) */
+  --motion-multiplier: 0.8;
+
+  /* Border (极细) */
+  --border-width: 1px;
+  --border-width-thick: 1px;
 }

package/dist/tokens/scale/presets/sharp.css

@@ -49,4 +49,11 @@
   --font-size-7xl: 56px;
   --font-size-8xl: 64px;
   --font-size-9xl: 88px;
+
+  /* Motion (机械精准，最快) */
+  --motion-multiplier: 0.75;
+
+  /* Border (几何硬边) */
+  --border-width: 1px;
+  --border-width-thick: 2px;
 }

package/dist/tokens/scale/presets/soft.css

@@ -35,4 +35,11 @@
   --font-size-xl--line-height: 28px;
   --font-size-2xl: 22px;
   --font-size-2xl--line-height: 30px;
+
+  /* Motion (更舒缓) */
+  --motion-multiplier: 1.3;
+
+  /* Border (无边框面，靠阴影区分层级) */
+  --border-width: 0px;
+  --border-width-thick: 1px;
 }

package/dist/tokens/theme-base.css

@@ -146,6 +146,14 @@
   --color-shadow-tertiary: var(--token-color-shadow-tertiary);
   --color-shadow-quaternary: var(--token-color-shadow-quaternary);
 
+  /* Elevation — 完整 box-shadow value token，Tailwind shadow-* 类自动消费 */
+  --shadow-xs: 0 1px 2px var(--color-shadow-primary);
+  --shadow-sm: 0 1px 3px var(--color-shadow-secondary), 0 1px 2px var(--color-shadow-primary);
+  --shadow-md: 0 4px 6px var(--color-shadow-secondary), 0 2px 4px var(--color-shadow-primary);
+  --shadow-lg: 0 10px 15px var(--color-shadow-tertiary), 0 4px 6px var(--color-shadow-secondary);
+  --shadow-xl: 0 20px 25px var(--color-shadow-tertiary), 0 8px 10px var(--color-shadow-secondary);
+  --shadow-2xl: 0 25px 50px var(--color-shadow-quaternary);
+
   /* Semantic */
   --color-link: var(--token-color-link);
   --color-error: var(--token-color-error);
@@ -254,6 +262,20 @@
   }
 }
 
+/* ============================================
+   Reduced motion — 全局无障碍
+   ============================================ */
+@media (prefers-reduced-motion: reduce) {
+  *,
+  *::before,
+  *::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+    scroll-behavior: auto !important;
+  }
+}
+
 /* ============================================
    Seti 文件图标字体（与 QodeChatPanel 一致；需将 qoder-seti.woff 置于 public/ 或根路径）
    ============================================ */

package/dist/tokens/themes/dark-mint.css

@@ -51,6 +51,12 @@
   --token-color-bg-highlight: #d0d0d0;
   --token-color-bg-highlight-hover: #e0e0e0;
 
+  /* --- Shadow (暗色需要更强的阴影以在深色背景上可见) --- */
+  --token-color-shadow-primary: rgba(0, 0, 0, 0.08);
+  --token-color-shadow-secondary: rgba(0, 0, 0, 0.14);
+  --token-color-shadow-tertiary: rgba(0, 0, 0, 0.22);
+  --token-color-shadow-quaternary: rgba(0, 0, 0, 0.30);
+
   /* --- Semantic Colors --- */
   --token-color-link: #8EE5A1;
   --token-color-error: #FF4D4F;

package/dist/tokens/themes/dark-parchment.css

@@ -51,6 +51,12 @@
   --token-color-bg-highlight: #C9C4B8;
   --token-color-bg-highlight-hover: #D4C9BC;
 
+  /* --- Shadow (暗色羊皮纸，需要更强的阴影) --- */
+  --token-color-shadow-primary: rgba(0, 0, 0, 0.08);
+  --token-color-shadow-secondary: rgba(0, 0, 0, 0.14);
+  --token-color-shadow-tertiary: rgba(0, 0, 0, 0.22);
+  --token-color-shadow-quaternary: rgba(0, 0, 0, 0.30);
+
   /* --- Semantic Colors --- */
   --token-color-link: #C4B8A8;
   --token-color-error: #FF6B6B;

package/dist/tokens/themes/light-parchment.css

@@ -50,6 +50,12 @@
   --token-color-bg-highlight: #202116;
   --token-color-bg-highlight-hover: #2D2A22;
 
+  /* --- Shadow (暖色基底，匹配羊皮纸调性) --- */
+  --token-color-shadow-primary: rgba(30, 25, 15, 0.025);
+  --token-color-shadow-secondary: rgba(30, 25, 15, 0.045);
+  --token-color-shadow-tertiary: rgba(30, 25, 15, 0.07);
+  --token-color-shadow-quaternary: rgba(30, 25, 15, 0.09);
+
   /* --- Semantic Colors --- */
   --token-color-link: #5B4A3A;
   --token-color-error: #FF4D4F;

package/docs/agent/component-selection.md

@@ -9,6 +9,8 @@ details are needed.
 - `sparkdesign/agent-manifest.json` — package export for agent-facing component semantics.
 - `registry/agent-manifest.json` — source of truth in this repository.
 - `npm run check:agent-manifest` — validates required semantic fields and recipe references.
+- `npm run report:agent-coverage` — reports manifest coverage against `registry/meta.json`.
+- `npm run check:agent-coverage` — fails if manifest coverage drops below 100%.
 
 ## Decision Order
 
@@ -18,28 +20,126 @@ details are needed.
 4. Use `cliAdd` when the target app should own copied component source.
 5. Use `packageImport` only when the app already consumes `sparkdesign` as a package.
 
+## Common Name Boundaries
+
+- `sidebar` is the full app-shell primitive set: provider state, trigger, responsive collapse, mobile sheet, and inset content. Package imports expose its menu list as `SidebarNavMenu` / `SidebarNavMenuItem`.
+- `sidebar-menu` is the lightweight data-driven list component exported as `SidebarMenu`; use it when a full app shell would be overkill.
+- `form` is for React Hook Form validation wiring; `field` is for layout-only form rows.
+- `toast` and `sonner` share the same runtime toaster API. Prefer `toast` for Spark semantic naming and `sonner` only when matching that install target.
+
 ## Current High-Confidence Coverage
 
-The first manifest version covers the components most likely to be selected by
-design/coding agents:
+The manifest covers the components most likely to be selected by design/coding
+agents. Use `npm run report:agent-coverage` for the current full coverage
+snapshot.
 
 - `button`
 - `alert`
+- `alert-dialog`
+- `accordion`
+- `aspect-ratio`
+- `avatar`
+- `badge`
+- `breadcrumb`
+- `button-group`
+- `calendar`
 - `card`
+- `carousel`
+- `chart`
+- `checkbox`
+- `collapse`
+- `collapsible`
+- `collapsible-card`
+- `combobox`
+- `command`
+- `context-menu`
+- `data-table`
+- `date-picker`
 - `dialog`
+- `direction`
+- `dropdown-menu`
 - `drawer`
-- `file-review-part`
+- `ellipsis-text`
+- `empty`
+- `field`
+- `form`
+- `hover-card`
+- `icon-button`
+- `input`
+- `input-group`
+- `input-otp`
+- `item`
+- `kbd`
+- `label`
+- `menubar`
+- `native-select`
+- `navigation-menu`
+- `option-list`
+- `pagination`
+- `popover`
+- `progress`
+- `radio-group`
+- `resizable`
+- `scroll-area`
+- `scrollbar`
+- `select`
+- `separator`
+- `sheet`
+- `sidebar`
+- `sidebar-menu`
+- `shimmering-text`
+- `slider`
+- `skeleton`
+- `spinner`
+- `sonner`
+- `switch`
+- `table`
+- `tag`
+- `tabs`
+- `textarea`
+- `toast`
+- `tooltip`
+- `toggle`
+- `toggle-group`
+- `typography`
+- `ask-user-part`
+- `browser-action-part`
 - `chat-input`
-- `response`
+- `code-block-part`
+- `conversation-anchor-nav`
+- `file-attachment`
+- `file-card`
+- `file-review-part`
+- `folder-button`
+- `generation-status-bar`
+- `generated-images-grid`
+- `hint-banner`
+- `image-attachment`
+- `image-generating`
 - `markdown`
+- `mermaid-part`
 - `permission-card`
+- `plan-part`
+- `queue-indicator`
+- `reasoning-step`
+- `related-prompts`
+- `response`
+- `send-button`
+- `streaming-markdown-block`
+- `task-part`
+- `terminal-code-block-part`
+- `thinking-indicator`
 - `tool-invocation-card`
+- `user-message`
+- `user-question-answer`
+- `user-question-part`
 
 ## Recipe Usage
 
 Recipes are intended to prevent agents from flattening rich AI interfaces into
 generic cards and Markdown.
 
+- `structured-form` — deterministic forms/settings with labels, controls, validation, and actions.
 - `assistant-composer` — prompt entry, attachments, send, and permissions.
 - `assistant-response-stream` — generated answer, tools, Markdown, and errors.
 - `focused-task-modal` — compact blocking task or confirmation flow.
@@ -58,3 +158,5 @@ When adding a component to the manifest:
 4. Ensure `cliAdd` installs the same component id as the manifest key.
 5. Add or update recipes if the component changes how agents should compose screens.
 6. Run `npm run check:agent-manifest`.
+7. Run `npm run check:agent-coverage` so new registry components cannot ship without agent semantics.
+8. Run `npm run report:agent-coverage` when planning broader semantic coverage or reviewing drift.