@neuctra/ui-mcp 0.4.7 → 0.4.9

package/data/layouts.json

@@ -66,7 +66,8 @@
             49,
             50,
             51,
-            59
+            59,
+            64
           ],
           "seoRuleIds": [
             "technical",
@@ -276,7 +277,8 @@
             48,
             49,
             53,
-            59
+            59,
+            64
           ],
           "seoRuleIds": [
             "technical",
@@ -483,7 +485,9 @@
             55,
             57,
             58,
-            59
+            59,
+            65,
+            66
           ],
           "seoRuleIds": [
             "technical",
@@ -604,6 +608,8 @@
             2,
             3,
             13,
+            15,
+            16,
             24,
             35,
             43,
@@ -615,7 +621,9 @@
             55,
             57,
             58,
-            59
+            59,
+            65,
+            66
           ],
           "seoRuleIds": [
             "technical",
@@ -675,6 +683,8 @@
             4,
             5,
             7,
+            15,
+            16,
             22,
             23,
             24,
@@ -691,7 +701,9 @@
             51,
             55,
             57,
-            59
+            59,
+            65,
+            66
           ],
           "seoRuleIds": [
             "technical",
@@ -748,6 +760,8 @@
             2,
             3,
             7,
+            15,
+            16,
             22,
             23,
             24,
@@ -759,7 +773,8 @@
             47,
             48,
             49,
-            59
+            59,
+            66
           ],
           "seoRuleIds": [
             "technical",
@@ -825,7 +840,8 @@
             55,
             57,
             58,
-            59
+            59,
+            66
           ],
           "seoRuleIds": [
             "technical",
@@ -880,6 +896,8 @@
             2,
             3,
             13,
+            15,
+            16,
             24,
             35,
             43,
@@ -891,7 +909,8 @@
             55,
             57,
             58,
-            59
+            59,
+            66
           ],
           "seoRuleIds": [
             "technical",
@@ -945,6 +964,8 @@
             2,
             3,
             13,
+            15,
+            16,
             24,
             35,
             43,
@@ -956,7 +977,8 @@
             55,
             57,
             58,
-            59
+            59,
+            66
           ],
           "seoRuleIds": [
             "technical",
@@ -1018,7 +1040,9 @@
             55,
             57,
             58,
-            59
+            59,
+            65,
+            66
           ],
           "seoRuleIds": [
             "technical",
@@ -1087,7 +1111,8 @@
             47,
             48,
             49,
-            59
+            59,
+            66
           ],
           "seoRuleIds": [
             "technical",
@@ -1138,6 +1163,8 @@
             2,
             3,
             13,
+            15,
+            16,
             24,
             35,
             43,
@@ -1149,7 +1176,8 @@
             55,
             57,
             58,
-            59
+            59,
+            66
           ],
           "seoRuleIds": [
             "technical",
@@ -1549,6 +1577,7 @@
             2,
             3,
             13,
+            15,
             24,
             35,
             43,
@@ -1696,6 +1725,7 @@
             2,
             3,
             13,
+            15,
             24,
             35,
             43,
@@ -1767,6 +1797,7 @@
             7,
             13,
             15,
+            16,
             22,
             24,
             25,
@@ -2189,7 +2220,8 @@
             49,
             53,
             59,
-            61
+            61,
+            64
           ],
           "seoRuleIds": [
             "technical",
@@ -2318,7 +2350,8 @@
             55,
             57,
             58,
-            59
+            59,
+            64
           ],
           "seoRuleIds": [
             "technical",
@@ -2551,7 +2584,8 @@
             55,
             57,
             58,
-            59
+            59,
+            64
           ],
           "seoRuleIds": [
             "technical",
@@ -2601,6 +2635,7 @@
             2,
             3,
             13,
+            15,
             24,
             35,
             43,
@@ -2791,7 +2826,9 @@
             55,
             57,
             58,
-            59
+            59,
+            65,
+            66
           ],
           "seoRuleIds": [
             "technical",

package/data/theme.json

@@ -14,25 +14,28 @@
   ],
   "antiAiLookRules": [
     "This section exists because AI-generated UI has recognizable tells. Read it before generating anything visual — the goal is UI indistinguishable from a deliberate human design pass, not a demo that screams 'built by an LLM'.",
-    "No gradients, compulsory: never use gradients on backgrounds, buttons, or text (bg-gradient-to-r, from-purple-500 to-pink-500, bg-clip-text text-transparent, etc.). Use a flat bg-primary (or the relevant status token) instead. This is the single most common AI-UI tell — do not use it even 'just for one hero section'.",
-    "No shadows, compulsory: never add box-shadow/drop-shadow utilities (shadow-sm through shadow-2xl, glowing hover rings, colored blur halos) to any element YOU style directly — buttons, badges, cards, inputs, hand-built panels/overlays, or any other static surface you write classNames for. A flat surface with border-border is correct. Scope note (applies to every rule in this list, not just this one): this governs classNames/markup you author yourself. It does not mean stripping or fighting any pre-built @neuctra/ui component's own internal default styling, no matter which component or what that default is (several components ship their own shadow — e.g. Modal, Drawer, Popover, Dropdown, Tooltip, Table, DatePicker's calendar panel, Avatar's status dot, Kbd, and the Toast/ToastProvider notification — this is not an exhaustive list and isn't meant to be maintained as one). Per the 'don't overwrite built-in component design' rule: leave every component's shipped defaults exactly as they ship. Never add a decorative shadow yourself, and never override one away with `!important` either — both are the same mistake in opposite directions.",
-    "No blur effects, compulsory: never use backdrop-blur or any glassmorphism treatment (frosted-glass cards, translucent bg-white/10 panels) on any element YOU style directly, including a hand-built modal/drawer backdrop — use an opaque or semi-opaque solid backdrop (e.g. bg-background/80) instead of a blurred one. Surfaces you author are opaque (bg-card, bg-popover, bg-background), not translucent. Same scope note as the shadow rule above: this is about classNames/markup you write, not about a pre-built @neuctra/ui component's own internal backdrop-blur (e.g. Modal/Drawer's backdrop, Dropdown's menu panel, Carousel's nav buttons ship with backdrop-blur baked in, among others) — leave every component's shipped defaults exactly as they ship, whichever component it is.",
+    "Brand effects are allowed, inside the theme, compulsory: gradients, glows, blur and animated backgrounds may be used to make a page feel branded, but every color in them must come from the theme tokens (var(--primary), var(--foreground), var(--background), var(--card), var(--border) and their /opacity variants, or color-mix() of them). Never introduce a color outside the theme for an effect: no from-purple-500 to-pink-500, no rainbow or multicolor gradients, no neon colors. Switching the theme must change every effect with it.",
+    "Gradients, restrained: use at most two theme colors per gradient (e.g. from-primary to-foreground, or primary fading to transparent). Allowed on: a few highlighted words in a heading (bg-clip-text), section and hero backgrounds, card edges, and thin divider lines. Not allowed on: buttons, body text, inputs, badges, or every heading on the page. At most one gradient heading per viewport.",
+    "No shadows on buttons and cards, compulsory: never add shadow-sm through shadow-2xl, drop-shadow, or any box-shadow to buttons, cards, panels, inputs, modals you build yourself, or any surface that holds content. Separate surfaces with border-border, a background change (bg-card vs bg-background) and spacing instead. Leave the built-in shadows of @neuctra/ui components (Modal, Drawer, Popover, Dropdown, Tooltip, Toast) exactly as they ship.",
+    "Glows are not shadows: a soft colored glow made from the primary token is allowed on small accents (a status dot, a step number, a progress bar, a timeline marker) and as a pointer-following light inside a card on hover. Keep it subtle (theme color at 10 to 30 percent opacity) and never use it on buttons, text or inputs.",
+    "Blur, in its place: backdrop-blur is allowed on sticky or fixed bars (navbar, tab bar, top bar) and on modal overlays, always with a mostly opaque token background (bg-background/75 or more). Large blurred blobs of the primary token (blur-[100px] or more, low opacity, pointer-events-none, aria-hidden) are allowed behind hero and section content. Never blur content the user reads, and never make a card see-through.",
     "No blanket border-radius escalation — don't reach for rounded-2xl/rounded-3xl/rounded-full on every card, input, and button by default. Match the radius already used by the surrounding neuctra-ui components (rounded-md/rounded-lg/rounded-xl per component, see each component's own classes) instead of picking a bigger one because it 'looks more modern'.",
-    "No decorative hover/focus glow rings. ring-* and focus-visible:ring-ring exist for accessibility (keyboard focus indication) only — never add a colored ring or glow as a pointer-hover decoration on cards, buttons, or images.",
-    "No animate-pulse / bounce / scale-105-on-hover / floating-icon motion sprinkled across static content as decoration. Motion should communicate state (loading, a toast entering, a modal opening) — components already handle that internally. Don't add extra hover-scale or idle animation to elements that aren't interactive or aren't mid-transition.",
+    "Focus rings are for accessibility only: ring-* and focus-visible:ring-ring indicate keyboard focus. Never add a colored ring as a pointer-hover decoration on cards, buttons, or images. The only hover glow allowed is the soft pointer-following primary light inside a card described in the glow rule.",
+    "Animated backgrounds are allowed, compulsory conditions: they use only theme tokens, sit behind content (absolute, -z-10 or under a readable overlay, pointer-events-none, aria-hidden), stay low contrast so text keeps its contrast, run at most one per viewport, and stop when the user prefers reduced motion (MotionConfig reducedMotion=\"user\" or a prefers-reduced-motion check). Never animate content itself, and never use flashing or fast loops.",
+    "Motion on interactive elements stays small: a hover lift of 1 to 4px or a press scale of about 0.97 is allowed on buttons, links and clickable cards. No scale-105 zooms, bouncing, floating icons or wobble. Idle animation is only for decorative backgrounds and live-status dots.",
     "No emoji used as icons or bullet markers in generated UI (✨, 🚀, 💡, ✅ as list bullets, feature markers, or button icons). Use lucide-react icons — the same icon set every neuctra-ui component already uses — passed via each component's icon props (iconBefore, iconAfter, icon, etc.).",
     "No 'icon in a colored circle badge' repeated on every single feature/stat/card by default (a bg-primary/10 rounded-full p-3 wrapper around every icon). Use it sparingly, only where the component's own design already calls for it — repeating the same decorative wrapper on every card in a grid is a generic-template tell.",
     "No arbitrary one-off spacing/sizing values (p-[13px], gap-[7px], w-[327px]) — use the Tailwind spacing scale (p-3, gap-2, w-80, etc.) so spacing stays consistent with the rest of the design system.",
     "Prefer information density and restraint over generic centered-hero-with-huge-padding layouts. Not every section needs max-w-7xl mx-auto text-center py-24 — match the density and layout the consumer's existing UI already uses.",
     "Make every layout fully responsive by default — mobile, tablet, and desktop (sm:/md:/lg:/xl: breakpoints), stacking to a single column and adjusting spacing/type-scale at small widths. Never ship a fixed-width or desktop-only layout and call it done.",
     "No em dashes (—), compulsory: never use an em dash in generated copy or UI text (headings, body copy, button labels, placeholder text). It's a recognizable AI-writing tell. Use a period, comma, colon, or restructure the sentence instead.",
-    "No over-effects: don't stack multiple decorative treatments on one element (e.g. a gradient plus a shadow plus a hover-scale plus a glow, all on the same button). Every visual effect that does appear should communicate a real state or interaction (hover, focus, loading, an entering toast) — never decoration for its own sake.",
+    "No over-effects: one decorative effect per element at most (a gradient OR a glow OR a hover lift), and the effects on one screen must share one color (the primary token). If an effect makes text harder to read or competes with the primary action, remove it.",
     "Don't layer a separate leading-* utility (leading-relaxed, leading-normal, leading-tight, ...) on top of a text-size class (text-sm, text-base, text-lg, text-xl, ...) — Tailwind's text-size utilities already ship a paired line-height, so adding leading-* alongside one is redundant and can fight the intended rhythm. Only reach for leading-* when no text-size class is already setting one, and even then never leading-none/leading-tight on paragraph-length text. Letter-spacing: use tracking-tight on headings text-3xl and larger; leave everything smaller at the default (tracking-normal); only use tracking-wide for short uppercase labels (badges, eyebrow text, nav labels), and never tracking-wide on paragraph-length text.",
     "Responsive, compulsory: every page must pass the Breakpoint Checklist in the design guide (360, 768, 1024, 1280, 1536px) with no horizontal scroll and touch targets of at least 44px.",
     "One focal point per viewport: a single dominant element (usually the primary CTA or one bg-primary block) that the eye lands on first. Never several competing bg-primary blocks on one screen.",
     "Use the fixed type scale from the design guide (Type Scale section). Never more than 4 text sizes on one screen, and keep paragraphs to max-w-prose or max-w-2xl.",
-    "The bar is modern, visually appealing UI achieved through typography hierarchy, whitespace, correct token usage, and responsive layout, not through gradients, shadows, blur, or glow effects standing in for actual design decisions.",
-    "Decent, restrained design, compulsory: build UI that is decent and intentional, never over-designed. When unsure whether an effect (shadow, gradient, blur, glow, animation, an extra color) is warranted on something you're authoring yourself: leave it out. A flat, token-colored, appropriately-radiused, unshadowed, responsive surface using only the semantic color tokens is the correct default for the overwhelming majority of neuctra-ui components — restraint is the default, not the exception."
+    "The bar is branded and restrained: a page may have a signature look (gradient headline words, a glow, an animated background in the brand color), but it must still read well with every effect removed. Hierarchy, spacing and typography carry the design; effects only add the brand.",
+    "Decent, restrained design, compulsory: build UI that is decent and intentional, never over-designed. When unsure whether an effect (gradient, glow, blur, animation) is warranted on something you're authoring yourself, leave it out; shadows on content surfaces and colors outside the theme are never warranted. A flat, token-colored, appropriately-radiused, unshadowed, responsive surface is the correct default for most neuctra-ui components. Brand effects are added on purpose, only where the effect rules above allow them."
   ],
   "tokens": [
     { "token": "primary", "className": "bg-primary / text-primary / border-primary", "pairsWith": "primary-foreground", "light": "#00c214", "dark": "#00c214", "usage": "Brand color: primary buttons, active states, links, focus accents." },