@kljj04/cli-kit 1.0.0

package/README.md

@@ -0,0 +1,110 @@
+# @kljj04/cli-kit
+
+All-in-one terminal styling library for Node.js.  
+RGB truecolor, boxes, tables, spinners, and progress bars — all in one package.
+
+## Install
+
+```bash
+npm install @kljj04/cli-kit
+```
+
+## Usage
+
+All styling follows the same chain pattern:
+
+```js
+kit.color(R, G, B).style(...styles).context(value)
+```
+
+- **`color(r, g, b)`** — RGB truecolor (0–255 each)
+- **`style(...args)`** — one or more text styles, plus an optional output type
+- **`context(value)`** — the content to render
+
+---
+
+## Text Styles
+
+Pass any of these as arguments to `.style()`:
+
+| Style | Description |
+|---|---|
+| `bold` | Bold text |
+| `dim` | Dimmed text |
+| `italic` | Italic text |
+| `underline` | Underlined text |
+| `inverse` | Inverted colors |
+| `strikethrough` | Strikethrough text |
+
+---
+
+## Output Types
+
+Pass one of these as an argument to `.style()` to change the output format.  
+Default is `print` if omitted.
+
+### `print` (default)
+
+```js
+kit.color(255, 100, 50).style('bold').context('Hello!')
+kit.color(255, 100, 50).style('bold', 'print').context('Hello!')
+```
+
+### `box`
+
+Wraps the text in a Unicode box. Supports multiline strings.
+
+```js
+kit.color(100, 200, 255).style('box').context('Hello!')
+kit.color(100, 200, 255).style('bold', 'box').context('Line one\nLine two')
+```
+
+```
+┌────────┐
+│ Hello! │
+└────────┘
+```
+
+### `spinner`
+
+Returns a spinner object. Call `.stop(text)` to stop it.
+
+```js
+const s = kit.color(0, 255, 200).style('spinner').context('Loading...')
+setTimeout(() => s.stop('Done!'), 2000)
+```
+
+### `progress`
+
+Pass a number from 0 to 100.
+
+```js
+kit.color(255, 200, 0).style('progress').context(72)
+// [██████████████████████░░░░░░░░] 72%
+```
+
+### `table`
+
+Pass an array of objects. Keys become headers.
+
+```js
+kit.color(200, 150, 255).style('table').context([
+    { name: 'Alice', age: 20, role: 'dev' },
+    { name: 'Bob',   age: 25, role: 'designer' },
+])
+```
+
+```
+┌───────┬─────┬──────────┐
+│ name  │ age │ role     │
+┼───────┼─────┼──────────┼
+│ Alice │ 20  │ dev      │
+│ Bob   │ 25  │ designer │
+└───────┴─────┴──────────┘
+```
+
+---
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@kljj04/cli-kit",
+  "version": "1.0.0",
+  "description": "All-in-one terminal styling library. Colors, boxes, tables, spinners, and progress bars.",
+  "main": "index.js",
+  "scripts": {
+    "test": "node test.js"
+  },
+  "keywords": [
+    "cli", "terminal", "color", "truecolor", "rgb",
+    "box", "table", "spinner", "progress", "styling"
+  ],
+  "author": "kljj04",
+  "license": "MIT",
+  "files": [
+    "index.js",
+    "src/",
+    "README.md"
+  ]
+}

package/src/color.js

