@portel/cli 1.0.0

package/dist/progress.js

@@ -0,0 +1,165 @@
+/**
+ * Progress Rendering Utilities
+ *
+ * Provides ephemeral progress indicators that clear when done:
+ * - Spinners for indeterminate progress
+ * - Progress bars for determinate progress
+ *
+ * Always writes to stderr to avoid interfering with stdout data.
+ */
+import * as readline from 'readline';
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+/**
+ * Progress renderer that manages ephemeral output
+ * All progress is shown on stderr and clears when complete
+ */
+export class ProgressRenderer {
+    spinnerInterval;
+    currentFrame = 0;
+    isActive = false;
+    lastMessage = '';
+    lastLength = 0;
+    /**
+     * Start an indeterminate spinner with auto-animation
+     * Updates every 80ms until stopped
+     */
+    startSpinner(message) {
+        this.stop();
+        this.isActive = true;
+        this.lastMessage = message;
+        this.renderSpinner();
+        this.spinnerInterval = setInterval(() => {
+            this.currentFrame = (this.currentFrame + 1) % SPINNER_FRAMES.length;
+            this.renderSpinner();
+        }, 80);
+    }
+    /**
+     * Show a single frame of spinner (no auto-animation)
+     */
+    showSpinner(message) {
+        this.clearLine();
+        this.isActive = true;
+        this.lastMessage = message;
+        this.renderSpinner();
+    }
+    /**
+     * Show a progress bar with percentage (0-1)
+     */
+    showProgress(value, message) {
+        this.stop();
+        this.isActive = true;
+        this.lastMessage = message || '';
+        this.renderProgressBar(value);
+    }
+    /**
+     * Render progress bar with spinner animation
+     */
+    render(value, message) {
+        this.isActive = true;
+        this.lastMessage = message || '';
+        const pct = Math.round(value * 100);
+        const barWidth = 20;
+        const filled = Math.round(value * barWidth);
+        const empty = barWidth - filled;
+        const bar = '█'.repeat(filled) + '░'.repeat(empty);
+        const spinner = pct < 100 ? SPINNER_FRAMES[this.currentFrame++ % SPINNER_FRAMES.length] : '✓';
+        const text = `${spinner} [${bar}] ${pct.toString().padStart(3)}%${this.lastMessage ? ` ${this.lastMessage}` : ''}`;
+        this.clearLine();
+        process.stderr.write(text);
+        this.lastLength = text.length;
+    }
+    /**
+     * Update message without restarting animation
+     */
+    updateMessage(message) {
+        if (this.isActive) {
+            this.lastMessage = message;
+            if (this.spinnerInterval) {
+                this.renderSpinner();
+            }
+        }
+    }
+    /**
+     * Stop and clear progress display
+     */
+    stop() {
+        this.done();
+    }
+    /**
+     * End progress display (clears the line)
+     */
+    done() {
+        if (this.spinnerInterval) {
+            clearInterval(this.spinnerInterval);
+            this.spinnerInterval = undefined;
+        }
+        if (this.isActive) {
+            this.clearLine();
+            this.isActive = false;
+        }
+        this.currentFrame = 0;
+        this.lastMessage = '';
+        this.lastLength = 0;
+    }
+    /**
+     * Print a persistent status message
+     */
+    status(message) {
+        this.done();
+        console.error(`ℹ ${message}`);
+    }
+    /**
+     * Check if progress is currently active
+     */
+    get active() {
+        return this.isActive;
+    }
+    clearLine() {
+        if ((this.lastLength > 0 || this.isActive) && process.stderr.isTTY) {
+            readline.clearLine(process.stderr, 0);
+            readline.cursorTo(process.stderr, 0);
+            this.lastLength = 0;
+        }
+    }
+    renderSpinner() {
+        const frame = SPINNER_FRAMES[this.currentFrame];
+        const text = `${frame} ${this.lastMessage}`;
+        this.clearLine();
+        process.stderr.write(text);
+        this.lastLength = text.length;
+    }
+    renderProgressBar(value) {
+        const percentage = Math.round(value * 100);
+        const barLength = 30;
+        const filled = Math.round(barLength * value);
+        const bar = '█'.repeat(filled) + '░'.repeat(barLength - filled);
+        const text = `[${bar}] ${percentage}%${this.lastMessage ? ` ${this.lastMessage}` : ''}`;
+        this.clearLine();
+        process.stderr.write(text);
+        this.lastLength = text.length;
+    }
+}
+// Global instance
+let globalRenderer = null;
+export function getProgressRenderer() {
+    if (!globalRenderer) {
+        globalRenderer = new ProgressRenderer();
+    }
+    return globalRenderer;
+}
+export function startSpinner(message) {
+    getProgressRenderer().startSpinner(message);
+}
+export function showProgress(value, message) {
+    getProgressRenderer().showProgress(value, message);
+}
+export function updateProgressMessage(message) {
+    getProgressRenderer().updateMessage(message);
+}
+export function stopProgress() {
+    getProgressRenderer().stop();
+}
+export function isProgressActive() {
+    return getProgressRenderer().active;
+}
+//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

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

