@vadimcomanescu/nadicode-design-system 4.0.1 → 4.0.2

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

@@ -1,287 +0,0 @@
-# Component Inventory
-
-Derived from `src/catalog/catalog.ts`.
-
-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.
-
----
-
-## Form Controls
-
-| Component | Path | Tier | Radix/Lib | Notes |
-|-----------|------|------|-----------|-------|
-| Button | `ui/Button` | 1 | `react-slot` | 8 variants (primary, secondary, outline, ghost, link, destructive, accent, glass), 4 sizes |
-| Calendar | `ui/Calendar` | 1 | `react-day-picker` | Calendar grid primitive |
-| Checkbox | `ui/Checkbox` | 1 | `react-checkbox` | With optional label |
-| CheckoutForm | `ui/CheckoutForm` | 2 | `@stripe/react-stripe-js` | Stripe Elements checkout form |
-| CheckoutFormDemo | `ui/CheckoutFormDemo` | 2 | `@stripe/react-stripe-js` | Demo checkout with pre-wired state |
-| Combobox | `ui/Combobox` | 1 | `cmdk` | Searchable select |
-| DatePicker | `ui/DatePicker` | 1 | `react-day-picker` | Single date picker |
-| DateRangePicker | `ui/DateRangePicker` | 1 | `react-day-picker` | Date range selection |
-| Field | `ui/Field` | 1 | - | Generic field wrapper (label + error) |
-| FileUpload | `ui/FileUpload` | 1 | - | Drag-and-drop file upload zone |
-| Form | `ui/Form` | 1 | `react-hook-form` | FormField, FormItem, FormLabel, FormControl, FormMessage |
-| FormWizard | `ui/FormWizard` | 1 | - | Multi-step form wizard |
-| Input | `ui/Input` | 1 | - | size: sm/default/lg, props: label, error, startIcon, endIcon |
-| InputGroup | `ui/InputGroup` | 1 | - | Input + addon composition |
-| InputOTP | `ui/InputOTP` | 1 | `input-otp` | OTP input with groups, slots, separators |
-| Label | `ui/Label` | 1 | `react-label` | Accessible label |
-| NativeSelect | `ui/NativeSelect` | 4 | - | Browser-native <select> styled |
-| PasswordInput | `ui/PasswordInput` | 1 | - | Input with show/hide toggle |
-| RadioGroup | `ui/RadioGroup` | 1 | `react-radio-group` | RadioGroup + RadioGroupItem |
-| Select | `ui/Select` | 1 | `react-select` | Compound: Trigger, Content, Item, Group, Separator |
-| Slider | `ui/Slider` | 1 | `react-slider` | Range slider |
-| Switch | `ui/Switch` | 1 | `react-switch` | Toggle switch |
-| TagInput | `ui/TagInput` | 1 | - | Multi-value tag input |
-| Textarea | `ui/Textarea` | 1 | - | Auto-grow text area |
-
----
-
-## Display
-
-| Component | Path | Tier | Radix/Lib | Notes |
-|-----------|------|------|-----------|-------|
-| Accordion | `ui/Accordion` | 1 | `react-accordion` | Accordion, Item, Trigger, Content |
-| Alert | `ui/Alert` | 1 | - | variant: default, destructive |
-| AlertDialog | `ui/AlertDialog` | 1 | `react-alert-dialog` | Full compound set with actions |
-| AnimatedTabs | `ui/AnimatedTabs` | 3 | - | Tabs with sliding indicator (layoutId) |
-| AnnouncementBanner | `ui/AnnouncementBanner` | 1 | - | Top-of-page announcement |
-| Avatar | `ui/Avatar` | 1 | `react-avatar` | Avatar, AvatarImage, AvatarFallback |
-| AvatarUpload | `ui/AvatarUpload` | 1 | - | Avatar with upload functionality |
-| Badge | `ui/Badge` | 1 | - | variant: primary, secondary, destructive, outline, accent |
-| Breadcrumb | `ui/Breadcrumb` | 1 | - | Breadcrumb, List, Item, Link, Separator |
-| Card | `ui/Card` | 1 | - | Card, Header, Title, Description, Content, Footer |
-| Carousel | `ui/Carousel` | 1 | `embla-carousel-react` | Content, Item, Previous, Next |
-| CheckStatus | `ui/CheckStatus` | 2 | - | Status check indicator component |
-| DataFreshness | `ui/DataFreshness` | 2 | - | Data freshness/staleness indicator |
-| DataTable | `ui/DataTable` | 1 | `@tanstack/react-table` | Full-featured with sorting/filtering |
-| Empty | `ui/Empty` | 1 | - | Empty state placeholder |
-| Heading | `ui/Heading` | 1 | - | Semantic headings with explicit level + visual size |
-| HoverCard | `ui/HoverCard` | 4 | `react-hover-card` | HoverCard, Trigger, Content |
-| KanbanBoard | `ui/KanbanBoard` | 2 | - | Drag-and-drop kanban board component |
-| Kbd | `ui/Kbd` | 1 | - | Keyboard shortcut display |
-| MetricCard | `ui/MetricCard` | 2 | - | Single metric display card with label, value, and trend |
-| Popover | `ui/Popover` | 1 | `react-popover` | Popover, Trigger, Content |
-| Progress | `ui/Progress` | 1 | `react-progress` | Progress bar |
-| ProgressRing | `ui/ProgressRing` | 2 | - | Circular progress ring indicator |
-| PromoCard | `ui/PromoCard` | 4 | - | Promotional card (Card + glass-floating may replace) |
-| RoleBadge | `ui/RoleBadge` | 4 | - | Role-specific badge styling (merge into Badge) |
-| Skeleton | `ui/Skeleton` | 1 | - | Loading placeholder |
-| Spinner | `ui/Spinner` | 1 | - | Loading spinner |
-| StatusDot | `ui/StatusDot` | 4 | - | Status indicator dot (can be CSS utility) |
-| Table | `ui/Table` | 1 | - | Table, Header, Body, Row, Head, Cell |
-| Tabs | `ui/Tabs` | 1 | `react-tabs` | Tabs, TabsList, TabsTrigger, TabsContent |
-| Timeline | `ui/Timeline` | 1 | - | Vertical timeline |
-| Tooltip | `ui/Tooltip` | 1 | `react-tooltip` | Provider, Tooltip, Trigger, Content |
-| TrendIndicator | `ui/TrendIndicator` | 2 | - | Trend direction indicator (up/down/neutral) |
-| Typography | `ui/Typography` | 1 | - | Body, small, and muted text only |
-
----
-
-## Navigation
-
-| Component | Path | Tier | Radix/Lib | Notes |
-|-----------|------|------|-----------|-------|
-| Command | `ui/Command` | 1 | `cmdk` | Command palette primitive |
-| ContextMenu | `ui/ContextMenu` | 4 | `react-context-menu` | Rarely needed |
-| DropdownMenu | `ui/DropdownMenu` | 1 | `react-dropdown-menu` | Full compound set |
-| FloatingDock | `ui/FloatingDock` | 4 | - | macOS-style floating dock |
-| LanguageSwitcher | `ui/LanguageSwitcher` | 2 | - | Locale/language selection switcher |
-| Menubar | `ui/Menubar` | 4 | `react-menubar` | Rare in modern SaaS |
-| NavigationMenu | `ui/NavigationMenu` | 1 | `react-navigation-menu` | Menu, List, Item, Trigger, Content |
-| Pagination | `ui/Pagination` | 1 | - | Content, Item, Previous, Next |
-| SearchCommand | `ui/SearchCommand` | 1 | `cmdk` | Cmd+K search dialog |
-| Sidebar | `ui/Sidebar` | 1 | - | Full system: Provider, Trigger, Content, Group, Menu |
-| TreeView | `ui/TreeView` | 1 | - | Recursive collapsible tree with keyboard nav |
-
----
-
-## Layout and Overlays
-
-| Component | Path | Tier | Radix/Lib | Notes |
-|-----------|------|------|-----------|-------|
-| AnimatedDialog | `ui/AnimatedDialog` | 3 | `react-dialog` | Dialog with motion spring animations |
-| AnimatedSheet | `ui/AnimatedSheet` | 3 | `react-dialog` | Sheet with motion animations |
-| AspectRatio | `ui/AspectRatio` | 1 | `react-aspect-ratio` | Fixed aspect ratio container |
-| BentoGrid | `ui/BentoGrid` | 1 | - | CSS grid layout system |
-| Collapsible | `ui/Collapsible` | 4 | `react-collapsible` | Used by Sidebar internally |
-| Dialog | `ui/Dialog` | 1 | `react-dialog` | Full compound set with close button |
-| Drawer | `ui/Drawer` | 1 | `vaul` | Mobile-friendly bottom drawer |
-| Grid | `layout/Grid` | 1 | - | CSS Grid wrapper |
-| GridSystem | `layout/GridSystem` | 2 | - | Extended grid system with responsive column and gap utilities |
-| Resizable | `ui/Resizable` | 1 | `react-resizable-panels` | PanelGroup, Panel, Handle |
-| ScrollArea | `ui/ScrollArea` | 1 | `react-scroll-area` | Custom scrollbar |
-| Separator | `ui/Separator` | 1 | `react-separator` | Horizontal/vertical divider |
-| SettingsModal | `ui/SettingsModal` | 2 | - | Modal dialog for application settings |
-| Sheet | `ui/Sheet` | 1 | `react-dialog` | Slide-in side panel |
-| Toggle | `ui/Toggle` | 4 | `react-toggle` | variant: default, outline |
-| ToggleGroup | `ui/ToggleGroup` | 4 | `react-toggle-group` | Group of toggles |
-
----
-
-## Decorative Effects
-
-| Component | Path | Tier | Notes |
-|-----------|------|------|-------|
-| AmbientGrid | `ui/AmbientGrid` | 3 | CSS grid overlay (24px cells, 0.06 opacity) |
-| AnimatedBackground | `ui/AnimatedBackground` | 3 | CSS animated gradient background |
-| AuroraEffect | `ui/AuroraEffect` | 3 | Animated gradient aurora background |
-| InfiniteSlider | `ui/InfiniteSlider` | 3 | Auto-scrolling content slider |
-| MagneticElement | `ui/MagneticElement` | 3 | Magnetic cursor attraction |
-| MeteorShower | `ui/MeteorShower` | 3 | Falling meteor particles |
-| MouseEffect | `ui/MouseEffect` | 3 | Mouse-tracking effects (MouseGlow, MouseSpotlight) |
-| MovingBorder | `ui/MovingBorder` | 3 | Animated border rotation |
-| ProgressiveBlur | `ui/ProgressiveBlur` | 3 | Gradient blur effect |
-| ShaderBackground | `ui/ShaderBackground` | 2 | 21 shader types with intent-based presets (hero, section, ambient, card) |
-| TiltCard | `ui/TiltCard` | 3 | 3D perspective tilt on hover |
-
----
-
-## Text Effects
-
-All in `@vadimcomanescu/nadicode-design-system/text-effects/`.
-
-| Component | Path | Tier | Notes |
-|-----------|------|------|-------|
-| AnimatedGradientText | `ui/text-effects/AnimatedGradientText` | 3 | Animated gradient sweep on text |
-| CountingNumber | `ui/text-effects/CountingNumber` | 3 | Animated number counter (also used in dashboard) |
-| FlipWords | `ui/text-effects/FlipWords` | 3 | Word cycling with flip animation |
-| HighlightText | `ui/text-effects/HighlightText` | 3 | Animated highlight marker |
-| MorphingText | `ui/text-effects/MorphingText` | 3 | SVG text morphing transitions |
-| ShimmeringText | `ui/text-effects/ShimmeringText` | 3 | Shimmer highlight sweep |
-| SlidingNumber | `ui/text-effects/SlidingNumber` | 3 | Digit-by-digit sliding animation |
-| StreamingText | `ui/text-effects/StreamingText` | 3 | ChatGPT-style streaming output |
-| TextReveal | `ui/text-effects/TextReveal` | 3 | Scroll-triggered text reveal |
-
----
-
-## Animation Utilities
-
-| Component | Path | Tier | Notes |
-|-----------|------|------|-------|
-| ConfettiBurst | `ui/ConfettiBurst` | 1 | Celebratory confetti animation |
-| PageTransition | `ui/PageTransition` | 1 | Route transition wrapper (keyed on pathname) |
-| ScrollFadeIn | `ui/ScrollFadeIn` | 1 | Fade in on scroll intersection |
-| SpringHover | `ui/SpringHover` | 3 | Spring-based hover effect wrapper |
-| StaggerChildren | `ui/StaggerChildren` | 1 | Stagger child element entrances |
-| StaggeredEntrance | `ui/StaggeredEntrance` | 3 | Sequential entrance animation |
-| SuccessCheck | `ui/SuccessCheck` | 1 | Animated success checkmark |
-
----
-
-## Charts
-
-Base `Chart.tsx` in `ui/` (not `ui/charts/`). The 7 chart variants in `ui/charts/`.
-
-| Component | Path | Tier | Notes |
-|-----------|------|------|-------|
-| AreaChart | `ui/charts/AreaChart` | 2 | Recharts area chart |
-| BarChart | `ui/charts/BarChart` | 2 | Recharts bar chart |
-| Chart | `ui/Chart` | 2 | Base config: ChartContainer, ChartTooltip, ChartLegend |
-| ChartCard | `ui/ChartCard` | 2 | Card wrapper for chart display with title and description |
-| HeatmapChart | `ui/charts/HeatmapChart` | 2 | Custom heatmap visualization |
-| LineChart | `ui/charts/LineChart` | 2 | Recharts line chart |
-| PieChart | `ui/charts/PieChart` | 2 | Recharts pie/donut chart |
-| RadarChart | `ui/charts/RadarChart` | 2 | Recharts radar chart |
-| RadialBarChart | `ui/charts/RadialBarChart` | 2 | Recharts radial bar chart |
-| Sparkline | `ui/charts/Sparkline` | 2 | Inline sparkline chart for compact trend display |
-
----
-
-## AI / Voice
-
-| Component | Path | Tier | Notes |
-|-----------|------|------|-------|
-| AgentAvatar | `ui/AgentAvatar` | 2 | AI agent avatar with idle/listening/speaking states |
-| AgentStatus | `ui/AgentStatus` | 2 | Agent connection status indicator |
-| AudioWaveform | `ui/AudioWaveform` | 2 | Real-time audio visualization |
-| Avatar3D | `ui/Avatar3D` | 2 | 3D avatar with Three.js |
-| ConversationThread | `ui/ConversationThread` | 2 | Chat message thread |
-
----
-
-## Agentic UI
-
-Components for AI agent interfaces, tool-use visualization, and multi-agent workflows.
-
-| Component | Path | Tier | Notes |
-|-----------|------|------|-------|
-| AgentMessageBubble | `ui/AgentMessageBubble` | 2 | Chat bubble with role-based styling |
-| AgentMetricsCard | `ui/AgentMetricsCard` | 2 | Agent performance metrics dashboard |
-| AgentTeamPanel | `ui/AgentTeamPanel` | 2 | Agent team members and statuses |
-| AgentTerminal | `ui/AgentTerminal` | 2 | Terminal-style command output |
-| AgentTimeline | `ui/AgentTimeline` | 2 | Timeline of agent actions |
-| ApprovalCard | `ui/ApprovalCard` | 2 | Human-in-the-loop approval/reject |
-| ArtifactCard | `ui/ArtifactCard` | 2 | Generated artifacts display |
-| ChatActions | `ui/ChatActions` | 2 | Quick-action buttons for chat messages |
-| ChatBranch | `ui/ChatBranch` | 2 | Conversation branching and fork navigation |
-| ChatChainOfThought | `ui/ChatChainOfThought` | 2 | Step-by-step reasoning display |
-| ChatConfirmation | `ui/ChatConfirmation` | 2 | Action confirmation dialog in chat |
-| ChatGreeting | `ui/ChatGreeting` | 2 | Welcome greeting for chat sessions |
-| ChatMessage | `ui/ChatMessage` | 2 | Core chat message with avatar, content, actions |
-| ChatPlan | `ui/ChatPlan` | 2 | Collapsible plan card with streaming title |
-| ChatPromptInput | `ui/ChatPromptInput` | 2 | Chat text input with keyboard handling |
-| ChatPromptInputAttachments | `ui/ChatPromptInputAttachments` | 2 | File attachment support for chat input |
-| ChatQueue | `ui/ChatQueue` | 2 | Task queue with collapsible sections |
-| ChatReasoning | `ui/ChatReasoning` | 2 | AI reasoning display with auto-close |
-| ChatResponse | `ui/ChatResponse` | 2 | Streaming markdown response renderer |
-| ChatShimmer | `ui/ChatShimmer` | 2 | Loading shimmer placeholder for chat |
-| ChatSources | `ui/ChatSources` | 2 | Source citations panel with inline citation |
-| ChatSuggestion | `ui/ChatSuggestion` | 2 | Suggested follow-up prompt chips |
-| ChatThinkingMessage | `ui/ChatThinkingMessage` | 2 | Animated thinking state message |
-| ChatToolCall | `ui/ChatToolCall` | 2 | Tool call lifecycle wrapper with state management |
-| CodeDiffViewer | `ui/CodeDiffViewer` | 2 | Side-by-side or unified diff view |
-| ContextMeter | `ui/ContextMeter` | 2 | Context window usage visualization |
-| Conversation | `ui/Conversation` | 2 | Scroll-aware conversation container with auto-scroll |
-| DiffStat | `ui/DiffStat` | 2 | Diff statistics display (additions/deletions) |
-| HandoffIndicator | `ui/HandoffIndicator` | 2 | Agent-to-agent task handoff |
-| MemoryInspector | `ui/MemoryInspector` | 2 | Agent memory/state inspector |
-| SourceCitation | `ui/SourceCitation` | 2 | Cited sources with links |
-| ThinkingIndicator | `ui/ThinkingIndicator` | 2 | Animated "thinking..." for agent reasoning |
-| ToolCallCard | `ui/ToolCallCard` | 2 | Tool invocation with name, args, status, result |
-| WorkflowGraph | `ui/WorkflowGraph` | 2 | Visual graph of workflow steps |
-
----
-
-## Multi-Step / Stepper
-
-All in `src/components/ui/stepper/`. Distinct from FormWizard.
-
-| Component | Path | Tier | Notes |
-|-----------|------|------|-------|
-| Step | `ui/stepper/step` | 1 | Individual step |
-| Stepper | `ui/stepper/stepper` | 1 | Root stepper, exports useStepper hook |
-
----
-
-## Miscellaneous
-
-| Component | Path | Tier | Notes |
-|-----------|------|------|-------|
-| BrandIcons | `ui/BrandIcons` | 1 | Google, GitHub brand SVGs |
-| ButtonGroup | `ui/ButtonGroup` | 4 | Grouped button layout (use flex+gap) |
-| Item | `ui/Item` | 4 | Generic list item (too generic) |
-| Logo | `ui/Logo` | 1 | Brand logo component |
-| NotificationCenter | `ui/NotificationCenter` | 4 | Overlaps with Sonner/Toast |
-| SkipNav | `ui/SkipNav` | 1 | Accessibility skip navigation |
-| Sonner | `ui/Sonner` | 1 | Sonner toast integration |
-| StyleToggle | `ui/StyleToggle` | 1 | Arctic/bloom style switcher |
-| ThemeToggle | `ui/ThemeToggle` | 1 | Light/dark/system theme switcher |
-| Toast | `ui/Toast` | 1 | Toast notification primitive |
-| Toaster | `ui/Toaster` | 1 | Toast container and renderer |
-| VisuallyHidden | `ui/VisuallyHidden` | 1 | Screen-reader-only content |
-
----
-
-## Tier Summary
-
-| Tier | Count | Usage |
-|------|-------|-------|
-| 1 (Core) | ~76 | 3+ recipes, always available |
-| 2 (Domain) | ~61 | Agentic, charts, AI/voice, checkout |
-| 3 (Decorative) | ~24 | Marketing/showcase only |
-| 4 (Deprecation) | ~14 | Evaluate for removal/consolidation |
-
-Use `npm run docs:inventory` for filesystem-backed inventory output.

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

