@vadimcomanescu/nadicode-design-system 2.0.9 → 4.0.0

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

@@ -20,29 +20,38 @@ 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 components.
 
-```
-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, Button, Card } = 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.
+Do not import from individual subpath exports. Do not browse package exports. The catalog is the single source of truth.
+
+The ESLint rule `nadicode/no-raw-recharts-import` and related rules enforce correct import paths at lint time. See the ESLint Rule Reference 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

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

@@ -9,8 +9,15 @@ 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
 

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"
     }
   }
 }