@profullstack/hqtui 0.1.0

package/dist/widgets/table.js

@@ -0,0 +1,228 @@
+import { Attr } from "../buffer.js";
+import { mix } from "../color.js";
+import { fit, stringWidth, truncate } from "../unicode.js";
+import { solve } from "../layout.js";
+import { elevate } from "../theme.js";
+function cellValue(row, column, index) {
+    if (column.render)
+        return column.render(row, index);
+    const v = row[column.key];
+    if (v === null || v === undefined)
+        return "";
+    return String(v);
+}
+/** A dense, column-aligned table with optional selection and scrollbar. */
+export function drawTable(surface, options) {
+    if (surface.empty)
+        return;
+    const theme = surface.theme;
+    const gap = options.gap ?? 1;
+    const showHeader = options.header !== false;
+    const headerRows = showHeader ? 1 : 0;
+    const scrollbar = options.scrollbar ?? false;
+    const bodyWidth = surface.width - (scrollbar ? 1 : 0);
+    const widths = solve(bodyWidth, options.columns.map((c) => ({
+        size: c.width ?? "auto",
+        min: c.min ?? 1,
+        max: c.max,
+        intrinsic: c.width === undefined
+            ? Math.max(stringWidth(c.title ?? c.key), ...options.rows.slice(0, 200).map((r, i) => stringWidth(cellValue(r, c, i))))
+            : 0,
+    })), gap);
+    if (showHeader) {
+        let x = 0;
+        options.columns.forEach((column, i) => {
+            const w = widths[i];
+            if (w <= 0)
+                return;
+            surface.text(x, 0, fit(truncate(column.title ?? column.key, w), w, column.align ?? "left"), {
+                fg: options.headerColor ?? theme.muted,
+                bg: options.background,
+                attrs: Attr.Bold,
+            });
+            x += w + gap;
+        });
+    }
+    const offset = Math.max(0, options.offset ?? 0);
+    const capacity = Math.max(0, surface.height - headerRows);
+    const zebraBg = options.zebra ? elevate(theme, 0.04) : undefined;
+    for (let i = 0; i < capacity; i++) {
+        const rowIndex = offset + i;
+        const row = options.rows[rowIndex];
+        if (row === undefined)
+            break;
+        const y = i + headerRows;
+        const selected = options.selected === rowIndex;
+        const rowBg = selected ? theme.selection : options.zebra && rowIndex % 2 === 1 ? zebraBg : options.background;
+        if (rowBg !== undefined)
+            surface.fillRect(0, y, bodyWidth, 1, { bg: rowBg });
+        let x = 0;
+        options.columns.forEach((column, ci) => {
+            const w = widths[ci];
+            if (w <= 0)
+                return;
+            const text = cellValue(row, column, rowIndex);
+            let fg;
+            if (selected)
+                fg = theme.selectionText;
+            else if (typeof column.color === "function")
+                fg = column.color(row, row[column.key]);
+            else if (column.color !== undefined)
+                fg = column.color;
+            else
+                fg = options.rowColor?.(row, rowIndex);
+            surface.text(x, y, fit(truncate(text, w), w, column.align ?? "left"), {
+                fg: fg ?? theme.foreground,
+                bg: rowBg,
+                attrs: selected ? Attr.Bold : 0,
+            });
+            x += w + gap;
+        });
+        options.onRow?.(row, rowIndex, y);
+    }
+    if (scrollbar && options.rows.length > capacity && capacity > 0) {
+        drawScrollbar(surface, surface.width - 1, headerRows, capacity, options.rows.length, offset);
+    }
+}
+/** A one-column scrollbar. Thumb size reflects the visible fraction. */
+export function drawScrollbar(surface, x, y, height, total, offset) {
+    const theme = surface.theme;
+    const track = mix(theme.background, theme.border, 0.7);
+    const thumbSize = Math.max(1, Math.round((height / total) * height));
+    const maxOffset = Math.max(1, total - height);
+    const thumbPos = Math.round((offset / maxOffset) * (height - thumbSize));
+    for (let i = 0; i < height; i++) {
+        const inThumb = i >= thumbPos && i < thumbPos + thumbSize;
+        surface.char(x, y + i, inThumb ? "█" : "│", { fg: inThumb ? theme.accent : track });
+    }
+}
+export function drawList(surface, options) {
+    if (surface.empty)
+        return;
+    const theme = surface.theme;
+    const width = surface.width - (options.scrollbar ? 1 : 0);
+    const offset = Math.max(0, options.offset ?? 0);
+    for (let i = 0; i < surface.height; i++) {
+        const index = offset + i;
+        const raw = options.items[index];
+        if (raw === undefined)
+            break;
+        const item = typeof raw === "string" ? { label: raw } : raw;
+        const selected = options.selected === index;
+        const bullet = options.bullet ? `${options.bullet} ` : "";
+        const label = `${bullet}${item.label}`;
+        if (selected)
+            surface.fillRect(0, i, width, 1, { bg: theme.selection });
+        surface.text(0, i, fit(truncate(label, width), width), {
+            fg: selected ? theme.selectionText : item.color ?? theme.foreground,
+            bg: selected ? theme.selection : options.background,
+            attrs: selected ? Attr.Bold : 0,
+        });
+    }
+    if (options.scrollbar && options.items.length > surface.height) {
+        drawScrollbar(surface, surface.width - 1, 0, surface.height, options.items.length, offset);
+    }
+}
+function flatten(nodes, depth, trail, out) {
+    nodes.forEach((node, i) => {
+        const last = i === nodes.length - 1;
+        out.push({ node, depth, last: [...trail, last] });
+        if (node.children && node.expanded !== false) {
+            flatten(node.children, depth + 1, [...trail, last], out);
+        }
+    });
+}
+/** An indented tree with box-drawing connectors, like `pstree`. */
+export function drawTree(surface, options) {
+    if (surface.empty)
+        return;
+    const theme = surface.theme;
+    const flat = [];
+    flatten(options.nodes, 0, [], flat);
+    const offset = Math.max(0, options.offset ?? 0);
+    const guides = options.guides !== false;
+    const guideColor = options.guideColor ?? mix(theme.border, theme.foreground, 0.15);
+    for (let i = 0; i < surface.height; i++) {
+        const index = offset + i;
+        const entry = flat[index];
+        if (!entry)
+            break;
+        const selected = options.selected === index;
+        const bg = selected ? theme.selection : options.background;
+        if (selected)
+            surface.fillRect(0, i, surface.width, 1, { bg: theme.selection });
+        let prefix = "";
+        if (guides) {
+            for (let d = 0; d < entry.depth; d++)
+                prefix += entry.last[d] ? "   " : "│  ";
+            prefix += entry.last[entry.depth] ? "└─ " : "├─ ";
+        }
+        else {
+            prefix = "  ".repeat(entry.depth);
+        }
+        const valuesWidth = (entry.node.values ?? []).reduce((a, v) => a + v.width + 1, 0);
+        const labelWidth = Math.max(0, surface.width - valuesWidth);
+        surface.text(0, i, truncate(prefix, labelWidth), { fg: guideColor, bg });
+        const px = Math.min(stringWidth(prefix), labelWidth);
+        surface.text(px, i, truncate(entry.node.label, Math.max(0, labelWidth - px)), {
+            fg: selected ? theme.selectionText : entry.node.color ?? theme.foreground,
+            bg,
+            attrs: selected ? Attr.Bold : 0,
+        });
+        let vx = labelWidth;
+        for (const value of entry.node.values ?? []) {
+            surface.text(vx, i, fit(truncate(value.text, value.width), value.width, value.align ?? "right"), {
+                fg: selected ? theme.selectionText : value.color ?? theme.foreground,
+                bg,
+            });
+            vx += value.width + 1;
+        }
+    }
+}
+/** A tailing log view with colored levels. Newest at the bottom. */
+export function drawLog(surface, options) {
+    if (surface.empty)
+        return;
+    const theme = surface.theme;
+    const levels = {
+        ERROR: theme.danger,
+        WARN: theme.warning,
+        INFO: theme.success,
+        DEBUG: theme.muted,
+        TRACE: theme.muted,
+        FATAL: theme.danger,
+        ...options.levelColors,
+    };
+    const entries = options.entries;
+    const follow = options.follow !== false;
+    const start = follow
+        ? Math.max(0, entries.length - surface.height)
+        : Math.max(0, options.offset ?? 0);
+    for (let i = 0; i < surface.height; i++) {
+        const entry = entries[start + i];
+        if (!entry)
+            break;
+        let x = 0;
+        if (entry.time) {
+            x += surface.text(x, i, `${entry.time} `, { fg: options.timeColor ?? theme.muted, bg: options.background });
+        }
+        if (entry.level) {
+            const color = levels[entry.level.toUpperCase()] ?? theme.foreground;
+            x += surface.text(x, i, fit(entry.level.toUpperCase(), 5), { fg: color, bg: options.background, attrs: Attr.Bold });
+            x += surface.text(x, i, " ", { bg: options.background });
+        }
+        const metaWidth = entry.meta ? stringWidth(entry.meta) + 1 : 0;
+        const msgWidth = Math.max(0, surface.width - x - metaWidth);
+        surface.text(x, i, truncate(entry.message, msgWidth), {
+            fg: entry.color ?? theme.foreground,
+            bg: options.background,
+        });
+        if (entry.meta && metaWidth < surface.width) {
+            surface.text(surface.width - metaWidth + 1, i, entry.meta, {
+                fg: options.metaColor ?? theme.muted,
+                bg: options.background,
+            });
+        }
+    }
+}
+//# sourceMappingURL=table.js.map

