lucent-ui 0.40.0 → 0.41.0

package/dist-server/src/manifest/patterns/tab-page.pattern.js

@@ -0,0 +1,152 @@
+export const PATTERN = {
+    id: 'tab-page',
+    name: 'Tab Page',
+    description: 'Tabbed content sections with card bodies. Useful for detail views, settings pages, or any multi-section content.',
+    category: 'nav',
+    components: ['tabs', 'card', 'row', 'text', 'stack', 'button'],
+    structure: `
+Stack gap="4"
+├── Row gap="3" align="center" justify="between"
+│   ├── Text (xl, bold)              ← page title
+│   └── Button (outline, sm)        ← optional action
+├── Tabs
+│   └── Tab[] — each tab's content is wrapped in a Card
+│       └── Card
+│           └── Stack gap="4"        ← tab body content
+  `.trim(),
+    code: `<Stack gap="4">
+  <Row gap="3" align="center" justify="between">
+    <Text as="h1" size="xl" weight="bold">Project settings</Text>
+    <Button variant="outline" size="sm">Save all</Button>
+  </Row>
+  <Tabs
+    defaultValue="general"
+    tabs={[
+      {
+        value: 'general',
+        label: 'General',
+        content: (
+          <Card>
+            <Stack gap="4">
+              <Text size="sm" weight="semibold">Project name</Text>
+              <Text size="sm" color="secondary">
+                Update your project name and description to help team members identify this project.
+              </Text>
+            </Stack>
+          </Card>
+        ),
+      },
+      {
+        value: 'members',
+        label: 'Members',
+        content: (
+          <Card>
+            <Stack gap="4">
+              <Row justify="between" align="center">
+                <Text size="sm" weight="semibold">Team members</Text>
+                <Button variant="outline" size="sm">Invite</Button>
+              </Row>
+              <Text size="sm" color="secondary">
+                Manage who has access to this project and their permissions.
+              </Text>
+            </Stack>
+          </Card>
+        ),
+      },
+      {
+        value: 'billing',
+        label: 'Billing',
+        content: (
+          <Card>
+            <Stack gap="4">
+              <Text size="sm" weight="semibold">Plan & usage</Text>
+              <Text size="sm" color="secondary">
+                Review your current plan, usage limits, and payment history.
+              </Text>
+            </Stack>
+          </Card>
+        ),
+      },
+    ]}
+  />
+</Stack>`,
+    variants: [
+        {
+            title: 'Detail view with description and no action button',
+            code: `<Stack gap="4">
+  <Stack gap="1">
+    <Text as="h1" size="xl" weight="bold">Order #1042</Text>
+    <Text size="sm" color="secondary">Placed on March 15, 2025</Text>
+  </Stack>
+  <Tabs
+    defaultValue="items"
+    tabs={[
+      {
+        value: 'items',
+        label: 'Items',
+        content: (
+          <Card>
+            <Stack gap="3">
+              <Row justify="between">
+                <Text size="sm">Widget Pro × 2</Text>
+                <Text size="sm" weight="medium">$49.98</Text>
+              </Row>
+              <Row justify="between">
+                <Text size="sm">Adapter Cable</Text>
+                <Text size="sm" weight="medium">$12.00</Text>
+              </Row>
+            </Stack>
+          </Card>
+        ),
+      },
+      {
+        value: 'shipping',
+        label: 'Shipping',
+        content: (
+          <Card>
+            <Stack gap="3">
+              <Text size="sm" weight="semibold">Tracking</Text>
+              <Text size="sm" color="secondary">
+                UPS Ground — 1Z999AA10123456784
+              </Text>
+            </Stack>
+          </Card>
+        ),
+      },
+      {
+        value: 'history',
+        label: 'History',
+        content: (
+          <Card>
+            <Stack gap="3">
+              <Row gap="3" align="center">
+                <Text size="xs" color="secondary" style={{ width: 80 }}>Mar 15</Text>
+                <Text size="sm">Order placed</Text>
+              </Row>
+              <Row gap="3" align="center">
+                <Text size="xs" color="secondary" style={{ width: 80 }}>Mar 16</Text>
+                <Text size="sm">Payment confirmed</Text>
+              </Row>
+              <Row gap="3" align="center">
+                <Text size="xs" color="secondary" style={{ width: 80 }}>Mar 18</Text>
+                <Text size="sm">Shipped</Text>
+              </Row>
+            </Stack>
+          </Card>
+        ),
+      },
+    ]}
+  />
+</Stack>`,
+        },
+    ],
+    designNotes: 'The page title and action button sit in a Row with justify="between" to push the action ' +
+        'to the far right, and align="center" to vertically center them regardless of text size. ' +
+        'Each tab\u2019s content is wrapped in a Card to give it a contained, elevated appearance that ' +
+        'visually separates the body from the tab strip. Stack gap="4" inside each Card provides ' +
+        'consistent vertical rhythm for the tab content. The Tabs component handles its own sliding ' +
+        'indicator and ARIA tablist semantics, so the pattern only needs to compose the surrounding ' +
+        'layout. The detail-view variant drops the action button and adds a subtitle via a nested ' +
+        'Stack gap="1" — a common pattern for entity detail pages where the header provides context ' +
+        'rather than actions.',
+};

