@vadimcomanescu/nadicode-design-system 2.0.9 → 4.0.1

package/.agents/skills/seed/SKILL.md

@@ -20,29 +20,40 @@ Consumer scaffold contract: brand customization stays palette-only unless the ta
 
 ## Component Discovery
 
-Start with the shipped machine-readable consumer contract:
+The catalog (`./catalog` and `./catalog/components` subpath exports) is the single surface for discovering and consuming Seed blocks and page-kits.
 
-```
-cat node_modules/@vadimcomanescu/nadicode-design-system/contracts/consumer-contract.json
+**Discovery** (server-safe, read this to learn what's available):
+```ts
+import { seedComponentDefinitions } from "@vadimcomanescu/nadicode-design-system/catalog"
 ```
 
-Then follow `entrypoints.machineReadable.catalog` to the generated catalog for exact component names, variant values, props, and tiers:
+Each entry provides: `props` (Zod schema), `description`, `slots`, `events`, `example`.
 
+**Components** (client, import this to get React components):
+```ts
+import { seedComponents } from "@vadimcomanescu/nadicode-design-system/catalog/components"
 ```
-cat node_modules/@vadimcomanescu/nadicode-design-system/dist/catalog.json
+
+Usage:
+```tsx
+const { LoginBlock, DashboardPageKit } = seedComponents
+<LoginBlock onSubmit={handleLogin} />
 ```
 
-The consumer contract is the machine entrypoint. The catalog is the component metadata surface. Both are auto-generated from source. Do not guess.
+**Blocks and page-kits** are imported exclusively from `seedComponents`. Do not import them via individual subpath exports (ADR 0009). The ESLint rule `nadicode/require-catalog-import` enforces this at lint time.
+
+**UI primitives** (Button, Heading, Input, etc.), icons, charts, and effects are imported via individual subpath exports. They are not registered in the catalog.
+
+See the full Import Rules in `contract.md`.
 
-The derived references under `references/components.md` and `references/blocks.md` are generated from the catalog. Any repo `Path` column there is a maintainer source path, not a consumer import path. Consumer code must keep importing from `@vadimcomanescu/nadicode-design-system/*` subpaths.
+The derived references under `references/components.md` and `references/blocks.md` are generated from the catalog. Any repo `Path` column there is a maintainer source path, not a consumer import path.
 
 ## Read Order
 
 1. **This file** -- router, quick references, forbidden patterns
 2. **`contract.md`** -- binary rules, package integration contract
-3. **consumer-contract.json** -- machine-readable package, ownership, and contract entrypoint map
-4. **catalog.json** (in dist/) -- machine-readable component metadata (variants, props, tiers)
-5. **`intent-map.md`** -- intent decision tree + recipe index
+3. **catalog** (`@vadimcomanescu/nadicode-design-system/catalog`) -- machine-readable component metadata (variants, props, tiers)
+4. **`intent-map.md`** -- intent decision tree + recipe index
 6. **`recipes/<page-type>.md`** -- matching recipe for your page
 7. **`references/`** -- deep dives as needed
 8. **`references/brand-override.md`** -- palette-only brand customization guide for seeded apps
@@ -336,10 +347,9 @@ Content widths, vertical rhythm, responsive contracts: `references/composition.m
 Compound component for multi-column sortable boards (project boards, runs views, pipelines).
 
 ```tsx
-import {
-  KanbanBoard, KanbanColumn, KanbanColumnHeader,
-  KanbanItem, KanbanHandle,
-} from '@vadimcomanescu/nadicode-design-system/kanban-board'
+import { seedComponents } from "@vadimcomanescu/nadicode-design-system/catalog/components"
+const { KanbanBoard: kanban } = seedComponents
+const { KanbanBoard, KanbanColumn, KanbanColumnHeader, KanbanItem, KanbanHandle } = kanban
 import type { KanbanColumnState, KanbanMoveMeta } from '@vadimcomanescu/nadicode-design-system/kanban-board'
 ```
 

package/.agents/skills/seed/contract.md

@@ -9,14 +9,27 @@ Binary rules for consumer apps using the Seed Design System. Every rule is non-n
 
 ## Component Catalog
 
-Start with `consumer-contract.json` (shipped in the package under `contracts/`) for the machine-readable entrypoint map and ownership rules. Then read catalog.json (shipped in the package under dist/) for the authoritative list of components, variant names, props, and tiers. Verify component names and variant values against the catalog. Do not guess variant names or prop values.
-Registry digest: `sha256:b5370c96c1bb877883860055c4b3d2c7c67ef7c2b1df4acacd7ea5cb0847da78`
+The catalog is the single starting point for component discovery. Read it via the `./catalog` subpath export for the authoritative list of components, variant names, props, and tiers. Get actual React components from `./catalog/components`. Verify component names and variant values against the catalog. Do not guess variant names or prop values.
+
+```ts
+// Discovery (server-safe)
+import { seedComponentDefinitions } from "@vadimcomanescu/nadicode-design-system/catalog"
+
+// Components (client)
+import { seedComponents } from "@vadimcomanescu/nadicode-design-system/catalog/components"
+```
 
 ## Import Rules
 
-1. Import Seed primitives, blocks, charts, icons, and text effects from `@vadimcomanescu/nadicode-design-system/*` subpaths. Do not vendor or recreate DS runtime files inside the scaffold.
-2. Never import icons from `lucide-react` directly. Import from `@vadimcomanescu/nadicode-design-system/icons` or the matching `@vadimcomanescu/nadicode-design-system/icons/<name>` subpath.
-3. If a needed primitive is missing, stop and report it. Do not invent ad-hoc replacements.
+1. **Blocks and page-kits**: import from `seedComponents` via `@vadimcomanescu/nadicode-design-system/catalog/components`. No individual subpath imports for blocks or page-kits.
+   ```ts
+   import { seedComponents } from "@vadimcomanescu/nadicode-design-system/catalog/components"
+   const { LoginBlock, DashboardPageKit } = seedComponents
+   ```
+2. **UI primitives, charts, effects, text-effects**: import via individual subpath exports (e.g., `@vadimcomanescu/nadicode-design-system/button`, `@vadimcomanescu/nadicode-design-system/charts`). These are not in the catalog.
+3. **Icons**: import from `@vadimcomanescu/nadicode-design-system/icons` or the matching `@vadimcomanescu/nadicode-design-system/icons/<name>` subpath. Never import from `lucide-react` directly.
+4. **Infrastructure** (tokens.css, tailwind preset, eslint-plugin, theme-provider, messages, test, lib/*): import via subpath exports. These are configuration wiring, not component consumption.
+5. Do not vendor or recreate DS runtime files inside the scaffold. If a needed primitive is missing, stop and report it. Do not invent ad-hoc replacements.
 
 ## Token Rules
 
@@ -62,7 +75,7 @@ Registry digest: `sha256:b5370c96c1bb877883860055c4b3d2c7c67ef7c2b1df4acacd7ea5c
 24. Dashboard KPI cards must use `MetricCard`, not ad-hoc Card + value compositions.
 25. Chart components must not be rendered without an empty-data guard (`data.length > 0` or `ChartCard`).
 26. Chart color configs must use `var(--color-chart-N)` tokens, never hex/rgb/hsl literals.
-27. Import chart primitives from `@vadimcomanescu/nadicode-design-system/charts` or the matching `@vadimcomanescu/nadicode-design-system/charts/<chart-name>` subpath. Do not import `recharts` directly into scaffold app code.
+27. Import chart primitives from `@vadimcomanescu/nadicode-design-system/charts` or the matching `@vadimcomanescu/nadicode-design-system/charts/<chart-name>` subpath (charts are UI primitives, not catalog items). Do not import `recharts` directly into scaffold app code.
 
 ## ESLint Rule Reference
 

package/.agents/skills/seed/recipes/agency-home.md

@@ -231,15 +231,15 @@ REDUCED MOTION: All items visible immediately, opacity 0->1 in 10ms
 
 | Component | Import Path | Purpose |
 |-----------|-------------|---------|
-| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/header-block` | Site navigation |
-| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/footer-block` | Site footer |
+| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site navigation |
+| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site footer |
 | `Button` | `@vadimcomanescu/nadicode-design-system/button` | CTAs |
 | `Badge` | `@vadimcomanescu/nadicode-design-system/badge` | Hero tag |
 | `Typography` | `@vadimcomanescu/nadicode-design-system/typography` | Headings, body text |
 | `ScrollFadeIn` | `@vadimcomanescu/nadicode-design-system/scroll-fade-in` | Below-fold animations |
-| `ProcessFlowBlock` | `@vadimcomanescu/nadicode-design-system/process-flow-block` | How-we-work process |
-| `FeatureGridBlock` | `@vadimcomanescu/nadicode-design-system/feature-grid-block` | Services grid |
-| `StatsMarketingBlock` | `@vadimcomanescu/nadicode-design-system/stats-marketing-block` | Outcome metrics (ROI, time saved) |
+| `ProcessFlowBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | How-we-work process |
+| `FeatureGridBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Services grid |
+| `StatsMarketingBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Outcome metrics (ROI, time saved) |
 
 ### Allowed (optional)
 

package/.agents/skills/seed/recipes/auth.md

@@ -167,9 +167,9 @@ REDUCED MOTION: Card and all children visible immediately
 
 | Component | Import Path | Purpose |
 |-----------|-------------|---------|
-| `AuthLayout` | `@vadimcomanescu/nadicode-design-system/auth-layout` | Split-screen wrapper |
-| `LoginBlock` | `@vadimcomanescu/nadicode-design-system/login-block` | Pre-built login form |
-| `SignUpBlock` | `@vadimcomanescu/nadicode-design-system/sign-up-block` | Pre-built signup form |
+| `AuthLayout` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Split-screen wrapper |
+| `LoginBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Pre-built login form |
+| `SignUpBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Pre-built signup form |
 | `Card` | `@vadimcomanescu/nadicode-design-system/card` | Auth card container |
 | `Input` | `@vadimcomanescu/nadicode-design-system/input` | Email, name fields |
 | `PasswordInput` | `@vadimcomanescu/nadicode-design-system/password-input` | Password with toggle |

package/.agents/skills/seed/recipes/blog-content.md

@@ -233,8 +233,8 @@ REDUCED MOTION: All items visible immediately
 | `Pagination` | `@vadimcomanescu/nadicode-design-system/pagination` | Blog index pages |
 | `Separator` | `@vadimcomanescu/nadicode-design-system/separator` | Content dividers |
 | `Select` | `@vadimcomanescu/nadicode-design-system/select` | Category filter |
-| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/header-block` | Site navigation |
-| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/footer-block` | Site footer |
+| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site navigation |
+| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site footer |
 | `ScrollFadeIn` | `@vadimcomanescu/nadicode-design-system/scroll-fade-in` | Below-fold animations |
 | `Button` | `@vadimcomanescu/nadicode-design-system/button` | Share, read more |
 

package/.agents/skills/seed/recipes/company-about.md

@@ -200,13 +200,13 @@ REDUCED MOTION: All items visible immediately, opacity 0->1 in 10ms
 
 | Component | Import Path | Purpose |
 |-----------|-------------|---------|
-| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/header-block` | Site navigation |
-| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/footer-block` | Site footer |
+| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site navigation |
+| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site footer |
 | `Button` | `@vadimcomanescu/nadicode-design-system/button` | CTAs |
 | `Badge` | `@vadimcomanescu/nadicode-design-system/badge` | Hero tag |
 | `Typography` | `@vadimcomanescu/nadicode-design-system/typography` | Headings, body text |
 | `ScrollFadeIn` | `@vadimcomanescu/nadicode-design-system/scroll-fade-in` | Below-fold animations |
-| `TeamBlock` | `@vadimcomanescu/nadicode-design-system/team-block` | Team member grid |
+| `TeamBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Team member grid |
 
 ### Allowed (optional)
 

package/.agents/skills/seed/recipes/company-contact.md

@@ -157,11 +157,11 @@ REDUCED MOTION: All items visible immediately, opacity 0->1 in 10ms
 
 | Component | Import Path | Purpose |
 |-----------|-------------|---------|
-| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/header-block` | Site navigation |
-| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/footer-block` | Site footer |
+| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site navigation |
+| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site footer |
 | `Button` | `@vadimcomanescu/nadicode-design-system/button` | CTAs and form submit |
 | `ScrollFadeIn` | `@vadimcomanescu/nadicode-design-system/scroll-fade-in` | Below-fold animations |
-| `ContactBlock` | `@vadimcomanescu/nadicode-design-system/contact-block` | Contact form + company info |
+| `ContactBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Contact form + company info |
 
 ### Allowed (optional)
 

package/.agents/skills/seed/recipes/digital-workers.md

@@ -237,13 +237,13 @@ REDUCED MOTION: All items visible immediately, opacity 0->1 in 10ms
 
 | Component | Import Path | Purpose |
 |-----------|-------------|---------|
-| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/header-block` | Site navigation |
-| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/footer-block` | Site footer |
+| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site navigation |
+| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site footer |
 | `Button` | `@vadimcomanescu/nadicode-design-system/button` | CTAs |
 | `Badge` | `@vadimcomanescu/nadicode-design-system/badge` | Hero tag |
 | `Typography` | `@vadimcomanescu/nadicode-design-system/typography` | Headings, body text |
 | `ScrollFadeIn` | `@vadimcomanescu/nadicode-design-system/scroll-fade-in` | Below-fold animations |
-| `AgentProfileGridBlock` | `@vadimcomanescu/nadicode-design-system/agent-profile-grid-block` | Agent profile cards grid |
+| `AgentProfileGridBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Agent profile cards grid |
 
 ### Allowed (optional)
 

package/.agents/skills/seed/recipes/marketing-landing.md

@@ -212,17 +212,17 @@ REDUCED MOTION: All items visible immediately, opacity 0->1 in 10ms
 
 | Component | Import Path | Purpose |
 |-----------|-------------|---------|
-| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/header-block` | Site navigation |
-| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/footer-block` | Site footer |
+| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site navigation |
+| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site footer |
 | `Button` | `@vadimcomanescu/nadicode-design-system/button` | CTAs |
 | `Badge` | `@vadimcomanescu/nadicode-design-system/badge` | Announcement tag |
 | `Typography` | `@vadimcomanescu/nadicode-design-system/typography` | Headings, body text |
-| `FeatureBlock` / `FeatureGridBlock` | `@vadimcomanescu/nadicode-design-system/feature*` | Feature showcase |
-| `FAQBlock` | `@vadimcomanescu/nadicode-design-system/faq-block` | FAQ accordion |
-| `CallToActionBlock` | `@vadimcomanescu/nadicode-design-system/call-to-action-block` | Final CTA |
-| `TestimonialsBlock` | `@vadimcomanescu/nadicode-design-system/testimonials-block` | Social proof |
-| `LogoCloud` | `@vadimcomanescu/nadicode-design-system/logo-cloud` | Partner logos |
-| `StatsMarketingBlock` | `@vadimcomanescu/nadicode-design-system/stats-marketing-block` | Key metrics |
+| `FeatureBlock` / `FeatureGridBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Feature showcase |
+| `FAQBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | FAQ accordion |
+| `CallToActionBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Final CTA |
+| `TestimonialsBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Social proof |
+| `LogoCloud` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Partner logos |
+| `StatsMarketingBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Key metrics |
 | `ScrollFadeIn` | `@vadimcomanescu/nadicode-design-system/scroll-fade-in` | Below-fold animations |
 | `ShaderBackground` | `@vadimcomanescu/nadicode-design-system/shader-background` | Hero background |
 

package/.agents/skills/seed/recipes/marketing-shell.md

@@ -35,8 +35,8 @@ Shared marketing layout providing scroll-aware header, main content area, and fo
 ### 1. Layout Shell
 
 ```tsx
-import { HeaderBlock } from '@vadimcomanescu/nadicode-design-system/header-block'
-import { FooterBlock } from '@vadimcomanescu/nadicode-design-system/footer-block'
+import { seedComponents } from '@vadimcomanescu/nadicode-design-system/catalog/components'
+const { HeaderBlock, FooterBlock } = seedComponents
 
 const navLinks = [
   { name: 'Services', href: '/services' },
@@ -86,8 +86,8 @@ REDUCED MOTION: Header visible immediately, no blur transition
 
 | Component | Import Path | Purpose |
 |-----------|-------------|---------|
-| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/header-block` | Site navigation with glass blur |
-| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/footer-block` | Site footer |
+| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site navigation with glass blur |
+| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site footer |
 
 ### Allowed (optional)
 

package/.agents/skills/seed/recipes/navigation-shell.md

@@ -75,7 +75,8 @@ import {
   SidebarMenuSubItem,
   SidebarMenuSubButton,
 } from '@vadimcomanescu/nadicode-design-system/sidebar'
-import { NavUser } from '@vadimcomanescu/nadicode-design-system/nav-user'
+import { seedComponents } from '@vadimcomanescu/nadicode-design-system/catalog/components'
+const { NavUser } = seedComponents
 import { AppBreadcrumb } from '@/components/blocks/AppBreadcrumb'
 import { AppSearch } from '@/components/blocks/AppSearch'
 import { WorkspaceSwitcher } from '@/components/blocks/WorkspaceSwitcher'
@@ -704,7 +705,7 @@ REDUCED MOTION: All transitions instant
 | Component | Import Path | Purpose |
 |-----------|-------------|---------|
 | `Sidebar` (full system) | `@vadimcomanescu/nadicode-design-system/sidebar` | App sidebar with all subcomponents |
-| `NavUser` | `@vadimcomanescu/nadicode-design-system/nav-user` | User menu in sidebar footer |
+| `NavUser` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | User menu in sidebar footer |
 | `AppBreadcrumb` | Consumer block (see Section 2) | Route-aware breadcrumb |
 | `AppSearch` | Consumer block (see Section 3) | Cmd+K search palette |
 | `WorkspaceSwitcher` | Consumer block (see Section 7) | Org/workspace picker |

package/.agents/skills/seed/recipes/pricing.md

@@ -195,10 +195,10 @@ REDUCED MOTION: All items visible immediately
 | `Switch` | `@vadimcomanescu/nadicode-design-system/switch` | Billing toggle |
 | `Typography` | `@vadimcomanescu/nadicode-design-system/typography` | Headings, descriptions |
 | `Separator` | `@vadimcomanescu/nadicode-design-system/separator` | Plan card divider |
-| `FAQBlock` | `@vadimcomanescu/nadicode-design-system/faq-block` | FAQ section |
-| `CallToActionBlock` | `@vadimcomanescu/nadicode-design-system/call-to-action-block` | Final CTA |
-| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/header-block` | Navigation |
-| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/footer-block` | Footer |
+| `FAQBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | FAQ section |
+| `CallToActionBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Final CTA |
+| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Navigation |
+| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Footer |
 | `ScrollFadeIn` | `@vadimcomanescu/nadicode-design-system/scroll-fade-in` | Below-fold animation |
 | `CountingNumber` | `@vadimcomanescu/nadicode-design-system/text-effects/counting-number` | Price animation on toggle |
 

package/.agents/skills/seed/recipes/service-detail.md

@@ -225,13 +225,13 @@ REDUCED MOTION: All items visible immediately, opacity 0->1 in 10ms
 
 | Component | Import Path | Purpose |
 |-----------|-------------|---------|
-| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/header-block` | Site navigation |
-| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/footer-block` | Site footer |
+| `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site navigation |
+| `FooterBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Site footer |
 | `Button` | `@vadimcomanescu/nadicode-design-system/button` | CTAs |
 | `Badge` | `@vadimcomanescu/nadicode-design-system/badge` | Category tag |
 | `Typography` | `@vadimcomanescu/nadicode-design-system/typography` | Headings, body text |
 | `ScrollFadeIn` | `@vadimcomanescu/nadicode-design-system/scroll-fade-in` | Below-fold animations |
-| `FeatureGridBlock` | `@vadimcomanescu/nadicode-design-system/feature-grid-block` | Product/service showcase |
+| `FeatureGridBlock` | `@vadimcomanescu/nadicode-design-system/catalog/components` via `seedComponents` | Product/service showcase |
 
 ### Allowed (optional)
 

package/.agents/skills/seed/references/blocks.md

@@ -1,9 +1,8 @@
 # Blocks Catalog
 
-Derived from `dist/catalog.json`.
-
-Consumer code must import from `@vadimcomanescu/nadicode-design-system/*` block subpaths. Repo source paths are maintainer references only.
+Derived from `src/catalog/catalog.ts`.
 
+Components are consumed via `seedComponents` from `@vadimcomanescu/nadicode-design-system/catalog/components`. Repo source paths are maintainer references only.
 Blocks are pre-composed page sections built from Seed UI primitives.
 Run `npm run docs:inventory` for the current filesystem-backed list.
 
@@ -115,8 +114,9 @@ Run `npm run docs:inventory` for the current filesystem-backed list.
 Blocks accept `className` for placement and compose Seed UI primitives:
 
 ```tsx
-import { LoginBlock } from "@vadimcomanescu/nadicode-design-system/login-block"
-import { HeroBlock } from "@vadimcomanescu/nadicode-design-system/hero-block"
+import { seedComponents } from "@vadimcomanescu/nadicode-design-system/catalog/components"
+
+const { LoginBlock, HeroBlock } = seedComponents
 
 <div className="flex items-center justify-center min-h-dvh">
   <LoginBlock type="login" showSocial />

package/.agents/skills/seed/references/components.md

@@ -1,8 +1,8 @@
 # Component Inventory
 
-Derived from `dist/catalog.json`.
+Derived from `src/catalog/catalog.ts`.
 
-Consumer code must import from `@vadimcomanescu/nadicode-design-system/*` subpaths. The `Path` column below is the repo source location for maintainers.
+Components are consumed via `seedComponents` from `@vadimcomanescu/nadicode-design-system/catalog/components`. The `Path` column below is the repo source location for maintainers.
 
 Tiers: **1**=Core (3+ recipes), **2**=Domain (1-2 recipes), **3**=Decorative (marketing only), **4**=Deprecation candidate.
 

package/.agents/skills/seed/references/nextjs.md

@@ -8,8 +8,8 @@ Use these in order:
 
 1. `contract.md`, binary consumer rules
 2. this guide, integration checklist
-3. `consumer-contract.json` in the installed package, machine-readable ownership and contract entrypoint map
-4. `catalog.json` in the installed package, exact component metadata
+3. `./catalog` subpath export, server-safe component definitions with Zod schemas
+4. `./catalog/components` subpath export, React component map keyed by catalog name
 
 ## Integration Checklist
 

package/README.md

@@ -27,11 +27,11 @@ Canonical consumer docs:
 The repo treats structured truth and prose differently.
 
 - Operational truth lives in `package.json` scripts and `.husky/*`.
-- The shipped machine entrypoint for agents and scaffold apps lives in `contracts/consumer-contract.json` and is exported as `@vadimcomanescu/nadicode-design-system/consumer-contract`.
-- Public package surface lives in `package.json` exports, `contracts/public-surface-registry.json`, and `bin/shipped-files.json`.
+- The catalog is the single machine-readable component surface. Discovery: `@vadimcomanescu/nadicode-design-system/catalog`. Components: `@vadimcomanescu/nadicode-design-system/catalog/components`.
+- Public package surface lives in `package.json` exports, `src/catalog/catalog.ts`, and `bin/shipped-files.json`.
 - Consumer ownership and package-backed runtime rules live in [docs/nadicode/SCAFFOLDING_PROCESS.md](docs/nadicode/SCAFFOLDING_PROCESS.md).
 - Release steps live in [docs/releasing-package.md](docs/releasing-package.md).
-- Component metadata lives in `dist/catalog.json`, generated from source.
+- Component metadata lives in `dist/catalog/catalog.js`, generated from `src/catalog/catalog.ts`.
 
 Use prose docs for guidance and rationale. Use scripts, manifests, and generated artifacts for anything that must stay machine-accurate.
 

package/contracts/consumer-intent-map.json

@@ -1,8 +1,7 @@
 {
   "schemaVersion": "1.0.0",
   "generatedFrom": {
-    "registryPath": "contracts/public-surface-registry.json",
-    "registrySchemaVersion": "1.0.0"
+    "source": "scripts/generate-consumer-intent-map.mjs"
   },
   "intents": {
     "agents-chat": {

package/contracts/release-governance-baseline.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-03-25T21:42:01.343Z",
-  "packageVersion": "2.0.7",
+  "generatedAt": "2026-03-27T10:15:35.016Z",
+  "packageVersion": "4.0.0",
   "stableExports": [
     ".",
     "./accordion",
@@ -52,7 +52,6 @@
     "./banner-block",
     "./bar-chart-block",
     "./bento-grid",
-    "./block-props-schemas",
     "./blog-content-page-kit",
     "./brand-icons",
     "./breadcrumb",
@@ -106,9 +105,7 @@
     "./command",
     "./company-suite-page-kit",
     "./comparison-block",
-    "./component-props-schemas",
     "./confetti-burst",
-    "./consumer-contract",
     "./consumer-intent-map",
     "./contact-block",
     "./context-menu",
@@ -330,7 +327,6 @@
     "./notification-center",
     "./onboarding-block",
     "./onboarding-page-kit",
-    "./page-kit-props-schemas",
     "./page-transition",
     "./pagination",
     "./password-input",
@@ -345,7 +341,6 @@
     "./progress-ring",
     "./progressive-blur",
     "./promo-card",
-    "./public-surface-registry",
     "./radio-group",
     "./react-utils",
     "./recovery-page-kit",
@@ -374,7 +369,6 @@
     "./social-proof-block",
     "./sonner",
     "./source-citation",
-    "./spec-manifest",
     "./spinner",
     "./spring-hover",
     "./stagger-children",
@@ -810,41 +804,13 @@
     "pages.settings.underConstruction"
   ],
   "artifacts": {
-    "contracts/public-surface-registry.json": {
-      "schemaVersion": "1.0.0",
-      "shapeSignature": "5a76cac109041a9f60e288cfe903e23db0a45c56f6daff8f09bff97bfeeb2d11"
-    },
-    "contracts/block-props-schemas.json": {
-      "schemaVersion": "1.0.0",
-      "shapeSignature": "5a20094b5a00004d3187ee3bc5b8fe6d5b2d76a6b5ad0297834ee39deefe8988"
-    },
-    "contracts/component-props-schemas.json": {
-      "schemaVersion": "1.0.0",
-      "shapeSignature": "61e2aa0831df178f701cdcb7d3905b87f33d15d5e13e42487c24ee8ff15a386a"
-    },
-    "contracts/page-kit-props-schemas.json": {
-      "schemaVersion": "1.0.0",
-      "shapeSignature": "76a764c4d9b76a1ccf40d5493872c344df2c136c8b4bdc06bddc854ea54e3590"
-    },
     "contracts/consumer-intent-map.json": {
       "schemaVersion": "1.0.0",
-      "shapeSignature": "ee0a6787c7613eb41c32568a90a9cad3568c79f3df8bdfaef69a642203e47886"
+      "shapeSignature": "583a600417b95d3b7278d18d8a23ad8f0353314feb64fba7fa037c2c7db5b8b9"
     },
     "contracts/message-catalog-contract.json": {
       "schemaVersion": "1.0.0",
       "shapeSignature": "c95089ecca818272b27b77f8fac6fae04f8e4f0f381e302dfa084b00da12fcc8"
-    },
-    "contracts/spec-manifest.json": {
-      "schemaVersion": "1.0.0",
-      "shapeSignature": "e6c8904e15cc0fa5117b58485856a7db80746905ab61615b3e9936fe7b59ce08"
-    },
-    "contracts/consumer-contract.json": {
-      "schemaVersion": "1.0.0",
-      "shapeSignature": "1472ab7f0c0d4cc77d02821ae5284c85fed6e57d664d93bb6552cf42157c9a86"
-    },
-    "dist/catalog.json": {
-      "schemaVersion": "1.1.0",
-      "shapeSignature": "163dd9cef740c711e04d3402491df7684801764142fd48de45ef9bdde9920e54"
     }
   }
 }