sonance-brand-mcp 1.3.1 → 1.3.3

package/dist/assets/components/card.stories.tsx

@@ -45,7 +45,7 @@ export const Default: Story = {
         <CardDescription>Card description goes here</CardDescription>
       </CardHeader>
       <CardContent>
-        <p className="text-foreground-secondary">
+        <p id="default-p-this-is-the-card-con" className="text-foreground-secondary">
           This is the card content area where you can place any content.
         </p>
       </CardContent>
@@ -62,7 +62,7 @@ export const Elevated: Story = {
         <CardDescription>With shadow effect</CardDescription>
       </CardHeader>
       <CardContent>
-        <p className="text-foreground-secondary">
+        <p id="elevated-p-elevated-cards-have-" className="text-foreground-secondary">
           Elevated cards have a shadow that increases on hover.
         </p>
       </CardContent>
@@ -79,13 +79,13 @@ export const WithFooter: Story = {
         <CardDescription>Includes action buttons in footer</CardDescription>
       </CardHeader>
       <CardContent>
-        <p className="text-foreground-secondary">
+        <p id="with-footer-p-cards-can-include-a-" className="text-foreground-secondary">
           Cards can include a footer section for actions.
         </p>
       </CardContent>
       <CardFooter className="gap-2">
-        <Button variant="primary" size="sm">Save</Button>
-        <Button variant="secondary" size="sm">Cancel</Button>
+        <Button id="with-footer-button-primary" variant="primary" size="sm">Save</Button>
+        <Button id="with-footer-button-secondary" variant="secondary" size="sm">Cancel</Button>
       </CardFooter>
     </Card>
   ),
@@ -96,17 +96,17 @@ export const ProductCard: Story = {
   render: () => (
     <Card className="w-72 overflow-hidden">
       <div className="aspect-square bg-background-secondary flex items-center justify-center">
-        <span className="text-foreground-muted">Product Image</span>
+        <span id="product-card-span-product-image" className="text-foreground-muted">Product Image</span>
       </div>
       <CardHeader>
         <CardTitle>Sonance Speaker</CardTitle>
         <CardDescription>Premium in-wall speaker</CardDescription>
       </CardHeader>
       <CardContent>
-        <p className="text-2xl font-light text-foreground">$1,299.00</p>
+        <p id="product-card-p-129900" className="text-2xl font-light text-foreground">$1,299.00</p>
       </CardContent>
       <CardFooter>
-        <Button className="w-full">Add to Cart</Button>
+        <Button id="product-card-button" className="w-full">Add to Cart</Button>
       </CardFooter>
     </Card>
   ),
@@ -123,7 +123,7 @@ export const GridLayout: Story = {
             <CardDescription>Feature description</CardDescription>
           </CardHeader>
           <CardContent>
-            <p className="text-foreground-secondary text-sm">
+            <p id="grid-layout-p-brief-explanation-of" className="text-foreground-secondary text-sm">
               Brief explanation of this feature and its benefits.
             </p>
           </CardContent>
@@ -143,7 +143,7 @@ export const VariantsComparison: Story = {
           <CardDescription>Subtle border, hover effect</CardDescription>
         </CardHeader>
         <CardContent>
-          <p className="text-foreground-secondary text-sm">
+          <p id="variants-comparison-p-best-for-content-lis" className="text-foreground-secondary text-sm">
             Best for content lists and grids.
           </p>
         </CardContent>
@@ -154,7 +154,7 @@ export const VariantsComparison: Story = {
           <CardDescription>Shadow with hover enhancement</CardDescription>
         </CardHeader>
         <CardContent>
-          <p className="text-foreground-secondary text-sm">
+          <p id="variants-comparison-p-best-for-featured-or" className="text-foreground-secondary text-sm">
             Best for featured or important content.
           </p>
         </CardContent>
@@ -170,8 +170,8 @@ export const StateMatrix: Story = {
     const states: CardState[] = ['default', 'hover', 'focus'];
 
     return (
-      <div className="space-y-8">
-        <h3 className="text-sm font-medium text-foreground-muted">Card State Matrix</h3>
+      <div data-sonance-name="card.stories" className="space-y-8">
+        <h3 id="state-matrix-h3-card-state-matrix" className="text-sm font-medium text-foreground-muted">Card State Matrix</h3>
         <div className="grid grid-cols-4 gap-4">
           <div></div>
           {states.map((state) => (
@@ -190,7 +190,7 @@ export const StateMatrix: Story = {
                   <CardDescription>{state} state</CardDescription>
                 </CardHeader>
                 <CardContent>
-                  <p className="text-foreground-secondary text-sm">
+                  <p id="state-matrix-p-card-content-goes-he" className="text-foreground-secondary text-sm">
                     Card content goes here.
                   </p>
                 </CardContent>
@@ -209,7 +209,7 @@ export const ResponsiveMatrix: Story = {
     <div className="space-y-8">
       {/* Mobile */}
       <div>
-        <h4 className="text-xs uppercase text-foreground-muted mb-2">Mobile (375px)</h4>
+        <h4 id="responsive-matrix-h4-mobile-375px" className="text-xs uppercase text-foreground-muted mb-2">Mobile (375px)</h4>
         <div className="w-[375px] border border-dashed border-border p-4 space-y-4">
           <Card className="w-full">
             <CardHeader>
@@ -217,17 +217,17 @@ export const ResponsiveMatrix: Story = {
               <CardDescription>Card description</CardDescription>
             </CardHeader>
             <CardContent>
-              <p className="text-foreground-secondary text-sm">Content that fills the mobile width.</p>
+              <p id="responsive-matrix-p-content-that-fills-t" className="text-foreground-secondary text-sm">Content that fills the mobile width.</p>
             </CardContent>
             <CardFooter>
-              <Button className="w-full">Action</Button>
+              <Button id="responsive-matrix-button" className="w-full">Action</Button>
             </CardFooter>
           </Card>
         </div>
       </div>
       {/* Tablet */}
       <div>
-        <h4 className="text-xs uppercase text-foreground-muted mb-2">Tablet (768px)</h4>
+        <h4 id="responsive-matrix-h4-tablet-768px" className="text-xs uppercase text-foreground-muted mb-2">Tablet (768px)</h4>
         <div className="w-[768px] border border-dashed border-border p-4">
           <div className="grid grid-cols-2 gap-4">
             <Card>
@@ -236,7 +236,7 @@ export const ResponsiveMatrix: Story = {
                 <CardDescription>Description</CardDescription>
               </CardHeader>
               <CardContent>
-                <p className="text-foreground-secondary text-sm">Card content for tablet view.</p>
+                <p id="responsive-matrix-p-card-content-for-tab" className="text-foreground-secondary text-sm">Card content for tablet view.</p>
               </CardContent>
             </Card>
             <Card>
@@ -245,7 +245,7 @@ export const ResponsiveMatrix: Story = {
                 <CardDescription>Description</CardDescription>
               </CardHeader>
               <CardContent>
-                <p className="text-foreground-secondary text-sm">Card content for tablet view.</p>
+                <p id="responsive-matrix-p-card-content-for-tab" className="text-foreground-secondary text-sm">Card content for tablet view.</p>
               </CardContent>
             </Card>
           </div>
@@ -253,7 +253,7 @@ export const ResponsiveMatrix: Story = {
       </div>
       {/* Desktop */}
       <div>
-        <h4 className="text-xs uppercase text-foreground-muted mb-2">Desktop (1280px)</h4>
+        <h4 id="responsive-matrix-h4-desktop-1280px" className="text-xs uppercase text-foreground-muted mb-2">Desktop (1280px)</h4>
         <div className="w-[1280px] border border-dashed border-border p-4">
           <div className="grid grid-cols-4 gap-4">
             {[1, 2, 3, 4].map((i) => (
@@ -263,7 +263,7 @@ export const ResponsiveMatrix: Story = {
                   <CardDescription>Feature description</CardDescription>
                 </CardHeader>
                 <CardContent>
-                  <p className="text-foreground-secondary text-sm">Card content at desktop width.</p>
+                  <p id="responsive-matrix-p-card-content-at-desk" className="text-foreground-secondary text-sm">Card content at desktop width.</p>
                 </CardContent>
               </Card>
             ))}

package/dist/assets/components/card.tsx

@@ -33,6 +33,7 @@ export const Card = forwardRef<HTMLDivElement, CardProps>(
   ({ className, variant = "default", state, ...props }, ref) => {
     return (
       <div
+        data-sonance-name="card"
         ref={ref}
         className={cn(
           "bg-card border border-card-border transition-all duration-200",
@@ -53,7 +54,7 @@ export const CardHeader = forwardRef<
   HTMLDivElement,
   React.HTMLAttributes<HTMLDivElement>
 >(({ className, ...props }, ref) => (
-  <div ref={ref} className={cn("p-6", className)} {...props} />
+  <div ref={ref} className={cn("p-6", className)} data-sonance-name="card" {...props} />
 ));
 
 CardHeader.displayName = "CardHeader";
@@ -63,6 +64,7 @@ export const CardTitle = forwardRef<
   React.HTMLAttributes<HTMLHeadingElement>
 >(({ className, ...props }, ref) => (
   <h3
+    id="card-title-h3"
     ref={ref}
     className={cn("text-lg font-medium text-foreground", className)}
     {...props}
@@ -76,8 +78,10 @@ export const CardDescription = forwardRef<
   React.HTMLAttributes<HTMLParagraphElement>
 >(({ className, ...props }, ref) => (
   <p
+    id="card-description-p"
     ref={ref}
     className={cn("mt-1 text-sm text-foreground-muted", className)}
+    data-sonance-name="card"
     {...props}
   />
 ));
@@ -88,7 +92,7 @@ export const CardContent = forwardRef<
   HTMLDivElement,
   React.HTMLAttributes<HTMLDivElement>
 >(({ className, ...props }, ref) => (
-  <div ref={ref} className={cn("p-6 pt-0", className)} {...props} />
+  <div ref={ref} className={cn("p-6 pt-0", className)} data-sonance-name="card" {...props} />
 ));
 
 CardContent.displayName = "CardContent";
@@ -100,9 +104,9 @@ export const CardFooter = forwardRef<
   <div
     ref={ref}
     className={cn("flex items-center p-6 pt-0", className)}
+    data-sonance-name="card"
     {...props}
   />
 ));
 
 CardFooter.displayName = "CardFooter";
-

package/dist/assets/components/carousel.stories.tsx

@@ -29,7 +29,7 @@ export const Default: Story = {
             <div className="p-1">
               <Card>
                 <CardContent className="flex aspect-square items-center justify-center p-6">
-                  <span className="text-4xl font-medium">{index + 1}</span>
+                  <span id="default-span-index-1" className="text-4xl font-medium">{index + 1}</span>
                 </CardContent>
               </Card>
             </div>
@@ -56,7 +56,7 @@ export const Multiple: Story = {
             <div className="p-1">
               <Card>
                 <CardContent className="flex aspect-square items-center justify-center p-6">
-                  <span className="text-3xl font-medium">{index + 1}</span>
+                  <span id="multiple-span-index-1" className="text-3xl font-medium">{index + 1}</span>
                 </CardContent>
               </Card>
             </div>
@@ -84,7 +84,7 @@ export const Vertical: Story = {
             <div className="p-1">
               <Card>
                 <CardContent className="flex items-center justify-center p-6">
-                  <span className="text-3xl font-medium">{index + 1}</span>
+                  <span id="vertical-span-index-1" className="text-3xl font-medium">{index + 1}</span>
                 </CardContent>
               </Card>
             </div>
@@ -111,10 +111,10 @@ export const ProductGallery: Story = {
             <div className="p-1">
               <Card>
                 <CardContent className="flex flex-col aspect-video items-center justify-center p-6 bg-secondary-hover">
-                  <span className="text-foreground-muted text-sm mb-2">
+                  <span id="product-gallery-span-image-index-1" className="text-foreground-muted text-sm mb-2">
                     Image {index + 1}
                   </span>
-                  <span className="text-lg font-medium text-foreground">
+                  <span id="product-gallery-span-product" className="text-lg font-medium text-foreground">
                     {product}
                   </span>
                 </CardContent>
@@ -143,7 +143,7 @@ export const Autoplay: Story = {
             <div className="p-1">
               <Card>
                 <CardContent className="flex aspect-square items-center justify-center p-6">
-                  <span className="text-4xl font-medium">{index + 1}</span>
+                  <span id="autoplay-span-index-1" className="text-4xl font-medium">{index + 1}</span>
                 </CardContent>
               </Card>
             </div>

package/dist/assets/components/carousel.tsx

@@ -138,7 +138,7 @@ const Carousel = React.forwardRef<
           onKeyDownCapture={handleKeyDown}
           className={cn("relative", className)}
           role="region"
-          aria-roledescription="carousel"
+          aria-roledescription="carousel" data-sonance-name="carousel"
           {...props}
         >
           {children}
@@ -156,14 +156,14 @@ const CarouselContent = React.forwardRef<
   const { carouselRef, orientation } = useCarousel();
 
   return (
-    <div ref={carouselRef} className="overflow-hidden">
+    <div data-sonance-name="carousel" ref={carouselRef} className="overflow-hidden">
       <div
         ref={ref}
         className={cn(
           "flex",
           orientation === "horizontal" ? "-ml-4" : "-mt-4 flex-col",
           className
-        )}
+        )} data-sonance-name="carousel"
         {...props}
       />
     </div>
@@ -186,7 +186,7 @@ const CarouselItem = React.forwardRef<
         "min-w-0 shrink-0 grow-0 basis-full",
         orientation === "horizontal" ? "pl-4" : "pt-4",
         className
-      )}
+      )} data-sonance-name="carousel"
       {...props}
     />
   );
@@ -201,6 +201,7 @@ const CarouselPrevious = React.forwardRef<
 
   return (
     <Button
+      id="carousel-previous-button-secondary"
       ref={ref}
       variant="secondary"
       size="sm"
@@ -212,11 +213,11 @@ const CarouselPrevious = React.forwardRef<
         className
       )}
       disabled={!canScrollPrev}
-      onClick={scrollPrev}
+      onClick={scrollPrev} data-sonance-name="carousel"
       {...props}
     >
       <ArrowLeft className="h-4 w-4" />
-      <span className="sr-only">Previous slide</span>
+      <span id="carousel-previous-span-previous-slide" className="sr-only">Previous slide</span>
     </Button>
   );
 });
@@ -230,6 +231,7 @@ const CarouselNext = React.forwardRef<
 
   return (
     <Button
+      id="carousel-next-button-secondary"
       ref={ref}
       variant="secondary"
       size="sm"
@@ -241,11 +243,11 @@ const CarouselNext = React.forwardRef<
         className
       )}
       disabled={!canScrollNext}
-      onClick={scrollNext}
+      onClick={scrollNext} data-sonance-name="carousel"
       {...props}
     >
       <ArrowRight className="h-4 w-4" />
-      <span className="sr-only">Next slide</span>
+      <span id="carousel-next-span-next-slide" className="sr-only">Next slide</span>
     </Button>
   );
 });

package/dist/assets/components/chart.tsx

@@ -53,7 +53,7 @@ const ChartContainer = React.forwardRef<
         className={cn(
           "flex aspect-video justify-center text-xs [&_.recharts-cartesian-axis-tick_text]:fill-foreground-muted [&_.recharts-cartesian-grid_line[stroke='#ccc']]:stroke-border/50 [&_.recharts-curve.recharts-tooltip-cursor]:stroke-border [&_.recharts-dot[stroke='#fff']]:stroke-transparent [&_.recharts-layer]:outline-none [&_.recharts-polar-grid_[stroke='#ccc']]:stroke-border [&_.recharts-radial-bar-background-sector]:fill-secondary-hover [&_.recharts-rectangle.recharts-tooltip-cursor]:fill-secondary-hover [&_.recharts-reference-line_[stroke='#ccc']]:stroke-border [&_.recharts-sector[stroke='#fff']]:stroke-transparent [&_.recharts-sector]:outline-none [&_.recharts-surface]:outline-none",
           className
-        )}
+        )} data-sonance-name="chart"
         {...props}
       >
         <ChartStyle id={chartId} config={config} />
@@ -76,7 +76,7 @@ const ChartStyle = ({ id, config }: { id: string; config: ChartConfig }) => {
   }
 
   return (
-    <style
+    <style data-sonance-name="chart"
       dangerouslySetInnerHTML={{
         __html: Object.entries(THEMES)
           .map(
@@ -165,7 +165,7 @@ const ChartTooltipContent = React.forwardRef<HTMLDivElement, ChartTooltipContent
 
       if (labelFormatter) {
         return (
-          <div className={cn("font-medium", labelClassName)}>
+          <div data-sonance-name="chart" className={cn("font-medium", labelClassName)}>
             {labelFormatter(value, payload)}
           </div>
         );
@@ -251,12 +251,12 @@ const ChartTooltipContent = React.forwardRef<HTMLDivElement, ChartTooltipContent
                     >
                       <div className="grid gap-1.5">
                         {nestLabel ? tooltipLabel : null}
-                        <span className="text-foreground-muted">
+                        <span id="span-itemconfiglabel-item" className="text-foreground-muted">
                           {itemConfig?.label || item.name}
                         </span>
                       </div>
                       {item.value && (
-                        <span className="font-mono font-medium tabular-nums text-foreground">
+                        <span id="span-typeof-itemvalue-num" className="font-mono font-medium tabular-nums text-foreground">
                           {typeof item.value === 'number' ? item.value.toLocaleString() : item.value}
                         </span>
                       )}

package/dist/assets/components/checkbox-group.stories.tsx

@@ -45,7 +45,7 @@ export const Default: Story = {
   render: () => {
     const [values, setValues] = useState<string[]>([]);
     return (
-      <CheckboxGroup value={values} onValueChange={setValues}>
+      <CheckboxGroup data-sonance-name="checkbox-group.stories" value={values} onValueChange={setValues}>
         <CheckboxGroupItem value="option1" label="Option 1" />
         <CheckboxGroupItem value="option2" label="Option 2" />
         <CheckboxGroupItem value="option3" label="Option 3" />
@@ -224,8 +224,8 @@ export const FormExample: Story = {
         </CheckboxGroup>
 
         <div className="text-sm text-foreground-muted">
-          <p>Interests: {interests.join(', ') || 'None selected'}</p>
-          <p>Agreements: {agreements.join(', ') || 'None selected'}</p>
+          <p id="form-example-p-interests-interestsj">Interests: {interests.join(', ') || 'None selected'}</p>
+          <p id="form-example-p-agreements-agreement">Agreements: {agreements.join(', ') || 'None selected'}</p>
         </div>
       </div>
     );
@@ -238,7 +238,7 @@ export const ResponsiveMatrix: Story = {
     <div className="space-y-8">
       {/* Mobile */}
       <div>
-        <h4 className="text-xs uppercase text-foreground-muted mb-2">Mobile (375px)</h4>
+        <h4 id="responsive-matrix-h4-mobile-375px" className="text-xs uppercase text-foreground-muted mb-2">Mobile (375px)</h4>
         <div className="w-[375px] border border-dashed border-border p-4">
           <CheckboxGroup label="Select Options" defaultValue={['option1']}>
             <CheckboxGroupItem value="option1" label="Option 1" />
@@ -249,7 +249,7 @@ export const ResponsiveMatrix: Story = {
       </div>
       {/* Tablet */}
       <div>
-        <h4 className="text-xs uppercase text-foreground-muted mb-2">Tablet (768px)</h4>
+        <h4 id="responsive-matrix-h4-tablet-768px" className="text-xs uppercase text-foreground-muted mb-2">Tablet (768px)</h4>
         <div className="w-[768px] border border-dashed border-border p-4">
           <CheckboxGroup label="Select Sizes" orientation="horizontal" defaultValue={['medium']}>
             <CheckboxGroupItem value="small" label="Small" />
@@ -261,7 +261,7 @@ export const ResponsiveMatrix: Story = {
       </div>
       {/* Desktop */}
       <div>
-        <h4 className="text-xs uppercase text-foreground-muted mb-2">Desktop (1280px)</h4>
+        <h4 id="responsive-matrix-h4-desktop-1280px" className="text-xs uppercase text-foreground-muted mb-2">Desktop (1280px)</h4>
         <div className="w-[1280px] border border-dashed border-border p-4">
           <div className="grid grid-cols-2 gap-8">
             <CheckboxGroup label="Features" defaultValue={['basic']}>

package/dist/assets/components/checkbox-group.tsx

@@ -79,7 +79,7 @@ export function CheckboxGroup({
         >
           {children}
         </div>
-        {error && <p className="mt-2 text-sm text-error">{error}</p>}
+        {error && <p id="checkbox-group-p-error" className="mt-2 text-sm text-error">{error}</p>}
       </div>
     </CheckboxGroupContext.Provider>
   );
@@ -109,7 +109,7 @@ export function CheckboxGroupItem({
   };
 
   return (
-    <Checkbox
+    <Checkbox id="checkbox-group-item-checkbox-checkboxgroup" data-sonance-name="checkbox-group"
       checked={isChecked}
       onChange={handleChange}
       disabled={isDisabled}
@@ -145,7 +145,7 @@ export function CheckboxList({
   className,
 }: CheckboxListProps) {
   return (
-    <CheckboxGroup
+    <CheckboxGroup data-sonance-name="checkbox-group"
       value={value}
       defaultValue={defaultValue}
       onValueChange={onValueChange}

package/dist/assets/components/checkbox.stories.tsx

@@ -84,11 +84,11 @@ export const DisabledChecked: Story = {
 export const AllStates: Story = {
   render: () => (
     <div className="space-y-4">
-      <Checkbox label="Unchecked" />
-      <Checkbox label="Checked" defaultChecked />
-      <Checkbox label="With description" description="Additional information about this option" />
-      <Checkbox label="Disabled" disabled />
-      <Checkbox label="Disabled checked" disabled defaultChecked />
+      <Checkbox id="all-states-checkbox" label="Unchecked" />
+      <Checkbox id="all-states-checkbox" label="Checked" defaultChecked />
+      <Checkbox id="all-states-checkbox" label="With description" description="Additional information about this option" />
+      <Checkbox id="all-states-checkbox" label="Disabled" disabled />
+      <Checkbox id="all-states-checkbox" label="Disabled checked" disabled defaultChecked />
     </div>
   ),
 };
@@ -98,17 +98,20 @@ export const FormExample: Story = {
   render: () => (
     <div className="space-y-6 w-80">
       <div className="space-y-4">
-        <h3 className="text-sm font-medium text-foreground">Notification Preferences</h3>
+        <h3 id="form-example-h3-notification-prefere" className="text-sm font-medium text-foreground">Notification Preferences</h3>
         <Checkbox
+          id="form-example-checkbox"
           label="Email notifications"
           description="Get notified about account activity via email"
           defaultChecked
         />
         <Checkbox
+          id="form-example-checkbox"
           label="SMS notifications"
           description="Get notified via text message"
         />
         <Checkbox
+          id="form-example-checkbox"
           label="Push notifications"
           description="Get notified on your mobile device"
           defaultChecked
@@ -124,34 +127,34 @@ export const ResponsiveMatrix: Story = {
     <div className="space-y-8">
       {/* Mobile */}
       <div>
-        <h4 className="text-xs uppercase text-foreground-muted mb-2">Mobile (375px)</h4>
+        <h4 id="responsive-matrix-h4-mobile-375px" className="text-xs uppercase text-foreground-muted mb-2">Mobile (375px)</h4>
         <div className="w-[375px] border border-dashed border-border p-4 space-y-4">
-          <Checkbox label="Accept terms and conditions" />
-          <Checkbox label="Subscribe to newsletter" description="Receive updates about new features" />
-          <Checkbox label="Remember me" defaultChecked />
+          <Checkbox id="responsive-matrix-checkbox" label="Accept terms and conditions" />
+          <Checkbox id="responsive-matrix-checkbox" label="Subscribe to newsletter" description="Receive updates about new features" />
+          <Checkbox id="responsive-matrix-checkbox" label="Remember me" defaultChecked />
         </div>
       </div>
       {/* Tablet */}
       <div>
-        <h4 className="text-xs uppercase text-foreground-muted mb-2">Tablet (768px)</h4>
+        <h4 id="responsive-matrix-h4-tablet-768px" className="text-xs uppercase text-foreground-muted mb-2">Tablet (768px)</h4>
         <div className="w-[768px] border border-dashed border-border p-4">
           <div className="grid grid-cols-2 gap-4">
-            <Checkbox label="Email notifications" description="Get notified via email" defaultChecked />
-            <Checkbox label="SMS notifications" description="Get notified via text" />
-            <Checkbox label="Push notifications" description="Mobile app notifications" defaultChecked />
-            <Checkbox label="Marketing emails" description="Product updates and offers" />
+            <Checkbox id="responsive-matrix-checkbox" label="Email notifications" description="Get notified via email" defaultChecked />
+            <Checkbox id="responsive-matrix-checkbox" label="SMS notifications" description="Get notified via text" />
+            <Checkbox id="responsive-matrix-checkbox" label="Push notifications" description="Mobile app notifications" defaultChecked />
+            <Checkbox id="responsive-matrix-checkbox" label="Marketing emails" description="Product updates and offers" />
           </div>
         </div>
       </div>
       {/* Desktop */}
       <div>
-        <h4 className="text-xs uppercase text-foreground-muted mb-2">Desktop (1280px)</h4>
+        <h4 id="responsive-matrix-h4-desktop-1280px" className="text-xs uppercase text-foreground-muted mb-2">Desktop (1280px)</h4>
         <div className="w-[1280px] border border-dashed border-border p-4">
           <div className="grid grid-cols-4 gap-4">
-            <Checkbox label="Unchecked" />
-            <Checkbox label="Checked" defaultChecked />
-            <Checkbox label="Disabled" disabled />
-            <Checkbox label="Disabled checked" disabled defaultChecked />
+            <Checkbox id="responsive-matrix-checkbox" label="Unchecked" />
+            <Checkbox id="responsive-matrix-checkbox" label="Checked" defaultChecked />
+            <Checkbox id="responsive-matrix-checkbox" label="Disabled" disabled />
+            <Checkbox id="responsive-matrix-checkbox" label="Disabled checked" disabled defaultChecked />
           </div>
         </div>
       </div>

package/dist/assets/components/checkbox.tsx

@@ -28,31 +28,28 @@ const getStateStyles = (state?: CheckboxState) => {
 };
 
 export const Checkbox = forwardRef<HTMLInputElement, CheckboxProps>(
-  ({ className, label, description, id, state, disabled, checked, ...props }, ref) => {
+  ({ className, label, description, id, state, disabled, checked, defaultChecked, onChange, style, ...props }, ref) => {
     const uniqueId = useId();
     const inputId = id || `checkbox-${uniqueId}`;
     const isDisabled = disabled || state === "disabled";
-    
-    // Resolve checked state:
-    // 1. If visual state is "checked", force true.
-    // 2. Else use provided checked prop (undefined = uncontrolled).
-    const isVisualChecked = state === "checked";
-    const resolvedChecked = isVisualChecked ? true : checked;
-    
-    // If visual state forces checked but no handler, mark readOnly to avoid React warnings
-    const isReadOnly = isVisualChecked && !props.onChange && !props.readOnly;
+
+    // Determine if we're in controlled mode
+    const isControlled = checked !== undefined || onChange !== undefined;
+    const isCheckedForState = state === "checked";
 
     return (
-      <div className="flex items-start gap-3">
+      <div data-sonance-name="checkbox" className="flex items-start gap-3">
         <div className="relative flex items-center justify-center">
           <input
-            key={isVisualChecked ? "visual-checked" : "normal"}
             type="checkbox"
             id={inputId}
             ref={ref}
             disabled={isDisabled}
-            checked={resolvedChecked}
-            readOnly={isReadOnly || props.readOnly}
+            style={style}
+            {...(isControlled
+              ? { checked: checked || isCheckedForState, onChange }
+              : { defaultChecked: defaultChecked || isCheckedForState }
+            )}
             className={cn(
               "peer h-5 w-5 shrink-0 appearance-none border border-border bg-input",
               "hover:border-border-hover",
@@ -62,7 +59,7 @@ export const Checkbox = forwardRef<HTMLInputElement, CheckboxProps>(
               "transition-colors duration-150",
               getStateStyles(state),
               className
-            )}
+            )} data-sonance-name="checkbox"
             {...props}
           />
           <Check
@@ -83,7 +80,7 @@ export const Checkbox = forwardRef<HTMLInputElement, CheckboxProps>(
               </label>
             )}
             {description && (
-              <p className="text-xs text-foreground-muted">{description}</p>
+              <p id="p-description" className="text-xs text-foreground-muted">{description}</p>
             )}
           </div>
         )}