tuimon 0.2.0 → 0.3.1

package/README.md

@@ -1,145 +1,114 @@
 # TuiMon
 
-> Render beautiful dashboards directly in your terminal. Zero config required.
+> Your HTML, CSS, and JavaScript, rendered directly in the terminal.
 
-## The Simplest Way to Visualize Data in Your Terminal
+## What Is TuiMon?
 
-```bash
-# Visualize any data file instantly
-tuimon data.json
-tuimon users.csv
-tuimon /var/log/nginx/access.log
-
-# Live monitoring from a data function
-tuimon watch metrics.js
+TuiMon takes any HTML page and renders it live in your terminal. Write your dashboard with HTML, CSS flexbox, Chart.js, D3, or whatever you already know, and TuiMon turns it into a real-time terminal application.
 
-# Poll a JSON API
-tuimon watch --url http://localhost:3000/metrics
+No curses. No blessed. No terminal UI framework. Just the web tech you already use.
 
-# Full custom dashboard (HTML/CSS/JS)
-tuimon start
+```
+Your HTML/CSS/JS > Headless Chromium > Screenshot > Terminal Graphics > Your Terminal
 ```
 
-No HTML. No config files. No charting libraries. Just point TuiMon at your data.
-
-## Terminal Support
-
-| Terminal | Protocol | Status |
-|----------|----------|--------|
-| Kitty | Kitty | Supported |
-| Ghostty | Kitty | Supported |
-| WezTerm | Kitty | Supported |
-| iTerm2 | iTerm2 | Supported |
-| **VSCode** | Sixel | **Supported** (requires one setting) |
-| mlterm | Sixel | Supported |
-
-### VSCode Setup
+If it works in a browser, it works in TuiMon.
 
-VSCode supports terminal images but it's **off by default**. Running `tuimon init` enables it automatically by creating `.vscode/settings.json` with:
-
-```json
-{ "terminal.integrated.enableImages": true }
-```
+But you don't have to write HTML if you don't want to. TuiMon also comes with a beautiful built-in theme and a set of zero-config CLI tools that let you visualize files, databases, and live data without writing a single line of HTML.
 
 ## Quick Start
 
 ```bash
 npm install -g tuimon
-tuimon check          # verify your terminal supports graphics
+tuimon init       # scaffolds a starter dashboard
+tuimon start      # renders it in your terminal
 ```
 
-## 1. Instant File Visualization
-
-Point TuiMon at any data file — it auto-detects the format, picks the right charts, and renders a dashboard:
-
-```bash
-# JSON array → table + charts
-tuimon users.json
-
-# CSV → table + charts
-tuimon sales.csv
+---
 
-# Nginx access log → request stats + table
-tuimon /var/log/nginx/access.log
+## 1. Build Your Own Dashboard with HTML
 
-# ModSecurity audit log → security dashboard
-tuimon /var/log/modsec_audit.log
+This is what TuiMon was built for. You write your dashboard as a normal HTML page. Use CSS flexbox, grid, animations, whatever. Use any charting library. TuiMon renders it in your terminal.
 
-# Filter columns
-tuimon access.log --columns "Timestamp,IP,Path,Status"
+```html
+<!-- pages/dashboard.html -->
+<div style="display: flex; gap: 20px; padding: 20px; background: #0a0e1a; color: white; height: 100vh;">
+  <div style="flex: 1; background: #0f1629; border-radius: 8px; padding: 16px;">
+    <h3>CPU Usage</h3>
+    <canvas id="cpuChart"></canvas>
+  </div>
+  <div style="flex: 1; background: #0f1629; border-radius: 8px; padding: 16px;">
+    <h3>Memory</h3>
+    <div id="memValue" style="font-size: 48px; color: #00e5ff;">--</div>
+  </div>
+</div>
+<script src="https://cdn.jsdelivr.net/npm/chart.js@4"></script>
+<script>
+  TuiMon.onUpdate(function(data) {
+    TuiMon.set('#memValue', data.memory + '%')
+    // update your charts, DOM, anything you want
+  })
+</script>
 ```
 
