slash-port 0.1.0

package/dist/ui/theme.js

@@ -0,0 +1,86 @@
+/**
+ * Only the sixteen named terminal colours are used, never hex or 256-colour
+ * codes, so the UI inherits whatever palette the user has chosen instead of
+ * fighting it. Colour is always redundant: a protected row is also refused and
+ * also marked in text.
+ */
+export const roles = {
+    heading: 'cyan',
+    muted: 'gray',
+    danger: 'red',
+    warn: 'yellow',
+    ok: 'green',
+    accent: 'magenta',
+};
+/**
+ * Honours NO_COLOR. Read on every call rather than at import time, because
+ * `--no-color` is parsed after this module is loaded.
+ */
+export function colorEnabled() {
+    return !process.env['NO_COLOR'];
+}
+export function color(role) {
+    return colorEnabled() ? roles[role] : undefined;
+}
+const ELLIPSIS = '…';
+/** Truncate with an ellipsis, so a cut value is visibly cut rather than a lie. */
+export function truncate(value, width) {
+    if (width <= 0)
+        return '';
+    if (value.length <= width)
+        return value;
+    if (width === 1)
+        return ELLIPSIS;
+    return value.slice(0, width - 1) + ELLIPSIS;
+}
+export function cell(value, width) {
+    return truncate(value, width).padEnd(width);
+}
+const PORT_WIDTH = 11; // "65535/tcp" plus a little slack
+const PID_WIDTH = 7;
+const USER_WIDTH = 10;
+const PROCESS_WIDTH = 18;
+const ADDRESS_WIDTH = 17;
+const MIN_DESCRIPTION = 12;
+/** What the description is worth before an optional column gets anything. */
+const TARGET_DESCRIPTION = 28;
+/**
+ * Column widths that always add up to exactly the terminal width, including
+ * the single-space gaps. Nothing may overflow: a row one character too wide
+ * wraps, and a wrapped row destroys the alignment of every row below it.
+ *
+ * Columns are allocated by how much they carry. The port is never dropped,
+ * the description is reserved next because it is the reason the tool exists,
+ * and the rest compete for what is left — so an 80-column window keeps the
+ * columns that matter and a 40-column one still reads.
+ *
+ * A zero width means the column is not shown at all.
+ */
+export function layout(totalWidth) {
+    const total = Math.max(24, Math.floor(totalWidth) || 80);
+    const port = PORT_WIDTH;
+    let budget = total - port;
+    let description = Math.min(MIN_DESCRIPTION, budget - 1);
+    budget -= description + 1;
+    /** Take a column and its leading gap, or nothing if it does not fit. */
+    const take = (want) => {
+        if (budget < want + 1)
+            return 0;
+        budget -= want + 1;
+        return want;
+    };
+    const pid = take(PID_WIDTH);
+    const process = take(PROCESS_WIDTH);
+    const user = take(USER_WIDTH);
+    // Bring the description up to a width that can hold "Vite dev server
+    // (admin)" before spending anything on the address, which is the column
+    // that carries the least. At 80 columns that is the difference between a
+    // readable description and a truncated one.
+    const bump = Math.min(TARGET_DESCRIPTION - description, budget);
+    description += bump;
+    budget -= bump;
+    const address = take(ADDRESS_WIDTH);
+    // Whatever is left widens the description rather than being left as a gap.
+    description += budget;
+    return { port, pid, user, process, address, description, total };
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "slash-port",
+  "version": "0.1.0",
+  "description": "See what is listening on your ports, understand what it is, and kill it safely.",
+  "keywords": [
+    "port",
+    "ports",
+    "kill-port",
+    "eaddrinuse",
+    "lsof",
+    "netstat",
+    "tui",
+    "cli",
+    "developer-tools"
+  ],
+  "license": "MIT",
+  "author": "Slash UI Pte Ltd",
+  "homepage": "https://github.com/Slash-ui/slash-port#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Slash-ui/slash-port.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Slash-ui/slash-port/issues"
+  },
+  "type": "module",
+  "bin": {
+    "slash-port": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && chmod +x dist/cli.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "start": "node dist/cli.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "ink": "^7.1.1",
+    "react": "^19.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "@types/react": "^19.2.0",
+    "ink-testing-library": "^4.0.0",
+    "typescript": "^5.9.0",
+    "vitest": "^4.1.0"
+  }
+}