package/dist-server/src/manifest/recipes/action-bar.recipe.js

@@ -0,0 +1,91 @@
+export const RECIPE = {
+    id: 'action-bar',
+    name: 'Action Bar',
+    description: 'Page-level or card-level header pairing a title with action buttons. Page headers use breadcrumb, large display title, and a divider below; card headers are compact with small text.',
+    category: 'action',
+    components: ['text', 'button', 'row', 'stack', 'breadcrumb', 'divider', 'card'],
+    structure: `
+Page header:
+Stack gap="4"
+├── Breadcrumb                               ← navigation context
+├── Row justify="between" align="end"
+│   ├── Stack gap="1"
+│   │   ├── Text (h1, 3xl, bold, display)    ← page title
+│   │   └── Text (sm, secondary)             ← subtitle
+│   └── Row gap="2"                          ← actions
+│       ├── Button (outline, sm)
+│       └── Button (primary, sm)
+└── Divider
+
+Card header:
+Row justify="between" align="start"
+├── Stack gap="1"
+│   ├── Text (xs, secondary, uppercase, tight) ← category label
+│   └── Text (md, semibold, tight)            ← section title
+└── Row gap="1"                              ← compact actions (top-aligned)
+    └── Button[] (ghost, xs)
+  `.trim(),
+    code: `<Stack gap="4">
+  <Breadcrumb items={[
+    { label: 'Home', href: '#' },
+    { label: 'Projects', href: '#' },
+    { label: 'Acme Corp' },
+  ]} />
+  <Row justify="between" align="end">
+    <Stack gap="1">
+      <Text as="h1" size="3xl" weight="bold" family="display">Acme Corp</Text>
+      <Text size="sm" color="secondary">Last updated 5 minutes ago</Text>
+    </Stack>
+    <Row gap="2">
+      <Button variant="outline" size="sm">Export</Button>
+      <Button variant="primary" size="sm">New report</Button>
+    </Row>
+  </Row>
+  <Divider />
+</Stack>`,
+    variants: [
+        {
+            title: 'Page header — danger zone',
+            code: `<Stack gap="4">
+  <Breadcrumb items={[
+    { label: 'Home', href: '#' },
+    { label: 'Settings', href: '#' },
+    { label: 'Danger zone' },
+  ]} />
+  <Row justify="between" align="end">
+    <Stack gap="1">
+      <Text as="h1" size="3xl" weight="bold" family="display">Danger zone</Text>
+      <Text size="sm" color="secondary">These actions are irreversible.</Text>
+    </Stack>
+    <Button variant="danger" size="sm">Delete project</Button>
+  </Row>
+  <Divider />
+</Stack>`,
+        },
+        {
+            title: 'Card header (compact with label)',
+            code: `<Card variant="outline" padding="md" style={{ width: 400 }}>
+  <Stack gap="4">
+    <Row justify="between" align="start">
+      <Stack gap="1">
+        <Text size="xs" color="secondary" weight="medium" style={{ letterSpacing: 'var(--lucent-letter-spacing-tight)', textTransform: 'uppercase' }}>Activity</Text>
+        <Text size="md" weight="semibold" style={{ letterSpacing: 'var(--lucent-letter-spacing-base)' }}>Recent activity</Text>
+      </Stack>
+      <Row gap="1">
+        <Button variant="ghost" size="xs">Filter</Button>
+        <Button variant="ghost" size="xs">Export</Button>
+      </Row>
+    </Row>
+    <Text size="xs" color="secondary">No activity to show yet.</Text>
+  </Stack>
+</Card>`,
+        },
+    ],
+    designNotes: 'Page headers and card headers have very different scales. Page headers use 3xl ' +
+        'display font for the title, Breadcrumb for navigation context, and a Divider to ' +
+        'separate the header from page content below. align="end" on the Row anchors the ' +
+        'buttons to the baseline of the title block so they sit level with the subtitle. ' +
+        'Card headers are compact: sm semibold text with xs/ghost buttons that recede ' +
+        'visually. The primary action is always rightmost following natural reading order. ' +
+        'Both patterns use justify="between" to push title and actions to opposite edges.',
+};

