sparkdesign 0.4.9 → 0.4.10

package/registry/agent-manifest.json

@@ -933,55 +933,7 @@
       ],
       "agentHints": [
         "Choose Popover for compact pickers and contextual controls.",
-        "Use Dialog or Sheet when the content needs more space."
-      ]
-    },
-    "sheet": {
-      "id": "sheet",
-      "name": "Sheet",
-      "category": "basic",
-      "status": "stable",
-      "intent": "Side panel overlay for contextual details, filters, settings, or secondary editing flows.",
-      "packageImport": "import { Sheet, SheetTrigger, SheetContent, SheetHeader, SheetTitle, SheetDescription } from 'sparkdesign'",
-      "cliAdd": "npx sparkdesign@latest add sheet",
-      "slots": [
-        "Sheet",
-        "SheetTrigger",
-        "SheetContent",
-        "SheetHeader",
-        "SheetTitle",
-        "SheetDescription",
-        "SheetFooter"
-      ],
-      "states": [
-        "open",
-        "closed",
-        "side-left",
-        "side-right",
-        "side-top",
-        "side-bottom",
-        "focus-trapped"
-      ],
-      "a11y": [
-        "Always provide SheetTitle.",
-        "Use SheetDescription when the panel purpose is not obvious.",
-        "Return focus to the trigger after close."
-      ],
-      "composition": [
-        "Button",
-        "Field",
-        "Tabs",
-        "SidebarMenu",
-        "Alert"
-      ],
-      "antiPatterns": [
-        "Do not use Sheet for destructive confirmations; use AlertDialog.",
-        "Do not create nested sheets unless the product specifically requires it.",
-        "Do not put primary app navigation in a temporary sheet on desktop when persistent navigation is expected."
-      ],
-      "agentHints": [
-        "Choose Sheet for secondary panels that preserve page context.",
-        "Use Drawer when the product already follows drawer terminology or behavior."
+        "Use Dialog or Drawer when the content needs more space."
       ]
     },
     "sidebar-menu": {
@@ -2004,6 +1956,49 @@
         "Use Spinner for brief unknown-duration loading."
       ]
     },
+    "rating": {
+      "id": "rating",
+      "name": "Rating",
+      "category": "basic",
+      "status": "stable",
+      "intent": "Star-based score or preference input for reviews, quality signals, and lightweight sentiment feedback.",
+      "packageImport": "import { Rating } from 'sparkdesign'",
+      "cliAdd": "npx sparkdesign@latest add rating",
+      "slots": [
+        "Rating",
+        "stars",
+        "numeric value by option",
+        "accessible label"
+      ],
+      "states": [
+        "controlled",
+        "uncontrolled",
+        "whole precision",
+        "half precision",
+        "read-only",
+        "disabled"
+      ],
+      "a11y": [
+        "Provide a clear label when the rating is an input.",
+        "Use readOnly for static review summaries.",
+        "Do not rely on star color alone when numeric precision matters."
+      ],
+      "composition": [
+        "Card",
+        "Field",
+        "Label",
+        "Tooltip"
+      ],
+      "antiPatterns": [
+        "Do not use Rating for exact numeric entry; use Input or Slider.",
+        "Do not ask for ratings when the user needs categorical choices.",
+        "Do not hide the current value in dense analytics summaries."
+      ],
+      "agentHints": [
+        "Choose Rating for familiar 1-5 preference capture or review display.",
+        "Use precision={0.5} only when half steps are meaningful to users."
+      ]
+    },
     "resizable": {
       "id": "resizable",
       "name": "Resizable",
@@ -2682,6 +2677,99 @@
         "Pair with Input when users need precise values."
       ]
     },
+    "stepper": {
+      "id": "stepper",
+      "name": "Stepper",
+      "category": "basic",
+      "status": "stable",
+      "intent": "Linear workflow progress for setup, checkout, approval, onboarding, and multi-step task status.",
+      "packageImport": "import { Stepper, StepperItem, StepperIndicator, StepperContent, StepperTitle, StepperDescription, StepperSeparator } from 'sparkdesign'",
+      "cliAdd": "npx sparkdesign@latest add stepper",
+      "slots": [
+        "Stepper",
+        "StepperItem",
+        "StepperIndicator",
+        "StepperContent",
+        "StepperTitle",
+        "StepperDescription",
+        "StepperSeparator"
+      ],
+      "states": [
+        "horizontal",
+        "vertical",
+        "complete",
+        "current",
+        "upcoming",
+        "error"
+      ],
+      "a11y": [
+        "Use ordered steps when sequence matters.",
+        "Make the current step visible in text, not only color.",
+        "Do not hide validation errors behind completed-looking steps."
+      ],
+      "composition": [
+        "Button",
+        "Progress",
+        "Alert",
+        "Card"
+      ],
+      "antiPatterns": [
+        "Do not use Stepper for non-linear tabs; use Tabs.",
+        "Do not show too many steps when grouped milestones would scan better.",
+        "Do not mark future steps as interactive unless navigation is supported."
+      ],
+      "agentHints": [
+        "Choose Stepper when users need to understand where they are in a process.",
+        "Use vertical orientation for verbose workflow history or mobile layouts."
+      ]
+    },
+    "timeline": {
+      "id": "timeline",
+      "name": "Timeline",
+      "category": "basic",
+      "status": "stable",
+      "intent": "Chronological event list for activity history, releases, audit logs, and milestone narratives.",
+      "packageImport": "import { Timeline, TimelineItem, TimelineMarker, TimelineConnector, TimelineContent, TimelineTitle, TimelineDescription, TimelineTime } from 'sparkdesign'",
+      "cliAdd": "npx sparkdesign@latest add timeline",
+      "slots": [
+        "Timeline",
+        "TimelineItem",
+        "TimelineMarker",
+        "TimelineConnector",
+        "TimelineContent",
+        "TimelineTitle",
+        "TimelineDescription",
+        "TimelineTime"
+      ],
+      "states": [
+        "default",
+        "primary",
+        "success",
+        "warning",
+        "error",
+        "last item without connector"
+      ],
+      "a11y": [
+        "Keep event order clear and consistent.",
+        "Include timestamps or labels when chronology matters.",
+        "Do not encode event meaning only through marker color."
+      ],
+      "composition": [
+        "Badge",
+        "Tag",
+        "Card",
+        "Separator"
+      ],
+      "antiPatterns": [
+        "Do not use Timeline for dense tabular audit data; use Table or DataTable.",
+        "Do not mix ascending and descending order in the same view.",
+        "Do not overload markers with unrelated status meanings."
+      ],
+      "agentHints": [
+        "Choose Timeline for readable event progression or product release histories.",
+        "Use tone sparingly for the few events that need semantic emphasis."
+      ]
+    },
     "toggle": {
       "id": "toggle",
       "name": "Toggle",
@@ -2861,50 +2949,6 @@
         "Use Alert for feedback that must remain visible."
       ]
     },
