tailwint 1.0.0 → 1.0.2

package/README.md

@@ -1,8 +1,37 @@
-# tailwint
+<p align="center">
+  <img src="assets/header.svg" alt="tailwint">
+</p>
 
-Tailwind CSS linter for CI. Drives the official `@tailwindcss/language-server` to catch class errors and auto-fix them — the same diagnostics VS Code shows, but from the command line.
+<p align="center">
+  <a href="https://www.npmjs.com/package/tailwint"><img src="https://img.shields.io/npm/v/tailwint?color=0ea5e9&label=npm" alt="npm version"></a>
+  <a href="https://github.com/peterwangsc/tailwint/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/tailwint?color=a78bfa" alt="license"></a>
+  <a href="https://www.npmjs.com/package/tailwint"><img src="https://img.shields.io/npm/dm/tailwint?color=f472b6" alt="downloads"></a>
+</p>
 
-Works with Tailwind CSS v4.
+---
+
+The same diagnostics VS Code shows — but from the command line. Catches class conflicts, suggests canonical rewrites, and auto-fixes everything. Built on the official `@tailwindcss/language-server`.
+
+**Works with Tailwind CSS v4.**
+
+## What it catches
+
+tailwint detects two categories of issues:
+
+**⚡ Conflicts** — classes that apply the same CSS properties, where the last one wins and the rest are dead code:
+
+```
+⚡ 3:21  conflict  'w-full' applies the same CSS properties as 'w-auto'
+⚡ 3:28  conflict  'w-auto' applies the same CSS properties as 'w-full'
+```
+
+**○ Canonical** — classes that can be written in a shorter or more idiomatic form:
+
+```
+○ 3:21 canonical The class `flex-shrink-0` can be written as `shrink-0`
+○ 3:35 canonical The class `z-[1]` can be written as `z-1`
+○ 3:41 canonical The class `min-w-[200px]` can be written as `min-w-50`
+```
 
 ## Install
 
@@ -13,18 +42,82 @@ npm install -D tailwint @tailwindcss/language-server
 ## Usage
 
 ```bash
-# Check default file types (tsx, jsx, html, vue, svelte)
+# Scan default file types (tsx, jsx, html, vue, svelte, css)
 npx tailwint
 
-# Check specific files
+# Scan specific files
 npx tailwint "src/**/*.tsx"
 
-# Auto-fix issues
+# Auto-fix all issues
 npx tailwint --fix
 
 # Fix specific files
 npx tailwint --fix "app/**/*.tsx"
+
+# Verbose LSP logging
+DEBUG=1 npx tailwint
+```
+
+## Example output
+
 ```
+  ~≈∼〜~≈∼〜~≈ tailwint ∼〜~≈∼〜~≈∼~
+    tailwind css linter // powered by the official lsp
+
+  ✔ language server ready ~≈∼〜~≈∼〜~≈∼〜
+  ✔ 42 files analyzed ~≈∼〜~≈∼〜~≈∼〜~≈
+
+  42 files scanned // 8 conflicts │ 12 canonical
+
+  ┌ components/Card.tsx (3)
+    ⚡ 5:21  conflict  'w-full' applies the same CSS properties as 'w-auto'
+    ○ 5:35 canonical The class `flex-shrink-0` can be written as `shrink-0`
+    ○ 5:49 canonical The class `z-[1]` can be written as `z-1`
+  └~≈∼
+
+  ≈∼〜~≈  ✘ FAIL  20 issues in 3 files 2.1s ≈∼〜~≈
+  run with --fix to auto-fix
+```
+
+With `--fix`:
+
+```
+  ⚙ FIX  conflicts first, then canonical
+
+  ✔ ┃━━━━━━━━━━━━━━━━━━┃ Card.tsx 3 fixed
+  ✔ ┃━━━━━━━━━━━━━━━━━━┃ Header.tsx 12 fixed
+  ✔ ┃━━━━━━━━━━━━━━━━━━┃ Sidebar.tsx 5 fixed
+
+  ≈∼〜~≈  ✔ FIXED  20 of 20 issues across 3 files 3.4s ≈∼〜~≈
+```
+
+## Supported file types
+
+| Extension | Language ID | Notes |
+|-----------|-----------|-------|
+| `.tsx` | typescriptreact | React / Next.js components |
+| `.jsx` | javascriptreact | React components |
+| `.html` | html | Static HTML files |
+| `.vue` | html | Vue single-file components |
+| `.svelte` | html | Svelte components |
+| `.css` | css | `@apply` directives and Tailwind at-rules |
+
+## Tailwind v4 support
+
+tailwint fully supports Tailwind CSS v4 features:
+
+- **Opacity shorthand** — `bg-red-500/50`, `text-blue-500/75`
+- **`size-*` utility** — `size-10`, `size-full`
+- **Container queries** — `@container`, `@lg:flex`, `@md:grid`
+- **`has-*` / `not-*` variants** — `has-checked:bg-blue-500`, `not-disabled:opacity-100`
+- **`aria-*` variants** — `aria-expanded:bg-blue-500`, `aria-disabled:opacity-50`
+- **`data-*` variants** — `data-[state=open]:bg-blue-500`
+- **`supports-*` variants** — `supports-[display:grid]:grid`
+- **`forced-colors` variant** — `forced-colors:bg-[ButtonFace]`
+- **Logical properties** — `ms-4`, `me-4`, `ps-4`, `pe-4`
+- **Text wrap utilities** — `text-balance`, `text-pretty`, `text-nowrap`
+- **Named groups/peers** — `group/sidebar`, `group-hover/sidebar:bg-blue-500`
+- **CSS-first config** — `@import "tailwindcss"` with `@theme` directive
 
 ## Programmatic API
 