@@ -0,0 +1,78 @@
+const STYLES = {
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    italic: '\x1b[3m',
+    underline: '\x1b[4m',
+    inverse: '\x1b[7m',
+    strikethrough: '\x1b[9m',
+};
+
+const RESET = '\x1b[0m';
+
+function rgb(r, g, b) {
+    return `\x1b[38;2;${r};${g};${b}m`;
+}
+
+function bgRgb(r, g, b) {
+    return `\x1b[48;2;${r};${g};${b}m`;
+}
+
+class KitBuilder {
+    constructor() {
+        this._r = 255;
+        this._g = 255;
+        this._b = 255;
+        this._styles = [];
+        this._outputType = 'print';
+    }
+
+    color(r, g, b) {
+        this._r = r;
+        this._g = g;
+        this._b = b;
+        return this;
+    }
+
+    style(...args) {
+        const outputTypes = ['print', 'box', 'spinner', 'progress', 'table'];
+        args.forEach(arg => {
+            if (outputTypes.includes(arg)) {
+                this._outputType = arg;
+            } else if (STYLES[arg]) {
+                this._styles.push(arg);
+            }
+        });
+        return this;
+    }
+
+    _buildPrefix() {
+        const colorCode = rgb(this._r, this._g, this._b);
+        const styleCodes = this._styles.map(s => STYLES[s]).join('');
+        return `${colorCode}${styleCodes}`;
+    }
+
+    context(value) {
+        const prefix = this._buildPrefix();
+        switch (this._outputType) {
+            case 'print':
+                require('./print').print(prefix, value);
+                break;
+            case 'box':
+                require('./box').box(prefix, value);
+                break;
+            case 'spinner':
+                return require('./spinner').spinner(prefix, value);
+            case 'progress':
+                require('./progress').progress(prefix, value);
+                break;
+            case 'table':
+                require('./table').table(prefix, value);
+                break;
+        }
+        // reset for next use
+        this._styles = [];
+        this._outputType = 'print';
+    }
+}
+
+module.exports = { KitBuilder, rgb, bgRgb, STYLES, RESET };

package/src/index.js

@@ -0,0 +1,12 @@
+const { KitBuilder } = require('./src/color');
+
+const kit = {
+    color(r, g, b) {
+        return new KitBuilder().color(r, g, b);
+    },
+    style(...args) {
+        return new KitBuilder().style(...args);
+    }
+};
+
+module.exports = kit;

package/src/print.js

@@ -0,0 +1,7 @@
+const { RESET } = require('./color');
+
+function print(prefix, text) {
+    console.log(`${prefix}${text}${RESET}`);
+}
+
+module.exports = { print };

package/src/progress.js

@@ -0,0 +1,13 @@
+const { RESET } = require('./color');
+
+function progress(prefix, value) {
+    const pct = Math.min(100, Math.max(0, Number(value)));
+    const width = 30;
+    const filled = Math.round((pct / 100) * width);
+    const empty = width - filled;
+
+    const bar = '█'.repeat(filled) + '░'.repeat(empty);
+    console.log(`${prefix}[${bar}] ${pct}%${RESET}`);
+}
+
+module.exports = { progress };

package/src/spinner.js

@@ -0,0 +1,24 @@
+const { RESET } = require('./color');
+
+const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+
+function spinner(prefix, text) {
+    let i = 0;
+    process.stdout.write('\x1b[?25l'); // 커서 숨기기
+
+    const interval = setInterval(() => {
+        process.stdout.write(`\r${prefix}${FRAMES[i % FRAMES.length]} ${text}${RESET}`);
+        i++;
+    }, 80);
+
+    return {
+        stop(finalText = '') {
+            clearInterval(interval);
+            process.stdout.write(`\r${' '.repeat(text.length + 4)}\r`);
+            if (finalText) console.log(`${prefix}✔ ${finalText}${RESET}`);
+            process.stdout.write('\x1b[?25h'); // 커서 복원
+        }
+    };
+}
+
+module.exports = { spinner };

package/src/table.js

@@ -0,0 +1,27 @@
+const { RESET } = require('./color');
+
+function table(prefix, data) {
+    if (!Array.isArray(data) || data.length === 0) return;
+
+    const headers = Object.keys(data[0]);
+    const colWidths = headers.map(h =>
+        Math.max(h.length, ...data.map(row => String(row[h] ?? '').length))
+    );
+
+    const hr = '┼' + colWidths.map(w => '─'.repeat(w + 2)).join('┼') + '┼';
+    const topBorder = '┌' + colWidths.map(w => '─'.repeat(w + 2)).join('┬') + '┐';
+    const bottomBorder = '└' + colWidths.map(w => '─'.repeat(w + 2)).join('┴') + '┘';
+
+    const row = (cells) =>
+        '│' + cells.map((c, i) => ` ${String(c).padEnd(colWidths[i])} `).join('│') + '│';
+
+    console.log(`${prefix}${topBorder}${RESET}`);
+    console.log(`${prefix}${row(headers)}${RESET}`);
+    console.log(`${prefix}${hr}${RESET}`);
+    data.forEach(r => {
+        console.log(`${prefix}${row(headers.map(h => r[h] ?? ''))}${RESET}`);
+    });
+    console.log(`${prefix}${bottomBorder}${RESET}`);
+}
+
+module.exports = { table };