@loworbitstudio/visor 0.7.0 → 0.9.0

package/README.md

@@ -21,6 +21,8 @@ npx visor init
 | `visor doctor` | Check your Visor installation health |
 | `visor diff` | See what's changed since you last updated |
 | `visor suggest --for <context>` | Get component suggestions for a use case |
+| `visor migrate token-substitution [path]` | Apply the §3.1 V7-primitive → Visor-semantic substitution table (dry-run by default; use `--apply` to commit) |
+| `visor check design <path>` | Scan frontend code for Borealis design anti-patterns (deterministic, no LLM) |
 
 ## Target platforms
 
@@ -40,6 +42,103 @@ preserving your existing deps and comments, and runs `flutter pub get` via
 When the Flutter CLI can't be found, `add` finishes writing files and warns
 so you can run `flutter pub get` yourself.
 
+## visor check design
+
+Deterministic static analysis for Borealis design anti-patterns. No LLM required. Scans `.tsx`, `.jsx`, `.ts`, `.js`, `.css`, and `.module.css` files.
+
+```bash
+# Human-readable terminal output
+npx visor check design ./src
+
+# JSON output for programmatic consumers (e.g. /lo-audit-design)
+npx visor check design ./src --json
+
+# Errors only (skip warnings)
+npx visor check design ./src --errors-only
+
+# Advisory mode — report without failing CI
+npx visor check design ./src --no-fail
+```
+
+### Output schema (--json)
+
+```json
+{
+  "success": true,
+  "errors": [
+    {
+      "file": "src/components/Button.tsx",
+      "line": 12,
+      "rule": "hardcoded-hex",
+      "severity": "error",
+      "message": "Hardcoded hex color \"#1a2b3c\" bypasses the Borealis token system.",
+      "fix": "Replace with the appropriate semantic token: var(--color-surface), var(--color-text-primary), etc."
+    }
+  ],
+  "warnings": [],
+  "summary": {
+    "errorCount": 1,
+    "warningCount": 0,
+    "filesScanned": 14
+  }
+}
+```
+
+### Exit codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | No violations (or `--no-fail` mode) |
+| `1` | One or more error-severity findings |
+
+### Rules
+
+#### Error rules — Borealis non-negotiables
+
+| Rule | What it catches | Fix |
+|------|-----------------|-----|
+| `tier-1-token-direct-usage` | Direct use of `--primitive-*`, `--raw-*`, `--palette-*` tokens in component code | Replace with the equivalent Tier-2 semantic token |
+| `hardcoded-hex` | Raw hex color literals (`#fff`, `#1a2b3c`) in source files | Use `var(--color-surface)`, `var(--color-text-primary)`, etc. |
+| `hardcoded-px` | Hardcoded pixel values in spacing/sizing properties (`margin`, `padding`, `width`, `height`, `gap`) | Use `var(--space-1)`, `var(--space-4)`, etc. |
+| `missing-dark-mode-block` | CSS files without a dark mode block | Add `@media (prefers-color-scheme: dark) { … }` or `[data-theme="dark"] { … }` |
+| `missing-hover-transition` | CSS files with `:hover` but no `transition` property | Add `transition: color 150ms ease, background 150ms ease` to base styles |
+| `div-as-input` | `<div onClick>` without `role=` — div masquerading as interactive element | Use `<button>` or add `role="button"` + `tabIndex={0}` |
+| `setstate-hover` | `useState` used to track hover state (or `onMouseEnter`/`onMouseLeave` with setState) | Delete the hover state variable; use CSS `:hover` instead |
+| `missing-aria-pressed` | Toggle buttons with active/selected/open props but no `aria-pressed` | Add `aria-pressed={isActive}` to the button element |
+
+#### Warn rules — general anti-patterns
+
+| Rule | What it catches | Fix |
+|------|-----------------|-----|
+| `banned-fonts` | Inter, Roboto, Arial, system-ui font references | Use `var(--font-sans)` or the project's designated font token |
+| `purple-gradient-on-white` | Purple gradient patterns — generic SaaS visual cliché | Replace with brand token gradients |
+| `pure-black-untinted` | `#000`, `#000000`, `black` keyword — flat pure black | Use `var(--color-text-primary)` or a near-black tinted token |
+| `bounce-easing` | Overshoot cubic-bezier values or `bounce` easing keyword | Use `ease`, `ease-out`, or `cubic-bezier(0.4, 0, 0.2, 1)` |
+| `sub-44px-touch-target` | Interactive elements with explicit dimensions below 44px | Minimum 44×44px touch target per WCAG 2.5.5 |
+| `line-length-over-75ch` | `max-width` over 75ch on text containers | Cap at 65–75ch for optimal reading comfort |
+| `gradient-text` | `background-clip: text` / `-webkit-text-fill-color: transparent` gradient text | Use a solid semantic text color token; reserve for hero headings only |
+| `excessive-card-nesting` | Card/Panel/Box components nested 3+ levels deep | Flatten layout; use spacing, dividers, or type scale for hierarchy |
+
+### Per-project rule toggles
+
+Create a `.visorrc.json` in the root of the directory being scanned:
+
+```json
+{
+  "disabledRules": ["gradient-text", "bounce-easing"]
+}
+```
+
+Rules in `disabledRules` are skipped entirely — useful when a project intentionally deviates from a specific rule.
+
+### CI integration
+
+```yaml
+# GitHub Actions example
+- name: Design anti-pattern check
+  run: npx visor check design ./src --json
+```
+
 ## Documentation
 
 Full docs at [visor.loworbit.studio](https://visor.loworbit.studio).

package/dist/CHANGELOG.json

@@ -1,6 +1,6 @@
 {
   "version": "0.4.0",
-  "generated_at": "2026-05-01T00:42:09.768Z",
+  "generated_at": "2026-05-12T02:11:40.680Z",
   "components": {
     "accessibility-specimen": {
       "changeType": "current",
@@ -44,6 +44,12 @@
       "breakingChange": false,
       "migrationNote": null
     },
+    "bento-grid": {
+      "changeType": "current",
+      "files": [],
+      "breakingChange": false,
+      "migrationNote": null
+    },
     "breadcrumb": {
       "changeType": "current",
       "files": [],
@@ -92,6 +98,12 @@
       "breakingChange": false,
       "migrationNote": null
     },
+    "chip": {
+      "changeType": "current",
+      "files": [],
+      "breakingChange": false,
+      "migrationNote": null
+    },
     "code-block": {
       "changeType": "current",
       "files": [],
@@ -272,6 +284,12 @@
       "breakingChange": false,
       "migrationNote": null
     },
+    "marquee": {
+      "changeType": "current",
+      "files": [],
+      "breakingChange": false,
+      "migrationNote": null
+    },
     "menubar": {
       "changeType": "current",
       "files": [],
@@ -284,6 +302,12 @@
       "breakingChange": false,
       "migrationNote": null
     },
+    "name-roster": {
+      "changeType": "current",
+      "files": [],
+      "breakingChange": false,
+      "migrationNote": null
+    },
     "navbar": {
       "changeType": "current",
       "files": [],
@@ -422,6 +446,18 @@
       "breakingChange": false,
       "migrationNote": null
     },
+    "stat-hero": {
+      "changeType": "current",
+      "files": [],
+      "breakingChange": false,
+      "migrationNote": null
+    },
+    "station-spectrum": {
+      "changeType": "current",
+      "files": [],
+      "breakingChange": false,
+      "migrationNote": null
+    },
     "status-badge": {
       "changeType": "current",
       "files": [],