package/dist-server/src/manifest/recipes/collapsible-card.recipe.js

@@ -0,0 +1,100 @@
+export const RECIPE = {
+    id: 'collapsible-card',
+    name: 'Collapsible Card',
+    description: 'Card with an expandable/collapsible section using smooth height animation, available in all card variants.',
+    category: 'card',
+    components: ['card', 'collapsible', 'text'],
+    structure: `
+Card (padding="none", hoverable)
+└── Collapsible
+    ├── trigger: Text (sm, semibold)         ← clickable header
+    └── children                             ← collapsible body
+        └── Text (sm, secondary)             ← content
+  `.trim(),
+    code: `<Card variant="outline" padding="none" hoverable style={{ width: 360 }}>
+  <Collapsible
+    trigger={<Text as="span" weight="semibold" size="sm">Details</Text>}
+    defaultOpen
+  >
+    <Text size="sm" color="secondary">
+      The Collapsible auto-detects its Card parent and bleeds the trigger
+      full-width. Content inherits the card's padding.
+    </Text>
+  </Collapsible>
+</Card>`,
+    variants: [
+        {
+            title: 'Ghost variant',
+            code: `<Card variant="ghost" padding="none" hoverable style={{ width: 360 }}>
+  <Collapsible trigger={<Text as="span" weight="semibold" size="sm">FAQ item</Text>}>
+    <Text size="sm" color="secondary">
+      Transparent container — content floats directly on the page surface.
+    </Text>
+  </Collapsible>
+</Card>`,
+        },
+        {
+            title: 'Elevated variant',
+            code: `<Card variant="elevated" padding="none" hoverable style={{ width: 360 }}>
+  <Collapsible trigger={<Text as="span" weight="semibold" size="sm">Advanced options</Text>}>
+    <Text size="sm" color="secondary">
+      Elevated cards cast a shadow — use for prominent collapsible sections.
+    </Text>
+  </Collapsible>
+</Card>`,
+        },
+        {
+            title: 'Combo (two-tone nested cards)',
+            code: `<Card variant="filled" padding="none" hoverable style={{ width: 360 }}>
+  <Collapsible
+    padded={false}
+    trigger={<Text as="span" weight="semibold" size="sm">Combo layout</Text>}
+  >
+    <Card
+      variant="elevated"
+      padding="sm"
+      style={{ margin: 'var(--lucent-space-1) var(--lucent-space-2) var(--lucent-space-2)' }}
+    >
+      <Text size="sm" color="secondary">
+        Two-tone layout — flat trigger surface, elevated body.
+      </Text>
+    </Card>
+  </Collapsible>
+</Card>`,
+        },
+        {
+            title: 'With localStorage persistence',
+            code: `function CollapsibleSection({ id, title, children }) {
+  const storageKey = \`collapsible-\${id}\`;
+  const [open, setOpen] = React.useState(() => {
+    const saved = localStorage.getItem(storageKey);
+    return saved !== null ? saved === 'true' : true;
+  });
+
+  const handleChange = (next) => {
+    setOpen(next);
+    localStorage.setItem(storageKey, String(next));
+  };
+
+  return (
+    <Card variant="outline" padding="none" hoverable>
+      <Collapsible
+        open={open}
+        onOpenChange={handleChange}
+        trigger={<Text as="span" weight="semibold" size="sm">{title}</Text>}
+      >
+        {children}
+      </Collapsible>
+    </Card>
+  );
+}`,
+        },
+    ],
+    designNotes: 'Card uses padding="none" because the Collapsible auto-detects its Card parent ' +
+        'via CardPaddingContext and bleeds the trigger full-width while applying card ' +
+        'padding to the body content. The hoverable prop gives hover lift feedback ' +
+        'without making the card itself interactive — the Collapsible trigger handles ' +
+        'clicks. For the combo variant, padded={false} on Collapsible removes its built-in ' +
+        'content padding so the nested elevated Card can control its own spacing with ' +
+        'custom margin. This creates a two-tone visual: flat trigger + elevated body.',
+};