-**Auto-detected formats:**
-- **JSON/JSONL** — arrays of objects → table + stat cards + charts
-- **CSV/TSV** — auto-detects delimiter, header row, column types
-- **Nginx combined log** — request stats, status codes, top endpoints/IPs, browsable request table
-- **ModSecurity audit log** — security events, severity distribution, attack categories, top attacker IPs
-- **JSON logs** — level distribution, latest entries
-- **Plain text** — live tail
-
-**Features:**
-- Press **D** to switch to full-screen data table view, **ESC** to go back
-- Arrow keys / PgUp / PgDn to navigate table pages
-- **F5** to reload file, **F10** to quit
-- File is **watched** — dashboard updates when the file changes on disk
+```typescript
+// tuimon.config.ts
+import tuimon from 'tuimon'
 
-## 2. Live Data Monitoring
+const dash = await tuimon.start({
+  pages: {
+    main: {
+      html: './pages/dashboard.html',
+      default: true,
+      keys: {
+        F5: { label: 'Refresh', action: async () => dash.render(await getData()) },
+        F10: { label: 'Quit', action: () => process.exit(0) },
+      },
+    },
+  },
+  refresh: 1000,
+  data: getData,
+})
+```
 
-Create a JS file that exports a data function — TuiMon handles the rest:
+### Multiple Pages
 
-```js
-// metrics.js
-const os = require('os')
+You can define multiple HTML pages and let users switch between them with keyboard shortcuts. Press a letter to jump to a detail page, ESC to go back.
 
-module.exports = () => ({
-  cpu: Math.round(100 - (os.cpus().reduce((a,c) => a + c.times.idle, 0) / os.cpus().reduce((a,c) => a + Object.values(c.times).reduce((x,y) => x+y, 0), 0)) * 100),
-  memory: Math.round((1 - os.freemem() / os.totalmem()) * 100),
-  uptime: Math.round(process.uptime()) + 's',
-})
+```typescript
+pages: {
+  overview: { html: './pages/overview.html', default: true },
+  cpu:      { html: './pages/cpu-detail.html', shortcut: 'g', label: 'CPU Detail' },
+  memory:   { html: './pages/memory-detail.html', shortcut: 'm', label: 'Memory' },
+}
 ```
 
-```bash
-tuimon watch metrics.js
-```
+### Client Library
 
-TuiMon inspects the returned data and auto-creates the right widgets:
+TuiMon automatically injects a small client script into your HTML pages. You use it to receive data updates:
 
-| Data type | Widget |
-|-----------|--------|
-| Number (0-100 + name like cpu/mem) | Gauge |
-| Number (other) | Stat card |
-| String | Stat card |
-| `{ key: number, ... }` (2+ keys) | Line chart (auto-accumulates history) |
-| `{ key: number }` | Bar chart |
-| `['string', ...]` | Event log (auto-timestamped) |
-| `[{ label, status }, ...]` | Status grid (colored dots) |
+- `TuiMon.onUpdate(callback)` receives data whenever `dash.render(data)` is called
+- `TuiMon.set(selector, value)` is a shortcut to update text content or styles
+- `TuiMon.notify(message)` dispatches a notification event
 
-**Export options:**
+### Shortcut Badges
 
-```js
-module.exports = () => ({ ... })    // data function (required)
-module.exports.refresh = 500        // refresh interval in ms (default: 1000)
-module.exports.title = 'My App'     // dashboard title
-module.exports.layout = { ... }     // override auto-detected layout
-```
+Add `data-tm-key="g"` to any element and TuiMon automatically renders a `[G]` badge in the corner. Users immediately know they can press G to navigate there.
 
-### Poll a JSON API
+### F-Key Bar
 
-```bash
-tuimon watch --url http://localhost:3000/metrics
-tuimon watch --url http://localhost:3000/metrics --interval 2000
-```
+Each page can define its own F-key bindings. The bar at the bottom of the terminal always shows the active page's keys.
 
-## 3. Zero-HTML Declarative Dashboard
+---
 
-For more control without writing HTML, define widgets in a layout config:
+## 2. Use the Built-in Theme (No HTML Needed)
 
-```typescript
-import tuimon from 'tuimon'
+If you don't want to design anything, TuiMon comes with a built-in dark neon theme. Just define your widgets and push data. TuiMon generates the HTML for you behind the scenes.
 
