impeccable 2.0.4 → 2.0.7

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 CHANGED
@@ -29,27 +29,27 @@ npx impeccable detect --fast src/
29
29
 
30
30
  ## What It Detects
31
31
 
32
- **AI Slop Tells** -- patterns that scream "AI generated this":
32
+ **AI Slop Tells**: patterns that scream "AI generated this":
33
33
  - Side-tab accent borders, gradient text on headings
34
34
  - Purple/violet gradients and cyan-on-dark palettes
35
35
  - Dark mode with glowing accents, border + border-radius clashes
36
36
 
37
- **Typography Issues** -- overused fonts (Inter, Roboto), flat type hierarchy, single font families
37
+ **Typography Issues**: overused fonts (Inter, Roboto), flat type hierarchy, single font families
38
38
 
39
- **Color & Contrast** -- WCAG AA violations, gray text on colored backgrounds, pure black/white
39
+ **Color & Contrast**: WCAG AA violations, gray text on colored backgrounds, pure black/white
40
40
 
41
- **Layout & Composition** -- nested cards, monotonous spacing, everything-centered layouts
41
+ **Layout & Composition**: nested cards, monotonous spacing, everything-centered layouts
42
42
 
43
- **Motion** -- bounce/elastic easing, layout property transitions
43
+ **Motion**: bounce/elastic easing, layout property transitions
44
44
 
45
- **Quality** -- tiny body text, cramped padding, long line lengths, small touch targets
45
+ **Quality**: tiny body text, cramped padding, long line lengths, small touch targets
46
46
 