@@ -38,9 +131,54 @@ const exitCode = await run({
 });
 ```
 
+### Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `patterns` | `string[]` | `["**/*.{tsx,jsx,html,vue,svelte,css}"]` | Glob patterns for files to scan |
+| `fix` | `boolean` | `false` | Auto-fix issues using LSP code actions |
+| `cwd` | `string` | `process.cwd()` | Working directory for glob resolution and LSP root |
+
+### Exports
+
+| Export | Description |
+|--------|-------------|
+| `run(options?)` | Run the linter, returns exit code |
+| `applyEdits(content, edits)` | Apply LSP text edits to a string |
+| `TextEdit` | TypeScript type for LSP text edits |
+
+## CI integration
+
+tailwint exits with meaningful codes for CI pipelines:
+
+| Exit code | Meaning |
+|-----------|---------|
+| `0` | No issues found, or all issues fixed with `--fix` |
+| `1` | Issues found (without `--fix`) |
+| `2` | Fatal error (language server not found, crash) |
+
+### GitHub Actions
+
+```yaml
+- name: Lint Tailwind classes
+  run: npx tailwint
+```
+
+### Pre-commit hook
+
+```bash
+npx tailwint --fix && git add -u
+```
+
 ## How it works
 
-tailwint spawns the official Tailwind CSS language server over stdio, opens your files via LSP, and collects the published diagnostics. In `--fix` mode it requests quickfix code actions and applies the resulting edits.
+1. **Boot** — spawns `@tailwindcss/language-server` over stdio
+2. **Open** — sends all matched files to the server via `textDocument/didOpen`
+3. **Analyze** — waits for `textDocument/publishDiagnostics` notifications (event-driven, no polling)
+4. **Report** — collects diagnostics, categorizes as conflicts or canonical
+5. **Fix** *(if `--fix`)* — requests `textDocument/codeAction` quickfixes and applies edits in a loop until no diagnostics remain
+
+The fix loop is unbounded — it keeps applying edits until the file stabilizes. A single pass may not resolve everything (e.g., fixing a conflict can reveal a canonical issue underneath), so the loop continues as long as edits produce changes.
 
 ## Requirements
 

package/bin/tailwint.js

@@ -1,2 +1,16 @@
 #!/usr/bin/env node
-import "../dist/index.js";
+import { run } from "../dist/index.js";
+import { c, isTTY } from "../dist/ui.js";
+
+const args = process.argv.slice(2);
+const fix = args.includes("--fix");
+const patterns = args.filter((a) => a !== "--fix");
+
+run({ fix, patterns: patterns.length > 0 ? patterns : undefined }).then(
+  (code) => process.exit(code),
+  (err) => {
+    console.error(`\n  ${c.red}${c.bold}tailwint crashed:${c.reset} ${err}`);
+    process.stderr.write(isTTY ? "\x1b[?25h" : "");
+    process.exit(2);
+  },
+);

package/dist/index.js

@@ -13,10 +13,10 @@ import { readFileSync } from "fs";
 import { glob } from "glob";
 import { startServer, send, notify, shutdown, fileUri, langId, diagnosticsReceived, waitForProjectReady, waitForDiagnosticCount, resetState, } from "./lsp.js";
 import { fixFile } from "./edits.js";
-import { c, isTTY, setTitle, windTrail, braille, windWave, dots, tick, advanceTick, startSpinner, progressBar, banner, fileBadge, diagLine, rainbowText, celebrationAnimation, } from "./ui.js";
+import { c, setTitle, windTrail, braille, windWave, dots, tick, advanceTick, startSpinner, progressBar, banner, fileBadge, diagLine, rainbowText, celebrationAnimation, } from "./ui.js";
 // Re-export for tests
 export { applyEdits } from "./edits.js";
-const DEFAULT_PATTERNS = ["**/*.{tsx,jsx,html,vue,svelte}"];
+const DEFAULT_PATTERNS = ["**/*.{tsx,jsx,html,vue,svelte,css}"];
 export async function run(options = {}) {
     resetState();
     const t0 = Date.now();
@@ -194,17 +194,3 @@ export async function run(options = {}) {
     await shutdown();
     return 1;
 }
-// CLI entry point — only runs when executed directly, not when imported
-const isCLI = process.argv[1] != null &&
-    (import.meta.url === new URL(process.argv[1], "file:").href ||
-        process.argv[1].endsWith("/tailwint.js"));
-if (isCLI) {
-    const args = process.argv.slice(2);
-    const fix = args.includes("--fix");
-    const patterns = args.filter((a) => a !== "--fix");
-    run({ fix, patterns: patterns.length > 0 ? patterns : undefined }).then((code) => process.exit(code), (err) => {
-        console.error(`\n  ${c.red}${c.bold}tailwint crashed:${c.reset} ${err}`);
-        process.stderr.write(isTTY ? "\x1b[?25h" : "");
-        process.exit(2);
-    });
-}

package/package.json

@@ -1,9 +1,11 @@
 {
   "name": "tailwint",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Tailwind CSS linter for CI — drives the official language server to catch class issues and auto-fix them",
   "license": "MIT",
   "author": "Peter Wang",
+  "homepage": "https://github.com/peterwangsc/tailwint",
+  "bugs": "https://github.com/peterwangsc/tailwint/issues",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/peterwangsc/tailwint.git"
@@ -14,25 +16,35 @@
     "lint",
     "linter",
     "ci",
+    "autofix",
     "language-server",
-    "lsp"
+    "lsp",
+    "tailwind-v4",
+    "css",
+    "diagnostics",
+    "code-quality"
   ],
   "type": "module",
   "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./dist/index.js"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
   },
   "bin": {
-    "tailwint": "./bin/tailwint.js"
+    "tailwint": "bin/tailwint.js"
   },
   "files": [
     "bin",
     "dist"
   ],
   "scripts": {
+    "clean": "rm -rf dist",
     "build": "tsc",
     "test": "tsx --test src/*.test.ts",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run clean && npm run build"
   },
   "dependencies": {
     "glob": "^13.0.6"

package/dist/applyEdits.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/applyEdits.test.js

@@ -1,133 +0,0 @@
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-import { applyEdits } from "./index.js";
-// Helper to build a TextEdit concisely
-function edit(startLine, startChar, endLine, endChar, newText) {
-    return {
-        range: {
-            start: { line: startLine, character: startChar },
-            end: { line: endLine, character: endChar },
-        },
-        newText,
-    };
-}
-describe("applyEdits", () => {
-    it("returns content unchanged when edits array is empty", () => {
-        assert.equal(applyEdits("hello\nworld", []), "hello\nworld");
-    });
-    it("replaces a single word on a single line", () => {
-        const result = applyEdits("bg-red-999", [edit(0, 0, 0, 10, "bg-red-500")]);
-        assert.equal(result, "bg-red-500");
-    });
-    it("replaces a substring in the middle of a line", () => {
-        const result = applyEdits("class=\"bg-red-999 p-4\"", [
-            edit(0, 7, 0, 17, "bg-red-500"),
-        ]);
-        assert.equal(result, "class=\"bg-red-500 p-4\"");
-    });
-    it("handles insertion (zero-width range)", () => {
-        const result = applyEdits("hello world", [edit(0, 5, 0, 5, " beautiful")]);
-        assert.equal(result, "hello beautiful world");
-    });
-    it("handles deletion (empty newText)", () => {
-        const result = applyEdits("hello beautiful world", [edit(0, 5, 0, 15, "")]);
-        assert.equal(result, "hello world");
-    });
-    it("handles multi-line replacement", () => {
-        const content = "line one\nline two\nline three";
-        const result = applyEdits(content, [edit(0, 5, 1, 5, "ONE\nline TWO\nline")]);
-        // Replaced range (0,5)-(1,5) is " one\nline ", so suffix is "two"
-        assert.equal(result, "line ONE\nline TWO\nlinetwo\nline three");
-    });
-    it("handles edit that spans multiple lines and collapses them", () => {
-        const content = "aaa\nbbb\nccc\nddd";
-        // Delete from middle of line 1 to middle of line 2
-        const result = applyEdits(content, [edit(1, 1, 2, 2, "")]);
-        assert.equal(result, "aaa\nbc\nddd");
-    });
-    it("applies multiple non-overlapping edits on the same line", () => {
-        const content = "class=\"bg-red-999 text-blue-999\"";
-        const result = applyEdits(content, [
-            edit(0, 7, 0, 17, "bg-red-500"),
-            edit(0, 18, 0, 31, "text-blue-500"),
-        ]);
-        assert.equal(result, "class=\"bg-red-500 text-blue-500\"");
-    });
-    it("applies multiple edits on different lines", () => {
-        const content = "line0\nline1\nline2";
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 5, "LINE0"),
-            edit(2, 0, 2, 5, "LINE2"),
-        ]);
-        assert.equal(result, "LINE0\nline1\nLINE2");
-    });
-    it("handles edit at the very end of file (no trailing newline)", () => {
-        const content = "hello";
-        const result = applyEdits(content, [edit(0, 5, 0, 5, " world")]);
-        assert.equal(result, "hello world");
-    });
-    it("handles edit on empty string", () => {
-        const result = applyEdits("", [edit(0, 0, 0, 0, "inserted")]);
-        assert.equal(result, "inserted");
-    });
-    it("handles replacement that introduces new lines", () => {
-        const content = "one line";
-        const result = applyEdits(content, [edit(0, 3, 0, 4, "\n")]);
-        assert.equal(result, "one\nline");
-    });
-    it("handles replacement that removes newlines (joining lines)", () => {
-        const content = "one\nline";
-        const result = applyEdits(content, [edit(0, 3, 1, 0, " ")]);
-        assert.equal(result, "one line");
-    });
-    it("handles edit past the actual content length of a line", () => {
-        // What if the range references characters beyond the line length?
-        const content = "hi";
-        const result = applyEdits(content, [edit(0, 2, 0, 100, " there")]);
-        assert.equal(result, "hi there");
-    });
-    it("handles edit referencing a line beyond file length", () => {
-        // File has 1 line, edit references line 5.
-        // Line 5 maps to content.length, so this is an append at the end — no newline inserted.
-        // An LSP server wouldn't actually send this, but we shouldn't crash.
-        const content = "only line";
-        const result = applyEdits(content, [edit(5, 0, 5, 0, "new line")]);
-        assert.equal(result, "only linenew line");
-    });
-    it("handles multiple edits where earlier edit changes line count", () => {
-        // This tests whether applying in reverse order is correct.
-        // Edit on line 2 first (applied first in reverse), then edit on line 0.
-        const content = "aaa\nbbb\nccc";
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 3, "AAA"),
-            edit(2, 0, 2, 3, "CCC"),
-        ]);
-        assert.equal(result, "AAA\nbbb\nCCC");
-    });
-    it("handles adjacent edits (end of one = start of next)", () => {
-        const content = "abcdef";
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 3, "ABC"),
-            edit(0, 3, 0, 6, "DEF"),
-        ]);
-        assert.equal(result, "ABCDEF");
-    });
-    it("does not mutate the original edits array", () => {
-        const edits = [
-            edit(1, 0, 1, 3, "BBB"),
-            edit(0, 0, 0, 3, "AAA"),
-        ];
-        const original = JSON.stringify(edits);
-        applyEdits("aaa\nbbb", edits);
-        assert.equal(JSON.stringify(edits), original);
-    });
-    // Stress test: many edits
-    it("handles a large number of single-line edits", () => {
-        const lines = Array.from({ length: 100 }, (_, i) => `line${i}`);
-        const content = lines.join("\n");
-        const edits = lines.map((_, i) => edit(i, 0, i, `line${i}`.length, `LINE${i}`));
-        const result = applyEdits(content, edits);
-        const expected = Array.from({ length: 100 }, (_, i) => `LINE${i}`).join("\n");
-        assert.equal(result, expected);
-    });
-});

package/dist/batchEdits.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/batchEdits.test.js

@@ -1,132 +0,0 @@
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-import { applyEdits } from "./index.js";
-function edit(startLine, startChar, endLine, endChar, newText) {
-    return {
-        range: {
-            start: { line: startLine, character: startChar },
-            end: { line: endLine, character: endChar },
-        },
-        newText,
-    };
-}
-describe("batched edits — multiple diagnostics fixed at once", () => {
-    // Scenario: two cssConflict warnings on separate lines, both fixed in one pass
-    it("removes conflicting classes on separate lines", () => {
-        const content = [
-            'export default function App() {',
-            '  return (',
-            '    <div className="text-red-500 text-blue-500 p-4">',
-            '      <span className="font-bold font-semibold">hello</span>',
-            '    </div>',
-            '  )',
-            '}',
-        ].join("\n");
-        // Simulate: LSP says remove "text-blue-500 " on line 2, and " font-semibold" on line 3
-        const result = applyEdits(content, [
-            edit(2, 33, 2, 47, ""),
-            edit(3, 32, 3, 46, ""),
-        ]);
-        assert.ok(result.includes('"text-red-500 p-4"'), "should keep text-red-500");
-        assert.ok(!result.includes("text-blue-500"), "should remove text-blue-500");
-        assert.ok(result.includes('"font-bold"'), "should keep font-bold");
-        assert.ok(!result.includes("font-semibold"), "should remove font-semibold");
-    });
-    // Scenario: two conflicting pairs on the SAME line
-    it("removes two conflicting classes on the same line", () => {
-        //                     0123456789...
-        const content = '<div className="text-red-500 text-blue-500 bg-red-500 bg-blue-500 p-4">';
-        const result = applyEdits(content, [
-            edit(0, 29, 0, 43, ""),
-            edit(0, 54, 0, 66, ""),
-        ]);
-        assert.ok(result.includes("text-red-500"), "should keep text-red-500");
-        assert.ok(!result.includes("text-blue-500"), "should remove text-blue-500");
-        assert.ok(result.includes("bg-red-500"), "should keep bg-red-500");
-        assert.ok(!result.includes("bg-blue-500"), "should remove bg-blue-500");
-        assert.ok(result.includes("p-4"), "should keep p-4");
-    });
-    // Scenario: edits that are adjacent (one right after the other, no gap)
-    it("handles adjacent removals with no gap between them", () => {
-        const content = "aabbcc";
-        // Remove "bb" (chars 2-4) and "cc" (chars 4-6) — adjacent edits
-        const result = applyEdits(content, [
-            edit(0, 2, 0, 4, ""),
-            edit(0, 4, 0, 6, ""),
-        ]);
-        assert.equal(result, "aa");
-    });
-    // Scenario: what happens if two code actions try to edit overlapping ranges?
-    // This is the dangerous case for batching.
-    it("overlapping edits produce unpredictable results", () => {
-        const content = "abcdefgh";
-        // Edit 1: replace chars 2-5 ("cdef") with "XX"
-        // Edit 2: replace chars 4-7 ("efgh") with "YY"
-        // These overlap at chars 4-5.
-        // Forward pass: cursor=0, edit1(2,5): "ab" + "XX", cursor=5
-        //   edit2(4,7): 4 < cursor(5), so we skip the slice — start is behind cursor!
-        //   Actually, the code does: if (e.start > cursor) parts.push(...)
-        //   e.start=4, cursor=5, 4 > 5 is false, so no gap pushed.
-        //   parts.push("YY"), cursor=7
-        //   remaining: parts.push("h")
-        //   Result: "abXXYYh"
-        //
-        // But what SHOULD happen? The LSP spec says overlapping edits are invalid.
-        // We just need to not crash.
-        const result = applyEdits(content, [
-            edit(0, 2, 0, 5, "XX"),
-            edit(0, 4, 0, 7, "YY"),
-        ]);
-        // We don't care about the exact output, just that we don't crash
-        // and produce a string (not undefined/null/error)
-        assert.equal(typeof result, "string");
-        console.log("Overlapping edit result:", JSON.stringify(result));
-    });
-    // Scenario: realistic Tailwind — class reordering across a whole file
-    it("handles edits across many lines (simulating a file-wide fix)", () => {
-        const lines = [];
-        for (let i = 0; i < 50; i++) {
-            lines.push(`<div className="flex items-center p-${i}">line ${i}</div>`);
-        }
-        const content = lines.join("\n");
-        // Simulate: replace "p-N" with "p-0" on every line
-        const edits = [];
-        for (let i = 0; i < 50; i++) {
-            const pClass = `p-${i}`;
-            const lineContent = lines[i];
-            const start = lineContent.indexOf(pClass);
-            edits.push(edit(i, start, i, start + pClass.length, "p-0"));
-        }
-        const result = applyEdits(content, edits);
-        const resultLines = result.split("\n");
-        assert.equal(resultLines.length, 50);
-        for (let i = 0; i < 50; i++) {
-            assert.ok(resultLines[i].includes("p-0"), `line ${i} should have p-0`);
-            if (i > 0) {
-                assert.ok(!resultLines[i].includes(`p-${i}`), `line ${i} should not have p-${i}`);
-            }
-        }
-    });
-    // Scenario: what if we batch a deletion that shifts everything,
-    // with another edit on a later line? This is the safe case.
-    it("handles deletion on one line + edit on later line", () => {
-        const content = "line0 extra\nline1\nline2 extra";
-        // Delete " extra" on line 0, replace "line2" with "LINE2" on line 2
-        const result = applyEdits(content, [
-            edit(0, 5, 0, 11, ""),
-            edit(2, 0, 2, 5, "LINE2"),
-        ]);
-        assert.equal(result, "line0\nline1\nLINE2 extra");
-    });
-    // Scenario: mixed insertions and deletions across lines
-    it("handles mixed insertions and deletions", () => {
-        const content = "aaa\nbbb\nccc\nddd";
-        const result = applyEdits(content, [
-            edit(0, 3, 0, 3, " inserted"), // insert at end of line 0
-            edit(1, 0, 1, 3, ""), // delete all of line 1 content
-            edit(2, 0, 2, 3, "CCC"), // replace line 2
-            edit(3, 0, 3, 0, "pre-"), // insert at start of line 3
-        ]);
-        assert.equal(result, "aaa inserted\n\nCCC\npre-ddd");
-    });
-});

package/dist/cli.d.ts

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-/**
- * tailwint — Tailwind CSS linter that drives the official language server.
- *
- * Usage:  tailwint [--fix] [glob...]
- *         tailwint                              # default: **\/*.{tsx,jsx,html,vue,svelte}
- *         tailwint --fix                        # auto-fix all issues
- *         tailwint "src/**\/*.tsx"               # custom glob
- *         tailwint --fix "app/**\/*.tsx"          # fix specific files
- *
- * Set DEBUG=1 for verbose LSP message logging.
- */
-export {};

package/dist/cli.js

@@ -1,21 +0,0 @@
-#!/usr/bin/env node
-/**
- * tailwint — Tailwind CSS linter that drives the official language server.
- *
- * Usage:  tailwint [--fix] [glob...]
- *         tailwint                              # default: **\/*.{tsx,jsx,html,vue,svelte}
- *         tailwint --fix                        # auto-fix all issues
- *         tailwint "src/**\/*.tsx"               # custom glob
- *         tailwint --fix "app/**\/*.tsx"          # fix specific files
- *
- * Set DEBUG=1 for verbose LSP message logging.
- */
-import { run } from "./index.js";
-const args = process.argv.slice(2);
-const fix = args.includes("--fix");
-const patterns = args.filter((a) => a !== "--fix");
-run({ fix, patterns: patterns.length > 0 ? patterns : undefined }).then((code) => process.exit(code), (err) => {
-    process.stderr.write("\x1b[?25h"); // restore cursor if hidden
-    console.error(`\n  tailwint crashed: ${err}`);
-    process.exit(2);
-});

package/dist/edgeCases.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/edgeCases.test.js

@@ -1,99 +0,0 @@
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-import { applyEdits } from "./index.js";
-function edit(startLine, startChar, endLine, endChar, newText) {
-    return {
-        range: {
-            start: { line: startLine, character: startChar },
-            end: { line: endLine, character: endChar },
-        },
-        newText,
-    };
-}
-describe("applyEdits edge cases", () => {
-    it("handles Windows-style CRLF content", () => {
-        const content = "hello\r\nworld";
-        const result = applyEdits(content, [edit(0, 0, 0, 5, "HELLO")]);
-        assert.equal(result, "HELLO\r\nworld");
-    });
-    it("handles file with trailing newline", () => {
-        const content = "hello\n";
-        const result = applyEdits(content, [edit(0, 0, 0, 5, "HELLO")]);
-        assert.equal(result, "HELLO\n");
-    });
-    it("handles file with multiple trailing newlines", () => {
-        const content = "hello\n\n\n";
-        const result = applyEdits(content, [edit(0, 0, 0, 5, "HELLO")]);
-        assert.equal(result, "HELLO\n\n\n");
-    });
-    it("handles edit that replaces entire file content", () => {
-        const content = "aaa\nbbb\nccc";
-        const result = applyEdits(content, [edit(0, 0, 2, 3, "replaced")]);
-        assert.equal(result, "replaced");
-    });
-    it("handles two edits on same line — order independence", () => {
-        const content = "abcdefghij";
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 2, "AB"),
-            edit(0, 5, 0, 7, "FG"),
-        ]);
-        assert.equal(result, "ABcdeFGhij");
-    });
-    it("handles two edits on same line — provided in reverse order", () => {
-        const content = "abcdefghij";
-        const result = applyEdits(content, [
-            edit(0, 5, 0, 7, "FG"),
-            edit(0, 0, 0, 2, "AB"),
-        ]);
-        assert.equal(result, "ABcdeFGhij");
-    });
-    it("handles edit with unicode characters", () => {
-        const content = "café latte";
-        const result = applyEdits(content, [edit(0, 0, 0, 4, "CAFÉ")]);
-        assert.equal(result, "CAFÉ latte");
-    });
-    it("handles edit with emoji (multi-codepoint)", () => {
-        // 👋 is 2 UTF-16 code units. LSP uses UTF-16 offsets, as does JS string indexing.
-        const content = "👋 hello";
-        const result = applyEdits(content, [edit(0, 2, 0, 3, "-")]);
-        assert.equal(result, "👋-hello");
-    });
-    it("handles three same-line edits that all grow in length", () => {
-        const content = "class=\"aa bb cc\"";
-        const result = applyEdits(content, [
-            edit(0, 7, 0, 9, "xxxx"),
-            edit(0, 10, 0, 12, "yyyy"),
-            edit(0, 13, 0, 15, "zzzz"),
-        ]);
-        assert.equal(result, "class=\"xxxx yyyy zzzz\"");
-    });
-});
-describe("applyEdits same-line multi-edit correctness", () => {
-    it("correctly handles two non-overlapping edits on the same line", () => {
-        const content = "___foo___bar___";
-        const result = applyEdits(content, [
-            edit(0, 3, 0, 6, "FOO"),
-            edit(0, 9, 0, 12, "BAR"),
-        ]);
-        assert.equal(result, "___FOO___BAR___");
-    });
-    it("handles same-line edits where replacement changes length", () => {
-        const content = "___foo___bar___";
-        const result = applyEdits(content, [
-            edit(0, 3, 0, 6, "FOOOO"),
-            edit(0, 9, 0, 12, "B"),
-        ]);
-        assert.equal(result, "___FOOOO___B___");
-    });
-    it("handles three non-overlapping same-line edits with varying lengths", () => {
-        // Edits replace chars at positions 0('a'), 2('c'), 4('e').
-        // Chars at positions 1('b'), 3('d'), 5('f') are preserved.
-        const content = "abcdef";
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 1, "XX"),
-            edit(0, 2, 0, 3, "YYYYYY"),
-            edit(0, 4, 0, 5, "ZZ"),
-        ]);
-        assert.equal(result, "XXbYYYYYYdZZf");
-    });
-});

package/dist/index.test.d.ts

@@ -1,4 +0,0 @@
-/**
- * Tests for applyEdits from tailwint/edits.ts
- */
-export {};

package/dist/index.test.js

@@ -1,410 +0,0 @@
-/**
- * Tests for applyEdits from tailwint/edits.ts
- */
-import { describe, it } from "node:test";
-import { strict as assert } from "node:assert";
-import { applyEdits } from "./edits.js";
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-/** Shorthand to build a TextEdit */
-function edit(startLine, startChar, endLine, endChar, newText) {
-    return {
-        range: {
-            start: { line: startLine, character: startChar },
-            end: { line: endLine, character: endChar },
-        },
-        newText,
-    };
-}
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-describe("applyEdits", () => {
-    // ---- Basic operations ----
-    it("returns content unchanged for empty edits array", () => {
-        assert.equal(applyEdits("hello", []), "hello");
-    });
-    it("returns content unchanged for empty string input with no edits", () => {
-        assert.equal(applyEdits("", []), "");
-    });
-    it("replaces a single word", () => {
-        assert.equal(applyEdits("flex-shrink-0", [edit(0, 0, 0, 13, "shrink-0")]), "shrink-0");
-    });
-    it("inserts text at the beginning", () => {
-        assert.equal(applyEdits("world", [edit(0, 0, 0, 0, "hello ")]), "hello world");
-    });
-    it("inserts text at the end", () => {
-        assert.equal(applyEdits("hello", [edit(0, 5, 0, 5, " world")]), "hello world");
-    });
-    it("deletes text (empty newText)", () => {
-        assert.equal(applyEdits("hello world", [edit(0, 5, 0, 11, "")]), "hello");
-    });
-    // ---- Multiple edits on the same line ----
-    it("applies two non-overlapping edits on the same line", () => {
-        const content = "z-[1] flex-shrink-0";
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 5, "z-1"),
-            edit(0, 6, 0, 19, "shrink-0"),
-        ]);
-        assert.equal(result, "z-1 shrink-0");
-    });
-    it("applies edits regardless of input order (unsorted)", () => {
-        const content = "z-[1] flex-shrink-0";
-        // Provide edits in reverse order — should still work
-        const result = applyEdits(content, [
-            edit(0, 6, 0, 19, "shrink-0"),
-            edit(0, 0, 0, 5, "z-1"),
-        ]);
-        assert.equal(result, "z-1 shrink-0");
-    });
-    it("applies three edits on the same line", () => {
-        const content = "z-[1] flex-shrink-0 min-w-[200px]";
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 5, "z-1"),
-            edit(0, 6, 0, 19, "shrink-0"),
-            edit(0, 20, 0, 33, "min-w-50"),
-        ]);
-        assert.equal(result, "z-1 shrink-0 min-w-50");
-    });
-    // ---- Adjacent edits (shared boundary) ----
-    it("handles adjacent edits that share a boundary", () => {
-        const content = "aabbcc";
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 2, "AA"),
-            edit(0, 2, 0, 4, "BB"),
-            edit(0, 4, 0, 6, "CC"),
-        ]);
-        assert.equal(result, "AABBCC");
-    });
-    it("handles adjacent insert-then-replace at same position", () => {
-        // Two edits at position 0: first is a zero-width insert, second replaces chars 0-2
-        // This is ambiguous — cursor advances past the first edit's end (0),
-        // so the second edit at start=0 would have start < cursor after the first.
-        // Current implementation: second edit's content replaces, but start <= cursor
-        // means the slice between them is empty.
-        const content = "abc";
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 0, "X"), // insert X at position 0
-            edit(0, 0, 0, 1, "Y"), // replace 'a' with Y
-        ]);
-        // Both edits start at offset 0. After sorting, they're in input order (stable sort?).
-        // First edit: start=0, end=0 → inserts "X", cursor=0
-        // Second edit: start=0 >= cursor(0), end=1 → but start is NOT > cursor, so no gap slice
-        // Result: "X" + "Y" + "bc" = "XYbc"
-        // This might be surprising — the "a" is deleted by the second edit but "X" is also inserted.
-        // Let's just verify the actual behavior.
-        assert.equal(result, "XYbc");
-    });
-    // ---- Multi-line edits ----
-    it("replaces across multiple lines", () => {
-        const content = "line1\nline2\nline3";
-        const result = applyEdits(content, [
-            edit(0, 3, 2, 3, "REPLACED"),
-        ]);
-        assert.equal(result, "linREPLACEDe3");
-    });
-    it("applies edits on different lines", () => {
-        const content = "aaa\nbbb\nccc";
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 3, "AAA"),
-            edit(2, 0, 2, 3, "CCC"),
-        ]);
-        assert.equal(result, "AAA\nbbb\nCCC");
-    });
-    it("deletes an entire line including newline", () => {
-        const content = "keep\ndelete\nkeep";
-        const result = applyEdits(content, [
-            edit(1, 0, 2, 0, ""),
-        ]);
-        assert.equal(result, "keep\nkeep");
-    });
-    it("inserts a new line", () => {
-        const content = "line1\nline3";
-        const result = applyEdits(content, [
-            edit(1, 0, 1, 0, "line2\n"),
-        ]);
-        assert.equal(result, "line1\nline2\nline3");
-    });
-    // ---- Edge cases: out-of-bounds ----
-    it("handles edit past end of file (line beyond last)", () => {
-        const content = "hello";
-        const result = applyEdits(content, [
-            edit(5, 0, 5, 0, " world"),
-        ]);
-        // Line 5 doesn't exist — toOffset clamps to content.length
-        assert.equal(result, "hello world");
-    });
-    it("handles edit with character past end of line", () => {
-        const content = "hi";
-        const result = applyEdits(content, [
-            edit(0, 100, 0, 100, "!"),
-        ]);
-        // Character 100 on a 2-char line clamps to position 2
-        assert.equal(result, "hi!");
-    });
-    // ---- Edge cases: empty content ----
-    it("inserts into empty string", () => {
-        assert.equal(applyEdits("", [edit(0, 0, 0, 0, "hello")]), "hello");
-    });
-    it("handles edit on empty string with out-of-bounds range", () => {
-        assert.equal(applyEdits("", [edit(0, 0, 0, 10, "hello")]), "hello");
-    });
-    // ---- CRLF line endings ----
-    it("handles CRLF line endings", () => {
-        const content = "line1\r\nline2\r\nline3";
-        // With CRLF, \r is a regular character — only \n triggers new line offset.
-        // So line 1 starts after the \n at position 7 (l-i-n-e-1-\r-\n = 7 chars).
-        // "line2" on line 1 starts at offset 7, char 0.
-        const result = applyEdits(content, [
-            edit(1, 0, 1, 5, "LINE2"),
-        ]);
-        assert.equal(result, "line1\r\nLINE2\r\nline3");
-    });
-    it("CRLF: replacing including \\r works correctly", () => {
-        const content = "aa\r\nbb";
-        // Line 0 is "aa\r", line 1 starts at offset 4
-        // Replace from (0,2) to (1,0) — should delete "\r\n"
-        const result = applyEdits(content, [
-            edit(0, 2, 1, 0, ""),
-        ]);
-        assert.equal(result, "aabb");
-    });
-    // ---- Unicode and emoji ----
-    it("handles unicode content correctly", () => {
-        const content = "café";
-        // "café" — the é is one JS char (U+00E9)
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 4, "CAFÉ"),
-        ]);
-        assert.equal(result, "CAFÉ");
-    });
-    it("handles emoji content", () => {
-        // "hi 👋 there" — 👋 is 2 JS chars (surrogate pair)
-        const content = "hi 👋 there";
-        // LSP character offsets use UTF-16 code units, same as JS string length
-        // "hi " = 3 chars, "👋" = 2 chars, " there" = 6 chars
-        // Replace "👋" (chars 3-5) with "🎉" (also 2 chars)
-        const result = applyEdits(content, [
-            edit(0, 3, 0, 5, "🎉"),
-        ]);
-        assert.equal(result, "hi 🎉 there");
-    });
-    // ---- Overlapping edits (potentially dangerous) ----
-    it("overlapping edits: second edit starts inside first edit's range", () => {
-        const content = "abcdef";
-        // Edit 1: replace chars 1-4 ("bcd") with "X"
-        // Edit 2: replace chars 2-5 ("cde") with "Y"
-        // After sorting: edit1 (start=1) comes first, cursor advances to 4
-        // edit2 (start=2) has start < cursor(4), so no gap, but edit2's
-        // newText "Y" is still pushed and cursor goes to 5.
-        // This produces: "a" + "X" + "Y" + "f" = "aXYf"
-        // The overlap means chars 2-4 are "deleted twice" — 'c' and 'd' appear
-        // in both edit ranges. The implementation doesn't detect this.
-        const result = applyEdits(content, [
-            edit(0, 1, 0, 4, "X"),
-            edit(0, 2, 0, 5, "Y"),
-        ]);
-        assert.equal(result, "aXYf");
-    });
-    // ---- Realistic Tailwind scenarios ----
-    it("fixes className with multiple bracket notations", () => {
-        const content = `<div className="w-[1200px] h-[630px] overflow-hidden">`;
-        // w-[1200px] = chars 16-26 (end exclusive), h-[630px] = chars 27-36 (end exclusive)
-        const result = applyEdits(content, [
-            edit(0, 16, 0, 26, "w-300"),
-            edit(0, 27, 0, 36, "h-157.5"),
-        ]);
-        assert.equal(result, `<div className="w-300 h-157.5 overflow-hidden">`);
-    });
-    it("fixes multi-line JSX with edits on different lines", () => {
-        const content = [
-            `<div`,
-            `  className="z-[1] flex-shrink-0"`,
-            `  style={{}}`,
-            `/>`,
-        ].join("\n");
-        // z-[1] starts at char 13 on line 1, flex-shrink-0 at char 19
-        const result = applyEdits(content, [
-            edit(1, 13, 1, 18, "z-1"),
-            edit(1, 19, 1, 32, "shrink-0"),
-        ]);
-        const expected = [
-            `<div`,
-            `  className="z-1 shrink-0"`,
-            `  style={{}}`,
-            `/>`,
-        ].join("\n");
-        assert.equal(result, expected);
-    });
-    // ---- Trailing newline ----
-    it("preserves trailing newline", () => {
-        const content = "hello\n";
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 5, "world"),
-        ]);
-        assert.equal(result, "world\n");
-    });
-    it("edit on the empty last line after trailing newline", () => {
-        const content = "hello\n";
-        // Line 1 exists (empty, after the \n). Insert there.
-        const result = applyEdits(content, [
-            edit(1, 0, 1, 0, "world"),
-        ]);
-        assert.equal(result, "hello\nworld");
-    });
-    // ---- Stress: many edits ----
-    it("handles 50 edits across 50 lines", () => {
-        const lines = Array.from({ length: 50 }, (_, i) => `line-${i}-old`);
-        const content = lines.join("\n");
-        const edits = lines.map((_, i) => {
-            const old = `line-${i}-old`;
-            return edit(i, 0, i, old.length, `line-${i}-new`);
-        });
-        const result = applyEdits(content, edits);
-        const expected = Array.from({ length: 50 }, (_, i) => `line-${i}-new`).join("\n");
-        assert.equal(result, expected);
-    });
-    // ---- Zero-width replacements at various positions ----
-    it("multiple zero-width inserts at different positions", () => {
-        const content = "ac";
-        const result = applyEdits(content, [
-            edit(0, 1, 0, 1, "b"), // insert 'b' between 'a' and 'c'
-        ]);
-        assert.equal(result, "abc");
-    });
-    it("multiple zero-width inserts at the same position", () => {
-        // Two inserts at position 1 — both have start=end=1
-        // After sorting they're both at offset 1, first insert "X", cursor stays at 1,
-        // second insert "Y", cursor stays at 1
-        const content = "ac";
-        const result = applyEdits(content, [
-            edit(0, 1, 0, 1, "X"),
-            edit(0, 1, 0, 1, "Y"),
-        ]);
-        // Both inserts land at offset 1: "a" + "X" + "Y" + "c"
-        assert.equal(result, "aXYc");
-    });
-    // ---- Edit that replaces entire content ----
-    it("replaces entire content with single edit", () => {
-        const content = "old content\nwith multiple\nlines";
-        const result = applyEdits(content, [
-            edit(0, 0, 2, 5, "new"),
-        ]);
-        assert.equal(result, "new");
-    });
-    // ---- Only newlines ----
-    it("handles content that is only newlines", () => {
-        const content = "\n\n\n";
-        const result = applyEdits(content, [
-            edit(1, 0, 1, 0, "inserted"),
-        ]);
-        assert.equal(result, "\ninserted\n\n");
-    });
-    // ---- Probing for subtle bugs ----
-    it("edit where replacement is longer than original (grows the line)", () => {
-        const content = "ab";
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 1, "AAAA"), // replace 'a' (1 char) with 'AAAA' (4 chars)
-        ]);
-        assert.equal(result, "AAAAb");
-    });
-    it("edit where replacement is shorter than original (shrinks the line)", () => {
-        const content = "aaaab";
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 4, "X"), // replace 'aaaa' (4 chars) with 'X' (1 char)
-        ]);
-        assert.equal(result, "Xb");
-    });
-    it("two edits where first shrinks and second uses original offsets", () => {
-        // This is the key scenario: after first edit shrinks, do second edit's
-        // original offsets still work correctly?
-        const content = "aaa bbb ccc";
-        // Replace 'aaa' (0-3) with 'x', replace 'ccc' (8-11) with 'z'
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 3, "x"),
-            edit(0, 8, 0, 11, "z"),
-        ]);
-        // Since we use original offsets: "x" + content[3:8]=" bbb " + "z"
-        assert.equal(result, "x bbb z");
-    });
-    it("two edits where first grows and second uses original offsets", () => {
-        const content = "a b c";
-        const result = applyEdits(content, [
-            edit(0, 0, 0, 1, "XXXX"), // 'a' → 'XXXX'
-            edit(0, 4, 0, 5, "ZZZZ"), // 'c' → 'ZZZZ'
-        ]);
-        assert.equal(result, "XXXX b ZZZZ");
-    });
-    it("edit that deletes everything and inserts nothing", () => {
-        const content = "hello\nworld";
-        const result = applyEdits(content, [
-            edit(0, 0, 1, 5, ""),
-        ]);
-        assert.equal(result, "");
-    });
-    it("edit range with end before start (invalid range)", () => {
-        // Pathological: end offset < start offset after conversion
-        // toOffset(0,5) = 5, toOffset(0,2) = 2 → start=5, end=2
-        // After sort, this edit has start=5 > cursor=0, so we'd push content[0:5]
-        // then push newText, then cursor=2 which is < 5...
-        // This should behave oddly. Let's see what happens.
-        const content = "abcdef";
-        const result = applyEdits(content, [
-            edit(0, 5, 0, 2, "X"), // start > end
-        ]);
-        // start=5, end=2: push "abcde" (0-5), push "X", cursor=2
-        // cursor(2) < content.length(6), push content[2:] = "cdef"
-        // Result: "abcdeXcdef" — the reversed range causes duplication
-        assert.equal(result, "abcdeXcdef");
-    });
-    it("consecutive edits that delete and insert on multi-line content", () => {
-        const content = "line1\nline2\nline3\nline4\nline5";
-        // Delete line2, replace line4 with NEW4
-        const result = applyEdits(content, [
-            edit(1, 0, 2, 0, ""), // delete "line2\n"
-            edit(3, 0, 3, 5, "NEW4"), // replace "line4" with "NEW4"
-        ]);
-        assert.equal(result, "line1\nline3\nNEW4\nline5");
-    });
-    it("edit at exact end of content (no trailing newline)", () => {
-        const content = "end";
-        const result = applyEdits(content, [
-            edit(0, 3, 0, 3, "!"),
-        ]);
-        assert.equal(result, "end!");
-    });
-    it("many edits on the same line, varying replacement lengths", () => {
-        // Simulates what the LSP might do with a class like:
-        // "z-[1] flex-shrink-0 bg-primary/[0.06] min-w-[200px] h-[1px]"
-        const content = `className="z-[1] flex-shrink-0 bg-primary/[0.06] min-w-[200px] h-[1px]"`;
-        const result = applyEdits(content, [
-            edit(0, 11, 0, 16, "z-1"), // z-[1] → z-1
-            edit(0, 17, 0, 30, "shrink-0"), // flex-shrink-0 → shrink-0
-            edit(0, 31, 0, 48, "bg-primary/6"), // bg-primary/[0.06] → bg-primary/6
-            edit(0, 49, 0, 62, "min-w-50"), // min-w-[200px] → min-w-50
-            edit(0, 63, 0, 70, "h-px"), // h-[1px] → h-px
-        ]);
-        assert.equal(result, `className="z-1 shrink-0 bg-primary/6 min-w-50 h-px"`);
-    });
-    it("single char file with replacement", () => {
-        assert.equal(applyEdits("x", [edit(0, 0, 0, 1, "y")]), "y");
-    });
-    it("edit newText contains newlines (splitting a line)", () => {
-        const content = "before after";
-        const result = applyEdits(content, [
-            edit(0, 6, 0, 7, "\n"), // replace space with newline
-        ]);
-        assert.equal(result, "before\nafter");
-    });
-    it("edit that joins lines by replacing newline with space", () => {
-        const content = "before\nafter";
-        // The \n is at the end of line 0 (char 6 = the newline itself?).
-        // Actually, line 0 is "before", line 1 is "after".
-        // Range (0,6) to (1,0) covers just the \n character.
-        const result = applyEdits(content, [
-            edit(0, 6, 1, 0, " "),
-        ]);
-        assert.equal(result, "before after");
-    });
-});