+```typescript
 const dash = await tuimon.start({
   pages: {
-    overview: {
+    main: {
       default: true,
       layout: {
         title: 'My App',
@@ -158,8 +127,8 @@ const dash = await tuimon.start({
   },
   refresh: 500,
   data: () => ({
-    users: getOnlineCount(),
-    cpu: getCpuPercent(),
+    users: 42,
+    cpu: 73,
     traffic: { Requests: 340, Errors: 12 },
     services: { Web: 47, API: 27 },
     events: ['Deploy completed'],
@@ -168,121 +137,162 @@ const dash = await tuimon.start({
 })
 ```
 
-**8 widget types:** `stat`, `gauge`, `line`, `doughnut`, `bar`, `event-log`, `status-grid`, `table`
+### Widget Types
 
-**Per-widget throttle:** Each widget can have its own update rate — charts update every frame while event logs and status grids update less frequently.
+There are 8 built-in widget types: `stat`, `gauge`, `line`, `doughnut`, `bar`, `event-log`, `status-grid`, and `table`.
 
-**Lazy data format:** Every widget accepts the simplest possible data. Just send numbers — TuiMon figures out the rest:
+### Just Send Numbers
 
-```typescript
-dash.render({
-  users: 42,                              // number → stat
-  cpu: 73,                                // number → gauge (0-100)
-  traffic: { Requests: 340, Errors: 12 }, // object → line chart (history auto-accumulated)
-  services: { Web: 47, API: 27 },         // object → doughnut
-  events: ['Deploy completed'],           // string[] → event-log (auto-timestamped)
-  health: ['Node-1', 'Node-2'],           // string[] → status-grid (all "ok")
-})
-```
+You don't need to learn a data format. Just send the simplest thing and TuiMon figures it out:
 
-## 4. Full Custom HTML Dashboard
+| What you send | What TuiMon shows |
+|---------------|-------------------|
+| `42` | Stat card with the number |
+| `73` (for something named cpu or mem) | Gauge bar showing 73% |
+| `{ Requests: 340, Errors: 12 }` | Line chart that builds up over time |
+| `['Deploy completed']` | Event log with automatic timestamps |
+| `['Node-1', 'Node-2']` | Status grid with green dots |
 
-For complete control, write your dashboard as normal HTML/CSS/JS:
+For line charts, you don't manage history. Each render call sends the current values and TuiMon accumulates the history automatically.
+
+### Per-Widget Throttle
+
+Each widget can update at its own speed. Your charts can update every frame while your event log only updates every 2 seconds and your status grid every 5 seconds. Just add `throttle: 2000` to any widget config.
+
+---
+
+## 3. Instant Visualization (Zero Setup)
+
+Sometimes you just need to quickly look at some data. TuiMon can do that too.
+
+### View a File
 
 ```bash
-tuimon init    # scaffolds starter project
-tuimon start   # runs it
+tuimon data.json                    # JSON array of objects, shown as table + charts
+tuimon users.csv                    # CSV file, auto-detects delimiter
+tuimon access.log                   # Nginx access log, shows request stats
+tuimon modsec_audit.log             # ModSecurity log, shows security dashboard
+tuimon data.json -c "name,age"      # Only show specific columns
 ```
 
-TuiMon renders your HTML pages in a headless Chromium browser via Playwright, screenshots them as PNG, and streams the images to your terminal. Any charting library works — Chart.js, D3, ECharts, anything.
+TuiMon auto-detects the file format, picks the right widgets, and builds a dashboard. It also watches the file for changes so the dashboard updates if the file is modified.
 
-### Multi-Page Navigation
+Press D to switch to a full-screen data table. Use arrow keys to page through the data. ESC goes back.
 