@@ -1,169 +0,0 @@
-# Icons Catalog
-
-Two-tier animated icon system: **109 hand-crafted** + **290 factory-wrapped** = **399 total**.
-
-- **Hand-crafted** (`src/components/ui/icons/*.tsx`): Custom SVG path animations using `motion/react` with imperative `startAnimation`/`stopAnimation` handles. Sourced from [lucide-animated.com](https://lucide-animated.com).
-- **Factory-wrapped** (`src/components/ui/icons/lucide-wrapped.tsx`): Full Lucide icon catalog wrapped via `createAnimatedIcon()`. These animate on hover but lack custom path transitions.
-
-All icons import from `@vadimcomanescu/nadicode-design-system/icons` (unified re-export via `index.ts`).
-
-## Usage
-
-```tsx
-import { SettingsIcon, BellIcon, SearchIcon } from "@vadimcomanescu/nadicode-design-system/icons"
-
-<SettingsIcon size={16} />
-<BellIcon size={20} />
-<SearchIcon size={24} />  // default size is 28
-```
-
-## Rules
-
-- **NEVER import directly from `lucide-react`** in component files. Enforced by `no-static-lucide-imports.test.ts`.
-- Hand-crafted icons contain inline SVG path data. They do NOT import from `lucide-react`.
-- Factory-wrapped icons use Lucide's React components internally via `createAnimatedIcon`.
-
-## Hand-Crafted Icons (109)
-
-Premium animated icons with custom per-path motion.
-
-| Export Name | File | Common Use |
-| --- | --- | --- |
-| ActivityIcon | `activity.tsx` | Activity feed |
-| AlertCircleIcon | `alert-circle.tsx` | Error alert |
-| AlertTriangleIcon | `alert-triangle.tsx` | Warning |
-| ArrowDownIcon | `arrow-down.tsx` | Directional |
-| ArrowDownRightIcon | `arrow-down-right.tsx` | Directional |
-| ArrowLeftIcon | `arrow-left.tsx` | Back navigation |
-| ArrowRightIcon | `arrow-right.tsx` | Forward navigation |
-| ArrowUpIcon | `arrow-up.tsx` | Directional |
-| ArrowUpRightIcon | `arrow-up-right.tsx` | External link |
-| BellIcon | `bell.tsx` | Notifications |
-| BoldIcon | `bold.tsx` | Text formatting |
-| BotIcon | `bot.tsx` | AI agent |
-| CalendarIcon | `calendar.tsx` | Date picker, events |
-| ChartBarIcon | `chart-bar.tsx` | Analytics |
-| ChartLineIcon | `chart-line.tsx` | Trends |
-| ChartPieIcon | `chart-pie.tsx` | Pie charts |
-| CheckIcon | `check.tsx` | Confirmations |
-| CheckCircleIcon | `check-circle.tsx` | Success state |
-| ChevronDownIcon | `chevron-down.tsx` | Expand, dropdown |
-| ChevronLeftIcon | `chevron-left.tsx` | Previous |
-| ChevronRightIcon | `chevron-right.tsx` | Next |
-| ChevronUpIcon | `chevron-up.tsx` | Collapse |
-| ChevronsUpDownIcon | `chevrons-up-down.tsx` | Sort, reorder |
-| CircleIcon | `circle.tsx` | Status indicator |
-| ClipboardIcon | `clipboard.tsx` | Copy, paste |
-| ClockIcon | `clock.tsx` | Time |
-| CloudIcon | `cloud.tsx` | Cloud services |
-| Code2Icon | `code-2.tsx` | Source code |
-| CopyIcon | `copy.tsx` | Copy to clipboard |
-| CornerDownLeftIcon | `corner-down-left.tsx` | Reply, enter |
-| CreditCardIcon | `credit-card.tsx` | Payments |
-| DatabaseIcon | `database.tsx` | Database |
-| DollarSignIcon | `dollar-sign.tsx` | Pricing, money |
-| DotIcon | `dot.tsx` | Bullet, separator |
-| DownloadIcon | `download.tsx` | Download |
-| EllipsisIcon | `ellipsis.tsx` | More actions |
-| ExternalLinkIcon | `external-link.tsx` | External link |
-| EyeIcon | `eye.tsx` | Show, visibility |
-| EyeOffIcon | `eye-off.tsx` | Hide, toggle visibility |
-| FileIcon | `file.tsx` | Files, documents |
-| FilterIcon | `filter.tsx` | Filtering |
-| FolderIcon | `folder.tsx` | Folders, files |
-| GithubIcon | `github.tsx` | GitHub link |
-| GlobeIcon | `globe.tsx` | International, web |
-| GripVerticalIcon | `grip-vertical.tsx` | Drag handle |
-| HomeIcon | `home.tsx` | Home, dashboard |
-| ImageIcon | `image.tsx` | Images, media |
-| InfoIcon | `info.tsx` | Information |
-| ItalicIcon | `italic.tsx` | Text formatting |
-| KeyIcon | `key.tsx` | Authentication, API keys |
-| LaptopIcon | `laptop.tsx` | Desktop device |
-| LayersIcon | `layers.tsx` | Stacks, layers |
-| LayoutDashboardIcon | `layout-dashboard.tsx` | Dashboard |
-| LinkIcon | `link.tsx` | Hyperlinks |
-| LinkedinIcon | `linkedin.tsx` | LinkedIn link |
-| ListIcon | `list.tsx` | Lists |
-| LoaderIcon | `loader.tsx` | Loading |
-| LoaderCircleIcon | `loader-circle.tsx` | Loading spinner |
-| LockIcon | `lock.tsx` | Security, locked state |
-| LogInIcon | `log-in.tsx` | Sign in |
-| LogOutIcon | `log-out.tsx` | Sign out |
-| MailIcon | `mail.tsx` | Email |
-| MenuIcon | `menu.tsx` | Hamburger menu |
-| MicIcon | `mic.tsx` | Voice input, recording |
-| MicOffIcon | `mic-off.tsx` | Muted mic |
-| MinusIcon | `minus.tsx` | Remove, collapse |
-| MonitorIcon | `monitor.tsx` | Display, screen |
-| MoonIcon | `moon.tsx` | Dark mode |
-| PackageIcon | `package.tsx` | Packages, shipping |
-| Package2Icon | `package-2.tsx` | Alt package icon |
-| PanelLeftIcon | `panel-left.tsx` | Sidebar toggle |
-| PaperclipIcon | `paperclip.tsx` | Attachments |
-| PauseIcon | `pause.tsx` | Pause media |
-| PencilIcon | `pencil.tsx` | Edit |
-| PlayIcon | `play.tsx` | Play media |
-| PlusIcon | `plus.tsx` | Add, create |
-| ReceiptIcon | `receipt.tsx` | Billing, receipts |
-| RefreshCwIcon | `refresh-cw.tsx` | Refresh, sync |
-| ReplyIcon | `reply.tsx` | Reply |
-| RocketIcon | `rocket.tsx` | Launch, deploy |
-| SaveIcon | `save.tsx` | Save |
-| SearchIcon | `search.tsx` | Search fields |
-| SendIcon | `send.tsx` | Send message |
-| SettingsIcon | `settings.tsx` | Settings, preferences |
-| Settings2Icon | `settings-2.tsx` | Alt settings |
-| ShareIcon | `share.tsx` | Share |
-| ShieldIcon | `shield.tsx` | Security |
-| ShieldCheckIcon | `shield-check.tsx` | Security verified |
-| SmartphoneIcon | `smartphone.tsx` | Mobile device |
-| SnowflakeIcon | `snowflake.tsx` | Arctic style, winter |
-| SortIcon | `sort.tsx` | Sorting |
-| SparklesIcon | `sparkles.tsx` | AI, magic, premium |
-| StarIcon | `star.tsx` | Favorites, rating |
-| StopIcon | `stop.tsx` | Stop media |
-| SunIcon | `sun.tsx` | Light mode |
-| TableIcon | `table.tsx` | Data tables |
-| TerminalIcon | `terminal.tsx` | Code, CLI |
-| ThumbsDownIcon | `thumbs-down.tsx` | Dislike |
-| ThumbsUpIcon | `thumbs-up.tsx` | Like |
-| Trash2Icon | `trash-2.tsx` | Delete |
-| TwitterIcon | `twitter.tsx` | Twitter/X link |
-| UnderlineIcon | `underline.tsx` | Text formatting |
-| UploadIcon | `upload.tsx` | File upload |
-| UserIcon | `user.tsx` | User profile |
-| UsersIcon | `users.tsx` | Team, groups |
-| WrenchIcon | `wrench.tsx` | Tools, configuration |
-| XIcon | `x.tsx` | Close, dismiss |
-| XCircleIcon | `x-circle.tsx` | Error, cancel |
-| ZapIcon | `zap.tsx` | Power, performance |
-
-## Factory-Wrapped Icons (290)
-
-Standard Lucide icons wrapped with `createAnimatedIcon()` for consistent hover behavior. All export as `<Name>Icon` and are available from `@vadimcomanescu/nadicode-design-system/icons`.
-
-For the full list, see `src/components/ui/icons/lucide-wrapped.tsx`. Representative icons include: AlarmClockIcon, AlignLeftIcon, AnchorIcon, ApertureIcon, ArchiveIcon, ArrowBigDownIcon, AtSignIcon, AwardIcon, BadgeCheckIcon, BanIcon, BanknoteIcon, BarChartIcon, BeakerIcon, BellDotIcon, BellOffIcon, BellRingIcon, BluetoothIcon, BookOpenIcon, BookmarkIcon, BoxIcon, BracesIcon, BriefcaseIcon, BugIcon, BuildingIcon, CalculatorIcon, CalendarCheckIcon, CalendarDaysIcon, CameraIcon, CircleAlertIcon, CircleCheckIcon, CodeIcon, CoinsIcon, CommandIcon, CompassIcon, CpuIcon, CrownIcon, FacebookIcon, FeatherIcon, FileCodeIcon, FileTextIcon, FlagIcon, FlameIcon, GaugeIcon, GemIcon, GiftIcon, GitBranchIcon, GlassesIcon, HammerIcon, HeartIcon, HeadphonesIcon, HighlighterIcon, HistoryIcon, HourglassIcon, InstagramIcon, KanbanIcon, LampIcon, LandmarkIcon, LanguagesIcon, LeafIcon, LightbulbIcon, LineChartIcon, LockKeyholeIcon, MapIcon, MapPinIcon, MegaphoneIcon, MessageCircleIcon, MessageSquareIcon, MicroscopeIcon, MoveIcon, MusicIcon, NetworkIcon, NotebookIcon, PaintbrushIcon, PaletteIcon, PartyPopperIcon, PenIcon, PenToolIcon, PercentIcon, PhoneIcon, PieChartIcon, PiggyBankIcon, PlugIcon, PodcastIcon, PowerIcon, PrinterIcon, PuzzleIcon, QrCodeIcon, RadioIcon, RedoIcon, RepeatIcon, RotateCcwIcon, RouteIcon, RssIcon, RulerIcon, ScaleIcon, ScanIcon, ScissorsIcon, ServerIcon, ShieldAlertIcon, ShieldOffIcon, ShoppingCartIcon, SirenIcon, SpeakerIcon, SquareIcon, StampIcon, StoreIcon, SunriseIcon, SunsetIcon, TagIcon, TargetIcon, TelescopeIcon, TicketIcon, TimerIcon, ToggleLeftIcon, TornadoIcon, TrashIcon, TrendingDownIcon, TrendingUpIcon, TrophyIcon, TvIcon, TwitchIcon, UmbrellaIcon, UndoIcon, UnlockIcon, UserCheckIcon, UserCogIcon, UserMinusIcon, UserPlusIcon, VideoIcon, VolumeIcon, WalletIcon, WandIcon, WatchIcon, WaypointsIcon, WebhookIcon, WifiIcon, WindIcon, YoutubeIcon.
-
-## Adding a New Icon
-
-Two paths depending on quality requirements:
-
-### Quick path — factory-wrapped
-
-Use when you need an icon quickly and custom animation is not required.
-
-1. Open `src/components/ui/icons/lucide-wrapped.tsx`
-2. Add the Lucide import at the top: `import { MyIcon } from 'lucide-react'`
-3. Add an export line: `export const MyIconIcon = createAnimatedIcon(MyIcon, 'MyIconIcon')`
-
-No changes to `index.ts` needed — `lucide-wrapped.tsx` is already re-exported.
-
-### Premium path — hand-crafted
-
-Use for icons that appear in high-visibility UI (nav, hero, primary actions) and benefit from custom per-path animation.
-
-1. Find the icon on [lucide-animated.com](https://lucide-animated.com) and grab the animation code
-2. Create `src/components/ui/icons/<icon-name>.tsx`
-3. Adapt to match project pattern: `motion/react` animations, imperative handle with `startAnimation`/`stopAnimation`, `size` prop (see `sun.tsx` as reference)
-4. Export from `src/components/ui/icons/index.ts`

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

@@ -1,49 +0,0 @@
-# Next.js Integration Guide
-
-Seed integrates into Next.js apps through installable package artifacts, not live repo-path links.
-
-## Canonical Contract
-
-Use these in order:
-
-1. `contract.md`, binary consumer rules
-2. this guide, integration checklist
-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
-
-- install an exact released package version of `@vadimcomanescu/nadicode-design-system`, or a committed relative tarball fallback such as `file:.nadicode/packages/vadimcomanescu-nadicode-design-system-<version>.tgz`
-- never point `package.json` at a live repo directory such as `file:/absolute/path/to/nadicode-design-system`
-- import `@vadimcomanescu/nadicode-design-system/tokens.css` before `seed-palette.css`
-- use `@vadimcomanescu/nadicode-design-system/tailwind` in `tailwind.config.*`
-- use `@vadimcomanescu/nadicode-design-system/eslint-config` and `@vadimcomanescu/nadicode-design-system/eslint-plugin` in `eslint.config.*`
-- mount `ThemeProvider` from `@vadimcomanescu/nadicode-design-system/theme-provider`
-- keep `scripts/ds-check.mjs` and `scripts/ds-update.mjs` as thin package delegates
-
-## i18n
-
-The app owns `src/i18n/request.ts`, locale routing, `NextIntlClientProvider`, and app catalogs. Seed owns DS catalogs and merge helpers.
-
-Import DS catalogs from `@vadimcomanescu/nadicode-design-system/messages/<locale>`, keep app catalogs in `messages/<locale>.json`, merge both with `mergeSeedMessages()`, and do not copy DS catalog files into the app.
-
-## Update Path
-
-After the first install, the stable consumer command is:
-
-```bash
-npm run ds:update
-```
-
-`ds:update` must reinstall the exact `@vadimcomanescu/nadicode-design-system` dependency already declared in `package.json`.
-
-That tarball path is the unpublished local fallback. Do not point the app at a live repo directory.
-
-## Verification
-
-```bash
-npm run ds:check
-npm run lint
-npx tsc --noEmit
-npm run build
-```

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

@@ -1,88 +0,0 @@
-# Tokens Reference
-
-This file is a usage guide, not the raw source of token values.
-
-## Source Of Truth
-
-- authored source: `src/lib/tokens.config.js`
-- generated repo CSS: `src/index.css`
-- shipped consumer CSS: `@vadimcomanescu/nadicode-design-system/tokens.css`
-
-When maintaining the DS, edit `src/lib/tokens.config.js` and regenerate through `npm run build:lib`. Do not hand-edit generated CSS.
-
-In consumer apps, normal branding work happens in `seed-palette.css`, not in the package token pipeline.
-
-## CSS Variable Format
-
-Use space-separated RGB values, not hex:
-
-```css
-/* correct */
---color-background: 247 247 248;
-
-/* wrong */
---color-background: #f7f7f8;
-```
-
-This preserves Tailwind opacity modifiers such as `bg-background/50`.
-
-## Allowed Semantic Utilities
-
-### Backgrounds
-
-- `bg-background`
-- `bg-surface`
-- `bg-surface-hover`
-- `bg-surface-active`
-- `bg-surface-raised`
-- `bg-muted`
-- `bg-overlay/80`
-
-### Text
-
-- `text-text-primary`
-- `text-text-secondary`
-- `text-text-tertiary`
-- `text-link`
-
-Do not use `text-foreground` or `text-muted-foreground`.
-
-### Borders And Focus
-
-- `border-border`
-- `border-border-hover`
-- `border-border-subtle`
-- `ring-focus-ring` for default focus indication
-- `ring-accent` for selected or emphasized states
-
-Do not use `border-error`.
-
-### Status
-
-- `bg-destructive`, `text-destructive`
-- `bg-success`, `text-success`
-- `bg-warning`, `text-warning`
-- `bg-info`, `text-info`
-
-### Interactive
-
-- `bg-primary`
-- `bg-secondary`
-- `bg-accent`
-- `text-accent`
-
-### Charts
-
-- `chart-1` through `chart-8`
-
-Use the exported chart tokens, not hardcoded hex values.
-
-## Theme Notes
-
-- Arctic is the baseline jade and teal style across light and dark themes.
-- Bloom is the warm light-only style variant.
-- `--color-focus-ring` currently tracks the jade focus color in Arctic and the bloom-specific focus token in Bloom.
-
-## Consumer Override Rule
-
-Consumers may override palette tokens in `seed-palette.css`. They should not change the package token catalog or copy package CSS into the app.