sonance-brand-mcp 1.2.5 → 1.3.2

package/dist/assets/components/navbar.tsx

@@ -20,15 +20,7 @@ export const Navbar = forwardRef<HTMLElement, NavbarProps>(
     };
 
     return (
-      <nav
-        ref={ref}
-        className={cn(
-          "w-full px-6 py-4",
-          variantClasses[variant],
-          sticky && "sticky top-0 z-40",
-          bordered && variant !== "dark" && variant !== "transparent" && "border-b border-border",
-          className
-        )}
+      <nav data-sonance-name="navbar"
         {...props}
       >
         {children}
@@ -53,7 +45,7 @@ export const NavbarContent = forwardRef<
   return (
     <div
       ref={ref}
-      className={cn("flex items-center gap-6", justifyClasses[justify], className)}
+      className={cn("flex items-center gap-6", justifyClasses[justify], className)} data-sonance-name="navbar"
       {...props}
     />
   );
@@ -67,7 +59,7 @@ export const NavbarBrand = forwardRef<
 >(({ className, ...props }, ref) => (
   <div
     ref={ref}
-    className={cn("flex items-center gap-2 shrink-0", className)}
+    className={cn("flex items-center gap-2 shrink-0", className)} data-sonance-name="navbar"
     {...props}
   />
 ));
@@ -80,7 +72,7 @@ export const NavbarItems = forwardRef<
 >(({ className, ...props }, ref) => (
   <div
     ref={ref}
-    className={cn("hidden md:flex items-center gap-6", className)}
+    className={cn("hidden md:flex items-center gap-6", className)} data-sonance-name="navbar"
     {...props}
   />
 ));
@@ -94,12 +86,13 @@ interface NavbarItemProps extends React.AnchorHTMLAttributes<HTMLAnchorElement>
 export const NavbarItem = forwardRef<HTMLAnchorElement, NavbarItemProps>(
   ({ className, active, ...props }, ref) => (
     <a
+      id="navbar-item-a"
       ref={ref}
       className={cn(
         "text-sm font-normal transition-opacity",
         active ? "opacity-100 font-medium" : "opacity-85 hover:opacity-100",
         className
-      )}
+      )} data-sonance-name="navbar"
       {...props}
     />
   )