package/dist/text-utils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Text Processing Utilities
+ *
+ * Shared utilities for text wrapping, formatting, and manipulation.
+ */
+import type { TextWrapOptions } from './types.js';
+export declare class TextUtils {
+    /**
+     * Wrap text to fit within specified width with optional indentation
+     */
+    static wrapText(text: string, options: TextWrapOptions): string;
+    /**
+     * Wrap text with background color applied to each line
+     */
+    static wrapTextWithBackground(text: string, maxWidth: number, indent: string, backgroundFormatter: (text: string) => string): string;
+    /**
+     * Truncate text with ellipsis if too long
+     */
+    static truncate(text: string, maxLength: number, ellipsis?: string): string;
+    /**
+     * Pad a string to a fixed width
+     */
+    static pad(text: string, width: number, align?: 'left' | 'right' | 'center'): string;
+    /**
+     * Strip ANSI escape codes from string
+     */
+    static stripAnsi(text: string): string;
+    /**
+     * Get visible length of string (excluding ANSI codes)
+     */
+    static visibleLength(text: string): number;
+}
+export { TextWrapOptions };
+//# sourceMappingURL=text-utils.d.ts.map

package/dist/text-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-utils.d.ts","sourceRoot":"","sources":["../src/text-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,SAAS;IACpB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM;IA+C/D;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAC5C,MAAM;IAcT;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAc,GAAG,MAAM;IAKlF;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,OAAO,GAAG,QAAiB,GAAG,MAAM;IAgB5F;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKtC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAG3C;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/text-utils.js