47
47
  25 detections in total. See the full list at [impeccable.style](https://impeccable.style).
48
48
 
49
49
  ## Exit Codes
50
50
 
51
- - `0` -- no issues found
52
- - `2` -- anti-patterns detected
51
+ - `0`: no issues found
52
+ - `2`: anti-patterns detected
53
53
 
54
54
  ## Options
55
55
 
@@ -69,8 +69,8 @@ impeccable detect [options] [file-or-dir-or-url...]
69
69
 
70
70
  ## Part of Impeccable
71
71
 
72
- This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes 20 steering commands for Claude, Cursor, Gemini, Codex, and more.
72
+ This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes 22 steering commands for Claude, Cursor, Gemini, Codex, and more.
73
73
 
74
74
  ## License
75
75
 
76
- See [LICENSE](https://github.com/pbakaus/impeccable/blob/main/LICENSE) file.
76
+ [Apache 2.0](https://github.com/pbakaus/impeccable/blob/main/LICENSE)
package/README.npm.md CHANGED
@@ -29,27 +29,27 @@ npx impeccable detect --fast src/
29
29
 
30
30
  ## What It Detects
31
31
 
32
- **AI Slop Tells** -- patterns that scream "AI generated this":
32
+ **AI Slop Tells**: patterns that scream "AI generated this":
33
33
  - Side-tab accent borders, gradient text on headings
34
34
  - Purple/violet gradients and cyan-on-dark palettes
35
35
  - Dark mode with glowing accents, border + border-radius clashes
36
36
 
37
- **Typography Issues** -- overused fonts (Inter, Roboto), flat type hierarchy, single font families
37
+ **Typography Issues**: overused fonts (Inter, Roboto), flat type hierarchy, single font families
38
38
 
39
- **Color & Contrast** -- WCAG AA violations, gray text on colored backgrounds, pure black/white
39
+ **Color & Contrast**: WCAG AA violations, gray text on colored backgrounds, pure black/white
40
40
 
41
- **Layout & Composition** -- nested cards, monotonous spacing, everything-centered layouts
41
+ **Layout & Composition**: nested cards, monotonous spacing, everything-centered layouts
42
42
 
43
- **Motion** -- bounce/elastic easing, layout property transitions
43
+ **Motion**: bounce/elastic easing, layout property transitions
44
44
 
45
- **Quality** -- tiny body text, cramped padding, long line lengths, small touch targets
45
+ **Quality**: tiny body text, cramped padding, long line lengths, small touch targets
46
46
 
47
47
  25 detections in total. See the full list at [impeccable.style](https://impeccable.style).
48
48
 
49
49
  ## Exit Codes
50
50
 
51
- - `0` -- no issues found
52
- - `2` -- anti-patterns detected
51
+ - `0`: no issues found
52
+ - `2`: anti-patterns detected
53
53
 
54
54
  ## Options
55
55
 
@@ -69,8 +69,8 @@ impeccable detect [options] [file-or-dir-or-url...]
69
69
 
70
70
  ## Part of Impeccable
71
71
 
72
- This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes 20 steering commands for Claude, Cursor, Gemini, Codex, and more.
72
+ This CLI is part of [Impeccable](https://impeccable.style), a cross-provider design skill pack for AI-powered development tools. The full suite includes 22 steering commands for Claude, Cursor, Gemini, Codex, and more.
73
73
 
74
74
  ## License
75
75
 
76
- See [LICENSE](https://github.com/pbakaus/impeccable/blob/main/LICENSE) file.
76
+ [Apache 2.0](https://github.com/pbakaus/impeccable/blob/main/LICENSE)
@@ -1,6 +1,6 @@
1
1
  # Impeccable
2
2
 
3
- The vocabulary you didn't know you needed. 1 skill, 22 commands, and curated anti-patterns for impeccable frontend design.
3
+ The vocabulary you didn't know you needed. 1 skill, 21 commands, and curated anti-patterns for impeccable frontend design.
4
4
 
5
5
  > **Quick start:** Visit [impeccable.style](https://impeccable.style) to download ready-to-use bundles.
6
6
 
@@ -12,7 +12,7 @@ Every LLM learned from the same generic templates. Without guidance, you get the
12
12
 
13
13
  Impeccable fights that bias with:
14
14
  - **An expanded skill** with 7 domain-specific reference files ([view source](source/skills/impeccable/))
15
- - **22 steering commands** to audit, review, polish, distill, animate, and more
15
+ - **21 steering commands** to audit, review, polish, distill, animate, and more
16
16
  - **Curated anti-patterns** that explicitly tell the AI what NOT to do
17
17
 
18
18
  ## What's Included
@@ -31,7 +31,7 @@ A comprehensive design skill with 7 domain-specific references ([view skill](sou
31
31
  | [responsive-design](source/skills/impeccable/reference/responsive-design.md) | Mobile-first, fluid design, container queries |
32
32
  | [ux-writing](source/skills/impeccable/reference/ux-writing.md) | Button labels, error messages, empty states |
33
33
 
34
- ### 22 Commands
34
+ ### 21 Commands
35
35
 
36
36
  | Command | What it does |
37
37
  |---------|--------------|
@@ -5,6 +5,8 @@
5
5
  *
6
6
  * Usage:
7
7
  * npx impeccable detect [file-or-dir-or-url...]
8
+ * npx impeccable live [--port=PORT]
9
+ * npx impeccable live stop
8
10
  * npx impeccable skills help|install|update
9
11
  * npx impeccable --help
10
12
  */
@@ -23,6 +25,7 @@ if (!command || command === '--help' || command === '-h') {
23
25
  Commands:
24
26
  detect [file-or-dir-or-url...] Scan for UI anti-patterns and design quality issues
25
27
  live [--port=PORT] Start browser detection overlay server
28
+ live stop Stop a running live server
26
29
  skills help List all available skills and commands
27
30
  skills install Install impeccable skills into your project
28
31
  skills update Update skills to the latest version
@@ -43,17 +46,18 @@ if (command === '--version' || command === '-v') {
43
46
 
44
47
  if (command === 'detect') {
45
48
  process.argv = [process.argv[0], process.argv[1], ...args.slice(1)];
46
- const { detectCli } = await import('@impeccable/detect');
49
+ const { detectCli } = await import('../src/detect-antipatterns.mjs');
47
50
  await detectCli();
48
51
  } else if (command === 'live') {
49
52
  process.argv = [process.argv[0], process.argv[1], ...args.slice(1)];
50
- const { liveCli } = await import('@impeccable/detect');
53
+ const { liveCli } = await import('../src/detect-antipatterns.mjs');
51
54
  await liveCli();
52
55
  } else if (command === 'skills') {
53
56
  const { run } = await import('./commands/skills.mjs');
54
57
  await run(args.slice(1));
55
58
  } else {
56
- console.error(`Unknown command: ${command}`);
57
- console.error(`Run 'impeccable --help' for available commands.`);
58
- process.exit(1);
59
+ // Default: treat as detect arguments (allow `npx impeccable src/` shorthand)
60
+ process.argv = [process.argv[0], process.argv[1], ...args];
61
+ const { detectCli } = await import('../src/detect-antipatterns.mjs');
62
+ await detectCli();
59
63
  }
package/package.json CHANGED
@@ -1,29 +1,21 @@
1
1
  {
2
2
  "name": "impeccable",
3
- "version": "2.0.4",
3
+ "version": "2.0.7",
4
4
  "author": "Paul Bakaus",
5
- "bin": {
6
- "impeccable": "./bin/impeccable"
7
- },
8
- "files": [
9
- "bin/",
10
- "lib/download-providers.js",
11
- "LICENSE"
12
- ],
13
- "dependencies": {
14
- "@impeccable/detect": "^2.0.4"
15
- },
16
- "description": "Detect UI anti-patterns and design quality issues from the command line",
5
+ "description": "Design skills, commands, and anti-pattern detection for AI coding agents",
17
6
  "keywords": [
18
7
  "design",
19
8
  "frontend",
20
9
  "ux",
10
+ "skills",
11
+ "ai",
21
12
  "anti-patterns",
22
13
  "lint",
23
14
  "accessibility",
24
15
  "css",
25
16
  "html",
26
- "cli"
17
+ "detection",
18
+ "ci-cd"
27
19
  ],
28
20
  "license": "Apache-2.0",
29
21
  "homepage": "https://impeccable.style",
@@ -34,20 +26,42 @@
34
26
  "engines": {
35
27
  "node": ">=18"
36
28
  },
29
+ "type": "module",
30
+ "bin": {
31
+ "impeccable": "bin/cli.js"
32
+ },
33
+ "main": "./src/detect-antipatterns.mjs",
34
+ "exports": {
35
+ ".": "./src/detect-antipatterns.mjs",
36
+ "./browser": "./src/detect-antipatterns-browser.js"
37
+ },
38
+ "files": [
39
+ "bin/",
40
+ "src/",
41
+ "LICENSE"
42
+ ],
37
43
  "scripts": {
38
- "prepublishOnly": "cp README.md README.bak.md && cp README.npm.md README.md",
39
- "postpublish": "mv README.bak.md README.md",
40
44
  "build": "bun run scripts/build.js",
45
+ "build:browser": "node scripts/build-browser-detector.js",
46
+ "build:extension": "node scripts/build-extension.js",
41
47
  "clean": "rm -rf dist build",
42
48
  "rebuild": "bun run clean && bun run build",
43
49
  "dev": "bun run server/index.js",
44
50
  "preview": "bun run build && wrangler pages dev",
45
51
  "deploy": "bun run build && wrangler pages deploy build/",
46
- "test": "bun test tests/build.test.js",
52
+ "test": "bun test tests/build.test.js tests/detect-antipatterns.test.js && node --test tests/detect-antipatterns-fixtures.test.mjs && node --test tests/detect-antipatterns-browser.test.mjs",
53
+ "prepack": "cp README.md README.repo.md && cp README.npm.md README.md",
54
+ "postpack": "cp README.repo.md README.md && rm README.repo.md",
47
55
  "screenshot": "bun run scripts/screenshot-antipatterns.js",
48
56
  "og-image": "bun run scripts/generate-og-image.js"
49
57
  },
50
- "type": "module",
58
+ "dependencies": {
59
+ "jsdom": "^29.0.0",
60
+ "marked": "^16.1.0"
61
+ },
62
+ "optionalDependencies": {
63
+ "puppeteer": "^24.39.1"
64
+ },
51
65
  "devDependencies": {
52
66
  "archiver": "^7.0.1",
53
67
  "motion": "^12.38.0",