@monoes/monodesign 1.2.25 → 2.24.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +15 -15
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -6,12 +6,12 @@
|
|
|
6
6
|
|
|
7
7
|
[](https://www.npmjs.com/package/@monoes/monodesign)
|
|
8
8
|
[](https://github.com/monoes/monomind/blob/main/LICENSE)
|
|
9
|
-
[](https://nodejs.org)
|
|
10
10
|
|
|
11
11
|
**Frontend design intelligence for AI agents** — OKLCH design tokens, a 51-rule AI-slop
|
|
12
12
|
antipattern detector, and the `/monodesign` agent skill for Claude Code and Gemini agy.
|
|
13
13
|
|
|
14
|
-
> Part of the [Monomind](https://github.com/monoes/monomind) ecosystem.
|
|
14
|
+
> Part of the [Monomind](https://github.com/monoes/monomind) ecosystem. v2.24.0 · Apache-2.0
|
|
15
15
|
|
|
16
16
|
---
|
|
17
17
|
|
|
@@ -36,7 +36,7 @@ npm install @monoes/monodesign
|
|
|
36
36
|
|
|
37
37
|
## Design Tokens
|
|
38
38
|
|
|
39
|
-
Source: [`src/tokens.ts`](
|
|
39
|
+
Source: [`src/tokens.ts`](src/tokens.ts) + [`src/tokens.css`](src/tokens.css)
|
|
40
40
|
|
|
41
41
|
All color tokens are in **OKLCH** — no hex colors in the token system.
|
|
42
42
|
|
|
@@ -63,7 +63,7 @@ All color tokens are in **OKLCH** — no hex colors in the token system.
|
|
|
63
63
|
color: var(--color-ink);
|
|
64
64
|
padding: var(--space-8);
|
|
65
65
|
border-radius: var(--radius-lg);
|
|
66
|
-
transition: transform var(--duration-
|
|
66
|
+
transition: transform var(--duration-base) var(--ease-out);
|
|
67
67
|
}
|
|
68
68
|
```
|
|
69
69
|
|
|
@@ -81,26 +81,26 @@ console.log(radius.lg); // 12px
|
|
|
81
81
|
|
|
82
82
|
## Antipattern Detection (51 Rules)
|
|
83
83
|
|
|
84
|
-
Source: [`cli/engine/registry/antipatterns.mjs`](
|
|
84
|
+
Source: [`cli/engine/registry/antipatterns.mjs`](cli/engine/registry/antipatterns.mjs) (entry point, re-exports from `antipatterns-slop.mjs`, `antipatterns-quality.mjs` and `antipatterns-provider.mjs`) — 51 entries.
|
|
85
85
|
|
|
86
86
|
### Rule Categories
|
|
87
87
|
|
|
88
|
-
**`slop`** (
|
|
88
|
+
**`slop`** (23 rules) — AI-generation tells that make UIs feel generic:
|
|
89
89
|
|
|
90
90
|
`side-tab`, `border-accent-on-rounded`, `overused-font`, `single-font`, `flat-type-hierarchy`, `gradient-text`, `ai-color-palette`, `cream-palette`, `nested-cards`, `monotonous-spacing`, `bounce-easing`, `dark-glow`, `icon-tile-stack`, `italic-serif-display`, `hero-eyebrow-chip`, `repeated-section-kickers`, `numbered-section-markers`, `em-dash-overuse`, `marketing-buzzword`, `aphoristic-cadence`, `oversized-h1`, `extreme-negative-tracking`, `broken-image`
|
|
91
91
|
|
|
92
|
-
**`quality`** (
|
|
92
|
+
**`quality`** (23 rules) — Accessibility and design principle violations:
|
|
93
93
|
|
|
94
94
|
`gray-on-color`, `low-contrast`, `layout-transition`, `line-length`, `cramped-padding`, `body-text-viewport-edge`, `tight-leading`, `skipped-heading`, `justified-text`, `tiny-text`, `all-caps-body`, `wide-tracking`, `text-overflow`, `clipped-overflow-container`, `design-system-font`, `design-system-color`, `design-system-radius`, `design-system-font-size`, `missing-focus-visible`, `small-touch-target`, `hover-only-affordance`, `image-missing-dimensions`, `dark-scheme-contrast-blindspot`
|
|
95
95
|
|
|
96
|
-
**Provider-gated** (
|
|
96
|
+
**Provider-gated** (5 advisory rules, opt-in via `--gpt`/`--gemini`): `gpt-thin-border-wide-shadow`, `repeating-stripes-gradient`, `codex-grid-background`, `theater-slop-phrase`, `image-hover-transform`
|
|
97
97
|
|
|
98
98
|
### Detection Engines
|
|
99
99
|
|
|
100
100
|
| Engine | Method | Optional dep |
|
|
101
101
|
|---|---|---|
|
|
102
102
|
| `regex` | Source text / CSS-in-JS scan | none |
|
|
103
|
-
| `static-html` |
|
|
103
|
+
| `static-html` | htmlparser2 static DOM parse | none |
|
|
104
104
|
| `browser` | Live-page scan | `@monoes/monobrowse` (optional) with an installed Chrome, Chromium or Edge, else a `puppeteer` you install yourself |
|
|
105
105
|
| `visual` | Visual contrast analysis | `@monoes/monobrowse` (optional) |
|
|
106
106
|
|
|
@@ -112,7 +112,7 @@ Source: [`cli/engine/registry/antipatterns.mjs`](packages/@monoes/monodesign/cli
|
|
|
112
112
|
|
|
113
113
|
## OKLCH Palette Seed Library
|
|
114
114
|
|
|
115
|
-
Source: [`packages/@monomind/cli/src/commands/design-palette.ts
|
|
115
|
+
Source: `SEEDS` in [`packages/@monomind/cli/src/commands/design-palette.ts`](../../@monomind/cli/src/commands/design-palette.ts), with the seed data in [`design-palette-seeds-1.ts`](../../@monomind/cli/src/commands/design-palette-seeds-1.ts) and [`design-palette-seeds-2.ts`](../../@monomind/cli/src/commands/design-palette-seeds-2.ts)
|
|
116
116
|
|
|
117
117
|
- **129 hand-curated seeds** spanning the full hue wheel (0°–360°)
|
|
118
118
|
- Each seed: `{ id, oklch: [L, C, H], mood: string, strategy: string }`
|
|
@@ -123,11 +123,11 @@ Source: [`packages/@monomind/cli/src/commands/design-palette.ts#SEEDS`](packages
|
|
|
123
123
|
|
|
124
124
|
## The `/monodesign` Agent Skill
|
|
125
125
|
|
|
126
|
-
Source: [`skill/SKILL.src.md`](
|
|
126
|
+
Source: [`skill/SKILL.src.md`](skill/SKILL.src.md) · v2.0.0 · Apache-2.0
|
|
127
127
|
|
|
128
128
|
Triggers: `/monodesign`, `/design`, `/frontend-design`, plus 40+ natural-language triggers.
|
|
129
129
|
|
|
130
|
-
###
|
|
130
|
+
### 28 Skill Commands
|
|
131
131
|
|
|
132
132
|
| Category | Commands |
|
|
133
133
|
|---|---|
|
|
@@ -171,14 +171,14 @@ Manage via `monomind design ignores` or `/monodesign hooks <on|off|status|ignore
|
|
|
171
171
|
|---|---|
|
|
172
172
|
| `monomind design detect [-t <path>] [--json]` | Scan HTML/CSS for antipatterns |
|
|
173
173
|
| `monomind design fix [-t <path>] [--dry-run] [--json] [--rule <ids>]` | Auto-fix with safe codemods |
|
|
174
|
-
| `monomind design ignores <list\|add-rule\|add-file\|add-value\|remove-rule>` | Manage detector ignores |
|
|
174
|
+
| `monomind design ignores <list\|add-rule\|add-file\|add-value\|remove-rule\|remove-file\|remove-value\|clear>` | Manage detector ignores |
|
|
175
175
|
| `monomind design palette [--id <id>] [--from <key>] [--random] [--json]` | Pick OKLCH brand seed |
|
|
176
176
|
|
|
177
177
|
---
|
|
178
178
|
|
|
179
179
|
## Design System Consistency
|
|
180
180
|
|
|
181
|
-
Source: [`cli/engine/design-system.mjs`](
|
|
181
|
+
Source: [`cli/engine/design-system.mjs`](cli/engine/design-system.mjs) (entry point, split across `design-system-parse.mjs` and `design-system-checks.mjs`)
|
|
182
182
|
|
|
183
183
|
Parses `DESIGN.md` / `.monodesign/design.json` to enforce consistency rules (`design-system-font`, `design-system-color`, `design-system-radius`, `design-system-font-size`). The skill writes `DESIGN.md`; the detector reads it for drift detection.
|
|
184
184
|
|
|
@@ -190,7 +190,7 @@ Search order: `DESIGN.md` → `.agents/context/DESIGN.md` → `docs/DESIGN.md`.
|
|
|
190
190
|
|
|
191
191
|
```json
|
|
192
192
|
{
|
|
193
|
-
".": "./
|
|
193
|
+
".": "./dist/index.js",
|
|
194
194
|
"./tokens": "./src/tokens.css",
|
|
195
195
|
"./engine": "./cli/engine/detect-antipatterns.mjs",
|
|
196
196
|
"./engine/browser": "./cli/engine/detect-antipatterns-browser.js"
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@monoes/monodesign",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "2.24.2",
|
|
4
4
|
"description": "Frontend design intelligence for AI agents — design tokens, antipattern detection, and the monodesign skill",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
"NOTICE.md"
|
|
23
23
|
],
|
|
24
24
|
"engines": {
|
|
25
|
-
"node": ">=22.
|
|
25
|
+
"node": ">=22.22.0"
|
|
26
26
|
},
|
|
27
27
|
"keywords": [
|
|
28
28
|
"design-system",
|
|
@@ -41,13 +41,13 @@
|
|
|
41
41
|
"domutils": "^4.0.2",
|
|
42
42
|
"fflate": "^0.8.3",
|
|
43
43
|
"htmlparser2": "^12.0.0",
|
|
44
|
-
"marked": "^18.
|
|
44
|
+
"marked": "^18.2.0"
|
|
45
45
|
},
|
|
46
46
|
"optionalDependencies": {
|
|
47
|
-
"@monoes/monobrowse": "
|
|
47
|
+
"@monoes/monobrowse": "2.24.6"
|
|
48
48
|
},
|
|
49
49
|
"devDependencies": {
|
|
50
|
-
"puppeteer": "^25.
|
|
50
|
+
"puppeteer": "^25.17.0"
|
|
51
51
|
},
|
|
52
52
|
"scripts": {
|
|
53
53
|
"prebuild": "node ../../../scripts/build-fs.mjs clean dist tsconfig.tsbuildinfo",
|