@@ -0,0 +1,104 @@
+/**
+ * Text Processing Utilities
+ *
+ * Shared utilities for text wrapping, formatting, and manipulation.
+ */
+export class TextUtils {
+    /**
+     * Wrap text to fit within specified width with optional indentation
+     */
+    static wrapText(text, options) {
+        const { maxWidth, indent = '', cleanupPrefixes = false, preserveWhitespace = false } = options;
+        if (!text)
+            return text;
+        let processedText = text;
+        if (cleanupPrefixes) {
+            processedText = text
+                .replace(/^[^:]+:\s*/, '')
+                .replace(/\s+/g, ' ')
+                .trim();
+        }
+        else if (!preserveWhitespace) {
+            processedText = text.trim();
+        }
+        if (processedText.length <= maxWidth) {
+            return processedText;
+        }
+        const words = processedText.split(' ');
+        const lines = [];
+        let currentLine = '';
+        for (const word of words) {
+            const testLine = currentLine ? `${currentLine} ${word}` : word;
+            if (testLine.length <= maxWidth) {
+                currentLine = testLine;
+            }
+            else {
+                if (currentLine) {
+                    lines.push(currentLine);
+                    currentLine = word;
+                }
+                else {
+                    lines.push(word);
+                }
+            }
+        }
+        if (currentLine) {
+            lines.push(currentLine);
+        }
+        return lines.map((line, index) => index === 0 ? line : `\n${indent}${line}`).join('');
+    }
+    /**
+     * Wrap text with background color applied to each line
+     */
+    static wrapTextWithBackground(text, maxWidth, indent, backgroundFormatter) {
+        if (text.length <= maxWidth) {
+            return `${indent}${backgroundFormatter(text)}`;
+        }
+        const wrappedText = this.wrapText(text, { maxWidth, indent: '', preserveWhitespace: true });
+        const lines = wrappedText.split('\n');
+        return lines.map((line, _index) => {
+            const formattedLine = backgroundFormatter(line);
+            return `${indent}${formattedLine}`;
+        }).join('\n');
+    }
+    /**
+     * Truncate text with ellipsis if too long
+     */
+    static truncate(text, maxLength, ellipsis = '...') {
+        if (text.length <= maxLength)
+            return text;
+        return text.slice(0, maxLength - ellipsis.length) + ellipsis;
+    }
+    /**
+     * Pad a string to a fixed width
+     */
+    static pad(text, width, align = 'left') {
+        if (text.length >= width)
+            return text;
+        const padding = width - text.length;
+        switch (align) {
+            case 'right':
+                return ' '.repeat(padding) + text;
+            case 'center':
+                const left = Math.floor(padding / 2);
+                const right = padding - left;
+                return ' '.repeat(left) + text + ' '.repeat(right);
+            default:
+                return text + ' '.repeat(padding);
+        }
+    }
+    /**
+     * Strip ANSI escape codes from string
+     */
+    static stripAnsi(text) {
+        // eslint-disable-next-line no-control-regex
+        return text.replace(/\x1B\[[0-9;]*[a-zA-Z]/g, '');
+    }
+    /**
+     * Get visible length of string (excluding ANSI codes)
+     */
+    static visibleLength(text) {
+        return this.stripAnsi(text).length;
+    }
+}
+//# sourceMappingURL=text-utils.js.map

package/dist/text-utils.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @portel/core type definitions
+ */
+/**
+ * Output format hints for CLI formatting
+ *
+ * Structural formats:
+ * - primitive: Single values (string, number, boolean)
+ * - table: Flat objects or arrays of flat objects
+ * - tree: Nested/hierarchical structures
+ * - list: Arrays of primitives
+ * - card: Bordered card view for objects
+ * - tabs: Tabbed sections for grouped data
+ * - accordion: Collapsible sections
+ * - none: No data to display
+ *
+ * Content formats:
+ * - json, markdown, yaml, xml, html: Syntax highlighted content
+ * - code / code:<lang>: Syntax highlighted code
+ */
+export type OutputFormat = 'primitive' | 'table' | 'tree' | 'list' | 'none' | 'card' | 'grid' | 'chips' | 'kv' | 'tabs' | 'accordion' | 'json' | 'markdown' | 'yaml' | 'xml' | 'html' | 'mermaid' | `code` | `code:${string}`;
+/**
+ * Text wrapping options for CLI output
+ */
+export interface TextWrapOptions {
+    maxWidth: number;
+    indent?: string;
+    cleanupPrefixes?: boolean;
+    preserveWhitespace?: boolean;
+}
+/**
+ * Fuzzy match result
+ */
+export interface FuzzyMatch {
+    text: string;
+    distance: number;
+    score: number;
+}
+/**
+ * Execution context for async operations
+ */
+export interface ExecutionContext {
+    outputHandler?: (data: any) => void;
+}
+/**
+ * Log levels for logger
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Logger configuration options
+ */
+export interface LoggerOptions {
+    level?: LogLevel;
+    prefix?: string;
+    silent?: boolean;
+    debugMode?: boolean;
+    logFilePath?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,YAAY,GACpB,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAChD,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,WAAW,GACvD,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GACzD,MAAM,GAAG,QAAQ,MAAM,EAAE,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * @portel/core type definitions
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@portel/cli",
+  "version": "1.0.0",
+  "description": "CLI toolkit for building terminal applications - formatting, progress, fuzzy matching, logging",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "cli",
+    "formatter",
+    "progress",
+    "spinner",
+    "fuzzy",
+    "logging",
+    "terminal",
+    "utilities"
+  ],
+  "author": "Portel",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/portel-dev/portel-cli"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "cli-highlight": "^2.1.11"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}