sparkdesign 0.4.8 → 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';

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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sparkdesign",
-  "version": "0.4.8",
+  "version": "0.4.9",
   "type": "module",
   "description": "Modern React Design System with dual-dimension theme system",
   "keywords": [
@@ -17,7 +17,7 @@
   },
   "homepage": "https://spark.design",
   "bin": {
-    "sparkdesign": "./cli/dist/index.js"
+    "sparkdesign": "cli/dist/index.js"
   },
   "exports": {
     ".": {
@@ -60,6 +60,8 @@
     "check:token-antipatterns": "node scripts/check-token-antipatterns.mjs",
     "check:registry": "node scripts/check-registry-sync.mjs",
     "check:showcase": "node scripts/check-showcase-sync.mjs",
+    "report:agent-coverage": "node scripts/report-agent-manifest-coverage.mjs",
+    "check:agent-coverage": "node scripts/report-agent-manifest-coverage.mjs --fail-under=100",
     "gen:demo": "node scripts/gen-demo.mjs",
     "build": "vite build && npx @tailwindcss/cli -i src/lib.css -o dist/sparkdesign.css --minify && tsc -p tsconfig.lib.json && npm run build:cli",
     "build:cli": "cd cli && npm run build",
@@ -79,7 +81,7 @@
     "test:smoke:vite": "node scripts/smoke-test-cli.mjs vite",
     "test:smoke:next": "node scripts/smoke-test-cli.mjs nextjs",
     "test:smoke:add": "node scripts/smoke-test-cli.mjs pure-add",
-    "prepublishOnly": "node scripts/generate-registry-meta.mjs && npm run check:agent-manifest && npm run check:token-ontology && npm run check:token-antipatterns && npm run build && node scripts/sync-registry-to-cli.mjs && npm run check:registry-meta"
+    "prepublishOnly": "node scripts/generate-registry-meta.mjs && npm run check:agent-manifest && npm run check:agent-coverage && npm run check:token-ontology && npm run check:token-antipatterns && npm run build && node scripts/sync-registry-to-cli.mjs && npm run check:registry-meta"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
@@ -106,6 +108,7 @@
     "@radix-ui/react-select": "^2.2.6",
     "@radix-ui/react-separator": "^1.1.8",
     "@radix-ui/react-slider": "^1.3.6",
+    "@radix-ui/react-slot": "^1.2.4",
     "@radix-ui/react-switch": "^1.2.6",
     "@radix-ui/react-tabs": "^1.1.2",
     "@radix-ui/react-toggle": "^1.1.10",
@@ -132,6 +135,7 @@
     "prompts": "^2.4.2",
     "radix-ui": "^1.4.3",
     "react-day-picker": "^9.14.0",
+    "react-hook-form": "^7.76.0",
     "react-i18next": "^16.5.4",
     "react-markdown": "^10.1.0",
     "react-resizable-panels": "^4.6.2",
@@ -163,6 +167,7 @@
     "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-react-refresh": "^0.4.24",
     "globals": "^16.5.0",
+    "jsdom": "^29.1.1",
     "size-limit": "^12.0.0",
     "typescript": "~5.9.3",
     "typescript-eslint": "^8.48.0",