tailwint 1.0.0

package/dist/ui.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Terminal UI — colors, spinners, animations, progress bars.
+ */
+export declare const isTTY: boolean;
+export declare const c: {
+    reset: string;
+    bold: string;
+    dim: string;
+    italic: string;
+    under: string;
+    red: string;
+    orange: string;
+    yellow: string;
+    green: string;
+    cyan: string;
+    blue: string;
+    purple: string;
+    pink: string;
+    gray: string;
+    white: string;
+    bgRed: string;
+    bgGreen: string;
+    bgOrange: string;
+    bgCyan: string;
+    hide: string;
+    show: string;
+    clear: string;
+};
+export declare function setTitle(text: string): void;
+/** Generates a wind trail that fills exactly `cols` terminal columns. */
+export declare function windTrail(cols: number, offset?: number): string;
+export declare let tick: number;
+export declare function advanceTick(): void;
+export declare function braille(): string;
+export declare function windWave(): string;
+export declare function dots(): string;
+export declare function startSpinner(render: () => string, intervalMs?: number): () => void;
+export declare function progressBar(pct: number, width: number, animate?: boolean): string;
+export declare function banner(): Promise<void>;
+export declare function rainbowText(text: string): string;
+export declare function celebrationAnimation(): Promise<void>;
+export declare function fileBadge(rel: string): string;
+export declare function diagLine(d: any): string;

package/dist/ui.js

