dockza.app 0.2.0

package/dist/utils/format.js

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.humanUptime = humanUptime;
+exports.humanSizeMB = humanSizeMB;
+exports.relativeTime = relativeTime;
+exports.truncate = truncate;
+exports.truncateMiddle = truncateMiddle;
+exports.stripTags = stripTags;
+exports.visualLength = visualLength;
+exports.padEnd = padEnd;
+const dayjs_1 = __importDefault(require("dayjs"));
+const relativeTime_1 = __importDefault(require("dayjs/plugin/relativeTime"));
+dayjs_1.default.extend(relativeTime_1.default);
+function humanUptime(startedAt) {
+    const totalSeconds = Math.max(0, Math.floor((Date.now() - startedAt.getTime()) / 1000));
+    const days = Math.floor(totalSeconds / 86400);
+    const hours = Math.floor((totalSeconds % 86400) / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const seconds = totalSeconds % 60;
+    if (days > 0)
+        return `${days}d ${hours}h`;
+    if (hours > 0)
+        return `${hours}h ${minutes}m`;
+    if (minutes > 0)
+        return `${minutes}m ${seconds}s`;
+    return `${seconds}s`;
+}
+function humanSizeMB(mb) {
+    if (mb >= 1024)
+        return `${(mb / 1024).toFixed(1)} GiB`;
+    return `${Math.round(mb)} MiB`;
+}
+function relativeTime(date) {
+    return (0, dayjs_1.default)(date).fromNow();
+}
+function truncate(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(0, n - 1) + '…';
+}
+function truncateMiddle(s, maxLen, ellipsis = '…') {
+    if (s.length <= maxLen)
+        return s;
+    if (maxLen <= ellipsis.length)
+        return ellipsis.slice(0, maxLen);
+    const keep = maxLen - ellipsis.length;
+    const left = Math.ceil(keep / 2);
+    const right = Math.floor(keep / 2);
+    return s.slice(0, left) + ellipsis + s.slice(s.length - right);
+}
+function stripTags(s) {
+    return s.replace(/\{[^}]+\}/g, '');
+}
+function visualLength(s) {
+    return stripTags(s).length;
+}
+function padEnd(s, visualLen) {
+    const pad = visualLen - visualLength(s);
+    if (pad <= 0)
+        return s;
+    return s + ' '.repeat(pad);
+}

package/dist/utils/stacks.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NO_STACK = void 0;
+exports.classifyContainer = classifyContainer;
+exports.groupIntoStacks = groupIntoStacks;
+exports.NO_STACK = '(no stack)';
+const COMPOSE_PROJECT_LABEL = 'com.docker.compose.project';
+const DEFAULT_NETWORK_SUFFIX = '_default';
+function classifyContainer(c) {
+    if (c.status === 'running' || c.status === 'paused' || c.status === 'restarting') {
+        return 'running';
+    }
+    if ((c.status === 'exited' || c.status === 'dead') && c.exitCode !== 0) {
+        return 'errored';
+    }
+    return 'stopped';
+}
+function detectStack(c) {
+    const labeled = c.labels[COMPOSE_PROJECT_LABEL];
+    if (labeled)
+        return { id: labeled, isCompose: true };
+    for (const net of c.networks) {
+        if (net.endsWith(DEFAULT_NETWORK_SUFFIX)) {
+            return { id: net.slice(0, -DEFAULT_NETWORK_SUFFIX.length), isCompose: true };
+        }
+    }
+    return { id: exports.NO_STACK, isCompose: false };
+}
+const CLASS_ORDER = { running: 0, errored: 1, stopped: 2 };
+function compareServices(a, b) {
+    const ca = CLASS_ORDER[classifyContainer(a)];
+    const cb = CLASS_ORDER[classifyContainer(b)];
+    if (ca !== cb)
+        return ca - cb;
+    return a.name.localeCompare(b.name);
+}
+function groupIntoStacks(containers) {
+    const grouped = new Map();
+    for (const c of containers) {
+        const { id, isCompose } = detectStack(c);
+        const existing = grouped.get(id);
+        if (existing) {
+            existing.services.push(c);
+            if (isCompose)
+                existing.isCompose = true;
+        }
+        else {
+            grouped.set(id, { isCompose, services: [c] });
+        }
+    }
+    const stacks = [];
+    for (const [id, { isCompose, services }] of grouped) {
+        const counts = { running: 0, errored: 0, stopped: 0 };
+        for (const c of services)
+            counts[classifyContainer(c)]++;
+        stacks.push({
+            id,
+            isCompose,
+            services: [...services].sort(compareServices),
+            counts,
+            isLive: counts.running > 0,
+        });
+    }
+    stacks.sort((a, b) => {
+        if (a.id === exports.NO_STACK && b.id !== exports.NO_STACK)
+            return 1;
+        if (b.id === exports.NO_STACK && a.id !== exports.NO_STACK)
+            return -1;
+        if (a.isLive !== b.isLive)
+            return a.isLive ? -1 : 1;
+        if (a.isLive)
+            return b.counts.running - a.counts.running;
+        return b.services.length - a.services.length;
+    });
+    return stacks;
+}

