oxlint-tui 1.2.0 → 1.4.0

package/README.md

@@ -1,21 +1,22 @@
 # oxlint-tui
 
-A lightweight, dependency-free Node.js Terminal User Interface (TUI) for browsing, toggling and visualizing [oxlint](https://github.com/oxc-project/oxc) rules and the number of warnings/errors they produce when toggled ON.
+A lightweight, dependency-free Node.js Terminal User Interface (TUI) for browsing, toggling, and visualizing [oxlint](https://github.com/oxc-project/oxc) rules.
 
-It automatically loads your local configuration to show you the status of the rules toggled in your project and allows you to toggle them by selecting a rule in the Rules pane and pressing <kbd>1</kbd>, <kbd>2</kbd>, or <kbd>3</kbd>. The config file is modified in real-time.
+It automatically loads your local configuration (if one exists) to show you the current status of your project. You can then toggle rules on the fly to see how they affect your codebase without altering your actual configuration file.
 
-**NOTE**: At the moment, comments will be erased from your configuration file when adding or toggling rules.
+**It serves as a playground:** Toggle rules in memory, run the linter, and see the results immediately.
 
 ![screenshot](https://raw.githubusercontent.com/holoflash/oxlint-tui/refs/heads/main/screenshot.png)
 
 ## Why?
 
-Configuring linters often involves jumping between your editor, a massive JSON file, and web documentation. `oxlint-tui` tries to make the process easier by giving you an **interactive dashboard** right in your terminal.
+Configuring linters often involves jumping between your editor, a massive JSON file, and web documentation. `oxlint-tui` tries to make the process easier by giving you an **interactive dashboard** right in your terminal. It allows you to "try before you buy"—enabling strict rules temporarily to see how many errors they would produce.
 
 ## Features
 
-- **Config Aware**: provides information about the rules used in your project by loading `.oxlintrc.json`.
-- **Details**: View category, scope, fix, default and type-aware rule parameters at a glance.
+- **Non-Destructive**: Toggling rules happens entirely in memory. No changes are written to disk, making it safe to experiment without messing up your config or comments.
+- **Config Aware**: Automatically reads `.oxlintrc.json` to initialize the state, but works perfectly even if no config file exists.
+- **Details**: View category, scope, fix, default, and type-aware rule parameters at a glance.
 - **View Docs**: Press <kbd>ENTER</kbd> on any rule to open its official documentation in your browser.
 - **Zero Dependencies**: Written in pure Node.js without any heavy TUI libraries.
 
@@ -31,7 +32,7 @@ npx oxlint-tui
 
 ### Custom Config Path
 
-If your configuration file is located elsewhere or named differently:
+If you want to load an initial state from a specific config file:
 
 ```bash
 npx oxlint-tui ./configs/oxlint.json
@@ -68,9 +69,7 @@ oxlint-tui
 - Node.js >= 16
 - `oxlint` (The tool runs `npx oxlint --rules --format=json` internally to fetch definitions)
 
-## Roadmap
-
-The goal is to build this into a tool that not only reads the information provided by the oxlint CLI and your configuration file - but also allows to fully customize the configuration. Oxlint provides a lot more flexibility than just toggling rules on/off, so making this fully functional is going to require more work.
+## Contributing
 
 If you're willing and able, please feel free to [contribute to this project](https://github.com/holoflash/oxlint-tui/blob/main/CONTRIBUTING.md).
 

package/dist/index.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import e from"node:fs";import t from"node:zlib";import{fileURLToPath as n}from"node:url";import r from"node:path";import i from"readline";import{execSync as a,spawn as o}from"node:child_process";import{argv as s,exit as c,platform as l,stdin as u,stdout as d}from"node:process";const f={reset:`\x1B[0m`,dim:`\x1B[38;5;242m`,highlight:`\x1B[38;5;111m`,selectedBg:`\x1B[48;5;24m\x1B[38;5;255m\x1B[1m`,borderActive:`\x1B[38;5;111m`,borderInactive:`\x1B[38;5;237m`,error:`\x1B[38;5;203m`,warn:`\x1B[38;5;215m`,success:`\x1B[38;5;114m`,info:`\x1B[38;5;75m`};function p(e,t){if(!e)return[];let n=Math.ceil(e.length/t),r=Array(n);for(let i=0;i<n;i++)r[i]=e.substring(i*t,(i+1)*t);return r}function m(e,t,n,r,i,a,o,s,c,l){let u=l?f.borderActive:f.borderInactive,d=`${u}┌─ ${a.length>r-6?a.substring(0,r-7)+`…`:a} `.padEnd(r+u.length-1,`─`);e.push(`\x1b[${n};${t}H${d}┐${f.reset}`);for(let a=1;a<i-1;a++)e.push(`\x1b[${n+a};${t}H${u}│${` `.repeat(r-2)}│${f.reset}`);e.push(`\x1b[${n+i-1};${t}H${u}└${`─`.repeat(r-2)}┘${f.reset}`);let p=i-2;o.slice(c,c+p).forEach((i,a)=>{let o=c+a,u=typeof i!=`string`,d=u?i.value:i,p=d.length>r-4?d.substring(0,r-5)+`…`:d.padEnd(r-4),m=f.dim;if(u){let e=i;e.configStatus===`error`?m=f.error:e.configStatus===`warn`?m=f.warn:e.isActive&&(m=f.success)}e.push(`\x1b[${n+1+a};${t+2}H`),o===s?e.push(l?`${f.selectedBg}${p}${f.reset}`:`${f.dim}\x1b[7m${p}${f.reset}`):e.push(`${m}${p}${f.reset}`)})}function h(e,t,n,r,i,a){let o=f.borderInactive,s=`${o}┌─ STATS `.padEnd(r+o.length-1,`─`);e.push(`\x1b[${n};${t}H${s}┐${f.reset}`);for(let a=1;a<i-1;a++)e.push(`\x1b[${n+a};${t}H${o}│${` `.repeat(r-2)}│${f.reset}`);e.push(`\x1b[${n+i-1};${t}H${o}└${`─`.repeat(r-2)}┘${f.reset}`);let c={error:0,warn:0,off:0};a.forEach(e=>{e.configStatus===`error`?c.error++:e.configStatus===`warn`?c.warn++:c.off++}),[{label:`Error`,count:c.error,color:f.error},{label:`Warn`,count:c.warn,color:f.warn},{label:`Off`,count:c.off,color:f.dim}].forEach((a,o)=>{if(o<i-2){let i=String(a.count).padStart(3),s=a.label.padEnd(r-8);e.push(`\x1b[${n+1+o};${t+2}H${a.color}${s}${i}${f.reset}`)}})}function g(e,t,n,r,i,a,o){let s=o?f.borderActive:f.borderInactive,c=`${s}┌─ DETAILS `.padEnd(r+s.length-1,`─`);e.push(`\x1b[${n};${t}H${c}┐${f.reset}`);for(let a=1;a<i-1;a++)e.push(`\x1b[${n+a};${t}H${s}│${` `.repeat(r-2)}│${f.reset}`);if(e.push(`\x1b[${n+i-1};${t}H${s}└${`─`.repeat(r-2)}┘${f.reset}`),!a)return;let l=a.configStatus.toUpperCase();l=a.configStatus===`error`?`${f.error}${l}${f.reset}`:a.configStatus===`warn`?`${f.warn}${l}${f.reset}`:`${f.dim}${l}${f.reset}`;let u=[[`Name`,a.value],[`Status`,l],[`Category`,a.category],[`Scope`,a.scope],[`Fix`,a.fix||`N/A`],[`Default`,a.default?`Yes`:`No`],[`Type-aware`,a.type_aware?`Yes`:`No`]],d=0;u.forEach(([r,a])=>{d<i-2&&(e.push(`\x1b[${n+1+d};${t+2}H${f.highlight}${r.padEnd(12)} ${f.reset}${a}`),d++)}),d<i-3&&d++,d<i-2&&(e.push(`\x1b[${n+1+d};${t+2}H${f.reset}Description:${f.reset}`),d++,p((a.description??`N/A`).replace(/\s+/g,` `).trim(),r-6).forEach(r=>{d<i-2&&(e.push(`\x1b[${n+1+d};${t+2}H${f.dim}${r}${f.reset}`),d++)}));let m=Math.max(d+1,i-3);m<i-1&&e.push(`\x1b[${n+1+m};${t+2}HHit ${f.highlight}ENTER${f.reset} to open docs`)}function _(e,t,n){return e<t?e:e>=t+n?e-n+1:t}function v(){if(!w||!w.categories)return;let{columns:e=80,rows:t=24}=d,n=w.categories[w.selectedCategoryIndex],r=w.rulesByCategory[n]||[],i=r[w.selectedRuleIndex],a=t-5,o=Math.floor(e*.2),s=Math.floor(e*.3),c=e-o-s-2,l=a-6,u=[`\x1B[H\x1B[J`];m(u,1,1,o,l,`CATEGORIES`,w.categories,w.selectedCategoryIndex,w.categoryScroll,w.activePane===0),h(u,1,1+l,o,6,r),m(u,o+1,1,s,a,`RULES (${r.length})`,r,w.selectedRuleIndex,w.ruleScroll,w.activePane===1),g(u,o+s+1,1,c,a,i,w.activePane===2);let p=f[w.messageType]||f.reset;u.push(`\x1b[${t-3};2H${p}● ${w.message}${f.reset}`);let _=w.configPath?`Config: ${w.configPath}`:`No config loaded`;u.push(`\x1b[${t-1};2H${f.dim}Arrows/HJKL: Nav | 1-3: Status | R: Lint | X: Run rule | Enter: Docs | Q: Quit | ${_}${f.reset}`),d.write(u.join(``))}const y=`1.42.0`,b={k:{type:`MOVE_UP`},up:{type:`MOVE_UP`},down:{type:`MOVE_DOWN`},j:{type:`MOVE_DOWN`},left:{type:`MOVE_LEFT`},h:{type:`MOVE_LEFT`},right:{type:`MOVE_RIGHT`},l:{type:`MOVE_RIGHT`},return:{type:`OPEN_DOCS`},enter:{type:`OPEN_DOCS`},1:{type:`SET_STATUS`,value:`off`},2:{type:`SET_STATUS`,value:`warn`},3:{type:`SET_STATUS`,value:`error`},q:{type:`EXIT`},r:{type:`RUN_LINT`},x:{type:`RUN_SINGLE_RULE`}},x=r.dirname(n(import.meta.url));function S(){let n=r.join(x,`rule-descriptions.br`);if(e.existsSync(n))return JSON.parse(t.brotliDecompressSync(e.readFileSync(n)).toString())}const C=S();let w={activePane:0,selectedCategoryIndex:0,selectedRuleIndex:0,categoryScroll:0,ruleScroll:0,isLintInProgress:!1,message:`oxlint-tui`,messageType:`dim`,...A()};function T(e,t){w.config||={rules:{}},w.config.rules||(w.config.rules={});try{let n=e.value,r=e.scope===`oxc2`||e.scope===`eslint`?n:`${e.scope}/${n}`,i=w.config.rules,a=Object.keys(i).find(e=>e===r||e===n||e.endsWith(`/${n}`))||r;i[a]=t}catch{w.message=`Failed to update internal state`,w.messageType=`error`}}function E({rule:e=null}={}){if(w.isLintInProgress)return;w.isLintInProgress=!0;let t=e?`${e.scope}/${e.value}`:null,n=e?e.type_aware:Object.values(w.rulesByCategory).flat().some(e=>e.isActive&&e.type_aware===!0);w.message=`Linting`,t&&(w.message+=` [${t}]`),n&&(w.message+=` with --type-aware`),w.message+=`...`,w.messageType=`info`,v();let r=l===`win32`?`npx.cmd`:`npx`,i=[`-q`,`--yes`,`--package`,`oxlint@${y}`];n&&i.push(`--package`,`oxlint-tsgolint@0.11.4`),i.push(`--`,`oxlint`),n&&i.push(`--type-aware`),t?i.push(`-A`,`all`,`-D`,t):w.config&&w.config.rules&&Object.entries(w.config.rules).forEach(([e,t])=>{let n=Array.isArray(t)?t[0]:t;n===`error`?i.push(`-D`,e):n===`warn`?i.push(`-W`,e):n===`off`&&i.push(`-A`,e)});let a=o(r,i),s=``,c=``;a.stdout.on(`data`,e=>{s+=e}),a.stderr.on(`data`,e=>{c+=e}),a.on(`close`,e=>{w.isLintInProgress=!1;let n=(s+c).match(/Found (\d+) warnings? and (\d+) errors?/i);if(n){let e=parseInt(n[2]);w.message=t?`[${t}] Found ${e} issue${e===1?``:`s`}`:n[0],w.messageType=e>0?`error`:`warn`}else if(s.toLowerCase().includes(`finished`)||e===0&&s.length<200)w.message=`Linting passed! 0 issues found.`,t&&(w.message=`[${t}] ${w.message}`),w.messageType=`success`;else{let e=c.split(`
+`).filter(e=>!e.includes(`experimental`)&&!e.includes(`Breaking changes`)&&e.trim()!==``).join(` `);w.message=e?`Error: ${e.substring(0,50)}...`:`Lint failed`,w.messageType=`error`}v()})}function D(e){if(!e)return;let{categories:t,rulesByCategory:n,selectedCategoryIndex:r,selectedRuleIndex:i,activePane:a}=w,o=t[r],s=n[o]||[],l=d.rows-8,u=l-7;switch(e.type){case`EXIT`:P(),c(0);return;case`RUN_LINT`:E();return;case`RUN_SINGLE_RULE`:{let e=s[i];e&&E({rule:e});return}case`OPEN_DOCS`:if(a===1){let e=s[i];e&&j(e.docs_url||e.url)}return;case`SET_STATUS`:{if(a!==1||!e.value)return;let t=s[i];if(!t)return;T(t,e.value);let r=[...s];r[i]={...t,configStatus:e.value,isActive:e.value===`error`||e.value===`warn`},w={...w,message:`Rule '${t.value}' set to: ${e.value}`,messageType:`info`,rulesByCategory:{...n,[o]:r}},v();return}case`MOVE_RIGHT`:a!==1&&(w={...w,activePane:a+1},v());return;case`MOVE_LEFT`:a!==0&&(w={...w,activePane:a-1},v());return;case`MOVE_UP`:if(a===0){let e=r===0?t.length-1:r-1;w={...w,selectedCategoryIndex:e,selectedRuleIndex:0,ruleScroll:0,categoryScroll:_(e,w.categoryScroll,u)}}else if(a===1){let e=i===0?s.length-1:i-1;w={...w,selectedRuleIndex:e,ruleScroll:_(e,w.ruleScroll,l)}}v();return;case`MOVE_DOWN`:if(a===0){let e=r===t.length-1?0:r+1;w={...w,selectedCategoryIndex:e,selectedRuleIndex:0,ruleScroll:0,categoryScroll:_(e,w.categoryScroll,u)}}else if(a===1){let e=i===s.length-1?0:i+1;w={...w,selectedRuleIndex:e,ruleScroll:_(e,w.ruleScroll,l)}}v();return}}function O(e,t,n){if(n.rules){let t=n.rules[e];if(t===void 0){let r=Object.keys(n.rules).find(t=>t.endsWith(`/${e}`));r&&(t=n.rules[r])}if(t!==void 0)return Array.isArray(t)?t[0]:t}return n.categories&&n.categories[t]?n.categories[t]:`off`}function k(e){return e.replace(/\\"|"(?:\\"|[^"])*"|(\/\/.*|\/\*[\s\S]*?\*\/)/g,(e,t)=>t?``:e)}function A(){let t=[],n={rules:{},categories:{}},r=null,i=C;i||(w.message=`Error: Couldn't find description.`,w.messageType=`error`);try{let e=a(`npx -q --yes oxlint@${y} --rules --format=json`,{encoding:`utf8`,stdio:[`ignore`,`pipe`,`ignore`]});t=JSON.parse(e)}catch{w.message=`Error: Couldn't run 'npx oxlint'.`,w.messageType=`error`,c(1)}let o=s[2];if(o&&e.existsSync(o)?r=o:e.existsSync(`.oxlintrc.json`)&&(r=`.oxlintrc.json`),r)try{n=JSON.parse(k(e.readFileSync(r,`utf8`)))}catch{w.message=`Error: Couldn't parse config.`,w.messageType=`error`}let l={};return t.forEach(e=>{let t=e.category||`Uncategorized`;l[t]||(l[t]=[]);let r=O(e.value,t,n),a=i[e.scope]?.[e.value];l[t].push({...e,description:a,configStatus:r,isActive:r===`error`||r===`warn`})}),{categories:Object.keys(l).toSorted(),rulesByCategory:l,config:n,configPath:r}}function j(e){e&&o(l===`darwin`?`open`:l===`win32`?`explorer`:`xdg-open`,[e],{detached:!0,stdio:`ignore`}).unref()}const M=e=>d.write(e),N=()=>M(`\x1B[?1049h\x1B[?25l`),P=()=>M(`\x1B[?1049l\x1B[?25h`);i.emitKeypressEvents(u),u.isTTY&&u.setRawMode(!0),u.on(`keypress`,(e,t)=>{D(b[t.name]||(t.ctrl&&t.name===`c`?{type:`EXIT`}:b[t.sequence]||null))}),d.on(`resize`,v),N(),v();export{w as state};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oxlint-tui",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "A Node TUI Oxlint rules and configuration browser",
   "keywords": [
     "cli",
@@ -13,7 +13,7 @@
   "license": "MIT",
   "author": "holoflash",
   "bin": {
-    "oxlint-tui": "dist/index.js"
+    "oxlint-tui": "./dist/index.mjs"
   },
   "files": [
     "dist"
@@ -21,22 +21,23 @@
   "type": "module",
   "scripts": {
     "prepare": "husky",
-    "dev": "tsx src/index.ts src/.oxlintrc.test.json",
-    "generate-rule-descriptions": "tsx src/generate-rule-descriptions.ts",
+    "dev": "tsx src/index.ts",
     "lint": "oxlint --type-aware --format=stylish",
     "type-check": "tsgo --noEmit",
     "format": "oxfmt",
     "format-check": "oxfmt --check",
-    "build": "rm -rf dist && npm run generate-rule-descriptions && tsc --outDir dist && cp src/rule-descriptions.json dist/",
-    "build-run": "npm run build && node dist/index.js src/.oxlintrc.test.json"
+    "gen": "tsx scripts/generate-rule-descriptions.ts",
+    "build": "tsdown && cp src/rule-descriptions.br dist/",
+    "build-run": "npm run gen && npm run build && node dist/index.mjs"
   },
   "devDependencies": {
-    "@types/node": "25.0.10",
-    "@typescript/native-preview": "7.0.0-dev.20260124.1",
+    "@types/node": "25.2.0",
+    "@typescript/native-preview": "7.0.0-dev.20260202.1",
     "husky": "9.1.7",
-    "oxfmt": "0.26.0",
-    "oxlint": "1.41.0",
-    "oxlint-tsgolint": "0.11.1",
+    "oxfmt": "0.28.0",
+    "oxlint": "1.43.0",
+    "oxlint-tsgolint": "0.11.4",
+    "tsdown": "0.20.1",
     "tsx": "4.21.0",
     "typescript": "5.9.3"
   },

package/dist/index.js

@@ -1,360 +0,0 @@
-#!/usr/bin/env node
-import fs from "node:fs";
-import readline from "readline";
-import { execSync, spawn } from "node:child_process";
-import { stdout, stdin, exit, platform, argv } from "node:process";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-import { render } from "./rendering.js";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const OXLINT_VERSION = "1.41.0";
-const TSGOLINT_VERSION = "0.11.1";
-const KEY_MAP = {
-    k: { type: "MOVE_UP" },
-    up: { type: "MOVE_UP" },
-    down: { type: "MOVE_DOWN" },
-    j: { type: "MOVE_DOWN" },
-    left: { type: "MOVE_LEFT" },
-    h: { type: "MOVE_LEFT" },
-    right: { type: "MOVE_RIGHT" },
-    l: { type: "MOVE_RIGHT" },
-    return: { type: "OPEN_DOCS" },
-    enter: { type: "OPEN_DOCS" },
-    "1": { type: "SET_STATUS", value: "off" },
-    "2": { type: "SET_STATUS", value: "warn" },
-    "3": { type: "SET_STATUS", value: "error" },
-    q: { type: "EXIT" },
-    r: { type: "RUN_LINT" },
-    x: { type: "RUN_SINGLE_RULE" },
-};
-export let state = {
-    activePane: 0,
-    selectedCategoryIndex: 0,
-    selectedRuleIndex: 0,
-    categoryScroll: 0,
-    ruleScroll: 0,
-    isLintInProgress: false,
-    message: "oxlint-tui",
-    messageType: "dim",
-    ...loadRules(),
-};
-function updateConfig(rule, newStatus) {
-    if (!state.configPath || !state.config)
-        return;
-    try {
-        if (!state.config.rules)
-            state.config.rules = {};
-        const ruleName = rule.value;
-        const canonicalKey = rule.scope === "oxc2" || rule.scope === "eslint" ? ruleName : `${rule.scope}/${ruleName}`;
-        const rules = state.config.rules;
-        const existingKey = Object.keys(rules).find((key) => key === canonicalKey || key === ruleName || key.endsWith(`/${ruleName}`));
-        const targetKey = existingKey || canonicalKey;
-        rules[targetKey] = newStatus;
-        fs.writeFileSync(state.configPath, JSON.stringify(state.config, null, 2), "utf8");
-    }
-    catch {
-        state.message = "Failed to write config file";
-        state.messageType = "error";
-    }
-}
-function runLint({ rule = null } = {}) {
-    if (state.isLintInProgress)
-        return;
-    state.isLintInProgress = true;
-    let ruleName = rule ? `${rule.scope}/${rule.value}` : null;
-    const typeAware = rule
-        ? rule.type_aware
-        : Object.values(state.rulesByCategory)
-            .flat()
-            .some((ruleItem) => ruleItem.isActive && ruleItem.type_aware === true);
-    state.message = "Linting";
-    if (ruleName)
-        state.message += ` [${ruleName}]`;
-    if (typeAware)
-        state.message += " with --type-aware";
-    state.message += "...";
-    state.messageType = "info";
-    render();
-    const npxCmd = platform === "win32" ? "npx.cmd" : "npx";
-    const args = ["-q", "--yes", "--package", `oxlint@${OXLINT_VERSION}`];
-    if (typeAware) {
-        args.push("--package", `oxlint-tsgolint@${TSGOLINT_VERSION}`);
-    }
-    args.push("--", "oxlint");
-    if (typeAware) {
-        args.push("--type-aware");
-    }
-    if (ruleName) {
-        args.push("-A", "all", "-D", ruleName);
-    }
-    const child = spawn(npxCmd, args);
-    let stdoutData = "";
-    let stderrData = "";
-    child.stdout.on("data", (data) => {
-        stdoutData += data;
-    });
-    child.stderr.on("data", (data) => {
-        stderrData += data;
-    });
-    child.on("close", (code) => {
-        state.isLintInProgress = false;
-        const fullOutput = stdoutData + stderrData;
-        const summaryMatch = fullOutput.match(/Found (\d+) warnings? and (\d+) errors?/i);
-        if (summaryMatch) {
-            const errors = parseInt(summaryMatch[2]);
-            state.message = ruleName
-                ? `[${ruleName}] Found ${errors} issue${errors === 1 ? "" : "s"}`
-                : summaryMatch[0];
-            state.messageType = errors > 0 ? "error" : "warn";
-        }
-        else if (stdoutData.toLowerCase().includes("finished") ||
-            (code === 0 && stdoutData.length < 200)) {
-            state.message = "Linting passed! 0 issues found.";
-            if (ruleName)
-                state.message = `[${ruleName}] ${state.message}`;
-            state.messageType = "success";
-        }
-        else {
-            const cleanError = stderrData
-                .split("\n")
-                .filter((l) => !l.includes("experimental") && !l.includes("Breaking changes") && l.trim() !== "")
-                .join(" ");
-            state.message = cleanError ? `Error: ${cleanError.substring(0, 50)}...` : "Lint failed";
-            state.messageType = "error";
-        }
-        render();
-    });
-}
-function execute(action) {
-    if (!action)
-        return;
-    const { categories, rulesByCategory, selectedCategoryIndex, selectedRuleIndex, activePane } = state;
-    const currentCategory = categories[selectedCategoryIndex];
-    const currentCategoryRules = rulesByCategory[currentCategory] || [];
-    const viewportHeight = stdout.rows - 8;
-    const statsBoxHeight = 7;
-    const categoryListHeight = viewportHeight - statsBoxHeight;
-    switch (action.type) {
-        case "EXIT":
-            exitAltScreen();
-            exit(0);
-            return;
-        case "RUN_LINT":
-            runLint();
-            return;
-        case "RUN_SINGLE_RULE": {
-            const rule = currentCategoryRules[selectedRuleIndex];
-            if (rule)
-                runLint({ rule });
-            return;
-        }
-        case "OPEN_DOCS": {
-            if (activePane === 1) {
-                const rule = currentCategoryRules[selectedRuleIndex];
-                if (rule)
-                    openUrl(rule.docs_url || rule.url);
-            }
-            return;
-        }
-        case "SET_STATUS": {
-            if (activePane !== 1 || !action.value)
-                return;
-            const rule = currentCategoryRules[selectedRuleIndex];
-            if (!rule)
-                return;
-            updateConfig(rule, action.value);
-            const updatedRules = [...currentCategoryRules];
-            updatedRules[selectedRuleIndex] = {
-                ...rule,
-                configStatus: action.value,
-                isActive: action.value === "error" || action.value === "warn",
-            };
-            state = {
-                ...state,
-                message: `Rule '${rule.value}' set to: ${action.value}`,
-                messageType: "info",
-                rulesByCategory: {
-                    ...rulesByCategory,
-                    [currentCategory]: updatedRules,
-                },
-            };
-            render();
-            return;
-        }
-        case "MOVE_RIGHT":
-            if (activePane !== 1) {
-                state = { ...state, activePane: activePane + 1 };
-                render();
-            }
-            return;
-        case "MOVE_LEFT":
-            if (activePane !== 0) {
-                state = { ...state, activePane: activePane - 1 };
-                render();
-            }
-            return;
-        case "MOVE_UP":
-            if (activePane === 0) {
-                const nextIndex = selectedCategoryIndex === 0 ? categories.length - 1 : selectedCategoryIndex - 1;
-                state = {
-                    ...state,
-                    selectedCategoryIndex: nextIndex,
-                    selectedRuleIndex: 0,
-                    ruleScroll: 0,
-                    categoryScroll: updateScroll(nextIndex, state.categoryScroll, categoryListHeight),
-                };
-            }
-            else if (activePane === 1) {
-                const nextIndex = selectedRuleIndex === 0 ? currentCategoryRules.length - 1 : selectedRuleIndex - 1;
-                state = {
-                    ...state,
-                    selectedRuleIndex: nextIndex,
-                    ruleScroll: updateScroll(nextIndex, state.ruleScroll, viewportHeight),
-                };
-            }
-            render();
-            return;
-        case "MOVE_DOWN":
-            if (activePane === 0) {
-                const nextIndex = selectedCategoryIndex === categories.length - 1 ? 0 : selectedCategoryIndex + 1;
-                state = {
-                    ...state,
-                    selectedCategoryIndex: nextIndex,
-                    selectedRuleIndex: 0,
-                    ruleScroll: 0,
-                    categoryScroll: updateScroll(nextIndex, state.categoryScroll, categoryListHeight),
-                };
-            }
-            else if (activePane === 1) {
-                const nextIndex = selectedRuleIndex === currentCategoryRules.length - 1 ? 0 : selectedRuleIndex + 1;
-                state = {
-                    ...state,
-                    selectedRuleIndex: nextIndex,
-                    ruleScroll: updateScroll(nextIndex, state.ruleScroll, viewportHeight),
-                };
-            }
-            render();
-            return;
-    }
-}
-function getRuleStatus(ruleName, category, config) {
-    if (config.rules) {
-        let val = config.rules[ruleName];
-        if (val === undefined) {
-            const foundKey = Object.keys(config.rules).find((key) => key.endsWith(`/${ruleName}`));
-            if (foundKey)
-                val = config.rules[foundKey];
-        }
-        if (val !== undefined) {
-            const status = Array.isArray(val) ? val[0] : val;
-            return status;
-        }
-    }
-    if (config.categories && config.categories[category]) {
-        return config.categories[category];
-    }
-    return "off";
-}
-function stripJsonComments(json) {
-    return json.replace(/\\"|"(?:\\"|[^"])*"|(\/\/.*|\/\*[\s\S]*?\*\/)/g, (m, g) => (g ? "" : m));
-}
-function loadRules() {
-    let rulesData = [];
-    let config = {
-        rules: {},
-        categories: {},
-    };
-    let configPath = null;
-    let descriptions = {};
-    const descriptionsPath = join(__dirname, "./", "rule-descriptions.json");
-    try {
-        if (fs.existsSync(descriptionsPath)) {
-            descriptions = JSON.parse(fs.readFileSync(descriptionsPath, "utf8"));
-        }
-    }
-    catch {
-        state.message = "Error: Couldn't find description.";
-        state.messageType = "error";
-    }
-    try {
-        const raw = execSync(`npx -q --yes oxlint@${OXLINT_VERSION} --rules --format=json`, {
-            encoding: "utf8",
-            stdio: ["ignore", "pipe", "ignore"],
-        });
-        rulesData = JSON.parse(raw);
-    }
-    catch {
-        state.message = "Error: Couldn't run 'npx oxlint'.";
-        state.messageType = "error";
-        exit(1);
-    }
-    const userConfigPath = argv[2];
-    if (userConfigPath && fs.existsSync(userConfigPath)) {
-        configPath = userConfigPath;
-    }
-    else if (fs.existsSync(".oxlintrc.json")) {
-        configPath = ".oxlintrc.json";
-    }
-    if (configPath) {
-        try {
-            config = JSON.parse(stripJsonComments(fs.readFileSync(configPath, "utf8")));
-        }
-        catch {
-            state.message = "Error: Couldn't parse config.";
-            state.messageType = "error";
-        }
-    }
-    const map = {};
-    rulesData.forEach((rule) => {
-        const cat = rule.category || "Uncategorized";
-        if (!map[cat])
-            map[cat] = [];
-        const status = getRuleStatus(rule.value, cat, config);
-        const description = descriptions[rule.scope]?.[rule.value];
-        map[cat].push({
-            ...rule,
-            description,
-            configStatus: status,
-            isActive: status === "error" || status === "warn",
-        });
-    });
-    const categories = Object.keys(map).toSorted();
-    return {
-        categories,
-        rulesByCategory: map,
-        config,
-        configPath,
-    };
-}
-function updateScroll(idx, currentScroll, viewHeight) {
-    if (idx < currentScroll)
-        return idx;
-    if (idx >= currentScroll + viewHeight)
-        return idx - viewHeight + 1;
-    return currentScroll;
-}
-function openUrl(url) {
-    if (!url)
-        return;
-    const cmd = platform === "darwin" ? "open" : platform === "win32" ? "explorer" : "xdg-open";
-    const process = spawn(cmd, [url], {
-        detached: true,
-        stdio: "ignore",
-    });
-    process.unref();
-}
-const write = (str) => stdout.write(str);
-const enterAltScreen = () => write("\x1b[?1049h\x1b[?25l");
-const exitAltScreen = () => write("\x1b[?1049l\x1b[?25h");
-readline.emitKeypressEvents(stdin);
-if (stdin.isTTY)
-    stdin.setRawMode(true);
-stdin.on("keypress", (_, key) => {
-    const action = KEY_MAP[key.name] ||
-        (key.ctrl && key.name === "c" ? { type: "EXIT" } : KEY_MAP[key.sequence] || null);
-    execute(action);
-});
-stdout.on("resize", render);
-enterAltScreen();
-render();

package/dist/rendering.js

@@ -1,166 +0,0 @@
-import { state } from "./index.js";
-import { stdout } from "node:process";
-export const COLORS = {
-    reset: "\x1b[0m",
-    dim: "\x1b[38;5;242m",
-    highlight: "\x1b[38;5;111m",
-    selectedBg: "\x1b[48;5;24m\x1b[38;5;255m\x1b[1m",
-    borderActive: "\x1b[38;5;111m",
-    borderInactive: "\x1b[38;5;237m",
-    error: "\x1b[38;5;203m",
-    warn: "\x1b[38;5;215m",
-    success: "\x1b[38;5;114m",
-    info: "\x1b[38;5;75m",
-};
-function chunkString(str, len) {
-    if (!str)
-        return [];
-    const size = Math.ceil(str.length / len);
-    const r = Array(size);
-    for (let i = 0; i < size; i++)
-        r[i] = str.substring(i * len, (i + 1) * len);
-    return r;
-}
-function drawBox(buffer, x, y, width, height, title, items, selectedIndex, scrollOffset, isActive) {
-    const borderColor = isActive ? COLORS.borderActive : COLORS.borderInactive;
-    const titleClean = title.length > width - 6 ? title.substring(0, width - 7) + "…" : title;
-    const topBorder = `${borderColor}┌─ ${titleClean} `.padEnd(width + borderColor.length - 1, "─");
-    buffer.push(`\x1b[${y};${x}H${topBorder}┐${COLORS.reset}`);
-    for (let i = 1; i < height - 1; i++) {
-        buffer.push(`\x1b[${y + i};${x}H${borderColor}│${" ".repeat(width - 2)}│${COLORS.reset}`);
-    }
-    buffer.push(`\x1b[${y + height - 1};${x}H${borderColor}└${"─".repeat(width - 2)}┘${COLORS.reset}`);
-    const innerHeight = height - 2;
-    items.slice(scrollOffset, scrollOffset + innerHeight).forEach((item, i) => {
-        const absoluteIndex = scrollOffset + i;
-        const isRule = typeof item !== "string";
-        const rawText = isRule ? item.value : item;
-        let display = rawText.length > width - 4
-            ? rawText.substring(0, width - 5) + "…"
-            : rawText.padEnd(width - 4);
-        let itemColor = COLORS.dim;
-        if (isRule) {
-            const ruleItem = item;
-            if (ruleItem.configStatus === "error")
-                itemColor = COLORS.error;
-            else if (ruleItem.configStatus === "warn")
-                itemColor = COLORS.warn;
-            else if (ruleItem.isActive)
-                itemColor = COLORS.success;
-        }
-        buffer.push(`\x1b[${y + 1 + i};${x + 2}H`);
-        if (absoluteIndex === selectedIndex) {
-            buffer.push(isActive
-                ? `${COLORS.selectedBg}${display}${COLORS.reset}`
-                : `${COLORS.dim}\x1b[7m${display}${COLORS.reset}`);
-        }
-        else {
-            buffer.push(`${itemColor}${display}${COLORS.reset}`);
-        }
-    });
-}
-function drawStats(buffer, x, y, width, height, rules) {
-    const borderColor = COLORS.borderInactive;
-    const topBorder = `${borderColor}┌─ STATS `.padEnd(width + borderColor.length - 1, "─");
-    buffer.push(`\x1b[${y};${x}H${topBorder}┐${COLORS.reset}`);
-    for (let i = 1; i < height - 1; i++)
-        buffer.push(`\x1b[${y + i};${x}H${borderColor}│${" ".repeat(width - 2)}│${COLORS.reset}`);
-    buffer.push(`\x1b[${y + height - 1};${x}H${borderColor}└${"─".repeat(width - 2)}┘${COLORS.reset}`);
-    let counts = { error: 0, warn: 0, off: 0 };
-    rules.forEach((ruleItem) => {
-        if (ruleItem.configStatus === "error")
-            counts.error++;
-        else if (ruleItem.configStatus === "warn")
-            counts.warn++;
-        else
-            counts.off++;
-    });
-    const lines = [
-        { label: "Error", count: counts.error, color: COLORS.error },
-        { label: "Warn", count: counts.warn, color: COLORS.warn },
-        { label: "Off", count: counts.off, color: COLORS.dim },
-    ];
-    lines.forEach((line, i) => {
-        if (i < height - 2) {
-            const numStr = String(line.count).padStart(3);
-            const labelStr = line.label.padEnd(width - 8);
-            buffer.push(`\x1b[${y + 1 + i};${x + 2}H${line.color}${labelStr}${numStr}${COLORS.reset}`);
-        }
-    });
-}
-function drawDetails(buffer, x, y, width, height, rule, isActive) {
-    const borderColor = isActive ? COLORS.borderActive : COLORS.borderInactive;
-    const topBorder = `${borderColor}┌─ DETAILS `.padEnd(width + borderColor.length - 1, "─");
-    buffer.push(`\x1b[${y};${x}H${topBorder}┐${COLORS.reset}`);
-    for (let i = 1; i < height - 1; i++)
-        buffer.push(`\x1b[${y + i};${x}H${borderColor}│${" ".repeat(width - 2)}│${COLORS.reset}`);
-    buffer.push(`\x1b[${y + height - 1};${x}H${borderColor}└${"─".repeat(width - 2)}┘${COLORS.reset}`);
-    if (!rule)
-        return;
-    let statusDisplay = rule.configStatus.toUpperCase();
-    if (rule.configStatus === "error")
-        statusDisplay = `${COLORS.error}${statusDisplay}${COLORS.reset}`;
-    else if (rule.configStatus === "warn")
-        statusDisplay = `${COLORS.warn}${statusDisplay}${COLORS.reset}`;
-    else
-        statusDisplay = `${COLORS.dim}${statusDisplay}${COLORS.reset}`;
-    const metadata = [
-        ["Name", rule.value],
-        ["Status", statusDisplay],
-        ["Category", rule.category],
-        ["Scope", rule.scope],
-        ["Fix", rule.fix || "N/A"],
-        ["Default", rule.default ? "Yes" : "No"],
-        ["Type-aware", rule.type_aware ? "Yes" : "No"],
-    ];
-    let line = 0;
-    metadata.forEach(([lbl, val]) => {
-        if (line < height - 2) {
-            buffer.push(`\x1b[${y + 1 + line};${x + 2}H${COLORS.highlight}${lbl.padEnd(12)} ${COLORS.reset}${val}`);
-            line++;
-        }
-    });
-    if (line < height - 3)
-        line++;
-    if (line < height - 2) {
-        buffer.push(`\x1b[${y + 1 + line};${x + 2}H${COLORS.reset}Description:${COLORS.reset}`);
-        line++;
-        const cleanDesc = (rule.description ?? "N/A").replace(/\s+/g, " ").trim();
-        const chunks = chunkString(cleanDesc, width - 6);
-        chunks.forEach((chunk) => {
-            if (line < height - 2) {
-                buffer.push(`\x1b[${y + 1 + line};${x + 2}H${COLORS.dim}${chunk}${COLORS.reset}`);
-                line++;
-            }
-        });
-    }
-    const footerLine = Math.max(line + 1, height - 3);
-    if (footerLine < height - 1) {
-        buffer.push(`\x1b[${y + 1 + footerLine};${x + 2}HHit ${COLORS.highlight}ENTER${COLORS.reset} to open docs`);
-    }
-}
-export function render() {
-    if (!state || !state.categories) {
-        return;
-    }
-    const { columns = 80, rows = 24 } = stdout;
-    const currentCategory = state.categories[state.selectedCategoryIndex];
-    const rules = state.rulesByCategory[currentCategory] || [];
-    const rule = rules[state.selectedRuleIndex];
-    const boxHeight = rows - 5;
-    const categoriesColumnWidth = Math.floor(columns * 0.2);
-    const rulesColumnWidth = Math.floor(columns * 0.3);
-    const detailsColumnWidth = columns - categoriesColumnWidth - rulesColumnWidth - 2;
-    const statsHeight = 6;
-    const categoryListHeight = boxHeight - statsHeight;
-    const buffer = ["\x1b[H\x1b[J"];
-    drawBox(buffer, 1, 1, categoriesColumnWidth, categoryListHeight, "CATEGORIES", state.categories, state.selectedCategoryIndex, state.categoryScroll, state.activePane === 0);
-    drawStats(buffer, 1, 1 + categoryListHeight, categoriesColumnWidth, statsHeight, rules);
-    drawBox(buffer, categoriesColumnWidth + 1, 1, rulesColumnWidth, boxHeight, `RULES (${rules.length})`, rules, state.selectedRuleIndex, state.ruleScroll, state.activePane === 1);
-    drawDetails(buffer, categoriesColumnWidth + rulesColumnWidth + 1, 1, detailsColumnWidth, boxHeight, rule, state.activePane === 2);
-    const msgColor = COLORS[state.messageType] || COLORS.reset;
-    buffer.push(`\x1b[${rows - 3};2H${msgColor}● ${state.message}${COLORS.reset}`);
-    const footerConfig = state.configPath ? `Config: ${state.configPath}` : "No config loaded";
-    buffer.push(`\x1b[${rows - 1};2H${COLORS.dim}Arrows/HJKL: Nav | 1-3: Status | R: Lint | X: Run rule | Enter: Docs | Q: Quit | ${footerConfig}${COLORS.reset}`);
-    stdout.write(buffer.join(""));
-}