package/dist-server/src/manifest/recipes/empty-state-card.recipe.js

@@ -0,0 +1,72 @@
+export const RECIPE = {
+    id: 'empty-state-card',
+    name: 'Empty State Card',
+    description: 'Centered empty state with illustration icon, heading, description, and call-to-action button inside a card.',
+    category: 'card',
+    components: ['card', 'empty-state', 'icon', 'button'],
+    structure: `
+Card (outline, padding="lg")
+└── EmptyState
+    ├── illustration: Icon (xl)              ← decorative SVG
+    ├── title: string                        ← heading
+    ├── description: string                  ← explanatory text
+    └── action: Button (secondary / primary) ← CTA
+  `.trim(),
+    code: `<Card variant="outline" padding="lg" style={{ width: 400 }}>
+  <EmptyState
+    illustration={
+      <Icon size="xl">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth={1.5} strokeLinecap="round" strokeLinejoin="round">
+          <circle cx={11} cy={11} r={8} />
+          <path d="M21 21l-4.35-4.35" />
+        </svg>
+      </Icon>
+    }
+    title="No results found"
+    description="Try adjusting your search or filters to find what you're looking for."
+    action={<Button variant="secondary" size="sm">Clear filters</Button>}
+  />
+</Card>`,
+    variants: [
+        {
+            title: 'Getting started empty state',
+            code: `<Card variant="elevated" padding="lg" style={{ width: 400 }}>
+  <EmptyState
+    illustration={
+      <Icon size="xl">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth={1.5} strokeLinecap="round" strokeLinejoin="round">
+          <path d="M12 5v14M5 12h14" />
+        </svg>
+      </Icon>
+    }
+    title="No projects yet"
+    description="Create your first project to get started."
+    action={<Button variant="primary" size="sm">Create project</Button>}
+  />
+</Card>`,
+        },
+        {
+            title: 'Error empty state with retry',
+            code: `<Card variant="outline" padding="lg" style={{ width: 400 }}>
+  <EmptyState
+    illustration={
+      <Icon size="xl">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth={1.5} strokeLinecap="round" strokeLinejoin="round">
+          <circle cx={12} cy={12} r={10} />
+          <path d="M12 8v4M12 16h.01" />
+        </svg>
+      </Icon>
+    }
+    title="Something went wrong"
+    description="We couldn't load your data. Please try again."
+    action={<Button variant="outline" size="sm">Retry</Button>}
+  />
+</Card>`,
+        },
+    ],
+    designNotes: 'EmptyState handles internal centering and spacing — no need for manual Stack/Row ' +
+        'layout inside it. The illustration uses Icon at xl size for visual weight without ' +
+        'overwhelming the text. Card variant should match the context: outline for inline ' +
+        'empty states (e.g. a table with no rows), elevated for standalone pages. The ' +
+        'action button uses size="sm" to avoid competing with the heading for attention.',
+};

package/dist-server/src/manifest/recipes/form-layout.recipe.js