package/dist/widgets/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../src/widgets/table.ts"],"names":[],"mappings":"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"}

package/dist/widgets/text.d.ts

@@ -0,0 +1,64 @@
+import type { Surface, Align } from "../surface.ts";
+import type { Style } from "../buffer.ts";
+import type { Color } from "../color.ts";
+export interface TextOptions extends Style {
+    align?: Align;
+    wrap?: boolean;
+    bold?: boolean;
+    dim?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+}
+export declare function drawText(surface: Surface, content: string, options?: TextOptions): void;
+export interface BadgeOptions {
+    text: string;
+    color?: Color;
+    /** Filled reads as a chip; outline keeps the panel quiet. */
+    variant?: "filled" | "outline" | "subtle";
+    align?: Align;
+}
+export declare function drawBadge(surface: Surface, options: BadgeOptions): number;
+export interface KeyValueRow {
+    label: string;
+    value: string;
+    color?: Color;
+    labelColor?: Color;
+}
+export interface KeyValueOptions {
+    rows: KeyValueRow[];
+    /** Columns reserved for labels. Defaults to the widest label. */
+    labelWidth?: number;
+    gap?: number;
+    /** Push values to the right edge instead of next to the label. */
+    spread?: boolean;
+    labelColor?: Color;
+    valueColor?: Color;
+    background?: Color;
+}
+/** Aligned label/value pairs — the backbone of every "System" panel. */
+export declare function drawKeyValues(surface: Surface, options: KeyValueOptions): void;
+export interface DividerOptions {
+    label?: string;
+    color?: Color;
+    char?: string;
+    align?: Align;
+}
+export declare function drawDivider(surface: Surface, options?: DividerOptions): void;
+export interface StatusItem {
+    key?: string;
+    label: string;
+    color?: Color;
+    /** Highlight this entry, e.g. the active tab or a live indicator. */
+    active?: boolean;
+}
+export interface StatusBarOptions {
+    items: StatusItem[];
+    right?: StatusItem[];
+    background?: Color;
+    keyColor?: Color;
+    /** Reverse-video the key caps, like a function-key bar. */
+    keyStyle?: "caps" | "plain";
+}
+/** The F1/F2/F10 bar along the bottom of every serious TUI. */
+export declare function drawStatusBar(surface: Surface, options: StatusBarOptions): void;
+//# sourceMappingURL=text.d.ts.map