-```typescript
-const dash = await tuimon.start({
-  pages: {
-    overview: {
-      html: './pages/overview.html',
-      default: true,
-      label: 'Overview',
-    },
-    cpu: {
-      html: './pages/cpu-detail.html',
-      shortcut: 'g',
-      label: 'CPU Detail',
-    },
-  },
+### Watch Live Data
+
+Create a JS file that exports a function returning your data:
+
+```js
+// metrics.js
+const os = require('os')
+module.exports = () => ({
+  cpu: getCpuPercent(),
+  memory: getMemPercent(),
+  uptime: process.uptime(),
 })
 ```
 
-- Press a shortcut key to jump to a detail page
-- **ESC** on detail page returns to overview
-- **ESC** on overview shows quit confirmation
-- **Ctrl+C** exits immediately from anywhere
+```bash
+tuimon watch metrics.js
+```
+
+TuiMon calls your function every second, auto-detects the data shape, and builds a dashboard.
 
-### Per-Page F-Key Bindings
+You can also poll an HTTP endpoint that returns JSON:
 
-```typescript
-keys: {
-  F5: { label: 'Refresh', action: async () => dash.render(await getData()) },
-  F10: { label: 'Quit', action: () => process.exit(0) },
-}
+```bash
+tuimon watch --url http://localhost:3000/metrics
+tuimon watch --url http://localhost:3000/metrics --interval 5000
 ```
 
-### Client Library
+### View a Database Table
 
-In your HTML pages, the injected `TuiMon` object receives data:
+If you are working on a project that already has a database driver installed and a connection string in `.env`, you can view your data directly:
 
-```javascript
-TuiMon.onUpdate(function(data) {
-  TuiMon.set('#cpu', data.cpu)
-  TuiMon.set('#memory', data.memory + '%')
-})
+```bash
+tuimon db users                          # view a table or collection
+tuimon db users --watch                  # re-query every 2 seconds
+tuimon db "SELECT * FROM orders"         # run a custom query
+tuimon db users --query '{"active":true}'  # MongoDB filter
+tuimon db users --env MY_DB_URI          # use a specific env variable
+tuimon db users -c "name,email,role"     # only show these columns
 ```
 
-Add shortcut badges to panels with data attributes:
+TuiMon finds the database driver in your project's `node_modules/` folder and reads the connection string from your `.env` file. It supports MongoDB, PostgreSQL, MySQL, and SQLite.
 
-```html
-<div class="panel" data-tm-key="g" data-tm-label="CPU Detail">
+No new dependencies are installed. TuiMon uses whatever driver your project already has.
+
+---
+
+## Terminal Support
+
+| Terminal | Protocol | Status |
+|----------|----------|--------|
+| Kitty | Kitty | Supported |
+| Ghostty | Kitty | Supported |
+| WezTerm | Kitty | Supported |
+| iTerm2 | iTerm2 | Supported |
+| VSCode | Sixel | Supported |
+| mlterm | Sixel | Supported |
+
+### VSCode
+
+Running `tuimon init` automatically enables terminal images in VSCode. It creates a `.vscode/settings.json` file with:
+
+```json
+{ "terminal.integrated.enableImages": true }
+```
+
+If you are adding TuiMon to an existing project, add that setting manually or run `tuimon init`.
+
+---
+
+## Global Config
+
+You can set preferences once so you don't have to repeat them:
+
+```bash
+tuimon config db.envVar MONGODB_URI    # which env var holds your DB connection
+tuimon config db.defaultLimit 500      # how many rows to show by default
+tuimon config refresh 250              # default refresh rate in ms
+tuimon config                          # show current config
+tuimon config --reset                  # reset everything to defaults
 ```
 
+Config is stored in `~/.tuimon/config.json`.
+
+---
+
 ## CLI Reference
 
-| Command | Description |
-|---------|-------------|
+| Command | What it does |
+|---------|--------------|
 | `tuimon <file>` | Visualize a JSON, CSV, or log file |
-| `tuimon watch <file.js>` | Live dashboard from a data module |
+| `tuimon watch <file.js>` | Live dashboard from a JS data module |
 | `tuimon watch --url <url>` | Poll a JSON endpoint |