@@ -0,0 +1,98 @@
+export const RECIPE = {
+    id: 'form-layout',
+    name: 'Form Layout',
+    description: 'Stacked form with grouped sections, FormField labels, validation hints, and a submit/cancel footer.',
+    category: 'form',
+    components: ['card', 'text', 'input', 'select', 'textarea', 'checkbox', 'button', 'stack', 'row', 'divider', 'form-field'],
+    structure: `
+Card (elevated, padding="lg")
+└── Stack as="form" gap="6"
+    ├── Stack gap="1"                        ← section header
+    │   ├── Text (lg, semibold)              ← form title
+    │   └── Text (sm, secondary)             ← description
+    ├── Stack gap="4"                        ← field group 1
+    │   ├── Row gap="4"                      ← side-by-side fields
+    │   │   ├── FormField (label, required)
+    │   │   │   └── Input
+    │   │   └── FormField (label, required)
+    │   │       └── Input
+    │   ├── FormField (label)
+    │   │   └── Input
+    │   └── FormField (label)
+    │       └── Select
+    ├── Divider
+    ├── Stack gap="4"                        ← field group 2
+    │   ├── FormField (label)
+    │   │   └── Textarea
+    │   └── Checkbox (contained)
+    └── Row gap="2" justify="end"            ← actions
+        ├── Button (ghost)
+        └── Button (primary)
+  `.trim(),
+    code: `<Card variant="elevated" padding="lg" style={{ width: 480 }}>
+  <Stack as="form" gap="6">
+    <Stack gap="1">
+      <Text as="h2" size="lg" weight="semibold">Create project</Text>
+      <Text size="sm" color="secondary">
+        Fill in the details to set up your new project.
+      </Text>
+    </Stack>
+    <Stack gap="4">
+      <Row gap="4">
+        <FormField label="First name" htmlFor="fname" required style={{ flex: 1 }}>
+          <Input id="fname" placeholder="Jane" />
+        </FormField>
+        <FormField label="Last name" htmlFor="lname" required style={{ flex: 1 }}>
+          <Input id="lname" placeholder="Doe" />
+        </FormField>
+      </Row>
+      <FormField label="Email" htmlFor="email" helperText="We'll never share your email.">
+        <Input id="email" type="email" placeholder="jane@example.com" />
+      </FormField>
+      <FormField label="Role" htmlFor="role">
+        <Select
+          id="role"
+          placeholder="Select a role..."
+          options={[
+            { value: 'admin', label: 'Admin' },
+            { value: 'editor', label: 'Editor' },
+            { value: 'viewer', label: 'Viewer' },
+          ]}
+        />
+      </FormField>
+    </Stack>
+    <Divider />
+    <Stack gap="4">
+      <FormField label="Bio" htmlFor="bio">
+        <Textarea id="bio" placeholder="Tell us about yourself..." rows={3} />
+      </FormField>
+      <Checkbox label="I agree to the terms" contained />
+    </Stack>
+    <Row gap="2" justify="end">
+      <Button variant="ghost">Cancel</Button>
+      <Button variant="primary">Create</Button>
+    </Row>
+  </Stack>
+</Card>`,
+    variants: [
+        {
+            title: 'Inline form (no card)',
+            code: `<Stack as="form" gap="4" style={{ maxWidth: 400 }}>
+  <FormField label="Username" htmlFor="user" required helperText="Letters and numbers only, 3–20 chars.">
+    <Input id="user" placeholder="yourname" />
+  </FormField>
+  <FormField label="Password" htmlFor="pass" required>
+    <Input id="pass" type="password" />
+  </FormField>
+  <Button variant="primary">Sign in</Button>
+</Stack>`,
+        },
+    ],
+    designNotes: 'The form uses Stack as="form" to render a semantic <form> element while keeping ' +
+        'token-based vertical spacing. gap="6" between sections provides clear visual ' +
+        'grouping; gap="4" within a section keeps fields tightly related. Side-by-side ' +
+        'fields use Row with flex: 1 on each FormField so they share width equally. ' +
+        'The Divider separates logical sections (identity fields vs. profile fields). ' +
+        'Actions are right-aligned (justify="end") following the convention that the ' +
+        'primary action is the rightmost button.',
+};

package/dist-server/src/manifest/recipes/index.js

@@ -0,0 +1,8 @@
+export { RECIPE as ProfileCard } from './profile-card.recipe.js';
+export { RECIPE as SettingsPanel } from './settings-panel.recipe.js';
+export { RECIPE as StatsRow } from './stats-row.recipe.js';
+export { RECIPE as ActionBar } from './action-bar.recipe.js';
+export { RECIPE as FormLayout } from './form-layout.recipe.js';
+export { RECIPE as EmptyStateCard } from './empty-state-card.recipe.js';
+export { RECIPE as CollapsibleCard } from './collapsible-card.recipe.js';
+export { RECIPE as SearchFilterBar } from './search-filter-bar.recipe.js';

package/dist-server/src/manifest/recipes/profile-card.recipe.js