@@ -116,7 +109,7 @@ interface NavbarMobileToggleProps {
 
 export function NavbarMobileToggle({ isOpen, onToggle, className }: NavbarMobileToggleProps) {
   return (
-    <button
+    <button data-sonance-name="navbar"
       type="button"
       onClick={onToggle}
       className={cn("md:hidden p-2 -m-2", className)}
@@ -193,6 +186,7 @@ export function ResponsiveNavbar({
       <NavbarMobileMenu isOpen={mobileMenuOpen}>
         {items.map((item) => (
           <a
+            id="nav-a"
             key={item.href}
             href={item.href}
             className={cn(

package/dist/assets/components/navigation-menu.stories.tsx

@@ -0,0 +1,239 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import {
+  NavigationMenu,
+  NavigationMenuContent,
+  NavigationMenuItem,
+  NavigationMenuLink,
+  NavigationMenuList,
+  NavigationMenuTrigger,
+  navigationMenuTriggerStyle,
+} from "./navigation-menu";
+import { cn } from "@/lib/utils";
+import React from "react";
+
+const meta: Meta<typeof NavigationMenu> = {
+  title: "Components/Navigation/NavigationMenu",
+  component: NavigationMenu,
+  parameters: {
+    layout: "centered",
+  },
+  tags: ["autodocs"],
+};
+
+export default meta;
+type Story = StoryObj<typeof NavigationMenu>;
+
+const components: { title: string; href: string; description: string }[] = [
+  {
+    title: "Alert Dialog",
+    href: "#",
+    description:
+      "A modal dialog that interrupts the user with important content and expects a response.",
+  },
+  {
+    title: "Hover Card",
+    href: "#",
+    description:
+      "For sighted users to preview content available behind a link.",
+  },
+  {
+    title: "Progress",
+    href: "#",
+    description:
+      "Displays an indicator showing the completion progress of a task.",
+  },
+  {
+    title: "Scroll Area",
+    href: "#",
+    description: "Visually or semantically separates content.",
+  },
+  {
+    title: "Tabs",
+    href: "#",
+    description:
+      "A set of layered sections of content—known as tab panels.",
+  },
+  {
+    title: "Tooltip",
+    href: "#",
+    description:
+      "A popup that displays information related to an element.",
+  },
+];
+
+const ListItem = React.forwardRef<
+  React.ElementRef<"a">,
+  React.ComponentPropsWithoutRef<"a">
+>(({ className, title, children, ...props }, ref) => {
+  return (
+    <li>
+      <NavigationMenuLink asChild>
+        <a
+          id="nav-a"
+          ref={ref}
+          className={cn(
+            "block select-none space-y-1 rounded-sm p-3 leading-none no-underline outline-none transition-colors hover:bg-secondary-hover hover:text-foreground focus:bg-secondary-hover focus:text-foreground",
+            className
+          )} data-sonance-name="navigation-menu.stories"
+          {...props}
+        >
+          <div className="text-sm font-medium leading-none">{title}</div>
+          <p id="nav-p-children" className="line-clamp-2 text-sm leading-snug text-foreground-muted">
+            {children}
+          </p>
+        </a>
+      </NavigationMenuLink>
+    </li>
+  );
+});
+ListItem.displayName = "ListItem";
+
+export const Default: Story = {
+  render: () => (
+    <NavigationMenu>
+      <NavigationMenuList>
+        <NavigationMenuItem>
+          <NavigationMenuTrigger>Getting started</NavigationMenuTrigger>
+          <NavigationMenuContent>
+            <ul className="grid gap-3 p-6 md:w-[400px] lg:w-[500px] lg:grid-cols-[.75fr_1fr]">
+              <li className="row-span-3">
+                <NavigationMenuLink asChild>
+                  <a
+                    id="nav-a"
+                    className="flex h-full w-full select-none flex-col justify-end rounded-sm bg-gradient-to-b from-secondary-hover/50 to-secondary-hover p-6 no-underline outline-none focus:shadow-md"
+                    href="#"
+                  >
+                    <div className="mb-2 mt-4 text-lg font-medium">
+                      Sonance
+                    </div>
+                    <p id="nav-p-premium-architectura" className="text-sm leading-tight text-foreground-muted">
+                      Premium architectural speakers and outdoor audio solutions.
+                    </p>
+                  </a>
+                </NavigationMenuLink>
+              </li>
+              <ListItem href="#" title="Introduction">
+                Learn about the Sonance brand and our commitment to audio excellence.
+              </ListItem>
+              <ListItem href="#" title="Installation">
+                How to get started with your Sonance audio system.
+              </ListItem>
+              <ListItem href="#" title="Support">
+                Find answers and get help from our team.
+              </ListItem>
+            </ul>
+          </NavigationMenuContent>
+        </NavigationMenuItem>
+        <NavigationMenuItem>
+          <NavigationMenuTrigger>Components</NavigationMenuTrigger>
+          <NavigationMenuContent>
+            <ul className="grid w-[400px] gap-3 p-4 md:w-[500px] md:grid-cols-2 lg:w-[600px]">
+              {components.map((component) => (
+                <ListItem
+                  key={component.title}
+                  title={component.title}
+                  href={component.href}
+                >
+                  {component.description}
+                </ListItem>
+              ))}
+            </ul>
+          </NavigationMenuContent>
+        </NavigationMenuItem>
+        <NavigationMenuItem>
+          <a id="nav-a" href="#">
+            <NavigationMenuLink className={navigationMenuTriggerStyle()}>
+              Documentation
+            </NavigationMenuLink>
+          </a>
+        </NavigationMenuItem>
+      </NavigationMenuList>
+    </NavigationMenu>
+  ),
+};
+
+export const Simple: Story = {
+  render: () => (
+    <NavigationMenu>
+      <NavigationMenuList>
+        <NavigationMenuItem>
+          <a id="nav-a" href="#">
+            <NavigationMenuLink className={navigationMenuTriggerStyle()}>
+              Products
+            </NavigationMenuLink>
+          </a>
+        </NavigationMenuItem>
+        <NavigationMenuItem>
+          <a id="nav-a" href="#">
+            <NavigationMenuLink className={navigationMenuTriggerStyle()}>
+              Solutions
+            </NavigationMenuLink>
+          </a>
+        </NavigationMenuItem>
+        <NavigationMenuItem>
+          <a id="nav-a" href="#">
+            <NavigationMenuLink className={navigationMenuTriggerStyle()}>
+              Support
+            </NavigationMenuLink>
+          </a>
+        </NavigationMenuItem>
+        <NavigationMenuItem>
+          <a id="nav-a" href="#">
+            <NavigationMenuLink className={navigationMenuTriggerStyle()}>
+              About
+            </NavigationMenuLink>
+          </a>
+        </NavigationMenuItem>
+      </NavigationMenuList>
+    </NavigationMenu>
+  ),
+};
+
+export const ProductsMenu: Story = {
+  render: () => (
+    <NavigationMenu>
+      <NavigationMenuList>
+        <NavigationMenuItem>
+          <NavigationMenuTrigger>Architectural</NavigationMenuTrigger>
+          <NavigationMenuContent>
+            <ul className="grid gap-3 p-4 w-[400px]">
+              <ListItem href="#" title="In-Ceiling Speakers">
+                Invisible audio solutions for residential and commercial spaces.
+              </ListItem>
+              <ListItem href="#" title="In-Wall Speakers">
+                Seamless integration into any wall surface.
+              </ListItem>
+              <ListItem href="#" title="Invisible Series">
+                Completely hidden speakers that disappear into your walls.
+              </ListItem>
+            </ul>
+          </NavigationMenuContent>
+        </NavigationMenuItem>
+        <NavigationMenuItem>
+          <NavigationMenuTrigger>Outdoor</NavigationMenuTrigger>
+          <NavigationMenuContent>
+            <ul className="grid gap-3 p-4 w-[400px]">
+              <ListItem href="#" title="Landscape Series">
+                Outdoor speakers designed to blend into your garden.
+              </ListItem>
+              <ListItem href="#" title="Patio Series">
+                Weather-resistant speakers for covered outdoor areas.
+              </ListItem>
+              <ListItem href="#" title="Subwoofers">
+                Powerful bass for your outdoor entertainment.
+              </ListItem>
+            </ul>
+          </NavigationMenuContent>
+        </NavigationMenuItem>
+        <NavigationMenuItem>
+          <a id="nav-a" href="#">
+            <NavigationMenuLink className={navigationMenuTriggerStyle()}>
+              View All
+            </NavigationMenuLink>
+          </a>
+        </NavigationMenuItem>
+      </NavigationMenuList>
+    </NavigationMenu>
+  ),
+};
+

package/dist/assets/components/navigation-menu.tsx

@@ -0,0 +1,135 @@
+"use client";
+
+import * as React from "react";
+import * as NavigationMenuPrimitive from "@radix-ui/react-navigation-menu";
+import { ChevronDown } from "lucide-react";
+import { cva } from "class-variance-authority";
+import { cn } from "@/lib/utils";
+
+const NavigationMenu = React.forwardRef<
+  React.ElementRef<typeof NavigationMenuPrimitive.Root>,
+  React.ComponentPropsWithoutRef<typeof NavigationMenuPrimitive.Root>
+>(({ className, children, ...props }, ref) => (
+  <NavigationMenuPrimitive.Root
+    ref={ref}
+    className={cn(
+      "relative z-10 flex max-w-max flex-1 items-center justify-center",
+      className
+    )}
+    {...props}
+  >
+    {children}
+    <NavigationMenuViewport />
+  </NavigationMenuPrimitive.Root>
+));
+NavigationMenu.displayName = NavigationMenuPrimitive.Root.displayName;
+
+const NavigationMenuList = React.forwardRef<
+  React.ElementRef<typeof NavigationMenuPrimitive.List>,
+  React.ComponentPropsWithoutRef<typeof NavigationMenuPrimitive.List>
+>(({ className, ...props }, ref) => (
+  <NavigationMenuPrimitive.List
+    ref={ref}
+    className={cn(
+      "group flex flex-1 list-none items-center justify-center space-x-1",
+      className
+    )}
+    {...props}
+  />
+));
+NavigationMenuList.displayName = NavigationMenuPrimitive.List.displayName;
+
+const NavigationMenuItem = NavigationMenuPrimitive.Item;
+
+const navigationMenuTriggerStyle = cva(
+  "group inline-flex h-10 w-max items-center justify-center rounded-sm bg-background px-4 py-2 text-sm font-medium transition-colors hover:bg-secondary-hover hover:text-foreground focus:bg-secondary-hover focus:text-foreground focus:outline-none disabled:pointer-events-none disabled:opacity-50 data-[active]:bg-secondary-hover/50 data-[state=open]:bg-secondary-hover/50"
+);
+
+const NavigationMenuTrigger = React.forwardRef<
+  React.ElementRef<typeof NavigationMenuPrimitive.Trigger>,
+  React.ComponentPropsWithoutRef<typeof NavigationMenuPrimitive.Trigger>
+>(({ className, children, ...props }, ref) => (
+  <NavigationMenuPrimitive.Trigger
+    ref={ref}
+    className={cn(navigationMenuTriggerStyle(), "group", className)}
+    {...props}
+  >
+    {children}{" "}
+    <ChevronDown
+      className="relative top-[1px] ml-1 h-3 w-3 transition duration-200 group-data-[state=open]:rotate-180"
+      aria-hidden="true"
+    />
+  </NavigationMenuPrimitive.Trigger>
+));
+NavigationMenuTrigger.displayName = NavigationMenuPrimitive.Trigger.displayName;
+
+const NavigationMenuContent = React.forwardRef<
+  React.ElementRef<typeof NavigationMenuPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof NavigationMenuPrimitive.Content>
+>(({ className, ...props }, ref) => (
+  <NavigationMenuPrimitive.Content
+    ref={ref}
+    className={cn(
+      "left-0 top-0 w-full data-[motion^=from-]:animate-in data-[motion^=to-]:animate-out data-[motion^=from-]:fade-in data-[motion^=to-]:fade-out data-[motion=from-end]:slide-in-from-right-52 data-[motion=from-start]:slide-in-from-left-52 data-[motion=to-end]:slide-out-to-right-52 data-[motion=to-start]:slide-out-to-left-52 md:absolute md:w-auto",
+      className
+    )}
+    {...props}
+  />
+));
+NavigationMenuContent.displayName = NavigationMenuPrimitive.Content.displayName;
+
+const NavigationMenuLink = NavigationMenuPrimitive.Link;
+
+const NavigationMenuViewport = React.forwardRef<
+  React.ElementRef<typeof NavigationMenuPrimitive.Viewport>,
+  React.ComponentPropsWithoutRef<typeof NavigationMenuPrimitive.Viewport>
+>(({ className, ...props }, ref) => (
+  <div data-sonance-name="navigation-menu" className={cn("absolute left-0 top-full flex justify-center")}>
+    <NavigationMenuPrimitive.Viewport
+      className={cn(
+        "origin-top-center relative mt-1.5 h-[var(--radix-navigation-menu-viewport-height)] w-full overflow-hidden rounded-sm border border-border bg-card text-foreground shadow-lg",
+        "data-[state=open]:animate-in data-[state=closed]:animate-out",
+        "data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-90",
+        "md:w-[var(--radix-navigation-menu-viewport-width)]",
+        className
+      )}
+      ref={ref}
+      {...props}
+    />
+  </div>
+));
+NavigationMenuViewport.displayName =
+  NavigationMenuPrimitive.Viewport.displayName;
+
+const NavigationMenuIndicator = React.forwardRef<
+  React.ElementRef<typeof NavigationMenuPrimitive.Indicator>,
+  React.ComponentPropsWithoutRef<typeof NavigationMenuPrimitive.Indicator>
+>(({ className, ...props }, ref) => (
+  <NavigationMenuPrimitive.Indicator
+    ref={ref}
+    className={cn(
+      "top-full z-[1] flex h-1.5 items-end justify-center overflow-hidden",
+      "data-[state=visible]:animate-in data-[state=hidden]:animate-out",
+      "data-[state=hidden]:fade-out data-[state=visible]:fade-in",
+      className
+    )}
+    {...props}
+  >
+    <div className="relative top-[60%] h-2 w-2 rotate-45 rounded-tl-sm bg-border shadow-md" />
+  </NavigationMenuPrimitive.Indicator>
+));
+NavigationMenuIndicator.displayName =
+  NavigationMenuPrimitive.Indicator.displayName;
+
+export {
+  navigationMenuTriggerStyle,
+  NavigationMenu,
+  NavigationMenuList,
+  NavigationMenuItem,
+  NavigationMenuContent,
+  NavigationMenuTrigger,
+  NavigationMenuLink,
+  NavigationMenuIndicator,
+  NavigationMenuViewport,
+};
+

package/dist/assets/components/number-input.stories.tsx

@@ -157,7 +157,7 @@ export const Controlled: Story = {
   render: () => {
     const [value, setValue] = useState(10);
     return (
-      <div className="w-48 space-y-4">
+      <div data-sonance-name="number-input.stories" className="w-48 space-y-4">
         <NumberInput
           label="Controlled Input"
           value={value}
@@ -165,7 +165,7 @@ export const Controlled: Story = {
           min={0}
           max={20}
         />
-        <p className="text-sm text-foreground-muted">
+        <p id="controlled-p-current-value-value" className="text-sm text-foreground-muted">
           Current value: {value}
         </p>
         <div className="flex gap-2">
@@ -211,8 +211,8 @@ export const QuantitySelector: Story = {
 
     return (
       <div className="p-4 border border-border w-80">
-        <h3 className="font-medium text-foreground">VP66 TL In-Wall Speaker</h3>
-        <p className="text-sm text-foreground-muted mt-1">${pricePerUnit.toFixed(2)} each</p>
+        <h3 id="quantity-selector-h3-vp66-tl-inwall-speak" className="font-medium text-foreground">VP66 TL In-Wall Speaker</h3>
+        <p id="quantity-selector-p-priceperunittofixed2" className="text-sm text-foreground-muted mt-1">${pricePerUnit.toFixed(2)} each</p>
         <div className="mt-4">
           <NumberInput
             label="Quantity"
@@ -223,8 +223,8 @@ export const QuantitySelector: Story = {
           />
         </div>
         <div className="mt-4 pt-4 border-t border-border flex justify-between items-center">
-          <span className="text-sm text-foreground-muted">Total:</span>
-          <span className="text-lg font-medium text-foreground">
+          <span id="quantity-selector-span-total" className="text-sm text-foreground-muted">Total:</span>
+          <span id="quantity-selector-span-totaltofixed2" className="text-lg font-medium text-foreground">
             ${total.toFixed(2)}
           </span>
         </div>
@@ -239,11 +239,11 @@ export const StateMatrix: Story = {
     const states: NumberInputState[] = ['default', 'hover', 'focus', 'error', 'disabled'];
     return (
       <div className="space-y-6 w-48">
-        <h3 className="text-sm font-medium text-foreground-muted">NumberInput States</h3>
+        <h3 id="state-matrix-h3-numberinput-states" className="text-sm font-medium text-foreground-muted">NumberInput States</h3>
         <div className="space-y-4">
           {states.map((state) => (
             <div key={state}>
-              <span className="text-xs font-medium text-foreground-muted uppercase">{state}</span>
+              <span id="state-matrix-span-state" className="text-xs font-medium text-foreground-muted uppercase">{state}</span>
               <NumberInput
                 state={state}
                 defaultValue={5}
@@ -263,14 +263,14 @@ 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">
           <NumberInput label="Quantity" defaultValue={1} min={1} max={10} />
         </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">
             <NumberInput label="Quantity" defaultValue={5} />
@@ -280,7 +280,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">
             <NumberInput label="Default" defaultValue={5} />

package/dist/assets/components/number-input.tsx

@@ -134,7 +134,7 @@ export const NumberInput = forwardRef<HTMLInputElement, NumberInputProps>(
       : inputValue;
 
     return (
-      <div className={cn("w-full", className)}>
+      <div data-sonance-name="number-input" className={cn("w-full", className)}>
         {label && (
           <label className="mb-2 block text-xs font-medium uppercase tracking-widest text-foreground-muted">
             {label}
@@ -196,7 +196,7 @@ export const NumberInput = forwardRef<HTMLInputElement, NumberInputProps>(
             </button>
           )}
         </div>
-        {error && <p className="mt-1 text-sm text-error">{error}</p>}
+        {error && <p id="p-error" className="mt-1 text-sm text-error">{error}</p>}
       </div>
     );
   }
@@ -218,7 +218,7 @@ export function Stepper({ size = "md", className, ...props }: StepperProps) {
 
   return (
     <NumberInput
-      {...props}
+      data-sonance-name="number-input" {...props}
       className={cn(sizeClasses[size], className)}
     />
   );

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

@@ -37,7 +37,7 @@ export const Default: Story = {
   render: () => {
     const [page, setPage] = useState(1);
     return (
-      <Pagination
+      <Pagination data-sonance-name="pagination.stories"
         currentPage={page}
         totalPages={10}
         onPageChange={setPage}
@@ -131,7 +131,7 @@ export const BothStyles: Story = {
     return (
       <div className="space-y-8">
         <div>
-          <p className="text-xs text-foreground-muted mb-2">Full Pagination</p>
+          <p id="both-styles-p-full-pagination" className="text-xs text-foreground-muted mb-2">Full Pagination</p>
           <Pagination
             currentPage={page}
             totalPages={20}
@@ -139,7 +139,7 @@ export const BothStyles: Story = {
           />
         </div>
         <div>
-          <p className="text-xs text-foreground-muted mb-2">Compact Pagination</p>
+          <p id="both-styles-p-compact-pagination" className="text-xs text-foreground-muted mb-2">Compact Pagination</p>
           <CompactPagination
             currentPage={page}
             totalPages={20}
@@ -186,7 +186,7 @@ export const TableExample: Story = {
           </table>
         </div>
         <div className="flex items-center justify-between">
-          <p className="text-sm text-foreground-muted">
+          <p id="table-example-p-showing-page-1-items" className="text-sm text-foreground-muted">
             Showing {(page - 1) * itemsPerPage + 1} to{' '}
             {Math.min(page * itemsPerPage, items.length)} of {items.length} results
           </p>
@@ -207,19 +207,19 @@ export const StateMatrix: Story = {
     const states: PaginationButtonState[] = ['default', 'hover', 'focus', 'active', 'disabled'];
     return (
       <div className="space-y-6">
-        <h3 className="text-sm font-medium text-foreground-muted">PaginationButton States</h3>
-        <p className="text-xs text-foreground-muted">States are demonstrated via the Pagination component&apos;s active and disabled props.</p>
+        <h3 id="state-matrix-h3-paginationbutton-sta" className="text-sm font-medium text-foreground-muted">PaginationButton States</h3>
+        <p id="state-matrix-p-states-are-demonstra" className="text-xs text-foreground-muted">States are demonstrated via the Pagination component&apos;s active and disabled props.</p>
         <div className="space-y-4">
           <div>
-            <span className="text-xs font-medium text-foreground-muted uppercase">Default + Active</span>
+            <span id="state-matrix-span-default-active" className="text-xs font-medium text-foreground-muted uppercase">Default + Active</span>
             <Pagination currentPage={3} totalPages={5} onPageChange={() => {}} />
           </div>
           <div>
-            <span className="text-xs font-medium text-foreground-muted uppercase">First Page (prev disabled)</span>
+            <span id="state-matrix-span-first-page-prev-disa" className="text-xs font-medium text-foreground-muted uppercase">First Page (prev disabled)</span>
             <Pagination currentPage={1} totalPages={5} onPageChange={() => {}} />
           </div>
           <div>
-            <span className="text-xs font-medium text-foreground-muted uppercase">Last Page (next disabled)</span>
+            <span id="state-matrix-span-last-page-next-disab" className="text-xs font-medium text-foreground-muted uppercase">Last Page (next disabled)</span>
             <Pagination currentPage={5} totalPages={5} onPageChange={() => {}} />
           </div>
         </div>
@@ -239,7 +239,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">
             <CompactPagination
               currentPage={mobilePage}
@@ -250,7 +250,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 flex justify-center">
             <Pagination
               currentPage={tabletPage}
@@ -261,9 +261,9 @@ 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 flex items-center justify-between">
-            <p className="text-sm text-foreground-muted">
+            <p id="responsive-matrix-p-showing-91100-of-500" className="text-sm text-foreground-muted">
               Showing 91-100 of 500 results
             </p>
             <Pagination