metwatch 0.1.0 → 0.2.0

package/src/types/blessed.d.ts

@@ -1,332 +0,0 @@
-// ---------------------------------------------------------------------------
-// Ambient declarations for blessed and blessed-contrib
-//
-// We use a local declaration file instead of @types/blessed because:
-//   1. @types/blessed (0.1.20, 2019) predates many blessed APIs and conflicts
-//      with Bun's bundler module resolution.
-//   2. We only need the subset of the API that MetWatch actually uses.
-//   3. This file is authoritative and won't drift when npm packages change.
-//
-// Add declarations here as new blessed features are consumed.
-// ---------------------------------------------------------------------------
-
-declare module 'blessed' {
-  import { EventEmitter } from 'events';
-
-  // ── Style objects ─────────────────────────────────────────────────────────
-
-  interface BorderStyle {
-    type?: 'line' | 'bg';
-    fg?: string;
-    bg?: string;
-  }
-
-  interface ScrollbarStyle {
-    ch?: string;
-    fg?: string;
-    bg?: string;
-    track?: { bg?: string; fg?: string };
-  }
-
-  interface ElementStyle {
-    fg?: string;
-    bg?: string;
-    bold?: boolean;
-    underline?: boolean;
-    border?: BorderStyle;
-    scrollbar?: ScrollbarStyle;
-    label?: Partial<ElementStyle>;
-    focus?: Partial<ElementStyle>;
-    hover?: Partial<ElementStyle>;
-    selected?: Partial<ElementStyle>;
-    item?: Partial<ElementStyle>;
-    header?: Partial<ElementStyle>;
-    cell?: Partial<ElementStyle>;
-    bar?: Partial<ElementStyle>;
-  }
-
-  // ── Options ───────────────────────────────────────────────────────────────
-
-  interface ScreenOptions {
-    smartCSR?: boolean;
-    fastCSR?: boolean;
-    fullUnicode?: boolean;
-    dockBorders?: boolean;
-    title?: string;
-    debug?: boolean;
-    ignoreLocked?: string[];
-    autoPadding?: boolean;
-  }
-
-  interface ElementOptions {
-    parent?: BlessedElement | BlessedScreen;
-    top?: number | string;
-    left?: number | string;
-    width?: number | string;
-    height?: number | string;
-    right?: number | string;
-    bottom?: number | string;
-    content?: string;
-    label?: string;
-    tags?: boolean;
-    border?: BorderStyle | { type: string };
-    style?: ElementStyle;
-    scrollable?: boolean;
-    alwaysScroll?: boolean;
-    scrollbar?: ScrollbarStyle | boolean;
-    keys?: boolean;
-    vi?: boolean;
-    mouse?: boolean;
-    hidden?: boolean;
-    padding?: number | { top?: number; right?: number; bottom?: number; left?: number };
-    shrink?: boolean;
-    focusable?: boolean;
-    input?: boolean;
-    clickable?: boolean;
-    interactive?: boolean;
-  }
-
-  interface BoxOptions extends ElementOptions {}
-
-  interface ListOptions extends ElementOptions {
-    items?: string[];
-    invertSelected?: boolean;
-  }
-
-  interface ListTableOptions extends ElementOptions {
-    data?: string[][];
-    rows?: string[][];
-    pad?: number;
-    noCellBorders?: boolean;
-    fillCellBorders?: boolean;
-  }
-
-  interface LogOptions extends ElementOptions {
-    scrollback?: number;
-    scrollOnInput?: boolean;
-  }
-
-  interface ProgressBarOptions extends ElementOptions {
-    orientation?: 'horizontal' | 'vertical';
-    pch?: string;
-    filled?: number;
-    value?: number;
-  }
-
-  interface QuestionOptions extends ElementOptions {}
-  interface MessageOptions extends ElementOptions {}
-
-  // ── Elements ──────────────────────────────────────────────────────────────
-
-  class BlessedElement extends EventEmitter {
-    width: number;
-    height: number;
-    top: number;
-    left: number;
-    content: string;
-    hidden: boolean;
-
-    setContent(text: string): void;
-    getContent(): string;
-    setText(text: string): void;
-    setLabel(text: string): void;
-    show(): void;
-    hide(): void;
-    toggle(): void;
-    focus(): void;
-    render(): void;
-    destroy(): void;
-    key(keys: string | string[], handler: (ch: string, key: KeyEvent) => void): void;
-    onceKey(keys: string | string[], handler: (ch: string, key: KeyEvent) => void): void;
-    unkey(keys: string | string[], handler: (ch: string, key: KeyEvent) => void): void;
-    on(event: string, handler: (...args: unknown[]) => void): this;
-    append(child: BlessedElement): void;
-    remove(child: BlessedElement): void;
-  }
-
-  class BlessedScreen extends BlessedElement {
-    cols: number;
-    rows: number;
-    focused: BlessedElement;
-
-    render(): void;
-    destroy(): void;
-    key(keys: string | string[], handler: (ch: string, key: KeyEvent) => void): void;
-    append(child: BlessedElement): void;
-    remove(child: BlessedElement): void;
-  }
-
-  class Box extends BlessedElement {
-    constructor(options?: BoxOptions);
-  }
-
-  class Log extends BlessedElement {
-    constructor(options?: LogOptions);
-    log(text: string): void;
-    add(text: string): void;
-  }
-
-  class ListTable extends BlessedElement {
-    constructor(options?: ListTableOptions);
-    setData(data: string[][]): void;
-    setRows(rows: string[][]): void;
-  }
-
-  class ProgressBar extends BlessedElement {
-    constructor(options?: ProgressBarOptions);
-    setProgress(amount: number): void;
-    progress(amount: number): void;
-    reset(): void;
-  }
-
-  class Question extends BlessedElement {
-    constructor(options?: QuestionOptions);
-    ask(question: string, callback: (err: Error | null, value: boolean) => void): void;
-  }
-
-  class Message extends BlessedElement {
-    constructor(options?: MessageOptions);
-    display(text: string, time: number, callback?: () => void): void;
-    error(text: string, time: number, callback?: () => void): void;
-  }
-
-  // ── Keyboard event ────────────────────────────────────────────────────────
-
-  interface KeyEvent {
-    name: string;
-    ctrl: boolean;
-    meta: boolean;
-    shift: boolean;
-    sequence: string;
-    full: string;
-  }
-
-  // ── Factory functions ─────────────────────────────────────────────────────
-
-  function screen(options?: ScreenOptions): BlessedScreen;
-  function box(options?: BoxOptions): Box;
-  function log(options?: LogOptions): Log;
-  function listtable(options?: ListTableOptions): ListTable;
-  function progressbar(options?: ProgressBarOptions): ProgressBar;
-  function question(options?: QuestionOptions): Question;
-  function message(options?: MessageOptions): Message;
-}
-
-declare module 'blessed-contrib' {
-  import type { BlessedElement, BlessedScreen, ElementOptions } from 'blessed';
-
-  // ── Grid ──────────────────────────────────────────────────────────────────
-
-  interface GridOptions {
-    rows: number;
-    cols: number;
-    screen: BlessedScreen;
-    hideBorder?: boolean;
-    color?: string;
-  }
-
-  type WidgetConstructor<T> = new (options: ElementOptions) => T;
-
-  class grid {
-    constructor(options: GridOptions);
-    set<T extends BlessedElement>(
-      row: number,
-      col: number,
-      rowSpan: number,
-      colSpan: number,
-      widget: WidgetConstructor<T> | ((options: ElementOptions) => T),
-      options: Record<string, unknown>
-    ): T;
-  }
-
-  // ── Gauge ─────────────────────────────────────────────────────────────────
-
-  interface GaugeOptions extends ElementOptions {
-    label?: string;
-    stroke?: string;
-    fill?: string;
-    percent?: number;
-    showLabel?: boolean;
-  }
-
-  class gauge extends BlessedElement {
-    constructor(options?: GaugeOptions);
-    setPercent(percent: number): void;
-    setData(data: { percent: number; label?: string }): void;
-  }
-
-  // ── GaugeList (stacked gauges) ────────────────────────────────────────────
-
-  interface GaugeListOptions extends ElementOptions {
-    label?: string;
-    gauges?: Array<{ percent: number; stroke?: string; label?: string }>;
-  }
-
-  class gaugeList extends BlessedElement {
-    constructor(options?: GaugeListOptions);
-    setGauges(gauges: Array<{ percent: number; stroke?: string; label?: string }>): void;
-  }
-
-  // ── Table ─────────────────────────────────────────────────────────────────
-
-  interface TableOptions extends ElementOptions {
-    keys?: boolean;
-    vi?: boolean;
-    mouse?: boolean;
-    interactive?: boolean;
-    label?: string;
-    columnSpacing?: number;
-    columnWidth?: number[];
-  }
-
-  class table extends BlessedElement {
-    constructor(options?: TableOptions);
-    setData(data: { headers: string[]; data: string[][] }): void;
-  }
-
-  // ── Log ───────────────────────────────────────────────────────────────────
-
-  interface ContribLogOptions extends ElementOptions {
-    label?: string;
-    bufferLength?: number;
-    scrollbar?: { ch?: string };
-  }
-
-  class log extends BlessedElement {
-    constructor(options?: ContribLogOptions);
-    log(text: string): void;
-    add(text: string): void;
-  }
-
-  // ── Line chart ────────────────────────────────────────────────────────────
-
-  interface LineSeries {
-    title?: string;
-    x: string[];
-    y: number[];
-    style?: { line?: string };
-  }
-
-  interface LineOptions extends ElementOptions {
-    label?:          string;
-    showLegend?:     boolean;
-    legend?:         { width?: number };
-    xLabelPadding?:  number;
-    xPadding?:       number;
-    numYLabels?:     number;
-    showNthLabel?:   number;
-    wholeNumbersOnly?: boolean;
-    minY?:           number;
-    maxY?:           number;
-    style?: {
-      line?:     string | string[];
-      text?:     string;
-      baseline?: string;
-    };
-  }
-
-  class line extends BlessedElement {
-    constructor(options?: LineOptions);
-    setData(data: LineSeries | LineSeries[]): void;
-  }
-}