@@ -0,0 +1,101 @@
+export const RECIPE = {
+    id: 'profile-card',
+    name: 'Profile Card',
+    description: 'User profile card with avatar, name/role, bio, tag chips, stats row, and action buttons.',
+    category: 'card',
+    components: ['card', 'avatar', 'text', 'chip', 'button', 'stack', 'row', 'divider'],
+    structure: `
+Card (elevated, equal padding via style)
+└── Stack gap="5"
+    ├── Row gap="3" align="center"           ← avatar + name block
+    │   ├── Avatar (lg)
+    │   └── Stack gap="1"
+    │       ├── Row gap="2" align="center"
+    │       │   ├── Text (lg, semibold, display) ← full name
+    │       │   └── Chip (success, sm)       ← status badge
+    │       └── Text (sm, secondary)         ← role / subtitle
+    ├── Text (sm)                            ← bio paragraph
+    ├── Row gap="2" wrap                     ← skill/tag chips
+    │   └── Chip[] (neutral, borderless, clickable)
+    ├── Divider
+    ├── Row gap="6" justify="around"         ← stats
+    │   └── Stack[] gap="0" align="center"
+    │       ├── Text (2xl, bold, display)     ← stat value
+    │       └── Text (xs, secondary)         ← stat label
+    └── Row gap="3"                          ← actions
+        ├── Button (primary, full width)
+        └── Button (outline, full width)
+  `.trim(),
+    code: `<Card variant="elevated" padding="none" style={{ width: 340, padding: 'var(--lucent-space-6)' }}>
+  <Stack gap="5">
+    <Row gap="3" align="center">
+      <Avatar src="/avatars/jane.jpg" alt="Jane Doe" size="lg" />
+      <Stack gap="1">
+        <Row gap="2" align="center">
+          <Text size="lg" weight="semibold" family="display">Jane Doe</Text>
+          <Chip variant="success" size="sm" dot>Pro</Chip>
+        </Row>
+        <Text size="sm" color="secondary">Software Engineer</Text>
+      </Stack>
+    </Row>
+    <Text size="sm">
+      Building design systems and component libraries.
+      Passionate about accessible, token-driven UI.
+    </Text>
+    <Row gap="2" wrap>
+      <Chip variant="neutral" borderless onClick={() => {}}>React</Chip>
+      <Chip variant="neutral" borderless onClick={() => {}}>TypeScript</Chip>
+      <Chip variant="neutral" borderless onClick={() => {}}>Design Systems</Chip>
+    </Row>
+    <Divider />
+    <Row gap="6" justify="around">
+      <Stack gap="0" align="center">
+        <Text size="2xl" weight="bold" family="display">128</Text>
+        <Text size="xs" color="secondary">Posts</Text>
+      </Stack>
+      <Stack gap="0" align="center">
+        <Text size="2xl" weight="bold" family="display">4.2k</Text>
+        <Text size="xs" color="secondary">Followers</Text>
+      </Stack>
+      <Stack gap="0" align="center">
+        <Text size="2xl" weight="bold" family="display">312</Text>
+        <Text size="xs" color="secondary">Following</Text>
+      </Stack>
+    </Row>
+    <Row gap="3">
+      <Button variant="primary" style={{ flex: 1 }}>Follow</Button>
+      <Button variant="outline" style={{ flex: 1 }}>Message</Button>
+    </Row>
+  </Stack>
+</Card>`,
+    variants: [
+        {
+            title: 'Compact collapsible profile',
+            code: `<Card variant="filled" padding="none" hoverable style={{ width: 280 }}>
+  <Collapsible
+    trigger={
+      <Row gap="3" align="center">
+        <Avatar alt="Jane Doe" size="md" />
+        <Stack gap="1">
+          <Text as="span" size="sm" weight="semibold">Jane Doe</Text>
+          <Text as="span" size="xs" color="secondary">Software Engineer</Text>
+        </Stack>
+      </Row>
+    }
+    defaultOpen
+  >
+    <Row gap="2" justify="end">
+      <Button variant="outline" size="sm">Message</Button>
+      <Button variant="primary" size="sm">Follow</Button>
+    </Row>
+  </Collapsible>
+</Card>`,
+        },
+    ],
+    designNotes: 'Avatar and name are grouped in a Row with center alignment so the text block ' +
+        'vertically centers against the avatar regardless of line count. The name row ' +
+        'uses gap="2" for tight coupling between name and status chip. Stats use ' +
+        'justify="around" to distribute evenly without fixed widths. Action buttons ' +
+        'use flex: 1 to split the row equally. The Divider separates informational ' +
+        'content (above) from interactive content (below).',
+};