@vadimcomanescu/nadicode-design-system 4.0.0 → 4.0.2

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

@@ -3,8 +3,8 @@ name: Seed Design System
 description: >
   Use when building UI with the Seed Design System or composing full pages from
   Seed components. Covers tokens, components, glass effects, animations,
-  dual-axis theming, page recipes, and Next.js App Router integration.
-tags: [seed, design-system, arctic-glow, react, tailwind, radix, glassmorphism, recipes]
+  dual-axis theming, page-kits, and Next.js App Router integration.
+tags: [seed, design-system, arctic-glow, react, tailwind, radix, glassmorphism, page-kits]
 ---
 
 # Seed Design System -- Agent Skill
@@ -20,7 +20,7 @@ Consumer scaffold contract: brand customization stays palette-only unless the ta
 
 ## Component Discovery
 
-The catalog (`./catalog` and `./catalog/components` subpath exports) is the single surface for discovering and consuming Seed components.
+The catalog (`./catalog` and `./catalog/components` subpath exports) is the single surface for discovering and consuming Seed blocks and page-kits.
 
 **Discovery** (server-safe, read this to learn what's available):
 ```ts
@@ -36,61 +36,19 @@ import { seedComponents } from "@vadimcomanescu/nadicode-design-system/catalog/c
 
 Usage:
 ```tsx
-const { LoginBlock, Button, Card } = seedComponents
+const { LoginBlock, DashboardPageKit } = seedComponents
 <LoginBlock onSubmit={handleLogin} />
 ```
 
-Do not import from individual subpath exports. Do not browse package exports. The catalog is the single source of truth.
+**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.
 
-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.
+**UI primitives** (Button, Heading, Input, etc.), icons, charts, and effects are imported via individual subpath exports. They are not registered in the catalog.
 
 ## Read Order
 
-1. **This file** -- router, quick references, forbidden patterns
-2. **`contract.md`** -- binary rules, package integration contract
-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
-
----
-
-## Intent Decision Tree
-
-What are you building? Follow the tree to find your recipe.
-
-```
-Does user have a session?
-  YES --> app-shell intents:
-         dashboard .......... recipes/dashboard.md
-         CRUD list/detail ... recipes/crud-list-detail.md
-         CRUD form .......... recipes/crud-form.md
-         settings ........... recipes/settings.md
-         analytics .......... recipes/analytics.md
-         agents/chat ........ recipes/agents-chat.md
-         navigation shell ... recipes/navigation-shell.md
-  NO  --> auth?
-            YES --> recipes/auth.md (auth-shell)
-          onboarding?
-            YES --> recipes/onboarding.md (onboarding-shell)
-          marketing intents (marketing-shell):
-            agency home ...... recipes/agency-home.md
-            landing .......... recipes/marketing-landing.md
-            digital workers .. recipes/digital-workers.md
-            service detail ... recipes/service-detail.md
-            pricing .......... recipes/pricing.md
-            blog/content ..... recipes/blog-content.md
-            about/team ....... recipes/company-about.md
-            contact .......... recipes/company-contact.md
-            checkout ......... recipes/checkout.md
-            marketing shell .. recipes/marketing-shell.md
-          error pages --> recipes/error-pages.md (fallback-shell)
-```
-
-Full intent-to-recipe mapping with shell selection: see `intent-map.md`.
+1. **This file** -- router, quick references, forbidden patterns, binary rules
+2. **catalog** (`@vadimcomanescu/nadicode-design-system/catalog`) -- machine-readable component metadata (variants, props, tiers)
+3. **`references/`** -- deep dives as needed
 
 ---
 
@@ -113,6 +71,28 @@ Full intent-to-recipe mapping with shell selection: see `intent-map.md`.
 | CSS hex in vars: `--color-bg: #0F1114` | `--color-background: 15 17 20` | CSS vars use space-separated RGB |
 | Block without `interface *Props` | `interface MyBlockProps { title?: string }` | Integrity test enforces |
 | Required content props | Optional with defaults in destructuring | Blocks render standalone |
+| Inline/floating labels | `Label` above control (stacked) | Form convention |
+| `text-[10px]`, `text-[11px]` | `text-xs`, `text-sm`, `Heading`, `Typography` | No arbitrary text sizes |
+| Ad-hoc `chat-*` classes | Compose Seed primitives + motion tokens | No custom chat classes |
+| `import { BarChart } from "recharts"` | `import { BarChart } from "@vadimcomanescu/nadicode-design-system/charts"` | No direct recharts |
+| Ad-hoc Card + value for KPIs | `MetricCard` | Use the DS component |
+| Hex/rgb in chart config | `var(--color-chart-N)` tokens | Chart colors are tokenized |
+| Generic English defaults | Override ALL default copy per brand | No shipping placeholder text |
+| Hardcoded hex in components | Map to semantic tokens | Brand colors via tokens only |
+
+---
+
+## Brand Customization
+
+Override all default copy. Map brand colors to semantic tokens. Verify contrast (WCAG AA: 4.5:1 body, 3:1 large). See `references/brand-override.md` for glass intensity presets.
+
+## Dashboard Rules
+
+KPI cards: `MetricCard`. Charts: empty-data guard required (`data.length > 0`). Chart colors: `var(--color-chart-N)` tokens. Import from `./charts`, never `recharts` directly. Sidebar navigation must include IA grouping with `SidebarGroupLabel`.
+
+## Admin Chat
+
+Chat features must include all three agentic layers: Conversation, Tooling, Traceability. See catalog for available components in each layer. Analytics must use Seed chart primitives.
 
 ---
 
@@ -132,7 +112,7 @@ Full intent-to-recipe mapping with shell selection: see `intent-map.md`.
 
 **Sidebar:** `sidebar`, `sidebar-foreground`, `sidebar-primary`, `sidebar-accent`, `sidebar-border`, `sidebar-ring`
 
-Full token tables with CSS variables and Radix scales: `references/tokens.md`
+Token source of truth: `src/lib/tokens.config.js` (authored), `src/index.css` (generated).
 
 ---
 
@@ -223,13 +203,7 @@ import { motionSpring, fadeInUp, blockStagger } from "@/lib/motion"
 
 ### Spring Presets
 
-| Name | Stiffness | Damping | Mass | Use For |
-|------|-----------|---------|------|---------|
-| `snappy` | 400 | 28 | 0.8 | Micro-interactions, tooltips |
-| `gentle` | 200 | 20 | 1.0 | Page transitions, drawers |
-| `bouncy` | 300 | 14 | 0.8 | Celebration, completion |
-| `dramatic` | 500 | 24 | 1.2 | Hero entrances |
-| `wobbly` | bloom only | | | Extra bounce |
+`snappy` (micro-interactions), `gentle` (page transitions), `bouncy` (celebration), `dramatic` (hero entrances), `wobbly` (bloom only). Full values: `references/animation.md`.
 
 ### Duration Tokens
 
@@ -267,19 +241,7 @@ import { SettingsIcon, BellIcon } from "@vadimcomanescu/nadicode-design-system/i
 
 **Total: 399 icons.** Before adding a new icon, check whether it already exports from `@vadimcomanescu/nadicode-design-system/icons` or a matching `@vadimcomanescu/nadicode-design-system/icons/<name>` subpath.
 
-### Adding a New Icon
-
-1. **Check if it exists** (399 total -- likely yes).
-2. **If missing:** add it to `lucide-wrapped.tsx` using `createAnimatedIcon`:
-   ```tsx
-   import { Home } from "lucide-react"
-   export const HomeIcon = createAnimatedIcon(Home, "HomeIcon")
-   ```
-3. **If the needed icon is missing**, stop and request an upstream DS export. Do not hand-craft a local scaffold copy just to bypass the package contract.
-
-`createAnimatedIcon` is also exported for consumers to wrap any Lucide icon ad-hoc without adding it to the catalog.
-
-Full catalog: `references/icons.md`
+If an icon is missing, add it to `lucide-wrapped.tsx` via `createAnimatedIcon`. Do not hand-craft local copies to bypass the package contract.
 
 ---
 
@@ -328,6 +290,8 @@ Every page = **Shell > Sections > Components**.
 - 2-8 sections (vertical bands, no nesting)
 - 1-6 components per section via CSS grid/flex
 
+Page-kits in the catalog ARE the ready-made compositions. Use `seedComponents.<Name>PageKit` from `@vadimcomanescu/nadicode-design-system/catalog/components` rather than assembling pages by hand.
+
 ### Shell Selection
 
 | Intent | Shell | Components |
@@ -340,69 +304,9 @@ Every page = **Shell > Sections > Components**.
 
 Content widths, vertical rhythm, responsive contracts: `references/composition.md`
 
-### Kanban Board (Drag & Drop)
+### Kanban Board
 
-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 type { KanbanColumnState, KanbanMoveMeta } from '@vadimcomanescu/nadicode-design-system/kanban-board'
-```
-
-**Architecture:** `@dnd-kit/core` + `@dnd-kit/sortable` internally. Consumer API is Seed-owned (no dnd-kit types leak).
-
-**Usage:**
-
-```tsx
-type Task = { id: string; title: string }
-
-const [columns, setColumns] = useState<KanbanColumnState<Task>[]>([
-  { id: 'todo', items: [{ id: '1', title: 'Task A' }] },
-  { id: 'done', items: [] },
-])
-
-<KanbanBoard
-  value={columns}
-  onValueChange={(next, meta) => {
-    setColumns([...next])
-    // meta: { item, itemId, fromColumnId, toColumnId, fromIndex, toIndex }
-  }}
-  getItemId={(task) => task.id}
-  getItemLabel={(task) => task.title}
-  canMove={({ fromColumnId, toColumnId }) => isAllowed(fromColumnId, toColumnId)}
-  renderOverlay={(task) => <MyCard task={task} />}
->
-  {columns.map((col) => (
-    <KanbanColumn key={col.id} id={col.id} items={col.items} aria-label={col.name}>
-      <KanbanColumnHeader>{col.name} <Badge variant="outline">{col.items.length}</Badge></KanbanColumnHeader>
-      {col.items.map((task) => (
-        <KanbanItem key={task.id} value={task}>
-          <KanbanHandle aria-label={`Move ${task.title}`} />
-          <MyCard task={task} />
-        </KanbanItem>
-      ))}
-    </KanbanColumn>
-  ))}
-</KanbanBoard>
-```
-
-**Key props:**
-
-| Prop | Required | Purpose |
-|------|----------|---------|
-| `value` | Yes | `KanbanColumnState<T>[]` -- controlled column state |
-| `onValueChange` | Yes | `(next, meta) => void` -- fires with new state + move metadata |
-| `getItemId` | Yes | Extract stable ID from item |
-| `getItemLabel` | No | Human label for screen reader announcements |
-| `canMove` | No | Constraint callback to reject moves |
-| `renderOverlay` | No | Custom drag ghost (renders inside `glass-floating`) |
-| `activationDistance` | No | Px before drag starts (default: 5) |
-| `items` on Column | Yes | Pass the column's items array for SortableContext |
-
-**Card content is consumer-owned.** The DS provides the board structure, drag mechanics, glass styling, and accessibility. Compose card interiors from existing DS primitives: `Badge`, `StatusDot`, `Typography`, `Button`, `Avatar`.
+Compound component via `seedComponents`. Uses `@dnd-kit` internally (no dnd-kit types leak). Card content is consumer-owned. See catalog entry for full props and sub-components. Types: `@vadimcomanescu/nadicode-design-system/kanban-board`.
 
 ---
 
@@ -415,46 +319,14 @@ Patterns: `references/state-machines.md`
 
 ---
 
-## Recipe Index
-
-| Intent | Recipe | Shell |
-|--------|--------|-------|
-| Dashboard | `recipes/dashboard.md` | app-shell |
-| Marketing Landing | `recipes/marketing-landing.md` | marketing-shell |
-| Agency Home | `recipes/agency-home.md` | marketing-shell |
-| Digital Workers | `recipes/digital-workers.md` | marketing-shell |
-| Service Detail | `recipes/service-detail.md` | marketing-shell |
-| CRUD List + Detail | `recipes/crud-list-detail.md` | app-shell |
-| CRUD Form | `recipes/crud-form.md` | app-shell |
-| Settings | `recipes/settings.md` | app-shell |
-| Auth | `recipes/auth.md` | auth-shell |
-| Onboarding | `recipes/onboarding.md` | onboarding-shell |
-| Pricing | `recipes/pricing.md` | marketing-shell |
-| Analytics | `recipes/analytics.md` | app-shell |
-| Agent Chat | `recipes/agents-chat.md` | app-shell |
-| Error Pages | `recipes/error-pages.md` | fallback-shell |
-| Navigation Shell | `recipes/navigation-shell.md` | app-shell |
-| Blog / Content | `recipes/blog-content.md` | marketing-shell |
-| Company About | `recipes/company-about.md` | marketing-shell |
-| Company Contact | `recipes/company-contact.md` | marketing-shell |
-| Marketing Shell | `recipes/marketing-shell.md` | marketing-shell |
-| Checkout | `recipes/checkout.md` | marketing-shell |
-
----
-
 ## Reference Index
 
 | File | Contents |
 |------|----------|
-| `references/tokens.md` | Radix scales, semantic token map, CSS variables, bloom palette |
-| `references/components.md` | All UI components with tiers inline, Radix primitives, agentic UI |
 | `references/patterns.md` | Golden pattern + 4 code examples: Button, Input, Dialog, LoginBlock |
 | `references/animation.md` | Springs, easings, durations, stagger, choreography, reduced motion |
 | `references/glass-and-effects.md` | Glass tier CSS, decorative components, text effects, shaders |
-| `references/blocks.md` | Blocks by domain with import paths |
-| `references/icons.md` | Animated icon usage patterns |
 | `references/opinions.md` | Decision tables from Opinions Bible |
-| `references/nextjs.md` | App Router setup, providers, SSR boundaries, showcase |
 | `references/composition.md` | Layout algebra, spacing, grid patterns, content widths |
 | `references/responsive.md` | Breakpoint contracts, mobile-first, touch targets |
 | `references/state-machines.md` | State machines, loading tiers, streaming, error handling |

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

@@ -90,7 +90,7 @@ What is the element?
 
 ## Storyboard Format
 
-Every recipe includes an animation storyboard:
+Animation storyboard format (use when documenting page-kit entrance sequences):
 
 ```
 ANIMATION STORYBOARD
@@ -254,7 +254,7 @@ When `prefers-reduced-motion` is active:
 - ScrollFadeIn elements visible immediately
 - Continuous animations (aurora, shimmer, meteor) paused via CSS
 
-Every recipe storyboard includes a `REDUCED` line specifying fallback behavior.
+Every storyboard includes a `REDUCED` line specifying fallback behavior when `prefers-reduced-motion` is active.
 
 ---
 

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

@@ -17,7 +17,7 @@ Breakpoint contracts, mobile-first patterns, touch targets, and responsive rules
 
 **Design priority**: Mobile-first. Default styles target mobile, add complexity at breakpoints.
 
-**Primary breakpoints** (used in recipes): default, `sm:`, `lg:`, `xl:`. Use `md:` and `2xl:` sparingly.
+**Primary breakpoints**: default, `sm:`, `lg:`, `xl:`. Use `md:` and `2xl:` sparingly.
 
 ---
 

package/README.md

@@ -15,12 +15,13 @@ The dev server runs on `http://localhost:5001` and serves the showcase routes un
 
 Consumer apps install Seed through an exact released package version. For unpublished local work, stage a tarball under `.nadicode/packages/` and install that committed relative artifact instead. Do not point apps at a live DS repo directory.
 
+Component discovery and consumption go through the catalog. Blocks and page-kits have no individual subpath exports.
+
 Canonical consumer docs:
 
 - [docs/nadicode/SCAFFOLDING_PROCESS.md](docs/nadicode/SCAFFOLDING_PROCESS.md), normative runtime and ownership contract
 - [docs/nadicode/ADOPTION_PLAYBOOK.md](docs/nadicode/ADOPTION_PLAYBOOK.md), step-by-step install and wiring flow
 - [.agents/skills/seed/SKILL.md](.agents/skills/seed/SKILL.md), synced agent-facing usage guide
-- [.agents/skills/seed/contract.md](.agents/skills/seed/contract.md), synced binary consumer rules
 
 ## Canonical Sources
 
@@ -31,7 +32,6 @@ The repo treats structured truth and prose differently.
 - 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/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/dist/catalog/components.js

@@ -7,14 +7,14 @@ import { PricingPageKit } from '../chunk-RMGDDOCD.js';
 import { ProfileSettingsPageKit } from '../chunk-MGSGCARB.js';
 import { RecoveryPageKit } from '../chunk-BRCBJ3S4.js';
 import { ResetPageKit } from '../chunk-LP6ZZYOQ.js';
-import { ServiceSuitePageKit } from '../chunk-7XLZCXUL.js';
+import { ServiceSuitePageKit } from '../chunk-K4U67BVG.js';
 import { SettingsPageKit } from '../chunk-RKQPU75I.js';
 import { SignupPageKit } from '../chunk-BRICSLHJ.js';
 import { SuccessPageKit } from '../chunk-3U56FXYC.js';
 import { DashboardPageKit } from '../chunk-C33GUEDY.js';
 import { ErrorPageKit } from '../chunk-HPTHS7SX.js';
 import { KanbanBoardPageKit } from '../chunk-25BOZMXA.js';
-import { LandingPageKit } from '../chunk-TUJZMJXW.js';
+import { LandingPageKit } from '../chunk-LK2L3C7D.js';
 import { LoginPageKit } from '../chunk-Z2WION42.js';
 import { OnboardingPageKit } from '../chunk-BYEHHZZN.js';
 import { AccountLockedPageKit } from '../chunk-DNJEVMDY.js';
@@ -52,7 +52,7 @@ import { PasswordRecoveryBlock } from '../chunk-5PZ4VR2D.js';
 import { PricingBlock } from '../chunk-VNNAL4A6.js';
 import '../chunk-DARC2ACH.js';
 import { GalleryBlock } from '../chunk-FTGFOK6T.js';
-import { HeroBlock } from '../chunk-7A2RXKGH.js';
+import { HeroBlock } from '../chunk-GJ557DGH.js';
 import { HeroSectionBlock } from '../chunk-ALA6OM7K.js';
 import '../chunk-QQOWC53X.js';
 import { HeaderBlock } from '../chunk-WOYBVPXK.js';
@@ -182,7 +182,7 @@ import '../chunk-D4NC7WX5.js';
 import '../chunk-5UESKK6S.js';
 import '../chunk-NAAU5IWU.js';
 import '../chunk-4S326Z3D.js';
-import '../chunk-DSMGCFMJ.js';
+import '../chunk-POFFOUQW.js';
 import '../chunk-GJUR6HT3.js';
 import '../chunk-7KIDDF3I.js';
 import '../chunk-4GSFNJAJ.js';

package/dist/{chunk-7A2RXKGH.js → chunk-GJ557DGH.js}

@@ -3,7 +3,7 @@ import { AnimatedGradientText } from './chunk-XZ3A33GP.js';
 import { Heading } from './chunk-WI547C47.js';
 import { siteConfig } from './chunk-A7NUWD76.js';
 import { Card, CardHeader, CardContent } from './chunk-AH6YSYYT.js';
-import { MouseGlow } from './chunk-DSMGCFMJ.js';
+import { MouseGlow } from './chunk-POFFOUQW.js';
 import { Button } from './chunk-7KIDDF3I.js';
 import { m, heroStagger } from './chunk-PD2YEH3H.js';
 import { ZapIcon } from './chunk-FLF5AMNO.js';

package/dist/{chunk-7XLZCXUL.js → chunk-K4U67BVG.js}

@@ -2,7 +2,7 @@ import { MarketingShellPageKit } from './chunk-Z233ZQZE.js';
 import { TeamBlock } from './chunk-VBZQ4DBE.js';
 import { TestimonialsBlock } from './chunk-FV2G6SAF.js';
 import { ProcessFlowBlock } from './chunk-HZERHGBT.js';
-import { HeroBlock } from './chunk-7A2RXKGH.js';
+import { HeroBlock } from './chunk-GJ557DGH.js';
 import { FAQBlock } from './chunk-NEHCPO53.js';
 import { FeatureBlock } from './chunk-HJ3A2YNO.js';
 import { CallToActionBlock } from './chunk-GJPTPLCQ.js';

package/dist/{chunk-TUJZMJXW.js → chunk-LK2L3C7D.js}

@@ -3,7 +3,7 @@ import { SocialProofBlock } from './chunk-C7WHMSF3.js';
 import { StatsMarketingBlock } from './chunk-QIHA7S3A.js';
 import { NewsletterBlock } from './chunk-K7NQ6ZAW.js';
 import { PricingBlock } from './chunk-VNNAL4A6.js';
-import { HeroBlock } from './chunk-7A2RXKGH.js';
+import { HeroBlock } from './chunk-GJ557DGH.js';
 import { FAQBlock } from './chunk-NEHCPO53.js';
 import { FeatureBlock } from './chunk-HJ3A2YNO.js';
 import { CallToActionBlock } from './chunk-GJPTPLCQ.js';

package/dist/{chunk-DSMGCFMJ.js → chunk-POFFOUQW.js}

@@ -5,10 +5,7 @@ import { createPortal } from 'react-dom';
 import { useReducedMotion, useMotionValue, useMotionTemplate } from 'motion/react';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
-function getAccentColor() {
-  if (typeof window === "undefined") return "10 158 111";
-  return getComputedStyle(document.documentElement).getPropertyValue("--color-accent").trim() || "10 158 111";
-}
+var CSS_ACCENT_095 = "rgb(var(--color-accent) / 0.95)";
 function MouseGlow({
   className,
   dotColor = "rgba(255, 255, 255, 0.5)",
@@ -20,7 +17,7 @@ function MouseGlow({
   const containerRef = React.useRef(null);
   const overlayRef = React.useRef(null);
   const [mounted, setMounted] = React.useState(false);
-  const resolvedOverlayColor = overlayColor ?? `rgba(${getAccentColor().replace(/ /g, ", ")}, 0.95)`;
+  const resolvedOverlayColor = overlayColor ?? CSS_ACCENT_095;
   React.useEffect(() => {
     setMounted(true);
     const handleMouseMove = (e) => {

package/dist/components/blocks/HeroBlock.js

@@ -1,5 +1,5 @@
 'use client';
-export { HeroBlock } from '../../chunk-7A2RXKGH.js';
+export { HeroBlock } from '../../chunk-GJ557DGH.js';
 import '../../chunk-G5EO22OR.js';
 import '../../chunk-OHX2LFAH.js';
 import '../../chunk-SGI25ZJ6.js';
@@ -14,7 +14,7 @@ import '../../chunk-4O6L5YWT.js';
 import '../../chunk-WI547C47.js';
 import '../../chunk-A7NUWD76.js';
 import '../../chunk-AH6YSYYT.js';
-import '../../chunk-DSMGCFMJ.js';
+import '../../chunk-POFFOUQW.js';
 import '../../chunk-7KIDDF3I.js';
 import '../../chunk-PD2YEH3H.js';
 import '../../chunk-CRY67BIF.js';

package/dist/components/page-kits/LandingPageKit.js

@@ -1,11 +1,11 @@
-export { LandingPageKit } from '../../chunk-TUJZMJXW.js';
+export { LandingPageKit } from '../../chunk-LK2L3C7D.js';
 import '../../chunk-Z233ZQZE.js';
 import '../../chunk-C7WHMSF3.js';
 import '../../chunk-QIHA7S3A.js';
 import '../../chunk-K7NQ6ZAW.js';
 import '../../chunk-VNNAL4A6.js';
 import '../../chunk-DARC2ACH.js';
-import '../../chunk-7A2RXKGH.js';
+import '../../chunk-GJ557DGH.js';
 import '../../chunk-QQOWC53X.js';
 import '../../chunk-WOYBVPXK.js';
 import '../../chunk-NEHCPO53.js';
@@ -38,7 +38,7 @@ import '../../chunk-LIBXYD5Q.js';
 import '../../chunk-I23DDSU7.js';
 import '../../chunk-AH6YSYYT.js';
 import '../../chunk-NAAU5IWU.js';
-import '../../chunk-DSMGCFMJ.js';
+import '../../chunk-POFFOUQW.js';
 import '../../chunk-7KIDDF3I.js';
 import '../../chunk-6FOHUNXR.js';
 import '../../chunk-PD2YEH3H.js';

package/dist/components/page-kits/ServiceSuitePageKit.js

@@ -1,9 +1,9 @@
-export { ServiceSuitePageKit } from '../../chunk-7XLZCXUL.js';
+export { ServiceSuitePageKit } from '../../chunk-K4U67BVG.js';
 import '../../chunk-Z233ZQZE.js';
 import '../../chunk-VBZQ4DBE.js';
 import '../../chunk-FV2G6SAF.js';
 import '../../chunk-HZERHGBT.js';
-import '../../chunk-7A2RXKGH.js';
+import '../../chunk-GJ557DGH.js';
 import '../../chunk-QQOWC53X.js';
 import '../../chunk-WOYBVPXK.js';
 import '../../chunk-NEHCPO53.js';
@@ -33,7 +33,7 @@ import '../../chunk-LIBXYD5Q.js';
 import '../../chunk-I23DDSU7.js';
 import '../../chunk-AH6YSYYT.js';
 import '../../chunk-NAAU5IWU.js';
-import '../../chunk-DSMGCFMJ.js';
+import '../../chunk-POFFOUQW.js';
 import '../../chunk-7KIDDF3I.js';
 import '../../chunk-6FOHUNXR.js';
 import '../../chunk-PD2YEH3H.js';

package/dist/components/ui/AvatarUpload.js

@@ -1,5 +1,5 @@
 'use client';
-import { MouseSpotlight } from '../../chunk-DSMGCFMJ.js';
+import { MouseSpotlight } from '../../chunk-POFFOUQW.js';
 import '../../chunk-PD2YEH3H.js';
 import '../../chunk-CRY67BIF.js';
 import '../../chunk-HJC6U46F.js';

package/dist/components/ui/MouseEffect.js

@@ -1,5 +1,5 @@
 'use client';
-export { MouseGlow, MouseSpotlight } from '../../chunk-DSMGCFMJ.js';
+export { MouseGlow, MouseSpotlight } from '../../chunk-POFFOUQW.js';
 import '../../chunk-PD2YEH3H.js';
 import '../../chunk-CRY67BIF.js';
 import '../../chunk-HJC6U46F.js';

package/eslint-rules/nadicode/config.js

@@ -83,6 +83,7 @@ export const nadicodeRules = {
   "nadicode/no-handcoded-empty-state": "error",
   "nadicode/no-handcoded-field": "error",
   "nadicode/require-catalog-component": "error",
+  "nadicode/require-catalog-import": "error",
 };
 
 function normalizePattern(pattern) {

package/eslint-rules/nadicode/index.js

@@ -70,6 +70,7 @@ import noHandcodedHeading from "./rules/no-handcoded-heading.js";
 import noHandcodedEmptyState from "./rules/no-handcoded-empty-state.js";
 import noHandcodedField from "./rules/no-handcoded-field.js";
 import requireCatalogComponent from "./rules/require-catalog-component.js";
+import requireCatalogImport from "./rules/require-catalog-import.js";
 
 export { nadicodeRules, createAllowlistOverrides } from "./config.js";
 
@@ -147,5 +148,6 @@ export const nadicodePlugin = {
     "no-handcoded-empty-state": noHandcodedEmptyState,
     "no-handcoded-field": noHandcodedField,
     "require-catalog-component": requireCatalogComponent,
+    "require-catalog-import": requireCatalogImport,
   },
 };

package/eslint-rules/nadicode/rules/__tests__/require-catalog-import.test.js

@@ -0,0 +1,111 @@
+import { RuleTester } from "eslint";
+import { describe } from "vitest";
+
+import rule from "../require-catalog-import.js";
+
+const tester = new RuleTester({
+  languageOptions: {
+    ecmaVersion: "latest",
+    sourceType: "module",
+  },
+});
+
+describe("require-catalog-import", () => {
+  tester.run("require-catalog-import", rule, {
+    valid: [
+      // Catalog import (correct pattern)
+      {
+        code: "import { seedComponents } from '@/catalog/components';",
+        filename: "/repo/src/app/page.tsx",
+      },
+      // UI primitive (not a block/page-kit)
+      {
+        code: "import { Button } from '@/components/ui/Button';",
+        filename: "/repo/src/app/page.tsx",
+      },
+      // Type-only imports are allowed (importKind === "type"), but require TS parser to test.
+      // Verified in production via TypeScript ESLint config.
+      // Test files are exempt
+      {
+        code: "import { HeroBlock } from '@/components/blocks/HeroBlock';",
+        filename: "/repo/src/components/blocks/__tests__/HeroBlock.test.tsx",
+      },
+      {
+        code: "import { HeroBlock } from '../../blocks/HeroBlock';",
+        filename: "/repo/src/components/blocks/HeroBlock.spec.tsx",
+      },
+      // Catalog barrel itself is exempt
+      {
+        code: "import { HeroBlock } from '@/components/blocks/HeroBlock';",
+        filename: "/repo/src/catalog/components.tsx",
+      },
+      // Block source files are exempt (internal composition)
+      {
+        code: "import { AuthLayout } from '../blocks/AuthLayout';",
+        filename: "/repo/src/components/blocks/LoginBlock.tsx",
+      },
+      // Page-kit source files are exempt
+      {
+        code: "import { HeaderBlock } from '../blocks/HeaderBlock';",
+        filename: "/repo/src/components/page-kits/LandingPageKit.tsx",
+      },
+    ],
+    invalid: [
+      // Direct block import via absolute alias
+      {
+        code: "import { HeroBlock } from '@/components/blocks/HeroBlock';",
+        filename: "/repo/src/app/page.tsx",
+        errors: [
+          {
+            message:
+              "Import 'HeroBlock' from '@/catalog/components' via seedComponents. Direct block/page-kit imports are not allowed (ADR 0009).",
+          },
+        ],
+      },
+      // Direct page-kit import via absolute alias
+      {
+        code: "import { LandingPageKit } from '@/components/page-kits/LandingPageKit';",
+        filename: "/repo/src/app/page.tsx",
+        errors: [
+          {
+            message:
+              "Import 'LandingPageKit' from '@/catalog/components' via seedComponents. Direct block/page-kit imports are not allowed (ADR 0009).",
+          },
+        ],
+      },
+      // Relative block import from pages directory
+      {
+        code: "import { HeroBlock } from '../../blocks/HeroBlock';",
+        filename: "/repo/src/components/pages/showcase/BlocksShowcase.tsx",
+        errors: [
+          {
+            message:
+              "Import 'HeroBlock' from '@/catalog/components' via seedComponents. Direct block/page-kit imports are not allowed (ADR 0009).",
+          },
+        ],
+      },
+      // Relative block import (one level up)
+      {
+        code: "import { FooterBlock } from '../blocks/FooterBlock';",
+        filename: "/repo/src/components/pages/LandingPage.tsx",
+        errors: [
+          {
+            message:
+              "Import 'FooterBlock' from '@/catalog/components' via seedComponents. Direct block/page-kit imports are not allowed (ADR 0009).",
+          },
+        ],
+      },
+      // Nested block path (e.g., blocks/user/InviteUserModal)
+      {
+        code: "import { InviteUserModal } from '../../blocks/user/InviteUserModal';",
+        filename: "/repo/src/components/pages/settings/TeamPage.tsx",
+        errors: [
+          {
+            message:
+              "Import 'InviteUserModal' from '@/catalog/components' via seedComponents. Direct block/page-kit imports are not allowed (ADR 0009).",
+          },
+        ],
+      },
+    ],
+  });
+});

package/eslint-rules/nadicode/rules/no-has-svg-selector.js

@@ -19,7 +19,7 @@ function reportMatches(context, node, tokens) {
       context.report({
         node,
         message:
-          "Selector '{{sel}}' breaks with animated icon wrappers. Use a data-slot sub-component instead (see golden-pattern.md).",
+          "Selector '{{sel}}' breaks with animated icon wrappers. Use a data-slot sub-component instead (see references/patterns.md).",
         data: { sel: hit },
       });
     }