-    "sonner": {
-      "id": "sonner",
-      "name": "Sonner",
-      "category": "basic",
-      "status": "stable",
-      "intent": "Sonner toaster entry using Spark token styling and theme/style portal inheritance.",
-      "packageImport": "import { Toaster, toast } from 'sparkdesign'",
-      "cliAdd": "npx sparkdesign@latest add sonner",
-      "slots": [
-        "Toaster",
-        "toast function",
-        "toast options",
-        "icons",
-        "portal wrapper"
-      ],
-      "states": [
-        "success",
-        "error",
-        "warning",
-        "info",
-        "loading",
-        "dismissed"
-      ],
-      "a11y": [
-        "Use concise notification text.",
-        "Do not put required decisions only in sonner toasts.",
-        "Ensure critical errors also appear inline when users need to recover."
-      ],
-      "composition": [
-        "Button",
-        "Alert",
-        "Form",
-        "ToolInvocationCard"
-      ],
-      "antiPatterns": [
-        "Do not use Sonner for persistent validation or destructive confirmation.",
-        "Do not stack noisy success toasts for every small state change.",
-        "Do not hide important recovery actions inside an auto-dismissing toast."
-      ],
-      "agentHints": [
-        "Choose Sonner when the target explicitly asks for the sonner toaster API.",
-        "Choose Toast when describing the semantic notification pattern."
-      ]
-    },
     "tooltip": {
       "id": "tooltip",
       "name": "Tooltip",

package/cli/registry/basic/sheet.tsx

@@ -1,18 +0,0 @@
-export {
-  Drawer as Sheet,
-  DrawerTrigger as SheetTrigger,
-  DrawerClose as SheetClose,
-  DrawerPortal as SheetPortal,
-  DrawerOverlay as SheetOverlay,
-  DrawerContent as SheetContent,
-  DrawerHeader as SheetHeader,
-  DrawerFooter as SheetFooter,
-  DrawerTitle as SheetTitle,
-  DrawerDescription as SheetDescription,
-  drawerVariants as sheetVariants,
-} from './drawer'
-export type {
-  DrawerContentProps as SheetContentProps,
-  DrawerHeaderProps as SheetHeaderProps,
-  DrawerFooterProps as SheetFooterProps,
-} from './drawer'

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

@@ -1,13 +0,0 @@
-/**
- * [WHO]: Sheet — compatibility alias for Drawer using shadcn-style naming.
- * [FROM]: registry/basic/drawer.
- * [TO]: sparkdesign package consumers; output of CLI `add sheet` when registered.
- * [HERE]: registry/basic/sheet.tsx — Spark Design source; keep aligned with Drawer semantics.
- *
- * [PROTOCOL]:
- * 1. Keep Sheet as a thin compatibility layer; Drawer remains the canonical semantic component.
- * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
- * 3. Follow design tokens and explicit type exports.
- */
-export { Drawer as Sheet, DrawerTrigger as SheetTrigger, DrawerClose as SheetClose, DrawerPortal as SheetPortal, DrawerOverlay as SheetOverlay, DrawerContent as SheetContent, DrawerHeader as SheetHeader, DrawerFooter as SheetFooter, DrawerTitle as SheetTitle, DrawerDescription as SheetDescription, drawerVariants as sheetVariants, } from './drawer';
-export type { DrawerContentProps as SheetContentProps, DrawerHeaderProps as SheetHeaderProps, DrawerFooterProps as SheetFooterProps, } from './drawer';

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

@@ -1,13 +0,0 @@
-/**
- * [WHO]: Public Sheet compatibility exports.
- * [FROM]: registry/basic/sheet.
- * [TO]: sparkdesign package consumers and Showcase demos.
- * [HERE]: src/components/basic/Sheet/index.tsx — package-facing Sheet alias re-export.
- *
- * [PROTOCOL]:
- * 1. Keep this P3 header in sync when the public contract changes.
- * 2. Update module AGENTS.md (P2) and root AGENTS.md (P1) when boundaries change.
- * 3. Follow design tokens and explicit type exports.
- */
-export { Sheet, SheetTrigger, SheetClose, SheetPortal, SheetOverlay, SheetContent, SheetHeader, SheetFooter, SheetTitle, SheetDescription, sheetVariants, } from '../../../../registry/basic/sheet';
-export type { SheetContentProps, SheetHeaderProps, SheetFooterProps, } from '../../../../registry/basic/sheet';