package/dist/utils/stats.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calcCPUPercent = calcCPUPercent;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function calcCPUPercent(stats) {
+    const cpuDelta = stats.cpu_stats.cpu_usage.total_usage - stats.precpu_stats.cpu_usage.total_usage;
+    const sysDelta = stats.cpu_stats.system_cpu_usage - stats.precpu_stats.system_cpu_usage;
+    const cpuCount = stats.cpu_stats.online_cpus ?? stats.cpu_stats.cpu_usage.percpu_usage?.length ?? 1;
+    if (sysDelta <= 0)
+        return 0;
+    return (cpuDelta / sysDelta) * cpuCount * 100;
+}

package/dist/utils/status.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACTIVE_STATUSES = void 0;
+exports.isActive = isActive;
+exports.statusDot = statusDot;
+exports.statusLabel = statusLabel;
+exports.colorByStatus = colorByStatus;
+exports.cpuColor = cpuColor;
+exports.memColor = memColor;
+exports.formatCpuCell = formatCpuCell;
+exports.formatMemCell = formatMemCell;
+const _theme_1 = require("../theme");
+exports.ACTIVE_STATUSES = new Set(['running', 'paused', 'restarting']);
+function isActive(status) {
+    return exports.ACTIVE_STATUSES.has(status);
+}
+function statusDot(c) {
+    switch (c.status) {
+        case 'running':
+            return _theme_1.t.green('●');
+        case 'paused':
+            return _theme_1.t.yellow('●');
+        case 'restarting':
+            return _theme_1.t.orange('●');
+        case 'exited':
+            return c.exitCode === 0 ? _theme_1.t.comment('●') : _theme_1.t.red('●');
+        case 'dead':
+            return _theme_1.t.red('●');
+        default:
+            return _theme_1.t.comment('●');
+    }
+}
+function statusLabel(c) {
+    switch (c.status) {
+        case 'exited':
+            return c.exitCode === 0 ? 'exited(0)' : `exited(${c.exitCode})`;
+        default:
+            return c.status;
+    }
+}
+function colorByStatus(c, text) {
+    switch (c.status) {
+        case 'running':
+            return _theme_1.t.green(text);
+        case 'paused':
+            return _theme_1.t.yellow(text);
+        case 'restarting':
+            return _theme_1.t.orange(text);
+        case 'exited':
+            return c.exitCode === 0 ? _theme_1.t.comment(text) : _theme_1.t.red(text);
+        case 'dead':
+            return _theme_1.t.red(text);
+        default:
+            return _theme_1.t.comment(text);
+    }
+}
+function cpuColor(cpu) {
+    if (cpu >= 80)
+        return _theme_1.t.red;
+    if (cpu >= 50)
+        return _theme_1.t.orange;
+    return _theme_1.t.purple;
+}
+function memColor(mem) {
+    if (mem >= 80)
+        return _theme_1.t.red;
+    if (mem >= 60)
+        return _theme_1.t.orange;
+    return _theme_1.t.cyan;
+}
+function formatCpuCell(c, cpu) {
+    if (!isActive(c.status) || cpu === undefined)
+        return _theme_1.t.faint('—');
+    return cpuColor(cpu)(`${cpu.toFixed(1)}%`);
+}
+function formatMemCell(c, mem) {
+    if (!isActive(c.status) || mem === undefined)
+        return _theme_1.t.faint('—');
+    return memColor(mem)(`${mem.toFixed(1)}%`);
+}

package/dist/utils/term-caps.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectColors = detectColors;
+function detectColors(env = process.env) {
+    const colorterm = env.COLORTERM;
+    if (colorterm === 'truecolor' || colorterm === '24bit')
+        return 'truecolor';
+    const term = env.TERM ?? '';
+    if (term.includes('truecolor') || term.includes('24bit'))
+        return 'truecolor';
+    if (term.includes('256color') || term === 'xterm-kitty')
+        return '256';
+    return 'low';
+}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "dockza.app",
+  "version": "0.2.0",
+  "description": "A lightweight terminal UI for Docker — manage containers, images, volumes, and networks without leaving your terminal",
+  "bin": {
+    "dockza": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "author": "Dmytro Shandyba <shandyba@gmail.com>",
+  "contributors": [
+    "Achraf El Fadili <contact@elfadiliachraf.tech> (original author of docktui, which dockza is forked from)"
+  ],
+  "homepage": "https://dockza.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shandyba/dockza.git"
+  },
+  "bugs": {
+    "url": "https://github.com/shandyba/dockza/issues"
+  },
+  "keywords": [
+    "docker",
+    "tui",
+    "terminal",
+    "cli",
+    "containers",
+    "dockerode",
+    "blessed",
+    "neo-blessed",
+    "compose",
+    "networks",
+    "devops"
+  ],
+  "scripts": {
+    "prebuild": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "tsc && tsc-alias",
+    "dev": "ts-node -r tsconfig-paths/register src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "prepublishOnly": "npm run lint && npm run format:check && npm run build && npm test"
+  },
+  "dependencies": {
+    "dayjs": "^1.11.13",
+    "dockerode": "^5.0.1",
+    "neo-blessed": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/blessed": "^0.1.25",
+    "@types/dockerode": "^4.0.1",
+    "@types/node": "^20.14.0",
+    "@vitest/coverage-v8": "^4.1.6",
+    "eslint": "^9.13.0",
+    "eslint-config-prettier": "^9.1.0",
+    "prettier": "^3.3.3",
+    "ts-node": "^10.9.2",
+    "tsc-alias": "^1.8.10",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.4.5",
+    "typescript-eslint": "^8.12.0",
+    "vitest": "^4.1.6"
+  }
+}