@@ -0,0 +1,190 @@
+/**
+ * Terminal UI — colors, spinners, animations, progress bars.
+ */
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+export const isTTY = !!(process.stderr.isTTY && process.stdout.isTTY);
+export const c = {
+    reset: isTTY ? "\x1b[0m" : "",
+    bold: isTTY ? "\x1b[1m" : "",
+    dim: isTTY ? "\x1b[2m" : "",
+    italic: isTTY ? "\x1b[3m" : "",
+    under: isTTY ? "\x1b[4m" : "",
+    red: isTTY ? "\x1b[38;5;203m" : "",
+    orange: isTTY ? "\x1b[38;5;208m" : "",
+    yellow: isTTY ? "\x1b[38;5;221m" : "",
+    green: isTTY ? "\x1b[38;5;114m" : "",
+    cyan: isTTY ? "\x1b[38;5;80m" : "",
+    blue: isTTY ? "\x1b[38;5;75m" : "",
+    purple: isTTY ? "\x1b[38;5;141m" : "",
+    pink: isTTY ? "\x1b[38;5;211m" : "",
+    gray: isTTY ? "\x1b[38;5;243m" : "",
+    white: isTTY ? "\x1b[38;5;255m" : "",
+    bgRed: isTTY ? "\x1b[48;5;52m" : "",
+    bgGreen: isTTY ? "\x1b[48;5;22m" : "",
+    bgOrange: isTTY ? "\x1b[48;5;94m" : "",
+    bgCyan: isTTY ? "\x1b[48;5;30m" : "",
+    hide: isTTY ? "\x1b[?25l" : "",
+    show: isTTY ? "\x1b[?25h" : "",
+    clear: isTTY ? "\x1b[2K\r" : "",
+};
+// ---------------------------------------------------------------------------
+// Terminal title
+// ---------------------------------------------------------------------------
+export function setTitle(text) {
+    if (isTTY)
+        process.stderr.write(`\x1b]2;${text}\x07`);
+}
+// ---------------------------------------------------------------------------
+// Wind trail — the tailwint signature
+// ---------------------------------------------------------------------------
+const WIND_CHARS = ["~", "\u2248", "\u223C", "\u301C"];
+const WIND_WIDTHS = [1, 1, 1, 2]; // 〜 is fullwidth
+const WIND_COLORS = [c.cyan, c.blue, c.purple, c.pink, c.cyan, c.blue];
+/** Generates a wind trail that fills exactly `cols` terminal columns. */
+export function windTrail(cols, offset = 0) {
+    const parts = [];
+    let used = 0;
+    let i = 0;
+    while (used < cols) {
+        const charIdx = (i + offset) % WIND_CHARS.length;
+        const colorIdx = (i + offset) % WIND_COLORS.length;
+        const w = WIND_WIDTHS[charIdx];
+        if (used + w > cols)
+            break; // don't overshoot
+        parts.push(`${WIND_COLORS[colorIdx]}${WIND_CHARS[charIdx]}${c.reset}`);
+        used += w;
+        i++;
+    }
+    // Fill remaining columns with single-width chars
+    while (used < cols) {
+        const colorIdx = (i + offset) % WIND_COLORS.length;
+        parts.push(`${WIND_COLORS[colorIdx]}~${c.reset}`);
+        used++;
+        i++;
+    }
+    return parts.join("");
+}
+// ---------------------------------------------------------------------------
+// Spinners & animation primitives
+// ---------------------------------------------------------------------------
+const BRAILLE_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2807"];
+export let tick = 0;
+export function advanceTick() { tick++; }
+const SPIN_COLORS = [c.cyan, c.blue, c.purple, c.pink, c.purple, c.blue];
+export function braille() {
+    const color = SPIN_COLORS[Math.floor(tick / 2) % SPIN_COLORS.length];
+    return `${color}${BRAILLE_FRAMES[tick % BRAILLE_FRAMES.length]}${c.reset}`;
+}
+export function windWave() {
+    return windTrail(6, tick % 24);
+}
+export function dots() {
+    const n = tick % 4;
+    return `${c.dim}${".".repeat(n)}${" ".repeat(3 - n)}${c.reset}`;
+}
+export function startSpinner(render, intervalMs = 100) {
+    if (!isTTY)
+        return () => { };
+    process.stderr.write(c.hide);
+    const id = setInterval(() => {
+        tick++;
+        process.stderr.write(`${c.clear}${render()}`);
+    }, intervalMs);
+    return () => {
+        clearInterval(id);
+        process.stderr.write(`${c.clear}${c.show}`);
+    };
+}
+// ---------------------------------------------------------------------------
+// Progress bar
+// ---------------------------------------------------------------------------
+export function progressBar(pct, width, animate = false) {
+    const filled = Math.round((pct / 100) * width);
+    const empty = width - filled;
+    const gradient = [c.cyan, c.cyan, c.blue, c.blue, c.purple, c.purple, c.pink];
+    const chars = Array.from({ length: filled }, (_, i) => {
+        const colorIdx = Math.floor((i / width) * gradient.length);
+        const shift = animate ? (tick + i) % gradient.length : colorIdx;
+        const color = gradient[Math.min(shift, gradient.length - 1)];
+        return `${color}\u2501${c.reset}`;
+    }).join("");
+    const emptyBar = `${c.dim}${"\u2501".repeat(empty)}${c.reset}`;
+    return `${c.dim}\u2503${c.reset}${chars}${emptyBar}${c.dim}\u2503${c.reset}`;
+}
+// ---------------------------------------------------------------------------
+// Banner & celebrations
+// ---------------------------------------------------------------------------
+// Viewport: 56 visible chars (2 indent + 54 content)
+const VP = 54;
+const WIND_SIDE = Math.floor((VP - 10) / 2); // 22 each side of " tailwint "
+export async function banner() {
+    console.error("");
+    if (isTTY) {
+        process.stderr.write(c.hide);
+        for (let frame = 0; frame < 8; frame++) {
+            const len = Math.min(frame + 2, WIND_SIDE);
+            const pad = " ".repeat(WIND_SIDE - len);
+            const left = windTrail(len, frame);
+            const right = windTrail(len, frame + 6);
+            const titleColor = frame < 4 ? c.dim : c.bold;
+            process.stderr.write(`${c.clear}  ${pad}${left} ${titleColor}${c.cyan}tailwint${c.reset} ${right}`);
+            await sleep(60);
+        }
+        process.stderr.write(`${c.clear}${c.show}`);
+    }
+    console.error(`  ${windTrail(WIND_SIDE)} ${c.bold}${c.cyan}tailwint${c.reset} ${windTrail(WIND_SIDE, 6)}`);
+    console.error(`    ${c.dim}tailwind css linter ${c.gray}// powered by the official lsp${c.reset}`);
+    console.error("");
+}
+function celebrationBurst() {
+    const sparks = ["\u2728", "\u2727", "\u2726", "\u2729", "\u00B7", "\u2728"];
+    const colors = [c.cyan, c.blue, c.purple, c.pink, c.yellow, c.green];
+    return Array.from({ length: 6 }, (_, i) => `${colors[i % colors.length]}${sparks[i % sparks.length]}${c.reset}`).join(" ");
+}
+export function rainbowText(text) {
+    const colors = [c.cyan, c.blue, c.purple, c.pink, c.orange, c.yellow, c.green];
+    return text
+        .split("")
+        .map((ch, i) => (ch === " " ? ch : `${colors[i % colors.length]}${ch}${c.reset}`))
+        .join("");
+}
+export async function celebrationAnimation() {
+    if (!isTTY)
+        return;
+    // Center each frame within the 56-col viewport
+    const pad = (visible) => " ".repeat(Math.floor((56 - visible) / 2));
+    process.stderr.write(c.hide);
+    const frames = [
+        `${pad(5)}${c.dim}. ${c.reset}${c.cyan}\u2728${c.reset}${c.dim} .${c.reset}`,
+        `${pad(5)}${c.blue}\u2727${c.reset} ${c.purple}\u2728${c.reset} ${c.pink}\u2727${c.reset}`,
+        `${pad(7)}${c.cyan}\u2728${c.reset} ${c.yellow}\u2726${c.reset} ${c.green}\u2728${c.reset} ${c.purple}\u2729${c.reset}`,
+        `${pad(11)}${celebrationBurst()}`,
+    ];
+    for (const frame of frames) {
+        process.stderr.write(`${c.clear}${frame}`);
+        await sleep(150);
+    }
+    process.stderr.write(`${c.clear}${c.show}`);
+    console.error(`${pad(11)}${celebrationBurst()}\n`);
+}
+// ---------------------------------------------------------------------------
+// Diagnostic & file formatting
+// ---------------------------------------------------------------------------
+export function fileBadge(rel) {
+    const dir = rel.includes("/") ? `${c.dim}${rel.slice(0, rel.lastIndexOf("/") + 1)}${c.reset}` : "";
+    const name = rel.includes("/") ? rel.slice(rel.lastIndexOf("/") + 1) : rel;
+    return `${dir}${c.bold}${c.white}${name}${c.reset}`;
+}
+export function diagLine(d) {
+    const line = (d.range?.start?.line ?? 0) + 1;
+    const col = (d.range?.start?.character ?? 0) + 1;
+    const loc = `${c.dim}${line}:${col}${c.reset}`;
+    const isConflict = d.code === "cssConflict";
+    const icon = isConflict ? `${c.orange}\u26A1${c.reset}` : `${c.yellow}\u25CB${c.reset}`;
+    const tag = isConflict
+        ? `${c.bgOrange}${c.bold} conflict ${c.reset}`
+        : `${c.yellow}canonical${c.reset}`;
+    return `    ${icon} ${loc} ${tag} ${c.white}${d.message}${c.reset}`;
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "tailwint",
+  "version": "1.0.0",
+  "description": "Tailwind CSS linter for CI — drives the official language server to catch class issues and auto-fix them",
+  "license": "MIT",
+  "author": "Peter Wang",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/peterwangsc/tailwint.git"
+  },
+  "keywords": [
+    "tailwindcss",
+    "tailwind",
+    "lint",
+    "linter",
+    "ci",
+    "language-server",
+    "lsp"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "bin": {
+    "tailwint": "./bin/tailwint.js"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "tsx --test src/*.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "glob": "^13.0.6"
+  },
+  "peerDependencies": {
+    "@tailwindcss/language-server": ">=0.14.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/language-server": "^0.14.29",
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2"
+  }
+}