package/src/ui/layout.ts

@@ -1,318 +0,0 @@
-// ---------------------------------------------------------------------------
-// Layout — Dynamic Collapsible Grid
-//
-// btop-inspired layout: all panels live on one screen, user can toggle each
-// panel on/off with a key. Hidden panels collapse; remaining panels expand.
-//
-// Default grid (all panels visible, ~50 row terminal assumed):
-//
-//   ┌────────────┬────────────┬────────────┐  ← row A  height ~20%
-//   │   CPU      │  Memory    │   Disk     │
-//   ├────────────┴────────────┴────────────┤  ← row B  height ~18%
-//   │   Network            │  Runtime      │
-//   ├─────────────────────────────────────┤  ← row C  height ~32%
-//   │          Processes                  │
-//   ├─────────────────────────────────────┤  ← row D  height ~30%
-//   │          Logs                       │
-//   └─────────────────────────────────────┘
-//
-// Panel toggle keys:
-//   d  → Disk        n  → Network
-//   R  → Runtime     p  → Processes
-//   l  → Logs (focus/toggle)
-//   (CPU and Memory are always visible)
-//
-// Heights are recalculated every time a panel is toggled. The layout
-// re-builds widget positions using blessed's hide()/show() — no widget
-// teardown needed (positions are updated via .top/.height attributes).
-// ---------------------------------------------------------------------------
-
-import blessed from 'blessed';
-import type { BlessedScreen, BlessedElement } from 'blessed';
-import type { ResolvedConfig } from '../types/config.types.ts';
-import type { LauncherHandle }   from '../core/launcher.ts';
-import type { LogManagerHandle } from '../core/log-manager.ts';
-import { createCpuWidget }          from './widgets/cpu.widget.ts';
-import { createMemoryWidget }       from './widgets/memory.widget.ts';
-import { createDiskWidget }         from './widgets/disk.widget.ts';
-import { createNetworkWidget }      from './widgets/network.widget.ts';
-import { createRuntimeWidget }      from './widgets/runtime.widget.ts';
-import { createProcessTableWidget } from './widgets/process-table.widget.ts';
-import { createLogsWidget }         from './widgets/logs.widget.ts';
-
-interface LayoutOptions {
-  screen:     BlessedScreen;
-  config:     ResolvedConfig;
-  launcher:   LauncherHandle | null;
-  logManager: LogManagerHandle | null;
-}
-
-interface LayoutHandles {
-  destroy: () => void;
-}
-
-// ── Height constants (percentages, must sum to 100 when all panels visible) ──
-
-const H = {
-  ROW_A:    20,   // CPU + Memory + Disk
-  ROW_B:    24,   // Network + Runtime (extra height for line graph)
-  ROW_C:    30,   // Processes
-  ROW_D:    26,   // Logs
-} as const;
-
-// ── Utility ───────────────────────────────────────────────────────────────────
-
-type Pct = `${number}%`;
-function pct(n: number): Pct { return `${n}%`; }
-
-/** Given a set of visible row heights (% units), compute their cumulative tops. */
-function tops(heights: number[]): number[] {
-  const result: number[] = [];
-  let acc = 0;
-  for (const h of heights) {
-    result.push(acc);
-    acc += h;
-  }
-  return result;
-}
-
-// ── Factory ───────────────────────────────────────────────────────────────────
-
-export function buildLayout(opts: LayoutOptions): LayoutHandles {
-  const { screen, config, launcher, logManager } = opts;
-
-  const panels = config.panels;
-  const managedNames = new Set<string>(
-    launcher ? launcher.getAll().map(p => p.name) : []
-  );
-
-  // Track which optional panels are currently visible
-  const visible = {
-    disk:      panels.disk      !== false,
-    network:   panels.network   !== false,
-    runtime:   panels.runtime   !== false,
-    processes: panels.processes !== false,
-    logs:      panels.logs      !== false,
-  };
-
-  // ── Create all widgets ─────────────────────────────────────────────────────
-  // Initial positions are placeholders; recalc() sets real values.
-
-  const cpu = createCpuWidget({
-    screen, top: 0, left: 0, width: '34%', height: pct(H.ROW_A),
-  });
-
-  const memory = createMemoryWidget({
-    screen, top: 0, left: '34%', width: '33%', height: pct(H.ROW_A),
-  });
-
-  const disk = createDiskWidget({
-    screen, top: 0, left: '67%', width: '33%', height: pct(H.ROW_A),
-  });
-
-  const network = createNetworkWidget({
-    screen, top: pct(H.ROW_A), left: 0, width: '55%', height: pct(H.ROW_B),
-  });
-
-  const runtime = createRuntimeWidget({
-    screen, top: pct(H.ROW_A), left: '55%', width: '45%', height: pct(H.ROW_B),
-  });
-
-  const processes = createProcessTableWidget({
-    screen,
-    config,
-    getManagedById: (id) => launcher?.get(id),
-    managedNames,
-    top: pct(H.ROW_A + H.ROW_B),
-    left: 0,
-    width: '100%',
-    height: pct(H.ROW_C),
-  });
-
-  const logs = createLogsWidget({
-    screen,
-    logManager: logManager ?? {
-      getLines:   () => [],
-      getAllLines: () => [],
-      clearLines: () => undefined,
-      destroy:    () => undefined,
-    },
-    processCount: managedNames.size,
-    top: pct(H.ROW_A + H.ROW_B + H.ROW_C),
-    left: 0,
-    width: '100%',
-    height: pct(H.ROW_D),
-  });
-
-  // ── Apply initial visibility from config ───────────────────────────────────
-
-  function applyVisibility(): void {
-    // Row A: CPU + Memory always shown; Disk optional.
-    // When Disk is hidden, CPU and Memory each take 50%.
-    const cpuBox     = cpu.box     as unknown as { top: string; left: string; width: string; height: string };
-    const memBox     = memory.box  as unknown as { top: string; left: string; width: string; height: string };
-    const diskBox    = disk.box    as unknown as { top: string; left: string; width: string; height: string; hide: () => void; show: () => void };
-    const netBox     = network.box as unknown as { top: string; left: string; width: string; height: string; hide: () => void; show: () => void };
-    const runtimeBox = runtime.box as unknown as { top: string; left: string; width: string; height: string; hide: () => void; show: () => void };
-    const procBox    = processes.box as unknown as { top: string; height: string; hide: () => void; show: () => void };
-    const logsBox    = logs.box    as unknown as { top: string; height: string; hide: () => void; show: () => void };
-
-    // Row A widths
-    if (visible.disk) {
-      cpuBox.width = '34%'; cpuBox.left = '0%';
-      memBox.width = '33%'; memBox.left = '34%';
-      diskBox.width = '33%'; diskBox.left = '67%';
-      diskBox.show();
-    } else {
-      cpuBox.width = '50%'; cpuBox.left = '0%';
-      memBox.width = '50%'; memBox.left = '50%';
-      diskBox.hide();
-    }
-
-    // Row A height
-    const rowAH = H.ROW_A;
-    cpuBox.height = pct(rowAH); memBox.height = pct(rowAH);
-
-    // Row B: Network + Runtime. If both hidden, row B has height 0.
-    let rowBTop = rowAH;
-    let rowBH   = 0;
-
-    if (visible.network || visible.runtime) {
-      rowBH = H.ROW_B;
-      if (visible.network && visible.runtime) {
-        netBox.width  = '55%'; netBox.left  = '0%';
-        runtimeBox.width = '45%'; runtimeBox.left = '55%';
-      } else if (visible.network) {
-        netBox.width  = '100%'; netBox.left = '0%';
-      } else {
-        runtimeBox.width = '100%'; runtimeBox.left = '0%';
-      }
-      if (visible.network) { netBox.top = pct(rowBTop); netBox.height = pct(rowBH); netBox.show(); }
-      else netBox.hide();
-      if (visible.runtime) { runtimeBox.top = pct(rowBTop); runtimeBox.height = pct(rowBH); runtimeBox.show(); }
-      else runtimeBox.hide();
-    } else {
-      netBox.hide();
-      runtimeBox.hide();
-    }
-
-    // Remaining height after rows A and B
-    const remaining = 100 - rowAH - rowBH;
-
-    // Split remaining between Processes and Logs
-    const showProc = visible.processes;
-    const showLogs = visible.logs;
-
-    let procH = 0;
-    let logsH = 0;
-
-    if (showProc && showLogs) {
-      procH = Math.round(remaining * 0.55);
-      logsH = remaining - procH;
-    } else if (showProc) {
-      procH = remaining;
-    } else if (showLogs) {
-      logsH = remaining;
-    }
-
-    const rowCTop = rowAH + rowBH;
-    const rowDTop = rowCTop + procH;
-
-    if (showProc) {
-      procBox.top = pct(rowCTop); procBox.height = pct(procH); procBox.show();
-    } else {
-      procBox.hide();
-    }
-
-    if (showLogs) {
-      logsBox.top = pct(rowDTop); logsBox.height = pct(logsH); logsBox.show();
-    } else {
-      logsBox.hide();
-    }
-
-    screen.render();
-  }
-
-  applyVisibility();
-
-  // ── Toggle keybindings ─────────────────────────────────────────────────────
-
-  screen.key(['d'], () => {
-    visible.disk = !visible.disk;
-    applyVisibility();
-  });
-
-  screen.key(['n'], () => {
-    visible.network = !visible.network;
-    applyVisibility();
-  });
-
-  screen.key(['R'], () => {
-    visible.runtime = !visible.runtime;
-    applyVisibility();
-  });
-
-  screen.key(['p'], () => {
-    visible.processes = !visible.processes;
-    applyVisibility();
-  });
-
-  // ── Help overlay ───────────────────────────────────────────────────────────
-  // Press ? to show keybindings overlay
-
-  const helpBox = blessed.box({
-    parent: screen as unknown as BlessedElement,
-    top: 'center', left: 'center',
-    width: 52, height: 18,
-    tags: true,
-    border: { type: 'line' },
-    hidden: true,
-    style: { border: { fg: 'white' }, bg: 'black' },
-    label: ' MetWatch — Keybindings ',
-    content: [
-      '',
-      '  {bold}Navigation{/bold}',
-      '  ↑ / k       Move process selection up',
-      '  ↓ / j       Move process selection down',
-      '',
-      '  {bold}View{/bold}',
-      '  a           Process table: All mode',
-      '  f           Process table: Watched mode',
-      '  c / m       Sort by CPU / Memory',
-      '',
-      '  {bold}Panel Toggles{/bold}',
-      '  d           Toggle Disk panel',
-      '  n           Toggle Network panel',
-      '  R           Toggle Runtime panel',
-      '  p           Toggle Process panel',
-      '',
-      '  {bold}Actions{/bold}',
-      '  K           Kill selected process',
-      '  r           Restart managed process',
-      '  s           Stop managed process',
-      '  q / Ctrl+C  Quit',
-      '  ?           Close this help',
-    ].join('\n'),
-  });
-
-  screen.key(['?'], () => {
-    const box = helpBox as unknown as { hidden: boolean; show: () => void; hide: () => void };
-    if (box.hidden) { box.show(); } else { box.hide(); }
-    screen.render();
-  });
-
-  // ── Destroy ────────────────────────────────────────────────────────────────
-
-  function destroy(): void {
-    cpu.destroy();
-    memory.destroy();
-    disk.destroy();
-    network.destroy();
-    runtime.destroy();
-    processes.destroy();
-    logs.destroy();
-    helpBox.destroy();
-  }
-
-  return { destroy };
-}