@impeccable/detect 2.0.3

package/LICENSE

@@ -0,0 +1,77 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Paul Bakaus
+Licensed Work:        Impeccable Detect 2.0.2
+                      The Licensed Work is (c) 2026 Paul Bakaus.
+Additional Use Grant: You may make use of the Licensed Work, provided that
+                      you do not use the Licensed Work for a Commercial
+                      Purpose.
+
+                      A "Commercial Purpose" means use of the Licensed Work
+                      that meets ALL of the following conditions:
+                      (a) the use is within or on behalf of an organization
+                          with more than five (5) individuals (employees,
+                          contractors, or agents) who access, interact with,
+                          or benefit from the Licensed Work; AND
+                      (b) that organization has annual recurring revenue
+                          exceeding one million US dollars ($1,000,000 USD).
+
+                      For the avoidance of doubt, the following are NOT
+                      Commercial Purposes regardless of organization size
+                      or revenue:
+                      - Personal, educational, or evaluation use
+                      - Use in open source projects licensed under an
+                        OSI-approved license
+                      - Non-commercial research
+
+Change Date:          2030-04-03
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed
+Work, please contact paul.bakaus@gmail.com.
+
+-----------------------------------------------------------------------------
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.

package/README.md

@@ -0,0 +1,64 @@
+# @impeccable/detect
+
+Deterministic UI anti-pattern detector. Catches AI slop (side-tab borders, purple gradients, bounce easing, dark glows) and general design quality issues (line length, cramped padding, skipped headings, and more) across HTML, CSS, JSX, TSX, Vue, and Svelte files.
+
+## Install
+
+```bash
+npm install @impeccable/detect
+```
+
+## CLI Usage
+
+```bash
+npx @impeccable/detect src/                   # scan a directory
+npx @impeccable/detect index.html             # scan an HTML file
+npx @impeccable/detect https://example.com    # scan a URL (Puppeteer)
+npx @impeccable/detect --fast --json .        # regex-only, JSON output
+```
+
+### Options
+
+- `--fast` -- Regex-only mode (skip jsdom, faster but misses linked stylesheets)
+- `--json` -- Output results as JSON (for CI/CD integration)
+- `--help` -- Show help
+
+### Detection modes
+
+| Input | Method | Best for |
+|---|---|---|
+| HTML files | jsdom + computed styles | Full accuracy, catches linked CSS |
+| Non-HTML files | Regex pattern matching | JSX, TSX, Vue, Svelte, CSS-in-JS |
+| URLs | Puppeteer rendering | Production sites, full browser fidelity |
+| `--fast` | Regex for all files | Speed, CI/CD pipelines |
+
+### Exit codes
+
+- `0` -- No anti-patterns found
+- `2` -- Anti-patterns detected
+
+### Framework detection
+
+When scanning a directory, the CLI detects framework configs (Next.js, Vite, SvelteKit, Nuxt, Astro, Angular, Remix) and suggests scanning the running dev server via URL for more accurate results.
+
+## Programmatic Usage
+
+```js
+import { detectText, detectHtml } from '@impeccable/detect';
+
+// Scan a string (regex-based)
+const findings = detectText(cssContent, 'styles.css');
+
+// Scan an HTML file (jsdom-based)
+const findings = await detectHtml('path/to/index.html');
+```
+
+## What it detects
+
+25 anti-patterns across borders, color, typography, layout, motion, and quality.
+
+## License
+
+[BSL 1.1](./LICENSE) -- free for individuals, open source projects, and small teams (5 or fewer people, or under $1M ARR). Commercial license required for larger organizations. Converts to Apache 2.0 on 2030-04-03.
+
+Part of the [Impeccable](https://impeccable.style) project.

package/bin/cli.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+/**
+ * @impeccable/detect CLI
+ *
+ * Usage:
+ *   npx @impeccable/detect [file-or-dir-or-url...]    # scan for anti-patterns
+ *   npx @impeccable/detect live [--port=PORT]          # start browser overlay server
+ *   npx @impeccable/detect --help
+ */
+
+import { detectCli, liveCli } from '../src/detect-antipatterns.mjs';
+
+const command = process.argv[2];
+
+if (command === 'live') {
+  // Shift args so liveCli sees --port etc. in the right positions
+  process.argv.splice(2, 1);
+  await liveCli();
+} else {
+  await detectCli();
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@impeccable/detect",
+  "version": "2.0.3",
+  "description": "Deterministic UI anti-pattern detector for design quality analysis",
+  "author": "Paul Bakaus",
+  "license": "BSL-1.1",
+  "type": "module",
+  "bin": {
+    "impeccable-detect": "bin/cli.js"
+  },
+  "main": "./src/detect-antipatterns.mjs",
+  "exports": {
+    ".": "./src/detect-antipatterns.mjs",
+    "./browser": "./src/detect-antipatterns-browser.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "jsdom": "^29.0.0"
+  },
+  "optionalDependencies": {
+    "puppeteer": "^24.39.1"
+  },
+  "scripts": {
+    "test": "bun test tests/detect-antipatterns.test.js && node --test tests/detect-antipatterns-fixtures.test.mjs",
+    "build:browser": "node scripts/build-browser-detector.js"
+  },
+  "keywords": [
+    "design",
+    "frontend",
+    "ux",
+    "anti-patterns",
+    "lint",
+    "accessibility",
+    "css",
+    "html",
+    "detection",
+    "ci-cd"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pbakaus/impeccable-detect.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}