-| `tuimon start` | Run from tuimon.config.ts |
-| `tuimon init` | Scaffold a starter project + enable VSCode |
-| `tuimon check` | Check terminal graphics support |
+| `tuimon db <table or query>` | View a database table or run a query |
+| `tuimon start` | Run a custom HTML dashboard from tuimon.config.ts |
+| `tuimon init` | Scaffold a starter project and enable VSCode |
+| `tuimon check` | Check if your terminal supports graphics |
+| `tuimon config` | View or set global preferences |
+| `tuimon ai` | Print the AI integration guide |
 
-**Options:**
-- `-c, --columns <cols>` — comma-separated list of columns to display
-- `--interval <ms>` — poll interval for URL watch mode (default: 1000)
+Set `TUIMON_DEBUG=1` to print per-frame timing to stderr.
 
-**Environment:**
-- `TUIMON_DEBUG=1` — print per-frame timing to stderr
+---
 
 ## How It Works
 
-```
-Your data → TuiMon → Headless Chromium → Screenshot → Kitty/Sixel → Terminal
-```
+TuiMon runs a headless Chromium browser via Playwright. Your HTML page loads in the browser. TuiMon pushes data into the page, takes a PNG screenshot, encodes it using the Kitty graphics protocol (or Sixel for terminals that need it), and writes it to stdout. The F-key bar and keyboard input run natively in the terminal.
 
-1. Your data is pushed to an HTML page running in headless Chromium
-2. Playwright takes a PNG screenshot
-3. The image is encoded as Kitty graphics protocol (or Sixel fallback)
-4. Written directly to your terminal's stdout
+A typical frame takes about 50ms from data push to pixels on screen.
 
-Typical frame time: **~50ms** (at 250ms refresh = 4 FPS with headroom to spare).
+---
 
 ## Contributing
 
-- **TDD required** — write tests first, implementation second
-- Coverage thresholds: 80% lines, 80% functions, 75% branches
-- `npm test` must pass before any PR
-- Strict TypeScript — `strict: true`, `noUncheckedIndexedAccess`, no `any`
+Tests first, implementation second. Coverage thresholds are 80% lines, 80% functions, and 75% branches. TypeScript is strict with no exceptions.
 
 ## License
 

package/dist/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,wBAAsB,aAAa,CAAC,EAClC,GAAG,EACH,KAAK,EACL,MAAM,GACP,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC,aAAa,CAAC,CAkEzB"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,wBAAsB,aAAa,CAAC,EAClC,GAAG,EACH,KAAK,EACL,MAAM,GACP,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC,aAAa,CAAC,CAqEzB"}

package/dist/browser.js

@@ -1,6 +1,9 @@
 import { chromium } from 'playwright';
 export async function createBrowser({ url, width, height, }) {
-    const browser = await chromium.launch({ headless: true });
+    const browser = await chromium.launch({
+        headless: true,
+        timeout: 30000,
+    });
     const context = await browser.newContext();
     const page = await context.newPage();
     await page.setViewportSize({ width, height });

package/dist/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGrC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAClC,GAAG,EACH,KAAK,EACL,MAAM,GAKP;IACC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IACzD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAA;IAC1C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;IAEpC,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;IAC7C,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAA;IAEvD,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QAC1B,UAAU,EAAE,CAAA;QACZ,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAA;YAChF,OAAM;QACR,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,UAAU,kBAAkB,CAAC,CAAA;QACpF,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,EAAE,CAAA;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,GAAG,CAAC,OAAO,IAAI,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,KAAK,CAAC,UAAU;YACd,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;YAClD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACzB,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,IAA6B;YAC1C,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAA0B,EAAE,EAAE;gBACjD,MAAM,GAAG,GAAG,UAAqC,CAAA;gBACjD,IAAI,OAAO,GAAG,CAAC,mBAAmB,CAAC,KAAK,UAAU,EAAE,CAAC;oBACnD,CAAC;oBAAC,GAAG,CAAC,mBAAmB,CAA0C,CAAC,CAAC,CAAC,CAAA;gBACxE,CAAC;YACH,CAAC,EAAE,IAAI,CAAC,CAAA;YACR,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,eAAe,CACxB,GAAG,EAAE,CAAE,UAAsC,CAAC,kBAAkB,CAAC,KAAK,IAAI,EAC1E,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAA;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,kEAAkE;YACpE,CAAC;QACH,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,MAAc;YAC3B,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAA;QAC5D,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,CAAS,EAAE,CAAS;YAC/B,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;QACrD,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,UAAkB;YAC/B,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;QACjC,CAAC;QAED,KAAK,CAAC,KAAK;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;QACvB,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -18,7 +18,7 @@ const program = new Command();
 program
     .name('tuimon')
     .description('Render beautiful HTML dashboards directly in your terminal.')
-    .version('0.1.0');
+    .version('0.3.0');
 // ─── Default command: tuimon <file> ──────────────────────────────────────────
 program
     .argument('[file]', 'JSON, CSV, or log file to visualize')
@@ -48,6 +48,34 @@ program
         return;
     }
     const columns = opts.columns ? opts.columns.split(',').map((c) => c.trim()).filter(Boolean) : undefined;
