@hmanlab/hl-plugins 0.1.0

package/dist/lib/ui.js

@@ -0,0 +1,103 @@
+// Tiny terminal UI helpers -- colors, spinners, hidden prompts.
+// No third-party deps; ANSI escape codes only. Stays readable in dumb terminals.
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+const isTTY = stdout.isTTY;
+const c = (code) => (isTTY ? `\x1b[${code}m` : "");
+const RESET = isTTY ? "\x1b[0m" : "";
+const wrap = (code, s) => `${c(code)}${s}${RESET}`;
+export const ui = {
+    bold: (s) => wrap("1", s),
+    dim: (s) => wrap("2", s),
+    red: (s) => wrap("31", s),
+    green: (s) => wrap("32", s),
+    yellow: (s) => wrap("33", s),
+    blue: (s) => wrap("34", s),
+    cyan: (s) => wrap("36", s),
+    gray: (s) => wrap("90", s),
+    ok: (s) => `${c("32")}✓${RESET} ${s}`,
+    fail: (s) => `${c("31")}✗${RESET} ${s}`,
+    warn: (s) => `${c("33")}!${RESET} ${s}`,
+    header: (s) => `\n${c("1")}${s}${RESET}\n`,
+    rule: () => (isTTY ? `${c("90")}${"─".repeat(60)}${RESET}` : "─".repeat(60)),
+    step: (n, total, label) => `${c("90")}[${n}/${total}]${RESET} ${c("1")}${label}${RESET}`,
+    info: (s) => console.log(s),
+    error: (s) => console.error(`${c("31")}error:${RESET} ${s}`),
+    /**
+     * Run an async task with a simple braille spinner. Animates only when
+     * stdout is a TTY; otherwise just prints "label..." and runs silently.
+     * Always clears the spinner line on completion.
+     */
+    async spinner(label, fn) {
+        if (!isTTY) {
+            stdout.write(`  ${c("36")}•${RESET} ${label}...`);
+            try {
+                const result = await fn();
+                stdout.write(`\r${c("32")}✓${RESET} ${label}\n`);
+                return result;
+            }
+            catch (err) {
+                stdout.write(`\r${c("31")}✗${RESET} ${label}\n`);
+                throw err;
+            }
+        }
+        const FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+        let i = 0;
+        const write = (frame) => {
+            stdout.write(`\r${c("36")}${frame}${RESET} ${label}`);
+        };
+        write(FRAMES[0]);
+        const timer = setInterval(() => {
+            i = (i + 1) % FRAMES.length;
+            write(FRAMES[i]);
+        }, 80);
+        try {
+            const result = await fn();
+            clearInterval(timer);
+            stdout.write(`\r${c("32")}✓${RESET} ${label}\n`);
+            return result;
+        }
+        catch (err) {
+            clearInterval(timer);
+            stdout.write(`\r${c("31")}✗${RESET} ${label}\n`);
+            throw err;
+        }
+    },
+    /** Section header inside a command, e.g. "[3/7] Authenticate". */
+    section: (label) => {
+        stdout.write(`\n${ui.bold(label)}\n`);
+    },
+    /** Prompt for a hidden string (e.g. API key). Echoes nothing. */
+    async promptHidden(question) {
+        if (!stdin.isTTY) {
+            throw new Error("Cannot prompt for hidden input: stdin is not a TTY. " +
+                "Pipe the value via env or --key instead.");
+        }
+        const rl = createInterface({ input: stdin, output: stdout, terminal: true });
+        try {
+            // Best-effort: turn off echo if the TTY supports it.
+            // process.stdin.setRawMode?.(true) would block line-mode semantics;
+            // readline + write("\x1b[8m") is a portable approximation.
+            stdout.write(question);
+            stdout.write("\x1b[8m"); // hide cursor / attempt to hide input
+            const answer = await rl.question("");
+            stdout.write("\x1b[0m");
+            stdout.write("\n");
+            return answer.trim();
+        }
+        finally {
+            rl.close();
+        }
+    },
+    async promptVisible(question) {
+        const rl = createInterface({ input: stdin, output: stdout, terminal: true });
+        try {
+            const answer = await rl.question(question);
+            return answer.trim();
+        }
+        finally {
+            rl.close();
+        }
+    },
+};
+//# sourceMappingURL=ui.js.map

package/dist/lib/ui.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@hmanlab/hl-plugins",
+  "version": "0.1.0",
+  "description": "Install curated OpenCode plugins with one command.",
+  "type": "module",
+  "bin": {
+    "hl-plugins": "bin/hl-plugins.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "opencode",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "help": "node ./bin/hl-plugins.js help"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "cli"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hmanlab/hl-plugins.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/hmanlab/hl-plugins#readme",
+  "bugs": {
+    "url": "https://github.com/hmanlab/hl-plugins/issues"
+  }
+}