package/dist/widgets/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/widgets/text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAKzC,MAAM,WAAW,WAAY,SAAQ,KAAK;IACxC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAWD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,IAAI,CAW3F;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,6DAA6D;IAC7D,OAAO,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1C,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAgBzE;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CA0B9E;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,IAAI,CAahF;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAuC/E"}

package/dist/widgets/text.js

@@ -0,0 +1,123 @@
+import { Attr } from "../buffer.js";
+import { mix } from "../color.js";
+import { fit, stringWidth, truncate, wrap } from "../unicode.js";
+import { elevate } from "../theme.js";
+function attrsOf(o) {
+    let a = o.attrs ?? 0;
+    if (o.bold)
+        a |= Attr.Bold;
+    if (o.dim)
+        a |= Attr.Dim;
+    if (o.italic)
+        a |= Attr.Italic;
+    if (o.underline)
+        a |= Attr.Underline;
+    return a;
+}
+export function drawText(surface, content, options = {}) {
+    if (surface.empty)
+        return;
+    const style = {
+        fg: options.fg ?? surface.theme.foreground,
+        bg: options.bg,
+        attrs: attrsOf(options),
+    };
+    const lines = options.wrap ? wrap(content, surface.width) : content.split("\n");
+    for (let i = 0; i < lines.length && i < surface.height; i++) {
+        surface.text(0, i, fit(truncate(lines[i], surface.width), surface.width, options.align ?? "left"), style);
+    }
+}
+export function drawBadge(surface, options) {
+    if (surface.empty)
+        return 0;
+    const theme = surface.theme;
+    const color = options.color ?? theme.primary;
+    const label = ` ${options.text} `;
+    const variant = options.variant ?? "filled";
+    const style = variant === "filled"
+        ? { fg: theme.dark ? theme.background : theme.surface, bg: color, attrs: Attr.Bold }
+        : variant === "subtle"
+            ? { fg: color, bg: mix(theme.surface, color, 0.18) }
+            : { fg: color, attrs: Attr.Bold };
+    const width = Math.min(stringWidth(label), surface.width);
+    const x = options.align === "right" ? surface.width - width : options.align === "center" ? Math.floor((surface.width - width) / 2) : 0;
+    surface.text(Math.max(0, x), 0, truncate(label, surface.width), style);
+    return width;
+}
+/** Aligned label/value pairs — the backbone of every "System" panel. */
+export function drawKeyValues(surface, options) {
+    if (surface.empty)
+        return;
+    const theme = surface.theme;
+    const rows = options.rows;
+    const gap = options.gap ?? 1;
+    const labelWidth = options.labelWidth ?? Math.min(Math.max(0, ...rows.map((r) => stringWidth(r.label))) + 1, Math.max(4, Math.floor(surface.width * 0.6)));
+    for (let i = 0; i < rows.length && i < surface.height; i++) {
+        const row = rows[i];
+        surface.text(0, i, fit(truncate(row.label, labelWidth), labelWidth), {
+            fg: row.labelColor ?? options.labelColor ?? theme.muted,
+            bg: options.background,
+        });
+        const vx = labelWidth + gap;
+        const vw = Math.max(0, surface.width - vx);
+        if (vw === 0)
+            continue;
+        const value = truncate(row.value, vw);
+        surface.text(vx, i, options.spread === false ? value : fit(value, vw, "right"), {
+            fg: row.color ?? options.valueColor ?? theme.foreground,
+            bg: options.background,
+        });
+    }
+}
+export function drawDivider(surface, options = {}) {
+    if (surface.empty)
+        return;
+    const theme = surface.theme;
+    const color = options.color ?? theme.border;
+    const ch = options.char ?? "─";
+    surface.hline(0, 0, surface.width, ch, { fg: color });
+    if (options.label) {
+        const label = ` ${options.label} `;
+        const w = stringWidth(label);
+        const align = options.align ?? "left";
+        const x = align === "left" ? 1 : align === "right" ? surface.width - w - 1 : Math.floor((surface.width - w) / 2);
+        surface.text(Math.max(0, x), 0, truncate(label, surface.width), { fg: theme.muted });
+    }
+}
+/** The F1/F2/F10 bar along the bottom of every serious TUI. */
+export function drawStatusBar(surface, options) {
+    if (surface.empty)
+        return;
+    const theme = surface.theme;
+    const bg = options.background ?? elevate(theme, 0.04);
+    surface.fill({ bg });
+    let x = 1;
+    const drawItems = (items, startX) => {
+        let cx = startX;
+        for (const item of items) {
+            if (cx >= surface.width)
+                break;
+            if (item.key) {
+                const cap = options.keyStyle === "plain" ? item.key : item.key;
+                const capStyle = options.keyStyle === "plain"
+                    ? { fg: options.keyColor ?? theme.accent, bg, attrs: Attr.Bold }
+                    : { fg: theme.dark ? theme.background : theme.surface, bg: options.keyColor ?? theme.accent, attrs: Attr.Bold };
+                cx += surface.text(cx, 0, cap, capStyle);
+                cx += surface.text(cx, 0, " ", { bg });
+            }
+            cx += surface.text(cx, 0, item.label, {
+                fg: item.active ? theme.foreground : item.color ?? theme.muted,
+                bg,
+                attrs: item.active ? Attr.Bold : 0,
+            });
+            cx += surface.text(cx, 0, "  ", { bg });
+        }
+        return cx;
+    };
+    x = drawItems(options.items, x);
+    if (options.right && options.right.length) {
+        const width = options.right.reduce((a, i) => a + stringWidth(i.label) + (i.key ? stringWidth(i.key) + 1 : 0) + 2, 0);
+        drawItems(options.right, Math.max(x, surface.width - width - 1));
+    }
+}
+//# sourceMappingURL=text.js.map

package/dist/widgets/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/widgets/text.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@profullstack/hqtui",
+  "version": "0.1.0",
+  "description": "High Quality Terminal UI for TypeScript. btop-grade dashboards with a one-import API, dark by default, zero runtime dependencies.",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "bun": ">=1.1",
+    "node": ">=22.6"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./graphics": {
+      "types": "./dist/graphics/index.d.ts",
+      "default": "./dist/graphics/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "bun x tsc -p tsconfig.build.json",
+    "typecheck": "bun x tsc -p tsconfig.json --noEmit"
+  },
+  "keywords": [
+    "tui",
+    "terminal",
+    "cli",
+    "dashboard",
+    "ansi",
+    "braille",
+    "truecolor",
+    "framebuffer",
+    "btop"
+  ],
+  "homepage": "https://hqtui.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/profullstack/hqtui.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}