+    // Check for preset file patterns first
+    const basename = file.split('/').pop()?.split('\\').pop() ?? '';
+    if (basename === 'package-lock.json' || basename === 'yarn.lock' || basename === 'pnpm-lock.yaml') {
+        if (!existsSync(file)) {
+            console.error(`[tuimon] File not found: ${file}`);
+            process.exit(1);
+        }
+        const { depsPreset } = await import('./quick/presets/deps.js');
+        const { runPreset } = await import('./quick/presets/runner.js');
+        await runPreset(depsPreset(file));
+        return;
+    }
+    if (basename.includes('coverage') || basename.endsWith('.lcov') || (basename.endsWith('.xml') && existsSync(file))) {
+        if (!existsSync(file)) {
+            console.error(`[tuimon] File not found: ${file}`);
+            process.exit(1);
+        }
+        // Check if it's a coverage/junit file
+        try {
+            const { coveragePreset } = await import('./quick/presets/coverage.js');
+            const { runPreset } = await import('./quick/presets/runner.js');
+            await runPreset(coveragePreset(file));
+            return;
+        }
+        catch {
+            // Not a coverage file, fall through to normal detection
+        }
+    }
     // Quick mode: detect file type and visualize
     const { detectInputType } = await import('./quick/detect.js');
     const inputType = detectInputType(file);
@@ -96,6 +124,31 @@ program
         }
     }
 });
+// ─── Preset subcommands ──────────────────────────────────────────────────────
+program
+    .command('docker')
+    .description('Live Docker container dashboard')
+    .action(async () => {
+    const { dockerPreset } = await import('./quick/presets/docker.js');
+    const { runPreset } = await import('./quick/presets/runner.js');
+    await runPreset(dockerPreset());
+});
+program
+    .command('git')
+    .description('Git repository dashboard')
+    .action(async () => {
+    const { gitPreset } = await import('./quick/presets/git.js');
+    const { runPreset } = await import('./quick/presets/runner.js');
+    await runPreset(gitPreset());
+});
+program
+    .command('ps')
+    .description('Live process monitor')
+    .action(async () => {
+    const { psPreset } = await import('./quick/presets/ps.js');
+    const { runPreset } = await import('./quick/presets/runner.js');
+    await runPreset(psPreset());
+});
 // ─── Start command: tuimon start (full config mode) ──────────────────────────
 program
     .command('start')
@@ -177,11 +230,23 @@ program
     }
     if (process.env['TERM_PROGRAM'] === 'vscode') {
         console.log('');
-        console.log('  VSCode detected \u2014 make sure this setting is enabled:');
+        console.log('  VSCode detected. Make sure this setting is enabled:');
         console.log('    "terminal.integrated.enableImages": true');
         console.log('');
         console.log('  Run "tuimon init" to configure this automatically.');
     }
+    // Check if Playwright browser is installed
+    console.log('');
+    try {
+        const { chromium } = await import('playwright');
+        const browser = await chromium.launch({ headless: true, timeout: 10000 });
+        await browser.close();
+        console.log('\u2713 Chromium browser: installed');
+    }
+    catch {
+        console.log('\u2717 Chromium browser: not found');
+        console.log('  Run: npx playwright install chromium');
+    }
     console.log('');
     process.exit(support.protocol ? 0 : 1);
 });