lucent-ui 0.34.0 → 0.35.0

package/dist-server/src/components/atoms/CodeBlock/CodeBlock.manifest.js

@@ -39,6 +39,20 @@ export const COMPONENT_MANIFEST = {
             description: '"code" renders a <pre><code> block with horizontal scroll. ' +
                 '"prompt" renders a single-line truncated span suited to AI prompts.',
         },
+        {
+            name: 'minimal',
+            type: 'boolean',
+            required: false,
+            default: 'false',
+            description: 'Hides the header bar and shows only a corner copy button overlay.',
+        },
+        {
+            name: 'wrap',
+            type: 'boolean',
+            required: false,
+            default: 'false',
+            description: 'When true, wraps long lines instead of scrolling horizontally.',
+        },
         {
             name: 'helperText',
             type: 'string',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lucent-ui",
-  "version": "0.34.0",
+  "version": "0.35.0",
   "description": "An AI-first React component library with machine-readable manifests.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -30,18 +30,6 @@
     "dist-server",
     "dist-cli"
   ],
-  "scripts": {
-    "dev": "vite --config vite.dev.config.ts",
-    "build": "vite build",
-    "build:server": "tsc -p server/tsconfig.json",
-    "build:cli": "tsc -p cli/tsconfig.json && cp cli/template.manifest.json dist-cli/cli/template.manifest.json",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "tsc --noEmit && pnpm build && pnpm build:server && pnpm build:cli",
-    "changeset": "changeset",
-    "version-packages": "changeset version",
-    "release": "pnpm prepublishOnly && changeset publish"
-  },
   "keywords": [
     "react",
     "component-library",
@@ -56,7 +44,6 @@
   },
   "author": "Rozina Szogyenyi",
   "license": "MIT",
-  "packageManager": "pnpm@10.30.3",
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
@@ -78,5 +65,16 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
     "zod": "^4.3.6"
+  },
+  "scripts": {
+    "dev": "vite --config vite.dev.config.ts",
+    "build": "vite build",
+    "build:server": "tsc -p server/tsconfig.json",
+    "build:cli": "tsc -p cli/tsconfig.json && cp cli/template.manifest.json dist-cli/cli/template.manifest.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "pnpm prepublishOnly && changeset publish"
   }
-}
+}

package/dist-server/server/recipe-registry.js

@@ -1,18 +0,0 @@
-import { RECIPE as ProfileCard } from '../src/manifest/recipes/profile-card.recipe.js';
-import { RECIPE as SettingsPanel } from '../src/manifest/recipes/settings-panel.recipe.js';
-import { RECIPE as StatsRow } from '../src/manifest/recipes/stats-row.recipe.js';
-import { RECIPE as ActionBar } from '../src/manifest/recipes/action-bar.recipe.js';
-import { RECIPE as FormLayout } from '../src/manifest/recipes/form-layout.recipe.js';
-import { RECIPE as EmptyStateCard } from '../src/manifest/recipes/empty-state-card.recipe.js';
-import { RECIPE as CollapsibleCard } from '../src/manifest/recipes/collapsible-card.recipe.js';
-import { RECIPE as SearchFilterBar } from '../src/manifest/recipes/search-filter-bar.recipe.js';
-export const ALL_RECIPES = [
-    ProfileCard,
-    SettingsPanel,
-    StatsRow,
-    ActionBar,
-    FormLayout,
-    EmptyStateCard,
-    CollapsibleCard,
-    SearchFilterBar,
-];

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

@@ -1,91 +0,0 @@
-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

@@ -1,100 +0,0 @@
-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

@@ -1,72 +0,0 @@
-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

@@ -1,98 +0,0 @@
-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

@@ -1,8 +0,0 @@
-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

@@ -1,101 +0,0 @@
-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).',
-};